@memberjunction/ng-conversations 6.2.0-edge.2 → 6.2.0-edge.4

package/dist/lib/components/realtime/channels/realtime-channel-pane.component.d.ts

@@ -1,35 +1,56 @@
 import { OnDestroy, OnInit } from '@angular/core';
+import type { MediaPlacement } from '@memberjunction/ai-realtime-client/media';
 import { BaseRealtimeChannelClient } from '@memberjunction/realtime-runtime';
 import * as i0 from "@angular/core";
 /**
- * Generic pane host for an interactive channel's surface inside the overlay's tabbed
- * surface panel. Given the per-session channel {@link Plugin}, it:
+ * Generic host for an interactive channel's surface on the call overlay's stage. Given the per-session channel
+ * {@link Plugin}, it:
  *
  *  1. dynamically creates the plugin's surface component
  *     ({@link BaseRealtimeChannelClient.GetSurfaceComponent}) into its own view container;
  *  2. immediately hands the created instance to
  *     {@link BaseRealtimeChannelClient.BindSurface} — synchronously, BEFORE the surface's
  *     first change detection, so inputs the plugin sets are visible in its `ngOnInit`;
- *  3. notifies {@link BaseRealtimeChannelClient.UnbindSurface} when the pane is destroyed
- *     (panel collapsed / overlay torn down), flipping the plugin back into its
- *     no-surface tool-execution mode.
+ *  3. tells the plugin whether the surface is on screen
+ *     ({@link BaseRealtimeChannelClient.OnSurfaceVisibilityChange}) and where it is placed
+ *     ({@link BaseRealtimeChannelClient.OnSurfacePlacementChange}) right after binding and whenever
+ *     {@link Visible} or {@link Placement} changes;
+ *  4. notifies {@link BaseRealtimeChannelClient.UnbindSurface} when the pane is destroyed
+ *     (the channel left the session / the overlay was torn down) or handed another plugin,
+ *     flipping the plugin back into its no-surface tool-execution mode.
  *
  * This is how channel surfaces render with ZERO channel-specific wiring in the overlay:
  * the host never knows the surface component's type or API — the plugin wires its own
  * inputs/outputs in `BindSurface`.
  *
  * The created component is inserted as a SIBLING of this host element (standard
- * `ViewContainerRef` semantics), so it participates directly in the pane's flex layout;
+ * `ViewContainerRef` semantics), so it participates directly in its container's layout;
  * the host element itself renders nothing (`display: none`).
  */
 export declare class RealtimeChannelPaneComponent implements OnInit, OnDestroy {
-    /** The per-session channel plugin whose surface this pane hosts. */
-    Plugin: BaseRealtimeChannelClient;
     private viewContainer;
     private surfaceRef;
+    private plugin;
+    private initialized;
+    private visible;
+    private placement;
+    /**
+     * The per-session channel plugin whose surface this pane hosts. Handing the pane another plugin (the same channel
+     * in a new session) releases the old plugin's surface and creates the new one's.
+     */
+    set Plugin(value: BaseRealtimeChannelClient);
+    get Plugin(): BaseRealtimeChannelClient;
+    /** Whether the surface is on screen. The plugin hears of every change while its surface is bound. */
+    set Visible(value: boolean);
+    get Visible(): boolean;
+    /** Where the surface is placed. The plugin hears of every move while its surface is bound. */
+    set Placement(value: MediaPlacement);
+    get Placement(): MediaPlacement;
     ngOnInit(): void;
     ngOnDestroy(): void;
+    private createSurface;
+    private releaseSurface;
     static ɵfac: i0.ɵɵFactoryDeclaration<RealtimeChannelPaneComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<RealtimeChannelPaneComponent, "mj-realtime-channel-pane", never, { "Plugin": { "alias": "Plugin"; "required": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RealtimeChannelPaneComponent, "mj-realtime-channel-pane", never, { "Plugin": { "alias": "Plugin"; "required": true; }; "Visible": { "alias": "Visible"; "required": false; }; "Placement": { "alias": "Placement"; "required": false; }; }, {}, never, never, true, never>;
 }
 //# sourceMappingURL=realtime-channel-pane.component.d.ts.map

package/dist/lib/components/realtime/channels/realtime-channel-pane.component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"realtime-channel-pane.component.d.ts","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/channels/realtime-channel-pane.component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,SAAS,EAAE,MAAM,EAAkC,MAAM,eAAe,CAAC;AAClH,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;;AAE7E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAMa,4BAA6B,YAAW,MAAM,EAAE,SAAS;IACpE,oEAAoE;IACzC,MAAM,EAAG,yBAAyB,CAAC;IAE9D,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,UAAU,CAAqC;IAEvD,QAAQ,IAAI,IAAI;IAiBhB,WAAW,IAAI,IAAI;yCAxBR,4BAA4B;2CAA5B,4BAA4B;CA6BxC"}
+{"version":3,"file":"realtime-channel-pane.component.d.ts","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/channels/realtime-channel-pane.component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,SAAS,EAAE,MAAM,EAAkC,MAAM,eAAe,CAAC;AAClH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAC/E,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAMa,4BAA6B,YAAW,MAAM,EAAE,SAAS;IACpE,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,UAAU,CAAqC;IACvD,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,SAAS,CAAyB;IAE1C;;;OAGG;IACH,IACI,MAAM,CAAC,KAAK,EAAE,yBAAyB,EAW1C;IACD,IAAI,MAAM,IAAI,yBAAyB,CAEtC;IAED,qGAAqG;IACrG,IACI,OAAO,CAAC,KAAK,EAAE,OAAO,EAQzB;IACD,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,8FAA8F;IAC9F,IACI,SAAS,CAAC,KAAK,EAAE,cAAc,EAQlC;IACD,IAAI,SAAS,IAAI,cAAc,CAE9B;IAED,QAAQ,IAAI,IAAI;IAKhB,WAAW,IAAI,IAAI;IAInB,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,cAAc;yCAvFX,4BAA4B;2CAA5B,4BAA4B;CA4FxC"}

package/dist/lib/components/realtime/channels/realtime-channel-pane.component.js

@@ -1,35 +1,93 @@
 import { Component, Input, ViewContainerRef, inject } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Generic pane host for an interactive channel's surface inside the overlay's tabbed
- * surface panel. Given the per-session channel {@link Plugin}, it:
+ * Generic host for an interactive channel's surface on the call overlay's stage. Given the per-session channel
+ * {@link Plugin}, it:
  *
  *  1. dynamically creates the plugin's surface component
  *     ({@link BaseRealtimeChannelClient.GetSurfaceComponent}) into its own view container;
  *  2. immediately hands the created instance to
  *     {@link BaseRealtimeChannelClient.BindSurface} — synchronously, BEFORE the surface's
  *     first change detection, so inputs the plugin sets are visible in its `ngOnInit`;
- *  3. notifies {@link BaseRealtimeChannelClient.UnbindSurface} when the pane is destroyed
- *     (panel collapsed / overlay torn down), flipping the plugin back into its
- *     no-surface tool-execution mode.
+ *  3. tells the plugin whether the surface is on screen
+ *     ({@link BaseRealtimeChannelClient.OnSurfaceVisibilityChange}) and where it is placed
+ *     ({@link BaseRealtimeChannelClient.OnSurfacePlacementChange}) right after binding and whenever
+ *     {@link Visible} or {@link Placement} changes;
+ *  4. notifies {@link BaseRealtimeChannelClient.UnbindSurface} when the pane is destroyed
+ *     (the channel left the session / the overlay was torn down) or handed another plugin,
+ *     flipping the plugin back into its no-surface tool-execution mode.
  *
  * This is how channel surfaces render with ZERO channel-specific wiring in the overlay:
  * the host never knows the surface component's type or API — the plugin wires its own
  * inputs/outputs in `BindSurface`.
  *
  * The created component is inserted as a SIBLING of this host element (standard
- * `ViewContainerRef` semantics), so it participates directly in the pane's flex layout;
+ * `ViewContainerRef` semantics), so it participates directly in its container's layout;
  * the host element itself renders nothing (`display: none`).
  */
 export class RealtimeChannelPaneComponent {
-    /** The per-session channel plugin whose surface this pane hosts. */
-    Plugin;
     viewContainer = inject(ViewContainerRef);
     surfaceRef = null;
+    plugin;
+    initialized = false;
+    visible = true;
+    placement = 'tab';
+    /**
+     * The per-session channel plugin whose surface this pane hosts. Handing the pane another plugin (the same channel
+     * in a new session) releases the old plugin's surface and creates the new one's.
+     */
+    set Plugin(value) {
+        if (value === this.plugin) {
+            return;
+        }
+        if (this.initialized) {
+            this.releaseSurface();
+        }
+        this.plugin = value;
+        if (this.initialized) {
+            this.createSurface();
+        }
+    }
+    get Plugin() {
+        return this.plugin;
+    }
+    /** Whether the surface is on screen. The plugin hears of every change while its surface is bound. */
+    set Visible(value) {
+        if (value === this.visible) {
+            return;
+        }
+        this.visible = value;
+        if (this.surfaceRef) {
+            this.plugin.OnSurfaceVisibilityChange(value);
+        }
+    }
+    get Visible() {
+        return this.visible;
+    }
+    /** Where the surface is placed. The plugin hears of every move while its surface is bound. */
+    set Placement(value) {
+        if (value === this.placement) {
+            return;
+        }
+        this.placement = value;
+        if (this.surfaceRef) {
+            this.plugin.OnSurfacePlacementChange(value);
+        }
+    }
+    get Placement() {
+        return this.placement;
+    }
     ngOnInit() {
+        this.initialized = true;
+        this.createSurface();
+    }
+    ngOnDestroy() {
+        this.releaseSurface();
+    }
+    createSurface() {
         // Server-only channels have no surface (GetSurfaceComponent === null). The overlay should not
         // register a pane for them, but guard here too so a stray registration never crashes the panel.
-        const surface = this.Plugin.GetSurfaceComponent();
+        const surface = this.plugin.GetSurfaceComponent();
         if (!surface) {
             return;
         }
@@ -39,16 +97,18 @@ export class RealtimeChannelPaneComponent {
         this.surfaceRef = this.viewContainer.createComponent(surface);
         // Bind BEFORE the created component's first change detection — inputs the plugin sets
         // here are in place when the surface's ngOnInit runs.
-        this.Plugin.BindSurface(this.surfaceRef.instance);
+        this.plugin.BindSurface(this.surfaceRef.instance);
+        this.plugin.OnSurfaceVisibilityChange(this.visible);
+        this.plugin.OnSurfacePlacementChange(this.placement);
         this.surfaceRef.changeDetectorRef.markForCheck();
     }
-    ngOnDestroy() {
-        this.Plugin.UnbindSurface();
+    releaseSurface() {
+        this.plugin.UnbindSurface();
         this.surfaceRef?.destroy();
         this.surfaceRef = null;
     }
     static ɵfac = function RealtimeChannelPaneComponent_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || RealtimeChannelPaneComponent)(); };
-    static ɵcmp = /*@__PURE__*/ i0.ɵɵdefineComponent({ type: RealtimeChannelPaneComponent, selectors: [["mj-realtime-channel-pane"]], inputs: { Plugin: "Plugin" }, decls: 0, vars: 0, template: function RealtimeChannelPaneComponent_Template(rf, ctx) { }, styles: ["[_nghost-%COMP%] { display: none; }"] });
+    static ɵcmp = /*@__PURE__*/ i0.ɵɵdefineComponent({ type: RealtimeChannelPaneComponent, selectors: [["mj-realtime-channel-pane"]], inputs: { Plugin: "Plugin", Visible: "Visible", Placement: "Placement" }, decls: 0, vars: 0, template: function RealtimeChannelPaneComponent_Template(rf, ctx) { }, styles: ["[_nghost-%COMP%] { display: none; }"] });
 }
 (() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(RealtimeChannelPaneComponent, [{
         type: Component,
@@ -56,6 +116,10 @@ export class RealtimeChannelPaneComponent {
     }], null, { Plugin: [{
             type: Input,
             args: [{ required: true }]
+        }], Visible: [{
+            type: Input
+        }], Placement: [{
+            type: Input
         }] }); })();
-(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(RealtimeChannelPaneComponent, { className: "RealtimeChannelPaneComponent", filePath: "src/lib/components/realtime/channels/realtime-channel-pane.component.ts", lineNumber: 31 }); })();
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(RealtimeChannelPaneComponent, { className: "RealtimeChannelPaneComponent", filePath: "src/lib/components/realtime/channels/realtime-channel-pane.component.ts", lineNumber: 36 }); })();
 //# sourceMappingURL=realtime-channel-pane.component.js.map

package/dist/lib/components/realtime/channels/realtime-channel-pane.component.js.map

@@ -1 +1 @@
-{"version":3,"file":"realtime-channel-pane.component.js","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/channels/realtime-channel-pane.component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,KAAK,EAA2B,gBAAgB,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;;AAGlH;;;;;;;;;;;;;;;;;;;;GAoBG;AAOH,MAAM,OAAO,4BAA4B;IACvC,oEAAoE;IACzC,MAAM,CAA6B;IAEtD,aAAa,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACzC,UAAU,GAAgC,IAAI,CAAC;IAEvD,QAAQ;QACN,8FAA8F;QAC9F,gGAAgG;QAChG,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAClD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QACD,4FAA4F;QAC5F,yFAAyF;QACzF,2FAA2F;QAC3F,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,OAAuB,CAAC,CAAC;QAC9E,sFAAsF;QACtF,sDAAsD;QACtD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,YAAY,EAAE,CAAC;IACnD,CAAC;IAED,WAAW;QACT,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAC5B,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;sHA5BU,4BAA4B;6DAA5B,4BAA4B;;iFAA5B,4BAA4B;cANxC,SAAS;6BACI,IAAI,YACN,0BAA0B,YAC1B,EAAE;;kBAKX,KAAK;mBAAC,EAAE,QAAQ,EAAE,IAAI,EAAE;;kFAFd,4BAA4B","sourcesContent":["import { Component, ComponentRef, Input, OnDestroy, OnInit, Type, ViewContainerRef, inject } from '@angular/core';\nimport { BaseRealtimeChannelClient } from '@memberjunction/realtime-runtime';\n\n/**\n * Generic pane host for an interactive channel's surface inside the overlay's tabbed\n * surface panel. Given the per-session channel {@link Plugin}, it:\n *\n *  1. dynamically creates the plugin's surface component\n *     ({@link BaseRealtimeChannelClient.GetSurfaceComponent}) into its own view container;\n *  2. immediately hands the created instance to\n *     {@link BaseRealtimeChannelClient.BindSurface} — synchronously, BEFORE the surface's\n *     first change detection, so inputs the plugin sets are visible in its `ngOnInit`;\n *  3. notifies {@link BaseRealtimeChannelClient.UnbindSurface} when the pane is destroyed\n *     (panel collapsed / overlay torn down), flipping the plugin back into its\n *     no-surface tool-execution mode.\n *\n * This is how channel surfaces render with ZERO channel-specific wiring in the overlay:\n * the host never knows the surface component's type or API — the plugin wires its own\n * inputs/outputs in `BindSurface`.\n *\n * The created component is inserted as a SIBLING of this host element (standard\n * `ViewContainerRef` semantics), so it participates directly in the pane's flex layout;\n * the host element itself renders nothing (`display: none`).\n */\n@Component({\n  standalone: true,\n  selector: 'mj-realtime-channel-pane',\n  template: '',\n  styles: [':host { display: none; }']\n})\nexport class RealtimeChannelPaneComponent implements OnInit, OnDestroy {\n  /** The per-session channel plugin whose surface this pane hosts. */\n  @Input({ required: true }) Plugin!: BaseRealtimeChannelClient;\n\n  private viewContainer = inject(ViewContainerRef);\n  private surfaceRef: ComponentRef<object> | null = null;\n\n  ngOnInit(): void {\n    // Server-only channels have no surface (GetSurfaceComponent === null). The overlay should not\n    // register a pane for them, but guard here too so a stray registration never crashes the panel.\n    const surface = this.Plugin.GetSurfaceComponent();\n    if (!surface) {\n      return;\n    }\n    // The runtime carries the surface as an opaque component class — it has no business knowing\n    // what a component is in any given framework. This is the single point that does, so the\n    // Angular narrowing belongs here rather than as a structural claim in the shared contract.\n    this.surfaceRef = this.viewContainer.createComponent(surface as Type<object>);\n    // Bind BEFORE the created component's first change detection — inputs the plugin sets\n    // here are in place when the surface's ngOnInit runs.\n    this.Plugin.BindSurface(this.surfaceRef.instance);\n    this.surfaceRef.changeDetectorRef.markForCheck();\n  }\n\n  ngOnDestroy(): void {\n    this.Plugin.UnbindSurface();\n    this.surfaceRef?.destroy();\n    this.surfaceRef = null;\n  }\n}\n"]}
+{"version":3,"file":"realtime-channel-pane.component.js","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/channels/realtime-channel-pane.component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,KAAK,EAA2B,gBAAgB,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;;AAIlH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAOH,MAAM,OAAO,4BAA4B;IAC/B,aAAa,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACzC,UAAU,GAAgC,IAAI,CAAC;IAC/C,MAAM,CAA6B;IACnC,WAAW,GAAG,KAAK,CAAC;IACpB,OAAO,GAAG,IAAI,CAAC;IACf,SAAS,GAAmB,KAAK,CAAC;IAE1C;;;OAGG;IACH,IACI,MAAM,CAAC,KAAgC;QACzC,IAAI,KAAK,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IACD,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,qGAAqG;IACrG,IACI,OAAO,CAAC,KAAc;QACxB,IAAI,KAAK,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YAC3B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,8FAA8F;IAC9F,IACI,SAAS,CAAC,KAAqB;QACjC,IAAI,KAAK,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IACD,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED,WAAW;QACT,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAEO,aAAa;QACnB,8FAA8F;QAC9F,gGAAgG;QAChG,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAClD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QACD,4FAA4F;QAC5F,yFAAyF;QACzF,2FAA2F;QAC3F,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,OAAuB,CAAC,CAAC;QAC9E,sFAAsF;QACtF,sDAAsD;QACtD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,wBAAwB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrD,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,YAAY,EAAE,CAAC;IACnD,CAAC;IAEO,cAAc;QACpB,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAC5B,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;sHA3FU,4BAA4B;6DAA5B,4BAA4B;;iFAA5B,4BAA4B;cANxC,SAAS;6BACI,IAAI,YACN,0BAA0B,YAC1B,EAAE;;kBAeX,KAAK;mBAAC,EAAE,QAAQ,EAAE,IAAI,EAAE;;kBAkBxB,KAAK;;kBAeL,KAAK;;kFA7CK,4BAA4B","sourcesContent":["import { Component, ComponentRef, Input, OnDestroy, OnInit, Type, ViewContainerRef, inject } from '@angular/core';\nimport type { MediaPlacement } from '@memberjunction/ai-realtime-client/media';\nimport { BaseRealtimeChannelClient } from '@memberjunction/realtime-runtime';\n\n/**\n * Generic host for an interactive channel's surface on the call overlay's stage. Given the per-session channel\n * {@link Plugin}, it:\n *\n *  1. dynamically creates the plugin's surface component\n *     ({@link BaseRealtimeChannelClient.GetSurfaceComponent}) into its own view container;\n *  2. immediately hands the created instance to\n *     {@link BaseRealtimeChannelClient.BindSurface} — synchronously, BEFORE the surface's\n *     first change detection, so inputs the plugin sets are visible in its `ngOnInit`;\n *  3. tells the plugin whether the surface is on screen\n *     ({@link BaseRealtimeChannelClient.OnSurfaceVisibilityChange}) and where it is placed\n *     ({@link BaseRealtimeChannelClient.OnSurfacePlacementChange}) right after binding and whenever\n *     {@link Visible} or {@link Placement} changes;\n *  4. notifies {@link BaseRealtimeChannelClient.UnbindSurface} when the pane is destroyed\n *     (the channel left the session / the overlay was torn down) or handed another plugin,\n *     flipping the plugin back into its no-surface tool-execution mode.\n *\n * This is how channel surfaces render with ZERO channel-specific wiring in the overlay:\n * the host never knows the surface component's type or API — the plugin wires its own\n * inputs/outputs in `BindSurface`.\n *\n * The created component is inserted as a SIBLING of this host element (standard\n * `ViewContainerRef` semantics), so it participates directly in its container's layout;\n * the host element itself renders nothing (`display: none`).\n */\n@Component({\n  standalone: true,\n  selector: 'mj-realtime-channel-pane',\n  template: '',\n  styles: [':host { display: none; }']\n})\nexport class RealtimeChannelPaneComponent implements OnInit, OnDestroy {\n  private viewContainer = inject(ViewContainerRef);\n  private surfaceRef: ComponentRef<object> | null = null;\n  private plugin!: BaseRealtimeChannelClient;\n  private initialized = false;\n  private visible = true;\n  private placement: MediaPlacement = 'tab';\n\n  /**\n   * The per-session channel plugin whose surface this pane hosts. Handing the pane another plugin (the same channel\n   * in a new session) releases the old plugin's surface and creates the new one's.\n   */\n  @Input({ required: true })\n  set Plugin(value: BaseRealtimeChannelClient) {\n    if (value === this.plugin) {\n      return;\n    }\n    if (this.initialized) {\n      this.releaseSurface();\n    }\n    this.plugin = value;\n    if (this.initialized) {\n      this.createSurface();\n    }\n  }\n  get Plugin(): BaseRealtimeChannelClient {\n    return this.plugin;\n  }\n\n  /** Whether the surface is on screen. The plugin hears of every change while its surface is bound. */\n  @Input()\n  set Visible(value: boolean) {\n    if (value === this.visible) {\n      return;\n    }\n    this.visible = value;\n    if (this.surfaceRef) {\n      this.plugin.OnSurfaceVisibilityChange(value);\n    }\n  }\n  get Visible(): boolean {\n    return this.visible;\n  }\n\n  /** Where the surface is placed. The plugin hears of every move while its surface is bound. */\n  @Input()\n  set Placement(value: MediaPlacement) {\n    if (value === this.placement) {\n      return;\n    }\n    this.placement = value;\n    if (this.surfaceRef) {\n      this.plugin.OnSurfacePlacementChange(value);\n    }\n  }\n  get Placement(): MediaPlacement {\n    return this.placement;\n  }\n\n  ngOnInit(): void {\n    this.initialized = true;\n    this.createSurface();\n  }\n\n  ngOnDestroy(): void {\n    this.releaseSurface();\n  }\n\n  private createSurface(): void {\n    // Server-only channels have no surface (GetSurfaceComponent === null). The overlay should not\n    // register a pane for them, but guard here too so a stray registration never crashes the panel.\n    const surface = this.plugin.GetSurfaceComponent();\n    if (!surface) {\n      return;\n    }\n    // The runtime carries the surface as an opaque component class — it has no business knowing\n    // what a component is in any given framework. This is the single point that does, so the\n    // Angular narrowing belongs here rather than as a structural claim in the shared contract.\n    this.surfaceRef = this.viewContainer.createComponent(surface as Type<object>);\n    // Bind BEFORE the created component's first change detection — inputs the plugin sets\n    // here are in place when the surface's ngOnInit runs.\n    this.plugin.BindSurface(this.surfaceRef.instance);\n    this.plugin.OnSurfaceVisibilityChange(this.visible);\n    this.plugin.OnSurfacePlacementChange(this.placement);\n    this.surfaceRef.changeDetectorRef.markForCheck();\n  }\n\n  private releaseSurface(): void {\n    this.plugin.UnbindSurface();\n    this.surfaceRef?.destroy();\n    this.surfaceRef = null;\n  }\n}\n"]}

package/dist/lib/components/realtime/identity-verification/identity-verification-channel.d.ts

@@ -0,0 +1,71 @@
+import type { Type } from '@angular/core';
+import type { JSONObject } from '@memberjunction/ai';
+import { type RealtimeChannelActor, type RealtimeChannelDescriptor } from '@memberjunction/ai-core-plus';
+import { GraphQLDataProvider, GraphQLRealtimeSessionClient } from '@memberjunction/graphql-dataprovider';
+import { BaseRealtimeChannelClient, type ChannelOnboardingDetails, type RealtimeChannelVerbResult } from '@memberjunction/realtime-runtime';
+import { IdentityVerificationModel } from './identity-verification-model';
+import { IdentityVerificationSurfaceComponent } from './identity-verification-surface.component';
+/** The registry key (`MJ: AI Agent Channels` → `ClientPluginClass`) and the channel's name. */
+export declare const IDENTITY_VERIFICATION_CHANNEL_NAME = "IdentityVerification";
+/** The verbs, by name — the vocabulary the agent, the surface and the tests share. */
+export declare const IDENTITY_VERIFICATION_VERBS: {
+    readonly Fill: "fill";
+    readonly Confirm: "confirm";
+    readonly Submit: "submit";
+    readonly Resend: "resend";
+    readonly EnterCode: "enter_code";
+};
+/**
+ * IDENTITY VERIFICATION as a generic, opt-in interactive channel: the way an agent helps a person —
+ * typically an anonymous visitor — prove they control an email address without leaving the call.
+ *
+ * What it models: three nouns (name, email, status), five verbs. The agent can `fill` what it heard, but
+ * only the USER can `confirm` it (enforced twice: `InvokableBy: 'user'`, which the runtime checks before
+ * dispatch, and again inside the verb). `submit` then asks the server to email a one-time code and link;
+ * `enter_code` hands the typed code back; `resend` asks for a fresh one. The channel never decides whether
+ * a person IS verified — the server's `identity.verified` session event does, and the channel follows it.
+ *
+ * The server half is a thin plugin that validates nothing beyond scope (see `IdentityVerificationChannelServer`);
+ * the real checks — domain policy, rate limits, hashing, expiry — live in the verification service.
+ *
+ * Opt in per agent or app with `channels.config.IdentityVerification`; open it from the host with
+ * `openChannel('IdentityVerification', { name, email })` or let the agent open it on demand.
+ */
+export declare class IdentityVerificationChannel extends BaseRealtimeChannelClient<IdentityVerificationSurfaceComponent> {
+    /** The state machine. Public so the surface and tests share the one instance. */
+    readonly Model: IdentityVerificationModel;
+    private surface;
+    private eventsSub;
+    get ChannelName(): string;
+    get TabTitle(): string;
+    get TabIcon(): string;
+    /** Clock hook for tests. */
+    protected now(): number;
+    GetDescriptor(): RealtimeChannelDescriptor;
+    GetState(): JSONObject;
+    GetSurfaceComponent(): Type<IdentityVerificationSurfaceComponent>;
+    GetOnboardingDetails(): ChannelOnboardingDetails;
+    protected OnInitialize(): void;
+    protected OnOpen(inputs: JSONObject): void;
+    BindSurface(instance: IdentityVerificationSurfaceComponent): void;
+    UnbindSurface(): void;
+    /** Runs one verb. The runtime already validated the call against the descriptor; confirm is guarded again here. */
+    ApplyVerb(verb: string, args: JSONObject, actor: RealtimeChannelActor, _instanceId?: string): Promise<RealtimeChannelVerbResult>;
+    Dispose(): void;
+    /** Records every change (events immediately, one coalesced note to the model) and completes on verification. */
+    private onModelChange;
+    /**
+     * The server calls, riding the session's own provider and live session id. `null` when the session has
+     * no GraphQL provider — the channel then refuses to send rather than pretending.
+     */
+    private createService;
+    private withClient;
+    /** Builds the transport; protected so a test (or a host on another transport) can substitute it. */
+    protected createVerificationClient(provider: GraphQLDataProvider): GraphQLRealtimeSessionClient;
+}
+/**
+ * Tree-shaking prevention: the channel is resolved through the ClassFactory by the registry row's
+ * `ClientPluginClass` key, so this static call keeps its `@RegisterClass` side effect alive.
+ */
+export declare function LoadIdentityVerificationChannel(): void;
+//# sourceMappingURL=identity-verification-channel.d.ts.map

package/dist/lib/components/realtime/identity-verification/identity-verification-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-verification-channel.d.ts","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/identity-verification/identity-verification-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAG1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC/B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AACzG,OAAO,EACL,yBAAyB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC/B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,yBAAyB,EAAqE,MAAM,+BAA+B,CAAC;AAC7I,OAAO,EAAE,oCAAoC,EAAE,MAAM,2CAA2C,CAAC;AAEjG,+FAA+F;AAC/F,eAAO,MAAM,kCAAkC,yBAAyB,CAAC;AAEzE,sFAAsF;AACtF,eAAO,MAAM,2BAA2B;;;;;;CAM9B,CAAC;AAIX;;;;;;;;;;;;;;;GAeG;AACH,qBACa,2BAA4B,SAAQ,yBAAyB,CAAC,oCAAoC,CAAC;IAC9G,iFAAiF;IACjF,SAAgB,KAAK,EAAE,yBAAyB,CAAyE;IAEzH,OAAO,CAAC,OAAO,CAAqD;IACpE,OAAO,CAAC,SAAS,CAA6B;IAE9C,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,IAAoB,QAAQ,IAAI,MAAM,CAErC;IAED,IAAoB,OAAO,IAAI,MAAM,CAEpC;IAED,4BAA4B;IAC5B,SAAS,CAAC,GAAG,IAAI,MAAM;IAIP,aAAa,IAAI,yBAAyB;IAoG1C,QAAQ,IAAI,UAAU;IAItB,mBAAmB,IAAI,IAAI,CAAC,oCAAoC,CAAC;IAIjE,oBAAoB,IAAI,wBAAwB;cAU7C,YAAY,IAAI,IAAI;cASpB,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAI5C,WAAW,CAAC,QAAQ,EAAE,oCAAoC,GAAG,IAAI;IAOxD,aAAa,IAAI,IAAI;IAIrC,mHAAmH;IAC7F,SAAS,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,oBAAoB,EAC3B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,yBAAyB,CAAC;IAiBrB,OAAO,IAAI,IAAI;IAQ/B,gHAAgH;IAChH,OAAO,CAAC,aAAa;IAWrB;;;OAGG;IACH,OAAO,CAAC,aAAa;YAOP,UAAU;IAWxB,oGAAoG;IACpG,SAAS,CAAC,wBAAwB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,4BAA4B;CAGhG;AASD;;;GAGG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD"}

package/dist/lib/components/realtime/identity-verification/identity-verification-channel.js

@@ -0,0 +1,259 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { RegisterClass } from '@memberjunction/global';
+import { IsIdentityVerifiedEventPayload, REALTIME_CHANNEL_CONTRACT_VERSION } from '@memberjunction/ai-core-plus';
+import { GraphQLRealtimeSessionClient } from '@memberjunction/graphql-dataprovider';
+import { BaseRealtimeChannelClient } from '@memberjunction/realtime-runtime';
+import { IdentityVerificationModel } from './identity-verification-model';
+import { IdentityVerificationSurfaceComponent } from './identity-verification-surface.component';
+/** The registry key (`MJ: AI Agent Channels` → `ClientPluginClass`) and the channel's name. */
+export const IDENTITY_VERIFICATION_CHANNEL_NAME = 'IdentityVerification';
+/** The verbs, by name — the vocabulary the agent, the surface and the tests share. */
+export const IDENTITY_VERIFICATION_VERBS = {
+    Fill: 'fill',
+    Confirm: 'confirm',
+    Submit: 'submit',
+    Resend: 'resend',
+    EnterCode: 'enter_code'
+};
+const FIELD_PARAM = { type: 'string', enum: ['name', 'email'], description: 'Which detail: "name" or "email".' };
+/**
+ * IDENTITY VERIFICATION as a generic, opt-in interactive channel: the way an agent helps a person —
+ * typically an anonymous visitor — prove they control an email address without leaving the call.
+ *
+ * What it models: three nouns (name, email, status), five verbs. The agent can `fill` what it heard, but
+ * only the USER can `confirm` it (enforced twice: `InvokableBy: 'user'`, which the runtime checks before
+ * dispatch, and again inside the verb). `submit` then asks the server to email a one-time code and link;
+ * `enter_code` hands the typed code back; `resend` asks for a fresh one. The channel never decides whether
+ * a person IS verified — the server's `identity.verified` session event does, and the channel follows it.
+ *
+ * The server half is a thin plugin that validates nothing beyond scope (see `IdentityVerificationChannelServer`);
+ * the real checks — domain policy, rate limits, hashing, expiry — live in the verification service.
+ *
+ * Opt in per agent or app with `channels.config.IdentityVerification`; open it from the host with
+ * `openChannel('IdentityVerification', { name, email })` or let the agent open it on demand.
+ */
+let IdentityVerificationChannel = class IdentityVerificationChannel extends BaseRealtimeChannelClient {
+    /** The state machine. Public so the surface and tests share the one instance. */
+    Model = new IdentityVerificationModel(this.createService(), () => this.now());
+    surface = null;
+    eventsSub = null;
+    get ChannelName() {
+        return IDENTITY_VERIFICATION_CHANNEL_NAME;
+    }
+    get TabTitle() {
+        return 'Verify your identity';
+    }
+    get TabIcon() {
+        return 'fa-solid fa-user-shield';
+    }
+    /** Clock hook for tests. */
+    now() {
+        return Date.now();
+    }
+    GetDescriptor() {
+        return {
+            Key: this.ChannelName,
+            Version: REALTIME_CHANNEL_CONTRACT_VERSION,
+            DisplayName: 'Identity verification',
+            OwningPackage: '@memberjunction/ng-conversations',
+            Instructions: 'Helps the user prove who they are by email, during this call. Ask for their name and email, `fill` what you hear, ' +
+                'then ask the user to check the form and press Confirm — only they can confirm, so never claim you did. ' +
+                'Once both are confirmed, `submit` emails them a code and a link. They can type the code in themselves, or you can ' +
+                '`enter_code` if they read it to you; or they can open the link, which completes it on its own. ' +
+                'Never repeat a code or an email back unprompted. Check `status`: it becomes "verified" when the server confirms it — ' +
+                'do not treat the person as verified before that.',
+            Nouns: [
+                { Name: 'name', Description: "The person's name, as entered.", Schema: { type: 'string' } },
+                { Name: 'email', Description: "The person's email address, as entered.", Schema: { type: 'string' } },
+                {
+                    Name: 'status',
+                    Description: 'Where verification stands: collecting (getting details, or ready to send), sending, code_sent, verifying, verified.',
+                    Schema: { type: 'string', enum: ['collecting', 'sending', 'code_sent', 'verifying', 'verified'] }
+                },
+                {
+                    Name: 'confirmed',
+                    Description: 'Whether the USER has confirmed each detail. Only confirmed details can be sent.',
+                    Schema: { type: 'object', properties: { name: { type: 'boolean' }, email: { type: 'boolean' } } }
+                },
+                { Name: 'problem', Description: 'The latest problem in plain words, or empty.', Schema: { type: 'string' } }
+            ],
+            Verbs: [
+                {
+                    Name: IDENTITY_VERIFICATION_VERBS.Fill,
+                    Description: 'Set the name or the email. What you fill is shown to the user marked as suggested until they confirm it.',
+                    ParametersSchema: {
+                        type: 'object',
+                        properties: { field: FIELD_PARAM, value: { type: 'string', description: 'The value to set.', maxLength: 200 } },
+                        required: ['field', 'value'],
+                        additionalProperties: false
+                    },
+                    InvokableBy: 'both'
+                },
+                {
+                    Name: IDENTITY_VERIFICATION_VERBS.Confirm,
+                    Description: 'Confirm the details shown. Only the user can do this.',
+                    ParametersSchema: { type: 'object', properties: { field: FIELD_PARAM }, additionalProperties: false },
+                    InvokableBy: 'user'
+                },
+                {
+                    Name: IDENTITY_VERIFICATION_VERBS.Submit,
+                    Description: 'Email the user a one-time code and link. Needs both details filled and confirmed by the user.',
+                    ParametersSchema: { type: 'object', additionalProperties: false },
+                    InvokableBy: 'both',
+                    Preconditions: ['name and email are filled', 'the user has confirmed both']
+                },
+                {
+                    Name: IDENTITY_VERIFICATION_VERBS.Resend,
+                    Description: 'Email a fresh code to the same address. Only after a code was sent, and subject to a short wait.',
+                    ParametersSchema: { type: 'object', additionalProperties: false },
+                    InvokableBy: 'both',
+                    Preconditions: ['a code was already sent']
+                },
+                {
+                    Name: IDENTITY_VERIFICATION_VERBS.EnterCode,
+                    Description: 'Submit the code the user received (digits as they gave them).',
+                    ParametersSchema: {
+                        type: 'object',
+                        properties: { code: { type: 'string', description: 'The code from the email.', maxLength: 16 } },
+                        required: ['code'],
+                        additionalProperties: false
+                    },
+                    InvokableBy: 'both',
+                    Preconditions: ['a code was sent']
+                }
+            ],
+            Inputs: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'A name the host already knows, to pre-fill (the user still confirms it).' },
+                    email: { type: 'string', description: 'An email the host already knows, to pre-fill (the user still confirms it).' }
+                },
+                additionalProperties: false
+            },
+            Events: [
+                { Name: 'field_filled', Description: 'A detail was filled in, by the agent or the user.' },
+                { Name: 'confirmed', Description: 'The user confirmed one or both details.' },
+                { Name: 'code_sent', Description: 'The server emailed a code and link.' },
+                { Name: 'code_entered', Description: 'A code was submitted for checking (the code itself is never included).' },
+                { Name: 'verified', Description: 'The server confirmed the person is verified.' },
+                { Name: 'error', Description: 'A step failed; the payload carries the error code and the stage.' }
+            ],
+            Output: {
+                type: 'object',
+                properties: { verified: { type: 'boolean' }, email: { type: 'string' }, name: { type: 'string' } },
+                required: ['verified', 'email', 'name']
+            },
+            DisplayPolicy: 'on-demand',
+            DefaultAvailability: 'opt-in',
+            MaxExposure: 'state'
+        };
+    }
+    GetState() {
+        return this.Model.ToState();
+    }
+    GetSurfaceComponent() {
+        return IdentityVerificationSurfaceComponent;
+    }
+    GetOnboardingDetails() {
+        return {
+            Heading: 'Verify your identity',
+            Description: 'Confirm your name and email so we can recognise you. We email you a code and a link; either one completes it.',
+            Tips: ['Check the details the assistant filled in, then press Confirm.', 'You can type the code here, or just open the link in the email.'],
+            IconClass: 'fa-solid fa-user-shield'
+        };
+    }
+    OnInitialize() {
+        this.Model.OnChange((change) => this.onModelChange(change));
+        this.eventsSub = this.Context?.SessionEvents$?.subscribe((event) => {
+            if (event.Type === 'identity.verified' && IsIdentityVerifiedEventPayload(event.Payload)) {
+                this.Model.MarkVerified(event.Payload);
+            }
+        }) ?? null;
+    }
+    OnOpen(inputs) {
+        this.Model.Seed(inputs);
+    }
+    BindSurface(instance) {
+        this.surface = instance;
+        instance.Model = this.Model;
+        instance.AgentName = this.Context?.AgentName ?? 'The assistant';
+        instance.Dispatch = (verb, args) => this.ApplyVerb(verb, args, 'user');
+    }
+    UnbindSurface() {
+        this.surface = null;
+    }
+    /** Runs one verb. The runtime already validated the call against the descriptor; confirm is guarded again here. */
+    async ApplyVerb(verb, args, actor, _instanceId) {
+        switch (verb) {
+            case IDENTITY_VERIFICATION_VERBS.Fill:
+                return this.Model.Fill(args, actor);
+            case IDENTITY_VERIFICATION_VERBS.Confirm:
+                return this.Model.Confirm(args, actor);
+            case IDENTITY_VERIFICATION_VERBS.Submit:
+                return this.Model.Submit();
+            case IDENTITY_VERIFICATION_VERBS.Resend:
+                return this.Model.Resend();
+            case IDENTITY_VERIFICATION_VERBS.EnterCode:
+                return this.Model.EnterCode(args);
+            default:
+                return { Success: false, ErrorCode: 'unknown_verb', Error: `${this.ChannelName} has no verb "${verb}".` };
+        }
+    }
+    Dispose() {
+        this.eventsSub?.unsubscribe();
+        this.eventsSub = null;
+        this.Model.OnChange(null);
+        this.surface = null;
+        super.Dispose();
+    }
+    /** Records every change (events immediately, one coalesced note to the model) and completes on verification. */
+    onModelChange(change) {
+        if (change.Event) {
+            this.EmitChannelEvent(change.Event.Name, change.Event.Payload);
+        }
+        this.RecordChange({ Author: change.Author });
+        if (change.Event?.Name === 'verified') {
+            const view = this.Model.View;
+            this.Complete({ verified: true, email: view.Email.Value, name: view.Name.Value });
+        }
+    }
+    /**
+     * The server calls, riding the session's own provider and live session id. `null` when the session has
+     * no GraphQL provider — the channel then refuses to send rather than pretending.
+     */
+    createService() {
+        return {
+            Request: (input) => this.withClient((client, id) => client.RequestVerification({ AgentSessionID: id, Name: input.Name, Email: input.Email })),
+            SubmitCode: (code) => this.withClient((client, id) => client.SubmitVerificationCode({ AgentSessionID: id, Code: code }))
+        };
+    }
+    async withClient(run) {
+        const provider = this.Context?.Provider;
+        const sessionId = this.Context?.AgentSessionID ?? null;
+        if (!provider || !sessionId) {
+            return { Success: false, VerificationState: 'unverified', ErrorCode: 'session_not_found' };
+        }
+        return run(this.createVerificationClient(provider), sessionId);
+    }
+    /** Builds the transport; protected so a test (or a host on another transport) can substitute it. */
+    createVerificationClient(provider) {
+        return new GraphQLRealtimeSessionClient(provider);
+    }
+};
+IdentityVerificationChannel = __decorate([
+    RegisterClass(BaseRealtimeChannelClient, 'IdentityVerificationChannel')
+], IdentityVerificationChannel);
+export { IdentityVerificationChannel };
+/**
+ * Tree-shaking prevention: the channel is resolved through the ClassFactory by the registry row's
+ * `ClientPluginClass` key, so this static call keeps its `@RegisterClass` side effect alive.
+ */
+export function LoadIdentityVerificationChannel() {
+    // intentional no-op — the import side effect performs the registration
+}
+//# sourceMappingURL=identity-verification-channel.js.map

package/dist/lib/components/realtime/identity-verification/identity-verification-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-verification-channel.js","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/identity-verification/identity-verification-channel.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Type } from '@angular/core';\nimport type { Subscription } from 'rxjs';\nimport { RegisterClass } from '@memberjunction/global';\nimport type { JSONObject } from '@memberjunction/ai';\nimport {\n  IsIdentityVerifiedEventPayload,\n  REALTIME_CHANNEL_CONTRACT_VERSION,\n  type RealtimeChannelActor,\n  type RealtimeChannelDescriptor\n} from '@memberjunction/ai-core-plus';\nimport { GraphQLDataProvider, GraphQLRealtimeSessionClient } from '@memberjunction/graphql-dataprovider';\nimport {\n  BaseRealtimeChannelClient,\n  type ChannelOnboardingDetails,\n  type RealtimeChannelVerbResult\n} from '@memberjunction/realtime-runtime';\nimport { IdentityVerificationModel, type IdentityVerificationChange, type IdentityVerificationService } from './identity-verification-model';\nimport { IdentityVerificationSurfaceComponent } from './identity-verification-surface.component';\n\n/** The registry key (`MJ: AI Agent Channels` → `ClientPluginClass`) and the channel's name. */\nexport const IDENTITY_VERIFICATION_CHANNEL_NAME = 'IdentityVerification';\n\n/** The verbs, by name — the vocabulary the agent, the surface and the tests share. */\nexport const IDENTITY_VERIFICATION_VERBS = {\n  Fill: 'fill',\n  Confirm: 'confirm',\n  Submit: 'submit',\n  Resend: 'resend',\n  EnterCode: 'enter_code'\n} as const;\n\nconst FIELD_PARAM = { type: 'string', enum: ['name', 'email'], description: 'Which detail: \"name\" or \"email\".' };\n\n/**\n * IDENTITY VERIFICATION as a generic, opt-in interactive channel: the way an agent helps a person —\n * typically an anonymous visitor — prove they control an email address without leaving the call.\n *\n * What it models: three nouns (name, email, status), five verbs. The agent can `fill` what it heard, but\n * only the USER can `confirm` it (enforced twice: `InvokableBy: 'user'`, which the runtime checks before\n * dispatch, and again inside the verb). `submit` then asks the server to email a one-time code and link;\n * `enter_code` hands the typed code back; `resend` asks for a fresh one. The channel never decides whether\n * a person IS verified — the server's `identity.verified` session event does, and the channel follows it.\n *\n * The server half is a thin plugin that validates nothing beyond scope (see `IdentityVerificationChannelServer`);\n * the real checks — domain policy, rate limits, hashing, expiry — live in the verification service.\n *\n * Opt in per agent or app with `channels.config.IdentityVerification`; open it from the host with\n * `openChannel('IdentityVerification', { name, email })` or let the agent open it on demand.\n */\n@RegisterClass(BaseRealtimeChannelClient, 'IdentityVerificationChannel')\nexport class IdentityVerificationChannel extends BaseRealtimeChannelClient<IdentityVerificationSurfaceComponent> {\n  /** The state machine. Public so the surface and tests share the one instance. */\n  public readonly Model: IdentityVerificationModel = new IdentityVerificationModel(this.createService(), () => this.now());\n\n  private surface: IdentityVerificationSurfaceComponent | null = null;\n  private eventsSub: Subscription | null = null;\n\n  public get ChannelName(): string {\n    return IDENTITY_VERIFICATION_CHANNEL_NAME;\n  }\n\n  public override get TabTitle(): string {\n    return 'Verify your identity';\n  }\n\n  public override get TabIcon(): string {\n    return 'fa-solid fa-user-shield';\n  }\n\n  /** Clock hook for tests. */\n  protected now(): number {\n    return Date.now();\n  }\n\n  public override GetDescriptor(): RealtimeChannelDescriptor {\n    return {\n      Key: this.ChannelName,\n      Version: REALTIME_CHANNEL_CONTRACT_VERSION,\n      DisplayName: 'Identity verification',\n      OwningPackage: '@memberjunction/ng-conversations',\n      Instructions:\n        'Helps the user prove who they are by email, during this call. Ask for their name and email, `fill` what you hear, ' +\n        'then ask the user to check the form and press Confirm — only they can confirm, so never claim you did. ' +\n        'Once both are confirmed, `submit` emails them a code and a link. They can type the code in themselves, or you can ' +\n        '`enter_code` if they read it to you; or they can open the link, which completes it on its own. ' +\n        'Never repeat a code or an email back unprompted. Check `status`: it becomes \"verified\" when the server confirms it — ' +\n        'do not treat the person as verified before that.',\n      Nouns: [\n        { Name: 'name', Description: \"The person's name, as entered.\", Schema: { type: 'string' } },\n        { Name: 'email', Description: \"The person's email address, as entered.\", Schema: { type: 'string' } },\n        {\n          Name: 'status',\n          Description: 'Where verification stands: collecting (getting details, or ready to send), sending, code_sent, verifying, verified.',\n          Schema: { type: 'string', enum: ['collecting', 'sending', 'code_sent', 'verifying', 'verified'] }\n        },\n        {\n          Name: 'confirmed',\n          Description: 'Whether the USER has confirmed each detail. Only confirmed details can be sent.',\n          Schema: { type: 'object', properties: { name: { type: 'boolean' }, email: { type: 'boolean' } } }\n        },\n        { Name: 'problem', Description: 'The latest problem in plain words, or empty.', Schema: { type: 'string' } }\n      ],\n      Verbs: [\n        {\n          Name: IDENTITY_VERIFICATION_VERBS.Fill,\n          Description: 'Set the name or the email. What you fill is shown to the user marked as suggested until they confirm it.',\n          ParametersSchema: {\n            type: 'object',\n            properties: { field: FIELD_PARAM, value: { type: 'string', description: 'The value to set.', maxLength: 200 } },\n            required: ['field', 'value'],\n            additionalProperties: false\n          },\n          InvokableBy: 'both'\n        },\n        {\n          Name: IDENTITY_VERIFICATION_VERBS.Confirm,\n          Description: 'Confirm the details shown. Only the user can do this.',\n          ParametersSchema: { type: 'object', properties: { field: FIELD_PARAM }, additionalProperties: false },\n          InvokableBy: 'user'\n        },\n        {\n          Name: IDENTITY_VERIFICATION_VERBS.Submit,\n          Description: 'Email the user a one-time code and link. Needs both details filled and confirmed by the user.',\n          ParametersSchema: { type: 'object', additionalProperties: false },\n          InvokableBy: 'both',\n          Preconditions: ['name and email are filled', 'the user has confirmed both']\n        },\n        {\n          Name: IDENTITY_VERIFICATION_VERBS.Resend,\n          Description: 'Email a fresh code to the same address. Only after a code was sent, and subject to a short wait.',\n          ParametersSchema: { type: 'object', additionalProperties: false },\n          InvokableBy: 'both',\n          Preconditions: ['a code was already sent']\n        },\n        {\n          Name: IDENTITY_VERIFICATION_VERBS.EnterCode,\n          Description: 'Submit the code the user received (digits as they gave them).',\n          ParametersSchema: {\n            type: 'object',\n            properties: { code: { type: 'string', description: 'The code from the email.', maxLength: 16 } },\n            required: ['code'],\n            additionalProperties: false\n          },\n          InvokableBy: 'both',\n          Preconditions: ['a code was sent']\n        }\n      ],\n      Inputs: {\n        type: 'object',\n        properties: {\n          name: { type: 'string', description: 'A name the host already knows, to pre-fill (the user still confirms it).' },\n          email: { type: 'string', description: 'An email the host already knows, to pre-fill (the user still confirms it).' }\n        },\n        additionalProperties: false\n      },\n      Events: [\n        { Name: 'field_filled', Description: 'A detail was filled in, by the agent or the user.' },\n        { Name: 'confirmed', Description: 'The user confirmed one or both details.' },\n        { Name: 'code_sent', Description: 'The server emailed a code and link.' },\n        { Name: 'code_entered', Description: 'A code was submitted for checking (the code itself is never included).' },\n        { Name: 'verified', Description: 'The server confirmed the person is verified.' },\n        { Name: 'error', Description: 'A step failed; the payload carries the error code and the stage.' }\n      ],\n      Output: {\n        type: 'object',\n        properties: { verified: { type: 'boolean' }, email: { type: 'string' }, name: { type: 'string' } },\n        required: ['verified', 'email', 'name']\n      },\n      DisplayPolicy: 'on-demand',\n      DefaultAvailability: 'opt-in',\n      MaxExposure: 'state'\n    };\n  }\n\n  public override GetState(): JSONObject {\n    return this.Model.ToState();\n  }\n\n  public override GetSurfaceComponent(): Type<IdentityVerificationSurfaceComponent> {\n    return IdentityVerificationSurfaceComponent;\n  }\n\n  public override GetOnboardingDetails(): ChannelOnboardingDetails {\n    return {\n      Heading: 'Verify your identity',\n      Description:\n        'Confirm your name and email so we can recognise you. We email you a code and a link; either one completes it.',\n      Tips: ['Check the details the assistant filled in, then press Confirm.', 'You can type the code here, or just open the link in the email.'],\n      IconClass: 'fa-solid fa-user-shield'\n    };\n  }\n\n  protected override OnInitialize(): void {\n    this.Model.OnChange((change) => this.onModelChange(change));\n    this.eventsSub = this.Context?.SessionEvents$?.subscribe((event) => {\n      if (event.Type === 'identity.verified' && IsIdentityVerifiedEventPayload(event.Payload)) {\n        this.Model.MarkVerified(event.Payload);\n      }\n    }) ?? null;\n  }\n\n  protected override OnOpen(inputs: JSONObject): void {\n    this.Model.Seed(inputs);\n  }\n\n  public BindSurface(instance: IdentityVerificationSurfaceComponent): void {\n    this.surface = instance;\n    instance.Model = this.Model;\n    instance.AgentName = this.Context?.AgentName ?? 'The assistant';\n    instance.Dispatch = (verb, args) => this.ApplyVerb(verb, args, 'user');\n  }\n\n  public override UnbindSurface(): void {\n    this.surface = null;\n  }\n\n  /** Runs one verb. The runtime already validated the call against the descriptor; confirm is guarded again here. */\n  public override async ApplyVerb(\n    verb: string,\n    args: JSONObject,\n    actor: RealtimeChannelActor,\n    _instanceId?: string\n  ): Promise<RealtimeChannelVerbResult> {\n    switch (verb) {\n      case IDENTITY_VERIFICATION_VERBS.Fill:\n        return this.Model.Fill(args, actor);\n      case IDENTITY_VERIFICATION_VERBS.Confirm:\n        return this.Model.Confirm(args, actor);\n      case IDENTITY_VERIFICATION_VERBS.Submit:\n        return this.Model.Submit();\n      case IDENTITY_VERIFICATION_VERBS.Resend:\n        return this.Model.Resend();\n      case IDENTITY_VERIFICATION_VERBS.EnterCode:\n        return this.Model.EnterCode(args);\n      default:\n        return { Success: false, ErrorCode: 'unknown_verb', Error: `${this.ChannelName} has no verb \"${verb}\".` };\n    }\n  }\n\n  public override Dispose(): void {\n    this.eventsSub?.unsubscribe();\n    this.eventsSub = null;\n    this.Model.OnChange(null);\n    this.surface = null;\n    super.Dispose();\n  }\n\n  /** Records every change (events immediately, one coalesced note to the model) and completes on verification. */\n  private onModelChange(change: IdentityVerificationChange): void {\n    if (change.Event) {\n      this.EmitChannelEvent(change.Event.Name, change.Event.Payload);\n    }\n    this.RecordChange({ Author: change.Author });\n    if (change.Event?.Name === 'verified') {\n      const view = this.Model.View;\n      this.Complete({ verified: true, email: view.Email.Value, name: view.Name.Value });\n    }\n  }\n\n  /**\n   * The server calls, riding the session's own provider and live session id. `null` when the session has\n   * no GraphQL provider — the channel then refuses to send rather than pretending.\n   */\n  private createService(): IdentityVerificationService | null {\n    return {\n      Request: (input) => this.withClient((client, id) => client.RequestVerification({ AgentSessionID: id, Name: input.Name, Email: input.Email })),\n      SubmitCode: (code) => this.withClient((client, id) => client.SubmitVerificationCode({ AgentSessionID: id, Code: code }))\n    };\n  }\n\n  private async withClient<T extends { Success: boolean }>(\n    run: (client: GraphQLRealtimeSessionClient, agentSessionId: string) => Promise<T>\n  ): Promise<T | NoSessionResult> {\n    const provider = this.Context?.Provider as GraphQLDataProvider | null | undefined;\n    const sessionId = this.Context?.AgentSessionID ?? null;\n    if (!provider || !sessionId) {\n      return { Success: false, VerificationState: 'unverified', ErrorCode: 'session_not_found' };\n    }\n    return run(this.createVerificationClient(provider), sessionId);\n  }\n\n  /** Builds the transport; protected so a test (or a host on another transport) can substitute it. */\n  protected createVerificationClient(provider: GraphQLDataProvider): GraphQLRealtimeSessionClient {\n    return new GraphQLRealtimeSessionClient(provider);\n  }\n}\n\n/** The shape returned when there is no live session to talk to (mirrors the client's own failure results). */\ninterface NoSessionResult {\n  Success: false;\n  VerificationState: 'unverified';\n  ErrorCode: 'session_not_found';\n}\n\n/**\n * Tree-shaking prevention: the channel is resolved through the ClassFactory by the registry row's\n * `ClientPluginClass` key, so this static call keeps its `@RegisterClass` side effect alive.\n */\nexport function LoadIdentityVerificationChannel(): void {\n  // intentional no-op — the import side effect performs the registration\n}\n"]}