@danceroutine/tango-testing 1.11.0 → 1.11.2

package/dist/{aDBClient-CH-ZcOaP.js → aDBClient-fMkIdR7p.js}

@@ -1,7 +1,13 @@
 import { PostgresAdapter, SqliteAdapter } from "@danceroutine/tango-orm";
 import { vi } from "vitest";
-
 //#region src/mocks/anAdapter.ts
+/**
+* Create a real built-in `Adapter` instance for unit tests that need one.
+*
+* Defaults to a Postgres adapter; pass `{ dialect: 'sqlite' }` to obtain a
+* SQLite adapter. The returned adapter carries the matching placeholder
+* formatter so compilers exercised under test emit dialect-accurate SQL.
+*/
 function anAdapter(overrides = {}) {
 	const dialect = overrides.dialect ?? "postgres";
 	switch (dialect) {
@@ -10,9 +16,13 @@ function anAdapter(overrides = {}) {
 		default: throw new Error(`Unsupported dialect: ${dialect}`);
 	}
 }
-
 //#endregion
 //#region src/mocks/aDBClient.ts
+/**
+* Create a lightweight `DBClient` test double with optional behavior overrides.
+* The `query` override accepts any function returning `Promise<{ rows: any[] }>`,
+* so concrete-typed Vitest mocks do not require a cast at the call site.
+*/
 function aDBClient(overrides = {}) {
 	const queryImpl = overrides.query ?? (async (_sql, _params) => ({ rows: [] }));
 	const beginImpl = overrides.begin ?? (async () => {});
@@ -22,7 +32,7 @@ function aDBClient(overrides = {}) {
 	const createSavepointImpl = overrides.createSavepoint ?? (async (_name) => {});
 	const releaseSavepointImpl = overrides.releaseSavepoint ?? (async (_name) => {});
 	const rollbackToSavepointImpl = overrides.rollbackToSavepoint ?? (async (_name) => {});
-	const client = {
+	return {
 		query: vi.fn((sql, params) => queryImpl(sql, params)),
 		begin: vi.fn(() => beginImpl()),
 		commit: vi.fn(() => commitImpl()),
@@ -32,9 +42,8 @@ function aDBClient(overrides = {}) {
 		releaseSavepoint: vi.fn((name) => releaseSavepointImpl(name)),
 		rollbackToSavepoint: vi.fn((name) => rollbackToSavepointImpl(name))
 	};
-	return client;
 }
-
 //#endregion
-export { aDBClient, anAdapter };
-//# sourceMappingURL=aDBClient-CH-ZcOaP.js.map
+export { anAdapter as n, aDBClient as t };
+
+//# sourceMappingURL=aDBClient-fMkIdR7p.js.map

package/dist/aDBClient-fMkIdR7p.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aDBClient-fMkIdR7p.js","names":[],"sources":["../src/mocks/anAdapter.ts","../src/mocks/aDBClient.ts"],"sourcesContent":["import { PostgresAdapter, SqliteAdapter, type Adapter } from '@danceroutine/tango-orm';\nimport type { Dialect } from '@danceroutine/tango-orm/query';\n\nexport type AdapterOverrides = {\n    dialect?: Dialect;\n};\n\n/**\n * Create a real built-in `Adapter` instance for unit tests that need one.\n *\n * Defaults to a Postgres adapter; pass `{ dialect: 'sqlite' }` to obtain a\n * SQLite adapter. The returned adapter carries the matching placeholder\n * formatter so compilers exercised under test emit dialect-accurate SQL.\n */\nexport function anAdapter(overrides: AdapterOverrides = {}): Adapter {\n    const dialect: Dialect = overrides.dialect ?? 'postgres';\n    switch (dialect) {\n        case 'postgres':\n            return new PostgresAdapter();\n        case 'sqlite':\n            return new SqliteAdapter();\n        default:\n            throw new Error(`Unsupported dialect: ${dialect}`);\n    }\n}\n","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    createSavepoint?: (name: string) => Promise<void>;\n    releaseSavepoint?: (name: string) => Promise<void>;\n    rollbackToSavepoint?: (name: string) => 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    const createSavepointImpl = overrides.createSavepoint ?? (async (_name: string) => {});\n    const releaseSavepointImpl = overrides.releaseSavepoint ?? (async (_name: string) => {});\n    const rollbackToSavepointImpl = overrides.rollbackToSavepoint ?? (async (_name: string) => {});\n\n    const client: DBClient = {\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        createSavepoint: vi.fn((name: string) => createSavepointImpl(name)),\n        releaseSavepoint: vi.fn((name: string) => releaseSavepointImpl(name)),\n        rollbackToSavepoint: vi.fn((name: string) => rollbackToSavepointImpl(name)),\n    };\n\n    return client;\n}\n"],"mappings":";;;;;;;;;;AAcA,SAAgB,UAAU,YAA8B,CAAC,GAAY;CACjE,MAAM,UAAmB,UAAU,WAAW;CAC9C,QAAQ,SAAR;EACI,KAAK,YACD,OAAO,IAAI,gBAAgB;EAC/B,KAAK,UACD,OAAO,IAAI,cAAc;EAC7B,SACI,MAAM,IAAI,MAAM,wBAAwB,SAAS;CACzD;AACJ;;;;;;;;ACAA,SAAgB,UAAU,YAA+B,CAAC,GAAa;CACnE,MAAM,YAEF,UAAU,UAAU,OAAO,MAAc,aAAkC,EAAE,MAAM,CAAC,EAAW;CACnG,MAAM,YAAY,UAAU,UAAU,YAAY,CAAC;CACnD,MAAM,aAAa,UAAU,WAAW,YAAY,CAAC;CACrD,MAAM,eAAe,UAAU,aAAa,YAAY,CAAC;CACzD,MAAM,YAAY,UAAU,UAAU,YAAY,CAAC;CACnD,MAAM,sBAAsB,UAAU,oBAAoB,OAAO,UAAkB,CAAC;CACpF,MAAM,uBAAuB,UAAU,qBAAqB,OAAO,UAAkB,CAAC;CACtF,MAAM,0BAA0B,UAAU,wBAAwB,OAAO,UAAkB,CAAC;CAa5F,OAAO;EAVH,OAAO,GAAG,IAAI,KAAa,WAAgC,UAAU,KAAK,MAAM,CAAC;EACjF,OAAO,GAAG,SAAS,UAAU,CAAC;EAC9B,QAAQ,GAAG,SAAS,WAAW,CAAC;EAChC,UAAU,GAAG,SAAS,aAAa,CAAC;EACpC,OAAO,GAAG,SAAS,UAAU,CAAC;EAC9B,iBAAiB,GAAG,IAAI,SAAiB,oBAAoB,IAAI,CAAC;EAClE,kBAAkB,GAAG,IAAI,SAAiB,qBAAqB,IAAI,CAAC;EACpE,qBAAqB,GAAG,IAAI,SAAiB,wBAAwB,IAAI,CAAC;CAGlE;AAChB"}

package/dist/assertions/index.d.ts

@@ -1,4 +1,2 @@
-/**
- * Domain boundary barrel: centralizes this subdomain's public contract.
- */
-export { assertions } from './assertions';
+import { n as assertions } from "../index-CKVKW5j_.js";
+export { assertions };

package/dist/assertions/index.js

@@ -1,3 +1,2 @@
-import { assertions } from "../assertions-CCFZ53Y-.js";
-
-export { assertions };
+import { n as assertions } from "../assertions-lsAd7fhA.js";
+export { assertions };

package/dist/assertions-lsAd7fhA.js

@@ -0,0 +1,15 @@
+import { t as __exportAll } from "./chunk-D7D4PA-g.js";
+//#region src/assertions/assertions.ts
+/**
+* Assertion helpers for Tango models.
+*/
+const assertions = { matchesSchema(model, data) {
+	model.parse(data);
+} };
+//#endregion
+//#region src/assertions/index.ts
+var assertions_exports = /* @__PURE__ */ __exportAll({ assertions: () => assertions });
+//#endregion
+export { assertions as n, assertions_exports as t };
+
+//# sourceMappingURL=assertions-lsAd7fhA.js.map

package/dist/assertions-lsAd7fhA.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions-lsAd7fhA.js","names":[],"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":";;;;;AAKA,MAAa,aAAa,EACtB,cACI,OACA,MAC2C;CAC3C,MAAM,MAAM,IAAI;AACpB,EACJ"}

package/dist/chunk-D7D4PA-g.js

@@ -0,0 +1,13 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+export { __exportAll as t };

package/dist/express/index.d.ts

@@ -1,3 +1,2 @@
-export { anExpressRequest } from './anExpressRequest';
-export type { ExpressRequestOverrides } from './anExpressRequest';
-export { anExpressResponse } from './anExpressResponse';
+import { i as anExpressRequest, n as anExpressResponse, r as ExpressRequestOverrides } from "../index-BCWo7zAn.js";
+export { type ExpressRequestOverrides, anExpressRequest, anExpressResponse };

package/dist/express/index.js

@@ -1,3 +1,2 @@
-import { anExpressRequest, anExpressResponse } from "../express-Czpfz_Ay.js";
-
-export { anExpressRequest, anExpressResponse };
+import { n as anExpressResponse, r as anExpressRequest } from "../express-CH6_GAyC.js";
+export { anExpressRequest, anExpressResponse };

package/dist/{express-Czpfz_Ay.js → express-CH6_GAyC.js}

@@ -1,7 +1,12 @@
-import { __export } from "./chunk-BkvOhyD0.js";
-import { vi, vi as vi$1 } from "vitest";
-
+import { t as __exportAll } from "./chunk-D7D4PA-g.js";
+import { vi } from "vitest";
 //#region src/express/anExpressRequest.ts
+/**
+* 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.
+*/
 function anExpressRequest(overrides = {}) {
 	return {
 		protocol: "http",
@@ -9,18 +14,24 @@ function anExpressRequest(overrides = {}) {
 		originalUrl: "/",
 		url: "/",
 		headers: {},
-		body: undefined,
+		body: void 0,
 		params: {},
-		get: vi$1.fn((name) => name.toLowerCase() === "host" ? "localhost:3000" : undefined),
+		get: vi.fn((name) => name.toLowerCase() === "host" ? "localhost:3000" : void 0),
 		...overrides
 	};
 }
-
 //#endregion
 //#region src/express/anExpressResponse.ts
+/**
+* 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.
+*/
 function anExpressResponse() {
 	const res = {};
-	const chainable = [
+	for (const method of [
 		"status",
 		"sendStatus",
 		"links",
@@ -35,8 +46,7 @@ function anExpressResponse() {
 		"location",
 		"vary",
 		"append"
-	];
-	for (const method of chainable) res[method] = vi.fn().mockReturnValue(res);
+	]) res[method] = vi.fn().mockReturnValue(res);
 	res.send = vi.fn().mockReturnValue(res);
 	res.json = vi.fn().mockReturnValue(res);
 	res.jsonp = vi.fn().mockReturnValue(res);
@@ -54,15 +64,13 @@ function anExpressResponse() {
 	res.req = {};
 	return res;
 }
-
 //#endregion
 //#region src/express/index.ts
-var express_exports = {};
-__export(express_exports, {
+var express_exports = /* @__PURE__ */ __exportAll({
 	anExpressRequest: () => anExpressRequest,
 	anExpressResponse: () => anExpressResponse
 });
-
 //#endregion
-export { anExpressRequest, anExpressResponse, express_exports };
-//# sourceMappingURL=express-Czpfz_Ay.js.map
+export { anExpressResponse as n, anExpressRequest as r, express_exports as t };
+
+//# sourceMappingURL=express-CH6_GAyC.js.map

package/dist/express-CH6_GAyC.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express-CH6_GAyC.js","names":[],"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":";;;;;;;;;AA4BA,SAAgB,iBAAiB,YAAqC,CAAC,GAAY;CAC/E,OAAO;EACH,UAAU;EACV,QAAQ;EACR,aAAa;EACb,KAAK;EACL,SAAS,CAAC;EACV,MAAM,KAAA;EACN,QAAQ,CAAC;EACT,KAAK,GAAG,IAAI,SAAkB,KAAK,YAAY,MAAM,SAAS,mBAAmB,KAAA,CAAU;EAC3F,GAAG;CACP;AACJ;;;;;;;;;;AC9BA,SAAgB,oBAA8B;CAC1C,MAAM,MAA+B,CAAC;CAmBtC,KAAK,MAAM,UAAU;EAhBjB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CAGyB,GACzB,IAAI,UAAU,GAAG,GAAG,EAAE,gBAAgB,GAAG;CAG7C,IAAI,OAAO,GAAG,GAAG,EAAE,gBAAgB,GAAG;CACtC,IAAI,OAAO,GAAG,GAAG,EAAE,gBAAgB,GAAG;CACtC,IAAI,QAAQ,GAAG,GAAG,EAAE,gBAAgB,GAAG;CACvC,IAAI,MAAM,GAAG,GAAG,EAAE,gBAAgB,GAAG;CACrC,IAAI,WAAW,GAAG,GAAG;CACrB,IAAI,WAAW,GAAG,GAAG;CACrB,IAAI,WAAW,GAAG,GAAG;CACrB,IAAI,SAAS,GAAG,GAAG;CACnB,IAAI,MAAM,GAAG,GAAG;CAChB,IAAI,YAAY,GAAG,GAAG,EAAE,gBAAgB,GAAG;CAE3C,IAAI,cAAc;CAClB,IAAI,SAAS,CAAC;CACd,IAAI,UAAU;CACd,IAAI,MAAM,CAAC;CACX,IAAI,MAAM,CAAC;CAEX,OAAO;AACX"}

package/dist/factories/index.d.ts

@@ -1,4 +1,2 @@
-/**
- * Domain boundary barrel: centralizes this subdomain's public contract.
- */
-export { ModelDataFactory, type GenericModelFactory } from './ModelDataFactory';
+import { n as GenericModelFactory, r as ModelDataFactory } from "../index-49XmDOxW.js";
+export { type GenericModelFactory, ModelDataFactory };

package/dist/factories/index.js

@@ -1,3 +1,2 @@
-import { ModelDataFactory } from "../factories-Cl_CAzbj.js";
-
-export { ModelDataFactory };
+import { n as ModelDataFactory } from "../factories-qAJouv1I.js";
+export { ModelDataFactory };

package/dist/{factories-Cl_CAzbj.js → factories-qAJouv1I.js}

@@ -1,7 +1,11 @@
-import { __export } from "./chunk-BkvOhyD0.js";
-
+import { t as __exportAll } from "./chunk-D7D4PA-g.js";
 //#region src/factories/ModelDataFactory.ts
+/**
+* Factory class for generating test data with sequences and defaults.
+*/
 var ModelDataFactory = class {
+	model;
+	defaults;
 	sequence = 0;
 	constructor(model, defaults = {}) {
 		this.model = model;
@@ -44,12 +48,10 @@ var ModelDataFactory = class {
 		return {};
 	}
 };
-
 //#endregion
 //#region src/factories/index.ts
-var factories_exports = {};
-__export(factories_exports, { ModelDataFactory: () => ModelDataFactory });
-
+var factories_exports = /* @__PURE__ */ __exportAll({ ModelDataFactory: () => ModelDataFactory });
 //#endregion
-export { ModelDataFactory, factories_exports };
-//# sourceMappingURL=factories-Cl_CAzbj.js.map
+export { ModelDataFactory as n, factories_exports as t };
+
+//# sourceMappingURL=factories-qAJouv1I.js.map

package/dist/factories-qAJouv1I.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factories-qAJouv1I.js","names":[],"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":";;;;;AAQA,IAAa,mBAAb,MAAoG;CAIpF;CACA;CAJZ,WAAmB;CAEnB,YACI,OACA,WAA6D,CAAC,GAChE;EAFU,KAAA,QAAA;EACA,KAAA,WAAA;CACT;;;;CAKH,MAAa,YAAsD,CAAC,GAAiC;EACjG,KAAK;EACL,MAAM,OAAO;GACT,GAAG,KAAK;GACR,GAAG,KAAK,iBAAiB;GACzB,GAAG;EACP;EACA,OAAO,KAAK,MAAM,OAAO,IAAuC;CACpE;;;;CAKA,UACI,OACA,YAAsD,CAAC,GACzB;EAC9B,OAAO,MAAM,KAAK,EAAE,QAAQ,MAAM,SAAS,KAAK,MAAM,SAAS,CAAC;CACpE;;;;CAKA,gBAA6B;EACzB,KAAK,WAAW;CACpB;;;;CAKA,cAA6B;EACzB,OAAO,KAAK;CAChB;;;;CAKA,mBAAuE;EACnE,OAAO,CAAC;CACZ;AACJ"}

package/dist/index-49XmDOxW.d.ts

@@ -0,0 +1,40 @@
+//#region src/factories/ModelDataFactory.d.ts
+type GenericModelFactory<TInput extends Record<string, unknown> = Record<string, unknown>, TOutput = TInput> = {
+  create(data: TInput): TOutput;
+  parse(data: unknown): TOutput;
+};
+/**
+ * Factory class for generating test data with sequences and defaults.
+ */
+declare class ModelDataFactory<TModel extends GenericModelFactory<Record<string, unknown>, unknown>> {
+  private model;
+  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']>[];
+  /**
+   * 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]>;
+}
+declare namespace index_d_exports {
+  export { GenericModelFactory, ModelDataFactory };
+}
+//#endregion
+export { GenericModelFactory as n, ModelDataFactory as r, index_d_exports as t };
+//# sourceMappingURL=index-49XmDOxW.d.ts.map

package/dist/index-B4H3wYuR.d.ts

@@ -0,0 +1,325 @@
+import { Adapter, AdapterConfig, DBClient, QuerySet, TangoRuntime } from "@danceroutine/tango-orm";
+import { TableMeta } from "@danceroutine/tango-orm/query";
+import { MigrationRunner } from "@danceroutine/tango-migrations";
+import { TangoConfig } from "@danceroutine/tango-config";
+import { spawn } from "node:child_process";
+
+//#region src/integration/domain/Dialect.d.ts
+declare const Dialect$1: {
+  readonly Sqlite: "sqlite";
+  readonly Postgres: "postgres";
+};
+type Dialect$1 = (typeof Dialect$1)[keyof typeof Dialect$1];
+//#endregion
+//#region src/integration/domain/ResetMode.d.ts
+declare const ResetMode: {
+  readonly Transaction: "transaction";
+  readonly Truncate: "truncate";
+  readonly DropSchema: "drop-schema";
+};
+type ResetMode = (typeof ResetMode)[keyof typeof ResetMode];
+//#endregion
+//#region src/integration/domain/IntegrationHarness.d.ts
+interface DialectTestCapabilities {
+  transactionalDDL: boolean;
+  supportsSchemas: boolean;
+  supportsConcurrentIndex: boolean;
+  supportsDeferredFkValidation: boolean;
+  supportsJsonb: boolean;
+}
+interface IntegrationHarness {
+  readonly dialect: Dialect$1 | string;
+  readonly adapter: Adapter;
+  readonly capabilities: DialectTestCapabilities;
+  readonly resetMode: ResetMode;
+  readonly dbClient: DBClient;
+  setup(): Promise<void>;
+  reset(): Promise<void>;
+  teardown(): Promise<void>;
+  migrationRunner(migrationsDir: string): MigrationRunner;
+}
+//#endregion
+//#region src/integration/domain/HarnessStrategy.d.ts
+interface HarnessOptions {
+  config?: Partial<AdapterConfig>;
+  tangoConfigLoader?: () => unknown;
+  resetMode?: ResetMode;
+  schema?: string;
+  sqliteFile?: string;
+}
+interface HarnessStrategy {
+  readonly dialect: Dialect$1 | string;
+  readonly capabilities: DialectTestCapabilities;
+  create(options?: HarnessOptions): Promise<IntegrationHarness>;
+}
+declare namespace index_d_exports$5 {
+  export { Dialect$1 as Dialect, DialectTestCapabilities, HarnessOptions, HarnessStrategy, IntegrationHarness, ResetMode };
+}
+//#endregion
+//#region src/integration/migrations/AssertMigrationPlan.d.ts
+type AssertMigrationPlanOptions = {
+  migrationsDir: string;
+  expectSqlContains?: string[];
+};
+/**
+ * Generate a migration plan through a harness and assert that required SQL fragments appear.
+ */
+declare function assertMigrationPlan(harness: IntegrationHarness, options: AssertMigrationPlanOptions): Promise<string>;
+//#endregion
+//#region src/integration/migrations/ApplyAndVerifyMigrations.d.ts
+type ApplyAndVerifyMigrationsOptions = {
+  migrationsDir: string;
+  toId?: string;
+  expectedAppliedIds?: string[];
+};
+type MigrationStatus = {
+  id: string;
+  applied: boolean;
+};
+/**
+ * Apply migrations through a harness and optionally verify that specific ids were applied.
+ */
+declare function applyAndVerifyMigrations(harness: IntegrationHarness, options: ApplyAndVerifyMigrationsOptions): Promise<{
+  statuses: MigrationStatus[];
+}>;
+//#endregion
+//#region src/integration/migrations/IntrospectSchema.d.ts
+/**
+ * Introspect the schema visible to a harness using Tango's built-in introspectors.
+ */
+declare function introspectSchema(harness: IntegrationHarness): Promise<unknown>;
+declare namespace index_d_exports$4 {
+  export { ApplyAndVerifyMigrationsOptions, AssertMigrationPlanOptions, MigrationStatus, applyAndVerifyMigrations, assertMigrationPlan, introspectSchema };
+}
+//#endregion
+//#region src/integration/conformance/runDialectConformanceSuite.d.ts
+/**
+ * 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.
+ */
+declare function runDialectConformanceSuite(strategy: HarnessStrategy, options?: {
+  createOptions?: HarnessOptions;
+  migrationsDir?: string;
+}): Promise<void>;
+declare namespace index_d_exports$3 {
+  export { runDialectConformanceSuite };
+}
+//#endregion
+//#region src/integration/runtime/aTangoConfig.d.ts
+type TestTangoConfigOptions = {
+  adapter?: 'sqlite' | 'postgres';
+  sqliteFilename?: string;
+};
+/**
+ * Create a stable Tango config fixture for runtime-oriented tests.
+ */
+declare function aTangoConfig(options?: TestTangoConfigOptions): TangoConfig;
+//#endregion
+//#region src/integration/runtime/aTangoRuntime.d.ts
+/**
+ * Create a standalone Tango runtime for tests without mutating the process-default runtime.
+ */
+declare function aTangoRuntime(options?: TestTangoConfigOptions): TangoRuntime;
+//#endregion
+//#region src/integration/runtime/setupTestTangoRuntime.d.ts
+/**
+ * Reset and initialize the process-default Tango runtime for tests.
+ */
+declare function setupTestTangoRuntime(options?: TestTangoConfigOptions): Promise<TangoRuntime>;
+declare namespace index_d_exports$2 {
+  export { TestTangoConfigOptions, aTangoConfig, aTangoRuntime, setupTestTangoRuntime };
+}
+//#endregion
+//#region src/integration/smoke/AppProcessHarness.d.ts
+interface AppProcessHarnessOptions {
+  command: string;
+  args?: string[];
+  cwd?: string;
+  env?: Record<string, string | undefined>;
+  baseUrl: string;
+  readyPath?: string;
+  readyTimeoutMs?: number;
+  readyIntervalMs?: number;
+  stopTimeoutMs?: number;
+}
+type FetchLike = typeof fetch;
+type ProcessHarnessOutputStream = {
+  on(eventName: 'data', listener: (chunk: unknown) => void): unknown;
+};
+type ProcessHarnessChild = {
+  exitCode: number | null;
+  killed: boolean;
+  kill(signal?: NodeJS.Signals): boolean;
+  off(eventName: 'exit', listener: () => void): unknown;
+  once(eventName: 'exit', listener: () => void): unknown;
+  stdout?: ProcessHarnessOutputStream | null;
+  stderr?: ProcessHarnessOutputStream | null;
+};
+interface AppProcessHarnessDeps {
+  spawnProcess: (command: string, args?: readonly string[], options?: Parameters<typeof spawn>[2]) => ProcessHarnessChild;
+  fetchImpl: FetchLike;
+  sleep: (ms: number) => Promise<void>;
+}
+/**
+ * Lightweight process harness for end-to-end smoke tests that need a real app process.
+ */
+declare class AppProcessHarness {
+  static readonly BRAND: "tango.testing.app_process_harness";
+  readonly __tangoBrand: typeof AppProcessHarness.BRAND;
+  private readonly child;
+  private readonly baseUrl;
+  private readonly readyUrl;
+  private readonly readyTimeoutMs;
+  private readonly readyIntervalMs;
+  private readonly stopTimeoutMs;
+  private readonly deps;
+  private stopped;
+  private stdoutBuffer;
+  private stderrBuffer;
+  private constructor();
+  /**
+   * Narrow an unknown value to the smoke-test harness that owns a child process.
+   */
+  static isAppProcessHarness(value: unknown): value is AppProcessHarness;
+  /**
+   * Spawn the target process and wait until its readiness endpoint responds successfully.
+   */
+  static start(options: AppProcessHarnessOptions, deps?: Partial<AppProcessHarnessDeps>): Promise<AppProcessHarness>;
+  /**
+   * Return the buffered stdout log for recent process output.
+   */
+  getStdoutLog(): string;
+  /**
+   * Return the buffered stderr log for recent process output.
+   */
+  getStderrLog(): string;
+  /**
+   * Return stdout and stderr in a single formatted string for debugging failures.
+   */
+  getCombinedLog(): string;
+  /**
+   * Issue an HTTP request against the managed application process.
+   */
+  request(path: string, init?: RequestInit): Promise<Response>;
+  /**
+   * Assert an HTTP response status and include process logs when it mismatches.
+   */
+  assertResponseStatus(response: Response, expectedStatus: number, label: string): Promise<void>;
+  /**
+   * Stop the managed process, escalating from SIGTERM to SIGKILL when necessary.
+   */
+  stop(): Promise<void>;
+  private waitForReady;
+  private waitForExit;
+}
+declare namespace index_d_exports$1 {
+  export { AppProcessHarness, AppProcessHarnessOptions };
+}
+//#endregion
+//#region src/integration/anIntegrationHarness.d.ts
+/**
+ * Create an integration-harness fixture with optional overrides.
+ */
+declare function anIntegrationHarness(overrides?: Partial<IntegrationHarness>): IntegrationHarness;
+//#endregion
+//#region src/integration/HarnessStrategyRegistry.d.ts
+/**
+ * Registry of test harness strategies keyed by dialect.
+ */
+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$1 | string): HarnessStrategy;
+  /**
+   * List all registered strategies.
+   */
+  list(): readonly HarnessStrategy[];
+}
+//#endregion
+//#region src/integration/TestHarness.d.ts
+/**
+ * Facade for creating integration test harnesses by dialect.
+ */
+declare class TestHarness {
+  static readonly BRAND: "tango.testing.test_harness";
+  private static defaultRegistry;
+  readonly __tangoBrand: typeof TestHarness.BRAND;
+  /**
+   * Narrow an unknown value to `TestHarness`.
+   */
+  static isTestHarness(value: unknown): value is TestHarness;
+  /**
+   * 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$1 | 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;
+}
+//#endregion
+//#region src/integration/orm/seedTable.d.ts
+/**
+ * Seed rows directly into a table for integration tests that need known fixtures.
+ */
+declare function seedTable<T extends Record<string, unknown>>(harness: IntegrationHarness, table: string, rows: T[]): Promise<void>;
+//#endregion
+//#region src/integration/orm/createModelQuerySetFixture.d.ts
+/**
+ * Create a `ModelQuerySet` fixture backed by a real integration harness and supplied table metadata.
+ */
+declare function createModelQuerySetFixture<TModel extends Record<string, unknown>>(input: {
+  harness: IntegrationHarness;
+  meta: TableMeta;
+}): QuerySet<TModel>;
+//#endregion
+//#region src/integration/orm/createQuerySetFixture.d.ts
+/**
+ * @deprecated Use `createModelQuerySetFixture(...)` instead.
+ */
+declare function createQuerySetFixture<TModel extends Record<string, unknown>>(input: {
+  harness: IntegrationHarness;
+  meta: TableMeta;
+}): QuerySet<TModel>;
+//#endregion
+//#region src/integration/orm/expectQueryResult.d.ts
+/**
+ * Assert that a query result matches an expected value using structural equality.
+ */
+declare function expectQueryResult<T>(actual: Promise<T> | T, expected: T): Promise<void>;
+declare namespace index_d_exports {
+  export { AppProcessHarness, AppProcessHarnessOptions, ApplyAndVerifyMigrationsOptions, AssertMigrationPlanOptions, Dialect$1 as Dialect, DialectTestCapabilities, HarnessOptions, HarnessStrategy, HarnessStrategyRegistry, IntegrationHarness, MigrationStatus, ResetMode, TestHarness, TestTangoConfigOptions, aTangoConfig, aTangoRuntime, anIntegrationHarness, applyAndVerifyMigrations, assertMigrationPlan, index_d_exports$3 as conformance, createModelQuerySetFixture, createQuerySetFixture, index_d_exports$5 as domain, expectQueryResult, introspectSchema, index_d_exports$4 as migrations, runDialectConformanceSuite, index_d_exports$2 as runtime, seedTable, setupTestTangoRuntime, index_d_exports$1 as smoke };
+}
+//#endregion
+export { IntegrationHarness as A, applyAndVerifyMigrations as C, HarnessOptions as D, index_d_exports$5 as E, Dialect$1 as M, HarnessStrategy as O, MigrationStatus as S, assertMigrationPlan as T, index_d_exports$3 as _, seedTable as a, introspectSchema as b, anIntegrationHarness as c, AppProcessHarnessOptions as d, index_d_exports$2 as f, aTangoConfig as g, TestTangoConfigOptions as h, createModelQuerySetFixture as i, ResetMode as j, DialectTestCapabilities as k, index_d_exports$1 as l, aTangoRuntime as m, expectQueryResult as n, TestHarness as o, setupTestTangoRuntime as p, createQuerySetFixture as r, HarnessStrategyRegistry as s, index_d_exports as t, AppProcessHarness as u, runDialectConformanceSuite as v, AssertMigrationPlanOptions as w, ApplyAndVerifyMigrationsOptions as x, index_d_exports$4 as y };
+//# sourceMappingURL=index-B4H3wYuR.d.ts.map