pipework 0.8.7 → 0.8.8

package/dist/tenant/types.d.ts

@@ -0,0 +1,14 @@
+/** Configuration for tenant extraction and isolation strategy. */
+export interface TenantConfig {
+    readonly extract: (auth: unknown) => string | null;
+    readonly sessionVars?: Record<string, (ctx: TenantContext) => string>;
+    readonly validate?: (tenantId: string) => boolean;
+    readonly required?: boolean;
+}
+/** Resolved tenant context — tenant ID, request ID, and user ID. */
+export interface TenantContext {
+    readonly tenant: string;
+    readonly requestId: string;
+    readonly userId: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tenant/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tenant/types.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAA;IAClD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,MAAM,CAAC,CAAA;IACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAA;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B"}

package/dist/tenant/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tenant/types.js.map

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

package/dist/tenant/validate.d.ts

@@ -0,0 +1,4 @@
+export declare function validateTenantId(value: string): boolean;
+export declare function validateSessionVarName(name: string): void;
+export declare function validateSessionVarValue(value: string): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/tenant/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/tenant/validate.ts"],"names":[],"mappings":"AAIA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAQzD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAQ3D"}

package/dist/tenant/validate.js

@@ -0,0 +1,20 @@
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const SAFE_VAR_NAME = /^[a-z][a-z0-9_.]*$/;
+export function validateTenantId(value) {
+    return UUID_PATTERN.test(value);
+}
+export function validateSessionVarName(name) {
+    if (!SAFE_VAR_NAME.test(name)) {
+        throw new Error(`[pipework] Invalid session variable name: "${name}". ` +
+            `Variable names must match /^[a-z][a-z0-9_.]*$/. ` +
+            `This prevents SQL injection in SET LOCAL statements.`);
+    }
+}
+export function validateSessionVarValue(value) {
+    if (/[;'"\n\r]/.test(value)) {
+        throw new Error(`[pipework] Unsafe session variable value rejected. ` +
+            `Values must not contain semicolons, quotes, or newlines. ` +
+            `Received: "${value.slice(0, 40)}${value.length > 40 ? '...' : ''}"`);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/tenant/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/tenant/validate.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,iEAAiE,CAAA;AAEtF,MAAM,aAAa,GAAG,oBAAoB,CAAA;AAE1C,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,8CAA8C,IAAI,KAAK;YACvD,kDAAkD;YAClD,sDAAsD,CACvD,CAAA;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,qDAAqD;YACrD,2DAA2D;YAC3D,cAAc,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,CACrE,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/test/vitest-config.d.ts

@@ -0,0 +1,21 @@
+import { type ViteUserConfig } from 'vitest/config';
+import { type PipeworkVitestOptions } from './vitest-plugin.js';
+export { resolveVitestWorkspace, resolveVitestModules } from './vitest-workspace.js';
+export type { PipeworkVitestOptions };
+export interface TestConfigOptions {
+    /** Set to `false` to skip DB auto-setup — use for pure unit test configs that never call `pipe()` or `withFlow()`. Shorthand for `pipework: { database: false }`. */
+    database?: boolean;
+    pipework?: PipeworkVitestOptions;
+    test?: {
+        setupFiles?: string | string[];
+        testTimeout?: number;
+        hookTimeout?: number;
+        pool?: string;
+        include?: string[];
+        exclude?: string[];
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export declare function defineTestConfig(overrides?: TestConfigOptions): ViteUserConfig;
+//# sourceMappingURL=vitest-config.d.ts.map

package/dist/test/vitest-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest-config.d.ts","sourceRoot":"","sources":["../../src/test/vitest-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AACjE,OAAO,EAAY,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAEzE,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AACpF,YAAY,EAAE,qBAAqB,EAAE,CAAA;AAErC,MAAM,WAAW,iBAAiB;IAChC,qKAAqK;IACrK,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,qBAAqB,CAAA;IAChC,IAAI,CAAC,EAAE;QACL,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;QAC9B,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;QAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;QAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KACvB,CAAA;IACD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,iBAAiB,GAAG,cAAc,CAuC9E"}

package/dist/test/vitest-config.js

@@ -0,0 +1,47 @@
+import { defineConfig } from 'vitest/config';
+import { pipework } from './vitest-plugin.js';
+export { resolveVitestWorkspace, resolveVitestModules } from './vitest-workspace.js';
+export function defineTestConfig(overrides) {
+    const pipeworkOptions = { ...overrides?.pipework };
+    if (overrides?.database === false) {
+        pipeworkOptions.database = false;
+    }
+    const useDatabase = pipeworkOptions.database !== false;
+    const { setupFiles: userSetupFiles, ...restTestOverrides } = overrides?.test ?? {};
+    const setupFiles = useDatabase
+        ? ['pipework/test/setup', ...normalizeStringArray(userSetupFiles)]
+        : normalizeStringArray(userSetupFiles);
+    const otherOverrides = {};
+    if (overrides) {
+        for (const key of Object.keys(overrides)) {
+            if (key !== 'pipework' && key !== 'test' && key !== 'database') {
+                otherOverrides[key] = overrides[key];
+            }
+        }
+    }
+    return defineConfig({
+        plugins: [pipework(pipeworkOptions)],
+        test: {
+            testTimeout: 30_000,
+            hookTimeout: 60_000,
+            pool: 'forks',
+            isolate: false,
+            server: {
+                deps: {
+                    inline: ['pipework'],
+                },
+            },
+            ...restTestOverrides,
+            ...(setupFiles.length > 0 ? { setupFiles } : {}),
+        },
+        ...otherOverrides,
+    });
+}
+function normalizeStringArray(value) {
+    if (Array.isArray(value))
+        return value;
+    if (typeof value === 'string')
+        return [value];
+    return [];
+}
+//# sourceMappingURL=vitest-config.js.map

package/dist/test/vitest-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest-config.js","sourceRoot":"","sources":["../../src/test/vitest-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,eAAe,CAAA;AACjE,OAAO,EAAE,QAAQ,EAA8B,MAAM,oBAAoB,CAAA;AAEzE,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAmBpF,MAAM,UAAU,gBAAgB,CAAC,SAA6B;IAC5D,MAAM,eAAe,GAA0B,EAAE,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAA;IACzE,IAAI,SAAS,EAAE,QAAQ,KAAK,KAAK,EAAE,CAAC;QAClC,eAAe,CAAC,QAAQ,GAAG,KAAK,CAAA;IAClC,CAAC;IACD,MAAM,WAAW,GAAG,eAAe,CAAC,QAAQ,KAAK,KAAK,CAAA;IAEtD,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,iBAAiB,EAAE,GAAG,SAAS,EAAE,IAAI,IAAI,EAAE,CAAA;IAClF,MAAM,UAAU,GAAG,WAAW;QAC5B,CAAC,CAAC,CAAC,qBAAqB,EAAE,GAAG,oBAAoB,CAAC,cAAc,CAAC,CAAC;QAClE,CAAC,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAA;IAExC,MAAM,cAAc,GAA4B,EAAE,CAAA;IAElD,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;gBAC/D,cAAc,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;YACtC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC;QAClB,OAAO,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;QACpC,IAAI,EAAE;YACJ,WAAW,EAAE,MAAM;YACnB,WAAW,EAAE,MAAM;YACnB,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,KAAK;YACd,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,MAAM,EAAE,CAAC,UAAU,CAAC;iBACrB;aACF;YACD,GAAG,iBAAiB;YACpB,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjD;QACD,GAAG,cAAc;KACA,CAAmB,CAAA;AACxC,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc;IAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAiB,CAAA;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IAC7C,OAAO,EAAE,CAAA;AACX,CAAC"}

package/dist/trunk.d.ts

@@ -0,0 +1,35 @@
+import type { ResolvedConfig } from './config/load.js';
+import type { ResolvedDatabase } from './config/load.js';
+import type { TrunkConfig } from './config/schema.js';
+import type { ManagedConnection } from './db/pool.js';
+export interface TrunkInstance {
+    readonly config: ResolvedConfig;
+    readonly pool: PoolState;
+    readonly isolation: IsolationState;
+    readonly connections: ConnectionTracker;
+}
+export interface PoolState {
+    getOrCreate(config: ResolvedDatabase): ManagedConnection;
+    get(name: string): ManagedConnection | undefined;
+    closeAll(): Promise<void>;
+    count(): number;
+}
+export interface IsolationState {
+    markBegin(): void;
+    markEnd(): void;
+    assertClean(): void;
+    stats(): {
+        active: number;
+        totalBegins: number;
+        totalEnds: number;
+    };
+    reset(): void;
+}
+export interface ConnectionTracker {
+    track(id: string, name: string, context: string): void;
+    release(id: string): void;
+    activeCount(): number;
+    assertNoLeaks(maxExpected: number): void;
+}
+export declare function createTrunk(raw: TrunkConfig): TrunkInstance;
+//# sourceMappingURL=trunk.d.ts.map

package/dist/trunk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trunk.d.ts","sourceRoot":"","sources":["../src/trunk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAExD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAIrD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAA;IAClC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAA;CACxC;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB,CAAA;IACxD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAA;IAChD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB,KAAK,IAAI,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,IAAI,IAAI,CAAA;IACjB,OAAO,IAAI,IAAI,CAAA;IACf,WAAW,IAAI,IAAI,CAAA;IACnB,KAAK,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IACnE,KAAK,IAAI,IAAI,CAAA;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,WAAW,IAAI,MAAM,CAAA;IACrB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CACzC;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,aAAa,CAO3D"}

package/dist/trunk.js

@@ -0,0 +1,102 @@
+import { loadConfig as parseConfig } from './config/load.js';
+import { createManagedConnection } from './db/pool.js';
+import { InvariantViolation } from './invariants/assert.js';
+export function createTrunk(raw) {
+    const config = parseConfig(raw);
+    const pool = createPoolState();
+    const isolation = createIsolationState();
+    const connections = createConnectionTracker();
+    return { config, pool, isolation, connections };
+}
+function createPoolState() {
+    const map = new Map();
+    return {
+        getOrCreate(config) {
+            const existing = map.get(config.name);
+            if (existing)
+                return existing;
+            const managed = createManagedConnection(config, () => map.delete(config.name));
+            map.set(config.name, managed);
+            return managed;
+        },
+        get(name) {
+            return map.get(name);
+        },
+        async closeAll() {
+            const closing = [...map.values()].map(c => c.close());
+            await Promise.all(closing);
+        },
+        count() {
+            return map.size;
+        },
+    };
+}
+function createIsolationState() {
+    let active = 0;
+    let totalBegins = 0;
+    let totalEnds = 0;
+    return {
+        markBegin() {
+            active++;
+            totalBegins++;
+        },
+        markEnd() {
+            if (active <= 0) {
+                throw new InvariantViolation('isolation-end-without-begin', {
+                    activeIsolationContexts: active,
+                    totalBegins,
+                    totalEnds,
+                });
+            }
+            active--;
+            totalEnds++;
+        },
+        assertClean() {
+            if (active !== 0) {
+                throw new InvariantViolation('isolation-context-leak', {
+                    activeIsolationContexts: active,
+                    totalBegins,
+                    totalEnds,
+                    delta: totalBegins - totalEnds,
+                });
+            }
+        },
+        stats() {
+            return { active, totalBegins, totalEnds };
+        },
+        reset() {
+            active = 0;
+            totalBegins = 0;
+            totalEnds = 0;
+        },
+    };
+}
+function createConnectionTracker() {
+    const tracked = new Map();
+    return {
+        track(id, name, context) {
+            tracked.set(id, { name, createdAt: Date.now(), context });
+        },
+        release(id) {
+            tracked.delete(id);
+        },
+        activeCount() {
+            return tracked.size;
+        },
+        assertNoLeaks(maxExpected) {
+            if (tracked.size > maxExpected) {
+                throw new InvariantViolation('connection-pool-bounded', {
+                    active: tracked.size,
+                    maxExpected,
+                    connections: [...tracked.entries()].map(([id, c]) => ({
+                        id,
+                        name: c.name,
+                        age_ms: Date.now() - c.createdAt,
+                        context: c.context,
+                    })),
+                });
+            }
+        },
+    };
+}
+//# sourceMappingURL=trunk.js.map

package/dist/trunk.js.map

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

package/dist/validation/connectivity.d.ts

@@ -0,0 +1,4 @@
+import type { ValidationIssue } from './types.js';
+import type { ResolvedDatabase } from '../config/load.js';
+export declare function validateConnectivity(databases: ReadonlyMap<string, ResolvedDatabase>, timeoutMs?: number): Promise<ValidationIssue[]>;
+//# sourceMappingURL=connectivity.d.ts.map

package/dist/validation/connectivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectivity.d.ts","sourceRoot":"","sources":["../../src/validation/connectivity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzD,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAChD,SAAS,SAAO,GACf,OAAO,CAAC,eAAe,EAAE,CAAC,CAgB5B"}

package/dist/validation/connectivity.js

@@ -0,0 +1,32 @@
+export async function validateConnectivity(databases, timeoutMs = 5000) {
+    const issues = [];
+    const checks = [...databases.entries()].map(async ([name, db]) => {
+        try {
+            await testConnection(db.url, timeoutMs);
+        }
+        catch (err) {
+            issues.push({
+                phase: 'database',
+                message: `cannot connect to database "${name}": ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+    });
+    await Promise.all(checks);
+    return issues;
+}
+async function testConnection(url, timeoutMs) {
+    const { default: postgres } = await import('postgres');
+    const sql = postgres(url, {
+        max: 1,
+        idle_timeout: 1,
+        connect_timeout: Math.ceil(timeoutMs / 1000),
+        onnotice: () => { },
+    });
+    try {
+        await sql `SELECT 1`;
+    }
+    finally {
+        await sql.end({ timeout: 1 });
+    }
+}
+//# sourceMappingURL=connectivity.js.map

package/dist/validation/connectivity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectivity.js","sourceRoot":"","sources":["../../src/validation/connectivity.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,SAAgD,EAChD,SAAS,GAAG,IAAI;IAEhB,MAAM,MAAM,GAAsB,EAAE,CAAA;IAEpC,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;QAC/D,IAAI,CAAC;YACH,MAAM,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;QACzC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,UAAU;gBACjB,OAAO,EAAE,+BAA+B,IAAI,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;aACrG,CAAC,CAAA;QACJ,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACzB,OAAO,MAAM,CAAA;AACf,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,SAAiB;IAC1D,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAA;IAEtD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE;QACxB,GAAG,EAAE,CAAC;QACN,YAAY,EAAE,CAAC;QACf,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAC5C,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;KACnB,CAAC,CAAA;IAEF,IAAI,CAAC;QACH,MAAM,GAAG,CAAA,UAAU,CAAA;IACrB,CAAC;YAAS,CAAC;QACT,MAAM,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAA;IAC/B,CAAC;AACH,CAAC"}

package/dist/validation/domain.d.ts

@@ -0,0 +1,4 @@
+import type { DefinedTable } from '../domain/types.js';
+import type { ValidationIssue } from './types.js';
+export declare function validateDomainIntegrity(definitions: ReadonlyMap<string, DefinedTable>, configuredDatabases: readonly string[]): ValidationIssue[];
+//# sourceMappingURL=domain.d.ts.map

package/dist/validation/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../src/validation/domain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,EAC9C,mBAAmB,EAAE,SAAS,MAAM,EAAE,GACrC,eAAe,EAAE,CA+EnB"}

package/dist/validation/domain.js

@@ -0,0 +1,72 @@
+export function validateDomainIntegrity(definitions, configuredDatabases) {
+    const issues = [];
+    const tableNames = new Map();
+    const brandNames = new Map();
+    for (const [name, def] of definitions) {
+        if (def.$options.virtual === true)
+            continue;
+        if (tableNames.has(name)) {
+            issues.push({
+                phase: 'domain',
+                message: `"${name}" table name conflicts with "${tableNames.get(name)}"`,
+            });
+        }
+        else {
+            tableNames.set(name, name);
+        }
+        if (def.$options.database !== undefined) {
+            if (!configuredDatabases.includes(def.$options.database)) {
+                issues.push({
+                    phase: 'domain',
+                    message: `${name}.database "${def.$options.database}" is not a configured database`,
+                });
+            }
+        }
+        let tenantFieldCount = 0;
+        for (const [fieldName, descriptor] of Object.entries(def.$fields)) {
+            const meta = descriptor._meta;
+            if (meta.tenant)
+                tenantFieldCount++;
+            if (meta.reference !== undefined) {
+                const refDef = meta.reference.definition;
+                if (!definitions.has(refDef.$name)) {
+                    issues.push({
+                        phase: 'domain',
+                        message: `${name}.${fieldName} references "${refDef.$name}" — no matching domain definition`,
+                    });
+                }
+                const refField = refDef.$fields[meta.reference.field];
+                if (refField === undefined) {
+                    issues.push({
+                        phase: 'domain',
+                        message: `${name}.${fieldName} references "${refDef.$name}.${meta.reference.field}" — field does not exist`,
+                    });
+                }
+            }
+            if (meta.brand !== undefined) {
+                const isInheritedFromFK = meta.reference !== undefined
+                    && meta.reference.definition.$fields[meta.reference.field]?._meta.brand === meta.brand;
+                if (!isInheritedFromFK) {
+                    const existing = brandNames.get(meta.brand);
+                    if (existing !== undefined && existing !== `${name}.${fieldName}`) {
+                        issues.push({
+                            phase: 'domain',
+                            message: `brand "${meta.brand}" used by both ${existing} and ${name}.${fieldName}`,
+                        });
+                    }
+                    else {
+                        brandNames.set(meta.brand, `${name}.${fieldName}`);
+                    }
+                }
+            }
+        }
+        if (tenantFieldCount > 1) {
+            issues.push({
+                phase: 'domain',
+                message: `${name} has ${String(tenantFieldCount)} tenant fields — exactly one expected`,
+            });
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=domain.js.map

package/dist/validation/domain.js.map

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

package/dist/validation/index.d.ts

@@ -0,0 +1,6 @@
+export { validateStartup, type ValidationContext } from './startup.js';
+export { validateDomainIntegrity } from './domain.js';
+export { collectSurfaceIssues } from '../surface/validate.js';
+export { validateConnectivity } from './connectivity.js';
+export { StartupValidationError, type ValidationIssue, type ValidationPhase } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAA;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,EAAE,sBAAsB,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAA"}

package/dist/validation/index.js

@@ -0,0 +1,6 @@
+export { validateStartup } from './startup.js';
+export { validateDomainIntegrity } from './domain.js';
+export { collectSurfaceIssues } from '../surface/validate.js';
+export { validateConnectivity } from './connectivity.js';
+export { StartupValidationError } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA0B,MAAM,cAAc,CAAA;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,EAAE,sBAAsB,EAA8C,MAAM,YAAY,CAAA"}

package/dist/validation/startup.d.ts

@@ -0,0 +1,12 @@
+import type { SurfaceMap } from '../surface/types.js';
+import type { ResolvedDatabase } from '../config/load.js';
+export interface ValidationContext {
+    readonly configuredDatabases: readonly string[];
+    readonly environment: string;
+    readonly surfaces?: SurfaceMap | undefined;
+    readonly defaultDbAvailable?: boolean | undefined;
+    readonly databases?: ReadonlyMap<string, ResolvedDatabase> | undefined;
+    readonly connectivityCheck?: boolean | undefined;
+}
+export declare function validateStartup(ctx: ValidationContext): Promise<void>;
+//# sourceMappingURL=startup.d.ts.map

package/dist/validation/startup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup.d.ts","sourceRoot":"","sources":["../../src/validation/startup.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,SAAS,CAAA;IAC1C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,SAAS,CAAA;IACtE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACjD;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB3E"}

package/dist/validation/startup.js

@@ -0,0 +1,19 @@
+import { StartupValidationError } from './types.js';
+import { validateDomainIntegrity } from './domain.js';
+import { collectSurfaceIssues } from '../surface/validate.js';
+import { validateConnectivity } from './connectivity.js';
+import { definitions } from '../domain/define.js';
+export async function validateStartup(ctx) {
+    const issues = [];
+    issues.push(...validateDomainIntegrity(definitions(), ctx.configuredDatabases));
+    if (ctx.surfaces !== undefined) {
+        issues.push(...collectSurfaceIssues(ctx.surfaces, ctx.configuredDatabases, ctx.defaultDbAvailable ?? ctx.configuredDatabases.length === 1));
+    }
+    if (ctx.connectivityCheck !== false && ctx.databases !== undefined) {
+        issues.push(...await validateConnectivity(ctx.databases));
+    }
+    if (issues.length > 0) {
+        throw new StartupValidationError(issues);
+    }
+}
+//# sourceMappingURL=startup.js.map

package/dist/validation/startup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup.js","sourceRoot":"","sources":["../../src/validation/startup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAajD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAsB;IAC1D,MAAM,MAAM,GAAsB,EAAE,CAAA;IAEpC,MAAM,CAAC,IAAI,CAAC,GAAG,uBAAuB,CAAC,WAAW,EAAE,EAAE,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAA;IAE/E,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CACT,GAAG,oBAAoB,CACrB,GAAG,CAAC,QAAQ,EACZ,GAAG,CAAC,mBAAmB,EACvB,GAAG,CAAC,kBAAkB,IAAI,GAAG,CAAC,mBAAmB,CAAC,MAAM,KAAK,CAAC,CAC/D,CACF,CAAA;IACH,CAAC;IAED,IAAI,GAAG,CAAC,iBAAiB,KAAK,KAAK,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACnE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,oBAAoB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAA;IAC3D,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAA;IAC1C,CAAC;AACH,CAAC"}

package/dist/validation/surface.d.ts

@@ -0,0 +1,4 @@
+import type { ValidationIssue } from './types.js';
+import type { SurfaceMap } from '../surface/types.js';
+export declare function validateSurfaceIntegrity(surfaces: SurfaceMap, configuredDatabases: readonly string[], defaultDbAvailable: boolean): ValidationIssue[];
+//# sourceMappingURL=surface.d.ts.map

package/dist/validation/surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../../src/validation/surface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAErD,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,UAAU,EACpB,mBAAmB,EAAE,SAAS,MAAM,EAAE,EACtC,kBAAkB,EAAE,OAAO,GAC1B,eAAe,EAAE,CAwDnB"}

package/dist/validation/surface.js

@@ -0,0 +1,55 @@
+export function validateSurfaceIntegrity(surfaces, configuredDatabases, defaultDbAvailable) {
+    const issues = [];
+    const dbSet = new Set(configuredDatabases);
+    for (const [name, surface] of Object.entries(surfaces)) {
+        for (const db of surface.manifest.databases) {
+            if (db === '__default__') {
+                if (!defaultDbAvailable) {
+                    issues.push({
+                        phase: 'surface',
+                        message: `"${name}" uses the default database, but multiple databases are configured: ${configuredDatabases.join(', ')}`,
+                    });
+                }
+            }
+            else if (!dbSet.has(db)) {
+                issues.push({
+                    phase: 'surface',
+                    message: `"${name}" requires database "${db}" which is not configured (available: ${configuredDatabases.join(', ')})`,
+                });
+            }
+        }
+        if (surface.kind === 'worker' && surface.manifest.jobTypes.length === 0) {
+            issues.push({
+                phase: 'surface',
+                message: `"${name}" is a worker with no job handlers`,
+            });
+        }
+        const seen = new Set();
+        for (const jobType of surface.manifest.jobTypes) {
+            if (seen.has(jobType)) {
+                issues.push({
+                    phase: 'surface',
+                    message: `"${name}" has duplicate job type "${jobType}"`,
+                });
+            }
+            seen.add(jobType);
+        }
+    }
+    const jobOwners = new Map();
+    for (const [name, surface] of Object.entries(surfaces)) {
+        for (const jobType of surface.manifest.jobTypes) {
+            const existing = jobOwners.get(jobType);
+            if (existing !== undefined) {
+                issues.push({
+                    phase: 'surface',
+                    message: `job type "${jobType}" handled by both "${existing}" and "${name}"`,
+                });
+            }
+            else {
+                jobOwners.set(jobType, name);
+            }
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=surface.js.map

package/dist/validation/surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.js","sourceRoot":"","sources":["../../src/validation/surface.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,wBAAwB,CACtC,QAAoB,EACpB,mBAAsC,EACtC,kBAA2B;IAE3B,MAAM,MAAM,GAAsB,EAAE,CAAA;IACpC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,mBAAmB,CAAC,CAAA;IAE1C,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvD,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YAC5C,IAAI,EAAE,KAAK,aAAa,EAAE,CAAC;gBACzB,IAAI,CAAC,kBAAkB,EAAE,CAAC;oBACxB,MAAM,CAAC,IAAI,CAAC;wBACV,KAAK,EAAE,SAAS;wBAChB,OAAO,EAAE,IAAI,IAAI,uEAAuE,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;qBACzH,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;iBAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC1B,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,SAAS;oBAChB,OAAO,EAAE,IAAI,IAAI,wBAAwB,EAAE,yCAAyC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;iBACtH,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxE,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,SAAS;gBAChB,OAAO,EAAE,IAAI,IAAI,oCAAoC;aACtD,CAAC,CAAA;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;QAC9B,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAChD,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,SAAS;oBAChB,OAAO,EAAE,IAAI,IAAI,6BAA6B,OAAO,GAAG;iBACzD,CAAC,CAAA;YACJ,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACnB,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAA;IAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvD,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAChD,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACvC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,SAAS;oBAChB,OAAO,EAAE,aAAa,OAAO,sBAAsB,QAAQ,UAAU,IAAI,GAAG;iBAC7E,CAAC,CAAA;YACJ,CAAC;iBAAM,CAAC;gBACN,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/validation/types.d.ts

@@ -0,0 +1,13 @@
+/** Which subsystem produced the validation issue. */
+export type ValidationPhase = 'config' | 'workspace' | 'database' | 'domain' | 'surface';
+/** A single validation problem with its phase and human-readable message. */
+export interface ValidationIssue {
+    readonly phase: ValidationPhase;
+    readonly message: string;
+}
+/** Thrown when startup validation finds issues — lists all problems across all phases. */
+export declare class StartupValidationError extends Error {
+    readonly issues: readonly ValidationIssue[];
+    constructor(issues: readonly ValidationIssue[]);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/validation/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/validation/types.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAA;AAExF,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,0FAA0F;AAC1F,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;gBAE/B,MAAM,EAAE,SAAS,eAAe,EAAE;CAW/C"}

package/dist/validation/types.js

@@ -0,0 +1,13 @@
+/** Thrown when startup validation finds issues — lists all problems across all phases. */
+export class StartupValidationError extends Error {
+    issues;
+    constructor(issues) {
+        const summary = issues
+            .map(i => `  [${i.phase}]${' '.repeat(Math.max(1, 12 - i.phase.length))}${i.message}`)
+            .join('\n');
+        super(`Startup validation failed (${String(issues.length)} issue${issues.length === 1 ? '' : 's'}):\n\n${summary}\n\nFix these issues and restart.`);
+        this.name = 'StartupValidationError';
+        this.issues = issues;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/validation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/validation/types.ts"],"names":[],"mappings":"AASA,0FAA0F;AAC1F,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACtC,MAAM,CAA4B;IAE3C,YAAY,MAAkC;QAC5C,MAAM,OAAO,GAAG,MAAM;aACnB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;aACrF,IAAI,CAAC,IAAI,CAAC,CAAA;QAEb,KAAK,CACH,8BAA8B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,SAAS,OAAO,mCAAmC,CAC9I,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;CACF"}

package/dist/vector/index.d.ts

@@ -0,0 +1,4 @@
+export { vector, tsvector } from './types.js';
+export { cosineDistance, cosineSimilarity, l2Distance, innerProduct, toTsvector, toTsquery, tsRank } from './query.js';
+export { validateVectorExtension } from './validate.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/vector/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vector/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACtH,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA"}

package/dist/vector/index.js

@@ -0,0 +1,4 @@
+export { vector, tsvector } from './types.js';
+export { cosineDistance, cosineSimilarity, l2Distance, innerProduct, toTsvector, toTsquery, tsRank } from './query.js';
+export { validateVectorExtension } from './validate.js';
+//# sourceMappingURL=index.js.map

package/dist/vector/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vector/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACtH,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA"}