@bett3r-dev/pv3 1.0.0 → 2.5.1

package/build/libraries/modules/scopedPortsView.test.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * TV1-2271 — pv3-side mirror of teselly's `setupPortsLaziness.test.ts`.
+ *
+ * The root here is a FAKE composition root: lazy getters with the memo in the
+ * factory's CLOSURE (exactly the shape teselly's `setupPorts` has), each getter
+ * incrementing a construction counter. That counter is the only instrument that
+ * distinguishes a delegating view from a copy — reading the code cannot.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const scopedPortsView_1 = require("./scopedPortsView");
+const buildRoot = () => {
+    const constructed = [];
+    const built = new Map();
+    const root = {};
+    for (const name of ['database', 'eventstore', 'mailer']) {
+        Object.defineProperty(root, name, {
+            enumerable: true,
+            configurable: true,
+            get: () => {
+                if (!built.has(name)) {
+                    constructed.push(name);
+                    built.set(name, { kind: name });
+                }
+                return built.get(name);
+            }
+        });
+    }
+    return { root, constructed };
+};
+const LOG = { info: () => undefined };
+describe('scopedPortsView', () => {
+    const originalLegacy = process.env.PV3_SCOPED_PORTS_LEGACY_SPREAD;
+    afterEach(() => {
+        if (originalLegacy === undefined)
+            delete process.env.PV3_SCOPED_PORTS_LEGACY_SPREAD;
+        else
+            process.env.PV3_SCOPED_PORTS_LEGACY_SPREAD = originalLegacy;
+    });
+    it('constructs NOTHING when a view is created — the regression this ticket exists for', () => {
+        const { root, constructed } = buildRoot();
+        (0, scopedPortsView_1.scopedPortsView)(root, LOG);
+        expect(constructed).toEqual([]);
+    });
+    it('has exactly one own key, `log`', () => {
+        const { root } = buildRoot();
+        const view = (0, scopedPortsView_1.scopedPortsView)(root, LOG);
+        void view.database;
+        void view.eventstore;
+        expect(Object.getOwnPropertyNames(view)).toEqual(['log']);
+        expect(Object.prototype.hasOwnProperty.call(view, 'database')).toBe(false);
+    });
+    it('delegates a port read to the root, returning the SAME instance', () => {
+        const { root, constructed } = buildRoot();
+        const view = (0, scopedPortsView_1.scopedPortsView)(root, LOG);
+        expect(view.database).toBe(root.database);
+        expect(constructed.filter((n) => n === 'database')).toHaveLength(1);
+    });
+    it('gives two DIFFERENT views the same instance — one construction total', () => {
+        const { root, constructed } = buildRoot();
+        const moduleA = (0, scopedPortsView_1.scopedPortsView)(root, LOG);
+        const moduleB = (0, scopedPortsView_1.scopedPortsView)(root, LOG);
+        expect(moduleA.database).toBe(moduleB.database);
+        expect(constructed.filter((n) => n === 'database')).toHaveLength(1);
+    });
+    it('records ONE construction across repeated reads through the view — memo is in the root closure, not on `this`', () => {
+        const { root, constructed } = buildRoot();
+        const view = (0, scopedPortsView_1.scopedPortsView)(root, LOG);
+        void view.database;
+        void view.database;
+        void view.database;
+        expect(constructed).toEqual(['database']);
+        expect(Object.getOwnPropertyNames(view)).toEqual(['log']);
+    });
+    it('exposes the injected logger as `log`, and writing it does not touch the root', () => {
+        const { root } = buildRoot();
+        const view = (0, scopedPortsView_1.scopedPortsView)(root, LOG);
+        expect(view.log).toBe(LOG);
+        const replacement = { info: () => undefined };
+        view.log = replacement;
+        expect(view.log).toBe(replacement);
+        expect(Object.prototype.hasOwnProperty.call(root, 'log')).toBe(false);
+    });
+    it('PV3_SCOPED_PORTS_LEGACY_SPREAD=1 restores the spread — own port keys, all getters fire', () => {
+        process.env.PV3_SCOPED_PORTS_LEGACY_SPREAD = '1';
+        const { root, constructed } = buildRoot();
+        const view = (0, scopedPortsView_1.scopedPortsView)(root, LOG);
+        expect(constructed.sort()).toEqual(['database', 'eventstore', 'mailer'].sort());
+        expect(Object.getOwnPropertyNames(view).sort()).toEqual(['database', 'eventstore', 'log', 'mailer'].sort());
+        expect(Object.prototype.hasOwnProperty.call(view, 'database')).toBe(true);
+    });
+    it('reads the env var at CALL time, not at module load', () => {
+        const { root: eager, constructed: eagerTrace } = buildRoot();
+        process.env.PV3_SCOPED_PORTS_LEGACY_SPREAD = '1';
+        (0, scopedPortsView_1.scopedPortsView)(eager, LOG);
+        expect(eagerTrace).not.toEqual([]);
+        delete process.env.PV3_SCOPED_PORTS_LEGACY_SPREAD;
+        const { root: lazy, constructed: lazyTrace } = buildRoot();
+        (0, scopedPortsView_1.scopedPortsView)(lazy, LOG);
+        expect(lazyTrace).toEqual([]);
+    });
+});
+//# sourceMappingURL=scopedPortsView.test.js.map

package/build/libraries/modules/scopedPortsView.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopedPortsView.test.js","sourceRoot":"","sources":["../../../src/libraries/modules/scopedPortsView.test.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAEH,uDAAoD;AAQpD,MAAM,SAAS,GAAG,GAAG,EAAE;IACrB,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,IAAI,GAAG,EAA4B,CAAC;IAClD,MAAM,IAAI,GAAG,EAAc,CAAC;IAE5B,KAAM,MAAM,IAAI,IAAI,CAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,CAAW,EAAG,CAAC;QACrE,MAAM,CAAC,cAAc,CAAE,IAAI,EAAE,IAAI,EAAE;YACjC,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,IAAI;YAClB,GAAG,EAAE,GAAG,EAAE;gBACR,IAAK,CAAC,KAAK,CAAC,GAAG,CAAE,IAAI,CAAE,EAAE,CAAC;oBACxB,WAAW,CAAC,IAAI,CAAE,IAAI,CAAE,CAAC;oBACzB,KAAK,CAAC,GAAG,CAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBACnC,CAAC;gBACD,OAAO,KAAK,CAAC,GAAG,CAAE,IAAI,CAAG,CAAC;YAC5B,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AAC/B,CAAC,CAAC;AAEF,MAAM,GAAG,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;AAEtC,QAAQ,CAAE,iBAAiB,EAAE,GAAG,EAAE;IAChC,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC;IAElE,SAAS,CAAC,GAAG,EAAE;QACb,IAAK,cAAc,KAAK,SAAS;YAAG,OAAO,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC;;YACjF,OAAO,CAAC,GAAG,CAAC,8BAA8B,GAAG,cAAc,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAE,mFAAmF,EAAE,GAAG,EAAE;QAC5F,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,SAAS,EAAE,CAAC;QAE1C,IAAA,iCAAe,EAAE,IAAI,EAAE,GAAG,CAAE,CAAC;QAE7B,MAAM,CAAE,WAAW,CAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAE,gCAAgC,EAAE,GAAG,EAAE;QACzC,MAAM,EAAE,IAAI,EAAE,GAAG,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAA,iCAAe,EAAE,IAAI,EAAE,GAAG,CAAE,CAAC;QAE1C,KAAK,IAAI,CAAC,QAAQ,CAAC;QACnB,KAAK,IAAI,CAAC,UAAU,CAAC;QAErB,MAAM,CAAE,MAAM,CAAC,mBAAmB,CAAE,IAAI,CAAE,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAE,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAE,IAAI,EAAE,UAAU,CAAE,CAAC,CAAC,IAAI,CAAE,KAAK,CAAE,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAE,gEAAgE,EAAE,GAAG,EAAE;QACzE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,SAAS,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAA,iCAAe,EAAE,IAAI,EAAE,GAAG,CAAE,CAAC;QAE1C,MAAM,CAAE,IAAI,CAAC,QAAQ,CAAE,CAAC,IAAI,CAAE,IAAI,CAAC,QAAQ,CAAE,CAAC;QAC9C,MAAM,CAAE,WAAW,CAAC,MAAM,CAAC,CAAE,CAAC,EAAG,EAAE,CAAC,CAAC,KAAK,UAAU,CAAE,CAAC,CAAC,YAAY,CAAE,CAAC,CAAE,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAE,sEAAsE,EAAE,GAAG,EAAE;QAC/E,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,SAAS,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAA,iCAAe,EAAE,IAAI,EAAE,GAAG,CAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAA,iCAAe,EAAE,IAAI,EAAE,GAAG,CAAE,CAAC;QAE7C,MAAM,CAAE,OAAO,CAAC,QAAQ,CAAE,CAAC,IAAI,CAAE,OAAO,CAAC,QAAQ,CAAE,CAAC;QACpD,MAAM,CAAE,WAAW,CAAC,MAAM,CAAC,CAAE,CAAC,EAAG,EAAE,CAAC,CAAC,KAAK,UAAU,CAAE,CAAC,CAAC,YAAY,CAAE,CAAC,CAAE,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAE,8GAA8G,EAAE,GAAG,EAAE;QACvH,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,SAAS,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAA,iCAAe,EAAE,IAAI,EAAE,GAAG,CAAE,CAAC;QAE1C,KAAK,IAAI,CAAC,QAAQ,CAAC;QACnB,KAAK,IAAI,CAAC,QAAQ,CAAC;QACnB,KAAK,IAAI,CAAC,QAAQ,CAAC;QAEnB,MAAM,CAAE,WAAW,CAAE,CAAC,OAAO,CAAC,CAAE,UAAU,CAAE,CAAC,CAAC;QAC9C,MAAM,CAAE,MAAM,CAAC,mBAAmB,CAAE,IAAI,CAAE,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAE,8EAA8E,EAAE,GAAG,EAAE;QACvF,MAAM,EAAE,IAAI,EAAE,GAAG,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAA,iCAAe,EAAE,IAAI,EAAE,GAAG,CAAE,CAAC;QAE1C,MAAM,CAAG,IAAoC,CAAC,GAAG,CAAE,CAAC,IAAI,CAAE,GAAG,CAAE,CAAC;QAEhE,MAAM,WAAW,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;QAC5C,IAAoC,CAAC,GAAG,GAAG,WAAW,CAAC;QAEzD,MAAM,CAAG,IAAoC,CAAC,GAAG,CAAE,CAAC,IAAI,CAAE,WAAW,CAAE,CAAC;QACxE,MAAM,CAAE,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAE,IAAI,EAAE,KAAK,CAAE,CAAC,CAAC,IAAI,CAAE,KAAK,CAAE,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAE,wFAAwF,EAAE,GAAG,EAAE;QACjG,OAAO,CAAC,GAAG,CAAC,8BAA8B,GAAG,GAAG,CAAC;QACjD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,SAAS,EAAE,CAAC;QAE1C,MAAM,IAAI,GAAG,IAAA,iCAAe,EAAE,IAAI,EAAE,GAAG,CAAE,CAAC;QAE1C,MAAM,CAAE,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,CAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACnF,MAAM,CAAE,MAAM,CAAC,mBAAmB,CAAE,IAAI,CAAE,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAE,UAAU,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACjH,MAAM,CAAE,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAE,IAAI,EAAE,UAAU,CAAE,CAAC,CAAC,IAAI,CAAE,IAAI,CAAE,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAE,oDAAoD,EAAE,GAAG,EAAE;QAC7D,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,SAAS,EAAE,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,8BAA8B,GAAG,GAAG,CAAC;QACjD,IAAA,iCAAe,EAAE,KAAK,EAAE,GAAG,CAAE,CAAC;QAC9B,MAAM,CAAE,UAAU,CAAE,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAErC,OAAO,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC;QAClD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAAC;QAC3D,IAAA,iCAAe,EAAE,IAAI,EAAE,GAAG,CAAE,CAAC;QAC7B,MAAM,CAAE,SAAS,CAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/libraries/modules/selectiveLoader.d.ts

@@ -0,0 +1,21 @@
+import { EventSourcingLibraryType, LoggerPort, PortsBase } from '@bett3r-dev/pv3-types';
+type SelectiveLoaderPorts = {
+    eventsourcing: Pick<EventSourcingLibraryType, 'routeCommandHandler' | 'routeEventHandler'>;
+    logger?: Pick<LoggerPort, 'createLoggerInstance'>;
+    [key: string]: any;
+};
+export type LoadFromManifestOptions = {
+    /** Directory containing module folders (relative to servicePath). Defaults to '<runtimeBase>/modules'. */
+    modulesDirectory?: string;
+    /**
+     * Root directory the running code actually lives in, relative to servicePath.
+     * The manifest always declares `src/**.ts` paths, but a compiled deployment
+     * ships only the emitted tree — a distroless image carries `build/` and no
+     * `src/` — so the caller passes `'build'` there. Defaults to `'src'`, i.e. the
+     * manifest's own root, which is where the sources live under ts-node.
+     */
+    runtimeBase?: string;
+};
+export declare function loadFromManifest(servicePath: string, liftPatterns: string[], ports: SelectiveLoaderPorts | Partial<PortsBase>, options?: LoadFromManifestOptions): Promise<void>;
+export {};
+//# sourceMappingURL=selectiveLoader.d.ts.map

package/build/libraries/modules/selectiveLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectiveLoader.d.ts","sourceRoot":"","sources":["../../../src/libraries/modules/selectiveLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAgBxF,KAAK,oBAAoB,GAAG;IAC1B,aAAa,EAAE,IAAI,CAAC,wBAAwB,EAAE,qBAAqB,GAAG,mBAAmB,CAAC,CAAC;IAC3F,MAAM,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAC;IAClD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,0GAA0G;IAC1G,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AA+EF,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EAAE,EACtB,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC,EAChD,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CA6Gf"}

package/build/libraries/modules/selectiveLoader.js

@@ -0,0 +1,164 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadFromManifest = loadFromManifest;
+const promises_1 = __importDefault(require("fs/promises"));
+const module_1 = require("module");
+const path_1 = __importDefault(require("path"));
+const modulePath_1 = require("../modulePath");
+const scopedPortsView_1 = require("./scopedPortsView");
+/** Manifest filePaths are always declared against the TypeScript source tree. */
+const MANIFEST_SOURCE_ROOT = 'src';
+/** Extensions a manifest-declared artifact can have materialised as at runtime. */
+const RUNTIME_EXTENSIONS = ['.ts', '.js'];
+function matchLiftPatterns(patterns, units) {
+    const unitIds = Object.keys(units);
+    const matched = new Set();
+    for (const pattern of patterns) {
+        const colonIndex = pattern.indexOf(':');
+        if (colonIndex === -1) {
+            throw new Error(`Invalid lift pattern "${pattern}". Expected format "module:ArtifactName" or "module:*". Available units: ${unitIds.join(', ')}`);
+        }
+        const modulePart = pattern.substring(0, colonIndex);
+        const artifactPart = pattern.substring(colonIndex + 1);
+        let patternMatched = false;
+        if (artifactPart === '*') {
+            for (const unitId of unitIds) {
+                const unit = units[unitId];
+                if (unit.module === modulePart) {
+                    matched.add(unitId);
+                    patternMatched = true;
+                }
+            }
+        }
+        else {
+            const exactId = `${modulePart}:${artifactPart}`;
+            if (units[exactId]) {
+                matched.add(exactId);
+                patternMatched = true;
+            }
+        }
+        if (!patternMatched) {
+            throw new Error(`No deployment units match pattern "${pattern}". Available units: ${unitIds.join(', ')}`);
+        }
+    }
+    return Array.from(matched).map(id => ({ ...units[id], id }));
+}
+async function fileExists(filePath) {
+    try {
+        await promises_1.default.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Rebases a manifest `src/**` filePath onto the tree this process is running
+ * from, so one manifest serves both the ts-node source tree and a compiled image.
+ */
+function toRuntimePath(filePath, runtimeBase) {
+    const [root, ...rest] = filePath.split(/[\\/]/);
+    return root === MANIFEST_SOURCE_ROOT ? path_1.default.join(runtimeBase, ...rest) : filePath;
+}
+/**
+ * Manifest filePaths carry the `.ts` extension. Requiring them extensionless is
+ * what lets CJS resolution pick the `.ts` under ts-node and the emitted `.js`
+ * from a compiled tree.
+ */
+function stripSourceExtension(filePath) {
+    return filePath.replace(/\.ts$/, '');
+}
+/** True when any runtime extension of an extensionless path is on disk. */
+async function resolvableFileExists(extensionlessPath) {
+    for (const extension of RUNTIME_EXTENSIONS) {
+        if (await fileExists(extensionlessPath + extension))
+            return true;
+    }
+    return false;
+}
+async function loadFromManifest(servicePath, liftPatterns, ports, options = {}) {
+    const { runtimeBase = MANIFEST_SOURCE_ROOT, modulesDirectory = path_1.default.join(runtimeBase, 'modules') } = options;
+    const manifestPath = path_1.default.join(servicePath, '.deployment-units.json');
+    // CJS require() via createRequire so that:
+    // 1. ts-node's .ts extension hook applies — native import() goes through the
+    //    Node ESM resolver, which bypasses it and cannot resolve a types-only
+    //    workspace link such as `ports`
+    // 2. directory imports resolve to index.js/index.ts
+    // Same reason the monolith loader beside this one (fs.ts) uses it.
+    const requireModule = (0, module_1.createRequire)(__filename);
+    if (!(await fileExists(manifestPath))) {
+        throw new Error('No .deployment-units.json found. Run --generateDeploymentUnits');
+    }
+    const manifestContent = await promises_1.default.readFile(manifestPath, 'utf-8');
+    const manifest = JSON.parse(manifestContent);
+    const matchedUnits = matchLiftPatterns(liftPatterns, manifest.units);
+    // Whose setup.ts to run comes from where the artifacts live, not from the
+    // unit's single label: a cross-module merge (`batch-processes:BatchProcesses`
+    // spans batch-processes, items-publishing and systems-integrations) carries
+    // one label but needs all three modules' module-wide process state. The label
+    // only backstops an artifact sitting outside any module directory.
+    const modulesNeeded = new Set(matchedUnits.flatMap(u => u.artifacts.map(a => (0, modulePath_1.moduleFromPath)(a.filePath) || u.module)));
+    const { eventsourcing, logger } = ports;
+    if (!eventsourcing) {
+        throw new Error('ports.eventsourcing is required for selective loading');
+    }
+    for (const moduleName of modulesNeeded) {
+        const setupPath = path_1.default.join(servicePath, modulesDirectory, moduleName, 'setup');
+        if (await resolvableFileExists(setupPath)) {
+            const setup = requireModule(setupPath);
+            const scopedPorts = (0, scopedPortsView_1.scopedPortsView)(ports, logger?.createLoggerInstance(moduleName));
+            if (typeof setup.default === 'function') {
+                await setup.default(scopedPorts);
+            }
+            else if (typeof setup.setup === 'function') {
+                await setup.setup(scopedPorts);
+            }
+        }
+    }
+    const loadedArtifacts = new Set();
+    for (const unit of matchedUnits) {
+        for (const artifact of unit.artifacts) {
+            const artifactKey = `${artifact.filePath}:${artifact.exportName}`;
+            if (loadedArtifacts.has(artifactKey)) {
+                continue;
+            }
+            loadedArtifacts.add(artifactKey);
+            const fullPath = stripSourceExtension(path_1.default.join(servicePath, toRuntimePath(artifact.filePath, runtimeBase)));
+            if (!(await resolvableFileExists(fullPath))) {
+                throw new Error(`Manifest is stale. Run --generateDeploymentUnits (file not found: ${artifact.filePath})`);
+            }
+            const mod = requireModule(fullPath);
+            let factory = mod[artifact.exportName];
+            // If exact export not found, search for the first exported function
+            // whose name contains the artifact name (handles naming variations like
+            // FiscalPeriodListReadmodel vs FiscalPeriodReadmodel)
+            if (typeof factory !== 'function') {
+                const normalizedName = artifact.exportName.toLowerCase();
+                const candidates = Object.entries(mod)
+                    .filter(([, v]) => typeof v === 'function')
+                    .filter(([k]) => k !== 'default' && k !== '__esModule');
+                const match = candidates.find(([k]) => k.toLowerCase().includes(normalizedName.replace(/aggregate$|readmodel$|policy$|system$/, '')));
+                if (match) {
+                    factory = match[1];
+                }
+            }
+            if (typeof factory !== 'function') {
+                throw new Error(`Export "${artifact.exportName}" not found or not a function in ${artifact.filePath}`);
+            }
+            const scopedPorts = (0, scopedPortsView_1.scopedPortsView)(ports, logger?.createLoggerInstance(unit.module));
+            // Several registration functions are `async`; without the await the
+            // unresolved promise is routed and the artifact races the rest of boot.
+            const instance = await factory(scopedPorts);
+            if (artifact.type === 'aggregate' || artifact.type === 'externalSystem') {
+                eventsourcing.routeCommandHandler(instance);
+            }
+            else if (artifact.type === 'readmodel' || artifact.type === 'policy') {
+                eventsourcing.routeEventHandler(instance);
+            }
+        }
+    }
+}
+//# sourceMappingURL=selectiveLoader.js.map

package/build/libraries/modules/selectiveLoader.js.map

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

package/build/libraries/modules/selectiveLoader.test.d.ts

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

package/build/libraries/modules/selectiveLoader.test.d.ts.map

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