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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (129) hide show
  1. package/README.md +361 -89
  2. package/dist/cli.cjs +131 -35
  3. package/dist/cli.cjs.map +1 -1
  4. package/dist/cli.mjs +118 -22
  5. package/dist/cli.mjs.map +1 -1
  6. package/dist/dev-env.cjs +12 -0
  7. package/dist/dev-env.cjs.map +1 -0
  8. package/dist/dev-env.d.cts +1 -0
  9. package/dist/dev-env.d.mts +1 -0
  10. package/dist/dev-env.mjs +14 -0
  11. package/dist/dev-env.mjs.map +1 -0
  12. package/dist/index.cjs +51 -10
  13. package/dist/index.cjs.map +1 -0
  14. package/dist/index.d.cts +198 -84
  15. package/dist/index.d.mts +198 -84
  16. package/dist/index.mjs +32 -2
  17. package/dist/index.mjs.map +1 -0
  18. package/dist/jest-teardown.cjs +18 -0
  19. package/dist/jest-teardown.cjs.map +1 -0
  20. package/dist/jest-teardown.d.cts +13 -0
  21. package/dist/jest-teardown.d.mts +14 -0
  22. package/dist/jest-teardown.mjs +18 -0
  23. package/dist/jest-teardown.mjs.map +1 -0
  24. package/dist/jest-template.cjs +44 -0
  25. package/dist/jest-template.cjs.map +1 -0
  26. package/dist/jest-template.d.cts +31 -0
  27. package/dist/jest-template.d.mts +31 -0
  28. package/dist/jest-template.mjs +38 -0
  29. package/dist/jest-template.mjs.map +1 -0
  30. package/dist/jest.cjs +12 -15
  31. package/dist/jest.cjs.map +1 -1
  32. package/dist/jest.d.cts +10 -7
  33. package/dist/jest.d.mts +10 -6
  34. package/dist/jest.mjs +12 -10
  35. package/dist/jest.mjs.map +1 -1
  36. package/dist/lease-B3TuX92y.d.mts +24 -0
  37. package/dist/lease-DS1SX8U_.mjs +221 -0
  38. package/dist/lease-DS1SX8U_.mjs.map +1 -0
  39. package/dist/lease-WlmOnNDi.cjs +310 -0
  40. package/dist/lease-WlmOnNDi.cjs.map +1 -0
  41. package/dist/lease-t4I9JahV.d.cts +24 -0
  42. package/dist/lifecycle-BbrvFQvg.cjs +953 -0
  43. package/dist/lifecycle-BbrvFQvg.cjs.map +1 -0
  44. package/dist/lifecycle-BvIx0xqq.mjs +781 -0
  45. package/dist/lifecycle-BvIx0xqq.mjs.map +1 -0
  46. package/dist/load-dev-env-BULkXyen.mjs +10 -0
  47. package/dist/load-dev-env-BULkXyen.mjs.map +1 -0
  48. package/dist/load-dev-env-Bl6Ddv1U.cjs +15 -0
  49. package/dist/load-dev-env-Bl6Ddv1U.cjs.map +1 -0
  50. package/dist/load-mode-env-CX9vd56X.cjs +39 -0
  51. package/dist/load-mode-env-CX9vd56X.cjs.map +1 -0
  52. package/dist/load-mode-env-Ce9ujisN.mjs +28 -0
  53. package/dist/load-mode-env-Ce9ujisN.mjs.map +1 -0
  54. package/dist/load-test-env-BqtA6V-d.mjs +18 -0
  55. package/dist/load-test-env-BqtA6V-d.mjs.map +1 -0
  56. package/dist/load-test-env-Dcgh6YHV.cjs +23 -0
  57. package/dist/load-test-env-Dcgh6YHV.cjs.map +1 -0
  58. package/dist/naming-C2nGVxPk.d.cts +39 -0
  59. package/dist/naming-C2nGVxPk.d.mts +39 -0
  60. package/dist/nx.cjs +25 -18
  61. package/dist/nx.cjs.map +1 -1
  62. package/dist/nx.d.cts +9 -20
  63. package/dist/nx.d.mts +9 -20
  64. package/dist/nx.mjs +18 -18
  65. package/dist/nx.mjs.map +1 -1
  66. package/dist/status-4Uz6A3LB.cjs +31 -0
  67. package/dist/status-4Uz6A3LB.cjs.map +1 -0
  68. package/dist/status-Dcnpgnlz.mjs +26 -0
  69. package/dist/status-Dcnpgnlz.mjs.map +1 -0
  70. package/dist/studio-DIFw1qWC.mjs +173 -0
  71. package/dist/studio-DIFw1qWC.mjs.map +1 -0
  72. package/dist/studio-oJE30_PO.cjs +208 -0
  73. package/dist/studio-oJE30_PO.cjs.map +1 -0
  74. package/dist/tasks-CNHvvlsN.cjs +67 -0
  75. package/dist/tasks-CNHvvlsN.cjs.map +1 -0
  76. package/dist/tasks-CjaZRi_G.d.mts +19 -0
  77. package/dist/tasks-D5iWIdlo.mjs +38 -0
  78. package/dist/tasks-D5iWIdlo.mjs.map +1 -0
  79. package/dist/tasks-DdQoP9We.d.cts +19 -0
  80. package/dist/template-BiJ-0TIF.mjs +88 -0
  81. package/dist/template-BiJ-0TIF.mjs.map +1 -0
  82. package/dist/template-CXMpODzK.cjs +105 -0
  83. package/dist/template-CXMpODzK.cjs.map +1 -0
  84. package/dist/template-mode-BTUsdBtA.mjs +94 -0
  85. package/dist/template-mode-BTUsdBtA.mjs.map +1 -0
  86. package/dist/template-mode-CzyVwHsi.d.cts +31 -0
  87. package/dist/template-mode-CzyVwHsi.d.mts +31 -0
  88. package/dist/template-mode-JTOxrEgE.cjs +105 -0
  89. package/dist/template-mode-JTOxrEgE.cjs.map +1 -0
  90. package/dist/test-env.cjs +16 -0
  91. package/dist/test-env.cjs.map +1 -0
  92. package/dist/test-env.d.cts +1 -0
  93. package/dist/test-env.d.mts +1 -0
  94. package/dist/test-env.mjs +18 -0
  95. package/dist/test-env.mjs.map +1 -0
  96. package/dist/vite-plus.cjs +113 -35
  97. package/dist/vite-plus.cjs.map +1 -1
  98. package/dist/vite-plus.d.cts +26 -46
  99. package/dist/vite-plus.d.mts +26 -46
  100. package/dist/vite-plus.mjs +110 -32
  101. package/dist/vite-plus.mjs.map +1 -1
  102. package/dist/vitest-template.cjs +48 -0
  103. package/dist/vitest-template.cjs.map +1 -0
  104. package/dist/vitest-template.d.cts +31 -0
  105. package/dist/vitest-template.d.mts +31 -0
  106. package/dist/vitest-template.mjs +42 -0
  107. package/dist/vitest-template.mjs.map +1 -0
  108. package/dist/vitest.cjs +10 -10
  109. package/dist/vitest.cjs.map +1 -1
  110. package/dist/vitest.d.cts +7 -3
  111. package/dist/vitest.d.mts +7 -2
  112. package/dist/vitest.mjs +10 -5
  113. package/dist/vitest.mjs.map +1 -1
  114. package/package.json +46 -13
  115. package/scripts/autopg-version +1 -0
  116. package/scripts/ci-install-autopg.sh +73 -0
  117. package/scripts/postinstall.js +35 -9
  118. package/dist/constants-BY97wXjA.mjs +0 -24
  119. package/dist/constants-BY97wXjA.mjs.map +0 -1
  120. package/dist/constants-CNZn5Xro.cjs +0 -41
  121. package/dist/constants-CNZn5Xro.cjs.map +0 -1
  122. package/dist/lifecycle-BGYtVXtx.cjs +0 -743
  123. package/dist/lifecycle-BGYtVXtx.cjs.map +0 -1
  124. package/dist/lifecycle-CT_8AWPv.mjs +0 -577
  125. package/dist/lifecycle-CT_8AWPv.mjs.map +0 -1
  126. package/dist/tasks-13P6tMth.mjs +0 -16
  127. package/dist/tasks-13P6tMth.mjs.map +0 -1
  128. package/dist/tasks-B8ryV9xo.cjs +0 -21
  129. package/dist/tasks-B8ryV9xo.cjs.map +0 -1
@@ -0,0 +1,88 @@
1
+ import { C as buildCloneDatabaseName, S as runIfNeeded, _ as setDatabaseIsTemplate, f as dropDatabase, l as buildDatabaseUrl, o as ensureHostRunning, u as cloneDatabaseFromTemplate, v as applyDatabaseUrlEnv } from "./lifecycle-BvIx0xqq.mjs";
2
+ import { f as resolveWorktreeIdentity, l as readLease } from "./lease-DS1SX8U_.mjs";
3
+ //#region src/core/template.ts
4
+ async function resolveAdminUrl(adminUrl) {
5
+ return adminUrl ?? (await ensureHostRunning()).adminUrl;
6
+ }
7
+ /**
8
+ * After migrations, mark the leased DB as a PostgreSQL TEMPLATE so workers can clone it.
9
+ * Requires a lease from `acquire` (no datname override).
10
+ */
11
+ async function markTemplate(options) {
12
+ const identity = resolveWorktreeIdentity(options.root);
13
+ const mode = options.mode;
14
+ const lease = readLease(identity.root, mode);
15
+ if (!lease) throw new Error(`no ${mode} lease; run acquire before markTemplate`);
16
+ const adminUrl = await resolveAdminUrl(options.adminUrl);
17
+ await setDatabaseIsTemplate({
18
+ adminUrl,
19
+ databaseName: lease.databaseName,
20
+ isTemplate: true
21
+ });
22
+ return {
23
+ databaseName: lease.databaseName,
24
+ adminUrl
25
+ };
26
+ }
27
+ /**
28
+ * Clone the leased TEMPLATE database via admin (`CREATE DATABASE … TEMPLATE`).
29
+ * Reuses the template role so `databaseUrl` passwords stay valid (scheme v2).
30
+ * Provider rejects when the leased DB is not marked TEMPLATE.
31
+ * Port comes from the lease; admin URL is passed through or rediscovered.
32
+ */
33
+ async function cloneFromTemplate(options) {
34
+ const identity = resolveWorktreeIdentity(options.root);
35
+ const mode = options.mode;
36
+ const lease = readLease(identity.root, mode);
37
+ if (!lease) throw new Error(`no ${mode} lease; run acquire + markTemplate before cloneFromTemplate`);
38
+ const adminUrl = await resolveAdminUrl(options.adminUrl);
39
+ const suffix = options.name ?? `${process.pid}_${Date.now().toString(36)}`;
40
+ const databaseName = buildCloneDatabaseName(lease.databaseName, suffix);
41
+ await cloneDatabaseFromTemplate({
42
+ adminUrl,
43
+ templateName: lease.databaseName,
44
+ databaseName,
45
+ roleName: lease.roleName
46
+ });
47
+ const databaseUrl = buildDatabaseUrl({
48
+ port: lease.port,
49
+ databaseName,
50
+ roleName: lease.roleName
51
+ });
52
+ if (options.setEnv) applyDatabaseUrlEnv(databaseUrl, { mode });
53
+ const roleName = lease.roleName;
54
+ return {
55
+ databaseUrl,
56
+ adminUrl,
57
+ databaseName,
58
+ roleName,
59
+ templateName: lease.databaseName,
60
+ port: lease.port,
61
+ dropClone: async () => {
62
+ await dropDatabase({
63
+ adminUrl,
64
+ databaseName,
65
+ roleName
66
+ });
67
+ }
68
+ };
69
+ }
70
+ /**
71
+ * Resolve skip policy then clone. Host entry for worker adapters (same skip
72
+ * semantics as `acquireIfNeeded`). Defaults `setEnv` on for skip and clone paths.
73
+ */
74
+ async function cloneFromTemplateIfNeeded(options) {
75
+ const outcome = await runIfNeeded(options, () => cloneFromTemplate({
76
+ ...options,
77
+ setEnv: options.setEnv !== false
78
+ }));
79
+ if (outcome.status === "skipped") return outcome;
80
+ return {
81
+ status: "cloned",
82
+ ...outcome.value
83
+ };
84
+ }
85
+ //#endregion
86
+ export { cloneFromTemplateIfNeeded as n, markTemplate as r, cloneFromTemplate as t };
87
+
88
+ //# sourceMappingURL=template-BiJ-0TIF.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"template-BiJ-0TIF.mjs","names":[],"sources":["../src/core/template.ts"],"sourcesContent":["import { buildCloneDatabaseName, type DbMode } from \"./naming.ts\";\nimport { readLease } from \"./lease.ts\";\nimport { applyDatabaseUrlEnv, runIfNeeded, type ResolveAcquireSkipInput } from \"./policy.ts\";\nimport { resolveWorktreeIdentity } from \"./worktree.ts\";\nimport {\n buildDatabaseUrl,\n cloneDatabaseFromTemplate,\n dropDatabase,\n setDatabaseIsTemplate,\n} from \"../providers/autopg.ts\";\nimport { ensureHostRunning } from \"../providers/host.ts\";\n\nasync function resolveAdminUrl(adminUrl?: string): Promise<string> {\n return adminUrl ?? (await ensureHostRunning()).adminUrl;\n}\n\nexport type MarkTemplateOptions = {\n root?: string;\n mode: DbMode;\n /** Superuser URL from `acquire`; when omitted, discovers/starts the host. */\n adminUrl?: string;\n};\n\n/**\n * After migrations, mark the leased DB as a PostgreSQL TEMPLATE so workers can clone it.\n * Requires a lease from `acquire` (no datname override).\n */\nexport async function markTemplate(\n options: MarkTemplateOptions,\n): Promise<{ databaseName: string; adminUrl: string }> {\n const identity = resolveWorktreeIdentity(options.root);\n const mode = options.mode;\n const lease = readLease(identity.root, mode);\n if (!lease) {\n throw new Error(`no ${mode} lease; run acquire before markTemplate`);\n }\n const adminUrl = await resolveAdminUrl(options.adminUrl);\n await setDatabaseIsTemplate({\n adminUrl,\n databaseName: lease.databaseName,\n isTemplate: true,\n });\n return { databaseName: lease.databaseName, adminUrl };\n}\n\nexport type CloneFromTemplateOptions = {\n root?: string;\n mode: DbMode;\n /** Superuser URL from `acquire`; when omitted, discovers/starts the host. */\n adminUrl?: string;\n /**\n * Suffix for the clone datname (e.g. Jest worker id).\n * Defaults to `<pid>_<base36 time>`.\n */\n name?: string;\n /**\n * Inject DATABASE_URL / TEST_DATABASE_URL for this clone (default false).\n * Host `cloneFromTemplateIfNeeded` defaults true; worker adapters pass true explicitly.\n */\n setEnv?: boolean;\n};\n\nexport type CloneResult = {\n databaseUrl: string;\n adminUrl: string;\n databaseName: string;\n roleName: string;\n templateName: string;\n port: number;\n /**\n * DROP this clone only (leaves TEMPLATE + role if still owned elsewhere).\n * Not suite teardown — use role-scoped `dispose` for that.\n */\n dropClone: () => Promise<void>;\n};\n\n/**\n * Clone the leased TEMPLATE database via admin (`CREATE DATABASE … TEMPLATE`).\n * Reuses the template role so `databaseUrl` passwords stay valid (scheme v2).\n * Provider rejects when the leased DB is not marked TEMPLATE.\n * Port comes from the lease; admin URL is passed through or rediscovered.\n */\nexport async function cloneFromTemplate(options: CloneFromTemplateOptions): Promise<CloneResult> {\n const identity = resolveWorktreeIdentity(options.root);\n const mode = options.mode;\n const lease = readLease(identity.root, mode);\n if (!lease) {\n throw new Error(`no ${mode} lease; run acquire + markTemplate before cloneFromTemplate`);\n }\n\n const adminUrl = await resolveAdminUrl(options.adminUrl);\n const suffix = options.name ?? `${process.pid}_${Date.now().toString(36)}`;\n const databaseName = buildCloneDatabaseName(lease.databaseName, suffix);\n\n await cloneDatabaseFromTemplate({\n adminUrl,\n templateName: lease.databaseName,\n databaseName,\n roleName: lease.roleName,\n });\n\n const databaseUrl = buildDatabaseUrl({\n port: lease.port,\n databaseName,\n roleName: lease.roleName,\n });\n\n if (options.setEnv) {\n applyDatabaseUrlEnv(databaseUrl, { mode });\n }\n\n const roleName = lease.roleName;\n\n return {\n databaseUrl,\n adminUrl,\n databaseName,\n roleName,\n templateName: lease.databaseName,\n port: lease.port,\n dropClone: async () => {\n await dropDatabase({ adminUrl, databaseName, roleName });\n },\n };\n}\n\nexport type CloneFromTemplateIfNeededOptions = CloneFromTemplateOptions & ResolveAcquireSkipInput;\n\nexport type CloneFromTemplateIfNeededResult =\n | { status: \"skipped\"; reason: \"disabled\" }\n | { status: \"skipped\"; reason: \"external-url\"; databaseUrl: string }\n | ({ status: \"cloned\" } & CloneResult);\n\n/**\n * Resolve skip policy then clone. Host entry for worker adapters (same skip\n * semantics as `acquireIfNeeded`). Defaults `setEnv` on for skip and clone paths.\n */\nexport async function cloneFromTemplateIfNeeded(\n options: CloneFromTemplateIfNeededOptions,\n): Promise<CloneFromTemplateIfNeededResult> {\n const outcome = await runIfNeeded(options, () =>\n cloneFromTemplate({\n ...options,\n setEnv: options.setEnv !== false,\n }),\n );\n if (outcome.status === \"skipped\") return outcome;\n return { status: \"cloned\", ...outcome.value };\n}\n"],"mappings":";;;AAYA,eAAe,gBAAgB,UAAoC;CACjE,OAAO,aAAa,MAAM,kBAAkB,EAAA,CAAG;AACjD;;;;;AAaA,eAAsB,aACpB,SACqD;CACrD,MAAM,WAAW,wBAAwB,QAAQ,IAAI;CACrD,MAAM,OAAO,QAAQ;CACrB,MAAM,QAAQ,UAAU,SAAS,MAAM,IAAI;CAC3C,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,MAAM,KAAK,wCAAwC;CAErE,MAAM,WAAW,MAAM,gBAAgB,QAAQ,QAAQ;CACvD,MAAM,sBAAsB;EAC1B;EACA,cAAc,MAAM;EACpB,YAAY;CACd,CAAC;CACD,OAAO;EAAE,cAAc,MAAM;EAAc;CAAS;AACtD;;;;;;;AAuCA,eAAsB,kBAAkB,SAAyD;CAC/F,MAAM,WAAW,wBAAwB,QAAQ,IAAI;CACrD,MAAM,OAAO,QAAQ;CACrB,MAAM,QAAQ,UAAU,SAAS,MAAM,IAAI;CAC3C,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,MAAM,KAAK,4DAA4D;CAGzF,MAAM,WAAW,MAAM,gBAAgB,QAAQ,QAAQ;CACvD,MAAM,SAAS,QAAQ,QAAQ,GAAG,QAAQ,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC,SAAS,EAAE;CACvE,MAAM,eAAe,uBAAuB,MAAM,cAAc,MAAM;CAEtE,MAAM,0BAA0B;EAC9B;EACA,cAAc,MAAM;EACpB;EACA,UAAU,MAAM;CAClB,CAAC;CAED,MAAM,cAAc,iBAAiB;EACnC,MAAM,MAAM;EACZ;EACA,UAAU,MAAM;CAClB,CAAC;CAED,IAAI,QAAQ,QACV,oBAAoB,aAAa,EAAE,KAAK,CAAC;CAG3C,MAAM,WAAW,MAAM;CAEvB,OAAO;EACL;EACA;EACA;EACA;EACA,cAAc,MAAM;EACpB,MAAM,MAAM;EACZ,WAAW,YAAY;GACrB,MAAM,aAAa;IAAE;IAAU;IAAc;GAAS,CAAC;EACzD;CACF;AACF;;;;;AAaA,eAAsB,0BACpB,SAC0C;CAC1C,MAAM,UAAU,MAAM,YAAY,eAChC,kBAAkB;EAChB,GAAG;EACH,QAAQ,QAAQ,WAAW;CAC7B,CAAC,CACH;CACA,IAAI,QAAQ,WAAW,WAAW,OAAO;CACzC,OAAO;EAAE,QAAQ;EAAU,GAAG,QAAQ;CAAM;AAC9C"}
@@ -0,0 +1,105 @@
1
+ const require_lifecycle = require("./lifecycle-BbrvFQvg.cjs");
2
+ const require_lease = require("./lease-WlmOnNDi.cjs");
3
+ //#region src/core/template.ts
4
+ async function resolveAdminUrl(adminUrl) {
5
+ return adminUrl ?? (await require_lifecycle.ensureHostRunning()).adminUrl;
6
+ }
7
+ /**
8
+ * After migrations, mark the leased DB as a PostgreSQL TEMPLATE so workers can clone it.
9
+ * Requires a lease from `acquire` (no datname override).
10
+ */
11
+ async function markTemplate(options) {
12
+ const identity = require_lease.resolveWorktreeIdentity(options.root);
13
+ const mode = options.mode;
14
+ const lease = require_lease.readLease(identity.root, mode);
15
+ if (!lease) throw new Error(`no ${mode} lease; run acquire before markTemplate`);
16
+ const adminUrl = await resolveAdminUrl(options.adminUrl);
17
+ await require_lifecycle.setDatabaseIsTemplate({
18
+ adminUrl,
19
+ databaseName: lease.databaseName,
20
+ isTemplate: true
21
+ });
22
+ return {
23
+ databaseName: lease.databaseName,
24
+ adminUrl
25
+ };
26
+ }
27
+ /**
28
+ * Clone the leased TEMPLATE database via admin (`CREATE DATABASE … TEMPLATE`).
29
+ * Reuses the template role so `databaseUrl` passwords stay valid (scheme v2).
30
+ * Provider rejects when the leased DB is not marked TEMPLATE.
31
+ * Port comes from the lease; admin URL is passed through or rediscovered.
32
+ */
33
+ async function cloneFromTemplate(options) {
34
+ const identity = require_lease.resolveWorktreeIdentity(options.root);
35
+ const mode = options.mode;
36
+ const lease = require_lease.readLease(identity.root, mode);
37
+ if (!lease) throw new Error(`no ${mode} lease; run acquire + markTemplate before cloneFromTemplate`);
38
+ const adminUrl = await resolveAdminUrl(options.adminUrl);
39
+ const suffix = options.name ?? `${process.pid}_${Date.now().toString(36)}`;
40
+ const databaseName = require_lifecycle.buildCloneDatabaseName(lease.databaseName, suffix);
41
+ await require_lifecycle.cloneDatabaseFromTemplate({
42
+ adminUrl,
43
+ templateName: lease.databaseName,
44
+ databaseName,
45
+ roleName: lease.roleName
46
+ });
47
+ const databaseUrl = require_lifecycle.buildDatabaseUrl({
48
+ port: lease.port,
49
+ databaseName,
50
+ roleName: lease.roleName
51
+ });
52
+ if (options.setEnv) require_lifecycle.applyDatabaseUrlEnv(databaseUrl, { mode });
53
+ const roleName = lease.roleName;
54
+ return {
55
+ databaseUrl,
56
+ adminUrl,
57
+ databaseName,
58
+ roleName,
59
+ templateName: lease.databaseName,
60
+ port: lease.port,
61
+ dropClone: async () => {
62
+ await require_lifecycle.dropDatabase({
63
+ adminUrl,
64
+ databaseName,
65
+ roleName
66
+ });
67
+ }
68
+ };
69
+ }
70
+ /**
71
+ * Resolve skip policy then clone. Host entry for worker adapters (same skip
72
+ * semantics as `acquireIfNeeded`). Defaults `setEnv` on for skip and clone paths.
73
+ */
74
+ async function cloneFromTemplateIfNeeded(options) {
75
+ const outcome = await require_lifecycle.runIfNeeded(options, () => cloneFromTemplate({
76
+ ...options,
77
+ setEnv: options.setEnv !== false
78
+ }));
79
+ if (outcome.status === "skipped") return outcome;
80
+ return {
81
+ status: "cloned",
82
+ ...outcome.value
83
+ };
84
+ }
85
+ //#endregion
86
+ Object.defineProperty(exports, "cloneFromTemplate", {
87
+ enumerable: true,
88
+ get: function() {
89
+ return cloneFromTemplate;
90
+ }
91
+ });
92
+ Object.defineProperty(exports, "cloneFromTemplateIfNeeded", {
93
+ enumerable: true,
94
+ get: function() {
95
+ return cloneFromTemplateIfNeeded;
96
+ }
97
+ });
98
+ Object.defineProperty(exports, "markTemplate", {
99
+ enumerable: true,
100
+ get: function() {
101
+ return markTemplate;
102
+ }
103
+ });
104
+
105
+ //# sourceMappingURL=template-CXMpODzK.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"template-CXMpODzK.cjs","names":["ensureHostRunning","resolveWorktreeIdentity","readLease","setDatabaseIsTemplate","buildCloneDatabaseName","cloneDatabaseFromTemplate","buildDatabaseUrl","dropDatabase","runIfNeeded"],"sources":["../src/core/template.ts"],"sourcesContent":["import { buildCloneDatabaseName, type DbMode } from \"./naming.ts\";\nimport { readLease } from \"./lease.ts\";\nimport { applyDatabaseUrlEnv, runIfNeeded, type ResolveAcquireSkipInput } from \"./policy.ts\";\nimport { resolveWorktreeIdentity } from \"./worktree.ts\";\nimport {\n buildDatabaseUrl,\n cloneDatabaseFromTemplate,\n dropDatabase,\n setDatabaseIsTemplate,\n} from \"../providers/autopg.ts\";\nimport { ensureHostRunning } from \"../providers/host.ts\";\n\nasync function resolveAdminUrl(adminUrl?: string): Promise<string> {\n return adminUrl ?? (await ensureHostRunning()).adminUrl;\n}\n\nexport type MarkTemplateOptions = {\n root?: string;\n mode: DbMode;\n /** Superuser URL from `acquire`; when omitted, discovers/starts the host. */\n adminUrl?: string;\n};\n\n/**\n * After migrations, mark the leased DB as a PostgreSQL TEMPLATE so workers can clone it.\n * Requires a lease from `acquire` (no datname override).\n */\nexport async function markTemplate(\n options: MarkTemplateOptions,\n): Promise<{ databaseName: string; adminUrl: string }> {\n const identity = resolveWorktreeIdentity(options.root);\n const mode = options.mode;\n const lease = readLease(identity.root, mode);\n if (!lease) {\n throw new Error(`no ${mode} lease; run acquire before markTemplate`);\n }\n const adminUrl = await resolveAdminUrl(options.adminUrl);\n await setDatabaseIsTemplate({\n adminUrl,\n databaseName: lease.databaseName,\n isTemplate: true,\n });\n return { databaseName: lease.databaseName, adminUrl };\n}\n\nexport type CloneFromTemplateOptions = {\n root?: string;\n mode: DbMode;\n /** Superuser URL from `acquire`; when omitted, discovers/starts the host. */\n adminUrl?: string;\n /**\n * Suffix for the clone datname (e.g. Jest worker id).\n * Defaults to `<pid>_<base36 time>`.\n */\n name?: string;\n /**\n * Inject DATABASE_URL / TEST_DATABASE_URL for this clone (default false).\n * Host `cloneFromTemplateIfNeeded` defaults true; worker adapters pass true explicitly.\n */\n setEnv?: boolean;\n};\n\nexport type CloneResult = {\n databaseUrl: string;\n adminUrl: string;\n databaseName: string;\n roleName: string;\n templateName: string;\n port: number;\n /**\n * DROP this clone only (leaves TEMPLATE + role if still owned elsewhere).\n * Not suite teardown — use role-scoped `dispose` for that.\n */\n dropClone: () => Promise<void>;\n};\n\n/**\n * Clone the leased TEMPLATE database via admin (`CREATE DATABASE … TEMPLATE`).\n * Reuses the template role so `databaseUrl` passwords stay valid (scheme v2).\n * Provider rejects when the leased DB is not marked TEMPLATE.\n * Port comes from the lease; admin URL is passed through or rediscovered.\n */\nexport async function cloneFromTemplate(options: CloneFromTemplateOptions): Promise<CloneResult> {\n const identity = resolveWorktreeIdentity(options.root);\n const mode = options.mode;\n const lease = readLease(identity.root, mode);\n if (!lease) {\n throw new Error(`no ${mode} lease; run acquire + markTemplate before cloneFromTemplate`);\n }\n\n const adminUrl = await resolveAdminUrl(options.adminUrl);\n const suffix = options.name ?? `${process.pid}_${Date.now().toString(36)}`;\n const databaseName = buildCloneDatabaseName(lease.databaseName, suffix);\n\n await cloneDatabaseFromTemplate({\n adminUrl,\n templateName: lease.databaseName,\n databaseName,\n roleName: lease.roleName,\n });\n\n const databaseUrl = buildDatabaseUrl({\n port: lease.port,\n databaseName,\n roleName: lease.roleName,\n });\n\n if (options.setEnv) {\n applyDatabaseUrlEnv(databaseUrl, { mode });\n }\n\n const roleName = lease.roleName;\n\n return {\n databaseUrl,\n adminUrl,\n databaseName,\n roleName,\n templateName: lease.databaseName,\n port: lease.port,\n dropClone: async () => {\n await dropDatabase({ adminUrl, databaseName, roleName });\n },\n };\n}\n\nexport type CloneFromTemplateIfNeededOptions = CloneFromTemplateOptions & ResolveAcquireSkipInput;\n\nexport type CloneFromTemplateIfNeededResult =\n | { status: \"skipped\"; reason: \"disabled\" }\n | { status: \"skipped\"; reason: \"external-url\"; databaseUrl: string }\n | ({ status: \"cloned\" } & CloneResult);\n\n/**\n * Resolve skip policy then clone. Host entry for worker adapters (same skip\n * semantics as `acquireIfNeeded`). Defaults `setEnv` on for skip and clone paths.\n */\nexport async function cloneFromTemplateIfNeeded(\n options: CloneFromTemplateIfNeededOptions,\n): Promise<CloneFromTemplateIfNeededResult> {\n const outcome = await runIfNeeded(options, () =>\n cloneFromTemplate({\n ...options,\n setEnv: options.setEnv !== false,\n }),\n );\n if (outcome.status === \"skipped\") return outcome;\n return { status: \"cloned\", ...outcome.value };\n}\n"],"mappings":";;;AAYA,eAAe,gBAAgB,UAAoC;CACjE,OAAO,aAAa,MAAMA,kBAAAA,kBAAkB,EAAA,CAAG;AACjD;;;;;AAaA,eAAsB,aACpB,SACqD;CACrD,MAAM,WAAWC,cAAAA,wBAAwB,QAAQ,IAAI;CACrD,MAAM,OAAO,QAAQ;CACrB,MAAM,QAAQC,cAAAA,UAAU,SAAS,MAAM,IAAI;CAC3C,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,MAAM,KAAK,wCAAwC;CAErE,MAAM,WAAW,MAAM,gBAAgB,QAAQ,QAAQ;CACvD,MAAMC,kBAAAA,sBAAsB;EAC1B;EACA,cAAc,MAAM;EACpB,YAAY;CACd,CAAC;CACD,OAAO;EAAE,cAAc,MAAM;EAAc;CAAS;AACtD;;;;;;;AAuCA,eAAsB,kBAAkB,SAAyD;CAC/F,MAAM,WAAWF,cAAAA,wBAAwB,QAAQ,IAAI;CACrD,MAAM,OAAO,QAAQ;CACrB,MAAM,QAAQC,cAAAA,UAAU,SAAS,MAAM,IAAI;CAC3C,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,MAAM,KAAK,4DAA4D;CAGzF,MAAM,WAAW,MAAM,gBAAgB,QAAQ,QAAQ;CACvD,MAAM,SAAS,QAAQ,QAAQ,GAAG,QAAQ,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC,SAAS,EAAE;CACvE,MAAM,eAAeE,kBAAAA,uBAAuB,MAAM,cAAc,MAAM;CAEtE,MAAMC,kBAAAA,0BAA0B;EAC9B;EACA,cAAc,MAAM;EACpB;EACA,UAAU,MAAM;CAClB,CAAC;CAED,MAAM,cAAcC,kBAAAA,iBAAiB;EACnC,MAAM,MAAM;EACZ;EACA,UAAU,MAAM;CAClB,CAAC;CAED,IAAI,QAAQ,QACV,kBAAA,oBAAoB,aAAa,EAAE,KAAK,CAAC;CAG3C,MAAM,WAAW,MAAM;CAEvB,OAAO;EACL;EACA;EACA;EACA;EACA,cAAc,MAAM;EACpB,MAAM,MAAM;EACZ,WAAW,YAAY;GACrB,MAAMC,kBAAAA,aAAa;IAAE;IAAU;IAAc;GAAS,CAAC;EACzD;CACF;AACF;;;;;AAaA,eAAsB,0BACpB,SAC0C;CAC1C,MAAM,UAAU,MAAMC,kBAAAA,YAAY,eAChC,kBAAkB;EAChB,GAAG;EACH,QAAQ,QAAQ,WAAW;CAC7B,CAAC,CACH;CACA,IAAI,QAAQ,WAAW,WAAW,OAAO;CACzC,OAAO;EAAE,QAAQ;EAAU,GAAG,QAAQ;CAAM;AAC9C"}
@@ -0,0 +1,94 @@
1
+ import { n as acquireIfNeeded, r as dispose } from "./lifecycle-BvIx0xqq.mjs";
2
+ import { n as cloneFromTemplateIfNeeded, r as markTemplate } from "./template-BiJ-0TIF.mjs";
3
+ //#region src/adapters/template-mode.ts
4
+ /**
5
+ * Runner orchestration: acquire → migrate → markTemplate.
6
+ * After acquire succeeds, migrate + markTemplate are all-or-nothing: any failure
7
+ * best-effort disposes the lease so Vitest (no separate teardown) does not leak.
8
+ * Programmatic apps that do not need a migrate hook should call core
9
+ * `acquire` + `markTemplate` + `cloneFromTemplate` + `dispose` instead.
10
+ */
11
+ async function setupTemplateMode(options) {
12
+ const result = await acquireIfNeeded({
13
+ root: options.root,
14
+ mode: "test",
15
+ setEnv: options.setEnv !== false
16
+ });
17
+ if (result.status !== "acquired") return result;
18
+ try {
19
+ await options.migrate({
20
+ databaseUrl: result.databaseUrl,
21
+ adminUrl: result.adminUrl,
22
+ databaseName: result.databaseName,
23
+ roleName: result.roleName
24
+ });
25
+ await markTemplate({
26
+ root: result.root,
27
+ mode: "test",
28
+ adminUrl: result.adminUrl
29
+ });
30
+ } catch (err) {
31
+ try {
32
+ await dispose({
33
+ root: result.root,
34
+ mode: "test"
35
+ });
36
+ } catch {}
37
+ const detail = err instanceof Error ? err.message : String(err);
38
+ throw new Error(`template setup failed after acquire; cleaned up lease DB (${result.databaseName}). Fix the error and re-run: ${detail}`, { cause: err });
39
+ }
40
+ return result;
41
+ }
42
+ /** Survives Jest `setupFiles` module reloads (module-scoped `let` does not). */
43
+ const CLONE_WORKER_MEMO = Symbol.for("@cedarjs/pg/cloneWorkerDatabase");
44
+ function readCloneWorkerMemo() {
45
+ return globalThis[CLONE_WORKER_MEMO];
46
+ }
47
+ function writeCloneWorkerMemo(memo) {
48
+ const g = globalThis;
49
+ if (memo === void 0) delete g[CLONE_WORKER_MEMO];
50
+ else g[CLONE_WORKER_MEMO] = memo;
51
+ }
52
+ function resolveWorkerName(options) {
53
+ return options.name ?? process.env.JEST_WORKER_ID ?? process.env.VITEST_POOL_ID ?? String(process.pid);
54
+ }
55
+ function workerOptionsKey(root, name) {
56
+ return `${root ?? ""}\0${name}`;
57
+ }
58
+ /**
59
+ * Process-once per-worker clone (JEST_WORKER_ID / VITEST_POOL_ID / pid by default).
60
+ * Uses `cloneFromTemplateIfNeeded` (same skip policy as `acquireIfNeeded`) with `setEnv: true`.
61
+ * First call wins for `root`/`name`; conflicting later calls throw.
62
+ *
63
+ * Memo lives on `globalThis` so Jest `setupFiles` (module reload per file) still
64
+ * shares one clone per worker. `setupFilesAfterEnv` + `beforeAll` also works.
65
+ */
66
+ function cloneWorkerDatabase(options = {}) {
67
+ const name = resolveWorkerName(options);
68
+ const key = workerOptionsKey(options.root, name);
69
+ const existing = readCloneWorkerMemo();
70
+ if (existing) {
71
+ if (existing.key !== key) throw new Error(`cloneWorkerDatabase already started with different root/name (first: ${JSON.stringify(existing.key)}, now: ${JSON.stringify(key)})`);
72
+ return existing.promise;
73
+ }
74
+ const promise = (async () => {
75
+ await cloneFromTemplateIfNeeded({
76
+ root: options.root,
77
+ mode: "test",
78
+ name,
79
+ setEnv: true
80
+ });
81
+ })().catch((err) => {
82
+ writeCloneWorkerMemo(void 0);
83
+ throw err;
84
+ });
85
+ writeCloneWorkerMemo({
86
+ promise,
87
+ key
88
+ });
89
+ return promise;
90
+ }
91
+ //#endregion
92
+ export { setupTemplateMode as n, cloneWorkerDatabase as t };
93
+
94
+ //# sourceMappingURL=template-mode-BTUsdBtA.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"template-mode-BTUsdBtA.mjs","names":[],"sources":["../src/adapters/template-mode.ts"],"sourcesContent":["import { dispose, acquireIfNeeded, type AcquireIfNeededResult } from \"../core/lifecycle.ts\";\nimport { cloneFromTemplateIfNeeded, markTemplate } from \"../core/template.ts\";\n\nexport type TemplateMigrateContext = {\n databaseUrl: string;\n adminUrl: string;\n databaseName: string;\n roleName: string;\n};\n\nexport type TemplateMigrateFn = (ctx: TemplateMigrateContext) => void | Promise<void>;\n\nexport type SetupTemplateModeOptions = {\n root?: string;\n /** App-owned migrate; runs once, then `markTemplate`. Required. */\n migrate: TemplateMigrateFn;\n setEnv?: boolean;\n};\n\n/**\n * Runner orchestration: acquire → migrate → markTemplate.\n * After acquire succeeds, migrate + markTemplate are all-or-nothing: any failure\n * best-effort disposes the lease so Vitest (no separate teardown) does not leak.\n * Programmatic apps that do not need a migrate hook should call core\n * `acquire` + `markTemplate` + `cloneFromTemplate` + `dispose` instead.\n */\nexport async function setupTemplateMode(\n options: SetupTemplateModeOptions,\n): Promise<AcquireIfNeededResult> {\n const result = await acquireIfNeeded({\n root: options.root,\n mode: \"test\",\n setEnv: options.setEnv !== false,\n });\n if (result.status !== \"acquired\") return result;\n\n try {\n await options.migrate({\n databaseUrl: result.databaseUrl,\n adminUrl: result.adminUrl,\n databaseName: result.databaseName,\n roleName: result.roleName,\n });\n await markTemplate({\n root: result.root,\n mode: \"test\",\n adminUrl: result.adminUrl,\n });\n } catch (err) {\n try {\n await dispose({ root: result.root, mode: \"test\" });\n } catch {\n // best-effort: leave lease for dispose/gc retry\n }\n const detail = err instanceof Error ? err.message : String(err);\n throw new Error(\n `template setup failed after acquire; cleaned up lease DB (${result.databaseName}). ` +\n `Fix the error and re-run: ${detail}`,\n { cause: err },\n );\n }\n\n return result;\n}\n\nexport type CloneWorkerDatabaseOptions = {\n root?: string;\n /** Clone suffix; defaults to JEST_WORKER_ID / VITEST_POOL_ID / pid. */\n name?: string;\n};\n\n/** Survives Jest `setupFiles` module reloads (module-scoped `let` does not). */\nconst CLONE_WORKER_MEMO = Symbol.for(\"@cedarjs/pg/cloneWorkerDatabase\");\n\ntype CloneWorkerMemo = {\n promise: Promise<void>;\n key: string;\n};\n\ntype GlobalWithCloneWorkerMemo = typeof globalThis & {\n [CLONE_WORKER_MEMO]?: CloneWorkerMemo;\n};\n\nfunction readCloneWorkerMemo(): CloneWorkerMemo | undefined {\n return (globalThis as GlobalWithCloneWorkerMemo)[CLONE_WORKER_MEMO];\n}\n\nfunction writeCloneWorkerMemo(memo: CloneWorkerMemo | undefined): void {\n const g = globalThis as GlobalWithCloneWorkerMemo;\n if (memo === undefined) delete g[CLONE_WORKER_MEMO];\n else g[CLONE_WORKER_MEMO] = memo;\n}\n\nfunction resolveWorkerName(options: CloneWorkerDatabaseOptions): string {\n return (\n options.name ?? process.env.JEST_WORKER_ID ?? process.env.VITEST_POOL_ID ?? String(process.pid)\n );\n}\n\nfunction workerOptionsKey(root: string | undefined, name: string): string {\n return `${root ?? \"\"}\\0${name}`;\n}\n\n/**\n * Process-once per-worker clone (JEST_WORKER_ID / VITEST_POOL_ID / pid by default).\n * Uses `cloneFromTemplateIfNeeded` (same skip policy as `acquireIfNeeded`) with `setEnv: true`.\n * First call wins for `root`/`name`; conflicting later calls throw.\n *\n * Memo lives on `globalThis` so Jest `setupFiles` (module reload per file) still\n * shares one clone per worker. `setupFilesAfterEnv` + `beforeAll` also works.\n */\nexport function cloneWorkerDatabase(options: CloneWorkerDatabaseOptions = {}): Promise<void> {\n const name = resolveWorkerName(options);\n const key = workerOptionsKey(options.root, name);\n const existing = readCloneWorkerMemo();\n if (existing) {\n if (existing.key !== key) {\n throw new Error(\n `cloneWorkerDatabase already started with different root/name ` +\n `(first: ${JSON.stringify(existing.key)}, now: ${JSON.stringify(key)})`,\n );\n }\n return existing.promise;\n }\n const promise = (async () => {\n await cloneFromTemplateIfNeeded({\n root: options.root,\n mode: \"test\",\n name,\n setEnv: true,\n });\n })().catch((err) => {\n writeCloneWorkerMemo(undefined);\n throw err;\n });\n writeCloneWorkerMemo({ promise, key });\n return promise;\n}\n"],"mappings":";;;;;;;;;;AA0BA,eAAsB,kBACpB,SACgC;CAChC,MAAM,SAAS,MAAM,gBAAgB;EACnC,MAAM,QAAQ;EACd,MAAM;EACN,QAAQ,QAAQ,WAAW;CAC7B,CAAC;CACD,IAAI,OAAO,WAAW,YAAY,OAAO;CAEzC,IAAI;EACF,MAAM,QAAQ,QAAQ;GACpB,aAAa,OAAO;GACpB,UAAU,OAAO;GACjB,cAAc,OAAO;GACrB,UAAU,OAAO;EACnB,CAAC;EACD,MAAM,aAAa;GACjB,MAAM,OAAO;GACb,MAAM;GACN,UAAU,OAAO;EACnB,CAAC;CACH,SAAS,KAAK;EACZ,IAAI;GACF,MAAM,QAAQ;IAAE,MAAM,OAAO;IAAM,MAAM;GAAO,CAAC;EACnD,QAAQ,CAER;EACA,MAAM,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;EAC9D,MAAM,IAAI,MACR,6DAA6D,OAAO,aAAa,+BAClD,UAC/B,EAAE,OAAO,IAAI,CACf;CACF;CAEA,OAAO;AACT;;AASA,MAAM,oBAAoB,OAAO,IAAI,iCAAiC;AAWtE,SAAS,sBAAmD;CAC1D,OAAQ,WAAyC;AACnD;AAEA,SAAS,qBAAqB,MAAyC;CACrE,MAAM,IAAI;CACV,IAAI,SAAS,KAAA,GAAW,OAAO,EAAE;MAC5B,EAAE,qBAAqB;AAC9B;AAEA,SAAS,kBAAkB,SAA6C;CACtE,OACE,QAAQ,QAAQ,QAAQ,IAAI,kBAAkB,QAAQ,IAAI,kBAAkB,OAAO,QAAQ,GAAG;AAElG;AAEA,SAAS,iBAAiB,MAA0B,MAAsB;CACxE,OAAO,GAAG,QAAQ,GAAG,IAAI;AAC3B;;;;;;;;;AAUA,SAAgB,oBAAoB,UAAsC,CAAC,GAAkB;CAC3F,MAAM,OAAO,kBAAkB,OAAO;CACtC,MAAM,MAAM,iBAAiB,QAAQ,MAAM,IAAI;CAC/C,MAAM,WAAW,oBAAoB;CACrC,IAAI,UAAU;EACZ,IAAI,SAAS,QAAQ,KACnB,MAAM,IAAI,MACR,wEACa,KAAK,UAAU,SAAS,GAAG,EAAE,SAAS,KAAK,UAAU,GAAG,EAAE,EACzE;EAEF,OAAO,SAAS;CAClB;CACA,MAAM,WAAW,YAAY;EAC3B,MAAM,0BAA0B;GAC9B,MAAM,QAAQ;GACd,MAAM;GACN;GACA,QAAQ;EACV,CAAC;CACH,EAAA,CAAG,CAAC,CAAC,OAAO,QAAQ;EAClB,qBAAqB,KAAA,CAAS;EAC9B,MAAM;CACR,CAAC;CACD,qBAAqB;EAAE;EAAS;CAAI,CAAC;CACrC,OAAO;AACT"}
@@ -0,0 +1,31 @@
1
+ //#region src/adapters/template-mode.d.ts
2
+ type TemplateMigrateContext = {
3
+ databaseUrl: string;
4
+ adminUrl: string;
5
+ databaseName: string;
6
+ roleName: string;
7
+ };
8
+ type TemplateMigrateFn = (ctx: TemplateMigrateContext) => void | Promise<void>;
9
+ type SetupTemplateModeOptions = {
10
+ root?: string;
11
+ /** App-owned migrate; runs once, then `markTemplate`. Required. */
12
+ migrate: TemplateMigrateFn;
13
+ setEnv?: boolean;
14
+ };
15
+ type CloneWorkerDatabaseOptions = {
16
+ root?: string;
17
+ /** Clone suffix; defaults to JEST_WORKER_ID / VITEST_POOL_ID / pid. */
18
+ name?: string;
19
+ };
20
+ /**
21
+ * Process-once per-worker clone (JEST_WORKER_ID / VITEST_POOL_ID / pid by default).
22
+ * Uses `cloneFromTemplateIfNeeded` (same skip policy as `acquireIfNeeded`) with `setEnv: true`.
23
+ * First call wins for `root`/`name`; conflicting later calls throw.
24
+ *
25
+ * Memo lives on `globalThis` so Jest `setupFiles` (module reload per file) still
26
+ * shares one clone per worker. `setupFilesAfterEnv` + `beforeAll` also works.
27
+ */
28
+ declare function cloneWorkerDatabase(options?: CloneWorkerDatabaseOptions): Promise<void>;
29
+ //#endregion
30
+ export { cloneWorkerDatabase as i, TemplateMigrateContext as n, TemplateMigrateFn as r, SetupTemplateModeOptions as t };
31
+ //# sourceMappingURL=template-mode-CzyVwHsi.d.cts.map
@@ -0,0 +1,31 @@
1
+ //#region src/adapters/template-mode.d.ts
2
+ type TemplateMigrateContext = {
3
+ databaseUrl: string;
4
+ adminUrl: string;
5
+ databaseName: string;
6
+ roleName: string;
7
+ };
8
+ type TemplateMigrateFn = (ctx: TemplateMigrateContext) => void | Promise<void>;
9
+ type SetupTemplateModeOptions = {
10
+ root?: string;
11
+ /** App-owned migrate; runs once, then `markTemplate`. Required. */
12
+ migrate: TemplateMigrateFn;
13
+ setEnv?: boolean;
14
+ };
15
+ type CloneWorkerDatabaseOptions = {
16
+ root?: string;
17
+ /** Clone suffix; defaults to JEST_WORKER_ID / VITEST_POOL_ID / pid. */
18
+ name?: string;
19
+ };
20
+ /**
21
+ * Process-once per-worker clone (JEST_WORKER_ID / VITEST_POOL_ID / pid by default).
22
+ * Uses `cloneFromTemplateIfNeeded` (same skip policy as `acquireIfNeeded`) with `setEnv: true`.
23
+ * First call wins for `root`/`name`; conflicting later calls throw.
24
+ *
25
+ * Memo lives on `globalThis` so Jest `setupFiles` (module reload per file) still
26
+ * shares one clone per worker. `setupFilesAfterEnv` + `beforeAll` also works.
27
+ */
28
+ declare function cloneWorkerDatabase(options?: CloneWorkerDatabaseOptions): Promise<void>;
29
+ //#endregion
30
+ export { cloneWorkerDatabase as i, TemplateMigrateContext as n, TemplateMigrateFn as r, SetupTemplateModeOptions as t };
31
+ //# sourceMappingURL=template-mode-CzyVwHsi.d.mts.map
@@ -0,0 +1,105 @@
1
+ const require_lifecycle = require("./lifecycle-BbrvFQvg.cjs");
2
+ const require_template = require("./template-CXMpODzK.cjs");
3
+ //#region src/adapters/template-mode.ts
4
+ /**
5
+ * Runner orchestration: acquire → migrate → markTemplate.
6
+ * After acquire succeeds, migrate + markTemplate are all-or-nothing: any failure
7
+ * best-effort disposes the lease so Vitest (no separate teardown) does not leak.
8
+ * Programmatic apps that do not need a migrate hook should call core
9
+ * `acquire` + `markTemplate` + `cloneFromTemplate` + `dispose` instead.
10
+ */
11
+ async function setupTemplateMode(options) {
12
+ const result = await require_lifecycle.acquireIfNeeded({
13
+ root: options.root,
14
+ mode: "test",
15
+ setEnv: options.setEnv !== false
16
+ });
17
+ if (result.status !== "acquired") return result;
18
+ try {
19
+ await options.migrate({
20
+ databaseUrl: result.databaseUrl,
21
+ adminUrl: result.adminUrl,
22
+ databaseName: result.databaseName,
23
+ roleName: result.roleName
24
+ });
25
+ await require_template.markTemplate({
26
+ root: result.root,
27
+ mode: "test",
28
+ adminUrl: result.adminUrl
29
+ });
30
+ } catch (err) {
31
+ try {
32
+ await require_lifecycle.dispose({
33
+ root: result.root,
34
+ mode: "test"
35
+ });
36
+ } catch {}
37
+ const detail = err instanceof Error ? err.message : String(err);
38
+ throw new Error(`template setup failed after acquire; cleaned up lease DB (${result.databaseName}). Fix the error and re-run: ${detail}`, { cause: err });
39
+ }
40
+ return result;
41
+ }
42
+ /** Survives Jest `setupFiles` module reloads (module-scoped `let` does not). */
43
+ const CLONE_WORKER_MEMO = Symbol.for("@cedarjs/pg/cloneWorkerDatabase");
44
+ function readCloneWorkerMemo() {
45
+ return globalThis[CLONE_WORKER_MEMO];
46
+ }
47
+ function writeCloneWorkerMemo(memo) {
48
+ const g = globalThis;
49
+ if (memo === void 0) delete g[CLONE_WORKER_MEMO];
50
+ else g[CLONE_WORKER_MEMO] = memo;
51
+ }
52
+ function resolveWorkerName(options) {
53
+ return options.name ?? process.env.JEST_WORKER_ID ?? process.env.VITEST_POOL_ID ?? String(process.pid);
54
+ }
55
+ function workerOptionsKey(root, name) {
56
+ return `${root ?? ""}\0${name}`;
57
+ }
58
+ /**
59
+ * Process-once per-worker clone (JEST_WORKER_ID / VITEST_POOL_ID / pid by default).
60
+ * Uses `cloneFromTemplateIfNeeded` (same skip policy as `acquireIfNeeded`) with `setEnv: true`.
61
+ * First call wins for `root`/`name`; conflicting later calls throw.
62
+ *
63
+ * Memo lives on `globalThis` so Jest `setupFiles` (module reload per file) still
64
+ * shares one clone per worker. `setupFilesAfterEnv` + `beforeAll` also works.
65
+ */
66
+ function cloneWorkerDatabase(options = {}) {
67
+ const name = resolveWorkerName(options);
68
+ const key = workerOptionsKey(options.root, name);
69
+ const existing = readCloneWorkerMemo();
70
+ if (existing) {
71
+ if (existing.key !== key) throw new Error(`cloneWorkerDatabase already started with different root/name (first: ${JSON.stringify(existing.key)}, now: ${JSON.stringify(key)})`);
72
+ return existing.promise;
73
+ }
74
+ const promise = (async () => {
75
+ await require_template.cloneFromTemplateIfNeeded({
76
+ root: options.root,
77
+ mode: "test",
78
+ name,
79
+ setEnv: true
80
+ });
81
+ })().catch((err) => {
82
+ writeCloneWorkerMemo(void 0);
83
+ throw err;
84
+ });
85
+ writeCloneWorkerMemo({
86
+ promise,
87
+ key
88
+ });
89
+ return promise;
90
+ }
91
+ //#endregion
92
+ Object.defineProperty(exports, "cloneWorkerDatabase", {
93
+ enumerable: true,
94
+ get: function() {
95
+ return cloneWorkerDatabase;
96
+ }
97
+ });
98
+ Object.defineProperty(exports, "setupTemplateMode", {
99
+ enumerable: true,
100
+ get: function() {
101
+ return setupTemplateMode;
102
+ }
103
+ });
104
+
105
+ //# sourceMappingURL=template-mode-JTOxrEgE.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"template-mode-JTOxrEgE.cjs","names":["acquireIfNeeded","markTemplate","dispose","cloneFromTemplateIfNeeded"],"sources":["../src/adapters/template-mode.ts"],"sourcesContent":["import { dispose, acquireIfNeeded, type AcquireIfNeededResult } from \"../core/lifecycle.ts\";\nimport { cloneFromTemplateIfNeeded, markTemplate } from \"../core/template.ts\";\n\nexport type TemplateMigrateContext = {\n databaseUrl: string;\n adminUrl: string;\n databaseName: string;\n roleName: string;\n};\n\nexport type TemplateMigrateFn = (ctx: TemplateMigrateContext) => void | Promise<void>;\n\nexport type SetupTemplateModeOptions = {\n root?: string;\n /** App-owned migrate; runs once, then `markTemplate`. Required. */\n migrate: TemplateMigrateFn;\n setEnv?: boolean;\n};\n\n/**\n * Runner orchestration: acquire → migrate → markTemplate.\n * After acquire succeeds, migrate + markTemplate are all-or-nothing: any failure\n * best-effort disposes the lease so Vitest (no separate teardown) does not leak.\n * Programmatic apps that do not need a migrate hook should call core\n * `acquire` + `markTemplate` + `cloneFromTemplate` + `dispose` instead.\n */\nexport async function setupTemplateMode(\n options: SetupTemplateModeOptions,\n): Promise<AcquireIfNeededResult> {\n const result = await acquireIfNeeded({\n root: options.root,\n mode: \"test\",\n setEnv: options.setEnv !== false,\n });\n if (result.status !== \"acquired\") return result;\n\n try {\n await options.migrate({\n databaseUrl: result.databaseUrl,\n adminUrl: result.adminUrl,\n databaseName: result.databaseName,\n roleName: result.roleName,\n });\n await markTemplate({\n root: result.root,\n mode: \"test\",\n adminUrl: result.adminUrl,\n });\n } catch (err) {\n try {\n await dispose({ root: result.root, mode: \"test\" });\n } catch {\n // best-effort: leave lease for dispose/gc retry\n }\n const detail = err instanceof Error ? err.message : String(err);\n throw new Error(\n `template setup failed after acquire; cleaned up lease DB (${result.databaseName}). ` +\n `Fix the error and re-run: ${detail}`,\n { cause: err },\n );\n }\n\n return result;\n}\n\nexport type CloneWorkerDatabaseOptions = {\n root?: string;\n /** Clone suffix; defaults to JEST_WORKER_ID / VITEST_POOL_ID / pid. */\n name?: string;\n};\n\n/** Survives Jest `setupFiles` module reloads (module-scoped `let` does not). */\nconst CLONE_WORKER_MEMO = Symbol.for(\"@cedarjs/pg/cloneWorkerDatabase\");\n\ntype CloneWorkerMemo = {\n promise: Promise<void>;\n key: string;\n};\n\ntype GlobalWithCloneWorkerMemo = typeof globalThis & {\n [CLONE_WORKER_MEMO]?: CloneWorkerMemo;\n};\n\nfunction readCloneWorkerMemo(): CloneWorkerMemo | undefined {\n return (globalThis as GlobalWithCloneWorkerMemo)[CLONE_WORKER_MEMO];\n}\n\nfunction writeCloneWorkerMemo(memo: CloneWorkerMemo | undefined): void {\n const g = globalThis as GlobalWithCloneWorkerMemo;\n if (memo === undefined) delete g[CLONE_WORKER_MEMO];\n else g[CLONE_WORKER_MEMO] = memo;\n}\n\nfunction resolveWorkerName(options: CloneWorkerDatabaseOptions): string {\n return (\n options.name ?? process.env.JEST_WORKER_ID ?? process.env.VITEST_POOL_ID ?? String(process.pid)\n );\n}\n\nfunction workerOptionsKey(root: string | undefined, name: string): string {\n return `${root ?? \"\"}\\0${name}`;\n}\n\n/**\n * Process-once per-worker clone (JEST_WORKER_ID / VITEST_POOL_ID / pid by default).\n * Uses `cloneFromTemplateIfNeeded` (same skip policy as `acquireIfNeeded`) with `setEnv: true`.\n * First call wins for `root`/`name`; conflicting later calls throw.\n *\n * Memo lives on `globalThis` so Jest `setupFiles` (module reload per file) still\n * shares one clone per worker. `setupFilesAfterEnv` + `beforeAll` also works.\n */\nexport function cloneWorkerDatabase(options: CloneWorkerDatabaseOptions = {}): Promise<void> {\n const name = resolveWorkerName(options);\n const key = workerOptionsKey(options.root, name);\n const existing = readCloneWorkerMemo();\n if (existing) {\n if (existing.key !== key) {\n throw new Error(\n `cloneWorkerDatabase already started with different root/name ` +\n `(first: ${JSON.stringify(existing.key)}, now: ${JSON.stringify(key)})`,\n );\n }\n return existing.promise;\n }\n const promise = (async () => {\n await cloneFromTemplateIfNeeded({\n root: options.root,\n mode: \"test\",\n name,\n setEnv: true,\n });\n })().catch((err) => {\n writeCloneWorkerMemo(undefined);\n throw err;\n });\n writeCloneWorkerMemo({ promise, key });\n return promise;\n}\n"],"mappings":";;;;;;;;;;AA0BA,eAAsB,kBACpB,SACgC;CAChC,MAAM,SAAS,MAAMA,kBAAAA,gBAAgB;EACnC,MAAM,QAAQ;EACd,MAAM;EACN,QAAQ,QAAQ,WAAW;CAC7B,CAAC;CACD,IAAI,OAAO,WAAW,YAAY,OAAO;CAEzC,IAAI;EACF,MAAM,QAAQ,QAAQ;GACpB,aAAa,OAAO;GACpB,UAAU,OAAO;GACjB,cAAc,OAAO;GACrB,UAAU,OAAO;EACnB,CAAC;EACD,MAAMC,iBAAAA,aAAa;GACjB,MAAM,OAAO;GACb,MAAM;GACN,UAAU,OAAO;EACnB,CAAC;CACH,SAAS,KAAK;EACZ,IAAI;GACF,MAAMC,kBAAAA,QAAQ;IAAE,MAAM,OAAO;IAAM,MAAM;GAAO,CAAC;EACnD,QAAQ,CAER;EACA,MAAM,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;EAC9D,MAAM,IAAI,MACR,6DAA6D,OAAO,aAAa,+BAClD,UAC/B,EAAE,OAAO,IAAI,CACf;CACF;CAEA,OAAO;AACT;;AASA,MAAM,oBAAoB,OAAO,IAAI,iCAAiC;AAWtE,SAAS,sBAAmD;CAC1D,OAAQ,WAAyC;AACnD;AAEA,SAAS,qBAAqB,MAAyC;CACrE,MAAM,IAAI;CACV,IAAI,SAAS,KAAA,GAAW,OAAO,EAAE;MAC5B,EAAE,qBAAqB;AAC9B;AAEA,SAAS,kBAAkB,SAA6C;CACtE,OACE,QAAQ,QAAQ,QAAQ,IAAI,kBAAkB,QAAQ,IAAI,kBAAkB,OAAO,QAAQ,GAAG;AAElG;AAEA,SAAS,iBAAiB,MAA0B,MAAsB;CACxE,OAAO,GAAG,QAAQ,GAAG,IAAI;AAC3B;;;;;;;;;AAUA,SAAgB,oBAAoB,UAAsC,CAAC,GAAkB;CAC3F,MAAM,OAAO,kBAAkB,OAAO;CACtC,MAAM,MAAM,iBAAiB,QAAQ,MAAM,IAAI;CAC/C,MAAM,WAAW,oBAAoB;CACrC,IAAI,UAAU;EACZ,IAAI,SAAS,QAAQ,KACnB,MAAM,IAAI,MACR,wEACa,KAAK,UAAU,SAAS,GAAG,EAAE,SAAS,KAAK,UAAU,GAAG,EAAE,EACzE;EAEF,OAAO,SAAS;CAClB;CACA,MAAM,WAAW,YAAY;EAC3B,MAAMC,iBAAAA,0BAA0B;GAC9B,MAAM,QAAQ;GACd,MAAM;GACN;GACA,QAAQ;EACV,CAAC;CACH,EAAA,CAAG,CAAC,CAAC,OAAO,QAAQ;EAClB,qBAAqB,KAAA,CAAS;EAC9B,MAAM;CACR,CAAC;CACD,qBAAqB;EAAE;EAAS;CAAI,CAAC;CACrC,OAAO;AACT"}
@@ -0,0 +1,16 @@
1
+ //#region src/adapters/test-env.ts
2
+ /**
3
+ * Test-runner `setupFiles` entry: inject `DATABASE_URL` from `.cedarpg/test.env`.
4
+ *
5
+ * Required for Jest (globalSetup is a separate process). Optional for Vitest
6
+ * when the pool does not inherit env from the main process.
7
+ *
8
+ * ```js
9
+ * setupFiles: [require.resolve('@cedarjs/pg/test-env')]
10
+ * // or: setupFiles: ['@cedarjs/pg/test-env']
11
+ * ```
12
+ */
13
+ require("./load-test-env-Dcgh6YHV.cjs").loadTestEnv();
14
+ //#endregion
15
+
16
+ //# sourceMappingURL=test-env.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"test-env.cjs","names":["loadTestEnv"],"sources":["../src/adapters/test-env.ts"],"sourcesContent":["import { loadTestEnv } from \"./load-test-env.ts\";\n\n/**\n * Test-runner `setupFiles` entry: inject `DATABASE_URL` from `.cedarpg/test.env`.\n *\n * Required for Jest (globalSetup is a separate process). Optional for Vitest\n * when the pool does not inherit env from the main process.\n *\n * ```js\n * setupFiles: [require.resolve('@cedarjs/pg/test-env')]\n * // or: setupFiles: ['@cedarjs/pg/test-env']\n * ```\n */\nloadTestEnv();\n"],"mappings":";;;;;;;;;;;;sCAaAA,CAAAA,CAAAA,YAAY"}
@@ -0,0 +1 @@
1
+ export {}
@@ -0,0 +1 @@
1
+ export {}
@@ -0,0 +1,18 @@
1
+ import { t as loadTestEnv } from "./load-test-env-BqtA6V-d.mjs";
2
+ //#region src/adapters/test-env.ts
3
+ /**
4
+ * Test-runner `setupFiles` entry: inject `DATABASE_URL` from `.cedarpg/test.env`.
5
+ *
6
+ * Required for Jest (globalSetup is a separate process). Optional for Vitest
7
+ * when the pool does not inherit env from the main process.
8
+ *
9
+ * ```js
10
+ * setupFiles: [require.resolve('@cedarjs/pg/test-env')]
11
+ * // or: setupFiles: ['@cedarjs/pg/test-env']
12
+ * ```
13
+ */
14
+ loadTestEnv();
15
+ //#endregion
16
+ export {};
17
+
18
+ //# sourceMappingURL=test-env.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"test-env.mjs","names":[],"sources":["../src/adapters/test-env.ts"],"sourcesContent":["import { loadTestEnv } from \"./load-test-env.ts\";\n\n/**\n * Test-runner `setupFiles` entry: inject `DATABASE_URL` from `.cedarpg/test.env`.\n *\n * Required for Jest (globalSetup is a separate process). Optional for Vitest\n * when the pool does not inherit env from the main process.\n *\n * ```js\n * setupFiles: [require.resolve('@cedarjs/pg/test-env')]\n * // or: setupFiles: ['@cedarjs/pg/test-env']\n * ```\n */\nloadTestEnv();\n"],"mappings":";;;;;;;;;;;;;AAaA,YAAY"}