create-prisma 0.4.1 → 0.4.2-next.37.104.1

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

@@ -8,25 +8,35 @@ Generated by `create-prisma` with the Elysia 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}}typecheck and compile{{/if}}{{/if}}
 - `{{runScriptCommand packageManager "start"}}` - {{#if (eq packageManager "deno")}}run the server directly from `src/index.ts` with Deno{{else}}{{#if (eq packageManager "bun")}}run the server directly from `src/index.ts` with Bun{{else}}run compiled server from `dist/`{{/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"}}`
+## 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`
+
+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 with `mongodb-memory-server`. Data persists in `.mongo-data/` across restarts.
+- `{{runScriptCommand packageManager "db:down"}}` - stop the local MongoDB process (data preserved)
+- `{{runScriptCommand packageManager "db:reset"}}` - stop and wipe `.mongo-data/` for a clean slate
+- `{{runScriptCommand packageManager "migration:plan"}}` - create a MongoDB migration plan
+- `{{runScriptCommand packageManager "migrate"}}` - 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 "migrate"}}` - apply a planned migration
+{{/if}}
 
-4. Seed the database:
+- `{{runScriptCommand packageManager "db:seed"}}` - insert sample users manually
 
-`{{runScriptCommand packageManager "db:seed"}}`
+For provider-specific Prisma Next reference docs, see `prisma-next.md`. Prisma Next skills live in the upstream `skills/` directory: https://github.com/prisma/prisma-next/tree/main/skills.
 
-5. Use the Prisma client from `src/lib/prisma.ts`.
+Node-based Prisma Next projects expect Node.js 24 LTS or newer.
 
-Generated Prisma files are written to `src/generated/prisma`.
-{{#if (eq schemaPreset "basic")}}
+The template includes a basic `User` model and a sample `GET /users` endpoint.
 
-The template includes a basic `User` model, a sample `GET /users` endpoint, and seed data in `prisma/seed.ts`.
-{{/if}}

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

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

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

@@ -6,9 +6,8 @@ import "dotenv/config";
 import { node } from "@elysiajs/node";
 {{/if}}
 import { Elysia } from "elysia";
-{{#if (eq schemaPreset "basic")}}
-import { prisma } from "./lib/prisma{{#if (eq packageManager "deno")}}.ts{{/if}}";
-{{/if}}
+
+import { listUsers } from "./lib/prisma{{#if (eq packageManager "deno")}}.ts{{/if}}";
 
 const rawPort = ({{#if (eq packageManager "deno")}}Deno.env.get("PORT"){{else}}process.env.PORT{{/if}} ?? "").trim();
 const parsedPort = rawPort.length > 0 ? Number(rawPort) : Number.NaN;
@@ -21,16 +20,21 @@ const app = new Elysia({{#if (eq packageManager "deno")}}{{else}}{ adapter: node
       message: "hello from create-prisma + elysia",
     };
   })
-{{#if (eq schemaPreset "basic")}}
-  .get("/users", async () => {
-    return prisma.user.findMany({
-      take: 10,
-      orderBy: {
-        createdAt: "desc",
-      },
+
+  .get("/users", async ({ set }) => {
+    const users = await listUsers(10).catch((error) => {
+      console.error("Failed to query users:", error);
+      return undefined;
     });
+
+    if (!users) {
+      set.status = 500;
+      return { error: "Could not query users yet. Run contract:emit and apply your schema first." };
+    }
+
+    return users;
   })
-{{/if}}
+
 {{#if (eq packageManager "deno")}}
   ;
 

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

@@ -1,56 +1,73 @@
-{{#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 (eq provider "mongo")}}
+import mongo from "@prisma-next/mongo/runtime";
+{{else}}
+import postgres from "@prisma-next/postgres/runtime";
 {{/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 type { DefaultModelRow } from "@prisma-next/mongo-orm";
 {{else}}
-const databaseUrl = (rawDatabaseUrl ?? "").trim();
-if (!databaseUrl) {
-  throw new Error("DATABASE_URL is required");
-}
+import type { DefaultModelRow } from "@prisma-next/sql-orm-client";
 {{/if}}
 
-{{#if (eq provider "postgresql")}}
-const adapter = new PrismaPg({
-  connectionString: databaseUrl,
+import type { Contract } from "../../prisma/contract.d";
+import contractJson from "../../prisma/contract.json" with { type: "json" };
+
+{{#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,
-});
+
+type UserRow = DefaultModelRow<Contract, "User">;
+
+{{#if (eq provider "mongo")}}
+function toStarterUser(user: Pick<UserRow, "_id" | "email" | "username" | "name">) {
+  return {
+    id: String(user._id),
+    email: user.email,
+    username: user.username ?? null,
+    name: user.name ?? null,
+    createdAt: null as Date | null,
+  };
+}
+{{else}}
+function toStarterUser(user: Pick<UserRow, "id" | "email" | "username" | "name" | "createdAt">) {
+  return {
+    id: String(user.id),
+    email: user.email,
+    username: user.username ?? null,
+    name: user.name ?? null,
+    createdAt: user.createdAt,
+  };
+}
 {{/if}}
-{{#if (eq provider "sqlserver")}}
-const adapter = new PrismaMssql(databaseUrl);
+
+export async function listUsers(limit = 10) {
+
+{{#if (eq provider "mongo")}}
+  const users: ReturnType<typeof toStarterUser>[] = [];
+
+  for await (const user of db.orm.users.select("_id", "email", "username", "name").take(limit).all()) {
+    users.push(toStarterUser(user));
+  }
+
+  return users;
+{{else}}
+  const users = await db.orm.User.select("id", "email", "username", "name", "createdAt").take(limit).all();
+
+  return users.map(toStarterUser);
 {{/if}}
 
-const prisma = new PrismaClient({ adapter });
+}
+
+export type StarterUser = Awaited<ReturnType<typeof listUsers>>[number];
 
-export { prisma };
-export default prisma;
+export default db;

package/templates/create/elysia/tsconfig.json

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

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

@@ -8,25 +8,35 @@ Generated by `create-prisma` with the Hono 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}}typecheck and compile{{/if}}{{/if}}
 - `{{runScriptCommand packageManager "start"}}` - {{#if (eq packageManager "deno")}}run the server directly from `src/index.ts` with Deno{{else}}{{#if (eq packageManager "bun")}}run the server directly from `src/index.ts` with Bun{{else}}run compiled server from `dist/`{{/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"}}`
+## 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`
+
+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 with `mongodb-memory-server`. Data persists in `.mongo-data/` across restarts.
+- `{{runScriptCommand packageManager "db:down"}}` - stop the local MongoDB process (data preserved)
+- `{{runScriptCommand packageManager "db:reset"}}` - stop and wipe `.mongo-data/` for a clean slate
+- `{{runScriptCommand packageManager "migration:plan"}}` - create a MongoDB migration plan
+- `{{runScriptCommand packageManager "migrate"}}` - 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 "migrate"}}` - apply a planned migration
+{{/if}}
 
-4. Seed the database:
+- `{{runScriptCommand packageManager "db:seed"}}` - insert sample users manually
 
-`{{runScriptCommand packageManager "db:seed"}}`
+For provider-specific Prisma Next reference docs, see `prisma-next.md`. Prisma Next skills live in the upstream `skills/` directory: https://github.com/prisma/prisma-next/tree/main/skills.
 
-5. Use the Prisma client from `src/lib/prisma.ts`.
+Node-based Prisma Next projects expect Node.js 24 LTS or newer.
 
-Generated Prisma files are written to `src/generated/prisma`.
-{{#if (eq schemaPreset "basic")}}
+The template includes a basic `User` model and a sample `GET /users` endpoint.
 
-The template includes a basic `User` model, a sample `GET /users` endpoint, and seed data in `prisma/seed.ts`.
-{{/if}}

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

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

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

@@ -3,9 +3,8 @@ import "dotenv/config";
 {{/if}}
 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}}";
-{{/if}}
+
+import { listUsers } from "./lib/prisma{{#if (eq packageManager "deno")}}.ts{{/if}}";
 
 const app = new Hono();
 
@@ -14,19 +13,19 @@ app.get("/", (c) => {
     message: "hello from create-prisma + hono",
   });
 });
-{{#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}}
 
 const rawPort = ({{#if (eq packageManager "deno")}}Deno.env.get("PORT"){{else}}process.env.PORT{{/if}} ?? "").trim();
 const parsedPort = rawPort.length > 0 ? Number(rawPort) : Number.NaN;

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

@@ -1,56 +1,73 @@
-{{#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 (eq provider "mongo")}}
+import mongo from "@prisma-next/mongo/runtime";
+{{else}}
+import postgres from "@prisma-next/postgres/runtime";
 {{/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 type { DefaultModelRow } from "@prisma-next/mongo-orm";
 {{else}}
-const databaseUrl = (rawDatabaseUrl ?? "").trim();
-if (!databaseUrl) {
-  throw new Error("DATABASE_URL is required");
-}
+import type { DefaultModelRow } from "@prisma-next/sql-orm-client";
 {{/if}}
 
-{{#if (eq provider "postgresql")}}
-const adapter = new PrismaPg({
-  connectionString: databaseUrl,
+import type { Contract } from "../../prisma/contract.d";
+import contractJson from "../../prisma/contract.json" with { type: "json" };
+
+{{#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,
-});
+
+type UserRow = DefaultModelRow<Contract, "User">;
+
+{{#if (eq provider "mongo")}}
+function toStarterUser(user: Pick<UserRow, "_id" | "email" | "username" | "name">) {
+  return {
+    id: String(user._id),
+    email: user.email,
+    username: user.username ?? null,
+    name: user.name ?? null,
+    createdAt: null as Date | null,
+  };
+}
+{{else}}
+function toStarterUser(user: Pick<UserRow, "id" | "email" | "username" | "name" | "createdAt">) {
+  return {
+    id: String(user.id),
+    email: user.email,
+    username: user.username ?? null,
+    name: user.name ?? null,
+    createdAt: user.createdAt,
+  };
+}
 {{/if}}
-{{#if (eq provider "sqlserver")}}
-const adapter = new PrismaMssql(databaseUrl);
+
+export async function listUsers(limit = 10) {
+
+{{#if (eq provider "mongo")}}
+  const users: ReturnType<typeof toStarterUser>[] = [];
+
+  for await (const user of db.orm.users.select("_id", "email", "username", "name").take(limit).all()) {
+    users.push(toStarterUser(user));
+  }
+
+  return users;
+{{else}}
+  const users = await db.orm.User.select("id", "email", "username", "name", "createdAt").take(limit).all();
+
+  return users.map(toStarterUser);
 {{/if}}
 
-const prisma = new PrismaClient({ adapter });
+}
+
+export type StarterUser = Awaited<ReturnType<typeof listUsers>>[number];
 
-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/minimal/.yarnrc.yml.hbs

@@ -0,0 +1,3 @@
+{{#if (eq packageManager "yarn")}}
+nodeLinker: node-modules
+{{/if}}

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

@@ -0,0 +1,39 @@
+# {{projectName}}
+
+Generated by `create-prisma` with the Minimal template.
+
+## Scripts
+
+- `{{runScriptCommand packageManager "dev"}}` - run the Prisma Next sample script
+
+## Prisma Next
+
+Prisma Next setup is scaffolded in:
+
+- `prisma/contract{{#if (eq authoring "typescript")}}.ts{{else}}.prisma{{/if}}`
+- `prisma-next.config.ts`
+- `prisma/db.ts`
+- `src/lib/prisma.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 with `mongodb-memory-server`. Data persists in `.mongo-data/` across restarts.
+- `{{runScriptCommand packageManager "db:down"}}` - stop the local MongoDB process (data preserved)
+- `{{runScriptCommand packageManager "db:reset"}}` - stop and wipe `.mongo-data/` for a clean slate
+- `{{runScriptCommand packageManager "migration:plan"}}` - create a MongoDB migration plan
+- `{{runScriptCommand packageManager "migrate"}}` - 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 "migrate"}}` - apply a planned migration
+{{/if}}
+- `{{runScriptCommand packageManager "db:seed"}}` - insert sample users manually
+
+For provider-specific Prisma Next reference docs, see `prisma-next.md`. Prisma Next skills live in the upstream `skills/` directory: https://github.com/prisma/prisma-next/tree/main/skills.
+
+Node-based Prisma Next projects expect Node.js 24 LTS or newer.
+
+Run the migration and seed scripts first, then `{{runScriptCommand packageManager "dev"}}` runs a small write/read round trip from `src/index.ts`.

package/templates/create/{turborepo → minimal}/deno.json.hbs

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

package/templates/create/minimal/package.json.hbs

@@ -0,0 +1,13 @@
+{
+  "name": "{{projectName}}",
+  "private": true,
+  {{#if (packageManagerManifestValue packageManager)}}
+  "packageManager": "{{packageManagerManifestValue packageManager}}",
+  {{/if}}
+  "type": "module",
+  "scripts": {
+    "dev": "{{runtimeScript packageManager "start" "src/index.ts" ""}}"
+  },
+  "dependencies": {},
+  "devDependencies": {}
+}

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

@@ -0,0 +1,43 @@
+import { db, listUsers } from "./lib/prisma{{#if (eq packageManager "deno")}}.ts{{/if}}";
+
+const sampleUser = {
+  email: "first.user@prisma.io",
+  username: "first-user",
+  name: "First User",
+};
+
+async function main() {
+{{#if (eq provider "mongo")}}
+  const existingUser = await db.orm.users.where({ email: sampleUser.email }).first();
+  if (!existingUser) {
+    await db.orm.users.createCount([sampleUser]);
+  }
+
+  const user = await db.orm.users.where({ email: sampleUser.email }).first();
+{{else}}
+  const existingUser = await db.orm.User.where({ email: sampleUser.email }).first();
+  if (!existingUser) {
+    await db.orm.User.createCount([sampleUser]);
+  }
+
+  const user = await db.orm.User.where({ email: sampleUser.email }).first();
+{{/if}}
+  const users = await listUsers();
+
+  console.log(`Prisma Next is ready. Found ${users.length} user${users.length === 1 ? "" : "s"}.`);
+  console.log(user);
+}
+
+try {
+  await main();
+} catch (error) {
+  console.error("Prisma Next query failed.");
+  console.error("Emit the contract, set DATABASE_URL, then apply migrations before running this script.");
+  throw error;
+} finally {
+{{#if (eq provider "mongo")}}
+  await db.close();
+{{else}}
+  await db.runtime().close();
+{{/if}}
+}

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

@@ -0,0 +1,73 @@
+import "dotenv/config";
+{{#if (eq provider "mongo")}}
+import mongo from "@prisma-next/mongo/runtime";
+{{else}}
+import postgres from "@prisma-next/postgres/runtime";
+{{/if}}
+
+{{#if (eq provider "mongo")}}
+import type { DefaultModelRow } from "@prisma-next/mongo-orm";
+{{else}}
+import type { DefaultModelRow } from "@prisma-next/sql-orm-client";
+{{/if}}
+
+import type { Contract } from "../../prisma/contract.d";
+import contractJson from "../../prisma/contract.json" with { type: "json" };
+
+{{#if (eq provider "mongo")}}
+export const db = mongo<Contract>({
+  contractJson,
+  url: process.env["DATABASE_URL"]!,
+});
+{{else}}
+export const db = postgres<Contract>({
+  contractJson,
+  url: process.env["DATABASE_URL"]!,
+});
+{{/if}}
+
+type UserRow = DefaultModelRow<Contract, "User">;
+
+{{#if (eq provider "mongo")}}
+function toStarterUser(user: Pick<UserRow, "_id" | "email" | "username" | "name">) {
+  return {
+    id: String(user._id),
+    email: user.email,
+    username: user.username ?? null,
+    name: user.name ?? null,
+    createdAt: null as Date | null,
+  };
+}
+{{else}}
+function toStarterUser(user: Pick<UserRow, "id" | "email" | "username" | "name" | "createdAt">) {
+  return {
+    id: String(user.id),
+    email: user.email,
+    username: user.username ?? null,
+    name: user.name ?? null,
+    createdAt: user.createdAt,
+  };
+}
+{{/if}}
+
+export async function listUsers(limit = 10) {
+
+{{#if (eq provider "mongo")}}
+  const users: ReturnType<typeof toStarterUser>[] = [];
+
+  for await (const user of db.orm.users.select("_id", "email", "username", "name").take(limit).all()) {
+    users.push(toStarterUser(user));
+  }
+
+  return users;
+{{else}}
+  const users = await db.orm.User.select("id", "email", "username", "name", "createdAt").take(limit).all();
+
+  return users.map(toStarterUser);
+{{/if}}
+
+}
+
+export type StarterUser = Awaited<ReturnType<typeof listUsers>>[number];
+
+export default db;