@rehers/rehers-roleplay-sdk 2.1.1 → 2.1.3

package/README.md

@@ -1,6 +1,6 @@
 # @rehers/rehers-roleplay-sdk
 
-Lightweight vanilla JS SDK for embedding roleplay call sessions. Opens a modal (dialog mode) or mounts into a container (mount mode) — no framework dependencies.
+Lightweight vanilla JS SDK for embedding roleplay call sessions and bulk contact import. Opens a modal (dialog mode), mounts into a container (mount mode), or launches a scenario picker (add-to-scenario mode) — no framework dependencies.
 
 ## Install
 
@@ -23,7 +23,7 @@ Or load via CDN:
   SeamlessRoleplay.init({
     publishableKey: 'pk_live_abc123',
     userId: 'user_789',
-    userEmail: 'john@example.com',       // optional
+    userEmail: 'john@example.com',
     trialUrl: 'https://seamless.ai/pricing', // optional — shown when user not found
     onReady: function() {
       console.log('SDK ready');
@@ -55,6 +55,19 @@ Or load via CDN:
     title: 'VP of Sales',
   });
 
+  // 3. Add contacts to a scenario in bulk
+  SeamlessRoleplay.addToScenario({
+    contacts: [
+      { name: 'Sarah Chen', company: 'Stripe', title: 'VP of Sales', domain: 'stripe.com', liUrl: 'https://linkedin.com/in/sarachen' },
+      { name: 'Mike Ross', company: 'Acme', title: 'CRO', domain: 'acme.com', liUrl: 'https://linkedin.com/in/mikeross' },
+    ],
+    onComplete: function(data) {
+      console.log('Added', data.addedCount, 'contacts to', data.scenarioName);
+    },
+    onClose: function() { console.log('Dialog closed'); },
+    onError: function(err) { console.error('Error:', err.code, err.message); },
+  });
+
   // Close and destroy
   SeamlessRoleplay.close();
   SeamlessRoleplay.destroy();
@@ -69,6 +82,7 @@ If the user doesn't have an active account, provide a `trialUrl` during init. Wh
 SeamlessRoleplay.init({
   publishableKey: 'pk_live_abc123',
   userId: 'unknown_user',
+  userEmail: 'unknown@example.com',
   trialUrl: 'https://seamless.ai/pricing',
 });
 ```
@@ -81,7 +95,7 @@ SeamlessRoleplay.init({
 |---|---|---|---|
 | `publishableKey` | `string` | Yes | Publishable API key |
 | `userId` | `string` | Yes | Your user's unique identifier |
-| `userEmail` | `string` | No | User email for account matching |
+| `userEmail` | `string` | Yes | User email for secure account matching |
 | `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) |
@@ -109,6 +123,23 @@ Opens the roleplay in a modal dialog overlay.
 
 Mounts the roleplay into a DOM element (full-page embed). Same `data` options as `open()`.
 
+### `SeamlessRoleplay.addToScenario(options)`
+
+Opens a compact dialog for selecting a scenario and importing contacts in bulk.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `contacts` | `array` | Yes | 1–25 contacts to import |
+| `contacts[].name` | `string` | Yes | Full name |
+| `contacts[].company` | `string` | Yes | Company name |
+| `contacts[].title` | `string` | Yes | Job title |
+| `contacts[].domain` | `string` | Yes | Company domain |
+| `contacts[].liUrl` | `string` | No | LinkedIn profile URL |
+| `contacts[].companyDescription` | `string` | No | Brief company description |
+| `onComplete` | `function` | No | `({ scenarioId, scenarioName, addedCount, skippedCount })` |
+| `onClose` | `function` | No | Called when dialog closes |
+| `onError` | `function` | No | `({ code, message })` |
+
 ### `SeamlessRoleplay.close()`
 
 Closes the active dialog or unmounts.
@@ -124,10 +155,11 @@ SDK                                      Backend
 ─────────────────                        ─────────────────
 POST /api/sdk/session
   X-Publishable-Key: pk_live_abc123
-  Body: { userId, userEmail? }
+  Body: { userId, userEmail }
                                          1. Validate key + origin
-                                         2. Find/create user
-                                         3. Mint JWT (1hr TTL)
+                                         2. Validate userId + userEmail combo
+                                         3. Find/create user
+                                         4. Mint JWT (1hr TTL)
                                 ←────    { sessionToken, expiresIn }
                                          OR { error: "USER_NOT_FOUND" }
 
@@ -135,10 +167,14 @@ Token stored in memory (not localStorage)
 Auto-refreshes at 80% of TTL
 ```
 
+## Error Handling
+
+All public methods are wrapped in try/catch — the SDK will never throw an uncaught exception that could crash the host page. Errors are logged to `console.error` with a `[SeamlessRoleplay]` prefix and routed to the relevant `onError` callback when provided.
+
 ## TypeScript
 
 Full type declarations are included:
 
 ```ts
-import type { SeamlessRoleplaySDK, SeamlessRoleplayOpenData } from '@rehers/rehers-roleplay-sdk';
+import type { SeamlessRoleplaySDK, SeamlessRoleplayOpenData, AddToScenarioOptions } from '@rehers/rehers-roleplay-sdk';
 ```

package/package.json

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

package/roleplay-sdk.js

@@ -207,13 +207,15 @@
 
   function dispatchInitToIframe(token) {
     if (addToScenarioPendingContacts) {
-      sendToIframe({
+      var msg = {
         type: "seamless-add-to-scenario-init",
         sessionToken: token,
         publishableKey: publishableKey,
         userId: userId,
         contacts: addToScenarioPendingContacts,
-      });
+      };
+      if (trialUrl) msg.trialUrl = trialUrl;
+      sendToIframe(msg);
     } else if (token && pendingContactData) {
       sendToIframe({
         type: "seamless-session-init",