@workglow/storage 0.2.26 → 0.2.28

package/dist/tabular/SupabaseTabularStorage.d.ts

@@ -1,174 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import type { SupabaseClient } from "@supabase/supabase-js";
-import { DataPortSchemaObject, FromSchema, JsonSchema, TypedArraySchemaOptions } from "@workglow/util/schema";
-import { BaseSqlTabularStorage } from "./BaseSqlTabularStorage";
-import { ClientProvidedKeysOption } from "./BaseTabularStorage";
-import { AnyTabularStorage, AutoGeneratedKeys, CoveringIndexQueryOptions, DeleteSearchCriteria, InsertEntity, QueryOptions, SearchCriteria, 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 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 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> {
-    protected readonly client: SupabaseClient;
-    private realtimeChannel;
-    /**
-     * Creates a new SupabaseTabularStorage instance.
-     *
-     * @param client - Supabase client instance
-     * @param table - Name of the table to store data (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(client: unknown, table: string | undefined, schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes?: readonly (keyof NoInfer<Entity> | readonly (keyof NoInfer<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>;
-    /**
-     * Maps TypeScript/JavaScript types to corresponding PostgreSQL data types.
-     * Uses additional schema information like minimum/maximum values, nullable status,
-     * and string lengths to create more optimized column types.
-     *
-     * @param typeDef - The TypeScript/JavaScript type to map
-     * @returns The corresponding PostgreSQL data type
-     */
-    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;
-    /**
-     * Generates the SQL column definitions for value fields with constraints
-     * @returns SQL string containing value column definitions
-     */
-    protected constructValueColumns($delimiter?: string): string;
-    /**
-     * Convert Supabase values to JS values. Ensures numeric strings become numbers where schema says number.
-     */
-    protected sqlToJsValue(column: string, value: ValueOptionType): Entity[keyof Entity];
-    /**
-     * Determines if a field should be treated as unsigned based on schema properties
-     * @param typeDef - The schema type definition
-     * @returns true if the field should be treated as unsigned
-     */
-    protected shouldBeUnsigned(typeDef: JsonSchema): boolean;
-    /**
-     * Stores or updates a row in the database.
-     * Uses UPSERT (INSERT ... ON CONFLICT DO UPDATE) for atomic operations.
-     *
-     * @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: InsertType): Promise<Entity>;
-    /**
-     * Stores multiple rows in the database in a bulk operation.
-     * Uses individual put calls to ensure auto-generated keys are handled correctly.
-     *
-     * @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: InsertType[]): Promise<Entity[]>;
-    /**
-     * Retrieves a value from the database by its primary key.
-     *
-     * @param key - The primary key object to look up
-     * @returns The stored entity or undefined if not found
-     * @emits "get" event with the key when successful
-     */
-    get(key: PrimaryKey): Promise<Entity | undefined>;
-    /**
-     * Deletes a row from the database.
-     *
-     * @param value - The primary key object or entity to delete
-     * @emits "delete" event with the key when successful
-     */
-    delete(value: PrimaryKey | Entity): Promise<void>;
-    /**
-     * Retrieves all entries from the database table, with optional ordering, offset, and limit.
-     * @param options - Optional ordering, limit, and offset options
-     * @returns Promise resolving to an array of entries or undefined if not found
-     */
-    getAll(options?: QueryOptions<Entity>): Promise<Entity[] | undefined>;
-    /**
-     * Deletes all rows from the database table.
-     * @emits "clearall" event when successful
-     */
-    deleteAll(): Promise<void>;
-    /**
-     * Returns the total number of rows in the database.
-     *
-     * @returns Promise resolving to the count of stored items
-     */
-    size(): Promise<number>;
-    /**
-     * Fetches a page of records from the repository.
-     * @param offset - Number of records to skip
-     * @param limit - Maximum number of records to return
-     * @returns Array of entities or undefined if no records found
-     */
-    getBulk(offset: number, limit: number): Promise<Entity[] | undefined>;
-    /**
-     * Applies criteria to a Supabase filter builder. Typed as `any` because the
-     * `PostgrestFilterBuilder` generics are deep enough to trip TS2589.
-     */
-    private applyCriteriaToFilter;
-    /**
-     * Counts rows matching the specified search criteria.
-     */
-    count(criteria?: SearchCriteria<Entity>): Promise<number>;
-    /**
-     * Deletes all entries matching the specified search criteria.
-     * Supports multiple columns with optional comparison operators.
-     *
-     * @param criteria - Object with column names as keys and values or SearchConditions
-     */
-    deleteSearch(criteria: DeleteSearchCriteria<Entity>): Promise<void>;
-    /**
-     * Queries entries matching the specified search criteria with optional ordering, limit, and offset.
-     *
-     * @param criteria - Object with column names as keys and values or SearchConditions
-     * @param options - Optional ordering, limit, and offset options
-     * @returns Array of matching entities or undefined if no matches found
-     */
-    query(criteria: SearchCriteria<Entity>, options?: QueryOptions<Entity>): Promise<Entity[] | undefined>;
-    queryIndex<K extends keyof Entity & string>(criteria: SearchCriteria<Entity>, options: CoveringIndexQueryOptions<Entity, K>): Promise<Pick<Entity, K>[]>;
-    /**
-     * Converts a row from Supabase realtime payload to an Entity with proper type conversions.
-     *
-     * @param row - The raw row data from Supabase realtime
-     * @returns The converted entity
-     */
-    private convertRealtimeRow;
-    /**
-     * Subscribes to changes in the repository using Supabase realtime.
-     * Receives notifications for INSERT, UPDATE, and DELETE operations from any source.
-     *
-     * @param callback - Function called when a change occurs
-     * @param options - Optional subscription options (not used for Supabase realtime)
-     * @returns Unsubscribe function
-     */
-    subscribeToChanges(callback: (change: TabularChangePayload<Entity>) => void, options?: TabularSubscribeOptions): () => void;
-    /**
-     * Destroys the repository and frees up resources.
-     */
-    destroy(): void;
-}
-//# sourceMappingURL=SupabaseTabularStorage.d.ts.map

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

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

package/dist/util/IndexedDbTable.d.ts

@@ -1,40 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-export interface ExpectedIndexDefinition {
-    name: string;
-    keyPath: string | string[];
-    options?: IDBIndexParameters;
-}
-export interface MigrationContext {
-    db: IDBDatabase;
-    transaction: IDBTransaction;
-    oldVersion: number;
-    newVersion: number;
-    tableName: string;
-}
-export interface DataTransformer {
-    (oldData: any): any | Promise<any>;
-}
-export interface MigrationOptions {
-    /** Custom data transformer to apply during migration */
-    dataTransformer?: DataTransformer;
-    /** Whether to allow destructive operations (delete and recreate). Default: false */
-    allowDestructiveMigration?: boolean;
-    /** Callback for migration progress/logging */
-    onMigrationProgress?: (message: string, progress?: number) => void;
-    /** Callback for migration errors (non-fatal warnings) */
-    onMigrationWarning?: (message: string, error?: Error) => void;
-}
-/**
- * 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, autoIncrement?: boolean): Promise<IDBDatabase>;
-/**
- * Utility function to delete a database (for testing or cleanup)
- */
-export declare function dropIndexedDbTable(tableName: string): Promise<void>;
-//# sourceMappingURL=IndexedDbTable.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"IndexedDbTable.d.ts","sourceRoot":"","sources":["../../src/util/IndexedDbTable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,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;AAsZD;;;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,CA6KtB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzE"}

package/dist/util/traced.d.ts

@@ -1,10 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * Executes an async function within a telemetry span.
- */
-export declare function traced<T>(spanName: string, storageName: string, fn: () => Promise<T>): Promise<T>;
-//# sourceMappingURL=traced.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"traced.d.ts","sourceRoot":"","sources":["../../src/util/traced.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAC5B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAgBZ"}

package/dist/vector/IndexedDbVectorStorage.d.ts

@@ -1,53 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import type { DataPortSchemaObject, FromSchema, TypedArray, TypedArrayConstructor, TypedArraySchemaOptions } from "@workglow/util/schema";
-import type { ClientProvidedKeysOption } from "../tabular/BaseTabularStorage";
-import { IndexedDbTabularStorage } from "../tabular/IndexedDbTabularStorage";
-import type { MigrationOptions } from "../util/IndexedDbTable";
-import type { AnyVectorStorage, HybridSearchOptions, IVectorStorage, VectorSearchOptions } from "./IVectorStorage";
-export declare const IDB_VECTOR_REPOSITORY: import("@workglow/util").ServiceToken<AnyVectorStorage>;
-/**
- * IndexedDB vector storage implementation.
- * Extends IndexedDbTabularStorage for storage.
- * Suitable for browser applications that need persistent vector storage.
- * No vector serialization needed since IndexedDB supports TypedArrays
- * natively via structured clone.
- *
- * @template Schema - The schema definition for the entity
- * @template PrimaryKeyNames - The primary key names
- * @template Metadata - The metadata type for the vector
- * @template VectorCtor - Constructor for stored vectors (default {@link typeof Float32Array})
- * @template Entity - The entity type
- */
-export declare class IndexedDbVectorStorage<Schema extends DataPortSchemaObject, PrimaryKeyNames extends ReadonlyArray<keyof Schema["properties"]>, Metadata extends Record<string, unknown> = Record<string, unknown>, Entity = FromSchema<Schema, TypedArraySchemaOptions>> extends IndexedDbTabularStorage<Schema, PrimaryKeyNames, Entity> implements IVectorStorage<Metadata, Schema, Entity, PrimaryKeyNames> {
-    private vectorDimensions;
-    private vectorPropertyName;
-    private metadataPropertyName;
-    /**
-     * Creates a new IndexedDB vector storage
-     * @param table - The name of the IndexedDB store (defaults to 'vectors')
-     * @param schema - The schema definition for the entity
-     * @param primaryKeyNames - Array of property names that form the primary key
-     * @param indexes - Array of columns or column arrays to make searchable
-     * @param dimensions - The number of dimensions of the vector
-     * @param _vectorCtor - TypedArray constructor (unused, IndexedDB stores typed arrays natively)
-     * @param migrationOptions - Options for handling database schema migrations
-     * @param clientProvidedKeys - How to handle client-provided values for auto-generated keys
-     */
-    constructor(table: string | undefined, schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes: readonly (keyof NoInfer<Entity> | readonly (keyof NoInfer<Entity>)[])[] | undefined, dimensions: number, _vectorCtor?: TypedArrayConstructor, migrationOptions?: MigrationOptions, clientProvidedKeys?: ClientProvidedKeysOption);
-    /**
-     * 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=IndexedDbVectorStorage.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"IndexedDbVectorStorage.d.ts","sourceRoot":"","sources":["../../src/vector/IndexedDbVectorStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,oBAAoB,EACpB,UAAU,EACV,UAAU,EACV,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAG1B,eAAO,MAAM,qBAAqB,yDAEjC,CAAC;AAiCF;;;;;;;;;;;;GAYG;AACH,qBAAa,sBAAsB,CACjC,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,GAAG,UAAU,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAEpD,SAAQ,uBAAuB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,CAC/D,YAAW,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC;IAEpE,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,kBAAkB,CAAe;IACzC,OAAO,CAAC,oBAAoB,CAA2B;IAEvD;;;;;;;;;;OAUG;IACH,YACE,KAAK,EAAE,MAAM,YAAY,EACzB,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,eAAe,EAChC,OAAO,EAAE,SAAS,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,YAAK,EACrF,UAAU,EAAE,MAAM,EAClB,WAAW,GAAE,qBAAoC,EACjD,gBAAgB,GAAE,gBAAqB,EACvC,kBAAkB,GAAE,wBAAuC,EAa5D;IAED;;;OAGG;IACH,mBAAmB,IAAI,MAAM,CAE5B;IAEK,gBAAgB,CACpB,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;eAGnB,MAAM;UAmC9C;IAEK,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;eArClD,MAAM;UAsF9C;CACF"}

package/dist/vector/PostgresVectorStorage.d.ts

@@ -1,39 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import type { Pool } from "@workglow/storage/postgres";
-import type { DataPortSchemaObject, FromSchema, TypedArray, TypedArrayConstructor, TypedArraySchemaOptions } from "@workglow/util/schema";
-import { PostgresTabularStorage } from "../tabular/PostgresTabularStorage";
-import type { HybridSearchOptions, IVectorStorage, VectorSearchOptions } from "./IVectorStorage";
-export declare class PostgresVectorStorage<Schema extends DataPortSchemaObject, PrimaryKeyNames extends ReadonlyArray<keyof Schema["properties"]>, Metadata extends Record<string, unknown> = Record<string, unknown>, Entity = FromSchema<Schema, TypedArraySchemaOptions>> extends PostgresTabularStorage<Schema, PrimaryKeyNames, Entity> implements IVectorStorage<Metadata, Schema, Entity, PrimaryKeyNames> {
-    private vectorDimensions;
-    private readonly vectorCtor;
-    private vectorPropertyName;
-    private metadataPropertyName;
-    /**
-     * Creates a new PostgreSQL vector repository
-     * @param db - PostgreSQL connection pool
-     * @param table - The name of the table to use for storage
-     * @param schema - The schema definition for the entity
-     * @param primaryKeyNames - Array of property names that form the primary key
-     * @param indexes - Array of columns or column arrays to make searchable
-     * @param dimensions - The number of dimensions of the vector
-     * @param vectorCtor - TypedArray constructor used when hydrating vectors from SQL text (e.g. {@link Float32Array})
-     */
-    constructor(db: Pool, table: string, schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes: readonly (keyof NoInfer<Entity> | readonly (keyof NoInfer<Entity>)[])[] | undefined, dimensions: number, vectorCtor?: TypedArrayConstructor);
-    getVectorDimensions(): number;
-    similaritySearch(query: TypedArray, options?: VectorSearchOptions<Metadata>): Promise<Array<Entity & {
-        score: number;
-    }>>;
-    hybridSearch(query: TypedArray, options: HybridSearchOptions<Metadata>): Promise<(Entity & {
-        score: number;
-    })[]>;
-    private searchFallback;
-    private hybridSearchFallback;
-    private getPrimaryKeyWhereClause;
-    private getPrimaryKeyValues;
-    private matchesFilter;
-}
-//# sourceMappingURL=PostgresVectorStorage.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"PostgresVectorStorage.d.ts","sourceRoot":"","sources":["../../src/vector/PostgresVectorStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,KAAK,EACV,oBAAoB,EACpB,UAAU,EACV,UAAU,EACV,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAqBjG,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,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,QAAQ,CAAC,UAAU,CAAwB;IACnD,OAAO,CAAC,kBAAkB,CAAe;IACzC,OAAO,CAAC,oBAAoB,CAA2B;IAEvD;;;;;;;;;OASG;IACH,YACE,EAAE,EAAE,IAAI,EACR,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,eAAe,EAChC,OAAO,EAAE,SAAS,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,YAAK,EACrF,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,qBAAoC,EAcjD;IAEe,mBAAmB,IAAI,MAAM,CAE5C;IAEY,gBAAgB,CAC3B,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,mBAAmB,CAAC,QAAQ,CAAM,GAC1C,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAwE5C;IAEK,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,mBAAmB,CAAC,QAAQ,CAAC;eA1EzC,MAAM;UA8JxC;YAKa,cAAc;YA+Bd,oBAAoB;IA8ClC,OAAO,CAAC,wBAAwB;IAKhC,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,aAAa;CAQtB"}

package/dist/vector/SqliteAiVectorStorage.d.ts

@@ -1,100 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import { Sqlite } from "@workglow/storage/sqlite";
-import type { DataPortSchemaObject, FromSchema, TypedArray, TypedArrayConstructor, TypedArraySchemaOptions } from "@workglow/util/schema";
-import { SqliteTabularStorage } from "../tabular/SqliteTabularStorage";
-import type { HybridSearchOptions, IVectorStorage, VectorSearchOptions } from "./IVectorStorage";
-/**
- * SQLite vector storage implementation using the @sqliteai/sqlite-vector extension.
- * Provides native vector similarity search via SQLite virtual table functions
- * instead of in-memory brute-force search.
- *
- * Requirements:
- * - @sqliteai/sqlite-vector package installed
- * - Extension loaded via db.loadExtension(getExtensionPath())
- *
- * Vectors are stored as BLOBs using sqlite-vector encoding functions (vector_as_f32, etc.)
- * and searched using vector_full_scan for efficient KNN queries.
- *
- * @template Schema - The schema for the vector storage
- * @template PrimaryKeyNames - The primary key names
- * @template VectorCtor - Constructor for stored vectors (default {@link typeof Float32Array})
- * @template Metadata - The metadata type
- */
-export declare class SqliteAiVectorStorage<Schema extends DataPortSchemaObject, PrimaryKeyNames extends ReadonlyArray<keyof Schema["properties"]>, Metadata extends Record<string, unknown> | undefined = Record<string, unknown>, Entity = FromSchema<Schema, TypedArraySchemaOptions>> extends SqliteTabularStorage<Schema, PrimaryKeyNames, Entity> implements IVectorStorage<Metadata, Schema, Entity, PrimaryKeyNames> {
-    private vectorDimensions;
-    private readonly vectorCtor;
-    private vectorPropertyName;
-    private metadataPropertyName;
-    private vectorTypeSuffix;
-    private extensionLoaded;
-    /**
-     * Creates a new SQLite AI vector storage
-     * @param dbOrPath - Either a Database instance or a path to the SQLite database file
-     * @param table - The name of the table to use for storage
-     * @param schema - The schema for the entity
-     * @param primaryKeyNames - Array of property names forming the primary key
-     * @param indexes - Array of columns to index
-     * @param dimensions - The number of dimensions of the vector
-     * @param vectorCtor - TypedArray constructor for stored vectors (e.g. {@link Float32Array})
-     */
-    constructor(dbOrPath: string | Sqlite.Database, table: string | undefined, schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes: readonly (keyof NoInfer<Entity> | readonly (keyof NoInfer<Entity>)[])[] | undefined, dimensions: number, vectorCtor?: TypedArrayConstructor);
-    getVectorDimensions(): number;
-    /**
-     * Load the sqlite-vector extension and initialize vector indexing on the vector column.
-     * Extension loading is best-effort: if unavailable, operations fall back to in-memory search.
-     */
-    setupDatabase(): Promise<void>;
-    /**
-     * Encode a vector as a BLOB using sqlite-vector functions.
-     * Returns a JSON string representation suitable for vector_as_f32() etc.
-     */
-    private encodeVectorJson;
-    /**
-     * Decode a vector BLOB from SQLite back to a TypedArray.
-     * sqlite-vector stores vectors as BLOBs, but when we SELECT them
-     * they come back as Buffer/Uint8Array. We also handle JSON string fallback.
-     */
-    private decodeVector;
-    /**
-     * Override jsToSqlValue to encode vectors as BLOBs via sqlite-vector functions
-     */
-    protected jsToSqlValue(column: string, value: Entity[keyof Entity]): ReturnType<SqliteTabularStorage<Schema, PrimaryKeyNames, Entity>["jsToSqlValue"]>;
-    /**
-     * Override sqlToJsValue to decode vector BLOBs back to TypedArrays
-     */
-    protected sqlToJsValue(column: string, value: any): Entity[keyof Entity];
-    /**
-     * Override mapTypeToSQL to use BLOB for vector columns instead of TEXT
-     */
-    protected mapTypeToSQL(typeDef: any): string;
-    /**
-     * Override put to use sqlite-vector encoding for vector data.
-     * Builds a custom INSERT OR REPLACE that wraps the vector column
-     * with vector_as_fXX() to encode as a native vector BLOB.
-     * Falls back to base class put() if the extension is not available.
-     */
-    put(entity: any): Promise<Entity>;
-    /**
-     * Perform similarity search using sqlite-vector's vector_full_scan.
-     * Uses native COSINE distance computation in SQLite rather than in-memory JS.
-     * Falls back to in-memory search if the extension is unavailable.
-     */
-    similaritySearch(query: TypedArray, options?: VectorSearchOptions<Metadata>): Promise<(Entity & {
-        score: number;
-    })[]>;
-    /**
-     * Hybrid search combining vector similarity with text relevance.
-     * Uses sqlite-vector for the vector component and keyword matching for text.
-     * Falls back to in-memory search if the extension is unavailable.
-     */
-    hybridSearch(query: TypedArray, options: HybridSearchOptions<Metadata>): Promise<(Entity & {
-        score: number;
-    })[]>;
-    private searchFallback;
-    private hybridSearchFallback;
-}
-//# sourceMappingURL=SqliteAiVectorStorage.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"SqliteAiVectorStorage.d.ts","sourceRoot":"","sources":["../../src/vector/SqliteAiVectorStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,KAAK,EACV,oBAAoB,EACpB,UAAU,EACV,UAAU,EACV,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAwDjG;;;;;;;;;;;;;;;;GAgBG;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,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9E,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAEpD,SAAQ,oBAAoB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,CAC5D,YAAW,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC;IAEpE,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwB;IACnD,OAAO,CAAC,kBAAkB,CAAe;IACzC,OAAO,CAAC,oBAAoB,CAA2B;IACvD,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,eAAe,CAAkB;IAEzC;;;;;;;;;OASG;IACH,YACE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,QAAQ,EAClC,KAAK,EAAE,MAAM,YAAY,EACzB,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,eAAe,EAChC,OAAO,EAAE,SAAS,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,YAAK,EACrF,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,qBAAoC,EAejD;IAED,mBAAmB,IAAI,MAAM,CAE5B;IAED;;;OAGG;IACmB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAsCnD;IAED;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IA8BpB;;OAEG;IACH,UAAmB,YAAY,CAC7B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,CAAC,MAAM,MAAM,CAAC,GAC1B,UAAU,CAAC,oBAAoB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC,CAOnF;IAED;;OAEG;IACH,UAAmB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,MAAM,CAAC,CAKhF;IAED;;OAEG;IACH,UAAmB,YAAY,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM,CAQpD;IAED;;;;;OAKG;IACmB,GAAG,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAwGtD;IAED;;;;OAIG;IACG,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,mBAAmB,CAAC,QAAQ,CAAM;eA+BxC,MAAM;UAqElD;IAED;;;;OAIG;IACG,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,mBAAmB,CAAC,QAAQ,CAAC;eA5E/B,MAAM;UAiKlD;YAKa,cAAc;YA6Bd,oBAAoB;CA2CnC"}

package/dist/vector/SqliteVectorStorage.d.ts

@@ -1,49 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import { Sqlite } from "@workglow/storage/sqlite";
-import type { DataPortSchemaObject, FromSchema, TypedArray, TypedArrayConstructor, TypedArraySchemaOptions } from "@workglow/util/schema";
-import { SqliteTabularStorage } from "../tabular/SqliteTabularStorage";
-import type { HybridSearchOptions, IVectorStorage, VectorSearchOptions } from "./IVectorStorage";
-/**
- * SQLite vector repository implementation using tabular storage underneath.
- * Stores vectors as JSON-encoded arrays with metadata.
- *
- * @template Schema - The schema for the vector
- * @template PrimaryKeyNames - The primary key names for the vector
- * @template VectorCtor - Constructor for stored vectors (default {@link typeof Float32Array})
- * @template Metadata - The metadata type for the vector
- * @template Entity - The entity type for the vector
- */
-export declare class SqliteVectorStorage<Schema extends DataPortSchemaObject, PrimaryKeyNames extends ReadonlyArray<keyof Schema["properties"]>, Metadata extends Record<string, unknown> | undefined = Record<string, unknown>, Entity = FromSchema<Schema, TypedArraySchemaOptions>> extends SqliteTabularStorage<Schema, PrimaryKeyNames, Entity> implements IVectorStorage<Metadata, Schema, Entity, PrimaryKeyNames> {
-    private vectorDimensions;
-    private readonly vectorCtor;
-    private vectorPropertyName;
-    private metadataPropertyName;
-    /**
-     * Creates a new SQLite vector repository
-     * @param dbOrPath - Either a Database instance or a path to the SQLite database file
-     * @param table - The name of the table to use for storage (defaults to 'vectors')
-     * @param schema - The schema for the entity
-     * @param primaryKeyNames - Array of property names forming the primary key
-     * @param indexes - Array of columns to index
-     * @param dimensions - The number of dimensions of the vector
-     * @param vectorCtor - TypedArray constructor used when deserializing JSON vectors (e.g. {@link Float32Array})
-     */
-    constructor(dbOrPath: string | Sqlite.Database, table: string | undefined, schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes: readonly (keyof NoInfer<Entity> | readonly (keyof NoInfer<Entity>)[])[] | undefined, dimensions: number, vectorCtor?: TypedArrayConstructor);
-    getVectorDimensions(): number;
-    /**
-     * Deserialize vector from JSON string
-     * Defaults to Float32Array for compatibility with typical embedding vectors
-     */
-    private deserializeVector;
-    similaritySearch(query: TypedArray, options?: VectorSearchOptions<Metadata>): Promise<(Entity & {
-        score: number;
-    })[]>;
-    hybridSearch(query: TypedArray, options: HybridSearchOptions<Metadata>): Promise<(Entity & {
-        score: number;
-    })[]>;
-}
-//# sourceMappingURL=SqliteVectorStorage.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"SqliteVectorStorage.d.ts","sourceRoot":"","sources":["../../src/vector/SqliteVectorStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,KAAK,EACV,oBAAoB,EACpB,UAAU,EACV,UAAU,EACV,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAejG;;;;;;;;;GASG;AACH,qBAAa,mBAAmB,CAC9B,MAAM,SAAS,oBAAoB,EACnC,eAAe,SAAS,aAAa,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC,EACjE,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9E,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAEpD,SAAQ,oBAAoB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,CAC5D,YAAW,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC;IAEpE,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwB;IACnD,OAAO,CAAC,kBAAkB,CAAe;IACzC,OAAO,CAAC,oBAAoB,CAA2B;IAEvD;;;;;;;;;OASG;IACH,YACE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,QAAQ,EAClC,KAAK,EAAE,MAAM,YAAY,EACzB,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,eAAe,EAChC,OAAO,EAAE,SAAS,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,YAAK,EACrF,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,qBAAoC,EAcjD;IAED,mBAAmB,IAAI,MAAM,CAE5B;IAED;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAMnB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,mBAAmB,CAAC,QAAQ,CAAM;eAE5C,MAAM;UAoC9C;IAEK,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,mBAAmB,CAAC,QAAQ,CAAC;eAtCnC,MAAM;UAqG9C;CACF"}

package/src/queue/README.md

@@ -1,41 +0,0 @@
-# ELLMERS Queue Storage Package
-
-This is not a job queue implementation. It is a storage implementation for job queues. See the [@workglow/job-queue](../../../job-queue/README.md) package for a job queue implementation that uses these storage implementations.
-
-- [Features](#features)
-- [Performance Considerations](#performance-considerations)
-- [Job Lifecycle](#job-lifecycle)
-
-## Features
-
-- Multiple storage implementations:
-  - `InMemoryQueueStorage` - Volatile memory (dev/testing)
-  - `IndexedDbQueueStorage` - Browser-based storage
-  - `SqliteQueueStorage` - Embedded SQLite (pass a `Sqlite.Database` from `@workglow/storage/sqlite`; call `await Sqlite.init()` before opening the DB)
-  - `PostgresQueueStorage` - Production-grade PostgreSQL
-- Job lifecycle management:
-  - PENDING → PROCESSING → COMPLETED/FAILED/ABORTED
-  - PENDING → DISABLED
-  - Automatic retry mechanisms
-  - Progress tracking with message/details
-- Fingerprint-based input deduplication
-- Transactional operations with SKIP LOCKED
-- Job expiration policies
-
-## Performance Considerations
-
-1. **IndexedDB**: Best for client-side applications with <10k jobs
-2. **SQLite**: Ideal for single-process applications
-3. **PostgreSQL**: Recommended for distributed systems with high throughput
-4. **In-Memory**: Suitable for testing/development only
-
-## Job Lifecycle
-
-1. Jobs start as `PENDING`
-2. Acquired via `next()` → `PROCESSING`
-3. Final states:
-   - `COMPLETED`: Successful execution
-   - `FAILED`: Unrecoverable error
-   - `ABORTED`: Manual cancellation
-   - `DISABLED`: Disabled due to conditions not met
-   - Auto-retried while `PENDING` if within retry limits