@zernio/node 0.2.1483 → 0.2.1485

package/dist/index.d.mts

@@ -15357,6 +15357,10 @@ type Post = {
      * Queue ID if the post was scheduled via a specific queue
      */
     queueId?: string;
+    /**
+     * Profile the post is filed under. Set only on drafts that have no platforms.
+     */
+    profileId?: string;
     createdAt?: string;
     /**
      * Last change to the post or to any of its platforms (a publish, a failure, a resolved URL).
@@ -16719,6 +16723,13 @@ type SocialAccount = {
      *
      */
     enabled?: boolean;
+    /**
+     * Facebook accounts only (absent on every other platform). Whether this Facebook account syncs the Meta ads of the ad accounts it reaches, the way a `metaads` connection does.
+     *
+     * Off by default; set it with `PUT /v1/accounts/{accountId}`. Synced active ads count on the managed ads meter like ads from a Meta Ads connection.
+     *
+     */
+    metaAdsSyncEnabled?: boolean;
     /**
      * End of the account's publishing cooldown. Compare it with the current time: a value in the past means the cooldown has ended (the field is cleared on the next successful publish); null means no cooldown since the last successful publish.
      *
@@ -19055,7 +19066,9 @@ type WebhookPayloadAccountDisconnected = {
         username: string;
         displayName?: string;
         /**
-         * Whether the disconnection was intentional (user action) or unintentional (token expired/revoked)
+         * intentional: removed on purpose, for example with DELETE /v1/accounts/{accountId} or by a switch to the Free plan for the accounts over its limit. The account is deleted permanently 1 hour later unless the same account is reconnected within that hour.
+         *
+         * unintentional: the connection broke (token expired or revoked, access lost on the platform). The account stays in Zernio, inactive, until it is reconnected (keeping its accountId) or removed.
          */
         disconnectionType: 'intentional' | 'unintentional';
         /**
@@ -19070,7 +19083,9 @@ type WebhookPayloadAccountDisconnected = {
 };
 type event5 = 'account.disconnected';
 /**
- * Whether the disconnection was intentional (user action) or unintentional (token expired/revoked)
+ * intentional: removed on purpose, for example with DELETE /v1/accounts/{accountId} or by a switch to the Free plan for the accounts over its limit. The account is deleted permanently 1 hour later unless the same account is reconnected within that hour.
+ *
+ * unintentional: the connection broke (token expired or revoked, access lost on the platform). The account stays in Zernio, inactive, until it is reconnected (keeping its accountId) or removed.
  */
 type disconnectionType = 'intentional' | 'unintentional';
 /**
@@ -27995,7 +28010,7 @@ type ListPostsData = {
         page?: number;
         platform?: string;
         /**
-         * Filter posts to a specific profile (24-char hex ObjectId). Omit it, or send `all` or an empty value, to list posts across every profile.
+         * Filter posts to a specific profile (24-char hex ObjectId), including drafts filed under it without platforms. Omit it, or send `all` or an empty value, to list posts across every profile.
          */
         profileId?: string;
         /**
@@ -28158,6 +28173,10 @@ type CreatePostData = {
          *
          */
         queueId?: string;
+        /**
+         * Files a draft with no platforms under this profile so it lists under ?profileId= and profile-scoped API keys. Ignored when platforms are set. When promoting the draft via PUT, send platforms, isDraft false and scheduledFor again.
+         */
+        profileId?: string;
     };
     headers?: {
         /**
@@ -28922,6 +28941,28 @@ type UpdateAccountData = {
              */
             inbox?: boolean;
         };
+        /**
+         * Facebook only (400 `invalid_field_value` on any other platform). Off by default for every Facebook account.
+         *
+         * `true` makes this account sync the Meta ads of the ad accounts it reaches, like a `metaads` connection.
+         *
+         * - The first sync starts at once (14 days, then 90 days of history in the background) and fires `account.ads.initial_sync_completed` for this `accountId` with `platform: metaads`.
+         * - It then refreshes on the Meta Ads schedule.
+         * - Each switch from `false` to `true` runs another initial sync and fires the webhook again. Sending `true` while it is on changes nothing.
+         * - Needs `ads_management` and `ads_read` on the account (403 `reconnect_required` otherwise, with `details.requiredPermissions`).
+         * - Needs ads access (403 `ads_addon_required`) and room in the managed ads allowance (403 `ads_allowance_exceeded`).
+         * - While a `metaads` connection has this account as `parentAccountId`, that connection syncs the ads instead.
+         *
+         * Synced active ads count on the managed ads meter like ads from a Meta Ads
+         * connection.
+         *
+         * `false` stops the sync. Ads already synced are kept, never deleted: they
+         * stop updating and stop counting on the meter, and a `metaads` connection
+         * of yours that reaches the same ad account takes them over. Posting, inbox
+         * and comments on the account are not affected.
+         *
+         */
+        metaAdsSyncEnabled?: boolean;
     };
     path: {
         accountId: string;
@@ -28940,8 +28981,12 @@ type UpdateAccountResponse = ({
         analytics?: boolean;
         inbox?: boolean;
     };
+    /**
+     * The resulting setting, returned only when the request body included `metaAdsSyncEnabled`.
+     */
+    metaAdsSyncEnabled?: boolean;
 });
-type UpdateAccountError = (unknown | ErrorResponse | {
+type UpdateAccountError = (ErrorResponse | unknown | {
     error?: string;
 });
 type MoveAccountToProfileData = {

package/dist/index.d.ts

@@ -15357,6 +15357,10 @@ type Post = {
      * Queue ID if the post was scheduled via a specific queue
      */
     queueId?: string;
+    /**
+     * Profile the post is filed under. Set only on drafts that have no platforms.
+     */
+    profileId?: string;
     createdAt?: string;
     /**
      * Last change to the post or to any of its platforms (a publish, a failure, a resolved URL).
@@ -16719,6 +16723,13 @@ type SocialAccount = {
      *
      */
     enabled?: boolean;
+    /**
+     * Facebook accounts only (absent on every other platform). Whether this Facebook account syncs the Meta ads of the ad accounts it reaches, the way a `metaads` connection does.
+     *
+     * Off by default; set it with `PUT /v1/accounts/{accountId}`. Synced active ads count on the managed ads meter like ads from a Meta Ads connection.
+     *
+     */
+    metaAdsSyncEnabled?: boolean;
     /**
      * End of the account's publishing cooldown. Compare it with the current time: a value in the past means the cooldown has ended (the field is cleared on the next successful publish); null means no cooldown since the last successful publish.
      *
@@ -19055,7 +19066,9 @@ type WebhookPayloadAccountDisconnected = {
         username: string;
         displayName?: string;
         /**
-         * Whether the disconnection was intentional (user action) or unintentional (token expired/revoked)
+         * intentional: removed on purpose, for example with DELETE /v1/accounts/{accountId} or by a switch to the Free plan for the accounts over its limit. The account is deleted permanently 1 hour later unless the same account is reconnected within that hour.
+         *
+         * unintentional: the connection broke (token expired or revoked, access lost on the platform). The account stays in Zernio, inactive, until it is reconnected (keeping its accountId) or removed.
          */
         disconnectionType: 'intentional' | 'unintentional';
         /**
@@ -19070,7 +19083,9 @@ type WebhookPayloadAccountDisconnected = {
 };
 type event5 = 'account.disconnected';
 /**
- * Whether the disconnection was intentional (user action) or unintentional (token expired/revoked)
+ * intentional: removed on purpose, for example with DELETE /v1/accounts/{accountId} or by a switch to the Free plan for the accounts over its limit. The account is deleted permanently 1 hour later unless the same account is reconnected within that hour.
+ *
+ * unintentional: the connection broke (token expired or revoked, access lost on the platform). The account stays in Zernio, inactive, until it is reconnected (keeping its accountId) or removed.
  */
 type disconnectionType = 'intentional' | 'unintentional';
 /**
@@ -27995,7 +28010,7 @@ type ListPostsData = {
         page?: number;
         platform?: string;
         /**
-         * Filter posts to a specific profile (24-char hex ObjectId). Omit it, or send `all` or an empty value, to list posts across every profile.
+         * Filter posts to a specific profile (24-char hex ObjectId), including drafts filed under it without platforms. Omit it, or send `all` or an empty value, to list posts across every profile.
          */
         profileId?: string;
         /**
@@ -28158,6 +28173,10 @@ type CreatePostData = {
          *
          */
         queueId?: string;
+        /**
+         * Files a draft with no platforms under this profile so it lists under ?profileId= and profile-scoped API keys. Ignored when platforms are set. When promoting the draft via PUT, send platforms, isDraft false and scheduledFor again.
+         */
+        profileId?: string;
     };
     headers?: {
         /**
@@ -28922,6 +28941,28 @@ type UpdateAccountData = {
              */
             inbox?: boolean;
         };
+        /**
+         * Facebook only (400 `invalid_field_value` on any other platform). Off by default for every Facebook account.
+         *
+         * `true` makes this account sync the Meta ads of the ad accounts it reaches, like a `metaads` connection.
+         *
+         * - The first sync starts at once (14 days, then 90 days of history in the background) and fires `account.ads.initial_sync_completed` for this `accountId` with `platform: metaads`.
+         * - It then refreshes on the Meta Ads schedule.
+         * - Each switch from `false` to `true` runs another initial sync and fires the webhook again. Sending `true` while it is on changes nothing.
+         * - Needs `ads_management` and `ads_read` on the account (403 `reconnect_required` otherwise, with `details.requiredPermissions`).
+         * - Needs ads access (403 `ads_addon_required`) and room in the managed ads allowance (403 `ads_allowance_exceeded`).
+         * - While a `metaads` connection has this account as `parentAccountId`, that connection syncs the ads instead.
+         *
+         * Synced active ads count on the managed ads meter like ads from a Meta Ads
+         * connection.
+         *
+         * `false` stops the sync. Ads already synced are kept, never deleted: they
+         * stop updating and stop counting on the meter, and a `metaads` connection
+         * of yours that reaches the same ad account takes them over. Posting, inbox
+         * and comments on the account are not affected.
+         *
+         */
+        metaAdsSyncEnabled?: boolean;
     };
     path: {
         accountId: string;
@@ -28940,8 +28981,12 @@ type UpdateAccountResponse = ({
         analytics?: boolean;
         inbox?: boolean;
     };
+    /**
+     * The resulting setting, returned only when the request body included `metaAdsSyncEnabled`.
+     */
+    metaAdsSyncEnabled?: boolean;
 });
-type UpdateAccountError = (unknown | ErrorResponse | {
+type UpdateAccountError = (ErrorResponse | unknown | {
     error?: string;
 });
 type MoveAccountToProfileData = {

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.1483",
+  version: "0.2.1485",
   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.1483",
+  version: "0.2.1485",
   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.1483",
+  "version": "0.2.1485",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -2265,6 +2265,10 @@ export const getFollowerStats = <ThrowOnError extends boolean = false>(options?:
  * - Publishing and deleting posts are always available regardless of these toggles.
  * - Setting `xCapabilities` on a non-X account returns 400.
  *
+ * ### Meta ads sync
+ *
+ * For Facebook accounts, also accepts `metaAdsSyncEnabled` to sync the Meta ads of the ad accounts the account reaches without a Meta Ads connection. See the field for what turning it on and off does.
+ *
  */
 export const updateAccount = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UpdateAccountData, ThrowOnError>) => {
     return (options?.client ?? client).put<UpdateAccountResponse, UpdateAccountError, ThrowOnError>({
@@ -2292,7 +2296,11 @@ export const moveAccountToProfile = <ThrowOnError extends boolean = false>(optio
 
 /**
  * Disconnect account
- * Disconnects and removes a connected account. Repeating the call for an account already disconnected returns 404, the account stays in its 1h grace window and the disconnect is not re-run.
+ * Disconnects and removes a connected account, and fires account.disconnected with disconnectionType intentional.
+ *
+ * The account is kept for a 1h grace window. Reconnecting the same account within it restores it with the same accountId and its scheduled posts. After that it is deleted permanently.
+ *
+ * Repeating the call for an account already disconnected returns 404, the account stays in its 1h grace window and the disconnect is not re-run.
  */
 export const deleteAccount = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<DeleteAccountData, ThrowOnError>) => {
     return (options?.client ?? client).delete<DeleteAccountResponse, DeleteAccountError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -13645,6 +13645,10 @@ export type Post = {
      * Queue ID if the post was scheduled via a specific queue
      */
     queueId?: string;
+    /**
+     * Profile the post is filed under. Set only on drafts that have no platforms.
+     */
+    profileId?: string;
     createdAt?: string;
     /**
      * Last change to the post or to any of its platforms (a publish, a failure, a resolved URL).
@@ -15082,6 +15086,13 @@ export type SocialAccount = {
      *
      */
     enabled?: boolean;
+    /**
+     * Facebook accounts only (absent on every other platform). Whether this Facebook account syncs the Meta ads of the ad accounts it reaches, the way a `metaads` connection does.
+     *
+     * Off by default; set it with `PUT /v1/accounts/{accountId}`. Synced active ads count on the managed ads meter like ads from a Meta Ads connection.
+     *
+     */
+    metaAdsSyncEnabled?: boolean;
     /**
      * End of the account's publishing cooldown. Compare it with the current time: a value in the past means the cooldown has ended (the field is cleared on the next successful publish); null means no cooldown since the last successful publish.
      *
@@ -17516,7 +17527,9 @@ export type WebhookPayloadAccountDisconnected = {
         username: string;
         displayName?: string;
         /**
-         * Whether the disconnection was intentional (user action) or unintentional (token expired/revoked)
+         * intentional: removed on purpose, for example with DELETE /v1/accounts/{accountId} or by a switch to the Free plan for the accounts over its limit. The account is deleted permanently 1 hour later unless the same account is reconnected within that hour.
+         *
+         * unintentional: the connection broke (token expired or revoked, access lost on the platform). The account stays in Zernio, inactive, until it is reconnected (keeping its accountId) or removed.
          */
         disconnectionType: 'intentional' | 'unintentional';
         /**
@@ -17533,7 +17546,9 @@ export type WebhookPayloadAccountDisconnected = {
 export type event5 = 'account.disconnected';
 
 /**
- * Whether the disconnection was intentional (user action) or unintentional (token expired/revoked)
+ * intentional: removed on purpose, for example with DELETE /v1/accounts/{accountId} or by a switch to the Free plan for the accounts over its limit. The account is deleted permanently 1 hour later unless the same account is reconnected within that hour.
+ *
+ * unintentional: the connection broke (token expired or revoked, access lost on the platform). The account stays in Zernio, inactive, until it is reconnected (keeping its accountId) or removed.
  */
 export type disconnectionType = 'intentional' | 'unintentional';
 
@@ -26941,7 +26956,7 @@ export type ListPostsData = {
         page?: number;
         platform?: string;
         /**
-         * Filter posts to a specific profile (24-char hex ObjectId). Omit it, or send `all` or an empty value, to list posts across every profile.
+         * Filter posts to a specific profile (24-char hex ObjectId), including drafts filed under it without platforms. Omit it, or send `all` or an empty value, to list posts across every profile.
          */
         profileId?: string;
         /**
@@ -27107,6 +27122,10 @@ export type CreatePostData = {
          *
          */
         queueId?: string;
+        /**
+         * Files a draft with no platforms under this profile so it lists under ?profileId= and profile-scoped API keys. Ignored when platforms are set. When promoting the draft via PUT, send platforms, isDraft false and scheduledFor again.
+         */
+        profileId?: string;
     };
     headers?: {
         /**
@@ -27936,6 +27955,28 @@ export type UpdateAccountData = {
              */
             inbox?: boolean;
         };
+        /**
+         * Facebook only (400 `invalid_field_value` on any other platform). Off by default for every Facebook account.
+         *
+         * `true` makes this account sync the Meta ads of the ad accounts it reaches, like a `metaads` connection.
+         *
+         * - The first sync starts at once (14 days, then 90 days of history in the background) and fires `account.ads.initial_sync_completed` for this `accountId` with `platform: metaads`.
+         * - It then refreshes on the Meta Ads schedule.
+         * - Each switch from `false` to `true` runs another initial sync and fires the webhook again. Sending `true` while it is on changes nothing.
+         * - Needs `ads_management` and `ads_read` on the account (403 `reconnect_required` otherwise, with `details.requiredPermissions`).
+         * - Needs ads access (403 `ads_addon_required`) and room in the managed ads allowance (403 `ads_allowance_exceeded`).
+         * - While a `metaads` connection has this account as `parentAccountId`, that connection syncs the ads instead.
+         *
+         * Synced active ads count on the managed ads meter like ads from a Meta Ads
+         * connection.
+         *
+         * `false` stops the sync. Ads already synced are kept, never deleted: they
+         * stop updating and stop counting on the meter, and a `metaads` connection
+         * of yours that reaches the same ad account takes them over. Posting, inbox
+         * and comments on the account are not affected.
+         *
+         */
+        metaAdsSyncEnabled?: boolean;
     };
     path: {
         accountId: string;
@@ -27955,9 +27996,13 @@ export type UpdateAccountResponse = ({
         analytics?: boolean;
         inbox?: boolean;
     };
+    /**
+     * The resulting setting, returned only when the request body included `metaAdsSyncEnabled`.
+     */
+    metaAdsSyncEnabled?: boolean;
 });
 
-export type UpdateAccountError = (unknown | ErrorResponse | {
+export type UpdateAccountError = (ErrorResponse | unknown | {
     error?: string;
 });