@rehers/rehers-roleplay-sdk 2.1.5 → 2.3.0

package/README.md

@@ -25,7 +25,6 @@ Or load via CDN:
     userId: 'user_789',
     userEmail: 'john@example.com',
     userRole: 'member',                        // optional — "owner", "admin", or "member"
-    trialUrl: 'https://seamless.ai/pricing', // optional — shown when user not found
     onReady: function() {
       console.log('SDK ready');
     },
@@ -48,7 +47,10 @@ Or load via CDN:
     onError: function(data) { console.error('Error:', data.code, data.message); },
   });
 
-  // 2b. Or mount into a container (full-page embed)
+  // 2b. Or mount the full app into a container (full-page embed)
+  SeamlessRoleplay.mount(document.getElementById('roleplay-container'));
+
+  // 2c. Or mount a call for a specific contact into a container
   SeamlessRoleplay.mount(document.getElementById('roleplay-container'), {
     name: 'Jane Smith',
     domain: 'acme.com',
@@ -77,16 +79,7 @@ Or load via CDN:
 
 ## Trial Mode
 
-If the user doesn't have an active account, provide a `trialUrl` during init. When the backend returns `USER_NOT_FOUND`, the SDK will render a trial screen:
-
-```js
-SeamlessRoleplay.init({
-  publishableKey: 'pk_live_abc123',
-  userId: 'unknown_user',
-  userEmail: 'unknown@example.com',
-  trialUrl: 'https://seamless.ai/pricing',
-});
-```
+When the backend returns `USER_NOT_FOUND`, it includes a `paymentLink` in the response. The SDK automatically captures it and renders a trial screen directing the user to sign up — no client-side configuration needed.
 
 ## API
 
@@ -99,7 +92,6 @@ SeamlessRoleplay.init({
 | `userEmail` | `string` | Yes | User email for secure account matching |
 | `userRole` | `string` | No | User role — `"owner"`, `"admin"`, or `"member"` |
 | `userToken` | `string` | No | Signed JWT for identity verification |
-| `trialUrl` | `string` | No | URL shown when user not found |
 | `origin` | `string` | No | Override app origin (dev only) |
 | `onReady` | `function` | No | Called when session is ready |
 | `onError` | `function` | No | Called on init error `({ code, message })` |
@@ -121,9 +113,12 @@ Opens the roleplay in a modal dialog overlay.
 | `onClose` | `function` | No | Called when dialog closes |
 | `onError` | `function` | No | `({ code, message })` |
 
-### `SeamlessRoleplay.mount(container, data)`
+### `SeamlessRoleplay.mount(container, data?)`
+
+Mounts into a DOM element. Two modes:
 
-Mounts the roleplay into a DOM element (full-page embed). Same `data` options as `open()`.
+- **`mount(container)`** — embeds the full Roleplay app (dashboard, scenarios, call logs)
+- **`mount(container, data)`** — embeds a roleplay call for a specific contact (same `data` options as `open()`)
 
 ### `SeamlessRoleplay.addToScenario(options)`
 

package/index.d.ts

@@ -9,8 +9,6 @@ export interface SeamlessRoleplayInitOptions {
   userRole?: "owner" | "admin" | "member";
   /** Optional signed JWT for identity verification */
   userToken?: string;
-  /** URL shown when the user is not found (trial mode) */
-  trialUrl?: string;
   /** Override the app origin — where the iframe loads from (for dev/testing only) */
   origin?: string;
   /** Called when the SDK session is ready */
@@ -80,8 +78,8 @@ export interface SeamlessRoleplaySDK {
   init(options: SeamlessRoleplayInitOptions): void;
   /** Open the roleplay modal for a contact (dialog mode). */
   open(data: SeamlessRoleplayOpenData): void;
-  /** Mount the roleplay into a container element (full-page embed). */
-  mount(container: HTMLElement, data: SeamlessRoleplayOpenData): void;
+  /** Mount the full Roleplay app into a container (no data), or a call embed for a specific contact (with data). */
+  mount(container: HTMLElement, data?: SeamlessRoleplayOpenData): void;
   /** Open the add-to-scenario dialog for bulk contact import. */
   addToScenario(options: AddToScenarioOptions): void;
   /** Close the roleplay dialog or unmount. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rehers/rehers-roleplay-sdk",
-  "version": "2.1.5",
+  "version": "2.3.0",
   "description": "Seamless Roleplay SDK — embed roleplay call sessions via a modal + iframe",
   "main": "roleplay-sdk.js",
   "types": "index.d.ts",

package/roleplay-sdk.js

@@ -21,7 +21,7 @@
   var userEmail = null;
   var userRole = null;
   var userToken = null;
-  var trialUrl = null;
+  var paymentLink = null;
   var appOrigin = null;
 
   var sessionToken = null;
@@ -116,6 +116,7 @@
         if (data.error === "USER_NOT_FOUND") {
           // Trial mode — not a fatal error
           sessionToken = null;
+          if (data.paymentLink) paymentLink = data.paymentLink;
           resolve({ trialMode: true });
           return;
         }
@@ -216,31 +217,32 @@
         userId: userId,
         contacts: addToScenarioPendingContacts,
       };
-      if (trialUrl) msg.trialUrl = trialUrl;
+      if (paymentLink) msg.paymentLink = paymentLink;
       sendToIframe(msg);
-    } else if (token && pendingContactData) {
-      sendToIframe({
+    } else if (token) {
+      var msg = {
         type: "seamless-session-init",
         sessionToken: token,
-        contact: {
+        contact: pendingContactData ? {
           name: pendingContactData.name,
           domain: pendingContactData.domain,
           company: pendingContactData.company,
           title: pendingContactData.title,
           companyDescription: pendingContactData.companyDescription || undefined,
           liUrl: pendingContactData.liUrl || undefined,
-        },
-      });
-    } else if (trialUrl) {
+        } : null,
+      };
+      sendToIframe(msg);
+    } else if (paymentLink) {
       sendToIframe({
         type: "seamless-session-init",
-        trialUrl: trialUrl,
+        paymentLink: paymentLink,
         contact: null,
       });
     } else {
       sendToIframe({
         type: "seamless-session-init",
-        trialUrl: null,
+        paymentLink: null,
         contact: null,
       });
     }
@@ -335,9 +337,9 @@
 
   // ── Create iframe ───────────────────────────────────────────────────
 
-  function createIframe() {
+  function createIframe(path) {
     var iframeEl = document.createElement("iframe");
-    iframeEl.src = getOrigin() + "/embed/roleplay-call";
+    iframeEl.src = getOrigin() + (path || "/embed/roleplay-call");
     iframeEl.allow = "camera; microphone; display-capture; autoplay";
     iframeEl.style.width = "100%";
     iframeEl.style.height = "100%";
@@ -373,7 +375,6 @@
         userEmail = opts.userEmail || null;
         userRole = opts.userRole || null;
         userToken = opts.userToken || null;
-        trialUrl = opts.trialUrl || null;
         appOrigin = opts.origin || null;
         initCallbacks.onReady = opts.onReady || null;
         initCallbacks.onError = opts.onError || null;
@@ -382,8 +383,8 @@
         // Fetch session immediately
         fetchSession()
           .then(function (result) {
-            if (result.trialMode && !trialUrl) {
-              // User not found and no trial URL configured — still call onReady
+            if (result.trialMode && !paymentLink) {
+              // User not found and no payment link from server — still call onReady
               // The open() will show an error state in the iframe
             }
             if (initCallbacks.onReady) initCallbacks.onReady();
@@ -502,7 +503,11 @@
     },
 
     /**
-     * Mount the roleplay into a container element (full-page embed).
+     * Mount the roleplay into a container element.
+     *
+     * Two modes:
+     *   mount(container)             — full app embed (dashboard, scenarios, call logs, etc.)
+     *   mount(container, contactData) — roleplay call embed for a specific contact
      */
     mount: function (container, data) {
       try {
@@ -514,19 +519,22 @@
           logError("mount", "requires a DOM element as first argument");
           return;
         }
-        if (!data || !data.name || !data.domain || !data.company || !data.title) {
-          logError("mount", "requires { name, domain, company, title }");
+
+        // If contact data is provided, validate required fields
+        var hasContactData = data && data.name && data.domain && data.company && data.title;
+        if (data && !hasContactData && (data.name || data.domain || data.company || data.title)) {
+          logError("mount", "contact data requires { name, domain, company, title }");
           return;
         }
 
         // If already open, tear down first (also cancels any pending close timer)
         if (overlay || (iframe && mode)) teardown();
 
-        pendingContactData = data;
-        callbacks.onCallStarted = data.onCallStarted || null;
-        callbacks.onCallEnded = data.onCallEnded || null;
-        callbacks.onClose = data.onClose || null;
-        callbacks.onError = data.onError || null;
+        pendingContactData = hasContactData ? data : null;
+        callbacks.onCallStarted = (data && data.onCallStarted) || null;
+        callbacks.onCallEnded = (data && data.onCallEnded) || null;
+        callbacks.onClose = (data && data.onClose) || null;
+        callbacks.onError = (data && data.onError) || null;
         mode = "mount";
         mountContainer = container;
 
@@ -534,7 +542,8 @@
         listener = handleMessage;
         window.addEventListener("message", listener);
 
-        var iframeEl = createIframe();
+        // No contact data → full app embed at root; with contact → /embed/roleplay-call
+        var iframeEl = createIframe(hasContactData ? "/embed/roleplay-call" : "/");
         iframe = iframeEl;
         container.appendChild(iframeEl);
       } catch (e) {
@@ -703,7 +712,7 @@
         userEmail = null;
         userRole = null;
         userToken = null;
-        trialUrl = null;
+        paymentLink = null;
         sessionToken = null;
         sessionExpiresAt = 0;
         fetchingSession = null;