@venturekit/testing 0.0.0-dev.20260701100017

package/dist/db.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Database reset helpers for integration tests.
+ *
+ * These lazy-import `@venturekit/data` (an optional peer dependency) and
+ * connect using the same env the app does (`DATABASE_URL` / `DB_*`). Run
+ * them from a test `beforeEach`/`globalSetup` to return the DB to a known
+ * state between specs.
+ *
+ * The pure SQL builders live in `sql.ts` and are unit-tested there; this
+ * module is the thin IO wrapper.
+ */
+export interface TruncateOptions {
+    /** Schema to operate on. Default `public`. */
+    schema?: string;
+    /** Extra table names to preserve (never truncated). */
+    exclude?: string[];
+    /** Append `RESTART IDENTITY`. Default `true`. */
+    restartIdentity?: boolean;
+    /** Append `CASCADE`. Default `true`. */
+    cascade?: boolean;
+}
+/** List all table names in a schema (default `public`). */
+export declare function listTables(schema?: string): Promise<string[]>;
+/** Truncate the given tables in a single statement. No-op for an empty list. */
+export declare function truncateTables(tables: string[], options?: TruncateOptions): Promise<void>;
+/**
+ * Truncate every table in the schema EXCEPT the VentureKit migration/seed
+ * tracking tables (and any caller-supplied exclusions). Returns the list
+ * of tables that were truncated.
+ */
+export declare function truncateAllTables(options?: TruncateOptions): Promise<string[]>;
+//# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiBH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,iDAAiD;IACjD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,wCAAwC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,2DAA2D;AAC3D,wBAAsB,UAAU,CAAC,MAAM,SAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOrE;AAED,gFAAgF;AAChF,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAMxF"}

package/dist/db.js

@@ -0,0 +1,52 @@
+/**
+ * Database reset helpers for integration tests.
+ *
+ * These lazy-import `@venturekit/data` (an optional peer dependency) and
+ * connect using the same env the app does (`DATABASE_URL` / `DB_*`). Run
+ * them from a test `beforeEach`/`globalSetup` to return the DB to a known
+ * state between specs.
+ *
+ * The pure SQL builders live in `sql.ts` and are unit-tested there; this
+ * module is the thin IO wrapper.
+ */
+import { buildTruncateSql, filterTruncatableTables } from './sql.js';
+async function loadData() {
+    try {
+        return await import('@venturekit/data');
+    }
+    catch {
+        throw new Error("@venturekit/testing: database helpers require '@venturekit/data'. " +
+            'Install it as a dev dependency (e.g. `pnpm add -D @venturekit/data`).');
+    }
+}
+/** List all table names in a schema (default `public`). */
+export async function listTables(schema = 'public') {
+    const { query } = await loadData();
+    const rows = await query(`SELECT tablename FROM pg_tables WHERE schemaname = $1 ORDER BY tablename`, [schema]);
+    return rows.map((row) => row.tablename);
+}
+/** Truncate the given tables in a single statement. No-op for an empty list. */
+export async function truncateTables(tables, options = {}) {
+    if (tables.length === 0)
+        return;
+    const { query } = await loadData();
+    const sql = buildTruncateSql(tables, {
+        schema: options.schema ?? 'public',
+        restartIdentity: options.restartIdentity,
+        cascade: options.cascade,
+    });
+    await query(sql);
+}
+/**
+ * Truncate every table in the schema EXCEPT the VentureKit migration/seed
+ * tracking tables (and any caller-supplied exclusions). Returns the list
+ * of tables that were truncated.
+ */
+export async function truncateAllTables(options = {}) {
+    const schema = options.schema ?? 'public';
+    const all = await listTables(schema);
+    const tables = filterTruncatableTables(all, options.exclude ?? []);
+    await truncateTables(tables, { ...options, schema });
+    return tables;
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAIrE,KAAK,UAAU,QAAQ;IACrB,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,oEAAoE;YAClE,uEAAuE,CAC1E,CAAC;IACJ,CAAC;AACH,CAAC;AAaD,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAM,GAAG,QAAQ;IAChD,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,MAAM,KAAK,CACtB,0EAA0E,EAC1E,CAAC,MAAM,CAAC,CACT,CAAC;IACF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAA0B,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AACjE,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAgB,EAChB,UAA2B,EAAE;IAE7B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAChC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,EAAE,CAAC;IACnC,MAAM,GAAG,GAAG,gBAAgB,CAAC,MAAM,EAAE;QACnC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,QAAQ;QAClC,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAC;IACH,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,UAA2B,EAAE;IACnE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC;IAC1C,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,uBAAuB,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IACnE,MAAM,cAAc,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Error raised by the test API client on a non-2xx response.
+ *
+ * VentureKit's runtime wraps every error as `{ error: { code, message,
+ * details? }, meta? }` (see `@venturekit/runtime` `response.ts`). The
+ * client parses that envelope and surfaces `code` / `details` here so
+ * assertions can target the framework's stable error codes
+ * (e.g. `VALIDATION_ERROR`, `NOT_FOUND`, `FORBIDDEN`) instead of brittle
+ * message strings.
+ */
+export interface ApiErrorInit {
+    status: number;
+    method: string;
+    url: string;
+    message: string;
+    /** The `error.code` from the VentureKit error envelope, when present. */
+    code?: string;
+    /** The `error.details` from the envelope (e.g. Zod field errors). */
+    details?: unknown;
+    /** The full parsed response body (or raw text when not JSON). */
+    body?: unknown;
+}
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly method: string;
+    readonly url: string;
+    readonly code?: string;
+    readonly details?: unknown;
+    readonly body?: unknown;
+    constructor(init: ApiErrorInit);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;gBAEZ,IAAI,EAAE,YAAY;CAa/B"}

package/dist/errors.js

@@ -0,0 +1,22 @@
+export class ApiError extends Error {
+    status;
+    method;
+    url;
+    code;
+    details;
+    body;
+    constructor(init) {
+        super(init.message);
+        this.name = 'ApiError';
+        this.status = init.status;
+        this.method = init.method;
+        this.url = init.url;
+        this.code = init.code;
+        this.details = init.details;
+        this.body = init.body;
+        // Restore the prototype chain — required when targeting ES2022 with
+        // a transpiled `extends Error` so `instanceof ApiError` holds.
+        Object.setPrototypeOf(this, ApiError.prototype);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAuBA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,MAAM,CAAS;IACf,MAAM,CAAS;IACf,GAAG,CAAS;IACZ,IAAI,CAAU;IACd,OAAO,CAAW;IAClB,IAAI,CAAW;IAExB,YAAY,IAAkB;QAC5B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,oEAAoE;QACpE,+DAA+D;QAC/D,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @venturekit/testing
+ *
+ * Integration & end-to-end test harness for VentureKit apps.
+ *
+ * - Launch a full local stack (`startTestStack`) — migrate + `vk dev`.
+ * - Wait for readiness (`waitForReady`) against `/_dev/health`.
+ * - Seed cognito-local users (`createTestUser`) and mint JWTs (`loginAs`).
+ * - Reset the database between specs (`truncateAllTables`).
+ * - Drive the API with a typed client (`createApiClient`).
+ */
+export { ApiError } from './errors.js';
+export type { ApiErrorInit } from './errors.js';
+export { createApiClient, buildUrl } from './client.js';
+export type { ApiClient, ApiClientOptions, ApiResponse, RequestOptions, } from './client.js';
+export { waitForReady, vkDevServerReady } from './ready.js';
+export type { WaitForReadyOptions } from './ready.js';
+export { createTestUser, deleteTestUser, setTestUserAttributes, getDevPools, } from './cognito.js';
+export type { DevServerRef, CreateTestUserInput, DevPool, DevPoolsResult, } from './cognito.js';
+export { signInWithPassword, loginAs, DEFAULT_COGNITO_ENDPOINT, DEFAULT_COGNITO_REGION, } from './auth-tokens.js';
+export type { TokenSet, SignInInput, LoginAsInput } from './auth-tokens.js';
+export { startTestStack } from './stack.js';
+export type { StartTestStackOptions, TestStack } from './stack.js';
+export { truncateAllTables, truncateTables, listTables, } from './db.js';
+export type { TruncateOptions } from './db.js';
+export { buildTruncateSql, filterTruncatableTables, quoteIdent, VK_TRACKING_TABLES, } from './sql.js';
+export type { TruncateSqlOptions } from './sql.js';
+export type { FetchImpl, AuthInit, QueryValue } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC5D,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EACL,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,OAAO,EACP,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,kBAAkB,EAClB,OAAO,EACP,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE5E,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEnE,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,UAAU,GACX,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,UAAU,EACV,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * @venturekit/testing
+ *
+ * Integration & end-to-end test harness for VentureKit apps.
+ *
+ * - Launch a full local stack (`startTestStack`) — migrate + `vk dev`.
+ * - Wait for readiness (`waitForReady`) against `/_dev/health`.
+ * - Seed cognito-local users (`createTestUser`) and mint JWTs (`loginAs`).
+ * - Reset the database between specs (`truncateAllTables`).
+ * - Drive the API with a typed client (`createApiClient`).
+ */
+export { ApiError } from './errors.js';
+export { createApiClient, buildUrl } from './client.js';
+export { waitForReady, vkDevServerReady } from './ready.js';
+export { createTestUser, deleteTestUser, setTestUserAttributes, getDevPools, } from './cognito.js';
+export { signInWithPassword, loginAs, DEFAULT_COGNITO_ENDPOINT, DEFAULT_COGNITO_REGION, } from './auth-tokens.js';
+export { startTestStack } from './stack.js';
+export { truncateAllTables, truncateTables, listTables, } from './db.js';
+export { buildTruncateSql, filterTruncatableTables, quoteIdent, VK_TRACKING_TABLES, } from './sql.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAQxD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG5D,OAAO,EACL,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,WAAW,GACZ,MAAM,cAAc,CAAC;AAQtB,OAAO,EACL,kBAAkB,EAClB,OAAO,EACP,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,UAAU,GACX,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,UAAU,EACV,kBAAkB,GACnB,MAAM,UAAU,CAAC"}

package/dist/ready.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Poll an HTTP endpoint until a VentureKit dev server (or any app health
+ * route) is ready to serve requests.
+ *
+ * The default target is `/_dev/health`, the unconditional liveness probe
+ * the `vk dev` server exposes (it returns `{ vk: 'dev-server', ... }`).
+ * Pass `validate: vkDevServerReady` to also assert the `vk` discriminator
+ * — useful when a Playwright `webServer.url` might otherwise match an
+ * unrelated process bound to the same port.
+ */
+import type { FetchImpl } from './types.js';
+export interface WaitForReadyOptions {
+    /** Base URL of the server, e.g. `http://localhost:4001`. */
+    baseUrl: string;
+    /** Path to probe. Default `/_dev/health`. */
+    path?: string;
+    /** Total time to wait before giving up, in ms. Default 60_000. */
+    timeoutMs?: number;
+    /** Delay between attempts, in ms. Default 500. */
+    intervalMs?: number;
+    /**
+     * Decide whether a response means "ready". Default: `res.ok`.
+     * Receives the parsed JSON body (or `undefined` if not JSON) + the response.
+     */
+    validate?: (body: unknown, res: Response) => boolean;
+    /** `fetch` implementation. Defaults to the global `fetch`. */
+    fetch?: FetchImpl;
+    /** Sleep implementation. Injectable for deterministic unit tests. */
+    sleep?: (ms: number) => Promise<void>;
+    /** Clock. Injectable for deterministic unit tests. Defaults to `Date.now`. */
+    now?: () => number;
+}
+/**
+ * Stricter predicate that also asserts the response is a `vk dev` server
+ * (the `/_dev/health` probe returns `{ vk: 'dev-server' }`). Guards
+ * against a stray process answering on the same port.
+ */
+export declare function vkDevServerReady(body: unknown, res: Response): boolean;
+/**
+ * Resolve once the endpoint is ready, or throw after `timeoutMs`.
+ */
+export declare function waitForReady(options: WaitForReadyOptions): Promise<void>;
+//# sourceMappingURL=ready.d.ts.map

package/dist/ready.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ready.d.ts","sourceRoot":"","sources":["../src/ready.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC;IACrD,8DAA8D;IAC9D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,qEAAqE;IACrE,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAOD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAOtE;AAWD;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwC9E"}

package/dist/ready.js

@@ -0,0 +1,67 @@
+/**
+ * Poll an HTTP endpoint until a VentureKit dev server (or any app health
+ * route) is ready to serve requests.
+ *
+ * The default target is `/_dev/health`, the unconditional liveness probe
+ * the `vk dev` server exposes (it returns `{ vk: 'dev-server', ... }`).
+ * Pass `validate: vkDevServerReady` to also assert the `vk` discriminator
+ * — useful when a Playwright `webServer.url` might otherwise match an
+ * unrelated process bound to the same port.
+ */
+/** Default readiness predicate — any 2xx response. */
+function defaultValidate(_body, res) {
+    return res.ok;
+}
+/**
+ * Stricter predicate that also asserts the response is a `vk dev` server
+ * (the `/_dev/health` probe returns `{ vk: 'dev-server' }`). Guards
+ * against a stray process answering on the same port.
+ */
+export function vkDevServerReady(body, res) {
+    return (res.ok &&
+        !!body &&
+        typeof body === 'object' &&
+        body.vk === 'dev-server');
+}
+function defaultSleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function errorMessage(err) {
+    if (err instanceof Error)
+        return err.message;
+    return String(err);
+}
+/**
+ * Resolve once the endpoint is ready, or throw after `timeoutMs`.
+ */
+export async function waitForReady(options) {
+    const { baseUrl, path = '/_dev/health', timeoutMs = 60_000, intervalMs = 500, validate = defaultValidate, fetch: doFetch = fetch, sleep = defaultSleep, now = Date.now, } = options;
+    const url = `${baseUrl.replace(/\/+$/, '')}${path.startsWith('/') ? path : `/${path}`}`;
+    const deadline = now() + timeoutMs;
+    let lastError;
+    for (;;) {
+        try {
+            const res = await doFetch(url, { method: 'GET' });
+            let body;
+            try {
+                const text = await res.text();
+                body = text ? JSON.parse(text) : undefined;
+            }
+            catch {
+                body = undefined;
+            }
+            if (validate(body, res))
+                return;
+            lastError = new Error(`unexpected response: HTTP ${res.status}`);
+        }
+        catch (err) {
+            lastError = err;
+        }
+        if (now() >= deadline) {
+            throw new Error(`waitForReady: timed out after ${timeoutMs}ms waiting for ${url}` +
+                (lastError ? ` (last error: ${errorMessage(lastError)})` : ''));
+        }
+        await sleep(intervalMs);
+    }
+}
+//# sourceMappingURL=ready.js.map

package/dist/ready.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ready.js","sourceRoot":"","sources":["../src/ready.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA0BH,sDAAsD;AACtD,SAAS,eAAe,CAAC,KAAc,EAAE,GAAa;IACpD,OAAO,GAAG,CAAC,EAAE,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAa,EAAE,GAAa;IAC3D,OAAO,CACL,GAAG,CAAC,EAAE;QACN,CAAC,CAAC,IAAI;QACN,OAAO,IAAI,KAAK,QAAQ;QACvB,IAAyB,CAAC,EAAE,KAAK,YAAY,CAC/C,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,YAAY,CAAC,GAAY;IAChC,IAAI,GAAG,YAAY,KAAK;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC7C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA4B;IAC7D,MAAM,EACJ,OAAO,EACP,IAAI,GAAG,cAAc,EACrB,SAAS,GAAG,MAAM,EAClB,UAAU,GAAG,GAAG,EAChB,QAAQ,GAAG,eAAe,EAC1B,KAAK,EAAE,OAAO,GAAG,KAAkB,EACnC,KAAK,GAAG,YAAY,EACpB,GAAG,GAAG,IAAI,CAAC,GAAG,GACf,GAAG,OAAO,CAAC;IAEZ,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;IACxF,MAAM,QAAQ,GAAG,GAAG,EAAE,GAAG,SAAS,CAAC;IACnC,IAAI,SAAkB,CAAC;IAEvB,SAAS,CAAC;QACR,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAClD,IAAI,IAAa,CAAC;YAClB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC9B,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC7C,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,GAAG,SAAS,CAAC;YACnB,CAAC;YACD,IAAI,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC;gBAAE,OAAO;YAChC,SAAS,GAAG,IAAI,KAAK,CAAC,6BAA6B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACnE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,GAAG,GAAG,CAAC;QAClB,CAAC;QAED,IAAI,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,iCAAiC,SAAS,kBAAkB,GAAG,EAAE;gBAC/D,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CACjE,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/sql.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Pure SQL builders for test database reset. Kept IO-free so they're
+ * fully unit-testable; the executing wrappers live in `db.ts`.
+ */
+/**
+ * VentureKit's migration/seed bookkeeping tables. These must NEVER be
+ * truncated between tests — doing so would make the runner re-apply (or
+ * lose track of) every migration. `truncateAllTables` excludes them by
+ * default via `filterTruncatableTables`.
+ */
+export declare const VK_TRACKING_TABLES: readonly string[];
+/** Quote a SQL identifier, escaping embedded double-quotes. */
+export declare function quoteIdent(name: string): string;
+/**
+ * Remove VentureKit tracking tables (and any caller-supplied names) from
+ * a list of candidate tables.
+ */
+export declare function filterTruncatableTables(all: string[], exclude?: string[]): string[];
+export interface TruncateSqlOptions {
+    /** Append `RESTART IDENTITY` (reset sequences). Default `true`. */
+    restartIdentity?: boolean;
+    /** Append `CASCADE` (truncate dependent tables too). Default `true`. */
+    cascade?: boolean;
+    /** Schema to qualify table names with (e.g. `public`). */
+    schema?: string;
+}
+/**
+ * Build a single `TRUNCATE TABLE ...` statement for the given tables.
+ * Returns `''` for an empty list so callers can skip the query entirely.
+ */
+export declare function buildTruncateSql(tables: string[], options?: TruncateSqlOptions): string;
+//# sourceMappingURL=sql.d.ts.map

package/dist/sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../src/sql.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAAsC,CAAC;AAEvF,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAGvF;AAED,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAU3F"}

package/dist/sql.js

@@ -0,0 +1,40 @@
+/**
+ * Pure SQL builders for test database reset. Kept IO-free so they're
+ * fully unit-testable; the executing wrappers live in `db.ts`.
+ */
+/**
+ * VentureKit's migration/seed bookkeeping tables. These must NEVER be
+ * truncated between tests — doing so would make the runner re-apply (or
+ * lose track of) every migration. `truncateAllTables` excludes them by
+ * default via `filterTruncatableTables`.
+ */
+export const VK_TRACKING_TABLES = ['__vk_migrations', '__vk_seeds'];
+/** Quote a SQL identifier, escaping embedded double-quotes. */
+export function quoteIdent(name) {
+    return `"${name.replace(/"/g, '""')}"`;
+}
+/**
+ * Remove VentureKit tracking tables (and any caller-supplied names) from
+ * a list of candidate tables.
+ */
+export function filterTruncatableTables(all, exclude = []) {
+    const skip = new Set([...VK_TRACKING_TABLES, ...exclude]);
+    return all.filter((table) => !skip.has(table));
+}
+/**
+ * Build a single `TRUNCATE TABLE ...` statement for the given tables.
+ * Returns `''` for an empty list so callers can skip the query entirely.
+ */
+export function buildTruncateSql(tables, options = {}) {
+    if (tables.length === 0)
+        return '';
+    const { restartIdentity = true, cascade = true, schema } = options;
+    const qualified = tables.map((table) => schema ? `${quoteIdent(schema)}.${quoteIdent(table)}` : quoteIdent(table));
+    let sql = `TRUNCATE TABLE ${qualified.join(', ')}`;
+    if (restartIdentity)
+        sql += ' RESTART IDENTITY';
+    if (cascade)
+        sql += ' CASCADE';
+    return sql;
+}
+//# sourceMappingURL=sql.js.map

package/dist/sql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.js","sourceRoot":"","sources":["../src/sql.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAsB,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;AAEvF,+DAA+D;AAC/D,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAa,EAAE,UAAoB,EAAE;IAC3E,MAAM,IAAI,GAAG,IAAI,GAAG,CAAS,CAAC,GAAG,kBAAkB,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAClE,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AACjD,CAAC;AAWD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAgB,EAAE,UAA8B,EAAE;IACjF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,EAAE,eAAe,GAAG,IAAI,EAAE,OAAO,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACnE,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACrC,MAAM,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAC1E,CAAC;IACF,IAAI,GAAG,GAAG,kBAAkB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACnD,IAAI,eAAe;QAAE,GAAG,IAAI,mBAAmB,CAAC;IAChD,IAAI,OAAO;QAAE,GAAG,IAAI,UAAU,CAAC;IAC/B,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/stack.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Programmatically launch a full local VentureKit stack for tests.
+ *
+ * `startTestStack` runs `vk migrate` (so the schema/seed are applied — `vk
+ * dev` does NOT auto-migrate) and then `vk dev`, waiting until the server's
+ * `/_dev/health` probe confirms it's ready. Use it from a vitest
+ * `globalSetup` or a Playwright `globalSetup` when you want the harness to
+ * own the server lifecycle. (For Playwright you can alternatively let the
+ * `webServer` block run `vk dev` and use `waitForReady` yourself.)
+ *
+ * Requires `@venturekit/cli` to be installed in the project (it is, for any
+ * VentureKit app) — the `vk` binary is resolved from `node_modules/.bin`.
+ *
+ * This module is IO-bound (child processes, ports) and is excluded from
+ * unit-test coverage; it's exercised by real E2E runs.
+ */
+export interface StartTestStackOptions {
+    /** Project directory containing `vk.config.ts`. Default `process.cwd()`. */
+    cwd?: string;
+    /** Stage name — flows into the local DB name. Default `test`. */
+    stage?: string;
+    /** Port for the API server. Default `4100`. */
+    port?: number;
+    /** Host to build the base URL from. Default `localhost`. */
+    host?: string;
+    /** Extra environment variables for the spawned `vk` processes. */
+    env?: Record<string, string>;
+    /** Run `vk migrate` before starting the server. Default `true`. */
+    migrate?: boolean;
+    /** Pass `--seed` to `vk migrate`. Default `false`. */
+    seed?: boolean;
+    /** Enable file watching / hot reload (usually off for tests). Default `false`. */
+    watch?: boolean;
+    /** Max time to wait for readiness, in ms. Default 120_000. */
+    readyTimeoutMs?: number;
+    /** Override the resolved `vk` binary path. */
+    vkBin?: string;
+    /** stdio mode for the spawned processes. Default `inherit`. */
+    stdio?: 'inherit' | 'ignore';
+}
+export interface TestStack {
+    /** Base URL of the running API, e.g. `http://localhost:4100`. */
+    baseUrl: string;
+    port: number;
+    /** Stop the server (and its process group). Idempotent. */
+    stop(): Promise<void>;
+}
+/**
+ * Migrate + boot a `vk dev` server and resolve once it's ready.
+ */
+export declare function startTestStack(options?: StartTestStackOptions): Promise<TestStack>;
+//# sourceMappingURL=stack.d.ts.map

package/dist/stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.d.ts","sourceRoot":"","sources":["../src/stack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,MAAM,WAAW,qBAAqB;IACpC,4EAA4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sDAAsD;IACtD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kFAAkF;IAClF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAoED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,SAAS,CAAC,CAuD5F"}

package/dist/stack.js

@@ -0,0 +1,142 @@
+/**
+ * Programmatically launch a full local VentureKit stack for tests.
+ *
+ * `startTestStack` runs `vk migrate` (so the schema/seed are applied — `vk
+ * dev` does NOT auto-migrate) and then `vk dev`, waiting until the server's
+ * `/_dev/health` probe confirms it's ready. Use it from a vitest
+ * `globalSetup` or a Playwright `globalSetup` when you want the harness to
+ * own the server lifecycle. (For Playwright you can alternatively let the
+ * `webServer` block run `vk dev` and use `waitForReady` yourself.)
+ *
+ * Requires `@venturekit/cli` to be installed in the project (it is, for any
+ * VentureKit app) — the `vk` binary is resolved from `node_modules/.bin`.
+ *
+ * This module is IO-bound (child processes, ports) and is excluded from
+ * unit-test coverage; it's exercised by real E2E runs.
+ */
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { waitForReady, vkDevServerReady } from './ready.js';
+/** Resolve the `vk` binary from the nearest `node_modules/.bin`, else PATH. */
+function resolveVkBin(cwd, override) {
+    if (override)
+        return override;
+    const binName = process.platform === 'win32' ? 'vk.cmd' : 'vk';
+    let dir = cwd;
+    for (;;) {
+        const candidate = join(dir, 'node_modules', '.bin', binName);
+        if (existsSync(candidate))
+            return candidate;
+        const parent = join(dir, '..');
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return 'vk';
+}
+/** Run a `vk` subcommand to completion, rejecting on a non-zero exit code. */
+function runToCompletion(bin, args, opts) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(bin, args, { cwd: opts.cwd, env: opts.env, stdio: opts.stdio });
+        child.on('error', reject);
+        child.on('exit', (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`\`${bin} ${args.join(' ')}\` exited with code ${code ?? 'null'}`));
+        });
+    });
+}
+/** Terminate a child process (and its group on POSIX), resolving once it's gone. */
+function terminate(child) {
+    return new Promise((resolve) => {
+        if (child.exitCode != null || child.pid == null) {
+            resolve();
+            return;
+        }
+        child.once('exit', () => resolve());
+        try {
+            if (process.platform === 'win32') {
+                spawn('taskkill', ['/pid', String(child.pid), '/T', '/F']);
+            }
+            else {
+                try {
+                    // Negative pid kills the whole detached process group.
+                    process.kill(-child.pid, 'SIGTERM');
+                }
+                catch {
+                    child.kill('SIGTERM');
+                }
+            }
+        }
+        catch {
+            // already gone
+        }
+        // Hard-stop safety net so teardown never hangs.
+        const t = setTimeout(() => {
+            try {
+                child.kill('SIGKILL');
+            }
+            catch {
+                // ignore
+            }
+            resolve();
+        }, 5_000);
+        t.unref();
+    });
+}
+/**
+ * Migrate + boot a `vk dev` server and resolve once it's ready.
+ */
+export async function startTestStack(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const stage = options.stage ?? 'test';
+    const port = options.port ?? 4100;
+    const host = options.host ?? 'localhost';
+    const baseUrl = `http://${host}:${port}`;
+    const stdio = options.stdio ?? 'inherit';
+    const vk = resolveVkBin(cwd, options.vkBin);
+    const env = { ...process.env, ...options.env, VENTURE_STAGE: stage };
+    // `vk dev` does NOT auto-migrate — apply schema (and optionally seeds) first.
+    if (options.migrate !== false) {
+        const migrateArgs = ['migrate', '--env', stage];
+        if (options.seed)
+            migrateArgs.push('--seed');
+        await runToCompletion(vk, migrateArgs, { cwd, env, stdio });
+    }
+    const devArgs = ['dev', '--stage', stage, '--port', String(port)];
+    if (options.watch !== true)
+        devArgs.push('--no-watch');
+    const child = spawn(vk, devArgs, {
+        cwd,
+        env,
+        stdio,
+        // Detach on POSIX so we can signal the whole process group on stop().
+        detached: process.platform !== 'win32',
+    });
+    let exited = null;
+    child.on('exit', (code) => {
+        exited = { code };
+    });
+    const stop = async () => {
+        await terminate(child);
+    };
+    try {
+        await waitForReady({
+            baseUrl,
+            timeoutMs: options.readyTimeoutMs ?? 120_000,
+            validate: vkDevServerReady,
+        });
+    }
+    catch (err) {
+        await stop();
+        const early = exited;
+        if (early) {
+            throw new Error(`vk dev exited early (code ${early.code ?? 'null'}) before becoming ready at ${baseUrl}`);
+        }
+        throw err;
+    }
+    return { baseUrl, port, stop };
+}
+//# sourceMappingURL=stack.js.map

package/dist/stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.js","sourceRoot":"","sources":["../src/stack.ts"],"names":[],"mappings":"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"}