@workglow/storage 0.0.52

package/dist/tabular/BaseSqlTabularRepository.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DataPortSchemaObject, FromSchema, JsonSchema } from "@workglow/util";
+import { ValueOptionType } from "./ITabularRepository";
+import { TabularRepository } from "./TabularRepository";
+/**
+ * Base class for SQL-based tabular repositories that implements common functionality
+ * for both SQLite and PostgreSQL database implementations.
+ *
+ * @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 BaseSqlTabularRepository<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> {
+    protected readonly table: string;
+    /**
+     * Creates a new instance of BaseSqlTabularRepository
+     * @param table - The name of the database table to use for storage
+     * @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(table: string | undefined, schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes?: Array<keyof Entity | Array<keyof Entity>>);
+    /**
+     * Maps JavaScript/TypeScript types to their corresponding SQL type
+     * Must be implemented by derived classes for specific SQL dialects
+     */
+    protected abstract mapTypeToSQL(typeDef: JsonSchema): string;
+    /**
+     * Generates the SQL column definitions for primary key fields
+     * @returns SQL string containing primary key column definitions
+     */
+    protected constructPrimaryKeyColumns($delimiter?: string): string;
+    /**
+     * Generates the SQL column definitions for value fields
+     * @returns SQL string containing value column definitions
+     */
+    protected constructValueColumns($delimiter?: string): string;
+    /**
+     * Determines if a schema type allows null values
+     * @param typeDef - The schema type definition
+     * @returns true if the type allows null values
+     */
+    protected isNullable(typeDef: JsonSchema): boolean;
+    /**
+     * Returns a comma-separated list of primary key column names
+     * @returns Formatted string of primary key column names
+     */
+    protected primaryKeyColumnList($delimiter?: string): string;
+    /**
+     * Returns a comma-separated list of value column names
+     * @returns Formatted string of value column names
+     */
+    protected valueColumnList($delimiter?: string): string;
+    /**
+     * Gets the real underlying type from possibly union types
+     * For example, for a union with null, this extracts the non-null type
+     * @param typeDef - The schema to extract from
+     * @returns The non-null type from the schema
+     */
+    protected getNonNullType(typeDef: JsonSchema): JsonSchema;
+    /**
+     * Converts a value object into an ordered array based on the valueSchema
+     * This ensures consistent parameter ordering for SQL queries
+     * @param value - The value object to convert
+     * @returns Array of values ordered according to the schema
+     * @throws Error if a required field is missing
+     */
+    protected getValueAsOrderedArray(value: Value): ValueOptionType[];
+    /**
+     * 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[];
+    protected jsToSqlValue(column: string, value: Entity[keyof Entity]): ValueOptionType;
+    protected sqlToJsValue(column: string, value: ValueOptionType): Entity[keyof Entity];
+    /**
+     * Validates table name and schema configurations
+     * Checks for:
+     * 1. Valid table name format
+     * 2. Valid schema key names
+     * 3. No duplicate keys between primary key and value schemas
+     * This is a sanity check to make sure the table and schema are valid,
+     * and to prevent dumb mistakes and mischevious behavior.
+     * @throws Error if validation fails
+     */
+    protected validateTableAndSchema(): void;
+}
+//# sourceMappingURL=BaseSqlTabularRepository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BaseSqlTabularRepository.d.ts","sourceRoot":"","sources":["../../src/tabular/BaseSqlTabularRepository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAIxD;;;;;;GAMG;AACH,8BAAsB,wBAAwB,CAC5C,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;IAU3E,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM;IATlC;;;;;;;OAOG;gBAEkB,KAAK,EAAE,MAAM,YAAkB,EAClD,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE,KAAK,CAAC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,MAAM,CAAC,CAAM;IAMzD;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM;IAE5D;;;OAGG;IACH,SAAS,CAAC,0BAA0B,CAAC,UAAU,GAAE,MAAW,GAAG,MAAM;IAUrE;;;OAGG;IACH,SAAS,CAAC,qBAAqB,CAAC,UAAU,GAAE,MAAW,GAAG,MAAM;IAkBhE;;;;OAIG;IACH,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO;IA0BlD;;;OAGG;IACH,SAAS,CAAC,oBAAoB,CAAC,UAAU,GAAE,MAAW,GAAG,MAAM;IAI/D;;;OAGG;IACH,SAAS,CAAC,eAAe,CAAC,UAAU,GAAE,MAAW,GAAG,MAAM;IAI1D;;;;;OAKG;IACH,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU;IAkBzD;;;;;;OAMG;IACH,SAAS,CAAC,sBAAsB,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe,EAAE;IAyBjE;;;;;OAKG;IACH,SAAS,CAAC,2BAA2B,CAAC,GAAG,EAAE,UAAU,GAAG,eAAe,EAAE;IAiBzE,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,MAAM,CAAC,GAAG,eAAe;IAqCpF,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,MAAM,CAAC;IAgCpF;;;;;;;;;OASG;IACH,SAAS,CAAC,sBAAsB,IAAI,IAAI;CAgCzC"}

package/dist/tabular/CachedTabularRepository.d.ts

@@ -0,0 +1,110 @@
+/**
+ * @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 CACHED_TABULAR_REPOSITORY: import("@workglow/util").ServiceToken<ITabularRepository<any, any, any, any, any>>;
+/**
+ * A tabular repository wrapper that adds caching layer to a durable repository.
+ * Uses InMemoryTabularRepository or SharedInMemoryTabularRepository as a cache
+ * for faster access to frequently used data.
+ *
+ * @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 CachedTabularRepository<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> {
+    readonly cache: ITabularRepository<Schema, PrimaryKeyNames, Entity, PrimaryKey, Value>;
+    private durable;
+    private cacheInitialized;
+    /**
+     * Creates a new CachedTabularRepository instance
+     * @param durable - The durable repository to use as the source of truth
+     * @param cache - Optional cache repository (InMemoryTabularRepository or SharedInMemoryTabularRepository).
+     *                 If not provided, a new InMemoryTabularRepository will be created.
+     * @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(durable: ITabularRepository<Schema, PrimaryKeyNames, Entity, PrimaryKey, Value>, cache?: ITabularRepository<Schema, PrimaryKeyNames, Entity, PrimaryKey, Value>, schema?: Schema, primaryKeyNames?: PrimaryKeyNames, indexes?: Array<keyof Entity | Array<keyof Entity>>);
+    /**
+     * Sets up event forwarding from cache and durable repositories
+     */
+    private setupEventForwarding;
+    /**
+     * Initializes the cache by loading all data from the durable repository
+     */
+    private initializeCache;
+    /**
+     * Stores a key-value pair in both cache and durable 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 both cache and durable repository
+     * @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, checking cache first, then durable repository
+     * @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 from both cache and durable repository
+     * @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 both cache and durable 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>;
+    /**
+     * Invalidates the cache by clearing it and resetting initialization flag
+     */
+    invalidateCache(): Promise<void>;
+    /**
+     * Refreshes the cache by reloading all data from the durable repository
+     */
+    refreshCache(): Promise<void>;
+    /**
+     * Destroys the durable and cache repositories.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=CachedTabularRepository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CachedTabularRepository.d.ts","sourceRoot":"","sources":["../../src/tabular/CachedTabularRepository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAsB,oBAAoB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,eAAO,MAAM,yBAAyB,oFAED,CAAC;AAEtC;;;;;;;GAOG;AACH,qBAAa,uBAAuB,CAClC,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,SAAgB,KAAK,EAAE,kBAAkB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IAC9F,OAAO,CAAC,OAAO,CAAyE;IACxF,OAAO,CAAC,gBAAgB,CAAS;IAEjC;;;;;;;;;OASG;gBAED,OAAO,EAAE,kBAAkB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,EAC/E,KAAK,CAAC,EAAE,kBAAkB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,EAC9E,MAAM,CAAC,EAAE,MAAM,EACf,eAAe,CAAC,EAAE,eAAe,EACjC,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,MAAM,CAAC,CAAC;IA+BrD;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmB5B;;OAEG;YACW,eAAe;IAe7B;;;;;OAKG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYzC;;;;;OAKG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAYlD;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAiBvD;;;;;OAKG;IACG,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC;IAiBjE;;;;OAIG;IACG,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvD;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAUhC;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC;IAiB7C;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAO7B;;;;;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;IAUhB;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAMnC;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB"}

package/dist/tabular/FsFolderTabularRepository.d.ts

@@ -0,0 +1,92 @@
+/**
+ * @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 FS_FOLDER_TABULAR_REPOSITORY: import("@workglow/util").ServiceToken<ITabularRepository<any, any, any, any, any>>;
+/**
+ * A tabular repository implementation that uses the filesystem for storage.
+ * Each row is stored as a separate JSON file in the specified directory.
+ *
+ * @template Schema - The schema definition for the entity
+ * @template PrimaryKeyNames - Array of property names that form the primary key
+ */
+export declare class FsFolderTabularRepository<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 folderPath;
+    /**
+     * Creates a new FsFolderTabularRepository instance.
+     *
+     * @param folderPath - The directory path where the JSON files will be stored
+     * @param schema - Schema defining the structure of the entity
+     * @param primaryKeyNames - Array of property names that form the primary key
+     * @param indexes - Note: indexes are not supported in this implementation.
+     */
+    constructor(folderPath: string, schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes?: Array<keyof Entity | Array<keyof Entity>>);
+    /**
+     * Sets up the directory for the repository (creates directory)
+     */
+    setupDirectory(): Promise<void>;
+    /**
+     * Stores a row in the repository
+     * @param entity - The entity to store
+     * @returns The stored entity
+     * @emits 'put' event when successful
+     */
+    put(entity: Entity): Promise<Entity>;
+    /**
+     * Stores multiple rows in the repository in a bulk operation
+     * @param entities - Array of entities to store
+     * @returns Array of stored entities
+     * @emits 'put' event for each entity stored
+     */
+    putBulk(entities: 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>;
+    /**
+     * Deletes an entry by its key
+     * @param key - The primary key object of the entry to delete
+     * @emits 'delete' event with the fingerprint ID when successful
+     */
+    delete(value: PrimaryKey | Entity): Promise<void>;
+    /**
+     * Retrieves all rows stored in the repository
+     * @returns Array of combined objects (rows) if found, undefined otherwise
+     */
+    getAll(): Promise<Entity[] | undefined>;
+    /**
+     * Removes all entries from the repository
+     * @emits 'clearall' event when successful
+     */
+    deleteAll(): Promise<void>;
+    /**
+     * Returns the total number of stored rows
+     * @returns Promise resolving to the count of stored items
+     */
+    size(): Promise<number>;
+    /**
+     * Search is not supported in the filesystem implementation.
+     * @throws {Error} Always throws an error indicating search is not supported
+     */
+    search(key: Partial<Entity>): Promise<Entity[] | undefined>;
+    /**
+     * Generates the full filesystem path for a given key.
+     * @private
+     */
+    private getFilePath;
+    /**
+     * 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=FsFolderTabularRepository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FsFolderTabularRepository.d.ts","sourceRoot":"","sources":["../../src/tabular/FsFolderTabularRepository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAsB,oBAAoB,EAAE,UAAU,EAAS,MAAM,gBAAgB,CAAC;AAG7F,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,eAAO,MAAM,4BAA4B,oFAEF,CAAC;AAExC;;;;;;GAMG;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,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC;IAC7E,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;OAOG;gBAED,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE,KAAK,CAAC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,MAAM,CAAC,CAAM;IAMzD;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAcrC;;;;;OAKG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkB1C;;;;;OAKG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKpD;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAevD;;;;OAIG;IACG,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvD;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC;IA4B7C;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAOhC;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAQ7B;;;OAGG;IACG,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC;IAIjE;;;OAGG;YACW,WAAW;IAOzB;;;;;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;CAGjB"}

package/dist/tabular/ITabularRepository.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DataPortSchemaObject, EventParameters, FromSchema } from "@workglow/util";
+export type ValueOptionType = string | number | bigint | boolean | null | Uint8Array;
+/**
+ * Type definitions for tabular repository events
+ */
+export type TabularEventListeners<PrimaryKey, Entity> = {
+    put: (entity: Entity) => void;
+    get: (key: PrimaryKey, entity: Entity | undefined) => void;
+    search: (key: Partial<Entity>, entities: Entity[] | undefined) => void;
+    delete: (key: keyof Entity) => void;
+    clearall: () => void;
+};
+export type TabularEventName = keyof TabularEventListeners<any, any>;
+export type TabularEventListener<Event extends TabularEventName, PrimaryKey, Entity> = TabularEventListeners<PrimaryKey, Entity>[Event];
+export type TabularEventParameters<Event extends TabularEventName, PrimaryKey, Entity> = EventParameters<TabularEventListeners<PrimaryKey, Entity>, Event>;
+export type uuid4 = string;
+export type JSONValue = string | number | boolean | null | JSONValue[] | {
+    [key: string]: JSONValue;
+};
+/**
+ * Interface defining the contract for tabular storage repositories.
+ * Provides a flexible interface for storing and retrieving data with typed
+ * primary keys and values, and supports compound keys and partial key lookup.
+ *
+ * @typeParam Schema - The schema definition for the entity using JSON Schema
+ * @typeParam PrimaryKeyNames - Array of property names that form the primary key
+ */
+export interface ITabularRepository<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>> {
+    put(value: Entity): Promise<Entity>;
+    putBulk(values: Entity[]): Promise<Entity[]>;
+    get(key: PrimaryKey): Promise<Entity | undefined>;
+    delete(key: PrimaryKey | Entity): Promise<void>;
+    getAll(): Promise<Entity[] | undefined>;
+    deleteAll(): Promise<void>;
+    size(): Promise<number>;
+    deleteSearch(column: keyof Entity, value: Entity[keyof Entity], operator: "=" | "<" | "<=" | ">" | ">="): Promise<void>;
+    on<Event extends TabularEventName>(name: Event, fn: TabularEventListener<Event, PrimaryKey, Entity>): void;
+    off<Event extends TabularEventName>(name: Event, fn: TabularEventListener<Event, PrimaryKey, Entity>): void;
+    emit<Event extends TabularEventName>(name: Event, ...args: TabularEventParameters<Event, PrimaryKey, Entity>): void;
+    once<Event extends TabularEventName>(name: Event, fn: TabularEventListener<Event, PrimaryKey, Entity>): void;
+    waitOn<Event extends TabularEventName>(name: Event): Promise<TabularEventParameters<Event, PrimaryKey, Entity>>;
+    search(key: Partial<Entity>): Promise<Entity[] | undefined>;
+    destroy(): void;
+    [Symbol.dispose](): void;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=ITabularRepository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ITabularRepository.d.ts","sourceRoot":"","sources":["../../src/tabular/ITabularRepository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGnF,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,UAAU,CAAC;AAErF;;GAEG;AACH,MAAM,MAAM,qBAAqB,CAAC,UAAU,EAAE,MAAM,IAAI;IACtD,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,GAAG,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAC3D,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,KAAK,IAAI,CAAC;IACvE,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,MAAM,KAAK,IAAI,CAAC;IACpC,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,MAAM,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACrE,MAAM,MAAM,oBAAoB,CAC9B,KAAK,SAAS,gBAAgB,EAC9B,UAAU,EACV,MAAM,IACJ,qBAAqB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;AAErD,MAAM,MAAM,sBAAsB,CAChC,KAAK,SAAS,gBAAgB,EAC9B,UAAU,EACV,MAAM,IACJ,eAAe,CAAC,qBAAqB,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;AAGtE,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC;AAC3B,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEjC;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB,CACjC,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;IAG5D,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAClD,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACxC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,YAAY,CACV,MAAM,EAAE,MAAM,MAAM,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,MAAM,CAAC,EAC3B,QAAQ,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC,CAAC;IAGjB,EAAE,CAAC,KAAK,SAAS,gBAAgB,EAC/B,IAAI,EAAE,KAAK,EACX,EAAE,EAAE,oBAAoB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,GAClD,IAAI,CAAC;IACR,GAAG,CAAC,KAAK,SAAS,gBAAgB,EAChC,IAAI,EAAE,KAAK,EACX,EAAE,EAAE,oBAAoB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,GAClD,IAAI,CAAC;IACR,IAAI,CAAC,KAAK,SAAS,gBAAgB,EACjC,IAAI,EAAE,KAAK,EACX,GAAG,IAAI,EAAE,sBAAsB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,GACzD,IAAI,CAAC;IACR,IAAI,CAAC,KAAK,SAAS,gBAAgB,EACjC,IAAI,EAAE,KAAK,EACX,EAAE,EAAE,oBAAoB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,GAClD,IAAI,CAAC;IACR,MAAM,CAAC,KAAK,SAAS,gBAAgB,EACnC,IAAI,EAAE,KAAK,GACV,OAAO,CAAC,sBAAsB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IAG9D,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IAG5D,OAAO,IAAI,IAAI,CAAC;IAChB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IACzB,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC"}

package/dist/tabular/InMemoryTabularRepository.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @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 MEMORY_TABULAR_REPOSITORY: import("@workglow/util").ServiceToken<ITabularRepository<any, any, any, any, any>>;
+/**
+ * A generic in-memory key-value repository implementation.
+ * Provides a simple, non-persistent storage solution suitable for testing and caching scenarios.
+ *
+ * @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 InMemoryTabularRepository<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> {
+    /** Internal storage using a Map with fingerprint strings as keys */
+    values: Map<string, Entity>;
+    /**
+     * Creates a new InMemoryTabularRepository 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>>);
+    /**
+     * Sets up the database for the repository (no-op for in-memory)
+     */
+    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 key - The primary key object 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 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>;
+    /**
+     * Destroys the repository and frees up resources.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=InMemoryTabularRepository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryTabularRepository.d.ts","sourceRoot":"","sources":["../../src/tabular/InMemoryTabularRepository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEH,oBAAoB,EACpB,UAAU,EAEb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,eAAO,MAAM,yBAAyB,oFAEC,CAAC;AAExC;;;;;;GAMG;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,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC;IAC7E,oEAAoE;IACpE,MAAM,sBAA6B;IAEnC;;;;;;OAMG;gBAED,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE,KAAK,CAAC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,MAAM,CAAC,CAAM;IAKzD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC;;;;;OAKG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQzC;;;;;OAKG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIlD;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAOvD;;;;;OAKG;IACG,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC;IAiCjE;;;;OAIG;IACG,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvD;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAKhC;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC;IAK7C;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B;;;;;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;IA8BhB;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/tabular/IndexedDbTabularRepository.d.ts

@@ -0,0 +1,100 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DataPortSchemaObject, FromSchema } from "@workglow/util";
+import { MigrationOptions } from "../util/IndexedDbTable";
+import { ITabularRepository } from "./ITabularRepository";
+import { TabularRepository } from "./TabularRepository";
+export declare const IDB_TABULAR_REPOSITORY: import("@workglow/util").ServiceToken<ITabularRepository<any, any, any, any, any>>;
+/**
+ * A tabular repository implementation using IndexedDB for browser-based storage.
+ *
+ * @template Schema - The schema definition for the entity
+ * @template PrimaryKeyNames - Array of property names that form the primary key
+ */
+export declare class IndexedDbTabularRepository<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> {
+    table: string;
+    /** Promise that resolves to the IndexedDB database instance */
+    private db;
+    /** Migration options for database schema changes */
+    private migrationOptions;
+    /**
+     * Creates a new IndexedDB-based tabular repository.
+     * @param table - Name of the IndexedDB store to use.
+     * @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 migrationOptions - Options for handling database schema migrations
+     */
+    constructor(table: string | undefined, schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes?: Array<keyof Entity | Array<keyof Entity>>, migrationOptions?: MigrationOptions);
+    /**
+     * Sets up the IndexedDB database table with the required schema and indexes.
+     * Must be called before using any other methods.
+     */
+    setupDatabase(): Promise<IDBDatabase>;
+    /**
+     * Stores a row in the repository.
+     * @param record - The entity to store.
+     * @returns The stored entity
+     * @emits put - Emitted when the value is successfully stored
+     */
+    put(record: Entity): Promise<Entity>;
+    /**
+     * Stores multiple rows in the repository in a bulk operation.
+     * @param records - Array of entities to store.
+     * @returns Array of stored entities
+     * @emits put - Emitted for each record successfully stored
+     */
+    putBulk(records: Entity[]): Promise<Entity[]>;
+    protected getPrimaryKeyAsOrderedArray(key: PrimaryKey): (string | number | boolean | Uint8Array<ArrayBufferLike> | null)[];
+    private getIndexedKey;
+    /**
+     * Retrieves a value from the repository by its key.
+     * @param key - The key object.
+     * @returns The value object or undefined if not found.
+     * @emits get - Emitted when the value is successfully retrieved
+     */
+    get(key: PrimaryKey): Promise<Entity | undefined>;
+    /**
+     * Returns an array of all entries in the repository.
+     * @returns Array of all entries in the repository.
+     */
+    getAll(): Promise<Entity[] | undefined>;
+    /**
+     * Searches for records matching the specified partial query.
+     * It uses an appropriate index if one exists, or scans all records.
+     * @param key - Partial query object.
+     * @returns Array of matching records or undefined.
+     */
+    search(key: Partial<Entity>): Promise<Entity[] | undefined>;
+    /**
+     * Deletes a row from the repository.
+     * @param key - The key object to delete.
+     */
+    delete(key: PrimaryKey): Promise<void>;
+    /**
+     * Deletes all records from the repository.
+     * @emits clearall - Emitted when all values are deleted
+     */
+    deleteAll(): Promise<void>;
+    /**
+     * Returns the total number of rows in the repository.
+     * @returns Count of stored items.
+     */
+    size(): Promise<number>;
+    /**
+     * 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>;
+    /**
+     * Destroys this repository and frees up resources.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=IndexedDbTabularRepository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IndexedDbTabularRepository.d.ts","sourceRoot":"","sources":["../../src/tabular/IndexedDbTabularRepository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAsB,oBAAoB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAGH,gBAAgB,EACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,eAAO,MAAM,sBAAsB,oFAEK,CAAC;AAEzC;;;;;GAKG;AACH,qBAAa,0BAA0B,CACrC,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;IAgBpE,KAAK,EAAE,MAAM;IAftB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,CAA0B;IACpC,oDAAoD;IACpD,OAAO,CAAC,gBAAgB,CAAmB;IAE3C;;;;;;;;OAQG;gBAEM,KAAK,EAAE,MAAM,YAAkB,EACtC,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE,KAAK,CAAC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,MAAM,CAAC,CAAM,EACvD,gBAAgB,GAAE,gBAAqB;IAMzC;;;OAGG;IACU,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC;IAsClD;;;;;OAKG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkB1C;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAuCnD,SAAS,CAAC,2BAA2B,CAAC,GAAG,EAAE,UAAU;IAMrD,OAAO,CAAC,aAAa;IAOrB;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAmBvD;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC;IAc7C;;;;;OAKG;IACG,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC;IAsIjE;;;OAGG;IACG,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5C;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAchC;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAW7B;;;;;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;IAmIhB;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}