Session Storage Adapter for Prisma
This package implements the SessionStorage interface that works with an instance of Prisma.
Session storage for prisma requires a schema.prisma with a Session table with at-least the following columns:
model Session {
id String @id
shop String
state String
isOnline Boolean @default(false)
scope String?
expires DateTime?
accessToken String
userId BigInt?
firstName String?
lastName String?
email String?
accountOwner Boolean?
locale String?
collaborator Boolean?
emailVerified Boolean?
}
[!WARNING]
Some DB adapters adapters may set a maximum length for the String type by default, please ensure your fields allow for long enough strings.
See https://www.prisma.io/docs/orm/reference/prisma-schema-reference#string for more information
You can then instantiate and use PrismaSessionStorage like so:
import {shopifyApp} from '@shopify/shopify-app-express';
import {PrismaSessionStorage} from '@shopify/shopify-app-session-storage-prisma';
import {PrismaClient} from '@prisma/client';
const prisma = new PrismaClient();
const storage = new PrismaSessionStorage(prisma);
const shopify = shopifyApp({
sessionStorage: storage,
// ...
});
Options
You can also pass in some optional flags to tweak the behavior of the adapter.
Custom table name
You can pass in the tableName option if you want to use a different table name in your schema.
For example:
const storage = new PrismaSessionStorage(prisma, {
tableName: 'MyCustomSession',
});
Note: If you use SQLite with Prisma note that sqlite is a local, file-based SQL database. It persists all tables to a single file on your local disk. As such, it’s simple to set up and is a great choice for getting started with Shopify App development. However, it won’t work when your app getting scaled across multiple instances because they would each create their own database.
If you prefer to use your own implementation of a session storage mechanism that is compatible with the @shopify/shopify-app-express package, see the implementing session storage guide.
Connection retries
When the storage starts up, it will connect to the database during startup so the app can start.
If the DB server takes too long to start, the setup may fail.
To avoid that, you can pass in the connectionRetries and connectionRetryIntervalMs options to control how many times to retry, and how long to wait between tries, respectively.
For example:
const storage = new PrismaSessionStorage(prisma, {
// Default values
connectionRetries: 2,
connectionRetryIntervalMs: 5000,
});
Updating your database
When updating the type of database you are using, you may need to make some changes to your project for Prisma to work correctly. Please review the prisma documentation for your specific database type for configuration.
Troubleshooting
MissingSessionTableError error is thrown
Some common reasons for that are:
- The database was not migrated.
- The
Session table above was not added to the schema.
- The table is in the schema, but isn't named
Session.
Here are some possible solutions for this issue:
- Ensure you've run the
migrate command to apply the schema.
- Ensure you've copied the schema above into your
prisma.schema file.
- If you've made changes to the table, make sure it's still called
Session.
Error: The "mongodb" provider is not supported with this command
MongoDB does not support the prisma migrate command. If you are using MongoDB please see the Prisma documentation for configuring your database.
