@cedarjs/pg 0.1.0-alpha.0 → 0.2.0-alpha.0

package/dist/tasks-Caud9yHr.cjs

@@ -0,0 +1,67 @@
+const require_constants = require("./constants-Ct8myrEn.cjs");
+//#region src/adapters/tasks.ts
+/** Shared CLI command strings and lifecycle target defs for Vite+ / Nx. */
+const CEDAR_PG_TASK_ACQUIRE_DEV = "db:acquire";
+const CEDAR_PG_TASK_ACQUIRE_TEST = "db:acquire-test";
+const CEDAR_PG_TASK_DISPOSE_TEST = "db:dispose-test";
+function cedarPgCommands(bin = require_constants.CLI_NAME) {
+	return {
+		acquireDev: `${bin} acquire --mode=dev`,
+		acquireTest: `${bin} acquire --mode=test --print-env`,
+		disposeTest: `${bin} dispose --mode=test`
+	};
+}
+function cedarPgLifecycleTargets(options = {}) {
+	const cmds = cedarPgCommands(options.bin ?? "cedarpg");
+	const targets = {
+		[CEDAR_PG_TASK_ACQUIRE_DEV]: {
+			command: cmds.acquireDev,
+			cache: false
+		},
+		[CEDAR_PG_TASK_ACQUIRE_TEST]: {
+			command: cmds.acquireTest,
+			cache: false
+		}
+	};
+	if (options.includeDisposeTest !== false) targets[CEDAR_PG_TASK_DISPOSE_TEST] = {
+		command: cmds.disposeTest,
+		cache: false
+	};
+	return targets;
+}
+function cedarPgRunCommand(mode, command, bin = require_constants.CLI_NAME) {
+	return `${bin} run --mode=${mode} -- ${command}`;
+}
+//#endregion
+Object.defineProperty(exports, "CEDAR_PG_TASK_ACQUIRE_DEV", {
+	enumerable: true,
+	get: function() {
+		return CEDAR_PG_TASK_ACQUIRE_DEV;
+	}
+});
+Object.defineProperty(exports, "CEDAR_PG_TASK_ACQUIRE_TEST", {
+	enumerable: true,
+	get: function() {
+		return CEDAR_PG_TASK_ACQUIRE_TEST;
+	}
+});
+Object.defineProperty(exports, "CEDAR_PG_TASK_DISPOSE_TEST", {
+	enumerable: true,
+	get: function() {
+		return CEDAR_PG_TASK_DISPOSE_TEST;
+	}
+});
+Object.defineProperty(exports, "cedarPgLifecycleTargets", {
+	enumerable: true,
+	get: function() {
+		return cedarPgLifecycleTargets;
+	}
+});
+Object.defineProperty(exports, "cedarPgRunCommand", {
+	enumerable: true,
+	get: function() {
+		return cedarPgRunCommand;
+	}
+});
+
+//# sourceMappingURL=tasks-Caud9yHr.cjs.map

package/dist/tasks-Caud9yHr.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks-Caud9yHr.cjs","names":["CLI_NAME"],"sources":["../src/adapters/tasks.ts"],"sourcesContent":["/** Shared CLI command strings and lifecycle target defs for Vite+ / Nx. */\n\nimport { CLI_NAME } from \"../core/constants.ts\";\nimport type { DbMode } from \"../core/naming.ts\";\n\nexport const CEDAR_PG_TASK_ACQUIRE_DEV = \"db:acquire\";\nexport const CEDAR_PG_TASK_ACQUIRE_TEST = \"db:acquire-test\";\nexport const CEDAR_PG_TASK_DISPOSE_TEST = \"db:dispose-test\";\n\nexport type CedarPgCommands = {\n  acquireDev: string;\n  acquireTest: string;\n  disposeTest: string;\n};\n\nexport type CedarPgLifecycleTarget = {\n  command: string;\n  cache?: boolean;\n};\n\nexport type CedarPgLifecycleTargetsOptions = {\n  bin?: string;\n  /** Include dispose-test target (default: true). */\n  includeDisposeTest?: boolean;\n};\n\nexport function cedarPgCommands(bin = CLI_NAME): CedarPgCommands {\n  return {\n    acquireDev: `${bin} acquire --mode=dev`,\n    acquireTest: `${bin} acquire --mode=test --print-env`,\n    disposeTest: `${bin} dispose --mode=test`,\n  };\n}\n\nexport function cedarPgLifecycleTargets(\n  options: CedarPgLifecycleTargetsOptions = {},\n): Record<string, CedarPgLifecycleTarget> {\n  const cmds = cedarPgCommands(options.bin ?? CLI_NAME);\n  const targets: Record<string, CedarPgLifecycleTarget> = {\n    [CEDAR_PG_TASK_ACQUIRE_DEV]: { command: cmds.acquireDev, cache: false },\n    [CEDAR_PG_TASK_ACQUIRE_TEST]: { command: cmds.acquireTest, cache: false },\n  };\n  if (options.includeDisposeTest !== false) {\n    targets[CEDAR_PG_TASK_DISPOSE_TEST] = { command: cmds.disposeTest, cache: false };\n  }\n  return targets;\n}\n\nexport function cedarPgRunCommand(mode: DbMode, command: string, bin = CLI_NAME): string {\n  return `${bin} run --mode=${mode} -- ${command}`;\n}\n"],"mappings":";;;AAKA,MAAa,4BAA4B;AACzC,MAAa,6BAA6B;AAC1C,MAAa,6BAA6B;AAmB1C,SAAgB,gBAAgB,MAAMA,kBAAAA,UAA2B;CAC/D,OAAO;EACL,YAAY,GAAG,IAAI;EACnB,aAAa,GAAG,IAAI;EACpB,aAAa,GAAG,IAAI;CACtB;AACF;AAEA,SAAgB,wBACd,UAA0C,CAAC,GACH;CACxC,MAAM,OAAO,gBAAgB,QAAQ,OAAA,SAAe;CACpD,MAAM,UAAkD;GACrD,4BAA4B;GAAE,SAAS,KAAK;GAAY,OAAO;EAAM;GACrE,6BAA6B;GAAE,SAAS,KAAK;GAAa,OAAO;EAAM;CAC1E;CACA,IAAI,QAAQ,uBAAuB,OACjC,QAAQ,8BAA8B;EAAE,SAAS,KAAK;EAAa,OAAO;CAAM;CAElF,OAAO;AACT;AAEA,SAAgB,kBAAkB,MAAc,SAAiB,MAAMA,kBAAAA,UAAkB;CACvF,OAAO,GAAG,IAAI,cAAc,KAAK,MAAM;AACzC"}

package/dist/tasks-CjaZRi_G.d.mts

@@ -0,0 +1,19 @@
+import { t as DbMode } from "./naming-C2nGVxPk.mjs";
+//#region src/adapters/tasks.d.ts
+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>;
+declare function cedarPgRunCommand(mode: DbMode, command: string, bin?: string): string;
+//#endregion
+export { CedarPgLifecycleTargetsOptions as a, CedarPgLifecycleTarget as i, CEDAR_PG_TASK_ACQUIRE_TEST as n, cedarPgLifecycleTargets as o, CEDAR_PG_TASK_DISPOSE_TEST as r, cedarPgRunCommand as s, CEDAR_PG_TASK_ACQUIRE_DEV as t };
+//# sourceMappingURL=tasks-CjaZRi_G.d.mts.map

package/dist/tasks-DdQoP9We.d.cts

@@ -0,0 +1,19 @@
+import { t as DbMode } from "./naming-C2nGVxPk.cjs";
+//#region src/adapters/tasks.d.ts
+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>;
+declare function cedarPgRunCommand(mode: DbMode, command: string, bin?: string): string;
+//#endregion
+export { CedarPgLifecycleTargetsOptions as a, CedarPgLifecycleTarget as i, CEDAR_PG_TASK_ACQUIRE_TEST as n, cedarPgLifecycleTargets as o, CEDAR_PG_TASK_DISPOSE_TEST as r, cedarPgRunCommand as s, CEDAR_PG_TASK_ACQUIRE_DEV as t };
+//# sourceMappingURL=tasks-DdQoP9We.d.cts.map

package/dist/tasks-KherHLac.mjs

@@ -0,0 +1,38 @@
+import { t as CLI_NAME } from "./constants-NLR0U4NR.mjs";
+//#region src/adapters/tasks.ts
+/** Shared CLI command strings and lifecycle target defs for Vite+ / Nx. */
+const CEDAR_PG_TASK_ACQUIRE_DEV = "db:acquire";
+const CEDAR_PG_TASK_ACQUIRE_TEST = "db:acquire-test";
+const CEDAR_PG_TASK_DISPOSE_TEST = "db:dispose-test";
+function cedarPgCommands(bin = CLI_NAME) {
+	return {
+		acquireDev: `${bin} acquire --mode=dev`,
+		acquireTest: `${bin} acquire --mode=test --print-env`,
+		disposeTest: `${bin} dispose --mode=test`
+	};
+}
+function cedarPgLifecycleTargets(options = {}) {
+	const cmds = cedarPgCommands(options.bin ?? "cedarpg");
+	const targets = {
+		[CEDAR_PG_TASK_ACQUIRE_DEV]: {
+			command: cmds.acquireDev,
+			cache: false
+		},
+		[CEDAR_PG_TASK_ACQUIRE_TEST]: {
+			command: cmds.acquireTest,
+			cache: false
+		}
+	};
+	if (options.includeDisposeTest !== false) targets[CEDAR_PG_TASK_DISPOSE_TEST] = {
+		command: cmds.disposeTest,
+		cache: false
+	};
+	return targets;
+}
+function cedarPgRunCommand(mode, command, bin = CLI_NAME) {
+	return `${bin} run --mode=${mode} -- ${command}`;
+}
+//#endregion
+export { cedarPgRunCommand as a, cedarPgLifecycleTargets as i, CEDAR_PG_TASK_ACQUIRE_TEST as n, CEDAR_PG_TASK_DISPOSE_TEST as r, CEDAR_PG_TASK_ACQUIRE_DEV as t };
+
+//# sourceMappingURL=tasks-KherHLac.mjs.map

package/dist/tasks-KherHLac.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks-KherHLac.mjs","names":[],"sources":["../src/adapters/tasks.ts"],"sourcesContent":["/** Shared CLI command strings and lifecycle target defs for Vite+ / Nx. */\n\nimport { CLI_NAME } from \"../core/constants.ts\";\nimport type { DbMode } from \"../core/naming.ts\";\n\nexport const CEDAR_PG_TASK_ACQUIRE_DEV = \"db:acquire\";\nexport const CEDAR_PG_TASK_ACQUIRE_TEST = \"db:acquire-test\";\nexport const CEDAR_PG_TASK_DISPOSE_TEST = \"db:dispose-test\";\n\nexport type CedarPgCommands = {\n  acquireDev: string;\n  acquireTest: string;\n  disposeTest: string;\n};\n\nexport type CedarPgLifecycleTarget = {\n  command: string;\n  cache?: boolean;\n};\n\nexport type CedarPgLifecycleTargetsOptions = {\n  bin?: string;\n  /** Include dispose-test target (default: true). */\n  includeDisposeTest?: boolean;\n};\n\nexport function cedarPgCommands(bin = CLI_NAME): CedarPgCommands {\n  return {\n    acquireDev: `${bin} acquire --mode=dev`,\n    acquireTest: `${bin} acquire --mode=test --print-env`,\n    disposeTest: `${bin} dispose --mode=test`,\n  };\n}\n\nexport function cedarPgLifecycleTargets(\n  options: CedarPgLifecycleTargetsOptions = {},\n): Record<string, CedarPgLifecycleTarget> {\n  const cmds = cedarPgCommands(options.bin ?? CLI_NAME);\n  const targets: Record<string, CedarPgLifecycleTarget> = {\n    [CEDAR_PG_TASK_ACQUIRE_DEV]: { command: cmds.acquireDev, cache: false },\n    [CEDAR_PG_TASK_ACQUIRE_TEST]: { command: cmds.acquireTest, cache: false },\n  };\n  if (options.includeDisposeTest !== false) {\n    targets[CEDAR_PG_TASK_DISPOSE_TEST] = { command: cmds.disposeTest, cache: false };\n  }\n  return targets;\n}\n\nexport function cedarPgRunCommand(mode: DbMode, command: string, bin = CLI_NAME): string {\n  return `${bin} run --mode=${mode} -- ${command}`;\n}\n"],"mappings":";;;AAKA,MAAa,4BAA4B;AACzC,MAAa,6BAA6B;AAC1C,MAAa,6BAA6B;AAmB1C,SAAgB,gBAAgB,MAAM,UAA2B;CAC/D,OAAO;EACL,YAAY,GAAG,IAAI;EACnB,aAAa,GAAG,IAAI;EACpB,aAAa,GAAG,IAAI;CACtB;AACF;AAEA,SAAgB,wBACd,UAA0C,CAAC,GACH;CACxC,MAAM,OAAO,gBAAgB,QAAQ,OAAA,SAAe;CACpD,MAAM,UAAkD;GACrD,4BAA4B;GAAE,SAAS,KAAK;GAAY,OAAO;EAAM;GACrE,6BAA6B;GAAE,SAAS,KAAK;GAAa,OAAO;EAAM;CAC1E;CACA,IAAI,QAAQ,uBAAuB,OACjC,QAAQ,8BAA8B;EAAE,SAAS,KAAK;EAAa,OAAO;CAAM;CAElF,OAAO;AACT;AAEA,SAAgB,kBAAkB,MAAc,SAAiB,MAAM,UAAkB;CACvF,OAAO,GAAG,IAAI,cAAc,KAAK,MAAM;AACzC"}

package/dist/template-CGw3C1Ob.mjs

@@ -0,0 +1,88 @@
+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";
+//#region src/core/template.ts
+async function resolveAdminUrl(adminUrl) {
+	return adminUrl ?? (await ensureHostRunning()).adminUrl;
+}
+/**
+* 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);
+	await setDatabaseIsTemplate({
+		adminUrl,
+		databaseName: lease.databaseName,
+		isTemplate: true
+	});
+	return {
+		databaseName: lease.databaseName,
+		adminUrl
+	};
+}
+/**
+* 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.
+*/
+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 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
+	});
+	const databaseUrl = buildDatabaseUrl({
+		port: lease.port,
+		databaseName,
+		roleName: lease.roleName
+	});
+	if (options.setEnv) applyDatabaseUrlEnv(databaseUrl, { mode });
+	const roleName = lease.roleName;
+	return {
+		databaseUrl,
+		adminUrl,
+		databaseName,
+		roleName,
+		templateName: lease.databaseName,
+		port: lease.port,
+		dropClone: async () => {
+			await dropDatabase({
+				adminUrl,
+				databaseName,
+				roleName
+			});
+		}
+	};
+}
+/**
+* Resolve skip policy then clone. Host entry for worker adapters (same skip
+* semantics as `acquireIfNeeded`). Defaults `setEnv` on for skip and clone paths.
+*/
+async function cloneFromTemplateIfNeeded(options) {
+	const outcome = await runIfNeeded(options, () => cloneFromTemplate({
+		...options,
+		setEnv: options.setEnv !== false
+	}));
+	if (outcome.status === "skipped") return outcome;
+	return {
+		status: "cloned",
+		...outcome.value
+	};
+}
+//#endregion
+export { cloneFromTemplateIfNeeded as n, markTemplate as r, cloneFromTemplate as t };
+
+//# sourceMappingURL=template-CGw3C1Ob.mjs.map

package/dist/template-CGw3C1Ob.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-CGw3C1Ob.mjs","names":[],"sources":["../src/core/template.ts"],"sourcesContent":["import { buildCloneDatabaseName, type DbMode } from \"./naming.ts\";\nimport { readLease } from \"./lease.ts\";\nimport { applyDatabaseUrlEnv, runIfNeeded, type ResolveAcquireSkipInput } from \"./policy.ts\";\nimport { resolveWorktreeIdentity } from \"./worktree.ts\";\nimport {\n  buildDatabaseUrl,\n  cloneDatabaseFromTemplate,\n  dropDatabase,\n  setDatabaseIsTemplate,\n} from \"../providers/autopg.ts\";\nimport { ensureHostRunning } from \"../providers/host.ts\";\n\nasync function resolveAdminUrl(adminUrl?: string): Promise<string> {\n  return adminUrl ?? (await ensureHostRunning()).adminUrl;\n}\n\nexport type MarkTemplateOptions = {\n  root?: string;\n  mode: DbMode;\n  /** Superuser URL from `acquire`; when omitted, discovers/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 identity = resolveWorktreeIdentity(options.root);\n  const mode = options.mode;\n  const lease = readLease(identity.root, mode);\n  if (!lease) {\n    throw new Error(`no ${mode} lease; run acquire before markTemplate`);\n  }\n  const adminUrl = await resolveAdminUrl(options.adminUrl);\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, discovers/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   * 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 rediscovered.\n */\nexport async function cloneFromTemplate(options: CloneFromTemplateOptions): Promise<CloneResult> {\n  const identity = resolveWorktreeIdentity(options.root);\n  const mode = options.mode;\n  const lease = readLease(identity.root, mode);\n  if (!lease) {\n    throw new Error(`no ${mode} lease; run acquire + markTemplate before cloneFromTemplate`);\n  }\n\n  const adminUrl = await resolveAdminUrl(options.adminUrl);\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  });\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 });\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":";;;AAYA,eAAe,gBAAgB,UAAoC;CACjE,OAAO,aAAa,MAAM,kBAAkB,EAAA,CAAG;AACjD;;;;;AAaA,eAAsB,aACpB,SACqD;CACrD,MAAM,WAAW,wBAAwB,QAAQ,IAAI;CACrD,MAAM,OAAO,QAAQ;CACrB,MAAM,QAAQ,UAAU,SAAS,MAAM,IAAI;CAC3C,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,MAAM,KAAK,wCAAwC;CAErE,MAAM,WAAW,MAAM,gBAAgB,QAAQ,QAAQ;CACvD,MAAM,sBAAsB;EAC1B;EACA,cAAc,MAAM;EACpB,YAAY;CACd,CAAC;CACD,OAAO;EAAE,cAAc,MAAM;EAAc;CAAS;AACtD;;;;;;;AAuCA,eAAsB,kBAAkB,SAAyD;CAC/F,MAAM,WAAW,wBAAwB,QAAQ,IAAI;CACrD,MAAM,OAAO,QAAQ;CACrB,MAAM,QAAQ,UAAU,SAAS,MAAM,IAAI;CAC3C,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,MAAM,KAAK,4DAA4D;CAGzF,MAAM,WAAW,MAAM,gBAAgB,QAAQ,QAAQ;CACvD,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;CAClB,CAAC;CAED,MAAM,cAAc,iBAAiB;EACnC,MAAM,MAAM;EACZ;EACA,UAAU,MAAM;CAClB,CAAC;CAED,IAAI,QAAQ,QACV,oBAAoB,aAAa,EAAE,KAAK,CAAC;CAG3C,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-D0gJ_MS2.cjs

@@ -0,0 +1,105 @@
+const require_lifecycle = require("./lifecycle-DEJ4GgWV.cjs");
+const require_lease = require("./lease-Bq9wKwQa.cjs");
+//#region src/core/template.ts
+async function resolveAdminUrl(adminUrl) {
+	return adminUrl ?? (await require_lifecycle.ensureHostRunning()).adminUrl;
+}
+/**
+* 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 = require_lease.resolveWorktreeIdentity(options.root);
+	const mode = options.mode;
+	const lease = require_lease.readLease(identity.root, mode);
+	if (!lease) throw new Error(`no ${mode} lease; run acquire before markTemplate`);
+	const adminUrl = await resolveAdminUrl(options.adminUrl);
+	await require_lifecycle.setDatabaseIsTemplate({
+		adminUrl,
+		databaseName: lease.databaseName,
+		isTemplate: true
+	});
+	return {
+		databaseName: lease.databaseName,
+		adminUrl
+	};
+}
+/**
+* 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.
+*/
+async function cloneFromTemplate(options) {
+	const identity = require_lease.resolveWorktreeIdentity(options.root);
+	const mode = options.mode;
+	const lease = require_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 suffix = options.name ?? `${process.pid}_${Date.now().toString(36)}`;
+	const databaseName = require_lifecycle.buildCloneDatabaseName(lease.databaseName, suffix);
+	await require_lifecycle.cloneDatabaseFromTemplate({
+		adminUrl,
+		templateName: lease.databaseName,
+		databaseName,
+		roleName: lease.roleName
+	});
+	const databaseUrl = require_lifecycle.buildDatabaseUrl({
+		port: lease.port,
+		databaseName,
+		roleName: lease.roleName
+	});
+	if (options.setEnv) require_lifecycle.applyDatabaseUrlEnv(databaseUrl, { mode });
+	const roleName = lease.roleName;
+	return {
+		databaseUrl,
+		adminUrl,
+		databaseName,
+		roleName,
+		templateName: lease.databaseName,
+		port: lease.port,
+		dropClone: async () => {
+			await require_lifecycle.dropDatabase({
+				adminUrl,
+				databaseName,
+				roleName
+			});
+		}
+	};
+}
+/**
+* Resolve skip policy then clone. Host entry for worker adapters (same skip
+* semantics as `acquireIfNeeded`). Defaults `setEnv` on for skip and clone paths.
+*/
+async function cloneFromTemplateIfNeeded(options) {
+	const outcome = await require_lifecycle.runIfNeeded(options, () => cloneFromTemplate({
+		...options,
+		setEnv: options.setEnv !== false
+	}));
+	if (outcome.status === "skipped") return outcome;
+	return {
+		status: "cloned",
+		...outcome.value
+	};
+}
+//#endregion
+Object.defineProperty(exports, "cloneFromTemplate", {
+	enumerable: true,
+	get: function() {
+		return cloneFromTemplate;
+	}
+});
+Object.defineProperty(exports, "cloneFromTemplateIfNeeded", {
+	enumerable: true,
+	get: function() {
+		return cloneFromTemplateIfNeeded;
+	}
+});
+Object.defineProperty(exports, "markTemplate", {
+	enumerable: true,
+	get: function() {
+		return markTemplate;
+	}
+});
+
+//# sourceMappingURL=template-D0gJ_MS2.cjs.map

package/dist/template-D0gJ_MS2.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-D0gJ_MS2.cjs","names":["ensureHostRunning","resolveWorktreeIdentity","readLease","setDatabaseIsTemplate","buildCloneDatabaseName","cloneDatabaseFromTemplate","buildDatabaseUrl","dropDatabase","runIfNeeded"],"sources":["../src/core/template.ts"],"sourcesContent":["import { buildCloneDatabaseName, type DbMode } from \"./naming.ts\";\nimport { readLease } from \"./lease.ts\";\nimport { applyDatabaseUrlEnv, runIfNeeded, type ResolveAcquireSkipInput } from \"./policy.ts\";\nimport { resolveWorktreeIdentity } from \"./worktree.ts\";\nimport {\n  buildDatabaseUrl,\n  cloneDatabaseFromTemplate,\n  dropDatabase,\n  setDatabaseIsTemplate,\n} from \"../providers/autopg.ts\";\nimport { ensureHostRunning } from \"../providers/host.ts\";\n\nasync function resolveAdminUrl(adminUrl?: string): Promise<string> {\n  return adminUrl ?? (await ensureHostRunning()).adminUrl;\n}\n\nexport type MarkTemplateOptions = {\n  root?: string;\n  mode: DbMode;\n  /** Superuser URL from `acquire`; when omitted, discovers/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 identity = resolveWorktreeIdentity(options.root);\n  const mode = options.mode;\n  const lease = readLease(identity.root, mode);\n  if (!lease) {\n    throw new Error(`no ${mode} lease; run acquire before markTemplate`);\n  }\n  const adminUrl = await resolveAdminUrl(options.adminUrl);\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, discovers/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   * 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 rediscovered.\n */\nexport async function cloneFromTemplate(options: CloneFromTemplateOptions): Promise<CloneResult> {\n  const identity = resolveWorktreeIdentity(options.root);\n  const mode = options.mode;\n  const lease = readLease(identity.root, mode);\n  if (!lease) {\n    throw new Error(`no ${mode} lease; run acquire + markTemplate before cloneFromTemplate`);\n  }\n\n  const adminUrl = await resolveAdminUrl(options.adminUrl);\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  });\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 });\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":";;;AAYA,eAAe,gBAAgB,UAAoC;CACjE,OAAO,aAAa,MAAMA,kBAAAA,kBAAkB,EAAA,CAAG;AACjD;;;;;AAaA,eAAsB,aACpB,SACqD;CACrD,MAAM,WAAWC,cAAAA,wBAAwB,QAAQ,IAAI;CACrD,MAAM,OAAO,QAAQ;CACrB,MAAM,QAAQC,cAAAA,UAAU,SAAS,MAAM,IAAI;CAC3C,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,MAAM,KAAK,wCAAwC;CAErE,MAAM,WAAW,MAAM,gBAAgB,QAAQ,QAAQ;CACvD,MAAMC,kBAAAA,sBAAsB;EAC1B;EACA,cAAc,MAAM;EACpB,YAAY;CACd,CAAC;CACD,OAAO;EAAE,cAAc,MAAM;EAAc;CAAS;AACtD;;;;;;;AAuCA,eAAsB,kBAAkB,SAAyD;CAC/F,MAAM,WAAWF,cAAAA,wBAAwB,QAAQ,IAAI;CACrD,MAAM,OAAO,QAAQ;CACrB,MAAM,QAAQC,cAAAA,UAAU,SAAS,MAAM,IAAI;CAC3C,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,MAAM,KAAK,4DAA4D;CAGzF,MAAM,WAAW,MAAM,gBAAgB,QAAQ,QAAQ;CACvD,MAAM,SAAS,QAAQ,QAAQ,GAAG,QAAQ,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC,SAAS,EAAE;CACvE,MAAM,eAAeE,kBAAAA,uBAAuB,MAAM,cAAc,MAAM;CAEtE,MAAMC,kBAAAA,0BAA0B;EAC9B;EACA,cAAc,MAAM;EACpB;EACA,UAAU,MAAM;CAClB,CAAC;CAED,MAAM,cAAcC,kBAAAA,iBAAiB;EACnC,MAAM,MAAM;EACZ;EACA,UAAU,MAAM;CAClB,CAAC;CAED,IAAI,QAAQ,QACV,kBAAA,oBAAoB,aAAa,EAAE,KAAK,CAAC;CAG3C,MAAM,WAAW,MAAM;CAEvB,OAAO;EACL;EACA;EACA;EACA;EACA,cAAc,MAAM;EACpB,MAAM,MAAM;EACZ,WAAW,YAAY;GACrB,MAAMC,kBAAAA,aAAa;IAAE;IAAU;IAAc;GAAS,CAAC;EACzD;CACF;AACF;;;;;AAaA,eAAsB,0BACpB,SAC0C;CAC1C,MAAM,UAAU,MAAMC,kBAAAA,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-BkEs9LnY.cjs

@@ -0,0 +1,91 @@
+const require_lifecycle = require("./lifecycle-DEJ4GgWV.cjs");
+const require_template = require("./template-D0gJ_MS2.cjs");
+//#region src/adapters/template-mode.ts
+/**
+* Runner orchestration: acquire → migrate → markTemplate.
+* 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",
+		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;
+}
+let workerOnce;
+let workerOnceKey;
+function resolveWorkerName(options) {
+	return options.name ?? process.env.JEST_WORKER_ID ?? process.env.VITEST_POOL_ID ?? String(process.pid);
+}
+function workerOptionsKey(root, name) {
+	return `${root ?? ""}\0${name}`;
+}
+/**
+* Process-once per-worker clone (JEST_WORKER_ID / VITEST_POOL_ID / pid by default).
+* Uses `cloneFromTemplateIfNeeded` (same skip policy as `acquireIfNeeded`) with `setEnv: true`.
+* First call wins for `root`/`name`; conflicting later calls throw.
+*/
+function cloneWorkerDatabase(options = {}) {
+	const name = resolveWorkerName(options);
+	const key = workerOptionsKey(options.root, name);
+	if (workerOnce) {
+		if (workerOnceKey !== key) throw new Error(`cloneWorkerDatabase already started with different root/name (first: ${JSON.stringify(workerOnceKey)}, now: ${JSON.stringify(key)})`);
+		return workerOnce;
+	}
+	workerOnceKey = key;
+	workerOnce = (async () => {
+		await require_template.cloneFromTemplateIfNeeded({
+			root: options.root,
+			mode: "test",
+			name,
+			setEnv: true
+		});
+	})().catch((err) => {
+		workerOnce = void 0;
+		workerOnceKey = void 0;
+		throw err;
+	});
+	return workerOnce;
+}
+//#endregion
+Object.defineProperty(exports, "cloneWorkerDatabase", {
+	enumerable: true,
+	get: function() {
+		return cloneWorkerDatabase;
+	}
+});
+Object.defineProperty(exports, "setupTemplateMode", {
+	enumerable: true,
+	get: function() {
+		return setupTemplateMode;
+	}
+});
+
+//# sourceMappingURL=template-mode-BkEs9LnY.cjs.map

package/dist/template-mode-BkEs9LnY.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-mode-BkEs9LnY.cjs","names":["acquireIfNeeded","markTemplate","dispose","cloneFromTemplateIfNeeded"],"sources":["../src/adapters/template-mode.ts"],"sourcesContent":["import { dispose, acquireIfNeeded, type AcquireIfNeededResult } from \"../core/lifecycle.ts\";\nimport { cloneFromTemplateIfNeeded, markTemplate } from \"../core/template.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: acquire → migrate → markTemplate.\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    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\nlet workerOnce: Promise<void> | undefined;\nlet workerOnceKey: string | undefined;\n\nfunction resolveWorkerName(options: CloneWorkerDatabaseOptions): string {\n  return (\n    options.name ?? process.env.JEST_WORKER_ID ?? process.env.VITEST_POOL_ID ?? String(process.pid)\n  );\n}\n\nfunction workerOptionsKey(root: string | undefined, name: string): string {\n  return `${root ?? \"\"}\\0${name}`;\n}\n\n/**\n * Process-once per-worker clone (JEST_WORKER_ID / VITEST_POOL_ID / pid by default).\n * Uses `cloneFromTemplateIfNeeded` (same skip policy as `acquireIfNeeded`) with `setEnv: true`.\n * First call wins for `root`/`name`; conflicting later calls throw.\n */\nexport function cloneWorkerDatabase(options: CloneWorkerDatabaseOptions = {}): Promise<void> {\n  const name = resolveWorkerName(options);\n  const key = workerOptionsKey(options.root, name);\n  if (workerOnce) {\n    if (workerOnceKey !== key) {\n      throw new Error(\n        `cloneWorkerDatabase already started with different root/name ` +\n          `(first: ${JSON.stringify(workerOnceKey)}, now: ${JSON.stringify(key)})`,\n      );\n    }\n    return workerOnce;\n  }\n  workerOnceKey = key;\n  workerOnce = (async () => {\n    await cloneFromTemplateIfNeeded({\n      root: options.root,\n      mode: \"test\",\n      name,\n      setEnv: true,\n    });\n  })().catch((err) => {\n    workerOnce = undefined;\n    workerOnceKey = undefined;\n    throw err;\n  });\n  return workerOnce;\n}\n"],"mappings":";;;;;;;;;;AA0BA,eAAsB,kBACpB,SACgC;CAChC,MAAM,SAAS,MAAMA,kBAAAA,gBAAgB;EACnC,MAAM,QAAQ;EACd,MAAM;EACN,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;AAQA,IAAI;AACJ,IAAI;AAEJ,SAAS,kBAAkB,SAA6C;CACtE,OACE,QAAQ,QAAQ,QAAQ,IAAI,kBAAkB,QAAQ,IAAI,kBAAkB,OAAO,QAAQ,GAAG;AAElG;AAEA,SAAS,iBAAiB,MAA0B,MAAsB;CACxE,OAAO,GAAG,QAAQ,GAAG,IAAI;AAC3B;;;;;;AAOA,SAAgB,oBAAoB,UAAsC,CAAC,GAAkB;CAC3F,MAAM,OAAO,kBAAkB,OAAO;CACtC,MAAM,MAAM,iBAAiB,QAAQ,MAAM,IAAI;CAC/C,IAAI,YAAY;EACd,IAAI,kBAAkB,KACpB,MAAM,IAAI,MACR,wEACa,KAAK,UAAU,aAAa,EAAE,SAAS,KAAK,UAAU,GAAG,EAAE,EAC1E;EAEF,OAAO;CACT;CACA,gBAAgB;CAChB,cAAc,YAAY;EACxB,MAAMC,iBAAAA,0BAA0B;GAC9B,MAAM,QAAQ;GACd,MAAM;GACN;GACA,QAAQ;EACV,CAAC;CACH,EAAA,CAAG,CAAC,CAAC,OAAO,QAAQ;EAClB,aAAa,KAAA;EACb,gBAAgB,KAAA;EAChB,MAAM;CACR,CAAC;CACD,OAAO;AACT"}

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

@@ -0,0 +1,28 @@
+//#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;
+};
+/**
+ * Process-once per-worker clone (JEST_WORKER_ID / VITEST_POOL_ID / pid by default).
+ * Uses `cloneFromTemplateIfNeeded` (same skip policy as `acquireIfNeeded`) with `setEnv: true`.
+ * First call wins for `root`/`name`; conflicting later calls throw.
+ */
+declare function cloneWorkerDatabase(options?: CloneWorkerDatabaseOptions): Promise<void>;
+//#endregion
+export { cloneWorkerDatabase as i, TemplateMigrateContext as n, TemplateMigrateFn as r, SetupTemplateModeOptions as t };
+//# sourceMappingURL=template-mode-CcxV_Iju.d.cts.map

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

@@ -0,0 +1,28 @@
+//#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;
+};
+/**
+ * Process-once per-worker clone (JEST_WORKER_ID / VITEST_POOL_ID / pid by default).
+ * Uses `cloneFromTemplateIfNeeded` (same skip policy as `acquireIfNeeded`) with `setEnv: true`.
+ * First call wins for `root`/`name`; conflicting later calls throw.
+ */
+declare function cloneWorkerDatabase(options?: CloneWorkerDatabaseOptions): Promise<void>;
+//#endregion
+export { cloneWorkerDatabase as i, TemplateMigrateContext as n, TemplateMigrateFn as r, SetupTemplateModeOptions as t };
+//# sourceMappingURL=template-mode-CcxV_Iju.d.mts.map

package/dist/template-mode-IjlFOG4O.mjs

@@ -0,0 +1,80 @@
+import { n as acquireIfNeeded, r as dispose } from "./lifecycle-BOo6xBjD.mjs";
+import { n as cloneFromTemplateIfNeeded, r as markTemplate } from "./template-CGw3C1Ob.mjs";
+//#region src/adapters/template-mode.ts
+/**
+* Runner orchestration: acquire → migrate → markTemplate.
+* 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",
+		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;
+}
+let workerOnce;
+let workerOnceKey;
+function resolveWorkerName(options) {
+	return options.name ?? process.env.JEST_WORKER_ID ?? process.env.VITEST_POOL_ID ?? String(process.pid);
+}
+function workerOptionsKey(root, name) {
+	return `${root ?? ""}\0${name}`;
+}
+/**
+* Process-once per-worker clone (JEST_WORKER_ID / VITEST_POOL_ID / pid by default).
+* Uses `cloneFromTemplateIfNeeded` (same skip policy as `acquireIfNeeded`) with `setEnv: true`.
+* First call wins for `root`/`name`; conflicting later calls throw.
+*/
+function cloneWorkerDatabase(options = {}) {
+	const name = resolveWorkerName(options);
+	const key = workerOptionsKey(options.root, name);
+	if (workerOnce) {
+		if (workerOnceKey !== key) throw new Error(`cloneWorkerDatabase already started with different root/name (first: ${JSON.stringify(workerOnceKey)}, now: ${JSON.stringify(key)})`);
+		return workerOnce;
+	}
+	workerOnceKey = key;
+	workerOnce = (async () => {
+		await cloneFromTemplateIfNeeded({
+			root: options.root,
+			mode: "test",
+			name,
+			setEnv: true
+		});
+	})().catch((err) => {
+		workerOnce = void 0;
+		workerOnceKey = void 0;
+		throw err;
+	});
+	return workerOnce;
+}
+//#endregion
+export { setupTemplateMode as n, cloneWorkerDatabase as t };
+
+//# sourceMappingURL=template-mode-IjlFOG4O.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template-mode-IjlFOG4O.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\";\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: acquire → migrate → markTemplate.\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    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\nlet workerOnce: Promise<void> | undefined;\nlet workerOnceKey: string | undefined;\n\nfunction resolveWorkerName(options: CloneWorkerDatabaseOptions): string {\n  return (\n    options.name ?? process.env.JEST_WORKER_ID ?? process.env.VITEST_POOL_ID ?? String(process.pid)\n  );\n}\n\nfunction workerOptionsKey(root: string | undefined, name: string): string {\n  return `${root ?? \"\"}\\0${name}`;\n}\n\n/**\n * Process-once per-worker clone (JEST_WORKER_ID / VITEST_POOL_ID / pid by default).\n * Uses `cloneFromTemplateIfNeeded` (same skip policy as `acquireIfNeeded`) with `setEnv: true`.\n * First call wins for `root`/`name`; conflicting later calls throw.\n */\nexport function cloneWorkerDatabase(options: CloneWorkerDatabaseOptions = {}): Promise<void> {\n  const name = resolveWorkerName(options);\n  const key = workerOptionsKey(options.root, name);\n  if (workerOnce) {\n    if (workerOnceKey !== key) {\n      throw new Error(\n        `cloneWorkerDatabase already started with different root/name ` +\n          `(first: ${JSON.stringify(workerOnceKey)}, now: ${JSON.stringify(key)})`,\n      );\n    }\n    return workerOnce;\n  }\n  workerOnceKey = key;\n  workerOnce = (async () => {\n    await cloneFromTemplateIfNeeded({\n      root: options.root,\n      mode: \"test\",\n      name,\n      setEnv: true,\n    });\n  })().catch((err) => {\n    workerOnce = undefined;\n    workerOnceKey = undefined;\n    throw err;\n  });\n  return workerOnce;\n}\n"],"mappings":";;;;;;;;;;AA0BA,eAAsB,kBACpB,SACgC;CAChC,MAAM,SAAS,MAAM,gBAAgB;EACnC,MAAM,QAAQ;EACd,MAAM;EACN,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;AAQA,IAAI;AACJ,IAAI;AAEJ,SAAS,kBAAkB,SAA6C;CACtE,OACE,QAAQ,QAAQ,QAAQ,IAAI,kBAAkB,QAAQ,IAAI,kBAAkB,OAAO,QAAQ,GAAG;AAElG;AAEA,SAAS,iBAAiB,MAA0B,MAAsB;CACxE,OAAO,GAAG,QAAQ,GAAG,IAAI;AAC3B;;;;;;AAOA,SAAgB,oBAAoB,UAAsC,CAAC,GAAkB;CAC3F,MAAM,OAAO,kBAAkB,OAAO;CACtC,MAAM,MAAM,iBAAiB,QAAQ,MAAM,IAAI;CAC/C,IAAI,YAAY;EACd,IAAI,kBAAkB,KACpB,MAAM,IAAI,MACR,wEACa,KAAK,UAAU,aAAa,EAAE,SAAS,KAAK,UAAU,GAAG,EAAE,EAC1E;EAEF,OAAO;CACT;CACA,gBAAgB;CAChB,cAAc,YAAY;EACxB,MAAM,0BAA0B;GAC9B,MAAM,QAAQ;GACd,MAAM;GACN;GACA,QAAQ;EACV,CAAC;CACH,EAAA,CAAG,CAAC,CAAC,OAAO,QAAQ;EAClB,aAAa,KAAA;EACb,gBAAgB,KAAA;EAChB,MAAM;CACR,CAAC;CACD,OAAO;AACT"}

package/dist/test-env.cjs

@@ -0,0 +1,16 @@
+//#region src/adapters/test-env.ts
+/**
+* Test-runner `setupFiles` entry: inject `DATABASE_URL` from `.cedarpg/test.env`.
+*
+* Required for Jest (globalSetup is a separate process). Optional for Vitest
+* when the pool does not inherit env from the main process.
+*
+* ```js
+* setupFiles: [require.resolve('@cedarjs/pg/test-env')]
+* // or: setupFiles: ['@cedarjs/pg/test-env']
+* ```
+*/
+require("./load-test-env-CkdUjTpV.cjs").loadTestEnv();
+//#endregion
+
+//# sourceMappingURL=test-env.cjs.map