ab-ecosystem-cpass 1.0.11 → 1.0.13

package/README.md

@@ -229,6 +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` `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/client.d.ts

@@ -14,6 +14,7 @@ import { InboxMedia } from './resources/audience/inbox-media';
 import { Notifications } from './resources/audience/notifications';
 import { DataStoreCollections, DataStoreRecords, DataStores } from './resources/data-stores';
 import { Channels } from './resources/channels/channels';
+import { ChannelOnboarding } from './resources/channels/onboarding';
 import { Templates } from './resources/channels/templates';
 import { ChannelWebhooks } from './resources/channels/webhooks';
 import { Billing } from './resources/channels/billing';
@@ -95,6 +96,11 @@ export declare class CrmClient {
     readonly dataStoreRecords: DataStoreRecords;
     /** Channels, and the provider properties that hang off them. */
     readonly channels: Channels;
+    /**
+     * Connecting a new channel. Separate from `channels` because it is the one
+     * channel operation that walks a person through a dialog on Meta's own site.
+     */
+    readonly channelOnboarding: ChannelOnboarding;
     /** WhatsApp message templates, per channel. */
     readonly templates: Templates;
     /** Channel webhooks: where a channel's message traffic is delivered. */

package/dist/client.js

@@ -19,6 +19,7 @@ const notifications_1 = require("./resources/audience/notifications");
 const data_stores_1 = require("./resources/data-stores");
 // Channels
 const channels_1 = require("./resources/channels/channels");
+const onboarding_1 = require("./resources/channels/onboarding");
 const templates_1 = require("./resources/channels/templates");
 const webhooks_2 = require("./resources/channels/webhooks");
 const billing_1 = require("./resources/channels/billing");
@@ -103,6 +104,11 @@ class CrmClient {
     // -- Channels -------------------------------------------------------------
     /** Channels, and the provider properties that hang off them. */
     channels;
+    /**
+     * Connecting a new channel. Separate from `channels` because it is the one
+     * channel operation that walks a person through a dialog on Meta's own site.
+     */
+    channelOnboarding;
     /** WhatsApp message templates, per channel. */
     templates;
     /** Channel webhooks: where a channel's message traffic is delivered. */
@@ -148,6 +154,7 @@ class CrmClient {
         this.dataStoreCollections = new data_stores_1.DataStoreCollections(http);
         this.dataStoreRecords = new data_stores_1.DataStoreRecords(http);
         this.channels = new channels_1.Channels(http);
+        this.channelOnboarding = new onboarding_1.ChannelOnboarding(http);
         this.templates = new templates_1.Templates(http);
         this.channelWebhooks = new webhooks_2.ChannelWebhooks(http);
         this.billing = new billing_1.Billing(http);

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;AAAA,iCAAwD;AAExD,WAAW;AACX,4DAAyD;AACzD,oEAAgE;AAChE,sEAAkE;AAClE,wEAAoE;AACpE,sEAAkE;AAClE,4DAAyD;AACzD,oEAAgE;AAChE,wEAA8D;AAC9D,wEAA8D;AAC9D,4DAAyD;AACzD,gFAA4E;AAC5E,kEAA8D;AAC9D,sEAAmE;AACnE,yDAIiC;AAEjC,WAAW;AACX,4DAAyD;AACzD,8DAA2D;AAC3D,4DAAgE;AAChE,0DAAuD;AACvD,wDAAqD;AACrD,4DAAyD;AAEzD,WAAW;AACX,qDAAkD;AAClD,qEAAiE;AAEjE;;;;;;;;;;;GAWG;AACH,MAAa,SAAS;IACpB,4EAA4E;IAE5E,gDAAgD;IACvC,QAAQ,CAAW;IAC5B,oDAAoD;IAC3C,WAAW,CAAc;IAClC,kEAAkE;IACzD,YAAY,CAAe;IACpC,qDAAqD;IAC5C,YAAY,CAAe;IACpC;;;;;;;OAOG;IACM,aAAa,CAAgB;IACtC,uCAAuC;IAC9B,QAAQ,CAAW;IAC5B,qFAAqF;IAC5E,WAAW,CAAc;IAClC,kEAAkE;IACzD,OAAO,CAAU;IAC1B,yDAAyD;IAChD,OAAO,CAAU;IAC1B,0DAA0D;IACjD,QAAQ,CAAW;IAC5B;;;OAGG;IACM,iBAAiB,CAAoB;IAE9C;;;;;;OAMG;IACM,UAAU,CAAa;IAEhC;;;;OAIG;IACM,aAAa,CAAgB;IAEtC;;;;;;;OAOG;IACM,UAAU,CAAa;IAChC,gFAAgF;IACvE,oBAAoB,CAAuB;IACpD,mFAAmF;IAC1E,gBAAgB,CAAmB;IAE5C,4EAA4E;IAE5E,gEAAgE;IACvD,QAAQ,CAAW;IAC5B,+CAA+C;IACtC,SAAS,CAAY;IAC9B,wEAAwE;IAC/D,eAAe,CAAkB;IAC1C,yDAAyD;IAChD,OAAO,CAAU;IAC1B,6BAA6B;IACpB,MAAM,CAAS;IACxB,6BAA6B;IACpB,QAAQ,CAAW;IAE5B,4EAA4E;IAE5E;;;;;;;OAOG;IACM,SAAS,CAAY;IAC9B;;;;OAIG;IACM,gBAAgB,CAAmB;IAE5C,YAAY,OAAsB;QAChC,MAAM,IAAI,GAAG,IAAI,iBAAU,CAAC,OAAO,CAAC,CAAC;QAErC,IAAI,CAAC,QAAQ,GAAG,IAAI,mBAAQ,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,IAAI,0BAAW,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,YAAY,GAAG,IAAI,4BAAY,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,YAAY,GAAG,IAAI,4BAAY,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,aAAa,GAAG,IAAI,8BAAa,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,GAAG,IAAI,mBAAQ,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,IAAI,0BAAW,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,IAAI,wBAAO,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,IAAI,wBAAO,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,IAAI,mBAAQ,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,iBAAiB,GAAG,IAAI,sCAAiB,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,UAAU,GAAG,IAAI,wBAAU,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,aAAa,GAAG,IAAI,6BAAa,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,UAAU,GAAG,IAAI,wBAAU,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,oBAAoB,GAAG,IAAI,kCAAoB,CAAC,IAAI,CAAC,CAAC;QAC3D,IAAI,CAAC,gBAAgB,GAAG,IAAI,8BAAgB,CAAC,IAAI,CAAC,CAAC;QAEnD,IAAI,CAAC,QAAQ,GAAG,IAAI,mBAAQ,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,IAAI,qBAAS,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,eAAe,GAAG,IAAI,0BAAe,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,IAAI,iBAAO,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,IAAI,eAAM,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,mBAAQ,CAAC,IAAI,CAAC,CAAC;QAEnC,uEAAuE;QACvE,yEAAyE;QACzE,WAAW;QACX,IAAI,CAAC,SAAS,GAAG,IAAI,qBAAS,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,gBAAgB,GAAG,IAAI,oCAAgB,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;CACF;AApID,8BAoIC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -25,6 +25,9 @@ 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 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.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);
@@ -71,6 +71,13 @@ Object.defineProperty(exports, "resolveAudience", { enumerable: true, get: funct
 // Channels
 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 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");
 Object.defineProperty(exports, "Templates", { enumerable: true, get: function () { return templates_1.Templates; } });
 var webhooks_2 = require("./resources/channels/webhooks");

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,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

@@ -0,0 +1,46 @@
+import type { OnboardingReturn, SignupCredentials } from '../types';
+/**
+ * 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 {
+    /** Window name, so a second call reuses the popup rather than opening two. */
+    name?: string;
+    width?: number;
+    height?: number;
+    /** How long to wait for both halves. Default 15 minutes. */
+    timeoutMs?: number;
+    /** For a console showing more than a spinner. `step` is Meta's own `current_step`. */
+    onProgress?: (event: {
+        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';
+    /** 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);
+}
+/**
+ * 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

@@ -0,0 +1,318 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openSignup = exports.awaitSignupReturn = exports.EmbeddedSignupError = void 0;
+/** Thrown for every way the dialog can fail to produce credentials. */
+class EmbeddedSignupError extends Error {
+    code;
+    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;
+const browser = () => {
+    const candidate = globalThis.window;
+    return candidate && typeof candidate.open === 'function' ? candidate : undefined;
+};
+/** An object in most browsers, a JSON string in some. */
+const parsePayload = (data) => {
+    if (typeof data === 'string') {
+        try {
+            const parsed = JSON.parse(data);
+            return typeof parsed === 'object' && parsed !== null ? parsed : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    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;
+    }
+};
+/**
+ * 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 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);
+    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'));
+    }
+    return new Promise((resolve, reject) => {
+        let code;
+        let state;
+        let wabaId;
+        let phoneNumberId;
+        let settled = false;
+        const progress = (phase, step) => {
+            try {
+                options.onProgress?.({ phase, step });
+            }
+            catch {
+                // A console's callback is not allowed to break the flow.
+            }
+        };
+        const finish = (outcome) => {
+            if (settled)
+                return;
+            settled = true;
+            win.removeEventListener('message', onMessage);
+            win.clearInterval(poll);
+            win.clearTimeout(timer);
+            // On success too: the console is about to render that confirmation properly.
+            try {
+                if (!popup.closed)
+                    popup.close();
+            }
+            catch {
+                // Cross-origin as it closed; the window is the user's problem now.
+            }
+            outcome();
+        };
+        /** Resolves only once both halves are in. */
+        const settleIfComplete = () => {
+            if (code && state && wabaId && phoneNumberId) {
+                const credentials = { code, state, wabaId, phoneNumberId };
+                finish(() => resolve(credentials));
+            }
+        };
+        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;
+            if (!META_ORIGINS.includes(event.origin))
+                return;
+            if (payload.type !== 'WA_EMBEDDED_SIGNUP')
+                return;
+            const data = (payload.data ?? {});
+            // Backing out is not worth a stack trace, but it has to reject or the
+            // promise never settles.
+            if (payload.event === 'CANCEL') {
+                const step = typeof data.current_step === 'string' ? data.current_step : undefined;
+                finish(() => reject(new EmbeddedSignupError('cancelled', step ? `Signup was cancelled at the "${step}" step` : 'Signup was cancelled')));
+                return;
+            }
+            if (payload.event === 'ERROR') {
+                const message = typeof data.error_message === 'string' ? data.error_message : 'Meta reported an error';
+                finish(() => reject(new EmbeddedSignupError('signup_error', message)));
+                return;
+            }
+            // 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')
+                progress('step', data.current_step);
+            settleIfComplete();
+        };
+        /**
+         * Same-origin once the dialog redirects to our `redirect_uri`; before that
+         * reading `location` throws. Also the only signal that the window was closed.
+         */
+        const poll = win.setInterval(() => {
+            if (popup.closed) {
+                finish(() => reject(new EmbeddedSignupError('popup_closed', code || wabaId
+                    ? 'The signup window was closed before it finished'
+                    : 'The signup window was closed')));
+                return;
+            }
+            if (code && wabaId && phoneNumberId)
+                return;
+            try {
+                const returned = popup.location.search ? fromSameOrigin(popup.location.search) : undefined;
+                if (!returned)
+                    return;
+                // 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;
+                }
+                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();
+            }
+            catch {
+                // Still on Meta's origin, 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);
+        progress('opened');
+    });
+};
+exports.openSignup = openSignup;
+//# sourceMappingURL=embedded-signup.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,89 @@
+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. */
+export interface ConnectOptions extends OpenSignupOptions {
+    /** Which family to connect. Only `whatsapp` today, and the default. */
+    type?: OnboardingChannelType;
+    /** The inclusion to spend, when the plan carries more than one. */
+    slug?: 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. 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({
+ *   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,
+ * });
+ * ```
+ */
+export declare class ChannelOnboarding {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * `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 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<{
+        data: OnboardingUrlResult;
+    }>;
+    /**
+     * `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;
+    }>;
+    /**
+     * `POST /v1/channels/onboarding/complete` -- creates the channel, **inactive**:
+     * `setProp(id, 'wa_pin_update')` brings it up, or `wa_biz_update` for a WA Biz number.
+     */
+    complete(input: CompleteOnboardingInput): Promise<ChannelResponse>;
+    /**
+     * 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<OnboardingPendingResult>;
+}