@cedarjs/pg 0.2.0-alpha.0 → 0.3.0

package/dist/studio-Bi6SU9jE.mjs

@@ -0,0 +1,221 @@
+import { p as CLI_NAME } from "./lease-DS1SX8U_.mjs";
+import { createRequire } from "node:module";
+import { existsSync, readFileSync } from "node:fs";
+import { constants } from "node:os";
+import { dirname, isAbsolute, join, relative, resolve } from "node:path";
+import { spawn } from "node:child_process";
+import { pathToFileURL } from "node:url";
+//#region src/adapters/child.ts
+const FORWARDED_SIGNALS = [
+	"SIGINT",
+	"SIGTERM",
+	"SIGHUP"
+];
+/**
+* Attached child: inherit stdio, forward SIGINT / SIGTERM / SIGHUP to the
+* child while it runs, resolve with its exit code (killed by signal → 128 + n).
+*/
+function runAttached(command, args, options = {}) {
+	return new Promise((resolve, reject) => {
+		const child = spawn(command, args, {
+			stdio: "inherit",
+			cwd: options.cwd,
+			env: options.env,
+			shell: options.shell
+		});
+		const forward = (signal) => child.kill(signal);
+		for (const signal of FORWARDED_SIGNALS) process.on(signal, forward);
+		const detach = () => {
+			for (const signal of FORWARDED_SIGNALS) process.off(signal, forward);
+		};
+		child.once("error", (error) => {
+			detach();
+			reject(error);
+		});
+		child.once("exit", (code, signal) => {
+			detach();
+			resolve(signal ? 128 + constants.signals[signal] : code ?? 1);
+		});
+	});
+}
+//#endregion
+//#region src/adapters/tasks.ts
+/** Vite+ lifecycle task names and command strings (also used by the status hint). */
+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;
+}
+//#endregion
+//#region src/adapters/status-format.ts
+/** Human-readable lines for the Vite panel / `cedarpg status`. */
+function formatDevStatus(status) {
+	if (!status.ok) {
+		const task = status.mode === "test" ? CEDAR_PG_TASK_ACQUIRE_TEST : CEDAR_PG_TASK_ACQUIRE_DEV;
+		return [`${CLI_NAME}: no ${status.mode} lease at ${status.root}`, `  run \`${CLI_NAME} acquire --mode=${status.mode}\` (or depend on ${task})`];
+	}
+	const { lease, databaseUrl, envPath } = status;
+	return [
+		`${CLI_NAME}: ${lease.databaseName} (${lease.repoSlug}/${lease.worktreeSlug} ${lease.mode})`,
+		`  port          ${lease.port}`,
+		`  DATABASE_URL  ${databaseUrl}`,
+		`  env           ${envPath}`
+	];
+}
+//#endregion
+//#region src/adapters/studio.ts
+const STUDIO_PACKAGE = {
+	prisma: "prisma",
+	drizzle: "drizzle-kit"
+};
+const AUTO_ORDER = ["prisma", "drizzle"];
+function readPackageJson(dir) {
+	const file = join(dir, "package.json");
+	if (!existsSync(file)) return null;
+	try {
+		return JSON.parse(readFileSync(file, "utf8"));
+	} catch {
+		return null;
+	}
+}
+function hasDep(pkg, name) {
+	if (!pkg) return false;
+	return Boolean(pkg.dependencies?.[name] || pkg.devDependencies?.[name] || pkg.optionalDependencies?.[name]);
+}
+function tryResolveBin(dir, packageName) {
+	try {
+		const pkgJsonPath = createRequire(pathToFileURL(join(dir, "package.json")).href).resolve(`${packageName}/package.json`);
+		const binField = JSON.parse(readFileSync(pkgJsonPath, "utf8")).bin;
+		let rel;
+		if (typeof binField === "string") rel = binField;
+		else if (binField && typeof binField === "object") rel = binField[packageName] ?? Object.values(binField)[0];
+		if (!rel) return null;
+		const abs = join(dirname(pkgJsonPath), rel);
+		return existsSync(abs) ? abs : null;
+	} catch {
+		return null;
+	}
+}
+function npxStudio(kind, cwd) {
+	return {
+		kind,
+		command: "npx",
+		args: [STUDIO_PACKAGE[kind], "studio"],
+		cwd,
+		shell: true
+	};
+}
+/** Local bin, else declared dep → npx, else null. Resolves the bin at most once. */
+function studioAt(kind, dir) {
+	const pkg = STUDIO_PACKAGE[kind];
+	const bin = tryResolveBin(dir, pkg);
+	if (bin) return {
+		kind,
+		command: bin,
+		args: ["studio"],
+		cwd: dir,
+		shell: false
+	};
+	if (hasDep(readPackageJson(dir), pkg)) return npxStudio(kind, dir);
+	return null;
+}
+function isInside(dir, ancestor) {
+	const rel = relative(ancestor, dir);
+	return rel === "" || !rel.startsWith("..") && !isAbsolute(rel);
+}
+/** `start` up to `stop` (inclusive) when `start` is inside the worktree; otherwise only `start`. */
+function searchDirs(start, stop) {
+	if (!isInside(start, stop)) return [start];
+	const dirs = [];
+	let dir = start;
+	for (;;) {
+		dirs.push(dir);
+		if (dir === stop) return dirs;
+		const parent = dirname(dir);
+		if (parent === dir) return dirs;
+		dir = parent;
+	}
+}
+/**
+* Detect Prisma Studio or Drizzle Kit Studio, walking from `cwd` up to the worktree `root`.
+*
+* Auto: nearest directory wins, prisma before drizzle in that directory; no npx fallback.
+* Forced `prefer`: same nearest walk for that kind only, then npx at `cwd`.
+*/
+function detectStudio(options) {
+	const stop = resolve(options.root);
+	const start = resolve(options.cwd ?? options.root);
+	const dirs = searchDirs(start, stop);
+	const kinds = options.prefer ? [options.prefer] : AUTO_ORDER;
+	for (const dir of dirs) for (const kind of kinds) {
+		const hit = studioAt(kind, dir);
+		if (hit) return hit;
+	}
+	return options.prefer ? npxStudio(options.prefer, start) : null;
+}
+function spawnStudio(options, spawnOpts) {
+	const { databaseUrl, studio } = options;
+	return spawn(studio.command, studio.args, {
+		cwd: studio.cwd,
+		env: {
+			...process.env,
+			DATABASE_URL: databaseUrl
+		},
+		...spawnOpts,
+		shell: studio.shell
+	});
+}
+/**
+* Detached Studio for the Vite shortcut. Caller attaches `error` / `exit` on the
+* returned process (spawn failures emit on a later tick).
+*/
+function openStudio(options) {
+	const child = spawnStudio(options, {
+		detached: true,
+		stdio: "ignore"
+	});
+	child.unref();
+	return child;
+}
+/** Attached Studio for `cedarpg studio`: inherit stdio, resolve with the child's exit code. */
+function runStudio(options) {
+	const { databaseUrl, studio } = options;
+	return runAttached(studio.command, studio.args, {
+		cwd: studio.cwd,
+		env: {
+			...process.env,
+			DATABASE_URL: databaseUrl
+		},
+		shell: studio.shell
+	});
+}
+function studioChildRunning(child) {
+	return Boolean(child && child.exitCode === null && !child.killed);
+}
+//#endregion
+export { formatDevStatus as a, CEDAR_PG_TASK_DISPOSE_TEST as c, studioChildRunning as i, cedarPgLifecycleTargets as l, openStudio as n, CEDAR_PG_TASK_ACQUIRE_DEV as o, runStudio as r, CEDAR_PG_TASK_ACQUIRE_TEST as s, detectStudio as t, runAttached as u };
+
+//# sourceMappingURL=studio-Bi6SU9jE.mjs.map

package/dist/studio-Bi6SU9jE.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-Bi6SU9jE.mjs","names":[],"sources":["../src/adapters/child.ts","../src/adapters/tasks.ts","../src/adapters/status-format.ts","../src/adapters/studio.ts"],"sourcesContent":["import { spawn } from \"node:child_process\";\nimport { constants } from \"node:os\";\n\nexport type RunAttachedOptions = {\n  cwd?: string;\n  env?: NodeJS.ProcessEnv;\n  shell?: boolean;\n};\n\nconst FORWARDED_SIGNALS = [\"SIGINT\", \"SIGTERM\", \"SIGHUP\"] as const;\n\n/**\n * Attached child: inherit stdio, forward SIGINT / SIGTERM / SIGHUP to the\n * child while it runs, resolve with its exit code (killed by signal → 128 + n).\n */\nexport function runAttached(\n  command: string,\n  args: string[],\n  options: RunAttachedOptions = {},\n): Promise<number> {\n  return new Promise((resolve, reject) => {\n    const child = spawn(command, args, {\n      stdio: \"inherit\",\n      cwd: options.cwd,\n      env: options.env,\n      shell: options.shell,\n    });\n    const forward = (signal: NodeJS.Signals) => child.kill(signal);\n    for (const signal of FORWARDED_SIGNALS) process.on(signal, forward);\n    const detach = () => {\n      for (const signal of FORWARDED_SIGNALS) process.off(signal, forward);\n    };\n    child.once(\"error\", (error) => {\n      detach();\n      reject(error);\n    });\n    child.once(\"exit\", (code, signal) => {\n      detach();\n      resolve(signal ? 128 + constants.signals[signal] : (code ?? 1));\n    });\n  });\n}\n","/** Vite+ lifecycle task names and command strings (also used by the status hint). */\n\nimport { CLI_NAME } from \"../core/constants.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","import { CLI_NAME } from \"../core/constants.ts\";\nimport type { DevStatus } from \"../core/status.ts\";\nimport { CEDAR_PG_TASK_ACQUIRE_DEV, CEDAR_PG_TASK_ACQUIRE_TEST } from \"./tasks.ts\";\n\n/** Human-readable lines for the Vite panel / `cedarpg status`. */\nexport function formatDevStatus(status: DevStatus): string[] {\n  if (!status.ok) {\n    const task = status.mode === \"test\" ? CEDAR_PG_TASK_ACQUIRE_TEST : CEDAR_PG_TASK_ACQUIRE_DEV;\n    return [\n      `${CLI_NAME}: no ${status.mode} lease at ${status.root}`,\n      `  run \\`${CLI_NAME} acquire --mode=${status.mode}\\` (or depend on ${task})`,\n    ];\n  }\n  const { lease, databaseUrl, envPath } = status;\n  return [\n    `${CLI_NAME}: ${lease.databaseName} (${lease.repoSlug}/${lease.worktreeSlug} ${lease.mode})`,\n    `  port          ${lease.port}`,\n    `  DATABASE_URL  ${databaseUrl}`,\n    `  env           ${envPath}`,\n  ];\n}\n","import { createRequire } from \"node:module\";\nimport { spawn, type ChildProcess, type SpawnOptions } from \"node:child_process\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { dirname, isAbsolute, join, relative, resolve } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { runAttached } from \"./child.ts\";\n\nexport type StudioKind = \"prisma\" | \"drizzle\";\n\nconst STUDIO_PACKAGE: Record<StudioKind, string> = {\n  prisma: \"prisma\",\n  drizzle: \"drizzle-kit\",\n};\n\nconst AUTO_ORDER: StudioKind[] = [\"prisma\", \"drizzle\"];\n\nexport type DetectStudioOptions = {\n  /** Worktree / lease root — directory walk stops here. */\n  root: string;\n  /** App package to start the walk (Nx `apps/…`). Defaults to `root`. */\n  cwd?: string;\n  /** Force a kind. Omit to auto-detect (nearest package; prisma if both). */\n  prefer?: StudioKind;\n};\n\nexport type DetectedStudio = {\n  kind: StudioKind;\n  command: string;\n  args: string[];\n  /** Directory to spawn in (where the ORM package / config was found). */\n  cwd: string;\n  /** True when falling back to `npx`. */\n  shell: boolean;\n};\n\ntype PkgJson = {\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n  optionalDependencies?: Record<string, string>;\n};\n\nfunction readPackageJson(dir: string): PkgJson | null {\n  const file = join(dir, \"package.json\");\n  if (!existsSync(file)) return null;\n  try {\n    return JSON.parse(readFileSync(file, \"utf8\")) as PkgJson;\n  } catch {\n    return null;\n  }\n}\n\nfunction hasDep(pkg: PkgJson | null, name: string): boolean {\n  if (!pkg) return false;\n  return Boolean(\n    pkg.dependencies?.[name] || pkg.devDependencies?.[name] || pkg.optionalDependencies?.[name],\n  );\n}\n\nfunction tryResolveBin(dir: string, packageName: string): string | null {\n  try {\n    const require = createRequire(pathToFileURL(join(dir, \"package.json\")).href);\n    const pkgJsonPath = require.resolve(`${packageName}/package.json`);\n    const pkg = JSON.parse(readFileSync(pkgJsonPath, \"utf8\")) as {\n      bin?: string | Record<string, string>;\n    };\n    const binField = pkg.bin;\n    let rel: string | undefined;\n    if (typeof binField === \"string\") rel = binField;\n    else if (binField && typeof binField === \"object\") {\n      rel = binField[packageName] ?? Object.values(binField)[0];\n    }\n    if (!rel) return null;\n    const abs = join(dirname(pkgJsonPath), rel);\n    return existsSync(abs) ? abs : null;\n  } catch {\n    return null;\n  }\n}\n\nfunction npxStudio(kind: StudioKind, cwd: string): DetectedStudio {\n  return {\n    kind,\n    command: \"npx\",\n    args: [STUDIO_PACKAGE[kind], \"studio\"],\n    cwd,\n    shell: true,\n  };\n}\n\n/** Local bin, else declared dep → npx, else null. Resolves the bin at most once. */\nfunction studioAt(kind: StudioKind, dir: string): DetectedStudio | null {\n  const pkg = STUDIO_PACKAGE[kind];\n  const bin = tryResolveBin(dir, pkg);\n  if (bin) return { kind, command: bin, args: [\"studio\"], cwd: dir, shell: false };\n  if (hasDep(readPackageJson(dir), pkg)) return npxStudio(kind, dir);\n  return null;\n}\n\nfunction isInside(dir: string, ancestor: string): boolean {\n  const rel = relative(ancestor, dir);\n  return rel === \"\" || (!rel.startsWith(\"..\") && !isAbsolute(rel));\n}\n\n/** `start` up to `stop` (inclusive) when `start` is inside the worktree; otherwise only `start`. */\nfunction searchDirs(start: string, stop: string): string[] {\n  if (!isInside(start, stop)) return [start];\n  const dirs: string[] = [];\n  let dir = start;\n  for (;;) {\n    dirs.push(dir);\n    if (dir === stop) return dirs;\n    const parent = dirname(dir);\n    if (parent === dir) return dirs;\n    dir = parent;\n  }\n}\n\n/**\n * Detect Prisma Studio or Drizzle Kit Studio, walking from `cwd` up to the worktree `root`.\n *\n * Auto: nearest directory wins, prisma before drizzle in that directory; no npx fallback.\n * Forced `prefer`: same nearest walk for that kind only, then npx at `cwd`.\n */\nexport function detectStudio(options: DetectStudioOptions): DetectedStudio | null {\n  const stop = resolve(options.root);\n  const start = resolve(options.cwd ?? options.root);\n  const dirs = searchDirs(start, stop);\n  const kinds = options.prefer ? [options.prefer] : AUTO_ORDER;\n\n  for (const dir of dirs) {\n    for (const kind of kinds) {\n      const hit = studioAt(kind, dir);\n      if (hit) return hit;\n    }\n  }\n  return options.prefer ? npxStudio(options.prefer, start) : null;\n}\n\nexport type SpawnStudioOptions = {\n  databaseUrl: string;\n  studio: DetectedStudio;\n};\n\nfunction spawnStudio(options: SpawnStudioOptions, spawnOpts: SpawnOptions): ChildProcess {\n  const { databaseUrl, studio } = options;\n  return spawn(studio.command, studio.args, {\n    cwd: studio.cwd,\n    env: { ...process.env, DATABASE_URL: databaseUrl },\n    ...spawnOpts,\n    shell: studio.shell,\n  });\n}\n\n/**\n * Detached Studio for the Vite shortcut. Caller attaches `error` / `exit` on the\n * returned process (spawn failures emit on a later tick).\n */\nexport function openStudio(options: SpawnStudioOptions): ChildProcess {\n  const child = spawnStudio(options, { detached: true, stdio: \"ignore\" });\n  child.unref();\n  return child;\n}\n\n/** Attached Studio for `cedarpg studio`: inherit stdio, resolve with the child's exit code. */\nexport function runStudio(options: SpawnStudioOptions): Promise<number> {\n  const { databaseUrl, studio } = options;\n  return runAttached(studio.command, studio.args, {\n    cwd: studio.cwd,\n    env: { ...process.env, DATABASE_URL: databaseUrl },\n    shell: studio.shell,\n  });\n}\n\nexport function studioChildRunning(child: ChildProcess | undefined): boolean {\n  return Boolean(child && child.exitCode === null && !child.killed);\n}\n"],"mappings":"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"}

package/dist/studio-CdWIdnxr.cjs

@@ -0,0 +1,280 @@
+const require_lease = require("./lease-WlmOnNDi.cjs");
+let node_fs = require("node:fs");
+let node_os = require("node:os");
+let node_path = require("node:path");
+let node_child_process = require("node:child_process");
+let node_module = require("node:module");
+let node_url = require("node:url");
+//#region src/adapters/child.ts
+const FORWARDED_SIGNALS = [
+	"SIGINT",
+	"SIGTERM",
+	"SIGHUP"
+];
+/**
+* Attached child: inherit stdio, forward SIGINT / SIGTERM / SIGHUP to the
+* child while it runs, resolve with its exit code (killed by signal → 128 + n).
+*/
+function runAttached(command, args, options = {}) {
+	return new Promise((resolve, reject) => {
+		const child = (0, node_child_process.spawn)(command, args, {
+			stdio: "inherit",
+			cwd: options.cwd,
+			env: options.env,
+			shell: options.shell
+		});
+		const forward = (signal) => child.kill(signal);
+		for (const signal of FORWARDED_SIGNALS) process.on(signal, forward);
+		const detach = () => {
+			for (const signal of FORWARDED_SIGNALS) process.off(signal, forward);
+		};
+		child.once("error", (error) => {
+			detach();
+			reject(error);
+		});
+		child.once("exit", (code, signal) => {
+			detach();
+			resolve(signal ? 128 + node_os.constants.signals[signal] : code ?? 1);
+		});
+	});
+}
+//#endregion
+//#region src/adapters/tasks.ts
+/** Vite+ lifecycle task names and command strings (also used by the status hint). */
+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_lease.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;
+}
+//#endregion
+//#region src/adapters/status-format.ts
+/** Human-readable lines for the Vite panel / `cedarpg status`. */
+function formatDevStatus(status) {
+	if (!status.ok) {
+		const task = status.mode === "test" ? CEDAR_PG_TASK_ACQUIRE_TEST : CEDAR_PG_TASK_ACQUIRE_DEV;
+		return [`${require_lease.CLI_NAME}: no ${status.mode} lease at ${status.root}`, `  run \`${require_lease.CLI_NAME} acquire --mode=${status.mode}\` (or depend on ${task})`];
+	}
+	const { lease, databaseUrl, envPath } = status;
+	return [
+		`${require_lease.CLI_NAME}: ${lease.databaseName} (${lease.repoSlug}/${lease.worktreeSlug} ${lease.mode})`,
+		`  port          ${lease.port}`,
+		`  DATABASE_URL  ${databaseUrl}`,
+		`  env           ${envPath}`
+	];
+}
+//#endregion
+//#region src/adapters/studio.ts
+const STUDIO_PACKAGE = {
+	prisma: "prisma",
+	drizzle: "drizzle-kit"
+};
+const AUTO_ORDER = ["prisma", "drizzle"];
+function readPackageJson(dir) {
+	const file = (0, node_path.join)(dir, "package.json");
+	if (!(0, node_fs.existsSync)(file)) return null;
+	try {
+		return JSON.parse((0, node_fs.readFileSync)(file, "utf8"));
+	} catch {
+		return null;
+	}
+}
+function hasDep(pkg, name) {
+	if (!pkg) return false;
+	return Boolean(pkg.dependencies?.[name] || pkg.devDependencies?.[name] || pkg.optionalDependencies?.[name]);
+}
+function tryResolveBin(dir, packageName) {
+	try {
+		const pkgJsonPath = (0, node_module.createRequire)((0, node_url.pathToFileURL)((0, node_path.join)(dir, "package.json")).href).resolve(`${packageName}/package.json`);
+		const binField = JSON.parse((0, node_fs.readFileSync)(pkgJsonPath, "utf8")).bin;
+		let rel;
+		if (typeof binField === "string") rel = binField;
+		else if (binField && typeof binField === "object") rel = binField[packageName] ?? Object.values(binField)[0];
+		if (!rel) return null;
+		const abs = (0, node_path.join)((0, node_path.dirname)(pkgJsonPath), rel);
+		return (0, node_fs.existsSync)(abs) ? abs : null;
+	} catch {
+		return null;
+	}
+}
+function npxStudio(kind, cwd) {
+	return {
+		kind,
+		command: "npx",
+		args: [STUDIO_PACKAGE[kind], "studio"],
+		cwd,
+		shell: true
+	};
+}
+/** Local bin, else declared dep → npx, else null. Resolves the bin at most once. */
+function studioAt(kind, dir) {
+	const pkg = STUDIO_PACKAGE[kind];
+	const bin = tryResolveBin(dir, pkg);
+	if (bin) return {
+		kind,
+		command: bin,
+		args: ["studio"],
+		cwd: dir,
+		shell: false
+	};
+	if (hasDep(readPackageJson(dir), pkg)) return npxStudio(kind, dir);
+	return null;
+}
+function isInside(dir, ancestor) {
+	const rel = (0, node_path.relative)(ancestor, dir);
+	return rel === "" || !rel.startsWith("..") && !(0, node_path.isAbsolute)(rel);
+}
+/** `start` up to `stop` (inclusive) when `start` is inside the worktree; otherwise only `start`. */
+function searchDirs(start, stop) {
+	if (!isInside(start, stop)) return [start];
+	const dirs = [];
+	let dir = start;
+	for (;;) {
+		dirs.push(dir);
+		if (dir === stop) return dirs;
+		const parent = (0, node_path.dirname)(dir);
+		if (parent === dir) return dirs;
+		dir = parent;
+	}
+}
+/**
+* Detect Prisma Studio or Drizzle Kit Studio, walking from `cwd` up to the worktree `root`.
+*
+* Auto: nearest directory wins, prisma before drizzle in that directory; no npx fallback.
+* Forced `prefer`: same nearest walk for that kind only, then npx at `cwd`.
+*/
+function detectStudio(options) {
+	const stop = (0, node_path.resolve)(options.root);
+	const start = (0, node_path.resolve)(options.cwd ?? options.root);
+	const dirs = searchDirs(start, stop);
+	const kinds = options.prefer ? [options.prefer] : AUTO_ORDER;
+	for (const dir of dirs) for (const kind of kinds) {
+		const hit = studioAt(kind, dir);
+		if (hit) return hit;
+	}
+	return options.prefer ? npxStudio(options.prefer, start) : null;
+}
+function spawnStudio(options, spawnOpts) {
+	const { databaseUrl, studio } = options;
+	return (0, node_child_process.spawn)(studio.command, studio.args, {
+		cwd: studio.cwd,
+		env: {
+			...process.env,
+			DATABASE_URL: databaseUrl
+		},
+		...spawnOpts,
+		shell: studio.shell
+	});
+}
+/**
+* Detached Studio for the Vite shortcut. Caller attaches `error` / `exit` on the
+* returned process (spawn failures emit on a later tick).
+*/
+function openStudio(options) {
+	const child = spawnStudio(options, {
+		detached: true,
+		stdio: "ignore"
+	});
+	child.unref();
+	return child;
+}
+/** Attached Studio for `cedarpg studio`: inherit stdio, resolve with the child's exit code. */
+function runStudio(options) {
+	const { databaseUrl, studio } = options;
+	return runAttached(studio.command, studio.args, {
+		cwd: studio.cwd,
+		env: {
+			...process.env,
+			DATABASE_URL: databaseUrl
+		},
+		shell: studio.shell
+	});
+}
+function studioChildRunning(child) {
+	return Boolean(child && child.exitCode === null && !child.killed);
+}
+//#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, "detectStudio", {
+	enumerable: true,
+	get: function() {
+		return detectStudio;
+	}
+});
+Object.defineProperty(exports, "formatDevStatus", {
+	enumerable: true,
+	get: function() {
+		return formatDevStatus;
+	}
+});
+Object.defineProperty(exports, "openStudio", {
+	enumerable: true,
+	get: function() {
+		return openStudio;
+	}
+});
+Object.defineProperty(exports, "runAttached", {
+	enumerable: true,
+	get: function() {
+		return runAttached;
+	}
+});
+Object.defineProperty(exports, "runStudio", {
+	enumerable: true,
+	get: function() {
+		return runStudio;
+	}
+});
+Object.defineProperty(exports, "studioChildRunning", {
+	enumerable: true,
+	get: function() {
+		return studioChildRunning;
+	}
+});
+
+//# sourceMappingURL=studio-CdWIdnxr.cjs.map

package/dist/studio-CdWIdnxr.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-CdWIdnxr.cjs","names":["constants","CLI_NAME","CLI_NAME"],"sources":["../src/adapters/child.ts","../src/adapters/tasks.ts","../src/adapters/status-format.ts","../src/adapters/studio.ts"],"sourcesContent":["import { spawn } from \"node:child_process\";\nimport { constants } from \"node:os\";\n\nexport type RunAttachedOptions = {\n  cwd?: string;\n  env?: NodeJS.ProcessEnv;\n  shell?: boolean;\n};\n\nconst FORWARDED_SIGNALS = [\"SIGINT\", \"SIGTERM\", \"SIGHUP\"] as const;\n\n/**\n * Attached child: inherit stdio, forward SIGINT / SIGTERM / SIGHUP to the\n * child while it runs, resolve with its exit code (killed by signal → 128 + n).\n */\nexport function runAttached(\n  command: string,\n  args: string[],\n  options: RunAttachedOptions = {},\n): Promise<number> {\n  return new Promise((resolve, reject) => {\n    const child = spawn(command, args, {\n      stdio: \"inherit\",\n      cwd: options.cwd,\n      env: options.env,\n      shell: options.shell,\n    });\n    const forward = (signal: NodeJS.Signals) => child.kill(signal);\n    for (const signal of FORWARDED_SIGNALS) process.on(signal, forward);\n    const detach = () => {\n      for (const signal of FORWARDED_SIGNALS) process.off(signal, forward);\n    };\n    child.once(\"error\", (error) => {\n      detach();\n      reject(error);\n    });\n    child.once(\"exit\", (code, signal) => {\n      detach();\n      resolve(signal ? 128 + constants.signals[signal] : (code ?? 1));\n    });\n  });\n}\n","/** Vite+ lifecycle task names and command strings (also used by the status hint). */\n\nimport { CLI_NAME } from \"../core/constants.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","import { CLI_NAME } from \"../core/constants.ts\";\nimport type { DevStatus } from \"../core/status.ts\";\nimport { CEDAR_PG_TASK_ACQUIRE_DEV, CEDAR_PG_TASK_ACQUIRE_TEST } from \"./tasks.ts\";\n\n/** Human-readable lines for the Vite panel / `cedarpg status`. */\nexport function formatDevStatus(status: DevStatus): string[] {\n  if (!status.ok) {\n    const task = status.mode === \"test\" ? CEDAR_PG_TASK_ACQUIRE_TEST : CEDAR_PG_TASK_ACQUIRE_DEV;\n    return [\n      `${CLI_NAME}: no ${status.mode} lease at ${status.root}`,\n      `  run \\`${CLI_NAME} acquire --mode=${status.mode}\\` (or depend on ${task})`,\n    ];\n  }\n  const { lease, databaseUrl, envPath } = status;\n  return [\n    `${CLI_NAME}: ${lease.databaseName} (${lease.repoSlug}/${lease.worktreeSlug} ${lease.mode})`,\n    `  port          ${lease.port}`,\n    `  DATABASE_URL  ${databaseUrl}`,\n    `  env           ${envPath}`,\n  ];\n}\n","import { createRequire } from \"node:module\";\nimport { spawn, type ChildProcess, type SpawnOptions } from \"node:child_process\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { dirname, isAbsolute, join, relative, resolve } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { runAttached } from \"./child.ts\";\n\nexport type StudioKind = \"prisma\" | \"drizzle\";\n\nconst STUDIO_PACKAGE: Record<StudioKind, string> = {\n  prisma: \"prisma\",\n  drizzle: \"drizzle-kit\",\n};\n\nconst AUTO_ORDER: StudioKind[] = [\"prisma\", \"drizzle\"];\n\nexport type DetectStudioOptions = {\n  /** Worktree / lease root — directory walk stops here. */\n  root: string;\n  /** App package to start the walk (Nx `apps/…`). Defaults to `root`. */\n  cwd?: string;\n  /** Force a kind. Omit to auto-detect (nearest package; prisma if both). */\n  prefer?: StudioKind;\n};\n\nexport type DetectedStudio = {\n  kind: StudioKind;\n  command: string;\n  args: string[];\n  /** Directory to spawn in (where the ORM package / config was found). */\n  cwd: string;\n  /** True when falling back to `npx`. */\n  shell: boolean;\n};\n\ntype PkgJson = {\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n  optionalDependencies?: Record<string, string>;\n};\n\nfunction readPackageJson(dir: string): PkgJson | null {\n  const file = join(dir, \"package.json\");\n  if (!existsSync(file)) return null;\n  try {\n    return JSON.parse(readFileSync(file, \"utf8\")) as PkgJson;\n  } catch {\n    return null;\n  }\n}\n\nfunction hasDep(pkg: PkgJson | null, name: string): boolean {\n  if (!pkg) return false;\n  return Boolean(\n    pkg.dependencies?.[name] || pkg.devDependencies?.[name] || pkg.optionalDependencies?.[name],\n  );\n}\n\nfunction tryResolveBin(dir: string, packageName: string): string | null {\n  try {\n    const require = createRequire(pathToFileURL(join(dir, \"package.json\")).href);\n    const pkgJsonPath = require.resolve(`${packageName}/package.json`);\n    const pkg = JSON.parse(readFileSync(pkgJsonPath, \"utf8\")) as {\n      bin?: string | Record<string, string>;\n    };\n    const binField = pkg.bin;\n    let rel: string | undefined;\n    if (typeof binField === \"string\") rel = binField;\n    else if (binField && typeof binField === \"object\") {\n      rel = binField[packageName] ?? Object.values(binField)[0];\n    }\n    if (!rel) return null;\n    const abs = join(dirname(pkgJsonPath), rel);\n    return existsSync(abs) ? abs : null;\n  } catch {\n    return null;\n  }\n}\n\nfunction npxStudio(kind: StudioKind, cwd: string): DetectedStudio {\n  return {\n    kind,\n    command: \"npx\",\n    args: [STUDIO_PACKAGE[kind], \"studio\"],\n    cwd,\n    shell: true,\n  };\n}\n\n/** Local bin, else declared dep → npx, else null. Resolves the bin at most once. */\nfunction studioAt(kind: StudioKind, dir: string): DetectedStudio | null {\n  const pkg = STUDIO_PACKAGE[kind];\n  const bin = tryResolveBin(dir, pkg);\n  if (bin) return { kind, command: bin, args: [\"studio\"], cwd: dir, shell: false };\n  if (hasDep(readPackageJson(dir), pkg)) return npxStudio(kind, dir);\n  return null;\n}\n\nfunction isInside(dir: string, ancestor: string): boolean {\n  const rel = relative(ancestor, dir);\n  return rel === \"\" || (!rel.startsWith(\"..\") && !isAbsolute(rel));\n}\n\n/** `start` up to `stop` (inclusive) when `start` is inside the worktree; otherwise only `start`. */\nfunction searchDirs(start: string, stop: string): string[] {\n  if (!isInside(start, stop)) return [start];\n  const dirs: string[] = [];\n  let dir = start;\n  for (;;) {\n    dirs.push(dir);\n    if (dir === stop) return dirs;\n    const parent = dirname(dir);\n    if (parent === dir) return dirs;\n    dir = parent;\n  }\n}\n\n/**\n * Detect Prisma Studio or Drizzle Kit Studio, walking from `cwd` up to the worktree `root`.\n *\n * Auto: nearest directory wins, prisma before drizzle in that directory; no npx fallback.\n * Forced `prefer`: same nearest walk for that kind only, then npx at `cwd`.\n */\nexport function detectStudio(options: DetectStudioOptions): DetectedStudio | null {\n  const stop = resolve(options.root);\n  const start = resolve(options.cwd ?? options.root);\n  const dirs = searchDirs(start, stop);\n  const kinds = options.prefer ? [options.prefer] : AUTO_ORDER;\n\n  for (const dir of dirs) {\n    for (const kind of kinds) {\n      const hit = studioAt(kind, dir);\n      if (hit) return hit;\n    }\n  }\n  return options.prefer ? npxStudio(options.prefer, start) : null;\n}\n\nexport type SpawnStudioOptions = {\n  databaseUrl: string;\n  studio: DetectedStudio;\n};\n\nfunction spawnStudio(options: SpawnStudioOptions, spawnOpts: SpawnOptions): ChildProcess {\n  const { databaseUrl, studio } = options;\n  return spawn(studio.command, studio.args, {\n    cwd: studio.cwd,\n    env: { ...process.env, DATABASE_URL: databaseUrl },\n    ...spawnOpts,\n    shell: studio.shell,\n  });\n}\n\n/**\n * Detached Studio for the Vite shortcut. Caller attaches `error` / `exit` on the\n * returned process (spawn failures emit on a later tick).\n */\nexport function openStudio(options: SpawnStudioOptions): ChildProcess {\n  const child = spawnStudio(options, { detached: true, stdio: \"ignore\" });\n  child.unref();\n  return child;\n}\n\n/** Attached Studio for `cedarpg studio`: inherit stdio, resolve with the child's exit code. */\nexport function runStudio(options: SpawnStudioOptions): Promise<number> {\n  const { databaseUrl, studio } = options;\n  return runAttached(studio.command, studio.args, {\n    cwd: studio.cwd,\n    env: { ...process.env, DATABASE_URL: databaseUrl },\n    shell: studio.shell,\n  });\n}\n\nexport function studioChildRunning(child: ChildProcess | undefined): boolean {\n  return Boolean(child && child.exitCode === null && !child.killed);\n}\n"],"mappings":"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"}

package/dist/{template-D0gJ_MS2.cjs → template-Cd77H7Cr.cjs}

@@ -1,19 +1,23 @@
-const require_lifecycle = require("./lifecycle-DEJ4GgWV.cjs");
-const require_lease = require("./lease-Bq9wKwQa.cjs");
+const require_lifecycle = require("./lifecycle-BCeM96tI.cjs");
 //#region src/core/template.ts
-async function resolveAdminUrl(adminUrl) {
-	return adminUrl ?? (await require_lifecycle.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 require_lifecycle.attach(options);
+	return {
+		lease,
+		adminUrl: options.adminUrl ?? require_lifecycle.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 = 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);
+	const { lease, adminUrl } = await attachAdmin(options);
 	await require_lifecycle.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 = 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 { lease, adminUrl } = await attachAdmin(options);
 	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
+		roleName: lease.roleName,
+		reuse: options.reuse
 	});
 	const databaseUrl = require_lifecycle.buildDatabaseUrl({
 		port: lease.port,
 		databaseName,
 		roleName: lease.roleName
 	});
-	if (options.setEnv) require_lifecycle.applyDatabaseUrlEnv(databaseUrl, { mode });
+	if (options.setEnv) require_lifecycle.applyDatabaseUrlEnv(databaseUrl, { mode: options.mode });
 	const roleName = lease.roleName;
 	return {
 		databaseUrl,
@@ -102,4 +105,4 @@ Object.defineProperty(exports, "markTemplate", {
 	}
 });
 
-//# sourceMappingURL=template-D0gJ_MS2.cjs.map
+//# sourceMappingURL=template-Cd77H7Cr.cjs.map

package/dist/template-Cd77H7Cr.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-Cd77H7Cr.cjs","names":["attach","adminUrlFor","setDatabaseIsTemplate","buildCloneDatabaseName","cloneDatabaseFromTemplate","buildDatabaseUrl","dropDatabase","runIfNeeded"],"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,MAAMA,kBAAAA,OAAO,OAAO;CACtC,OAAO;EAAE;EAAO,UAAU,QAAQ,YAAYC,kBAAAA,YAAY,MAAM,IAAI;CAAE;AACxE;;;;;AAaA,eAAsB,aACpB,SACqD;CACrD,MAAM,EAAE,OAAO,aAAa,MAAM,YAAY,OAAO;CACrD,MAAMC,kBAAAA,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,eAAeC,kBAAAA,uBAAuB,MAAM,cAAc,MAAM;CAEtE,MAAMC,kBAAAA,0BAA0B;EAC9B;EACA,cAAc,MAAM;EACpB;EACA,UAAU,MAAM;EAChB,OAAO,QAAQ;CACjB,CAAC;CAED,MAAM,cAAcC,kBAAAA,iBAAiB;EACnC,MAAM,MAAM;EACZ;EACA,UAAU,MAAM;CAClB,CAAC;CAED,IAAI,QAAQ,QACV,kBAAA,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,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"}