ab-ecosystem-cpass 1.0.12 → 1.0.13

package/README.md

@@ -229,7 +229,7 @@ same pages ship inside the package, so they are readable offline at
 | --- | --- | --- |
 | `crm.channels` | [channels](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/channels/channels.md) | `list` `get` `updateDetails` `disable` `rotateToken` `getProp` `setProp` |
 | — | [channel properties](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/channels/channel-props.md) | every `prop` `getProp`/`setProp` accepts |
-| `crm.channelOnboarding` | [connecting a channel](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/channels/onboarding.md) | `types` `url` `exchange` `complete` `connect` |
+| `crm.channelOnboarding` | [connecting a channel](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/channels/onboarding.md) | `types` `url` `pending` `complete` `exchange` `connect` |
 | `crm.templates` | [templates](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/channels/templates.md) | `list` `get` `create` `update` `delete` `sync` |
 | `crm.channelWebhooks` | [channel webhooks](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/channels/webhooks.md) | `list` `get` `create` `update` `delete` |
 | `crm.billing` | [conversation billing](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/channels/billing.md) | `list` `stats` |

package/dist/index.d.ts

@@ -26,8 +26,8 @@ export { CampaignMessages } from './resources/campaign-messages';
 export { MAX_BULK_RECEIVERS, buildReceivers, normaliseColumn, normaliseNumbers, parseDelimited, resolveAudience, type BulkAudienceInput, type CampaignReceiver, type ResolvedAudience, } from './resources/campaign-audience';
 export { Channels, type SetPropOptions } from './resources/channels/channels';
 export { ChannelOnboarding, type ConnectOptions } from './resources/channels/onboarding';
-/** The popup driver on its own, for a console that calls `url()` itself. */
-export { openSignup, EmbeddedSignupError, type OpenSignupOptions, } from './internal/embedded-signup';
+/** The popup drivers on their own, for a console that calls `url()` itself. */
+export { awaitSignupReturn, openSignup, EmbeddedSignupError, type OpenSignupOptions, } from './internal/embedded-signup';
 export { Templates } from './resources/channels/templates';
 export { ChannelWebhooks } from './resources/channels/webhooks';
 export { Billing } from './resources/channels/billing';

package/dist/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Activity = exports.Wallet = exports.Billing = exports.ChannelWebhooks = exports.Templates = exports.EmbeddedSignupError = exports.openSignup = exports.ChannelOnboarding = exports.Channels = exports.resolveAudience = exports.parseDelimited = exports.normaliseNumbers = exports.normaliseColumn = exports.buildReceivers = exports.MAX_BULK_RECEIVERS = exports.CampaignMessages = exports.Campaigns = exports.InboxMedia = exports.DataStoreRecords = exports.DataStoreCollections = exports.DataStores = exports.Notifications = exports.Webhooks = exports.Exports = exports.Imports = exports.CrmTriggers = exports.Segments = exports.CustomFields = exports.CannedReplies = exports.ContactNotes = exports.ContactTags = exports.Contacts = exports.CHANNELS = exports.AUDIENCE = void 0;
+exports.Activity = exports.Wallet = exports.Billing = exports.ChannelWebhooks = exports.Templates = exports.EmbeddedSignupError = exports.openSignup = exports.awaitSignupReturn = exports.ChannelOnboarding = exports.Channels = exports.resolveAudience = exports.parseDelimited = exports.normaliseNumbers = exports.normaliseColumn = exports.buildReceivers = exports.MAX_BULK_RECEIVERS = exports.CampaignMessages = exports.Campaigns = exports.InboxMedia = exports.DataStoreRecords = exports.DataStoreCollections = exports.DataStores = exports.Notifications = exports.Webhooks = exports.Exports = exports.Imports = exports.CrmTriggers = exports.Segments = exports.CustomFields = exports.CannedReplies = exports.ContactNotes = exports.ContactTags = exports.Contacts = exports.CHANNELS = exports.AUDIENCE = void 0;
 __exportStar(require("./client"), exports);
 __exportStar(require("./http"), exports);
 __exportStar(require("./errors"), exports);
@@ -73,8 +73,9 @@ var channels_1 = require("./resources/channels/channels");
 Object.defineProperty(exports, "Channels", { enumerable: true, get: function () { return channels_1.Channels; } });
 var onboarding_1 = require("./resources/channels/onboarding");
 Object.defineProperty(exports, "ChannelOnboarding", { enumerable: true, get: function () { return onboarding_1.ChannelOnboarding; } });
-/** The popup driver on its own, for a console that calls `url()` itself. */
+/** The popup drivers on their own, for a console that calls `url()` itself. */
 var embedded_signup_1 = require("./internal/embedded-signup");
+Object.defineProperty(exports, "awaitSignupReturn", { enumerable: true, get: function () { return embedded_signup_1.awaitSignupReturn; } });
 Object.defineProperty(exports, "openSignup", { enumerable: true, get: function () { return embedded_signup_1.openSignup; } });
 Object.defineProperty(exports, "EmbeddedSignupError", { enumerable: true, get: function () { return embedded_signup_1.EmbeddedSignupError; } });
 var templates_1 = require("./resources/channels/templates");

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,yCAAuB;AACvB,2CAAyB;AACzB,0CAAwB;AAExB,2CAAuD;AAA9C,iGAAA,QAAQ,OAAA;AAAE,iGAAA,QAAQ,OAAA;AAE3B,WAAW;AACX,0DAAyD;AAAhD,oGAAA,QAAQ,OAAA;AACjB,kEAAgE;AAAvD,2GAAA,WAAW,OAAA;AACpB,oEAAkE;AAAzD,6GAAA,YAAY,OAAA;AACrB,sEAAoE;AAA3D,+GAAA,aAAa,OAAA;AACtB,oEAAkE;AAAzD,6GAAA,YAAY,OAAA;AACrB,0DAAyD;AAAhD,oGAAA,QAAQ,OAAA;AACjB,kEAAgE;AAAvD,2GAAA,WAAW,OAAA;AACpB,sEAA8D;AAArD,yGAAA,OAAO,OAAA;AAChB,sEAA8D;AAArD,yGAAA,OAAO,OAAA;AAChB,0DAAyD;AAAhD,oGAAA,QAAQ,OAAA;AACjB,oEAAmE;AAA1D,8GAAA,aAAa,OAAA;AACtB,uDAIiC;AAH/B,yGAAA,UAAU,OAAA;AACV,mHAAA,oBAAoB,OAAA;AACpB,+GAAA,gBAAgB,OAAA;AAElB,gEAI0C;AAHxC,yGAAA,UAAU,OAAA;AAKZ,WAAW;AACX,mDAS+B;AAR7B,sGAAA,SAAS,OAAA;AASX,mEAAiE;AAAxD,qHAAA,gBAAgB,OAAA;AACzB;;;;GAIG;AACH,mEAUuC;AATrC,uHAAA,kBAAkB,OAAA;AAClB,mHAAA,cAAc,OAAA;AACd,oHAAA,eAAe,OAAA;AACf,qHAAA,gBAAgB,OAAA;AAChB,mHAAA,cAAc,OAAA;AACd,oHAAA,eAAe,OAAA;AAMjB,WAAW;AACX,0DAA8E;AAArE,oGAAA,QAAQ,OAAA;AACjB,8DAAyF;AAAhF,+GAAA,iBAAiB,OAAA;AAC1B,4EAA4E;AAC5E,8DAIoC;AAHlC,6GAAA,UAAU,OAAA;AACV,sHAAA,mBAAmB,OAAA;AAGrB,4DAA2D;AAAlD,sGAAA,SAAS,OAAA;AAClB,0DAAgE;AAAvD,2GAAA,eAAe,OAAA;AACxB,wDAAuD;AAA9C,kGAAA,OAAO,OAAA;AAChB,sDAAqD;AAA5C,gGAAA,MAAM,OAAA;AACf,0DAAyD;AAAhD,oGAAA,QAAQ,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,yCAAuB;AACvB,2CAAyB;AACzB,0CAAwB;AAExB,2CAAuD;AAA9C,iGAAA,QAAQ,OAAA;AAAE,iGAAA,QAAQ,OAAA;AAE3B,WAAW;AACX,0DAAyD;AAAhD,oGAAA,QAAQ,OAAA;AACjB,kEAAgE;AAAvD,2GAAA,WAAW,OAAA;AACpB,oEAAkE;AAAzD,6GAAA,YAAY,OAAA;AACrB,sEAAoE;AAA3D,+GAAA,aAAa,OAAA;AACtB,oEAAkE;AAAzD,6GAAA,YAAY,OAAA;AACrB,0DAAyD;AAAhD,oGAAA,QAAQ,OAAA;AACjB,kEAAgE;AAAvD,2GAAA,WAAW,OAAA;AACpB,sEAA8D;AAArD,yGAAA,OAAO,OAAA;AAChB,sEAA8D;AAArD,yGAAA,OAAO,OAAA;AAChB,0DAAyD;AAAhD,oGAAA,QAAQ,OAAA;AACjB,oEAAmE;AAA1D,8GAAA,aAAa,OAAA;AACtB,uDAIiC;AAH/B,yGAAA,UAAU,OAAA;AACV,mHAAA,oBAAoB,OAAA;AACpB,+GAAA,gBAAgB,OAAA;AAElB,gEAI0C;AAHxC,yGAAA,UAAU,OAAA;AAKZ,WAAW;AACX,mDAS+B;AAR7B,sGAAA,SAAS,OAAA;AASX,mEAAiE;AAAxD,qHAAA,gBAAgB,OAAA;AACzB;;;;GAIG;AACH,mEAUuC;AATrC,uHAAA,kBAAkB,OAAA;AAClB,mHAAA,cAAc,OAAA;AACd,oHAAA,eAAe,OAAA;AACf,qHAAA,gBAAgB,OAAA;AAChB,mHAAA,cAAc,OAAA;AACd,oHAAA,eAAe,OAAA;AAMjB,WAAW;AACX,0DAA8E;AAArE,oGAAA,QAAQ,OAAA;AACjB,8DAAyF;AAAhF,+GAAA,iBAAiB,OAAA;AAC1B,+EAA+E;AAC/E,8DAKoC;AAJlC,oHAAA,iBAAiB,OAAA;AACjB,6GAAA,UAAU,OAAA;AACV,sHAAA,mBAAmB,OAAA;AAGrB,4DAA2D;AAAlD,sGAAA,SAAS,OAAA;AAClB,0DAAgE;AAAvD,2GAAA,eAAe,OAAA;AACxB,wDAAuD;AAA9C,kGAAA,OAAO,OAAA;AAChB,sDAAqD;AAA5C,gGAAA,MAAM,OAAA;AACf,0DAAyD;AAAhD,oGAAA,QAAQ,OAAA"}

package/dist/internal/embedded-signup.d.ts

@@ -1,7 +1,10 @@
-import type { SignupCredentials } from '../types';
+import type { OnboardingReturn, SignupCredentials } from '../types';
 /**
- * The dialog answers in two halves -- the code on the redirect, the ids by
- * `postMessage` -- and neither is usable alone, so `openSignup` waits for both.
+ * Two drivers for the same popup. {@link awaitSignupReturn} is the one to use:
+ * the code goes to the service's callback, so it only waits for the popup to
+ * come back to our origin. {@link openSignup} is the older half-and-half (code
+ * on the redirect, ids by `postMessage`), for a BSP app whose registered
+ * redirect is a page of yours -- what `/onboarding/exchange` exists for.
  */
 /** How the popup is opened, and how to follow its progress. */
 export interface OpenSignupOptions {
@@ -13,17 +16,31 @@ export interface OpenSignupOptions {
     timeoutMs?: number;
     /** For a console showing more than a spinner. `step` is Meta's own `current_step`. */
     onProgress?: (event: {
-        phase: 'opened' | 'step' | 'code' | 'ids';
+        phase: 'opened' | 'step' | 'code' | 'ids' | 'returned';
         step?: string;
     }) => void;
 }
 /** Thrown for every way the dialog can fail to produce credentials. */
 export declare class EmbeddedSignupError extends Error {
     readonly code: 'unsupported_environment' | 'popup_blocked' | 'popup_closed' | 'cancelled' | 'signup_error' | 'timeout';
-    constructor(code: 'unsupported_environment' | 'popup_blocked' | 'popup_closed' | 'cancelled' | 'signup_error' | 'timeout', message: string);
+    /** The service's own code, when the refusal came back on the return URL. */
+    readonly reason?: string | undefined;
+    constructor(code: 'unsupported_environment' | 'popup_blocked' | 'popup_closed' | 'cancelled' | 'signup_error' | 'timeout', message: string, 
+    /** The service's own code, when the refusal came back on the return URL. */
+    reason?: string | undefined);
 }
 /**
- * Call this **straight from a click handler**: a `window.open` a browser does not
- * attribute to a gesture is blocked, and that looks like the user's popup blocker.
+ * The redirect flow: open the dialog, wait for the popup to come back to our
+ * origin with the service's outcome on it. Nothing here reads Meta, so the
+ * return has to be a page on **this** origin -- a cross-origin one cannot be
+ * read, and the wait ends as `popup_closed`.
+ *
+ * Call it **straight from a click handler**, or the `window.open` is blocked.
+ */
+export declare const awaitSignupReturn: (url: string, options?: OpenSignupOptions) => Promise<OnboardingReturn>;
+/**
+ * The older driver, for a BSP app whose registered redirect is a page of yours:
+ * it waits for the code *and* the ids, which is what `/onboarding/exchange`
+ * takes. Call it **straight from a click handler**, as above.
  */
 export declare const openSignup: (url: string, options?: OpenSignupOptions) => Promise<SignupCredentials>;

package/dist/internal/embedded-signup.js

@@ -1,16 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.openSignup = exports.EmbeddedSignupError = void 0;
+exports.openSignup = exports.awaitSignupReturn = exports.EmbeddedSignupError = void 0;
 /** Thrown for every way the dialog can fail to produce credentials. */
 class EmbeddedSignupError extends Error {
     code;
-    constructor(code, message) {
+    reason;
+    constructor(code, message, 
+    /** The service's own code, when the refusal came back on the return URL. */
+    reason) {
         super(message);
         this.code = code;
+        this.reason = reason;
         this.name = 'EmbeddedSignupError';
     }
 }
 exports.EmbeddedSignupError = EmbeddedSignupError;
+/** The events that carry the ids. The second is a number off the WA Business app. */
+const FINISH_EVENTS = ['FINISH', 'FINISH_WHATSAPP_BUSINESS_APP_ONBOARDING'];
 /** Origins Meta posts the signup events from. */
 const META_ORIGINS = ['https://www.facebook.com', 'https://web.facebook.com', 'https://business.facebook.com'];
 const DEFAULT_TIMEOUT_MS = 15 * 60 * 1000;
@@ -31,20 +37,144 @@ const parsePayload = (data) => {
     }
     return typeof data === 'object' && data !== null ? data : undefined;
 };
+const str = (value) => (typeof value === 'string' && value ? value : undefined);
+const decodeBase64 = (value) => {
+    try {
+        const json = globalThis.atob?.(value);
+        return json ? parsePayload(json) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
 /**
- * Call this **straight from a click handler**: a `window.open` a browser does not
- * attribute to a gesture is blocked, and that looks like the user's popup blocker.
+ * A redirect page may post its whole query string rather than an object, and
+ * may wrap it in a base64 `json` param, as our panel does.
  */
-const openSignup = (url, options = {}) => {
-    const win = browser();
-    if (!win) {
-        return Promise.reject(new EmbeddedSignupError('unsupported_environment', 'Embedded signup needs a browser; drive the three onboarding calls yourself outside one'));
+const fromSameOrigin = (data) => {
+    if (typeof data === 'string') {
+        const text = data.trim();
+        if (!text || !/[?&=]/.test(text))
+            return undefined;
+        const params = new URLSearchParams(text.startsWith('?') ? text.slice(1) : text);
+        const wrapped = params.get('json');
+        if (wrapped) {
+            const payload = decodeBase64(wrapped);
+            // `{ success: false, data: '<message>' }` on a refusal.
+            if (payload?.success === false)
+                return { error: str(payload.data) ?? 'Signup was refused' };
+            const inner = (payload?.data ?? payload);
+            return inner ?? undefined;
+        }
+        return Object.fromEntries(params.entries());
     }
+    const payload = parsePayload(data);
+    return payload?.type === 'CRM_CHANNEL_ONBOARDING' ? payload : undefined;
+};
+/** Centred, and named so a second call reuses the window rather than opening two. */
+const openPopup = (win, url, options) => {
     const width = options.width ?? 620;
     const height = options.height ?? 760;
     const left = Math.max(0, ((win.screen?.width ?? width) - width) / 2);
     const top = Math.max(0, ((win.screen?.height ?? height) - height) / 2);
-    const popup = win.open(url, options.name ?? 'wa_embedded_signup', `popup=1,width=${width},height=${height},left=${left},top=${top},scrollbars=1,resizable=1`);
+    return win.open(url, options.name ?? 'wa_embedded_signup', `popup=1,width=${width},height=${height},left=${left},top=${top},scrollbars=1,resizable=1`);
+};
+/** A console's progress callback is never allowed to break the flow. */
+const report = (options, phase, step) => {
+    try {
+        options.onProgress?.({ phase, step });
+    }
+    catch {
+        // Theirs to fix, not ours to propagate.
+    }
+};
+/**
+ * The redirect flow: open the dialog, wait for the popup to come back to our
+ * origin with the service's outcome on it. Nothing here reads Meta, so the
+ * return has to be a page on **this** origin -- a cross-origin one cannot be
+ * read, and the wait ends as `popup_closed`.
+ *
+ * Call it **straight from a click handler**, or the `window.open` is blocked.
+ */
+const awaitSignupReturn = (url, options = {}) => {
+    const win = browser();
+    if (!win) {
+        return Promise.reject(new EmbeddedSignupError('unsupported_environment', 'Embedded signup needs a browser; drive the onboarding calls yourself outside one'));
+    }
+    const popup = openPopup(win, url, options);
+    if (!popup) {
+        return Promise.reject(new EmbeddedSignupError('popup_blocked', 'The signup window was blocked; allow popups and try again'));
+    }
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const finish = (outcome) => {
+            if (settled)
+                return;
+            settled = true;
+            win.removeEventListener('message', onMessage);
+            win.clearInterval(poll);
+            win.clearTimeout(timer);
+            try {
+                if (!popup.closed)
+                    popup.close();
+            }
+            catch {
+                // Cross-origin as it closed; the window is the user's problem now.
+            }
+            outcome();
+        };
+        /** True once something carrying a `status` has been dealt with. */
+        const take = (returned) => {
+            const status = str(returned?.status);
+            if (!returned || !status)
+                return false;
+            report(options, 'returned');
+            if (status === 'error') {
+                finish(() => reject(new EmbeddedSignupError('signup_error', str(returned.message) ?? 'The number could not be connected', str(returned.code))));
+                return true;
+            }
+            finish(() => resolve(returned));
+            return true;
+        };
+        // For a return page that posts its query and closes itself, which the poll
+        // would never get to read.
+        const onMessage = (event) => {
+            if (event.origin !== win.location.origin)
+                return;
+            take(fromSameOrigin(event.data));
+        };
+        const poll = win.setInterval(() => {
+            if (popup.closed) {
+                finish(() => reject(new EmbeddedSignupError('popup_closed', 'The signup window was closed before it finished')));
+                return;
+            }
+            try {
+                // Reading this throws while the window is still on Meta's origin.
+                take(popup.location.search ? fromSameOrigin(popup.location.search) : undefined);
+            }
+            catch {
+                // Still at Meta, so there is nothing to read yet.
+            }
+        }, 400);
+        const timer = win.setTimeout(() => {
+            finish(() => reject(new EmbeddedSignupError('timeout', 'The signup window was not completed in time')));
+        }, options.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+        win.addEventListener('message', onMessage);
+        report(options, 'opened');
+    });
+};
+exports.awaitSignupReturn = awaitSignupReturn;
+/**
+ * The older driver, for a BSP app whose registered redirect is a page of yours:
+ * it waits for the code *and* the ids, which is what `/onboarding/exchange`
+ * takes. Call it **straight from a click handler**, as above.
+ */
+const openSignup = (url, options = {}) => {
+    const win = browser();
+    if (!win) {
+        return Promise.reject(new EmbeddedSignupError('unsupported_environment', 'Embedded signup needs a browser; drive the three onboarding calls yourself outside one'));
+    }
+    const popup = openPopup(win, url, options);
     if (!popup) {
         return Promise.reject(new EmbeddedSignupError('popup_blocked', 'The signup window was blocked; allow popups and try again'));
     }
@@ -87,20 +217,31 @@ const openSignup = (url, options = {}) => {
             }
         };
         const onMessage = (event) => {
+            // Our own redirect page posting back, rather than the poll reading its URL.
+            // It may hold all three, so it can finish the flow on its own.
+            if (event.origin === win.location.origin) {
+                const returned = fromSameOrigin(event.data);
+                if (returned) {
+                    const error = str(returned.error) ?? str(returned.error_description);
+                    if (error) {
+                        finish(() => reject(new EmbeddedSignupError('signup_error', error)));
+                        return;
+                    }
+                    code = str(returned.code) ?? code;
+                    state = str(returned.state) ?? state;
+                    wabaId = str(returned.waba_id) ?? wabaId;
+                    phoneNumberId = str(returned.phone_number_id) ?? phoneNumberId;
+                    if (code)
+                        progress('code');
+                    if (wabaId && phoneNumberId)
+                        progress('ids');
+                    settleIfComplete();
+                    return;
+                }
+            }
             const payload = parsePayload(event.data);
             if (!payload)
                 return;
-            // Our own redirect page posting back, rather than the poll reading its URL.
-            if (event.origin === win.location.origin && payload.type === 'CRM_CHANNEL_ONBOARDING') {
-                if (typeof payload.code === 'string')
-                    code = payload.code;
-                if (typeof payload.state === 'string')
-                    state = payload.state;
-                if (code)
-                    progress('code');
-                settleIfComplete();
-                return;
-            }
             if (!META_ORIGINS.includes(event.origin))
                 return;
             if (payload.type !== 'WA_EMBEDDED_SIGNUP')
@@ -118,10 +259,11 @@ const openSignup = (url, options = {}) => {
                 finish(() => reject(new EmbeddedSignupError('signup_error', message)));
                 return;
             }
-            if (typeof data.waba_id === 'string')
-                wabaId = data.waba_id;
-            if (typeof data.phone_number_id === 'string')
-                phoneNumberId = data.phone_number_id;
+            // Only a finish event carries the ids; the rest are step changes.
+            if (FINISH_EVENTS.includes(String(payload.event))) {
+                wabaId = str(data.waba_id) ?? wabaId;
+                phoneNumberId = str(data.phone_number_id) ?? phoneNumberId;
+            }
             if (wabaId && phoneNumberId)
                 progress('ids');
             else if (typeof data.current_step === 'string')
@@ -139,24 +281,25 @@ const openSignup = (url, options = {}) => {
                     : 'The signup window was closed')));
                 return;
             }
-            if (code)
+            if (code && wabaId && phoneNumberId)
                 return;
             try {
-                const search = popup.location.search;
-                if (!search)
+                const returned = popup.location.search ? fromSameOrigin(popup.location.search) : undefined;
+                if (!returned)
                     return;
-                const params = new URLSearchParams(search);
-                const returned = params.get('code');
-                if (!returned) {
-                    // A refusal arrives here and never as a message; without this the
-                    // popup just sits there.
-                    const error = params.get('error_description') ?? params.get('error');
-                    if (error)
-                        finish(() => reject(new EmbeddedSignupError('signup_error', error)));
+                // A refusal arrives here and never as a message; without this the popup
+                // just sits there.
+                const error = str(returned.error) ?? str(returned.error_description);
+                if (error) {
+                    finish(() => reject(new EmbeddedSignupError('signup_error', error)));
                     return;
                 }
-                code = returned;
-                state = params.get('state') ?? state;
+                if (!returned.code)
+                    return;
+                code = str(returned.code) ?? code;
+                state = str(returned.state) ?? state;
+                wabaId = str(returned.waba_id) ?? wabaId;
+                phoneNumberId = str(returned.phone_number_id) ?? phoneNumberId;
                 progress('code');
                 settleIfComplete();
             }

package/dist/internal/embedded-signup.js.map

@@ -1 +1 @@
-{"version":3,"file":"embedded-signup.js","sourceRoot":"","sources":["../../src/internal/embedded-signup.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"embedded-signup.js","sourceRoot":"","sources":["../../src/internal/embedded-signup.ts"],"names":[],"mappings":"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"}

package/dist/resources/channels/onboarding.d.ts

@@ -1,4 +1,4 @@
-import type { ChannelOnboardingOption, ChannelResponse, CompleteOnboardingInput, OnboardingChannelType, OnboardingExchangeInput, OnboardingExchangeResult, OnboardingUrlInput, OnboardingUrlResult } from '../../types';
+import type { ChannelOnboardingOption, ChannelResponse, CompleteOnboardingInput, OnboardingChannelType, OnboardingExchangeInput, OnboardingExchangeResult, OnboardingPendingResult, OnboardingUrlInput, OnboardingUrlResult } from '../../types';
 import type { HttpClient } from '../../http';
 import { type OpenSignupOptions } from '../../internal/embedded-signup';
 /** Options for the one-call driver. */
@@ -7,20 +7,30 @@ export interface ConnectOptions extends OpenSignupOptions {
     type?: OnboardingChannelType;
     /** The inclusion to spend, when the plan carries more than one. */
     slug?: string;
-    /** A non-default redirect, which must be one the service is configured for. */
-    redirectUri?: string;
+    /** The BSP to connect through, by provider code. Omit for the active one. */
+    provider?: string;
+    /**
+     * Where the popup is handed back to. **Required**, and it has to be a page on
+     * this page's own origin -- that is what makes the outcome readable from here.
+     */
+    redirectUri: string;
 }
 /**
- * Connecting a channel. `connect()` does steps 1 to 3 and hands back the number
- * to confirm; or call `url()`, open the dialog yourself, then `exchange()`.
- * Either way the browser never sees a Meta credential.
+ * Connecting a channel. The browser only runs Meta's dialog: Meta returns to
+ * the service's callback, which redeems the code and sends the browser back to
+ * `redirectUri` with a `status` and a `token` -- no credential reaches this
+ * page. `connect()` drives all of it; or call `url()`, open the dialog
+ * yourself, and read the return off your own landing page.
  *
  * ```ts
  * // In the click handler for "Connect WhatsApp" -- not after an await.
- * const candidate = await crm.channelOnboarding.connect();
- * // Show candidate.phoneNumber, prefill a form from candidate.defaults...
+ * const candidate = await crm.channelOnboarding.connect({
+ *   redirectUri: 'https://console.example.com/channels/connected',
+ * });
+ * // One number, or several to choose between: candidate.numbers
  * const { data: channel } = await crm.channelOnboarding.complete({
  *   token: candidate.id,
+ *   phoneNumberId: chosen.id,
  *   name: form.name,
  * });
  * ```
@@ -29,22 +39,35 @@ export declare class ChannelOnboarding {
     private readonly http;
     constructor(http: HttpClient);
     /**
-     * `GET /v1/channels/onboarding/types` -- every family, available or not, so a
-     * picker greys rows out. Check `available`, show `reason`. Scope: `channels:read`.
+     * `GET /v1/channels/onboarding/types` -- the families this caller can connect
+     * right now. Anything the plan, the provider record or their role rules out is
+     * left out, so an empty list means "nothing to offer". Scope: `channels:read`.
      */
     types(): Promise<{
         data: ChannelOnboardingOption[];
     }>;
     /**
-     * `POST /v1/channels/onboarding/url` -- the dialog URL and the `state` to hand
-     * back. **Meta refuses to be framed**: use a popup. 402 if the plan has no room.
+     * `POST /v1/channels/onboarding/url` -- the page to open. **Meta refuses to
+     * be framed**: use a popup, or navigate. 402 if the plan has no room.
+     *
+     * `url` is a launcher on the app's own domain that forwards to the dialog
+     * (`dialogUrl`); `redirectUri` is where *we* return the browser, not what
+     * Meta is given -- that is `callbackUri`.
      */
-    url(input?: OnboardingUrlInput): Promise<{
+    url(input: OnboardingUrlInput): Promise<{
         data: OnboardingUrlResult;
     }>;
     /**
-     * `POST /v1/channels/onboarding/exchange` -- redeems the code. **Creates
-     * nothing**: show `phoneNumber`, Meta's own description, and let them confirm.
+     * `GET /v1/channels/onboarding/pending/:token` -- what the return URL's
+     * `token` refers to: the numbers it covers, and the form's prefill.
+     */
+    pending(token: string): Promise<{
+        data: OnboardingPendingResult;
+    }>;
+    /**
+     * `POST /v1/channels/onboarding/exchange` -- redeems a code you hold yourself,
+     * for a BSP app whose registered redirect is a page of yours rather than the
+     * service's callback. **Creates nothing**: show `phoneNumber` and confirm.
      */
     exchange(input: OnboardingExchangeInput): Promise<{
         data: OnboardingExchangeResult;
@@ -55,8 +78,12 @@ export declare class ChannelOnboarding {
      */
     complete(input: CompleteOnboardingInput): Promise<ChannelResponse>;
     /**
-     * The URL, the dialog and the exchange in one call. **Call it straight from the
-     * click handler**, or the popup is blocked. Rejects with `EmbeddedSignupError`.
+     * The URL, the dialog, and the record the callback leaves behind, in one call.
+     * **Call it straight from the click handler**, or the popup is blocked.
+     * Rejects with `EmbeddedSignupError`; `reason` carries the service's own code.
+     *
+     * What comes back is a *candidate* -- nothing exists until `complete()`, and
+     * if it holds several numbers the person picks one.
      */
-    connect(options?: ConnectOptions): Promise<OnboardingExchangeResult>;
+    connect(options: ConnectOptions): Promise<OnboardingPendingResult>;
 }

package/dist/resources/channels/onboarding.js

@@ -5,16 +5,21 @@ const paths_1 = require("../paths");
 const embedded_signup_1 = require("../../internal/embedded-signup");
 const ONBOARDING = `${paths_1.CHANNELS}/onboarding`;
 /**
- * Connecting a channel. `connect()` does steps 1 to 3 and hands back the number
- * to confirm; or call `url()`, open the dialog yourself, then `exchange()`.
- * Either way the browser never sees a Meta credential.
+ * Connecting a channel. The browser only runs Meta's dialog: Meta returns to
+ * the service's callback, which redeems the code and sends the browser back to
+ * `redirectUri` with a `status` and a `token` -- no credential reaches this
+ * page. `connect()` drives all of it; or call `url()`, open the dialog
+ * yourself, and read the return off your own landing page.
  *
  * ```ts
  * // In the click handler for "Connect WhatsApp" -- not after an await.
- * const candidate = await crm.channelOnboarding.connect();
- * // Show candidate.phoneNumber, prefill a form from candidate.defaults...
+ * const candidate = await crm.channelOnboarding.connect({
+ *   redirectUri: 'https://console.example.com/channels/connected',
+ * });
+ * // One number, or several to choose between: candidate.numbers
  * const { data: channel } = await crm.channelOnboarding.complete({
  *   token: candidate.id,
+ *   phoneNumberId: chosen.id,
  *   name: form.name,
  * });
  * ```
@@ -25,22 +30,35 @@ class ChannelOnboarding {
         this.http = http;
     }
     /**
-     * `GET /v1/channels/onboarding/types` -- every family, available or not, so a
-     * picker greys rows out. Check `available`, show `reason`. Scope: `channels:read`.
+     * `GET /v1/channels/onboarding/types` -- the families this caller can connect
+     * right now. Anything the plan, the provider record or their role rules out is
+     * left out, so an empty list means "nothing to offer". Scope: `channels:read`.
      */
     types() {
         return this.http.request('GET', `${ONBOARDING}/types`);
     }
     /**
-     * `POST /v1/channels/onboarding/url` -- the dialog URL and the `state` to hand
-     * back. **Meta refuses to be framed**: use a popup. 402 if the plan has no room.
+     * `POST /v1/channels/onboarding/url` -- the page to open. **Meta refuses to
+     * be framed**: use a popup, or navigate. 402 if the plan has no room.
+     *
+     * `url` is a launcher on the app's own domain that forwards to the dialog
+     * (`dialogUrl`); `redirectUri` is where *we* return the browser, not what
+     * Meta is given -- that is `callbackUri`.
      */
-    url(input = {}) {
+    url(input) {
         return this.http.request('POST', `${ONBOARDING}/url`, { body: input });
     }
     /**
-     * `POST /v1/channels/onboarding/exchange` -- redeems the code. **Creates
-     * nothing**: show `phoneNumber`, Meta's own description, and let them confirm.
+     * `GET /v1/channels/onboarding/pending/:token` -- what the return URL's
+     * `token` refers to: the numbers it covers, and the form's prefill.
+     */
+    pending(token) {
+        return this.http.request('GET', `${ONBOARDING}/pending/${encodeURIComponent(token)}`);
+    }
+    /**
+     * `POST /v1/channels/onboarding/exchange` -- redeems a code you hold yourself,
+     * for a BSP app whose registered redirect is a page of yours rather than the
+     * service's callback. **Creates nothing**: show `phoneNumber` and confirm.
      */
     exchange(input) {
         return this.http.request('POST', `${ONBOARDING}/exchange`, {
@@ -55,20 +73,22 @@ class ChannelOnboarding {
         return this.http.request('POST', `${ONBOARDING}/complete`, { body: input });
     }
     /**
-     * The URL, the dialog and the exchange in one call. **Call it straight from the
-     * click handler**, or the popup is blocked. Rejects with `EmbeddedSignupError`.
+     * The URL, the dialog, and the record the callback leaves behind, in one call.
+     * **Call it straight from the click handler**, or the popup is blocked.
+     * Rejects with `EmbeddedSignupError`; `reason` carries the service's own code.
+     *
+     * What comes back is a *candidate* -- nothing exists until `complete()`, and
+     * if it holds several numbers the person picks one.
      */
-    async connect(options = {}) {
-        const { type, slug, redirectUri, ...popup } = options;
-        const { data: session } = await this.url({ type, slug, redirectUri });
-        const credentials = await (0, embedded_signup_1.openSignup)(session.url, popup);
-        const { data } = await this.exchange({
-            // The one we issued, since the dialog may or may not return it.
-            state: session.state,
-            code: credentials.code,
-            wabaId: credentials.wabaId,
-            phoneNumberId: credentials.phoneNumberId,
-        });
+    async connect(options) {
+        const { type, slug, provider, redirectUri, ...popup } = options;
+        const { data: session } = await this.url({ type, slug, provider, redirectUri });
+        const returned = await (0, embedded_signup_1.awaitSignupReturn)(session.url, popup);
+        if (!returned.token) {
+            throw new embedded_signup_1.EmbeddedSignupError('signup_error', 'The signup came back without an onboarding token');
+        }
+        // The query string carries a summary; this is the whole record.
+        const { data } = await this.pending(returned.token);
         return data;
     }
 }