pipework 0.7.12 → 0.7.17

package/dist/data/temporal/definition-queries.js

@@ -0,0 +1,45 @@
+import { atTime } from './query.js';
+import { revise } from './revise.js';
+import { TemporalIntegrityError } from './errors.js';
+import { and } from '../db/generated/drizzle-orm/operator.js';
+function requireEffectiveDated(definition, fnName) {
+    if (!definition.$traits.includes('effectiveDated')) {
+        throw new TemporalIntegrityError(`temporal.${fnName}() requires an effective-dated definition.\n\n` +
+            `  "${definition.$name}" does not have the .effectiveDated() trait.\n\n` +
+            `  Add .effectiveDated() to your definition:\n` +
+            `    pipe.define('${definition.$name}', { ... }).effectiveDated()\n`);
+    }
+}
+export async function asOf(db, definition, date, where) {
+    requireEffectiveDated(definition, 'asOf');
+    const table = definition.table();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- atTime expects column accessors typed by HasTemporalColumns
+    const temporal = atTime(table, date);
+    const condition = where !== undefined ? and(temporal, where) : temporal;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Drizzle select chain requires concrete table generics
+    return await db.select().from(table).where(condition);
+}
+export async function allVersions(db, definition, where) {
+    requireEffectiveDated(definition, 'allVersions');
+    const table = definition.table();
+    if (where !== undefined) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Drizzle select chain requires concrete table generics
+        return await db.select().from(table).where(where);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Drizzle select chain requires concrete table generics
+    return await db.select().from(table);
+}
+export async function effectiveUpdate(options) {
+    requireEffectiveDated(options.definition, 'effectiveUpdate');
+    const reviseOptions = {
+        tx: options.tx,
+        table: options.definition.$name,
+        where: options.where,
+        data: options.data,
+    };
+    if (options.userId !== undefined) {
+        return revise({ ...reviseOptions, userId: options.userId });
+    }
+    return revise(reviseOptions);
+}
+//# sourceMappingURL=definition-queries.js.map

package/dist/data/temporal/definition-queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-queries.js","sourceRoot":"","sources":["../../../src/data/temporal/definition-queries.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,GAAG,EAAE,MAAM,yCAAyC,CAAA;AAU7D,SAAS,qBAAqB,CAA8B,UAAiC,EAAE,MAAc;IAC3G,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,sBAAsB,CAC9B,YAAY,MAAM,gDAAgD;YAClE,MAAM,UAAU,CAAC,KAAK,kDAAkD;YACxE,+CAA+C;YAC/C,oBAAoB,UAAU,CAAC,KAAK,gCAAgC,CACrE,CAAA;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,EAAM,EACN,UAAiC,EACjC,IAAU,EACV,KAAW;IAEX,qBAAqB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,CAAA;IAChC,6HAA6H;IAC7H,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAY,EAAE,IAAI,CAAC,CAAA;IAC3C,MAAM,SAAS,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;IACvE,uHAAuH;IACvH,OAAO,MAAO,EAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;AAChE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,EAAM,EACN,UAAiC,EACjC,KAAW;IAEX,qBAAqB,CAAC,UAAU,EAAE,aAAa,CAAC,CAAA;IAChD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,CAAA;IAChC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,uHAAuH;QACvH,OAAO,MAAO,EAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAC5D,CAAC;IACD,uHAAuH;IACvH,OAAO,MAAO,EAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAA8B,OAAyC;IAC1G,qBAAqB,CAAC,OAAO,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAA;IAC5D,MAAM,aAAa,GAAkB;QACnC,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,KAAK;QAC/B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,CAAA;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,EAAE,GAAG,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC7D,CAAC;IACD,OAAO,MAAM,CAAC,aAAa,CAAC,CAAA;AAC9B,CAAC"}

package/dist/data/temporal/errors.d.ts

@@ -0,0 +1,7 @@
+import { PipeworkError } from '../../core/errors/base.js';
+export declare class TemporalIntegrityError extends PipeworkError {
+    readonly code: "TEMPORAL_INTEGRITY";
+    readonly httpStatus: 409;
+    constructor(message: string, details?: Record<string, unknown>);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/data/temporal/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/data/temporal/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAEzD,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,QAAQ,CAAC,IAAI,EAAG,oBAAoB,CAAS;IAC7C,QAAQ,CAAC,UAAU,EAAG,GAAG,CAAS;gBAEtB,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAGnE"}

package/dist/data/temporal/errors.js

@@ -0,0 +1,9 @@
+import { PipeworkError } from '../../core/errors/base.js';
+export class TemporalIntegrityError extends PipeworkError {
+    code = 'TEMPORAL_INTEGRITY';
+    httpStatus = 409;
+    constructor(message, details = {}) {
+        super(message, details);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/data/temporal/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/data/temporal/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAEzD,MAAM,OAAO,sBAAuB,SAAQ,aAAa;IAC9C,IAAI,GAAG,oBAA6B,CAAA;IACpC,UAAU,GAAG,GAAY,CAAA;IAElC,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACzB,CAAC;CACF"}

package/dist/data/temporal/get-current.d.ts

@@ -0,0 +1,3 @@
+import type { TemporalOptions, GetCurrentResult } from './types.js';
+export declare function getCurrent(options: TemporalOptions): Promise<GetCurrentResult | null>;
+//# sourceMappingURL=get-current.d.ts.map

package/dist/data/temporal/get-current.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-current.d.ts","sourceRoot":"","sources":["../../../src/data/temporal/get-current.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAGnE,wBAAsB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAsB3F"}

package/dist/data/temporal/get-current.js

@@ -0,0 +1,18 @@
+import { sql } from '../db/sql.js';
+import { getTableName } from '../db/generated/drizzle-orm/introspection.js';
+import { TemporalIntegrityError } from './errors.js';
+export async function getCurrent(options) {
+    const { tx, where } = options;
+    const table = typeof options.table === 'string' ? options.table : getTableName(options.table);
+    const rows = await tx.execute(sql `SELECT id::text, version FROM ${sql.identifier(table)} WHERE ${where} AND effective_to IS NULL`);
+    if (rows.length === 0) {
+        return null;
+    }
+    if (rows.length > 1) {
+        throw new TemporalIntegrityError(`Multiple open versions detected in "${table}" — data integrity violation. ` +
+            `Expected at most one row with effective_to IS NULL, found ${rows.length}.`, { table, count: rows.length });
+    }
+    const row = rows[0];
+    return { id: row['id'], version: row['version'] };
+}
+//# sourceMappingURL=get-current.js.map

package/dist/data/temporal/get-current.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-current.js","sourceRoot":"","sources":["../../../src/data/temporal/get-current.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAA;AAE3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAEpD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAwB;IACvD,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,CAAA;IAC7B,MAAM,KAAK,GAAG,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAE7F,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAC3B,GAAG,CAAA,iCAAiC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,KAAK,2BAA2B,CACpG,CAAA;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,sBAAsB,CAC9B,uCAAuC,KAAK,gCAAgC;YAC5E,6DAA6D,IAAI,CAAC,MAAM,GAAG,EAC3E,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAC9B,CAAA;IACH,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAA;IACpB,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,IAAI,CAAW,EAAE,OAAO,EAAE,GAAG,CAAC,SAAS,CAAW,EAAE,CAAA;AACvE,CAAC"}

package/dist/data/temporal/index.d.ts

@@ -0,0 +1,9 @@
+export { temporalColumns } from './columns.js';
+export { atTime, current, between } from './query.js';
+export { revise } from './revise.js';
+export { close } from './close.js';
+export { getCurrent } from './get-current.js';
+export { TemporalIntegrityError } from './errors.js';
+export { asOf, allVersions, effectiveUpdate, type DefinitionReviseOptions } from './definition-queries.js';
+export type { TemporalOptions, ReviseOptions, ReviseResult, GetCurrentResult } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/data/temporal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/data/temporal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,KAAK,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AAC1G,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA"}

package/dist/data/temporal/index.js

@@ -0,0 +1,8 @@
+export { temporalColumns } from './columns.js';
+export { atTime, current, between } from './query.js';
+export { revise } from './revise.js';
+export { close } from './close.js';
+export { getCurrent } from './get-current.js';
+export { TemporalIntegrityError } from './errors.js';
+export { asOf, allVersions, effectiveUpdate } from './definition-queries.js';
+//# sourceMappingURL=index.js.map

package/dist/data/temporal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/data/temporal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAgC,MAAM,yBAAyB,CAAA"}

package/dist/data/temporal/namespace.d.ts

@@ -0,0 +1,31 @@
+import { temporalColumns } from './columns.js';
+import { revise } from './revise.js';
+import { close } from './close.js';
+import { getCurrent } from './get-current.js';
+import { atTime, between } from './query.js';
+import { TemporalIntegrityError } from './errors.js';
+import { asOf, allVersions, effectiveUpdate } from './definition-queries.js';
+/** Temporal (bitemporal) data namespace — version history with effective date ranges. */
+export declare const temporal: {
+    /** Returns the standard temporal column definitions (effectiveFrom, effectiveTo, version, createdBy) for table schemas. */
+    columns: typeof temporalColumns;
+    /** Creates a new version of a temporal record, closing the previous version's effectiveTo. */
+    revise: typeof revise;
+    /** Closes a temporal record by setting effectiveTo to now. Returns number of rows affected. */
+    close: typeof close;
+    /** Fetches the currently-effective version of a temporal record (effectiveTo IS NULL). */
+    current: typeof getCurrent;
+    /** Returns a SQL condition for records effective at a specific point in time. */
+    atTime: typeof atTime;
+    /** Returns a SQL condition for records overlapping a date range. */
+    between: typeof between;
+    /** Thrown when a temporal operation would violate version continuity. */
+    TemporalIntegrityError: typeof TemporalIntegrityError;
+    /** Query records effective at a specific date, using a domain definition with .effectiveDated() trait. */
+    asOf: typeof asOf;
+    /** Query all versions of temporal records (no date filter). */
+    allVersions: typeof allVersions;
+    /** Close the current version and create a new one with updated data. */
+    effectiveUpdate: typeof effectiveUpdate;
+};
+//# sourceMappingURL=namespace.d.ts.map

package/dist/data/temporal/namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../../src/data/temporal/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAE5E,yFAAyF;AACzF,eAAO,MAAM,QAAQ;IACnB,2HAA2H;;IAE3H,8FAA8F;;IAE9F,+FAA+F;;IAE/F,0FAA0F;;IAE1F,iFAAiF;;IAEjF,oEAAoE;;IAEpE,yEAAyE;;IAEzE,0GAA0G;;IAE1G,+DAA+D;;IAE/D,wEAAwE;;CAEzE,CAAA"}

package/dist/data/temporal/namespace.js

@@ -0,0 +1,31 @@
+import { temporalColumns } from './columns.js';
+import { revise } from './revise.js';
+import { close } from './close.js';
+import { getCurrent } from './get-current.js';
+import { atTime, between } from './query.js';
+import { TemporalIntegrityError } from './errors.js';
+import { asOf, allVersions, effectiveUpdate } from './definition-queries.js';
+/** Temporal (bitemporal) data namespace — version history with effective date ranges. */
+export const temporal = {
+    /** Returns the standard temporal column definitions (effectiveFrom, effectiveTo, version, createdBy) for table schemas. */
+    columns: temporalColumns,
+    /** Creates a new version of a temporal record, closing the previous version's effectiveTo. */
+    revise,
+    /** Closes a temporal record by setting effectiveTo to now. Returns number of rows affected. */
+    close,
+    /** Fetches the currently-effective version of a temporal record (effectiveTo IS NULL). */
+    current: getCurrent,
+    /** Returns a SQL condition for records effective at a specific point in time. */
+    atTime,
+    /** Returns a SQL condition for records overlapping a date range. */
+    between,
+    /** Thrown when a temporal operation would violate version continuity. */
+    TemporalIntegrityError,
+    /** Query records effective at a specific date, using a domain definition with .effectiveDated() trait. */
+    asOf,
+    /** Query all versions of temporal records (no date filter). */
+    allVersions,
+    /** Close the current version and create a new one with updated data. */
+    effectiveUpdate,
+};
+//# sourceMappingURL=namespace.js.map

package/dist/data/temporal/namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../../src/data/temporal/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAE5E,yFAAyF;AACzF,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,2HAA2H;IAC3H,OAAO,EAAE,eAAe;IACxB,8FAA8F;IAC9F,MAAM;IACN,+FAA+F;IAC/F,KAAK;IACL,0FAA0F;IAC1F,OAAO,EAAE,UAAU;IACnB,iFAAiF;IACjF,MAAM;IACN,oEAAoE;IACpE,OAAO;IACP,yEAAyE;IACzE,sBAAsB;IACtB,0GAA0G;IAC1G,IAAI;IACJ,+DAA+D;IAC/D,WAAW;IACX,wEAAwE;IACxE,eAAe;CAChB,CAAA"}

package/dist/data/temporal/query.d.ts

@@ -0,0 +1,10 @@
+import type { SQL, Column } from '../db/types.js';
+interface HasTemporalColumns {
+    effectiveFrom: Column;
+    effectiveTo: Column;
+}
+export declare function atTime<T extends HasTemporalColumns>(table: T, asOf: Date): SQL;
+export declare function current<T extends HasTemporalColumns>(table: T): SQL;
+export declare function between<T extends HasTemporalColumns>(table: T, from: Date, to: Date): SQL;
+export {};
+//# sourceMappingURL=query.d.ts.map

package/dist/data/temporal/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/data/temporal/query.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAEjD,UAAU,kBAAkB;IAC1B,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,wBAAgB,MAAM,CAAC,CAAC,SAAS,kBAAkB,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,GAAG,CAK9E;AAED,wBAAgB,OAAO,CAAC,CAAC,SAAS,kBAAkB,EAAE,KAAK,EAAE,CAAC,GAAG,GAAG,CAEnE;AAED,wBAAgB,OAAO,CAAC,CAAC,SAAS,kBAAkB,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,GAAG,GAAG,CAKzF"}

package/dist/data/temporal/query.js

@@ -0,0 +1,11 @@
+import { and, lte, gt, isNull, or } from '../db/generated/drizzle-orm/operator.js';
+export function atTime(table, asOf) {
+    return and(lte(table.effectiveFrom, asOf), or(isNull(table.effectiveTo), gt(table.effectiveTo, asOf)));
+}
+export function current(table) {
+    return isNull(table.effectiveTo);
+}
+export function between(table, from, to) {
+    return and(lte(table.effectiveFrom, to), or(isNull(table.effectiveTo), gt(table.effectiveTo, from)));
+}
+//# sourceMappingURL=query.js.map

package/dist/data/temporal/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/data/temporal/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,yCAAyC,CAAA;AAQlF,MAAM,UAAU,MAAM,CAA+B,KAAQ,EAAE,IAAU;IACvE,OAAO,GAAG,CACR,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,IAAI,CAAC,EAC9B,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAC1D,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,OAAO,CAA+B,KAAQ;IAC5D,OAAO,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;AAClC,CAAC;AAED,MAAM,UAAU,OAAO,CAA+B,KAAQ,EAAE,IAAU,EAAE,EAAQ;IAClF,OAAO,GAAG,CACR,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,CAAC,EAC5B,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAC1D,CAAA;AACJ,CAAC"}

package/dist/data/temporal/revise.d.ts

@@ -0,0 +1,3 @@
+import type { ReviseOptions, ReviseResult } from './types.js';
+export declare function revise(options: ReviseOptions): Promise<ReviseResult>;
+//# sourceMappingURL=revise.d.ts.map

package/dist/data/temporal/revise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revise.d.ts","sourceRoot":"","sources":["../../../src/data/temporal/revise.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAI7D,wBAAsB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAoE1E"}

package/dist/data/temporal/revise.js

@@ -0,0 +1,52 @@
+import { sql } from '../db/sql.js';
+import { getTableName } from '../db/generated/drizzle-orm/introspection.js';
+import { TemporalIntegrityError } from './errors.js';
+import { assertValidIdentifier, quoteIdentifier } from '../db/identifiers.js';
+export async function revise(options) {
+    const { tx, where, data, userId } = options;
+    const table = typeof options.table === 'string' ? options.table : getTableName(options.table);
+    const current = await tx.execute(sql `SELECT id, version FROM ${sql.identifier(table)} WHERE ${where} AND effective_to IS NULL FOR UPDATE`);
+    if (current.length === 0) {
+        throw new TemporalIntegrityError(`No current version found. Cannot revise a record in "${table}" — ` +
+            `ensure the entity exists and has an open version (effective_to IS NULL).`, { table });
+    }
+    if (current.length > 1) {
+        throw new TemporalIntegrityError(`Multiple open versions detected in "${table}" — data integrity violation. ` +
+            `Expected exactly one row with effective_to IS NULL, found ${current.length}.`, { table, count: current.length });
+    }
+    const currentRow = current[0];
+    const currentId = currentRow['id'];
+    const currentVersion = currentRow['version'];
+    await tx.execute(sql `UPDATE ${sql.identifier(table)} SET effective_to = now() WHERE id = ${currentId}::uuid`);
+    const columns = Object.keys(data);
+    const values = Object.values(data);
+    for (const col of columns) {
+        assertValidIdentifier(col, 'column');
+    }
+    const allColumns = [...columns, 'effective_from', 'effective_to', 'version', 'created_by'];
+    const colListRaw = allColumns.map((c) => quoteIdentifier(c, 'column')).join(', ');
+    const serializedValues = values.map((v) => {
+        if (v === null || v === undefined)
+            return null;
+        if (typeof v === 'object')
+            return JSON.stringify(v);
+        return v;
+    });
+    const valueParts = [
+        ...serializedValues.map((v) => sql `${v ?? null}`),
+        sql `now()`,
+        sql `NULL`,
+        sql `${currentVersion + 1}`,
+        sql `${userId ?? null}`,
+    ];
+    const valuesList = valueParts.reduce((acc, part, i) => {
+        if (i === 0)
+            return part;
+        return sql `${acc}, ${part}`;
+    });
+    assertValidIdentifier(table, 'table');
+    const result = await tx.execute(sql `INSERT INTO ${sql.raw(quoteIdentifier(table, 'table'))} (${sql.raw(colListRaw)}) VALUES (${valuesList}) RETURNING id::text, version`);
+    const row = result[0];
+    return { id: row['id'], version: row['version'] };
+}
+//# sourceMappingURL=revise.js.map

package/dist/data/temporal/revise.js.map

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

package/dist/data/temporal/types.d.ts

@@ -0,0 +1,19 @@
+import type { DB, SQL, Table } from '../db/types.js';
+export interface TemporalOptions {
+    readonly tx: DB;
+    readonly table: string | Table;
+    readonly where: SQL;
+}
+export interface ReviseOptions extends TemporalOptions {
+    readonly data: Record<string, unknown>;
+    readonly userId?: string;
+}
+export interface ReviseResult {
+    readonly id: string;
+    readonly version: number;
+}
+export interface GetCurrentResult {
+    readonly id: string;
+    readonly version: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/data/temporal/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/data/temporal/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAEpD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAA;IACf,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAA;IAC9B,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAA;CACpB;AAED,MAAM,WAAW,aAAc,SAAQ,eAAe;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB"}

package/dist/data/temporal/types.js

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

package/dist/data/temporal/types.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/data/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,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACzJ,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA"}

package/dist/data/vector/index.js

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

package/dist/data/vector/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/data/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,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAEzJ,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA"}

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

@@ -0,0 +1,33 @@
+import { vector as vectorColumn, tsvector } from './types.js';
+import { cosineDistance, cosineSimilarity, l2Distance, innerProduct, toTsvector, toTsquery, plainToTsquery, matches, headline, tsRank } from './query.js';
+import { validateVectorExtension } from './validate.js';
+/** Vector and full-text search namespace — pgvector column types, similarity queries, and FTS operators. */
+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 using to_tsquery (supports operators like &, |, !). */
+    toTsquery: typeof toTsquery;
+    /** Converts natural language text to a tsquery using plainto_tsquery (no operator syntax required). */
+    plainToTsquery: typeof plainToTsquery;
+    /** The @@ match operator — tests whether a tsvector column matches a tsquery. */
+    matches: typeof matches;
+    /** Generates a ts_headline search snippet with highlighted matches. */
+    headline: typeof headline;
+    /** Computes ts_rank for full-text search result ordering. Accepts a pre-built tsquery SQL or a raw query string. */
+    rank: typeof tsRank;
+    /** Verifies the pgvector extension is installed and accessible. */
+    validate: typeof validateVectorExtension;
+};
+//# sourceMappingURL=namespace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../../src/data/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,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACzJ,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAEvD,4GAA4G;AAC5G,eAAO,MAAM,MAAM;IACjB,iDAAiD;;IAEjD,sDAAsD;;IAEtD,kFAAkF;;IAElF,sEAAsE;;IAEtE,mEAAmE;;IAEnE,yDAAyD;;IAEzD,0DAA0D;;IAE1D,sGAAsG;;IAEtG,uGAAuG;;IAEvG,iFAAiF;;IAEjF,uEAAuE;;IAEvE,oHAAoH;;IAEpH,mEAAmE;;CAEpE,CAAA"}

package/dist/data/vector/namespace.js

@@ -0,0 +1,33 @@
+import { vector as vectorColumn, tsvector } from './types.js';
+import { cosineDistance, cosineSimilarity, l2Distance, innerProduct, toTsvector, toTsquery, plainToTsquery, matches, headline, tsRank } from './query.js';
+import { validateVectorExtension } from './validate.js';
+/** Vector and full-text search namespace — pgvector column types, similarity queries, and FTS operators. */
+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 using to_tsquery (supports operators like &, |, !). */
+    toTsquery,
+    /** Converts natural language text to a tsquery using plainto_tsquery (no operator syntax required). */
+    plainToTsquery,
+    /** The @@ match operator — tests whether a tsvector column matches a tsquery. */
+    matches,
+    /** Generates a ts_headline search snippet with highlighted matches. */
+    headline,
+    /** Computes ts_rank for full-text search result ordering. Accepts a pre-built tsquery SQL or a raw query string. */
+    rank: tsRank,
+    /** Verifies the pgvector extension is installed and accessible. */
+    validate: validateVectorExtension,
+};
+//# sourceMappingURL=namespace.js.map

package/dist/data/vector/namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../../src/data/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,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACzJ,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAEvD,4GAA4G;AAC5G,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,sGAAsG;IACtG,SAAS;IACT,uGAAuG;IACvG,cAAc;IACd,iFAAiF;IACjF,OAAO;IACP,uEAAuE;IACvE,QAAQ;IACR,oHAAoH;IACpH,IAAI,EAAE,MAAM;IACZ,mEAAmE;IACnE,QAAQ,EAAE,uBAAuB;CAClC,CAAA"}

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

@@ -0,0 +1,22 @@
+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: Column | string | SQL, config?: string): SQL;
+export declare function toTsquery(query: string, config?: string): SQL;
+export declare function plainToTsquery(query: string, config?: string): SQL;
+export declare function matches(column: Column | SQL, query: SQL): SQL<boolean>;
+export interface HeadlineOptions {
+    maxWords?: number;
+    minWords?: number;
+    shortWord?: number;
+    highlightAll?: boolean;
+    maxFragments?: number;
+    fragmentDelimiter?: string;
+    startSel?: string;
+    stopSel?: string;
+}
+export declare function headline(column: Column | SQL, query: SQL, config?: string, options?: HeadlineOptions): SQL<string>;
+export declare function tsRank(column: Column | SQL, query: string | SQL, config?: string): SQL<number>;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/data/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,MAAM,GAAG,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,CAM5E;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,CAG7D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,CAGlE;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE,KAAK,EAAE,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,CAEtE;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,GAAG,CAAC,MAAM,CAAC,CAOlH;AAeD,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAM9F"}

package/dist/data/vector/query.js

@@ -0,0 +1,71 @@
+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 plainToTsquery(query, config) {
+    const tsConfig = config ?? 'english';
+    return sql `plainto_tsquery(${tsConfig}, ${query})`;
+}
+export function matches(column, query) {
+    return sql `${column} @@ ${query}`;
+}
+export function headline(column, query, config, options) {
+    const tsConfig = config ?? 'english';
+    if (options === undefined) {
+        return sql `ts_headline(${tsConfig}, ${column}, ${query})`;
+    }
+    const optStr = formatHeadlineOptions(options);
+    return sql `ts_headline(${tsConfig}, ${column}, ${query}, ${optStr})`;
+}
+function formatHeadlineOptions(options) {
+    const parts = [];
+    if (options.maxWords !== undefined)
+        parts.push(`MaxWords=${String(options.maxWords)}`);
+    if (options.minWords !== undefined)
+        parts.push(`MinWords=${String(options.minWords)}`);
+    if (options.shortWord !== undefined)
+        parts.push(`ShortWord=${String(options.shortWord)}`);
+    if (options.highlightAll !== undefined)
+        parts.push(`HighlightAll=${options.highlightAll ? 'TRUE' : 'FALSE'}`);
+    if (options.maxFragments !== undefined)
+        parts.push(`MaxFragments=${String(options.maxFragments)}`);
+    if (options.fragmentDelimiter !== undefined)
+        parts.push(`FragmentDelimiter=${options.fragmentDelimiter}`);
+    if (options.startSel !== undefined)
+        parts.push(`StartSel=${options.startSel}`);
+    if (options.stopSel !== undefined)
+        parts.push(`StopSel=${options.stopSel}`);
+    return parts.join(', ');
+}
+export function tsRank(column, query, config) {
+    const tsConfig = config ?? 'english';
+    if (typeof query === 'string') {
+        return sql `ts_rank(${column}, to_tsquery(${tsConfig}, ${query}))`;
+    }
+    return sql `ts_rank(${column}, ${query})`;
+}
+//# sourceMappingURL=query.js.map

package/dist/data/vector/query.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/data/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/data/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/data/vector/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/data/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"}