@bett3r-dev/pv3 1.0.0 → 1.1.7

package/build/ports/endpoints/__tests__/declarationSite.test.js

@@ -0,0 +1,165 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = __importDefault(require("path"));
+const declarationSite_1 = require("../declarationSite");
+const PORT_DIRECTORY = path_1.default.resolve(__dirname, '..');
+// In production the frames between the declaring file and here are the port's
+// own — declarationSite.ts and index.ts's `registerEndpoint`, both of which the
+// capture skips. So the caller of `getDeclarationSite` stands in for the
+// function that declared the endpoint.
+describe('getDeclarationSite', () => {
+    it('reports the file and the function that registered the endpoint', () => {
+        const registerHealthSyncEndpoints = () => (0, declarationSite_1.getDeclarationSite)('endpoint "Test"');
+        const site = registerHealthSyncEndpoints();
+        expect(site.filePath).toBe(path_1.default.resolve(__filename));
+        // The declaring function is what the manifest names the artifact after, so
+        // the selective loader resolves the export exactly instead of guessing.
+        expect(site.exportName).toBe('registerHealthSyncEndpoints');
+    });
+    it('still reports the file when the caller cannot be named', () => {
+        const site = (() => (0, declarationSite_1.getDeclarationSite)('endpoint "Test"'))();
+        expect(site.filePath).toBe(path_1.default.resolve(__filename));
+    });
+    it('skips the endpoints port itself rather than attributing the endpoint to pv3', () => {
+        const site = (0, declarationSite_1.getDeclarationSite)('endpoint "Test"');
+        // Without the frame filter this would be declarationSite.ts, and every
+        // endpoint in the manifest would be declared by pv3 instead of by its module.
+        expect(path_1.default.dirname(site.filePath)).not.toBe(PORT_DIRECTORY);
+        expect(site.filePath).toBe(path_1.default.resolve(__filename));
+    });
+    describe('frame resolution', () => {
+        it('skips the port when the stack reports src but the port was loaded from build', () => {
+            // A consumer under ts-node loads pv3 from `build/`, and source-map-support
+            // rewrites the frames back to `src/**.ts`. Keying the boundary off
+            // `__dirname` (the build tree) matched nothing, so every endpoint was
+            // attributed to declarationSite.ts and the whole manifest collapsed into
+            // one bogus artifact.
+            const site = (0, declarationSite_1.resolveDeclarationFrame)([
+                'Error',
+                '    at getDeclarationSite (/repo/pv3/packages/pv3/src/ports/endpoints/declarationSite.ts:78:20)',
+                '    at registerEndpoint (/repo/pv3/packages/pv3/src/ports/endpoints/index.ts:266:32)',
+                '    at registerHealthSyncEndpoints (/repo/teselly/src/modules/marketplace-health/healthSync.endpoints.ts:27:20)',
+                '    at create (/repo/teselly/src/modules/marketplace-health/index.ts:9:3)'
+            ]);
+            expect(site).toEqual({
+                filePath: '/repo/teselly/src/modules/marketplace-health/healthSync.endpoints.ts',
+                exportName: 'registerHealthSyncEndpoints',
+                kind: 'module'
+            });
+        });
+        it('reads through an anonymous frame and node internals', () => {
+            const site = (0, declarationSite_1.resolveDeclarationFrame)([
+                'Error',
+                '    at getDeclarationSite (/repo/pv3/build/ports/endpoints/declarationSite.js:60:20)',
+                '    at registerEndpoint (/repo/pv3/build/ports/endpoints/index.js:266:32)',
+                '    at Object.<anonymous> (/repo/teselly/src/modules/generic/upload.endpoints.ts:14:5)',
+                '    at node:internal/modules/cjs/loader:1105:14'
+            ]);
+            expect(site?.filePath).toBe('/repo/teselly/src/modules/generic/upload.endpoints.ts');
+            expect(site?.exportName).toBeUndefined();
+        });
+        it('reports nothing when every frame belongs to the port', () => {
+            expect((0, declarationSite_1.resolveDeclarationFrame)([
+                'Error',
+                '    at getDeclarationSite (/repo/pv3/src/ports/endpoints/declarationSite.ts:78:20)',
+                '    at registerEndpoint (/repo/pv3/src/ports/endpoints/index.ts:266:32)'
+            ])).toBeUndefined();
+        });
+    });
+});
+// ---------------------------------------------------------------------------
+// Which bucket the declaring file falls in — the whole of F1's three-way split
+// plus the one site it refuses. Synthetic stacks throughout: every interesting
+// case is a frame this process cannot produce (a sibling pv3 package, a
+// compiled tree, a service's module directory, a file in neither tree).
+// ---------------------------------------------------------------------------
+describe('declaration buckets', () => {
+    const SRC_PORT_ROOT = '/repo/pv3/packages/pv3/src';
+    const BUILD_PORT_ROOT = '/repo/pv3/packages/pv3/build';
+    /**
+     * A stack with the two frames the capture always skips on top. The pv3
+     * boundary is derived from the FIRST of them, so which tree the port itself
+     * was loaded from is a parameter of every case.
+     */
+    const siteFrom = (callerFrame, portRoot = SRC_PORT_ROOT) => {
+        const extension = portRoot.endsWith('build') ? 'js' : 'ts';
+        return (0, declarationSite_1.resolveDeclarationFrame)([
+            'Error',
+            `    at getDeclarationSite (${portRoot}/ports/endpoints/declarationSite.${extension}:78:20)`,
+            `    at registerEndpoint (${portRoot}/ports/endpoints/index.${extension}:266:32)`,
+            callerFrame
+        ]);
+    };
+    it('calls a file under the service\'s modules/ tree a manual endpoint', () => {
+        const site = siteFrom('    at registerHealthSyncEndpoints (/repo/teselly/src/services/server/src/modules/marketplace-health/healthSync.endpoints.ts:27:20)');
+        expect(site?.kind).toBe('module');
+    });
+    it('calls a file inside the pv3 package a framework route', () => {
+        // pv3 derives this route from an aggregate; nothing declared it and no
+        // deployment unit owns it. The boundary is read off the PORT'S OWN FRAME —
+        // deriving it from `__dirname` would compare this synthetic /repo path
+        // against the real checkout and call it foreign.
+        const site = siteFrom('    at routeCommandHandler (/repo/pv3/packages/pv3/src/libraries/eventsourcing/commandHandlers/index.ts:804:22)');
+        expect(site?.kind).toBe('framework');
+    });
+    it('calls a sibling pv3 package a framework route as well', () => {
+        // The live case: pv3-admin-server registers 17 routes on the real port and
+        // is NOT inside packages/pv3. Classifying it foreign would fail teselly's
+        // manifest generation on pv3's own endpoints.
+        const site = siteFrom('    at AdminServer (/repo/pv3/packages/pv3-admin-server/src/index.ts:136:13)');
+        expect(site?.kind).toBe('framework');
+    });
+    it('follows the tree the stack reports, not the one the port was loaded from', () => {
+        // Under ts-node a consumer loads pv3 from build/ while source-map-support
+        // rewrites the frames to src/. Both trees belong to the same package, so
+        // either mix is still the framework.
+        expect(siteFrom('    at routeCommandHandler (/repo/pv3/packages/pv3/build/libraries/eventsourcing/commandHandlers/index.js:804:22)', BUILD_PORT_ROOT)?.kind).toBe('framework');
+        expect(siteFrom('    at routeCommandHandler (/repo/pv3/packages/pv3/src/libraries/eventsourcing/commandHandlers/index.ts:804:22)', BUILD_PORT_ROOT)?.kind).toBe('framework');
+    });
+    it('refuses a module\'s own index.ts — the composition root', () => {
+        // `create( ports )` never runs in a lifted pod, so capturing this file
+        // would make `create` an artifact factory and lift the module's entire
+        // interior into a pod under one endpoint's contract.
+        const site = siteFrom('    at create (/repo/teselly/src/services/server/src/modules/dev-utils/index.ts:32:22)');
+        expect(site?.kind).toBe('moduleIndex');
+    });
+    it('accepts an index.ts that is not the module root', () => {
+        // The live Better Auth case: modules/identity/teselly-better-auth/index.ts
+        // is one artifact among many in `identity`, not identity's composition
+        // root. Refusing it would break the one file that holds 46 routes.
+        const site = siteFrom('    at TesellyAuth (/repo/teselly/src/services/server/src/modules/identity/teselly-better-auth/index.ts:1009:15)');
+        expect(site?.kind).toBe('module');
+    });
+    it('accepts a sub-composition root deeper in the module tree', () => {
+        // `modules/items-publishing/size-guides/index.ts` is a real file. Only the
+        // module's OWN index.ts is the root `loadModulesFromDirectory` calls
+        // `create( ports )` on; refusing every path ending in index.ts would break
+        // a legitimate file the design never meant to touch.
+        const site = siteFrom('    at registerSizeGuideEndpoints (/repo/teselly/src/services/server/src/modules/items-publishing/size-guides/index.ts:41:5)');
+        expect(site?.kind).toBe('module');
+    });
+    it('decides on the path, never on the registrar\'s name', () => {
+        // `generateAppLoginUrl.ts` exports a function literally called `create` and
+        // is a genuine endpoint registrar. A refusal keyed on the name instead of
+        // the file would reject it — and the manifest names the artifact after this
+        // frame, which is what `loadFromManifest` then requires by name.
+        const site = siteFrom('    at create (/repo/teselly/src/services/server/src/modules/clients-management/users/generateAppLoginUrl.ts:13:22)');
+        expect(site?.kind).toBe('module');
+        expect(site?.exportName).toBe('create');
+    });
+    it('refuses a file in neither tree instead of inventing a third bucket', () => {
+        const site = siteFrom('    at registerWorkerEndpoints (/repo/teselly/src/tests/src/automation/rulesWorkerClaim.integration.test.ts:81:20)');
+        expect(site?.kind).toBe('foreign');
+    });
+    it('does not read "pv3" out of an unrelated ancestor directory name', () => {
+        // A checkout at ~/development/pv3-2257 is not the pv3 package. The family
+        // test is anchored at the directory the port's own package sits in, so a
+        // name match anywhere else in the path means nothing.
+        const site = siteFrom('    at registerThings (/Users/dev/development/pv3-2257-app/src/handlers/things.ts:12:3)');
+        expect(site?.kind).toBe('foreign');
+    });
+});
+//# sourceMappingURL=declarationSite.test.js.map

package/build/ports/endpoints/__tests__/declarationSite.test.js.map

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

package/build/ports/endpoints/__tests__/fixtures/modules/sales/appLoginUrl.d.ts

@@ -0,0 +1,9 @@
+import { EndpointsPort } from '@bett3r-dev/pv3-types';
+/**
+ * A registrar whose export is literally named `create`, in a file that is NOT a
+ * composition root — the shape of `clients-management/users/generateAppLoginUrl.ts`.
+ * The refusal keys on the file's path, so this one is captured, and the manifest
+ * names its artifact `create`, which is the export `loadFromManifest` requires.
+ */
+export declare const create: (endpoints: EndpointsPort) => void;
+//# sourceMappingURL=appLoginUrl.d.ts.map

package/build/ports/endpoints/__tests__/fixtures/modules/sales/appLoginUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appLoginUrl.d.ts","sourceRoot":"","sources":["../../../../../../../src/ports/endpoints/__tests__/fixtures/modules/sales/appLoginUrl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,MAAM,cAAgB,aAAa,SAQ/C,CAAC"}

package/build/ports/endpoints/__tests__/fixtures/modules/sales/appLoginUrl.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.create = void 0;
+/**
+ * A registrar whose export is literally named `create`, in a file that is NOT a
+ * composition root — the shape of `clients-management/users/generateAppLoginUrl.ts`.
+ * The refusal keys on the file's path, so this one is captured, and the manifest
+ * names its artifact `create`, which is the export `loadFromManifest` requires.
+ */
+const create = (endpoints) => {
+    endpoints.registerEndpoint({
+        name: 'Generate App Login Url',
+        route: '/sales/generate-app-login-url',
+        method: 'GET',
+        loggingModule: 'sales',
+        action: async () => ({})
+    });
+};
+exports.create = create;
+//# sourceMappingURL=appLoginUrl.js.map

package/build/ports/endpoints/__tests__/fixtures/modules/sales/appLoginUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appLoginUrl.js","sourceRoot":"","sources":["../../../../../../../src/ports/endpoints/__tests__/fixtures/modules/sales/appLoginUrl.ts"],"names":[],"mappings":";;;AAEA;;;;;GAKG;AACI,MAAM,MAAM,GAAG,CAAE,SAAwB,EAAG,EAAE;IACnD,SAAS,CAAC,gBAAgB,CAAC;QACzB,IAAI,EAAE,wBAAwB;QAC9B,KAAK,EAAE,+BAA+B;QACtC,MAAM,EAAE,KAAK;QACb,aAAa,EAAE,OAAO;QACtB,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACzB,CAAC,CAAC;AACL,CAAC,CAAC;AARW,QAAA,MAAM,GAAN,MAAM,CAQjB"}

package/build/ports/endpoints/__tests__/fixtures/modules/sales/index.d.ts

@@ -0,0 +1,10 @@
+import { EndpointsPort } from '@bett3r-dev/pv3-types';
+/**
+ * A stand-in for a service module's composition root — the shape the port
+ * refuses. `create( ports )` does not run in a lifted pod, so a route
+ * registered from here exists in the monolith and in no lifted pod.
+ *
+ * Required by `manifestEndpoints.test.ts` and by nothing else.
+ */
+export declare const create: (endpoints: EndpointsPort) => void;
+//# sourceMappingURL=index.d.ts.map

package/build/ports/endpoints/__tests__/fixtures/modules/sales/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/ports/endpoints/__tests__/fixtures/modules/sales/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,cAAgB,aAAa,SAQ/C,CAAC"}

package/build/ports/endpoints/__tests__/fixtures/modules/sales/index.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.create = void 0;
+/**
+ * A stand-in for a service module's composition root — the shape the port
+ * refuses. `create( ports )` does not run in a lifted pod, so a route
+ * registered from here exists in the monolith and in no lifted pod.
+ *
+ * Required by `manifestEndpoints.test.ts` and by nothing else.
+ */
+const create = (endpoints) => {
+    endpoints.registerEndpoint({
+        name: 'Whoami',
+        route: '/sales/whoami',
+        method: 'GET',
+        loggingModule: 'sales',
+        action: async () => ({})
+    });
+};
+exports.create = create;
+//# sourceMappingURL=index.js.map

package/build/ports/endpoints/__tests__/fixtures/modules/sales/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/ports/endpoints/__tests__/fixtures/modules/sales/index.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACI,MAAM,MAAM,GAAG,CAAE,SAAwB,EAAG,EAAE;IACnD,SAAS,CAAC,gBAAgB,CAAC;QACzB,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,eAAe;QACtB,MAAM,EAAE,KAAK;QACb,aAAa,EAAE,OAAO;QACtB,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACzB,CAAC,CAAC;AACL,CAAC,CAAC;AARW,QAAA,MAAM,GAAN,MAAM,CAQjB"}

package/build/ports/endpoints/__tests__/fixtures/modules/sales/orders.endpoints.d.ts

@@ -0,0 +1,15 @@
+import { EndpointsPort } from '@bett3r-dev/pv3-types';
+/**
+ * A stand-in for a service module's endpoint file.
+ *
+ * It sits under a `modules/<name>/` path deliberately: the endpoints port
+ * decides what a route is from WHERE it was declared, and that question can
+ * only be put to a real stack. pv3 ships no `modules/<name>/` directory of its
+ * own, so this is the only file in the package that classifies as a service
+ * module — it is required by `manifestEndpoints.test.ts` and by nothing else.
+ */
+export declare const registerOrderEndpoints: (endpoints: EndpointsPort) => void;
+export declare const registerItemDraftEndpoints: (endpoints: EndpointsPort) => void;
+/** Names no aggregate — the case the whole slice exists for. */
+export declare const registerOrderSearchEndpoint: (endpoints: EndpointsPort) => void;
+//# sourceMappingURL=orders.endpoints.d.ts.map

package/build/ports/endpoints/__tests__/fixtures/modules/sales/orders.endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orders.endpoints.d.ts","sourceRoot":"","sources":["../../../../../../../src/ports/endpoints/__tests__/fixtures/modules/sales/orders.endpoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;;;;;;;GAQG;AAEH,eAAO,MAAM,sBAAsB,cAAgB,aAAa,SAS/D,CAAC;AAEF,eAAO,MAAM,0BAA0B,cAAgB,aAAa,SASnE,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,2BAA2B,cAAgB,aAAa,SAQpE,CAAC"}

package/build/ports/endpoints/__tests__/fixtures/modules/sales/orders.endpoints.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerOrderSearchEndpoint = exports.registerItemDraftEndpoints = exports.registerOrderEndpoints = void 0;
+/**
+ * A stand-in for a service module's endpoint file.
+ *
+ * It sits under a `modules/<name>/` path deliberately: the endpoints port
+ * decides what a route is from WHERE it was declared, and that question can
+ * only be put to a real stack. pv3 ships no `modules/<name>/` directory of its
+ * own, so this is the only file in the package that classifies as a service
+ * module — it is required by `manifestEndpoints.test.ts` and by nothing else.
+ */
+const registerOrderEndpoints = (endpoints) => {
+    endpoints.registerEndpoint({
+        name: 'Order Fulfilment Status',
+        route: '/sales/orders/:orderId/fulfilment-status',
+        method: 'POST',
+        loggingModule: 'sales',
+        linkedTo: ['OrdersAggregate'],
+        action: async () => ({})
+    });
+};
+exports.registerOrderEndpoints = registerOrderEndpoints;
+const registerItemDraftEndpoints = (endpoints) => {
+    endpoints.registerEndpoint({
+        name: 'Item Drafts',
+        route: '/sales/item-drafts/:id?',
+        method: 'GET',
+        loggingModule: 'sales',
+        linkedTo: ['ItemsAggregate'],
+        action: async () => ({})
+    });
+};
+exports.registerItemDraftEndpoints = registerItemDraftEndpoints;
+/** Names no aggregate — the case the whole slice exists for. */
+const registerOrderSearchEndpoint = (endpoints) => {
+    endpoints.registerEndpoint({
+        name: 'Order Search',
+        route: '/sales/orders-search',
+        method: 'GET',
+        loggingModule: 'sales',
+        action: async () => ({})
+    });
+};
+exports.registerOrderSearchEndpoint = registerOrderSearchEndpoint;
+//# sourceMappingURL=orders.endpoints.js.map

package/build/ports/endpoints/__tests__/fixtures/modules/sales/orders.endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orders.endpoints.js","sourceRoot":"","sources":["../../../../../../../src/ports/endpoints/__tests__/fixtures/modules/sales/orders.endpoints.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;GAQG;AAEI,MAAM,sBAAsB,GAAG,CAAE,SAAwB,EAAG,EAAE;IACnE,SAAS,CAAC,gBAAgB,CAAC;QACzB,IAAI,EAAE,yBAAyB;QAC/B,KAAK,EAAE,0CAA0C;QACjD,MAAM,EAAE,MAAM;QACd,aAAa,EAAE,OAAO;QACtB,QAAQ,EAAE,CAAC,iBAAiB,CAAC;QAC7B,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACzB,CAAC,CAAC;AACL,CAAC,CAAC;AATW,QAAA,sBAAsB,GAAtB,sBAAsB,CASjC;AAEK,MAAM,0BAA0B,GAAG,CAAE,SAAwB,EAAG,EAAE;IACvE,SAAS,CAAC,gBAAgB,CAAC;QACzB,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,yBAAyB;QAChC,MAAM,EAAE,KAAK;QACb,aAAa,EAAE,OAAO;QACtB,QAAQ,EAAE,CAAC,gBAAgB,CAAC;QAC5B,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACzB,CAAC,CAAC;AACL,CAAC,CAAC;AATW,QAAA,0BAA0B,GAA1B,0BAA0B,CASrC;AAEF,gEAAgE;AACzD,MAAM,2BAA2B,GAAG,CAAE,SAAwB,EAAG,EAAE;IACxE,SAAS,CAAC,gBAAgB,CAAC;QACzB,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,sBAAsB;QAC7B,MAAM,EAAE,KAAK;QACb,aAAa,EAAE,OAAO;QACtB,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACzB,CAAC,CAAC;AACL,CAAC,CAAC;AARW,QAAA,2BAA2B,GAA3B,2BAA2B,CAQtC"}

package/build/ports/endpoints/__tests__/manifestEndpoints.test.d.ts

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

package/build/ports/endpoints/__tests__/manifestEndpoints.test.d.ts.map

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

package/build/ports/endpoints/__tests__/manifestEndpoints.test.js

@@ -0,0 +1,117 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const vm_1 = __importDefault(require("vm"));
+const configuration_1 = require("../../configuration");
+const index_1 = require("../index");
+const appLoginUrl_1 = require("./fixtures/modules/sales/appLoginUrl");
+const sales_1 = require("./fixtures/modules/sales");
+const orders_endpoints_1 = require("./fixtures/modules/sales/orders.endpoints");
+/**
+ * What the endpoints port hands the deployment manifest for a manually
+ * registered route. `computeMDUs` turns this into an `endpoint` artifact's
+ * `routes` list, and teselly's manifest-coverage guard keys its comparison by
+ * the same `METHOD route` pair — so a field the port never fills would leave
+ * both of those green over nothing.
+ *
+ * Which routes are captured at all is decided by WHERE they were declared, and
+ * only a real stack answers that — hence the `fixtures/modules/sales/` files.
+ * Registering from this file instead exercises the framework bucket, since a
+ * test inside the pv3 package is exactly what a pv3-registered route looks like.
+ */
+const configAdapter = (config) => ({
+    applyConfig: async () => config,
+    name: 'test',
+    _adapter: () => { },
+    start: async () => { },
+    stop: async () => { }
+});
+const createEndpointsPort = async () => {
+    const configuration = await (0, configuration_1.Configuration)(configAdapter({}));
+    return (0, index_1.Endpoints)({ packageJson: { name: 'test', version: '1' }, configuration });
+};
+describe('getManifestEndpoints', () => {
+    it('records which route the captured declaration site is', async () => {
+        const endpoints = await createEndpointsPort();
+        (0, orders_endpoints_1.registerOrderEndpoints)(endpoints);
+        const [captured] = endpoints.getManifestEndpoints();
+        expect(captured.route).toBe('/sales/orders/:orderId/fulfilment-status');
+        expect(captured.method).toBe('POST');
+        // The declaring FUNCTION, off the V8 frame — not the file name. The
+        // selective loader calls this export by name.
+        expect(captured.exportName).toBe('registerOrderEndpoints');
+    });
+    it('records the route as declared when it carries an optional path parameter', async () => {
+        const endpoints = await createEndpointsPort();
+        (0, orders_endpoints_1.registerItemDraftEndpoints)(endpoints);
+        const captured = endpoints.getManifestEndpoints();
+        // `registerEndpoint` stores this endpoint under TWO route-table keys
+        // (`/…/:id` and `/…`), so the manifest would otherwise see it twice.
+        expect(captured).toHaveLength(1);
+        // The declared route, `?` intact — the same string teselly's coverage guard
+        // reads off the booted endpoint, so the two sides key identically.
+        expect(captured[0].route).toBe('/sales/item-drafts/:id?');
+    });
+    it('captures a module route that declares nothing at all', async () => {
+        const endpoints = await createEndpointsPort();
+        (0, orders_endpoints_1.registerOrderSearchEndpoint)(endpoints);
+        const captured = endpoints.getManifestEndpoints();
+        // Being in a module IS the declaration. Before this, a route with no
+        // `linkedTo` was captured for nothing and existed in no deployment unit.
+        expect(captured).toHaveLength(1);
+        expect(captured[0].route).toBe('/sales/orders-search');
+        expect(captured[0].linkedTo).toBeUndefined();
+        expect(captured[0].exportName).toBe('registerOrderSearchEndpoint');
+    });
+    it('captures nothing for a route registered from inside pv3', async () => {
+        const endpoints = await createEndpointsPort();
+        // Declared from this test file — i.e. from inside the pv3 package, which is
+        // what every framework-derived route (an aggregate's command route, a
+        // readmodel's query route, pv3-admin-server's console) looks like on the
+        // stack. No deployment unit owns those and none should try.
+        endpoints.registerEndpoint({
+            name: 'Framework Route',
+            route: '/pv3-internal/framework-route',
+            method: 'GET',
+            loggingModule: 'test',
+            action: async () => ({})
+        });
+        expect(endpoints.getManifestEndpoints()).toEqual([]);
+    });
+    it('captures a registrar named `create` that is not a composition root', async () => {
+        const endpoints = await createEndpointsPort();
+        (0, appLoginUrl_1.create)(endpoints);
+        const [captured] = endpoints.getManifestEndpoints();
+        // The refusal below keys on the file, not on the function: this is the live
+        // shape of `clients-management/users/generateAppLoginUrl.ts`.
+        expect(captured.route).toBe('/sales/generate-app-login-url');
+        expect(captured.exportName).toBe('create');
+    });
+    it('refuses a module composition root, naming the file and where to move it', async () => {
+        const endpoints = await createEndpointsPort();
+        (0, sales_1.create)(endpoints);
+        // Capturing `create()` would make it an artifact factory and lift the whole
+        // module interior into a pod under one endpoint's contract; NOT capturing it
+        // silently would leave the route in the monolith and in no lifted pod.
+        expect(() => endpoints.getManifestEndpoints()).toThrow(/modules[/\\]sales[/\\]index\.ts/);
+        expect(() => endpoints.getManifestEndpoints()).toThrow(/composition root/i);
+    });
+    it('refuses a declaration site in neither the modules tree nor pv3', async () => {
+        const endpoints = await createEndpointsPort();
+        // A file in neither tree cannot be authored inside this package — every path
+        // here is either under `fixtures/modules/` or inside pv3 — so the frame is
+        // synthesised by compiling the registrar under a foreign filename. V8 reports
+        // it verbatim, which is exactly what teselly's own out-of-tree registrars
+        // (`src/tests/**/*.integration.test.ts`) look like on a real stack.
+        const registerFromOutsideAnyModule = vm_1.default.runInThisContext('(( endpoints ) => endpoints.registerEndpoint({' +
+            "  name: 'Worker Probe', route: '/probes/worker', method: 'GET'," +
+            "  loggingModule: 'test', action: async () => ({})" +
+            '}))', { filename: '/repo/teselly/src/tests/src/automation/rulesWorkerClaim.integration.test.ts' });
+        registerFromOutsideAnyModule(endpoints);
+        expect(() => endpoints.getManifestEndpoints()).toThrow(/rulesWorkerClaim\.integration\.test\.ts/);
+        expect(() => endpoints.getManifestEndpoints()).toThrow(/modules/);
+    });
+});
+//# sourceMappingURL=manifestEndpoints.test.js.map

package/build/ports/endpoints/__tests__/manifestEndpoints.test.js.map

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

package/build/ports/endpoints/declarationSite.d.ts

@@ -0,0 +1,63 @@
+/**
+ * What the file a route was registered from says the route IS.
+ *
+ * - `module` — a file under the service's `modules/<name>/` tree: a manually
+ *   registered endpoint, and therefore a deployment artifact. Being in a module
+ *   is the whole declaration; naming an aggregate is the exception, not the rule.
+ * - `framework` — a file inside the pv3 package family: a route pv3 derived from
+ *   an artifact (an aggregate's command route, a readmodel's query route, the
+ *   admin console). Nothing declared it and no deployment unit owns it.
+ * - `moduleIndex` — a module's own `index.ts`, refused: `create( ports )` never
+ *   runs in a lifted pod, so capturing it would make `create` an artifact
+ *   factory and lift the module's entire interior into a pod under one
+ *   endpoint's contract.
+ * - `foreign` — neither. Refused rather than dropped into a silent third bucket.
+ */
+export type DeclarationKind = 'module' | 'framework' | 'moduleIndex' | 'foreign';
+/**
+ * Where a manually registered endpoint was declared.
+ *
+ * `getStackTrace()` (libraries/eventsourcing/utils) answers the same question for
+ * aggregates, readmodels, systems and policies, but it cannot be reused here: it
+ * keys on the artifact filename suffix `/\.(readmodel|aggregate|system|policy)\.ts:/`
+ * and throws for a file named `itemDeletePreflight.endpoints.ts`. Endpoint files
+ * carry no mandated suffix, so this sibling walks the stack for the first frame
+ * outside the endpoints port instead of pattern-matching the filename.
+ */
+export type DeclarationSite = {
+    /** Absolute path of the file the endpoint was registered from. */
+    filePath: string;
+    /**
+     * The function that made the registration call, when V8 could name it — for
+     * `export const registerHealthSyncEndpoints = ( ports ) => {…}` that is the
+     * exported symbol itself. The deployment manifest names the endpoint artifact
+     * after it so the selective loader resolves the export exactly, instead of
+     * guessing at it from the file name.
+     */
+    exportName?: string;
+    /** Which of the four buckets above the declaring file falls in. */
+    kind: DeclarationKind;
+};
+/**
+ * The first frame outside the endpoints port — i.e. the caller that registered
+ * the endpoint. Exported for testing: the interesting failures are all about
+ * which frame gets picked, and a real stack cannot express them.
+ *
+ * The boundary is read off the stack rather than from `__dirname`, because the
+ * two disagree. A consumer running under ts-node loads the port from `build/`
+ * (so `__dirname` is the emitted tree) while source-map-support rewrites the
+ * frames to the original `src/**.ts` — comparing the two attributed EVERY
+ * endpoint to this file. Since the Error is constructed here, the topmost frame
+ * is always this module in whichever tree the stack reports, and `index.ts`'s
+ * `registerEndpoint` is its neighbour, so one directory skips both.
+ */
+export declare const resolveDeclarationFrame: (frames: string[]) => DeclarationSite | undefined;
+/**
+ * Where the caller registered the endpoint from.
+ *
+ * @param description names the endpoint in the failure message, since a
+ * declaration site that cannot be captured would otherwise drop the endpoint
+ * from the deployment manifest silently.
+ */
+export declare const getDeclarationSite: (description: string) => DeclarationSite;
+//# sourceMappingURL=declarationSite.d.ts.map

package/build/ports/endpoints/declarationSite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declarationSite.d.ts","sourceRoot":"","sources":["../../../src/ports/endpoints/declarationSite.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;AAEjF;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,IAAI,EAAE,eAAe,CAAC;CACvB,CAAC;AAwEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,WAAa,MAAM,EAAE,KAAG,eAAe,GAAG,SAuB7E,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,gBAAkB,MAAM,KAAI,eAY1D,CAAC"}