@rebasepro/server-postgres 0.16.0 → 0.16.1-canary.g2d1aec8

package/dist/schema/vector-index.d.ts

@@ -0,0 +1,88 @@
+/**
+ * The one place a `{ type: "vector" }` property becomes an ANN index.
+ *
+ * Without an index, pgvector answers `ORDER BY embedding <=> $1` by computing
+ * the distance to every row and sorting — exact, and linear. That is the right
+ * answer at ten thousand rows and the wrong one at a million, which is why the
+ * default here is to build an index rather than to leave the column bare.
+ *
+ * ## The operator class is not a detail
+ *
+ * An index is built for exactly one operator class, and the planner uses it
+ * only for the operator that class implements. `vector_cosine_ops` answers
+ * `<=>` and nothing else; a query asking for `<->` against a cosine index gets
+ * a sequential scan and no error. So the default indexed distance here is
+ * `cosine`, because `cosine` is what `vectorSearch` measures with when the
+ * caller does not say — see `DrizzleConditionBuilder.buildVectorSearch`. The
+ * two defaults have to agree, and this comment is the reason they do.
+ *
+ * ## Why 2000 dimensions is a ceiling and not an error
+ *
+ * pgvector cannot index a `vector` wider than 2000 dimensions with either
+ * method. A 3072-dimension embedding (`text-embedding-3-large`) is therefore
+ * storable and searchable but not indexable. Refusing the boot over that would
+ * make a working configuration unbootable; silently indexing it is impossible.
+ * So the column is created, the index is skipped, and the reason is reported.
+ *
+ * Like `search-column.ts`, this module exists so that the DDL generator and the
+ * boot-time ensure render the *same* specification rather than describing the
+ * same index twice, differently. `contracts/derived-names.txt` records the
+ * names both produce, and CI fails if they diverge.
+ */
+import type { CollectionConfig, Property, VectorDistance } from "@rebasepro/types";
+/**
+ * The widest `vector` pgvector will build an HNSW or IVFFlat index over.
+ * Storage and exact search are unaffected by this limit.
+ */
+export declare const MAX_INDEXABLE_VECTOR_DIMENSIONS = 2000;
+/** The distance indexed when a property does not name one. */
+export declare const DEFAULT_VECTOR_DISTANCE: VectorDistance;
+/** The index method used when a property does not name one. */
+export declare const DEFAULT_VECTOR_INDEX_METHOD: "hnsw";
+export interface VectorIndexSpec {
+    schema: string;
+    table: string;
+    column: string;
+    indexName: string;
+    method: "hnsw" | "ivfflat";
+    distance: VectorDistance;
+    operatorClass: string;
+    /** Rendered into `WITH (...)`; empty when every parameter is defaulted. */
+    parameters: Array<[string, number]>;
+}
+/** A vector column that will not be indexed, and why. */
+export interface SkippedVectorIndex {
+    schema: string;
+    table: string;
+    column: string;
+    dimensions: number;
+    reason: string;
+}
+export interface VectorIndexPlan {
+    specs: VectorIndexSpec[];
+    skipped: SkippedVectorIndex[];
+}
+export declare class VectorIndexConfigError extends Error {
+    constructor(message: string);
+}
+/**
+ * Every ANN index a collection's vector properties call for.
+ *
+ * `resolveColumn` is passed in rather than imported so that this module stays
+ * free of the DDL generator, which imports *it*. Both callers hand it the same
+ * `resolveColumnName`, and a contract test asserts the names agree.
+ */
+export declare const buildVectorIndexPlan: (collection: CollectionConfig, resolveColumn: (propName: string, prop?: Property | null) => string) => VectorIndexPlan;
+/**
+ * The `CREATE INDEX` for one spec.
+ *
+ * `CONCURRENTLY` is deliberately absent, for the same reason it is absent from
+ * `searchIndexStatements`: this form is replayed as part of a migration, where
+ * a concurrent build is not allowed. The boot-time ensure rewrites it — see
+ * `ensureCollectionTables`.
+ */
+export declare const vectorIndexStatement: (spec: VectorIndexSpec) => string;
+/** Every statement for a plan, in a stable order. */
+export declare const vectorIndexStatements: (plan: VectorIndexPlan) => string[];
+/** The index names a plan creates — what the derived-names contract records. */
+export declare const vectorIndexNames: (plan: VectorIndexPlan) => string[];

package/dist/services/BranchService.d.ts

@@ -7,8 +7,8 @@
  * same `rebase` schema convention used by entity_history, auth, etc.
  */
 import { BranchInfo } from "@rebasepro/types";
-import { DrizzleClient } from "../interfaces";
-import { DatabasePoolManager } from "../databasePoolManager";
+import { DrizzleClient } from "../interfaces.js";
+import { DatabasePoolManager } from "../databasePoolManager.js";
 export declare class BranchService {
     private db;
     private poolManager;

package/dist/services/FetchService.d.ts

@@ -2,10 +2,10 @@ import { SQL } from "drizzle-orm";
 import { PgTable } from "drizzle-orm/pg-core";
 import { FilterValues, OrderByTuple, LogicalCondition } from "@rebasepro/types";
 import type { VectorSearchParams } from "@rebasepro/types";
-import { RelationService } from "./RelationService";
-import { DrizzleClient } from "../interfaces";
-import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry";
-import { type NestedPathHop } from "./nested-path";
+import { RelationService } from "./RelationService.js";
+import { DrizzleClient } from "../interfaces.js";
+import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry.js";
+import { type NestedPathHop } from "./nested-path.js";
 /**
  * Service for handling all row read operations.
  * Handles fetching, searching, counting, and filtering rows.

package/dist/services/PersistService.d.ts

@@ -1,8 +1,8 @@
-import { RelationService } from "./RelationService";
-import { RelationWriteService } from "./RelationWriteService";
-import { FetchService } from "./FetchService";
-import { DrizzleClient } from "../interfaces";
-import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry";
+import { RelationService } from "./RelationService.js";
+import { RelationWriteService } from "./RelationWriteService.js";
+import { FetchService } from "./FetchService.js";
+import { DrizzleClient } from "../interfaces.js";
+import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry.js";
 /**
  * Service for handling all row write operations.
  * Handles saving, deleting, and updating rows.

package/dist/services/RelationService.d.ts

@@ -1,7 +1,7 @@
-import { DrizzleClient } from "../interfaces";
+import { DrizzleClient } from "../interfaces.js";
 import { CollectionConfig, FilterValues, OrderByTuple, ResolvedRelation, ResolvedHasMany, ResolvedHasOne } from "@rebasepro/types";
-import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry";
-import type { NestedPathHop } from "./nested-path";
+import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry.js";
+import type { NestedPathHop } from "./nested-path.js";
 /**
  * Service for handling all relation-related operations.
  * Handles fetching, updating, and managing row relations.

package/dist/services/RelationWriteService.d.ts

@@ -1,7 +1,7 @@
 import { CollectionConfig, ResolvedManyToMany, ResolvedRelation, ResolvedVia } from "@rebasepro/types";
-import { DrizzleClient } from "../interfaces";
-import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry";
-import type { NestedPathHop } from "./nested-path";
+import { DrizzleClient } from "../interfaces.js";
+import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry.js";
+import type { NestedPathHop } from "./nested-path.js";
 /**
  * Writing relations: junction membership, foreign-key stamping, and the links a
  * nested path creates or removes.

package/dist/services/cdc/junction-tables.d.ts

@@ -1,5 +1,5 @@
 import { CollectionConfig } from "@rebasepro/types";
-import { PostgresCollectionRegistry } from "../../collections/PostgresCollectionRegistry";
+import { PostgresCollectionRegistry } from "../../collections/PostgresCollectionRegistry.js";
 /**
  * One end of a many-to-many, as seen from the junction table.
  *

package/dist/services/cdc/trigger-cdc.d.ts

@@ -1,4 +1,4 @@
-import type { RawSqlRunner } from "../../security/rls-enforcement";
+import type { RawSqlRunner } from "../../security/rls-enforcement.js";
 /**
  * Trigger-based Change Data Capture (CDC).
  *

package/dist/services/channel-bus/PostgresChannelBus.d.ts

@@ -26,7 +26,7 @@
  *    than correctness. That is what makes coalescing safe.
  */
 import { NodePgDatabase } from "drizzle-orm/node-postgres";
-import { ChannelBus, ChannelBusFrame, ChannelBusHandler } from "./ChannelBus";
+import { ChannelBus, ChannelBusFrame, ChannelBusHandler } from "./ChannelBus.js";
 /** NOTIFY channel carrying channel-bus frames. */
 export declare const CHANNEL_BUS_NOTIFY_CHANNEL = "rebase_channel_bus";
 /**

package/dist/services/channel-bus/index.d.ts

@@ -16,8 +16,8 @@
  */
 import { NodePgDatabase } from "drizzle-orm/node-postgres";
 import { type ChannelBus, type ChannelBusSetting } from "@rebasepro/types";
-export * from "./ChannelBus";
-export { PostgresChannelBus, CHANNEL_BUS_NOTIFY_CHANNEL, PG_NOTIFY_MAX_PAYLOAD_BYTES, DEFAULT_BATCH_WINDOW_MS, parseChannelBusFrame, parseChannelBusPayload } from "./PostgresChannelBus";
+export * from "./ChannelBus.js";
+export { PostgresChannelBus, CHANNEL_BUS_NOTIFY_CHANNEL, PG_NOTIFY_MAX_PAYLOAD_BYTES, DEFAULT_BATCH_WINDOW_MS, parseChannelBusFrame, parseChannelBusPayload } from "./PostgresChannelBus.js";
 export interface ChannelBusDeps {
     db: NodePgDatabase<Record<string, unknown>>;
     /**

package/dist/services/collection-helpers.d.ts

@@ -1,6 +1,6 @@
 import { PgTable, AnyPgColumn } from "drizzle-orm/pg-core";
 import { CollectionConfig, ResolvedHasMany, ResolvedHasOne } from "@rebasepro/types";
-import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry";
+import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry.js";
 import { ApiError } from "@rebasepro/server";
 export { buildCompositeId, parseIdValues, isAddressableId, COMPOSITE_ID_SEPARATOR } from "@rebasepro/common";
 export type { PrimaryKeyInfo } from "@rebasepro/common";

package/dist/services/dataService.d.ts

@@ -1,15 +1,15 @@
 import { FilterValues, LogicalCondition, OrderByTuple } from "@rebasepro/types";
 import type { VectorSearchParams } from "@rebasepro/types";
-import { FetchService } from "./FetchService";
-import { PersistService } from "./PersistService";
-import { RelationService } from "./RelationService";
-import { DataRepository, DrizzleClient } from "../interfaces";
-import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry";
-export { sanitizeAndConvertDates, serializeDataToServer, parseDataFromServer } from "../data-transformer";
-export { FetchService } from "./FetchService";
-export { PersistService } from "./PersistService";
-export { RelationService } from "./RelationService";
-export * from "../interfaces";
+import { FetchService } from "./FetchService.js";
+import { PersistService } from "./PersistService.js";
+import { RelationService } from "./RelationService.js";
+import { DataRepository, DrizzleClient } from "../interfaces.js";
+import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry.js";
+export { sanitizeAndConvertDates, serializeDataToServer, parseDataFromServer } from "../data-transformer.js";
+export { FetchService } from "./FetchService.js";
+export { PersistService } from "./PersistService.js";
+export { RelationService } from "./RelationService.js";
+export * from "../interfaces.js";
 /**
  * DataService - Facade for row operations.
  *

package/dist/services/index.d.ts

@@ -1,4 +1,4 @@
-export { FetchService } from "./FetchService";
-export { PersistService } from "./PersistService";
-export { RelationService } from "./RelationService";
-export { getCollectionByPath, getTableForCollection, getPrimaryKeys, deriveRowAddress, parseIdValues, buildCompositeId } from "./collection-helpers";
+export { FetchService } from "./FetchService.js";
+export { PersistService } from "./PersistService.js";
+export { RelationService } from "./RelationService.js";
+export { getCollectionByPath, getTableForCollection, getPrimaryKeys, deriveRowAddress, parseIdValues, buildCompositeId } from "./collection-helpers.js";

package/dist/services/junction-writes.d.ts

@@ -1,7 +1,7 @@
 import { AnyPgColumn, PgTable } from "drizzle-orm/pg-core";
 import type { ResolvedVia } from "@rebasepro/types";
-import { DrizzleClient } from "../interfaces";
-import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry";
+import { DrizzleClient } from "../interfaces.js";
+import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry.js";
 /**
  * Writing a many-to-many means writing rows in a junction table, and doing that
  * needs three things: the table, the column naming the row being written from,

package/dist/services/nested-path.d.ts

@@ -1,5 +1,5 @@
 import { CollectionConfig, ResolvedRelation } from "@rebasepro/types";
-import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry";
+import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry.js";
 /**
  * The last hop of a nested collection path, e.g. `authors/1/posts`.
  *

package/dist/services/realtimeService.d.ts

@@ -2,9 +2,9 @@ import { WebSocket } from "ws";
 import { EventEmitter } from "events";
 import { DataDriver, WebSocketMessage, LogicalCondition, OrderByTuple } from "@rebasepro/types";
 import { NodePgDatabase } from "drizzle-orm/node-postgres";
-import { RealtimeProvider, CollectionSubscriptionConfig, SingleSubscriptionConfig } from "../interfaces";
-import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry";
-import { ChannelBus } from "./channel-bus";
+import { RealtimeProvider, CollectionSubscriptionConfig, SingleSubscriptionConfig } from "../interfaces.js";
+import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry.js";
+import { ChannelBus } from "./channel-bus/index.js";
 import type { ChannelRetentionRule } from "@rebasepro/types";
 /**
  * Auth context stored per-subscription so real-time refetches respect RLS.

package/dist/services/row-pipeline.d.ts

@@ -1,5 +1,5 @@
 import { CollectionConfig, ResolvedRelation } from "@rebasepro/types";
-import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry";
+import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry.js";
 /**
  * Turning a drizzle result into a row we serve.
  *

package/dist/services/write-denial.d.ts

@@ -1,7 +1,7 @@
 import { SQL } from "drizzle-orm";
 import { PgTable } from "drizzle-orm/pg-core";
 import { ApiError } from "@rebasepro/server";
-import { DrizzleClient } from "../interfaces";
+import { DrizzleClient } from "../interfaces.js";
 /**
  * Explain a write that matched no rows.
  *

package/dist/utils/drizzle-conditions.d.ts

@@ -1,8 +1,8 @@
 import { SQL } from "drizzle-orm";
 import { AnyPgColumn, PgTable } from "drizzle-orm/pg-core";
 import { CollectionConfig, FilterValues, WhereFilterOp, LogicalCondition, FilterCondition, ResolvedRelation, ResolvedBelongsTo, ResolvedForeignKeyOnTarget, ResolvedManyToMany, type RelationAggregateSort } from "@rebasepro/types";
-import { type SearchColumnSpec } from "../schema/search-column";
-import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry";
+import { type SearchColumnSpec } from "../schema/search-column.js";
+import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry.js";
 /**
  * What to do with a filter field that resolves to no column at all.
  *