@bett3r-dev/pv3 1.0.0 → 1.1.7

package/build/libraries/eventsourcing/utils/policyBuilder.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PolicyBuilder = exports._internalPolicyBuilder = void 0;
+const pv3_types_1 = require("@bett3r-dev/pv3-types");
+const change_case_1 = require("change-case");
+const _1 = require(".");
+const eventHandlerBuilder_1 = require("./eventHandlerBuilder");
+const _internalPolicyBuilder = () => (events, commandHandler, policy = {}) => {
+    return (0, exports.PolicyBuilder)(events, commandHandler, policy);
+};
+exports._internalPolicyBuilder = _internalPolicyBuilder;
+const PolicyBuilder = (events, commandHandler, policy = {}) => {
+    const { eventHandler, ...builder } = (0, eventHandlerBuilder_1.eventHandlerBuilder)(policy);
+    policy = eventHandler;
+    const info = (0, _1.getStackTrace)();
+    policy.name = (0, change_case_1.pascalCase)(info.name);
+    policy.subdomain = policy.subdomain || info.subdomain;
+    policy.filePath = info.filePath;
+    policy.artifactType = 'policy';
+    policy.events = events;
+    policy.commandHandler = commandHandler;
+    const withEventHandlers = (handlers) => {
+        policy.eventHandlers = handlers({
+            createCommand: (0, pv3_types_1.createCommand)(commandHandler)
+        });
+        return _builder;
+    };
+    const withSubdomain = (subdomain) => {
+        policy.subdomain = subdomain;
+        return _builder;
+    };
+    const linkedTo = (...aggregateNames) => {
+        policy.linkedTo = aggregateNames;
+        return _builder;
+    };
+    const standalone = () => {
+        policy.isStandalone = true;
+        return _builder;
+    };
+    const build = () => policy;
+    const _builder = {
+        ...builder,
+        withEventHandlers,
+        withSubdomain,
+        linkedTo,
+        standalone,
+        eventHandler: policy,
+        build
+    };
+    return _builder;
+};
+exports.PolicyBuilder = PolicyBuilder;
+//# sourceMappingURL=policyBuilder.js.map

package/build/libraries/eventsourcing/utils/policyBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policyBuilder.js","sourceRoot":"","sources":["../../../../src/libraries/eventsourcing/utils/policyBuilder.ts"],"names":[],"mappings":";;;AAAA,qDAAwJ;AACxJ,6CAAyC;AACzC,wBAAkC;AAClC,+DAA4D;AAErD,MAAM,sBAAsB,GAAG,GAAG,EAAE,CAAC,CAA8E,MAAc,EAAE,cAA+B,EAAE,MAAM,GAAG,EAAY,EAAG,EAAE;IACnM,OAAO,IAAA,QAAA,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,CAAE,CAAC;AACzD,CAAC,CAAC;AAFW,QAAA,sBAAsB,GAAtB,sBAAsB,CAEjC;AAEK,MAAM,aAAa,GAAG,CAA8E,MAAc,EAAE,cAA+B,EAAE,MAAM,GAAG,EAAY,EAA8C,EAAE;IAC/N,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE,GAAG,IAAA,yCAAmB,EAA0C,MAAM,CAAE,CAAC;IAC3G,MAAM,GAAG,YAA8C,CAAC;IACxD,MAAM,IAAI,GAAG,IAAA,gBAAa,GAAE,CAAC;IAC7B,MAAM,CAAC,IAAI,GAAG,IAAA,wBAAU,EAAE,IAAI,CAAC,IAAI,CAAE,CAAC;IACtC,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC;IACtD,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAChC,MAAM,CAAC,YAAY,GAAG,QAAQ,CAAC;IAC/B,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,CAAC,cAAc,GAAG,cAAc,CAAC;IAEvC,MAAM,iBAAiB,GAAG,CAAE,QAE3B,EAAE,EAAE;QACH,MAAM,CAAC,aAAa,GAAG,QAAQ,CAAC;YAC9B,aAAa,EAAE,IAAA,yBAAa,EAAkB,cAAgC,CAAE;SACjF,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,CAAE,SAAiB,EAAG,EAAE;QAC5C,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;QAC7B,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAE,GAAG,cAAwB,EAAE,EAAE;QAChD,MAAM,CAAC,QAAQ,GAAG,cAAc,CAAC;QACjC,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,GAAG,EAAE;QACtB,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,MAAwC,CAAC;IAE7D,MAAM,QAAQ,GAAG;QACf,GAAG,OAAO;QACV,iBAAiB;QACjB,aAAa;QACb,QAAQ;QACR,UAAU;QACV,YAAY,EAAE,MAAM;QACpB,KAAK;KACN,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAhDW,QAAA,aAAa,GAAb,aAAa,CAgDxB"}

package/build/libraries/eventsourcing/utils/readmodelBuilder.d.ts

@@ -0,0 +1,6 @@
+import { ObjectSchema } from '@bett3r-dev/jsonschema-definer';
+import { Collection, CommittedEvent, Document, EventFactory, Readmodel, ReadmodelBuilderType } from '@bett3r-dev/pv3-types';
+export declare const mergeReducer: <Model extends Document>(collection: Collection<Model>, idPathOrFunction: string | ((event: CommittedEvent) => string | number), includeId?: boolean) => (event: CommittedEvent) => Promise<Model>;
+export declare const _internalReadmodelBuilder: <USER = any>() => <Model extends Document = any, EVENTS extends Record<string, EventFactory> = any>(schema: ObjectSchema<Model>, events?: EVENTS, readmodel?: Readmodel<Model, EVENTS, USER>) => ReadmodelBuilderType<USER, Model, EVENTS>;
+export declare const ReadmodelBuilder: <USER = any, Model extends Document = any, EVENTS extends Record<string, EventFactory> = any>(schema: ObjectSchema<Model>, events?: EVENTS, readmodel?: Readmodel<Model, EVENTS, USER>) => ReadmodelBuilderType<USER, Model, EVENTS>;
+//# sourceMappingURL=readmodelBuilder.d.ts.map

package/build/libraries/eventsourcing/utils/readmodelBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readmodelBuilder.d.ts","sourceRoot":"","sources":["../../../../src/libraries/eventsourcing/utils/readmodelBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAgB,QAAQ,EAAE,YAAY,EAA0B,SAAS,EAAiD,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAMjN,eAAO,MAAM,YAAY,GAAI,KAAK,SAAS,QAAQ,cAAe,UAAU,CAAC,KAAK,CAAC,oBAAoB,MAAM,GAAG,CAAC,CAAE,KAAK,EAAE,cAAc,KAAM,MAAM,GAAG,MAAM,CAAE,kCAAuC,cAAc,mBAGnN,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,IAAI,GAAG,GAAG,QAAQ,KAAK,SAAS,QAAQ,GAAC,GAAG,EAAE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAC,GAAG,UAAW,YAAY,CAAC,KAAK,CAAC,WAAW,MAAM,cAAoB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,KAAI,oBAAoB,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAEnR,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,IAAI,GAAC,GAAG,EAAE,KAAK,SAAS,QAAQ,GAAC,GAAG,EAAE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAC,GAAG,UAAW,YAAY,CAAC,KAAK,CAAC,WAAW,MAAM,cAAoB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,KAAI,oBAAoB,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAyDlQ,CAAC"}

package/build/libraries/eventsourcing/utils/readmodelBuilder.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadmodelBuilder = exports._internalReadmodelBuilder = exports.mergeReducer = void 0;
+const ramda_1 = require("ramda");
+const eventHandlerBuilder_1 = require("./eventHandlerBuilder");
+const _1 = require(".");
+const change_case_1 = require("change-case");
+const mergeReducer = (collection, idPathOrFunction, includeId = true) => async (event) => {
+    const id = typeof idPathOrFunction === 'string' ? (0, ramda_1.path)(idPathOrFunction.split('.'), event) : idPathOrFunction(event);
+    return collection.upsert(id, { ...(includeId ? { id } : {}), ...event.data, lastEvent: (0, ramda_1.pick)(['id', 'position', 'name', 'version'], event) });
+};
+exports.mergeReducer = mergeReducer;
+const _internalReadmodelBuilder = () => (schema, events, readmodel = {}) => {
+    return (0, exports.ReadmodelBuilder)(schema, events, readmodel);
+};
+exports._internalReadmodelBuilder = _internalReadmodelBuilder;
+const ReadmodelBuilder = (schema, events, readmodel = {}) => {
+    // ApplicationsReadmodel
+    // applications-readmodel
+    const info = (0, _1.getStackTrace)();
+    readmodel.name = readmodel.name || (0, change_case_1.pascalCase)(`${info.name}Readmodel`);
+    readmodel.subdomain = readmodel.subdomain || info.subdomain;
+    readmodel.filePath = info.filePath;
+    readmodel.artifactType = 'readmodel';
+    const { eventHandler, ...builder } = (0, eventHandlerBuilder_1.eventHandlerBuilder)(readmodel);
+    readmodel = eventHandler;
+    readmodel.isReadmodel = true;
+    readmodel.schema = schema;
+    readmodel.events = events;
+    readmodel.idProperty = 'id';
+    const withIdProperty = (idProperty) => {
+        readmodel.idProperty = idProperty;
+        return _builder;
+    };
+    const withDatabase = (database, collection, sessionDatabase) => {
+        readmodel.database = database;
+        readmodel.sessionDatabase = sessionDatabase;
+        readmodel.collection = collection || readmodel.name;
+        return _builder;
+    };
+    const withProjector = (eventProjectors) => {
+        readmodel.eventProjectors = eventProjectors ? eventProjectors({ database: readmodel.database, collection: readmodel.collection }) : {};
+        return _builder;
+    };
+    const withQuery = (query) => {
+        readmodel.queries ||= [];
+        readmodel.queries.push(query || {});
+        return _builder;
+    };
+    const withSubdomain = (subdomain) => {
+        readmodel.subdomain = subdomain;
+        return _builder;
+    };
+    const build = () => readmodel;
+    const _builder = {
+        ...builder,
+        withIdProperty,
+        withDatabase,
+        withProjector,
+        withQuery,
+        withSubdomain,
+        eventHandler: readmodel,
+        build
+    };
+    return _builder;
+};
+exports.ReadmodelBuilder = ReadmodelBuilder;
+//# sourceMappingURL=readmodelBuilder.js.map

package/build/libraries/eventsourcing/utils/readmodelBuilder.js.map

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

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

@@ -0,0 +1,6 @@
+import { PortsBase } from '@bett3r-dev/pv3-types';
+export declare const LocalOutbox: (ports: Pick<PortsBase, 'endpoints' | 'eventsourcing' | 'eventstore'>) => {
+    start: () => Promise<void>;
+    stop: () => Promise<void>;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/libraries/localOutbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGlE,eAAO,MAAM,WAAW,UAAY,IAAI,CAAC,SAAS,EAAE,WAAW,GAAG,eAAe,GAAG,YAAY,CAAC;;;CAoEhG,CAAC"}

package/build/libraries/localOutbox/index.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalOutbox = void 0;
+const async_1 = require("async");
+const LocalOutbox = (ports) => {
+    const consumerQueues = {};
+    const consumerQueues2 = {};
+    const processEvent = (route) => (event, callback) => {
+        ports.endpoints.post(route, {
+            body: event
+        }).then((result) => {
+            callback(null, result);
+        })
+            .catch((err) => {
+            callback(err);
+        });
+    };
+    const enqueueEvent = (event) => {
+        if (!consumerQueues2[event.name]) {
+            console.warn('No consumer queues for event', event.name);
+        }
+        else {
+            consumerQueues2[event.name].forEach(q => q.push(event));
+        }
+    };
+    const start = async () => {
+        Object.entries(ports.eventsourcing.registeredEndpoints.policies)
+            .concat(Object.entries(ports.eventsourcing.registeredEndpoints.projectors))
+            // A QUERY-ONLY readmodel is in `projectors` too since TV1-2275, so that it gets an
+            // MDU node and its GET route can be placed. It subscribes to nothing and has no
+            // event-handler POST route, so `route` is '' — building a consumer queue for it
+            // would POST every event at the empty route. Filtered here, at the one consumer
+            // that dispatches, rather than by narrowing the registry the manifest reads.
+            .filter(([, { events }]) => events.length > 0)
+            .forEach(([name, { route, events }]) => {
+            console.log('Creating consumer queue for', name, 'with route', route);
+            const consumerQueue = (0, async_1.queue)(processEvent(route), 1);
+            consumerQueue.error((err, event) => {
+                console.error(err);
+                console.log('Error Processing event', event.name, 'in Event Handler', name);
+                console.log('Event Payload', event);
+                console.log('Dying now');
+                process.exit(1);
+            });
+            events.forEach((e) => {
+                consumerQueues2[e] ||= [];
+                consumerQueues2[e].push(consumerQueue);
+            });
+            // consumerQueues[name] = queue(processEvent(route), 1)
+        });
+        // listen to new Events
+        ports.eventstore.subscribe(async (slim) => {
+            const events = await ports.eventstore.read({ from: slim.position - 1, limit: 1 });
+            const event = events.find(e => e.position === slim.position);
+            if (event)
+                enqueueEvent(event);
+        });
+        // load preexisting events in eventStore
+        return ports.eventstore.read({})
+            .then((events) => events.forEach(enqueueEvent));
+    };
+    const stop = async () => {
+        Object.values(consumerQueues).forEach(q => q.kill());
+        Object.values(consumerQueues2).forEach(q => q.forEach(q => q.kill()));
+    };
+    return {
+        start,
+        stop
+    };
+};
+exports.LocalOutbox = LocalOutbox;
+//# sourceMappingURL=index.js.map

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

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

package/build/libraries/modulePath.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Derives the module an artifact belongs to from where its source file lives:
+ * the segment following `modules/` in `.../modules/<name>/...`.
+ *
+ * This is the single source of truth for that rule. `getStackTrace()` reads it
+ * off the stack frame at registration time, `computeMDUs` labels deployment
+ * units with it, and the selective loader uses it to decide whose `setup.ts` to
+ * run — so a declared subdomain can never disagree with where the code sits.
+ *
+ * Returns `undefined` for a file outside any module directory; callers decide
+ * what to fall back to.
+ */
+export declare const moduleFromPath: (filePath: string | undefined) => string | undefined;
+//# sourceMappingURL=modulePath.d.ts.map

package/build/libraries/modulePath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modulePath.d.ts","sourceRoot":"","sources":["../../src/libraries/modulePath.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,aAAe,MAAM,GAAG,SAAS,KAAI,MAAM,GAAG,SAGxE,CAAC"}

package/build/libraries/modulePath.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.moduleFromPath = void 0;
+/**
+ * Derives the module an artifact belongs to from where its source file lives:
+ * the segment following `modules/` in `.../modules/<name>/...`.
+ *
+ * This is the single source of truth for that rule. `getStackTrace()` reads it
+ * off the stack frame at registration time, `computeMDUs` labels deployment
+ * units with it, and the selective loader uses it to decide whose `setup.ts` to
+ * run — so a declared subdomain can never disagree with where the code sits.
+ *
+ * Returns `undefined` for a file outside any module directory; callers decide
+ * what to fall back to.
+ */
+const moduleFromPath = (filePath) => {
+    const match = filePath?.match(/[/\\]modules[/\\]([^/\\]+)[/\\]/);
+    return match ? match[1] : undefined;
+};
+exports.moduleFromPath = moduleFromPath;
+//# sourceMappingURL=modulePath.js.map

package/build/libraries/modulePath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modulePath.js","sourceRoot":"","sources":["../../src/libraries/modulePath.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;GAWG;AACI,MAAM,cAAc,GAAG,CAAE,QAA4B,EAAuB,EAAE;IACnF,MAAM,KAAK,GAAG,QAAQ,EAAE,KAAK,CAAE,iCAAiC,CAAE,CAAC;IACnE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtC,CAAC,CAAC;AAHW,QAAA,cAAc,GAAd,cAAc,CAGzB"}

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

@@ -1,12 +1,10 @@
-import { Ports } from '@bett3r-dev/pv3-types';
+import { PortsBase } from '@bett3r-dev/pv3-types';
 export type LoadModuleOptions = {
-    whiteList?: (string | RegExp)[];
     blackList?: (string | RegExp)[];
 };
 export declare function loadModulesFromDirectory(modulesPath: string, options?: LoadModuleOptions): Promise<{
     modules: Record<string, {
-        create: (ports: Partial<Ports>) => any;
+        create: (ports: Partial<PortsBase>) => any;
     }>;
-    modulesList: Record<string, string[]>;
 }>;
 //# sourceMappingURL=fs.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../../src/libraries/modules/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAI9C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,CAAC,EAAE,CAAE,MAAM,GAAC,MAAM,CAAE,EAAE,CAAA;IAC/B,SAAS,CAAC,EAAE,CAAE,MAAM,GAAC,MAAM,CAAE,EAAE,CAAA;CAChC,CAAA;AA2BD,wBAAsB,wBAAwB,CAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAC,MAAM,EAAE,CAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,KAAM,GAAG,CAAA;KAAC,CAAC,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAC,MAAM,EAAE,CAAC,CAAA;CAAC,CAAC,CAqD1N"}
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../../src/libraries/modules/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAMlD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,CAAC,EAAE,CAAE,MAAM,GAAG,MAAM,CAAE,EAAE,CAAA;CAClC,CAAC;AAWF,wBAAsB,wBAAwB,CAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,CAAE,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,KAAM,GAAG,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA8B5L"}

package/build/libraries/modules/fs.js

@@ -1,103 +1,40 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : 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 __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadModulesFromDirectory = void 0;
+exports.loadModulesFromDirectory = loadModulesFromDirectory;
 const promises_1 = __importDefault(require("fs/promises"));
+const module_1 = require("module");
 const path_1 = __importDefault(require("path"));
-function rejectFilename(filename, module, { whiteList, blackList }) {
+const scopedPortsView_1 = require("./scopedPortsView");
+function rejectFilename(filename, module, { blackList }) {
     if (filename === '.git' ||
         filename === '.DS_Store' ||
-        (whiteList?.length && !whiteList?.some((match) => !match.test ? match === module : match.test(module))) ||
         (blackList?.length && blackList?.some((match) => !match.test ? match === module : match.test(module))))
         return true;
 }
-const getArtifactsFromModule = async (modulesPath, moduleName, artifactsList = []) => {
-    const files = await promises_1.default.readdir(path_1.default.join(modulesPath, moduleName));
-    for (const file of files) {
-        const stat = await promises_1.default.stat(path_1.default.join(modulesPath, moduleName, file));
-        if (stat.isDirectory()) {
-            artifactsList = await getArtifactsFromModule(path_1.default.join(modulesPath, moduleName), file, artifactsList);
-        }
-        else {
-            if (file.search(/\.(readmodel|aggregate|externalSystem|system|policy)\.(j|t)s/mig) !== -1) {
-                artifactsList.push(file.replace(/\.(j|t)s/mig, ''));
-            }
-        }
-    }
-    return artifactsList;
-};
 async function loadModulesFromDirectory(modulesPath, options = {}) {
     const modules = await promises_1.default.readdir(modulesPath);
-    const modulesList = modules.reduce((acc, component) => {
-        acc[component] = {};
-        return acc;
-    }, {});
-    // const e = Error('x');
-    //   const line = e.stack?.split('\n')[2];
-    //   // regex to extract folder name from generic line
-    //   // const line = 'at Object.routeEventHandler (/Users/tomasruiz/Documents/development/pv3/src/ports/eventsourcing/index.ts:79:40)';
-    //   //REVIEW: Esto hay que probarlo en windows
-    //   const folder = line?.match(/[\/\\].+?\.(j|t)s/g)?.[0];
-    // if (folder){
-    //   const f = path.basename(folder);
-    //   fs.readdir(folder).then(async files => {
-    //     for (const file of files) {
-    //       const stat = await fs.stat(path.join(folder, file))
-    //       if (stat.isDirectory()){
-    //       } else {
-    //         console.log(files)
-    //       }
-    //     }
-    //   })
-    // }
-    // console.log('%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%', e.stack);
-    if (options.whiteList) {
-        const missing = options.whiteList.reduce((errors, w) => {
-            !modules.some(c => RegExp(w).test(c)) && errors.push(w);
-            return errors;
-        }, []);
-        if (missing.length)
-            throw Error(`Whitelisted module or pattern not found or returned 0 matches: ${missing.join(', ')}`);
-    }
-    const modulesMap = {};
-    for (let moduleName of modules) {
-        const module = path_1.default.parse(moduleName).name;
-        modulesList[moduleName] = await getArtifactsFromModule(modulesPath, moduleName);
+    const filteredModules = modules
+        .map(moduleName => ({ moduleName, module: path_1.default.parse(moduleName).name }))
+        .filter(({ moduleName, module }) => !rejectFilename(moduleName, module, options));
+    // Use CJS require() via createRequire so that:
+    // 1. Directory imports resolve to index.js/index.ts (CJS supports this, ESM import() does not)
+    // 2. ts-node's .ts extension patches apply
+    // Node16 module mode preserves native import() in CJS output, which breaks directory imports.
+    const requireModule = (0, module_1.createRequire)(modulesPath + path_1.default.sep);
+    const entries = await Promise.all(filteredModules.map(async ({ moduleName, module }) => {
         const filePath = `${modulesPath}/${moduleName}`;
-        if (rejectFilename(moduleName, module, options))
-            continue;
-        else
-            modulesMap[module] = await Promise.resolve(`${filePath}`).then(s => __importStar(require(s)));
-    }
+        const imported = requireModule(filePath);
+        return [module, {
+                ...imported,
+                create: (ports) => imported.create((0, scopedPortsView_1.scopedPortsView)(ports, ports.logger?.createLoggerInstance(moduleName)))
+            }];
+    }));
+    const modulesMap = Object.fromEntries(entries);
     return {
-        modules: modulesMap,
-        modulesList
+        modules: modulesMap
     };
 }
-exports.loadModulesFromDirectory = loadModulesFromDirectory;
 //# sourceMappingURL=fs.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../../src/libraries/modules/fs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../../src/libraries/modules/fs.ts"],"names":[],"mappings":";;;;;;AACA,2DAA6B;AAC7B,mCAAuC;AACvC,gDAAwB;AACxB,uDAAoD;AAMpD,SAAS,cAAc,CAAE,QAAe,EAAE,MAAa,EAAE,EAAE,SAAS,EAAqB;IACvF,IACE,QAAQ,KAAK,MAAM;QACnB,QAAQ,KAAK,WAAW;QACxB,CAAE,SAAS,EAAE,MAAM,IAAI,SAAS,EAAE,IAAI,CAAC,CAAE,KAAU,EAAG,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAE,MAAM,CAAE,CAAC,CAAC;QAEhH,OAAO,IAAI,CAAC;AAChB,CAAC;AAEM,KAAK,mCAAoC,WAAmB,EAAE,OAAO,GAAsB,EAAE;IAClG,MAAM,OAAO,GAAG,MAAM,kBAAE,CAAC,OAAO,CAAE,WAAW,CAAE,CAAC;IAEhD,MAAM,eAAe,GAAG,OAAO;SAC5B,GAAG,CAAE,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,cAAI,CAAC,KAAK,CAAE,UAAU,CAAE,CAAC,IAAI,EAAE,CAAC,CAAC;SAC3E,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,cAAc,CAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAE,CAAC,CAAC;IAEtF,+CAA+C;IAC/C,+FAA+F;IAC/F,2CAA2C;IAC3C,8FAA8F;IAC9F,MAAM,aAAa,GAAG,IAAA,sBAAa,EAAE,WAAW,GAAG,cAAI,CAAC,GAAG,CAAE,CAAC;IAE9D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,eAAe,CAAC,GAAG,CAAE,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE;QACpD,MAAM,QAAQ,GAAG,GAAG,WAAW,IAAI,UAAU,EAAE,CAAC;QAChD,MAAM,QAAQ,GAAG,aAAa,CAAE,QAAQ,CAAE,CAAC;QAC3C,OAAO,CAAE,MAAM,EAAE;gBACf,GAAG,QAAQ;gBACX,MAAM,EAAE,CAAE,KAAyB,EAAG,EAAE,CACtC,QAAQ,CAAC,MAAM,CAAE,IAAA,iCAAe,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,oBAAoB,CAAE,UAAU,CAAE,CAAC,CAAC;aAC9F,CAAU,CAAC;IACd,CAAC,CAAC,CACH,CAAC;IAEF,MAAM,UAAU,GAAwB,MAAM,CAAC,WAAW,CAAE,OAAO,CAAE,CAAC;IAEtE,OAAO;QACL,OAAO,EAAE,UAAU;KACpB,CAAC;AACJ,CAAC"}

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

@@ -1,2 +1,4 @@
 export * from './fs';
+export * from './selectiveLoader';
+export * from './scopedPortsView';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/libraries/modules/index.ts"],"names":[],"mappings":"AAAA,cAAc,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/libraries/modules/index.ts"],"names":[],"mappings":"AAAA,cAAc,MAAM,CAAC;AACrB,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}

package/build/libraries/modules/index.js

@@ -15,4 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./fs"), exports);
+__exportStar(require("./selectiveLoader"), exports);
+__exportStar(require("./scopedPortsView"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/libraries/modules/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uCAAqB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/libraries/modules/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uCAAqB;AACrB,oDAAkC;AAClC,oDAAkC"}

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

@@ -0,0 +1,42 @@
+/**
+ * TV1-2271 — a module loader hands an artifact factory a DELEGATING VIEW of the
+ * composition root's ports, not a copy.
+ *
+ * The loaders used to build the per-module scoped ports as `{ ...ports, log }`.
+ * That spread ENUMERATES the root, so on a composition root whose ports are lazy
+ * memoized getters (teselly's `setupPorts`), every port in the application is
+ * constructed at module-load time — the laziness is defeated by the very object
+ * that is supposed to consume it. A delegating view reads nothing at creation
+ * time: a port is constructed on FIRST READ, by the artifact that actually needs
+ * it, and two views over the same root resolve to the SAME instance because the
+ * memo lives in the root's closure and the read falls through to it.
+ *
+ * WHY `Object.create` AND NOT A `Proxy`.
+ * A proxy installs a trap on every read of the hottest object in the process,
+ * and — more decisively — it breaks identity: teselly keys a `WeakMap` on the
+ * ports object (`setupGenerationPorts.ts:103`), and a proxy is not the target.
+ *
+ * WHY NOT COPYING GETTER DESCRIPTORS.
+ * Copying descriptors re-creates a getter per view whose `this` is the VIEW.
+ * Any getter that memoizes onto `this` then writes its memo onto the view, so
+ * every module gets its own pool / redis connection / eventstore. That is the
+ * exact `this`-memoization hazard TV1-2266 closed; delegation is what keeps it
+ * closed, since the inherited getter still runs with the root as its receiver
+ * only when the memo is a closure — and here it is.
+ *
+ * OWN-KEY DISCIPLINE — the contract this helper defines.
+ * A scoped view must never gain own properties. Its only own key is `log`.
+ * A downstream `{ ...scopedPortsView( ports, log ) }` yields `{ log }` ONLY, so
+ * the next port read is `undefined` — this is a crash, not a leak.
+ * Do not spread, enumerate (`Object.keys` / `Object.entries` / `for...in`) or
+ * `hasOwnProperty` a scoped ports object.
+ *
+ * `log` is deliberately `writable` and `configurable`, matching the mutability
+ * the old spread-produced object had.
+ *
+ * ESCAPE HATCH: set `PV3_SCOPED_PORTS_LEGACY_SPREAD=1` to restore the legacy
+ * spread. This is the only recovery lever short of revert-rebuild-redeploy, so
+ * the variable is read at CALL time, never captured at module load.
+ */
+export declare const scopedPortsView: <T extends object>(ports: T, log: unknown) => T;
+//# sourceMappingURL=scopedPortsView.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scopedPortsView.d.ts","sourceRoot":"","sources":["../../../src/libraries/modules/scopedPortsView.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,MAAM,SAAU,CAAC,OAAO,OAAO,KAAI,CAU5E,CAAC"}

package/build/libraries/modules/scopedPortsView.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scopedPortsView = void 0;
+/**
+ * TV1-2271 — a module loader hands an artifact factory a DELEGATING VIEW of the
+ * composition root's ports, not a copy.
+ *
+ * The loaders used to build the per-module scoped ports as `{ ...ports, log }`.
+ * That spread ENUMERATES the root, so on a composition root whose ports are lazy
+ * memoized getters (teselly's `setupPorts`), every port in the application is
+ * constructed at module-load time — the laziness is defeated by the very object
+ * that is supposed to consume it. A delegating view reads nothing at creation
+ * time: a port is constructed on FIRST READ, by the artifact that actually needs
+ * it, and two views over the same root resolve to the SAME instance because the
+ * memo lives in the root's closure and the read falls through to it.
+ *
+ * WHY `Object.create` AND NOT A `Proxy`.
+ * A proxy installs a trap on every read of the hottest object in the process,
+ * and — more decisively — it breaks identity: teselly keys a `WeakMap` on the
+ * ports object (`setupGenerationPorts.ts:103`), and a proxy is not the target.
+ *
+ * WHY NOT COPYING GETTER DESCRIPTORS.
+ * Copying descriptors re-creates a getter per view whose `this` is the VIEW.
+ * Any getter that memoizes onto `this` then writes its memo onto the view, so
+ * every module gets its own pool / redis connection / eventstore. That is the
+ * exact `this`-memoization hazard TV1-2266 closed; delegation is what keeps it
+ * closed, since the inherited getter still runs with the root as its receiver
+ * only when the memo is a closure — and here it is.
+ *
+ * OWN-KEY DISCIPLINE — the contract this helper defines.
+ * A scoped view must never gain own properties. Its only own key is `log`.
+ * A downstream `{ ...scopedPortsView( ports, log ) }` yields `{ log }` ONLY, so
+ * the next port read is `undefined` — this is a crash, not a leak.
+ * Do not spread, enumerate (`Object.keys` / `Object.entries` / `for...in`) or
+ * `hasOwnProperty` a scoped ports object.
+ *
+ * `log` is deliberately `writable` and `configurable`, matching the mutability
+ * the old spread-produced object had.
+ *
+ * ESCAPE HATCH: set `PV3_SCOPED_PORTS_LEGACY_SPREAD=1` to restore the legacy
+ * spread. This is the only recovery lever short of revert-rebuild-redeploy, so
+ * the variable is read at CALL time, never captured at module load.
+ */
+const scopedPortsView = (ports, log) => {
+    if (process.env.PV3_SCOPED_PORTS_LEGACY_SPREAD === '1') {
+        return { ...ports, log };
+    }
+    // `Object.create` is typed `any`; the cast to `T` is written and checked HERE,
+    // once, so the three loader call sites stay cast-free.
+    return Object.create(ports, {
+        log: { value: log, enumerable: true, writable: true, configurable: true }
+    });
+};
+exports.scopedPortsView = scopedPortsView;
+//# sourceMappingURL=scopedPortsView.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scopedPortsView.js","sourceRoot":"","sources":["../../../src/libraries/modules/scopedPortsView.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACI,MAAM,eAAe,GAAG,CAAoB,KAAQ,EAAE,GAAY,EAAM,EAAE;IAC/E,IAAK,OAAO,CAAC,GAAG,CAAC,8BAA8B,KAAK,GAAG,EAAG,CAAC;QACzD,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,EAAO,CAAC;IAChC,CAAC;IAED,+EAA+E;IAC/E,uDAAuD;IACvD,OAAO,MAAM,CAAC,MAAM,CAAE,KAAK,EAAE;QAC3B,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE;KAC1E,CAAM,CAAC;AACV,CAAC,CAAC;AAVW,QAAA,eAAe,GAAf,eAAe,CAU1B"}

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

@@ -0,0 +1,10 @@
+/**
+ * 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.
+ */
+export {};
+//# sourceMappingURL=scopedPortsView.test.d.ts.map

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

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