@zernio/node 0.2.1054 → 0.2.1056

package/dist/index.d.mts

@@ -20212,7 +20212,7 @@ type GetConnectUrlData = {
          */
         profileId: string;
         /**
-         * Refresh this existing account (a Zernio account id of the same platform on this profile; otherwise 400). The OAuth callback and the selection endpoints (select-page, select-organization, select-board, select-location, Instagram and Snapchat selection) refuse, with `reconnect_account_mismatch`, a login that would write to a different account of the platform on this profile instead of this one. While a profile holds one account per platform the login still replaces this account as before. In headless mode the marker travels in the redirect_url we hand you, so pass that URL back unchanged to the selection endpoint. On X it counts toward the OAuth state limit described under redirect_url.
+         * Refresh this existing account (a Zernio account id of the same platform on this profile; otherwise 400). The OAuth callback and the selection endpoints (select-page, select-organization, select-board, select-location, Instagram and Snapchat selection) refuse, with `reconnect_account_mismatch`, a login that would write to a different account of the platform on this profile instead of this one. In headless mode the marker travels in the redirect_url we hand you, so pass that URL back unchanged to the selection endpoint. On X it counts toward the OAuth state limit described under redirect_url.
          */
         reconnectAccountId?: string;
         /**
@@ -20244,7 +20244,8 @@ type GetConnectUrlData = {
          * - `pages_permission_declined`: the user declined the pages_show_list permission.
          * - `no_pages_granted`: the permission was granted with no Page ticked. Meta reports a user who
          * manages no Page the same way, so this covers both.
-         * - `granted_pages_not_listed`: Pages were ticked but Meta listed none the user can manage.
+         * - `granted_pages_not_listed`: Pages were ticked but Meta listed none the user can manage, and a
+         * direct read of each ticked Page returned no access token.
          *
          * Headless Facebook success (`step=select_page`): `userProfile` is JSON that was
          * percent-encoded once before being set as a query param, so it is encoded twice on the wire.
@@ -21111,7 +21112,7 @@ type SelectFacebookPageData = {
          */
         pageId?: string;
         /**
-         * Several Page IDs to connect from one sign-in, each as its own account. With two or more distinct IDs the response lists `accounts` and `failed` instead of `account`, and the request is refused with 400 while a profile holds one Facebook account and on a reconnect or an ads connect, which pick exactly one Page. A single distinct ID behaves exactly like pageId.
+         * Several Page IDs to connect from one sign-in, each as its own account. With two or more distinct IDs the response lists `accounts` and `failed` instead of `account`, and the request is refused with 400 on a reconnect or an ads connect, which pick exactly one Page. A single distinct ID behaves exactly like pageId.
          */
         pageIds?: Array<(string)>;
         /**
@@ -21237,7 +21238,7 @@ type SelectInstagramAccountData = {
          */
         pageId?: string;
         /**
-         * Several Page IDs whose linked Instagram accounts to connect from one sign-in, each as its own account. With two or more distinct IDs the response lists `accounts` and `failed` instead of `account`, and the request is refused with 400 while a profile holds one Instagram account and on a reconnect or an ads connect. A single distinct ID behaves exactly like pageId.
+         * Several Page IDs whose linked Instagram accounts to connect from one sign-in, each as its own account. With two or more distinct IDs the response lists `accounts` and `failed` instead of `account`, and the request is refused with 400 on a reconnect or an ads connect. A single distinct ID behaves exactly like pageId.
          */
         pageIds?: Array<(string)>;
         /**
@@ -22793,7 +22794,7 @@ type SelectLinkedInOrganizationData = {
          */
         accountType?: 'personal' | 'organization';
         /**
-         * Several accounts to connect from one sign-in (yourself and/or organizations), each as its own account. With two or more entries the response lists `accounts` and `failed` instead of `account`, and the request is refused with 400 while a profile holds one LinkedIn account and on a reconnect or an ads connect. A single entry behaves exactly like accountType.
+         * Several accounts to connect from one sign-in (yourself and/or organizations), each as its own account. With two or more entries the response lists `accounts` and `failed` instead of `account`, and the request is refused with 400 on a reconnect or an ads connect. A single entry behaves exactly like accountType.
          */
         selections?: Array<{
             accountType: 'personal' | 'organization';
@@ -33202,7 +33203,7 @@ type ReleasePhoneNumberError = (unknown | {
 type PurchasePhoneNumberData = {
     body: {
         /**
-         * Preferred profile for the number. One number = one profile, so when the requested profile already holds a number the API assigns the next free profile instead (or creates one) and returns the actual assignment in `profileId` on the response.
+         * Profile for the number, which may already hold other numbers. Without it the number goes to the default profile. The response's `profileId` carries the assignment.
          *
          */
         profileId: string;

package/dist/index.d.ts

@@ -20212,7 +20212,7 @@ type GetConnectUrlData = {
          */
         profileId: string;
         /**
-         * Refresh this existing account (a Zernio account id of the same platform on this profile; otherwise 400). The OAuth callback and the selection endpoints (select-page, select-organization, select-board, select-location, Instagram and Snapchat selection) refuse, with `reconnect_account_mismatch`, a login that would write to a different account of the platform on this profile instead of this one. While a profile holds one account per platform the login still replaces this account as before. In headless mode the marker travels in the redirect_url we hand you, so pass that URL back unchanged to the selection endpoint. On X it counts toward the OAuth state limit described under redirect_url.
+         * Refresh this existing account (a Zernio account id of the same platform on this profile; otherwise 400). The OAuth callback and the selection endpoints (select-page, select-organization, select-board, select-location, Instagram and Snapchat selection) refuse, with `reconnect_account_mismatch`, a login that would write to a different account of the platform on this profile instead of this one. In headless mode the marker travels in the redirect_url we hand you, so pass that URL back unchanged to the selection endpoint. On X it counts toward the OAuth state limit described under redirect_url.
          */
         reconnectAccountId?: string;
         /**
@@ -20244,7 +20244,8 @@ type GetConnectUrlData = {
          * - `pages_permission_declined`: the user declined the pages_show_list permission.
          * - `no_pages_granted`: the permission was granted with no Page ticked. Meta reports a user who
          * manages no Page the same way, so this covers both.
-         * - `granted_pages_not_listed`: Pages were ticked but Meta listed none the user can manage.
+         * - `granted_pages_not_listed`: Pages were ticked but Meta listed none the user can manage, and a
+         * direct read of each ticked Page returned no access token.
          *
          * Headless Facebook success (`step=select_page`): `userProfile` is JSON that was
          * percent-encoded once before being set as a query param, so it is encoded twice on the wire.
@@ -21111,7 +21112,7 @@ type SelectFacebookPageData = {
          */
         pageId?: string;
         /**
-         * Several Page IDs to connect from one sign-in, each as its own account. With two or more distinct IDs the response lists `accounts` and `failed` instead of `account`, and the request is refused with 400 while a profile holds one Facebook account and on a reconnect or an ads connect, which pick exactly one Page. A single distinct ID behaves exactly like pageId.
+         * Several Page IDs to connect from one sign-in, each as its own account. With two or more distinct IDs the response lists `accounts` and `failed` instead of `account`, and the request is refused with 400 on a reconnect or an ads connect, which pick exactly one Page. A single distinct ID behaves exactly like pageId.
          */
         pageIds?: Array<(string)>;
         /**
@@ -21237,7 +21238,7 @@ type SelectInstagramAccountData = {
          */
         pageId?: string;
         /**
-         * Several Page IDs whose linked Instagram accounts to connect from one sign-in, each as its own account. With two or more distinct IDs the response lists `accounts` and `failed` instead of `account`, and the request is refused with 400 while a profile holds one Instagram account and on a reconnect or an ads connect. A single distinct ID behaves exactly like pageId.
+         * Several Page IDs whose linked Instagram accounts to connect from one sign-in, each as its own account. With two or more distinct IDs the response lists `accounts` and `failed` instead of `account`, and the request is refused with 400 on a reconnect or an ads connect. A single distinct ID behaves exactly like pageId.
          */
         pageIds?: Array<(string)>;
         /**
@@ -22793,7 +22794,7 @@ type SelectLinkedInOrganizationData = {
          */
         accountType?: 'personal' | 'organization';
         /**
-         * Several accounts to connect from one sign-in (yourself and/or organizations), each as its own account. With two or more entries the response lists `accounts` and `failed` instead of `account`, and the request is refused with 400 while a profile holds one LinkedIn account and on a reconnect or an ads connect. A single entry behaves exactly like accountType.
+         * Several accounts to connect from one sign-in (yourself and/or organizations), each as its own account. With two or more entries the response lists `accounts` and `failed` instead of `account`, and the request is refused with 400 on a reconnect or an ads connect. A single entry behaves exactly like accountType.
          */
         selections?: Array<{
             accountType: 'personal' | 'organization';
@@ -33202,7 +33203,7 @@ type ReleasePhoneNumberError = (unknown | {
 type PurchasePhoneNumberData = {
     body: {
         /**
-         * Preferred profile for the number. One number = one profile, so when the requested profile already holds a number the API assigns the next free profile instead (or creates one) and returns the actual assignment in `profileId` on the response.
+         * Profile for the number, which may already hold other numbers. Without it the number goes to the default profile. The response's `profileId` carries the assignment.
          *
          */
         profileId: string;

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.1054",
+  version: "0.2.1056",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.1054",
+  version: "0.2.1056",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zernio/node",
-  "version": "0.2.1054",
+  "version": "0.2.1056",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -1642,12 +1642,12 @@ export const createInviteToken = <ThrowOnError extends boolean = false>(options:
  * Initiate an OAuth connection flow. Returns an authUrl to redirect the user to.
  * Standard flow: Zernio hosts the selection UI, then redirects to your redirect_url. Headless mode (headless=true): user is redirected to your redirect_url with OAuth data for custom UI. Use the platform-specific selection endpoints to complete.
  *
- * TikTok: every connection now goes through the TikTok for Business app. One TikTok account per
- * profile, so connecting on a profile that already holds one replaces it. Reconnecting the SAME
- * account keeps it and all of its history; authorizing a DIFFERENT TikTok account takes the slot
- * over and permanently deletes the previous account's analytics, inbox and DM history. The two
- * are told apart by the `@handle` stored at the last connect, so an account whose handle has
- * been renamed on TikTok since then reads as a different account. An authorization that leaves
+ * A profile can hold several accounts of the same platform: connecting a different account adds
+ * it as a new account, and reconnecting the SAME account keeps it and all of its history. Ads
+ * connections stay one per profile. On a legacy plan limited to N profiles, a new account is
+ * refused with 403 `platform_account_limit` once N accounts of its platform are connected.
+ *
+ * TikTok: every connection now goes through the TikTok for Business app. An authorization that leaves
  * out a permission the connected account needs changes nothing at all and comes back as
  * `missing_tiktok_permissions`; connect again and accept every permission on TikTok's screen.
  *
@@ -1944,7 +1944,7 @@ export const listInstagramPages = <ThrowOnError extends boolean = false>(options
  * Select the Page whose Instagram account to connect
  * Saves the selected Page as an Instagram account connected via Facebook Login. The Page access token becomes the account's access token, so every Instagram call for it runs against the Facebook Graph host.
  *
- * One Instagram account per profile: if the profile already has an Instagram account, this replaces it, and picking a different Instagram identity purges the previous account's conversations, external posts and stats.
+ * A different Instagram account is added next to any already connected on the profile; picking one already connected refreshes it.
  *
  */
 export const selectInstagramAccount = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<SelectInstagramAccountData, ThrowOnError>) => {
@@ -3009,7 +3009,7 @@ export const updateGmbLocation = <ThrowOnError extends boolean = false>(options:
 
 /**
  * Assign Google Business Profile location to another profile
- * Connect a Google Business Profile location onto a DIFFERENT profile by reusing the OAuth grant from an already-connected Google Business Profile account, with no browser and no re-authorization. Built for agencies whose single Google account has manager access to many client locations and who run one profile per client: connect one location the normal way (browser OAuth), then bulk-assign the rest onto each client's profile via this endpoint. The path `accountId` is a SOURCE connected Google Business Profile account (the token holder); the body `profileId` is the TARGET profile. Returns 409 if the target profile already has a Google Business Profile connection (switch its location with PUT gmb-locations instead).
+ * Connect a Google Business Profile location onto a DIFFERENT profile by reusing the OAuth grant from an already-connected Google Business Profile account, with no browser and no re-authorization. Built for agencies whose single Google account has manager access to many client locations and who run one profile per client: connect one location the normal way (browser OAuth), then bulk-assign the rest onto each client's profile via this endpoint. The path `accountId` is a SOURCE connected Google Business Profile account (the token holder); the body `profileId` is the TARGET profile, which may already hold other locations; assigning a location it already holds refreshes that account.
  *
  */
 export const assignGoogleBusinessLocation = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<AssignGoogleBusinessLocationData, ThrowOnError>) => {
@@ -5504,9 +5504,9 @@ export const listImessageSenders = <ThrowOnError extends boolean = false>(option
  * conversation endpoints. To have Zernio order a new sender for you, use
  * POST /v1/imessage/senders/order instead. Registration attaches the
  * monthly sender fee (billed while active) and requires a payment method
- * (402 without one). One sender per profile: re-registering the SAME
- * handle refreshes it; a different handle returns 409 until the existing
- * sender is canceled.
+ * (402 without one). Re-registering the SAME handle refreshes its account;
+ * a different handle is added as another sender, and a profile can hold
+ * several.
  *
  */
 export const registerImessageSender = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<RegisterImessageSenderData, ThrowOnError>) => {
@@ -5817,7 +5817,7 @@ export const listRcsAgents = <ThrowOnError extends boolean = false>(options?: Op
  * Request an RCS agent
  * Requests a new agent for a profile, with a new company (`brand`) or an existing one
  * (`brandId`, skips vetting when it is already verified). The request lands in our review:
- * nothing is filed with the carriers or billed until we submit it. One open agent per profile.
+ * nothing is filed with the carriers or billed until we submit it. A profile can hold several agents.
  * Requires usage-based billing and a card on file. Send an `Idempotency-Key` header to make
  * retries safe.
  *
@@ -7643,8 +7643,7 @@ export const createWhatsAppNumberKycLink = <ThrowOnError extends boolean = false
  *
  * `id` is the number record id from `GET /v1/phone-numbers`, not an account id.
  *
- * A profile holds at most one account per platform, so the destination must be
- * free of every platform this number occupies.
+ * The destination profile may already hold other numbers.
  *
  */
 export const moveWhatsAppNumberToProfile = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<MoveWhatsAppNumberToProfileData, ThrowOnError>) => {

package/src/generated/types.gen.ts

@@ -19144,7 +19144,7 @@ export type GetConnectUrlData = {
          */
         profileId: string;
         /**
-         * Refresh this existing account (a Zernio account id of the same platform on this profile; otherwise 400). The OAuth callback and the selection endpoints (select-page, select-organization, select-board, select-location, Instagram and Snapchat selection) refuse, with `reconnect_account_mismatch`, a login that would write to a different account of the platform on this profile instead of this one. While a profile holds one account per platform the login still replaces this account as before. In headless mode the marker travels in the redirect_url we hand you, so pass that URL back unchanged to the selection endpoint. On X it counts toward the OAuth state limit described under redirect_url.
+         * Refresh this existing account (a Zernio account id of the same platform on this profile; otherwise 400). The OAuth callback and the selection endpoints (select-page, select-organization, select-board, select-location, Instagram and Snapchat selection) refuse, with `reconnect_account_mismatch`, a login that would write to a different account of the platform on this profile instead of this one. In headless mode the marker travels in the redirect_url we hand you, so pass that URL back unchanged to the selection endpoint. On X it counts toward the OAuth state limit described under redirect_url.
          */
         reconnectAccountId?: string;
         /**
@@ -19176,7 +19176,8 @@ export type GetConnectUrlData = {
          * - `pages_permission_declined`: the user declined the pages_show_list permission.
          * - `no_pages_granted`: the permission was granted with no Page ticked. Meta reports a user who
          * manages no Page the same way, so this covers both.
-         * - `granted_pages_not_listed`: Pages were ticked but Meta listed none the user can manage.
+         * - `granted_pages_not_listed`: Pages were ticked but Meta listed none the user can manage, and a
+         * direct read of each ticked Page returned no access token.
          *
          * Headless Facebook success (`step=select_page`): `userProfile` is JSON that was
          * percent-encoded once before being set as a query param, so it is encoded twice on the wire.
@@ -20071,7 +20072,7 @@ export type SelectFacebookPageData = {
      */
     pageId?: string;
     /**
-     * Several Page IDs to connect from one sign-in, each as its own account. With two or more distinct IDs the response lists `accounts` and `failed` instead of `account`, and the request is refused with 400 while a profile holds one Facebook account and on a reconnect or an ads connect, which pick exactly one Page. A single distinct ID behaves exactly like pageId.
+     * Several Page IDs to connect from one sign-in, each as its own account. With two or more distinct IDs the response lists `accounts` and `failed` instead of `account`, and the request is refused with 400 on a reconnect or an ads connect, which pick exactly one Page. A single distinct ID behaves exactly like pageId.
      */
     pageIds?: Array<(string)>;
     /**
@@ -20203,7 +20204,7 @@ export type SelectInstagramAccountData = {
          */
         pageId?: string;
         /**
-         * Several Page IDs whose linked Instagram accounts to connect from one sign-in, each as its own account. With two or more distinct IDs the response lists `accounts` and `failed` instead of `account`, and the request is refused with 400 while a profile holds one Instagram account and on a reconnect or an ads connect. A single distinct ID behaves exactly like pageId.
+         * Several Page IDs whose linked Instagram accounts to connect from one sign-in, each as its own account. With two or more distinct IDs the response lists `accounts` and `failed` instead of `account`, and the request is refused with 400 on a reconnect or an ads connect. A single distinct ID behaves exactly like pageId.
          */
         pageIds?: Array<(string)>;
         /**
@@ -21849,7 +21850,7 @@ export type SelectLinkedInOrganizationData = {
          */
         accountType?: 'personal' | 'organization';
         /**
-         * Several accounts to connect from one sign-in (yourself and/or organizations), each as its own account. With two or more entries the response lists `accounts` and `failed` instead of `account`, and the request is refused with 400 while a profile holds one LinkedIn account and on a reconnect or an ads connect. A single entry behaves exactly like accountType.
+         * Several accounts to connect from one sign-in (yourself and/or organizations), each as its own account. With two or more entries the response lists `accounts` and `failed` instead of `account`, and the request is refused with 400 on a reconnect or an ads connect. A single entry behaves exactly like accountType.
          */
         selections?: Array<{
             accountType: 'personal' | 'organization';
@@ -33086,7 +33087,7 @@ export type ReleasePhoneNumberError = (unknown | {
 export type PurchasePhoneNumberData = {
     body: {
         /**
-         * Preferred profile for the number. One number = one profile, so when the requested profile already holds a number the API assigns the next free profile instead (or creates one) and returns the actual assignment in `profileId` on the response.
+         * Profile for the number, which may already hold other numbers. Without it the number goes to the default profile. The response's `profileId` carries the assignment.
          *
          */
         profileId: string;