@zernio/node 0.2.883 → 0.2.885

package/dist/index.d.mts

@@ -10138,6 +10138,10 @@ type Webhook = {
      * Resource groups this subscription does not receive (opt-out denylist, same vocabulary and same semantics as the field on API keys). Absent or empty means the subscription receives every event listed in `events`, which is how every subscription created before this field existed behaves. An event whose group is listed here is dropped before delivery even when it is still present in `events`, and the same check runs on every replay path (test fire, redelivery, dead-letter requeue). Editing the denylist applies to every event emitted afterwards; events already queued when the edit landed can still be delivered for up to five minutes after they were enqueued.
      */
     disabledResourceGroups?: Array<('publishing' | 'engagement' | 'messages' | 'contacts' | 'analytics' | 'ads' | 'telephony' | 'accounts' | 'billing' | 'webhooks')>;
+    /**
+     * Profiles this subscription receives events for (allowlist). Absent or empty means every profile, which is how every subscription created before this field existed behaves. A scoped subscription is only sent events attributable to a listed profile; events with no profile behind them (`verification.*`, `phone_number.*`) are not delivered to it. Applied when the event is emitted: a redelivery replays a delivery already made to this endpoint, and a test fire ignores the list.
+     */
+    profileIds?: Array<(string)>;
 };
 /**
  * A single webhook delivery attempt recorded by Zernio (30-day retention).
@@ -17056,7 +17060,12 @@ type ConnectAdsData = {
          * gives one, `details.disableReason`. Unsettled and in-grace accounts
          * are accepted, matching the `selectable` flag of `GET /v1/ads/accounts`.
          * Setting a scope also removes already synced ads from de-scoped ad
-         * accounts. For multiple accounts use `adAccountIds` instead.
+         * accounts. On Meta the scope also decides which ad accounts Zernio
+         * subscribes to ad-account webhooks: only the scoped ones, instead of
+         * every ad account the login can reach. The scope is kept when this
+         * call returns an `authUrl`, so the Meta Ads account created after
+         * OAuth is scoped (and only its scoped ad accounts synced and
+         * subscribed) from the start. For multiple accounts use `adAccountIds` instead.
          *
          */
         adAccountId?: string;
@@ -17066,8 +17075,10 @@ type ConnectAdsData = {
          * (`?adAccountIds=act_1&adAccountIds=act_2`) or comma-separate
          * (`?adAccountIds=act_1,act_2`). Persisted server-side; latest call
          * wins, and de-scoped ad accounts have their synced ads removed.
+         * On Meta only the scoped ad accounts get webhook subscriptions,
+         * including when the call starts a fresh OAuth.
          * Omitting both `adAccountId` and `adAccountIds` keeps any previously
-         * persisted scope unchanged.
+         * persisted scope unchanged (no scope means every reachable ad account).
          *
          */
         adAccountIds?: Array<(string)>;
@@ -22290,6 +22301,10 @@ type CreateWebhookSettingsData = {
          * Resource groups this subscription does not receive (opt-out denylist). Omit or send an empty array to receive every event in `events`. Listing a group here drops its events before delivery and on every replay path. Set at creation it applies to everything this subscription ever receives; changed later via PUT it applies to events emitted after the change, with a five-minute tail for events already queued (see that operation). When the caller is a restricted (zrk_) key, that key's own disabled groups are unioned into whatever you send here, so a restricted key can never create a subscription wider than itself.
          */
         disabledResourceGroups?: Array<('publishing' | 'engagement' | 'messages' | 'contacts' | 'analytics' | 'ads' | 'telephony' | 'accounts' | 'billing' | 'webhooks')>;
+        /**
+         * Profiles this subscription receives events for. Omit or send an empty array to receive every profile. Every id must be a profile in your team, otherwise the request fails with 404 `profile_not_found` and nothing is created. Typical use is routing the profile that holds test accounts to a staging endpoint.
+         */
+        profileIds?: Array<(string)>;
     };
 };
 type CreateWebhookSettingsResponse = ({
@@ -22347,6 +22362,10 @@ type UpdateWebhookSettingsData = {
          * Replaces the subscription's denylist. Send an empty array to clear it and receive every event in `events` again. Omitting the field leaves the current denylist untouched. Applies to events emitted after the update; already-queued events can still deliver for up to five minutes after they were enqueued. When the caller is a restricted (zrk_) key, that key's own disabled groups are unioned back in either way, so a restricted key can neither clear nor widen a subscription past its own groups.
          */
         disabledResourceGroups?: Array<('publishing' | 'engagement' | 'messages' | 'contacts' | 'analytics' | 'ads' | 'telephony' | 'accounts' | 'billing' | 'webhooks')>;
+        /**
+         * Replaces the subscription's profile allowlist. Send an empty array to receive every profile again. Omitting the field leaves the current list untouched. Every id must be a profile in your team, otherwise the request fails with 404 `profile_not_found` and nothing changes. Applies to events emitted after the update.
+         */
+        profileIds?: Array<(string)>;
     };
 };
 type UpdateWebhookSettingsResponse = ({

package/dist/index.d.ts

@@ -10138,6 +10138,10 @@ type Webhook = {
      * Resource groups this subscription does not receive (opt-out denylist, same vocabulary and same semantics as the field on API keys). Absent or empty means the subscription receives every event listed in `events`, which is how every subscription created before this field existed behaves. An event whose group is listed here is dropped before delivery even when it is still present in `events`, and the same check runs on every replay path (test fire, redelivery, dead-letter requeue). Editing the denylist applies to every event emitted afterwards; events already queued when the edit landed can still be delivered for up to five minutes after they were enqueued.
      */
     disabledResourceGroups?: Array<('publishing' | 'engagement' | 'messages' | 'contacts' | 'analytics' | 'ads' | 'telephony' | 'accounts' | 'billing' | 'webhooks')>;
+    /**
+     * Profiles this subscription receives events for (allowlist). Absent or empty means every profile, which is how every subscription created before this field existed behaves. A scoped subscription is only sent events attributable to a listed profile; events with no profile behind them (`verification.*`, `phone_number.*`) are not delivered to it. Applied when the event is emitted: a redelivery replays a delivery already made to this endpoint, and a test fire ignores the list.
+     */
+    profileIds?: Array<(string)>;
 };
 /**
  * A single webhook delivery attempt recorded by Zernio (30-day retention).
@@ -17056,7 +17060,12 @@ type ConnectAdsData = {
          * gives one, `details.disableReason`. Unsettled and in-grace accounts
          * are accepted, matching the `selectable` flag of `GET /v1/ads/accounts`.
          * Setting a scope also removes already synced ads from de-scoped ad
-         * accounts. For multiple accounts use `adAccountIds` instead.
+         * accounts. On Meta the scope also decides which ad accounts Zernio
+         * subscribes to ad-account webhooks: only the scoped ones, instead of
+         * every ad account the login can reach. The scope is kept when this
+         * call returns an `authUrl`, so the Meta Ads account created after
+         * OAuth is scoped (and only its scoped ad accounts synced and
+         * subscribed) from the start. For multiple accounts use `adAccountIds` instead.
          *
          */
         adAccountId?: string;
@@ -17066,8 +17075,10 @@ type ConnectAdsData = {
          * (`?adAccountIds=act_1&adAccountIds=act_2`) or comma-separate
          * (`?adAccountIds=act_1,act_2`). Persisted server-side; latest call
          * wins, and de-scoped ad accounts have their synced ads removed.
+         * On Meta only the scoped ad accounts get webhook subscriptions,
+         * including when the call starts a fresh OAuth.
          * Omitting both `adAccountId` and `adAccountIds` keeps any previously
-         * persisted scope unchanged.
+         * persisted scope unchanged (no scope means every reachable ad account).
          *
          */
         adAccountIds?: Array<(string)>;
@@ -22290,6 +22301,10 @@ type CreateWebhookSettingsData = {
          * Resource groups this subscription does not receive (opt-out denylist). Omit or send an empty array to receive every event in `events`. Listing a group here drops its events before delivery and on every replay path. Set at creation it applies to everything this subscription ever receives; changed later via PUT it applies to events emitted after the change, with a five-minute tail for events already queued (see that operation). When the caller is a restricted (zrk_) key, that key's own disabled groups are unioned into whatever you send here, so a restricted key can never create a subscription wider than itself.
          */
         disabledResourceGroups?: Array<('publishing' | 'engagement' | 'messages' | 'contacts' | 'analytics' | 'ads' | 'telephony' | 'accounts' | 'billing' | 'webhooks')>;
+        /**
+         * Profiles this subscription receives events for. Omit or send an empty array to receive every profile. Every id must be a profile in your team, otherwise the request fails with 404 `profile_not_found` and nothing is created. Typical use is routing the profile that holds test accounts to a staging endpoint.
+         */
+        profileIds?: Array<(string)>;
     };
 };
 type CreateWebhookSettingsResponse = ({
@@ -22347,6 +22362,10 @@ type UpdateWebhookSettingsData = {
          * Replaces the subscription's denylist. Send an empty array to clear it and receive every event in `events` again. Omitting the field leaves the current denylist untouched. Applies to events emitted after the update; already-queued events can still deliver for up to five minutes after they were enqueued. When the caller is a restricted (zrk_) key, that key's own disabled groups are unioned back in either way, so a restricted key can neither clear nor widen a subscription past its own groups.
          */
         disabledResourceGroups?: Array<('publishing' | 'engagement' | 'messages' | 'contacts' | 'analytics' | 'ads' | 'telephony' | 'accounts' | 'billing' | 'webhooks')>;
+        /**
+         * Replaces the subscription's profile allowlist. Send an empty array to receive every profile again. Omitting the field leaves the current list untouched. Every id must be a profile in your team, otherwise the request fails with 404 `profile_not_found` and nothing changes. Applies to events emitted after the update.
+         */
+        profileIds?: Array<(string)>;
     };
 };
 type UpdateWebhookSettingsResponse = ({

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -3547,6 +3547,11 @@ export const getWebhookSettings = <ThrowOnError extends boolean = false>(options
  * subscriptions behave. A restricted key's own disabled groups are always
  * unioned in.
  *
+ * `profileIds` pins the subscription to a set of profiles: only events
+ * attributable to one of them are delivered. Use it to send the profile
+ * holding your test accounts to a staging endpoint. Ids outside your team
+ * are rejected with 404 `profile_not_found`.
+ *
  */
 export const createWebhookSettings = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateWebhookSettingsData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateWebhookSettingsResponse, CreateWebhookSettingsError, ThrowOnError>({
@@ -3581,6 +3586,9 @@ export const createWebhookSettings = <ThrowOnError extends boolean = false>(opti
  * subscription. Retries beyond that window, dead-letter replays, test fires,
  * and redeliveries are all checked against the current denylist.
  *
+ * `profileIds` replaces the subscription's profile allowlist; an empty array
+ * clears it. Ids outside your team are rejected with 404 `profile_not_found`.
+ *
  */
 export const updateWebhookSettings = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UpdateWebhookSettingsData, ThrowOnError>) => {
     return (options?.client ?? client).put<UpdateWebhookSettingsResponse, UpdateWebhookSettingsError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -8802,6 +8802,10 @@ export type Webhook = {
      * Resource groups this subscription does not receive (opt-out denylist, same vocabulary and same semantics as the field on API keys). Absent or empty means the subscription receives every event listed in `events`, which is how every subscription created before this field existed behaves. An event whose group is listed here is dropped before delivery even when it is still present in `events`, and the same check runs on every replay path (test fire, redelivery, dead-letter requeue). Editing the denylist applies to every event emitted afterwards; events already queued when the edit landed can still be delivered for up to five minutes after they were enqueued.
      */
     disabledResourceGroups?: Array<('publishing' | 'engagement' | 'messages' | 'contacts' | 'analytics' | 'ads' | 'telephony' | 'accounts' | 'billing' | 'webhooks')>;
+    /**
+     * Profiles this subscription receives events for (allowlist). Absent or empty means every profile, which is how every subscription created before this field existed behaves. A scoped subscription is only sent events attributable to a listed profile; events with no profile behind them (`verification.*`, `phone_number.*`) are not delivered to it. Applied when the event is emitted: a redelivery replays a delivery already made to this endpoint, and a test fire ignores the list.
+     */
+    profileIds?: Array<(string)>;
 };
 
 /**
@@ -16102,7 +16106,12 @@ export type ConnectAdsData = {
          * gives one, `details.disableReason`. Unsettled and in-grace accounts
          * are accepted, matching the `selectable` flag of `GET /v1/ads/accounts`.
          * Setting a scope also removes already synced ads from de-scoped ad
-         * accounts. For multiple accounts use `adAccountIds` instead.
+         * accounts. On Meta the scope also decides which ad accounts Zernio
+         * subscribes to ad-account webhooks: only the scoped ones, instead of
+         * every ad account the login can reach. The scope is kept when this
+         * call returns an `authUrl`, so the Meta Ads account created after
+         * OAuth is scoped (and only its scoped ad accounts synced and
+         * subscribed) from the start. For multiple accounts use `adAccountIds` instead.
          *
          */
         adAccountId?: string;
@@ -16112,8 +16121,10 @@ export type ConnectAdsData = {
          * (`?adAccountIds=act_1&adAccountIds=act_2`) or comma-separate
          * (`?adAccountIds=act_1,act_2`). Persisted server-side; latest call
          * wins, and de-scoped ad accounts have their synced ads removed.
+         * On Meta only the scoped ad accounts get webhook subscriptions,
+         * including when the call starts a fresh OAuth.
          * Omitting both `adAccountId` and `adAccountIds` keeps any previously
-         * persisted scope unchanged.
+         * persisted scope unchanged (no scope means every reachable ad account).
          *
          */
         adAccountIds?: Array<(string)>;
@@ -21711,6 +21722,10 @@ export type CreateWebhookSettingsData = {
          * Resource groups this subscription does not receive (opt-out denylist). Omit or send an empty array to receive every event in `events`. Listing a group here drops its events before delivery and on every replay path. Set at creation it applies to everything this subscription ever receives; changed later via PUT it applies to events emitted after the change, with a five-minute tail for events already queued (see that operation). When the caller is a restricted (zrk_) key, that key's own disabled groups are unioned into whatever you send here, so a restricted key can never create a subscription wider than itself.
          */
         disabledResourceGroups?: Array<('publishing' | 'engagement' | 'messages' | 'contacts' | 'analytics' | 'ads' | 'telephony' | 'accounts' | 'billing' | 'webhooks')>;
+        /**
+         * Profiles this subscription receives events for. Omit or send an empty array to receive every profile. Every id must be a profile in your team, otherwise the request fails with 404 `profile_not_found` and nothing is created. Typical use is routing the profile that holds test accounts to a staging endpoint.
+         */
+        profileIds?: Array<(string)>;
     };
 };
 
@@ -21771,6 +21786,10 @@ export type UpdateWebhookSettingsData = {
          * Replaces the subscription's denylist. Send an empty array to clear it and receive every event in `events` again. Omitting the field leaves the current denylist untouched. Applies to events emitted after the update; already-queued events can still deliver for up to five minutes after they were enqueued. When the caller is a restricted (zrk_) key, that key's own disabled groups are unioned back in either way, so a restricted key can neither clear nor widen a subscription past its own groups.
          */
         disabledResourceGroups?: Array<('publishing' | 'engagement' | 'messages' | 'contacts' | 'analytics' | 'ads' | 'telephony' | 'accounts' | 'billing' | 'webhooks')>;
+        /**
+         * Replaces the subscription's profile allowlist. Send an empty array to receive every profile again. Omitting the field leaves the current list untouched. Every id must be a profile in your team, otherwise the request fails with 404 `profile_not_found` and nothing changes. Applies to events emitted after the update.
+         */
+        profileIds?: Array<(string)>;
     };
 };