@gcm-cz/dmon-switcher 0.1.0

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function h(s){if(typeof s!="object"||s===null)return!1;const i=s;return!(i.dmon_bridge!==!0||typeof i.type!="string")}function d(s){return typeof s.request_id=="string"}class l{constructor(i){this.iframe=null,this.nextRequestId=1,this.destroyed=!1,this.failed=!1,this.pending=new Map,this.switchListeners=[],this.readyListeners=[],this.handleMessage=e=>{if(this.iframe==null||!h(e.data))return;if(e.source!==this.iframe.contentWindow){this.log("message dropped: wrong source",{eventOrigin:e.origin,expectedOrigin:this.origin,hasSource:e.source!=null,sourceIsExpectedIframe:!1});return}if(e.origin!==this.origin){this.log("message dropped: wrong origin",{eventOrigin:e.origin,expectedOrigin:this.origin});return}const t=e.data;if(t.type==="ready"){this.log("ready received"),this.resolveReady();for(const o of this.readyListeners)try{o()}catch(n){this.logError("ready handler threw",n)}return}if(!d(t)){this.log("message dropped: no request_id");return}const r=this.pending.get(t.request_id);r!==void 0?(this.log("rpc reply",{request_id:t.request_id,type:t.type}),this.pending.delete(t.request_id),r.resolve(t)):this.log("rpc reply for unknown request_id — ignored",{request_id:t.request_id})},this.origin=i.dmonOrigin,this.mode=i.mode??"emit",this.debug=i.debug??!1,this.readyPromise=new Promise(e=>{this.resolveReady=e});try{const e=`${i.dmonOrigin}/api/v1/authorize/${i.realmSlug}/embed/bridge?client_id=${encodeURIComponent(i.clientId)}`,t=document.createElement("iframe");t.setAttribute("aria-hidden","true"),t.setAttribute("sandbox","allow-scripts allow-same-origin"),t.style.display="none",t.src=e,document.body.appendChild(t),this.iframe=t,window.addEventListener("message",this.handleMessage),this.log("constructed",{origin:this.origin,mode:this.mode,src:e})}catch(e){this.failed=!0,this.resolveReady(),this.logError("construction failed — switcher disabled",e)}}ready(){return this.readyPromise}async listSessions(){if(this.failed||this.destroyed||this.iframe==null)return this.log("listSessions skipped — switcher unavailable"),[];try{const e=(await this.rpc({type:"list_sessions"})).sessions;return Array.isArray(e)?(this.log("listSessions resolved",{count:e.length}),e):(this.log("listSessions resolved with no sessions array"),[])}catch(i){return this.logError("listSessions failed — returning empty list",i),[]}}async switchTo(i,e){if(this.failed||this.destroyed||this.iframe==null){this.log("switchTo skipped — switcher unavailable",{sub:i});return}try{if(this.mode==="emit"){this.log("switchTo emit",{sub:i,listeners:this.switchListeners.length}),this.emitSwitch(i);return}const t=i==="__new__"?"login":"none",r=e?.returnTo??window.location.href;this.log("switchTo redirect",{sub:i,prompt:t,return_to:r}),await this.rpc({type:"redirect_authorize",login_hint:i,prompt:t,return_to:r})}catch(t){this.logError("switchTo failed",t)}}accountPageUrl(i){const e=`${this.origin}/account?login_hint=${encodeURIComponent(i)}`;return this.log("accountPageUrl",{sub:i,url:e}),e}destroy(){if(this.destroyed){this.log("destroy called again — no-op");return}this.destroyed=!0;try{window.removeEventListener("message",this.handleMessage);const i=new DOMException("DmonSwitcher destroyed","AbortError");this.log("destroy",{rejectingPending:this.pending.size}),this.pending.forEach(({reject:e})=>e(i)),this.pending.clear(),this.iframe?.remove(),this.resolveReady()}catch(i){this.logError("destroy encountered an error",i)}}on(i,e){i==="switch"?this.switchListeners.push(e):this.readyListeners.push(e)}log(i,e){this.debug&&(e===void 0?console.debug(`[DmonSwitcher] ${i}`):console.debug(`[DmonSwitcher] ${i}`,e))}logError(i,e){e===void 0?console.error(`[DmonSwitcher] ${i}`):console.error(`[DmonSwitcher] ${i}`,e)}emitSwitch(i){for(const e of this.switchListeners)try{e({sub:i})}catch(t){this.logError("switch handler threw",t)}}async rpc(i){if(this.destroyed||this.iframe==null)throw new DOMException("DmonSwitcher destroyed","AbortError");if(await this.readyPromise,this.destroyed||this.iframe==null)throw new DOMException("DmonSwitcher destroyed","AbortError");const e=String(this.nextRequestId++);this.log("rpc send",{request_id:e,...i});const t=this.iframe;return new Promise((r,o)=>{this.pending.set(e,{resolve:r,reject:o}),t.contentWindow?.postMessage({...i,request_id:e},this.origin)})}}exports.DmonSwitcher=l;

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+export interface Session {
+    sub: string;
+    name: string;
+    given_name?: string;
+    family_name?: string;
+    picture?: string;
+}
+export type SwitcherMode = "emit" | "redirect";
+export interface DmonSwitcherOptions {
+    dmonOrigin: string;
+    realmSlug: string;
+    clientId: string;
+    mode?: SwitcherMode;
+    /**
+     * When true, every internal step (construction, ready handshake, RPC send/receive,
+     * dropped messages, switch, account-page open, teardown) is logged via console.debug.
+     * Off by default.
+     */
+    debug?: boolean;
+}
+type SwitchHandler = (payload: {
+    sub: string;
+}) => void;
+type ReadyHandler = () => void;
+export declare class DmonSwitcher {
+    private readonly origin;
+    private readonly mode;
+    private readonly debug;
+    private readonly iframe;
+    private readonly readyPromise;
+    private resolveReady;
+    private nextRequestId;
+    private destroyed;
+    private failed;
+    private readonly pending;
+    private readonly switchListeners;
+    private readonly readyListeners;
+    constructor(opts: DmonSwitcherOptions);
+    ready(): Promise<void>;
+    listSessions(): Promise<Session[]>;
+    switchTo(sub: string, opts?: {
+        returnTo?: string;
+    }): Promise<void>;
+    /**
+     * Build the URL of the DMon account page for the given user, pre-filled with the
+     * `login_hint` so DMon can mount it silently if that user's session is in the cookie.
+     *
+     * This only constructs the string — it never navigates. Put it in an anchor's `href`
+     * so the user can choose how to open it (left click = same tab, middle/ctrl click =
+     * new tab). Pure and side-effect free; safe to call at any time.
+     */
+    accountPageUrl(sub: string): string;
+    destroy(): void;
+    on(event: "switch", handler: SwitchHandler): void;
+    on(event: "ready", handler: ReadyHandler): void;
+    private log;
+    private logError;
+    private emitSwitch;
+    private rpc;
+    private readonly handleMessage;
+}
+export {};

package/dist/index.js

@@ -0,0 +1,149 @@
+function h(s) {
+  if (typeof s != "object" || s === null) return !1;
+  const i = s;
+  return !(i.dmon_bridge !== !0 || typeof i.type != "string");
+}
+function d(s) {
+  return typeof s.request_id == "string";
+}
+class l {
+  constructor(i) {
+    this.iframe = null, this.nextRequestId = 1, this.destroyed = !1, this.failed = !1, this.pending = /* @__PURE__ */ new Map(), this.switchListeners = [], this.readyListeners = [], this.handleMessage = (e) => {
+      if (this.iframe == null || !h(e.data)) return;
+      if (e.source !== this.iframe.contentWindow) {
+        this.log("message dropped: wrong source", {
+          eventOrigin: e.origin,
+          expectedOrigin: this.origin,
+          hasSource: e.source != null,
+          sourceIsExpectedIframe: !1
+        });
+        return;
+      }
+      if (e.origin !== this.origin) {
+        this.log("message dropped: wrong origin", { eventOrigin: e.origin, expectedOrigin: this.origin });
+        return;
+      }
+      const t = e.data;
+      if (t.type === "ready") {
+        this.log("ready received"), this.resolveReady();
+        for (const o of this.readyListeners)
+          try {
+            o();
+          } catch (n) {
+            this.logError("ready handler threw", n);
+          }
+        return;
+      }
+      if (!d(t)) {
+        this.log("message dropped: no request_id");
+        return;
+      }
+      const r = this.pending.get(t.request_id);
+      r !== void 0 ? (this.log("rpc reply", { request_id: t.request_id, type: t.type }), this.pending.delete(t.request_id), r.resolve(t)) : this.log("rpc reply for unknown request_id — ignored", { request_id: t.request_id });
+    }, this.origin = i.dmonOrigin, this.mode = i.mode ?? "emit", this.debug = i.debug ?? !1, this.readyPromise = new Promise((e) => {
+      this.resolveReady = e;
+    });
+    try {
+      const e = `${i.dmonOrigin}/api/v1/authorize/${i.realmSlug}/embed/bridge?client_id=${encodeURIComponent(i.clientId)}`, t = document.createElement("iframe");
+      t.setAttribute("aria-hidden", "true"), t.setAttribute("sandbox", "allow-scripts allow-same-origin"), t.style.display = "none", t.src = e, document.body.appendChild(t), this.iframe = t, window.addEventListener("message", this.handleMessage), this.log("constructed", { origin: this.origin, mode: this.mode, src: e });
+    } catch (e) {
+      this.failed = !0, this.resolveReady(), this.logError("construction failed — switcher disabled", e);
+    }
+  }
+  ready() {
+    return this.readyPromise;
+  }
+  async listSessions() {
+    if (this.failed || this.destroyed || this.iframe == null)
+      return this.log("listSessions skipped — switcher unavailable"), [];
+    try {
+      const e = (await this.rpc({ type: "list_sessions" })).sessions;
+      return Array.isArray(e) ? (this.log("listSessions resolved", { count: e.length }), e) : (this.log("listSessions resolved with no sessions array"), []);
+    } catch (i) {
+      return this.logError("listSessions failed — returning empty list", i), [];
+    }
+  }
+  async switchTo(i, e) {
+    if (this.failed || this.destroyed || this.iframe == null) {
+      this.log("switchTo skipped — switcher unavailable", { sub: i });
+      return;
+    }
+    try {
+      if (this.mode === "emit") {
+        this.log("switchTo emit", { sub: i, listeners: this.switchListeners.length }), this.emitSwitch(i);
+        return;
+      }
+      const t = i === "__new__" ? "login" : "none", r = e?.returnTo ?? window.location.href;
+      this.log("switchTo redirect", { sub: i, prompt: t, return_to: r }), await this.rpc({
+        type: "redirect_authorize",
+        login_hint: i,
+        prompt: t,
+        return_to: r
+      });
+    } catch (t) {
+      this.logError("switchTo failed", t);
+    }
+  }
+  /**
+   * Build the URL of the DMon account page for the given user, pre-filled with the
+   * `login_hint` so DMon can mount it silently if that user's session is in the cookie.
+   *
+   * This only constructs the string — it never navigates. Put it in an anchor's `href`
+   * so the user can choose how to open it (left click = same tab, middle/ctrl click =
+   * new tab). Pure and side-effect free; safe to call at any time.
+   */
+  accountPageUrl(i) {
+    const e = `${this.origin}/account?login_hint=${encodeURIComponent(i)}`;
+    return this.log("accountPageUrl", { sub: i, url: e }), e;
+  }
+  destroy() {
+    if (this.destroyed) {
+      this.log("destroy called again — no-op");
+      return;
+    }
+    this.destroyed = !0;
+    try {
+      window.removeEventListener("message", this.handleMessage);
+      const i = new DOMException("DmonSwitcher destroyed", "AbortError");
+      this.log("destroy", { rejectingPending: this.pending.size }), this.pending.forEach(({ reject: e }) => e(i)), this.pending.clear(), this.iframe?.remove(), this.resolveReady();
+    } catch (i) {
+      this.logError("destroy encountered an error", i);
+    }
+  }
+  on(i, e) {
+    i === "switch" ? this.switchListeners.push(e) : this.readyListeners.push(e);
+  }
+  log(i, e) {
+    this.debug && (e === void 0 ? console.debug(`[DmonSwitcher] ${i}`) : console.debug(`[DmonSwitcher] ${i}`, e));
+  }
+  // Errors are always surfaced (not gated by `debug`) but never thrown — the library
+  // must not crash the consuming application.
+  logError(i, e) {
+    e === void 0 ? console.error(`[DmonSwitcher] ${i}`) : console.error(`[DmonSwitcher] ${i}`, e);
+  }
+  // Invoke each consumer "switch" handler in isolation: a throwing handler is logged and
+  // skipped, never allowed to break the loop or propagate out of the library.
+  emitSwitch(i) {
+    for (const e of this.switchListeners)
+      try {
+        e({ sub: i });
+      } catch (t) {
+        this.logError("switch handler threw", t);
+      }
+  }
+  async rpc(i) {
+    if (this.destroyed || this.iframe == null)
+      throw new DOMException("DmonSwitcher destroyed", "AbortError");
+    if (await this.readyPromise, this.destroyed || this.iframe == null)
+      throw new DOMException("DmonSwitcher destroyed", "AbortError");
+    const e = String(this.nextRequestId++);
+    this.log("rpc send", { request_id: e, ...i });
+    const t = this.iframe;
+    return new Promise((r, o) => {
+      this.pending.set(e, { resolve: r, reject: o }), t.contentWindow?.postMessage({ ...i, request_id: e }, this.origin);
+    });
+  }
+}
+export {
+  l as DmonSwitcher
+};

package/package.json

@@ -0,0 +1,28 @@
+{
+    "name": "@gcm-cz/dmon-switcher",
+    "version": "0.1.0",
+    "type": "module",
+    "main": "./dist/index.cjs",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "require": "./dist/index.cjs"
+        }
+    },
+    "files": ["dist"],
+    "scripts": {
+        "build": "vite build && tsc --emitDeclarationOnly",
+        "prepare": "vite build && tsc --emitDeclarationOnly",
+        "test": "vitest run",
+        "test:watch": "vitest"
+    },
+    "devDependencies": {
+        "typescript": "^5.9.3",
+        "vite": "^7.3.1",
+        "vitest": "^4.1.6",
+        "jsdom": "^29.1.1"
+    }
+}