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

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.
  *

package/dist/websocket.d.ts

@@ -1,5 +1,5 @@
-import { RealtimeService } from "./services/realtimeService";
-import { PostgresBackendDriver } from "./PostgresBackendDriver";
+import { RealtimeService } from "./services/realtimeService.js";
+import { PostgresBackendDriver } from "./PostgresBackendDriver.js";
 import type { AuthAdapter } from "@rebasepro/types";
 import { Server } from "http";
 /** Minimal subset of RebaseAuthConfig used by the WebSocket layer. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rebasepro/server-postgres",
   "type": "module",
-  "version": "0.16.0",
+  "version": "0.16.1-canary.g701140a",
   "description": "PostgreSQL data source backend implementation for Rebase with Drizzle ORM",
   "funding": {
     "url": "https://github.com/sponsors/rebaseco"
@@ -47,11 +47,11 @@
     "execa": "^9.6.1",
     "pg": "^8.22.0",
     "ws": "^8.21.1",
-    "@rebasepro/common": "0.16.0",
-    "@rebasepro/server": "0.16.0",
-    "@rebasepro/types": "0.16.0",
-    "@rebasepro/codegen": "0.16.0",
-    "@rebasepro/utils": "0.16.0"
+    "@rebasepro/codegen": "0.16.1-canary.g701140a",
+    "@rebasepro/common": "0.16.1-canary.g701140a",
+    "@rebasepro/server": "0.16.1-canary.g701140a",
+    "@rebasepro/utils": "0.16.1-canary.g701140a",
+    "@rebasepro/types": "0.16.1-canary.g701140a"
   },
   "devDependencies": {
     "@hono/node-server": "^2.0.12",
@@ -77,7 +77,7 @@
   ],
   "scripts": {
     "watch": "vite build --watch",
-    "build": "vite build && tsc --emitDeclarationOnly -p tsconfig.prod.json && node ../../scripts/assert-build-output.mjs",
+    "build": "vite build && tsc --emitDeclarationOnly -p tsconfig.prod.json && node ../../scripts/add-dts-extensions.mjs dist && node ../../scripts/assert-build-output.mjs",
     "test:lint": "eslint \"src/**\" --quiet",
     "test": "jest",
     "test:e2e": "vitest run --config vitest.e2e.config.ts",

package/src/schema/ensure-collection-tables.ts

@@ -48,6 +48,7 @@ import {
     planJunctionTables,
     quoteSqlLiteral
 } from "./generate-postgres-ddl-logic";
+import { buildVectorIndexPlan, vectorIndexStatement, type SkippedVectorIndex } from "./vector-index";
 import {
     AUTH_USERS_COLUMNS,
     authUsersColumnDefinition,
@@ -138,6 +139,17 @@ export interface EnsurePlan {
      * current block cannot be known, which is what the caller reports.
      */
     searchAdopted: { table: string; column: string }[];
+    /**
+     * Vector columns this plan is deliberately leaving unindexed, because
+     * pgvector cannot build an ANN index that wide.
+     *
+     * Reported rather than thrown: the column is valid, storable and
+     * searchable, and refusing the boot over it would make a working
+     * configuration unbootable. Reported rather than dropped: an unindexed
+     * vector column and an indexed one differ only in latency, so nothing
+     * about the running system says which one you got.
+     */
+    vectorIndexSkipped: SkippedVectorIndex[];
 }
 
 /**
@@ -595,7 +607,26 @@ export function planCollectionSchemaEnsure(
         }
     }
 
-    return { actions, statements: actions.map(a => a.sql), legacyForeignKeys, searchDrift, searchAdopted };
+    //    ANN indexes for vector columns, on the same terms: the column has to
+    //    exist, the build is real work against real rows, and CONCURRENTLY is
+    //    what keeps that from locking writes for its duration.
+    //
+    //    A column too wide for pgvector to index is reported, not planned —
+    //    silence there would read as "indexed" to anyone watching the boot.
+    const vectorIndexSkipped: SkippedVectorIndex[] = [];
+    for (const collection of collections) {
+        const plan = buildVectorIndexPlan(collection, resolveColumnName);
+        for (const spec of plan.specs) {
+            actions.push({
+                kind: "create-index",
+                target: `${spec.schema}.${spec.table}`,
+                sql: vectorIndexStatement(spec).replace("CREATE INDEX IF NOT EXISTS", "CREATE INDEX CONCURRENTLY IF NOT EXISTS")
+            });
+        }
+        vectorIndexSkipped.push(...plan.skipped);
+    }
+
+    return { actions, statements: actions.map(a => a.sql), legacyForeignKeys, searchDrift, searchAdopted, vectorIndexSkipped };
 }
 
 /** Read what the database has, for the schemas the collections live in. */
@@ -707,20 +738,23 @@ function searchDriftMessage(drift: SearchColumnDrift[]): string {
  * The missing-pgvector explanation, appended to the error that reveals it.
  *
  * A `{ type: "vector" }` property compiles to `VECTOR(n)`, and nothing in the
- * OSS pipeline installs pgvector — not this ensure, not `db push`, not the
- * scaffold's `postgres:18-alpine`, which does not ship it. Installing an
- * extension on someone's database is a decision with a deployment behind it
+ * OSS pipeline installs pgvector — not this ensure, not `db push`. Installing
+ * an extension on someone's database is a decision with a deployment behind it
  * (image, superuser, cloud allow-list), so this path stays a refusal; what it
  * must not stay is a bare `type "vector" does not exist` on a crash-looping
  * pod, which names nothing the reader can act on.
+ *
+ * The scaffold now ships `pgvector/pgvector:pg18`, so this is reached by a
+ * project pointed at a database someone else provisioned — which is exactly
+ * the case where naming the extension and the image is worth the words.
  */
 function vectorExtensionHint(message: string): string {
     if (!/type "(vector|halfvec|sparsevec)" does not exist/i.test(message)) return "";
     return (
         "\n  pgvector is not installed on this database, and Rebase does not install it: it is a server extension, " +
-        "so it needs an image that ships it (e.g. `pgvector/pgvector:pg18` — the scaffold's `postgres:18-alpine` " +
+        "so it needs an image that ships it (the scaffold's `pgvector/pgvector:pg18` does; a stock `postgres:18` " +
         "does not) and a role allowed to run `CREATE EXTENSION vector;`. Install it once, then boot again. " +
-        "Note also that Rebase creates no ANN index for a vector column, so `vectorSearch` is an exact scan."
+        "Rebase then creates an ANN index for the column automatically — see the `index` option on the property."
     );
 }
 
@@ -793,6 +827,15 @@ export async function ensureCollectionTables(
         log?.(message);
     }
 
+    // Said once per column, every boot: an unindexed vector column and an
+    // indexed one behave identically apart from latency, so the only way anyone
+    // learns which one they have is if the boot says so.
+    for (const skip of plan.vectorIndexSkipped) {
+        const message = `No ANN index on "${skip.table}"."${skip.column}": ${skip.reason}`;
+        logger.warn(`[schema] ${message}`);
+        log?.(message);
+    }
+
     if (plan.actions.length === 0) {
         log?.("Schema is up to date; nothing to create.");
         return { ...plan, failures };

package/src/schema/generate-postgres-ddl-logic.ts

@@ -15,6 +15,11 @@ import {
     searchIndexNames,
     type SearchColumnSpec
 } from "./search-column";
+import {
+    buildVectorIndexPlan,
+    vectorIndexStatements,
+    type VectorIndexPlan
+} from "./vector-index";
 import { REBASE_SCHEMA } from "@rebasepro/types";
 
 // --- Helper Functions ---
@@ -719,6 +724,16 @@ export const generatePostgresDdl = async (
                 indexStatements.push(...searchIndexStatements(searchSpec));
             }
 
+            // ANN indexes for vector columns. Emitted with the other indexes
+            // rather than inline, because `CREATE INDEX` is a statement and a
+            // column definition is not — and because a column too wide for
+            // pgvector to index still needs its column.
+            const vectorPlan: VectorIndexPlan = buildVectorIndexPlan(collection, resolveColumnName);
+            indexStatements.push(...vectorIndexStatements(vectorPlan));
+            for (const skip of vectorPlan.skipped) {
+                indexStatements.push(`-- No ANN index on "${skip.schema}"."${skip.table}"."${skip.column}": ${skip.reason}`);
+            }
+
             // Backwards compatibility: add default id primary key if missing
             const hasPk = columns.some(c => c.includes("PRIMARY KEY"));
             if (!hasPk) {