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

package/dist/lease-Bq9wKwQa.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"lease-Bq9wKwQa.cjs","names":["STATE_DIRNAME"],"sources":["../src/core/worktree.ts","../src/core/lease.ts"],"sourcesContent":["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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"}

package/dist/lease-t4I9JahV.d.cts

@@ -0,0 +1,24 @@
+import { t as DbMode } from "./naming-C2nGVxPk.cjs";
+//#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-t4I9JahV.d.cts.map