better-supabase 0.12.0 → 0.13.0

package/dist/cli/scaffold-DoURlDEI.js

@@ -1,898 +0,0 @@
-import { a as list, p as commandMeta, r as defineCliCommand } from "./command-dfdVhU_2.js";
-import { n as CliError } from "./errors-Caiz_0so.js";
-import { t as display } from "./io-BiPX-_J1.js";
-import { t as isRecord } from "./guards-CUlDNYZs.js";
-import { d as applyCasing, i as metaPaths } from "./emit-56LAG_Px.js";
-import { t as importFresh } from "./fresh-import-BeYf9I3x.js";
-import { a as hasConflicts, n as applyPlan, r as changeLines, s as planResult, t as PLAN_ARGS } from "./files-DDvAwTko.js";
-import { t as detectProject } from "./detect-DQsVeBHg.js";
-import { existsSync } from "node:fs";
-import { posix, resolve } from "node:path";
-import { FIELD_FORMATS } from "better-supabase/config";
-//#region src/cli/scaffold/api.ts
-const SCAFFOLD_FRAMEWORKS = ["hono", "next"];
-const GENERATED_HEADER = "// @generated by better-supabase scaffold. Do not edit; run `better-supabase scaffold api` again instead.";
-const join$2 = (...parts) => posix.normalize(posix.join(...parts));
-function importFrom$1(context, from, to) {
-	let path = posix.relative(posix.dirname(from), to);
-	if (!path.startsWith(".")) path = `./${path}`;
-	if (context.tsExtensions) return path;
-	return path.replace(/\.tsx?$/, "").replace(/^(\.\.?\/.+)\/index$/, "$1");
-}
-const quote$2 = (value) => JSON.stringify(value);
-function generatedModule(context) {
-	const names = context.tables.map(quote$2).join(", ");
-	const resources = context.tables.map((table) => `  ${/^[A-Za-z_$][\w$]*$/.test(table) ? table : quote$2(table)}: true,`).join("\n");
-	return `${GENERATED_HEADER}
-
-/** The tables served as REST resources and documented in the API model. */
-export const tableNames = [${names}] as const;
-
-export const resources = {
-${resources}
-} as const;
-
-export const basePath = ${quote$2(context.basePath)};
-`;
-}
-function apiModule(context, path, generated) {
-	return `import { defineApi } from 'better-supabase/spec';
-
-import { betterSupabase } from '${importFrom$1(context, path, join$2(context.srcDir, "lib", "supabase", "index.ts"))}';
-import { basePath, resources, tableNames } from '${importFrom$1(context, path, generated)}';
-
-export { basePath, resources, tableNames };
-
-/**
- * The API model. Every OpenAPI version, and the other spec formats, render
- * from it, and \`better-supabase spec emit\` reads it. Describe resources,
- * add list queries and custom routes here: this file is yours, and
- * \`better-supabase scaffold api\` never rewrites it.
- */
-export const api = defineApi(betterSupabase, {
-  info: { title: 'API', version: '1.0.0' },
-  basePath,
-  resources,
-});
-`;
-}
-function nextFiles(context, api) {
-	const routeDir = join$2(context.srcDir, "app", context.basePath);
-	const resources = join$2(routeDir, "[...path]", "route.ts");
-	const spec = join$2(routeDir, "openapi.json", "route.ts");
-	const server = join$2(context.srcDir, "lib", "supabase", "server.ts");
-	return [{
-		path: resources,
-		generated: false,
-		contents: `import { basePath, resources } from '${importFrom$1(context, resources, api)}';
-import { bs } from '${importFrom$1(context, resources, server)}';
-
-export const { GET, POST, PATCH, PUT, DELETE } = bs.resources(resources, { basePath });
-`
-	}, {
-		path: spec,
-		generated: false,
-		contents: `import { specResponse } from 'better-supabase/spec';
-
-import { api } from '${importFrom$1(context, spec, api)}';
-
-const { document } = api.openapi();
-
-export const GET = (request: Request) => specResponse(document, request);
-`
-	}];
-}
-function honoFiles(context, api) {
-	const path = join$2(context.srcDir, `${context.name}-routes.ts`);
-	const server = join$2(context.srcDir, "server.ts");
-	return [{
-		path,
-		generated: false,
-		contents: `import { specResponse } from 'better-supabase/spec';
-
-import { api, basePath, tableNames } from '${importFrom$1(context, path, api)}';
-import type { bs as server } from '${importFrom$1(context, path, server)}';
-
-const { document } = api.openapi();
-
-/**
- * The OpenAPI document and a REST resource per table. Mount it in
- * server.ts with \`.route('/', apiRoutes(bs))\`.
- */
-export function apiRoutes(bs: typeof server) {
-  const routes = bs
-    .app()
-    .get(\`\${basePath}/openapi.json\`, (c) => specResponse(document, c.req.raw))
-    .use(\`\${basePath}/*\`, bs.middleware());
-  for (const table of tableNames) routes.route(\`\${basePath}/\${table}\`, bs.resource(table));
-  return routes;
-}
-`
-	}];
-}
-/** The files `scaffold api` writes for a framework. */
-function scaffoldApiFiles(context) {
-	const lib = join$2(context.srcDir, "lib");
-	const generated = join$2(lib, `${context.name}.generated.ts`);
-	const api = join$2(lib, `${context.name}.ts`);
-	const shared = [{
-		path: generated,
-		generated: true,
-		contents: generatedModule(context)
-	}, {
-		path: api,
-		generated: false,
-		contents: apiModule(context, api, generated)
-	}];
-	switch (context.framework) {
-		case "next": return [...shared, ...nextFiles(context, api)];
-		case "hono": return [...shared, ...honoFiles(context, api)];
-		default: {
-			const unknown = context.framework;
-			throw new Error(`Unknown framework: ${String(unknown)}`);
-		}
-	}
-}
-/** What to do after the files are written. */
-function scaffoldNextSteps(context, specsEntry) {
-	const api = join$2(context.srcDir, "lib", `${context.name}.ts`);
-	const steps = [];
-	if (context.framework === "hono") steps.push(`Mount the routes in ${join$2(context.srcDir, "server.ts")}: \`.route('/', apiRoutes(bs))\`.`);
-	if (specsEntry !== api) steps.push(`Set \`specs: { entry: '${api}' }\` in better-supabase.config.ts, so \`better-supabase spec emit\` reads the API model.`);
-	steps.push(`Describe the resources in ${api}; \`scaffold api\` only rewrites ${context.name}.generated.ts.`);
-	return steps;
-}
-//#endregion
-//#region src/cli/scaffold/screens.ts
-/** Thrown for a table the screens can't serve; the message is for the user. */
-var ScreensError = class extends Error {};
-const NEXT_NAVIGATION = "next/navigation";
-const FUNCTION_DEFAULTS = /* @__PURE__ */ new Set([
-	"now()",
-	"gen_random_uuid()",
-	"auth.uid()"
-]);
-const quote$1 = (value) => `'${value.replaceAll("'", "\\'")}'`;
-const join$1 = (...parts) => posix.normalize(posix.join(...parts));
-const pascal = (name) => name.split("_").map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");
-function labelOf(column) {
-	const text = column.replace(/_id$/, "").split("_").join(" ");
-	return text.charAt(0).toUpperCase() + text.slice(1);
-}
-function importFrom(context, from, to) {
-	let path = posix.relative(posix.dirname(from), to);
-	if (!path.startsWith(".")) path = `./${path}`;
-	return context.tsExtensions ? path : path.replace(/\.tsx?$/, "");
-}
-/** The literal a form starts from, or undefined for none or a function default. */
-function literalDefault(value) {
-	if (value === void 0 || FUNCTION_DEFAULTS.has(value)) return;
-	return value.replace(/^'(.*)'$/, "$1");
-}
-/** The first text column, which names a row on the list and in pickers. */
-function titleColumn(table) {
-	const columns = Object.entries(table.columns ?? {});
-	return table.subject?.title ?? columns.find(([, column]) => column.type === "text")?.[0] ?? "id";
-}
-function inputOf(column, config) {
-	if (column.identity === true || FUNCTION_DEFAULTS.has(column.default ?? "")) return;
-	if (column.references !== void 0) return "reference";
-	switch (column.type) {
-		case "text":
-			if (column.options !== void 0) return "select";
-			return column.format === void 0 ? "text" : FIELD_FORMATS[column.format].input;
-		case "uuid": return "text";
-		case "integer":
-		case "bigint":
-		case "numeric": return "number";
-		case "boolean": return "checkbox";
-		case "date": return "date";
-		case "timestamptz": return config.codecs.timestamptz === "string" ? "datetime" : void 0;
-		case "jsonb":
-		case "text[]": return;
-		default: {
-			const unknown = column.type;
-			throw new Error(`Unknown column type: ${String(unknown)}`);
-		}
-	}
-}
-function fieldsOf(context, table) {
-	const { config } = context;
-	return Object.entries(table.columns ?? {}).map(([column, settings]) => {
-		const input = inputOf(settings, config);
-		const reference = settings.references;
-		const targetTable = reference !== void 0 && !("block" in reference) ? config.appTables[reference.table] : void 0;
-		if (input === void 0 && settings.nullable === false && settings.default === void 0 && settings.identity !== true) throw new ScreensError(`${context.table}.${column} is required, but the form has no input for a ${settings.type} column. Give it a default or make it nullable.`);
-		return {
-			column,
-			prop: applyCasing(column, config.casing),
-			label: labelOf(column),
-			config: settings,
-			input: input === "reference" && !targetTable ? "text" : input,
-			initial: literalDefault(settings.default),
-			target: targetTable && reference ? {
-				key: applyCasing(reference.table, config.casing),
-				title: applyCasing(titleColumn(targetTable), config.casing)
-			} : void 0
-		};
-	});
-}
-/** How a form value becomes the column's type, given the generated codecs. */
-function parseExpression(field, config) {
-	const name = quote$1(field.column);
-	if (field.input === "checkbox") return `form.get(${name}) === 'on'`;
-	const required = field.config.nullable === false;
-	const read = required ? `required(form, ${name})` : `optional(form, ${name})`;
-	const wrap = (parse) => required ? `${parse}(${read})` : `map(${read}, ${parse})`;
-	if (field.config.options !== void 0 && field.config.type === "text") {
-		const options = `[${field.config.options.map(quote$1).join(", ")}] as const`;
-		return required ? `oneOf(${read}, ${options})` : `map(${read}, (value) => oneOf(value, ${options}))`;
-	}
-	const { type } = field.config;
-	if (type === "integer") return wrap("Number");
-	if (type === "bigint") return INT8_PARSERS[config.codecs.int8](read, wrap);
-	if (type === "numeric") return config.codecs.numeric === "string" ? read : wrap("Number");
-	return type === "timestamptz" ? wrap("toTimestamp") : read;
-}
-const INT8_PARSERS = {
-	bigint: (_read, wrap) => wrap("BigInt"),
-	string: (read) => read,
-	number: (_read, wrap) => wrap("Number")
-};
-function namesOf(context, table) {
-	const { config } = context;
-	const scope = table.scope === void 0 || table.scope === "inherit" ? config.sql.scope ?? "tenant" : table.scope;
-	const bigintId = table.id === "bigint";
-	const idValue = bigintId ? config.codecs.int8 === "bigint" ? "BigInt(id)" : config.codecs.int8 === "string" ? "id" : "Number(id)" : "id";
-	return {
-		key: applyCasing(context.table, config.casing),
-		component: pascal(context.table),
-		href: context.basePath.split("/").filter((segment) => !/^\(.*\)$/.test(segment)).join("/"),
-		tenant: scope === "tenant" ? applyCasing(`${config.sql.naming?.tenant ?? "organization"}_id`, config.casing) : void 0,
-		deletedAt: table.subject?.softDelete === true ? applyCasing("deleted_at", config.casing) : void 0,
-		title: applyCasing(titleColumn(table), config.casing),
-		idPattern: bigintId ? String.raw`/^\d+$/` : String.raw`/^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/i`,
-		idValue
-	};
-}
-function whereOf(names, extra = []) {
-	const parts = [
-		...extra,
-		...names.tenant ? [`${names.tenant}: tenant`] : [],
-		...names.deletedAt ? [`${names.deletedAt}: { isNull: true }`] : []
-	];
-	return parts.length === 0 ? "" : `, where: { ${parts.join(", ")} }`;
-}
-function requireCall(names) {
-	return names.tenant ? "const { db, tenant } = await bs.require({ requireTenant: true });" : "const { db } = await bs.require();";
-}
-const SHOW = `/** A column value as text for the list and detail pages. */
-export function show(value: unknown): string {
-  if (value === null || value === undefined) {
-    return '';
-  }
-
-  if (Array.isArray(value)) {
-    return value.map(show).join(', ');
-  }
-
-  if (typeof value === 'object' && value.toString === Object.prototype.toString) {
-    return JSON.stringify(value);
-  }
-
-  return String(value);
-}
-`;
-function listPage(context, names, fields, paths) {
-	const shown = fields.filter((field) => field.config.type !== "jsonb").slice(0, 5);
-	const props = [.../* @__PURE__ */ new Set([
-		"id",
-		names.title,
-		...shown.map((field) => field.prop)
-	])];
-	const order = context.config.appTables[context.table]?.timestamps !== false ? `, orderBy: { ${applyCasing("created_at", context.config.casing)}: 'desc' }` : "";
-	const cells = props.filter((prop) => prop !== "id").map((prop) => prop === names.title ? `            <td><Link href={\`${names.href}/\${row.id}\`}>{show(row.${prop}) || row.id}</Link></td>` : `            <td>{show(row.${prop})}</td>`);
-	const headers = props.filter((prop) => prop !== "id").map((prop) => `          <th>${fields.find((field) => field.prop === prop)?.label ?? labelOf(prop)}</th>`);
-	return `import Link from 'next/link';
-import { Suspense } from 'react';
-
-import { bs } from '${importFrom(context, paths.list, paths.server)}';
-import { show } from '${importFrom(context, paths.list, paths.show)}';
-
-export const metadata = { title: '${labelOf(context.table)}' };
-
-/**
- * The ${context.table} list, written once by \`better-supabase scaffold screens\`.
- * The record-grid recipe adds search, filters, saved views and bulk actions.
- */
-export default function ${names.component}Page() {
-  return (
-    <main>
-      <h1>${labelOf(context.table)}</h1>
-      <p><Link href="${names.href}/new">New</Link></p>
-      <Suspense fallback={<p>Loading</p>}>
-        <${names.component}List />
-      </Suspense>
-    </main>
-  );
-}
-
-async function ${names.component}List() {
-  ${requireCall(names)}
-
-  const rows = await db.${names.key}
-    .findMany({ select: [${props.map(quote$1).join(", ")}]${whereOf(names)}${order}, limit: 100 })
-    .orThrow();
-
-  if (rows.length === 0) {
-    return <p>Nothing here yet. <Link href="${names.href}/new">Add the first one</Link>.</p>;
-  }
-
-  return (
-    <table>
-      <thead>
-        <tr>
-${headers.join("\n")}
-        </tr>
-      </thead>
-      <tbody>
-        {rows.map((row) => (
-          <tr key={row.id}>
-${cells.join("\n")}
-          </tr>
-        ))}
-      </tbody>
-    </table>
-  );
-}
-`;
-}
-function detailPage(context, names, fields, paths) {
-	const props = ["id", ...fields.map((field) => field.prop)];
-	const rows = fields.map((field) => `        <dt>${field.label}</dt>\n        <dd>{show(row.${field.prop})}</dd>`);
-	return `import Link from 'next/link';
-import { notFound } from '${NEXT_NAVIGATION}';
-import { Suspense } from 'react';
-
-import { bs } from '${importFrom(context, paths.detail, paths.server)}';
-import { show } from '${importFrom(context, paths.detail, paths.show)}';
-
-export const metadata = { title: '${labelOf(context.table)}' };
-
-/**
- * One row of ${context.table}, written once by \`better-supabase scaffold screens\`.
- * The record-page recipe adds the rows that reference it, comments and tags.
- */
-export default function ${names.component}RecordPage({
-  params,
-}: {
-  params: Promise<{ id: string }>;
-}) {
-  return (
-    <main>
-      <p><Link href="${names.href}">All ${labelOf(context.table).toLowerCase()}</Link></p>
-      <Suspense fallback={<p>Loading</p>}>
-        <${names.component}Record params={params} />
-      </Suspense>
-    </main>
-  );
-}
-
-async function ${names.component}Record({ params }: { params: Promise<{ id: string }> }) {
-  const { id } = await params;
-
-  if (!${names.idPattern}.test(id)) {
-    notFound();
-  }
-
-  ${requireCall(names)}
-
-  const row = await db.${names.key}
-    .findFirst({ select: [${props.map(quote$1).join(", ")}]${whereOf(names, [names.idValue === "id" ? "id" : `id: ${names.idValue}`])} })
-    .orThrow();
-
-  if (!row) {
-    notFound();
-  }
-
-  return (
-    <article>
-      <h1>{show(row.${names.title}) || row.id}</h1>
-      <dl>
-${rows.join("\n")}
-      </dl>
-    </article>
-  );
-}
-`;
-}
-function newPage(context, names, fields, paths) {
-	const targets = fields.flatMap((field) => field.input === "reference" && field.target ? [{
-		field,
-		...field.target
-	}] : []);
-	const loads = targets.map((target) => `db.${target.key}.findMany({ select: ['id', ${quote$1(target.title)}], limit: 200 }).orThrow()`);
-	const options = targets.map((target, index) => `      ${target.field.column}: ${targets.length === 1 ? "lists" : `lists[${index}]`}.map((row) => ({ value: String(row.id), label: String(row.${target.title} ?? row.id) })),`);
-	const header = `export const metadata = { title: 'New ${labelOf(context.table).toLowerCase()}' };
-
-/** The create form for ${context.table}, written once by \`better-supabase scaffold screens\`. */`;
-	if (targets.length === 0) return `import { ${names.component}Form } from '${importFrom(context, paths.newPage, paths.form)}';
-
-${header}
-export default function New${names.component}Page() {
-  return (
-    <main>
-      <h1>New ${labelOf(context.table).toLowerCase()}</h1>
-      <${names.component}Form />
-    </main>
-  );
-}
-`;
-	return `import { Suspense } from 'react';
-
-import { bs } from '${importFrom(context, paths.newPage, paths.server)}';
-import { ${names.component}Form } from '${importFrom(context, paths.newPage, paths.form)}';
-
-${header}
-export default function New${names.component}Page() {
-  return (
-    <main>
-      <h1>New ${labelOf(context.table).toLowerCase()}</h1>
-      <Suspense fallback={<p>Loading</p>}>
-        <${names.component}FormLoader />
-      </Suspense>
-    </main>
-  );
-}
-
-/** Loads the rows each reference picker lists. */
-async function ${names.component}FormLoader() {
-  const { db } = await bs.require(${names.tenant ? "{ requireTenant: true }" : ""});
-
-  const lists = ${targets.length === 1 ? `await ${loads[0]}` : `await Promise.all([\n    ${loads.join(",\n    ")},\n  ])`};
-
-  return (
-    <${names.component}Form
-      options={{
-${options.join("\n")}
-      }}
-    />
-  );
-}
-`;
-}
-function inputMarkup(field) {
-	const name = quote$1(field.column).replaceAll("'", "\"");
-	const required = field.config.nullable === false ? " required" : "";
-	const initial = field.initial === void 0 ? "" : ` defaultValue=${JSON.stringify(field.initial)}`;
-	const id = `id=${name}`;
-	const label = `        <label htmlFor=${name}>${field.label}</label>`;
-	switch (field.input) {
-		case "checkbox": return `        <label>
-          <input type="checkbox" name=${name}${field.initial === "true" ? " defaultChecked" : ""} /> ${field.label}
-        </label>`;
-		case "select": {
-			const choices = (field.config.options ?? []).map((option) => `          <option value=${JSON.stringify(option)}>${option}</option>`).join("\n");
-			return `${label}
-        <select ${id} name=${name}${required}${initial}>
-${field.config.nullable === false ? "" : "          <option value=\"\">None</option>\n"}${choices}
-        </select>`;
-		}
-		case "reference": return `${label}
-        <select ${id} name=${name}${required}>
-          <option value="">${field.config.nullable === false ? "Pick one" : "None"}</option>
-          {options[${name}]?.map((option) => (
-            <option key={option.value} value={option.value}>{option.label}</option>
-          ))}
-        </select>`;
-		case "textarea": return `${label}
-        <textarea ${id} name=${name}${required}${field.config.max === void 0 ? "" : ` maxLength={${field.config.max}}`}${initial} />`;
-		case "number": return `${label}
-        <input ${id} name=${name} type="number"${field.config.min === void 0 ? "" : ` min={${field.config.min}}`}${field.config.max === void 0 ? "" : ` max={${field.config.max}}`}${field.config.type === "numeric" ? " step=\"any\"" : ""}${required}${initial} />`;
-		case "datetime": return `${label}
-        <input ${id} name=${name} type="datetime-local"${required} />`;
-		case void 0: return "";
-		case "text":
-		case "email":
-		case "url":
-		case "tel":
-		case "color":
-		case "date": return `${label}
-        <input ${id} name=${name}${field.input === "text" ? "" : ` type="${field.input}"`}${field.config.type === "text" && field.config.max !== void 0 ? ` maxLength={${field.config.max}}` : ""}${required}${initial} />`;
-		default: {
-			const unknown = field.input;
-			throw new Error(`Unknown input: ${String(unknown)}`);
-		}
-	}
-}
-function formModule(context, names, fields, paths) {
-	const inputs = fields.filter((field) => field.input !== void 0).map((field) => `      <p>\n${inputMarkup(field)}\n      </p>`);
-	const pickers = fields.some((field) => field.input === "reference");
-	const props = pickers ? `{
-  options,
-}: {
-  options: Readonly<Record<string, readonly Option[]>>;
-}` : "";
-	const option = pickers ? `
-interface Option {
-  readonly value: string;
-  readonly label: string;
-}
-` : "";
-	return `'use client';
-
-import { useActionState } from 'react';
-
-import { create${names.component} } from '${importFrom(context, paths.form, paths.actions)}';
-${option}
-/**
- * The create form. Each column gets the input its type, format and options
- * call for; the record-form recipe swaps the selects for searchable pickers.
- */
-export function ${names.component}Form(${props}) {
-  const [state, action, pending] = useActionState(create${names.component}, { error: null });
-
-  return (
-    <form action={action}>
-${inputs.join("\n")}
-      {state.error ? <p role="alert">{state.error}</p> : null}
-      <button type="submit" disabled={pending}>Create</button>
-    </form>
-  );
-}
-`;
-}
-function actionsModule(context, names, fields, paths) {
-	const values = fields.filter((field) => field.input !== void 0).map((field) => `    ${field.prop}: ${parseExpression(field, context.config)},`);
-	const tenant = names.tenant ? `, ${names.tenant}: tenant` : "";
-	const code = values.join("\n");
-	const helpers = HELPERS.filter(([name]) => code.includes(`${name}(`)).map(([, source]) => `${source}\n`).join("");
-	return `'use server';
-
-import { redirect } from '${NEXT_NAVIGATION}';
-
-import { bs } from '${importFrom(context, paths.actions, paths.server)}';
-
-export interface CreateState {
-  readonly error: string | null;
-}
-
-/** A form value the action refuses; the message is shown on the form. */
-class FieldError extends Error {}
-
-${helpers}function valuesOf(form: FormData) {
-  return {
-${values.join("\n")}
-  };
-}
-
-/** Creates a row from the form, then opens it. The table's policies check the caller. */
-export async function create${names.component}(
-  _state: CreateState,
-  form: FormData,
-): Promise<CreateState> {
-  ${requireCall(names)}
-
-  let values: ReturnType<typeof valuesOf>;
-
-  try {
-    values = valuesOf(form);
-  } catch (error) {
-    if (error instanceof FieldError) {
-      return { error: error.message };
-    }
-
-    throw error;
-  }
-
-  const created = await db.${names.key}.create({ ...values${tenant} }, { select: ['id'] });
-
-  if (!created.ok) {
-    return { error: created.error.message };
-  }
-
-  redirect(\`${names.href}/\${created.data.id}\`);
-}
-`;
-}
-const HELPERS = [
-	["optional", `function optional(form: FormData, name: string): string | null {
-  const value = form.get(name);
-
-  return typeof value === 'string' && value.trim() !== '' ? value.trim() : null;
-}
-`],
-	["required", `function required(form: FormData, name: string): string {
-  const value = form.get(name);
-
-  if (typeof value !== 'string' || value.trim() === '') {
-    throw new FieldError(\`Fill in \${name}.\`);
-  }
-
-  return value.trim();
-}
-`],
-	["map", `function map<T>(value: string | null, parse: (value: string) => T): T | null {
-  return value === null ? null : parse(value);
-}
-`],
-	["oneOf", `function oneOf<const T extends string>(value: string, options: readonly T[]): T {
-  const found = options.find((option) => option === value);
-
-  if (found === undefined) {
-    throw new FieldError(\`\${value} is not one of the options.\`);
-  }
-
-  return found;
-}
-`],
-	["toTimestamp", `function toTimestamp(value: string): string {
-  return new Date(value).toISOString();
-}
-`]
-];
-/** The pages `scaffold screens <table>` writes for Next.js, each written once. */
-function scaffoldScreensFiles(context) {
-	const table = context.config.appTables[context.table];
-	if (!table) {
-		const known = Object.keys(context.config.appTables);
-		throw new ScreensError(known.length === 0 ? `"${context.table}" is not an app table, and the config has none. Add it under appTables first.` : `"${context.table}" is not an app table. App tables: ${known.join(", ")}.`);
-	}
-	if (table.scope === "none") throw new ScreensError(`${context.table} has scope "none", so only the service role writes it. Screens need a table the caller writes.`);
-	if (/[[\]]/.test(context.basePath)) throw new ScreensError(`--base-path takes a static route, got "${context.basePath}". Move the pages under a dynamic segment yourself.`);
-	const fields = fieldsOf(context, table);
-	const names = namesOf(context, table);
-	const dir = join$1(context.srcDir, "app", context.basePath);
-	const ext = (name, tsx) => join$1(dir, `${name}.${tsx ? "tsx" : "ts"}`);
-	const paths = {
-		server: join$1(context.srcDir, "lib", "supabase", "server.ts"),
-		show: ext("show", false),
-		list: ext("page", true),
-		newPage: join$1(dir, "new", "page.tsx"),
-		detail: join$1(dir, "[id]", "page.tsx"),
-		form: ext("form", true),
-		actions: ext("actions", false)
-	};
-	return [
-		{
-			path: paths.list,
-			generated: false,
-			contents: listPage(context, names, fields, paths)
-		},
-		{
-			path: paths.newPage,
-			generated: false,
-			contents: newPage(context, names, fields, paths)
-		},
-		{
-			path: paths.detail,
-			generated: false,
-			contents: detailPage(context, names, fields, paths)
-		},
-		{
-			path: paths.form,
-			generated: false,
-			contents: formModule(context, names, fields, paths)
-		},
-		{
-			path: paths.actions,
-			generated: false,
-			contents: actionsModule(context, names, fields, paths)
-		},
-		{
-			path: paths.show,
-			generated: false,
-			contents: SHOW
-		}
-	];
-}
-//#endregion
-//#region src/cli/commands/scaffold.ts
-const ARGS = {
-	framework: {
-		type: "string",
-		description: "hono or next. Defaults to the one in package.json",
-		valueHint: "name"
-	},
-	tables: {
-		type: "string",
-		description: "Tables to serve. Defaults to every table and view in the public schema",
-		valueHint: "list"
-	},
-	name: {
-		type: "string",
-		description: "The API module's name: lib/<name>.ts and lib/<name>.generated.ts. Defaults to api",
-		valueHint: "name"
-	},
-	"base-path": {
-		type: "string",
-		description: "Where the resources are served. Defaults to /api",
-		valueHint: "path"
-	}
-};
-const SCREENS_ARGS = {
-	table: {
-		type: "positional",
-		required: false,
-		description: "The app table to write pages for"
-	},
-	framework: {
-		type: "string",
-		description: "next. Defaults to next when package.json lists it",
-		valueHint: "name"
-	},
-	"base-path": {
-		type: "string",
-		description: "The route the pages live under. Defaults to /<table>",
-		valueHint: "path"
-	}
-};
-const isFramework = (value) => SCAFFOLD_FRAMEWORKS.some((framework) => framework === value);
-/** The public tables and views in the metadata module `gen` writes, or undefined without one. */
-async function generatedTables(config) {
-	const path = resolve(config.root, metaPaths(config.output).js);
-	if (!existsSync(path)) return;
-	const meta = (await importFresh(path))["default"];
-	const tables = isRecord(meta) ? meta["tables"] : void 0;
-	if (!isRecord(tables)) return;
-	return Object.entries(tables).filter(([, table]) => isRecord(table) && table["schema"] === "public" && (table["kind"] === "table" || table["kind"] === "view")).map(([key]) => key);
-}
-async function runScaffoldApi(config, args, options = {}) {
-	const configured = config.scaffold.api ?? {};
-	const project = await detectProject(config.root);
-	const detected = project.frameworks.filter(isFramework);
-	const chosen = args.framework ?? configured.framework;
-	const framework = chosen ?? (detected.length === 1 ? detected[0] : void 0);
-	if (!isFramework(framework)) throw new CliError("usage", chosen === void 0 ? "Pass --framework hono or --framework next, or set scaffold.api.framework." : `--framework takes hono or next, got "${chosen}".`);
-	const name = args.name ?? configured.name ?? "api";
-	if (!/^[a-z][\w-]*$/i.test(name)) throw new CliError("usage", `--name must be a file name without a folder, got "${name}".`);
-	const basePath = `/${(args["base-path"] ?? configured.basePath ?? "/api").replaceAll(/^\/+|\/+$/g, "")}`;
-	const known = await generatedTables(config);
-	const requested = args.tables === void 0 ? [...configured.tables ?? []] : list(args.tables);
-	if (requested.length === 0 && !known) return {
-		code: 1,
-		errorCode: "not_found",
-		error: `No ${display(config.root, metaPaths(config.output).js)}. Run \`better-supabase gen\` first, or pass --tables.`
-	};
-	const unknown = known ? requested.filter((table) => !known.includes(table)) : [];
-	if (unknown.length > 0) return {
-		code: 1,
-		error: `Unknown tables: ${unknown.join(", ")}. Known tables: ${known?.join(", ")}.`
-	};
-	const tables = requested.length > 0 ? requested : known ?? [];
-	if (tables.length === 0) return {
-		code: 1,
-		error: "There are no public tables to serve. Pass --tables."
-	};
-	const context = {
-		framework,
-		srcDir: project.srcDir,
-		tsExtensions: project.tsExtensions,
-		name,
-		basePath,
-		tables
-	};
-	const plan = {
-		root: config.root,
-		regenerate: "better-supabase scaffold api",
-		files: scaffoldApiFiles(context).filter((file) => options.generatedOnly !== true || file.generated).map((file) => ({
-			path: file.path,
-			contents: file.contents,
-			policy: file.generated ? "owned" : "create"
-		}))
-	};
-	const applied = await applyPlan(plan, {
-		...args,
-		...options.check === true ? { check: true } : {}
-	});
-	const files = applied.changes;
-	const lines = changeLines(applied);
-	if (applied.mode !== "write" || options.generatedOnly === true || hasConflicts(applied)) return planResult(plan, applied, { data: {
-		framework,
-		tables
-	} });
-	const steps = scaffoldNextSteps(context, config.specs.entry);
-	const save = config.scaffold.api === void 0 ? [
-		"",
-		"Add this to your config so `better-supabase gen` keeps the generated file current:",
-		`  scaffold: { api: ${scaffoldSnippet({
-			framework,
-			...name === "api" ? {} : { name },
-			...basePath === "/api" ? {} : { basePath },
-			...requested.length > 0 ? { tables: requested } : {}
-		})} }`
-	] : [];
-	return {
-		code: 0,
-		output: [
-			...lines,
-			"",
-			"Next:",
-			...steps.map((step) => `- ${step}`),
-			...save
-		].join("\n"),
-		data: {
-			framework,
-			tables,
-			files,
-			steps
-		}
-	};
-}
-/** Writes list, create and detail pages for one app table, each once. */
-async function runScaffoldScreens(config, args) {
-	const { table } = args;
-	if (table === void 0) throw new CliError("usage", "Name the app table: `better-supabase scaffold screens <table>`.");
-	const project = await detectProject(config.root);
-	const framework = args.framework ?? (project.frameworks.includes("next") ? "next" : void 0);
-	if (framework !== "next") throw new CliError("usage", framework === void 0 ? "Screens are Next.js pages, and package.json has no next. Pass --framework next." : `Screens are Next.js pages; --framework ${framework} has none.`);
-	const basePath = `/${(args["base-path"] ?? table).replaceAll(/^\/+|\/+$/g, "")}`;
-	let files;
-	try {
-		files = scaffoldScreensFiles({
-			config,
-			table,
-			srcDir: project.srcDir,
-			tsExtensions: project.tsExtensions,
-			basePath
-		});
-	} catch (error) {
-		if (error instanceof ScreensError) return {
-			code: 1,
-			errorCode: "invalid_input",
-			error: error.message
-		};
-		throw error;
-	}
-	const plan = {
-		root: config.root,
-		regenerate: "better-supabase scaffold screens",
-		files: files.map((file) => ({
-			path: file.path,
-			contents: file.contents,
-			policy: "create"
-		}))
-	};
-	const applied = await applyPlan(plan, args);
-	if (applied.mode !== "write" || hasConflicts(applied)) return planResult(plan, applied, { data: {
-		table,
-		basePath
-	} });
-	const steps = [`Open ${basePath} in \`next dev\`. The pages call \`bs\` from lib/supabase/server; \`better-supabase add next\` writes it if you don't have one.`, "The files are yours. For search, saved views, a board or a calendar, start from the record-* recipes: https://bettersupabase.com/docs/registry/ui-recipes"];
-	return {
-		code: 0,
-		output: [
-			...changeLines(applied),
-			"",
-			"Next:",
-			...steps.map((step) => `- ${step}`)
-		].join("\n"),
-		data: {
-			table,
-			basePath,
-			files: applied.changes,
-			steps
-		}
-	};
-}
-const quote = (value) => `'${value}'`;
-const scaffoldSnippet = (api) => `{ ${Object.entries(api).map(([key, value]) => `${key}: ${typeof value === "string" ? quote(value) : `[${value.map(quote).join(", ")}]`}`).join(", ")} }`;
-const scaffoldApiCommand = defineCliCommand({
-	meta: commandMeta("scaffold api"),
-	args: {
-		...ARGS,
-		...PLAN_ARGS
-	},
-	lists: ["tables"],
-	run: (args, { config }) => runScaffoldApi(config, args)
-});
-const scaffoldScreensCommand = defineCliCommand({
-	meta: commandMeta("scaffold screens"),
-	args: {
-		...SCREENS_ARGS,
-		...PLAN_ARGS
-	},
-	run: (args, { config }) => runScaffoldScreens(config, args)
-});
-//#endregion
-export { scaffoldScreensCommand as i, runScaffoldScreens as n, scaffoldApiCommand as r, runScaffoldApi as t };