@vived/host 5.4.2 → 5.6.0

package/dist/cjs/BoundaryLog/Adapters/boundaryLogAdapter.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.boundaryLogAdapter = void 0;
+const BoundaryLogPM_1 = require("../PMs/BoundaryLogPM");
+exports.boundaryLogAdapter = {
+    defaultVM: BoundaryLogPM_1.defaultBoundaryLogVM,
+    subscribe: (appObjects, setVM) => {
+        const pm = BoundaryLogPM_1.BoundaryLogPM.get(appObjects);
+        if (!pm) {
+            appObjects.submitError("boundaryLogAdapter", "Unable to find BoundaryLogPM");
+            return;
+        }
+        pm.addView(setVM);
+    },
+    unsubscribe: (appObjects, setVM) => {
+        const pm = BoundaryLogPM_1.BoundaryLogPM.get(appObjects);
+        if (!pm) {
+            appObjects.submitError("boundaryLogAdapter", "Unable to find BoundaryLogPM");
+            return;
+        }
+        pm.removeView(setVM);
+    }
+};
+//# sourceMappingURL=boundaryLogAdapter.js.map

package/dist/cjs/BoundaryLog/Adapters/boundaryLogAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundaryLogAdapter.js","sourceRoot":"","sources":["../../../../src/BoundaryLog/Adapters/boundaryLogAdapter.ts"],"names":[],"mappings":";;;AACA,wDAI8B;AAEjB,QAAA,kBAAkB,GAAsC;IACnE,SAAS,EAAE,oCAAoB;IAC/B,SAAS,EAAE,CACT,UAAyB,EACzB,KAAkC,EAClC,EAAE;QACF,MAAM,EAAE,GAAG,6BAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACzC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CACpB,oBAAoB,EACpB,8BAA8B,CAC/B,CAAC;YACF,OAAO;QACT,CAAC;QACD,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IACD,WAAW,EAAE,CACX,UAAyB,EACzB,KAAkC,EAClC,EAAE;QACF,MAAM,EAAE,GAAG,6BAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACzC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CACpB,oBAAoB,EACpB,8BAA8B,CAC/B,CAAC;YACF,OAAO;QACT,CAAC;QACD,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;CACF,CAAC","sourcesContent":["import { AppObjectRepo, SingletonPmAdapter } from \"@vived/core\";\r\nimport {\r\n  BoundaryLogPM,\r\n  BoundaryLogVM,\r\n  defaultBoundaryLogVM\r\n} from \"../PMs/BoundaryLogPM\";\r\n\r\nexport const boundaryLogAdapter: SingletonPmAdapter<BoundaryLogVM> = {\r\n  defaultVM: defaultBoundaryLogVM,\r\n  subscribe: (\r\n    appObjects: AppObjectRepo,\r\n    setVM: (vm: BoundaryLogVM) => void\r\n  ) => {\r\n    const pm = BoundaryLogPM.get(appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\r\n        \"boundaryLogAdapter\",\r\n        \"Unable to find BoundaryLogPM\"\r\n      );\r\n      return;\r\n    }\r\n    pm.addView(setVM);\r\n  },\r\n  unsubscribe: (\r\n    appObjects: AppObjectRepo,\r\n    setVM: (vm: BoundaryLogVM) => void\r\n  ) => {\r\n    const pm = BoundaryLogPM.get(appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\r\n        \"boundaryLogAdapter\",\r\n        \"Unable to find BoundaryLogPM\"\r\n      );\r\n      return;\r\n    }\r\n    pm.removeView(setVM);\r\n  }\r\n};\r\n"]}

package/dist/cjs/BoundaryLog/Adapters/index.js

@@ -0,0 +1,18 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./boundaryLogAdapter"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/BoundaryLog/Adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/BoundaryLog/Adapters/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC","sourcesContent":["export * from \"./boundaryLogAdapter\";\r\n"]}

package/dist/cjs/BoundaryLog/Controllers/clearBoundaryLog.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearBoundaryLog = clearBoundaryLog;
+const Entities_1 = require("../Entities");
+/** Clears the Boundary Log on demand (the tab's Clear action). */
+function clearBoundaryLog(appObjects) {
+    const entity = Entities_1.BoundaryLogEntity.get(appObjects);
+    if (entity) {
+        entity.clear();
+    }
+    else {
+        appObjects.submitError("clearBoundaryLog", "Unable to find BoundaryLogEntity");
+    }
+}
+//# sourceMappingURL=clearBoundaryLog.js.map

package/dist/cjs/BoundaryLog/Controllers/clearBoundaryLog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clearBoundaryLog.js","sourceRoot":"","sources":["../../../../src/BoundaryLog/Controllers/clearBoundaryLog.ts"],"names":[],"mappings":";;AAIA,4CAUC;AAbD,0CAAgD;AAEhD,kEAAkE;AAClE,SAAgB,gBAAgB,CAAC,UAAyB;IACxD,MAAM,MAAM,GAAG,4BAAiB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACjD,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,WAAW,CACpB,kBAAkB,EAClB,kCAAkC,CACnC,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["import { AppObjectRepo } from \"@vived/core\";\r\nimport { BoundaryLogEntity } from \"../Entities\";\r\n\r\n/** Clears the Boundary Log on demand (the tab's Clear action). */\r\nexport function clearBoundaryLog(appObjects: AppObjectRepo) {\r\n  const entity = BoundaryLogEntity.get(appObjects);\r\n  if (entity) {\r\n    entity.clear();\r\n  } else {\r\n    appObjects.submitError(\r\n      \"clearBoundaryLog\",\r\n      \"Unable to find BoundaryLogEntity\"\r\n    );\r\n  }\r\n}\r\n"]}

package/dist/cjs/BoundaryLog/Controllers/index.js

@@ -0,0 +1,18 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./clearBoundaryLog"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/BoundaryLog/Controllers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/BoundaryLog/Controllers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC","sourcesContent":["export * from \"./clearBoundaryLog\";\r\n"]}

package/dist/cjs/BoundaryLog/Entities/BoundaryLogEntity.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BoundaryLogEntity = void 0;
+exports.makeBoundaryLogEntity = makeBoundaryLogEntity;
+const core_1 = require("@vived/core");
+const snapshotPayload_1 = require("./snapshotPayload");
+/**
+ * The Boundary Log: a passive, chronological recording of every Request
+ * observed crossing the host↔App boundary. Accumulates unbounded within a
+ * session and is only reset by an explicit clear() — never by traffic itself.
+ */
+class BoundaryLogEntity extends core_1.AppObjectEntity {
+    static get(appObjects) {
+        return (0, core_1.getSingletonComponent)(BoundaryLogEntity.type, appObjects);
+    }
+}
+exports.BoundaryLogEntity = BoundaryLogEntity;
+BoundaryLogEntity.type = "BoundaryLogEntity";
+function makeBoundaryLogEntity(appObject) {
+    return new BoundaryLogEntityImp(appObject);
+}
+class BoundaryLogEntityImp extends BoundaryLogEntity {
+    constructor(appObject) {
+        super(appObject, BoundaryLogEntity.type);
+        this.records = [];
+        this.recordTraffic = (direction, request, outcome) => {
+            const record = {
+                direction,
+                type: request.type,
+                version: request.version,
+                payload: (0, snapshotPayload_1.snapshotPayload)(request.payload),
+                timestamp: Date.now(),
+                outcome
+            };
+            this.records.push(record);
+            this.notifyOnChange();
+        };
+        this.clear = () => {
+            this.records = [];
+            this.notifyOnChange();
+        };
+        this.appObjects.registerSingleton(this);
+    }
+}
+//# sourceMappingURL=BoundaryLogEntity.js.map

package/dist/cjs/BoundaryLog/Entities/BoundaryLogEntity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoundaryLogEntity.js","sourceRoot":"","sources":["../../../../src/BoundaryLog/Entities/BoundaryLogEntity.ts"],"names":[],"mappings":";;;AAgEA,sDAEC;AAlED,sCAMqB;AACrB,uDAAqE;AA+BrE;;;;GAIG;AACH,MAAsB,iBAAkB,SAAQ,sBAAe;IAG7D,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAC1B,iBAAiB,CAAC,IAAI,EACtB,UAAU,CACX,CAAC;IACJ,CAAC;;AARH,8CAmBC;AAlBQ,sBAAI,GAAG,mBAAmB,CAAC;AAoBpC,SAAgB,qBAAqB,CAAC,SAAoB;IACxD,OAAO,IAAI,oBAAoB,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,oBAAqB,SAAQ,iBAAiB;IA0BlD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;QA1B3C,YAAO,GAAoB,EAAE,CAAC;QAE9B,kBAAa,GAAG,CACd,SAA2B,EAC3B,OAAgB,EAChB,OAAuB,EACjB,EAAE;YACR,MAAM,MAAM,GAAkB;gBAC5B,SAAS;gBACT,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,OAAO,EAAE,IAAA,iCAAe,EAAC,OAAO,CAAC,OAAO,CAAC;gBACzC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,OAAO;aACR,CAAC;YAEF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC,CAAC;QAEF,UAAK,GAAG,GAAS,EAAE;YACjB,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;YAClB,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC,CAAC;QAIA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectEntity,\r\n  AppObjectRepo,\r\n  Request\r\n} from \"@vived/core\";\r\nimport { PayloadSnapshot, snapshotPayload } from \"./snapshotPayload\";\r\n\r\n/** Which way a recorded Request crossed the host↔App boundary. */\r\nexport type RequestDirection = \"dispatch\" | \"handler\";\r\n\r\n/**\r\n * What happened to a recorded Request. Outbound (Dispatch) records use\r\n * \"delivered\" | \"no-app-handler\" | \"threw\"; inbound (Handler) records use\r\n * \"handled\" | \"unsupported\" | \"threw\".\r\n */\r\nexport type RequestOutcome =\r\n  | \"delivered\"\r\n  | \"no-app-handler\"\r\n  | \"handled\"\r\n  | \"unsupported\"\r\n  | \"threw\";\r\n\r\n/**\r\n * One captured entry in the Boundary Log: the observed Request plus its\r\n * direction, a frozen payload snapshot, the time it was observed, and its\r\n * outcome. Distinct from the live wire Request it was captured from.\r\n */\r\nexport interface RequestRecord {\r\n  direction: RequestDirection;\r\n  type: string;\r\n  version: number;\r\n  payload: PayloadSnapshot;\r\n  timestamp: number;\r\n  outcome: RequestOutcome;\r\n}\r\n\r\n/**\r\n * The Boundary Log: a passive, chronological recording of every Request\r\n * observed crossing the host↔App boundary. Accumulates unbounded within a\r\n * session and is only reset by an explicit clear() — never by traffic itself.\r\n */\r\nexport abstract class BoundaryLogEntity extends AppObjectEntity {\r\n  static type = \"BoundaryLogEntity\";\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<BoundaryLogEntity>(\r\n      BoundaryLogEntity.type,\r\n      appObjects\r\n    );\r\n  }\r\n\r\n  abstract records: RequestRecord[];\r\n\r\n  abstract recordTraffic: (\r\n    direction: RequestDirection,\r\n    request: Request,\r\n    outcome: RequestOutcome\r\n  ) => void;\r\n\r\n  abstract clear: () => void;\r\n}\r\n\r\nexport function makeBoundaryLogEntity(appObject: AppObject): BoundaryLogEntity {\r\n  return new BoundaryLogEntityImp(appObject);\r\n}\r\n\r\nclass BoundaryLogEntityImp extends BoundaryLogEntity {\r\n  records: RequestRecord[] = [];\r\n\r\n  recordTraffic = (\r\n    direction: RequestDirection,\r\n    request: Request,\r\n    outcome: RequestOutcome\r\n  ): void => {\r\n    const record: RequestRecord = {\r\n      direction,\r\n      type: request.type,\r\n      version: request.version,\r\n      payload: snapshotPayload(request.payload),\r\n      timestamp: Date.now(),\r\n      outcome\r\n    };\r\n\r\n    this.records.push(record);\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  clear = (): void => {\r\n    this.records = [];\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, BoundaryLogEntity.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}

package/dist/cjs/BoundaryLog/Entities/index.js

@@ -0,0 +1,19 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./BoundaryLogEntity"), exports);
+__exportStar(require("./snapshotPayload"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/BoundaryLog/Entities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/BoundaryLog/Entities/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,oDAAkC","sourcesContent":["export * from \"./BoundaryLogEntity\";\r\nexport * from \"./snapshotPayload\";\r\n"]}

package/dist/cjs/BoundaryLog/Entities/snapshotPayload.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.snapshotPayload = snapshotPayload;
+const UNREADABLE = "⟨unreadable⟩";
+/**
+ * Preview a single value one level deep. Objects and arrays are marked rather
+ * than expanded, so circular structures are inherently safe. Any access that
+ * throws (e.g. a getter) is caught and rendered as unreadable.
+ */
+function previewValue(value) {
+    try {
+        if (value === null)
+            return "null";
+        if (value === undefined)
+            return "undefined";
+        const type = typeof value;
+        if (type === "function") {
+            const name = value.name;
+            return `ƒ ${name && name.length > 0 ? name : "anonymous"}`;
+        }
+        if (type === "string")
+            return JSON.stringify(value);
+        if (type === "number" || type === "boolean" || type === "bigint") {
+            return String(value);
+        }
+        if (type === "symbol")
+            return value.toString();
+        if (Array.isArray(value))
+            return `Array(${value.length})`;
+        if (type === "object")
+            return "{…}";
+        return String(value);
+    }
+    catch {
+        return UNREADABLE;
+    }
+}
+function snapshotPayload(payload) {
+    const fields = {};
+    if (payload !== null && payload !== undefined && typeof payload === "object") {
+        let keys = [];
+        try {
+            keys = Object.keys(payload);
+        }
+        catch {
+            keys = [];
+        }
+        for (const key of keys) {
+            try {
+                fields[key] = previewValue(payload[key]);
+            }
+            catch {
+                fields[key] = UNREADABLE;
+            }
+        }
+    }
+    return {
+        isEmpty: Object.keys(fields).length === 0,
+        fields
+    };
+}
+//# sourceMappingURL=snapshotPayload.js.map

package/dist/cjs/BoundaryLog/Entities/snapshotPayload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshotPayload.js","sourceRoot":"","sources":["../../../../src/BoundaryLog/Entities/snapshotPayload.ts"],"names":[],"mappings":";;AA+CA,0CAwBC;AAxDD,MAAM,UAAU,GAAG,cAAc,CAAC;AAElC;;;;GAIG;AACH,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,CAAC;QACH,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC;QAClC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,WAAW,CAAC;QAE5C,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC;QAE1B,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACxB,MAAM,IAAI,GAAI,KAA2B,CAAC,IAAI,CAAC;YAC/C,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7D,CAAC;QACD,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACpD,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACjE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAQ,KAAgB,CAAC,QAAQ,EAAE,CAAC;QAC3D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,KAAK,CAAC,MAAM,GAAG,CAAC;QAC1D,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAEpC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,UAAU,CAAC;IACpB,CAAC;AACH,CAAC;AAED,SAAgB,eAAe,CAAC,OAAgB;IAC9C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC7E,IAAI,IAAI,GAAa,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAkC,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,EAAE,CAAC;QACZ,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAE,OAAmC,CAAC,GAAG,CAAC,CAAC,CAAC;YACxE,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;QACzC,MAAM;KACP,CAAC;AACJ,CAAC","sourcesContent":["/**\r\n * A best-effort, one-level-deep structural snapshot of a Request payload, taken\r\n * at the moment the Request crosses the host↔App boundary. It never throws:\r\n * callbacks, circular references, and throwing getters are all rendered as\r\n * previews rather than expanded or serialized. Nested objects/arrays are marked\r\n * (not recursed), so what a developer inspects is exactly what was sent —\r\n * frozen, safe to render, and cheap to build.\r\n */\r\nexport interface PayloadSnapshot {\r\n  /** True when the payload was undefined/null or carried no own-enumerable keys. */\r\n  isEmpty: boolean;\r\n  /** Own-enumerable key → one-level preview string. */\r\n  fields: Record<string, string>;\r\n}\r\n\r\nconst UNREADABLE = \"⟨unreadable⟩\";\r\n\r\n/**\r\n * Preview a single value one level deep. Objects and arrays are marked rather\r\n * than expanded, so circular structures are inherently safe. Any access that\r\n * throws (e.g. a getter) is caught and rendered as unreadable.\r\n */\r\nfunction previewValue(value: unknown): string {\r\n  try {\r\n    if (value === null) return \"null\";\r\n    if (value === undefined) return \"undefined\";\r\n\r\n    const type = typeof value;\r\n\r\n    if (type === \"function\") {\r\n      const name = (value as { name?: string }).name;\r\n      return `ƒ ${name && name.length > 0 ? name : \"anonymous\"}`;\r\n    }\r\n    if (type === \"string\") return JSON.stringify(value);\r\n    if (type === \"number\" || type === \"boolean\" || type === \"bigint\") {\r\n      return String(value);\r\n    }\r\n    if (type === \"symbol\") return (value as symbol).toString();\r\n    if (Array.isArray(value)) return `Array(${value.length})`;\r\n    if (type === \"object\") return \"{…}\";\r\n\r\n    return String(value);\r\n  } catch {\r\n    return UNREADABLE;\r\n  }\r\n}\r\n\r\nexport function snapshotPayload(payload: unknown): PayloadSnapshot {\r\n  const fields: Record<string, string> = {};\r\n\r\n  if (payload !== null && payload !== undefined && typeof payload === \"object\") {\r\n    let keys: string[] = [];\r\n    try {\r\n      keys = Object.keys(payload as Record<string, unknown>);\r\n    } catch {\r\n      keys = [];\r\n    }\r\n\r\n    for (const key of keys) {\r\n      try {\r\n        fields[key] = previewValue((payload as Record<string, unknown>)[key]);\r\n      } catch {\r\n        fields[key] = UNREADABLE;\r\n      }\r\n    }\r\n  }\r\n\r\n  return {\r\n    isEmpty: Object.keys(fields).length === 0,\r\n    fields\r\n  };\r\n}\r\n"]}

package/dist/cjs/BoundaryLog/Factories/BoundaryLogFactory.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BoundaryLogFactory = void 0;
+exports.makeBoundaryLogFactory = makeBoundaryLogFactory;
+const core_1 = require("@vived/core");
+const AppSandboxEntity_1 = require("../../AppSandbox/Entities/AppSandboxEntity");
+const HostDispatchEntity_1 = require("../../Dispatcher/Entities/HostDispatchEntity");
+const HostHandler_1 = require("../../Handler/Entities/HostHandler");
+const Entities_1 = require("../Entities");
+const PMs_1 = require("../PMs");
+/**
+ * Sets up the Boundary Log and wires its passive observers into the per-App
+ * communication entities (ADR-0002). The observers are attached in finalSetup,
+ * after every entity exists but before the App mounts — so the host-internal
+ * version-negotiation dispatches fired at registration are captured too.
+ */
+class BoundaryLogFactory extends core_1.DomainFactory {
+    constructor(appObject) {
+        super(appObject);
+        this.factoryName = "BoundaryLogFactory";
+    }
+    setupEntities() {
+        (0, Entities_1.makeBoundaryLogEntity)(this.appObject);
+    }
+    setupUCs() {
+        // No use cases.
+    }
+    setupPMs() {
+        (0, PMs_1.makeBoundaryLogPM)(this.appObject);
+    }
+    finalSetup() {
+        const boundaryLog = Entities_1.BoundaryLogEntity.get(this.appObjects);
+        if (!boundaryLog) {
+            this.error("BoundaryLogEntity not found during final setup.");
+            return;
+        }
+        const sandbox = AppSandboxEntity_1.AppSandboxEntity.get(this.appObjects);
+        if (!sandbox) {
+            this.error("AppSandboxEntity not found during final setup.");
+            return;
+        }
+        const appObject = this.appObjects.get(sandbox.appID);
+        if (!appObject) {
+            this.error("App AppObject not found during final setup.");
+            return;
+        }
+        const dispatch = HostDispatchEntity_1.HostDispatchEntity.get(appObject);
+        if (dispatch) {
+            dispatch.requestObserver = (request, outcome) => boundaryLog.recordTraffic("dispatch", request, outcome);
+        }
+        const handler = HostHandler_1.HostHandlerEntity.get(appObject);
+        if (handler) {
+            handler.requestObserver = (request, outcome) => boundaryLog.recordTraffic("handler", request, outcome);
+        }
+    }
+}
+exports.BoundaryLogFactory = BoundaryLogFactory;
+function makeBoundaryLogFactory(appObjects) {
+    const ao = appObjects.getOrCreate("BoundaryLog");
+    return new BoundaryLogFactory(ao);
+}
+//# sourceMappingURL=BoundaryLogFactory.js.map

package/dist/cjs/BoundaryLog/Factories/BoundaryLogFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoundaryLogFactory.js","sourceRoot":"","sources":["../../../../src/BoundaryLog/Factories/BoundaryLogFactory.ts"],"names":[],"mappings":";;;AAiEA,wDAKC;AAtED,sCAAsE;AACtE,iFAA8E;AAC9E,qFAAkF;AAClF,oEAAuE;AACvE,0CAAuE;AACvE,gCAA2C;AAE3C;;;;;GAKG;AACH,MAAa,kBAAmB,SAAQ,oBAAa;IAGnD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,CAAC,CAAC;QAHV,gBAAW,GAAG,oBAAoB,CAAC;IAI5C,CAAC;IAED,aAAa;QACX,IAAA,gCAAqB,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED,QAAQ;QACN,gBAAgB;IAClB,CAAC;IAED,QAAQ;QACN,IAAA,uBAAiB,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAED,UAAU;QACR,MAAM,WAAW,GAAG,4BAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3D,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,IAAI,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;YAC9D,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,mCAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;YAC7D,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACrD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;YAC1D,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,uCAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAC9C,WAAW,CAAC,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,OAAO,GAAG,+BAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAC7C,WAAW,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;CACF;AAlDD,gDAkDC;AAED,SAAgB,sBAAsB,CACpC,UAAyB;IAEzB,MAAM,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IACjD,OAAO,IAAI,kBAAkB,CAAC,EAAE,CAAC,CAAC;AACpC,CAAC","sourcesContent":["import { AppObject, AppObjectRepo, DomainFactory } from \"@vived/core\";\r\nimport { AppSandboxEntity } from \"../../AppSandbox/Entities/AppSandboxEntity\";\r\nimport { HostDispatchEntity } from \"../../Dispatcher/Entities/HostDispatchEntity\";\r\nimport { HostHandlerEntity } from \"../../Handler/Entities/HostHandler\";\r\nimport { BoundaryLogEntity, makeBoundaryLogEntity } from \"../Entities\";\r\nimport { makeBoundaryLogPM } from \"../PMs\";\r\n\r\n/**\r\n * Sets up the Boundary Log and wires its passive observers into the per-App\r\n * communication entities (ADR-0002). The observers are attached in finalSetup,\r\n * after every entity exists but before the App mounts — so the host-internal\r\n * version-negotiation dispatches fired at registration are captured too.\r\n */\r\nexport class BoundaryLogFactory extends DomainFactory {\r\n  readonly factoryName = \"BoundaryLogFactory\";\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject);\r\n  }\r\n\r\n  setupEntities(): void {\r\n    makeBoundaryLogEntity(this.appObject);\r\n  }\r\n\r\n  setupUCs(): void {\r\n    // No use cases.\r\n  }\r\n\r\n  setupPMs(): void {\r\n    makeBoundaryLogPM(this.appObject);\r\n  }\r\n\r\n  finalSetup(): void {\r\n    const boundaryLog = BoundaryLogEntity.get(this.appObjects);\r\n    if (!boundaryLog) {\r\n      this.error(\"BoundaryLogEntity not found during final setup.\");\r\n      return;\r\n    }\r\n\r\n    const sandbox = AppSandboxEntity.get(this.appObjects);\r\n    if (!sandbox) {\r\n      this.error(\"AppSandboxEntity not found during final setup.\");\r\n      return;\r\n    }\r\n\r\n    const appObject = this.appObjects.get(sandbox.appID);\r\n    if (!appObject) {\r\n      this.error(\"App AppObject not found during final setup.\");\r\n      return;\r\n    }\r\n\r\n    const dispatch = HostDispatchEntity.get(appObject);\r\n    if (dispatch) {\r\n      dispatch.requestObserver = (request, outcome) =>\r\n        boundaryLog.recordTraffic(\"dispatch\", request, outcome);\r\n    }\r\n\r\n    const handler = HostHandlerEntity.get(appObject);\r\n    if (handler) {\r\n      handler.requestObserver = (request, outcome) =>\r\n        boundaryLog.recordTraffic(\"handler\", request, outcome);\r\n    }\r\n  }\r\n}\r\n\r\nexport function makeBoundaryLogFactory(\r\n  appObjects: AppObjectRepo\r\n): BoundaryLogFactory {\r\n  const ao = appObjects.getOrCreate(\"BoundaryLog\");\r\n  return new BoundaryLogFactory(ao);\r\n}\r\n"]}

package/dist/cjs/BoundaryLog/Factories/index.js

@@ -0,0 +1,18 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./BoundaryLogFactory"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/BoundaryLog/Factories/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/BoundaryLog/Factories/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC","sourcesContent":["export * from \"./BoundaryLogFactory\";\r\n"]}

package/dist/cjs/BoundaryLog/Mocks/BoundaryLogPMMock.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BoundaryLogPMMock = void 0;
+exports.makeBoundaryLogPMMock = makeBoundaryLogPMMock;
+const PMs_1 = require("../PMs");
+class BoundaryLogPMMock extends PMs_1.BoundaryLogPM {
+    constructor(appObject) {
+        super(appObject, PMs_1.BoundaryLogPM.type);
+        this.vmsAreEqual = jest.fn();
+    }
+}
+exports.BoundaryLogPMMock = BoundaryLogPMMock;
+function makeBoundaryLogPMMock(appObjects) {
+    return new BoundaryLogPMMock(appObjects.getOrCreate("BoundaryLogPMMock"));
+}
+//# sourceMappingURL=BoundaryLogPMMock.js.map

package/dist/cjs/BoundaryLog/Mocks/BoundaryLogPMMock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoundaryLogPMMock.js","sourceRoot":"","sources":["../../../../src/BoundaryLog/Mocks/BoundaryLogPMMock.ts"],"names":[],"mappings":";;;AAWA,sDAEC;AAZD,gCAAuC;AAEvC,MAAa,iBAAkB,SAAQ,mBAAa;IAGlD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,mBAAa,CAAC,IAAI,CAAC,CAAC;QAHvC,gBAAW,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;IAIxB,CAAC;CACF;AAND,8CAMC;AAED,SAAgB,qBAAqB,CAAC,UAAyB;IAC7D,OAAO,IAAI,iBAAiB,CAAC,UAAU,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,CAAC;AAC5E,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\r\nimport { BoundaryLogPM } from \"../PMs\";\r\n\r\nexport class BoundaryLogPMMock extends BoundaryLogPM {\r\n  vmsAreEqual = jest.fn();\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, BoundaryLogPM.type);\r\n  }\r\n}\r\n\r\nexport function makeBoundaryLogPMMock(appObjects: AppObjectRepo) {\r\n  return new BoundaryLogPMMock(appObjects.getOrCreate(\"BoundaryLogPMMock\"));\r\n}\r\n"]}

package/dist/cjs/BoundaryLog/Mocks/index.js

@@ -0,0 +1,18 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./BoundaryLogPMMock"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/BoundaryLog/Mocks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/BoundaryLog/Mocks/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC","sourcesContent":["export * from \"./BoundaryLogPMMock\";\r\n"]}

package/dist/cjs/BoundaryLog/PMs/BoundaryLogPM.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BoundaryLogPM = exports.defaultBoundaryLogVM = void 0;
+exports.makeBoundaryLogPM = makeBoundaryLogPM;
+const core_1 = require("@vived/core");
+const Entities_1 = require("../Entities");
+exports.defaultBoundaryLogVM = {
+    records: [],
+    count: 0
+};
+class BoundaryLogPM extends core_1.AppObjectPM {
+    static get(appObjects) {
+        return (0, core_1.getSingletonComponent)(BoundaryLogPM.type, appObjects);
+    }
+}
+exports.BoundaryLogPM = BoundaryLogPM;
+BoundaryLogPM.type = "BoundaryLogPM";
+function makeBoundaryLogPM(appObject) {
+    return new BoundaryLogPMImp(appObject);
+}
+class BoundaryLogPMImp extends BoundaryLogPM {
+    get boundaryLog() {
+        return this.getCachedSingleton(Entities_1.BoundaryLogEntity.type);
+    }
+    vmsAreEqual(a, b) {
+        if (a.count !== b.count)
+            return false;
+        if (a.records.length !== b.records.length)
+            return false;
+        for (let i = 0; i < a.records.length; i++) {
+            if (a.records[i] !== b.records[i])
+                return false;
+        }
+        return true;
+    }
+    constructor(appObject) {
+        super(appObject, BoundaryLogPM.type);
+        this.onEntityChange = () => {
+            if (!this.boundaryLog)
+                return;
+            // Copy the array (new VM identity) but keep record references stable so
+            // vmsAreEqual can compare cheaply. Order is insertion order = the order the
+            // Requests were observed.
+            const records = [...this.boundaryLog.records];
+            const vm = {
+                records,
+                count: records.length
+            };
+            this.doUpdateView(vm);
+        };
+        this.onEntityChange();
+        this.boundaryLog?.addChangeObserver(this.onEntityChange);
+        this.appObjects.registerSingleton(this);
+    }
+}
+//# sourceMappingURL=BoundaryLogPM.js.map

package/dist/cjs/BoundaryLog/PMs/BoundaryLogPM.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoundaryLogPM.js","sourceRoot":"","sources":["../../../../src/BoundaryLog/PMs/BoundaryLogPM.ts"],"names":[],"mappings":";;;AA+BA,8CAEC;AAjCD,sCAKqB;AACrB,0CAA+D;AAYlD,QAAA,oBAAoB,GAAkB;IACjD,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAsB,aAAc,SAAQ,kBAA0B;IAGpE,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC9E,CAAC;;AALH,sCAMC;AALQ,kBAAI,GAAG,eAAe,CAAC;AAOhC,SAAgB,iBAAiB,CAAC,SAAoB;IACpD,OAAO,IAAI,gBAAgB,CAAC,SAAS,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,gBAAiB,SAAQ,aAAa;IAC1C,IAAY,WAAW;QACrB,OAAO,IAAI,CAAC,kBAAkB,CAAoB,4BAAiB,CAAC,IAAI,CAAC,CAAC;IAC5E,CAAC;IAED,WAAW,CAAC,CAAgB,EAAE,CAAgB;QAC5C,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACtC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QACxD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;QAClD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAiBD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;QAhB/B,mBAAc,GAAG,GAAG,EAAE;YAC5B,IAAI,CAAC,IAAI,CAAC,WAAW;gBAAE,OAAO;YAE9B,wEAAwE;YACxE,4EAA4E;YAC5E,0BAA0B;YAC1B,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC9C,MAAM,EAAE,GAAkB;gBACxB,OAAO;gBACP,KAAK,EAAE,OAAO,CAAC,MAAM;aACtB,CAAC;YAEF,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC,CAAC;QAKA,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACzD,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectPM,\r\n  AppObjectRepo\r\n} from \"@vived/core\";\r\nimport { BoundaryLogEntity, RequestRecord } from \"../Entities\";\r\n\r\n/**\r\n * The view projection of the Boundary Log: the recorded Requests in observation\r\n * order (each row carries its direction so the view can side Dispatches and\r\n * Handlers independently) plus the total count.\r\n */\r\nexport interface BoundaryLogVM {\r\n  records: RequestRecord[];\r\n  count: number;\r\n}\r\n\r\nexport const defaultBoundaryLogVM: BoundaryLogVM = {\r\n  records: [],\r\n  count: 0\r\n};\r\n\r\nexport abstract class BoundaryLogPM extends AppObjectPM<BoundaryLogVM> {\r\n  static type = \"BoundaryLogPM\";\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<BoundaryLogPM>(BoundaryLogPM.type, appObjects);\r\n  }\r\n}\r\n\r\nexport function makeBoundaryLogPM(appObject: AppObject): BoundaryLogPM {\r\n  return new BoundaryLogPMImp(appObject);\r\n}\r\n\r\nclass BoundaryLogPMImp extends BoundaryLogPM {\r\n  private get boundaryLog() {\r\n    return this.getCachedSingleton<BoundaryLogEntity>(BoundaryLogEntity.type);\r\n  }\r\n\r\n  vmsAreEqual(a: BoundaryLogVM, b: BoundaryLogVM): boolean {\r\n    if (a.count !== b.count) return false;\r\n    if (a.records.length !== b.records.length) return false;\r\n    for (let i = 0; i < a.records.length; i++) {\r\n      if (a.records[i] !== b.records[i]) return false;\r\n    }\r\n    return true;\r\n  }\r\n\r\n  private onEntityChange = () => {\r\n    if (!this.boundaryLog) return;\r\n\r\n    // Copy the array (new VM identity) but keep record references stable so\r\n    // vmsAreEqual can compare cheaply. Order is insertion order = the order the\r\n    // Requests were observed.\r\n    const records = [...this.boundaryLog.records];\r\n    const vm: BoundaryLogVM = {\r\n      records,\r\n      count: records.length\r\n    };\r\n\r\n    this.doUpdateView(vm);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, BoundaryLogPM.type);\r\n\r\n    this.onEntityChange();\r\n    this.boundaryLog?.addChangeObserver(this.onEntityChange);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}

package/dist/cjs/BoundaryLog/PMs/index.js

@@ -0,0 +1,18 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./BoundaryLogPM"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/BoundaryLog/PMs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/BoundaryLog/PMs/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC","sourcesContent":["export * from \"./BoundaryLogPM\";\r\n"]}

package/dist/cjs/BoundaryLog/index.js

@@ -0,0 +1,23 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Adapters"), exports);
+__exportStar(require("./Controllers"), exports);
+__exportStar(require("./Entities"), exports);
+__exportStar(require("./Factories"), exports);
+__exportStar(require("./Mocks"), exports);
+__exportStar(require("./PMs"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/BoundaryLog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/BoundaryLog/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,gDAA8B;AAC9B,6CAA2B;AAC3B,8CAA4B;AAC5B,0CAAwB;AACxB,wCAAsB","sourcesContent":["export * from \"./Adapters\";\r\nexport * from \"./Controllers\";\r\nexport * from \"./Entities\";\r\nexport * from \"./Factories\";\r\nexport * from \"./Mocks\";\r\nexport * from \"./PMs\";\r\n"]}

package/dist/cjs/Dialog/Entities/DialogQueue.js

@@ -25,36 +25,51 @@ class DialogRepoImp extends DialogQueue {
         this.dialogQueue = [];
         this.submitDialog = (dialog) => {
             this.dialogQueue.push(dialog);
-            if (this.activeDialog === dialog) {
-                dialog.isOpen = true;
-            }
-            dialog.addChangeObserver(this.notifyOnChange);
+            dialog.addChangeObserver(this.onDialogChange);
+            this.openActiveDialog();
             this.notifyOnChange();
         };
         this.activeDialogHasClosed = () => {
             const currentActiveDialog = this.activeDialog;
-            if (currentActiveDialog !== null) {
-                currentActiveDialog.removeChangeObserver(this.notifyOnChange);
-                this.filterOutClosedDialogs();
-                this.dialogQueue.splice(0, 1);
-                const newActiveDialog = this.activeDialog;
-                if (newActiveDialog !== null) {
-                    newActiveDialog.isOpen = true;
-                }
+            if (currentActiveDialog === null)
+                return;
+            // Dismissal comes via two routes: a dialog's own close() (which sets
+            // hasBeenClosed) or the host's backdrop/escape path (this method). Mark the
+            // active dialog closed here so both routes converge on the same advance.
+            currentActiveDialog.hasBeenClosed = true;
+            this.advanceQueue();
+        };
+        /**
+         * Observes every queued dialog. When the active dialog closes itself (e.g.
+         * via its own close button), advance the queue so the next dialog surfaces;
+         * otherwise just forward the change to the queue's own observers.
+         */
+        this.onDialogChange = () => {
+            const currentActiveDialog = this.activeDialog;
+            if (currentActiveDialog !== null && currentActiveDialog.hasBeenClosed) {
+                this.advanceQueue();
+            }
+            else {
                 this.notifyOnChange();
             }
         };
-        this.filterOutClosedDialogs = () => {
-            const dialogsToKeep = [];
-            this.dialogQueue.forEach((dialog) => {
-                if (!dialog.hasBeenClosed) {
-                    dialogsToKeep.push(dialog);
-                }
-                else {
-                    dialog.removeChangeObserver(this.notifyOnChange);
+        /** Drop every closed dialog, then open whatever is now the active dialog. */
+        this.advanceQueue = () => {
+            this.dialogQueue = this.dialogQueue.filter((dialog) => {
+                if (dialog.hasBeenClosed) {
+                    dialog.removeChangeObserver(this.onDialogChange);
+                    return false;
                 }
+                return true;
             });
-            this.dialogQueue = dialogsToKeep;
+            this.openActiveDialog();
+            this.notifyOnChange();
+        };
+        this.openActiveDialog = () => {
+            const active = this.activeDialog;
+            if (active !== null && !active.isOpen) {
+                active.isOpen = true;
+            }
         };
         this.appObjects.registerSingleton(this);
     }

package/dist/cjs/Dialog/Entities/DialogQueue.js.map

@@ -1 +1 @@
-{"version":3,"file":"DialogQueue.js","sourceRoot":"","sources":["../../../../src/Dialog/Entities/DialogQueue.ts"],"names":[],"mappings":";;;AA0BA,0CAEC;AA5BD,sCAKqB;AAErB,MAAsB,MAAO,SAAQ,sBAAe;CAKnD;AALD,wBAKC;AAED,MAAsB,WAAY,SAAQ,sBAAe;IAOvD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAc,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC1E,CAAC;;AATH,kCAUC;AATQ,gBAAI,GAAG,aAAa,CAAC;AAW9B,SAAgB,eAAe,CAAC,SAAoB;IAClD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,aAAc,SAAQ,WAAW;IAGrC,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClE,CAAC;IA6CD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QAlD7B,gBAAW,GAAa,EAAE,CAAC;QAMnC,iBAAY,GAAG,CAAC,MAAc,EAAQ,EAAE;YACtC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAE9B,IAAI,IAAI,CAAC,YAAY,KAAK,MAAM,EAAE,CAAC;gBACjC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;YACvB,CAAC;YAED,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAE9C,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC,CAAC;QAEF,0BAAqB,GAAG,GAAS,EAAE;YACjC,MAAM,mBAAmB,GAAG,IAAI,CAAC,YAAY,CAAC;YAC9C,IAAI,mBAAmB,KAAK,IAAI,EAAE,CAAC;gBACjC,mBAAmB,CAAC,oBAAoB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;gBAE9D,IAAI,CAAC,sBAAsB,EAAE,CAAC;gBAE9B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC9B,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC;gBAC1C,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;oBAC7B,eAAe,CAAC,MAAM,GAAG,IAAI,CAAC;gBAChC,CAAC;gBAED,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,CAAC;QACH,CAAC,CAAC;QAEM,2BAAsB,GAAG,GAAG,EAAE;YACpC,MAAM,aAAa,GAAa,EAAE,CAAC;YAEnC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;gBAClC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;oBAC1B,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC7B,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,WAAW,GAAG,aAAa,CAAC;QACnC,CAAC,CAAC;QAIA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\n  AppObject,\n  AppObjectEntity,\n  AppObjectRepo,\n  getSingletonComponent\n} from \"@vived/core\";\n\nexport abstract class Dialog extends AppObjectEntity {\n  abstract dialogType: string;\n  abstract preventOutsideDismiss: boolean;\n  abstract isOpen: boolean;\n  abstract hasBeenClosed: boolean;\n}\n\nexport abstract class DialogQueue extends AppObjectEntity {\n  static type = \"DialogQueue\";\n\n  abstract get activeDialog(): Dialog | null;\n  abstract submitDialog(dialog: Dialog): void;\n  abstract activeDialogHasClosed(): void;\n\n  static get(appObjects: AppObjectRepo) {\n    return getSingletonComponent<DialogQueue>(DialogQueue.type, appObjects);\n  }\n}\n\nexport function makeDialogQueue(appObject: AppObject): DialogQueue {\n  return new DialogRepoImp(appObject);\n}\n\nclass DialogRepoImp extends DialogQueue {\n  private dialogQueue: Dialog[] = [];\n\n  get activeDialog(): Dialog | null {\n    return this.dialogQueue.length > 0 ? this.dialogQueue[0] : null;\n  }\n\n  submitDialog = (dialog: Dialog): void => {\n    this.dialogQueue.push(dialog);\n\n    if (this.activeDialog === dialog) {\n      dialog.isOpen = true;\n    }\n\n    dialog.addChangeObserver(this.notifyOnChange);\n\n    this.notifyOnChange();\n  };\n\n  activeDialogHasClosed = (): void => {\n    const currentActiveDialog = this.activeDialog;\n    if (currentActiveDialog !== null) {\n      currentActiveDialog.removeChangeObserver(this.notifyOnChange);\n\n      this.filterOutClosedDialogs();\n\n      this.dialogQueue.splice(0, 1);\n      const newActiveDialog = this.activeDialog;\n      if (newActiveDialog !== null) {\n        newActiveDialog.isOpen = true;\n      }\n\n      this.notifyOnChange();\n    }\n  };\n\n  private filterOutClosedDialogs = () => {\n    const dialogsToKeep: Dialog[] = [];\n\n    this.dialogQueue.forEach((dialog) => {\n      if (!dialog.hasBeenClosed) {\n        dialogsToKeep.push(dialog);\n      } else {\n        dialog.removeChangeObserver(this.notifyOnChange);\n      }\n    });\n\n    this.dialogQueue = dialogsToKeep;\n  };\n\n  constructor(appObject: AppObject) {\n    super(appObject, DialogQueue.type);\n    this.appObjects.registerSingleton(this);\n  }\n}\n"]}
+{"version":3,"file":"DialogQueue.js","sourceRoot":"","sources":["../../../../src/Dialog/Entities/DialogQueue.ts"],"names":[],"mappings":";;;AA0BA,0CAEC;AA5BD,sCAKqB;AAErB,MAAsB,MAAO,SAAQ,sBAAe;CAKnD;AALD,wBAKC;AAED,MAAsB,WAAY,SAAQ,sBAAe;IAOvD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAc,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC1E,CAAC;;AATH,kCAUC;AATQ,gBAAI,GAAG,aAAa,CAAC;AAW9B,SAAgB,eAAe,CAAC,SAAoB;IAClD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,aAAc,SAAQ,WAAW;IAGrC,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClE,CAAC;IAyDD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QA9D7B,gBAAW,GAAa,EAAE,CAAC;QAMnC,iBAAY,GAAG,CAAC,MAAc,EAAQ,EAAE;YACtC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAE9B,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAE9C,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACxB,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC,CAAC;QAEF,0BAAqB,GAAG,GAAS,EAAE;YACjC,MAAM,mBAAmB,GAAG,IAAI,CAAC,YAAY,CAAC;YAC9C,IAAI,mBAAmB,KAAK,IAAI;gBAAE,OAAO;YAEzC,qEAAqE;YACrE,4EAA4E;YAC5E,yEAAyE;YACzE,mBAAmB,CAAC,aAAa,GAAG,IAAI,CAAC;YACzC,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC,CAAC;QAEF;;;;WAIG;QACK,mBAAc,GAAG,GAAS,EAAE;YAClC,MAAM,mBAAmB,GAAG,IAAI,CAAC,YAAY,CAAC;YAC9C,IAAI,mBAAmB,KAAK,IAAI,IAAI,mBAAmB,CAAC,aAAa,EAAE,CAAC;gBACtE,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,CAAC;QACH,CAAC,CAAC;QAEF,6EAA6E;QACrE,iBAAY,GAAG,GAAS,EAAE;YAChC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;gBACpD,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;oBACzB,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;oBACjD,OAAO,KAAK,CAAC;gBACf,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACxB,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC,CAAC;QAEM,qBAAgB,GAAG,GAAS,EAAE;YACpC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC;YACjC,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACtC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;YACvB,CAAC;QACH,CAAC,CAAC;QAIA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\r\n  AppObject,\r\n  AppObjectEntity,\r\n  AppObjectRepo,\r\n  getSingletonComponent\r\n} from \"@vived/core\";\r\n\r\nexport abstract class Dialog extends AppObjectEntity {\r\n  abstract dialogType: string;\r\n  abstract preventOutsideDismiss: boolean;\r\n  abstract isOpen: boolean;\r\n  abstract hasBeenClosed: boolean;\r\n}\r\n\r\nexport abstract class DialogQueue extends AppObjectEntity {\r\n  static type = \"DialogQueue\";\r\n\r\n  abstract get activeDialog(): Dialog | null;\r\n  abstract submitDialog(dialog: Dialog): void;\r\n  abstract activeDialogHasClosed(): void;\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<DialogQueue>(DialogQueue.type, appObjects);\r\n  }\r\n}\r\n\r\nexport function makeDialogQueue(appObject: AppObject): DialogQueue {\r\n  return new DialogRepoImp(appObject);\r\n}\r\n\r\nclass DialogRepoImp extends DialogQueue {\r\n  private dialogQueue: Dialog[] = [];\r\n\r\n  get activeDialog(): Dialog | null {\r\n    return this.dialogQueue.length > 0 ? this.dialogQueue[0] : null;\r\n  }\r\n\r\n  submitDialog = (dialog: Dialog): void => {\r\n    this.dialogQueue.push(dialog);\r\n\r\n    dialog.addChangeObserver(this.onDialogChange);\r\n\r\n    this.openActiveDialog();\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  activeDialogHasClosed = (): void => {\r\n    const currentActiveDialog = this.activeDialog;\r\n    if (currentActiveDialog === null) return;\r\n\r\n    // Dismissal comes via two routes: a dialog's own close() (which sets\r\n    // hasBeenClosed) or the host's backdrop/escape path (this method). Mark the\r\n    // active dialog closed here so both routes converge on the same advance.\r\n    currentActiveDialog.hasBeenClosed = true;\r\n    this.advanceQueue();\r\n  };\r\n\r\n  /**\r\n   * Observes every queued dialog. When the active dialog closes itself (e.g.\r\n   * via its own close button), advance the queue so the next dialog surfaces;\r\n   * otherwise just forward the change to the queue's own observers.\r\n   */\r\n  private onDialogChange = (): void => {\r\n    const currentActiveDialog = this.activeDialog;\r\n    if (currentActiveDialog !== null && currentActiveDialog.hasBeenClosed) {\r\n      this.advanceQueue();\r\n    } else {\r\n      this.notifyOnChange();\r\n    }\r\n  };\r\n\r\n  /** Drop every closed dialog, then open whatever is now the active dialog. */\r\n  private advanceQueue = (): void => {\r\n    this.dialogQueue = this.dialogQueue.filter((dialog) => {\r\n      if (dialog.hasBeenClosed) {\r\n        dialog.removeChangeObserver(this.onDialogChange);\r\n        return false;\r\n      }\r\n      return true;\r\n    });\r\n\r\n    this.openActiveDialog();\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  private openActiveDialog = (): void => {\r\n    const active = this.activeDialog;\r\n    if (active !== null && !active.isOpen) {\r\n      active.isOpen = true;\r\n    }\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, DialogQueue.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}