pipework 0.8.6 → 0.8.8

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"}

package/dist/vector/namespace.d.ts

@@ -0,0 +1,27 @@
+import { vector as vectorColumn, tsvector } from './types.js';
+import { cosineDistance, cosineSimilarity, l2Distance, innerProduct, toTsvector, toTsquery, tsRank } from './query.js';
+import { validateVectorExtension } from './validate.js';
+/** Vector and full-text search namespace — pgvector column types and similarity/ranking queries. */
+export declare const vector: {
+    /** Defines a vector(N) column for embeddings. */
+    column: typeof vectorColumn;
+    /** Defines a tsvector column for full-text search. */
+    tsvector: typeof tsvector;
+    /** Cosine distance between a column and a query vector (lower = more similar). */
+    cosine: typeof cosineDistance;
+    /** Cosine similarity (higher = more similar) — 1 - cosineDistance. */
+    cosineSimilarity: typeof cosineSimilarity;
+    /** L2 (Euclidean) distance between a column and a query vector. */
+    l2: typeof l2Distance;
+    /** Inner product between a column and a query vector. */
+    innerProduct: typeof innerProduct;
+    /** Converts text to a tsvector for full-text indexing. */
+    toTsvector: typeof toTsvector;
+    /** Converts a search query string to a tsquery. */
+    toTsquery: typeof toTsquery;
+    /** Computes ts_rank for full-text search result ordering. */
+    rank: typeof tsRank;
+    /** Verifies the pgvector extension is installed and accessible. */
+    validate: typeof validateVectorExtension;
+};
+//# sourceMappingURL=namespace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../src/vector/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC7D,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;AAEvD,oGAAoG;AACpG,eAAO,MAAM,MAAM;IACjB,iDAAiD;;IAEjD,sDAAsD;;IAEtD,kFAAkF;;IAElF,sEAAsE;;IAEtE,mEAAmE;;IAEnE,yDAAyD;;IAEzD,0DAA0D;;IAE1D,mDAAmD;;IAEnD,6DAA6D;;IAE7D,mEAAmE;;CAEpE,CAAA"}

package/dist/vector/namespace.js

@@ -0,0 +1,27 @@
+import { vector as vectorColumn, tsvector } from './types.js';
+import { cosineDistance, cosineSimilarity, l2Distance, innerProduct, toTsvector, toTsquery, tsRank } from './query.js';
+import { validateVectorExtension } from './validate.js';
+/** Vector and full-text search namespace — pgvector column types and similarity/ranking queries. */
+export const vector = {
+    /** Defines a vector(N) column for embeddings. */
+    column: vectorColumn,
+    /** Defines a tsvector column for full-text search. */
+    tsvector,
+    /** Cosine distance between a column and a query vector (lower = more similar). */
+    cosine: cosineDistance,
+    /** Cosine similarity (higher = more similar) — 1 - cosineDistance. */
+    cosineSimilarity,
+    /** L2 (Euclidean) distance between a column and a query vector. */
+    l2: l2Distance,
+    /** Inner product between a column and a query vector. */
+    innerProduct,
+    /** Converts text to a tsvector for full-text indexing. */
+    toTsvector,
+    /** Converts a search query string to a tsquery. */
+    toTsquery,
+    /** Computes ts_rank for full-text search result ordering. */
+    rank: tsRank,
+    /** Verifies the pgvector extension is installed and accessible. */
+    validate: validateVectorExtension,
+};
+//# sourceMappingURL=namespace.js.map

package/dist/vector/namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../src/vector/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC7D,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;AAEvD,oGAAoG;AACpG,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,iDAAiD;IACjD,MAAM,EAAE,YAAY;IACpB,sDAAsD;IACtD,QAAQ;IACR,kFAAkF;IAClF,MAAM,EAAE,cAAc;IACtB,sEAAsE;IACtE,gBAAgB;IAChB,mEAAmE;IACnE,EAAE,EAAE,UAAU;IACd,yDAAyD;IACzD,YAAY;IACZ,0DAA0D;IAC1D,UAAU;IACV,mDAAmD;IACnD,SAAS;IACT,6DAA6D;IAC7D,IAAI,EAAE,MAAM;IACZ,mEAAmE;IACnE,QAAQ,EAAE,uBAAuB;CAClC,CAAA"}

package/dist/vector/query.d.ts

@@ -0,0 +1,9 @@
+import type { SQL, Column } from '../db/types.js';
+export declare function cosineDistance(column: Column, query: number[]): SQL<number>;
+export declare function cosineSimilarity(column: Column, query: number[]): SQL<number>;
+export declare function l2Distance(column: Column, query: number[]): SQL<number>;
+export declare function innerProduct(column: Column, query: number[]): SQL<number>;
+export declare function toTsvector(text: string | SQL, config?: string): SQL;
+export declare function toTsquery(query: string, config?: string): SQL;
+export declare function tsRank(column: Column, query: string, config?: string): SQL<number>;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/vector/query.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAEjD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAG3E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAG7E;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAGvE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAGzE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,CAMnE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,CAG7D;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAGlF"}

package/dist/vector/query.js

@@ -0,0 +1,33 @@
+import { sql } from '../db/sql.js';
+export function cosineDistance(column, query) {
+    const vectorStr = `[${query.join(',')}]`;
+    return sql `${column} <=> ${vectorStr}::vector`;
+}
+export function cosineSimilarity(column, query) {
+    const vectorStr = `[${query.join(',')}]`;
+    return sql `1 - (${column} <=> ${vectorStr}::vector)`;
+}
+export function l2Distance(column, query) {
+    const vectorStr = `[${query.join(',')}]`;
+    return sql `${column} <-> ${vectorStr}::vector`;
+}
+export function innerProduct(column, query) {
+    const vectorStr = `[${query.join(',')}]`;
+    return sql `${column} <#> ${vectorStr}::vector`;
+}
+export function toTsvector(text, config) {
+    const tsConfig = config ?? 'english';
+    if (typeof text === 'string') {
+        return sql `to_tsvector(${tsConfig}, ${text})`;
+    }
+    return sql `to_tsvector(${tsConfig}, ${text})`;
+}
+export function toTsquery(query, config) {
+    const tsConfig = config ?? 'english';
+    return sql `to_tsquery(${tsConfig}, ${query})`;
+}
+export function tsRank(column, query, config) {
+    const tsConfig = config ?? 'english';
+    return sql `ts_rank(${column}, to_tsquery(${tsConfig}, ${query}))`;
+}
+//# sourceMappingURL=query.js.map

package/dist/vector/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/vector/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAGlC,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,KAAe;IAC5D,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA;IACxC,OAAO,GAAG,CAAQ,GAAG,MAAM,QAAQ,SAAS,UAAU,CAAA;AACxD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,KAAe;IAC9D,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA;IACxC,OAAO,GAAG,CAAQ,QAAQ,MAAM,QAAQ,SAAS,WAAW,CAAA;AAC9D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,KAAe;IACxD,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA;IACxC,OAAO,GAAG,CAAQ,GAAG,MAAM,QAAQ,SAAS,UAAU,CAAA;AACxD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,KAAe;IAC1D,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA;IACxC,OAAO,GAAG,CAAQ,GAAG,MAAM,QAAQ,SAAS,UAAU,CAAA;AACxD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAkB,EAAE,MAAe;IAC5D,MAAM,QAAQ,GAAG,MAAM,IAAI,SAAS,CAAA;IACpC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,GAAG,CAAA,eAAe,QAAQ,KAAK,IAAI,GAAG,CAAA;IAC/C,CAAC;IACD,OAAO,GAAG,CAAA,eAAe,QAAQ,KAAK,IAAI,GAAG,CAAA;AAC/C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,MAAe;IACtD,MAAM,QAAQ,GAAG,MAAM,IAAI,SAAS,CAAA;IACpC,OAAO,GAAG,CAAA,cAAc,QAAQ,KAAK,KAAK,GAAG,CAAA;AAC/C,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,MAAc,EAAE,KAAa,EAAE,MAAe;IACnE,MAAM,QAAQ,GAAG,MAAM,IAAI,SAAS,CAAA;IACpC,OAAO,GAAG,CAAQ,WAAW,MAAM,gBAAgB,QAAQ,KAAK,KAAK,IAAI,CAAA;AAC3E,CAAC"}

package/dist/vector/types.d.ts

@@ -0,0 +1,19 @@
+export declare function vector(name: string, config: {
+    dimensions: number;
+}): import("drizzle-orm/pg-core").PgCustomColumnBuilder<{
+    name: string;
+    dataType: "custom";
+    columnType: "PgCustomColumn";
+    data: number[];
+    driverParam: unknown;
+    enumValues: undefined;
+}>;
+export declare function tsvector(name: string): import("drizzle-orm/pg-core").PgCustomColumnBuilder<{
+    name: string;
+    dataType: "custom";
+    columnType: "PgCustomColumn";
+    data: unknown;
+    driverParam: unknown;
+    enumValues: undefined;
+}>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/vector/types.ts"],"names":[],"mappings":"AAEA,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE;;;;;;;GAgBlE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM;;;;;;;GAMpC"}

package/dist/vector/types.js

@@ -0,0 +1,26 @@
+import { customType } from '../db/col/index.js';
+export function vector(name, config) {
+    return customType({
+        dataType() {
+            return `vector(${config.dimensions})`;
+        },
+        toDriver(value) {
+            return `[${value.join(',')}]`;
+        },
+        fromDriver(value) {
+            if (typeof value === 'string') {
+                const trimmed = value.startsWith('[') ? value.slice(1, -1) : value;
+                return trimmed.split(',').map(Number);
+            }
+            return value;
+        },
+    })(name);
+}
+export function tsvector(name) {
+    return customType({
+        dataType() {
+            return 'tsvector';
+        },
+    })(name);
+}
+//# sourceMappingURL=types.js.map

package/dist/vector/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/vector/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAE/C,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,MAA8B;IACjE,OAAO,UAAU,CAA0C;QACzD,QAAQ;YACN,OAAO,UAAU,MAAM,CAAC,UAAU,GAAG,CAAA;QACvC,CAAC;QACD,QAAQ,CAAC,KAAe;YACtB,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA;QAC/B,CAAC;QACD,UAAU,CAAC,KAAc;YACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;gBAClE,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YACvC,CAAC;YACD,OAAO,KAAiB,CAAA;QAC1B,CAAC;KACF,CAAC,CAAC,IAAI,CAAC,CAAA;AACV,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,UAAU,CAA0C;QACzD,QAAQ;YACN,OAAO,UAAU,CAAA;QACnB,CAAC;KACF,CAAC,CAAC,IAAI,CAAC,CAAA;AACV,CAAC"}

package/dist/vector/validate.d.ts

@@ -0,0 +1,3 @@
+import type { DB } from '../db/index.js';
+export declare function validateVectorExtension(db: DB): Promise<void>;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/vector/validate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAA;AAExC,wBAAsB,uBAAuB,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAYnE"}