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

package/dist/schema/introspect-db-project.d.ts

@@ -1,4 +1,4 @@
-import { type CollectionBuilder } from "./introspect-db-logic";
+import { type CollectionBuilder } from "./introspect-db-logic.js";
 /**
  * Which `defineCollection` to generate against, for collections written to `outDir`.
  *

package/dist/schema/introspect-db-queries.d.ts

@@ -9,7 +9,7 @@
  * No side effects beyond `SELECT`. Introspection reads a database it does not
  * own — it must never `ANALYZE`, create a temp table, or otherwise write.
  */
-import type { SchemaMetadata } from "./introspect-db-logic";
+import type { SchemaMetadata } from "./introspect-db-logic.js";
 /** The subset of `pg.Client` this module needs, so tests can pass a fake. */
 export interface QueryableClient {
     query<R = Record<string, unknown>>(text: string, values?: unknown[]): Promise<{

package/dist/schema/introspect-db-structure.d.ts

@@ -33,8 +33,8 @@
  * which the caller fills from {@link ./introspect-db-queries.countRowsUpTo} for
  * the tables {@link lookupCandidates} names.
  */
-import type { ForeignKeyRow, SchemaMetadata, TableColumn, TableMeta } from "./introspect-db-logic";
-import type { CheckFactsByTable } from "./introspect-db-constraints";
+import type { ForeignKeyRow, SchemaMetadata, TableColumn, TableMeta } from "./introspect-db-logic.js";
+import type { CheckFactsByTable } from "./introspect-db-constraints.js";
 /**
  * The row count above which a referenced table is a real entity rather than a
  * code list. Deliberately low: `pagila.category` has 16 rows and `language` 6,

package/dist/schema/introspect-runtime.d.ts

@@ -12,7 +12,7 @@
  * the same way whether it was generated or introspected.
  */
 import type { PostgresCollectionConfig } from "@rebasepro/types";
-import { TableMeta } from "./introspect-db-logic";
+import { TableMeta } from "./introspect-db-logic.js";
 export interface IntrospectedSchema {
     tablesMap: Map<string, TableMeta>;
     enumMap: Map<string, string[]>;

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/{src-BBFsDaeA.js → src-DolrXONo.js}

@@ -410,6 +410,98 @@ function usesLegacyRlsFunctions(sql) {
 	return /\bauth\.(uid|jwt|roles)\s*\(\s*\)/i.test(sql);
 }
 //#endregion
+//#region ../types/src/types/resources.ts
+var GLOBAL_KEY = Symbol.for("@rebasepro/types.resourceRegistry");
+function registry() {
+	const g = globalThis;
+	let existing = g[GLOBAL_KEY];
+	if (!existing) {
+		existing = {
+			kinds: /* @__PURE__ */ new Map(),
+			declarations: /* @__PURE__ */ new Map()
+		};
+		g[GLOBAL_KEY] = existing;
+	}
+	return existing;
+}
+/** Register a resource kind. Idempotent for an identical spec; throws on a conflicting one. */
+function registerResourceKind(spec) {
+	const existing = registry().kinds.get(spec.kind);
+	if (existing && JSON.stringify(existing) !== JSON.stringify(spec)) throw new Error(`Resource kind "${spec.kind}" is already registered with a different definition. Two packages cannot define the same kind.`);
+	registry().kinds.set(spec.kind, spec);
+}
+//#endregion
+//#region ../types/src/types/resource_kinds.ts
+/**
+* The kinds Rebase ships, and the constructors a project declares them with.
+*
+* Each kind is registered rather than hardcoded, so a fourth one arrives
+* without editing a manifest schema, a validator and a switch statement. That
+* cost is precisely why databases and buckets ended up declared in different
+* files with different rules — the cheapest thing to do was always to bolt the
+* new kind onto whichever home was nearest.
+*
+* A kind owns its engine list. `custom:<id>` is always accepted, so a build
+* that ships an engine this package has never heard of says so at the call site
+* instead of looking like a typo of one that exists.
+*/
+registerResourceKind({
+	kind: "database",
+	engines: [
+		"postgres",
+		"mongodb",
+		"firestore",
+		"sqlite"
+	],
+	defaultEngine: "postgres",
+	envBases: [
+		"DATABASE_URL",
+		"REBASE_DRIVER",
+		"REBASE_DB_POOL_MAX"
+	],
+	optionKeys: ["databaseId", "migrations"],
+	implicitDefault: true
+});
+registerResourceKind({
+	kind: "bucket",
+	engines: [
+		"local",
+		"s3",
+		"gcs",
+		"azure",
+		"firebase"
+	],
+	defaultEngine: "local",
+	envBases: [
+		"S3_BUCKET",
+		"GCS_BUCKET",
+		"STORAGE_BUCKET",
+		"STORAGE_PUBLIC_URL"
+	],
+	envBasesByEngine: {
+		local: ["STORAGE_BUCKET"],
+		s3: [
+			"S3_BUCKET",
+			"STORAGE_ENDPOINT",
+			"STORAGE_REGION",
+			"STORAGE_PUBLIC_URL"
+		],
+		gcs: ["GCS_BUCKET", "STORAGE_PUBLIC_URL"],
+		azure: ["STORAGE_BUCKET", "STORAGE_PUBLIC_URL"],
+		firebase: ["STORAGE_BUCKET", "STORAGE_PUBLIC_URL"]
+	},
+	optionKeys: ["publicRead", "prefix"],
+	implicitDefault: false
+});
+registerResourceKind({
+	kind: "topic",
+	engines: ["jobs"],
+	defaultEngine: "jobs",
+	envBases: ["REBASE_TOPIC_URL"],
+	optionKeys: ["delivery", "maxAttempts"],
+	implicitDefault: false
+});
+//#endregion
 export { isRelationAggregateSort as _, rewriteLegacyRlsFunctions as a, toCanonicalOp as b, isPostgresCollectionConfig as c, getDataSourceCapabilities as d, ALL_WHERE_FILTER_OPS as f, encodeRelationAggregateSort as g, REST_TO_CANONICAL as h, RLS_UID_SQL as i, isRelationalCollectionConfig as l, NULL_OPS as m, REBASE_SCHEMA as n, usesLegacyRlsFunctions as o, CANONICAL_TO_REST as p, RLS_ROLES_SQL as r, getDeclaredSubcollections as s, LEGACY_RLS_SCHEMA as t, DEFAULT_DATA_SOURCE_KEY as u, parseRelationAggregateSort as v, sortKeyToString as y };
 
-//# sourceMappingURL=src-BBFsDaeA.js.map
+//# sourceMappingURL=src-DolrXONo.js.map