@zernio/node 0.2.1053 → 0.2.1055

package/dist/index.d.mts

@@ -1973,6 +1973,12 @@ type AccountsListResponse = {
      * Only present when page/limit params are provided
      */
     pagination?: Pagination;
+    /**
+     * Only with profileIds and perProfile. Accounts matching the filters per profile ID; a profile with none is absent.
+     */
+    profileTotals?: {
+        [key: string]: (number);
+    };
 };
 type AccountWithFollowerStats = SocialAccount & {
     /**
@@ -10618,6 +10624,10 @@ type Profile = {
      * Only present when includeOverLimit=true. Indicates if this profile exceeds the plan limit.
      */
     isOverLimit?: boolean;
+    /**
+     * In the profile list. Connected accounts on the profile, including ones that need reconnecting; phone and SMS number internals and posting accounts hidden by an ads connect are not counted.
+     */
+    accountCount?: number;
     createdAt?: string;
 };
 type ProfileCreateResponse = {
@@ -19221,6 +19231,10 @@ type ListAccountsData = {
          *
          */
         page?: number;
+        /**
+         * Return a preview of each profile in profileIds: the newest account of every platform it has, topped up to at least N. Requires profileIds; cannot be combined with page and limit.
+         */
+        perProfile?: number;
         /**
          * Filter accounts by platform (e.g. "instagram", "twitter").
          */
@@ -19229,6 +19243,10 @@ type ListAccountsData = {
          * Filter accounts by profile ID. Must be a valid ObjectId.
          */
         profileId?: string;
+        /**
+         * Comma-separated profile IDs (up to 50) to preview, together with perProfile. The response then also carries `profileTotals`.
+         */
+        profileIds?: string;
         /**
          * Filter accounts by connection status. `connected` returns healthy accounts; `disconnected` returns accounts that need reconnection (per the same reconnection check surfaced in the dashboard). Omit to return accounts in any status. When combined with page/limit, pagination totals reflect the filtered result set.
          *
@@ -20194,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;
         /**
@@ -21093,7 +21111,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)>;
         /**
@@ -21219,7 +21237,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)>;
         /**
@@ -22775,7 +22793,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';
@@ -33184,7 +33202,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

@@ -1973,6 +1973,12 @@ type AccountsListResponse = {
      * Only present when page/limit params are provided
      */
     pagination?: Pagination;
+    /**
+     * Only with profileIds and perProfile. Accounts matching the filters per profile ID; a profile with none is absent.
+     */
+    profileTotals?: {
+        [key: string]: (number);
+    };
 };
 type AccountWithFollowerStats = SocialAccount & {
     /**
@@ -10618,6 +10624,10 @@ type Profile = {
      * Only present when includeOverLimit=true. Indicates if this profile exceeds the plan limit.
      */
     isOverLimit?: boolean;
+    /**
+     * In the profile list. Connected accounts on the profile, including ones that need reconnecting; phone and SMS number internals and posting accounts hidden by an ads connect are not counted.
+     */
+    accountCount?: number;
     createdAt?: string;
 };
 type ProfileCreateResponse = {
@@ -19221,6 +19231,10 @@ type ListAccountsData = {
          *
          */
         page?: number;
+        /**
+         * Return a preview of each profile in profileIds: the newest account of every platform it has, topped up to at least N. Requires profileIds; cannot be combined with page and limit.
+         */
+        perProfile?: number;
         /**
          * Filter accounts by platform (e.g. "instagram", "twitter").
          */
@@ -19229,6 +19243,10 @@ type ListAccountsData = {
          * Filter accounts by profile ID. Must be a valid ObjectId.
          */
         profileId?: string;
+        /**
+         * Comma-separated profile IDs (up to 50) to preview, together with perProfile. The response then also carries `profileTotals`.
+         */
+        profileIds?: string;
         /**
          * Filter accounts by connection status. `connected` returns healthy accounts; `disconnected` returns accounts that need reconnection (per the same reconnection check surfaced in the dashboard). Omit to return accounts in any status. When combined with page/limit, pagination totals reflect the filtered result set.
          *
@@ -20194,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;
         /**
@@ -21093,7 +21111,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)>;
         /**
@@ -21219,7 +21237,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)>;
         /**
@@ -22775,7 +22793,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';
@@ -33184,7 +33202,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.1053",
+  version: "0.2.1055",
   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.1053",
+  version: "0.2.1055",
   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.1053",
+  "version": "0.2.1055",
   "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

@@ -10,6 +10,12 @@ export type AccountsListResponse = {
      * Only present when page/limit params are provided
      */
     pagination?: Pagination;
+    /**
+     * Only with profileIds and perProfile. Accounts matching the filters per profile ID; a profile with none is absent.
+     */
+    profileTotals?: {
+        [key: string]: (number);
+    };
 };
 
 export type AccountWithFollowerStats = SocialAccount & {
@@ -9036,6 +9042,10 @@ export type Profile = {
      * Only present when includeOverLimit=true. Indicates if this profile exceeds the plan limit.
      */
     isOverLimit?: boolean;
+    /**
+     * In the profile list. Connected accounts on the profile, including ones that need reconnecting; phone and SMS number internals and posting accounts hidden by an ads connect are not counted.
+     */
+    accountCount?: number;
     createdAt?: string;
 };
 
@@ -18087,6 +18097,10 @@ export type ListAccountsData = {
          *
          */
         page?: number;
+        /**
+         * Return a preview of each profile in profileIds: the newest account of every platform it has, topped up to at least N. Requires profileIds; cannot be combined with page and limit.
+         */
+        perProfile?: number;
         /**
          * Filter accounts by platform (e.g. "instagram", "twitter").
          */
@@ -18095,6 +18109,10 @@ export type ListAccountsData = {
          * Filter accounts by profile ID. Must be a valid ObjectId.
          */
         profileId?: string;
+        /**
+         * Comma-separated profile IDs (up to 50) to preview, together with perProfile. The response then also carries `profileTotals`.
+         */
+        profileIds?: string;
         /**
          * Filter accounts by connection status. `connected` returns healthy accounts; `disconnected` returns accounts that need reconnection (per the same reconnection check surfaced in the dashboard). Omit to return accounts in any status. When combined with page/limit, pagination totals reflect the filtered result set.
          *
@@ -19126,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;
         /**
@@ -20053,7 +20071,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)>;
     /**
@@ -20185,7 +20203,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)>;
         /**
@@ -21831,7 +21849,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';
@@ -33068,7 +33086,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;