@bett3r-dev/pv3 1.0.0 → 2.5.1

package/build/adapters/database/memory/index.test.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const pv3_types_1 = require("@bett3r-dev/pv3-types");
+const index_1 = require("./index");
+describe('MemoryDb createMany atomic unique-index reject', () => {
+    const setup = async () => {
+        const db = (0, index_1.MemoryDb)();
+        await db.start();
+        const collection = db.getCollection('people');
+        await collection.ensureIndex(['email'], { isUnique: true });
+        return { db, collection };
+    };
+    it('rejects with DuplicatedValueInIndexError and leaves the collection unmutated when any doc collides with an existing row on a unique index', async () => {
+        // Given a collection holding one row
+        const { collection } = await setup();
+        await collection.createMany([{ id: '1', email: 'a@a.com' }]);
+        const before = await collection.query({});
+        // When createMany-ing a batch whose second doc collides on the unique `email` index
+        await expect(collection.createMany([
+            { id: '2', email: 'b@b.com' },
+            { id: '3', email: 'a@a.com' }
+        ])).rejects.toBeInstanceOf(pv3_types_1.DuplicatedValueInIndexError);
+        // Then NONE of the batch was written — all-or-nothing, including the non-colliding doc '2'
+        expect(await collection.query({})).toEqual(before);
+        expect(await collection.readById('2')).toBeNull();
+        expect(await collection.readById('3')).toBeNull();
+    });
+    it('inserts every row when the batch does not collide', async () => {
+        const { collection } = await setup();
+        const result = await collection.createMany([
+            { id: '1', email: 'a@a.com' },
+            { id: '2', email: 'b@b.com' }
+        ]);
+        expect(result).toHaveLength(2);
+        expect(await collection.readById('1')).toEqual({ id: '1', email: 'a@a.com' });
+        expect(await collection.readById('2')).toEqual({ id: '2', email: 'b@b.com' });
+    });
+    it('does not treat null indexed values as colliding (SQL NULL-distinctness — versionless streams)', async () => {
+        // Compound unique index on (stream, version), matching the eventstore.
+        const db = (0, index_1.MemoryDb)();
+        await db.start();
+        const events = db.getCollection('events');
+        await events.ensureIndex(['stream', 'version'], { isUnique: true });
+        // A versionless stream commits many events all at version === null.
+        await events.createMany([{ id: '1', stream: 'S-1', version: null }]);
+        await expect(events.createMany([{ id: '2', stream: 'S-1', version: null }]))
+            .resolves.toHaveLength(1);
+        expect(await events.query({})).toHaveLength(2);
+        // Non-null duplicates on the same index still collide.
+        await events.createMany([{ id: '3', stream: 'S-1', version: 0 }]);
+        await expect(events.createMany([{ id: '4', stream: 'S-1', version: 0 }]))
+            .rejects.toBeInstanceOf(pv3_types_1.DuplicatedValueInIndexError);
+    });
+});
+describe('MemoryDb transaction isolation (TV1-1976)', () => {
+    it("a rolled-back transaction does not clobber a concurrent transaction's committed write", async () => {
+        // Given a db and a transaction B whose snapshot is taken (at BEGIN) while the
+        // db is still empty, but which acts LATER — the exact window the old
+        // whole-_db snapshot/restore clobbered.
+        const db = (0, index_1.MemoryDb)();
+        await db.start();
+        const coll = 'accounts';
+        let release = () => { };
+        const gate = new Promise((r) => { release = r; });
+        const txB = db.initTransaction(async (transaction) => {
+            await gate; // B was BEGUN (snapshot empty) but does its write only after A commits.
+            await transaction.getCollection(coll).upsert('b', { id: 'b', v: 2 });
+            throw new Error('boom'); // force B to roll back
+        });
+        // When a concurrent transaction A commits a write to a DIFFERENT key while B is paused,
+        await db.initTransaction(async (transaction) => {
+            await transaction.getCollection(coll).upsert('a', { id: 'a', keep: true });
+        });
+        // ...and only then B resumes, writes 'b', and rolls back.
+        release();
+        await expect(txB).rejects.toThrow('boom');
+        // Then A's committed write SURVIVES B's rollback (old code wiped it), and B's
+        // own write is undone.
+        expect(await db.getCollection(coll).readById('a')).toEqual({ id: 'a', keep: true });
+        expect(await db.getCollection(coll).readById('b')).toBeNull();
+    });
+    it('rolls back only its own writes, leaving pre-existing committed rows untouched', async () => {
+        // Given a committed baseline row
+        const db = (0, index_1.MemoryDb)();
+        await db.start();
+        const coll = 'accounts';
+        await db.getCollection(coll).upsert('base', { id: 'base', v: 0 });
+        // When a transaction updates the baseline AND inserts a new row, then rolls back
+        await expect(db.initTransaction(async (transaction) => {
+            await transaction.getCollection(coll).upsert('base', { id: 'base', v: 99 });
+            await transaction.getCollection(coll).upsert('new', { id: 'new', v: 1 });
+            throw new Error('rollback');
+        })).rejects.toThrow('rollback');
+        // Then the baseline is restored to its pre-transaction value and the insert is gone
+        expect(await db.getCollection(coll).readById('base')).toEqual({ id: 'base', v: 0 });
+        expect(await db.getCollection(coll).readById('new')).toBeNull();
+    });
+    it('undoes a non-unique arrayPush on rollback (the in-place push must not corrupt its own pre-image)', async () => {
+        // Given a committed row with an array field
+        const db = (0, index_1.MemoryDb)();
+        await db.start();
+        const coll = 'docs';
+        await db.getCollection(coll).upsert('r1', { id: 'r1', tags: ['a'] });
+        // When a transaction arrayPushes a NON-UNIQUE element then rolls back
+        await expect(db.initTransaction(async (transaction) => {
+            await transaction.getCollection(coll).arrayPush([{ field: 'id', op: 'eq', value: 'r1' }], ['tags'], 'b');
+            throw new Error('rollback');
+        })).rejects.toThrow('rollback');
+        // Then the push is undone — the pre-image is intact. (Regression: the old
+        // in-place `array.push` mutated the row's array before the journal captured
+        // its pre-image by reference, so the rollback left the pushed 'b' behind.)
+        expect(await db.getCollection(coll).readById('r1')).toEqual({ id: 'r1', tags: ['a'] });
+    });
+    it('a committed non-unique arrayPush still persists the pushed element', async () => {
+        // Control: the fresh-array rewrite must not change normal (commit) behavior.
+        const db = (0, index_1.MemoryDb)();
+        await db.start();
+        const coll = 'docs';
+        await db.getCollection(coll).upsert('r1', { id: 'r1', tags: ['a'] });
+        await db.initTransaction(async (transaction) => {
+            await transaction.getCollection(coll).arrayPush([{ field: 'id', op: 'eq', value: 'r1' }], ['tags'], 'b');
+        });
+        expect(await db.getCollection(coll).readById('r1')).toEqual({ id: 'r1', tags: ['a', 'b'] });
+    });
+});
+// A CHARACTERIZATION test: it pins the behavior MemoryDb already has, on purpose. It is green from
+// the moment it is written and it must STAY green — if it ever goes red, somebody "fixed" the
+// non-isolation and (see below) broke the OCC retry while they were at it.
+describe('MemoryDb transactions are ATOMIC, not ISOLATED (TV1-1985)', () => {
+    it('a read taken from the POOL sees a write made inside an OPEN, UNCOMMITTED transaction', async () => {
+        // Given a db and an open transaction
+        const db = (0, index_1.MemoryDb)();
+        await db.start();
+        const coll = 'accounts';
+        // When the transaction writes a row and, BEFORE it commits, the POOL reads the same collection.
+        // (`initTransaction` only resolves after the callback returns, so everything read inside the
+        // callback is read while the transaction is still open — nothing is committed yet.)
+        let readByIdFromPool = 'never read';
+        let queriedFromPool = [];
+        await db.initTransaction(async (transaction) => {
+            await transaction.getCollection(coll).upsert('a', { id: 'a', uncommitted: true });
+            readByIdFromPool = await db.getCollection(coll).readById('a');
+            queriedFromPool = await db.getCollection(coll).query({});
+        });
+        // Then the UNCOMMITTED row IS visible from the pool. This is the true, deliberate behavior —
+        // NOT a bug to be asserted away. MemoryDb applies transaction writes IN PLACE on the shared
+        // `_db` behind an undo-journal Proxy and its commit is a no-op (index.ts:341-421): the journal
+        // exists only to restore this transaction's touched keys on ROLLBACK. It therefore buys
+        // ATOMICITY, not ISOLATION. index.ts:360-364 records the rejection of the alternative
+        // explicitly: a snapshot-clone-then-apply-on-commit (MVCC-style) overlay was turned down
+        // because applying writes only at commit defers the UNIQUE-index violation to commit time,
+        // which (a) diverges from Postgres, which fails at INSERT, and (b) bypasses the eventstore's
+        // `createMany` -> ConcurrencyError remap that the command-handler's optimistic retry is keyed
+        // on. Isolate MemoryDb and you break the OCC retry.
+        expect(readByIdFromPool).toEqual({ id: 'a', uncommitted: true });
+        expect(queriedFromPool).toEqual([{ id: 'a', uncommitted: true }]);
+        // The consequence, and the reason this fact is worth an executed assertion: NO MemoryDb-backed
+        // test can witness a transaction-ISOLATION bug. `DatabaseEventstore.reduceMultipleStream`
+        // silently dropped the transaction it was handed and read from the pool for three months — and
+        // because a MemoryDb pool read returns exactly what the transaction wrote, the buggy and the
+        // fixed adapter reduce to IDENTICAL state here. The entire default (infra-free) tier could only
+        // ever pass VACUOUSLY on that contract; the ticket even produced a false P1 off the confusion.
+        // Isolation contracts must therefore be proven in a `.deps.test.ts` over a REAL Postgres:
+        // packages/pv3-adapter-eventstore-postgres/__tests__/multiStreamTransaction.deps.test.ts.
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/build/adapters/database/memory/index.test.js.map

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

package/build/adapters/database/memory/pagingCursorZero.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pagingCursorZero.test.d.ts.map

package/build/adapters/database/memory/pagingCursorZero.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagingCursorZero.test.d.ts","sourceRoot":"","sources":["../../../../src/adapters/database/memory/pagingCursorZero.test.ts"],"names":[],"mappings":""}

package/build/adapters/database/memory/pagingCursorZero.test.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("./index");
+/**
+ * A paging walk over a readmodel whose cursor legitimately takes the value `0`.
+ *
+ * The cursor is the key column's value, so on a zero-based numeric key page 1's last key IS `0`.
+ * The adapter used to guard the cursor with `if ( after )`; `0` being falsy, page 2 was fetched
+ * UNCURSORED and returned page 1 again — whose last key is again `0` — so the walk never
+ * terminated and re-yielded page 1 forever.
+ *
+ * The walk below is BOUNDED by MAX_PAGES: a regression FAILS the assertion rather than hanging
+ * the suite.
+ */
+describe('MemoryDb paging cursor of 0', () => {
+    const MAX_PAGES = 10;
+    const setup = async () => {
+        const db = (0, index_1.MemoryDb)();
+        await db.start();
+        const collection = db.getCollection('items');
+        // Zero-based numeric keys — '0' is a real, reachable cursor value.
+        await collection.createMany([
+            { id: '0', name: 'zero' },
+            { id: '1', name: 'one' },
+            { id: '2', name: 'two' }
+        ]);
+        return collection;
+    };
+    it('Given a page-1 cursor of 0 when fetching page 2 then page 2 does NOT repeat page 1', async () => {
+        const collection = await setup();
+        const pageOne = await collection.query({ limit: 1 });
+        expect(pageOne.map(r => r.id)).toEqual(['0']);
+        // The cursor page 1 hands forward is the literal value 0 — the falsy value that used to be dropped.
+        const cursor = Number(pageOne[pageOne.length - 1].id);
+        expect(cursor).toBe(0);
+        const pageTwo = await collection.query({ limit: 1, after: cursor });
+        expect(pageTwo.map(r => r.id)).not.toEqual(pageOne.map(r => r.id));
+        expect(pageTwo.map(r => r.id)).toEqual(['1']);
+    });
+    it('Given a full paged walk from a 0 cursor when draining the collection then it TERMINATES and visits each row exactly once', async () => {
+        const collection = await setup();
+        const seen = [];
+        let cursor = undefined;
+        let pages = 0;
+        while (pages < MAX_PAGES) {
+            const page = await collection.query(cursor === undefined ? { limit: 1 } : { limit: 1, after: cursor });
+            if (page.length === 0)
+                break;
+            pages++;
+            seen.push(...page.map(r => r.id));
+            cursor = Number(page[page.length - 1].id);
+        }
+        // Terminated well inside the bound — a re-yielding pager would burn all MAX_PAGES.
+        expect(pages).toBe(3);
+        // Each row exactly once, in key order — no repeats.
+        expect(seen).toEqual(['0', '1', '2']);
+        expect(new Set(seen).size).toBe(seen.length);
+    });
+});
+//# sourceMappingURL=pagingCursorZero.test.js.map

package/build/adapters/database/memory/pagingCursorZero.test.js.map

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

package/build/adapters/database/memory/pagingVanishedCursor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pagingVanishedCursor.test.d.ts.map

package/build/adapters/database/memory/pagingVanishedCursor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagingVanishedCursor.test.d.ts","sourceRoot":"","sources":["../../../../src/adapters/database/memory/pagingVanishedCursor.test.ts"],"names":[],"mappings":""}

package/build/adapters/database/memory/pagingVanishedCursor.test.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("./index");
+/**
+ * A paging walk over a collection whose CURSOR ROW IS DELETED between page 1 and page 2.
+ *
+ * The adapter resolved the cursor with `sortedKeys.indexOf( after.toString())`. When the cursor
+ * key has vanished, `indexOf` returns -1 and the follow-on `slice( -1 + 1 )` === `slice( 0 )`
+ * re-yields the WHOLE collection from the beginning — the same non-terminating-pager class as the
+ * falsy-cursor bug in `pagingCursorZero.test.ts`, reached by a different route.
+ *
+ * Correct semantics are taken from the Postgres adapter, the contract oracle: it compiles the
+ * cursor to `<key> > $n` (`postgres.utils.ts` `translateSQL`), so deleting the cursor row changes
+ * nothing and rows after it still match — SKIP-FORWARD, not empty, and certainly not restart.
+ * Mongo agrees ( `{ id: { $gt: after }}` ).
+ *
+ * The walk below is BOUNDED by MAX_PAGES: a regression FAILS the assertion rather than hanging
+ * the suite.
+ */
+describe('MemoryDb paging over a vanished cursor', () => {
+    const MAX_PAGES = 10;
+    const setup = async () => {
+        const db = (0, index_1.MemoryDb)();
+        await db.start();
+        const collection = db.getCollection('items');
+        await collection.createMany([
+            { id: '1', name: 'one' },
+            { id: '2', name: 'two' },
+            { id: '3', name: 'three' },
+            { id: '4', name: 'four' },
+            { id: '5', name: 'five' }
+        ]);
+        return collection;
+    };
+    it('Given the cursor row is deleted when fetching the next page then it SKIPS FORWARD to the next key, not back to the start', async () => {
+        const collection = await setup();
+        const pageOne = await collection.query({ limit: 2 });
+        expect(pageOne.map(r => r.id)).toEqual(['1', '2']);
+        const cursor = pageOne[pageOne.length - 1].id;
+        // The row the cursor names disappears between pages.
+        await collection.destroyById(cursor);
+        const pageTwo = await collection.query({ limit: 2, after: cursor });
+        // Skip-forward: everything ordered after the vanished key, nothing before it.
+        expect(pageTwo.map(r => r.id)).toEqual(['3', '4']);
+        expect(pageTwo.map(r => r.id)).not.toContain('1');
+    });
+    it('Given a paged walk whose cursor row vanishes each page then it TERMINATES and never re-yields an earlier row', async () => {
+        const collection = await setup();
+        // Pages of 2, deleting only the row the cursor NAMES (the page's last). Row '1' is never the
+        // cursor, so it stays in the collection for the whole walk — which is what makes a restarting
+        // pager observable: broken, every page leads with '1' again, and the walk burns pages until
+        // the bound. Deleting the head instead would mask the defect.
+        const seen = [];
+        let cursor = undefined;
+        let pages = 0;
+        while (pages < MAX_PAGES) {
+            const page = await collection.query(cursor === undefined ? { limit: 2 } : { limit: 2, after: cursor });
+            if (page.length === 0)
+                break;
+            pages++;
+            seen.push(...page.map(r => r.id));
+            cursor = page[page.length - 1].id;
+            await collection.destroyById(cursor);
+        }
+        // Terminated well inside the bound — a restarting pager burns MAX_PAGES instead.
+        expect(pages).toBe(3);
+        // Each row exactly once, in key order — no row re-yielded from the start.
+        expect(seen).toEqual(['1', '2', '3', '4', '5']);
+        expect(new Set(seen).size).toBe(seen.length);
+    });
+});
+//# sourceMappingURL=pagingVanishedCursor.test.js.map

package/build/adapters/database/memory/pagingVanishedCursor.test.js.map

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

package/build/adapters/endpoints/addAuthUser/index.d.ts

@@ -1,8 +1,10 @@
 import { EndpointsAdapter } from '@bett3r-dev/pv3-types';
 /**
- * Adds the user object to the request context
- * @param customTokenAttributes - Object with key as the path to the attribute in the token and value as the name of the attribute in the user object
- * @returns
+ * Adds the user object to the request context.
+ *
+ * X-Auth-* headers — set by an API gateway (e.g., Caddy subrequest).
+ * The gateway resolves JWT/session and forwards user identity as headers.
+ * @param headersToContextMap - Maps request headers to context paths (e.g., { 'x-auth-user-id': 'context.user.id' })
  */
-export declare const AddAuthUserToRequest: (customTokenAttributes: Record<string, string>) => EndpointsAdapter;
+export declare const AddAuthUserToRequest: (headersToContextMap?: Record<string, string>) => EndpointsAdapter;
 //# sourceMappingURL=index.d.ts.map

package/build/adapters/endpoints/addAuthUser/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/endpoints/addAuthUser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAYzF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,0BAA4B,OAAO,MAAM,EAAE,MAAM,CAAC,KAAI,gBAqCtF,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/endpoints/addAuthUser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6C,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGpG;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,yBACV,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC1C,gBA2BF,CAAC"}

package/build/adapters/endpoints/addAuthUser/index.js

@@ -2,40 +2,21 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AddAuthUserToRequest = void 0;
 const ramda_1 = require("ramda");
-const __1 = require("../../..");
-const propMapper = (map, object) => {
-    const result = {};
-    Object.keys(map).forEach(key => {
-        result[map[key]] = (0, ramda_1.path)(key.split('.'), object);
-    });
-    return result;
-};
 /**
- * Adds the user object to the request context
- * @param customTokenAttributes - Object with key as the path to the attribute in the token and value as the name of the attribute in the user object
- * @returns
+ * Adds the user object to the request context.
+ *
+ * X-Auth-* headers — set by an API gateway (e.g., Caddy subrequest).
+ * The gateway resolves JWT/session and forwards user identity as headers.
+ * @param headersToContextMap - Maps request headers to context paths (e.g., { 'x-auth-user-id': 'context.user.id' })
  */
-const AddAuthUserToRequest = (customTokenAttributes) => {
+const AddAuthUserToRequest = (headersToContextMap = {}) => {
     const addUserToContext = async (params) => {
-        const token = params.context?.req?.headers?.authorization || params.query?.access_token;
-        if (!token)
-            return params;
-        try {
-            const payload = JSON.parse(Buffer.from(token.split('.')[1], 'base64').toString());
-            if (!params.context)
-                params.context = {};
-            params.context.token = token.slice(token.lastIndexOf(' ') + 1);
-            params.context.user = propMapper({
-                'email': 'email',
-                'realm_access.roles': 'roles',
-                'app_id': 'id',
-                ...customTokenAttributes
-            }, payload);
-            return Promise.resolve(params);
-        }
-        catch (err) {
-            return Promise.reject((0, __1.createError)((0, __1.AuthenticationError)(), { description: 'Invalid Token' }));
-        }
+        Object.entries(headersToContextMap).forEach(([header, contextPath]) => {
+            if (params.context?.req?.headers?.[header]) {
+                params = (0, ramda_1.assocPath)(contextPath.split('.'), params.context.req.headers[header], params);
+            }
+        });
+        return params;
     };
     const registerEndpoint = (endpoint) => {
         const originalAction = endpoint.action;

package/build/adapters/endpoints/addAuthUser/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/endpoints/addAuthUser/index.ts"],"names":[],"mappings":";;;AACA,iCAA6B;AAC7B,gCAA4D;AAE5D,MAAM,UAAU,GAAG,CAAE,GAA2B,EAAE,MAA2B,EAAG,EAAE;IAChF,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,MAAM,CAAC,IAAI,CAAE,GAAG,CAAE,CAAC,OAAO,CAAE,GAAG,CAAC,EAAE;QAChC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAA,YAAI,EAAE,GAAG,CAAC,KAAK,CAAE,GAAG,CAAE,EAAE,MAAM,CAAE,CAAC;IACtD,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;;GAIG;AACI,MAAM,oBAAoB,GAAG,CAAE,qBAA6C,EAAqB,EAAE;IACxG,MAAM,gBAAgB,GAAG,KAAK,EAAG,MAA4B,EAAkC,EAAE;QAC/F,MAAM,KAAK,GAAW,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,aAAuB,IAAI,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC;QAC1G,IAAK,CAAC,KAAK;YAAG,OAAO,MAAM,CAAC;QAC5B,IAAG;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAE,MAAM,CAAC,IAAI,CAAE,KAAK,CAAC,KAAK,CAAE,GAAG,CAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;YACvF,IAAK,CAAC,MAAM,CAAC,OAAO;gBAClB,MAAM,CAAC,OAAO,GAAG,EAAE,CAAC;YACtB,MAAM,CAAC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAE,KAAK,CAAC,WAAW,CAAE,GAAG,CAAE,GAAG,CAAC,CAAE,CAAC;YACnE,MAAM,CAAC,OAAO,CAAC,IAAI,GAAG,UAAU,CAAC;gBAC/B,OAAO,EAAE,OAAO;gBAChB,oBAAoB,EAAE,OAAO;gBAC7B,QAAQ,EAAE,IAAI;gBACd,GAAG,qBAAqB;aACzB,EAAE,OAAO,CAAE,CAAC;YACb,OAAO,OAAO,CAAC,OAAO,CAAE,MAAM,CAAE,CAAC;SAClC;QAAC,OAAQ,GAAG,EAAG;YACd,OAAO,OAAO,CAAC,MAAM,CAAE,IAAA,eAAW,EAAE,IAAA,uBAAmB,GAAE,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;SAC/F;IACH,CAAC,CAAC;IAEF,MAAM,gBAAgB,GAAG,CAAE,QAAkB,EAAG,EAAE;QAChD,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC;QACvC,QAAQ,CAAC,MAAM,GAAG,CAAE,MAA2C,EAAG,EAAE;YAClE,OAAO,gBAAgB,CAAE,MAAM,CAAE;iBAC9B,IAAI,CAAE,cAAc,CAAE,CAAC;QAC5B,CAAC,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;QAClB,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,KAAK,IAAE,EAAE,GAAC,CAAC;QAClB,IAAI,EAAE,KAAK,IAAE,EAAE,GAAC,CAAC;QACjB,gBAAgB;KACjB,CAAC;AACJ,CAAC,CAAC;AArCW,QAAA,oBAAoB,wBAqC/B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/endpoints/addAuthUser/index.ts"],"names":[],"mappings":";;;AACA,iCAAkC;AAElC;;;;;;GAMG;AACI,MAAM,oBAAoB,GAAG,CAClC,mBAAmB,GAA2B,EAAE,EAC9B,EAAE;IACpB,MAAM,gBAAgB,GAAG,KAAK,EAAG,MAA4B,EAAkC,EAAE;QAC/F,MAAM,CAAC,OAAO,CAAE,mBAAmB,CAAE,CAAC,OAAO,CAAC,CAAC,CAAE,MAAM,EAAE,WAAW,CAAE,EAAE,EAAE;YACxE,IAAK,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAE,MAAM,CAAE,EAAE,CAAC;gBAC9C,MAAM,GAAG,IAAA,iBAAS,EAAE,WAAW,CAAC,KAAK,CAAE,GAAG,CAAE,EAAE,MAAM,CAAC,OAAO,CAAC,GAAI,CAAC,OAAO,CAAE,MAAM,CAAE,EAAE,MAAM,CAAE,CAAC;YAChG,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,MAAM,gBAAgB,GAAG,CAAE,QAAkB,EAAG,EAAE;QAChD,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC;QACvC,QAAQ,CAAC,MAAM,GAAG,CAAE,MAA2C,EAAG,EAAE;YAClE,OAAO,gBAAgB,CAAE,MAAM,CAAE;iBAC9B,IAAI,CAAE,cAAc,CAAE,CAAC;QAC5B,CAAC,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;QAClB,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACrB,IAAI,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACpB,gBAAgB;KACjB,CAAC;AACJ,CAAC,CAAC;AA7BW,QAAA,oBAAoB,GAApB,oBAAoB,CA6B/B"}

package/build/adapters/endpoints/addDevAuthUser/index.d.ts

@@ -0,0 +1,32 @@
+import { EndpointActionParams, EndpointsAdapter } from '@bett3r-dev/pv3-types';
+/**
+ * A pre-action interceptor. Receives the action params, returns the same
+ * (or a transformed) params object. May be sync or async.
+ *
+ * Typical use is to populate `params.context.user` from whatever credential
+ * the deployment supplies (a JWT in `Authorization`, an opaque session
+ * cookie, upstream-gateway headers, etc.). All such concerns live in
+ * consumer code so this adapter carries no transport, provider, or
+ * authentication-library knowledge.
+ *
+ * Returning the params unmodified is a valid no-op.
+ */
+export type RequestInterceptor = (params: EndpointActionParams) => Promise<EndpointActionParams> | EndpointActionParams;
+/**
+ * Endpoints adapter that runs a consumer-supplied interceptor before each
+ * endpoint's action. The interceptor is the only injection point — this
+ * adapter has no opinion about how identity is resolved, where credentials
+ * live, or which libraries verify them.
+ *
+ * When `interceptor` is omitted, the adapter is a no-op (every endpoint
+ * action runs unchanged), which lets callers wire the adapter
+ * unconditionally even when the dev-only interceptor build failed (e.g.,
+ * because optional auth-resolution dependencies aren't installed in a
+ * production image).
+ *
+ * Naming: kept as `AddDevAuthUserToRequest` for backwards compatibility
+ * with existing call sites. The semantics are now generic — see
+ * `RequestInterceptor`.
+ */
+export declare const AddDevAuthUserToRequest: (interceptor?: RequestInterceptor) => EndpointsAdapter;
+//# sourceMappingURL=index.d.ts.map

package/build/adapters/endpoints/addDevAuthUser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/endpoints/addDevAuthUser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,MAAM,EAAE,oBAAoB,KACzB,OAAO,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAAC;AAE1D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,uBAAuB,iBACpB,kBAAkB,KAC/B,gBAiBF,CAAC"}

package/build/adapters/endpoints/addDevAuthUser/index.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddDevAuthUserToRequest = void 0;
+/**
+ * Endpoints adapter that runs a consumer-supplied interceptor before each
+ * endpoint's action. The interceptor is the only injection point — this
+ * adapter has no opinion about how identity is resolved, where credentials
+ * live, or which libraries verify them.
+ *
+ * When `interceptor` is omitted, the adapter is a no-op (every endpoint
+ * action runs unchanged), which lets callers wire the adapter
+ * unconditionally even when the dev-only interceptor build failed (e.g.,
+ * because optional auth-resolution dependencies aren't installed in a
+ * production image).
+ *
+ * Naming: kept as `AddDevAuthUserToRequest` for backwards compatibility
+ * with existing call sites. The semantics are now generic — see
+ * `RequestInterceptor`.
+ */
+const AddDevAuthUserToRequest = (interceptor) => {
+    const registerEndpoint = (endpoint) => {
+        if (!interceptor)
+            return endpoint;
+        const originalAction = endpoint.action;
+        endpoint.action = (params) => {
+            return Promise.resolve(interceptor(params)).then(originalAction);
+        };
+        return endpoint;
+    };
+    return {
+        _adapter: () => { },
+        name: 'addDevAuthUser',
+        start: async () => { },
+        stop: async () => { },
+        registerEndpoint
+    };
+};
+exports.AddDevAuthUserToRequest = AddDevAuthUserToRequest;
+//# sourceMappingURL=index.js.map

package/build/adapters/endpoints/addDevAuthUser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/endpoints/addDevAuthUser/index.ts"],"names":[],"mappings":";;;AAkBA;;;;;;;;;;;;;;;GAeG;AACI,MAAM,uBAAuB,GAAG,CACrC,WAAgC,EACd,EAAE;IACpB,MAAM,gBAAgB,GAAG,CAAE,QAAkB,EAAG,EAAE;QAChD,IAAK,CAAC,WAAW;YAAG,OAAO,QAAQ,CAAC;QACpC,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC;QACvC,QAAQ,CAAC,MAAM,GAAG,CAAE,MAA2C,EAAG,EAAE;YAClE,OAAO,OAAO,CAAC,OAAO,CAAE,WAAW,CAAE,MAAM,CAAE,CAAC,CAAC,IAAI,CAAE,cAAc,CAAE,CAAC;QACxE,CAAC,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;QAClB,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACrB,IAAI,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACpB,gBAAgB;KACjB,CAAC;AACJ,CAAC,CAAC;AAnBW,QAAA,uBAAuB,GAAvB,uBAAuB,CAmBlC"}

package/build/adapters/endpoints/asyncLocalStorage/__tests__/asyncLocalStorage.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=asyncLocalStorage.test.d.ts.map

package/build/adapters/endpoints/asyncLocalStorage/__tests__/asyncLocalStorage.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncLocalStorage.test.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/endpoints/asyncLocalStorage/__tests__/asyncLocalStorage.test.ts"],"names":[],"mappings":""}

package/build/adapters/endpoints/asyncLocalStorage/__tests__/asyncLocalStorage.test.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const executionContext_1 = require("../../../../libraries/eventsourcing/executionContext");
+const __1 = require("..");
+const buildEndpoint = (action) => ({
+    name: 'test',
+    loggingModule: 'test',
+    route: '/test',
+    method: 'GET',
+    action,
+    schemas: {}
+});
+/**
+ * The shape every real `extractContext` in this ecosystem has: it enumerates every
+ * field it knows about and returns `correlationId` / `causationId` EXPLICITLY as
+ * `undefined` when the request carries none. That is exactly what a naive
+ * `{ ...outer, ...ctx }` would use to erase an inherited correlation, and why the
+ * adapter drops undefined-valued keys before overriding.
+ */
+const requestShapedExtractor = (params) => {
+    const accountId = params.context?.user?.accountId;
+    const userId = params.context?.user?.id;
+    const correlationId = params.query?.correlationId;
+    const causationId = params.query?.causationId;
+    if (!accountId && !userId && !correlationId && !causationId)
+        return undefined;
+    return {
+        accountId: accountId ?? '',
+        userId: userId ?? '',
+        correlationId,
+        causationId
+    };
+};
+describe('AsyncLocalStorageContext adapter', () => {
+    const adapter = (0, __1.AsyncLocalStorageContext)(requestShapedExtractor);
+    const runEndpoint = async (params) => {
+        let seen;
+        const ep = adapter.registerEndpoint(buildEndpoint(async () => { seen = (0, executionContext_1.getExecutionContext)(); }));
+        await ep.action(params);
+        return seen;
+    };
+    it('establishes the extracted context when there is no outer one', async () => {
+        const seen = await runEndpoint({ context: { user: { id: 'u1', accountId: 'a1' } }, query: {} });
+        expect(seen).toMatchObject({ accountId: 'a1', userId: 'u1' });
+    });
+    it('runs the action with NO context when the extractor declines', async () => {
+        const seen = await runEndpoint({ context: {}, query: {} });
+        expect(seen).toBeUndefined();
+    });
+    it('INHERITS an ambient field the request cannot carry (tags) into a nested endpoint call', async () => {
+        // The whole point: an in-process caller (a worker, a policy, another endpoint
+        // action) sets ambient context and dispatches through the client library. The
+        // request itself has no transport for `tags`, so replacing the store would drop it.
+        const seen = await (0, executionContext_1.runWithExecutionContext)({ accountId: 'a1', userId: 'u1', correlationId: 'outer-corr', tags: { channelSyncReason: 'observationGoLive' } }, () => runEndpoint({ context: { user: { id: 'u1', accountId: 'a1' } }, query: {} }));
+        expect(seen?.tags).toEqual({ channelSyncReason: 'observationGoLive' });
+    });
+    it('INHERITS `userAttributes` across a hop, so an authorization tier needs no forgeable header', async () => {
+        // The reason this field exists. A hop serializes its identity into `x-auth-*`
+        // headers on a synthetic request, and a header is forgeable by anything that can
+        // set one. `userAttributes` has no transport at all: it survives the hop purely by
+        // this inherit-and-override merge, so a host can carry an authorization-scope map
+        // (or an acting principal) in-process without widening the forgeable surface.
+        const seen = await (0, executionContext_1.runWithExecutionContext)({
+            accountId: 'a1',
+            userId: 'u1',
+            userAttributes: { scopesByCapability: { 'sales:order-read': 'own' }, executedBy: 'system@a1' }
+        }, () => runEndpoint({ context: { user: { id: 'u1', accountId: 'a1' } }, query: {} }));
+        expect(seen?.userAttributes).toEqual({
+            scopesByCapability: { 'sales:order-read': 'own' },
+            executedBy: 'system@a1'
+        });
+    });
+    it('does NOT let an extractor emitting `correlationId: undefined` clobber the inherited correlation', async () => {
+        const seen = await (0, executionContext_1.runWithExecutionContext)({ accountId: 'a1', userId: 'u1', correlationId: 'outer-corr', causationId: 'outer-caus' }, () => runEndpoint({ context: { user: { id: 'u1', accountId: 'a1' } }, query: {} }));
+        expect(seen?.correlationId).toBe('outer-corr');
+        expect(seen?.causationId).toBe('outer-caus');
+    });
+    it('still lets the REQUEST win for every field it actually defines', async () => {
+        const seen = await (0, executionContext_1.runWithExecutionContext)({ accountId: 'outer-account', userId: 'outer-user', correlationId: 'outer-corr', tags: { t: '1' } }, () => runEndpoint({
+            context: { user: { id: 'inner-user', accountId: 'inner-account' } },
+            query: { correlationId: 'inner-corr' }
+        }));
+        expect(seen).toMatchObject({
+            accountId: 'inner-account',
+            userId: 'inner-user',
+            correlationId: 'inner-corr',
+            tags: { t: '1' }
+        });
+    });
+    it('restores the OUTER context after the nested action resolves', async () => {
+        await (0, executionContext_1.runWithExecutionContext)({ accountId: 'a1', userId: 'u1', tags: { t: '1' } }, async () => {
+            await runEndpoint({ context: { user: { id: 'u2', accountId: 'a2' } }, query: {} });
+            expect((0, executionContext_1.getExecutionContext)()).toEqual({ accountId: 'a1', userId: 'u1', tags: { t: '1' } });
+        });
+    });
+});
+//# sourceMappingURL=asyncLocalStorage.test.js.map