@stratal/testing 0.0.22 → 0.0.23

package/dist/vitest-plugin/index.d.mts

@@ -1,8 +1,42 @@
+import { r as DatabaseIsolation } from "../index-BIr5nLof.mjs";
+import { StratalEnv } from "stratal";
 import { cloudflareTest } from "@cloudflare/vitest-pool-workers";
 import { Plugin } from "vite";
 
 //#region src/vitest-plugin/stratal-test.d.ts
 type CloudflareTestOptions = Parameters<typeof cloudflareTest>[0];
+/** String keys of `StratalEnv` whose value is a Hyperdrive binding. */
+type HyperdriveKeys = Extract<{ [K in keyof StratalEnv]-?: StratalEnv[K] extends Hyperdrive ? K : never }[keyof StratalEnv], string>;
+/**
+ * Names of declared Hyperdrive bindings, drawn from the consumer's augmented
+ * `StratalEnv` (which extends `Cloudflare.Env`). Falls back to `string` only
+ * when no Hyperdrive binding is declared (nothing to constrain to).
+ */
+type HyperdriveBindingName = [HyperdriveKeys] extends [never] ? string : HyperdriveKeys;
+/** Stratal-specific test database configuration for {@link stratalTest}. */
+interface StratalTestDatabaseOptions {
+  /**
+   * Database isolation mode for parallel runs. Defaults to `'shared'`.
+   *
+   * - `'shared'` — all test files share one database (serial; today's behaviour).
+   * - `'database'` — each test file gets its own database cloned from a migrated
+   *   template (dropped on teardown), and file parallelism is enabled.
+   *
+   * Pair with `createTestDatabaseGlobalSetup({ isolation })` from
+   * `@stratal/testing/database` in your Vitest `globalSetup`.
+   */
+  isolation?: DatabaseIsolation;
+  /**
+   * Name of the Hyperdrive binding to isolate per test file. Defaults to `'DB'`.
+   * Constrained to Hyperdrive binding names declared on `Cloudflare.Env` /
+   * `StratalEnv`.
+   */
+  binding?: HyperdriveBindingName;
+}
+type WorkersPoolOptions = Exclude<CloudflareTestOptions, (...args: never[]) => unknown>;
+type StratalTestOptions = WorkersPoolOptions & {
+  database?: StratalTestDatabaseOptions;
+};
 /**
  * Returns a Vite plugin that forces CJS resolution for `pg` sub-dependencies.
  *
@@ -66,15 +100,17 @@ declare const fixNobleHashesCjs: () => Plugin;
 /**
  * Returns Vite plugins for Stratal tests running in the Cloudflare Workers (workerd) environment.
  *
- * Includes the cloudflare pool plugin and Stratal alias plugin.
- * Use inside a project-level `plugins` array.
+ * Includes the cloudflare pool plugin and Stratal alias plugin. Pass
+ * `database: { isolation: 'database' }` to give each test file its own
+ * database (cloned from a migrated template, dropped on teardown) and enable
+ * file parallelism. Use inside a project-level `plugins` array.
  *
  * **Note:** `fixPgCjs()` must be registered separately at the root `defineConfig` level.
  *
- * @param options - Same options as `cloudflareTest()` from `@cloudflare/vitest-pool-workers`
+ * @param options - `cloudflareTest()` options plus Stratal `database` options
  * @returns An array of Vite plugins
  */
-declare function stratalTest(options?: CloudflareTestOptions): Plugin[];
+declare function stratalTest(options?: StratalTestOptions): Plugin[];
 //#endregion
-export { fixNobleHashesCjs, fixPgCjs, stratalTest };
+export { type StratalTestDatabaseOptions, fixNobleHashesCjs, fixPgCjs, stratalTest };
 //# sourceMappingURL=index.d.mts.map

package/dist/vitest-plugin/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/vitest-plugin/stratal-test.ts"],"mappings":";;;;KAQK,qBAAA,GAAwB,UAAA,QAAkB,cAAA;;AAJD;;;;;AA0C9C;;;;;AA2CA;;;;;AA2DA;;;;;;;;;;;;;cAtGa,QAAA,QAAe,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA2Cf,iBAAA,QAAwB,MAAA;;;;;;;;;;;;iBA2DrB,WAAA,CAAY,OAAA,GAAS,qBAAA,GAA6B,MAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/vitest-plugin/stratal-test.ts"],"mappings":";;;;;;KAWK,qBAAA,GAAwB,UAAU,QAAQ,cAAA;;KAG1C,cAAA,GAAiB,OAAA,eACN,UAAA,KAAe,UAAA,CAAW,CAAA,UAAW,UAAA,GAAa,CAAA,iBAAkB,UAAA;;AAJvB;AAAA;;;KAaxD,qBAAA,IAAyB,cAAA,6BAA2C,cAAc;;UAGtE,0BAAA;EAZoC;;;;;;;;;;EAuBnD,SAAA,GAAY,iBAAA;EAvBuC;;;;AAAyC;EA6B5F,OAAA,GAAU,qBAAqB;AAAA;AAAA,KAG5B,kBAAA,GAAqB,OAAO,CAAC,qBAAA,MAA2B,IAAA;AAAA,KACxD,kBAAA,GAAqB,kBAAA;EAAuB,QAAA,GAAW,0BAA0B;AAAA;;;;;;;;;AAJrD;AAChC;;;;;;;;AAEgE;AAAA;;;;;;;;AACqB;AAsCtF;;cAAa,QAAA,QAAe,MAY1B;;AAAA;AA+BF;;;;AA0BC;AA4CD;;;;;;;;AAAqE;;;;;;;;;;;;;;cAtExD,iBAAA,QAAwB,MA0BpC;;;;;;;;;;;;;;iBA4Ce,WAAA,CAAY,OAAA,GAAS,kBAAA,GAA0B,MAAM"}

package/dist/vitest-plugin/index.mjs

@@ -1,3 +1,4 @@
+import { f as normalizeIsolation, r as ISOLATION_ENV_VAR, t as BINDING_ENV_VAR } from "../database-B02eYKhE.mjs";
 import { createRequire } from "node:module";
 import path from "node:path";
 import { cloudflareTest } from "@cloudflare/vitest-pool-workers";
@@ -102,34 +103,53 @@ const fixNobleHashesCjs = () => {
 		}
 	};
 };
-const stratalPlugin = {
+const createStratalPlugin = (isolation) => ({
 	name: "stratal-test",
 	config() {
-		return {
+		const config = {
 			resolve: { alias: {
 				tslib: "tslib/tslib.es6.mjs",
 				"@zenstackhq/language/ast": "@stratal/testing/mocks/zenstack-language",
 				"@zenstackhq/language/utils": "@stratal/testing/mocks/zenstack-language",
-				"@zenstackhq/language": "@stratal/testing/mocks/zenstack-language",
-				nodemailer: "@stratal/testing/mocks/nodemailer"
+				"@zenstackhq/language": "@stratal/testing/mocks/zenstack-language"
 			} },
 			ssr: { noExternal: ["@zenstackhq/better-auth"] }
 		};
+		if (isolation === "database") config.test = {
+			fileParallelism: true,
+			isolate: true
+		};
+		return config;
 	}
-};
+});
 /**
 * Returns Vite plugins for Stratal tests running in the Cloudflare Workers (workerd) environment.
 *
-* Includes the cloudflare pool plugin and Stratal alias plugin.
-* Use inside a project-level `plugins` array.
+* Includes the cloudflare pool plugin and Stratal alias plugin. Pass
+* `database: { isolation: 'database' }` to give each test file its own
+* database (cloned from a migrated template, dropped on teardown) and enable
+* file parallelism. Use inside a project-level `plugins` array.
 *
 * **Note:** `fixPgCjs()` must be registered separately at the root `defineConfig` level.
 *
-* @param options - Same options as `cloudflareTest()` from `@cloudflare/vitest-pool-workers`
+* @param options - `cloudflareTest()` options plus Stratal `database` options
 * @returns An array of Vite plugins
 */
 function stratalTest(options = {}) {
-	return [cloudflareTest(options), stratalPlugin];
+	const { database, ...cfOptions } = options;
+	const isolation = normalizeIsolation(database?.isolation);
+	const binding = database?.binding ?? "DB";
+	return [cloudflareTest({
+		...cfOptions,
+		miniflare: {
+			...cfOptions.miniflare,
+			bindings: {
+				...cfOptions.miniflare?.bindings,
+				[ISOLATION_ENV_VAR]: isolation,
+				[BINDING_ENV_VAR]: binding
+			}
+		}
+	}), createStratalPlugin(isolation)];
 }
 //#endregion
 export { fixNobleHashesCjs, fixPgCjs, stratalTest };

package/dist/vitest-plugin/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/vitest-plugin/stratal-test.ts"],"sourcesContent":["import { createRequire } from 'node:module'\nimport path from 'node:path'\n\nimport { cloudflareTest } from '@cloudflare/vitest-pool-workers'\nimport type { Plugin, UserConfig } from 'vite'\n\nconst require = createRequire(import.meta.url)\n\ntype CloudflareTestOptions = Parameters<typeof cloudflareTest>[0]\n\nconst pgCjsResolvers = new Map<string, () => string>([\n  ['pg-protocol', () => require.resolve('pg-protocol')],\n  ['pg-connection-string', () => require.resolve('pg-connection-string')],\n  ['pg-pool', () => require.resolve('pg-pool')],\n  ['pg-cloudflare', () => path.join(path.dirname(require.resolve('pg-cloudflare')), 'index.js')],\n])\n\n/**\n * Returns a Vite plugin that forces CJS resolution for `pg` sub-dependencies.\n *\n * `pg` is CJS but its dependencies (`pg-protocol`, `pg-connection-string`, `pg-pool`) ship\n * dual CJS/ESM exports. In workerd, the module fallback resolver prefers the ESM condition,\n * causing `SyntaxError: Cannot use import statement outside a module` when CJS `pg` does\n * `require()`. Additionally, `pg-cloudflare` uses a `workerd` export condition that the\n * root Vite instance doesn't resolve.\n *\n * Must be used at the **root** `defineConfig` level so that the\n * `@cloudflare/vitest-pool-workers` module fallback resolver (which uses the root Vite\n * instance) resolves pg sub-deps correctly.\n *\n * @example\n * ```ts\n * import { fixPgCjs, stratalTest } from '@stratal/testing/vitest-plugin'\n * import { defineConfig } from 'vitest/config'\n *\n * export default defineConfig({\n *   plugins: [fixPgCjs()],\n *   test: {\n *     projects: [{\n *       plugins: [stratalTest({ wrangler: { configPath: './wrangler.jsonc' } })],\n *       test: { name: 'e2e', include: ['test/e2e/**\\/*.spec.ts'] },\n *     }],\n *   },\n * })\n * ```\n */\nexport const fixPgCjs = (): Plugin => ({\n  name: 'stratal-pg-cjs',\n  enforce: 'pre',\n  resolveId(id) {\n    const resolver = pgCjsResolvers.get(id)\n    if (!resolver) return\n    try {\n      return resolver()\n    } catch {\n      return\n    }\n  },\n})\n\n/**\n * Returns a Vite plugin that forces CJS resolution for `@noble/hashes` subpaths\n * used by `@paralleldrive/cuid2@2.x` (the version `@zenstackhq/orm` depends on).\n *\n * cuid2@2.x is CJS and does `require(\"@noble/hashes/sha3\")` without the `.js`\n * extension. In a workspace that also installs `@noble/hashes@2.x` (ESM-only),\n * the hoisted v2 package has no extensionless `./sha3` entry in its exports\n * map, so Vite/workerd resolution fails. This plugin routes the extensionless\n * subpaths through the consumer's nested `@noble/hashes@1.x` (a sibling of\n * cuid2 under `@zenstackhq/orm/node_modules`), which ships proper CJS exports.\n *\n * If the consumer doesn't depend on `@zenstackhq/orm`, the plugin is a no-op.\n * Otherwise it throws loudly at config-resolution time if the resolution chain\n * is unexpectedly broken — surfacing dependency drift instead of letting the\n * symptom resurface as an opaque test failure.\n *\n * Must be used at the **root** `defineConfig` level (same constraint as\n * `fixPgCjs`).\n *\n * @example\n * ```ts\n * import { fixNobleHashesCjs, fixPgCjs, stratalTest } from '@stratal/testing/vitest-plugin'\n *\n * export default defineConfig({\n *   plugins: [fixPgCjs(), fixNobleHashesCjs()],\n *   // ...\n * })\n * ```\n */\nexport const fixNobleHashesCjs = (): Plugin => {\n  const ids = ['@noble/hashes/sha3', '@noble/hashes/crypto']\n  let resolved: Map<string, string> | null = null\n\n  return {\n    name: 'stratal-noble-hashes-cjs',\n    enforce: 'pre',\n    configResolved(config) {\n      const consumerRequire = createRequire(path.join(config.root, 'noop.js'))\n      let zenstackPath: string\n      try {\n        zenstackPath = consumerRequire.resolve('@zenstackhq/orm')\n      } catch {\n        // Consumer doesn't use ZenStack — nothing to fix.\n        return\n      }\n      const cuid2Path = createRequire(zenstackPath).resolve('@paralleldrive/cuid2')\n      const cuid2Require = createRequire(cuid2Path)\n      resolved = new Map<string, string>(\n        ids.map((id) => [id, cuid2Require.resolve(id)]),\n      )\n    },\n    resolveId(id) {\n      return resolved?.get(id)\n    },\n  }\n}\n\nconst stratalPlugin: Plugin = {\n  name: 'stratal-test',\n  config() {\n    return {\n      resolve: {\n        alias: {\n          tslib: 'tslib/tslib.es6.mjs',\n          '@zenstackhq/language/ast': '@stratal/testing/mocks/zenstack-language',\n          '@zenstackhq/language/utils': '@stratal/testing/mocks/zenstack-language',\n          '@zenstackhq/language': '@stratal/testing/mocks/zenstack-language',\n          nodemailer: '@stratal/testing/mocks/nodemailer',\n        },\n      },\n      ssr: {\n        noExternal: ['@zenstackhq/better-auth'],\n      },\n    } satisfies UserConfig\n  },\n}\n\n/**\n * Returns Vite plugins for Stratal tests running in the Cloudflare Workers (workerd) environment.\n *\n * Includes the cloudflare pool plugin and Stratal alias plugin.\n * Use inside a project-level `plugins` array.\n *\n * **Note:** `fixPgCjs()` must be registered separately at the root `defineConfig` level.\n *\n * @param options - Same options as `cloudflareTest()` from `@cloudflare/vitest-pool-workers`\n * @returns An array of Vite plugins\n */\nexport function stratalTest(options: CloudflareTestOptions = {}): Plugin[] {\n  return [cloudflareTest(options) as unknown as Plugin, stratalPlugin]\n}\n"],"mappings":";;;;AAMA,MAAM,UAAU,cAAc,OAAO,KAAK,IAAI;AAI9C,MAAM,iBAAiB,IAAI,IAA0B;CACnD,CAAC,qBAAqB,QAAQ,QAAQ,cAAc,CAAC;CACrD,CAAC,8BAA8B,QAAQ,QAAQ,uBAAuB,CAAC;CACvE,CAAC,iBAAiB,QAAQ,QAAQ,UAAU,CAAC;CAC7C,CAAC,uBAAuB,KAAK,KAAK,KAAK,QAAQ,QAAQ,QAAQ,gBAAgB,CAAC,EAAE,WAAW,CAAC;CAC/F,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BF,MAAa,kBAA0B;CACrC,MAAM;CACN,SAAS;CACT,UAAU,IAAI;EACZ,MAAM,WAAW,eAAe,IAAI,GAAG;EACvC,IAAI,CAAC,UAAU;EACf,IAAI;GACF,OAAO,UAAU;UACX;GACN;;;CAGL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BD,MAAa,0BAAkC;CAC7C,MAAM,MAAM,CAAC,sBAAsB,uBAAuB;CAC1D,IAAI,WAAuC;CAE3C,OAAO;EACL,MAAM;EACN,SAAS;EACT,eAAe,QAAQ;GACrB,MAAM,kBAAkB,cAAc,KAAK,KAAK,OAAO,MAAM,UAAU,CAAC;GACxE,IAAI;GACJ,IAAI;IACF,eAAe,gBAAgB,QAAQ,kBAAkB;WACnD;IAEN;;GAGF,MAAM,eAAe,cADH,cAAc,aAAa,CAAC,QAAQ,uBACV,CAAC;GAC7C,WAAW,IAAI,IACb,IAAI,KAAK,OAAO,CAAC,IAAI,aAAa,QAAQ,GAAG,CAAC,CAAC,CAChD;;EAEH,UAAU,IAAI;GACZ,OAAO,UAAU,IAAI,GAAG;;EAE3B;;AAGH,MAAM,gBAAwB;CAC5B,MAAM;CACN,SAAS;EACP,OAAO;GACL,SAAS,EACP,OAAO;IACL,OAAO;IACP,4BAA4B;IAC5B,8BAA8B;IAC9B,wBAAwB;IACxB,YAAY;IACb,EACF;GACD,KAAK,EACH,YAAY,CAAC,0BAA0B,EACxC;GACF;;CAEJ;;;;;;;;;;;;AAaD,SAAgB,YAAY,UAAiC,EAAE,EAAY;CACzE,OAAO,CAAC,eAAe,QAAQ,EAAuB,cAAc"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/vitest-plugin/stratal-test.ts"],"sourcesContent":["import { createRequire } from 'node:module'\nimport path from 'node:path'\n\nimport { cloudflareTest } from '@cloudflare/vitest-pool-workers'\nimport type { StratalEnv } from 'stratal'\nimport type { Plugin, UserConfig } from 'vite'\nimport type { TestUserConfig } from 'vitest/config'\nimport { BINDING_ENV_VAR, DEFAULT_DB_BINDING, ISOLATION_ENV_VAR, normalizeIsolation, type DatabaseIsolation } from '../database'\n\nconst require = createRequire(import.meta.url)\n\ntype CloudflareTestOptions = Parameters<typeof cloudflareTest>[0]\n\n/** String keys of `StratalEnv` whose value is a Hyperdrive binding. */\ntype HyperdriveKeys = Extract<\n  { [K in keyof StratalEnv]-?: StratalEnv[K] extends Hyperdrive ? K : never }[keyof StratalEnv],\n  string\n>\n\n/**\n * Names of declared Hyperdrive bindings, drawn from the consumer's augmented\n * `StratalEnv` (which extends `Cloudflare.Env`). Falls back to `string` only\n * when no Hyperdrive binding is declared (nothing to constrain to).\n */\ntype HyperdriveBindingName = [HyperdriveKeys] extends [never] ? string : HyperdriveKeys\n\n/** Stratal-specific test database configuration for {@link stratalTest}. */\nexport interface StratalTestDatabaseOptions {\n  /**\n   * Database isolation mode for parallel runs. Defaults to `'shared'`.\n   *\n   * - `'shared'` — all test files share one database (serial; today's behaviour).\n   * - `'database'` — each test file gets its own database cloned from a migrated\n   *   template (dropped on teardown), and file parallelism is enabled.\n   *\n   * Pair with `createTestDatabaseGlobalSetup({ isolation })` from\n   * `@stratal/testing/database` in your Vitest `globalSetup`.\n   */\n  isolation?: DatabaseIsolation\n  /**\n   * Name of the Hyperdrive binding to isolate per test file. Defaults to `'DB'`.\n   * Constrained to Hyperdrive binding names declared on `Cloudflare.Env` /\n   * `StratalEnv`.\n   */\n  binding?: HyperdriveBindingName\n}\n\ntype WorkersPoolOptions = Exclude<CloudflareTestOptions, (...args: never[]) => unknown>\ntype StratalTestOptions = WorkersPoolOptions & { database?: StratalTestDatabaseOptions }\n\nconst pgCjsResolvers = new Map<string, () => string>([\n  ['pg-protocol', () => require.resolve('pg-protocol')],\n  ['pg-connection-string', () => require.resolve('pg-connection-string')],\n  ['pg-pool', () => require.resolve('pg-pool')],\n  ['pg-cloudflare', () => path.join(path.dirname(require.resolve('pg-cloudflare')), 'index.js')],\n])\n\n/**\n * Returns a Vite plugin that forces CJS resolution for `pg` sub-dependencies.\n *\n * `pg` is CJS but its dependencies (`pg-protocol`, `pg-connection-string`, `pg-pool`) ship\n * dual CJS/ESM exports. In workerd, the module fallback resolver prefers the ESM condition,\n * causing `SyntaxError: Cannot use import statement outside a module` when CJS `pg` does\n * `require()`. Additionally, `pg-cloudflare` uses a `workerd` export condition that the\n * root Vite instance doesn't resolve.\n *\n * Must be used at the **root** `defineConfig` level so that the\n * `@cloudflare/vitest-pool-workers` module fallback resolver (which uses the root Vite\n * instance) resolves pg sub-deps correctly.\n *\n * @example\n * ```ts\n * import { fixPgCjs, stratalTest } from '@stratal/testing/vitest-plugin'\n * import { defineConfig } from 'vitest/config'\n *\n * export default defineConfig({\n *   plugins: [fixPgCjs()],\n *   test: {\n *     projects: [{\n *       plugins: [stratalTest({ wrangler: { configPath: './wrangler.jsonc' } })],\n *       test: { name: 'e2e', include: ['test/e2e/**\\/*.spec.ts'] },\n *     }],\n *   },\n * })\n * ```\n */\nexport const fixPgCjs = (): Plugin => ({\n  name: 'stratal-pg-cjs',\n  enforce: 'pre',\n  resolveId(id) {\n    const resolver = pgCjsResolvers.get(id)\n    if (!resolver) return\n    try {\n      return resolver()\n    } catch {\n      return\n    }\n  },\n})\n\n/**\n * Returns a Vite plugin that forces CJS resolution for `@noble/hashes` subpaths\n * used by `@paralleldrive/cuid2@2.x` (the version `@zenstackhq/orm` depends on).\n *\n * cuid2@2.x is CJS and does `require(\"@noble/hashes/sha3\")` without the `.js`\n * extension. In a workspace that also installs `@noble/hashes@2.x` (ESM-only),\n * the hoisted v2 package has no extensionless `./sha3` entry in its exports\n * map, so Vite/workerd resolution fails. This plugin routes the extensionless\n * subpaths through the consumer's nested `@noble/hashes@1.x` (a sibling of\n * cuid2 under `@zenstackhq/orm/node_modules`), which ships proper CJS exports.\n *\n * If the consumer doesn't depend on `@zenstackhq/orm`, the plugin is a no-op.\n * Otherwise it throws loudly at config-resolution time if the resolution chain\n * is unexpectedly broken — surfacing dependency drift instead of letting the\n * symptom resurface as an opaque test failure.\n *\n * Must be used at the **root** `defineConfig` level (same constraint as\n * `fixPgCjs`).\n *\n * @example\n * ```ts\n * import { fixNobleHashesCjs, fixPgCjs, stratalTest } from '@stratal/testing/vitest-plugin'\n *\n * export default defineConfig({\n *   plugins: [fixPgCjs(), fixNobleHashesCjs()],\n *   // ...\n * })\n * ```\n */\nexport const fixNobleHashesCjs = (): Plugin => {\n  const ids = ['@noble/hashes/sha3', '@noble/hashes/crypto']\n  let resolved: Map<string, string> | null = null\n\n  return {\n    name: 'stratal-noble-hashes-cjs',\n    enforce: 'pre',\n    configResolved(config) {\n      const consumerRequire = createRequire(path.join(config.root, 'noop.js'))\n      let zenstackPath: string\n      try {\n        zenstackPath = consumerRequire.resolve('@zenstackhq/orm')\n      } catch {\n        // Consumer doesn't use ZenStack — nothing to fix.\n        return\n      }\n      const cuid2Path = createRequire(zenstackPath).resolve('@paralleldrive/cuid2')\n      const cuid2Require = createRequire(cuid2Path)\n      resolved = new Map<string, string>(\n        ids.map((id) => [id, cuid2Require.resolve(id)]),\n      )\n    },\n    resolveId(id) {\n      return resolved?.get(id)\n    },\n  }\n}\n\nconst createStratalPlugin = (isolation: DatabaseIsolation): Plugin => ({\n  name: 'stratal-test',\n  config() {\n    const config: UserConfig & { test?: TestUserConfig } = {\n      resolve: {\n        alias: {\n          tslib: 'tslib/tslib.es6.mjs',\n          '@zenstackhq/language/ast': '@stratal/testing/mocks/zenstack-language',\n          '@zenstackhq/language/utils': '@stratal/testing/mocks/zenstack-language',\n          '@zenstackhq/language': '@stratal/testing/mocks/zenstack-language',\n        },\n      },\n      ssr: {\n        noExternal: ['@zenstackhq/better-auth'],\n      },\n    }\n\n    // In 'database' mode each test file owns its database, so enable file\n    // parallelism + isolation. In 'shared' mode leave these untouched so the\n    // project's own defaults stand (forcing them would alter maxWorkers and\n    // can collide with sibling projects' sequence.groupOrder).\n    if (isolation === 'database') {\n      config.test = { fileParallelism: true, isolate: true }\n    }\n\n    return config\n  },\n})\n\n/**\n * Returns Vite plugins for Stratal tests running in the Cloudflare Workers (workerd) environment.\n *\n * Includes the cloudflare pool plugin and Stratal alias plugin. Pass\n * `database: { isolation: 'database' }` to give each test file its own\n * database (cloned from a migrated template, dropped on teardown) and enable\n * file parallelism. Use inside a project-level `plugins` array.\n *\n * **Note:** `fixPgCjs()` must be registered separately at the root `defineConfig` level.\n *\n * @param options - `cloudflareTest()` options plus Stratal `database` options\n * @returns An array of Vite plugins\n */\nexport function stratalTest(options: StratalTestOptions = {}): Plugin[] {\n  const { database, ...cfOptions } = options\n  const isolation = normalizeIsolation(database?.isolation)\n  const binding = database?.binding ?? DEFAULT_DB_BINDING\n\n  // Expose the mode + binding name to the worker as env vars so\n  // TestingModule.compile() can decide whether and what to provision.\n  const merged = {\n    ...cfOptions,\n    miniflare: {\n      ...cfOptions.miniflare,\n      bindings: {\n        ...(cfOptions.miniflare?.bindings as Record<string, unknown> | undefined),\n        [ISOLATION_ENV_VAR]: isolation,\n        [BINDING_ENV_VAR]: binding,\n      },\n    },\n  }\n\n  return [cloudflareTest(merged) as unknown as Plugin, createStratalPlugin(isolation)]\n}\n"],"mappings":";;;;;AASA,MAAM,UAAU,cAAc,OAAO,KAAK,GAAG;AAyC7C,MAAM,iBAAiB,IAAI,IAA0B;CACnD,CAAC,qBAAqB,QAAQ,QAAQ,aAAa,CAAC;CACpD,CAAC,8BAA8B,QAAQ,QAAQ,sBAAsB,CAAC;CACtE,CAAC,iBAAiB,QAAQ,QAAQ,SAAS,CAAC;CAC5C,CAAC,uBAAuB,KAAK,KAAK,KAAK,QAAQ,QAAQ,QAAQ,eAAe,CAAC,GAAG,UAAU,CAAC;AAC/F,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BD,MAAa,kBAA0B;CACrC,MAAM;CACN,SAAS;CACT,UAAU,IAAI;EACZ,MAAM,WAAW,eAAe,IAAI,EAAE;EACtC,IAAI,CAAC,UAAU;EACf,IAAI;GACF,OAAO,SAAS;EAClB,QAAQ;GACN;EACF;CACF;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAa,0BAAkC;CAC7C,MAAM,MAAM,CAAC,sBAAsB,sBAAsB;CACzD,IAAI,WAAuC;CAE3C,OAAO;EACL,MAAM;EACN,SAAS;EACT,eAAe,QAAQ;GACrB,MAAM,kBAAkB,cAAc,KAAK,KAAK,OAAO,MAAM,SAAS,CAAC;GACvE,IAAI;GACJ,IAAI;IACF,eAAe,gBAAgB,QAAQ,iBAAiB;GAC1D,QAAQ;IAEN;GACF;GAEA,MAAM,eAAe,cADH,cAAc,YAAY,EAAE,QAAQ,sBACX,CAAC;GAC5C,WAAW,IAAI,IACb,IAAI,KAAK,OAAO,CAAC,IAAI,aAAa,QAAQ,EAAE,CAAC,CAAC,CAChD;EACF;EACA,UAAU,IAAI;GACZ,OAAO,UAAU,IAAI,EAAE;EACzB;CACF;AACF;AAEA,MAAM,uBAAuB,eAA0C;CACrE,MAAM;CACN,SAAS;EACP,MAAM,SAAiD;GACrD,SAAS,EACP,OAAO;IACL,OAAO;IACP,4BAA4B;IAC5B,8BAA8B;IAC9B,wBAAwB;GAC1B,EACF;GACA,KAAK,EACH,YAAY,CAAC,yBAAyB,EACxC;EACF;EAMA,IAAI,cAAc,YAChB,OAAO,OAAO;GAAE,iBAAiB;GAAM,SAAS;EAAK;EAGvD,OAAO;CACT;AACF;;;;;;;;;;;;;;AAeA,SAAgB,YAAY,UAA8B,CAAC,GAAa;CACtE,MAAM,EAAE,UAAU,GAAG,cAAc;CACnC,MAAM,YAAY,mBAAmB,UAAU,SAAS;CACxD,MAAM,UAAU,UAAU,WAAA;CAgB1B,OAAO,CAAC,eAAe;EAXrB,GAAG;EACH,WAAW;GACT,GAAG,UAAU;GACb,UAAU;IACR,GAAI,UAAU,WAAW;KACxB,oBAAoB;KACpB,kBAAkB;GACrB;EACF;CAG0B,CAAC,GAAwB,oBAAoB,SAAS,CAAC;AACrF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stratal/testing",
-  "version": "0.0.22",
+  "version": "0.0.23",
   "description": "Testing utilities and mocks for Stratal framework applications",
   "type": "module",
   "license": "MIT",
@@ -37,14 +37,18 @@
       "types": "./dist/index.d.mts",
       "import": "./dist/index.mjs"
     },
+    "./database": {
+      "types": "./dist/database/index.d.mts",
+      "import": "./dist/database/index.mjs"
+    },
+    "./feature-flags": {
+      "types": "./dist/feature-flags/index.d.mts",
+      "import": "./dist/feature-flags/index.mjs"
+    },
     "./mocks": {
       "types": "./dist/mocks/index.d.mts",
       "import": "./dist/mocks/index.mjs"
     },
-    "./mocks/nodemailer": {
-      "types": "./dist/mocks/nodemailer.d.mts",
-      "import": "./dist/mocks/nodemailer.mjs"
-    },
     "./mocks/zenstack-language": {
       "types": "./dist/mocks/zenstack-language.d.mts",
       "import": "./dist/mocks/zenstack-language.mjs"
@@ -66,14 +70,15 @@
     "lint:fix": "npx oxlint --fix ."
   },
   "dependencies": {
-    "@cloudflare/vitest-pool-workers": "^0.16.3",
+    "@cloudflare/vitest-pool-workers": "^0.16.12",
     "@golevelup/ts-vitest": "^4.0.0",
-    "msw": "^2.14.5"
+    "msw": "^2.14.6"
   },
   "peerDependencies": {
-    "@stratal/framework": ">=0.0.22",
+    "@stratal/framework": ">=0.0.23",
     "better-auth": ">=1.4",
-    "stratal": ">=0.0.22",
+    "pg": "^8.0.0",
+    "stratal": ">=0.0.23",
     "vitest": "^4.1.0"
   },
   "peerDependenciesMeta": {
@@ -82,18 +87,23 @@
     },
     "better-auth": {
       "optional": true
+    },
+    "pg": {
+      "optional": true
     }
   },
   "devDependencies": {
-    "@cloudflare/workers-types": "4.20260510.1",
+    "@cloudflare/workers-types": "4.20260603.1",
     "@stratal/framework": "workspace:*",
-    "@types/node": "^25.6.2",
-    "@vitest/runner": "~4.1.5",
-    "@vitest/snapshot": "~4.1.5",
-    "better-auth": "^1.6.11",
+    "@types/node": "^25.9.1",
+    "@types/pg": "^8.20.0",
+    "@vitest/runner": "~4.1.8",
+    "@vitest/snapshot": "~4.1.8",
+    "better-auth": "^1.6.14",
+    "pg": "^8.21.0",
     "stratal": "workspace:*",
-    "tsdown": "^0.22.0",
+    "tsdown": "^0.22.1",
     "typescript": "^6.0.3",
-    "vitest": "~4.1.5"
+    "vitest": "~4.1.8"
   }
 }

package/dist/index-D-Q2cR2v.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-D-Q2cR2v.d.mts","names":[],"sources":["../src/storage/fake-storage.service.ts"],"mappings":";;;;;AAkBA;UAAiB,UAAA;EACf,OAAA,EAAS,UAAA;EACT,QAAA;EACA,IAAA;EACA,QAAA,GAAW,MAAA;EACX,UAAA,EAAY,IAAA;AAAA;;;;;;;;;;;AAoBd;;;;;;;cACa,kBAAA,SAA2B,cAAA;EAAA,mBAKjB,cAAA,EAAgB,qBAAA;EAAA,mBAEhB,OAAA,EAAS,aAAA;EAAA,QANtB,KAAA;cAIa,cAAA,EAAgB,qBAAA,EAEhB,OAAA,EAAS,aAAA;EAsCN;;;EA9BlB,MAAA,CACJ,IAAA,EAAM,8BAAA,EACN,YAAA,UACA,OAAA,EAAS,aAAA,EACT,IAAA,YACC,OAAA,CAAQ,YAAA;EAoER;;;EA3CH,QAAA,CAAS,IAAA,WAAe,OAAA,CAAQ,cAAA;EA+D7B;;;EAtCH,MAAA,CAAO,IAAA,WAAe,OAAA;EAkDX;;;EA1CX,MAAA,CAAO,IAAA,WAAe,OAAA;EAyHC;;;EAlHvB,uBAAA,CACE,IAAA,UACA,SAAA,YACC,OAAA,CAAQ,kBAAA;EAxF2B;;;EA+FtC,qBAAA,CACE,IAAA,UACA,SAAA,YACC,OAAA,CAAQ,kBAAA;EA3FmB;;;EAkG9B,qBAAA,CACE,IAAA,UACA,SAAA,YACC,OAAA,CAAQ,kBAAA;EAvGU;;;EA8Gf,aAAA,CACJ,IAAA,EAAM,8BAAA,EACN,IAAA,UACA,OAAA,EAAS,IAAA,CAAK,aAAA;IAA2B,IAAA;EAAA,GACzC,IAAA,YACC,OAAA,CAAQ,YAAA;EAvGT;;;;;;EAwHF,YAAA,CAAa,IAAA;EA5FJ;;;;;;EAyGT,aAAA,CAAc,IAAA;EAxEP;;;;;EAoFP,WAAA,CAAA;EA1EW;;;;;;EAuFX,WAAA,CAAY,KAAA;EArEV;;;EA+EF,cAAA,CAAA,GAAkB,GAAA,SAAY,UAAA;EAtExB;;;EA6EN,cAAA,CAAA;EA1EW;;;EAiFX,OAAA,CAAQ,IAAA,WAAe,UAAA;EAhFrB;;;EAuFF,KAAA,CAAA;EAAA,QAQQ,kBAAA;EAAA,QAeM,gBAAA;AAAA"}

package/dist/mocks/nodemailer.d.mts

@@ -1,12 +0,0 @@
-//#region src/mocks/nodemailer.d.ts
-declare const _default: {
-  createTransport: () => {
-    sendMail: () => Promise<{}>;
-  };
-};
-declare const createTransport: () => {
-  sendMail: () => Promise<{}>;
-};
-//#endregion
-export { createTransport, _default as default };
-//# sourceMappingURL=nodemailer.d.mts.map

package/dist/mocks/nodemailer.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"nodemailer.d.mts","names":[],"sources":["../../src/mocks/nodemailer.ts"],"mappings":";;;;;;cAMa,eAAA;kBAEX,OAAA;AAAA"}

package/dist/mocks/nodemailer.mjs

@@ -1,7 +0,0 @@
-//#region src/mocks/nodemailer.ts
-var nodemailer_default = { createTransport: () => ({ sendMail: () => Promise.resolve({}) }) };
-const createTransport = () => ({ sendMail: () => Promise.resolve({}) });
-//#endregion
-export { createTransport, nodemailer_default as default };
-
-//# sourceMappingURL=nodemailer.mjs.map

package/dist/mocks/nodemailer.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"nodemailer.mjs","names":[],"sources":["../../src/mocks/nodemailer.ts"],"sourcesContent":["export default {\n  createTransport: () => ({\n    sendMail: () => Promise.resolve({}),\n  }),\n}\n\nexport const createTransport = () => ({\n  sendMail: () => Promise.resolve({}),\n})\n"],"mappings":";AAAA,IAAA,qBAAe,EACb,wBAAwB,EACtB,gBAAgB,QAAQ,QAAQ,EAAE,CAAC,EACpC,GACF;AAED,MAAa,yBAAyB,EACpC,gBAAgB,QAAQ,QAAQ,EAAE,CAAC,EACpC"}