@itoa/adapter-prisma v4.0.3

Prisma database adapter

This is the last active development release of this package as Itoa 5 is now in a 6 to 12 month active maintenance phase. For more information please read our Itoa 5 and beyond post.

The Prisma adapter allows Itoa to connect a database using Prisma Client, a type-safe and auto-generated database client. You can learn more about Prisma Client in the Prisma docs.

Tip: Want to get started with Itoa + Prisma? Follow the guide!

Warning: The Itoa Prisma adapter is not currently production-ready. It depends on the Prisma Migrate system which is currently flagged as Preview. Once Prisma Migrate is out of preview mode, we will release a production-ready version of this package.

Note: This adapter currently only supports PostgreSQL databases, and has other limitations. For more details, see our Prisma Adapter - Production Ready Checklist

Usage

const { PrismaAdapter } = require('@itoa/adapter-prisma');

const itoa = new Itoa({
  adapter: new PrismaAdapter({ url: 'postgres://...' }),
});

Config

url

Default: DATABASE_URL

The connection string for your database, in the form postgres://<user>:<password>@<host>:<port>/<dbname>. By default it will use the value of the environment variable DATABASE_URL. You can learn more about the connection string format used in the Prisma docs.

getPrismaPath

Default: ({ prismaSchema }) => '.prisma'

A function which returns a directory name for storing the generated Prisma schema and client.

getDbSchemaName

Default: ({ prismaSchema }) => 'public'

A function which returns a database schema name to use for storage of all Itoa tables in your database.

You can also set the schema name by including the suffix ?schema=... in your DATABASE_URL or url. In this case you should set this value to () => null.

enableLogging

Default: false

Enables logging at the query level in the Prisma client.

dropDatabase

Default: false

Allow the adapter to drop the entire database and recreate the tables / foreign keys based on the list schema in your application. This option is ignored in production, i.e. when the environment variable NODE_ENV === 'production'.

migrationMode

Default: 'dev'

Controls how and when migrations are applied. One of 'dev', 'prototype', 'createOnly', or 'none'. In prototype mode, prisma db push is used to sync the database tables without generating migration files. In dev mode, migrations files are generated and applied whenever the schema changes. In createOnly mode, migrations are generated but not applied. In none mode, no migrations are generated or applied.

Setup

Before running Itoa with the Prisma adapter you will need to have a PostgreSQL database to connect to.

If you already have a database then you can use its connection string in the url config option. If you don't have a database already then you can create one locally with the following commands.

createdb -U postgres itoa
psql itoa -U postgres -c "CREATE USER itoa5 PASSWORD 'change_me_plz'"
psql itoa -U postgres -c "GRANT ALL ON DATABASE itoa TO itoa5;"

If using the above, you will want to set a connection string of:

const itoa = new Itoa({
  adapter: new PrismaAdapter({ url: `postgres://itoa5:change_me_plz@localhost:5432/itoa` }),
});

See the adapters setup guide for more details on how to setup a database.