@workglow/storage 0.0.52

package/dist/tabular/PostgresTabularRepository.d.ts

@@ -0,0 +1,133 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DataPortSchemaObject, FromSchema, JsonSchema } from "@workglow/util";
+import type { Pool } from "pg";
+import { BaseSqlTabularRepository } from "./BaseSqlTabularRepository";
+import { ITabularRepository, ValueOptionType } from "./ITabularRepository";
+export declare const POSTGRES_TABULAR_REPOSITORY: import("@workglow/util").ServiceToken<ITabularRepository<any, any, any, any, any>>;
+/**
+ * A PostgreSQL-based tabular repository implementation that extends BaseSqlTabularRepository.
+ * 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;
+    private db;
+    /**
+     * Creates a new PostgresTabularRepository instance.
+     *
+     * @param db - PostgreSQL db
+     * @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.
+     */
+    constructor(db: Pool, table: string | undefined, schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes?: Array<keyof Entity | Array<keyof Entity>>);
+    /**
+     * Initializes the database table with the required schema.
+     * Creates the table if it doesn't exist with primary key and value columns.
+     */
+    setupDatabase(): Promise<Pool>;
+    /**
+     * 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
+     * @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 PostgreSQL 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
+     * @returns The entity with any server-generated fields updated
+     * @emits "put" event with the updated entity when successful
+     */
+    put(entity: Entity): Promise<Entity>;
+    /**
+     * Stores multiple rows in the database in a bulk operation.
+     * Uses batch INSERT with ON CONFLICT for better performance.
+     *
+     * @param entities - Array of entities to store
+     * @returns Array of entities with any server-generated fields updated
+     * @emits "put" event for each entity stored
+     */
+    putBulk(entities: Entity[]): Promise<Entity[]>;
+    /**
+     * Retrieves a value from the database by its primary key.
+     *
+     * @param key - The primary key object to look up
+     * @returns The stored value or undefined if not found
+     * @emits "get" event with the key when successful
+     */
+    get(key: PrimaryKey): Promise<Entity | undefined>;
+    /**
+     * Method to be implemented by concrete repositories to search for rows
+     * based on a partial key.
+     *
+     * @param key - Partial key to search for
+     * @returns Promise resolving to an array of combined row objects or undefined if not found
+     */
+    search(key: Partial<Entity>): Promise<Entity[] | undefined>;
+    /**
+     * Deletes a row from the database.
+     *
+     * @param key - The primary key object to delete
+     * @emits "delete" event with the key when successful
+     */
+    delete(value: PrimaryKey | Entity): Promise<void>;
+    /**
+     * Retrieves all entries from the database table
+     * @returns Promise resolving to an array of entries or undefined if not found
+     */
+    getAll(): 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>;
+    protected generateWhereClause(column: keyof Entity, operator?: "=" | "<" | "<=" | ">" | ">="): string;
+    /**
+     * Deletes all entries with a date column value older than the provided date
+     * @param column - The name of the date column to compare against
+     * @param value - The value to compare against
+     * @param operator - The operator to use for comparison
+     */
+    deleteSearch(column: keyof Entity, value: Entity[keyof Entity], operator?: "=" | "<" | "<=" | ">" | ">="): Promise<void>;
+}
+//# sourceMappingURL=PostgresTabularRepository.d.ts.map

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

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

package/dist/tabular/SharedInMemoryTabularRepository.d.ts

@@ -0,0 +1,126 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DataPortSchemaObject, FromSchema } from "@workglow/util";
+import { ITabularRepository } from "./ITabularRepository";
+import { TabularRepository } from "./TabularRepository";
+export declare const SHARED_IN_MEMORY_TABULAR_REPOSITORY: import("@workglow/util").ServiceToken<ITabularRepository<any, any, any, any, any>>;
+/**
+ * A tabular repository implementation that shares data across browser tabs/windows
+ * using BroadcastChannel API. Uses InMemoryTabularRepository 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> {
+    private channel;
+    private channelName;
+    private inMemoryRepo;
+    private isInitialized;
+    private syncInProgress;
+    /**
+     * Creates a new SharedInMemoryTabularRepository 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.
+     */
+    constructor(channelName: string | undefined, schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes?: Array<keyof Entity | Array<keyof Entity>>);
+    /**
+     * Checks if BroadcastChannel is available in the current environment
+     */
+    private isBroadcastChannelAvailable;
+    /**
+     * Initializes the BroadcastChannel and sets up message handlers
+     */
+    private initializeBroadcastChannel;
+    /**
+     * Sets up event forwarding from the internal InMemoryTabularRepository
+     */
+    private setupEventForwarding;
+    /**
+     * Handles incoming BroadcastChannel messages
+     */
+    private handleBroadcastMessage;
+    /**
+     * Requests synchronization from other tabs
+     */
+    private syncFromOtherTabs;
+    /**
+     * Copies data from an array of entities into the repository
+     */
+    private copyDataFromArray;
+    /**
+     * Broadcasts a message to other tabs
+     */
+    private broadcast;
+    /**
+     * Sets up the database for the repository (syncs from other tabs)
+     */
+    setupDatabase(): Promise<void>;
+    /**
+     * Stores a key-value pair in the repository
+     * @param value - The combined object to store
+     * @returns The stored entity
+     * @emits 'put' event with the stored entity when successful
+     */
+    put(value: Entity): 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[]>;
+    /**
+     * Retrieves a value by its key
+     * @param key - The primary key object to look up
+     * @returns The value object if found, undefined otherwise
+     * @emits 'get' event with the fingerprint ID and value when found
+     */
+    get(key: PrimaryKey): Promise<Entity | undefined>;
+    /**
+     * Searches for entries matching a partial key
+     * @param key - Partial key object to search for
+     * @returns Array of matching combined objects
+     * @throws Error if search criteria outside of searchable fields
+     */
+    search(key: Partial<Entity>): Promise<Entity[] | undefined>;
+    /**
+     * Deletes an entry by its key
+     * @param value - The primary key object or entity of the entry to delete
+     * @emits 'delete' event with the fingerprint ID when successful
+     */
+    delete(value: PrimaryKey | Entity): Promise<void>;
+    /**
+     * Removes all entries from the repository
+     * @emits 'clearall' event when successful
+     */
+    deleteAll(): Promise<void>;
+    /**
+     * Returns an array of all entries in the repository
+     * @returns Array of all entries in the repository
+     */
+    getAll(): Promise<Entity[] | undefined>;
+    /**
+     * Returns the number of entries in the repository
+     * @returns The total count of stored entries
+     */
+    size(): Promise<number>;
+    /**
+     * Deletes all entries with a date column value matching the provided criteria
+     * @param column - The name of the date column to compare against
+     * @param value - The value to compare against
+     * @param operator - The operator to use for comparison
+     */
+    deleteSearch(column: keyof Entity, value: Entity[keyof Entity], operator?: "=" | "<" | "<=" | ">" | ">="): Promise<void>;
+    /**
+     * Cleanup method to close the BroadcastChannel
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=SharedInMemoryTabularRepository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SharedInMemoryTabularRepository.d.ts","sourceRoot":"","sources":["../../src/tabular/SharedInMemoryTabularRepository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAsB,oBAAoB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,eAAO,MAAM,mCAAmC,oFAEH,CAAC;AAc9C;;;;;;;GAOG;AACH,qBAAa,+BAA+B,CAC1C,MAAM,SAAS,oBAAoB,EACnC,eAAe,SAAS,aAAa,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC,EAEjE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,EAC3B,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,EACjE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,CAC5D,SAAQ,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC;IAC7E,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAMlB;IACF,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAS;IAE/B;;;;;;;OAOG;gBAED,WAAW,EAAE,MAAM,YAAkB,EACrC,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE,KAAK,CAAC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,MAAM,CAAC,CAAM;IAmBzD;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAInC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAmBlC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;OAEG;YACW,sBAAsB;IAyDpC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;YACW,iBAAiB;IAU/B;;OAEG;IACH,OAAO,CAAC,SAAS;IAMjB;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAMpC;;;;;OAKG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOzC;;;;;OAKG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAOlD;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAKvD;;;;;OAKG;IACG,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC;IAKjE;;;;OAIG;IACG,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvD;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAMhC;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC;IAK7C;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAK7B;;;;;OAKG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,MAAM,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,MAAM,CAAC,EAC3B,QAAQ,GAAE,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAU,GAC5C,OAAO,CAAC,IAAI,CAAC;IAWhB;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB"}

package/dist/tabular/SqliteTabularRepository.d.ts

@@ -0,0 +1,110 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Sqlite } from "@workglow/sqlite";
+import { DataPortSchemaObject, FromSchema, JsonSchema } from "@workglow/util";
+import { BaseSqlTabularRepository } from "./BaseSqlTabularRepository";
+import { ITabularRepository, ValueOptionType } from "./ITabularRepository";
+export declare const SQLITE_TABULAR_REPOSITORY: import("@workglow/util").ServiceToken<ITabularRepository<any, any, any, any, any>>;
+/**
+ * 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> {
+    #private;
+    /** The SQLite database instance */
+    private db;
+    /**
+     * Creates a new SQLite key-value 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 '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.
+     */
+    constructor(dbOrPath: string | Sqlite.Database, table: string | undefined, schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes?: Array<keyof Entity | Array<keyof Entity>>);
+    /**
+     * Creates the database table if it doesn't exist with the defined schema
+     */
+    setupDatabase(): Promise<Sqlite.Database>;
+    /**
+     * Convert JS values to SQLite-compatible values. Ensures booleans are stored as 0/1.
+     */
+    protected jsToSqlValue(column: string, value: Entity[keyof Entity]): ValueOptionType;
+    /**
+     * Convert SQLite values to JS values. Ensures 0/1 become booleans where schema says boolean.
+     */
+    protected sqlToJsValue(column: string, value: ValueOptionType): Entity[keyof Entity];
+    /**
+     * Maps TypeScript/JavaScript types to their SQLite column type equivalents
+     * 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 definition
+     * @returns The corresponding SQLite column type
+     */
+    protected mapTypeToSQL(typeDef: JsonSchema): string;
+    /**
+     * Stores a key-value pair in the database
+     * @param entity - The entity to store
+     * @returns The entity with any server-generated fields updated
+     * @emits 'put' event when successful
+     */
+    put(entity: Entity): Promise<Entity>;
+    /**
+     * Stores multiple key-value pairs in the database in a bulk operation
+     * @param entities - Array of entities to store
+     * @returns Array of entities with any server-generated fields updated
+     * @emits 'put' event for each entity stored
+     */
+    putBulk(entities: Entity[]): Promise<Entity[]>;
+    /**
+     * Retrieves a value from the database by its key
+     * @param key - The primary key object to look up
+     * @returns The stored value or undefined if not found
+     * @emits 'get' event when successful
+     */
+    get(key: PrimaryKey): Promise<Entity | undefined>;
+    /**
+     * Method to be implemented by concrete repositories to search for key-value pairs
+     * based on a partial key.
+     *
+     * @param key - Partial key to search for
+     * @returns Promise resolving to an array of combined key-value objects or undefined if not found
+     */
+    search(key: Partial<Entity>): Promise<Entity[] | undefined>;
+    /**
+     * Deletes a key-value pair from the database
+     * @param key - The primary key object to delete
+     * @emits 'delete' event when successful
+     */
+    delete(key: PrimaryKey): Promise<void>;
+    /**
+     * Retrieves all entries from the database table
+     * @returns Promise resolving to an array of entries or undefined if not found
+     */
+    getAll(): Promise<Entity[] | undefined>;
+    /**
+     * Deletes all entries from the database table
+     * @emits 'clearall' event when successful
+     */
+    deleteAll(): Promise<void>;
+    /**
+     * Gets the total number of entries in the database table
+     * @returns The count of entries
+     */
+    size(): Promise<number>;
+    protected generateWhereClause(column: keyof Entity, operator?: "=" | "<" | "<=" | ">" | ">="): string;
+    /**
+     * Deletes all entries with a date column value older than the provided date
+     * @param column - The name of the date column to compare against
+     * @param value - The value to compare against
+     * @param operator - The operator to use for comparison
+     */
+    deleteSearch(column: keyof Entity, value: Entity[keyof Entity], operator?: "=" | "<" | "<=" | ">" | ">="): Promise<void>;
+}
+//# sourceMappingURL=SqliteTabularRepository.d.ts.map

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

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

package/dist/tabular/SupabaseTabularRepository.d.ts

@@ -0,0 +1,132 @@
+/**
+ * @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 } from "@workglow/util";
+import { BaseSqlTabularRepository } from "./BaseSqlTabularRepository";
+import { ITabularRepository, ValueOptionType } from "./ITabularRepository";
+export declare const SUPABASE_TABULAR_REPOSITORY: import("@workglow/util").ServiceToken<ITabularRepository<any, any, any, any, any>>;
+/**
+ * A Supabase-based tabular repository implementation that extends BaseSqlTabularRepository.
+ * 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> {
+    private client;
+    /**
+     * Creates a new SupabaseTabularRepository 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.
+     */
+    constructor(client: SupabaseClient, table: string | undefined, schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes?: Array<keyof Entity | Array<keyof Entity>>);
+    protected isSetup: boolean;
+    /**
+     * Initializes the database table with the required schema.
+     * Creates the table if it doesn't exist with primary key and value columns.
+     */
+    setupDatabase(): Promise<SupabaseClient>;
+    /**
+     * 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
+     * @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
+     * @returns The entity with any server-generated fields updated
+     * @emits "put" event with the updated entity when successful
+     */
+    put(entity: Entity): Promise<Entity>;
+    /**
+     * Stores multiple rows in the database in a bulk operation.
+     * Uses batch INSERT with ON CONFLICT for better performance.
+     *
+     * @param entities - Array of entities to store
+     * @returns Array of entities with any server-generated fields updated
+     * @emits "put" event for each entity stored
+     */
+    putBulk(entities: Entity[]): 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>;
+    /**
+     * Method to search for rows based on a partial key.
+     *
+     * @param searchCriteria - Partial entity to search for
+     * @returns Promise resolving to an array of entities or undefined if not found
+     */
+    search(searchCriteria: Partial<Entity>): 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
+     * @returns Promise resolving to an array of entries or undefined if not found
+     */
+    getAll(): 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>;
+    protected generateWhereClause(column: keyof Entity, operator?: "=" | "<" | "<=" | ">" | ">="): string;
+    /**
+     * Deletes all entries matching a search criteria
+     * @param column - The column name to compare against
+     * @param value - The value to compare against
+     * @param operator - The operator to use for comparison
+     */
+    deleteSearch(column: keyof Entity, value: Entity[keyof Entity], operator?: "=" | "<" | "<=" | ">" | ">="): Promise<void>;
+}
+//# sourceMappingURL=SupabaseTabularRepository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SupabaseTabularRepository.d.ts","sourceRoot":"","sources":["../../src/tabular/SupabaseTabularRepository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAsB,oBAAoB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAClG,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE3E,eAAO,MAAM,2BAA2B,oFAED,CAAC;AAExC;;;;;;;GAOG;AACH,qBAAa,yBAAyB,CACpC,MAAM,SAAS,oBAAoB,EACnC,eAAe,SAAS,aAAa,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC,EAEjE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,EAC3B,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,EACjE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,CAC5D,SAAQ,wBAAwB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC;IACpF,OAAO,CAAC,MAAM,CAAiB;IAE/B;;;;;;;;;OASG;gBAED,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,MAAM,YAAkB,EAC/B,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE,KAAK,CAAC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,MAAM,CAAC,CAAM;IAMzD,SAAS,CAAC,OAAO,UAAQ;IAEzB;;;OAGG;IACU,aAAa,IAAI,OAAO,CAAC,cAAc,CAAC;IA4DrD;;;;;;;OAOG;IACH,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM;IAgHnD;;;OAGG;IACH,SAAS,CAAC,0BAA0B,CAAC,UAAU,GAAE,MAAW,GAAG,MAAM;IAiBrE;;;OAGG;IACH,SAAS,CAAC,qBAAqB,CAAC,UAAU,GAAE,MAAW,GAAG,MAAM;IAyBhE;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,MAAM,CAAC;IA0BpF;;;;OAIG;IACH,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO;IAmBxD;;;;;;;OAOG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA+B1C;;;;;;;OAOG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAqCpD;;;;;;OAMG;IACG,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAiCvD;;;;;OAKG;IACU,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC;IAsDnF;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBvD;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC;IAmB7C;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAWhC;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAU7B,SAAS,CAAC,mBAAmB,CAC3B,MAAM,EAAE,MAAM,MAAM,EACpB,QAAQ,GAAE,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAU,GAC5C,MAAM;IAOT;;;;;OAKG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,MAAM,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,MAAM,CAAC,EAC3B,QAAQ,GAAE,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAU,GAC5C,OAAO,CAAC,IAAI,CAAC;CA4BjB"}

package/dist/tabular/TabularRepository.d.ts

@@ -0,0 +1,123 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DataPortSchemaObject, EventEmitter, FromSchema } from "@workglow/util";
+import { ITabularRepository, TabularEventListener, TabularEventListeners, TabularEventName, TabularEventParameters, ValueOptionType } from "./ITabularRepository";
+export declare const TABULAR_REPOSITORY: import("@workglow/util").ServiceToken<ITabularRepository<any, any, any, any, any>>;
+/**
+ * Abstract base class for tabular storage repositories.
+ * Provides functionality for storing and retrieving data with typed
+ * primary keys and values, and supports compound keys and partial key lookup.
+ * Has a basic event emitter for listening to repository events.
+ *
+ * @template Schema - The schema definition for the entity using JSON Schema
+ * @template PrimaryKeyNames - Array of property names that form the primary key
+ */
+export declare abstract class TabularRepository<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>> implements ITabularRepository<Schema, PrimaryKeyNames, Entity, PrimaryKey, Value> {
+    protected schema: Schema;
+    protected primaryKeyNames: PrimaryKeyNames;
+    /** Event emitter for repository events */
+    protected events: EventEmitter<TabularEventListeners<PrimaryKey, Entity>>;
+    protected indexes: Array<keyof Entity>[];
+    protected primaryKeySchema: DataPortSchemaObject;
+    protected valueSchema: DataPortSchemaObject;
+    /**
+     * Creates a new TabularRepository instance
+     * @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.
+     */
+    constructor(schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes?: Array<keyof Entity | Array<keyof Entity>>);
+    protected filterCompoundKeys(primaryKey: Array<keyof Entity>, potentialKeys: Array<keyof Entity>[]): Array<keyof Entity>[];
+    /**
+     * Adds an event listener for a specific event
+     * @param name The name of the event to listen for
+     * @param fn The callback function to execute when the event occurs
+     */
+    on<Event extends TabularEventName>(name: Event, fn: TabularEventListener<Event, PrimaryKey, Entity>): void;
+    /**
+     * Removes an event listener for a specific event
+     * @param name The name of the event to remove the listener from
+     * @param fn The callback function to remove
+     */
+    off<Event extends TabularEventName>(name: Event, fn: TabularEventListener<Event, PrimaryKey, Entity>): void;
+    /**
+     * Adds an event listener that will only be called once
+     * @param name The name of the event to listen for
+     * @param fn The callback function to execute when the event occurs
+     */
+    once<Event extends TabularEventName>(name: Event, fn: TabularEventListener<Event, PrimaryKey, Entity>): void;
+    /**
+     * Emits an event with the specified name and arguments
+     * @param name The name of the event to emit
+     * @param args The arguments to pass to the event listeners
+     */
+    emit<Event extends TabularEventName>(name: Event, ...args: TabularEventParameters<Event, PrimaryKey, Entity>): void;
+    /**
+     * Returns when the event was emitted (promise form of once)
+     * @param name The name of the event to check
+     * @returns true if the event has listeners, false otherwise
+     */
+    waitOn<Event extends TabularEventName>(name: Event): Promise<TabularEventParameters<Event, PrimaryKey, Entity>>;
+    /**
+     * Core abstract methods that must be implemented by concrete repositories
+     */
+    abstract put(value: Entity): Promise<Entity>;
+    abstract putBulk(values: Entity[]): Promise<Entity[]>;
+    abstract get(key: PrimaryKey): Promise<Entity | undefined>;
+    abstract delete(key: PrimaryKey | Entity): Promise<void>;
+    abstract getAll(): Promise<Entity[] | undefined>;
+    abstract deleteAll(): Promise<void>;
+    abstract size(): Promise<number>;
+    abstract deleteSearch(column: keyof Entity, value: Entity[keyof Entity], operator: "=" | "<" | "<=" | ">" | ">="): Promise<void>;
+    /**
+     * Abstract method to be implemented by concrete repositories to search for rows
+     * based on a partial key.
+     *
+     * @param key - Partial key to search for
+     * @returns Promise resolving to an array of combined row objects or undefined if not found
+     */
+    abstract search(key: Partial<Entity>): Promise<Entity[] | undefined>;
+    protected primaryKeyColumns(): Array<keyof PrimaryKey>;
+    protected valueColumns(): Array<keyof Value>;
+    /**
+     * Utility method to separate a combined object into its key and value components
+     * for storage.
+     * @param obj - Entity row object
+     * @returns Separated key and value objects
+     */
+    protected separateKeyValueFromCombined(obj: Entity): {
+        value: Value;
+        key: PrimaryKey;
+    };
+    /**
+     * Generates a consistent string identifier for a given key.
+     *
+     * @param key - Primary key to convert
+     * @returns Promise resolving to a string fingerprint of the key
+     */
+    protected getKeyAsIdString(key: PrimaryKey): Promise<string>;
+    /**
+     * Converts a primary key object into an ordered array based on the schema
+     * This ensures consistent parameter ordering for storage operations
+     * @param key - The primary key object to convert
+     * @returns Array of key values ordered according to the schema
+     */
+    protected getPrimaryKeyAsOrderedArray(key: PrimaryKey): ValueOptionType[];
+    /**
+     * Finds the best matching index for a set of search keys.
+     * @param unorderedSearchKey - Unordered array of keys being searched, can be reordered
+     * @returns Array of column names representing the best matching index, or undefined if no suitable index is found
+     */
+    findBestMatchingIndex(unorderedSearchKey: Array<keyof Entity>): Array<keyof Entity> | undefined;
+    /**
+     * Destroys the repository and frees up resources.
+     */
+    destroy(): void;
+    [Symbol.asyncDispose](): Promise<void>;
+    [Symbol.dispose](): void;
+}
+//# sourceMappingURL=TabularRepository.d.ts.map