create-prisma 0.4.1 → 0.4.2-next.37.80.1

package/templates/create/hono/src/index.ts.hbs

@@ -4,7 +4,7 @@ import "dotenv/config";
 import { serve } from "@hono/node-server";
 import { Hono } from "hono";
 {{#if (eq schemaPreset "basic")}}
-import { prisma } from "./lib/prisma{{#if (eq packageManager "deno")}}.ts{{/if}}";
+import { listUsers } from "./lib/prisma{{#if (eq packageManager "deno")}}.ts{{/if}}";
 {{/if}}
 
 const app = new Hono();
@@ -17,13 +17,15 @@ app.get("/", (c) => {
 {{#if (eq schemaPreset "basic")}}
 
 app.get("/users", async (c) => {
-  const users = await prisma.user.findMany({
-    take: 10,
-    orderBy: {
-      createdAt: "desc",
-    },
+  const users = await listUsers(10).catch((error) => {
+    console.error("Failed to query users:", error);
+    return undefined;
   });
 
+  if (!users) {
+    return c.json({ error: "Could not query users yet. Run contract:emit and apply your schema first." }, 500);
+  }
+
   return c.json(users);
 });
 {{/if}}

package/templates/create/hono/src/lib/prisma.ts.hbs

@@ -1,56 +1,59 @@
-{{#if (requiresDotenvConfigImport packageManager)}}
 import "dotenv/config";
-{{/if}}
-import { PrismaClient } from "../generated/prisma/client{{#if (eq packageManager "deno")}}.ts{{/if}}";
-{{#if (eq provider "postgresql")}}
-import { PrismaPg } from "@prisma/adapter-pg";
-{{/if}}
-{{#if (eq provider "cockroachdb")}}
-import { PrismaPg } from "@prisma/adapter-pg";
-{{/if}}
-{{#if (eq provider "mysql")}}
-import { PrismaMariaDb } from "@prisma/adapter-mariadb";
-{{/if}}
-{{#if (eq provider "sqlite")}}
-import { PrismaBetterSqlite3 } from "@prisma/adapter-better-sqlite3";
-{{/if}}
-{{#if (eq provider "sqlserver")}}
-import { PrismaMssql } from "@prisma/adapter-mssql";
-{{/if}}
-
-const rawDatabaseUrl = {{#if (eq packageManager "deno")}}Deno.env.get("DATABASE_URL"){{else}}process.env.DATABASE_URL{{/if}};
-{{#if (eq provider "sqlite")}}
-const databaseUrl = (rawDatabaseUrl ?? "").trim() || "file:./dev.db";
+{{#if (eq provider "mongo")}}
+import mongo from "@prisma-next/mongo/runtime";
 {{else}}
-const databaseUrl = (rawDatabaseUrl ?? "").trim();
-if (!databaseUrl) {
-  throw new Error("DATABASE_URL is required");
-}
+import postgres from "@prisma-next/postgres/runtime";
 {{/if}}
+import type { Contract } from "../../prisma/contract.d";
+import contractJson from "../../prisma/contract.json" with { type: "json" };
 
-{{#if (eq provider "postgresql")}}
-const adapter = new PrismaPg({
-  connectionString: databaseUrl,
+{{#if (eq provider "mongo")}}
+export const db = mongo<Contract>({
+  contractJson,
+  url: process.env["DATABASE_URL"],
 });
-{{/if}}
-{{#if (eq provider "cockroachdb")}}
-const adapter = new PrismaPg({
-  connectionString: databaseUrl,
+{{else}}
+export const db = postgres<Contract>({
+  contractJson,
+  url: process.env["DATABASE_URL"],
 });
 {{/if}}
-{{#if (eq provider "mysql")}}
-const adapter = new PrismaMariaDb(databaseUrl);
-{{/if}}
-{{#if (eq provider "sqlite")}}
-const adapter = new PrismaBetterSqlite3({
-  url: databaseUrl,
-});
+
+export type StarterUser = {
+  id: string;
+  email: string;
+  name: string | null;
+  createdAt: Date | null;
+};
+
+export async function listUsers(limit = 10): Promise<StarterUser[]> {
+{{#if (eq schemaPreset "basic")}}
+{{#if (eq provider "mongo")}}
+  const users: StarterUser[] = [];
+
+  for await (const user of db.orm.users.select("_id", "email", "name").take(limit).all()) {
+    users.push({
+      id: String(user._id),
+      email: user.email,
+      name: user.name ?? null,
+      createdAt: null,
+    });
+  }
+
+  return users;
+{{else}}
+  const users = await db.orm.User.select("id", "email", "name", "createdAt").take(limit).all();
+
+  return users.map((user) => ({
+    id: String(user.id),
+    email: user.email,
+    name: user.name ?? null,
+    createdAt: user.createdAt,
+  }));
 {{/if}}
-{{#if (eq provider "sqlserver")}}
-const adapter = new PrismaMssql(databaseUrl);
+{{else}}
+  return [];
 {{/if}}
+}
 
-const prisma = new PrismaClient({ adapter });
-
-export { prisma };
-export default prisma;
+export default db;

package/templates/create/hono/tsconfig.json

@@ -3,6 +3,7 @@
     "target": "ES2022",
     "module": "ESNext",
     "moduleResolution": "Bundler",
+    "resolveJsonModule": true,
     "verbatimModuleSyntax": true,
     "strict": true,
     "esModuleInterop": true,

package/templates/create/nest/README.md.hbs

@@ -8,25 +8,35 @@ Generated by `create-prisma` with the NestJS template.
 - `{{runScriptCommand packageManager "build"}}` - {{#if (eq packageManager "deno")}}type-check the app with Deno{{else}}{{#if (eq packageManager "bun")}}type-check the app for Bun{{else}}compile the app into `dist/`{{/if}}{{/if}}
 - `{{runScriptCommand packageManager "start"}}` - {{#if (eq packageManager "deno")}}run the server directly from `src/main.ts` with Deno{{else}}{{#if (eq packageManager "bun")}}run the server directly from `src/main.ts` with Bun{{else}}run the compiled server from `dist/main.js`{{/if}}{{/if}}
 
-## Prisma
-
-1. Make sure dependencies are installed.
-2. Generate Prisma Client:
-
-`{{runScriptCommand packageManager "db:generate"}}`
-
-3. Run your first migration:
-
-`{{runScriptCommand packageManager "db:migrate"}}`
-
-4. Seed the database:
-
-`{{runScriptCommand packageManager "db:seed"}}`
-
-5. Use the shared Prisma setup from `src/lib/prisma.ts` and inject `PrismaService` from `src/prisma.service.ts` inside Nest providers.
+## Prisma Next
+
+Prisma Next setup is scaffolded in:
+
+- `prisma/contract{{#if (eq authoring "typescript")}}.ts{{else}}.prisma{{/if}}`
+- `prisma-next.config.ts`
+- `src/lib/prisma.ts`
+- `src/prisma.service.ts`
+
+Database helper scripts are added to `package.json`:
+
+- `{{runScriptCommand packageManager "contract:emit"}}` - emit contract artifacts after contract changes
+{{#if (eq provider "mongo")}}
+- `{{runScriptCommand packageManager "db:up"}}` - start the local MongoDB replica set
+- `{{runScriptCommand packageManager "db:down"}}` - stop the local MongoDB replica set
+- `{{runScriptCommand packageManager "migration:plan"}}` - create a MongoDB migration plan
+- `{{runScriptCommand packageManager "migration:apply"}}` - apply the planned MongoDB migration
+{{else}}
+- `{{runScriptCommand packageManager "db:init"}}` - initialize database state manually
+- `{{runScriptCommand packageManager "db:update"}}` - update database state manually
+- `{{runScriptCommand packageManager "migration:plan"}}` - create a migration plan
+- `{{runScriptCommand packageManager "migration:apply"}}` - apply a planned migration
+{{/if}}
+{{#if (eq schemaPreset "basic")}}
+- `{{runScriptCommand packageManager "db:seed"}}` - insert sample users manually
+{{/if}}
 
-Generated Prisma files are written to `src/generated/prisma`.
+Node-based Prisma Next projects expect Node.js 24 LTS or newer.
 {{#if (eq schemaPreset "basic")}}
 
-The template includes a basic `User` model, a sample `GET /users` endpoint, and seed data in `prisma/seed.ts`.
+The template includes a basic `User` model and a sample `GET /users` endpoint.
 {{/if}}

package/templates/create/nest/deno.json.hbs

@@ -1,5 +1,5 @@
 {{#if (eq packageManager "deno")}}
 {
-  "nodeModulesDir": "auto"
+  "nodeModulesDir": "manual"
 }
 {{/if}}

package/templates/create/nest/prisma/contract.prisma.hbs

@@ -0,0 +1,44 @@
+{{#if (eq authoring "psl")}}
+// use prisma-next
+{{#if (eq schemaPreset "basic")}}
+{{#if (eq provider "mongo")}}
+
+model User {
+  id    ObjectId @id @map("_id")
+  email String   @unique
+  name  String?
+  posts Post[]
+
+  @@map("users")
+}
+
+model Post {
+  id       ObjectId @id @map("_id")
+  title    String
+  content  String?
+  author   User     @relation(fields: [authorId], references: [id])
+  authorId ObjectId
+
+  @@map("posts")
+}
+{{else}}
+
+model User {
+  id        Int      @id @default(autoincrement())
+  email     String   @unique
+  name      String?
+  posts     Post[]
+  createdAt DateTime @default(now())
+}
+
+model Post {
+  id        Int      @id @default(autoincrement())
+  title     String
+  content   String?
+  author    User     @relation(fields: [authorId], references: [id])
+  authorId  Int
+  createdAt DateTime @default(now())
+}
+{{/if}}
+{{/if}}
+{{/if}}

package/templates/create/nest/prisma/contract.ts.hbs

@@ -0,0 +1,85 @@
+{{#if (eq authoring "typescript")}}
+{{#if (eq provider "mongo")}}
+import mongoFamily from "@prisma-next/family-mongo/pack";
+import { defineContract } from "@prisma-next/mongo-contract-ts/contract-builder";
+import mongoTarget from "@prisma-next/target-mongo/pack";
+
+export const contract = defineContract(
+  { family: mongoFamily, target: mongoTarget },
+  ({ field, index, model, rel }) => ({
+    models: {
+{{#if (eq schemaPreset "basic")}}
+      User: model("User", {
+        collection: "users",
+        fields: {
+          _id: field.objectId(),
+          email: field.string(),
+          name: field.string().optional(),
+        },
+        indexes: [
+          index({ email: 1 }, { unique: true }),
+        ],
+        relations: {
+          posts: rel.hasMany("Post", { from: "_id", to: "authorId" }),
+        },
+      }),
+
+      Post: model("Post", {
+        collection: "posts",
+        fields: {
+          _id: field.objectId(),
+          title: field.string(),
+          content: field.string().optional(),
+          authorId: field.objectId(),
+        },
+        indexes: [
+          index({ authorId: 1 }),
+        ],
+        relations: {
+          author: rel.belongsTo("User", { from: "authorId", to: "_id" }),
+        },
+      }),
+{{/if}}
+    },
+  }),
+);
+{{else}}
+import sqlFamily from "@prisma-next/family-sql/pack";
+import { defineContract } from "@prisma-next/sql-contract-ts/contract-builder";
+import postgresPack from "@prisma-next/target-postgres/pack";
+
+export const contract = defineContract(
+  { family: sqlFamily, target: postgresPack },
+  ({ field, model, rel }) => ({
+    models: {
+{{#if (eq schemaPreset "basic")}}
+      User: model("User", {
+        fields: {
+          id: field.id.uuidv7(),
+          email: field.text().unique(),
+          name: field.text().optional(),
+          createdAt: field.createdAt(),
+        },
+        relations: {
+          posts: rel.hasMany("Post", { by: "authorId" }),
+        },
+      }),
+
+      Post: model("Post", {
+        fields: {
+          id: field.id.uuidv7(),
+          title: field.text(),
+          content: field.text().optional(),
+          authorId: field.uuid(),
+          createdAt: field.createdAt(),
+        },
+        relations: {
+          author: rel.belongsTo("User", { from: "authorId", to: "id" }),
+        },
+      }),
+{{/if}}
+    },
+  }),
+);
+{{/if}}
+{{/if}}

package/templates/create/nest/prisma-next.config.ts.hbs

@@ -0,0 +1,13 @@
+import "dotenv/config";
+{{#if (eq provider "mongo")}}
+import { defineConfig } from "@prisma-next/mongo/config";
+{{else}}
+import { defineConfig } from "@prisma-next/postgres/config";
+{{/if}}
+
+export default defineConfig({
+  contract: "./prisma/contract{{#if (eq authoring "typescript")}}.ts{{else}}.prisma{{/if}}",
+  db: {
+    connection: process.env["DATABASE_URL"],
+  },
+});

package/templates/create/nest/src/lib/prisma.ts.hbs

@@ -1,58 +1,59 @@
-{{#if (requiresDotenvConfigImport packageManager)}}
 import "dotenv/config";
-{{/if}}
-
-import { PrismaClient } from "../generated/prisma/client{{#if (eq packageManager "deno")}}.ts{{/if}}";
-{{#if (eq provider "postgresql")}}
-import { PrismaPg } from "@prisma/adapter-pg";
-{{/if}}
-{{#if (eq provider "cockroachdb")}}
-import { PrismaPg } from "@prisma/adapter-pg";
-{{/if}}
-{{#if (eq provider "mysql")}}
-import { PrismaMariaDb } from "@prisma/adapter-mariadb";
-{{/if}}
-{{#if (eq provider "sqlite")}}
-import { PrismaBetterSqlite3 } from "@prisma/adapter-better-sqlite3";
-{{/if}}
-{{#if (eq provider "sqlserver")}}
-import { PrismaMssql } from "@prisma/adapter-mssql";
-{{/if}}
-
-const rawDatabaseUrl = {{#if (eq packageManager "deno")}}Deno.env.get("DATABASE_URL"){{else}}process.env.DATABASE_URL{{/if}};
-{{#if (eq provider "sqlite")}}
-const databaseUrl = (rawDatabaseUrl ?? "").trim() || "file:./dev.db";
+{{#if (eq provider "mongo")}}
+import mongo from "@prisma-next/mongo/runtime";
 {{else}}
-const databaseUrl = (rawDatabaseUrl ?? "").trim();
-if (!databaseUrl) {
-  throw new Error("DATABASE_URL is required");
-}
+import postgres from "@prisma-next/postgres/runtime";
 {{/if}}
+import type { Contract } from "../../prisma/contract.d";
+import contractJson from "../../prisma/contract.json" with { type: "json" };
 
-{{#if (eq provider "postgresql")}}
-const adapter = new PrismaPg({
-  connectionString: databaseUrl,
+{{#if (eq provider "mongo")}}
+export const db = mongo<Contract>({
+  contractJson,
+  url: process.env["DATABASE_URL"],
 });
-{{/if}}
-{{#if (eq provider "cockroachdb")}}
-const adapter = new PrismaPg({
-  connectionString: databaseUrl,
-});
-{{/if}}
-{{#if (eq provider "mysql")}}
-const adapter = new PrismaMariaDb(databaseUrl);
-{{/if}}
-{{#if (eq provider "sqlite")}}
-const adapter = new PrismaBetterSqlite3({
-  url: databaseUrl,
+{{else}}
+export const db = postgres<Contract>({
+  contractJson,
+  url: process.env["DATABASE_URL"],
 });
 {{/if}}
-{{#if (eq provider "sqlserver")}}
-const adapter = new PrismaMssql(databaseUrl);
-{{/if}}
 
-export const prismaClientOptions = { adapter };
+export type StarterUser = {
+  id: string;
+  email: string;
+  name: string | null;
+  createdAt: Date | null;
+};
 
-export function createPrismaClient() {
-  return new PrismaClient(prismaClientOptions);
+export async function listUsers(limit = 10): Promise<StarterUser[]> {
+{{#if (eq schemaPreset "basic")}}
+{{#if (eq provider "mongo")}}
+  const users: StarterUser[] = [];
+
+  for await (const user of db.orm.users.select("_id", "email", "name").take(limit).all()) {
+    users.push({
+      id: String(user._id),
+      email: user.email,
+      name: user.name ?? null,
+      createdAt: null,
+    });
+  }
+
+  return users;
+{{else}}
+  const users = await db.orm.User.select("id", "email", "name", "createdAt").take(limit).all();
+
+  return users.map((user) => ({
+    id: String(user.id),
+    email: user.email,
+    name: user.name ?? null,
+    createdAt: user.createdAt,
+  }));
+{{/if}}
+{{else}}
+  return [];
+{{/if}}
 }
+
+export default db;

package/templates/create/nest/src/prisma.service.ts.hbs

@@ -1,10 +1,11 @@
 import { Injectable } from "@nestjs/common";
-import { PrismaClient } from "./generated/prisma/client{{#if (eq packageManager "deno")}}.ts{{/if}}";
-import { prismaClientOptions } from "./lib/prisma{{#if (eq packageManager "deno")}}.ts{{/if}}";
+import { db, listUsers, type StarterUser } from "./lib/prisma{{#if (eq packageManager "deno")}}.ts{{/if}}";
 
 @Injectable()
-export class PrismaService extends PrismaClient {
-  constructor() {
-    super(prismaClientOptions);
+export class PrismaService {
+  readonly db = db;
+
+  listUsers(limit = 10): Promise<StarterUser[]> {
+    return listUsers(limit);
   }
 }

package/templates/create/nest/src/users.service.ts.hbs

@@ -8,12 +8,7 @@ export class UsersService {
   constructor(private readonly prisma: PrismaService) {}
 
   async findAll() {
-    return this.prisma.user.findMany({
-      take: 10,
-      orderBy: {
-        createdAt: "desc",
-      },
-    });
+    return this.prisma.listUsers(10);
   }
 }
 {{/if}}

package/templates/create/nest/tsconfig.json

@@ -3,6 +3,7 @@
     "target": "ES2022",
     "module": "ESNext",
     "moduleResolution": "Bundler",
+    "resolveJsonModule": true,
     "verbatimModuleSyntax": true,
     "strict": true,
     "esModuleInterop": true,

package/templates/create/next/README.md.hbs

@@ -8,23 +8,34 @@ Generated by `create-prisma` with the Next.js template.
 - `{{runScriptCommand packageManager "build"}}` - production build
 - `{{runScriptCommand packageManager "start"}}` - run production server
 
-## Prisma
+## Prisma Next
 
-Prisma setup is scaffolded automatically in:
+Prisma Next setup is scaffolded in:
 
-- `prisma/schema.prisma`
-- `prisma/seed.ts`
+- `prisma/contract{{#if (eq authoring "typescript")}}.ts{{else}}.prisma{{/if}}`
+- `prisma-next.config.ts`
 - `src/lib/prisma.ts`
-- `prisma.config.ts`
-- `src/generated/prisma`
 
 Database helper scripts are added to `package.json`:
 
-- `db:generate`
-- `db:push`
-- `db:migrate`
-- `db:seed`
+- `{{runScriptCommand packageManager "contract:emit"}}` - emit contract artifacts after contract changes
+{{#if (eq provider "mongo")}}
+- `{{runScriptCommand packageManager "db:up"}}` - start the local MongoDB replica set
+- `{{runScriptCommand packageManager "db:down"}}` - stop the local MongoDB replica set
+- `{{runScriptCommand packageManager "migration:plan"}}` - create a MongoDB migration plan
+- `{{runScriptCommand packageManager "migration:apply"}}` - apply the planned MongoDB migration
+{{else}}
+- `{{runScriptCommand packageManager "db:init"}}` - initialize database state manually
+- `{{runScriptCommand packageManager "db:update"}}` - update database state manually
+- `{{runScriptCommand packageManager "migration:plan"}}` - create a migration plan
+- `{{runScriptCommand packageManager "migration:apply"}}` - apply a planned migration
+{{/if}}
+{{#if (eq schemaPreset "basic")}}
+- `{{runScriptCommand packageManager "db:seed"}}` - insert sample users manually
+{{/if}}
+
+Node-based Prisma Next projects expect Node.js 24 LTS or newer.
 {{#if (eq schemaPreset "basic")}}
 
-The starter page in `src/app/page.tsx` reads from a basic `User` model so you can verify queries quickly, and `prisma/seed.ts` inserts starter users.
+The starter page in `src/app/page.tsx` reads from a basic `User` model so you can verify queries quickly after you initialize and apply your schema.
 {{/if}}

package/templates/create/next/deno.json.hbs

@@ -1,6 +1,6 @@
 {{#if (eq packageManager "deno")}}
 {
-  "nodeModulesDir": "auto",
+  "nodeModulesDir": "manual",
   "unstable": [
     "bare-node-builtins",
     "detect-cjs",

package/templates/create/next/prisma/contract.prisma.hbs

@@ -0,0 +1,44 @@
+{{#if (eq authoring "psl")}}
+// use prisma-next
+{{#if (eq schemaPreset "basic")}}
+{{#if (eq provider "mongo")}}
+
+model User {
+  id    ObjectId @id @map("_id")
+  email String   @unique
+  name  String?
+  posts Post[]
+
+  @@map("users")
+}
+
+model Post {
+  id       ObjectId @id @map("_id")
+  title    String
+  content  String?
+  author   User     @relation(fields: [authorId], references: [id])
+  authorId ObjectId
+
+  @@map("posts")
+}
+{{else}}
+
+model User {
+  id        Int      @id @default(autoincrement())
+  email     String   @unique
+  name      String?
+  posts     Post[]
+  createdAt DateTime @default(now())
+}
+
+model Post {
+  id        Int      @id @default(autoincrement())
+  title     String
+  content   String?
+  author    User     @relation(fields: [authorId], references: [id])
+  authorId  Int
+  createdAt DateTime @default(now())
+}
+{{/if}}
+{{/if}}
+{{/if}}