@danceroutine/tango-testing 0.1.0 → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Pedro Del Moral Lopez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+# @danceroutine/tango-testing
+
+`@danceroutine/tango-testing` provides Tango's testing helpers for unit tests, integration tests, and smoke-test workflows.
+
+This package exists because framework-level testing needs more than a handful of mocks. Once a codebase has managers, query composition, migrations, dialect differences, and real application processes, test support has to cover several levels of confidence at once. Tango keeps those helpers together so that application and framework code can move from fast isolated tests to realistic integration coverage without rebuilding the same harness machinery for every project.
+
+## Install
+
+```bash
+pnpm add -D @danceroutine/tango-testing vitest
+```
+
+Depending on your tests, you may also need the database driver or Tango packages your application already uses.
+
+## What kinds of testing it supports
+
+The package spans three common testing layers:
+
+- lightweight mocks for fast unit tests
+- integration harnesses for database-backed query, manager, and migration tests
+- Vitest helpers and smoke-test utilities for higher-level workflows
+
+Those layers let one package support fast unit tests, dialect-backed integration tests, and full process-level smoke tests without changing mental models between them.
+
+## Quick start
+
+Register the Vitest helper surface:
+
+```ts
+import { beforeAll } from 'vitest';
+import { registerVitestTango } from '@danceroutine/tango-testing/vitest';
+
+beforeAll(() => {
+    registerVitestTango();
+});
+```
+
+For unit tests, you can use the mock helpers directly:
+
+```ts
+import { aManager } from '@danceroutine/tango-testing';
+
+const manager = aManager();
+```
+
+Runtime-focused tests can also start from a shared config and runtime setup helper instead of rebuilding Tango config in every file:
+
+```ts
+import { aTangoConfig, setupTestTangoRuntime } from '@danceroutine/tango-testing';
+
+const config = aTangoConfig({ adapter: 'sqlite' });
+const runtime = await setupTestTangoRuntime();
+```
+
+`aTangoConfig` gives tests a stable config fixture, and `setupTestTangoRuntime` resets and initializes the process-default Tango runtime in one call.
+
+For integration tests, the package exposes the `TestHarness` and dialect strategies that create real database-backed workflows.
+
+## Public API
+
+The root export covers three main jobs. Mock helpers such as `aDBClient`, `aManager`, `aQueryExecutor`, and `aQuerySet` keep unit tests lightweight. Runtime and integration helpers such as `aTangoConfig`, `setupTestTangoRuntime`, `TestHarness`, and `createQuerySetFixture` support database-backed and framework-backed workflows. `ModelDataFactory` and the Vitest integration surface round out the package for data fixtures and test-runner setup.
+
+The package also exposes subpaths such as `mocks`, `factories`, `assertions`, `integration`, and `vitest` when you want a more explicit import boundary.
+
+## Documentation
+
+- Official documentation: <https://tangowebframework.dev>
+- Testing topic: <https://tangowebframework.dev/topics/testing>
+- New dialect onboarding: <https://tangowebframework.dev/contributors/how-to/new-dialect-onboarding>
+
+## Development
+
+```bash
+pnpm --filter @danceroutine/tango-testing build
+pnpm --filter @danceroutine/tango-testing typecheck
+pnpm --filter @danceroutine/tango-testing test
+```
+
+For the wider contributor workflow, use:
+
+- <https://tangowebframework.dev/contributing>
+
+## License
+
+MIT

package/dist/aDBClient-W6eXsK3X.js

@@ -0,0 +1,21 @@
+import { vi } from "vitest";
+
+//#region src/mocks/aDBClient.ts
+function aDBClient(overrides = {}) {
+	const queryImpl = overrides.query ?? (async (_sql, _params) => ({ rows: [] }));
+	const beginImpl = overrides.begin ?? (async () => {});
+	const commitImpl = overrides.commit ?? (async () => {});
+	const rollbackImpl = overrides.rollback ?? (async () => {});
+	const closeImpl = overrides.close ?? (async () => {});
+	return {
+		query: vi.fn((sql, params) => queryImpl(sql, params)),
+		begin: vi.fn(() => beginImpl()),
+		commit: vi.fn(() => commitImpl()),
+		rollback: vi.fn(() => rollbackImpl()),
+		close: vi.fn(() => closeImpl())
+	};
+}
+
+//#endregion
+export { aDBClient };
+//# sourceMappingURL=aDBClient-W6eXsK3X.js.map

package/dist/aDBClient-W6eXsK3X.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aDBClient-W6eXsK3X.js","names":["overrides: DBClientOverrides","_sql: string","_params?: readonly unknown[]","sql: string","params?: readonly unknown[]"],"sources":["../src/mocks/aDBClient.ts"],"sourcesContent":["import { vi } from 'vitest';\nimport type { DBClient } from './DBClient';\n\n/**\n * Looser override type for `aDBClient` that accepts concrete-typed query mocks.\n * Consumers should not need to cast their mocks to satisfy `DBClient['query']`'s generic.\n */\ntype DBClientOverrides = {\n    // oxlint-disable-next-line typescript/no-explicit-any\n    query?: (sql: string, params?: readonly unknown[]) => Promise<{ rows: any[] }>;\n    begin?: () => Promise<void>;\n    commit?: () => Promise<void>;\n    rollback?: () => Promise<void>;\n    close?: () => Promise<void>;\n};\n\n/**\n * Create a lightweight `DBClient` test double with optional behavior overrides.\n * The `query` override accepts any function returning `Promise<{ rows: any[] }>`,\n * so concrete-typed Vitest mocks do not require a cast at the call site.\n */\nexport function aDBClient(overrides: DBClientOverrides = {}): DBClient {\n    const queryImpl =\n        // oxlint-disable-next-line typescript/no-explicit-any\n        overrides.query ?? (async (_sql: string, _params?: readonly unknown[]) => ({ rows: [] as any[] }));\n    const beginImpl = overrides.begin ?? (async () => {});\n    const commitImpl = overrides.commit ?? (async () => {});\n    const rollbackImpl = overrides.rollback ?? (async () => {});\n    const closeImpl = overrides.close ?? (async () => {});\n\n    return {\n        query: vi.fn((sql: string, params?: readonly unknown[]) => queryImpl(sql, params)) as DBClient['query'],\n        begin: vi.fn(() => beginImpl()),\n        commit: vi.fn(() => commitImpl()),\n        rollback: vi.fn(() => rollbackImpl()),\n        close: vi.fn(() => closeImpl()),\n    };\n}\n"],"mappings":";;;AAqBO,SAAS,UAAUA,YAA+B,CAAE,GAAY;CACnE,MAAM,YAEF,UAAU,UAAU,OAAOC,MAAcC,aAAkC,EAAE,MAAM,CAAE,EAAW;CACpG,MAAM,YAAY,UAAU,UAAU,YAAY,CAAE;CACpD,MAAM,aAAa,UAAU,WAAW,YAAY,CAAE;CACtD,MAAM,eAAe,UAAU,aAAa,YAAY,CAAE;CAC1D,MAAM,YAAY,UAAU,UAAU,YAAY,CAAE;AAEpD,QAAO;EACH,OAAO,GAAG,GAAG,CAACC,KAAaC,WAAgC,UAAU,KAAK,OAAO,CAAC;EAClF,OAAO,GAAG,GAAG,MAAM,WAAW,CAAC;EAC/B,QAAQ,GAAG,GAAG,MAAM,YAAY,CAAC;EACjC,UAAU,GAAG,GAAG,MAAM,cAAc,CAAC;EACrC,OAAO,GAAG,GAAG,MAAM,WAAW,CAAC;CAClC;AACJ"}

package/dist/assertions/index.js

@@ -1,3 +1,3 @@
-import { assertions } from "../assertions-CN6KxXhH.js";
+import { assertions } from "../assertions-CCFZ53Y-.js";
 
 export { assertions };

package/dist/{assertions-CN6KxXhH.js → assertions-CCFZ53Y-.js}

@@ -12,4 +12,4 @@ __export(assertions_exports, { assertions: () => assertions });
 
 //#endregion
 export { assertions, assertions_exports };
-//# sourceMappingURL=assertions-CN6KxXhH.js.map
+//# sourceMappingURL=assertions-CCFZ53Y-.js.map

package/dist/assertions-CCFZ53Y-.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions-CCFZ53Y-.js","names":["model: TModel","data: unknown"],"sources":["../src/assertions/assertions.ts","../src/assertions/index.ts"],"sourcesContent":["import type { GenericModelFactory } from '../factories';\n\n/**\n * Assertion helpers for Tango models.\n */\nexport const assertions = {\n    matchesSchema<TModel extends GenericModelFactory<Record<string, unknown>, unknown>>(\n        model: TModel,\n        data: unknown\n    ): asserts data is ReturnType<TModel['parse']> {\n        model.parse(data);\n    },\n};\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { assertions } from './assertions';\n"],"mappings":";;;MAKa,aAAa,EACtB,cACIA,OACAC,MAC2C;AAC3C,OAAM,MAAM,KAAK;AACpB,EACJ"}

package/dist/express/anExpressRequest.d.ts

@@ -0,0 +1,24 @@
+import type { Request } from 'express';
+type ExpressRequestParams = Request['params'] | Record<string, string | string[]>;
+/**
+ * Overrides accepted by `anExpressRequest`. All fields are optional;
+ * sensible defaults are provided for a minimal GET request.
+ */
+export type ExpressRequestOverrides = {
+    protocol?: string;
+    method?: string;
+    originalUrl?: string;
+    url?: string;
+    headers?: Record<string, any>;
+    body?: any;
+    params?: ExpressRequestParams;
+    get?: (name: string) => string | undefined;
+};
+/**
+ * Create a minimal Express `Request` test double.
+ * The `get` method is a Vitest mock that returns `'localhost:3000'` for the
+ * `host` header and `undefined` for everything else, matching the most common
+ * test pattern. Override any field via the `overrides` argument.
+ */
+export declare function anExpressRequest(overrides?: ExpressRequestOverrides): Request;
+export {};

package/dist/express/anExpressResponse.d.ts

@@ -0,0 +1,9 @@
+import type { Response } from 'express';
+/**
+ * Create an Express `Response` test double.
+ *
+ * Every Express `Response` method is backed by a `vi.fn()`.
+ * Chainable methods (`status`, `sendStatus`, `links`, etc.) return `res`.
+ * Use `vi.mocked()` to access the mock API for assertions.
+ */
+export declare function anExpressResponse(): Response;

package/dist/express/index.d.ts

@@ -0,0 +1,3 @@
+export { anExpressRequest } from './anExpressRequest';
+export type { ExpressRequestOverrides } from './anExpressRequest';
+export { anExpressResponse } from './anExpressResponse';

package/dist/express/index.js

@@ -0,0 +1,3 @@
+import { anExpressRequest, anExpressResponse } from "../express-Czpfz_Ay.js";
+
+export { anExpressRequest, anExpressResponse };

package/dist/express-Czpfz_Ay.js

@@ -0,0 +1,68 @@
+import { __export } from "./chunk-BkvOhyD0.js";
+import { vi, vi as vi$1 } from "vitest";
+
+//#region src/express/anExpressRequest.ts
+function anExpressRequest(overrides = {}) {
+	return {
+		protocol: "http",
+		method: "GET",
+		originalUrl: "/",
+		url: "/",
+		headers: {},
+		body: undefined,
+		params: {},
+		get: vi$1.fn((name) => name.toLowerCase() === "host" ? "localhost:3000" : undefined),
+		...overrides
+	};
+}
+
+//#endregion
+//#region src/express/anExpressResponse.ts
+function anExpressResponse() {
+	const res = {};
+	const chainable = [
+		"status",
+		"sendStatus",
+		"links",
+		"contentType",
+		"type",
+		"format",
+		"attachment",
+		"set",
+		"header",
+		"clearCookie",
+		"cookie",
+		"location",
+		"vary",
+		"append"
+	];
+	for (const method of chainable) res[method] = vi.fn().mockReturnValue(res);
+	res.send = vi.fn().mockReturnValue(res);
+	res.json = vi.fn().mockReturnValue(res);
+	res.jsonp = vi.fn().mockReturnValue(res);
+	res.end = vi.fn().mockReturnValue(res);
+	res.sendFile = vi.fn();
+	res.download = vi.fn();
+	res.redirect = vi.fn();
+	res.render = vi.fn();
+	res.get = vi.fn();
+	res.setHeader = vi.fn().mockReturnValue(res);
+	res.headersSent = false;
+	res.locals = {};
+	res.charset = "utf-8";
+	res.app = {};
+	res.req = {};
+	return res;
+}
+
+//#endregion
+//#region src/express/index.ts
+var express_exports = {};
+__export(express_exports, {
+	anExpressRequest: () => anExpressRequest,
+	anExpressResponse: () => anExpressResponse
+});
+
+//#endregion
+export { anExpressRequest, anExpressResponse, express_exports };
+//# sourceMappingURL=express-Czpfz_Ay.js.map

package/dist/express-Czpfz_Ay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express-Czpfz_Ay.js","names":["overrides: ExpressRequestOverrides","name: string","res: Record<string, unknown>"],"sources":["../src/express/anExpressRequest.ts","../src/express/anExpressResponse.ts","../src/express/index.ts"],"sourcesContent":["import { vi } from 'vitest';\nimport type { Request } from 'express';\n\ntype ExpressRequestParams = Request['params'] | Record<string, string | string[]>;\n\n/**\n * Overrides accepted by `anExpressRequest`. All fields are optional;\n * sensible defaults are provided for a minimal GET request.\n */\nexport type ExpressRequestOverrides = {\n    protocol?: string;\n    method?: string;\n    originalUrl?: string;\n    url?: string;\n    // oxlint-disable-next-line typescript/no-explicit-any\n    headers?: Record<string, any>;\n    // oxlint-disable-next-line typescript/no-explicit-any\n    body?: any;\n    params?: ExpressRequestParams;\n    get?: (name: string) => string | undefined;\n};\n\n/**\n * Create a minimal Express `Request` test double.\n * The `get` method is a Vitest mock that returns `'localhost:3000'` for the\n * `host` header and `undefined` for everything else, matching the most common\n * test pattern. Override any field via the `overrides` argument.\n */\nexport function anExpressRequest(overrides: ExpressRequestOverrides = {}): Request {\n    return {\n        protocol: 'http',\n        method: 'GET',\n        originalUrl: '/',\n        url: '/',\n        headers: {},\n        body: undefined,\n        params: {},\n        get: vi.fn((name: string) => (name.toLowerCase() === 'host' ? 'localhost:3000' : undefined)),\n        ...overrides,\n    } as unknown as Request;\n}\n","import { vi } from 'vitest';\nimport type { Response } from 'express';\n\n/**\n * Create an Express `Response` test double.\n *\n * Every Express `Response` method is backed by a `vi.fn()`.\n * Chainable methods (`status`, `sendStatus`, `links`, etc.) return `res`.\n * Use `vi.mocked()` to access the mock API for assertions.\n */\nexport function anExpressResponse(): Response {\n    const res: Record<string, unknown> = {};\n\n    const chainable = [\n        'status',\n        'sendStatus',\n        'links',\n        'contentType',\n        'type',\n        'format',\n        'attachment',\n        'set',\n        'header',\n        'clearCookie',\n        'cookie',\n        'location',\n        'vary',\n        'append',\n    ];\n\n    for (const method of chainable) {\n        res[method] = vi.fn().mockReturnValue(res);\n    }\n\n    res.send = vi.fn().mockReturnValue(res);\n    res.json = vi.fn().mockReturnValue(res);\n    res.jsonp = vi.fn().mockReturnValue(res);\n    res.end = vi.fn().mockReturnValue(res);\n    res.sendFile = vi.fn();\n    res.download = vi.fn();\n    res.redirect = vi.fn();\n    res.render = vi.fn();\n    res.get = vi.fn();\n    res.setHeader = vi.fn().mockReturnValue(res);\n\n    res.headersSent = false;\n    res.locals = {};\n    res.charset = 'utf-8';\n    res.app = {};\n    res.req = {};\n\n    return res as unknown as Response;\n}\n","export { anExpressRequest } from './anExpressRequest';\nexport type { ExpressRequestOverrides } from './anExpressRequest';\nexport { anExpressResponse } from './anExpressResponse';\n"],"mappings":";;;;AA4BO,SAAS,iBAAiBA,YAAqC,CAAE,GAAW;AAC/E,QAAO;EACH,UAAU;EACV,QAAQ;EACR,aAAa;EACb,KAAK;EACL,SAAS,CAAE;EACX,MAAM;EACN,QAAQ,CAAE;EACV,KAAK,KAAG,GAAG,CAACC,SAAkB,KAAK,aAAa,KAAK,SAAS,mBAAmB,UAAW;EAC5F,GAAG;CACN;AACJ;;;;AC9BM,SAAS,oBAA8B;CAC1C,MAAMC,MAA+B,CAAE;CAEvC,MAAM,YAAY;EACd;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACH;AAED,MAAK,MAAM,UAAU,UACjB,KAAI,UAAU,GAAG,IAAI,CAAC,gBAAgB,IAAI;AAG9C,KAAI,OAAO,GAAG,IAAI,CAAC,gBAAgB,IAAI;AACvC,KAAI,OAAO,GAAG,IAAI,CAAC,gBAAgB,IAAI;AACvC,KAAI,QAAQ,GAAG,IAAI,CAAC,gBAAgB,IAAI;AACxC,KAAI,MAAM,GAAG,IAAI,CAAC,gBAAgB,IAAI;AACtC,KAAI,WAAW,GAAG,IAAI;AACtB,KAAI,WAAW,GAAG,IAAI;AACtB,KAAI,WAAW,GAAG,IAAI;AACtB,KAAI,SAAS,GAAG,IAAI;AACpB,KAAI,MAAM,GAAG,IAAI;AACjB,KAAI,YAAY,GAAG,IAAI,CAAC,gBAAgB,IAAI;AAE5C,KAAI,cAAc;AAClB,KAAI,SAAS,CAAE;AACf,KAAI,UAAU;AACd,KAAI,MAAM,CAAE;AACZ,KAAI,MAAM,CAAE;AAEZ,QAAO;AACV"}

package/dist/factories/ModelDataFactory.d.ts

@@ -10,9 +10,24 @@ export declare class ModelDataFactory<TModel extends GenericModelFactory<Record<
     private defaults;
     private sequence;
     constructor(model: TModel, defaults?: Partial<Parameters<TModel['create']>[0]>);
+    /**
+     * Build one model instance by merging defaults, sequence defaults, and overrides.
+     */
     build(overrides?: Partial<Parameters<TModel['create']>[0]>): ReturnType<TModel['create']>;
+    /**
+     * Build `count` model instances using shared overrides.
+     */
     buildList(count: number, overrides?: Partial<Parameters<TModel['create']>[0]>): ReturnType<TModel['create']>[];
-    protected sequenceDefaults(): Partial<Parameters<TModel['create']>[0]>;
+    /**
+     * Reset the internal sequence counter to zero.
+     */
     resetSequence(): void;
+    /**
+     * Return the current sequence counter value.
+     */
     getSequence(): number;
+    /**
+     * Hook for subclasses to provide per-sequence default values.
+     */
+    protected sequenceDefaults(): Partial<Parameters<TModel['create']>[0]>;
 }

package/dist/factories/index.js

@@ -1,3 +1,3 @@
-import { ModelDataFactory } from "../factories-CCAZ6E-g.js";
+import { ModelDataFactory } from "../factories-Cl_CAzbj.js";
 
 export { ModelDataFactory };

package/dist/{factories-CCAZ6E-g.js → factories-Cl_CAzbj.js}

@@ -7,6 +7,9 @@ var ModelDataFactory = class {
 		this.model = model;
 		this.defaults = defaults;
 	}
+	/**
+	* Build one model instance by merging defaults, sequence defaults, and overrides.
+	*/
 	build(overrides = {}) {
 		this.sequence++;
 		const data = {
@@ -16,18 +19,30 @@ var ModelDataFactory = class {
 		};
 		return this.model.create(data);
 	}
+	/**
+	* Build `count` model instances using shared overrides.
+	*/
 	buildList(count, overrides = {}) {
 		return Array.from({ length: count }, () => this.build(overrides));
 	}
-	sequenceDefaults() {
-		return {};
-	}
+	/**
+	* Reset the internal sequence counter to zero.
+	*/
 	resetSequence() {
 		this.sequence = 0;
 	}
+	/**
+	* Return the current sequence counter value.
+	*/
 	getSequence() {
 		return this.sequence;
 	}
+	/**
+	* Hook for subclasses to provide per-sequence default values.
+	*/
+	sequenceDefaults() {
+		return {};
+	}
 };
 
 //#endregion
@@ -37,4 +52,4 @@ __export(factories_exports, { ModelDataFactory: () => ModelDataFactory });
 
 //#endregion
 export { ModelDataFactory, factories_exports };
-//# sourceMappingURL=factories-CCAZ6E-g.js.map
+//# sourceMappingURL=factories-Cl_CAzbj.js.map

package/dist/factories-Cl_CAzbj.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factories-Cl_CAzbj.js","names":["model: TModel","defaults: Partial<Parameters<TModel['create']>[0]>","overrides: Partial<Parameters<TModel['create']>[0]>","count: number"],"sources":["../src/factories/ModelDataFactory.ts","../src/factories/index.ts"],"sourcesContent":["export type GenericModelFactory<TInput extends Record<string, unknown> = Record<string, unknown>, TOutput = TInput> = {\n    create(data: TInput): TOutput;\n    parse(data: unknown): TOutput;\n};\n\n/**\n * Factory class for generating test data with sequences and defaults.\n */\nexport class ModelDataFactory<TModel extends GenericModelFactory<Record<string, unknown>, unknown>> {\n    private sequence = 0;\n\n    constructor(\n        private model: TModel,\n        private defaults: Partial<Parameters<TModel['create']>[0]> = {}\n    ) {}\n\n    /**\n     * Build one model instance by merging defaults, sequence defaults, and overrides.\n     */\n    public build(overrides: Partial<Parameters<TModel['create']>[0]> = {}): ReturnType<TModel['create']> {\n        this.sequence++;\n        const data = {\n            ...this.defaults,\n            ...this.sequenceDefaults(),\n            ...overrides,\n        };\n        return this.model.create(data as Parameters<TModel['create']>[0]) as ReturnType<TModel['create']>;\n    }\n\n    /**\n     * Build `count` model instances using shared overrides.\n     */\n    public buildList(\n        count: number,\n        overrides: Partial<Parameters<TModel['create']>[0]> = {}\n    ): ReturnType<TModel['create']>[] {\n        return Array.from({ length: count }, () => this.build(overrides));\n    }\n\n    /**\n     * Reset the internal sequence counter to zero.\n     */\n    public resetSequence(): void {\n        this.sequence = 0;\n    }\n\n    /**\n     * Return the current sequence counter value.\n     */\n    public getSequence(): number {\n        return this.sequence;\n    }\n\n    /**\n     * Hook for subclasses to provide per-sequence default values.\n     */\n    protected sequenceDefaults(): Partial<Parameters<TModel['create']>[0]> {\n        return {};\n    }\n}\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { ModelDataFactory, type GenericModelFactory } from './ModelDataFactory';\n"],"mappings":";;;IAQa,mBAAN,MAA6F;CAChG,WAAmB;CAEnB,YACYA,OACAC,WAAqD,CAAE,GACjE;AAAA,OAFU,QAAA;AAAA,OACA,WAAA;CACR;;;;CAKJ,MAAaC,YAAsD,CAAE,GAAgC;AACjG,OAAK;EACL,MAAM,OAAO;GACT,GAAG,KAAK;GACR,GAAG,KAAK,kBAAkB;GAC1B,GAAG;EACN;AACD,SAAO,KAAK,MAAM,OAAO,KAAwC;CACpE;;;;CAKD,UACIC,OACAD,YAAsD,CAAE,GAC1B;AAC9B,SAAO,MAAM,KAAK,EAAE,QAAQ,MAAO,GAAE,MAAM,KAAK,MAAM,UAAU,CAAC;CACpE;;;;CAKD,gBAA6B;AACzB,OAAK,WAAW;CACnB;;;;CAKD,cAA6B;AACzB,SAAO,KAAK;CACf;;;;CAKD,mBAAuE;AACnE,SAAO,CAAE;CACZ;AACJ"}

package/dist/index.d.ts

@@ -7,9 +7,11 @@ export * as factories from './factories/index';
 export * as assertionsDomain from './assertions/index';
 export * as integration from './integration/index';
 export * as vitest from './vitest/index';
-export { VERSION as version } from './version';
-export { aMockDBClient, aMockQuerySet, aMockRepository } from './mocks/index';
-export type { DBClient, MockQuerySetResult, RepositoryLike } from './mocks/index';
+export * as express from './express/index';
+export { aDBClient, aManager, aQueryResult, aQuerySet, aRequestContext, aQueryExecutor } from './mocks/index';
+export { anExpressRequest, anExpressResponse } from './express/index';
+export type { DBClient, ManagerOverrides, MockQuerySetResult, QueryExecutorOverrides, RequestContextFixtureOptions, } from './mocks/index';
+export type { ExpressRequestOverrides } from './express/index';
 export { ModelDataFactory } from './factories/index';
 export type { GenericModelFactory } from './factories/index';
 export { assertions } from './assertions/index';

package/dist/index.js

@@ -1,12 +1,9 @@
-import { aMockDBClient, aMockQuerySet, aMockRepository, mocks_exports } from "./mocks-qo-1vCez.js";
-import { ModelDataFactory, factories_exports } from "./factories-CCAZ6E-g.js";
-import { assertions, assertions_exports } from "./assertions-CN6KxXhH.js";
-import { Dialect, HarnessStrategyRegistry, ResetMode, TestHarness, applyAndVerifyMigrations, assertMigrationPlan, createRepositoryFixture, domain_exports, expectQueryResult, integration_exports, introspectSchema, migrations_exports, seedTable } from "./integration-CDdpboYz.js";
-import { vitest_exports } from "./vitest-PxMJue7R.js";
+import { aDBClient } from "./aDBClient-W6eXsK3X.js";
+import { aManager, aQueryExecutor, aQueryResult, aQuerySet, aRequestContext, mocks_exports } from "./mocks-BkwkXQQt.js";
+import { ModelDataFactory, factories_exports } from "./factories-Cl_CAzbj.js";
+import { assertions, assertions_exports } from "./assertions-CCFZ53Y-.js";
+import { AppProcessHarness, Dialect, HarnessStrategyRegistry, ResetMode, TestHarness, aTangoConfig, anIntegrationHarness, applyAndVerifyMigrations, assertMigrationPlan, conformance_exports, createQuerySetFixture, domain_exports, expectQueryResult, integration_exports, introspectSchema, migrations_exports, runDialectConformanceSuite, runtime_exports, seedTable, setupTestTangoRuntime, smoke_exports } from "./integration-BrJw6NzG.js";
+import { vitest_exports } from "./vitest-37qN8D93.js";
+import { anExpressRequest, anExpressResponse, express_exports } from "./express-Czpfz_Ay.js";
 
-//#region src/version.ts
-const VERSION = "0.1.0";
-
-//#endregion
-export { Dialect, HarnessStrategyRegistry, ModelDataFactory, ResetMode, TestHarness, aMockDBClient, aMockQuerySet, aMockRepository, applyAndVerifyMigrations, assertMigrationPlan, assertions, assertions_exports as assertionsDomain, createRepositoryFixture, domain_exports as domain, expectQueryResult, factories_exports as factories, integration_exports as integration, introspectSchema, migrations_exports as migrations, mocks_exports as mocks, seedTable, VERSION as version, vitest_exports as vitest };
-//# sourceMappingURL=index.js.map
+export { AppProcessHarness, Dialect, HarnessStrategyRegistry, ModelDataFactory, ResetMode, TestHarness, aDBClient, aManager, aQueryExecutor, aQueryResult, aQuerySet, aRequestContext, aTangoConfig, anExpressRequest, anExpressResponse, anIntegrationHarness, applyAndVerifyMigrations, assertMigrationPlan, assertions, assertions_exports as assertionsDomain, conformance_exports as conformance, createQuerySetFixture, domain_exports as domain, expectQueryResult, express_exports as express, factories_exports as factories, integration_exports as integration, introspectSchema, migrations_exports as migrations, mocks_exports as mocks, runDialectConformanceSuite, runtime_exports as runtime, seedTable, setupTestTangoRuntime, smoke_exports as smoke, vitest_exports as vitest };

package/dist/integration/HarnessStrategyRegistry.d.ts

@@ -1,10 +1,25 @@
 import type { Dialect, HarnessStrategy } from './domain';
+/**
+ * Registry of test harness strategies keyed by dialect.
+ */
 export declare class HarnessStrategyRegistry {
     static readonly BRAND: "tango.testing.harness_strategy_registry";
     readonly __tangoBrand: typeof HarnessStrategyRegistry.BRAND;
     private readonly strategies;
+    /**
+     * Narrow an unknown value to `HarnessStrategyRegistry`.
+     */
     static isHarnessStrategyRegistry(value: unknown): value is HarnessStrategyRegistry;
+    /**
+     * Register or replace a dialect strategy.
+     */
     register(strategy: HarnessStrategy): this;
+    /**
+     * Resolve a strategy for a dialect, or throw if none is registered.
+     */
     get(dialect: Dialect | string): HarnessStrategy;
+    /**
+     * List all registered strategies.
+     */
     list(): readonly HarnessStrategy[];
 }

package/dist/integration/TestHarness.d.ts

@@ -1,17 +1,38 @@
 import { HarnessStrategyRegistry } from './HarnessStrategyRegistry';
 import { Dialect, type HarnessOptions, type HarnessStrategy, type IntegrationHarness } from './domain';
+/**
+ * Facade for creating integration test harnesses by dialect.
+ */
 export declare class TestHarness {
     static readonly BRAND: "tango.testing.test_harness";
-    readonly __tangoBrand: typeof TestHarness.BRAND;
     private static defaultRegistry;
+    readonly __tangoBrand: typeof TestHarness.BRAND;
+    /**
+     * Narrow an unknown value to `TestHarness`.
+     */
     static isTestHarness(value: unknown): value is TestHarness;
-    private static ensureRegistry;
+    /**
+     * Register a harness strategy on the shared default registry.
+     */
     static registerStrategy(strategy: HarnessStrategy): void;
+    /**
+     * Return the shared harness strategy registry.
+     */
     static getRegistry(): HarnessStrategyRegistry;
+    /**
+     * Create a dialect-specific harness from the registry.
+     */
     static forDialect(args: {
         dialect: Dialect | string;
         options?: HarnessOptions;
     }, registry?: HarnessStrategyRegistry): Promise<IntegrationHarness>;
+    /**
+     * Convenience helper for a SQLite test harness.
+     */
     static sqlite(options?: HarnessOptions): Promise<IntegrationHarness>;
+    /**
+     * Convenience helper for a Postgres test harness.
+     */
     static postgres(options?: HarnessOptions): Promise<IntegrationHarness>;
+    private static ensureRegistry;
 }

package/dist/integration/anIntegrationHarness.d.ts

@@ -0,0 +1,5 @@
+import type { IntegrationHarness } from './domain/IntegrationHarness';
+/**
+ * Create an integration-harness fixture with optional overrides.
+ */
+export declare function anIntegrationHarness(overrides?: Partial<IntegrationHarness>): IntegrationHarness;

package/dist/integration/config.d.ts

@@ -1,5 +1,9 @@
 import type { AdapterConfig } from '@danceroutine/tango-orm';
 import { Dialect } from './domain';
+/**
+ * Resolve adapter configuration for a test harness from explicit options,
+ * typed Tango config, and environment variables in that order.
+ */
 export declare function resolveAdapterConfig(dialect: Dialect, opts: {
     config?: Partial<AdapterConfig>;
     tangoConfigLoader?: () => unknown;

package/dist/integration/conformance/index.d.ts

@@ -0,0 +1 @@
+export { runDialectConformanceSuite } from './runDialectConformanceSuite';

package/dist/integration/conformance/runDialectConformanceSuite.d.ts

@@ -0,0 +1,11 @@
+import type { HarnessOptions, HarnessStrategy } from '../domain';
+/**
+ * Shared conformance checks every harness strategy must satisfy.
+ *
+ * This is intentionally framework-agnostic so first-party and third-party
+ * strategies can run the same lifecycle validation.
+ */
+export declare function runDialectConformanceSuite(strategy: HarnessStrategy, options?: {
+    createOptions?: HarnessOptions;
+    migrationsDir?: string;
+}): Promise<void>;

package/dist/integration/domain/Dialect.d.ts

@@ -1,4 +1,5 @@
-export declare enum Dialect {
-    Sqlite = "sqlite",
-    Postgres = "postgres"
-}
+export declare const Dialect: {
+    readonly Sqlite: "sqlite";
+    readonly Postgres: "postgres";
+};
+export type Dialect = (typeof Dialect)[keyof typeof Dialect];

package/dist/integration/domain/ResetMode.d.ts

@@ -1,5 +1,6 @@
-export declare enum ResetMode {
-    Transaction = "transaction",
-    Truncate = "truncate",
-    DropSchema = "drop-schema"
-}
+export declare const ResetMode: {
+    readonly Transaction: "transaction";
+    readonly Truncate: "truncate";
+    readonly DropSchema: "drop-schema";
+};
+export type ResetMode = (typeof ResetMode)[keyof typeof ResetMode];

package/dist/integration/index.d.ts

@@ -4,8 +4,15 @@
  */
 export * as domain from './domain/index';
 export * as migrations from './migrations/index';
+export * as conformance from './conformance/index';
+export * as runtime from './runtime/index';
+export * as smoke from './smoke/index';
 export * from './domain/index';
+export * from './anIntegrationHarness';
 export * from './HarnessStrategyRegistry';
 export * from './TestHarness';
 export * from './migrations/index';
-export * from './orm';
+export * from './conformance/index';
+export * from './orm/index';
+export * from './runtime/index';
+export * from './smoke/index';

package/dist/integration/index.js

@@ -1,3 +1,4 @@
-import { Dialect, HarnessStrategyRegistry, ResetMode, TestHarness, applyAndVerifyMigrations, assertMigrationPlan, createRepositoryFixture, domain_exports, expectQueryResult, introspectSchema, migrations_exports, seedTable } from "../integration-CDdpboYz.js";
+import "../aDBClient-W6eXsK3X.js";
+import { AppProcessHarness, Dialect, HarnessStrategyRegistry, ResetMode, TestHarness, aTangoConfig, anIntegrationHarness, applyAndVerifyMigrations, assertMigrationPlan, conformance_exports, createQuerySetFixture, domain_exports, expectQueryResult, introspectSchema, migrations_exports, runDialectConformanceSuite, runtime_exports, seedTable, setupTestTangoRuntime, smoke_exports } from "../integration-BrJw6NzG.js";
 
-export { Dialect, HarnessStrategyRegistry, ResetMode, TestHarness, applyAndVerifyMigrations, assertMigrationPlan, createRepositoryFixture, domain_exports as domain, expectQueryResult, introspectSchema, migrations_exports as migrations, seedTable };
+export { AppProcessHarness, Dialect, HarnessStrategyRegistry, ResetMode, TestHarness, aTangoConfig, anIntegrationHarness, applyAndVerifyMigrations, assertMigrationPlan, conformance_exports as conformance, createQuerySetFixture, domain_exports as domain, expectQueryResult, introspectSchema, migrations_exports as migrations, runDialectConformanceSuite, runtime_exports as runtime, seedTable, setupTestTangoRuntime, smoke_exports as smoke };

package/dist/integration/migrations/ApplyAndVerifyMigrations.d.ts

@@ -8,6 +8,9 @@ export type MigrationStatus = {
     id: string;
     applied: boolean;
 };
+/**
+ * Apply migrations through a harness and optionally verify that specific ids were applied.
+ */
 export declare function applyAndVerifyMigrations(harness: IntegrationHarness, options: ApplyAndVerifyMigrationsOptions): Promise<{
     statuses: MigrationStatus[];
 }>;

package/dist/integration/migrations/AssertMigrationPlan.d.ts

@@ -3,4 +3,7 @@ export type AssertMigrationPlanOptions = {
     migrationsDir: string;
     expectSqlContains?: string[];
 };
+/**
+ * Generate a migration plan through a harness and assert that required SQL fragments appear.
+ */
 export declare function assertMigrationPlan(harness: IntegrationHarness, options: AssertMigrationPlanOptions): Promise<string>;

package/dist/integration/migrations/IntrospectSchema.d.ts

@@ -1,2 +1,5 @@
 import { type IntegrationHarness } from '../domain';
+/**
+ * Introspect the schema visible to a harness using Tango's built-in introspectors.
+ */
 export declare function introspectSchema(harness: IntegrationHarness): Promise<unknown>;

package/dist/integration/orm/createQuerySetFixture.d.ts

@@ -0,0 +1,10 @@
+import { QuerySet } from '@danceroutine/tango-orm';
+import type { TableMeta } from '@danceroutine/tango-orm/query';
+import { type IntegrationHarness } from '../domain/index';
+/**
+ * Create a `QuerySet` fixture backed by a real integration harness and supplied table metadata.
+ */
+export declare function createQuerySetFixture<TModel extends Record<string, unknown>>(input: {
+    harness: IntegrationHarness;
+    meta: TableMeta;
+}): QuerySet<TModel>;

package/dist/integration/orm/expectQueryResult.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Assert that a query result matches an expected value using structural equality.
+ */
+export declare function expectQueryResult<T>(actual: Promise<T> | T, expected: T): Promise<void>;

package/dist/integration/orm/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Domain boundary barrel: centralizes this subdomain's public contract.
+ */
+export { seedTable } from './seedTable';
+export { createQuerySetFixture } from './createQuerySetFixture';
+export { expectQueryResult } from './expectQueryResult';

package/dist/integration/orm/seedTable.d.ts

@@ -0,0 +1,5 @@
+import { type IntegrationHarness } from '../domain/index';
+/**
+ * Seed rows directly into a table for integration tests that need known fixtures.
+ */
+export declare function seedTable<T extends Record<string, unknown>>(harness: IntegrationHarness, table: string, rows: T[]): Promise<void>;

package/dist/integration/runtime/aTangoConfig.d.ts

@@ -0,0 +1,8 @@
+import { type TangoConfig } from '@danceroutine/tango-config';
+export type TestTangoConfigOptions = {
+    adapter?: 'sqlite' | 'postgres';
+};
+/**
+ * Create a stable Tango config fixture for runtime-oriented tests.
+ */
+export declare function aTangoConfig(options?: TestTangoConfigOptions): TangoConfig;