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

package/dist/jest-template.mjs

@@ -0,0 +1,38 @@
+import { n as setupTemplateMode, t as cloneWorkerDatabase } from "./template-mode-BTUsdBtA.mjs";
+//#region src/adapters/jest-template.ts
+/**
+* Jest globalSetup (template mode).
+*
+* ```js
+* // jest.cedar-global.cjs
+* const { createGlobalSetup } = require("@cedarjs/pg/jest/template");
+* module.exports = createGlobalSetup({ migrate: async ({ databaseUrl }) => {} });
+*
+* // jest.config.cjs
+* // When .env has a real TEST_DATABASE_URL, set once here (inherits to workers):
+* // process.env.CEDAR_PG_FORCE = "1";
+* globalSetup: "<rootDir>/jest.cedar-global.cjs",
+* globalTeardown: require.resolve("@cedarjs/pg/jest-teardown"),
+* // Prefer setupFilesAfterEnv + beforeAll; setupFiles also works (memo is process-scoped).
+* setupFilesAfterEnv: ["<rootDir>/jest.cedar-worker.cjs"],
+*
+* // jest.cedar-worker.cjs
+* const { cloneWorkerDatabase } = require("@cedarjs/pg/jest/template");
+* beforeAll(() => cloneWorkerDatabase());
+* ```
+*
+* Stock `@cedarjs/pg/jest` is one shared test DB only.
+*/
+function createGlobalSetup(options) {
+	return async () => {
+		await setupTemplateMode(options);
+	};
+}
+/** String `require.resolve` without a migrate hook is unsupported — use `createGlobalSetup`. */
+async function globalSetup() {
+	throw new Error("@cedarjs/pg/jest/template requires createGlobalSetup({ migrate }). Point globalSetup at a local module that exports createGlobalSetup({ migrate }).");
+}
+//#endregion
+export { cloneWorkerDatabase, createGlobalSetup, globalSetup as default };
+
+//# sourceMappingURL=jest-template.mjs.map

package/dist/jest-template.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"jest-template.mjs","names":[],"sources":["../src/adapters/jest-template.ts"],"sourcesContent":["import {\n  cloneWorkerDatabase,\n  setupTemplateMode,\n  type SetupTemplateModeOptions,\n} from \"./template-mode.ts\";\n\nexport { cloneWorkerDatabase };\nexport type {\n  SetupTemplateModeOptions,\n  TemplateMigrateFn,\n  TemplateMigrateContext,\n} from \"./template-mode.ts\";\n\n/**\n * Jest globalSetup (template mode).\n *\n * ```js\n * // jest.cedar-global.cjs\n * const { createGlobalSetup } = require(\"@cedarjs/pg/jest/template\");\n * module.exports = createGlobalSetup({ migrate: async ({ databaseUrl }) => {} });\n *\n * // jest.config.cjs\n * // When .env has a real TEST_DATABASE_URL, set once here (inherits to workers):\n * // process.env.CEDAR_PG_FORCE = \"1\";\n * globalSetup: \"<rootDir>/jest.cedar-global.cjs\",\n * globalTeardown: require.resolve(\"@cedarjs/pg/jest-teardown\"),\n * // Prefer setupFilesAfterEnv + beforeAll; setupFiles also works (memo is process-scoped).\n * setupFilesAfterEnv: [\"<rootDir>/jest.cedar-worker.cjs\"],\n *\n * // jest.cedar-worker.cjs\n * const { cloneWorkerDatabase } = require(\"@cedarjs/pg/jest/template\");\n * beforeAll(() => cloneWorkerDatabase());\n * ```\n *\n * Stock `@cedarjs/pg/jest` is one shared test DB only.\n */\nexport function createGlobalSetup(options: SetupTemplateModeOptions) {\n  return async () => {\n    await setupTemplateMode(options);\n  };\n}\n\n/** String `require.resolve` without a migrate hook is unsupported — use `createGlobalSetup`. */\nexport default async function globalSetup(): Promise<void> {\n  throw new Error(\n    \"@cedarjs/pg/jest/template requires createGlobalSetup({ migrate }). \" +\n      \"Point globalSetup at a local module that exports createGlobalSetup({ migrate }).\",\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,SAAgB,kBAAkB,SAAmC;CACnE,OAAO,YAAY;EACjB,MAAM,kBAAkB,OAAO;CACjC;AACF;;AAGA,eAA8B,cAA6B;CACzD,MAAM,IAAI,MACR,qJAEF;AACF"}

package/dist/jest.cjs

@@ -1,28 +1,25 @@
-Object.defineProperties(exports, {
-	__esModule: { value: true },
-	[Symbol.toStringTag]: { value: "Module" }
-});
-const require_lifecycle = require("./lifecycle-BGYtVXtx.cjs");
+const require_lifecycle = require("./lifecycle-BbrvFQvg.cjs");
 //#region src/adapters/jest.ts
 /**
-* Jest globalSetup. Call from jest config:
+* Jest globalSetup for a single shared test DB (`acquireIfNeeded` + dispose).
+* Not a migrate-once / per-worker TEMPLATE runner — use `@cedarjs/pg/jest/template`.
+*
 * ```js
-* globalSetup: require.resolve('@cedarjs/pg/jest')
+* globalSetup: require.resolve('@cedarjs/pg/jest'),
+* globalTeardown: require.resolve('@cedarjs/pg/jest-teardown'),
+* setupFiles: [require.resolve('@cedarjs/pg/test-env')],
 * ```
-* Pair with `teardown` from this module as globalTeardown.
+*
+* `setupFiles` is required: Jest runs globalSetup in a separate process, so
+* `DATABASE_URL` reaches workers via `.cedarpg/test.env`.
 */
 async function globalSetup() {
-	await require_lifecycle.ensureIfNeeded({
+	await require_lifecycle.acquireIfNeeded({
 		mode: "test",
 		setEnv: true
 	});
 }
-/** Lease-gated dispose; no skip re-check (env may flip mid-suite). */
-async function teardown() {
-	await require_lifecycle.dispose({ mode: "test" });
-}
 //#endregion
-exports.default = globalSetup;
-exports.teardown = teardown;
+module.exports = globalSetup;
 
 //# sourceMappingURL=jest.cjs.map

package/dist/jest.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"jest.cjs","names":["ensureIfNeeded","dispose"],"sources":["../src/adapters/jest.ts"],"sourcesContent":["import { dispose, ensureIfNeeded } from \"../core/lifecycle.ts\";\n\n/**\n * Jest globalSetup. Call from jest config:\n * ```js\n * globalSetup: require.resolve('@cedarjs/pg/jest')\n * ```\n * Pair with `teardown` from this module as globalTeardown.\n */\nexport default async function globalSetup(): Promise<void> {\n  await ensureIfNeeded({\n    mode: \"test\",\n    setEnv: true,\n  });\n}\n\n/** Lease-gated dispose; no skip re-check (env may flip mid-suite). */\nexport async function teardown(): Promise<void> {\n  await dispose({ mode: \"test\" });\n}\n"],"mappings":";;;;;;;;;;;;;AASA,eAA8B,cAA6B;CACzD,MAAMA,kBAAAA,eAAe;EACnB,MAAM;EACN,QAAQ;CACV,CAAC;AACH;;AAGA,eAAsB,WAA0B;CAC9C,MAAMC,kBAAAA,QAAQ,EAAE,MAAM,OAAO,CAAC;AAChC"}
+{"version":3,"file":"jest.cjs","names":["acquireIfNeeded"],"sources":["../src/adapters/jest.ts"],"sourcesContent":["import { acquireIfNeeded } from \"../core/lifecycle.ts\";\n\n/**\n * Jest globalSetup for a single shared test DB (`acquireIfNeeded` + dispose).\n * Not a migrate-once / per-worker TEMPLATE runner — use `@cedarjs/pg/jest/template`.\n *\n * ```js\n * globalSetup: require.resolve('@cedarjs/pg/jest'),\n * globalTeardown: require.resolve('@cedarjs/pg/jest-teardown'),\n * setupFiles: [require.resolve('@cedarjs/pg/test-env')],\n * ```\n *\n * `setupFiles` is required: Jest runs globalSetup in a separate process, so\n * `DATABASE_URL` reaches workers via `.cedarpg/test.env`.\n */\nexport default async function globalSetup(): Promise<void> {\n  await acquireIfNeeded({\n    mode: \"test\",\n    setEnv: true,\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;AAeA,eAA8B,cAA6B;CACzD,MAAMA,kBAAAA,gBAAgB;EACpB,MAAM;EACN,QAAQ;CACV,CAAC;AACH"}

package/dist/jest.d.cts

@@ -1,14 +1,17 @@
 //#region src/adapters/jest.d.ts
 /**
- * Jest globalSetup. Call from jest config:
+ * Jest globalSetup for a single shared test DB (`acquireIfNeeded` + dispose).
+ * Not a migrate-once / per-worker TEMPLATE runner — use `@cedarjs/pg/jest/template`.
+ *
  * ```js
- * globalSetup: require.resolve('@cedarjs/pg/jest')
+ * globalSetup: require.resolve('@cedarjs/pg/jest'),
+ * globalTeardown: require.resolve('@cedarjs/pg/jest-teardown'),
+ * setupFiles: [require.resolve('@cedarjs/pg/test-env')],
  * ```
- * Pair with `teardown` from this module as globalTeardown.
+ *
+ * `setupFiles` is required: Jest runs globalSetup in a separate process, so
+ * `DATABASE_URL` reaches workers via `.cedarpg/test.env`.
  */
 declare function globalSetup(): Promise<void>;
-/** Lease-gated dispose; no skip re-check (env may flip mid-suite). */
-declare function teardown(): Promise<void>;
-//#endregion
-export { globalSetup as default, teardown };
+export = globalSetup;
 //# sourceMappingURL=jest.d.cts.map

package/dist/jest.d.mts

@@ -1,14 +1,18 @@
 //#region src/adapters/jest.d.ts
 /**
- * Jest globalSetup. Call from jest config:
+ * Jest globalSetup for a single shared test DB (`acquireIfNeeded` + dispose).
+ * Not a migrate-once / per-worker TEMPLATE runner — use `@cedarjs/pg/jest/template`.
+ *
  * ```js
- * globalSetup: require.resolve('@cedarjs/pg/jest')
+ * globalSetup: require.resolve('@cedarjs/pg/jest'),
+ * globalTeardown: require.resolve('@cedarjs/pg/jest-teardown'),
+ * setupFiles: [require.resolve('@cedarjs/pg/test-env')],
  * ```
- * Pair with `teardown` from this module as globalTeardown.
+ *
+ * `setupFiles` is required: Jest runs globalSetup in a separate process, so
+ * `DATABASE_URL` reaches workers via `.cedarpg/test.env`.
  */
 declare function globalSetup(): Promise<void>;
-/** Lease-gated dispose; no skip re-check (env may flip mid-suite). */
-declare function teardown(): Promise<void>;
 //#endregion
-export { globalSetup as default, teardown };
+export { globalSetup as default };
 //# sourceMappingURL=jest.d.mts.map

package/dist/jest.mjs

@@ -1,23 +1,25 @@
-import { r as ensureIfNeeded, t as dispose } from "./lifecycle-CT_8AWPv.mjs";
+import { n as acquireIfNeeded } from "./lifecycle-BvIx0xqq.mjs";
 //#region src/adapters/jest.ts
 /**
-* Jest globalSetup. Call from jest config:
+* Jest globalSetup for a single shared test DB (`acquireIfNeeded` + dispose).
+* Not a migrate-once / per-worker TEMPLATE runner — use `@cedarjs/pg/jest/template`.
+*
 * ```js
-* globalSetup: require.resolve('@cedarjs/pg/jest')
+* globalSetup: require.resolve('@cedarjs/pg/jest'),
+* globalTeardown: require.resolve('@cedarjs/pg/jest-teardown'),
+* setupFiles: [require.resolve('@cedarjs/pg/test-env')],
 * ```
-* Pair with `teardown` from this module as globalTeardown.
+*
+* `setupFiles` is required: Jest runs globalSetup in a separate process, so
+* `DATABASE_URL` reaches workers via `.cedarpg/test.env`.
 */
 async function globalSetup() {
-	await ensureIfNeeded({
+	await acquireIfNeeded({
 		mode: "test",
 		setEnv: true
 	});
 }
-/** Lease-gated dispose; no skip re-check (env may flip mid-suite). */
-async function teardown() {
-	await dispose({ mode: "test" });
-}
 //#endregion
-export { globalSetup as default, teardown };
+export { globalSetup as default };
 
 //# sourceMappingURL=jest.mjs.map

package/dist/jest.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"jest.mjs","names":[],"sources":["../src/adapters/jest.ts"],"sourcesContent":["import { dispose, ensureIfNeeded } from \"../core/lifecycle.ts\";\n\n/**\n * Jest globalSetup. Call from jest config:\n * ```js\n * globalSetup: require.resolve('@cedarjs/pg/jest')\n * ```\n * Pair with `teardown` from this module as globalTeardown.\n */\nexport default async function globalSetup(): Promise<void> {\n  await ensureIfNeeded({\n    mode: \"test\",\n    setEnv: true,\n  });\n}\n\n/** Lease-gated dispose; no skip re-check (env may flip mid-suite). */\nexport async function teardown(): Promise<void> {\n  await dispose({ mode: \"test\" });\n}\n"],"mappings":";;;;;;;;;AASA,eAA8B,cAA6B;CACzD,MAAM,eAAe;EACnB,MAAM;EACN,QAAQ;CACV,CAAC;AACH;;AAGA,eAAsB,WAA0B;CAC9C,MAAM,QAAQ,EAAE,MAAM,OAAO,CAAC;AAChC"}
+{"version":3,"file":"jest.mjs","names":[],"sources":["../src/adapters/jest.ts"],"sourcesContent":["import { acquireIfNeeded } from \"../core/lifecycle.ts\";\n\n/**\n * Jest globalSetup for a single shared test DB (`acquireIfNeeded` + dispose).\n * Not a migrate-once / per-worker TEMPLATE runner — use `@cedarjs/pg/jest/template`.\n *\n * ```js\n * globalSetup: require.resolve('@cedarjs/pg/jest'),\n * globalTeardown: require.resolve('@cedarjs/pg/jest-teardown'),\n * setupFiles: [require.resolve('@cedarjs/pg/test-env')],\n * ```\n *\n * `setupFiles` is required: Jest runs globalSetup in a separate process, so\n * `DATABASE_URL` reaches workers via `.cedarpg/test.env`.\n */\nexport default async function globalSetup(): Promise<void> {\n  await acquireIfNeeded({\n    mode: \"test\",\n    setEnv: true,\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;AAeA,eAA8B,cAA6B;CACzD,MAAM,gBAAgB;EACpB,MAAM;EACN,QAAQ;CACV,CAAC;AACH"}

package/dist/lease-B3TuX92y.d.mts

@@ -0,0 +1,24 @@
+import { t as DbMode } from "./naming-C2nGVxPk.mjs";
+//#region src/core/lease.d.ts
+type Lease = {
+  schemaVersion: 1;
+  mode: DbMode;
+  root: string;
+  repoSlug: string;
+  worktreeSlug: string;
+  pathHash: string;
+  databaseName: string;
+  roleName: string;
+  port: number;
+  pid: number;
+  createdAt: string;
+};
+/** Narrow-parse a lease; reject incomplete or wrong-version records. */
+declare function parseLease(raw: unknown): Lease | null;
+/** Absolute `.cedarpg/<mode>.env` path (resolves root when omitted). */
+declare function envFilePath(root: string | undefined, mode: DbMode): string;
+declare function readLease(root: string, mode: DbMode): Lease | null;
+declare function isOrphanLease(lease: Lease): boolean;
+//#endregion
+export { readLease as a, parseLease as i, envFilePath as n, isOrphanLease as r, Lease as t };
+//# sourceMappingURL=lease-B3TuX92y.d.mts.map

package/dist/lease-DS1SX8U_.mjs

@@ -0,0 +1,221 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, dirname, join, resolve } from "node:path";
+import { createHash } from "node:crypto";
+import { execFileSync } from "node:child_process";
+//#region src/core/constants.ts
+/**
+* Product identity vs frozen crypto.
+*
+* State dirs follow the CLI name (`.cedarpg`): product-owned, not nested under
+* autopg's `~/.autopg/` (host owns that) and not a generic `.pg` (collision-prone).
+* Password salt is an opaque crypto constant; bump ROLE_PASSWORD_SCHEME to change it.
+*/
+/** User-facing CLI binary (`package.json` bin) and log prefix */
+const CLI_NAME = "cedarpg";
+/**
+* Worktree-local state dir and home-registry parent (`~/.cedarpg/registry`).
+* Frozen for lease/gc discovery after first alpha consumers appear.
+*/
+const STATE_DIRNAME = ".cedarpg";
+/**
+* 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
+//#region src/core/worktree.ts
+function git(args, cwd) {
+	try {
+		return execFileSync("git", args, {
+			cwd,
+			encoding: "utf8",
+			stdio: [
+				"ignore",
+				"pipe",
+				"ignore"
+			]
+		}).trim();
+	} catch {
+		return null;
+	}
+}
+function sanitizeSlug(input) {
+	return input.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/_+/g, "_").replace(/^_|_$/g, "");
+}
+/**
+* Resolve the project / worktree root.
+* Explicit `root` wins (app project path). Otherwise prefer git toplevel, then cwd.
+*/
+function resolveRoot(root) {
+	if (root) return resolve(root);
+	const start = resolve(process.cwd());
+	const toplevel = git(["rev-parse", "--show-toplevel"], start);
+	if (toplevel) return toplevel;
+	return start;
+}
+/**
+* Identify repo + worktree for observable DB naming.
+*/
+function resolveWorktreeIdentity(root) {
+	const absRoot = resolveRoot(root);
+	const pathHash = createHash("sha256").update(absRoot).digest("hex").slice(0, 8);
+	const commonDir = git(["rev-parse", "--git-common-dir"], absRoot);
+	let repoSlug = sanitizeSlug(basename(absRoot));
+	if (commonDir) {
+		const commonAbs = resolve(absRoot, commonDir);
+		const mainRoot = basename(commonAbs) === ".git" ? dirname(commonAbs) : commonAbs;
+		const fromGit = sanitizeSlug(basename(basename(mainRoot) === ".git" ? dirname(mainRoot) : mainRoot));
+		if (fromGit) repoSlug = fromGit;
+	}
+	let worktreeSlug = sanitizeSlug(basename(absRoot));
+	const gitFile = resolve(absRoot, ".git");
+	if (existsSync(gitFile)) try {
+		const match = readFileSync(gitFile, "utf8").trim().match(/gitdir:\s*(.+)$/m);
+		if (match?.[1]) {
+			const parts = resolve(absRoot, match[1].trim()).split(/[/\\]/);
+			const wtIdx = parts.lastIndexOf("worktrees");
+			if (wtIdx >= 0 && parts[wtIdx + 1]) {
+				const fromWt = sanitizeSlug(parts[wtIdx + 1]);
+				if (fromWt) worktreeSlug = fromWt;
+			}
+		}
+	} catch {}
+	if (!repoSlug) repoSlug = "repo";
+	if (!worktreeSlug) worktreeSlug = "wt";
+	return {
+		root: absRoot,
+		repoSlug,
+		worktreeSlug,
+		pathHash
+	};
+}
+//#endregion
+//#region src/core/lease.ts
+function isDbMode(value) {
+	return value === "dev" || value === "test";
+}
+function isNonEmptyString(value) {
+	return typeof value === "string" && value.length > 0;
+}
+/** Narrow-parse a lease; reject incomplete or wrong-version records. */
+function parseLease(raw) {
+	if (!raw || typeof raw !== "object") return null;
+	const o = raw;
+	if (o.schemaVersion !== 1) return null;
+	if (!isDbMode(o.mode)) return null;
+	if (!isNonEmptyString(o.root)) return null;
+	if (!isNonEmptyString(o.repoSlug)) return null;
+	if (!isNonEmptyString(o.worktreeSlug)) return null;
+	if (!isNonEmptyString(o.pathHash)) return null;
+	if (!isNonEmptyString(o.databaseName)) return null;
+	if (!isNonEmptyString(o.roleName)) return null;
+	if (typeof o.port !== "number") return null;
+	if (typeof o.pid !== "number") return null;
+	if (!isNonEmptyString(o.createdAt)) return null;
+	return {
+		schemaVersion: 1,
+		mode: o.mode,
+		root: o.root,
+		repoSlug: o.repoSlug,
+		worktreeSlug: o.worktreeSlug,
+		pathHash: o.pathHash,
+		databaseName: o.databaseName,
+		roleName: o.roleName,
+		port: o.port,
+		pid: o.pid,
+		createdAt: o.createdAt
+	};
+}
+function leaseDir(root) {
+	return join(root, STATE_DIRNAME);
+}
+function leasePath(root, mode) {
+	return join(leaseDir(root), `${mode}.json`);
+}
+function envPath(root, mode) {
+	return join(leaseDir(root), `${mode}.env`);
+}
+/** Absolute `.cedarpg/<mode>.env` path (resolves root when omitted). */
+function envFilePath(root, mode) {
+	return envPath(resolveRoot(root), mode);
+}
+/** Best-effort delete worktree lease JSON + mode env (missing is fine). */
+function unlinkWorktreeArtifacts(root, mode) {
+	for (const file of [leasePath(root, mode), envPath(root, mode)]) try {
+		unlinkSync(file);
+	} catch {}
+}
+/** Durable registry outside worktrees so GC can find orphans after a checkout is deleted. */
+function registryDir() {
+	return process.env.CEDAR_PG_REGISTRY_DIR || join(homedir(), ".cedarpg", "registry");
+}
+function registryPath(databaseName) {
+	return join(registryDir(), `${databaseName}.json`);
+}
+function writeJsonAtomic(file, value) {
+	mkdirSync(dirname(file), {
+		recursive: true,
+		mode: 448
+	});
+	const tmp = `${file}.tmp.${process.pid}`;
+	writeFileSync(tmp, `${JSON.stringify(value, null, 2)}\n`, { mode: 384 });
+	renameSync(tmp, file);
+}
+function registerLease(lease) {
+	writeJsonAtomic(registryPath(lease.databaseName), lease);
+}
+function unregisterLease(databaseName) {
+	try {
+		unlinkSync(registryPath(databaseName));
+	} catch {}
+}
+function readLease(root, mode) {
+	const file = leasePath(root, mode);
+	if (!existsSync(file)) return null;
+	try {
+		return parseLease(JSON.parse(readFileSync(file, "utf8")));
+	} catch {
+		return null;
+	}
+}
+/**
+* Persist lease. Registry is written first (GC source of truth), then the worktree cache.
+*/
+function writeLease(lease) {
+	registerLease(lease);
+	mkdirSync(leaseDir(lease.root), {
+		recursive: true,
+		mode: 448
+	});
+	writeJsonAtomic(leasePath(lease.root, lease.mode), lease);
+}
+/**
+* Remove registry entry by databaseName and best-effort delete worktree lease + env.
+* Call only after a successful DROP (or when intentionally abandoning tracking).
+*/
+function forgetLease(lease) {
+	unregisterLease(lease.databaseName);
+	unlinkWorktreeArtifacts(lease.root, lease.mode);
+}
+/** All registry entries (used by gc). */
+function listRegistryLeases() {
+	const dir = registryDir();
+	if (!existsSync(dir)) return [];
+	const out = [];
+	for (const name of readdirSync(dir)) {
+		if (!name.endsWith(".json")) continue;
+		try {
+			const lease = parseLease(JSON.parse(readFileSync(join(dir, name), "utf8")));
+			if (lease) out.push(lease);
+		} catch {}
+	}
+	return out;
+}
+function isOrphanLease(lease) {
+	return !existsSync(lease.root);
+}
+//#endregion
+export { leaseDir as a, parseLease as c, resolveRoot as d, resolveWorktreeIdentity as f, STATE_DIRNAME as h, isOrphanLease as i, readLease as l, PASSWORD_SALT_PREFIX as m, envPath as n, leasePath as o, CLI_NAME as p, forgetLease as r, listRegistryLeases as s, envFilePath as t, writeLease as u };
+
+//# sourceMappingURL=lease-DS1SX8U_.mjs.map

package/dist/lease-DS1SX8U_.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"lease-DS1SX8U_.mjs","names":[],"sources":["../src/core/constants.ts","../src/core/worktree.ts","../src/core/lease.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","import { createHash } from \"node:crypto\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { basename, dirname, resolve } from \"node:path\";\nimport { execFileSync } from \"node:child_process\";\n\nexport type WorktreeIdentity = {\n  /** Absolute path to the worktree / project root. */\n  root: string;\n  /** Basename of the git common dir / main checkout (e.g. `cedar`). */\n  repoSlug: string;\n  /** Basename of this worktree directory (e.g. `feat-auth`). */\n  worktreeSlug: string;\n  /** First 8 hex chars of sha256(absolute root). */\n  pathHash: string;\n};\n\nfunction git(args: string[], cwd: string): string | null {\n  try {\n    return execFileSync(\"git\", args, {\n      cwd,\n      encoding: \"utf8\",\n      stdio: [\"ignore\", \"pipe\", \"ignore\"],\n    }).trim();\n  } catch {\n    return null;\n  }\n}\n\nfunction sanitizeSlug(input: string): string {\n  return input\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"_\")\n    .replace(/_+/g, \"_\")\n    .replace(/^_|_$/g, \"\");\n}\n\n/**\n * Resolve the project / worktree root.\n * Explicit `root` wins (app project path). Otherwise prefer git toplevel, then cwd.\n */\nexport function resolveRoot(root?: string): string {\n  if (root) return resolve(root);\n  const start = resolve(process.cwd());\n  const toplevel = git([\"rev-parse\", \"--show-toplevel\"], start);\n  if (toplevel) return toplevel;\n  return start;\n}\n\n/**\n * Identify repo + worktree for observable DB naming.\n */\nexport function resolveWorktreeIdentity(root?: string): WorktreeIdentity {\n  const absRoot = resolveRoot(root);\n  const pathHash = createHash(\"sha256\").update(absRoot).digest(\"hex\").slice(0, 8);\n\n  const commonDir = git([\"rev-parse\", \"--git-common-dir\"], absRoot);\n  let repoSlug = sanitizeSlug(basename(absRoot));\n  if (commonDir) {\n    // common-dir is often `<main>/.git` or an absolute path to the main .git\n    const commonAbs = resolve(absRoot, commonDir);\n    // If commonAbs ends with `.git`, parent is main worktree root\n    const mainRoot = basename(commonAbs) === \".git\" ? dirname(commonAbs) : commonAbs;\n    // For linked worktrees, common-dir may be `.../main/.git`\n    const candidate = basename(mainRoot) === \".git\" ? dirname(mainRoot) : mainRoot;\n    const fromGit = sanitizeSlug(basename(candidate));\n    if (fromGit) repoSlug = fromGit;\n  }\n\n  // Prefer gitdir worktree name when present (`.git` file pointing at worktrees/<name>)\n  let worktreeSlug = sanitizeSlug(basename(absRoot));\n  const gitFile = resolve(absRoot, \".git\");\n  if (existsSync(gitFile)) {\n    try {\n      const content = readFileSync(gitFile, \"utf8\").trim();\n      const match = content.match(/gitdir:\\s*(.+)$/m);\n      if (match?.[1]) {\n        const gitdir = resolve(absRoot, match[1].trim());\n        // .../.git/worktrees/<name>\n        const parts = gitdir.split(/[/\\\\]/);\n        const wtIdx = parts.lastIndexOf(\"worktrees\");\n        if (wtIdx >= 0 && parts[wtIdx + 1]) {\n          const fromWt = sanitizeSlug(parts[wtIdx + 1]!);\n          if (fromWt) worktreeSlug = fromWt;\n        }\n      }\n    } catch {\n      // keep basename slug\n    }\n  }\n\n  if (!repoSlug) repoSlug = \"repo\";\n  if (!worktreeSlug) worktreeSlug = \"wt\";\n\n  return { root: absRoot, repoSlug, worktreeSlug, pathHash };\n}\n","import {\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  renameSync,\n  unlinkSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { dirname, join } from \"node:path\";\nimport { STATE_DIRNAME } from \"./constants.ts\";\nimport type { DbMode } from \"./naming.ts\";\nimport { resolveRoot } from \"./worktree.ts\";\n\nexport type Lease = {\n  schemaVersion: 1;\n  mode: DbMode;\n  root: string;\n  repoSlug: string;\n  worktreeSlug: string;\n  pathHash: string;\n  databaseName: string;\n  roleName: string;\n  port: number;\n  pid: number;\n  createdAt: string;\n};\n\nfunction isDbMode(value: unknown): value is DbMode {\n  return value === \"dev\" || value === \"test\";\n}\n\nfunction isNonEmptyString(value: unknown): value is string {\n  return typeof value === \"string\" && value.length > 0;\n}\n\n/** Narrow-parse a lease; reject incomplete or wrong-version records. */\nexport function parseLease(raw: unknown): Lease | null {\n  if (!raw || typeof raw !== \"object\") return null;\n  const o = raw as Record<string, unknown>;\n  if (o.schemaVersion !== 1) return null;\n  if (!isDbMode(o.mode)) return null;\n  if (!isNonEmptyString(o.root)) return null;\n  if (!isNonEmptyString(o.repoSlug)) return null;\n  if (!isNonEmptyString(o.worktreeSlug)) return null;\n  if (!isNonEmptyString(o.pathHash)) return null;\n  if (!isNonEmptyString(o.databaseName)) return null;\n  if (!isNonEmptyString(o.roleName)) return null;\n  if (typeof o.port !== \"number\") return null;\n  if (typeof o.pid !== \"number\") return null;\n  if (!isNonEmptyString(o.createdAt)) return null;\n  return {\n    schemaVersion: 1,\n    mode: o.mode,\n    root: o.root,\n    repoSlug: o.repoSlug,\n    worktreeSlug: o.worktreeSlug,\n    pathHash: o.pathHash,\n    databaseName: o.databaseName,\n    roleName: o.roleName,\n    port: o.port,\n    pid: o.pid,\n    createdAt: o.createdAt,\n  };\n}\n\nexport function leaseDir(root: string): string {\n  return join(root, STATE_DIRNAME);\n}\n\nexport function leasePath(root: string, mode: DbMode): string {\n  return join(leaseDir(root), `${mode}.json`);\n}\n\nexport function envPath(root: string, mode: DbMode): string {\n  return join(leaseDir(root), `${mode}.env`);\n}\n\n/** Absolute `.cedarpg/<mode>.env` path (resolves root when omitted). */\nexport function envFilePath(root: string | undefined, mode: DbMode): string {\n  return envPath(resolveRoot(root), mode);\n}\n\n/** Best-effort delete worktree lease JSON + mode env (missing is fine). */\nfunction unlinkWorktreeArtifacts(root: string, mode: DbMode): void {\n  for (const file of [leasePath(root, mode), envPath(root, mode)]) {\n    try {\n      unlinkSync(file);\n    } catch {\n      // root or file may already be gone\n    }\n  }\n}\n\n/** Durable registry outside worktrees so GC can find orphans after a checkout is deleted. */\nexport function registryDir(): string {\n  return process.env.CEDAR_PG_REGISTRY_DIR || join(homedir(), STATE_DIRNAME, \"registry\");\n}\n\nfunction registryPath(databaseName: string): string {\n  return join(registryDir(), `${databaseName}.json`);\n}\n\nfunction writeJsonAtomic(file: string, value: unknown): void {\n  mkdirSync(dirname(file), { recursive: true, mode: 0o700 });\n  const tmp = `${file}.tmp.${process.pid}`;\n  writeFileSync(tmp, `${JSON.stringify(value, null, 2)}\\n`, { mode: 0o600 });\n  renameSync(tmp, file);\n}\n\nfunction registerLease(lease: Lease): void {\n  writeJsonAtomic(registryPath(lease.databaseName), lease);\n}\n\nfunction unregisterLease(databaseName: string): void {\n  try {\n    unlinkSync(registryPath(databaseName));\n  } catch {\n    // missing is fine\n  }\n}\n\nfunction peekDatabaseName(root: string, mode: DbMode): string | undefined {\n  const file = leasePath(root, mode);\n  if (!existsSync(file)) return undefined;\n  try {\n    const raw = JSON.parse(readFileSync(file, \"utf8\")) as { databaseName?: unknown };\n    return typeof raw.databaseName === \"string\" && raw.databaseName ? raw.databaseName : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function readLease(root: string, mode: DbMode): Lease | null {\n  const file = leasePath(root, mode);\n  if (!existsSync(file)) return null;\n  try {\n    return parseLease(JSON.parse(readFileSync(file, \"utf8\")));\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Persist lease. Registry is written first (GC source of truth), then the worktree cache.\n */\nexport function writeLease(lease: Lease): void {\n  registerLease(lease);\n  const dir = leaseDir(lease.root);\n  mkdirSync(dir, { recursive: true, mode: 0o700 });\n  writeJsonAtomic(leasePath(lease.root, lease.mode), lease);\n}\n\n/**\n * Remove registry entry by databaseName and best-effort delete worktree lease + env.\n * Call only after a successful DROP (or when intentionally abandoning tracking).\n */\nexport function forgetLease(lease: Pick<Lease, \"root\" | \"mode\" | \"databaseName\">): void {\n  unregisterLease(lease.databaseName);\n  unlinkWorktreeArtifacts(lease.root, lease.mode);\n}\n\n/**\n * Clear worktree lease + env + registry. Unregisters by databaseName even when the local\n * file fails full parse (peeks databaseName from raw JSON).\n */\nexport function clearLease(root: string, mode: DbMode): void {\n  const existing = readLease(root, mode);\n  if (existing) {\n    forgetLease(existing);\n    return;\n  }\n  const databaseName = peekDatabaseName(root, mode);\n  unlinkWorktreeArtifacts(root, mode);\n  if (databaseName) {\n    unregisterLease(databaseName);\n  }\n}\n\n/** All registry entries (used by gc). */\nexport function listRegistryLeases(): Lease[] {\n  const dir = registryDir();\n  if (!existsSync(dir)) return [];\n  const out: Lease[] = [];\n  for (const name of readdirSync(dir)) {\n    if (!name.endsWith(\".json\")) continue;\n    try {\n      const lease = parseLease(JSON.parse(readFileSync(join(dir, name), \"utf8\")));\n      if (lease) out.push(lease);\n    } catch {\n      // skip corrupt\n    }\n  }\n  return out;\n}\n\nexport function isOrphanLease(lease: Lease): boolean {\n  return !existsSync(lease.root);\n}\n"],"mappings":"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"}