@workglow/storage 0.0.52

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

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

package/dist/types.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./common-server";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC"}

package/dist/util/IndexedDbTable.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @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): 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

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

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@workglow/storage",
+  "type": "module",
+  "version": "0.0.52",
+  "description": "Storage abstraction layer for Workglow, supporting IndexedDB, PostgreSQL, and Supabase with unified interfaces.",
+  "scripts": {
+    "watch": "concurrently -c 'auto' 'bun:watch-*'",
+    "watch-browser": "bun build --watch --no-clear-screen --target=browser --sourcemap=external --packages=external --outdir ./dist ./src/browser.ts",
+    "watch-node": "bun build --watch --no-clear-screen --target=node --sourcemap=external --packages=external --outdir ./dist ./src/node.ts",
+    "watch-bun": "bun build --watch --no-clear-screen --target=bun --sourcemap=external --packages=external --outdir ./dist ./src/bun.ts",
+    "watch-types": "tsc --watch --preserveWatchOutput",
+    "build-package": "bun run build-clean && concurrently -c 'auto' -n 'browser,node,bun,types' 'bun run build-browser' 'bun run build-node' 'bun run build-bun' 'bun run build-types'",
+    "build-clean": "rm -fr dist/*",
+    "build-browser": "bun build --target=browser --sourcemap=external --packages=external --outdir ./dist ./src/browser.ts",
+    "build-node": "bun build --target=node --sourcemap=external --packages=external --outdir ./dist ./src/node.ts",
+    "build-bun": "bun build --target=bun --sourcemap=external --packages=external --outdir ./dist ./src/bun.ts",
+    "build-types": "rm -f tsconfig.tsbuildinfo && tsc",
+    "lint": "eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 0",
+    "test": "bun test",
+    "prepare": "node -e \"const pkg=require('./package.json');pkg.exports['.'].bun='./dist/bun.js';pkg.exports['.'].types='./dist/types.d.ts';require('fs').writeFileSync('package.json',JSON.stringify(pkg,null,2))\""
+  },
+  "peerDependencies": {
+    "@workglow/sqlite": "0.0.52",
+    "@workglow/util": "0.0.52",
+    "pg": "^8.16.3",
+    "@supabase/supabase-js": "^2.84.0"
+  },
+  "peerDependenciesMeta": {
+    "@workglow/sqlite": {
+      "optional": false
+    },
+    "@workglow/util": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@workglow/sqlite": "0.0.52",
+    "@workglow/util": "0.0.52",
+    "pg": "^8.16.3",
+    "@types/pg": "^8.15.5",
+    "@supabase/supabase-js": "^2.84.0",
+    "fake-indexeddb": "^6.2.4"
+  },
+  "exports": {
+    ".": {
+      "react-native": "./dist/browser.js",
+      "browser": "./dist/browser.js",
+      "bun": "./dist/bun.js",
+      "types": "./dist/types.d.ts",
+      "node": "./dist/node.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/kv/README.md

@@ -0,0 +1,159 @@
+# Key-Value Storage Module
+
+A flexible key-value storage solution with multiple backend implementations. Provides a consistent interface for CRUD operations with event monitoring capabilities.
+
+- [Features](#features)
+- [Installation](#installation)
+- [Usage](#usage)
+  - [File System Storage](#file-system-storage)
+  - [Browser IndexedDB Storage](#browser-indexeddb-storage)
+  - [PostgreSQL Storage](#postgresql-storage)
+  - [SQLite Storage](#sqlite-storage)
+  - [In-Memory Storage](#in-memory-storage)
+- [API Documentation](#api-documentation)
+  - [Core Methods](#core-methods)
+  - [Events](#events)
+- [Testing](#testing)
+- [License](#license)
+
+## Features
+
+- Multiple storage backends:
+  - 🗂️ `FsFolderKvRepository` - File system storage
+  - 💾 `IndexedDbKvRepository` - Browser IndexedDB storage
+  - 🐘 `PostgresKvRepository` - PostgreSQL database storage
+  - 📁 `SqliteKvRepository` - SQLite database storage
+  - 🧠 `InMemoryKvRepository` - Volatile memory storage
+- Type-safe key/value definitions
+- JSON value serialization support
+- Event emitter for storage operations (put/get/delete)
+- Cross-platform compatibility (Node.js and browser)
+
+## Installation
+
+```bash
+bun install @workglow/storage
+```
+
+## Usage
+
+### File System Storage
+
+```typescript
+import { FsFolderKvRepository } from "@workglow/storage/kv";
+
+const fsRepo = new FsFolderKvRepository(
+  "./data-storage", // Storage directory
+  "string", // Key type (string)
+  "json" // Value type (JSON serialized)
+);
+
+await fsRepo.put("config", { theme: "dark", notifications: true });
+const config = await fsRepo.get("config");
+```
+
+### Browser IndexedDB Storage
+
+```typescript
+import { IndexedDbKvRepository } from "@workglow/storage/kv";
+
+const idbRepo = new IndexedDbKvRepository(
+  "my-app-db", // Database name
+  "string", // Key type
+  "json" // Value type
+);
+
+// Works in browser environments
+await idbRepo.put("session", { userId: 123, token: "abc" });
+```
+
+### PostgreSQL Storage
+
+```typescript
+import { PostgresKvRepository } from "@workglow/storage/kv";
+import { PGlite } from "@electric-sql/pglite";
+
+const pg = new PGlite(); // Requires @electric-sql/pglite
+const pgRepo = new PostgresKvRepository(
+  pg, // PostgreSQL connection
+  "user_data", // Table name
+  "string", // Key type
+  "json" // Value type
+);
+
+await pgRepo.put("preferences:456", { lang: "en", fontSize: 16 });
+```
+
+### SQLite Storage
+
+```typescript
+import { SqliteKvRepository } from "@workglow/storage/kv";
+import { Sqlite } from "@workglow/sqlite";
+
+const db = new Sqlite(":memory:"); // In-memory database
+const sqliteRepo = new SqliteKvRepository(
+  db, // SQLite connection
+  "cache_data", // Table name
+  "string", // Key type
+  "string" // Value type (raw strings)
+);
+
+await sqliteRepo.put("temp:789", "cached_value");
+```
+
+### In-Memory Storage
+
+```typescript
+import { InMemoryKvRepository } from "@workglow/storage/kv";
+
+const memRepo = new InMemoryKvRepository(
+  "string", // Key type
+  "json" // Value type
+);
+
+// Volatile storage - data lost on process exit
+await memRepo.put("counter", { value: 42 });
+```
+
+## API Documentation
+
+### Core Methods
+
+- `put(key: Key, value: Value): Promise<void>`
+- `get(key: Key): Promise<Value | undefined>`
+- `delete(key: Key): Promise<void>`
+- `getAll(): Promise<Combined[] | undefined>`
+- `deleteAll(): Promise<void>`
+- `size(): Promise<number>`
+
+### Events
+
+```typescript
+repo.on("put", (key, value) => {
+  console.log(`Stored ${key}:`, value);
+});
+
+repo.on("delete", (key) => {
+  console.log(`Deleted ${key}`);
+});
+```
+
+## Testing
+
+Run all tests:
+
+```bash
+bun test
+```
+
+Run specific implementation tests:
+
+```bash
+bun test FsFolderKvRepository
+bun test IndexedDbKvRepository
+bun test PostgresKvRepository
+```
+
+## License
+
+Apache 2.0 - See LICENSE for details

package/src/queue/README.md

@@ -0,0 +1,41 @@
+# 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
+  - `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

package/src/tabular/README.md

@@ -0,0 +1,298 @@
+# Tabular Repository Implementations
+
+A collection of storage implementations for tabular data with multiple backend support. Provides consistent CRUD operations, search capabilities, and event monitoring across different storage technologies.
+
+- [Features](#features)
+- [Installation](#installation)
+- [Basic Usage](#basic-usage)
+- [Schema Definitions](#schema-definitions)
+  - [Using TypeBox](#using-typebox)
+  - [Using Zod 4](#using-zod-4)
+- [Implementations](#implementations)
+  - [InMemoryTabularRepository](#inmemorytabularrepository)
+  - [SqliteTabularRepository](#sqlitetabularrepository)
+  - [PostgresTabularRepository](#postgrestabularrepository)
+  - [IndexedDbTabularRepository](#indexeddbtabularrepository)
+  - [FsFolderTabularRepository](#fsfoldertabularrepository)
+- [Events](#events)
+- [Testing](#testing)
+- [License](#license)
+
+## Features
+
+- Multiple storage backends:
+  - In-memory (for testing/caching)
+  - SQLite (embedded database)
+  - PostgreSQL (relational database)
+  - IndexedDB (browser storage)
+  - Filesystem (JSON file per record)
+- Type-safe schema definitions
+- Compound primary keys support
+- Indexing for efficient search
+- Event-driven architecture
+- Cross-implementation test suite
+
+## Installation
+
+```bash
+bun add @workglow/storage
+# or
+npm install @workglow/storage
+```
+
+## Basic Usage
+
+```typescript
+import { InMemoryTabularRepository } from "@workglow/storage/tabular";
+
+// Define schema and primary keys
+const schema = {
+  id: "string",
+  name: "string",
+  age: "number",
+  active: "boolean",
+} as const;
+
+const primaryKeys = ["id"] as const;
+// Create repository instance (when using const schemas, the next three generics
+// on InMemoryTabularRepository are automatically created for you)
+const repo = new InMemoryTabularRepository<typeof schema, typeof primaryKeys>(schema, primaryKeys);
+
+// Basic operations
+await repo.put({ id: "1", name: "Alice", age: 30, active: true });
+const result = await repo.get({ id: "1" });
+await repo.delete({ id: "1" });
+```
+
+## Schema Definitions
+
+You can define schemas using plain JSON Schema objects, or use schema libraries like TypeBox or Zod 4 to create them. All schemas must be compatible with `DataPortSchemaObject` from `@workglow/util`.
+
+**Note:** When using TypeBox or Zod schemas, you **must** explicitly provide the generic type parameters to the repository constructor, as TypeScript cannot infer them from non-const schema definitions.
+
+### Using TypeBox
+
+TypeBox schemas are JSON Schema compatible and can be used directly:
+
+```typescript
+import { InMemoryTabularRepository } from "@workglow/storage/tabular";
+import { Type, Static } from "@sinclair/typebox";
+import { DataPortSchemaObject, FromSchema, IncludeProps, ExcludeProps } from "@workglow/util";
+
+// Define schema using TypeBox
+const userSchema = Type.Object({
+  id: Type.String({ format: "uuid" }),
+  name: Type.String({ minLength: 1, maxLength: 100 }),
+  email: Type.String({ format: "email" }),
+  age: Type.Optional(Type.Number({ minimum: 0, maximum: 150 })),
+  active: Type.Boolean({ default: true }),
+}) satisfies DataPortSchemaObject;
+
+// Infer TypeScript types from schema
+type User = FromSchema<typeof userSchema>;
+// => { id: string; name: string; email: string; age?: number; active: boolean }
+
+const primaryKeys = ["id"] as const;
+
+type UserEntity = FromSchema<typeof userSchema>;
+
+// IMPORTANT: You must explicitly provide generic type parameters for t
+// TypeScript cannot infer them from TypeBox schemas
+const repo = new InMemoryTabularRepository<typeof userSchema, typeof primaryKeys, UserEntity>(
+  userSchema,
+  primaryKeys,
+  ["email", "active"] // Indexes
+);
+
+// Use with type safety
+await repo.put({
+  id: "550e8400-e29b-41d4-a716-446655440000",
+  name: "Alice",
+  email: "alice@example.com",
+  age: 30,
+  active: true,
+});
+```
+
+### Using Zod 4
+
+Zod 4 has built-in JSON Schema support using the `.toJSONSchema()` method:
+
+```typescript
+import { InMemoryTabularRepository } from "@workglow/storage/tabular";
+import { z } from "zod";
+import { DataPortSchemaObject } from "@workglow/util";
+
+// Define schema using Zod
+const userSchemaZod = z.object({
+  id: z.string().uuid(),
+  name: z.string().min(1).max(100),
+  email: z.string().email(),
+  age: z.number().min(0).max(150).optional(),
+  active: z.boolean().default(true),
+});
+
+// Convert Zod schema to JSON Schema using built-in method
+const userSchema = userSchemaZod.toJSONSchema() as DataPortSchemaObject;
+const primaryKeys = ["id"] as const;
+
+// Define computed types for the repository generics
+type UserEntity = z.infer<typeof userSchemaZod>;
+
+// IMPORTANT: You must explicitly provide generic type parameters
+// TypeScript cannot infer them from Zod schemas (even after conversion)
+const repo = new InMemoryTabularRepository<typeof userSchema, typeof primaryKeys, UserEntity>(
+  userSchema,
+  primaryKeys,
+  ["email", "active"] // Indexes
+);
+
+// Use with type safety
+await repo.put({
+  id: "550e8400-e29b-41d4-a716-446655440000",
+  name: "Alice",
+  email: "alice@example.com",
+  age: 30,
+  active: true,
+});
+```
+
+## Implementations
+
+### InMemoryTabularRepository
+
+- Ideal for testing/development
+- No persistence
+- Fast search capabilities
+
+```typescript
+const repo = new InMemoryTabularRepository<
+  typeof schema,
+  typeof primaryKeys,
+  Entity, // required if using TypeBox, Zod, etc, otherwise automatically created
+  PrimaryKeyEntity, // should be automatically created
+  ValueEntity // should be automatically created
+>(schema, primaryKeys, ["name", "active"]);
+```
+
+### SqliteTabularRepository
+
+- Embedded SQLite database
+- File-based or in-memory
+
+```typescript
+const repo = new SqliteTabularRepository<
+  typeof schema,
+  typeof primaryKeys,
+  Entity, // required if using TypeBox, Zod, etc, otherwise automatically created
+  PrimaryKeyEntity, // should be automatically created
+  ValueEntity // should be automatically created
+>(
+  ":memory:", // Database path
+  "users", // Table name
+  schema,
+  primaryKeys,
+  [["name", "active"], "age"] // Indexes
+);
+```
+
+### PostgresTabularRepository
+
+- PostgreSQL backend
+- Connection pooling support
+
+```typescript
+import { Pool } from "pg";
+
+const pool = new Pool({
+  /* config */
+});
+const repo = new PostgresTabularRepository<
+  typeof schema,
+  typeof primaryKeys,
+  Entity, // required if using TypeBox, Zod, etc, otherwise automatically created
+  PrimaryKeyEntity, // should be automatically created
+  ValueEntity // should be automatically created
+>(
+  pool, // postgres connection pool
+  "users",
+  schema,
+  primaryKeys,
+  [["name", "active"], "age"]
+);
+```
+
+### IndexedDbTabularRepository
+
+- Browser-based storage
+- Automatic schema migration
+
+```typescript
+const repo = new IndexedDbTabularRepository<
+  typeof schema,
+  typeof primaryKeys,
+  Entity, // required if using TypeBox, Zod, etc, otherwise automatically created
+  PrimaryKeyEntity, // should be automatically created
+  ValueEntity // should be automatically created
+>(
+  "user_db", // Database name
+  schema,
+  primaryKeys,
+  [["name", "active"], "age"]
+);
+```
+
+### FsFolderTabularRepository
+
+- Filesystem storage (one JSON file per record)
+- Simple persistence format
+
+```typescript
+const repo = new FsFolderTabularRepository<
+  typeof schema,
+  typeof primaryKeys,
+  Entity, // required if using TypeBox, Zod, etc, otherwise automatically created
+  PrimaryKeyEntity, // should be automatically created
+  ValueEntity // should be automatically created
+>("./data/users", schema, primaryKeys);
+```
+
+## Events
+
+All implementations emit events:
+
+- `put`: When a record is created/updated
+- `get`: When a record is retrieved
+- `delete`: When a record is deleted
+- `clearall`: When all records are deleted
+- `search`: When a search is performed
+
+```typescript
+repo.on("put", (entity) => {
+  console.log("Record stored:", entity);
+});
+
+repo.on("delete", (key) => {
+  console.log("Record deleted:", key);
+});
+```
+
+## Testing
+
+The implementations share a common test suite. To run tests:
+
+```bash
+bun test
+```
+
+Test includes:
+
+- Basic CRUD operations
+- Compound key handling
+- Index-based search
+- Event emission
+- Concurrency tests
+
+## License
+
+Apache 2.0