create-prisma 0.4.2-next.37.81.1 → 0.4.2-next.37.83.1

package/README.md

@@ -11,9 +11,10 @@ Scaffold a new app with Prisma Next already wired up.
 - scaffolds `prisma/contract.prisma` or `prisma/contract.ts`
 - scaffolds `prisma-next.config.ts`
 - writes a template-specific Prisma Next runtime helper
-- adds `contract:emit`, `db:init`, `db:update`, `db:seed`, `migration:plan`, and `migration:apply` scripts
+- adds `contract:emit`, `db:init`, `db:update`, `db:verify`, `db:seed`, `migration:plan`, `migration:apply`, `migration:status`, and `migration:show` scripts
 - adds `db:up` / `db:down` and `docker-compose.yml` for default MongoDB projects
 - creates or updates `.env` with `DATABASE_URL`
+- writes `.env.example`, appends a Prisma Next reference to `README.md`, and scaffolds `.agents/skills/prisma-next/SKILL.md`
 - can install dependencies and run `prisma-next contract emit`
 
 `db:init`, migrations, and seeding are never run automatically. PostgreSQL projects show

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import "./create-C-bVmrxB.mjs";
+import "./create-CXc9jHIv.mjs";
 import { createCreatePrismaCli } from "./index.mjs";
 
 //#region src/cli.ts

package/dist/{create-C-bVmrxB.mjs → create-CXc9jHIv.mjs}

@@ -40,7 +40,7 @@ async function getAnonymousId() {
 }
 function getCommonProperties() {
 	return {
-		"cli-version": "0.4.2-next.37.81.1",
+		"cli-version": "0.4.2-next.37.83.1",
 		"node-version": process.version,
 		platform: process.platform,
 		arch: process.arch
@@ -149,9 +149,11 @@ const dependencyVersionMap = {
 	"@prisma-next/mongo": "0.4.4",
 	"@prisma-next/mongo-contract": "0.4.4",
 	"@prisma-next/mongo-contract-ts": "0.4.4",
+	"@prisma-next/mongo-orm": "0.4.4",
 	"@prisma-next/postgres": "0.4.4",
 	"@prisma-next/sql-contract": "0.4.4",
 	"@prisma-next/sql-contract-ts": "0.4.4",
+	"@prisma-next/sql-orm-client": "0.4.4",
 	"@prisma-next/target-mongo": "0.4.4",
 	"@prisma-next/target-postgres": "0.4.4",
 	"@types/node": "^25.6.2",
@@ -621,9 +623,12 @@ function getPrismaNextScriptMap(packageManager) {
 			"contract:emit": `${prismaNextCli} contract emit`,
 			"db:init": `${prismaNextCli} db init`,
 			"db:update": `${prismaNextCli} db update`,
+			"db:verify": `${prismaNextCli} db verify`,
 			"db:seed": "deno run -A --env-file=.env prisma/seed.ts",
 			"migration:plan": `${prismaNextCli} migration plan`,
-			"migration:apply": `${prismaNextCli} migration apply`
+			"migration:apply": `${prismaNextCli} migration apply`,
+			"migration:status": `${prismaNextCli} migration status`,
+			"migration:show": `${prismaNextCli} migration show`
 		};
 	}
 	if (packageManager === "bun") {
@@ -632,18 +637,24 @@ function getPrismaNextScriptMap(packageManager) {
 			"contract:emit": `${prismaNextCli} contract emit`,
 			"db:init": `${prismaNextCli} db init`,
 			"db:update": `${prismaNextCli} db update`,
+			"db:verify": `${prismaNextCli} db verify`,
 			"db:seed": "bun prisma/seed.ts",
 			"migration:plan": `${prismaNextCli} migration plan`,
-			"migration:apply": `${prismaNextCli} migration apply`
+			"migration:apply": `${prismaNextCli} migration apply`,
+			"migration:status": `${prismaNextCli} migration status`,
+			"migration:show": `${prismaNextCli} migration show`
 		};
 	}
 	return {
 		"contract:emit": "prisma-next contract emit",
 		"db:init": "prisma-next db init",
 		"db:update": "prisma-next db update",
+		"db:verify": "prisma-next db verify",
 		"db:seed": "tsx prisma/seed.ts",
 		"migration:plan": "prisma-next migration plan",
-		"migration:apply": "prisma-next migration apply"
+		"migration:apply": "prisma-next migration apply",
+		"migration:status": "prisma-next migration status",
+		"migration:show": "prisma-next migration show"
 	};
 }
 function getVersion(packageName) {
@@ -685,6 +696,10 @@ function getMigrationPackages(provider) {
 	if (provider === "mongo") return ["@prisma-next/family-mongo", "@prisma-next/target-mongo"];
 	return ["@prisma-next/target-postgres"];
 }
+function getOrmTypePackages(provider) {
+	if (provider === "mongo") return ["@prisma-next/mongo-orm"];
+	return ["@prisma-next/sql-orm-client"];
+}
 async function addPackageDependency(opts) {
 	const { dependencies = [], devDependencies = [], customDependencies = {}, scripts = {}, scriptMode, projectDir } = opts;
 	const pkgJsonPath = path.join(projectDir, "package.json");
@@ -722,9 +737,10 @@ async function writePrismaDependencies(provider, packageManager, authoring, proj
 		"@prisma-next/cli",
 		"@types/node"
 	];
+	devDependencies.push(...getGeneratedContractTypePackages(provider));
 	devDependencies.push(...getMigrationPackages(provider));
+	devDependencies.push(...getOrmTypePackages(provider));
 	if (authoring === "typescript") devDependencies.push(...getTypeScriptContractPackages(provider));
-	else if (packageManager === "deno") devDependencies.push(...getGeneratedContractTypePackages(provider));
 	await addPackageDependency({
 		dependencies,
 		devDependencies,
@@ -847,6 +863,11 @@ const mongoDockerScripts = {
 	"db:up": "docker compose up -d --wait",
 	"db:down": "docker compose down"
 };
+const minimumServerVersion = {
+	postgres: "14",
+	mongo: "6.0"
+};
+const readmeSectionMarker = "<!-- prisma-next-reference -->";
 const requiredPrismaFileGroups = [
 	[
 		"prisma/contract.prisma",
@@ -868,6 +889,275 @@ async function resolvePrismaProjectDir(projectDir) {
 	if (await fs.pathExists(path.join(monorepoDbDir, "prisma/contract.prisma")) || await fs.pathExists(path.join(monorepoDbDir, "prisma/contract.ts"))) return monorepoDbDir;
 	return projectDir;
 }
+function getDatabaseLabel(provider) {
+	return provider === "mongo" ? "MongoDB" : "PostgreSQL";
+}
+function getContractPath(authoring) {
+	return `prisma/contract${authoring === "typescript" ? ".ts" : ".prisma"}`;
+}
+function stripTypeScriptExtension(filePath) {
+	return filePath.endsWith(".ts") ? filePath.slice(0, -3) : filePath;
+}
+async function findFirstExistingRelativePath(projectDir, candidates) {
+	for (const candidate of candidates) if (await fs.pathExists(path.join(projectDir, candidate))) return candidate;
+}
+async function readPackageScripts(projectDir) {
+	const packageJsonPath = path.join(projectDir, "package.json");
+	if (!await fs.pathExists(packageJsonPath)) return {};
+	const packageJson = await fs.readJson(packageJsonPath);
+	return typeof packageJson.scripts === "object" && packageJson.scripts !== null ? packageJson.scripts : {};
+}
+async function writeFileIfMissing(filePath, content) {
+	if (await fs.pathExists(filePath)) return;
+	await fs.outputFile(filePath, content.endsWith("\n") ? content : `${content}\n`, "utf8");
+}
+async function appendReadmeSectionIfMissing(projectDir, content) {
+	const readmePath = path.join(projectDir, "README.md");
+	const section = `${readmeSectionMarker}\n${content.trim()}\n`;
+	if (!await fs.pathExists(readmePath)) {
+		await fs.outputFile(readmePath, `# Prisma Next\n\n${section}`, "utf8");
+		return;
+	}
+	const existingContent = await fs.readFile(readmePath, "utf8");
+	if (existingContent.includes(readmeSectionMarker)) return;
+	const separator = existingContent.endsWith("\n") ? "\n" : "\n\n";
+	await fs.writeFile(readmePath, `${existingContent}${separator}${section}`, "utf8");
+}
+function getEnvExampleContent(provider) {
+	const label = getDatabaseLabel(provider);
+	const minVersion = minimumServerVersion[provider];
+	const databaseUrl = provider === "mongo" ? "mongodb://localhost:27017/mydb?replicaSet=rs0&directConnection=true" : "postgresql://user:password@localhost:5432/mydb";
+	return [
+		"# Copy this file to .env and replace the placeholder with your connection string.",
+		`# Requires ${label} >= ${minVersion}.`,
+		`DATABASE_URL="${databaseUrl}"`,
+		""
+	].join("\n");
+}
+function formatCommandListItem(packageManager, scriptName, description) {
+	return `- \`${getRunScriptCommand(packageManager, scriptName)}\` - ${description}`;
+}
+function getPrismaNextReadmeSectionContent(options) {
+	const { provider, authoring, schemaPreset, packageManager, schemaPath, dbImportPath, scripts, rootScripts } = options;
+	const label = getDatabaseLabel(provider);
+	const minVersion = minimumServerVersion[provider];
+	const hasWorkspaceRootDbUp = typeof scripts["db:up"] !== "string" && typeof rootScripts["db:up"] === "string";
+	const hasDbUp = typeof scripts["db:up"] === "string" || hasWorkspaceRootDbUp;
+	const commandLines = [
+		formatCommandListItem(packageManager, "contract:emit", "emit contract.json and contract.d.ts after contract changes"),
+		...hasDbUp ? [formatCommandListItem(packageManager, "db:up", hasWorkspaceRootDbUp ? "start the local MongoDB replica set with Docker from the workspace root" : "start the local MongoDB replica set with Docker")] : [],
+		formatCommandListItem(packageManager, "db:init", "bootstrap a new database from the contract"),
+		formatCommandListItem(packageManager, "db:update", "apply contract changes directly after confirmation"),
+		formatCommandListItem(packageManager, "db:verify", "compare the live database state against the contract"),
+		formatCommandListItem(packageManager, "migration:plan", "write an offline migration plan from contract changes"),
+		formatCommandListItem(packageManager, "migration:apply", "apply pending migrations"),
+		formatCommandListItem(packageManager, "migration:status", "show applied and pending migrations"),
+		formatCommandListItem(packageManager, "migration:show", "inspect a planned migration"),
+		...schemaPreset === "basic" ? [formatCommandListItem(packageManager, "db:seed", "insert starter sample data")] : []
+	];
+	const workflowLines = provider === "mongo" ? [
+		"1. Start MongoDB with Docker if you are using the generated local database.",
+		"2. Run `contract:emit` after editing the contract.",
+		"3. Run `migration:plan` and review the generated migration.",
+		"4. Run `migration:apply` to apply pending migrations.",
+		...schemaPreset === "basic" ? ["5. Run `db:seed` if you want the starter sample data."] : []
+	] : [
+		"1. Run `contract:emit` after editing the contract.",
+		"2. For first-time setup, run `db:init` to create and sign the database state.",
+		"3. For later contract changes, run `migration:plan` and `migration:apply`.",
+		...schemaPreset === "basic" ? ["4. Run `db:seed` if you want the starter sample data."] : []
+	];
+	const queryExample = provider === "mongo" ? [
+		"```ts",
+		`import { db } from "${dbImportPath}";`,
+		"",
+		"for await (const user of db.orm.users.select(\"_id\", \"email\").take(10).all()) {",
+		"  console.log(user.email);",
+		"}",
+		"```",
+		"",
+		"MongoDB accessors use the emitted collection names, so the starter `User` model is queried through `db.orm.users`. The Mongo facade connects lazily on the first query; call `db.close()` when a script is done. Use `db.query` for typed aggregation pipelines when the ORM cannot express a query."
+	] : [
+		"```ts",
+		`import { db } from "${dbImportPath}";`,
+		"",
+		"const users = await db.orm.User.select(\"id\", \"email\").take(10).all();",
+		"```",
+		"",
+		"PostgreSQL models use their contract model names, so the starter `User` model is queried through `db.orm.User`. Prefer `db.orm` for application queries and use raw SQL only when the ORM does not cover the operation."
+	];
+	return [
+		"## Prisma Next Reference",
+		"",
+		`This project uses Prisma Next with ${label}. The contract is authored in ${authoring === "typescript" ? "TypeScript" : "PSL"} at \`${schemaPath}\`.`,
+		"",
+		"## Requirements",
+		"",
+		`- ${label} ${minVersion} or newer.`,
+		"- The generated `.env.example` shows the expected `DATABASE_URL` shape.",
+		...provider === "mongo" ? ["- The generated Docker Compose setup starts MongoDB as a replica set for local migration workflows."] : [],
+		"",
+		"## Contract Artifacts",
+		"",
+		"Prisma Next emits two generated files next to the contract:",
+		"",
+		"- `prisma/contract.json` - runtime contract metadata",
+		"- `prisma/contract.d.ts` - TypeScript types for the contract",
+		"",
+		"Commit both generated files. Do not edit either one by hand.",
+		"",
+		"## Query Example",
+		"",
+		...queryExample,
+		"",
+		"## Commands",
+		"",
+		...commandLines,
+		"",
+		"## Workflow",
+		"",
+		...workflowLines,
+		""
+	].join("\n");
+}
+function getPrismaNextAgentSkillContent(options) {
+	const { provider, authoring, schemaPreset, packageManager, schemaPath, dbImportPath, scripts, rootScripts } = options;
+	const label = getDatabaseLabel(provider);
+	const runtimePackage = provider === "mongo" ? "@prisma-next/mongo" : "@prisma-next/postgres";
+	const hasWorkspaceRootDbUp = typeof scripts["db:up"] !== "string" && typeof rootScripts["db:up"] === "string";
+	const hasDbUp = typeof scripts["db:up"] === "string" || hasWorkspaceRootDbUp;
+	const commands = [
+		formatCommandListItem(packageManager, "contract:emit", "regenerate contract artifacts"),
+		...hasDbUp ? [formatCommandListItem(packageManager, "db:up", hasWorkspaceRootDbUp ? "start local MongoDB with Docker from the workspace root" : "start local MongoDB with Docker")] : [],
+		formatCommandListItem(packageManager, "db:init", "bootstrap a new database"),
+		formatCommandListItem(packageManager, "db:update", "apply contract changes directly"),
+		formatCommandListItem(packageManager, "db:verify", "verify database state against the contract"),
+		formatCommandListItem(packageManager, "migration:plan", "create an offline migration plan"),
+		formatCommandListItem(packageManager, "migration:apply", "apply pending migrations"),
+		formatCommandListItem(packageManager, "migration:status", "show migration status"),
+		formatCommandListItem(packageManager, "migration:show", "inspect a migration"),
+		...schemaPreset === "basic" ? [formatCommandListItem(packageManager, "db:seed", "insert starter sample data")] : []
+	];
+	const queryGuidance = provider === "mongo" ? [
+		"- Use `db.orm`. Mongo root accessors are lowercased plural collection names emitted by `contract:emit`, for example `db.orm.users` and `db.orm.posts`.",
+		"- `.all()` returns an async iterable result. Consume it with `for await` or await it to materialize an array.",
+		"- Use `db.query` for typed aggregation pipelines when the ORM cannot express a query.",
+		"- For direct MongoDB driver control, construct your own `MongoClient` and pass it through the `mongoClient` binding; keep that raw client reference for sessions, transactions, and change streams.",
+		"- Do not use `db.runtime()` as a raw driver escape hatch. It returns Prisma Next's internal executor, not a `mongodb` `MongoClient` or `Db`.",
+		"- The Mongo client connects lazily on the first query. Short-lived scripts should call `await db.close()` in `finally`.",
+		"- Multi-document transactions and change streams require MongoDB to run as a replica set. The generated local Docker setup does this."
+	] : [
+		"- Use `db.orm`. PostgreSQL root accessors follow contract model names, for example `db.orm.User` and `db.orm.Post`.",
+		"- Prefer `db.orm` for application queries. Use raw SQL only when the ORM cannot express the operation or the user explicitly asks for it.",
+		"- `.where(...)`, `.select(...)`, `.orderBy(...)`, `.take(...)`, `.all()`, `.first()`, and `.include(...)` are the primary ORM query methods.",
+		"- Short-lived scripts should close the runtime with `await db.runtime().close()` when needed."
+	];
+	const queryExamples = provider === "mongo" ? [
+		"```ts",
+		`import { db } from "${dbImportPath}";`,
+		"",
+		"const user = await db.orm.users.where({ email: \"alice@example.com\" }).first();",
+		"",
+		"for await (const user of db.orm.users.select(\"_id\", \"email\").take(10).all()) {",
+		"  console.log(user.email);",
+		"}",
+		"",
+		"const usersWithPosts = await db.orm.users",
+		"  .select(\"_id\", \"email\")",
+		"  .include(\"posts\")",
+		"  .take(10)",
+		"  .all();",
+		"```"
+	] : [
+		"```ts",
+		`import { db } from "${dbImportPath}";`,
+		"",
+		"const user = await db.orm.User",
+		"  .where((user) => user.email.eq(\"alice@example.com\"))",
+		"  .first();",
+		"",
+		"const users = await db.orm.User.select(\"id\", \"email\").take(10).all();",
+		"",
+		"const usersWithPosts = await db.orm.User",
+		"  .select(\"id\", \"email\")",
+		"  .include(\"posts\", (post) => post.select(\"id\", \"title\").take(5))",
+		"  .take(10)",
+		"  .all();",
+		"```"
+	];
+	return [
+		"# Prisma Next - Project Skill",
+		"",
+		`This project uses **Prisma Next** with **${label}** via \`${runtimePackage}\`. The contract is \`${schemaPath}\` using ${authoring === "typescript" ? "TypeScript" : "PSL"} authoring.`,
+		"",
+		"## Files",
+		"",
+		`- **Contract**: \`${schemaPath}\` - edit this to add or change models.`,
+		"- **Config**: `prisma-next.config.ts` - tells the CLI where the contract is and how to connect to the database.",
+		`- **Database helper**: import \`db\` from \`${dbImportPath}\`. This is the entry point for queries.`,
+		"- **Generated files**: `prisma/contract.json` and `prisma/contract.d.ts`. Do not edit these by hand.",
+		"",
+		"## Commands",
+		"",
+		...commands,
+		"",
+		"## How To Write Queries",
+		"",
+		...queryExamples,
+		"",
+		"## Rules",
+		"",
+		"- Never hand-edit `contract.json` or `contract.d.ts`. Regenerate them with `contract:emit`.",
+		"- Always run `contract:emit` after changing the contract before writing code that depends on the changed models.",
+		"- Do not auto-run `db:init`, migrations, or seed commands. These are manual project-owner actions.",
+		"- Do not restructure the generated database helper unless the user explicitly asks.",
+		"- `DATABASE_URL` lives in `.env`; `.env.example` documents the expected shape and minimum server version.",
+		...queryGuidance,
+		"",
+		"## Common Workflow",
+		"",
+		"- Edit the contract.",
+		"- Run `contract:emit`.",
+		"- For a new database, run `db:init`.",
+		"- For existing databases, run `migration:plan`, review it, then run `migration:apply`.",
+		"- Run `db:verify` or `migration:status` when checking state.",
+		""
+	].join("\n");
+}
+async function writePrismaNextProjectDocs(options) {
+	const prismaProjectDir = await resolvePrismaProjectDir(options.projectDir);
+	const schemaPath = getContractPath(options.authoring);
+	const dbImportPath = `./${stripTypeScriptExtension(await findFirstExistingRelativePath(prismaProjectDir, [
+		"src/lib/prisma.ts",
+		"src/lib/prisma.server.ts",
+		"src/lib/server/prisma.ts",
+		"server/utils/prisma.ts",
+		"src/client.ts"
+	]) ?? "src/lib/prisma.ts")}`;
+	const scripts = await readPackageScripts(prismaProjectDir);
+	const rootScripts = await readPackageScripts(options.projectDir);
+	await writeFileIfMissing(path.join(prismaProjectDir, ".env.example"), getEnvExampleContent(options.provider));
+	await appendReadmeSectionIfMissing(prismaProjectDir, getPrismaNextReadmeSectionContent({
+		provider: options.provider,
+		authoring: options.authoring,
+		schemaPreset: options.schemaPreset,
+		packageManager: options.packageManager,
+		schemaPath,
+		dbImportPath,
+		scripts,
+		rootScripts
+	}));
+	await writeFileIfMissing(path.join(prismaProjectDir, ".agents/skills/prisma-next/SKILL.md"), getPrismaNextAgentSkillContent({
+		provider: options.provider,
+		authoring: options.authoring,
+		schemaPreset: options.schemaPreset,
+		packageManager: options.packageManager,
+		schemaPath,
+		dbImportPath,
+		scripts,
+		rootScripts
+	}));
+}
 async function promptForDatabaseProvider() {
 	const databaseProvider = await select({
 		message: "Select your database",
@@ -1239,6 +1529,21 @@ async function finalizePrismaFilesForContext(context, projectDir, provisionResul
 		return false;
 	}
 }
+async function writePrismaNextProjectDocsForContext(context, projectDir) {
+	try {
+		await writePrismaNextProjectDocs({
+			provider: context.databaseProvider,
+			authoring: context.authoring,
+			schemaPreset: context.schemaPreset,
+			packageManager: context.packageManager,
+			projectDir
+		});
+		return true;
+	} catch (error) {
+		cancel(getCommandErrorMessage(error));
+		return false;
+	}
+}
 function getPrismaNextCliCommand(packageManager, prismaNextArgs) {
 	if (packageManager === "deno") return `deno run -A --env-file=.env npm:prisma-next@${dependencyVersionMap["prisma-next"]} ${prismaNextArgs.join(" ")}`;
 	return getLocalPackageBinaryCommand(packageManager, "prisma-next", prismaNextArgs);
@@ -1339,6 +1644,7 @@ async function executePrismaSetupContext(context, options = {}) {
 	if (!await installDependenciesForContext(context, projectDir)) return false;
 	if (!await finalizePrismaFilesForContext(context, projectDir, provisionResult)) return false;
 	if (!await writeMongoDockerHelpersForContext(context, projectDir)) return false;
+	if (!await writePrismaNextProjectDocsForContext(context, projectDir)) return false;
 	const emitResult = await emitPrismaNextContractForContext(context, projectDir);
 	const warningLines = buildWarningLines(provisionResult.warning, emitResult.warning);
 	const nextSteps = buildNextStepsForContext({

package/dist/index.mjs

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { a as DatabaseProviderSchema, c as SchemaPresetSchema, i as CreateTemplateSchema, n as AuthoringStyleSchema, o as DatabaseUrlSchema, r as CreateCommandInputSchema, s as PackageManagerSchema, t as runCreateCommand } from "./create-C-bVmrxB.mjs";
+import { a as DatabaseProviderSchema, c as SchemaPresetSchema, i as CreateTemplateSchema, n as AuthoringStyleSchema, o as DatabaseUrlSchema, r as CreateCommandInputSchema, s as PackageManagerSchema, t as runCreateCommand } from "./create-CXc9jHIv.mjs";
 import { os } from "@orpc/server";
 import { createCli } from "trpc-cli";
 
 //#region src/index.ts
-const CLI_VERSION = "0.4.2-next.37.81.1";
+const CLI_VERSION = "0.4.2-next.37.83.1";
 const router = os.router({ create: os.meta({
 	description: "Create a new project with Prisma setup",
 	default: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-prisma",
-  "version": "0.4.2-next.37.81.1",
+  "version": "0.4.2-next.37.83.1",
   "private": false,
   "description": "Create Prisma Next projects with first-party templates and great DX.",
   "homepage": "https://github.com/prisma/create-prisma",

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

@@ -36,6 +36,8 @@ Database helper scripts are added to `package.json`:
 - `{{runScriptCommand packageManager "db:seed"}}` - insert sample users manually
 {{/if}}
 
+This README includes provider-specific Prisma Next reference notes below. Agent-specific project guidance is scaffolded in `.agents/skills/prisma-next/SKILL.md`.
+
 Node-based Prisma Next projects expect Node.js 24 LTS or newer.
 {{#if (eq schemaPreset "basic")}}
 

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

@@ -4,6 +4,13 @@ import mongo from "@prisma-next/mongo/runtime";
 {{else}}
 import postgres from "@prisma-next/postgres/runtime";
 {{/if}}
+{{#if (eq schemaPreset "basic")}}
+{{#if (eq provider "mongo")}}
+import type { DefaultModelRow } from "@prisma-next/mongo-orm";
+{{else}}
+import type { DefaultModelRow } from "@prisma-next/sql-orm-client";
+{{/if}}
+{{/if}}
 import type { Contract } from "../../prisma/contract.d";
 import contractJson from "../../prisma/contract.json" with { type: "json" };
 
@@ -19,41 +26,50 @@ export const db = postgres<Contract>({
 });
 {{/if}}
 
-export type StarterUser = {
-  id: string;
-  email: string;
-  name: string | null;
-  createdAt: Date | null;
-};
+{{#if (eq schemaPreset "basic")}}
+type UserRow = DefaultModelRow<Contract, "User">;
+
+{{#if (eq provider "mongo")}}
+function toStarterUser(user: Pick<UserRow, "_id" | "email" | "name">) {
+  return {
+    id: String(user._id),
+    email: user.email,
+    name: user.name ?? null,
+    createdAt: null,
+  };
+}
+{{else}}
+function toStarterUser(user: Pick<UserRow, "id" | "email" | "name" | "createdAt">) {
+  return {
+    id: String(user.id),
+    email: user.email,
+    name: user.name ?? null,
+    createdAt: user.createdAt,
+  };
+}
+{{/if}}
+{{/if}}
 
-export async function listUsers(limit = 10): Promise<StarterUser[]> {
+export async function listUsers(limit = 10) {
 {{#if (eq schemaPreset "basic")}}
 {{#if (eq provider "mongo")}}
-  const users: StarterUser[] = [];
+  const users: ReturnType<typeof toStarterUser>[] = [];
 
   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,
-    });
+    users.push(toStarterUser(user));
   }
 
   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,
-  }));
+  return users.map(toStarterUser);
 {{/if}}
 {{else}}
   return [];
 {{/if}}
 }
 
+export type StarterUser = Awaited<ReturnType<typeof listUsers>>[number];
+
 export default db;

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

@@ -34,6 +34,8 @@ Database helper scripts are added to `package.json`:
 - `{{runScriptCommand packageManager "db:seed"}}` - insert sample users manually
 {{/if}}
 
+This README includes provider-specific Prisma Next reference notes below. Agent-specific project guidance is scaffolded in `.agents/skills/prisma-next/SKILL.md`.
+
 Node-based Prisma Next projects expect Node.js 24 LTS or newer.
 {{#if (eq schemaPreset "basic")}}
 

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

@@ -4,6 +4,13 @@ import mongo from "@prisma-next/mongo/runtime";
 {{else}}
 import postgres from "@prisma-next/postgres/runtime";
 {{/if}}
+{{#if (eq schemaPreset "basic")}}
+{{#if (eq provider "mongo")}}
+import type { DefaultModelRow } from "@prisma-next/mongo-orm";
+{{else}}
+import type { DefaultModelRow } from "@prisma-next/sql-orm-client";
+{{/if}}
+{{/if}}
 import type { Contract } from "../../prisma/contract.d";
 import contractJson from "../../prisma/contract.json" with { type: "json" };
 
@@ -19,41 +26,50 @@ export const db = postgres<Contract>({
 });
 {{/if}}
 
-export type StarterUser = {
-  id: string;
-  email: string;
-  name: string | null;
-  createdAt: Date | null;
-};
+{{#if (eq schemaPreset "basic")}}
+type UserRow = DefaultModelRow<Contract, "User">;
+
+{{#if (eq provider "mongo")}}
+function toStarterUser(user: Pick<UserRow, "_id" | "email" | "name">) {
+  return {
+    id: String(user._id),
+    email: user.email,
+    name: user.name ?? null,
+    createdAt: null,
+  };
+}
+{{else}}
+function toStarterUser(user: Pick<UserRow, "id" | "email" | "name" | "createdAt">) {
+  return {
+    id: String(user.id),
+    email: user.email,
+    name: user.name ?? null,
+    createdAt: user.createdAt,
+  };
+}
+{{/if}}
+{{/if}}
 
-export async function listUsers(limit = 10): Promise<StarterUser[]> {
+export async function listUsers(limit = 10) {
 {{#if (eq schemaPreset "basic")}}
 {{#if (eq provider "mongo")}}
-  const users: StarterUser[] = [];
+  const users: ReturnType<typeof toStarterUser>[] = [];
 
   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,
-    });
+    users.push(toStarterUser(user));
   }
 
   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,
-  }));
+  return users.map(toStarterUser);
 {{/if}}
 {{else}}
   return [];
 {{/if}}
 }
 
+export type StarterUser = Awaited<ReturnType<typeof listUsers>>[number];
+
 export default db;

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

@@ -34,6 +34,8 @@ Database helper scripts are added to `package.json`:
 - `{{runScriptCommand packageManager "db:seed"}}` - insert sample users manually
 {{/if}}
 
+This README includes provider-specific Prisma Next reference notes below. Agent-specific project guidance is scaffolded in `.agents/skills/prisma-next/SKILL.md`.
+
 Node-based Prisma Next projects expect Node.js 24 LTS or newer.
 {{#if (eq schemaPreset "basic")}}