@vived/host 5.5.0 → 5.7.0

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

@@ -0,0 +1,57 @@
+import { DomainFactory } from "@vived/core";
+import { AppSandboxEntity } from "../../AppSandbox/Entities/AppSandboxEntity";
+import { HostDispatchEntity } from "../../Dispatcher/Entities/HostDispatchEntity";
+import { HostHandlerEntity } from "../../Handler/Entities/HostHandler";
+import { BoundaryLogEntity, makeBoundaryLogEntity } from "../Entities";
+import { makeBoundaryLogPM } from "../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.
+ */
+export class BoundaryLogFactory extends DomainFactory {
+    constructor(appObject) {
+        super(appObject);
+        this.factoryName = "BoundaryLogFactory";
+    }
+    setupEntities() {
+        makeBoundaryLogEntity(this.appObject);
+    }
+    setupUCs() {
+        // No use cases.
+    }
+    setupPMs() {
+        makeBoundaryLogPM(this.appObject);
+    }
+    finalSetup() {
+        const boundaryLog = BoundaryLogEntity.get(this.appObjects);
+        if (!boundaryLog) {
+            this.error("BoundaryLogEntity not found during final setup.");
+            return;
+        }
+        const sandbox = 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.get(appObject);
+        if (dispatch) {
+            dispatch.requestObserver = (request, outcome) => boundaryLog.recordTraffic("dispatch", request, outcome);
+        }
+        const handler = HostHandlerEntity.get(appObject);
+        if (handler) {
+            handler.requestObserver = (request, outcome) => boundaryLog.recordTraffic("handler", request, outcome);
+        }
+    }
+}
+export function makeBoundaryLogFactory(appObjects) {
+    const ao = appObjects.getOrCreate("BoundaryLog");
+    return new BoundaryLogFactory(ao);
+}
+//# sourceMappingURL=BoundaryLogFactory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BoundaryLogFactory.js","sourceRoot":"","sources":["../../../../src/BoundaryLog/Factories/BoundaryLogFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,aAAa,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IAGnD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,CAAC,CAAC;QAHV,gBAAW,GAAG,oBAAoB,CAAC;IAI5C,CAAC;IAED,aAAa;QACX,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED,QAAQ;QACN,gBAAgB;IAClB,CAAC;IAED,QAAQ;QACN,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAED,UAAU;QACR,MAAM,WAAW,GAAG,iBAAiB,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,gBAAgB,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,kBAAkB,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,iBAAiB,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;AAED,MAAM,UAAU,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/esm/BoundaryLog/Factories/index.js

@@ -0,0 +1,2 @@
+export * from "./BoundaryLogFactory";
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,11 @@
+import { BoundaryLogPM } from "../PMs";
+export class BoundaryLogPMMock extends BoundaryLogPM {
+    constructor(appObject) {
+        super(appObject, BoundaryLogPM.type);
+        this.vmsAreEqual = jest.fn();
+    }
+}
+export function makeBoundaryLogPMMock(appObjects) {
+    return new BoundaryLogPMMock(appObjects.getOrCreate("BoundaryLogPMMock"));
+}
+//# sourceMappingURL=BoundaryLogPMMock.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BoundaryLogPMMock.js","sourceRoot":"","sources":["../../../../src/BoundaryLog/Mocks/BoundaryLogPMMock.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAGlD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;QAHvC,gBAAW,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;IAIxB,CAAC;CACF;AAED,MAAM,UAAU,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/esm/BoundaryLog/Mocks/index.js

@@ -0,0 +1,2 @@
+export * from "./BoundaryLogPMMock";
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,51 @@
+import { getSingletonComponent, AppObjectPM } from "@vived/core";
+import { BoundaryLogEntity } from "../Entities";
+export const defaultBoundaryLogVM = {
+    records: [],
+    count: 0
+};
+export class BoundaryLogPM extends AppObjectPM {
+    static get(appObjects) {
+        return getSingletonComponent(BoundaryLogPM.type, appObjects);
+    }
+}
+BoundaryLogPM.type = "BoundaryLogPM";
+export function makeBoundaryLogPM(appObject) {
+    return new BoundaryLogPMImp(appObject);
+}
+class BoundaryLogPMImp extends BoundaryLogPM {
+    get boundaryLog() {
+        return this.getCachedSingleton(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/esm/BoundaryLog/PMs/BoundaryLogPM.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoundaryLogPM.js","sourceRoot":"","sources":["../../../../src/BoundaryLog/PMs/BoundaryLogPM.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAErB,WAAW,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAiB,MAAM,aAAa,CAAC;AAY/D,MAAM,CAAC,MAAM,oBAAoB,GAAkB;IACjD,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAM,OAAgB,aAAc,SAAQ,WAA0B;IAGpE,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC9E,CAAC;;AAJM,kBAAI,GAAG,eAAe,CAAC;AAOhC,MAAM,UAAU,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,iBAAiB,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/esm/BoundaryLog/PMs/index.js

@@ -0,0 +1,2 @@
+export * from "./BoundaryLogPM";
+//# sourceMappingURL=index.js.map

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

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

package/dist/esm/BoundaryLog/index.js

@@ -0,0 +1,7 @@
+export * from "./Adapters";
+export * from "./Controllers";
+export * from "./Entities";
+export * from "./Factories";
+export * from "./Mocks";
+export * from "./PMs";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/BoundaryLog/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC","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/esm/Dialog/Entities/DialogQueue.js

@@ -19,36 +19,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/esm/Dialog/Entities/DialogQueue.js.map

@@ -1 +1 @@
-{"version":3,"file":"DialogQueue.js","sourceRoot":"","sources":["../../../../src/Dialog/Entities/DialogQueue.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EAEf,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAErB,MAAM,OAAgB,MAAO,SAAQ,eAAe;CAKnD;AAED,MAAM,OAAgB,WAAY,SAAQ,eAAe;IAOvD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAc,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC1E,CAAC;;AARM,gBAAI,GAAG,aAAa,CAAC;AAW9B,MAAM,UAAU,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":"AAAA,OAAO,EAEL,eAAe,EAEf,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAErB,MAAM,OAAgB,MAAO,SAAQ,eAAe;CAKnD;AAED,MAAM,OAAgB,WAAY,SAAQ,eAAe;IAOvD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAc,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC1E,CAAC;;AARM,gBAAI,GAAG,aAAa,CAAC;AAW9B,MAAM,UAAU,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"]}

package/dist/esm/Dispatcher/Entities/HostDispatchEntity.js

@@ -61,23 +61,36 @@ class HostDispatchEntityImp extends HostDispatchEntity {
         this.setupPayloadVersions = (payloadVersion) => {
             this.appPayloadVersions = payloadVersion;
         };
+        /**
+         * Notify the passive observer, if any. Wrapped so a throwing or slow observer
+         * can never alter, delay, or fail the Request's delivery (ADR-0002).
+         */
+        this.notifyObserver = (request, outcome) => {
+            if (!this.requestObserver)
+                return;
+            try {
+                this.requestObserver(request, outcome);
+            }
+            catch {
+                // Passive: an observer failure must never affect dispatch.
+            }
+        };
         this.dispatch = (request) => {
             if (!this.appHandler) {
                 this.error("No app handler has been registered");
+                this.notifyObserver(request, "no-app-handler");
                 return;
             }
             try {
                 this.appHandler(request);
+                this.notifyObserver(request, "delivered");
             }
             catch (e) {
                 this.warn(e.message);
+                this.notifyObserver(request, "threw");
             }
         };
         this.formRequestAndDispatch = (type, version, payload) => {
-            if (!this.appHandler) {
-                this.error("No app handler has been registered");
-                return;
-            }
             const request = {
                 type,
                 version,

package/dist/esm/Dispatcher/Entities/HostDispatchEntity.js.map

@@ -1 +1 @@
-{"version":3,"file":"HostDispatchEntity.js","sourceRoot":"","sources":["../../../../src/Dispatcher/Entities/HostDispatchEntity.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppObject, AppObjectEntity, AppObjectRepo } from \"@vived/core\";\nimport { Handler, Request } from \"@vived/core\";\n\nexport abstract class HostDispatchEntity extends AppObjectEntity {\n  static readonly type = \"HostDispatchEntity\";\n\n  abstract appHandlerVersion: number;\n  abstract getRequestPayloadVersion(requestType: string): number | undefined;\n  abstract registerAppHandler: (appHandler: Handler) => void;\n  abstract clearAppHandler: () => void;\n  abstract dispatch: (request: Request) => void;\n  abstract formRequestAndDispatch: (\n    type: string,\n    version: number,\n    payload?: object | undefined\n  ) => void;\n\n  static get(appObject: AppObject): HostDispatchEntity | undefined {\n    const component = appObject.getComponent<HostDispatchEntity>(\n      HostDispatchEntity.type\n    );\n    if (!component) {\n      appObject.appObjectRepo.submitWarning(\n        \"AssetEntity.get\",\n        \"Unable to find HostDispatchEntity on app object \" + appObject.id\n      );\n    }\n    return component;\n  }\n\n  static getByID(\n    id: string,\n    appObjects: AppObjectRepo\n  ): HostDispatchEntity | undefined {\n    const appObject = appObjects.get(id);\n    if (!appObject) {\n      appObjects.submitWarning(\n        \"AssetEntity.getByID\",\n        \"Unable to find app object \" + id\n      );\n      return;\n    }\n    return HostDispatchEntity.get(appObject);\n  }\n}\n\nexport function makeHostDispatchEntity(\n  appObject: AppObject\n): HostDispatchEntity {\n  return new HostDispatchEntityImp(appObject);\n}\n\nclass HostDispatchEntityImp extends HostDispatchEntity {\n  private appHandler?: Handler;\n\n  private _appHandlerVersion = 0;\n  public get appHandlerVersion() {\n    return this._appHandlerVersion;\n  }\n\n  private appPayloadVersions = new Map<string, number>();\n\n  registerAppHandler = (appHandler: Handler) => {\n    this.appHandler = appHandler;\n    this.getAppHandlerVersion();\n  };\n\n  clearAppHandler = () => {\n    this.appHandler = undefined;\n  };\n\n  private getAppHandlerVersion() {\n    const type = \"GET_APP_HANDLER_VERSION\";\n    const payload = { callback: this.setupVersion };\n\n    try {\n      this.formRequestAndDispatch(type, 1, payload);\n    } catch {\n      // All good. this is probably an older app\n    }\n  }\n\n  getRequestPayloadVersion = (requestType: string): number | undefined => {\n    return this.appPayloadVersions.get(requestType);\n  };\n\n  private setupVersion = (version: number) => {\n    // Apps before app package version 2.27 will not reach this\n    this._appHandlerVersion = version;\n    this.getPayloadVersions();\n  };\n\n  private getPayloadVersions = () => {\n    const type = \"GET_APP_PAYLOAD_VERSION\";\n    const payload = { callback: this.setupPayloadVersions };\n    this.formRequestAndDispatch(type, 2, payload);\n  };\n\n  private setupPayloadVersions = (payloadVersion: Map<string, number>) => {\n    this.appPayloadVersions = payloadVersion;\n  };\n\n  dispatch = (request: Request) => {\n    if (!this.appHandler) {\n      this.error(\"No app handler has been registered\");\n      return;\n    }\n\n    try {\n      this.appHandler(request);\n    } catch (e) {\n      this.warn((e as Error).message);\n    }\n  };\n\n  formRequestAndDispatch = (\n    type: string,\n    version: number,\n    payload?: object | undefined\n  ) => {\n    if (!this.appHandler) {\n      this.error(\"No app handler has been registered\");\n      return;\n    }\n\n    const request: Request = {\n      type,\n      version,\n      payload\n    };\n\n    this.dispatch(request);\n  };\n\n  constructor(appObject: AppObject) {\n    super(appObject, HostDispatchEntity.type);\n  }\n}\n"]}
+{"version":3,"file":"HostDispatchEntity.js","sourceRoot":"","sources":["../../../../src/Dispatcher/Entities/HostDispatchEntity.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppObject, AppObjectEntity, AppObjectRepo } from \"@vived/core\";\r\nimport { Handler, Request } from \"@vived/core\";\r\n\r\n/**\r\n * The outcome of an outbound Dispatch, as seen at the dispatch chokepoint:\r\n * \"delivered\" (the app handler ran), \"no-app-handler\" (nothing registered to\r\n * receive it), or \"threw\" (the app handler raised).\r\n */\r\nexport type DispatchOutcome = \"delivered\" | \"no-app-handler\" | \"threw\";\r\n\r\n/**\r\n * Passive observer of outbound Dispatches. Notified after each Request is\r\n * dispatched, with the outcome. Purely observational — see the passivity\r\n * contract in ADR-0002: an observer must never alter, delay, or fail delivery.\r\n */\r\nexport type DispatchObserver = (\r\n  request: Request,\r\n  outcome: DispatchOutcome\r\n) => void;\r\n\r\nexport abstract class HostDispatchEntity extends AppObjectEntity {\r\n  static readonly type = \"HostDispatchEntity\";\r\n\r\n  abstract appHandlerVersion: number;\r\n  abstract getRequestPayloadVersion(requestType: string): number | undefined;\r\n  abstract registerAppHandler: (appHandler: Handler) => void;\r\n  abstract clearAppHandler: () => void;\r\n  abstract dispatch: (request: Request) => void;\r\n  abstract formRequestAndDispatch: (\r\n    type: string,\r\n    version: number,\r\n    payload?: object | undefined\r\n  ) => void;\r\n\r\n  /**\r\n   * Optional passive observer of outbound Dispatches (ADR-0002). Unset by\r\n   * default, so production hosts pay nothing and behave exactly as before.\r\n   */\r\n  abstract requestObserver?: DispatchObserver;\r\n\r\n  static get(appObject: AppObject): HostDispatchEntity | undefined {\r\n    const component = appObject.getComponent<HostDispatchEntity>(\r\n      HostDispatchEntity.type\r\n    );\r\n    if (!component) {\r\n      appObject.appObjectRepo.submitWarning(\r\n        \"AssetEntity.get\",\r\n        \"Unable to find HostDispatchEntity on app object \" + appObject.id\r\n      );\r\n    }\r\n    return component;\r\n  }\r\n\r\n  static getByID(\r\n    id: string,\r\n    appObjects: AppObjectRepo\r\n  ): HostDispatchEntity | undefined {\r\n    const appObject = appObjects.get(id);\r\n    if (!appObject) {\r\n      appObjects.submitWarning(\r\n        \"AssetEntity.getByID\",\r\n        \"Unable to find app object \" + id\r\n      );\r\n      return;\r\n    }\r\n    return HostDispatchEntity.get(appObject);\r\n  }\r\n}\r\n\r\nexport function makeHostDispatchEntity(\r\n  appObject: AppObject\r\n): HostDispatchEntity {\r\n  return new HostDispatchEntityImp(appObject);\r\n}\r\n\r\nclass HostDispatchEntityImp extends HostDispatchEntity {\r\n  private appHandler?: Handler;\r\n\r\n  private _appHandlerVersion = 0;\r\n  public get appHandlerVersion() {\r\n    return this._appHandlerVersion;\r\n  }\r\n\r\n  private appPayloadVersions = new Map<string, number>();\r\n\r\n  registerAppHandler = (appHandler: Handler) => {\r\n    this.appHandler = appHandler;\r\n    this.getAppHandlerVersion();\r\n  };\r\n\r\n  clearAppHandler = () => {\r\n    this.appHandler = undefined;\r\n  };\r\n\r\n  private getAppHandlerVersion() {\r\n    const type = \"GET_APP_HANDLER_VERSION\";\r\n    const payload = { callback: this.setupVersion };\r\n\r\n    try {\r\n      this.formRequestAndDispatch(type, 1, payload);\r\n    } catch {\r\n      // All good. this is probably an older app\r\n    }\r\n  }\r\n\r\n  getRequestPayloadVersion = (requestType: string): number | undefined => {\r\n    return this.appPayloadVersions.get(requestType);\r\n  };\r\n\r\n  private setupVersion = (version: number) => {\r\n    // Apps before app package version 2.27 will not reach this\r\n    this._appHandlerVersion = version;\r\n    this.getPayloadVersions();\r\n  };\r\n\r\n  private getPayloadVersions = () => {\r\n    const type = \"GET_APP_PAYLOAD_VERSION\";\r\n    const payload = { callback: this.setupPayloadVersions };\r\n    this.formRequestAndDispatch(type, 2, payload);\r\n  };\r\n\r\n  private setupPayloadVersions = (payloadVersion: Map<string, number>) => {\r\n    this.appPayloadVersions = payloadVersion;\r\n  };\r\n\r\n  requestObserver?: DispatchObserver;\r\n\r\n  /**\r\n   * Notify the passive observer, if any. Wrapped so a throwing or slow observer\r\n   * can never alter, delay, or fail the Request's delivery (ADR-0002).\r\n   */\r\n  private notifyObserver = (request: Request, outcome: DispatchOutcome) => {\r\n    if (!this.requestObserver) return;\r\n    try {\r\n      this.requestObserver(request, outcome);\r\n    } catch {\r\n      // Passive: an observer failure must never affect dispatch.\r\n    }\r\n  };\r\n\r\n  dispatch = (request: Request) => {\r\n    if (!this.appHandler) {\r\n      this.error(\"No app handler has been registered\");\r\n      this.notifyObserver(request, \"no-app-handler\");\r\n      return;\r\n    }\r\n\r\n    try {\r\n      this.appHandler(request);\r\n      this.notifyObserver(request, \"delivered\");\r\n    } catch (e) {\r\n      this.warn((e as Error).message);\r\n      this.notifyObserver(request, \"threw\");\r\n    }\r\n  };\r\n\r\n  formRequestAndDispatch = (\r\n    type: string,\r\n    version: number,\r\n    payload?: object | undefined\r\n  ) => {\r\n    const request: Request = {\r\n      type,\r\n      version,\r\n      payload\r\n    };\r\n\r\n    this.dispatch(request);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, HostDispatchEntity.type);\r\n  }\r\n}\r\n"]}

package/dist/esm/Dispatcher/Mocks/MockHostDispatcher.js

@@ -8,6 +8,7 @@ export class MockHostDispatchEntity extends HostDispatchEntity {
         this.registerAppHandler = jest.fn();
         this.dispatch = jest.fn();
         this.formRequestAndDispatch = jest.fn();
+        this.requestObserver = undefined;
     }
 }
 //# sourceMappingURL=MockHostDispatcher.js.map

package/dist/esm/Dispatcher/Mocks/MockHostDispatcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"MockHostDispatcher.js","sourceRoot":"","sources":["../../../../src/Dispatcher/Mocks/MockHostDispatcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,OAAO,sBAAuB,SAAQ,kBAAkB;IAQ5D,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAR5C,oBAAe,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QAC5B,sBAAiB,GAAG,CAAC,CAAC;QACtB,6BAAwB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACrC,uBAAkB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QAC/B,aAAQ,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACrB,2BAAsB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;IAInC,CAAC;CACF","sourcesContent":["import { AppObject } from \"@vived/core\";\nimport { HostDispatchEntity } from \"../Entities\";\n\nexport class MockHostDispatchEntity extends HostDispatchEntity {\n  clearAppHandler = jest.fn();\n  appHandlerVersion = 1;\n  getRequestPayloadVersion = jest.fn();\n  registerAppHandler = jest.fn();\n  dispatch = jest.fn();\n  formRequestAndDispatch = jest.fn();\n\n  constructor(appObject: AppObject) {\n    super(appObject, HostDispatchEntity.type);\n  }\n}\n"]}
+{"version":3,"file":"MockHostDispatcher.js","sourceRoot":"","sources":["../../../../src/Dispatcher/Mocks/MockHostDispatcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,OAAO,sBAAuB,SAAQ,kBAAkB;IAS5D,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAT5C,oBAAe,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QAC5B,sBAAiB,GAAG,CAAC,CAAC;QACtB,6BAAwB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACrC,uBAAkB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QAC/B,aAAQ,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACrB,2BAAsB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACnC,oBAAe,GAAG,SAAS,CAAC;IAI5B,CAAC;CACF","sourcesContent":["import { AppObject } from \"@vived/core\";\r\nimport { HostDispatchEntity } from \"../Entities\";\r\n\r\nexport class MockHostDispatchEntity extends HostDispatchEntity {\r\n  clearAppHandler = jest.fn();\r\n  appHandlerVersion = 1;\r\n  getRequestPayloadVersion = jest.fn();\r\n  registerAppHandler = jest.fn();\r\n  dispatch = jest.fn();\r\n  formRequestAndDispatch = jest.fn();\r\n  requestObserver = undefined;\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, HostDispatchEntity.type);\r\n  }\r\n}\r\n"]}

package/dist/esm/Handler/Entities/HostHandler.js

@@ -12,17 +12,34 @@ class RequestHandlerImp extends HostHandlerEntity {
     constructor(appObj) {
         super(appObj, HostHandlerEntity.type);
         this.handlers = new Map();
+        /**
+         * Notify the passive observer, if any. Wrapped so a throwing or slow observer
+         * can never alter, delay, or fail the Request (ADR-0002).
+         */
+        this.notifyObserver = (request, outcome) => {
+            if (!this.requestObserver)
+                return;
+            try {
+                this.requestObserver(request, outcome);
+            }
+            catch {
+                // Passive: an observer failure must never affect handling.
+            }
+        };
         this.handler = (request) => {
             const handler = this.handlers.get(request.type);
             if (!handler) {
                 this.warn(`Unsupported request type received: ${request.type}`);
+                this.notifyObserver(request, "unsupported");
                 return;
             }
             try {
                 handler.handleRequest(request.version, request.payload);
+                this.notifyObserver(request, "handled");
             }
             catch (e) {
                 this.warn(`${e}`);
+                this.notifyObserver(request, "threw");
             }
         };
         this.registerRequestHandler = (handler) => {

package/dist/esm/Handler/Entities/HostHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"HostHandler.js","sourceRoot":"","sources":["../../../../src/Handler/Entities/HostHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,eAAe,EAAE,MAAM,aAAa,CAAC;AAQzD,MAAM,OAAgB,iBAAkB,SAAQ,eAAe;IAG7D,MAAM,CAAC,GAAG,CAAC,SAAoB;QAC7B,OAAO,SAAS,CAAC,YAAY,CAAoB,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC3E,CAAC;;AAJM,sBAAI,GAAG,mBAAmB,CAAC;AAUpC,MAAM,UAAU,qBAAqB,CAAC,SAAoB;IACxD,OAAO,IAAI,iBAAiB,CAAC,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,iBAAkB,SAAQ,iBAAiB;IA4B/C,YAAY,MAAiB;QAC3B,KAAK,CAAC,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;QA5BhC,aAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;QAErD,YAAO,GAAY,CAAC,OAAgB,EAAQ,EAAE;YAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAEhD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,IAAI,CAAC,IAAI,CAAC,sCAAsC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;gBAChE,OAAO;YACT,CAAC;YAED,IAAI,CAAC;gBACH,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YAC1D,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,CAAC;QAEF,2BAAsB,GAAG,CAAC,OAAuB,EAAQ,EAAE;YACzD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC3C,IAAI,CAAC,IAAI,CACP,iDAAiD,OAAO,CAAC,WAAW,yCAAyC,CAC9G,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC,CAAC;IAIF,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAClD,YAAY,WAAmB,EAAE,OAAe;QAC9C,MAAM,GAAG,GAAG,WAAW,OAAO,oBAAoB,WAAW,mBAAmB,CAAC;QACjF,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,WAAmB;QAC7B,MAAM,GAAG,GAAG,2BAA2B,WAAW,qBAAqB,CAAC;QACxE,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,WAAmB,EAAE,OAAe,EAAE,OAAe;QAC/D,MAAM,GAAG,GAAG,sCAAsC,OAAO,oBAAoB,WAAW,KAAK,OAAO,EAAE,CAAC;QACvG,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;CACF","sourcesContent":["import { AppObject, AppObjectEntity } from \"@vived/core\";\nimport { Handler, Request } from \"@vived/core\";\n\nexport interface RequestHandler {\n  readonly requestType: string;\n  handleRequest: (version: number, payload?: unknown) => void;\n}\n\nexport abstract class HostHandlerEntity extends AppObjectEntity {\n  static type = \"HostHandlerEntity\";\n\n  static get(appObject: AppObject) {\n    return appObject.getComponent<HostHandlerEntity>(HostHandlerEntity.type);\n  }\n\n  abstract handler: Handler;\n  abstract registerRequestHandler: (requestHandler: RequestHandler) => void;\n}\n\nexport function makeHostHandlerEntity(appObject: AppObject): HostHandlerEntity {\n  return new RequestHandlerImp(appObject);\n}\n\nclass RequestHandlerImp extends HostHandlerEntity {\n  private handlers = new Map<string, RequestHandler>();\n\n  handler: Handler = (request: Request): void => {\n    const handler = this.handlers.get(request.type);\n\n    if (!handler) {\n      this.warn(`Unsupported request type received: ${request.type}`);\n      return;\n    }\n\n    try {\n      handler.handleRequest(request.version, request.payload);\n    } catch (e) {\n      this.warn(`${e}`);\n    }\n  };\n\n  registerRequestHandler = (handler: RequestHandler): void => {\n    if (this.handlers.has(handler.requestType)) {\n      this.warn(\n        `More than one handler is being registered for ${handler.requestType}. Previous handler is being overwritten`\n      );\n    }\n\n    this.handlers.set(handler.requestType, handler);\n  };\n\n  constructor(appObj: AppObject) {\n    super(appObj, HostHandlerEntity.type);\n  }\n}\n\nexport class UnsupportedRequestVersion extends Error {\n  constructor(requestType: string, version: number) {\n    const msg = `Version ${version} of request type ${requestType} is not supported`;\n    super(msg);\n  }\n}\n\nexport class ActionNotImplemented extends Error {\n  constructor(requestType: string) {\n    const msg = `Action for request type ${requestType} is not implemented`;\n    super(msg);\n  }\n}\n\nexport class UnableToParsePayload extends Error {\n  constructor(requestType: string, version: number, payload: string) {\n    const msg = `Unable to parse paylod for version ${version} of request type ${requestType}: ${payload}`;\n    super(msg);\n  }\n}\n"]}
+{"version":3,"file":"HostHandler.js","sourceRoot":"","sources":["../../../../src/Handler/Entities/HostHandler.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppObject, AppObjectEntity } from \"@vived/core\";\r\nimport { Handler, Request } from \"@vived/core\";\r\n\r\nexport interface RequestHandler {\r\n  readonly requestType: string;\r\n  handleRequest: (version: number, payload?: unknown) => void;\r\n}\r\n\r\n/**\r\n * The outcome of an inbound Request, as seen at the handler chokepoint:\r\n * \"handled\" (a registered handler ran), \"unsupported\" (no handler registered\r\n * for the type), or \"threw\" (the handler raised).\r\n */\r\nexport type HandlerOutcome = \"handled\" | \"unsupported\" | \"threw\";\r\n\r\n/**\r\n * Passive observer of inbound Requests. Notified after each Request is routed,\r\n * with the outcome. Purely observational — see the passivity contract in\r\n * ADR-0002: an observer must never alter, delay, or fail the Request.\r\n */\r\nexport type HandlerObserver = (\r\n  request: Request,\r\n  outcome: HandlerOutcome\r\n) => void;\r\n\r\nexport abstract class HostHandlerEntity extends AppObjectEntity {\r\n  static type = \"HostHandlerEntity\";\r\n\r\n  static get(appObject: AppObject) {\r\n    return appObject.getComponent<HostHandlerEntity>(HostHandlerEntity.type);\r\n  }\r\n\r\n  abstract handler: Handler;\r\n  abstract registerRequestHandler: (requestHandler: RequestHandler) => void;\r\n\r\n  /**\r\n   * Optional passive observer of inbound Requests (ADR-0002). Unset by default,\r\n   * so production hosts pay nothing and behave exactly as before.\r\n   */\r\n  abstract requestObserver?: HandlerObserver;\r\n}\r\n\r\nexport function makeHostHandlerEntity(appObject: AppObject): HostHandlerEntity {\r\n  return new RequestHandlerImp(appObject);\r\n}\r\n\r\nclass RequestHandlerImp extends HostHandlerEntity {\r\n  private handlers = new Map<string, RequestHandler>();\r\n\r\n  requestObserver?: HandlerObserver;\r\n\r\n  /**\r\n   * Notify the passive observer, if any. Wrapped so a throwing or slow observer\r\n   * can never alter, delay, or fail the Request (ADR-0002).\r\n   */\r\n  private notifyObserver = (request: Request, outcome: HandlerOutcome) => {\r\n    if (!this.requestObserver) return;\r\n    try {\r\n      this.requestObserver(request, outcome);\r\n    } catch {\r\n      // Passive: an observer failure must never affect handling.\r\n    }\r\n  };\r\n\r\n  handler: Handler = (request: Request): void => {\r\n    const handler = this.handlers.get(request.type);\r\n\r\n    if (!handler) {\r\n      this.warn(`Unsupported request type received: ${request.type}`);\r\n      this.notifyObserver(request, \"unsupported\");\r\n      return;\r\n    }\r\n\r\n    try {\r\n      handler.handleRequest(request.version, request.payload);\r\n      this.notifyObserver(request, \"handled\");\r\n    } catch (e) {\r\n      this.warn(`${e}`);\r\n      this.notifyObserver(request, \"threw\");\r\n    }\r\n  };\r\n\r\n  registerRequestHandler = (handler: RequestHandler): void => {\r\n    if (this.handlers.has(handler.requestType)) {\r\n      this.warn(\r\n        `More than one handler is being registered for ${handler.requestType}. Previous handler is being overwritten`\r\n      );\r\n    }\r\n\r\n    this.handlers.set(handler.requestType, handler);\r\n  };\r\n\r\n  constructor(appObj: AppObject) {\r\n    super(appObj, HostHandlerEntity.type);\r\n  }\r\n}\r\n\r\nexport class UnsupportedRequestVersion extends Error {\r\n  constructor(requestType: string, version: number) {\r\n    const msg = `Version ${version} of request type ${requestType} is not supported`;\r\n    super(msg);\r\n  }\r\n}\r\n\r\nexport class ActionNotImplemented extends Error {\r\n  constructor(requestType: string) {\r\n    const msg = `Action for request type ${requestType} is not implemented`;\r\n    super(msg);\r\n  }\r\n}\r\n\r\nexport class UnableToParsePayload extends Error {\r\n  constructor(requestType: string, version: number, payload: string) {\r\n    const msg = `Unable to parse paylod for version ${version} of request type ${requestType}: ${payload}`;\r\n    super(msg);\r\n  }\r\n}\r\n"]}

package/dist/esm/ThemeColors/Data/vivedDarkTheme.json

@@ -1,51 +1,51 @@
 {
-    "primary": "#7BD0FF",
-    "onPrimary": "#003549",
-    "primaryContainer": "#004C69",
-    "onPrimaryContainer": "#C4E7FF",
-    "primaryFixed": "#C4E7FF",
-    "onPrimaryFixed": "#001E2C",
-    "primaryFixedDim": "#7BD0FF",
-    "onPrimaryFixedVariant": "#004C69",
-    "secondary": "#B5C9D7",
-    "onSecondary": "#20333E",
-    "secondaryContainer": "#374955",
-    "onSecondaryContainer": "#D1E5F4",
-    "secondaryFixed": "#D1E5F4",
-    "onSecondaryFixed": "#0A1E28",
-    "secondaryFixedDim": "#B5C9D7",
-    "onSecondaryFixedVariant": "#374955",
-    "tertiary": "#CAC1E9",
-    "onTertiary": "#322C4C",
-    "tertiaryContainer": "#484264",
-    "onTertiaryContainer": "#E6DEFF",
-    "tertiaryFixed": "#E6DEFF",
-    "onTertiaryFixed": "#1D1736",
-    "tertiaryFixedDim": "#CAC1E9",
-    "onTertiaryFixedVariant": "#484264",
-    "error": "#FFB4AB",
-    "onError": "#690005",
-    "errorContainer": "#93000A",
-    "onErrorContainer": "#FFDAD6",
-    "outline": "#8B9297",
-    "background": "#191C1E",
-    "onBackground": "#E1E2E5",
-    "surface": "#111416",
-    "onSurface": "#C5C6C9",
-    "surfaceVariant": "#41484D",
-    "onSurfaceVariant": "#C0C7CD",
-    "inverseSurface": "#E1E2E5",
-    "inverseOnSurface": "#191C1E",
-    "inversePrimary": "#00668A",
+    "primary": "#4ec9f5",
+    "onPrimary": "#062231",
+    "primaryContainer": "#00506f",
+    "onPrimaryContainer": "#cbeafb",
+    "primaryFixed": "#cbeafb",
+    "onPrimaryFixed": "#001e2e",
+    "primaryFixedDim": "#7ad2f2",
+    "onPrimaryFixedVariant": "#00506f",
+    "secondary": "#b3c7d3",
+    "onSecondary": "#1e2c34",
+    "secondaryContainer": "#35525f",
+    "onSecondaryContainer": "#d0e6f0",
+    "secondaryFixed": "#d0e6f0",
+    "onSecondaryFixed": "#081f2a",
+    "secondaryFixedDim": "#b4cad6",
+    "onSecondaryFixedVariant": "#35525f",
+    "tertiary": "#5cd0f6",
+    "onTertiary": "#00344a",
+    "tertiaryContainer": "#005e7c",
+    "onTertiaryContainer": "#bfeaff",
+    "tertiaryFixed": "#bfeaff",
+    "onTertiaryFixed": "#001f2c",
+    "tertiaryFixedDim": "#6bd5f5",
+    "onTertiaryFixedVariant": "#005e7c",
+    "error": "#ff6b81",
+    "onError": "#3a0710",
+    "errorContainer": "#7f1225",
+    "onErrorContainer": "#ffd9df",
+    "outline": "#7c7f83",
+    "background": "#17181a",
+    "onBackground": "#e7e8ea",
+    "surface": "#1f2123",
+    "onSurface": "#e7e8ea",
+    "surfaceVariant": "#2a2d30",
+    "onSurfaceVariant": "#a9abae",
+    "inverseSurface": "#e7e8ea",
+    "inverseOnSurface": "#17181a",
+    "inversePrimary": "#0096d6",
     "shadow": "#000000",
-    "surfaceTint": "#7BD0FF",
-    "outlineVariant": "#41484D",
+    "surfaceTint": "#4ec9f5",
+    "outlineVariant": "#303336",
     "scrim": "#000000",
-    "surfaceContainerHighest": "#333537",
-    "surfaceContainerHigh": "#282A2C",
-    "surfaceContainer": "#1D2022",
-    "surfaceContainerLow": "#191C1E",
-    "surfaceContainerLowest": "#0C0F10",
-    "surfaceBright": "#37393C",
-    "surfaceDim": "#111416"
+    "surfaceContainerHighest": "#35383b",
+    "surfaceContainerHigh": "#2a2d30",
+    "surfaceContainer": "#1f2123",
+    "surfaceContainerLow": "#1b1d1f",
+    "surfaceContainerLowest": "#101113",
+    "surfaceBright": "#35383b",
+    "surfaceDim": "#101113"
 }