@workglow/storage 0.0.85 → 0.0.86

package/dist/tabular/IndexedDbTabularStorage.d.ts.map

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

package/dist/tabular/{PostgresTabularRepository.d.ts → PostgresTabularStorage.d.ts}

@@ -3,23 +3,24 @@
  * Copyright 2025 Steven Roussey <sroussey@gmail.com>
  * SPDX-License-Identifier: Apache-2.0
  */
-import { DataPortSchemaObject, FromSchema, JsonSchema } from "@workglow/util";
+import { DataPortSchemaObject, FromSchema, JsonSchema, TypedArraySchemaOptions } from "@workglow/util";
 import type { Pool } from "pg";
-import { BaseSqlTabularRepository } from "./BaseSqlTabularRepository";
-import { DeleteSearchCriteria, ITabularRepository, TabularChangePayload, TabularSubscribeOptions, ValueOptionType } from "./ITabularRepository";
-export declare const POSTGRES_TABULAR_REPOSITORY: import("@workglow/util").ServiceToken<ITabularRepository<any, any, any, any, any>>;
+import { BaseSqlTabularStorage } from "./BaseSqlTabularStorage";
+import { ClientProvidedKeysOption } from "./BaseTabularStorage";
+import { AnyTabularStorage, AutoGeneratedKeys, DeleteSearchCriteria, InsertEntity, SimplifyPrimaryKey, TabularChangePayload, TabularSubscribeOptions, ValueOptionType } from "./ITabularStorage";
+export declare const POSTGRES_TABULAR_REPOSITORY: import("@workglow/util").ServiceToken<AnyTabularStorage>;
 /**
- * A PostgreSQL-based tabular repository implementation that extends BaseSqlTabularRepository.
+ * A PostgreSQL-based tabular repository implementation that extends BaseSqlTabularStorage.
  * This class provides persistent storage for data in a PostgreSQL database,
  * making it suitable for multi-user scenarios.
  *
  * @template Schema - The schema definition for the entity
  * @template PrimaryKeyNames - Array of property names that form the primary key
  */
-export declare class PostgresTabularRepository<Schema extends DataPortSchemaObject, PrimaryKeyNames extends ReadonlyArray<keyof Schema["properties"]>, Entity = FromSchema<Schema>, PrimaryKey = Pick<Entity, PrimaryKeyNames[number] & keyof Entity>, Value = Omit<Entity, PrimaryKeyNames[number] & keyof Entity>> extends BaseSqlTabularRepository<Schema, PrimaryKeyNames, Entity, PrimaryKey, Value> {
-    private db;
+export declare class PostgresTabularStorage<Schema extends DataPortSchemaObject, PrimaryKeyNames extends ReadonlyArray<keyof Schema["properties"]>, Entity = FromSchema<Schema, TypedArraySchemaOptions>, PrimaryKey = SimplifyPrimaryKey<Entity, PrimaryKeyNames>, Value = Omit<Entity, PrimaryKeyNames[number] & keyof Entity>, InsertType extends InsertEntity<Entity, AutoGeneratedKeys<Schema>> = InsertEntity<Entity, AutoGeneratedKeys<Schema>>> extends BaseSqlTabularStorage<Schema, PrimaryKeyNames, Entity, PrimaryKey, Value, InsertType> {
+    protected db: Pool;
     /**
-     * Creates a new PostgresTabularRepository instance.
+     * Creates a new PostgresTabularStorage instance.
      *
      * @param db - PostgreSQL db
      * @param table - Name of the table to store data (defaults to "tabular_store")
@@ -27,14 +28,17 @@ export declare class PostgresTabularRepository<Schema extends DataPortSchemaObje
      * @param primaryKeyNames - Array of property names that form the primary key
      * @param indexes - Array of columns or column arrays to make searchable. Each string or single column creates a single-column index,
      *                    while each array creates a compound index with columns in the specified order.
+     * @param clientProvidedKeys - How to handle client-provided values for auto-generated keys
      */
-    constructor(db: Pool, table: string | undefined, schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes?: readonly (keyof Entity | readonly (keyof Entity)[])[]);
+    constructor(db: Pool, table: string | undefined, schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes?: readonly (keyof Entity | readonly (keyof Entity)[])[], clientProvidedKeys?: ClientProvidedKeysOption);
     /**
      * Initializes the database table with the required schema.
      * Creates the table if it doesn't exist with primary key and value columns.
      * Must be called before using any other methods.
      */
     setupDatabase(): Promise<void>;
+    protected isVectorFormat(format?: string): boolean;
+    protected getVectorDimensions(typeDef: JsonSchema): number | undefined;
     /**
      * Maps TypeScript/JavaScript types to corresponding PostgreSQL data types.
      * Uses additional schema information like minimum/maximum values, nullable status,
@@ -46,6 +50,7 @@ export declare class PostgresTabularRepository<Schema extends DataPortSchemaObje
     protected mapTypeToSQL(typeDef: JsonSchema): string;
     /**
      * Generates the SQL column definitions for primary key fields with constraints
+     * Handles auto-generated keys using SERIAL for integers and UUID DEFAULT for strings
      * @returns SQL string containing primary key column definitions
      */
     protected constructPrimaryKeyColumns($delimiter?: string): string;
@@ -54,6 +59,10 @@ export declare class PostgresTabularRepository<Schema extends DataPortSchemaObje
      * @returns SQL string containing value column definitions
      */
     protected constructValueColumns($delimiter?: string): string;
+    /**
+     * Convert JavaScript values to PostgreSQL values, including TypedArray to vector string
+     */
+    protected jsToSqlValue(column: string, value: Entity[keyof Entity]): ValueOptionType;
     /**
      * Convert PostgreSQL values to JS values. Ensures numeric strings become numbers where schema says number.
      */
@@ -64,24 +73,37 @@ export declare class PostgresTabularRepository<Schema extends DataPortSchemaObje
      * @returns true if the field should be treated as unsigned
      */
     protected shouldBeUnsigned(typeDef: JsonSchema): boolean;
+    /**
+     * Gets information about vector columns in the schema
+     * @returns Array of objects with column name and dimension
+     */
+    protected getVectorColumns(): Array<{
+        column: string;
+        dimension: number;
+    }>;
+    /**
+     * Creates vector-specific indexes (HNSW for pgvector)
+     * Called after table creation if vector columns exist
+     */
+    protected createVectorIndexes(): Promise<void>;
     /**
      * Stores or updates a row in the database.
      * Uses UPSERT (INSERT ... ON CONFLICT DO UPDATE) for atomic operations.
      *
-     * @param entity - The entity to store
+     * @param entity - The entity to store (may be missing auto-generated keys)
      * @returns The entity with any server-generated fields updated
      * @emits "put" event with the updated entity when successful
      */
-    put(entity: Entity): Promise<Entity>;
+    put(entity: InsertType): Promise<Entity>;
     /**
      * Stores multiple rows in the database in a bulk operation.
-     * Uses batch INSERT with ON CONFLICT for better performance.
+     * Uses individual put calls to ensure auto-generated keys are handled correctly.
      *
-     * @param entities - Array of entities to store
+     * @param entities - Array of entities to store (may be missing auto-generated keys)
      * @returns Array of entities with any server-generated fields updated
      * @emits "put" event for each entity stored
      */
-    putBulk(entities: Entity[]): Promise<Entity[]>;
+    putBulk(entities: InsertType[]): Promise<Entity[]>;
     /**
      * Retrieves a value from the database by its primary key.
      *
@@ -149,4 +171,4 @@ export declare class PostgresTabularRepository<Schema extends DataPortSchemaObje
      */
     destroy(): void;
 }
-//# sourceMappingURL=PostgresTabularRepository.d.ts.map
+//# sourceMappingURL=PostgresTabularStorage.d.ts.map

package/dist/tabular/PostgresTabularStorage.d.ts.map

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

package/dist/tabular/{SharedInMemoryTabularRepository.d.ts → SharedInMemoryTabularStorage.d.ts}

@@ -3,33 +3,34 @@
  * Copyright 2025 Steven Roussey <sroussey@gmail.com>
  * SPDX-License-Identifier: Apache-2.0
  */
-import { DataPortSchemaObject, FromSchema } from "@workglow/util";
-import { DeleteSearchCriteria, ITabularRepository, TabularSubscribeOptions } from "./ITabularRepository";
-import { TabularRepository } from "./TabularRepository";
-export declare const SHARED_IN_MEMORY_TABULAR_REPOSITORY: import("@workglow/util").ServiceToken<ITabularRepository<any, any, any, any, any>>;
+import { DataPortSchemaObject, FromSchema, TypedArraySchemaOptions } from "@workglow/util";
+import { BaseTabularStorage, ClientProvidedKeysOption } from "./BaseTabularStorage";
+import { AnyTabularStorage, AutoGeneratedKeys, DeleteSearchCriteria, InsertEntity, SimplifyPrimaryKey, TabularSubscribeOptions } from "./ITabularStorage";
+export declare const SHARED_IN_MEMORY_TABULAR_REPOSITORY: import("@workglow/util").ServiceToken<AnyTabularStorage>;
 /**
  * A tabular repository implementation that shares data across browser tabs/windows
- * using BroadcastChannel API. Uses InMemoryTabularRepository internally and
+ * using BroadcastChannel API. Uses InMemoryTabularStorage internally and
  * synchronizes changes across all instances.
  *
  * @template Schema - The schema definition for the entity using JSON Schema
  * @template PrimaryKeyNames - Array of property names that form the primary key
  */
-export declare class SharedInMemoryTabularRepository<Schema extends DataPortSchemaObject, PrimaryKeyNames extends ReadonlyArray<keyof Schema["properties"]>, Entity = FromSchema<Schema>, PrimaryKey = Pick<Entity, PrimaryKeyNames[number] & keyof Entity>, Value = Omit<Entity, PrimaryKeyNames[number] & keyof Entity>> extends TabularRepository<Schema, PrimaryKeyNames, Entity, PrimaryKey, Value> {
+export declare class SharedInMemoryTabularStorage<Schema extends DataPortSchemaObject, PrimaryKeyNames extends ReadonlyArray<keyof Schema["properties"]>, Entity = FromSchema<Schema, TypedArraySchemaOptions>, PrimaryKey = SimplifyPrimaryKey<Entity, PrimaryKeyNames>, Value = Omit<Entity, PrimaryKeyNames[number] & keyof Entity>, InsertType extends InsertEntity<Entity, AutoGeneratedKeys<Schema>> = InsertEntity<Entity, AutoGeneratedKeys<Schema>>> extends BaseTabularStorage<Schema, PrimaryKeyNames, Entity, PrimaryKey, Value, InsertType> {
     private channel;
     private channelName;
     private inMemoryRepo;
     private isInitialized;
     private syncInProgress;
     /**
-     * Creates a new SharedInMemoryTabularRepository instance
+     * Creates a new SharedInMemoryTabularStorage instance
      * @param channelName - Unique name for the BroadcastChannel (defaults to "tabular_store")
      * @param schema - Schema defining the structure of the entity
      * @param primaryKeyNames - Array of property names that form the primary key
      * @param indexes - Array of columns or column arrays to make searchable. Each string or single column creates a single-column index,
      *                    while each array creates a compound index with columns in the specified order.
+     * @param clientProvidedKeys - How to handle client-provided values for auto-generated keys
      */
-    constructor(channelName: string | undefined, schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes?: readonly (keyof Entity | readonly (keyof Entity)[])[]);
+    constructor(channelName: string | undefined, schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes?: readonly (keyof Entity | readonly (keyof Entity)[])[], clientProvidedKeys?: ClientProvidedKeysOption);
     /**
      * Checks if BroadcastChannel is available in the current environment
      */
@@ -39,7 +40,7 @@ export declare class SharedInMemoryTabularRepository<Schema extends DataPortSche
      */
     private initializeBroadcastChannel;
     /**
-     * Sets up event forwarding from the internal InMemoryTabularRepository
+     * Sets up event forwarding from the internal InMemoryTabularStorage
      */
     private setupEventForwarding;
     /**
@@ -68,14 +69,14 @@ export declare class SharedInMemoryTabularRepository<Schema extends DataPortSche
      * @returns The stored entity
      * @emits 'put' event with the stored entity when successful
      */
-    put(value: Entity): Promise<Entity>;
+    put(value: InsertType): Promise<Entity>;
     /**
      * Stores multiple key-value pairs in the repository in a bulk operation
      * @param values - Array of combined objects to store
      * @returns Array of stored entities
      * @emits 'put' event for each value stored
      */
-    putBulk(values: Entity[]): Promise<Entity[]>;
+    putBulk(values: InsertType[]): Promise<Entity[]>;
     /**
      * Retrieves a value by its key
      * @param key - The primary key object to look up
@@ -120,7 +121,7 @@ export declare class SharedInMemoryTabularRepository<Schema extends DataPortSche
     deleteSearch(criteria: DeleteSearchCriteria<Entity>): Promise<void>;
     /**
      * Subscribes to changes in the repository.
-     * Delegates to the internal InMemoryTabularRepository which monitors local changes.
+     * Delegates to the internal InMemoryTabularStorage which monitors local changes.
      * Changes from other tabs/windows are already propagated via BroadcastChannel.
      *
      * @param callback - Function called when a change occurs
@@ -133,4 +134,4 @@ export declare class SharedInMemoryTabularRepository<Schema extends DataPortSche
      */
     destroy(): void;
 }
-//# sourceMappingURL=SharedInMemoryTabularRepository.d.ts.map
+//# sourceMappingURL=SharedInMemoryTabularStorage.d.ts.map

package/dist/tabular/SharedInMemoryTabularStorage.d.ts.map

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

package/dist/tabular/{SqliteTabularRepository.d.ts → SqliteTabularStorage.d.ts}

@@ -4,16 +4,17 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { Sqlite } from "@workglow/sqlite";
-import { DataPortSchemaObject, FromSchema, JsonSchema } from "@workglow/util";
-import { BaseSqlTabularRepository } from "./BaseSqlTabularRepository";
-import { DeleteSearchCriteria, ITabularRepository, TabularChangePayload, TabularSubscribeOptions, ValueOptionType } from "./ITabularRepository";
-export declare const SQLITE_TABULAR_REPOSITORY: import("@workglow/util").ServiceToken<ITabularRepository<any, any, any, any, any>>;
+import { DataPortSchemaObject, FromSchema, JsonSchema, TypedArraySchemaOptions } from "@workglow/util";
+import { BaseSqlTabularStorage } from "./BaseSqlTabularStorage";
+import { ClientProvidedKeysOption, KeyGenerationStrategy } from "./BaseTabularStorage";
+import { AnyTabularStorage, AutoGeneratedKeys, DeleteSearchCriteria, InsertEntity, SimplifyPrimaryKey, TabularChangePayload, TabularSubscribeOptions, ValueOptionType } from "./ITabularStorage";
+export declare const SQLITE_TABULAR_REPOSITORY: import("@workglow/util").ServiceToken<AnyTabularStorage>;
 /**
  * A SQLite-based key-value repository implementation.
  * @template Schema - The schema definition for the entity
  * @template PrimaryKeyNames - Array of property names that form the primary key
  */
-export declare class SqliteTabularRepository<Schema extends DataPortSchemaObject, PrimaryKeyNames extends ReadonlyArray<keyof Schema["properties"]>, Entity = FromSchema<Schema>, PrimaryKey = Pick<Entity, PrimaryKeyNames[number] & keyof Entity>, Value = Omit<Entity, PrimaryKeyNames[number] & keyof Entity>> extends BaseSqlTabularRepository<Schema, PrimaryKeyNames, Entity, PrimaryKey, Value> {
+export declare class SqliteTabularStorage<Schema extends DataPortSchemaObject, PrimaryKeyNames extends ReadonlyArray<keyof Schema["properties"]>, Entity = FromSchema<Schema, TypedArraySchemaOptions>, PrimaryKey = SimplifyPrimaryKey<Entity, PrimaryKeyNames>, Value = Omit<Entity, PrimaryKeyNames[number] & keyof Entity>, InsertType extends InsertEntity<Entity, AutoGeneratedKeys<Schema>> = InsertEntity<Entity, AutoGeneratedKeys<Schema>>> extends BaseSqlTabularStorage<Schema, PrimaryKeyNames, Entity, PrimaryKey, Value, InsertType> {
     /** The SQLite database instance */
     private db;
     /**
@@ -24,8 +25,13 @@ export declare class SqliteTabularRepository<Schema extends DataPortSchemaObject
      * @param primaryKeyNames - Array of property names that form the primary key
      * @param indexes - Array of columns or column arrays to make searchable. Each string or single column creates a single-column index,
      *                    while each array creates a compound index with columns in the specified order.
+     * @param clientProvidedKeys - How to handle client-provided values for auto-generated keys
      */
-    constructor(dbOrPath: string | Sqlite.Database, table: string | undefined, schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes?: readonly (keyof Entity | readonly (keyof Entity)[])[]);
+    constructor(dbOrPath: string | Sqlite.Database, table: string | undefined, schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes?: readonly (keyof Entity | readonly (keyof Entity)[])[], clientProvidedKeys?: ClientProvidedKeysOption);
+    /**
+     * Override to handle SQLite's INTEGER PRIMARY KEY for auto-increment
+     */
+    protected constructPrimaryKeyColumns($delimiter?: string): string;
     /**
      * Creates the database table if it doesn't exist with the defined schema.
      * Must be called before using any other methods.
@@ -48,20 +54,28 @@ export declare class SqliteTabularRepository<Schema extends DataPortSchemaObject
      * @returns The corresponding SQLite column type
      */
     protected mapTypeToSQL(typeDef: JsonSchema): string;
+    /**
+     * Generates a key value for string UUID keys
+     * Integer keys are auto-generated by SQLite's INTEGER PRIMARY KEY
+     * @param columnName - Name of the column to generate a key for
+     * @param strategy - The generation strategy to use
+     * @returns The generated key value
+     */
+    protected generateKeyValue(columnName: string, strategy: KeyGenerationStrategy): string | number;
     /**
      * Stores a key-value pair in the database
-     * @param entity - The entity to store
+     * @param entity - The entity to store (may be missing auto-generated keys)
      * @returns The entity with any server-generated fields updated
      * @emits 'put' event when successful
      */
-    put(entity: Entity): Promise<Entity>;
+    put(entity: InsertType): Promise<Entity>;
     /**
      * Stores multiple key-value pairs in the database in a bulk operation
-     * @param entities - Array of entities to store
+     * @param entities - Array of entities to store (may be missing auto-generated keys)
      * @returns Array of entities with any server-generated fields updated
      * @emits 'put' event for each entity stored
      */
-    putBulk(entities: Entity[]): Promise<Entity[]>;
+    putBulk(entities: InsertType[]): Promise<Entity[]>;
     /**
      * Retrieves a value from the database by its key
      * @param key - The primary key object to look up
@@ -126,4 +140,4 @@ export declare class SqliteTabularRepository<Schema extends DataPortSchemaObject
      */
     destroy(): void;
 }
-//# sourceMappingURL=SqliteTabularRepository.d.ts.map
+//# sourceMappingURL=SqliteTabularStorage.d.ts.map

package/dist/tabular/SqliteTabularStorage.d.ts.map

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

package/dist/tabular/{SupabaseTabularRepository.d.ts → SupabaseTabularStorage.d.ts}

@@ -4,23 +4,24 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { SupabaseClient } from "@supabase/supabase-js";
-import { DataPortSchemaObject, FromSchema, JsonSchema } from "@workglow/util";
-import { BaseSqlTabularRepository } from "./BaseSqlTabularRepository";
-import { DeleteSearchCriteria, ITabularRepository, TabularChangePayload, TabularSubscribeOptions, ValueOptionType } from "./ITabularRepository";
-export declare const SUPABASE_TABULAR_REPOSITORY: import("@workglow/util").ServiceToken<ITabularRepository<any, any, any, any, any>>;
+import { DataPortSchemaObject, FromSchema, JsonSchema, TypedArraySchemaOptions } from "@workglow/util";
+import { BaseSqlTabularStorage } from "./BaseSqlTabularStorage";
+import { ClientProvidedKeysOption } from "./BaseTabularStorage";
+import { AnyTabularStorage, AutoGeneratedKeys, DeleteSearchCriteria, InsertEntity, SimplifyPrimaryKey, TabularChangePayload, TabularSubscribeOptions, ValueOptionType } from "./ITabularStorage";
+export declare const SUPABASE_TABULAR_REPOSITORY: import("@workglow/util").ServiceToken<AnyTabularStorage>;
 /**
- * A Supabase-based tabular repository implementation that extends BaseSqlTabularRepository.
+ * A Supabase-based tabular repository implementation that extends BaseSqlTabularStorage.
  * This class provides persistent storage for data in a Supabase database,
  * making it suitable for multi-user scenarios.
  *
  * @template Schema - The schema definition for the entity
  * @template PrimaryKeyNames - Array of property names that form the primary key
  */
-export declare class SupabaseTabularRepository<Schema extends DataPortSchemaObject, PrimaryKeyNames extends ReadonlyArray<keyof Schema["properties"]>, Entity = FromSchema<Schema>, PrimaryKey = Pick<Entity, PrimaryKeyNames[number] & keyof Entity>, Value = Omit<Entity, PrimaryKeyNames[number] & keyof Entity>> extends BaseSqlTabularRepository<Schema, PrimaryKeyNames, Entity, PrimaryKey, Value> {
+export declare class SupabaseTabularStorage<Schema extends DataPortSchemaObject, PrimaryKeyNames extends ReadonlyArray<keyof Schema["properties"]>, Entity = FromSchema<Schema, TypedArraySchemaOptions>, PrimaryKey = SimplifyPrimaryKey<Entity, PrimaryKeyNames>, Value = Omit<Entity, PrimaryKeyNames[number] & keyof Entity>, InsertType extends InsertEntity<Entity, AutoGeneratedKeys<Schema>> = InsertEntity<Entity, AutoGeneratedKeys<Schema>>> extends BaseSqlTabularStorage<Schema, PrimaryKeyNames, Entity, PrimaryKey, Value, InsertType> {
     private client;
     private realtimeChannel;
     /**
-     * Creates a new SupabaseTabularRepository instance.
+     * Creates a new SupabaseTabularStorage instance.
      *
      * @param client - Supabase client instance
      * @param table - Name of the table to store data (defaults to "tabular_store")
@@ -28,13 +29,13 @@ export declare class SupabaseTabularRepository<Schema extends DataPortSchemaObje
      * @param primaryKeyNames - Array of property names that form the primary key
      * @param indexes - Array of columns or column arrays to make searchable. Each string or single column creates a single-column index,
      *                    while each array creates a compound index with columns in the specified order.
+     * @param clientProvidedKeys - How to handle client-provided values for auto-generated keys
      */
-    constructor(client: SupabaseClient, table: string | undefined, schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes?: readonly (keyof Entity | readonly (keyof Entity)[])[]);
+    constructor(client: SupabaseClient, table: string | undefined, schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes?: readonly (keyof Entity | readonly (keyof Entity)[])[], clientProvidedKeys?: ClientProvidedKeysOption);
     /**
      * Initializes the database table with the required schema.
      * Creates the table if it doesn't exist with primary key and value columns.
      * Must be called before using any other methods.
-     * Note: By default, assumes the table already exists (set isSetup in tests).
      */
     setupDatabase(): Promise<void>;
     /**
@@ -48,6 +49,7 @@ export declare class SupabaseTabularRepository<Schema extends DataPortSchemaObje
     protected mapTypeToSQL(typeDef: JsonSchema): string;
     /**
      * Generates the SQL column definitions for primary key fields with constraints
+     * Handles auto-generated keys using SERIAL for integers and UUID DEFAULT for strings
      * @returns SQL string containing primary key column definitions
      */
     protected constructPrimaryKeyColumns($delimiter?: string): string;
@@ -70,20 +72,20 @@ export declare class SupabaseTabularRepository<Schema extends DataPortSchemaObje
      * Stores or updates a row in the database.
      * Uses UPSERT (INSERT ... ON CONFLICT DO UPDATE) for atomic operations.
      *
-     * @param entity - The entity to store
+     * @param entity - The entity to store (may be missing auto-generated keys)
      * @returns The entity with any server-generated fields updated
      * @emits "put" event with the updated entity when successful
      */
-    put(entity: Entity): Promise<Entity>;
+    put(entity: InsertType): Promise<Entity>;
     /**
      * Stores multiple rows in the database in a bulk operation.
-     * Uses batch INSERT with ON CONFLICT for better performance.
+     * Uses individual put calls to ensure auto-generated keys are handled correctly.
      *
-     * @param entities - Array of entities to store
+     * @param entities - Array of entities to store (may be missing auto-generated keys)
      * @returns Array of entities with any server-generated fields updated
      * @emits "put" event for each entity stored
      */
-    putBulk(entities: Entity[]): Promise<Entity[]>;
+    putBulk(entities: InsertType[]): Promise<Entity[]>;
     /**
      * Retrieves a value from the database by its primary key.
      *
@@ -150,4 +152,4 @@ export declare class SupabaseTabularRepository<Schema extends DataPortSchemaObje
      */
     destroy(): void;
 }
-//# sourceMappingURL=SupabaseTabularRepository.d.ts.map
+//# sourceMappingURL=SupabaseTabularStorage.d.ts.map

package/dist/tabular/SupabaseTabularStorage.d.ts.map

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

package/dist/tabular/TabularStorageRegistry.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AnyTabularStorage } from "./ITabularStorage";
+/**
+ * Service token for the tabular repository registry
+ * Maps repository IDs to ITabularStorage instances
+ */
+export declare const TABULAR_REPOSITORIES: import("@workglow/util").ServiceToken<Map<string, AnyTabularStorage>>;
+/**
+ * Gets the global tabular repository registry
+ * @returns Map of tabular repository ID to instance
+ */
+export declare function getGlobalTabularRepositories(): Map<string, AnyTabularStorage>;
+/**
+ * Registers a tabular repository globally by ID
+ * @param id The unique identifier for this repository
+ * @param repository The repository instance to register
+ */
+export declare function registerTabularRepository(id: string, repository: AnyTabularStorage): void;
+/**
+ * Gets a tabular repository by ID from the global registry
+ * @param id The repository identifier
+ * @returns The repository instance or undefined if not found
+ */
+export declare function getTabularRepository(id: string): AnyTabularStorage | undefined;
+//# sourceMappingURL=TabularStorageRegistry.d.ts.map

package/dist/tabular/TabularStorageRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TabularStorageRegistry.d.ts","sourceRoot":"","sources":["../../src/tabular/TabularStorageRegistry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,uEAEhC,CAAC;AAWF;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAGzF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAE9E"}

package/dist/util/IndexedDbTable.d.ts

@@ -32,7 +32,7 @@ export interface MigrationOptions {
  * Ensures that an IndexedDB table exists with the specified schema.
  * Performs migrations as needed without data loss when possible.
  */
-export declare function ensureIndexedDbTable(tableName: string, primaryKey: string | string[], expectedIndexes?: ExpectedIndexDefinition[], options?: MigrationOptions): Promise<IDBDatabase>;
+export declare function ensureIndexedDbTable(tableName: string, primaryKey: string | string[], expectedIndexes?: ExpectedIndexDefinition[], options?: MigrationOptions, autoIncrement?: boolean): Promise<IDBDatabase>;
 /**
  * Utility function to delete a database (for testing or cleanup)
  */

package/dist/util/IndexedDbTable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IndexedDbTable.d.ts","sourceRoot":"","sources":["../../src/util/IndexedDbTable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,WAAW,CAAC;IAChB,WAAW,EAAE,cAAc,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oFAAoF;IACpF,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,8CAA8C;IAC9C,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnE,yDAAyD;IACzD,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;CAC/D;AAycD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,EAC7B,eAAe,GAAE,uBAAuB,EAAO,EAC/C,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,WAAW,CAAC,CA6JtB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzE"}
+{"version":3,"file":"IndexedDbTable.d.ts","sourceRoot":"","sources":["../../src/util/IndexedDbTable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,WAAW,CAAC;IAChB,WAAW,EAAE,cAAc,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oFAAoF;IACpF,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,8CAA8C;IAC9C,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnE,yDAAyD;IACzD,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;CAC/D;AA2cD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,EAC7B,eAAe,GAAE,uBAAuB,EAAO,EAC/C,OAAO,GAAE,gBAAqB,EAC9B,aAAa,GAAE,OAAe,GAC7B,OAAO,CAAC,WAAW,CAAC,CA6JtB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzE"}

package/dist/vector/IVectorStorage.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { DataPortSchemaObject, EventParameters, FromSchema, TypedArray, TypedArraySchemaOptions } from "@workglow/util";
+import type { ITabularStorage, TabularEventListeners } from "../tabular/ITabularStorage";
+export type AnyVectorStorage = IVectorStorage<any, any, any, any>;
+/**
+ * Options for vector search operations
+ */
+export interface VectorSearchOptions<Metadata extends Record<string, unknown> | undefined = Record<string, unknown>> {
+    readonly topK?: number;
+    readonly filter?: Partial<Metadata>;
+    readonly scoreThreshold?: number;
+}
+/**
+ * Options for hybrid search (vector + full-text)
+ */
+export interface HybridSearchOptions<Metadata extends Record<string, unknown> | undefined = Record<string, unknown>> extends VectorSearchOptions<Metadata> {
+    readonly textQuery: string;
+    readonly vectorWeight?: number;
+}
+/**
+ * Type definitions for document chunk vector repository events
+ */
+export interface VectorEventListeners<PrimaryKey, Entity> extends TabularEventListeners<PrimaryKey, Entity> {
+    similaritySearch: (query: TypedArray, results: (Entity & {
+        score: number;
+    })[]) => void;
+    hybridSearch: (query: TypedArray, results: (Entity & {
+        score: number;
+    })[]) => void;
+}
+export type VectorEventName = keyof VectorEventListeners<any, any>;
+export type VectorEventListener<Event extends VectorEventName, PrimaryKey, Entity> = VectorEventListeners<PrimaryKey, Entity>[Event];
+export type VectorEventParameters<Event extends VectorEventName, PrimaryKey, Entity> = EventParameters<VectorEventListeners<PrimaryKey, Entity>, Event>;
+/**
+ * Interface defining the contract for vector storage repositories.
+ * These repositories store vector embeddings with metadata.
+ * Extends ITabularStorage to provide standard storage operations,
+ * plus vector-specific similarity search capabilities.
+ * Supports various vector types including quantized formats.
+ *
+ * @typeParam Schema - The schema definition for the entity using JSON Schema
+ * @typeParam PrimaryKeyNames - Array of property names that form the primary key
+ * @typeParam Entity - The entity type
+ */
+export interface IVectorStorage<Metadata extends Record<string, unknown> | undefined, Schema extends DataPortSchemaObject, Entity = FromSchema<Schema, TypedArraySchemaOptions>, PrimaryKeyNames extends ReadonlyArray<keyof Schema["properties"]> = ReadonlyArray<keyof Schema["properties"]>> extends ITabularStorage<Schema, PrimaryKeyNames, Entity> {
+    /**
+     * Get the vector dimension
+     * @returns The vector dimension
+     */
+    getVectorDimensions(): number;
+    /**
+     * Search for similar vectors using similarity scoring
+     * @param query - Query vector to compare against
+     * @param options - Search options (topK, filter, scoreThreshold)
+     * @returns Array of search results sorted by similarity (highest first)
+     */
+    similaritySearch(query: TypedArray, options?: VectorSearchOptions<Metadata>): Promise<(Entity & {
+        score: number;
+    })[]>;
+    /**
+     * Hybrid search combining vector similarity with full-text search
+     * This is optional and may not be supported by all implementations
+     * @param query - Query vector to compare against
+     * @param options - Hybrid search options including text query
+     * @returns Array of search results sorted by combined relevance
+     */
+    hybridSearch?(query: TypedArray, options: HybridSearchOptions<Metadata>): Promise<(Entity & {
+        score: number;
+    })[]>;
+}
+/**
+ * TODO: Given a schema, return the vector column by searching for a property with a TypedArray format (or TypedArray:xxx format)
+ */
+export declare function getVectorProperty<Schema extends DataPortSchemaObject>(schema: Schema): keyof Schema["properties"] | undefined;
+/**
+ * Given a schema, return the property which is an object with format "metadata"
+ */
+export declare function getMetadataProperty<Schema extends DataPortSchemaObject>(schema: Schema): keyof Schema["properties"] | undefined;
+//# sourceMappingURL=IVectorStorage.d.ts.map

package/dist/vector/IVectorStorage.d.ts.map

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

package/dist/vector/InMemoryVectorStorage.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { DataPortSchemaObject, FromSchema, TypedArray, TypedArraySchemaOptions } from "@workglow/util";
+import { InMemoryTabularStorage } from "../tabular/InMemoryTabularStorage";
+import { type HybridSearchOptions, type IVectorStorage, type VectorSearchOptions } from "./IVectorStorage";
+/**
+ * In-memory document chunk vector repository implementation.
+ * Extends InMemoryTabularStorage for storage.
+ * Suitable for testing and small-scale browser applications.
+ * Supports all vector types including quantized formats.
+ *
+ * @template Metadata - The metadata type for the document chunk
+ * @template Vector - The vector type for the document chunk
+ */
+export declare class InMemoryVectorStorage<Schema extends DataPortSchemaObject, PrimaryKeyNames extends ReadonlyArray<keyof Schema["properties"]>, Metadata extends Record<string, unknown> = Record<string, unknown>, Vector extends TypedArray = Float32Array, Entity = FromSchema<Schema, TypedArraySchemaOptions>> extends InMemoryTabularStorage<Schema, PrimaryKeyNames, Entity> implements IVectorStorage<Metadata, Schema, Entity, PrimaryKeyNames> {
+    private vectorDimensions;
+    private VectorType;
+    private vectorPropertyName;
+    private metadataPropertyName;
+    /**
+     * Creates a new in-memory document chunk vector repository
+     * @param dimensions - The number of dimensions of the vector
+     * @param VectorType - The type of vector to use (defaults to Float32Array)
+     */
+    constructor(schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes: readonly (keyof Entity | readonly (keyof Entity)[])[] | undefined, dimensions: number, VectorType?: new (array: number[]) => TypedArray);
+    /**
+     * Get the vector dimensions
+     * @returns The vector dimensions
+     */
+    getVectorDimensions(): number;
+    similaritySearch(query: TypedArray, options?: VectorSearchOptions<Record<string, unknown>>): Promise<(Entity & {
+        score: number;
+    })[]>;
+    hybridSearch(query: TypedArray, options: HybridSearchOptions<Record<string, unknown>>): Promise<(Entity & {
+        score: number;
+    })[]>;
+}
+//# sourceMappingURL=InMemoryVectorStorage.d.ts.map

package/dist/vector/InMemoryVectorStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryVectorStorage.d.ts","sourceRoot":"","sources":["../../src/vector/InMemoryVectorStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,UAAU,EACV,UAAU,EACV,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAC;AAiC1B;;;;;;;;GAQG;AACH,qBAAa,qBAAqB,CAChC,MAAM,SAAS,oBAAoB,EACnC,eAAe,SAAS,aAAa,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC,EACjE,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,MAAM,SAAS,UAAU,GAAG,YAAY,EACxC,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAEpD,SAAQ,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,CAC9D,YAAW,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC;IAEpE,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,kBAAkB,CAAe;IACzC,OAAO,CAAC,oBAAoB,CAA2B;IAEvD;;;;OAIG;gBAED,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,eAAe,EAChC,OAAO,EAAE,SAAS,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,MAAM,CAAC,EAAE,CAAC,EAAE,YAAK,EACnE,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,KAAK,KAAK,EAAE,MAAM,EAAE,KAAK,UAAyB;IAgBhE;;;OAGG;IACH,mBAAmB,IAAI,MAAM;IAIvB,gBAAgB,CACpB,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;eAGnB,MAAM;;IAoCzC,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;eApClD,MAAM;;CAsFhD"}