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

package/dist/cli.mjs

@@ -1,24 +1,32 @@
 #!/usr/bin/env node
-import { S as readLease, a as urlFromLease, g as resolveWorktreeIdentity, i as gc, n as ensure, t as dispose } from "./lifecycle-CT_8AWPv.mjs";
-import { t as CLI_NAME } from "./constants-BY97wXjA.mjs";
+import { a as urlFromLease, i as gc, r as dispose, t as acquire } from "./lifecycle-BOo6xBjD.mjs";
+import { t as CLI_NAME } from "./constants-NLR0U4NR.mjs";
+import { f as resolveWorktreeIdentity, l as readLease } from "./lease-BSBBpaR4.mjs";
+import { spawn } from "node:child_process";
 //#region src/cli.ts
 function printHelp() {
 	process.stdout.write(`${CLI_NAME}: worktree-isolated local Postgres (via autopg)
 
 Usage:
-  ${CLI_NAME} ensure --mode=dev|test [--root <path>] [--json] [--print-env]
+  ${CLI_NAME} acquire --mode=dev|test [--root <path>] [--force] [--json] [--print-env]
+  ${CLI_NAME} run --mode=dev|test [--root <path>] [--force] -- <cmd…>
   ${CLI_NAME} dispose [--mode=dev|test] [--root <path>]
   ${CLI_NAME} gc [--json]
   ${CLI_NAME} print-url [--mode=dev|test] [--root <path>]
   ${CLI_NAME} --help
 
 Modes:
-  dev   Keep DB across restarts (default for ensure if omitted: dev)
+  dev   Keep DB across restarts (default when --mode omitted)
   test  Drop DB on dispose / test teardown
 
+run:
+  Acquire, set DATABASE_URL (+ TEST_DATABASE_URL in test) on the child, exec <cmd…>.
+  --force sets CEDAR_PG_FORCE (escape hatch); child env overwrite is always on.
+
 Env:
-  AUTOPG_BIN     Path to autopg binary
-  CEDAR_PG=0     Disable adapters that auto-ensure
+  AUTOPG_BIN       Path to autopg binary
+  CEDAR_PG=0       Disable adapters that auto-acquire
+  CEDAR_PG_FORCE=1 Ignore external-URL escape hatch (same as --force)
 `);
 }
 function parseMode(value) {
@@ -29,19 +37,40 @@ function parseArgs(argv) {
 	const out = {};
 	const rest = [...argv];
 	out.cmd = rest.shift();
-	for (let i = 0; i < rest.length; i++) {
-		const a = rest[i];
+	const dash = rest.indexOf("--");
+	let flagArgs = rest;
+	if (dash >= 0) {
+		flagArgs = rest.slice(0, dash);
+		out.child = rest.slice(dash + 1);
+	}
+	for (let i = 0; i < flagArgs.length; i++) {
+		const a = flagArgs[i];
 		if (a === "--help" || a === "-h") out.help = true;
 		else if (a === "--json") out.json = true;
 		else if (a === "--print-env") out.printEnv = true;
+		else if (a === "--force") out.force = true;
 		else if (a.startsWith("--mode=")) out.mode = parseMode(a.slice(7));
-		else if (a === "--mode") out.mode = parseMode(rest[++i]);
+		else if (a === "--mode") out.mode = parseMode(flagArgs[++i]);
 		else if (a.startsWith("--root=")) out.root = a.slice(7);
-		else if (a === "--root") out.root = rest[++i];
+		else if (a === "--root") out.root = flagArgs[++i];
 		else throw new Error(`unknown argument: ${a}`);
 	}
 	return out;
 }
+function runChild(command, env) {
+	const [file, ...args] = command;
+	if (!file) throw new Error(`run requires a command after -- (e.g. ${CLI_NAME} run --mode=dev -- yarn dev)`);
+	return new Promise((resolve, reject) => {
+		const child = spawn(file, args, {
+			stdio: "inherit",
+			env
+		});
+		child.on("error", reject);
+		child.on("exit", (code, signal) => {
+			resolve(signal ? 1 : code ?? 1);
+		});
+	});
+}
 async function main() {
 	const argv = process.argv.slice(2);
 	if (argv.length === 0 || argv[0] === "help" || argv[0] === "--help" || argv[0] === "-h") {
@@ -54,9 +83,10 @@ async function main() {
 		return 0;
 	}
 	try {
-		if (args.cmd === "ensure") {
+		if (args.cmd === "acquire") {
+			if (args.force) process.env.CEDAR_PG_FORCE = "1";
 			const mode = args.mode ?? "dev";
-			const result = await ensure({
+			const result = await acquire({
 				root: args.root,
 				mode,
 				setEnv: true
@@ -67,6 +97,7 @@ async function main() {
 			}
 			if (args.json) process.stdout.write(`${JSON.stringify({
 				databaseUrl: result.databaseUrl,
+				adminUrl: result.adminUrl,
 				databaseName: result.databaseName,
 				roleName: result.roleName,
 				repoSlug: result.repoSlug,
@@ -82,6 +113,21 @@ async function main() {
 			}
 			return 0;
 		}
+		if (args.cmd === "run") {
+			if (args.force) process.env.CEDAR_PG_FORCE = "1";
+			const mode = args.mode ?? "dev";
+			const result = await acquire({
+				root: args.root,
+				mode,
+				setEnv: true
+			});
+			const childEnv = {
+				...process.env,
+				DATABASE_URL: result.databaseUrl
+			};
+			if (mode === "test") childEnv.TEST_DATABASE_URL = result.databaseUrl;
+			return await runChild(args.child ?? [], childEnv);
+		}
 		if (args.cmd === "dispose") {
 			const mode = args.mode ?? "test";
 			const result = await dispose({
@@ -112,7 +158,7 @@ async function main() {
 			const mode = args.mode ?? "dev";
 			const lease = readLease(resolveWorktreeIdentity(args.root).root, mode);
 			if (!lease) {
-				process.stderr.write(`${CLI_NAME}: no ${mode} lease; run \`${CLI_NAME} ensure --mode=${mode}\` first\n`);
+				process.stderr.write(`${CLI_NAME}: no ${mode} lease; run \`${CLI_NAME} acquire --mode=${mode}\` first\n`);
 				return 2;
 			}
 			process.stdout.write(`${urlFromLease(lease)}\n`);

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { CLI_NAME } from \"./core/constants.ts\";\nimport { ensure, dispose, gc, urlFromLease } from \"./core/lifecycle.ts\";\nimport { resolveWorktreeIdentity } from \"./core/worktree.ts\";\nimport { readLease } from \"./core/lease.ts\";\nimport type { DbMode } from \"./core/naming.ts\";\n\nfunction printHelp(): void {\n  process.stdout.write(`${CLI_NAME}: worktree-isolated local Postgres (via autopg)\n\nUsage:\n  ${CLI_NAME} ensure --mode=dev|test [--root <path>] [--json] [--print-env]\n  ${CLI_NAME} dispose [--mode=dev|test] [--root <path>]\n  ${CLI_NAME} gc [--json]\n  ${CLI_NAME} print-url [--mode=dev|test] [--root <path>]\n  ${CLI_NAME} --help\n\nModes:\n  dev   Keep DB across restarts (default for ensure if omitted: dev)\n  test  Drop DB on dispose / test teardown\n\nEnv:\n  AUTOPG_BIN     Path to autopg binary\n  CEDAR_PG=0     Disable adapters that auto-ensure\n`);\n}\n\nfunction parseMode(value: string | undefined): DbMode {\n  if (value === \"dev\" || value === \"test\") return value;\n  throw new Error(\"--mode must be dev or test\");\n}\n\nfunction parseArgs(argv: string[]) {\n  const out: {\n    cmd?: string;\n    mode?: DbMode;\n    root?: string;\n    json?: boolean;\n    printEnv?: boolean;\n    help?: boolean;\n  } = {};\n  const rest = [...argv];\n  out.cmd = rest.shift();\n  for (let i = 0; i < rest.length; i++) {\n    const a = rest[i]!;\n    if (a === \"--help\" || a === \"-h\") out.help = true;\n    else if (a === \"--json\") out.json = true;\n    else if (a === \"--print-env\") out.printEnv = true;\n    else if (a.startsWith(\"--mode=\")) out.mode = parseMode(a.slice(7));\n    else if (a === \"--mode\") out.mode = parseMode(rest[++i]);\n    else if (a.startsWith(\"--root=\")) out.root = a.slice(7);\n    else if (a === \"--root\") out.root = rest[++i];\n    else throw new Error(`unknown argument: ${a}`);\n  }\n  return out;\n}\n\nasync function main(): Promise<number> {\n  const argv = process.argv.slice(2);\n  if (argv.length === 0 || argv[0] === \"help\" || argv[0] === \"--help\" || argv[0] === \"-h\") {\n    printHelp();\n    return 0;\n  }\n  const args = parseArgs(argv);\n  if (args.help) {\n    printHelp();\n    return 0;\n  }\n\n  try {\n    if (args.cmd === \"ensure\") {\n      const mode = args.mode ?? \"dev\";\n      const result = await ensure({\n        root: args.root,\n        mode,\n        setEnv: true,\n      });\n      if (args.printEnv) {\n        process.stdout.write(`DATABASE_URL=${result.databaseUrl}\\n`);\n        if (mode === \"test\") {\n          process.stdout.write(`TEST_DATABASE_URL=${result.databaseUrl}\\n`);\n        }\n      }\n      if (args.json) {\n        process.stdout.write(\n          `${JSON.stringify(\n            {\n              databaseUrl: result.databaseUrl,\n              databaseName: result.databaseName,\n              roleName: result.roleName,\n              repoSlug: result.repoSlug,\n              worktreeSlug: result.worktreeSlug,\n              pathHash: result.pathHash,\n              mode: result.mode,\n              port: result.port,\n              root: result.root,\n            },\n            null,\n            2,\n          )}\\n`,\n        );\n      } else if (!args.printEnv) {\n        process.stdout.write(\n          `${CLI_NAME}: ${result.databaseName} (${result.repoSlug}/${result.worktreeSlug} ${result.mode})\\n`,\n        );\n        process.stdout.write(`${result.databaseUrl}\\n`);\n      }\n      return 0;\n    }\n\n    if (args.cmd === \"dispose\") {\n      const mode = args.mode ?? \"test\";\n      const result = await dispose({ root: args.root, mode });\n      if (result.dropped) {\n        process.stdout.write(`${CLI_NAME}: disposed ${mode} (${result.databaseName})\\n`);\n        return 0;\n      }\n      if (result.reason === \"no-lease\") {\n        process.stdout.write(`${CLI_NAME}: nothing to dispose for ${mode} (no lease)\\n`);\n        return 0;\n      }\n      process.stderr.write(\n        `${CLI_NAME}: could not dispose ${mode}: autopg host unavailable (lease kept for retry)\\n`,\n      );\n      return 1;\n    }\n\n    if (args.cmd === \"gc\") {\n      const result = await gc();\n      if (args.json) {\n        process.stdout.write(`${JSON.stringify(result)}\\n`);\n      } else {\n        process.stdout.write(`${CLI_NAME} gc: dropped ${result.dropped.length} database(s)\\n`);\n        for (const name of result.dropped) process.stdout.write(`  ${name}\\n`);\n      }\n      return 0;\n    }\n\n    if (args.cmd === \"print-url\") {\n      const mode = args.mode ?? \"dev\";\n      const identity = resolveWorktreeIdentity(args.root);\n      const lease = readLease(identity.root, mode);\n      if (!lease) {\n        process.stderr.write(\n          `${CLI_NAME}: no ${mode} lease; run \\`${CLI_NAME} ensure --mode=${mode}\\` first\\n`,\n        );\n        return 2;\n      }\n      process.stdout.write(`${urlFromLease(lease)}\\n`);\n      return 0;\n    }\n\n    process.stderr.write(`${CLI_NAME}: unknown command ${args.cmd}\\n`);\n    printHelp();\n    return 64;\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    process.stderr.write(`${CLI_NAME}: ${message}\\n`);\n    return 1;\n  }\n}\n\nmain()\n  .then((code) => {\n    process.exit(code);\n  })\n  .catch((err: unknown) => {\n    const message = err instanceof Error ? err.message : String(err);\n    process.stderr.write(`${CLI_NAME}: ${message}\\n`);\n    process.exit(1);\n  });\n"],"mappings":"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"}
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { spawn } from \"node:child_process\";\nimport { CLI_NAME } from \"./core/constants.ts\";\nimport { acquire, dispose, gc, urlFromLease } from \"./core/lifecycle.ts\";\nimport { resolveWorktreeIdentity } from \"./core/worktree.ts\";\nimport { readLease } from \"./core/lease.ts\";\nimport type { DbMode } from \"./core/naming.ts\";\n\nfunction printHelp(): void {\n  process.stdout.write(`${CLI_NAME}: worktree-isolated local Postgres (via autopg)\n\nUsage:\n  ${CLI_NAME} acquire --mode=dev|test [--root <path>] [--force] [--json] [--print-env]\n  ${CLI_NAME} run --mode=dev|test [--root <path>] [--force] -- <cmd…>\n  ${CLI_NAME} dispose [--mode=dev|test] [--root <path>]\n  ${CLI_NAME} gc [--json]\n  ${CLI_NAME} print-url [--mode=dev|test] [--root <path>]\n  ${CLI_NAME} --help\n\nModes:\n  dev   Keep DB across restarts (default when --mode omitted)\n  test  Drop DB on dispose / test teardown\n\nrun:\n  Acquire, set DATABASE_URL (+ TEST_DATABASE_URL in test) on the child, exec <cmd…>.\n  --force sets CEDAR_PG_FORCE (escape hatch); child env overwrite is always on.\n\nEnv:\n  AUTOPG_BIN       Path to autopg binary\n  CEDAR_PG=0       Disable adapters that auto-acquire\n  CEDAR_PG_FORCE=1 Ignore external-URL escape hatch (same as --force)\n`);\n}\n\nfunction parseMode(value: string | undefined): DbMode {\n  if (value === \"dev\" || value === \"test\") return value;\n  throw new Error(\"--mode must be dev or test\");\n}\n\ntype ParsedArgs = {\n  cmd?: string;\n  mode?: DbMode;\n  root?: string;\n  json?: boolean;\n  printEnv?: boolean;\n  force?: boolean;\n  help?: boolean;\n  child?: string[];\n};\n\nfunction parseArgs(argv: string[]): ParsedArgs {\n  const out: ParsedArgs = {};\n  const rest = [...argv];\n  out.cmd = rest.shift();\n\n  const dash = rest.indexOf(\"--\");\n  let flagArgs = rest;\n  if (dash >= 0) {\n    flagArgs = rest.slice(0, dash);\n    out.child = rest.slice(dash + 1);\n  }\n\n  for (let i = 0; i < flagArgs.length; i++) {\n    const a = flagArgs[i]!;\n    if (a === \"--help\" || a === \"-h\") out.help = true;\n    else if (a === \"--json\") out.json = true;\n    else if (a === \"--print-env\") out.printEnv = true;\n    else if (a === \"--force\") out.force = true;\n    else if (a.startsWith(\"--mode=\")) out.mode = parseMode(a.slice(7));\n    else if (a === \"--mode\") out.mode = parseMode(flagArgs[++i]);\n    else if (a.startsWith(\"--root=\")) out.root = a.slice(7);\n    else if (a === \"--root\") out.root = flagArgs[++i];\n    else throw new Error(`unknown argument: ${a}`);\n  }\n  return out;\n}\n\nfunction runChild(command: string[], env: NodeJS.ProcessEnv): Promise<number> {\n  const [file, ...args] = command;\n  if (!file) {\n    throw new Error(\n      `run requires a command after -- (e.g. ${CLI_NAME} run --mode=dev -- yarn dev)`,\n    );\n  }\n  return new Promise((resolve, reject) => {\n    const child = spawn(file, args, { stdio: \"inherit\", env });\n    child.on(\"error\", reject);\n    child.on(\"exit\", (code, signal) => {\n      resolve(signal ? 1 : (code ?? 1));\n    });\n  });\n}\n\nasync function main(): Promise<number> {\n  const argv = process.argv.slice(2);\n  if (argv.length === 0 || argv[0] === \"help\" || argv[0] === \"--help\" || argv[0] === \"-h\") {\n    printHelp();\n    return 0;\n  }\n  const args = parseArgs(argv);\n  if (args.help) {\n    printHelp();\n    return 0;\n  }\n\n  try {\n    if (args.cmd === \"acquire\") {\n      if (args.force) process.env.CEDAR_PG_FORCE = \"1\";\n      const mode = args.mode ?? \"dev\";\n      const result = await acquire({\n        root: args.root,\n        mode,\n        setEnv: true,\n      });\n      if (args.printEnv) {\n        process.stdout.write(`DATABASE_URL=${result.databaseUrl}\\n`);\n        if (mode === \"test\") {\n          process.stdout.write(`TEST_DATABASE_URL=${result.databaseUrl}\\n`);\n        }\n      }\n      if (args.json) {\n        process.stdout.write(\n          `${JSON.stringify(\n            {\n              databaseUrl: result.databaseUrl,\n              adminUrl: result.adminUrl,\n              databaseName: result.databaseName,\n              roleName: result.roleName,\n              repoSlug: result.repoSlug,\n              worktreeSlug: result.worktreeSlug,\n              pathHash: result.pathHash,\n              mode: result.mode,\n              port: result.port,\n              root: result.root,\n            },\n            null,\n            2,\n          )}\\n`,\n        );\n      } else if (!args.printEnv) {\n        process.stdout.write(\n          `${CLI_NAME}: ${result.databaseName} (${result.repoSlug}/${result.worktreeSlug} ${result.mode})\\n`,\n        );\n        process.stdout.write(`${result.databaseUrl}\\n`);\n      }\n      return 0;\n    }\n\n    if (args.cmd === \"run\") {\n      if (args.force) process.env.CEDAR_PG_FORCE = \"1\";\n      const mode = args.mode ?? \"dev\";\n      const result = await acquire({\n        root: args.root,\n        mode,\n        setEnv: true,\n      });\n      const childEnv: NodeJS.ProcessEnv = {\n        ...process.env,\n        DATABASE_URL: result.databaseUrl,\n      };\n      if (mode === \"test\") childEnv.TEST_DATABASE_URL = result.databaseUrl;\n      return await runChild(args.child ?? [], childEnv);\n    }\n\n    if (args.cmd === \"dispose\") {\n      const mode = args.mode ?? \"test\";\n      const result = await dispose({ root: args.root, mode });\n      if (result.dropped) {\n        process.stdout.write(`${CLI_NAME}: disposed ${mode} (${result.databaseName})\\n`);\n        return 0;\n      }\n      if (result.reason === \"no-lease\") {\n        process.stdout.write(`${CLI_NAME}: nothing to dispose for ${mode} (no lease)\\n`);\n        return 0;\n      }\n      process.stderr.write(\n        `${CLI_NAME}: could not dispose ${mode}: autopg host unavailable (lease kept for retry)\\n`,\n      );\n      return 1;\n    }\n\n    if (args.cmd === \"gc\") {\n      const result = await gc();\n      if (args.json) {\n        process.stdout.write(`${JSON.stringify(result)}\\n`);\n      } else {\n        process.stdout.write(`${CLI_NAME} gc: dropped ${result.dropped.length} database(s)\\n`);\n        for (const name of result.dropped) process.stdout.write(`  ${name}\\n`);\n      }\n      return 0;\n    }\n\n    if (args.cmd === \"print-url\") {\n      const mode = args.mode ?? \"dev\";\n      const identity = resolveWorktreeIdentity(args.root);\n      const lease = readLease(identity.root, mode);\n      if (!lease) {\n        process.stderr.write(\n          `${CLI_NAME}: no ${mode} lease; run \\`${CLI_NAME} acquire --mode=${mode}\\` first\\n`,\n        );\n        return 2;\n      }\n      process.stdout.write(`${urlFromLease(lease)}\\n`);\n      return 0;\n    }\n\n    process.stderr.write(`${CLI_NAME}: unknown command ${args.cmd}\\n`);\n    printHelp();\n    return 64;\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    process.stderr.write(`${CLI_NAME}: ${message}\\n`);\n    return 1;\n  }\n}\n\nmain()\n  .then((code) => {\n    process.exit(code);\n  })\n  .catch((err: unknown) => {\n    const message = err instanceof Error ? err.message : String(err);\n    process.stderr.write(`${CLI_NAME}: ${message}\\n`);\n    process.exit(1);\n  });\n"],"mappings":"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"}

package/dist/{constants-CNZn5Xro.cjs → constants-Ct8myrEn.cjs}

@@ -14,7 +14,7 @@ const CLI_NAME = "cedarpg";
 */
 const STATE_DIRNAME = ".cedarpg";
 /**
-* Password scheme v1 salt prefix: sha256(`${PASSWORD_SALT_PREFIX}\0` + databaseName).
+* Password scheme v2 salt prefix: sha256(`${PASSWORD_SALT_PREFIX}\0` + roleName).
 * Opaque; independent of STATE_DIRNAME / CLI_NAME. Bump ROLE_PASSWORD_SCHEME to change.
 */
 const PASSWORD_SALT_PREFIX = "cedar-pg";
@@ -38,4 +38,4 @@ Object.defineProperty(exports, "STATE_DIRNAME", {
 	}
 });
 
-//# sourceMappingURL=constants-CNZn5Xro.cjs.map
+//# sourceMappingURL=constants-Ct8myrEn.cjs.map

package/dist/{constants-BY97wXjA.mjs.map → constants-Ct8myrEn.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"constants-BY97wXjA.mjs","names":[],"sources":["../src/core/constants.ts"],"sourcesContent":["/**\n * Product identity vs frozen crypto.\n *\n * State dirs follow the CLI name (`.cedarpg`): product-owned, not nested under\n * autopg's `~/.autopg/` (host owns that) and not a generic `.pg` (collision-prone).\n * Password salt is an opaque crypto constant; bump ROLE_PASSWORD_SCHEME to change it.\n */\n\n/** User-facing CLI binary (`package.json` bin) and log prefix */\nexport const CLI_NAME = \"cedarpg\";\n\n/**\n * Worktree-local state dir and home-registry parent (`~/.cedarpg/registry`).\n * Frozen for lease/gc discovery after first alpha consumers appear.\n */\nexport const STATE_DIRNAME = \".cedarpg\";\n\n/**\n * Password scheme v1 salt prefix: sha256(`${PASSWORD_SALT_PREFIX}\\0` + databaseName).\n * Opaque; independent of STATE_DIRNAME / CLI_NAME. Bump ROLE_PASSWORD_SCHEME to change.\n */\nexport const PASSWORD_SALT_PREFIX = \"cedar-pg\";\n"],"mappings":";;;;;;;;;AASA,MAAa,WAAW;;;;;AAMxB,MAAa,gBAAgB;;;;;AAM7B,MAAa,uBAAuB"}
+{"version":3,"file":"constants-Ct8myrEn.cjs","names":[],"sources":["../src/core/constants.ts"],"sourcesContent":["/**\n * Product identity vs frozen crypto.\n *\n * State dirs follow the CLI name (`.cedarpg`): product-owned, not nested under\n * autopg's `~/.autopg/` (host owns that) and not a generic `.pg` (collision-prone).\n * Password salt is an opaque crypto constant; bump ROLE_PASSWORD_SCHEME to change it.\n */\n\n/** User-facing CLI binary (`package.json` bin) and log prefix */\nexport const CLI_NAME = \"cedarpg\";\n\n/**\n * Worktree-local state dir and home-registry parent (`~/.cedarpg/registry`).\n * Frozen for lease/gc discovery after first alpha consumers appear.\n */\nexport const STATE_DIRNAME = \".cedarpg\";\n\n/**\n * Password scheme v2 salt prefix: sha256(`${PASSWORD_SALT_PREFIX}\\0` + roleName).\n * Opaque; independent of STATE_DIRNAME / CLI_NAME. Bump ROLE_PASSWORD_SCHEME to change.\n */\nexport const PASSWORD_SALT_PREFIX = \"cedar-pg\";\n"],"mappings":";;;;;;;;;AASA,MAAa,WAAW;;;;;AAMxB,MAAa,gBAAgB;;;;;AAM7B,MAAa,uBAAuB"}

package/dist/{constants-BY97wXjA.mjs → constants-NLR0U4NR.mjs}

@@ -14,11 +14,11 @@ const CLI_NAME = "cedarpg";
 */
 const STATE_DIRNAME = ".cedarpg";
 /**
-* Password scheme v1 salt prefix: sha256(`${PASSWORD_SALT_PREFIX}\0` + databaseName).
+* Password scheme v2 salt prefix: sha256(`${PASSWORD_SALT_PREFIX}\0` + roleName).
 * Opaque; independent of STATE_DIRNAME / CLI_NAME. Bump ROLE_PASSWORD_SCHEME to change.
 */
 const PASSWORD_SALT_PREFIX = "cedar-pg";
 //#endregion
 export { PASSWORD_SALT_PREFIX as n, STATE_DIRNAME as r, CLI_NAME as t };
 
-//# sourceMappingURL=constants-BY97wXjA.mjs.map
+//# sourceMappingURL=constants-NLR0U4NR.mjs.map

package/dist/{constants-CNZn5Xro.cjs.map → constants-NLR0U4NR.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"constants-CNZn5Xro.cjs","names":[],"sources":["../src/core/constants.ts"],"sourcesContent":["/**\n * Product identity vs frozen crypto.\n *\n * State dirs follow the CLI name (`.cedarpg`): product-owned, not nested under\n * autopg's `~/.autopg/` (host owns that) and not a generic `.pg` (collision-prone).\n * Password salt is an opaque crypto constant; bump ROLE_PASSWORD_SCHEME to change it.\n */\n\n/** User-facing CLI binary (`package.json` bin) and log prefix */\nexport const CLI_NAME = \"cedarpg\";\n\n/**\n * Worktree-local state dir and home-registry parent (`~/.cedarpg/registry`).\n * Frozen for lease/gc discovery after first alpha consumers appear.\n */\nexport const STATE_DIRNAME = \".cedarpg\";\n\n/**\n * Password scheme v1 salt prefix: sha256(`${PASSWORD_SALT_PREFIX}\\0` + databaseName).\n * Opaque; independent of STATE_DIRNAME / CLI_NAME. Bump ROLE_PASSWORD_SCHEME to change.\n */\nexport const PASSWORD_SALT_PREFIX = \"cedar-pg\";\n"],"mappings":";;;;;;;;;AASA,MAAa,WAAW;;;;;AAMxB,MAAa,gBAAgB;;;;;AAM7B,MAAa,uBAAuB"}
+{"version":3,"file":"constants-NLR0U4NR.mjs","names":[],"sources":["../src/core/constants.ts"],"sourcesContent":["/**\n * Product identity vs frozen crypto.\n *\n * State dirs follow the CLI name (`.cedarpg`): product-owned, not nested under\n * autopg's `~/.autopg/` (host owns that) and not a generic `.pg` (collision-prone).\n * Password salt is an opaque crypto constant; bump ROLE_PASSWORD_SCHEME to change it.\n */\n\n/** User-facing CLI binary (`package.json` bin) and log prefix */\nexport const CLI_NAME = \"cedarpg\";\n\n/**\n * Worktree-local state dir and home-registry parent (`~/.cedarpg/registry`).\n * Frozen for lease/gc discovery after first alpha consumers appear.\n */\nexport const STATE_DIRNAME = \".cedarpg\";\n\n/**\n * Password scheme v2 salt prefix: sha256(`${PASSWORD_SALT_PREFIX}\\0` + roleName).\n * Opaque; independent of STATE_DIRNAME / CLI_NAME. Bump ROLE_PASSWORD_SCHEME to change.\n */\nexport const PASSWORD_SALT_PREFIX = \"cedar-pg\";\n"],"mappings":";;;;;;;;;AASA,MAAa,WAAW;;;;;AAMxB,MAAa,gBAAgB;;;;;AAM7B,MAAa,uBAAuB"}

package/dist/dev-env.cjs

@@ -0,0 +1,12 @@
+//#region src/adapters/dev-env.ts
+/**
+* `setupFiles`-style entry: load `.cedarpg/dev.env` with overwrite.
+*
+* ```ts
+* import "@cedarjs/pg/dev-env";
+* ```
+*/
+require("./load-dev-env-cII6N4ZP.cjs").loadDevEnv({ overwrite: true });
+//#endregion
+
+//# sourceMappingURL=dev-env.cjs.map

package/dist/dev-env.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-env.cjs","names":["loadDevEnv"],"sources":["../src/adapters/dev-env.ts"],"sourcesContent":["import { loadDevEnv } from \"./load-dev-env.ts\";\n\n/**\n * `setupFiles`-style entry: load `.cedarpg/dev.env` with overwrite.\n *\n * ```ts\n * import \"@cedarjs/pg/dev-env\";\n * ```\n */\nloadDevEnv({ overwrite: true });\n"],"mappings":";;;;;;;;qCASAA,CAAAA,CAAAA,WAAW,EAAE,WAAW,KAAK,CAAC"}

package/dist/dev-env.d.cts

@@ -0,0 +1 @@
+export {}

package/dist/dev-env.d.mts

@@ -0,0 +1 @@
+export {}

package/dist/dev-env.mjs

@@ -0,0 +1,14 @@
+import { t as loadDevEnv } from "./load-dev-env-7UjMHhw7.mjs";
+//#region src/adapters/dev-env.ts
+/**
+* `setupFiles`-style entry: load `.cedarpg/dev.env` with overwrite.
+*
+* ```ts
+* import "@cedarjs/pg/dev-env";
+* ```
+*/
+loadDevEnv({ overwrite: true });
+//#endregion
+export {};
+
+//# sourceMappingURL=dev-env.mjs.map

package/dist/dev-env.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-env.mjs","names":[],"sources":["../src/adapters/dev-env.ts"],"sourcesContent":["import { loadDevEnv } from \"./load-dev-env.ts\";\n\n/**\n * `setupFiles`-style entry: load `.cedarpg/dev.env` with overwrite.\n *\n * ```ts\n * import \"@cedarjs/pg/dev-env\";\n * ```\n */\nloadDevEnv({ overwrite: true });\n"],"mappings":";;;;;;;;;AASA,WAAW,EAAE,WAAW,KAAK,CAAC"}

package/dist/index.cjs

@@ -1,26 +1,66 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_lifecycle = require("./lifecycle-BGYtVXtx.cjs");
+const require_lifecycle = require("./lifecycle-DEJ4GgWV.cjs");
+const require_constants = require("./constants-Ct8myrEn.cjs");
+const require_lease = require("./lease-Bq9wKwQa.cjs");
+const require_template = require("./template-D0gJ_MS2.cjs");
+const require_load_test_env = require("./load-test-env-CkdUjTpV.cjs");
+const require_load_dev_env = require("./load-dev-env-cII6N4ZP.cjs");
+//#region src/adapters/acquire-task.ts
+/** Run acquireIfNeeded, then optional afterAcquire (migrate / db:ready). */
+function createAcquireTask(options) {
+	return async () => {
+		const result = await require_lifecycle.acquireIfNeeded({
+			root: options.root,
+			mode: options.mode,
+			setEnv: options.setEnv !== false,
+			force: options.force
+		});
+		if (result.status !== "acquired" || !options.afterAcquire) return;
+		await options.afterAcquire({
+			databaseUrl: result.databaseUrl,
+			adminUrl: result.adminUrl,
+			databaseName: result.databaseName,
+			roleName: result.roleName,
+			root: result.root,
+			mode: result.mode,
+			port: result.port
+		});
+	};
+}
+//#endregion
+exports.CLI_NAME = require_constants.CLI_NAME;
 exports.INSTALL_HINT = require_lifecycle.INSTALL_HINT;
 exports.ROLE_PASSWORD_SCHEME = require_lifecycle.ROLE_PASSWORD_SCHEME;
+exports.STATE_DIRNAME = require_constants.STATE_DIRNAME;
+exports.acquire = require_lifecycle.acquire;
+exports.acquireIfNeeded = require_lifecycle.acquireIfNeeded;
+exports.applyDatabaseUrlEnv = require_lifecycle.applyDatabaseUrlEnv;
+exports.buildCloneDatabaseName = require_lifecycle.buildCloneDatabaseName;
 exports.buildDatabaseName = require_lifecycle.buildDatabaseName;
 exports.buildDatabaseUrl = require_lifecycle.buildDatabaseUrl;
 exports.buildRoleName = require_lifecycle.buildRoleName;
+exports.cloneFromTemplate = require_template.cloneFromTemplate;
+exports.cloneFromTemplateIfNeeded = require_template.cloneFromTemplateIfNeeded;
+exports.createAcquireTask = createAcquireTask;
 exports.discoverHost = require_lifecycle.discoverHost;
 exports.dispose = require_lifecycle.dispose;
-exports.ensure = require_lifecycle.ensure;
-exports.ensureHostRunning = require_lifecycle.ensureHostRunning;
-exports.ensureIfNeeded = require_lifecycle.ensureIfNeeded;
+exports.envFilePath = require_lease.envFilePath;
 exports.gc = require_lifecycle.gc;
 exports.isCedarPgManagedUrl = require_lifecycle.isCedarPgManagedUrl;
 exports.isExternalDatabaseEscapeHatch = require_lifecycle.isExternalDatabaseEscapeHatch;
-exports.isOrphanLease = require_lifecycle.isOrphanLease;
+exports.isOrphanLease = require_lease.isOrphanLease;
+exports.loadDevEnv = require_load_dev_env.loadDevEnv;
+exports.loadTestEnv = require_load_test_env.loadTestEnv;
+exports.markTemplate = require_template.markTemplate;
 exports.parseHostStatus = require_lifecycle.parseHostStatus;
-exports.parseLease = require_lifecycle.parseLease;
-exports.readLease = require_lifecycle.readLease;
+exports.parseLease = require_lease.parseLease;
+exports.readLease = require_lease.readLease;
 exports.requireAutopgBin = require_lifecycle.requireAutopgBin;
+exports.resolveAcquireSkip = require_lifecycle.resolveAcquireSkip;
 exports.resolveAutopgBin = require_lifecycle.resolveAutopgBin;
-exports.resolveEnsureSkip = require_lifecycle.resolveEnsureSkip;
-exports.resolveRoot = require_lifecycle.resolveRoot;
-exports.resolveWorktreeIdentity = require_lifecycle.resolveWorktreeIdentity;
+exports.resolveRoot = require_lease.resolveRoot;
+exports.resolveWorktreeIdentity = require_lease.resolveWorktreeIdentity;
 exports.rolePasswordFor = require_lifecycle.rolePasswordFor;
 exports.urlFromLease = require_lifecycle.urlFromLease;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["acquireIfNeeded"],"sources":["../src/adapters/acquire-task.ts"],"sourcesContent":["import { acquireIfNeeded, type AcquireResult } from \"../core/lifecycle.ts\";\nimport type { DbMode } from \"../core/naming.ts\";\n\nexport type AcquireTaskContext = Pick<\n  AcquireResult,\n  \"databaseUrl\" | \"adminUrl\" | \"databaseName\" | \"roleName\" | \"root\" | \"mode\" | \"port\"\n>;\n\nexport type CreateAcquireTaskOptions = {\n  mode: DbMode;\n  root?: string;\n  /** Ignore external-URL escape hatch (`CEDAR_PG_FORCE=1` also works). */\n  force?: boolean;\n  setEnv?: boolean;\n  /** App-owned migrate/seed after a successful acquire. */\n  afterAcquire?: (ctx: AcquireTaskContext) => void | Promise<void>;\n};\n\n/** Run acquireIfNeeded, then optional afterAcquire (migrate / db:ready). */\nexport function createAcquireTask(options: CreateAcquireTaskOptions): () => Promise<void> {\n  return async () => {\n    const result = await acquireIfNeeded({\n      root: options.root,\n      mode: options.mode,\n      setEnv: options.setEnv !== false,\n      force: options.force,\n    });\n    if (result.status !== \"acquired\" || !options.afterAcquire) return;\n    await options.afterAcquire({\n      databaseUrl: result.databaseUrl,\n      adminUrl: result.adminUrl,\n      databaseName: result.databaseName,\n      roleName: result.roleName,\n      root: result.root,\n      mode: result.mode,\n      port: result.port,\n    });\n  };\n}\n"],"mappings":";;;;;;;;;AAmBA,SAAgB,kBAAkB,SAAwD;CACxF,OAAO,YAAY;EACjB,MAAM,SAAS,MAAMA,kBAAAA,gBAAgB;GACnC,MAAM,QAAQ;GACd,MAAM,QAAQ;GACd,QAAQ,QAAQ,WAAW;GAC3B,OAAO,QAAQ;EACjB,CAAC;EACD,IAAI,OAAO,WAAW,cAAc,CAAC,QAAQ,cAAc;EAC3D,MAAM,QAAQ,aAAa;GACzB,aAAa,OAAO;GACpB,UAAU,OAAO;GACjB,cAAc,OAAO;GACrB,UAAU,OAAO;GACjB,MAAM,OAAO;GACb,MAAM,OAAO;GACb,MAAM,OAAO;EACf,CAAC;CACH;AACF"}