@amodalai/runtime 0.1.26 → 0.2.1

package/dist/src/stores/drizzle-store-backend.test.js

@@ -0,0 +1,215 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Shared Drizzle store backend tests.
+ *
+ * Runs the full behaviour matrix (tenant isolation, concurrent writes,
+ * TTL/purge, filter-field validation) against the PGLite-backed factory.
+ *
+ * A Postgres variant runs only when TEST_POSTGRES_URL is set in the
+ * environment — otherwise that `describe` block is skipped. This lets
+ * CI stay fast and local devs can opt into the Postgres path.
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { createPGLiteStoreBackend } from './pglite-store-backend.js';
+import { createPostgresStoreBackend } from './postgres-store-backend.js';
+import { StoreError } from '../errors.js';
+function makeStore(overrides = {}) {
+    return {
+        name: 'test-store',
+        entity: {
+            name: 'TestEntity',
+            key: '{id}',
+            schema: {
+                id: { type: 'string' },
+                value: { type: 'string' },
+            },
+        },
+        location: '/test/stores/test-store.json',
+        ...overrides,
+    };
+}
+const STORES = [
+    makeStore(),
+    makeStore({ name: 'ttl-store', ttl: 1 }),
+    makeStore({ name: 'versioned-store', history: { versions: 3 } }),
+];
+function runSuite(makeBackend) {
+    let backend;
+    let cleanup;
+    beforeEach(async () => {
+        const b = await makeBackend();
+        backend = b.backend;
+        cleanup = b.cleanup;
+    });
+    afterEach(async () => {
+        await cleanup();
+    });
+    describe('tenant isolation', () => {
+        it('same (store, key) across different appIds do not collide', async () => {
+            await backend.put('tenant-a', 'test-store', 'shared', { id: 'shared', value: 'A' }, {});
+            await backend.put('tenant-b', 'test-store', 'shared', { id: 'shared', value: 'B' }, {});
+            const a = await backend.get('tenant-a', 'test-store', 'shared');
+            const b = await backend.get('tenant-b', 'test-store', 'shared');
+            expect(a?.payload['value']).toBe('A');
+            expect(b?.payload['value']).toBe('B');
+        });
+        it('list only returns the caller\'s appId rows', async () => {
+            await backend.put('tenant-a', 'test-store', 'a1', { id: 'a1' }, {});
+            await backend.put('tenant-a', 'test-store', 'a2', { id: 'a2' }, {});
+            await backend.put('tenant-b', 'test-store', 'b1', { id: 'b1' }, {});
+            const resA = await backend.list('tenant-a', 'test-store');
+            const resB = await backend.list('tenant-b', 'test-store');
+            expect(resA.total).toBe(2);
+            expect(resB.total).toBe(1);
+            expect(resA.documents.every((d) => d.appId === 'tenant-a')).toBe(true);
+            expect(resB.documents.every((d) => d.appId === 'tenant-b')).toBe(true);
+        });
+        it('delete on one tenant does not affect the other', async () => {
+            await backend.put('tenant-a', 'test-store', 'k', { id: 'k' }, {});
+            await backend.put('tenant-b', 'test-store', 'k', { id: 'k' }, {});
+            await backend.delete('tenant-a', 'test-store', 'k');
+            expect(await backend.get('tenant-a', 'test-store', 'k')).toBeNull();
+            expect(await backend.get('tenant-b', 'test-store', 'k')).not.toBeNull();
+        });
+    });
+    describe('concurrent writes', () => {
+        it('serializes parallel puts to the same key via write queue', async () => {
+            // Fire 20 concurrent puts at the same key. The write queue must
+            // serialize them so each read-modify-write sees the previous
+            // version — final version should be exactly 20.
+            const writes = Array.from({ length: 20 }, (_, i) => backend.put('app', 'test-store', 'same-key', { id: 'same-key', n: i }, {}));
+            const results = await Promise.all(writes);
+            // All writes reported stored:true
+            expect(results.every((r) => r.stored)).toBe(true);
+            const final = await backend.get('app', 'test-store', 'same-key');
+            expect(final?.version).toBe(20);
+        });
+    });
+    describe('purgeExpired', () => {
+        it('removes only expired rows and returns the count', async () => {
+            // ttl-store has ttl=1s
+            await backend.put('app', 'ttl-store', 'e1', { id: 'e1' }, {});
+            await backend.put('app', 'ttl-store', 'e2', { id: 'e2' }, {});
+            // Non-TTL store — should never be purged
+            await backend.put('app', 'test-store', 'keep', { id: 'keep' }, {});
+            // Wait for TTL to elapse
+            await new Promise((r) => setTimeout(r, 1100));
+            const purged = await backend.purgeExpired('app');
+            expect(purged).toBe(2);
+            expect(await backend.get('app', 'ttl-store', 'e1')).toBeNull();
+            expect(await backend.get('app', 'ttl-store', 'e2')).toBeNull();
+            expect(await backend.get('app', 'test-store', 'keep')).not.toBeNull();
+        });
+        it('scoped purge only touches the named store', async () => {
+            await backend.put('app', 'ttl-store', 'a', { id: 'a' }, {});
+            await backend.put('app', 'test-store', 'b', { id: 'b' }, {});
+            // put with manual expires_at on test-store via TTL=0 is not exposed;
+            // instead, verify purgeExpired scoped to ttl-store only affects ttl-store.
+            await new Promise((r) => setTimeout(r, 1100));
+            const purged = await backend.purgeExpired('app', 'ttl-store');
+            expect(purged).toBe(1);
+            expect(await backend.get('app', 'test-store', 'b')).not.toBeNull();
+        });
+        it('excludes expired rows from list() when includeStale is false', async () => {
+            await backend.put('app', 'ttl-store', 'x', { id: 'x' }, {});
+            await new Promise((r) => setTimeout(r, 1100));
+            const defaultList = await backend.list('app', 'ttl-store');
+            expect(defaultList.total).toBe(0);
+            const withStale = await backend.list('app', 'ttl-store', { includeStale: true });
+            expect(withStale.total).toBe(1);
+            expect(withStale.documents[0].meta.stale).toBe(true);
+        });
+    });
+    describe('filter-field validation', () => {
+        it('rejects filter field names with injection characters', async () => {
+            await backend.put('app', 'test-store', 'k', { id: 'k' }, {});
+            await expect(backend.list('app', 'test-store', { filter: { "'; DROP TABLE store_documents; --": 'x' } })).rejects.toBeInstanceOf(StoreError);
+        });
+        it('rejects filter fields containing whitespace or punctuation', async () => {
+            await expect(backend.list('app', 'test-store', { filter: { 'value OR 1=1': 'x' } })).rejects.toBeInstanceOf(StoreError);
+        });
+        it('rejects sort field with injection characters', async () => {
+            await expect(backend.list('app', 'test-store', { sort: "value); DROP TABLE x; --" })).rejects.toBeInstanceOf(StoreError);
+        });
+        it('accepts valid snake_case filter field', async () => {
+            await backend.put('app', 'test-store', 'k', { id: 'k', my_field: 'yes' }, {});
+            const result = await backend.list('app', 'test-store', { filter: { my_field: 'yes' } });
+            expect(result.total).toBe(1);
+        });
+    });
+    describe('versioning edge cases', () => {
+        it('history respects maxVersions trim', async () => {
+            // versioned-store has history.versions=3
+            for (let i = 1; i <= 6; i++) {
+                await backend.put('app', 'versioned-store', 'k', { id: 'k', n: i }, {});
+            }
+            const history = await backend.history('app', 'versioned-store', 'k');
+            // Current version is 6; history should hold the trailing 3 prior versions (3,4,5)
+            expect(history).toHaveLength(3);
+            expect(history[0].version).toBe(5);
+            expect(history[2].version).toBe(3);
+        });
+    });
+    describe('close() idempotency', () => {
+        it('double-close is safe and ops after close throw StoreError', async () => {
+            await backend.put('app', 'test-store', 'k', { id: 'k' }, {});
+            await backend.close();
+            // Second close should be a no-op, not throw
+            await backend.close();
+            // Operations after close throw StoreError
+            await expect(backend.get('app', 'test-store', 'k')).rejects.toBeInstanceOf(StoreError);
+            await expect(backend.put('app', 'test-store', 'k', { id: 'k' }, {})).rejects.toBeInstanceOf(StoreError);
+            // The cleanup() in afterEach expects to close a live backend; re-open
+            // via the factory so afterEach doesn't blow up on a double-cleanup.
+            // (It's simpler to just no-op cleanup here by setting a flag — but
+            // the suite-wide afterEach would need the hook. Instead, since
+            // close() is idempotent, let afterEach call it again safely.)
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// PGLite suite (always runs)
+// ---------------------------------------------------------------------------
+describe('DrizzleStoreBackend (PGLite)', () => {
+    runSuite(async () => {
+        const backend = await createPGLiteStoreBackend(STORES);
+        return {
+            backend,
+            cleanup: () => backend.close(),
+        };
+    });
+});
+// ---------------------------------------------------------------------------
+// Postgres suite (opt-in via TEST_POSTGRES_URL env var)
+// ---------------------------------------------------------------------------
+const pgUrl = process.env['TEST_POSTGRES_URL'] ?? '';
+const pgDescribe = pgUrl ? describe : describe.skip;
+pgDescribe('DrizzleStoreBackend (Postgres, via TEST_POSTGRES_URL)', () => {
+    runSuite(async () => {
+        // Drop any existing tables so every test run starts clean. Use a
+        // dedicated database for TEST_POSTGRES_URL — these DROPs are
+        // destructive and will wipe any store tables in the target DB.
+        const pg = await import('pg');
+        const { Pool: CleanPool } = pg.default ?? pg;
+        const cleanPool = new CleanPool({ connectionString: pgUrl });
+        try {
+            await cleanPool.query('DROP TABLE IF EXISTS store_document_versions CASCADE');
+            await cleanPool.query('DROP TABLE IF EXISTS store_documents CASCADE');
+        }
+        finally {
+            await cleanPool.end();
+        }
+        const backend = await createPostgresStoreBackend(STORES, {
+            connectionString: pgUrl,
+        });
+        return {
+            backend,
+            cleanup: () => backend.close(),
+        };
+    });
+});
+//# sourceMappingURL=drizzle-store-backend.test.js.map

package/dist/src/stores/drizzle-store-backend.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle-store-backend.test.js","sourceRoot":"","sources":["../../../src/stores/drizzle-store-backend.test.ts"],"names":[],"mappings":"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"}

package/dist/src/stores/index.d.ts

@@ -4,5 +4,9 @@
  * SPDX-License-Identifier: MIT
  */
 export { PGLiteStoreBackend, createPGLiteStoreBackend } from './pglite-store-backend.js';
+export type { PGLiteStoreBackendOptions } from './pglite-store-backend.js';
+export { DrizzleStoreBackend } from './drizzle-store-backend.js';
+export { createPostgresStoreBackend } from './postgres-store-backend.js';
+export type { PostgresStoreBackendOptions } from './postgres-store-backend.js';
 export { resolveKey } from './key-resolver.js';
 export { resolveTtl, evaluateCondition } from './ttl-resolver.js';

package/dist/src/stores/index.js

@@ -4,6 +4,8 @@
  * SPDX-License-Identifier: MIT
  */
 export { PGLiteStoreBackend, createPGLiteStoreBackend } from './pglite-store-backend.js';
+export { DrizzleStoreBackend } from './drizzle-store-backend.js';
+export { createPostgresStoreBackend } from './postgres-store-backend.js';
 export { resolveKey } from './key-resolver.js';
 export { resolveTtl, evaluateCondition } from './ttl-resolver.js';
 //# sourceMappingURL=index.js.map

package/dist/src/stores/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/stores/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,kBAAkB,EAAE,wBAAwB,EAAC,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAAC,UAAU,EAAC,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAC,UAAU,EAAE,iBAAiB,EAAC,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/stores/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,kBAAkB,EAAE,wBAAwB,EAAC,MAAM,2BAA2B,CAAC;AAEvF,OAAO,EAAC,mBAAmB,EAAC,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAC,0BAA0B,EAAC,MAAM,6BAA6B,CAAC;AAEvE,OAAO,EAAC,UAAU,EAAC,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAC,UAAU,EAAE,iBAAiB,EAAC,MAAM,mBAAmB,CAAC"}

package/dist/src/stores/pglite-store-backend.d.ts

@@ -4,29 +4,27 @@
  * SPDX-License-Identifier: MIT
  */
 import type { LoadedStore } from '@amodalai/core';
-import type { StoreBackend, StoreDocument, StoreDocumentMeta, StorePutResult, StoreListOptions, StoreListResult } from '@amodalai/core';
+import type { StoreBackend, StoreDocument, StoreDocumentMeta, StorePutResult, StoreListOptions, StoreListResult } from '@amodalai/types';
+import type { Logger } from '../logger.js';
 /**
- * PGLite-backed store backend.
+ * PGLite store backend. Delegates all query logic to DrizzleStoreBackend
+ * once the underlying PGLite instance has been initialized.
  *
- * Uses in-process WASM Postgres via @electric-sql/pglite.
- * Data is stored in a configurable directory (default: .amodal/store-data/).
- *
- * All writes are serialized through a queue to prevent concurrent access
- * issues with PGLite's single-threaded WASM engine.
+ * Constructor + initialize() pattern is preserved for backwards
+ * compatibility with existing callers (and test suites that `new` then
+ * call `initialize()`).
  */
+export interface PGLiteStoreBackendOptions {
+    dataDir?: string;
+    logger?: Logger;
+}
 export declare class PGLiteStoreBackend implements StoreBackend {
-    private db;
     private readonly dataDir;
-    private stores;
-    private writeQueue;
-    constructor(dataDir?: string);
-    /**
-     * Serialize a write operation through the queue.
-     * Ensures PGLite only processes one write at a time.
-     */
-    private enqueue;
+    private readonly logger;
+    private inner;
+    constructor(dataDirOrOpts?: string | PGLiteStoreBackendOptions);
     initialize(stores: LoadedStore[]): Promise<void>;
-    private ensureDb;
+    private ensure;
     get(appId: string, store: string, key: string): Promise<StoreDocument | null>;
     put(appId: string, store: string, key: string, payload: Record<string, unknown>, meta: Partial<StoreDocumentMeta>): Promise<StorePutResult>;
     list(appId: string, store: string, options?: StoreListOptions): Promise<StoreListResult>;
@@ -34,9 +32,8 @@ export declare class PGLiteStoreBackend implements StoreBackend {
     history(appId: string, store: string, key: string): Promise<StoreDocument[]>;
     purgeExpired(appId: string, store?: string): Promise<number>;
     close(): Promise<void>;
-    private rowToDocument;
 }
 /**
  * Create a PGLite store backend.
  */
-export declare function createPGLiteStoreBackend(stores: LoadedStore[], dataDir?: string): Promise<PGLiteStoreBackend>;
+export declare function createPGLiteStoreBackend(stores: LoadedStore[], dataDirOrOpts?: string | PGLiteStoreBackendOptions): Promise<PGLiteStoreBackend>;