@bett3r-dev/pv3 1.0.0 → 2.5.1

package/build/libraries/tcp/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/libraries/tcp/types.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAG7B,MAAM,MAAM,WAAW,GAAG;IAAE,CAAC,EAAE,EAAC,MAAM,GAAC,MAAM,GAAI,SAAS,CAAA;CAAE,CAAA;AAE5D,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,CAAE,OAAO,EAAE,MAAM,KAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5C,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IAC/C,kBAAkB,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACrC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IAC9D,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9B,SAAS,EAAE,CAAE,OAAO,EAAE,MAAM,KAAM,IAAI,CAAC;CACxC,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,yBAAyB,EAAE,CAAE,MAAM,EAAE,SAAS,KAAM,IAAI,CAAC;IACzD,OAAO,EAAE,0BAA0B,CAAA;CACpC,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,0BAA0B,GAAG;IACzD,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAC9B,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,CAAC;AAElE,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,kBAAkB,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACrC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IACxC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,CAAE,OAAO,EAAE,MAAM,KAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3C,OAAO,EAAE,CAAE,KAAK,CAAC,EAAE,KAAK,KAAM,SAAS,CAAA;CACxC,CAAA;AAGD,MAAM,MAAM,OAAO,GAAG;IACpB,eAAe,EAAE,CAAE,OAAO,EAAC,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,KAAM,OAAO,CAAC,eAAe,CAAC,CAAC;IACvH,eAAe,EAAE,CAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAM,OAAO,CAAC,eAAe,CAAC,CAAC;CACvG,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/libraries/tcp/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAE7B,MAAM,MAAM,WAAW,GAAG;IAAC,CAAC,EAAE,EAAC,MAAM,GAAG,MAAM,GAAI,SAAS,CAAA;CAAE,CAAC;AAE9D,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,CAAE,OAAO,EAAE,MAAM,KAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5C,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,kBAAkB,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACrC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9B,SAAS,EAAE,CAAE,OAAO,EAAE,MAAM,KAAM,IAAI,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,yBAAyB,EAAE,CAAE,MAAM,EAAE,SAAS,KAAM,IAAI,CAAC;IACzD,OAAO,EAAE,0BAA0B,CAAA;CACpC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,0BAA0B,GAAG;IACzD,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAC9B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,kBAAkB,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACrC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IACxC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,CAAE,OAAO,EAAE,MAAM,KAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3C,OAAO,EAAE,CAAE,KAAK,CAAC,EAAE,KAAK,KAAM,SAAS,CAAA;CACxC,CAAC;AAGF,MAAM,MAAM,OAAO,GAAG;IACpB,eAAe,EAAE,CAAE,OAAO,EAAC,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,KAAM,OAAO,CAAC,eAAe,CAAC,CAAC;IACvH,eAAe,EAAE,CAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAM,OAAO,CAAC,eAAe,CAAC,CAAC;CACvG,CAAC"}

package/build/libraries/validation/__tests__/readmodelQuerySchema.test.d.ts

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

package/build/libraries/validation/__tests__/readmodelQuerySchema.test.d.ts.map

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

package/build/libraries/validation/__tests__/readmodelQuerySchema.test.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const pv3_types_1 = require("@bett3r-dev/pv3-types");
+const index_1 = require("../index");
+/**
+ * TV1-2342 — the readmodel query schema must COMPILE, with both filter-bearing properties present.
+ *
+ * `ReadmodelDefaultQuerySchema` embeds the recursive filter schema TWICE: once at `filter`, and
+ * once at `aggregate.filter`. A JSON Schema document may carry a given `$id` only once — ajv
+ * rejects a second occurrence with `reference "<id>" resolves to more than one schema`, and it
+ * does so at COMPILE time, so the failure is not "this filter is invalid" but "no request to this
+ * readmodel can be validated at all". Nothing else in pv3 compiles this document, which is why the
+ * defect shipped green: it surfaced downstream, in a consumer, as a fail-open.
+ */
+describe('ReadmodelDefaultQuerySchema', () => {
+    it('Given a query carrying BOTH a filter and an aggregate.filter when it is validated then the schema compiles and accepts it', () => {
+        const query = {
+            limit: 10,
+            filter: [{ field: 'status', op: 'eq', value: 'open' }],
+            aggregate: {
+                groupBy: ['itemId'],
+                aggregates: [{ fn: 'sum', field: 'outstanding', as: 'net' }],
+                filter: [{ field: 'status', op: 'eq', value: 'open' }]
+            }
+        };
+        expect(() => (0, index_1.validateSchema)(pv3_types_1.ReadmodelDefaultQuerySchema)(query)).not.toThrow();
+    });
+    it('Given a recursive OR inside the AGGREGATE filter when it is validated then the self-reference still resolves', () => {
+        const query = {
+            aggregate: {
+                groupBy: ['itemId'],
+                aggregates: [{ fn: 'count', as: 'n' }],
+                filter: [{ OR: [{ field: 'status', op: 'eq', value: 'open' }, { field: 'status', op: 'eq', value: 'closed' }] }]
+            }
+        };
+        expect(() => (0, index_1.validateSchema)(pv3_types_1.ReadmodelDefaultQuerySchema)(query)).not.toThrow();
+    });
+});
+/**
+ * The keyset cursor's domain is the KEY COLUMN's domain, not `number`.
+ *
+ * A generated `<Readmodel>ListNode` pages by ordering on the primary key ASC and setting `after`
+ * to the LAST ROW'S KEY. For every readmodel keyed on a uuid/text `id` that key is a STRING, so
+ * `after: S.number()` rejected page 2 onward at the route — while page 1, which carries no cursor,
+ * validated fine and read as a complete result set. The failure was therefore invisible until a
+ * readmodel outgrew one page: a wrong answer that looks like a right one.
+ *
+ * These walk the paging contract rather than asserting the schema shape, because the shape is not
+ * what broke — the ROUTE ADMITTING THE SECOND PAGE is.
+ */
+describe('ReadmodelDefaultQuerySchema — the `after` keyset cursor', () => {
+    const PAGE_SIZE = 200;
+    // The route compiles the query schema with `coerceTypes: true` (see
+    // `adapters/endpoints/endpointValidation`), so validate the way the route does.
+    const validateAsRoute = (query) => (0, index_1.validateSchema)(pv3_types_1.ReadmodelDefaultQuerySchema, true)(query);
+    /**
+     * Walks a fixture the way `streamReadmodelQuery` walks a readmodel: sort by key asc, take a
+     * page, then set the cursor to the last row's key. Every page's params go through the ROUTE's
+     * validation first, so a cursor the schema refuses surfaces here exactly as it does in
+     * production — as a thrown ValidationError, not as an empty page.
+     */
+    const walkPages = (rows) => {
+        const pages = [];
+        let cursor = undefined;
+        for (let guard = 0; guard < 10; guard++) {
+            const query = { limit: PAGE_SIZE, sort: [{ field: 'id', direction: 'asc' }], ...(cursor !== undefined ? { after: cursor } : {}) };
+            validateAsRoute(query);
+            const page = rows.filter(row => cursor === undefined || row.id > cursor).slice(0, PAGE_SIZE);
+            if (!page.length)
+                break;
+            pages.push(page);
+            if (page.length < PAGE_SIZE)
+                break;
+            cursor = page[page.length - 1].id;
+        }
+        return pages;
+    };
+    it('Given a STRING-keyed readmodel larger than one page when it is paged then page 2 is admitted and returns its rows', () => {
+        // Zero-padded so lexical order matches insertion order — the same ordering the adapter's
+        // `id > $1` gives on a text column.
+        const rows = Array.from({ length: 250 }, (_, i) => ({ id: `item-${String(i).padStart(4, '0')}` }));
+        const pages = walkPages(rows);
+        expect(pages).toHaveLength(2);
+        expect(pages[0]).toHaveLength(PAGE_SIZE);
+        expect(pages[1]).toHaveLength(50);
+        expect(pages.flat()).toHaveLength(rows.length);
+        expect(pages[1][0].id).toBe('item-0200');
+    });
+    it('Given a NUMERIC-keyed readmodel when it is paged then the widened cursor still admits page 2', () => {
+        const rows = Array.from({ length: 250 }, (_, i) => ({ id: i }));
+        const pages = walkPages(rows);
+        expect(pages).toHaveLength(2);
+        expect(pages[1]).toHaveLength(50);
+        expect(pages[1][0].id).toBe(200);
+    });
+    it('Given a cursor that is neither a string nor a number when it is validated then the route still rejects it', () => {
+        expect(() => validateAsRoute({ limit: PAGE_SIZE, after: { nested: true } })).toThrow();
+    });
+});
+//# sourceMappingURL=readmodelQuerySchema.test.js.map

package/build/libraries/validation/__tests__/readmodelQuerySchema.test.js.map

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

package/build/libraries/validation/__tests__/validation.test.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };

package/build/libraries/validation/__tests__/validation.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.test.js","sourceRoot":"","sources":["../../../../src/libraries/validation/__tests__/validation.test.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wFAA+C;AAC/C,+CAAiC;AAEjC,QAAQ,CAAE,YAAY,EAAE,GAAG,EAAE;IAC3B,QAAQ,CAAE,gBAAgB,EAAE,GAAG,EAAE;QAC/B,MAAM,MAAM,GAAG,4BAAC,CAAC,KAAK,CAAC;YACrB,MAAM,EAAE,4BAAC,CAAC,MAAM,EAAE;YAClB,MAAM,EAAE,4BAAC,CAAC,MAAM,EAAE;SACnB,CAAC,CAAC;QAEH,EAAE,CAAE,8CAA8C,EAAE,GAAG,EAAE;YACvD,MAAM,GAAG,GAAG,UAAU,CAAC,cAAc,CAAE,MAAM,CAAE,CAAC,EAAE,MAAM,EAAC,MAAM,EAAE,MAAM,EAAC,EAAE,EAAE,CAAC,CAAC;YAC9E,MAAM,CAAE,GAAG,CAAE,CAAC,OAAO,CAAC,EAAE,MAAM,EAAC,MAAM,EAAE,MAAM,EAAC,EAAE,EAAE,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QACH,EAAE,CAAE,uDAAuD,EAAE,GAAG,EAAE;YAChE,IAAG;gBACD,iCAAiC;gBACjC,UAAU,CAAC,cAAc,CAAE,MAAM,CAAE,CAAC,EAAE,MAAM,EAAC,EAAE,EAAE,MAAM,EAAC,EAAE,EAAE,CAAC,CAAC;aAC/D;YAAC,OAAQ,GAAG,EAAG;gBACd,MAAM,CAAE,GAAG,CAAE,CAAC,cAAc,CAAE,KAAK,CAAE,CAAC;gBACtC,MAAM,CAAE,GAAG,CAAC,IAAI,CAAE,CAAC,OAAO,CAAE,iBAAiB,CAAE,CAAC;aACjD;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"validation.test.js","sourceRoot":"","sources":["../../../../src/libraries/validation/__tests__/validation.test.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wFAA+C;AAC/C,MAAY,UAAU,+BAAW;AAEjC,QAAQ,CAAE,YAAY,EAAE,GAAG,EAAE;IAC3B,QAAQ,CAAE,gBAAgB,EAAE,GAAG,EAAE;QAC/B,MAAM,MAAM,GAAG,4BAAC,CAAC,KAAK,CAAC;YACrB,MAAM,EAAE,4BAAC,CAAC,MAAM,EAAE;YAClB,MAAM,EAAE,4BAAC,CAAC,MAAM,EAAE;SACnB,CAAC,CAAC;QAEH,EAAE,CAAE,8CAA8C,EAAE,GAAG,EAAE;YACvD,MAAM,GAAG,GAAG,UAAU,CAAC,cAAc,CAAE,MAAM,CAAE,CAAC,EAAE,MAAM,EAAC,MAAM,EAAE,MAAM,EAAC,EAAE,EAAE,CAAC,CAAC;YAC9E,MAAM,CAAE,GAAG,CAAE,CAAC,OAAO,CAAC,EAAE,MAAM,EAAC,MAAM,EAAE,MAAM,EAAC,EAAE,EAAE,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QACH,EAAE,CAAE,uDAAuD,EAAE,GAAG,EAAE;YAChE,IAAG,CAAC;gBACF,iCAAiC;gBACjC,UAAU,CAAC,cAAc,CAAE,MAAM,CAAE,CAAC,EAAE,MAAM,EAAC,EAAE,EAAE,MAAM,EAAC,EAAE,EAAE,CAAC,CAAC;YAChE,CAAC;YAAC,OAAQ,GAAG,EAAG,CAAC;gBACf,MAAM,CAAE,GAAG,CAAE,CAAC,cAAc,CAAE,KAAK,CAAE,CAAC;gBACtC,MAAM,CAAE,GAAG,CAAC,IAAI,CAAE,CAAC,OAAO,CAAE,iBAAiB,CAAE,CAAC;YAClD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/libraries/validation/index.d.ts

@@ -1,8 +1,8 @@
 import { BaseSchema } from '@bett3r-dev/jsonschema-definer';
 import { EndpointActionParams, EndpointSchemas } from '@bett3r-dev/pv3-types';
-export declare const validateSchema: <T>(schema: BaseSchema<T, true, Readonly<import("@bett3r-dev/jsonschema-definer/dist/base").BaseJsonSchema>>, coerceTypes?: boolean) => (value: T) => T;
-export declare const validateEndpoint: <B = any, Q = any, P = any>(validateSchema: <T>(schema: BaseSchema<T, true, Readonly<import("@bett3r-dev/jsonschema-definer/dist/base").BaseJsonSchema>>) => (value: T) => T, schemas?: EndpointSchemas<B, Q, P> | undefined) => (epParams: EndpointActionParams<B>) => Promise<EndpointActionParams<B>>;
+export declare const validateSchema: <T>(schema: BaseSchema<T>, coerceTypes?: boolean) => (value: T) => T;
+export declare const validateEndpoint: <B = any, Q = any, P = any>(validateSchema: <T>(schema: BaseSchema<T>, coerceTypes?: boolean) => (value: T) => T, schemas?: EndpointSchemas<B, Q, P>, coerceTypes?: boolean) => (epParams: EndpointActionParams<B>) => Promise<EndpointActionParams<B>>;
 export declare function dieOnError(logger?: {
     error: (err: any) => void;
-}, err?: any): (err: any) => any;
+}, err?: any): (err: any) => /*elided*/ any;
 //# sourceMappingURL=index.d.ts.map

package/build/libraries/validation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/libraries/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAoB9E,eAAO,MAAM,cAAc,yJAU1B,CAAC;AAEF,eAAO,MAAM,gBAAgB,0SAQ5B,CAAC;AAEF,wBAAgB,UAAU,CAAG,MAAM,GAAE;IAAC,KAAK,EAAE,CAAE,GAAG,EAAC,GAAG,KAAM,IAAI,CAAA;CAAW,EAAE,GAAG,CAAC,EAAE,GAAG,SACxC,GAAG,SAGhD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/libraries/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAmB,MAAM,uBAAuB,CAAC;AAqC/F,eAAO,MAAM,cAAc,GAAI,CAAC,UAAW,UAAU,CAAC,CAAC,CAAC,oCAAkC,CAAC,KAAI,CAoB9F,CAAC;AAWF,eAAO,MAAM,gBAAgB,GAAI,CAAC,GAAC,GAAG,EAAC,CAAC,GAAC,GAAG,EAAC,CAAC,GAAC,GAAG,kBAAmB,CAAC,CAAC,EAAG,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,OAAO,KAAM,CAAE,KAAK,EAAC,CAAC,KAAM,CAAC,YAAY,eAAe,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,gBAAgB,OAAO,gBAAwB,oBAAoB,CAAC,CAAC,CAAC,KAAI,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAQtR,CAAC;AAEF,wBAAgB,UAAU,CAAG,MAAM,GAAE;IAAE,KAAK,EAAE,CAAE,GAAG,EAAC,GAAG,KAAM,IAAI,CAAA;CAAY,EAAE,GAAG,CAAC,EAAE,GAAG,SAC1C,GAAG,oBAGhD"}

package/build/libraries/validation/index.js

@@ -3,40 +3,75 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.dieOnError = exports.validateEndpoint = exports.validateSchema = void 0;
+exports.validateEndpoint = exports.validateSchema = void 0;
+exports.dieOnError = dieOnError;
+const pv3_types_1 = require("@bett3r-dev/pv3-types");
 const ajv_1 = __importDefault(require("ajv"));
 const ajv_formats_1 = __importDefault(require("ajv-formats"));
-const utils_1 = require("../../utils");
-const ajv = new ajv_1.default({ allErrors: true, schemaId: '$id', useDefaults: true });
+const ajv = new ajv_1.default({ allErrors: true, schemaId: '$id', useDefaults: true, strict: false });
+ajv.addKeyword({
+    keyword: 'x-friendly-name',
+    metaSchema: {
+        type: 'object',
+        additionalProperties: { type: 'string' }
+    },
+    // annotation-only: do nothing, always valid
+    validate: () => true
+});
+ajv.addKeyword({
+    keyword: 'x-response-query-schema',
+    metaSchema: {
+        type: 'object',
+        additionalProperties: { type: 'string' }
+    },
+    // annotation-only: do nothing, always valid
+    validate: () => true
+});
 (0, ajv_formats_1.default)(ajv);
 const schemas = new WeakMap();
 const getCompiledSchema = (schema, coerceTypes) => {
     ajv.opts.coerceTypes = coerceTypes;
-    const compiled = schemas.get(schema);
-    if (!compiled) {
+    const validate = schemas.get(schema);
+    if (!validate) {
         const compiled = ajv.compile(schema);
         schemas.set(schema, compiled);
         return compiled;
     }
-    return compiled;
+    return validate;
 };
 const validateSchema = (schema, coerceTypes = false) => (value) => {
-    const compiled = getCompiledSchema(schema.plain, coerceTypes);
+    const validate = getCompiledSchema(schema.plain, coerceTypes);
+    if (schema.isRequired === false && !value) {
+        value = {};
+        validate(value);
+        return value;
+    }
     if (schema === null && value !== undefined) {
-        throw (0, utils_1.createError)((0, utils_1.ValidationError)(), { description: 'Must not have body', details: [value] });
+        throw new pv3_types_1.ValidationError('Must not have body', 'VALIDATION_ERROR', { value });
     }
-    if (!compiled(value)) {
-        throw (0, utils_1.createError)((0, utils_1.ValidationError)(), { description: 'Validation Error', details: compiled.errors });
+    if (!validate(value)) {
+        throw new pv3_types_1.ValidationError('Validation Error', 'VALIDATION_ERROR', {
+            errors: validate.errors,
+            value
+        });
     }
     return value;
 };
 exports.validateSchema = validateSchema;
-const validateEndpoint = (validateSchema, schemas) => async (epParams) => {
+const INFRA_QUERY_PARAMS = ['correlationId', 'causationId'];
+const stripInfraParams = (query) => {
+    if (!query || typeof query !== 'object')
+        return query;
+    const cleaned = { ...query };
+    INFRA_QUERY_PARAMS.forEach((key) => delete cleaned[key]);
+    return cleaned;
+};
+const validateEndpoint = (validateSchema, schemas, coerceTypes) => async (epParams) => {
     const response = {
         ...epParams,
-        query: schemas?.query && epParams.query ? validateSchema(schemas.query)(epParams.query) : epParams.query,
-        params: schemas?.params && epParams.params ? validateSchema(schemas.params)(epParams.params) : epParams.params,
-        body: schemas?.body && epParams.body ? validateSchema(schemas.body)(epParams.body) : epParams.body
+        query: schemas?.query && epParams.query ? validateSchema(schemas.query, coerceTypes)(stripInfraParams(epParams.query)) : epParams.query,
+        params: schemas?.params && epParams.params ? validateSchema(schemas.params, coerceTypes)(epParams.params) : epParams.params,
+        body: schemas?.body && epParams.body ? validateSchema(schemas.body, coerceTypes)(epParams.body) : epParams.body
     };
     return response;
 };
@@ -47,5 +82,4 @@ function dieOnError(logger = console, err) {
     logger.error(err);
     process.exit(1);
 }
-exports.dieOnError = dieOnError;
 //# sourceMappingURL=index.js.map

package/build/libraries/validation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/libraries/validation/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/libraries/validation/index.ts"],"names":[],"mappings":";;;;;;;AACA,qDAA+F;AAC/F,8CAAsB;AACtB,8DAAqC;AAErC,MAAM,GAAG,GAAG,IAAI,aAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5F,GAAG,CAAC,UAAU,CAAC;IACb,OAAO,EAAE,iBAAiB;IAC1B,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,oBAAoB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACzC;IACD,4CAA4C;IAC5C,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI;CACrB,CAAC,CAAC;AACH,GAAG,CAAC,UAAU,CAAC;IACb,OAAO,EAAE,yBAAyB;IAClC,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,oBAAoB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACzC;IACD,4CAA4C;IAC5C,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI;CACrB,CAAC,CAAC;AACH,IAAA,qBAAU,EAAE,GAAG,CAAE,CAAC;AAClB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,MAAM,iBAAiB,GAAG,CAAE,MAAc,EAAE,WAAoB,EAAG,EAAE;IACnE,GAAG,CAAC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACnC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAE,MAAM,CAAE,CAAC;IACvC,IAAK,CAAC,QAAQ,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAE,MAAM,CAAE,CAAC;QACvC,OAAO,CAAC,GAAG,CAAE,MAAM,EAAE,QAAQ,CAAE,CAAC;QAChC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEK,MAAM,cAAc,GAAG,CAAK,MAAqB,EAAE,WAAW,GAAG,KAAK,EAAE,EAAE,CAAC,CAAE,KAAO,EAAM,EAAE;IACjG,MAAM,QAAQ,GAAG,iBAAiB,CAAE,MAAM,CAAC,KAAK,EAAE,WAAW,CAAE,CAAC;IAEhE,IAAK,MAAM,CAAC,UAAU,KAAK,KAAK,IAAI,CAAC,KAAK,EAAG,CAAC;QAC5C,KAAK,GAAG,EAAO,CAAC;QAChB,QAAQ,CAAE,KAAK,CAAE,CAAC;QAClB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAK,MAAM,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5C,MAAM,IAAI,2BAAe,CAAE,oBAAoB,EAAE,kBAAkB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,IAAK,CAAC,QAAQ,CAAE,KAAK,CAAE,EAAC,CAAC;QACvB,MAAM,IAAI,2BAAe,CAAE,kBAAkB,EAAE,kBAAkB,EAAE;YACjE,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AApBW,QAAA,cAAc,GAAd,cAAc,CAoBzB;AAEF,MAAM,kBAAkB,GAAG,CAAE,eAAe,EAAE,aAAa,CAAE,CAAC;AAE9D,MAAM,gBAAgB,GAAG,CAAE,KAAU,EAAG,EAAE;IACxC,IAAK,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAG,OAAO,KAAK,CAAC;IACxD,MAAM,OAAO,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;IAC7B,kBAAkB,CAAC,OAAO,CAAC,CAAE,GAAG,EAAG,EAAE,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3D,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEK,MAAM,gBAAgB,GAAG,CAAqB,cAAuF,EAAE,OAAgC,EAAE,WAAqB,EAAG,EAAE,CAAC,KAAK,EAAG,QAAiC,EAAqC,EAAE;IACzR,MAAM,QAAQ,GAAG;QACf,GAAG,QAAQ;QACX,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAE,OAAO,CAAC,KAAK,EAAE,WAAW,CAAE,CAAE,gBAAgB,CAAE,QAAQ,CAAC,KAAK,CAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK;QAC5I,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAE,OAAO,CAAC,MAAM,EAAE,WAAW,CAAE,CAAE,QAAQ,CAAC,MAAM,CAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM;QAC/H,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAE,OAAO,CAAC,IAAI,EAAE,WAAW,CAAE,CAAE,QAAQ,CAAC,IAAI,CAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI;KACpH,CAAC;IACF,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AARW,QAAA,gBAAgB,GAAhB,gBAAgB,CAQ3B;AAEF,oBAA6B,MAAM,GAAmC,OAAO,EAAE,GAAS;IACtF,IAAK,SAAS,CAAC,MAAM,KAAK,CAAC;QAAG,OAAO,CAAE,GAAQ,EAAG,EAAE,CAAC,UAAU,CAAE,MAAM,EAAE,GAAG,CAAE,CAAC;IAC/E,MAAM,CAAC,KAAK,CAAE,GAAG,CAAE,CAAC;IACpB,OAAO,CAAC,IAAI,CAAE,CAAC,CAAE,CAAC;AACpB,CAAC"}

package/build/ports/authentication/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ports/authentication/index.ts"],"names":[],"mappings":";;;AAKA,kCAAqC;AAErC;;;;GAIG;AACI,MAAM,cAAc,GAAG,CAAE,OAA8B,EAAE,iBAA0C,EAAuB,EAAE;IACjI,MAAM,cAAc,GAAG,IAAA,iBAAU,EAAC;QAChC,GAAG,OAAO;QACV,YAAY,EAAE,iBAAiB;KAChC,CAAC,CAAC;IACH,OAAO,CAAC,KAAK,EAAE;SACZ,IAAI,CAAC,GAAG,EAAE;QACT,cAAc,CAAC,SAAS,GAAG,IAAI,CAAC;QAChC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAE,SAAS,CAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEL,OAAO,cAAc,CAAC;AACxB,CAAC,CAAC;AAZW,QAAA,cAAc,kBAYzB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ports/authentication/index.ts"],"names":[],"mappings":";;;AAKA,kCAAqC;AAErC;;;;GAIG;AACI,MAAM,cAAc,GAAG,CAAE,OAA8B,EAAE,iBAA0C,EAAuB,EAAE;IACjI,MAAM,cAAc,GAAG,IAAA,iBAAU,EAAC;QAChC,GAAG,OAAO;QACV,YAAY,EAAE,iBAAiB;KAChC,CAAC,CAAC;IACH,OAAO,CAAC,KAAK,EAAE;SACZ,IAAI,CAAC,GAAG,EAAE;QACT,cAAc,CAAC,SAAS,GAAG,IAAI,CAAC;QAChC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAE,SAAS,CAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEL,OAAO,cAAc,CAAC;AACxB,CAAC,CAAC;AAZW,QAAA,cAAc,GAAd,cAAc,CAYzB"}

package/build/ports/authentication/index.test.d.ts

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

package/build/ports/authentication/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../src/ports/authentication/index.test.ts"],"names":[],"mappings":""}

package/build/ports/authentication/index.test.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("./index");
+/**
+ * TV1-2057 regression guard — see cache/index.test.ts for the full bug description.
+ *
+ * The Authentication port returns the createPort instance directly and flips
+ * `isStarted` on that same instance from its eager `adapter.start().then(...)`, so
+ * a late `onStarted` reads a live `true` and fires. This test fails if Authentication
+ * is refactored into the EventStore-style spread-copy shape.
+ *
+ * PLAIN adapter double REQUIRED (a createPort-style adapter would shadow the port's
+ * lifecycle fields and mask the staleness bug).
+ */
+const plainAuthAdapter = () => ({
+    name: 'plain-auth',
+    _adapter: () => ({}),
+    start: async () => { },
+    stop: async () => { }
+});
+const routesAuthManager = (() => ({}));
+const tick = () => new Promise(r => setImmediate(r));
+describe('Authentication port — late onStarted (TV1-2057)', () => {
+    describe('Given a started Authentication port over a plain adapter', () => {
+        it('When onStarted is registered AFTER start, Then the hook still fires', async () => {
+            // Given — the eager `adapter.start().then(...)` has flipped isStarted
+            const authentication = (0, index_1.Authentication)(plainAuthAdapter(), routesAuthManager);
+            await tick();
+            // When — register the boot hook only after the port has started
+            let fired = false;
+            authentication.onStarted(() => { fired = true; });
+            await authentication.awaitStarted();
+            // Then — a spread-copied isStarted would leave this hook silently dropped
+            expect(fired).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/build/ports/authentication/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../../src/ports/authentication/index.test.ts"],"names":[],"mappings":";;AACA,mCAAyC;AAEzC;;;;;;;;;;GAUG;AACH,MAAM,gBAAgB,GAAG,GAA0B,EAAE,CAAC,CAAC;IACrD,IAAI,EAAE,YAAY;IAClB,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;IACpB,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;IACrB,IAAI,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;CACiB,CAAA,CAAC;AAExC,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAuC,CAAC;AAE7E,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,CAAC,YAAY,CAAE,CAAC,CAAE,CAAC,CAAC;AAE9D,QAAQ,CAAE,iDAAiD,EAAE,GAAG,EAAE;IAChE,QAAQ,CAAE,0DAA0D,EAAE,GAAG,EAAE;QACzE,EAAE,CAAE,qEAAqE,EAAE,KAAK,IAAI,EAAE;YACpF,sEAAsE;YACtE,MAAM,cAAc,GAAG,IAAA,sBAAc,EAAE,gBAAgB,EAAE,EAAE,iBAAiB,CAAE,CAAC;YAC/E,MAAM,IAAI,EAAE,CAAC;YACb,gEAAgE;YAChE,IAAI,KAAK,GAAG,KAAK,CAAC;YAClB,cAAc,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAClD,MAAM,cAAc,CAAC,YAAY,EAAE,CAAC;YACpC,0EAA0E;YAC1E,MAAM,CAAE,KAAK,CAAE,CAAC,IAAI,CAAE,IAAI,CAAE,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/ports/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/ports/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAwC,MAAM,uBAAuB,CAAC;AAE1F;;;GAGG;AACH,eAAO,MAAM,UAAU,0CAatB,CAAC"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/ports/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAwC,MAAM,uBAAuB,CAAC;AAE1F;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,IAAI,QAAS,IAAI,KAAI,IAAI,GAAG,WA+CtD,CAAC"}

package/build/ports/base.js

@@ -7,15 +7,49 @@ const pv3_types_1 = require("@bett3r-dev/pv3-types");
  * @param port The Port to instanciate.
  */
 const createPort = (port) => {
-    const emitter = new pv3_types_1.TypedEventEmitter();
-    emitter.setMaxListeners(100);
+    // A port may supply its OWN emitter — the configuration port does, because it needs a
+    // wider typed emitter ( `argsApplied` on top of `started`/`stopped` ). The `...port`
+    // spread below overwrites `instance.emitter` with that supplied emitter, so the
+    // `onStarted`/`onStopped` closures MUST bind to the same object — otherwise they
+    // listen on an emitter the port never emits `started`/`stopped` on, and every
+    // early-registered callback is silently dropped. (TV1-2069)
+    const emitter = port.emitter ?? new pv3_types_1.TypedEventEmitter();
+    emitter.setMaxListeners(200);
+    // Promises returned by async `onStarted` boot callbacks (e.g. readmodel
+    // `ensureIndex` migrations), collected so a port's `start()` can await them via
+    // `awaitStarted()`. A callback that returns nothing keeps its exact previous
+    // (synchronous) timing — only a returned promise is additionally tracked.
+    const startedPromises = [];
+    const runStartedCallback = (fn) => {
+        const result = fn();
+        if (result && typeof result.then === 'function')
+            startedPromises.push(result);
+    };
     const instance = {
         emitter,
         isStarted: false,
         onStarted: (fn) => {
-            if (instance.isStarted)
-                fn();
-            emitter.once('started', fn);
+            if (instance.isStarted) {
+                runStartedCallback(fn);
+                return;
+            }
+            emitter.once('started', () => runStartedCallback(fn));
+        },
+        awaitStarted: async () => {
+            // Drain in a loop: a boot callback may itself register further `onStarted`
+            // work while we are awaiting. Rethrow the first rejection so a failed boot
+            // callback surfaces loudly through the awaiting `start()` instead of
+            // becoming a swallowed unhandled rejection.
+            while (startedPromises.length) {
+                const pending = startedPromises.splice(0, startedPromises.length);
+                const settled = await Promise.allSettled(pending);
+                const rejected = settled.find((r) => r.status === 'rejected');
+                if (rejected)
+                    throw rejected.reason;
+            }
+        },
+        onStopped: (fn) => {
+            emitter.once('stopped', fn);
         },
         ...port
     };

package/build/ports/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/ports/base.ts"],"names":[],"mappings":";;;AAAA,qDAA0F;AAE1F;;;GAGG;AACI,MAAM,UAAU,GAAG,CAAQ,IAAU,EAAuB,EAAE;IACnE,MAAM,OAAO,GAAG,IAAI,6BAAiB,EAAqB,CAAC;IAC3D,OAAO,CAAC,eAAe,CAAE,GAAG,CAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG;QACf,OAAO;QACP,SAAS,EAAE,KAAK;QAChB,SAAS,EAAE,CAAE,EAAc,EAAG,EAAE;YAC9B,IAAK,QAAQ,CAAC,SAAS;gBAAG,EAAE,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAE,SAAS,EAAE,EAAE,CAAE,CAAC;QAChC,CAAC;QACD,GAAG,IAAI;KACR,CAAC;IACF,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAbW,QAAA,UAAU,cAarB"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/ports/base.ts"],"names":[],"mappings":";;;AAAA,qDAA0F;AAE1F;;;GAGG;AACI,MAAM,UAAU,GAAG,CAAQ,IAAU,EAAuB,EAAE;IACnE,sFAAsF;IACtF,qFAAqF;IACrF,gFAAgF;IAChF,iFAAiF;IACjF,8EAA8E;IAC9E,4DAA4D;IAC5D,MAAM,OAAO,GAAK,IAAqC,CAAC,OAAO,IAAI,IAAI,6BAAiB,EAAqB,CAAC;IAC9G,OAAO,CAAC,eAAe,CAAE,GAAG,CAAE,CAAC;IAC/B,wEAAwE;IACxE,gFAAgF;IAChF,6EAA6E;IAC7E,0EAA0E;IAC1E,MAAM,eAAe,GAAoB,EAAE,CAAC;IAC5C,MAAM,kBAAkB,GAAG,CAAE,EAA8B,EAAG,EAAE;QAC9D,MAAM,MAAM,GAAG,EAAE,EAAE,CAAC;QACpB,IAAK,MAAM,IAAI,OAAS,MAA6B,CAAC,IAAI,KAAK,UAAU;YACvE,eAAe,CAAC,IAAI,CAAE,MAAuB,CAAE,CAAC;IACpD,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG;QACf,OAAO;QACP,SAAS,EAAE,KAAK;QAChB,SAAS,EAAE,CAAE,EAA8B,EAAG,EAAE;YAC9C,IAAK,QAAQ,CAAC,SAAS,EAAG,CAAC;gBACzB,kBAAkB,CAAE,EAAE,CAAE,CAAC;gBACzB,OAAO;YACT,CAAC;YACD,OAAO,CAAC,IAAI,CAAE,SAAS,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAE,EAAE,CAAE,CAAC,CAAC;QAC3D,CAAC;QACD,YAAY,EAAE,KAAK,IAAmB,EAAE;YACtC,2EAA2E;YAC3E,2EAA2E;YAC3E,qEAAqE;YACrE,4CAA4C;YAC5C,OAAQ,eAAe,CAAC,MAAM,EAAG,CAAC;gBAChC,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAE,CAAC,EAAE,eAAe,CAAC,MAAM,CAAE,CAAC;gBACpE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAE,OAAO,CAAE,CAAC;gBACpD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAE,CAAC,EAA+B,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAE,CAAC;gBAC7F,IAAK,QAAQ;oBAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;YACxC,CAAC;QACH,CAAC;QACD,SAAS,EAAE,CAAE,EAAc,EAAG,EAAE;YAC9B,OAAO,CAAC,IAAI,CAAE,SAAS,EAAE,EAAE,CAAE,CAAC;QAChC,CAAC;QACD,GAAG,IAAI;KACR,CAAC;IACF,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AA/CW,QAAA,UAAU,GAAV,UAAU,CA+CrB"}

package/build/ports/base.test.d.ts

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

package/build/ports/base.test.d.ts.map

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

package/build/ports/base.test.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const memory_1 = require("../adapters/database/memory");
+const base_1 = require("./base");
+const database_1 = require("./database");
+const tick = (ms = 10) => new Promise(resolve => setTimeout(resolve, ms));
+describe('createPort — onStarted / awaitStarted', () => {
+    describe('Given an async boot callback that resolves', () => {
+        it('When the port emits started, Then awaitStarted waits for it to finish', async () => {
+            // Given
+            const port = (0, base_1.createPort)({ name: 'test' });
+            const order = [];
+            port.onStarted(async () => {
+                await tick();
+                order.push('boot-done');
+            });
+            // When
+            port.isStarted = true;
+            port.emitter.emit('started');
+            order.push('emit-returned');
+            await port.awaitStarted();
+            order.push('await-returned');
+            // Then — the boot work completed before awaitStarted resolved
+            expect(order).toEqual(['emit-returned', 'boot-done', 'await-returned']);
+        });
+    });
+    describe('Given an async boot callback that rejects', () => {
+        it('When awaitStarted is called, Then it rethrows the rejection', async () => {
+            // Given
+            const port = (0, base_1.createPort)({ name: 'test' });
+            const settled = [];
+            port.onStarted(async () => {
+                await tick();
+                settled.push('sibling-still-awaited');
+            });
+            port.onStarted(async () => {
+                throw new Error('index build failed');
+            });
+            // When
+            port.isStarted = true;
+            port.emitter.emit('started');
+            // Then
+            await expect(port.awaitStarted()).rejects.toThrow('index build failed');
+            // and a sibling boot callback still ran (allSettled, not fail-fast)
+            expect(settled).toContain('sibling-still-awaited');
+        });
+    });
+    describe('Given a synchronous () => void boot callback (legacy signature)', () => {
+        it('When the port emits started, Then the callback still runs', async () => {
+            // Given
+            const port = (0, base_1.createPort)({ name: 'test' });
+            let ran = false;
+            port.onStarted(() => { ran = true; });
+            // When
+            port.isStarted = true;
+            port.emitter.emit('started');
+            await port.awaitStarted();
+            // Then
+            expect(ran).toBe(true);
+        });
+    });
+});
+describe('Database port — start() awaits async boot work', () => {
+    describe('Given a readmodel-style async boot callback that rejects', () => {
+        it('When start() is awaited, Then it rejects loudly (fails before TV1-2041)', async () => {
+            // Given
+            const database = (0, database_1.Database)((0, memory_1.MemoryDb)());
+            database.onStarted(async () => {
+                throw new Error('ensureIndex failed');
+            });
+            // When / Then — before the fix start() === raw adapter.start and resolves,
+            // silently swallowing the boot rejection.
+            await expect(database.start()).rejects.toThrow('ensureIndex failed');
+        });
+    });
+    describe('Given an async boot callback that resolves slowly', () => {
+        it('When start() is awaited, Then it resolves only after boot work completes', async () => {
+            // Given
+            const database = (0, database_1.Database)((0, memory_1.MemoryDb)());
+            let bootComplete = false;
+            database.onStarted(async () => {
+                await tick(20);
+                bootComplete = true;
+            });
+            // When
+            await database.start();
+            // Then — start() did not resolve until the async boot callback finished
+            expect(bootComplete).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=base.test.js.map

package/build/ports/base.test.js.map

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

package/build/ports/cache/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ports/cache/index.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,kCAAqC;AAG9B,MAAM,KAAK,GAAG,CAAE,OAAqB,EAAc,EAAE;IAC1D,MAAM,KAAK,GAAG,IAAA,iBAAU,EAAE,OAAO,CAAE,CAAC;IACpC,OAAO,CAAC,KAAK,EAAE;SACZ,IAAI,CAAC,GAAG,EAAE;QACT,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;QACvB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAE,SAAS,CAAE,CAAC;IAClC,CAAC,CAAC,CAAC;IAEL,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AATW,QAAA,KAAK,SAShB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ports/cache/index.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,kCAAqC;AAG9B,MAAM,KAAK,GAAG,CAAE,OAAqB,EAAc,EAAE;IAC1D,MAAM,KAAK,GAAG,IAAA,iBAAU,EAAE,OAAO,CAAE,CAAC;IACpC,OAAO,CAAC,KAAK,EAAE;SACZ,IAAI,CAAC,GAAG,EAAE;QACT,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;QACvB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAE,SAAS,CAAE,CAAC;IAClC,CAAC,CAAC,CAAC;IAEL,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AATW,QAAA,KAAK,GAAL,KAAK,CAShB"}

package/build/ports/cache/index.test.d.ts

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

package/build/ports/cache/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../src/ports/cache/index.test.ts"],"names":[],"mappings":""}

package/build/ports/cache/index.test.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("./index");
+/**
+ * TV1-2057 regression guard.
+ *
+ * `createPort()` returns an object whose `onStarted` closes over the createPort
+ * `instance.isStarted`. A port that spreads `...createPort(...)` into a NEW object
+ * and flips the COPY of `isStarted` in its own `start()` leaves `onStarted` reading
+ * the stale original → an `onStarted` hook registered AFTER `start()` is silently
+ * dropped (the EventStore bug audited in TV1-2057).
+ *
+ * The Cache port returns the createPort instance directly and flips `isStarted` on
+ * that same instance, so it is NOT affected. This test locks that in: it fails if
+ * Cache is ever refactored into the spread-copy shape.
+ *
+ * A PLAIN adapter double (bare object) is REQUIRED. A createPort/DatabaseEventstore
+ * -style adapter shadows the port's own isStarted/onStarted/emitter fields and masks
+ * the bug — which is exactly why it hid in every harness suite.
+ */
+const plainCacheAdapter = () => ({
+    name: 'plain-cache',
+    _adapter: () => ({}),
+    start: async () => { },
+    stop: async () => { }
+});
+const tick = () => new Promise(r => setImmediate(r));
+describe('Cache port — late onStarted (TV1-2057)', () => {
+    describe('Given a started Cache port over a plain adapter', () => {
+        it('When onStarted is registered AFTER start, Then the hook still fires', async () => {
+            // Given — the eager `adapter.start().then(...)` has flipped isStarted
+            const cache = (0, index_1.Cache)(plainCacheAdapter());
+            await tick();
+            // When — register the boot hook only after the port has started
+            let fired = false;
+            cache.onStarted(() => { fired = true; });
+            await cache.awaitStarted();
+            // Then — a spread-copied isStarted would leave this hook silently dropped
+            expect(fired).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/build/ports/cache/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../../src/ports/cache/index.test.ts"],"names":[],"mappings":";;AACA,mCAAgC;AAEhC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,iBAAiB,GAAG,GAAiB,EAAE,CAAC,CAAC;IAC7C,IAAI,EAAE,aAAa;IACnB,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;IACpB,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;IACrB,IAAI,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;CACQ,CAAA,CAAC;AAE/B,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,CAAC,YAAY,CAAE,CAAC,CAAE,CAAC,CAAC;AAE9D,QAAQ,CAAE,wCAAwC,EAAE,GAAG,EAAE;IACvD,QAAQ,CAAE,iDAAiD,EAAE,GAAG,EAAE;QAChE,EAAE,CAAE,qEAAqE,EAAE,KAAK,IAAI,EAAE;YACpF,sEAAsE;YACtE,MAAM,KAAK,GAAG,IAAA,aAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;YAC1C,MAAM,IAAI,EAAE,CAAC;YACb,gEAAgE;YAChE,IAAI,KAAK,GAAG,KAAK,CAAC;YAClB,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACzC,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC;YAC3B,0EAA0E;YAC1E,MAAM,CAAE,KAAK,CAAE,CAAC,IAAI,CAAE,IAAI,CAAE,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/ports/configuration/__tests__/cliArgs.test.d.ts

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

package/build/ports/configuration/__tests__/cliArgs.test.d.ts.map

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