@mochabug/adapt-web 1.0.0-rc57 → 1.0.0-rc59

package/dist/esm/AdaptAutomationElement.js

@@ -249,6 +249,8 @@ export class AdaptAutomationElement extends BaseElement {
             options.classNames = this.classNames;
         if (this.styles !== undefined)
             options.styles = this.styles;
+        if (this.text !== undefined)
+            options.text = this.text;
         // Persist: object options take precedence, otherwise use boolean attribute
         if (this.persistOptions !== undefined) {
             options.persist = this.persistOptions;

package/dist/esm/index.js

@@ -4,12 +4,12 @@ if (typeof window !== "undefined" &&
     // Convert to absolute URL - Web Workers run in blob URL context and can't resolve relative paths
     window.CAP_CUSTOM_WASM_URL = new URL(__CAP_WASM_URL__, window.location.href).href;
 }
-import { configure, createAdaptClient, resetConfig, } from "@mochabug/adapt-core";
+import { Code, configure, ConnectError, createAdaptClient, resetConfig, } from "@mochabug/adapt-core";
 import { createConnectClient } from "@mochabug/adapt-core/connect";
 import { AdaptCapWidget } from "./AdaptCapWidget.js";
 import { getIframeSrc } from "./iframe-url.js";
 // Re-export standalone Cap widget for independent use
-export { AdaptCapWidget, } from "./AdaptCapWidget.js";
+export { AdaptCapWidget } from "./AdaptCapWidget.js";
 // Re-export challenge functions for direct use
 export { createChallenge, redeemChallenge } from "./cap-adapter.js";
 // Re-export createConnectClient for standalone Cap widget usage
@@ -559,7 +559,7 @@ cap-widget::part(attribution) {
   display: none;
 }
 
-.mb-adapt__stopped-placeholder {
+.mb-adapt__status-message {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -613,8 +613,8 @@ export class AdaptWebClient {
         this.backdropClickHandler = null;
         this.destroyed = false;
         this.lastForkActive = null;
-        // Stopped placeholder element
-        this.stoppedPlaceholder = null;
+        // Status message element (stopped / error)
+        this.statusMessageElement = null;
         // Cap.js widget instance (for PoW challenges)
         this.capWidgetInstance = null;
         this.options = options;
@@ -652,7 +652,9 @@ export class AdaptWebClient {
         this.setupDragListeners();
         this.setupResizeObserver();
         this.setupMessageListener();
-        this.init();
+        this.init().catch((error) => {
+            this.showStatusMessage(this.getErrorMessage(error));
+        });
     }
     createInitialStructure() {
         // Create DOM structure immediately based on display mode
@@ -1432,7 +1434,7 @@ export class AdaptWebClient {
             this.forkIframe.classList.add("mb-adapt__iframe--hidden");
         }
         // Reset visual state
-        this.removeStoppedPlaceholder();
+        this.removeStatusMessage();
         if (this.forkDisplay.mode === "side-by-side") {
             this.updateSideBySideVisibility();
         }
@@ -1440,7 +1442,12 @@ export class AdaptWebClient {
             this.updateDialogVisibility();
         }
         // Reinitialize
-        await this.init();
+        try {
+            await this.init();
+        }
+        catch (error) {
+            this.showStatusMessage(this.getErrorMessage(error));
+        }
     }
     async destroy() {
         this.destroyed = true;
@@ -1492,7 +1499,7 @@ export class AdaptWebClient {
         this.resizeObserver = null;
         this.messageHandler = null;
         this.backdropClickHandler = null;
-        this.stoppedPlaceholder = null;
+        this.statusMessageElement = null;
     }
     onUrl(msg) {
         if (this.destroyed)
@@ -1568,7 +1575,7 @@ export class AdaptWebClient {
                 this.mainIframe.classList.remove("mb-adapt__iframe--visible");
                 this.mainIframe.classList.add("mb-adapt__iframe--hidden");
             }
-            this.showStoppedPlaceholder();
+            this.showStatusMessage(this.options.text?.stopped ?? "This session has been stopped");
             return;
         }
         // Fork stopped — remove from queue
@@ -1602,13 +1609,30 @@ export class AdaptWebClient {
         }
     }
     handleMainUrl(url, token) {
-        this.removeStoppedPlaceholder();
+        this.removeStatusMessage();
         this.mainUrl = url;
         this.mainToken = token;
         // Update main iframe only - never touch dialog state
         this.updateMainIframe();
     }
     handleForkUrl(url, token, fork) {
+        // If this fork is already the current fork, update it in-place
+        if (this.currentFork?.fork === fork) {
+            this.currentFork.url = url;
+            this.currentFork.token = token;
+            this.currentFork.time = Date.now();
+            this.updateForkIframe();
+            return;
+        }
+        // If this fork is already queued, update in-place
+        const queued = this.forkQueue.find((item) => item.fork === fork);
+        if (queued) {
+            queued.url = url;
+            queued.token = token;
+            queued.time = Date.now();
+            return;
+        }
+        // New fork — add to queue
         const depth = (fork.match(/\//g) || []).length;
         const forkItem = {
             url,
@@ -1623,7 +1647,6 @@ export class AdaptWebClient {
             this.mainToken = token;
             this.updateMainIframe();
         }
-        // Add to queue and activate if no current fork or current fork is completed.
         this.forkQueue.push(forkItem);
         if (!this.currentFork || this.currentFork.completed) {
             this.currentFork = null;
@@ -2093,22 +2116,43 @@ export class AdaptWebClient {
         });
         return iframe;
     }
-    showStoppedPlaceholder() {
+    showStatusMessage(text) {
         if (!this.mainFrameElement && !this.mainContainer)
             return;
-        // Remove existing placeholder if any
-        this.removeStoppedPlaceholder();
-        this.stoppedPlaceholder = document.createElement("div");
-        this.stoppedPlaceholder.className = "mb-adapt__stopped-placeholder";
-        this.stoppedPlaceholder.textContent = "This session has been stopped";
+        // Remove existing message if any
+        this.removeStatusMessage();
+        this.statusMessageElement = document.createElement("div");
+        this.statusMessageElement.className =
+            this.options.classNames?.statusMessage ?? "mb-adapt__status-message";
+        this.statusMessageElement.textContent = text;
         const parent = this.mainFrameElement || this.mainContainer;
-        parent.appendChild(this.stoppedPlaceholder);
+        parent.appendChild(this.statusMessageElement);
     }
-    removeStoppedPlaceholder() {
-        if (this.stoppedPlaceholder) {
-            this.stoppedPlaceholder.remove();
-            this.stoppedPlaceholder = null;
+    removeStatusMessage() {
+        if (this.statusMessageElement) {
+            this.statusMessageElement.remove();
+            this.statusMessageElement = null;
+        }
+    }
+    getErrorMessage(error) {
+        const text = this.options.text;
+        const fallback = text?.error ?? "Something went wrong. Please try again later.";
+        if (error instanceof ConnectError) {
+            switch (error.code) {
+                case Code.ResourceExhausted:
+                    return (text?.resourceExhausted ??
+                        "This automation is currently at capacity. Please try again later.");
+                case Code.NotFound:
+                    return text?.notFound ?? "This automation could not be found.";
+                case Code.PermissionDenied:
+                case Code.Unauthenticated:
+                    return (text?.permissionDenied ??
+                        "You don't have permission to run this automation.");
+                default:
+                    return fallback;
+            }
         }
+        return fallback;
     }
     showIframe(iframe) {
         iframe.classList.remove("mb-adapt__iframe--hidden");

package/dist/types/AdaptAutomationElement.d.ts

@@ -1,4 +1,4 @@
-import type { AdaptWebClientOptions, CapWidgetOptions, Output, PersistOptions, SignalValue, StatusJson } from "./types.js";
+import type { AdaptWebClientOptions, CapWidgetOptions, Output, PersistOptions, SignalValue, StatusJson, StatusText } from "./types.js";
 /**
  * `<adapt-automation>` custom element for embedding Adapt automations.
  *
@@ -34,6 +34,7 @@ export declare class AdaptAutomationElement extends BaseElement {
     classNames: AdaptWebClientOptions["classNames"];
     styles: Partial<CSSStyleDeclaration> | undefined;
     persistOptions: PersistOptions | undefined;
+    text: StatusText | undefined;
     onSessionCallback: ((status: StatusJson, fork?: string) => void) | undefined;
     onOutputCallback: ((output: Output) => void) | undefined;
     onForkActiveCallback: ((active: boolean) => void) | undefined;

package/dist/types/index.d.ts

@@ -6,8 +6,8 @@ declare global {
 import { configure, resetConfig } from "@mochabug/adapt-core";
 import { createConnectClient } from "@mochabug/adapt-core/connect";
 import type { AdaptWebClientOptions } from "./types.js";
-export type { AdaptWebClientOptions, CapWidgetI18n, CapWidgetOptions, ChallengeInfo, ForkDisplay, Output, PersistOptions, RedeemedChallenge, SignalValue, StatusJson, } from "./types.js";
-export { AdaptCapWidget, type AdaptCapWidgetOptions, } from "./AdaptCapWidget.js";
+export type { AdaptWebClientOptions, CapWidgetI18n, CapWidgetOptions, ChallengeInfo, ForkDisplay, Output, PersistOptions, RedeemedChallenge, SignalValue, StatusJson, StatusText } from "./types.js";
+export { AdaptCapWidget, type AdaptCapWidgetOptions } from "./AdaptCapWidget.js";
 export { createChallenge, redeemChallenge } from "./cap-adapter.js";
 export type { SignalData } from "@mochabug/adapt-core";
 export { createConnectClient };
@@ -82,7 +82,7 @@ export declare class AdaptWebClient {
     private destroyed;
     private lastForkActive;
     private sessionExpiresAt;
-    private stoppedPlaceholder;
+    private statusMessageElement;
     private capWidgetInstance;
     constructor(options: AdaptWebClientOptions);
     private createInitialStructure;
@@ -167,7 +167,8 @@ export declare class AdaptWebClient {
     private createDialogStructure;
     private updateDialogVisibility;
     private createHiddenIframe;
-    private showStoppedPlaceholder;
-    private removeStoppedPlaceholder;
+    private showStatusMessage;
+    private removeStatusMessage;
+    private getErrorMessage;
     private showIframe;
 }

package/dist/types/types.d.ts

@@ -361,6 +361,8 @@ export interface AdaptWebClientOptions {
         dragHandle?: string;
         /** Expand button for collapsed panels. Default: `'mb-adapt__expand-button'` */
         expandButton?: string;
+        /** Status message overlay (stopped / error). Default: `'mb-adapt__status-message'` */
+        statusMessage?: string;
         /** Fork toolbar container. Default: `'mb-adapt__toolbar'` */
         toolbar?: string;
         /** Fork toolbar title text. Default: `'mb-adapt__toolbar-title'` */
@@ -395,4 +397,24 @@ export interface AdaptWebClientOptions {
      * @default undefined (disabled)
      */
     persist?: boolean | PersistOptions;
+    /**
+     * Custom text overrides for status messages shown to the user.
+     * Each property is optional — unspecified messages use built-in defaults.
+     */
+    text?: StatusText;
+}
+/**
+ * Custom text overrides for status messages and error states.
+ */
+export interface StatusText {
+    /** Shown when the session is stopped. Default: `"This session has been stopped"` */
+    stopped?: string;
+    /** Shown on ResourceExhausted. Default: `"This automation is currently at capacity. Please try again later."` */
+    resourceExhausted?: string;
+    /** Shown on NotFound. Default: `"This automation could not be found."` */
+    notFound?: string;
+    /** Shown on PermissionDenied or Unauthenticated. Default: `"You don't have permission to run this automation."` */
+    permissionDenied?: string;
+    /** Shown on any other non-retriable error. Default: `"Something went wrong. Please try again later."` */
+    error?: string;
 }

package/dist/umd/adapt-web.js

@@ -6073,7 +6073,8 @@ var MbAdapt = (() => {
       Code.PermissionDenied,
       Code.Unauthenticated,
       Code.InvalidArgument,
-      Code.FailedPrecondition
+      Code.FailedPrecondition,
+      Code.ResourceExhausted
     ];
     const isRetriableError = (error) => {
       if (error instanceof ConnectError) {
@@ -7398,6 +7399,7 @@ var MbAdapt = (() => {
       if (this.inheritFrom !== void 0) options.inheritFrom = this.inheritFrom;
       if (this.classNames !== void 0) options.classNames = this.classNames;
       if (this.styles !== void 0) options.styles = this.styles;
+      if (this.text !== void 0) options.text = this.text;
       if (this.persistOptions !== void 0) {
         options.persist = this.persistOptions;
       } else if (this.persist) {
@@ -7547,7 +7549,7 @@ var MbAdapt = (() => {
   // src/index.ts
   if (typeof window !== "undefined" && true && !window.CAP_CUSTOM_WASM_URL) {
     window.CAP_CUSTOM_WASM_URL = new URL(
-      "https://cdn.mochabug.com/adapt/web/1.0.0-rc57/cap_wasm.js",
+      "https://cdn.mochabug.com/adapt/web/1.0.0-rc59/cap_wasm.js",
       window.location.href
     ).href;
   }
@@ -8081,7 +8083,7 @@ cap-widget::part(attribution) {
   display: none;
 }
 
-.mb-adapt__stopped-placeholder {
+.mb-adapt__status-message {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -8128,8 +8130,8 @@ cap-widget::part(attribution) {
       this.backdropClickHandler = null;
       this.destroyed = false;
       this.lastForkActive = null;
-      // Stopped placeholder element
-      this.stoppedPlaceholder = null;
+      // Status message element (stopped / error)
+      this.statusMessageElement = null;
       // Cap.js widget instance (for PoW challenges)
       this.capWidgetInstance = null;
       this.options = options;
@@ -8159,7 +8161,9 @@ cap-widget::part(attribution) {
       this.setupDragListeners();
       this.setupResizeObserver();
       this.setupMessageListener();
-      this.init();
+      this.init().catch((error) => {
+        this.showStatusMessage(this.getErrorMessage(error));
+      });
     }
     static {
       this.COLLAPSE_THRESHOLD = 15;
@@ -8794,13 +8798,17 @@ cap-widget::part(attribution) {
         this.forkIframe.classList.remove("mb-adapt__iframe--visible");
         this.forkIframe.classList.add("mb-adapt__iframe--hidden");
       }
-      this.removeStoppedPlaceholder();
+      this.removeStatusMessage();
       if (this.forkDisplay.mode === "side-by-side") {
         this.updateSideBySideVisibility();
       } else {
         this.updateDialogVisibility();
       }
-      await this.init();
+      try {
+        await this.init();
+      } catch (error) {
+        this.showStatusMessage(this.getErrorMessage(error));
+      }
     }
     async destroy() {
       this.destroyed = true;
@@ -8847,7 +8855,7 @@ cap-widget::part(attribution) {
       this.resizeObserver = null;
       this.messageHandler = null;
       this.backdropClickHandler = null;
-      this.stoppedPlaceholder = null;
+      this.statusMessageElement = null;
     }
     onUrl(msg) {
       if (this.destroyed) return;
@@ -8908,7 +8916,9 @@ cap-widget::part(attribution) {
           this.mainIframe.classList.remove("mb-adapt__iframe--visible");
           this.mainIframe.classList.add("mb-adapt__iframe--hidden");
         }
-        this.showStoppedPlaceholder();
+        this.showStatusMessage(
+          this.options.text?.stopped ?? "This session has been stopped"
+        );
         return;
       }
       this.forkQueue = this.forkQueue.filter((item) => item.fork !== fork);
@@ -8935,12 +8945,26 @@ cap-widget::part(attribution) {
       }
     }
     handleMainUrl(url, token) {
-      this.removeStoppedPlaceholder();
+      this.removeStatusMessage();
       this.mainUrl = url;
       this.mainToken = token;
       this.updateMainIframe();
     }
     handleForkUrl(url, token, fork) {
+      if (this.currentFork?.fork === fork) {
+        this.currentFork.url = url;
+        this.currentFork.token = token;
+        this.currentFork.time = Date.now();
+        this.updateForkIframe();
+        return;
+      }
+      const queued = this.forkQueue.find((item) => item.fork === fork);
+      if (queued) {
+        queued.url = url;
+        queued.token = token;
+        queued.time = Date.now();
+        return;
+      }
       const depth = (fork.match(/\//g) || []).length;
       const forkItem = {
         url,
@@ -9345,20 +9369,38 @@ cap-widget::part(attribution) {
       });
       return iframe;
     }
-    showStoppedPlaceholder() {
+    showStatusMessage(text) {
       if (!this.mainFrameElement && !this.mainContainer) return;
-      this.removeStoppedPlaceholder();
-      this.stoppedPlaceholder = document.createElement("div");
-      this.stoppedPlaceholder.className = "mb-adapt__stopped-placeholder";
-      this.stoppedPlaceholder.textContent = "This session has been stopped";
+      this.removeStatusMessage();
+      this.statusMessageElement = document.createElement("div");
+      this.statusMessageElement.className = this.options.classNames?.statusMessage ?? "mb-adapt__status-message";
+      this.statusMessageElement.textContent = text;
       const parent = this.mainFrameElement || this.mainContainer;
-      parent.appendChild(this.stoppedPlaceholder);
+      parent.appendChild(this.statusMessageElement);
+    }
+    removeStatusMessage() {
+      if (this.statusMessageElement) {
+        this.statusMessageElement.remove();
+        this.statusMessageElement = null;
+      }
     }
-    removeStoppedPlaceholder() {
-      if (this.stoppedPlaceholder) {
-        this.stoppedPlaceholder.remove();
-        this.stoppedPlaceholder = null;
+    getErrorMessage(error) {
+      const text = this.options.text;
+      const fallback = text?.error ?? "Something went wrong. Please try again later.";
+      if (error instanceof ConnectError) {
+        switch (error.code) {
+          case Code.ResourceExhausted:
+            return text?.resourceExhausted ?? "This automation is currently at capacity. Please try again later.";
+          case Code.NotFound:
+            return text?.notFound ?? "This automation could not be found.";
+          case Code.PermissionDenied:
+          case Code.Unauthenticated:
+            return text?.permissionDenied ?? "You don't have permission to run this automation.";
+          default:
+            return fallback;
+        }
       }
+      return fallback;
     }
     showIframe(iframe) {
       iframe.classList.remove("mb-adapt__iframe--hidden");