@rawsql-ts/ztd-cli 0.14.4 → 0.16.0

package/templates/dist/writer-core/src/index.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.remove = exports.update = exports.insert = void 0;
+const identifierPattern = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const identifierControlPattern = /[\u0000-\u001F\u007F]/;
+const assertIdentifierBasics = (identifier, kind) => {
+    if (identifier.length === 0) {
+        throw new Error(`${kind} identifier must not be empty`);
+    }
+    if (identifierControlPattern.test(identifier)) {
+        throw new Error(`identifier "${identifier}" must not contain control characters`);
+    }
+};
+const assertColumnIdentifier = (identifier, allowUnsafe) => {
+    assertIdentifierBasics(identifier, 'column');
+    if (!allowUnsafe && !identifierPattern.test(identifier)) {
+        throw new Error(`column identifier "${identifier}" must match ${identifierPattern}`);
+    }
+};
+const assertTableIdentifier = (identifier, allowUnsafe) => {
+    assertIdentifierBasics(identifier, 'table');
+    if (!allowUnsafe && !identifierPattern.test(identifier)) {
+        throw new Error(`table identifier "${identifier}" must match ${identifierPattern}`);
+    }
+};
+const hasParamValueEntry = (entry) => entry[1] !== undefined;
+const ensureEntries = (entries, kind) => {
+    if (entries.length === 0) {
+        throw new Error(kind === 'insert' ? 'insert values must not be empty' : 'update values must not be empty');
+    }
+};
+const formatPlaceholder = (index) => `$${index}`;
+const buildPlaceholders = (count, startIndex = 1) => Array.from({ length: count }, (_, index) => formatPlaceholder(startIndex + index));
+const buildWhereClause = (key, startIndex, options) => {
+    const entries = Object.entries(key);
+    if (entries.length === 0) {
+        throw new Error('where must not be empty');
+    }
+    const params = [];
+    const clauses = entries.map(([column, value], index) => {
+        assertColumnIdentifier(column, options === null || options === void 0 ? void 0 : options.allowUnsafeIdentifiers);
+        if (value === undefined) {
+            throw new Error('key values must not be undefined');
+        }
+        params.push(value);
+        return `${column} = ${formatPlaceholder(startIndex + index)}`;
+    });
+    // Build a flat AND list of equality checks with placeholders offset by the caller.
+    return {
+        clause: `WHERE ${clauses.join(' AND ')}`,
+        params,
+    };
+};
+/**
+ * Build an INSERT statement that keeps SQL visible and drops undefined fields.
+ * @param options – Pass `allowUnsafeIdentifiers` when you knowingly use Unicode names.
+ */
+const insert = (table, values, options) => {
+    const allowUnsafe = (options === null || options === void 0 ? void 0 : options.allowUnsafeIdentifiers) === true;
+    assertTableIdentifier(table, allowUnsafe);
+    const entries = Object.entries(values).filter(hasParamValueEntry);
+    ensureEntries(entries, 'insert');
+    const columns = [];
+    const params = [];
+    for (const [column, value] of entries) {
+        assertColumnIdentifier(column, allowUnsafe);
+        columns.push(column);
+        params.push(value);
+    }
+    const columnsList = columns.join(', ');
+    const placeholders = buildPlaceholders(params.length).join(', ');
+    return {
+        sql: `INSERT INTO ${table} (${columnsList}) VALUES (${placeholders})`,
+        params,
+    };
+};
+exports.insert = insert;
+/**
+ * Build an UPDATE statement that reuses parameterized placeholders and guards empty sets.
+ * @param options – Pass `allowUnsafeIdentifiers` when you knowingly use Unicode names.
+ */
+const update = (table, values, where, options) => {
+    const allowUnsafe = (options === null || options === void 0 ? void 0 : options.allowUnsafeIdentifiers) === true;
+    assertTableIdentifier(table, allowUnsafe);
+    const entries = Object.entries(values).filter(hasParamValueEntry);
+    ensureEntries(entries, 'update');
+    const params = [];
+    const clauses = entries.map(([column, value]) => {
+        assertColumnIdentifier(column, allowUnsafe);
+        params.push(value);
+        return `${column} = ${formatPlaceholder(params.length)}`;
+    });
+    // Offset WHERE placeholders so they follow the SET parameters.
+    const whereClause = buildWhereClause(where, params.length + 1, options);
+    return {
+        sql: `UPDATE ${table} SET ${clauses.join(', ')} ${whereClause.clause}`,
+        params: [...params, ...whereClause.params],
+    };
+};
+exports.update = update;
+/**
+ * Build a DELETE statement that only emits equality-only WHERE clauses.
+ * @param options – Pass `allowUnsafeIdentifiers` when you knowingly use Unicode names.
+ */
+const remove = (table, where, options) => {
+    const allowUnsafe = (options === null || options === void 0 ? void 0 : options.allowUnsafeIdentifiers) === true;
+    assertTableIdentifier(table, allowUnsafe);
+    const whereClause = buildWhereClause(where, 1, options);
+    return {
+        sql: `DELETE FROM ${table} ${whereClause.clause}`,
+        params: [...whereClause.params],
+    };
+};
+exports.remove = remove;
+//# sourceMappingURL=index.js.map

package/templates/dist/writer-core/src/index.js.map

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

package/templates/dist/ztd-cli/templates/src/db/sql-client.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Promise that resolves to the array of rows produced by an SQL query.
+ * @template T Shape of each row yielded by the SQL client.
+ * @example
+ * const rows: SqlQueryRows<{ id: number; name: string }> = client.query('SELECT id, name FROM users');
+ */
+export type SqlQueryRows<T> = Promise<T[]>;
+/**
+ * Minimal SQL client interface required by the repository layer.
+ *
+ * - Production: adapt `pg` (or other drivers) to normalize results into `T[]`
+ * - Tests: compatible with `pg-testkit` clients returned by `createTestkitClient()`
+ *
+ * Connection strategy note:
+ * - Prefer a shared client per worker process for performance.
+ * - Do not share a live client across parallel workers.
+ */
+export type SqlClient = {
+    query<T extends Record<string, unknown> = Record<string, unknown>>(text: string, values?: readonly unknown[]): SqlQueryRows<T>;
+};

package/templates/dist/ztd-cli/templates/src/db/sql-client.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=sql-client.js.map

package/templates/dist/ztd-cli/templates/src/db/sql-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-client.js","sourceRoot":"","sources":["../../../../../src/db/sql-client.ts"],"names":[],"mappings":""}

package/templates/dist/ztd-cli/templates/src/repositories/user-accounts.d.ts

@@ -0,0 +1,36 @@
+import type { SqlClient } from '../db/sql-client';
+import { insert, Key, remove, update } from '@rawsql-ts/writer-core';
+type UserProfileRow = {
+    profileId: number;
+    userAccountId: number;
+    bio: string | null;
+    website: string | null;
+    verified: boolean;
+};
+export type UserAccountWithProfile = {
+    userAccountId: number;
+    username: string;
+    email: string;
+    displayName: string;
+    createdAt: Date;
+    updatedAt: Date;
+    profile?: UserProfileRow;
+};
+export declare function listUserProfiles(client: SqlClient): Promise<UserAccountWithProfile[]>;
+export type NewUserAccount = {
+    username: string;
+    email: string;
+    displayName: string;
+};
+export type DisplayNameUpdatePayload = {
+    displayName: string;
+};
+export declare function buildInsertUserAccount(input: NewUserAccount): ReturnType<typeof insert>;
+export declare function buildUpdateDisplayName(key: Key, payload: DisplayNameUpdatePayload): ReturnType<typeof update>;
+export declare function buildRemoveUserAccount(key: Key): ReturnType<typeof remove>;
+export declare const userAccountWriterColumnSets: {
+    insertColumns: readonly ["username", "email", "display_name"];
+    updateColumns: readonly ["display_name", "updated_at"];
+    immutableColumns: readonly ["user_account_id", "created_at"];
+};
+export {};

package/templates/dist/ztd-cli/templates/src/repositories/user-accounts.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.userAccountWriterColumnSets = void 0;
+exports.listUserProfiles = listUserProfiles;
+exports.buildInsertUserAccount = buildInsertUserAccount;
+exports.buildUpdateDisplayName = buildUpdateDisplayName;
+exports.buildRemoveUserAccount = buildRemoveUserAccount;
+const mapper_core_1 = require("@rawsql-ts/mapper-core");
+const writer_core_1 = require("@rawsql-ts/writer-core");
+const userAccountTable = 'public.user_account';
+// Map the joined profile columns so we can hydrate nested objects later.
+const profileMapping = (0, mapper_core_1.entity)({
+    name: 'userProfile',
+    key: 'profileId',
+    columnMap: {
+        profileId: 'profile_id',
+        userAccountId: 'profile_user_account_id',
+        bio: 'bio',
+        website: 'website',
+        verified: 'verified',
+    },
+});
+const userAccountMapping = (0, mapper_core_1.entity)({
+    name: 'userAccount',
+    key: 'userAccountId',
+    columnMap: {
+        userAccountId: 'user_account_id',
+        username: 'username',
+        email: 'email',
+        displayName: 'display_name',
+        createdAt: 'created_at',
+        updatedAt: 'updated_at',
+    },
+}).belongsTo('profile', profileMapping, 'userAccountId', { optional: true });
+const userProfilesSql = `
+SELECT
+  u.user_account_id,
+  u.username,
+  u.email,
+  u.display_name,
+  u.created_at,
+  u.updated_at,
+  p.profile_id,
+  p.user_account_id AS profile_user_account_id,
+  p.bio,
+  p.website,
+  p.verified
+FROM public.user_account u
+LEFT JOIN public.user_profile p ON p.user_account_id = u.user_account_id
+ORDER BY u.user_account_id, p.profile_id;
+`;
+// Build a mapper that can translate snake_case columns into camelCase DTOs.
+const createMapperForClient = (client) => (0, mapper_core_1.createMapper)((0, mapper_core_1.toRowsExecutor)((sql, params = []) => client.query(sql, params)), {
+    keyTransform: 'snake_to_camel',
+    coerceDates: true,
+});
+async function listUserProfiles(client) {
+    const mapper = createMapperForClient(client);
+    return mapper.query(userProfilesSql, [], userAccountMapping);
+}
+// Writer helpers keep SQL+params visible and enforce the minimal CUD surface.
+function buildInsertUserAccount(input) {
+    return (0, writer_core_1.insert)(userAccountTable, {
+        username: input.username,
+        email: input.email,
+        display_name: input.displayName,
+    });
+}
+function buildUpdateDisplayName(key, payload) {
+    return (0, writer_core_1.update)(userAccountTable, {
+        // Persist the new display name and bump the timestamp along with it.
+        display_name: payload.displayName,
+        updated_at: new Date(),
+    }, key);
+}
+function buildRemoveUserAccount(key) {
+    return (0, writer_core_1.remove)(userAccountTable, key);
+}
+// Tests consume these lists to verify writer callers stay within the approved columns.
+exports.userAccountWriterColumnSets = {
+    insertColumns: ['username', 'email', 'display_name'],
+    updateColumns: ['display_name', 'updated_at'],
+    immutableColumns: ['user_account_id', 'created_at'],
+};
+//# sourceMappingURL=user-accounts.js.map

package/templates/dist/ztd-cli/templates/src/repositories/user-accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-accounts.js","sourceRoot":"","sources":["../../../../../src/repositories/user-accounts.ts"],"names":[],"mappings":";;;AAgFA,4CAKC;AAaD,wDAQC;AAED,wDAaC;AAED,wDAEC;AA5HD,wDAA8E;AAC9E,wDAAqE;AAErE,MAAM,gBAAgB,GAAG,qBAAqB,CAAC;AAoB/C,yEAAyE;AACzE,MAAM,cAAc,GAAG,IAAA,oBAAM,EAAiB;IAC5C,IAAI,EAAE,aAAa;IACnB,GAAG,EAAE,WAAW;IAChB,SAAS,EAAE;QACT,SAAS,EAAE,YAAY;QACvB,aAAa,EAAE,yBAAyB;QACxC,GAAG,EAAE,KAAK;QACV,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,UAAU;KACrB;CACF,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,IAAA,oBAAM,EAAyB;IACxD,IAAI,EAAE,aAAa;IACnB,GAAG,EAAE,eAAe;IACpB,SAAS,EAAE;QACT,aAAa,EAAE,iBAAiB;QAChC,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,cAAc;QAC3B,SAAS,EAAE,YAAY;QACvB,SAAS,EAAE,YAAY;KACxB;CACF,CAAC,CAAC,SAAS,CAAC,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AAE7E,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;CAgBvB,CAAC;AAEF,4EAA4E;AAC5E,MAAM,qBAAqB,GAAG,CAAC,MAAiB,EAAE,EAAE,CAClD,IAAA,0BAAY,EACV,IAAA,4BAAc,EAAC,CAAC,GAAG,EAAE,SAAoB,EAAE,EAAE,EAAE,CAC7C,MAAM,CAAC,KAAK,CAA0B,GAAG,EAAE,MAAM,CAAC,CACnD,EACD;IACE,YAAY,EAAE,gBAAgB;IAC9B,WAAW,EAAE,IAAI;CAClB,CACF,CAAC;AAEG,KAAK,UAAU,gBAAgB,CACpC,MAAiB;IAEjB,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC7C,OAAO,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,EAAE,kBAAkB,CAAC,CAAC;AAC/D,CAAC;AAYD,8EAA8E;AAC9E,SAAgB,sBAAsB,CACpC,KAAqB;IAErB,OAAO,IAAA,oBAAM,EAAC,gBAAgB,EAAE;QAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,YAAY,EAAE,KAAK,CAAC,WAAW;KAChC,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,sBAAsB,CACpC,GAAQ,EACR,OAAiC;IAEjC,OAAO,IAAA,oBAAM,EACX,gBAAgB,EAChB;QACE,qEAAqE;QACrE,YAAY,EAAE,OAAO,CAAC,WAAW;QACjC,UAAU,EAAE,IAAI,IAAI,EAAE;KACvB,EACD,GAAG,CACJ,CAAC;AACJ,CAAC;AAED,SAAgB,sBAAsB,CAAC,GAAQ;IAC7C,OAAO,IAAA,oBAAM,EAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC;AAED,uFAAuF;AAC1E,QAAA,2BAA2B,GAAG;IACzC,aAAa,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,cAAc,CAAU;IAC7D,aAAa,EAAE,CAAC,cAAc,EAAE,YAAY,CAAU;IACtD,gBAAgB,EAAE,CAAC,iBAAiB,EAAE,YAAY,CAAU;CAC7D,CAAC"}

package/templates/dist/ztd-cli/templates/tests/generated/ztd-row-map.generated.d.ts

@@ -0,0 +1,20 @@
+import type { TableFixture, TableSchemaDefinition } from '@rawsql-ts/testkit-core';
+export type TestRowMap = {
+    'public.user_account': {
+        user_account_id: number;
+        username: string;
+        email: string;
+        display_name: string;
+        created_at: string;
+        updated_at: string;
+    };
+    'public.user_profile': {
+        profile_id: number;
+        user_account_id: number;
+        bio: string | null;
+        website: string | null;
+        verified: boolean;
+    };
+};
+export declare const tableSchemas: Record<keyof TestRowMap, TableSchemaDefinition>;
+export declare function tableFixture<TableName extends keyof TestRowMap>(tableName: TableName, rows: TestRowMap[TableName][], schema: TableSchemaDefinition): TableFixture;

package/templates/dist/ztd-cli/templates/tests/generated/ztd-row-map.generated.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tableSchemas = void 0;
+exports.tableFixture = tableFixture;
+exports.tableSchemas = {
+    'public.user_account': {
+        columns: {
+            user_account_id: 'int',
+            username: 'text',
+            email: 'text',
+            display_name: 'text',
+            created_at: 'timestamp',
+            updated_at: 'timestamp',
+        },
+    },
+    'public.user_profile': {
+        columns: {
+            profile_id: 'int',
+            user_account_id: 'int',
+            bio: 'text',
+            website: 'text',
+            verified: 'boolean',
+        },
+    },
+};
+function tableFixture(tableName, rows, schema) {
+    return {
+        tableName,
+        rows,
+        schema,
+    };
+}
+//# sourceMappingURL=ztd-row-map.generated.js.map

package/templates/dist/ztd-cli/templates/tests/generated/ztd-row-map.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ztd-row-map.generated.js","sourceRoot":"","sources":["../../../../../tests/generated/ztd-row-map.generated.ts"],"names":[],"mappings":";;;AA0CA,oCAUC;AAhCY,QAAA,YAAY,GAAoD;IAC3E,qBAAqB,EAAE;QACrB,OAAO,EAAE;YACP,eAAe,EAAE,KAAK;YACtB,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,MAAM;YACb,YAAY,EAAE,MAAM;YACpB,UAAU,EAAE,WAAW;YACvB,UAAU,EAAE,WAAW;SACxB;KACF;IACD,qBAAqB,EAAE;QACrB,OAAO,EAAE;YACP,UAAU,EAAE,KAAK;YACjB,eAAe,EAAE,KAAK;YACtB,GAAG,EAAE,MAAM;YACX,OAAO,EAAE,MAAM;YACf,QAAQ,EAAE,SAAS;SACpB;KACF;CACF,CAAC;AAEF,SAAgB,YAAY,CAC1B,SAAoB,EACpB,IAA6B,EAC7B,MAA6B;IAE7B,OAAO;QACL,SAAS;QACT,IAAI;QACJ,MAAM;KACP,CAAC;AACJ,CAAC"}

package/templates/dist/ztd-cli/templates/tests/support/global-setup.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Vitest global setup.
+ *
+ * ZTD tests are safe to run in parallel against a single Postgres instance because pg-testkit
+ * rewrites CRUD into fixture-backed SELECT queries (no physical tables are created/mutated).
+ *
+ * This setup starts exactly one disposable Postgres container when DATABASE_URL is not provided,
+ * and shares the resulting DATABASE_URL with all Vitest workers.
+ */
+export default function globalSetup(): Promise<(() => undefined) | (() => Promise<void>)>;

package/templates/dist/ztd-cli/templates/tests/support/global-setup.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = globalSetup;
+const postgresql_1 = require("@testcontainers/postgresql");
+/**
+ * Vitest global setup.
+ *
+ * ZTD tests are safe to run in parallel against a single Postgres instance because pg-testkit
+ * rewrites CRUD into fixture-backed SELECT queries (no physical tables are created/mutated).
+ *
+ * This setup starts exactly one disposable Postgres container when DATABASE_URL is not provided,
+ * and shares the resulting DATABASE_URL with all Vitest workers.
+ */
+async function globalSetup() {
+    const configuredUrl = process.env.DATABASE_URL;
+    if (configuredUrl && configuredUrl.length > 0) {
+        return () => undefined;
+    }
+    const container = new postgresql_1.PostgreSqlContainer('postgres:18-alpine')
+        .withDatabase('ztd_playground')
+        .withUsername('postgres')
+        .withPassword('postgres');
+    const started = await container.start();
+    process.env.DATABASE_URL = started.getConnectionUri();
+    return async () => {
+        await started.stop();
+    };
+}
+//# sourceMappingURL=global-setup.js.map

package/templates/dist/ztd-cli/templates/tests/support/global-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-setup.js","sourceRoot":"","sources":["../../../../../tests/support/global-setup.ts"],"names":[],"mappings":";;AAWA,8BAiBC;AA5BD,2DAAiE;AAEjE;;;;;;;;GAQG;AACY,KAAK,UAAU,WAAW;IACvC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAC/C,IAAI,aAAa,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;IACzB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,gCAAmB,CAAC,oBAAoB,CAAC;SAC5D,YAAY,CAAC,gBAAgB,CAAC;SAC9B,YAAY,CAAC,UAAU,CAAC;SACxB,YAAY,CAAC,UAAU,CAAC,CAAC;IAE5B,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAEtD,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC,CAAC;AACJ,CAAC"}

package/templates/dist/ztd-cli/templates/tests/support/testkit-client.d.ts

@@ -0,0 +1,66 @@
+import type { QueryResultRow } from 'pg';
+import type { TableFixture } from '@rawsql-ts/testkit-core';
+type ZtdSqlLogPhase = 'original' | 'rewritten';
+type ZtdSqlLogEvent = {
+    kind: 'ztd-sql';
+    phase: ZtdSqlLogPhase;
+    queryId: number;
+    sql: string;
+    params?: unknown[];
+    fixturesApplied?: string[];
+    timestamp: string;
+};
+export type ZtdExecutionMode = 'ztd' | 'traditional';
+export type TraditionalIsolationMode = 'schema' | 'none';
+export type TraditionalCleanupStrategy = 'drop_schema' | 'custom_sql' | 'none';
+export interface TraditionalExecutionConfig {
+    isolation?: TraditionalIsolationMode;
+    setupSql?: string[];
+    cleanup?: TraditionalCleanupStrategy;
+    cleanupSql?: string[];
+    schemaName?: string;
+}
+export type ZtdSqlLogOptions = {
+    enabled?: boolean;
+    includeParams?: boolean;
+    logger?: (event: ZtdSqlLogEvent) => void;
+    profile?: ZtdProfileOptions;
+    mode?: ZtdExecutionMode;
+    traditional?: TraditionalExecutionConfig;
+};
+type ZtdProfilePhase = 'connection' | 'setup' | 'query' | 'teardown';
+type ZtdProfileEvent = {
+    kind: 'ztd-profile';
+    phase: ZtdProfilePhase;
+    testName?: string;
+    workerId?: string;
+    processId: number;
+    executionMode?: 'serial' | 'parallel' | 'unknown';
+    connectionReused?: boolean;
+    queryId?: number;
+    queryCount?: number;
+    durationMs?: number;
+    totalQueryMs?: number;
+    sql?: string;
+    params?: unknown[];
+    fixturesApplied?: string[];
+    sampleSql?: string[];
+    timestamp: string;
+};
+export type ZtdProfileOptions = {
+    enabled?: boolean;
+    perQuery?: boolean;
+    includeParams?: boolean;
+    includeSql?: boolean;
+    sampleLimit?: number;
+    testName?: string;
+    executionMode?: 'serial' | 'parallel' | 'unknown';
+    logger?: (event: ZtdProfileEvent) => void;
+};
+export type ZtdPlaygroundQueryResult<T extends QueryResultRow = QueryResultRow> = Promise<T[]>;
+export type ZtdPlaygroundClient = {
+    query<T extends QueryResultRow = QueryResultRow>(text: string, values?: unknown[]): ZtdPlaygroundQueryResult<T>;
+    close(): Promise<void>;
+};
+export declare function createTestkitClient(fixtures: TableFixture[], options?: ZtdSqlLogOptions): Promise<ZtdPlaygroundClient>;
+export {};