@cedarjs/pg 0.2.0-alpha.0 → 0.3.0

package/dist/{template-CGw3C1Ob.mjs → template-DlqHL8Go.mjs}

@@ -1,19 +1,23 @@
-import { C as buildCloneDatabaseName, S as runIfNeeded, _ as setDatabaseIsTemplate, f as dropDatabase, l as buildDatabaseUrl, o as ensureHostRunning, u as cloneDatabaseFromTemplate, v as applyDatabaseUrlEnv } from "./lifecycle-BOo6xBjD.mjs";
-import { f as resolveWorktreeIdentity, l as readLease } from "./lease-BSBBpaR4.mjs";
+import { T as buildCloneDatabaseName, b as applyDatabaseUrlEnv, d as cloneDatabaseFromTemplate, l as adminUrlFor, p as dropDatabase, r as attach, u as buildDatabaseUrl, v as setDatabaseIsTemplate, w as runIfNeeded } from "./lifecycle-2BZgSVz2.mjs";
 //#region src/core/template.ts
-async function resolveAdminUrl(adminUrl) {
-	return adminUrl ?? (await ensureHostRunning()).adminUrl;
+/**
+* Lease + admin URL the way `attach` connects: lease file, one TCP probe on the
+* leased port, never host discovery / start / revive. Workers call this once per
+* test file, so it must stay cheap (no git, no `autopg` processes).
+*/
+async function attachAdmin(options) {
+	const { lease } = await attach(options);
+	return {
+		lease,
+		adminUrl: options.adminUrl ?? adminUrlFor(lease.port)
+	};
 }
 /**
 * After migrations, mark the leased DB as a PostgreSQL TEMPLATE so workers can clone it.
 * Requires a lease from `acquire` (no datname override).
 */
 async function markTemplate(options) {
-	const identity = resolveWorktreeIdentity(options.root);
-	const mode = options.mode;
-	const lease = readLease(identity.root, mode);
-	if (!lease) throw new Error(`no ${mode} lease; run acquire before markTemplate`);
-	const adminUrl = await resolveAdminUrl(options.adminUrl);
+	const { lease, adminUrl } = await attachAdmin(options);
 	await setDatabaseIsTemplate({
 		adminUrl,
 		databaseName: lease.databaseName,
@@ -28,28 +32,27 @@ async function markTemplate(options) {
 * Clone the leased TEMPLATE database via admin (`CREATE DATABASE … TEMPLATE`).
 * Reuses the template role so `databaseUrl` passwords stay valid (scheme v2).
 * Provider rejects when the leased DB is not marked TEMPLATE.
-* Port comes from the lease; admin URL is passed through or rediscovered.
+* Port comes from the lease; admin URL is passed through or built from the lease
+* port. Fails when nothing listens there (setup should have acquired).
+* An existing clone datname fails unless `reuse` is set and the lease role owns it.
 */
 async function cloneFromTemplate(options) {
-	const identity = resolveWorktreeIdentity(options.root);
-	const mode = options.mode;
-	const lease = readLease(identity.root, mode);
-	if (!lease) throw new Error(`no ${mode} lease; run acquire + markTemplate before cloneFromTemplate`);
-	const adminUrl = await resolveAdminUrl(options.adminUrl);
+	const { lease, adminUrl } = await attachAdmin(options);
 	const suffix = options.name ?? `${process.pid}_${Date.now().toString(36)}`;
 	const databaseName = buildCloneDatabaseName(lease.databaseName, suffix);
 	await cloneDatabaseFromTemplate({
 		adminUrl,
 		templateName: lease.databaseName,
 		databaseName,
-		roleName: lease.roleName
+		roleName: lease.roleName,
+		reuse: options.reuse
 	});
 	const databaseUrl = buildDatabaseUrl({
 		port: lease.port,
 		databaseName,
 		roleName: lease.roleName
 	});
-	if (options.setEnv) applyDatabaseUrlEnv(databaseUrl, { mode });
+	if (options.setEnv) applyDatabaseUrlEnv(databaseUrl, { mode: options.mode });
 	const roleName = lease.roleName;
 	return {
 		databaseUrl,
@@ -85,4 +88,4 @@ async function cloneFromTemplateIfNeeded(options) {
 //#endregion
 export { cloneFromTemplateIfNeeded as n, markTemplate as r, cloneFromTemplate as t };
 
-//# sourceMappingURL=template-CGw3C1Ob.mjs.map
+//# sourceMappingURL=template-DlqHL8Go.mjs.map

package/dist/template-DlqHL8Go.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-DlqHL8Go.mjs","names":[],"sources":["../src/core/template.ts"],"sourcesContent":["import { buildCloneDatabaseName, type DbMode } from \"./naming.ts\";\nimport type { Lease } from \"./lease.ts\";\nimport { attach } from \"./lifecycle.ts\";\nimport { applyDatabaseUrlEnv, runIfNeeded, type ResolveAcquireSkipInput } from \"./policy.ts\";\nimport {\n  adminUrlFor,\n  buildDatabaseUrl,\n  cloneDatabaseFromTemplate,\n  dropDatabase,\n  setDatabaseIsTemplate,\n} from \"../providers/autopg.ts\";\n\n/**\n * Lease + admin URL the way `attach` connects: lease file, one TCP probe on the\n * leased port, never host discovery / start / revive. Workers call this once per\n * test file, so it must stay cheap (no git, no `autopg` processes).\n */\nasync function attachAdmin(options: {\n  root?: string;\n  mode: DbMode;\n  adminUrl?: string;\n}): Promise<{ lease: Lease; adminUrl: string }> {\n  const { lease } = await attach(options);\n  return { lease, adminUrl: options.adminUrl ?? adminUrlFor(lease.port) };\n}\n\nexport type MarkTemplateOptions = {\n  root?: string;\n  mode: DbMode;\n  /** Superuser URL from `acquire`; when omitted, built from the lease port (never starts the host). */\n  adminUrl?: string;\n};\n\n/**\n * After migrations, mark the leased DB as a PostgreSQL TEMPLATE so workers can clone it.\n * Requires a lease from `acquire` (no datname override).\n */\nexport async function markTemplate(\n  options: MarkTemplateOptions,\n): Promise<{ databaseName: string; adminUrl: string }> {\n  const { lease, adminUrl } = await attachAdmin(options);\n  await setDatabaseIsTemplate({\n    adminUrl,\n    databaseName: lease.databaseName,\n    isTemplate: true,\n  });\n  return { databaseName: lease.databaseName, adminUrl };\n}\n\nexport type CloneFromTemplateOptions = {\n  root?: string;\n  mode: DbMode;\n  /** Superuser URL from `acquire`; when omitted, built from the lease port (never starts the host). */\n  adminUrl?: string;\n  /**\n   * Suffix for the clone datname (e.g. Jest worker id).\n   * Defaults to `<pid>_<base36 time>`.\n   */\n  name?: string;\n  /**\n   * Keep an existing `<template>_c_<name>` owned by the lease role instead of\n   * failing with `database already exists` (default false). Worker adapters pass\n   * true so every test file in one worker attaches to the same clone.\n   */\n  reuse?: boolean;\n  /**\n   * Inject DATABASE_URL / TEST_DATABASE_URL for this clone (default false).\n   * Host `cloneFromTemplateIfNeeded` defaults true; worker adapters pass true explicitly.\n   */\n  setEnv?: boolean;\n};\n\nexport type CloneResult = {\n  databaseUrl: string;\n  adminUrl: string;\n  databaseName: string;\n  roleName: string;\n  templateName: string;\n  port: number;\n  /**\n   * DROP this clone only (leaves TEMPLATE + role if still owned elsewhere).\n   * Not suite teardown — use role-scoped `dispose` for that.\n   */\n  dropClone: () => Promise<void>;\n};\n\n/**\n * Clone the leased TEMPLATE database via admin (`CREATE DATABASE … TEMPLATE`).\n * Reuses the template role so `databaseUrl` passwords stay valid (scheme v2).\n * Provider rejects when the leased DB is not marked TEMPLATE.\n * Port comes from the lease; admin URL is passed through or built from the lease\n * port. Fails when nothing listens there (setup should have acquired).\n * An existing clone datname fails unless `reuse` is set and the lease role owns it.\n */\nexport async function cloneFromTemplate(options: CloneFromTemplateOptions): Promise<CloneResult> {\n  const { lease, adminUrl } = await attachAdmin(options);\n  const suffix = options.name ?? `${process.pid}_${Date.now().toString(36)}`;\n  const databaseName = buildCloneDatabaseName(lease.databaseName, suffix);\n\n  await cloneDatabaseFromTemplate({\n    adminUrl,\n    templateName: lease.databaseName,\n    databaseName,\n    roleName: lease.roleName,\n    reuse: options.reuse,\n  });\n\n  const databaseUrl = buildDatabaseUrl({\n    port: lease.port,\n    databaseName,\n    roleName: lease.roleName,\n  });\n\n  if (options.setEnv) {\n    applyDatabaseUrlEnv(databaseUrl, { mode: options.mode });\n  }\n\n  const roleName = lease.roleName;\n\n  return {\n    databaseUrl,\n    adminUrl,\n    databaseName,\n    roleName,\n    templateName: lease.databaseName,\n    port: lease.port,\n    dropClone: async () => {\n      await dropDatabase({ adminUrl, databaseName, roleName });\n    },\n  };\n}\n\nexport type CloneFromTemplateIfNeededOptions = CloneFromTemplateOptions & ResolveAcquireSkipInput;\n\nexport type CloneFromTemplateIfNeededResult =\n  | { status: \"skipped\"; reason: \"disabled\" }\n  | { status: \"skipped\"; reason: \"external-url\"; databaseUrl: string }\n  | ({ status: \"cloned\" } & CloneResult);\n\n/**\n * Resolve skip policy then clone. Host entry for worker adapters (same skip\n * semantics as `acquireIfNeeded`). Defaults `setEnv` on for skip and clone paths.\n */\nexport async function cloneFromTemplateIfNeeded(\n  options: CloneFromTemplateIfNeededOptions,\n): Promise<CloneFromTemplateIfNeededResult> {\n  const outcome = await runIfNeeded(options, () =>\n    cloneFromTemplate({\n      ...options,\n      setEnv: options.setEnv !== false,\n    }),\n  );\n  if (outcome.status === \"skipped\") return outcome;\n  return { status: \"cloned\", ...outcome.value };\n}\n"],"mappings":";;;;;;;AAiBA,eAAe,YAAY,SAIqB;CAC9C,MAAM,EAAE,UAAU,MAAM,OAAO,OAAO;CACtC,OAAO;EAAE;EAAO,UAAU,QAAQ,YAAY,YAAY,MAAM,IAAI;CAAE;AACxE;;;;;AAaA,eAAsB,aACpB,SACqD;CACrD,MAAM,EAAE,OAAO,aAAa,MAAM,YAAY,OAAO;CACrD,MAAM,sBAAsB;EAC1B;EACA,cAAc,MAAM;EACpB,YAAY;CACd,CAAC;CACD,OAAO;EAAE,cAAc,MAAM;EAAc;CAAS;AACtD;;;;;;;;;AA+CA,eAAsB,kBAAkB,SAAyD;CAC/F,MAAM,EAAE,OAAO,aAAa,MAAM,YAAY,OAAO;CACrD,MAAM,SAAS,QAAQ,QAAQ,GAAG,QAAQ,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC,SAAS,EAAE;CACvE,MAAM,eAAe,uBAAuB,MAAM,cAAc,MAAM;CAEtE,MAAM,0BAA0B;EAC9B;EACA,cAAc,MAAM;EACpB;EACA,UAAU,MAAM;EAChB,OAAO,QAAQ;CACjB,CAAC;CAED,MAAM,cAAc,iBAAiB;EACnC,MAAM,MAAM;EACZ;EACA,UAAU,MAAM;CAClB,CAAC;CAED,IAAI,QAAQ,QACV,oBAAoB,aAAa,EAAE,MAAM,QAAQ,KAAK,CAAC;CAGzD,MAAM,WAAW,MAAM;CAEvB,OAAO;EACL;EACA;EACA;EACA;EACA,cAAc,MAAM;EACpB,MAAM,MAAM;EACZ,WAAW,YAAY;GACrB,MAAM,aAAa;IAAE;IAAU;IAAc;GAAS,CAAC;EACzD;CACF;AACF;;;;;AAaA,eAAsB,0BACpB,SAC0C;CAC1C,MAAM,UAAU,MAAM,YAAY,eAChC,kBAAkB;EAChB,GAAG;EACH,QAAQ,QAAQ,WAAW;CAC7B,CAAC,CACH;CACA,IAAI,QAAQ,WAAW,WAAW,OAAO;CACzC,OAAO;EAAE,QAAQ;EAAU,GAAG,QAAQ;CAAM;AAC9C"}

package/dist/template-mode-BqV3GjXI.d.cts

@@ -0,0 +1,48 @@
+//#region src/adapters/template-mode.d.ts
+type TemplateMigrateContext = {
+  databaseUrl: string;
+  adminUrl: string;
+  databaseName: string;
+  roleName: string;
+};
+type TemplateMigrateFn = (ctx: TemplateMigrateContext) => void | Promise<void>;
+type SetupTemplateModeOptions = {
+  root?: string;
+  /** App-owned migrate; runs once, then `markTemplate`. Required. */
+  migrate: TemplateMigrateFn;
+  setEnv?: boolean;
+};
+type CloneWorkerDatabaseOptions = {
+  root?: string;
+  /** Clone suffix; defaults to JEST_WORKER_ID / VITEST_POOL_ID / pid. */
+  name?: string;
+  /**
+   * How each file starts on the worker clone (default `"truncate"`):
+   * - `"truncate"`: `TRUNCATE … RESTART IDENTITY` on every user table, so rows
+   *   from earlier files are gone and serial / identity IDs restart at 1.
+   * - `"none"`: keep whatever the previous file left (app-owned reset).
+   */
+  reset?: "truncate" | "none";
+};
+/**
+ * One clone per worker (`<template>_c_<JEST_WORKER_ID | VITEST_POOL_ID | pid>`),
+ * shared by every test file that worker runs. Call it once per test file
+ * (`beforeAll` in `setupFilesAfterEnv`, or a Vitest `setupFiles` module).
+ *
+ * The first file creates the clone. Later files reuse it (`reuse: true`): the
+ * database itself is the source of truth, so this holds even though Jest gives
+ * each file a fresh `globalThis` and module registry. Clones left over from a
+ * crashed earlier run cannot leak in — `setupTemplateMode` drops them first.
+ *
+ * Every file then starts from empty tables with identities restarted (`reset`),
+ * the first file included, so file order never changes what a file sees. That
+ * also clears rows `migrate` seeded into the TEMPLATE; pass `reset: "none"` to
+ * keep them and reset on your own. A skipped clone (external URL, `CEDAR_PG=0`)
+ * is never truncated.
+ *
+ * Uses `cloneFromTemplateIfNeeded` (same skip policy as `acquireIfNeeded`) with `setEnv: true`.
+ */
+declare function cloneWorkerDatabase(options?: CloneWorkerDatabaseOptions): Promise<void>;
+//#endregion
+export { cloneWorkerDatabase as i, TemplateMigrateContext as n, TemplateMigrateFn as r, SetupTemplateModeOptions as t };
+//# sourceMappingURL=template-mode-BqV3GjXI.d.cts.map

package/dist/template-mode-BqV3GjXI.d.mts

@@ -0,0 +1,48 @@
+//#region src/adapters/template-mode.d.ts
+type TemplateMigrateContext = {
+  databaseUrl: string;
+  adminUrl: string;
+  databaseName: string;
+  roleName: string;
+};
+type TemplateMigrateFn = (ctx: TemplateMigrateContext) => void | Promise<void>;
+type SetupTemplateModeOptions = {
+  root?: string;
+  /** App-owned migrate; runs once, then `markTemplate`. Required. */
+  migrate: TemplateMigrateFn;
+  setEnv?: boolean;
+};
+type CloneWorkerDatabaseOptions = {
+  root?: string;
+  /** Clone suffix; defaults to JEST_WORKER_ID / VITEST_POOL_ID / pid. */
+  name?: string;
+  /**
+   * How each file starts on the worker clone (default `"truncate"`):
+   * - `"truncate"`: `TRUNCATE … RESTART IDENTITY` on every user table, so rows
+   *   from earlier files are gone and serial / identity IDs restart at 1.
+   * - `"none"`: keep whatever the previous file left (app-owned reset).
+   */
+  reset?: "truncate" | "none";
+};
+/**
+ * One clone per worker (`<template>_c_<JEST_WORKER_ID | VITEST_POOL_ID | pid>`),
+ * shared by every test file that worker runs. Call it once per test file
+ * (`beforeAll` in `setupFilesAfterEnv`, or a Vitest `setupFiles` module).
+ *
+ * The first file creates the clone. Later files reuse it (`reuse: true`): the
+ * database itself is the source of truth, so this holds even though Jest gives
+ * each file a fresh `globalThis` and module registry. Clones left over from a
+ * crashed earlier run cannot leak in — `setupTemplateMode` drops them first.
+ *
+ * Every file then starts from empty tables with identities restarted (`reset`),
+ * the first file included, so file order never changes what a file sees. That
+ * also clears rows `migrate` seeded into the TEMPLATE; pass `reset: "none"` to
+ * keep them and reset on your own. A skipped clone (external URL, `CEDAR_PG=0`)
+ * is never truncated.
+ *
+ * Uses `cloneFromTemplateIfNeeded` (same skip policy as `acquireIfNeeded`) with `setEnv: true`.
+ */
+declare function cloneWorkerDatabase(options?: CloneWorkerDatabaseOptions): Promise<void>;
+//#endregion
+export { cloneWorkerDatabase as i, TemplateMigrateContext as n, TemplateMigrateFn as r, SetupTemplateModeOptions as t };
+//# sourceMappingURL=template-mode-BqV3GjXI.d.mts.map

package/dist/template-mode-DK5cAlv9.mjs

@@ -0,0 +1,81 @@
+import { i as dispose, n as acquireIfNeeded, y as truncateUserTables } from "./lifecycle-2BZgSVz2.mjs";
+import { n as cloneFromTemplateIfNeeded, r as markTemplate } from "./template-DlqHL8Go.mjs";
+//#region src/adapters/template-mode.ts
+/**
+* Runner orchestration: fresh acquire → migrate → markTemplate.
+* The acquire is `fresh`: leftovers a crashed earlier run left under this
+* worktree's test role (TEMPLATE, worker clones) are dropped first, so migrate
+* always starts from an empty database and no consumer pre-cleanup is needed.
+* After acquire succeeds, migrate + markTemplate are all-or-nothing: any failure
+* best-effort disposes the lease so Vitest (no separate teardown) does not leak.
+* Programmatic apps that do not need a migrate hook should call core
+* `acquire` + `markTemplate` + `cloneFromTemplate` + `dispose` instead.
+*/
+async function setupTemplateMode(options) {
+	const result = await acquireIfNeeded({
+		root: options.root,
+		mode: "test",
+		fresh: true,
+		setEnv: options.setEnv !== false
+	});
+	if (result.status !== "acquired") return result;
+	try {
+		await options.migrate({
+			databaseUrl: result.databaseUrl,
+			adminUrl: result.adminUrl,
+			databaseName: result.databaseName,
+			roleName: result.roleName
+		});
+		await markTemplate({
+			root: result.root,
+			mode: "test",
+			adminUrl: result.adminUrl
+		});
+	} catch (err) {
+		try {
+			await dispose({
+				root: result.root,
+				mode: "test"
+			});
+		} catch {}
+		const detail = err instanceof Error ? err.message : String(err);
+		throw new Error(`template setup failed after acquire; cleaned up lease DB (${result.databaseName}). Fix the error and re-run: ${detail}`, { cause: err });
+	}
+	return result;
+}
+/**
+* One clone per worker (`<template>_c_<JEST_WORKER_ID | VITEST_POOL_ID | pid>`),
+* shared by every test file that worker runs. Call it once per test file
+* (`beforeAll` in `setupFilesAfterEnv`, or a Vitest `setupFiles` module).
+*
+* The first file creates the clone. Later files reuse it (`reuse: true`): the
+* database itself is the source of truth, so this holds even though Jest gives
+* each file a fresh `globalThis` and module registry. Clones left over from a
+* crashed earlier run cannot leak in — `setupTemplateMode` drops them first.
+*
+* Every file then starts from empty tables with identities restarted (`reset`),
+* the first file included, so file order never changes what a file sees. That
+* also clears rows `migrate` seeded into the TEMPLATE; pass `reset: "none"` to
+* keep them and reset on your own. A skipped clone (external URL, `CEDAR_PG=0`)
+* is never truncated.
+*
+* Uses `cloneFromTemplateIfNeeded` (same skip policy as `acquireIfNeeded`) with `setEnv: true`.
+*/
+async function cloneWorkerDatabase(options = {}) {
+	const name = options.name ?? process.env.JEST_WORKER_ID ?? process.env.VITEST_POOL_ID ?? String(process.pid);
+	const clone = await cloneFromTemplateIfNeeded({
+		root: options.root,
+		mode: "test",
+		name,
+		reuse: true,
+		setEnv: true
+	});
+	if (clone.status === "cloned" && options.reset !== "none") await truncateUserTables({
+		adminUrl: clone.adminUrl,
+		databaseName: clone.databaseName
+	});
+}
+//#endregion
+export { setupTemplateMode as n, cloneWorkerDatabase as t };
+
+//# sourceMappingURL=template-mode-DK5cAlv9.mjs.map

package/dist/template-mode-DK5cAlv9.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-mode-DK5cAlv9.mjs","names":[],"sources":["../src/adapters/template-mode.ts"],"sourcesContent":["import { dispose, acquireIfNeeded, type AcquireIfNeededResult } from \"../core/lifecycle.ts\";\nimport { cloneFromTemplateIfNeeded, markTemplate } from \"../core/template.ts\";\nimport { truncateUserTables } from \"../providers/autopg.ts\";\n\nexport type TemplateMigrateContext = {\n  databaseUrl: string;\n  adminUrl: string;\n  databaseName: string;\n  roleName: string;\n};\n\nexport type TemplateMigrateFn = (ctx: TemplateMigrateContext) => void | Promise<void>;\n\nexport type SetupTemplateModeOptions = {\n  root?: string;\n  /** App-owned migrate; runs once, then `markTemplate`. Required. */\n  migrate: TemplateMigrateFn;\n  setEnv?: boolean;\n};\n\n/**\n * Runner orchestration: fresh acquire → migrate → markTemplate.\n * The acquire is `fresh`: leftovers a crashed earlier run left under this\n * worktree's test role (TEMPLATE, worker clones) are dropped first, so migrate\n * always starts from an empty database and no consumer pre-cleanup is needed.\n * After acquire succeeds, migrate + markTemplate are all-or-nothing: any failure\n * best-effort disposes the lease so Vitest (no separate teardown) does not leak.\n * Programmatic apps that do not need a migrate hook should call core\n * `acquire` + `markTemplate` + `cloneFromTemplate` + `dispose` instead.\n */\nexport async function setupTemplateMode(\n  options: SetupTemplateModeOptions,\n): Promise<AcquireIfNeededResult> {\n  const result = await acquireIfNeeded({\n    root: options.root,\n    mode: \"test\",\n    fresh: true,\n    setEnv: options.setEnv !== false,\n  });\n  if (result.status !== \"acquired\") return result;\n\n  try {\n    await options.migrate({\n      databaseUrl: result.databaseUrl,\n      adminUrl: result.adminUrl,\n      databaseName: result.databaseName,\n      roleName: result.roleName,\n    });\n    await markTemplate({\n      root: result.root,\n      mode: \"test\",\n      adminUrl: result.adminUrl,\n    });\n  } catch (err) {\n    try {\n      await dispose({ root: result.root, mode: \"test\" });\n    } catch {\n      // best-effort: leave lease for dispose/gc retry\n    }\n    const detail = err instanceof Error ? err.message : String(err);\n    throw new Error(\n      `template setup failed after acquire; cleaned up lease DB (${result.databaseName}). ` +\n        `Fix the error and re-run: ${detail}`,\n      { cause: err },\n    );\n  }\n\n  return result;\n}\n\nexport type CloneWorkerDatabaseOptions = {\n  root?: string;\n  /** Clone suffix; defaults to JEST_WORKER_ID / VITEST_POOL_ID / pid. */\n  name?: string;\n  /**\n   * How each file starts on the worker clone (default `\"truncate\"`):\n   * - `\"truncate\"`: `TRUNCATE … RESTART IDENTITY` on every user table, so rows\n   *   from earlier files are gone and serial / identity IDs restart at 1.\n   * - `\"none\"`: keep whatever the previous file left (app-owned reset).\n   */\n  reset?: \"truncate\" | \"none\";\n};\n\n/**\n * One clone per worker (`<template>_c_<JEST_WORKER_ID | VITEST_POOL_ID | pid>`),\n * shared by every test file that worker runs. Call it once per test file\n * (`beforeAll` in `setupFilesAfterEnv`, or a Vitest `setupFiles` module).\n *\n * The first file creates the clone. Later files reuse it (`reuse: true`): the\n * database itself is the source of truth, so this holds even though Jest gives\n * each file a fresh `globalThis` and module registry. Clones left over from a\n * crashed earlier run cannot leak in — `setupTemplateMode` drops them first.\n *\n * Every file then starts from empty tables with identities restarted (`reset`),\n * the first file included, so file order never changes what a file sees. That\n * also clears rows `migrate` seeded into the TEMPLATE; pass `reset: \"none\"` to\n * keep them and reset on your own. A skipped clone (external URL, `CEDAR_PG=0`)\n * is never truncated.\n *\n * Uses `cloneFromTemplateIfNeeded` (same skip policy as `acquireIfNeeded`) with `setEnv: true`.\n */\nexport async function cloneWorkerDatabase(options: CloneWorkerDatabaseOptions = {}): Promise<void> {\n  const name =\n    options.name ?? process.env.JEST_WORKER_ID ?? process.env.VITEST_POOL_ID ?? String(process.pid);\n  const clone = await cloneFromTemplateIfNeeded({\n    root: options.root,\n    mode: \"test\",\n    name,\n    reuse: true,\n    setEnv: true,\n  });\n  if (clone.status === \"cloned\" && options.reset !== \"none\") {\n    await truncateUserTables({ adminUrl: clone.adminUrl, databaseName: clone.databaseName });\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AA8BA,eAAsB,kBACpB,SACgC;CAChC,MAAM,SAAS,MAAM,gBAAgB;EACnC,MAAM,QAAQ;EACd,MAAM;EACN,OAAO;EACP,QAAQ,QAAQ,WAAW;CAC7B,CAAC;CACD,IAAI,OAAO,WAAW,YAAY,OAAO;CAEzC,IAAI;EACF,MAAM,QAAQ,QAAQ;GACpB,aAAa,OAAO;GACpB,UAAU,OAAO;GACjB,cAAc,OAAO;GACrB,UAAU,OAAO;EACnB,CAAC;EACD,MAAM,aAAa;GACjB,MAAM,OAAO;GACb,MAAM;GACN,UAAU,OAAO;EACnB,CAAC;CACH,SAAS,KAAK;EACZ,IAAI;GACF,MAAM,QAAQ;IAAE,MAAM,OAAO;IAAM,MAAM;GAAO,CAAC;EACnD,QAAQ,CAER;EACA,MAAM,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;EAC9D,MAAM,IAAI,MACR,6DAA6D,OAAO,aAAa,+BAClD,UAC/B,EAAE,OAAO,IAAI,CACf;CACF;CAEA,OAAO;AACT;;;;;;;;;;;;;;;;;;;AAiCA,eAAsB,oBAAoB,UAAsC,CAAC,GAAkB;CACjG,MAAM,OACJ,QAAQ,QAAQ,QAAQ,IAAI,kBAAkB,QAAQ,IAAI,kBAAkB,OAAO,QAAQ,GAAG;CAChG,MAAM,QAAQ,MAAM,0BAA0B;EAC5C,MAAM,QAAQ;EACd,MAAM;EACN;EACA,OAAO;EACP,QAAQ;CACV,CAAC;CACD,IAAI,MAAM,WAAW,YAAY,QAAQ,UAAU,QACjD,MAAM,mBAAmB;EAAE,UAAU,MAAM;EAAU,cAAc,MAAM;CAAa,CAAC;AAE3F"}

package/dist/template-mode-DMO5-z7O.cjs

@@ -0,0 +1,92 @@
+const require_lifecycle = require("./lifecycle-BCeM96tI.cjs");
+const require_template = require("./template-Cd77H7Cr.cjs");
+//#region src/adapters/template-mode.ts
+/**
+* Runner orchestration: fresh acquire → migrate → markTemplate.
+* The acquire is `fresh`: leftovers a crashed earlier run left under this
+* worktree's test role (TEMPLATE, worker clones) are dropped first, so migrate
+* always starts from an empty database and no consumer pre-cleanup is needed.
+* After acquire succeeds, migrate + markTemplate are all-or-nothing: any failure
+* best-effort disposes the lease so Vitest (no separate teardown) does not leak.
+* Programmatic apps that do not need a migrate hook should call core
+* `acquire` + `markTemplate` + `cloneFromTemplate` + `dispose` instead.
+*/
+async function setupTemplateMode(options) {
+	const result = await require_lifecycle.acquireIfNeeded({
+		root: options.root,
+		mode: "test",
+		fresh: true,
+		setEnv: options.setEnv !== false
+	});
+	if (result.status !== "acquired") return result;
+	try {
+		await options.migrate({
+			databaseUrl: result.databaseUrl,
+			adminUrl: result.adminUrl,
+			databaseName: result.databaseName,
+			roleName: result.roleName
+		});
+		await require_template.markTemplate({
+			root: result.root,
+			mode: "test",
+			adminUrl: result.adminUrl
+		});
+	} catch (err) {
+		try {
+			await require_lifecycle.dispose({
+				root: result.root,
+				mode: "test"
+			});
+		} catch {}
+		const detail = err instanceof Error ? err.message : String(err);
+		throw new Error(`template setup failed after acquire; cleaned up lease DB (${result.databaseName}). Fix the error and re-run: ${detail}`, { cause: err });
+	}
+	return result;
+}
+/**
+* One clone per worker (`<template>_c_<JEST_WORKER_ID | VITEST_POOL_ID | pid>`),
+* shared by every test file that worker runs. Call it once per test file
+* (`beforeAll` in `setupFilesAfterEnv`, or a Vitest `setupFiles` module).
+*
+* The first file creates the clone. Later files reuse it (`reuse: true`): the
+* database itself is the source of truth, so this holds even though Jest gives
+* each file a fresh `globalThis` and module registry. Clones left over from a
+* crashed earlier run cannot leak in — `setupTemplateMode` drops them first.
+*
+* Every file then starts from empty tables with identities restarted (`reset`),
+* the first file included, so file order never changes what a file sees. That
+* also clears rows `migrate` seeded into the TEMPLATE; pass `reset: "none"` to
+* keep them and reset on your own. A skipped clone (external URL, `CEDAR_PG=0`)
+* is never truncated.
+*
+* Uses `cloneFromTemplateIfNeeded` (same skip policy as `acquireIfNeeded`) with `setEnv: true`.
+*/
+async function cloneWorkerDatabase(options = {}) {
+	const name = options.name ?? process.env.JEST_WORKER_ID ?? process.env.VITEST_POOL_ID ?? String(process.pid);
+	const clone = await require_template.cloneFromTemplateIfNeeded({
+		root: options.root,
+		mode: "test",
+		name,
+		reuse: true,
+		setEnv: true
+	});
+	if (clone.status === "cloned" && options.reset !== "none") await require_lifecycle.truncateUserTables({
+		adminUrl: clone.adminUrl,
+		databaseName: clone.databaseName
+	});
+}
+//#endregion
+Object.defineProperty(exports, "cloneWorkerDatabase", {
+	enumerable: true,
+	get: function() {
+		return cloneWorkerDatabase;
+	}
+});
+Object.defineProperty(exports, "setupTemplateMode", {
+	enumerable: true,
+	get: function() {
+		return setupTemplateMode;
+	}
+});
+
+//# sourceMappingURL=template-mode-DMO5-z7O.cjs.map

package/dist/template-mode-DMO5-z7O.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-mode-DMO5-z7O.cjs","names":["acquireIfNeeded","markTemplate","dispose","cloneFromTemplateIfNeeded","truncateUserTables"],"sources":["../src/adapters/template-mode.ts"],"sourcesContent":["import { dispose, acquireIfNeeded, type AcquireIfNeededResult } from \"../core/lifecycle.ts\";\nimport { cloneFromTemplateIfNeeded, markTemplate } from \"../core/template.ts\";\nimport { truncateUserTables } from \"../providers/autopg.ts\";\n\nexport type TemplateMigrateContext = {\n  databaseUrl: string;\n  adminUrl: string;\n  databaseName: string;\n  roleName: string;\n};\n\nexport type TemplateMigrateFn = (ctx: TemplateMigrateContext) => void | Promise<void>;\n\nexport type SetupTemplateModeOptions = {\n  root?: string;\n  /** App-owned migrate; runs once, then `markTemplate`. Required. */\n  migrate: TemplateMigrateFn;\n  setEnv?: boolean;\n};\n\n/**\n * Runner orchestration: fresh acquire → migrate → markTemplate.\n * The acquire is `fresh`: leftovers a crashed earlier run left under this\n * worktree's test role (TEMPLATE, worker clones) are dropped first, so migrate\n * always starts from an empty database and no consumer pre-cleanup is needed.\n * After acquire succeeds, migrate + markTemplate are all-or-nothing: any failure\n * best-effort disposes the lease so Vitest (no separate teardown) does not leak.\n * Programmatic apps that do not need a migrate hook should call core\n * `acquire` + `markTemplate` + `cloneFromTemplate` + `dispose` instead.\n */\nexport async function setupTemplateMode(\n  options: SetupTemplateModeOptions,\n): Promise<AcquireIfNeededResult> {\n  const result = await acquireIfNeeded({\n    root: options.root,\n    mode: \"test\",\n    fresh: true,\n    setEnv: options.setEnv !== false,\n  });\n  if (result.status !== \"acquired\") return result;\n\n  try {\n    await options.migrate({\n      databaseUrl: result.databaseUrl,\n      adminUrl: result.adminUrl,\n      databaseName: result.databaseName,\n      roleName: result.roleName,\n    });\n    await markTemplate({\n      root: result.root,\n      mode: \"test\",\n      adminUrl: result.adminUrl,\n    });\n  } catch (err) {\n    try {\n      await dispose({ root: result.root, mode: \"test\" });\n    } catch {\n      // best-effort: leave lease for dispose/gc retry\n    }\n    const detail = err instanceof Error ? err.message : String(err);\n    throw new Error(\n      `template setup failed after acquire; cleaned up lease DB (${result.databaseName}). ` +\n        `Fix the error and re-run: ${detail}`,\n      { cause: err },\n    );\n  }\n\n  return result;\n}\n\nexport type CloneWorkerDatabaseOptions = {\n  root?: string;\n  /** Clone suffix; defaults to JEST_WORKER_ID / VITEST_POOL_ID / pid. */\n  name?: string;\n  /**\n   * How each file starts on the worker clone (default `\"truncate\"`):\n   * - `\"truncate\"`: `TRUNCATE … RESTART IDENTITY` on every user table, so rows\n   *   from earlier files are gone and serial / identity IDs restart at 1.\n   * - `\"none\"`: keep whatever the previous file left (app-owned reset).\n   */\n  reset?: \"truncate\" | \"none\";\n};\n\n/**\n * One clone per worker (`<template>_c_<JEST_WORKER_ID | VITEST_POOL_ID | pid>`),\n * shared by every test file that worker runs. Call it once per test file\n * (`beforeAll` in `setupFilesAfterEnv`, or a Vitest `setupFiles` module).\n *\n * The first file creates the clone. Later files reuse it (`reuse: true`): the\n * database itself is the source of truth, so this holds even though Jest gives\n * each file a fresh `globalThis` and module registry. Clones left over from a\n * crashed earlier run cannot leak in — `setupTemplateMode` drops them first.\n *\n * Every file then starts from empty tables with identities restarted (`reset`),\n * the first file included, so file order never changes what a file sees. That\n * also clears rows `migrate` seeded into the TEMPLATE; pass `reset: \"none\"` to\n * keep them and reset on your own. A skipped clone (external URL, `CEDAR_PG=0`)\n * is never truncated.\n *\n * Uses `cloneFromTemplateIfNeeded` (same skip policy as `acquireIfNeeded`) with `setEnv: true`.\n */\nexport async function cloneWorkerDatabase(options: CloneWorkerDatabaseOptions = {}): Promise<void> {\n  const name =\n    options.name ?? process.env.JEST_WORKER_ID ?? process.env.VITEST_POOL_ID ?? String(process.pid);\n  const clone = await cloneFromTemplateIfNeeded({\n    root: options.root,\n    mode: \"test\",\n    name,\n    reuse: true,\n    setEnv: true,\n  });\n  if (clone.status === \"cloned\" && options.reset !== \"none\") {\n    await truncateUserTables({ adminUrl: clone.adminUrl, databaseName: clone.databaseName });\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AA8BA,eAAsB,kBACpB,SACgC;CAChC,MAAM,SAAS,MAAMA,kBAAAA,gBAAgB;EACnC,MAAM,QAAQ;EACd,MAAM;EACN,OAAO;EACP,QAAQ,QAAQ,WAAW;CAC7B,CAAC;CACD,IAAI,OAAO,WAAW,YAAY,OAAO;CAEzC,IAAI;EACF,MAAM,QAAQ,QAAQ;GACpB,aAAa,OAAO;GACpB,UAAU,OAAO;GACjB,cAAc,OAAO;GACrB,UAAU,OAAO;EACnB,CAAC;EACD,MAAMC,iBAAAA,aAAa;GACjB,MAAM,OAAO;GACb,MAAM;GACN,UAAU,OAAO;EACnB,CAAC;CACH,SAAS,KAAK;EACZ,IAAI;GACF,MAAMC,kBAAAA,QAAQ;IAAE,MAAM,OAAO;IAAM,MAAM;GAAO,CAAC;EACnD,QAAQ,CAER;EACA,MAAM,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;EAC9D,MAAM,IAAI,MACR,6DAA6D,OAAO,aAAa,+BAClD,UAC/B,EAAE,OAAO,IAAI,CACf;CACF;CAEA,OAAO;AACT;;;;;;;;;;;;;;;;;;;AAiCA,eAAsB,oBAAoB,UAAsC,CAAC,GAAkB;CACjG,MAAM,OACJ,QAAQ,QAAQ,QAAQ,IAAI,kBAAkB,QAAQ,IAAI,kBAAkB,OAAO,QAAQ,GAAG;CAChG,MAAM,QAAQ,MAAMC,iBAAAA,0BAA0B;EAC5C,MAAM,QAAQ;EACd,MAAM;EACN;EACA,OAAO;EACP,QAAQ;CACV,CAAC;CACD,IAAI,MAAM,WAAW,YAAY,QAAQ,UAAU,QACjD,MAAMC,kBAAAA,mBAAmB;EAAE,UAAU,MAAM;EAAU,cAAc,MAAM;CAAa,CAAC;AAE3F"}

package/dist/test-env.cjs

@@ -10,7 +10,7 @@
 * // or: setupFiles: ['@cedarjs/pg/test-env']
 * ```
 */
-require("./load-test-env-CkdUjTpV.cjs").loadTestEnv();
+require("./load-test-env-Dcgh6YHV.cjs").loadTestEnv();
 //#endregion
 
 //# sourceMappingURL=test-env.cjs.map

package/dist/test-env.mjs

@@ -1,4 +1,4 @@
-import { t as loadTestEnv } from "./load-test-env-C34wpkIX.mjs";
+import { t as loadTestEnv } from "./load-test-env-BqtA6V-d.mjs";
 //#region src/adapters/test-env.ts
 /**
 * Test-runner `setupFiles` entry: inject `DATABASE_URL` from `.cedarpg/test.env`.

package/dist/vite-plus.cjs

@@ -1,18 +1,119 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_tasks = require("./tasks-Caud9yHr.cjs");
+const require_lease = require("./lease-WlmOnNDi.cjs");
+const require_status = require("./status-Z_BYdxzI.cjs");
+const require_studio = require("./studio-CdWIdnxr.cjs");
+//#region src/adapters/vite-dev-plugin.ts
+const requireVite = (0, require("node:module").createRequire)(require("url").pathToFileURL(__filename).href);
+function installedViteVersion() {
+	try {
+		return requireVite("vite/package.json").version;
+	} catch {
+		return;
+	}
+}
+function viteBindsPluginShortcuts(version) {
+	const resolved = version ?? installedViteVersion();
+	if (resolved === void 0) return false;
+	return Number.parseInt(resolved, 10) >= 8;
+}
+function shouldShowPanel() {
+	return Boolean(process.stdin.isTTY) && !process.env.CI;
+}
+function logStatus(server, options) {
+	const status = require_status.resolveDevStatus({
+		root: options.root,
+		mode: options.mode
+	});
+	for (const line of require_studio.formatDevStatus(status)) if (status.ok) server.config.logger.info(line);
+	else server.config.logger.warn(line);
+	return status;
+}
+function createStudioLauncher(options) {
+	let studioChild;
+	const prefer = options.studio === false ? void 0 : options.studio;
+	return (s) => {
+		const status = logStatus(s, options);
+		if (!status.ok) return;
+		const studio = require_studio.detectStudio({
+			root: status.root,
+			cwd: options.cwd ?? s.config.root,
+			prefer
+		});
+		if (!studio) {
+			s.config.logger.warn(`${require_lease.CLI_NAME}: no Prisma or Drizzle Studio found (install prisma or drizzle-kit)`);
+			return;
+		}
+		if (require_studio.studioChildRunning(studioChild)) {
+			s.config.logger.info(`${require_lease.CLI_NAME}: studio already running`);
+			return;
+		}
+		const child = require_studio.openStudio({
+			databaseUrl: status.databaseUrl,
+			studio
+		});
+		child.once("error", (err) => {
+			studioChild = void 0;
+			s.config.logger.error(`${require_lease.CLI_NAME}: studio failed: ${err.message}`);
+		});
+		child.once("exit", (code, signal) => {
+			studioChild = void 0;
+			if (code && code !== 0) s.config.logger.warn(`${require_lease.CLI_NAME}: studio exited ${code}`);
+			else if (signal) s.config.logger.warn(`${require_lease.CLI_NAME}: studio killed (${signal})`);
+		});
+		studioChild = child;
+		s.config.logger.info(`${require_lease.CLI_NAME}: opening ${studio.kind} studio (${studio.command} ${studio.args.join(" ")})`);
+	};
+}
+/**
+* Vite / Vite+ plugin: print a cedar-pg status panel on listen and register
+* CLI shortcuts (`d` status, `s` studio) on Vite 8+. Does **not** acquire —
+* pair with `cedarPgTasks()` / `dependsOn: ['db:acquire']`.
+*
+* @param viteVersion Test-only override for the shortcut gate. Omit in production.
+*/
+function cedarPgDev(options = {}, viteVersion) {
+	return {
+		name: "cedar-pg-dev",
+		configureServer(server) {
+			if (shouldShowPanel() && server.httpServer) server.httpServer.once("listening", () => {
+				logStatus(server, options);
+			});
+			if (!viteBindsPluginShortcuts(viteVersion)) return;
+			const dShortcut = {
+				key: "d",
+				description: "show cedar-pg database status",
+				action(s) {
+					logStatus(s, options);
+				}
+			};
+			const shortcuts = options.studio === false ? [dShortcut] : [dShortcut, {
+				key: "s",
+				description: "open Prisma/Drizzle studio (cedar-pg DATABASE_URL)",
+				action: createStudioLauncher(options)
+			}];
+			server.bindCLIShortcuts({
+				print: false,
+				customShortcuts: shortcuts
+			});
+		}
+	};
+}
+//#endregion
 //#region src/adapters/vite-plus.ts
 /**
 * Consumer adapter for external Vite+ projects.
 *
-* Merge into `vite.config.ts` `run.tasks` so `vp run test` / `vp run dev`
-* depend on cedarpg acquire.
+* - `cedarPgTasks()` — merge into `run.tasks` so `vp run test` / `vp run dev`
+*   depend on cedarpg acquire.
+* - `cedarPgDev()` — Vite plugin: status panel + `d` / `s` shortcuts on Vite 8 (no acquire).
 *
 * @example
 * ```ts
 * import { defineConfig } from 'vite-plus'
-* import { cedarPgTasks } from '@cedarjs/pg/vite-plus'
+* import { cedarPgTasks, cedarPgDev } from '@cedarjs/pg/vite-plus'
 *
 * export default defineConfig({
+*   plugins: [cedarPgDev()],
 *   run: {
 *     tasks: {
 *       ...cedarPgTasks(),
@@ -21,10 +122,11 @@ const require_tasks = require("./tasks-Caud9yHr.cjs");
 *         dependsOn: ['db:acquire-test'],
 *         env: ['DATABASE_URL', 'TEST_DATABASE_URL'],
 *       },
+*       // dependsOn does not forward env: attach hands vp dev the lease URL.
 *       dev: {
-*         command: 'vp dev',
+*         command: 'cedarpg run --attach --mode=dev -- vp dev',
 *         dependsOn: ['db:acquire'],
-*         env: ['DATABASE_URL'],
+*         cache: false,
 *       },
 *     },
 *   },
@@ -32,9 +134,10 @@ const require_tasks = require("./tasks-Caud9yHr.cjs");
 * ```
 */
 //#endregion
-exports.CEDAR_PG_TASK_ACQUIRE_DEV = require_tasks.CEDAR_PG_TASK_ACQUIRE_DEV;
-exports.CEDAR_PG_TASK_ACQUIRE_TEST = require_tasks.CEDAR_PG_TASK_ACQUIRE_TEST;
-exports.CEDAR_PG_TASK_DISPOSE_TEST = require_tasks.CEDAR_PG_TASK_DISPOSE_TEST;
-exports.cedarPgTasks = require_tasks.cedarPgLifecycleTargets;
+exports.CEDAR_PG_TASK_ACQUIRE_DEV = require_studio.CEDAR_PG_TASK_ACQUIRE_DEV;
+exports.CEDAR_PG_TASK_ACQUIRE_TEST = require_studio.CEDAR_PG_TASK_ACQUIRE_TEST;
+exports.CEDAR_PG_TASK_DISPOSE_TEST = require_studio.CEDAR_PG_TASK_DISPOSE_TEST;
+exports.cedarPgDev = cedarPgDev;
+exports.cedarPgTasks = require_studio.cedarPgLifecycleTargets;
 
 //# sourceMappingURL=vite-plus.cjs.map

package/dist/vite-plus.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"vite-plus.cjs","names":[],"sources":["../src/adapters/vite-plus.ts"],"sourcesContent":["/**\n * Consumer adapter for external Vite+ projects.\n *\n * Merge into `vite.config.ts` `run.tasks` so `vp run test` / `vp run dev`\n * depend on cedarpg acquire.\n *\n * @example\n * ```ts\n * import { defineConfig } from 'vite-plus'\n * import { cedarPgTasks } from '@cedarjs/pg/vite-plus'\n *\n * export default defineConfig({\n *   run: {\n *     tasks: {\n *       ...cedarPgTasks(),\n *       test: {\n *         command: 'vp test',\n *         dependsOn: ['db:acquire-test'],\n *         env: ['DATABASE_URL', 'TEST_DATABASE_URL'],\n *       },\n *       dev: {\n *         command: 'vp dev',\n *         dependsOn: ['db:acquire'],\n *         env: ['DATABASE_URL'],\n *       },\n *     },\n *   },\n * })\n * ```\n */\n\nimport {\n  cedarPgLifecycleTargets,\n  type CedarPgLifecycleTarget,\n  type CedarPgLifecycleTargetsOptions,\n  CEDAR_PG_TASK_DISPOSE_TEST,\n  CEDAR_PG_TASK_ACQUIRE_DEV,\n  CEDAR_PG_TASK_ACQUIRE_TEST,\n} from \"./tasks.ts\";\n\nexport {\n  CEDAR_PG_TASK_ACQUIRE_DEV,\n  CEDAR_PG_TASK_ACQUIRE_TEST,\n  CEDAR_PG_TASK_DISPOSE_TEST,\n  cedarPgLifecycleTargets as cedarPgTasks,\n};\n\nexport type CedarPgTaskDef = CedarPgLifecycleTarget;\nexport type CedarPgTasksOptions = CedarPgLifecycleTargetsOptions;\n"],"mappings":""}
+{"version":3,"file":"vite-plus.cjs","names":["resolveDevStatus","formatDevStatus","detectStudio","CLI_NAME","studioChildRunning","openStudio"],"sources":["../src/adapters/vite-dev-plugin.ts","../src/adapters/vite-plus.ts"],"sourcesContent":["import { createRequire } from \"node:module\";\nimport type { ChildProcess } from \"node:child_process\";\nimport type { Plugin, ViteDevServer } from \"vite\";\nimport { CLI_NAME } from \"../core/constants.ts\";\nimport { resolveDevStatus, type DevStatus } from \"../core/status.ts\";\nimport type { DbMode } from \"../core/naming.ts\";\nimport { formatDevStatus } from \"./status-format.ts\";\nimport { detectStudio, openStudio, studioChildRunning, type StudioKind } from \"./studio.ts\";\n\nconst requireVite = createRequire(import.meta.url);\n\nfunction installedViteVersion(): string | undefined {\n  try {\n    return (requireVite(\"vite/package.json\") as { version: string }).version;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function viteBindsPluginShortcuts(version?: string): boolean {\n  const resolved = version ?? installedViteVersion();\n  if (resolved === undefined) return false;\n  return Number.parseInt(resolved, 10) >= 8;\n}\n\nexport type CedarPgDevOptions = {\n  mode?: DbMode;\n  /** Worktree / lease root. Omit to resolve from cwd (git toplevel). */\n  root?: string;\n  /** App package to search for Prisma/Drizzle. Defaults to Vite `config.root`. */\n  cwd?: string;\n  /** Force Prisma/Drizzle Studio; `false` disables the `s` shortcut. Omit to auto-detect. */\n  studio?: StudioKind | false;\n};\n\nfunction shouldShowPanel(): boolean {\n  return Boolean(process.stdin.isTTY) && !process.env.CI;\n}\n\nfunction logStatus(server: ViteDevServer, options: CedarPgDevOptions): DevStatus {\n  const status = resolveDevStatus({ root: options.root, mode: options.mode });\n  for (const line of formatDevStatus(status)) {\n    if (status.ok) server.config.logger.info(line);\n    else server.config.logger.warn(line);\n  }\n  return status;\n}\n\nfunction createStudioLauncher(options: CedarPgDevOptions): (s: ViteDevServer) => void {\n  let studioChild: ChildProcess | undefined;\n  const prefer = options.studio === false ? undefined : options.studio;\n  return (s) => {\n    const status = logStatus(s, options);\n    if (!status.ok) return;\n\n    const studio = detectStudio({\n      root: status.root,\n      cwd: options.cwd ?? s.config.root,\n      prefer,\n    });\n    if (!studio) {\n      s.config.logger.warn(\n        `${CLI_NAME}: no Prisma or Drizzle Studio found (install prisma or drizzle-kit)`,\n      );\n      return;\n    }\n\n    if (studioChildRunning(studioChild)) {\n      s.config.logger.info(`${CLI_NAME}: studio already running`);\n      return;\n    }\n\n    const child = openStudio({ databaseUrl: status.databaseUrl, studio });\n    child.once(\"error\", (err) => {\n      studioChild = undefined;\n      s.config.logger.error(`${CLI_NAME}: studio failed: ${err.message}`);\n    });\n    child.once(\"exit\", (code, signal) => {\n      studioChild = undefined;\n      if (code && code !== 0) {\n        s.config.logger.warn(`${CLI_NAME}: studio exited ${code}`);\n      } else if (signal) {\n        s.config.logger.warn(`${CLI_NAME}: studio killed (${signal})`);\n      }\n    });\n    studioChild = child;\n    s.config.logger.info(\n      `${CLI_NAME}: opening ${studio.kind} studio (${studio.command} ${studio.args.join(\" \")})`,\n    );\n  };\n}\n\n/**\n * Vite / Vite+ plugin: print a cedar-pg status panel on listen and register\n * CLI shortcuts (`d` status, `s` studio) on Vite 8+. Does **not** acquire —\n * pair with `cedarPgTasks()` / `dependsOn: ['db:acquire']`.\n *\n * @param viteVersion Test-only override for the shortcut gate. Omit in production.\n */\nexport function cedarPgDev(options: CedarPgDevOptions = {}, viteVersion?: string): Plugin {\n  return {\n    name: \"cedar-pg-dev\",\n    configureServer(server) {\n      if (shouldShowPanel() && server.httpServer) {\n        server.httpServer.once(\"listening\", () => {\n          logStatus(server, options);\n        });\n      }\n\n      if (!viteBindsPluginShortcuts(viteVersion)) {\n        return;\n      }\n\n      const dShortcut = {\n        key: \"d\",\n        description: \"show cedar-pg database status\",\n        action(s: ViteDevServer) {\n          logStatus(s, options);\n        },\n      };\n      const shortcuts =\n        options.studio === false\n          ? [dShortcut]\n          : [\n              dShortcut,\n              {\n                key: \"s\",\n                description: \"open Prisma/Drizzle studio (cedar-pg DATABASE_URL)\",\n                action: createStudioLauncher(options),\n              },\n            ];\n\n      server.bindCLIShortcuts({\n        print: false,\n        customShortcuts: shortcuts,\n      });\n    },\n  };\n}\n","/**\n * Consumer adapter for external Vite+ projects.\n *\n * - `cedarPgTasks()` — merge into `run.tasks` so `vp run test` / `vp run dev`\n *   depend on cedarpg acquire.\n * - `cedarPgDev()` — Vite plugin: status panel + `d` / `s` shortcuts on Vite 8 (no acquire).\n *\n * @example\n * ```ts\n * import { defineConfig } from 'vite-plus'\n * import { cedarPgTasks, cedarPgDev } from '@cedarjs/pg/vite-plus'\n *\n * export default defineConfig({\n *   plugins: [cedarPgDev()],\n *   run: {\n *     tasks: {\n *       ...cedarPgTasks(),\n *       test: {\n *         command: 'vp test',\n *         dependsOn: ['db:acquire-test'],\n *         env: ['DATABASE_URL', 'TEST_DATABASE_URL'],\n *       },\n *       // dependsOn does not forward env: attach hands vp dev the lease URL.\n *       dev: {\n *         command: 'cedarpg run --attach --mode=dev -- vp dev',\n *         dependsOn: ['db:acquire'],\n *         cache: false,\n *       },\n *     },\n *   },\n * })\n * ```\n */\n\nimport {\n  cedarPgLifecycleTargets,\n  type CedarPgLifecycleTarget,\n  type CedarPgLifecycleTargetsOptions,\n  CEDAR_PG_TASK_DISPOSE_TEST,\n  CEDAR_PG_TASK_ACQUIRE_DEV,\n  CEDAR_PG_TASK_ACQUIRE_TEST,\n} from \"./tasks.ts\";\n\nexport {\n  CEDAR_PG_TASK_ACQUIRE_DEV,\n  CEDAR_PG_TASK_ACQUIRE_TEST,\n  CEDAR_PG_TASK_DISPOSE_TEST,\n  cedarPgLifecycleTargets as cedarPgTasks,\n};\n\nexport type CedarPgTaskDef = CedarPgLifecycleTarget;\nexport type CedarPgTasksOptions = CedarPgLifecycleTargetsOptions;\n\nexport { cedarPgDev } from \"./vite-dev-plugin.ts\";\nexport type { CedarPgDevOptions } from \"./vite-dev-plugin.ts\";\n"],"mappings":";;;;;AASA,MAAM,eAAA,wBAAA,CAAA,CAAA,cAAA,CAAA,QAAA,KAAA,CAAA,CAAA,cAAA,UAAA,CAAA,CAAA,IAA2C;AAEjD,SAAS,uBAA2C;CAClD,IAAI;EACF,OAAQ,YAAY,mBAAmB,CAAC,CAAyB;CACnE,QAAQ;EACN;CACF;AACF;AAEA,SAAgB,yBAAyB,SAA2B;CAClE,MAAM,WAAW,WAAW,qBAAqB;CACjD,IAAI,aAAa,KAAA,GAAW,OAAO;CACnC,OAAO,OAAO,SAAS,UAAU,EAAE,KAAK;AAC1C;AAYA,SAAS,kBAA2B;CAClC,OAAO,QAAQ,QAAQ,MAAM,KAAK,KAAK,CAAC,QAAQ,IAAI;AACtD;AAEA,SAAS,UAAU,QAAuB,SAAuC;CAC/E,MAAM,SAASA,eAAAA,iBAAiB;EAAE,MAAM,QAAQ;EAAM,MAAM,QAAQ;CAAK,CAAC;CAC1E,KAAK,MAAM,QAAQC,eAAAA,gBAAgB,MAAM,GACvC,IAAI,OAAO,IAAI,OAAO,OAAO,OAAO,KAAK,IAAI;MACxC,OAAO,OAAO,OAAO,KAAK,IAAI;CAErC,OAAO;AACT;AAEA,SAAS,qBAAqB,SAAwD;CACpF,IAAI;CACJ,MAAM,SAAS,QAAQ,WAAW,QAAQ,KAAA,IAAY,QAAQ;CAC9D,QAAQ,MAAM;EACZ,MAAM,SAAS,UAAU,GAAG,OAAO;EACnC,IAAI,CAAC,OAAO,IAAI;EAEhB,MAAM,SAASC,eAAAA,aAAa;GAC1B,MAAM,OAAO;GACb,KAAK,QAAQ,OAAO,EAAE,OAAO;GAC7B;EACF,CAAC;EACD,IAAI,CAAC,QAAQ;GACX,EAAE,OAAO,OAAO,KACd,GAAGC,cAAAA,SAAS,oEACd;GACA;EACF;EAEA,IAAIC,eAAAA,mBAAmB,WAAW,GAAG;GACnC,EAAE,OAAO,OAAO,KAAK,GAAGD,cAAAA,SAAS,yBAAyB;GAC1D;EACF;EAEA,MAAM,QAAQE,eAAAA,WAAW;GAAE,aAAa,OAAO;GAAa;EAAO,CAAC;EACpE,MAAM,KAAK,UAAU,QAAQ;GAC3B,cAAc,KAAA;GACd,EAAE,OAAO,OAAO,MAAM,GAAGF,cAAAA,SAAS,mBAAmB,IAAI,SAAS;EACpE,CAAC;EACD,MAAM,KAAK,SAAS,MAAM,WAAW;GACnC,cAAc,KAAA;GACd,IAAI,QAAQ,SAAS,GACnB,EAAE,OAAO,OAAO,KAAK,GAAGA,cAAAA,SAAS,kBAAkB,MAAM;QACpD,IAAI,QACT,EAAE,OAAO,OAAO,KAAK,GAAGA,cAAAA,SAAS,mBAAmB,OAAO,EAAE;EAEjE,CAAC;EACD,cAAc;EACd,EAAE,OAAO,OAAO,KACd,GAAGA,cAAAA,SAAS,YAAY,OAAO,KAAK,WAAW,OAAO,QAAQ,GAAG,OAAO,KAAK,KAAK,GAAG,EAAE,EACzF;CACF;AACF;;;;;;;;AASA,SAAgB,WAAW,UAA6B,CAAC,GAAG,aAA8B;CACxF,OAAO;EACL,MAAM;EACN,gBAAgB,QAAQ;GACtB,IAAI,gBAAgB,KAAK,OAAO,YAC9B,OAAO,WAAW,KAAK,mBAAmB;IACxC,UAAU,QAAQ,OAAO;GAC3B,CAAC;GAGH,IAAI,CAAC,yBAAyB,WAAW,GACvC;GAGF,MAAM,YAAY;IAChB,KAAK;IACL,aAAa;IACb,OAAO,GAAkB;KACvB,UAAU,GAAG,OAAO;IACtB;GACF;GACA,MAAM,YACJ,QAAQ,WAAW,QACf,CAAC,SAAS,IACV,CACE,WACA;IACE,KAAK;IACL,aAAa;IACb,QAAQ,qBAAqB,OAAO;GACtC,CACF;GAEN,OAAO,iBAAiB;IACtB,OAAO;IACP,iBAAiB;GACnB,CAAC;EACH;CACF;AACF"}

package/dist/vite-plus.d.cts

@@ -1,7 +1,46 @@
-import { a as CedarPgLifecycleTargetsOptions, i as CedarPgLifecycleTarget, n as CEDAR_PG_TASK_ACQUIRE_TEST, o as cedarPgLifecycleTargets, r as CEDAR_PG_TASK_DISPOSE_TEST, t as CEDAR_PG_TASK_ACQUIRE_DEV } from "./tasks-DdQoP9We.cjs";
+import { t as DbMode } from "./naming-Df4fz_Fb.cjs";
+import { Plugin } from "vite";
+//#region src/adapters/tasks.d.ts
+/** Vite+ lifecycle task names and command strings (also used by the status hint). */
+declare const CEDAR_PG_TASK_ACQUIRE_DEV = "db:acquire";
+declare const CEDAR_PG_TASK_ACQUIRE_TEST = "db:acquire-test";
+declare const CEDAR_PG_TASK_DISPOSE_TEST = "db:dispose-test";
+type CedarPgLifecycleTarget = {
+  command: string;
+  cache?: boolean;
+};
+type CedarPgLifecycleTargetsOptions = {
+  bin?: string;
+  /** Include dispose-test target (default: true). */
+  includeDisposeTest?: boolean;
+};
+declare function cedarPgLifecycleTargets(options?: CedarPgLifecycleTargetsOptions): Record<string, CedarPgLifecycleTarget>;
+//#endregion
+//#region src/adapters/studio.d.ts
+type StudioKind = "prisma" | "drizzle";
+//#endregion
+//#region src/adapters/vite-dev-plugin.d.ts
+type CedarPgDevOptions = {
+  mode?: DbMode;
+  /** Worktree / lease root. Omit to resolve from cwd (git toplevel). */
+  root?: string;
+  /** App package to search for Prisma/Drizzle. Defaults to Vite `config.root`. */
+  cwd?: string;
+  /** Force Prisma/Drizzle Studio; `false` disables the `s` shortcut. Omit to auto-detect. */
+  studio?: StudioKind | false;
+};
+/**
+ * Vite / Vite+ plugin: print a cedar-pg status panel on listen and register
+ * CLI shortcuts (`d` status, `s` studio) on Vite 8+. Does **not** acquire —
+ * pair with `cedarPgTasks()` / `dependsOn: ['db:acquire']`.
+ *
+ * @param viteVersion Test-only override for the shortcut gate. Omit in production.
+ */
+declare function cedarPgDev(options?: CedarPgDevOptions, viteVersion?: string): Plugin;
+//#endregion
 //#region src/adapters/vite-plus.d.ts
 type CedarPgTaskDef = CedarPgLifecycleTarget;
 type CedarPgTasksOptions = CedarPgLifecycleTargetsOptions;
 //#endregion
-export { CEDAR_PG_TASK_ACQUIRE_DEV, CEDAR_PG_TASK_ACQUIRE_TEST, CEDAR_PG_TASK_DISPOSE_TEST, CedarPgTaskDef, CedarPgTasksOptions, cedarPgLifecycleTargets as cedarPgTasks };
+export { CEDAR_PG_TASK_ACQUIRE_DEV, CEDAR_PG_TASK_ACQUIRE_TEST, CEDAR_PG_TASK_DISPOSE_TEST, type CedarPgDevOptions, CedarPgTaskDef, CedarPgTasksOptions, cedarPgDev, cedarPgLifecycleTargets as cedarPgTasks };
 //# sourceMappingURL=vite-plus.d.cts.map