@spine-event-engine/storage-postgres 2.0.0-snapshot.26 → 2.0.0-snapshot.29

package/REFERENCE.md

@@ -35,8 +35,16 @@ and required audit indexes without DDL or custom creation SQL. A successful
 compatible preparation is reused by later handles and operations in this
 factory. Explicit preparation uses and releases a temporary pool when no runtime
 pool exists; otherwise it reuses the retained runtime pool. Failed requirements
-can be retried without discarding
-earlier compatible families.
+can be retried without discarding earlier compatible families.
+
+Each `RecordSpec.indexes` requirement likewise checks a complete non-unique,
+ascending B-tree index with default operator class and column collation, no
+partial predicate, expression, or included column. Create mode adds missing
+indexes under the family preparation lock; incompatible existing indexes reject
+without alteration. Fixed byte columns use `BYTEA` and exact-width stored and
+query validation. Non-null fixed-byte equality uses native `=` for indexable
+queries. A record handle with `prepareOnAccess: false` performs no index
+metadata probe or DDL on ordinary data operations.
 
 The default shared registry converts message-valued IDs and columns using
 generated descriptors registered on module import. A registry supplied with

package/dist/postgres/record-indexes.d.ts

@@ -0,0 +1,114 @@
+import type { PoolClient } from "pg";
+import type { StoragePreparationMode } from "@spine-event-engine/storage/provider";
+import type { PostgresIndexSpec } from "./storage-factory.js";
+/**
+ * Carries one ordered PostgreSQL catalog component and its index-wide flags.
+ */
+interface IndexRow {
+    /**
+     * Materialized column name, absent for an expression component.
+     */
+    readonly column_name: string | null;
+    /**
+     * One-based position in the native index.
+     */
+    readonly ordinal: number | string;
+    /**
+     * Whether the index enforces uniqueness.
+     */
+    readonly unique: boolean;
+    /**
+     * Whether the index is valid for queries.
+     */
+    readonly valid: boolean;
+    /**
+     * Whether writes maintain the index.
+     */
+    readonly ready: boolean;
+    /**
+     * Whether the index remains live.
+     */
+    readonly live: boolean;
+    /**
+     * Whether a predicate excludes some table rows.
+     */
+    readonly partial: boolean;
+    /**
+     * Whether a component is an expression.
+     */
+    readonly expression: boolean;
+    /**
+     * Number of searchable key components.
+     */
+    readonly key_count: number;
+    /**
+     * Total components, including non-key values.
+     */
+    readonly total_count: number;
+    /**
+     * Native access method name.
+     */
+    readonly method: string;
+    /**
+     * Native relation kind.
+     */
+    readonly kind: string;
+    /**
+     * Native sort-direction flags.
+     */
+    readonly direction: number;
+    /**
+     * Whether the component uses its default operator class.
+     */
+    readonly default_operator: boolean;
+    /**
+     * Whether the index uses the source column collation.
+     */
+    readonly column_collation: boolean;
+}
+/**
+ * Defines native catalog operations for complete lookup-index preparation.
+ */
+interface IndexOperations {
+    /**
+     * Creates or checks a complete native lookup index.
+     *
+     * @param client PostgreSQL transaction or read-only client.
+     * @param index Declared physical lookup index.
+     * @param mode Physical preparation mode.
+     * @param schema Physical PostgreSQL schema.
+     * @param table Physical record-family table.
+     * @returns Completion of index preparation.
+     */
+    ensure(client: PoolClient, schema: string, table: string, index: PostgresIndexSpec, mode: StoragePreparationMode): Promise<void>;
+    /**
+     * Reads the ordered native index catalog rows.
+     *
+     * @param client PostgreSQL transaction or read-only client.
+     * @param name Physical index name or identifier.
+     * @param schema Physical PostgreSQL schema.
+     * @param table Physical record-family table.
+     * @returns Ordered native index catalog rows.
+     */
+    read(client: PoolClient, schema: string, table: string, name: string): Promise<readonly IndexRow[]>;
+    /**
+     * Rejects an incompatible native index definition.
+     *
+     * @param index Declared physical lookup index.
+     * @param rows Ordered native index catalog rows.
+     */
+    assert(index: PostgresIndexSpec, rows: readonly IndexRow[]): void;
+    /**
+     * Returns one safely quoted physical SQL identifier.
+     *
+     * @param value Physical SQL identifier.
+     * @returns Quoted SQL identifier.
+     */
+    quote(value: string): string;
+}
+/**
+ * Creates or checks complete PostgreSQL B-tree lookup indexes.
+ */
+export declare const PostgresRecordIndexes: Readonly<IndexOperations>;
+export {};
+//# sourceMappingURL=record-indexes.d.ts.map

package/dist/postgres/record-indexes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-indexes.d.ts","sourceRoot":"","sources":["../../src/postgres/record-indexes.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AACrC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAEnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;GAEG;AACH,UAAU,QAAQ;IAGhB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC;AAED;;GAEG;AACH,UAAU,eAAe;IACvB;;;;;;;;;OASG;IACH,MAAM,CACJ,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;;OAQG;IACH,IAAI,CACF,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAC;IAEhC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,QAAQ,EAAE,GAAG,IAAI,CAAC;IAElE;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,eAAe,CAsG1D,CAAC"}

package/dist/postgres/record-indexes.js

@@ -0,0 +1,97 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+import { PostgresStorageSchemaError } from "./errors.js";
+/**
+ * Creates or checks complete PostgreSQL B-tree lookup indexes.
+ */
+export const PostgresRecordIndexes = Object.freeze({
+    /**
+     * Establishes one declared index without repairing an incompatible definition.
+     * @param client Transaction client or read-only checker.
+     * @param schema Physical schema.
+     * @param table Physical table.
+     * @param index Complete ordered requirement.
+     * @param mode Creation or check mode.
+     */
+    async ensure(client, schema, table, index, mode) {
+        let rows = await this.read(client, schema, table, index.name);
+        if (rows.length === 0) {
+            if (mode === "check")
+                throw new PostgresStorageSchemaError("PostgreSQL record index is missing.");
+            const qualified = `${this.quote(schema)}.${this.quote(table)}`;
+            const columns = index.columns.map((column) => this.quote(column)).join(", ");
+            await client.query(`CREATE INDEX ${this.quote(index.name)} ON ${qualified} USING btree (${columns})`);
+            rows = await this.read(client, schema, table, index.name);
+        }
+        this.assert(index, rows);
+    },
+    /**
+     * Reads ordered native index components and structural flags from the catalog.
+     * @param client PostgreSQL client.
+     * @param schema Physical schema.
+     * @param table Physical table.
+     * @param name Required physical index name.
+     * @returns Ordered catalog rows.
+     */
+    async read(client, schema, table, name) {
+        const result = await client.query("SELECT a.attname AS column_name, key.ordinality AS ordinal, x.indisunique AS unique, " +
+            "x.indisvalid AS valid, x.indisready AS ready, x.indislive AS live, " +
+            "x.indpred IS NOT NULL AS partial, x.indexprs IS NOT NULL AS expression, " +
+            "x.indnkeyatts AS key_count, x.indnatts AS total_count, am.amname AS method, " +
+            "i.relkind AS kind, x.indoption[(key.ordinality - 1)::int] AS direction, " +
+            "op.opcdefault AS default_operator, " +
+            "x.indcollation[(key.ordinality - 1)::int] = a.attcollation AS column_collation " +
+            "FROM pg_class t JOIN pg_namespace n ON n.oid=t.relnamespace " +
+            "JOIN pg_index x ON x.indrelid=t.oid JOIN pg_class i ON i.oid=x.indexrelid " +
+            "JOIN pg_am am ON am.oid=i.relam " +
+            "JOIN LATERAL unnest(x.indkey) WITH ORDINALITY AS key(attnum, ordinality) ON true " +
+            "LEFT JOIN pg_attribute a ON a.attrelid=t.oid AND a.attnum=key.attnum " +
+            "LEFT JOIN pg_opclass op ON op.oid=x.indclass[(key.ordinality - 1)::int] " +
+            "WHERE n.nspname=$1 AND t.relname=$2 AND i.relname=$3 ORDER BY key.ordinality", [schema, table, name]);
+        return result.rows;
+    },
+    /**
+     * Rejects substituted, unusable, or incomplete index definitions.
+     * @param index Required index.
+     * @param rows Native ordered components.
+     */
+    assert(index, rows) {
+        if (rows.length !== index.columns.length ||
+            rows.some((row, position) => row.column_name !== index.columns[position] ||
+                Number(row.ordinal) !== position + 1 ||
+                row.unique ||
+                !row.valid ||
+                !row.ready ||
+                !row.live ||
+                row.partial ||
+                row.expression ||
+                row.key_count !== index.columns.length ||
+                row.total_count !== index.columns.length ||
+                row.method !== "btree" ||
+                row.kind !== "i" ||
+                row.direction !== 0 ||
+                !row.default_operator ||
+                !row.column_collation))
+            throw new PostgresStorageSchemaError("PostgreSQL record index is incompatible.");
+    },
+    /**
+     * Quotes a physical identifier without truncation.
+     * @param value Physical identifier.
+     * @returns SQL-quoted identifier.
+     */
+    quote(value) {
+        return `"${value.replaceAll('"', '""')}"`;
+    },
+});
+//# sourceMappingURL=record-indexes.js.map

package/dist/postgres/record-indexes.js.map

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

package/dist/postgres/record-storage.d.ts

@@ -70,8 +70,8 @@ export interface PostgresRecordLifecycle {
  */
 export interface PostgresRecordExecutor<I, R extends Message> {
     /**
-     * Prepares the backing table before acquiring an operation client.
-     * @returns A promise that resolves when the table is compatible.
+     * Binds the destination and prepares the table when this handle enables preparation on access.
+     * @returns Completion after binding and any preparation required by this handle.
      */
     prepare(): Promise<void>;
     /**
@@ -157,6 +157,7 @@ export declare class PostgresRecordStorage<I, R extends Message> extends RecordS
     private readonly lifecycle;
     private readonly onClose;
     private readonly create?;
+    private readonly prepareOnAccess;
     /**
      * Reports that compare-and-set uses a conditional SQL mutation.
      */
@@ -172,10 +173,11 @@ export declare class PostgresRecordStorage<I, R extends Message> extends RecordS
      * @param onClose Removes this handle from the factory's live set.
      * @param create Optionally supplies custom create-table SQL.
      * @param stringifiers Converts message IDs and columns reversibly.
+     * @param prepareOnAccess Whether data access prepares the physical table.
      */
-    constructor(context: StorageContext, spec: RecordSpec<I, R>, tableNameValue: string, onSchema: (schema: string) => PostgresTableSpec<I, R>, lifecycle: PostgresRecordLifecycle, onClose: () => void, create?: ((table: PostgresTableSpec<I, R>) => string) | undefined, stringifiers?: StringifierRegistry);
+    constructor(context: StorageContext, spec: RecordSpec<I, R>, tableNameValue: string, onSchema: (schema: string) => PostgresTableSpec<I, R>, lifecycle: PostgresRecordLifecycle, onClose: () => void, create?: ((table: PostgresTableSpec<I, R>) => string) | undefined, stringifiers?: StringifierRegistry, prepareOnAccess?: boolean);
     /**
-     * Returns the bound layout after preparation.
+     * Returns the bound layout after destination resolution.
      *
      * @returns The resolved physical layout.
      */
@@ -187,21 +189,21 @@ export declare class PostgresRecordStorage<I, R extends Message> extends RecordS
      */
     get tableName(): string;
     /**
-     * Prepares this table before a record operation.
+     * Binds this table before a record operation and applies this handle's preparation policy.
      *
-     * @returns A promise that resolves after compatible initialization.
+     * @returns Completion after binding and any preparation required by this handle.
      */
     prepare(): Promise<void>;
     /**
-     * Prepares an already admitted operation, including after the factory fence.
+     * Binds an already admitted operation and applies this handle's preparation policy.
      *
-     * @returns Completion after table preparation.
+     * @returns Completion after binding and any required table preparation.
      */
     private prepareInternal;
     /**
-     * Binds the destination and prepares its physical table.
+     * Binds the destination and prepares its physical table when enabled for this handle.
      *
-     * @returns Completion after physical table preparation.
+     * @returns Completion after binding and any required table preparation.
      */
     private prepareBound;
     /**
@@ -385,7 +387,7 @@ export declare class PostgresRecordStorage<I, R extends Message> extends RecordS
      */
     private casUpdateSql;
     /**
-     * Executes work with one prepared and automatically released client.
+     * Executes work with one automatically released client after applying this handle's policy.
      *
      * @typeParam T The value returned by the client work.
      * @param work Performs the client work.
@@ -393,7 +395,7 @@ export declare class PostgresRecordStorage<I, R extends Message> extends RecordS
      */
     private using;
     /**
-     * Executes one prepared record operation on a released client.
+     * Executes one record operation on a released client after applying this handle's policy.
      *
      * @typeParam T The operation result.
      * @param work Performs the client operation.
@@ -409,7 +411,7 @@ export declare class PostgresRecordStorage<I, R extends Message> extends RecordS
      */
     private transaction;
     /**
-     * Executes one prepared Agent transaction on a released client.
+     * Executes one Agent transaction on a released client after applying this handle's policy.
      *
      * @typeParam T The transaction result.
      * @param work Performs work on the transaction client.
@@ -582,6 +584,13 @@ export declare class PostgresRecordStorage<I, R extends Message> extends RecordS
      * @returns The parameterized SQL predicate.
      */
     private predicate;
+    /**
+     * Returns indexable equality only for present fixed-byte column values.
+     * @param name Declared comparison column.
+     * @param value Compared logical value.
+     * @returns Equality SQL preserving null semantics otherwise.
+     */
+    private equalityOperator;
     /**
      * Validates and quotes one queryable column name.
      *

package/dist/postgres/record-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"record-storage.d.ts","sourceRoot":"","sources":["../../src/postgres/record-storage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"record-storage.d.ts","sourceRoot":"","sources":["../../src/postgres/record-storage.ts"],"names":[],"mappings":"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"}

package/dist/postgres/record-storage.js

@@ -31,6 +31,7 @@ export class PostgresRecordStorage extends RecordStorage {
     lifecycle;
     onClose;
     create;
+    prepareOnAccess;
     /**
      * Reports that compare-and-set uses a conditional SQL mutation.
      */
@@ -50,19 +51,21 @@ export class PostgresRecordStorage extends RecordStorage {
      * @param onClose Removes this handle from the factory's live set.
      * @param create Optionally supplies custom create-table SQL.
      * @param stringifiers Converts message IDs and columns reversibly.
+     * @param prepareOnAccess Whether data access prepares the physical table.
      */
-    constructor(context, spec, tableNameValue, onSchema, lifecycle, onClose, create, stringifiers = defaultStringifierRegistry) {
+    constructor(context, spec, tableNameValue, onSchema, lifecycle, onClose, create, stringifiers = defaultStringifierRegistry, prepareOnAccess = true) {
         super(context, spec);
         this.tableNameValue = tableNameValue;
         this.onSchema = onSchema;
         this.lifecycle = lifecycle;
         this.onClose = onClose;
         this.create = create;
+        this.prepareOnAccess = prepareOnAccess;
         this.#idColumn = new PostgresIdColumn(spec.idType, stringifiers);
         this.#columns = new PostgresColumnMapping(stringifiers);
     }
     /**
-     * Returns the bound layout after preparation.
+     * Returns the bound layout after destination resolution.
      *
      * @returns The resolved physical layout.
      */
@@ -80,25 +83,25 @@ export class PostgresRecordStorage extends RecordStorage {
         return this.tableNameValue;
     }
     /**
-     * Prepares this table before a record operation.
+     * Binds this table before a record operation and applies this handle's preparation policy.
      *
-     * @returns A promise that resolves after compatible initialization.
+     * @returns Completion after binding and any preparation required by this handle.
      */
     prepare() {
         return this.admit(() => this.prepareInternal());
     }
     /**
-     * Prepares an already admitted operation, including after the factory fence.
+     * Binds an already admitted operation and applies this handle's preparation policy.
      *
-     * @returns Completion after table preparation.
+     * @returns Completion after binding and any required table preparation.
      */
     prepareInternal() {
         return this.lifecycle.track(Promise.resolve().then(() => this.prepareBound()));
     }
     /**
-     * Binds the destination and prepares its physical table.
+     * Binds the destination and prepares its physical table when enabled for this handle.
      *
-     * @returns Completion after physical table preparation.
+     * @returns Completion after binding and any required table preparation.
      */
     async prepareBound() {
         this.#binding ??= this.bind().catch((error) => {
@@ -106,6 +109,8 @@ export class PostgresRecordStorage extends RecordStorage {
             throw error;
         });
         await this.#binding;
+        if (!this.prepareOnAccess)
+            return;
         const create = this.create;
         await this.lifecycle.prepare(this.table, create === undefined ? undefined : () => create(this.table));
     }
@@ -438,7 +443,7 @@ export class PostgresRecordStorage extends RecordStorage {
         return `UPDATE ${this.qualified()} SET ${assignments.join(", ")} WHERE "ID" = $1 AND "bytes" = $2`;
     }
     /**
-     * Executes work with one prepared and automatically released client.
+     * Executes work with one automatically released client after applying this handle's policy.
      *
      * @typeParam T The value returned by the client work.
      * @param work Performs the client work.
@@ -448,7 +453,7 @@ export class PostgresRecordStorage extends RecordStorage {
         return this.lifecycle.track(this.usePrepared(work));
     }
     /**
-     * Executes one prepared record operation on a released client.
+     * Executes one record operation on a released client after applying this handle's policy.
      *
      * @typeParam T The operation result.
      * @param work Performs the client operation.
@@ -480,7 +485,7 @@ export class PostgresRecordStorage extends RecordStorage {
         return this.lifecycle.track(this.transactionPrepared(work));
     }
     /**
-     * Executes one prepared Agent transaction on a released client.
+     * Executes one Agent transaction on a released client after applying this handle's policy.
      *
      * @typeParam T The transaction result.
      * @param work Performs work on the transaction client.
@@ -824,7 +829,8 @@ export class PostgresRecordStorage extends RecordStorage {
         for (const filter of query.filters ?? []) {
             const column = this.column(filter.column === "id" ? "ID" : filter.column);
             const accepted = RecordQuery.acceptedValues(filter);
-            const alternatives = accepted.map((value) => `${column} IS NOT DISTINCT FROM ${bind.add(this.value(filter.column, value))}`);
+            const alternatives = accepted.map((value) => `${column} ${this.equalityOperator(filter.column, value)} ` +
+                bind.add(this.value(filter.column, value)));
             clauses.push(accepted.length === 0
                 ? "1=0"
                 : accepted.length === 1
@@ -906,12 +912,31 @@ export class PostgresRecordStorage extends RecordStorage {
     predicate(predicate, bind) {
         if (predicate.kind === "ids")
             return `"ID" IN (${predicate.ids.map((id) => bind.add(this.id(id))).join(", ")})`;
-        if (predicate.kind === "comparison")
-            return (`${this.column(predicate.column)} ${operator(predicate.operator)} ` +
+        if (predicate.kind === "comparison") {
+            const comparisonOperator = predicate.operator === "equal"
+                ? this.equalityOperator(predicate.column, predicate.value)
+                : operator(predicate.operator);
+            return (`${this.column(predicate.column)} ${comparisonOperator} ` +
                 bind.add(this.value(predicate.column, predicate.value)));
+        }
         const joiner = predicate.kind === "all" ? " AND " : " OR ";
         return `(${predicate.predicates.map((child) => this.predicate(child, bind)).join(joiner)})`;
     }
+    /**
+     * Returns indexable equality only for present fixed-byte column values.
+     * @param name Declared comparison column.
+     * @param value Compared logical value.
+     * @returns Equality SQL preserving null semantics otherwise.
+     */
+    equalityOperator(name, value) {
+        const type = this.recordSpec.columns.find((column) => column.name === name)?.type;
+        return type?.kind === "scalar" &&
+            type.scalar === ScalarType.BYTES &&
+            type.byteLength !== undefined &&
+            value instanceof Uint8Array
+            ? "="
+            : "IS NOT DISTINCT FROM";
+    }
     /**
      * Validates and quotes one queryable column name.
      *