@zernio/node 0.2.120 → 0.2.122

package/dist/index.d.mts

@@ -3786,6 +3786,32 @@ type WebhookPayloadMessage = {
         flowResponseData?: {
             [key: string]: unknown;
         };
+        /**
+         * Instagram only. Populated when an IG user replies to one of the
+         * account's stories (Meta `messaging_story_replies`). Mutually
+         * exclusive in practice with `isStoryMention`.
+         *
+         */
+        storyReply?: {
+            /**
+             * The Instagram story ID the user replied to.
+             */
+            storyId: string;
+            /**
+             * Meta CDN URL for the story media. Expires approximately
+             * 24 hours after the story posted; consumers must fetch
+             * promptly or treat 404s as expected.
+             *
+             */
+            storyUrl?: string;
+        };
+        /**
+         * Instagram only. True when the message was generated by an IG
+         * user mentioning the account in their own story (`story_mention`
+         * attachment type). Mutually exclusive in practice with `storyReply`.
+         *
+         */
+        isStoryMention?: boolean;
         /**
          * WhatsApp only. Click-to-WhatsApp (CTWA) ad attribution. Present
          * only on the FIRST inbound message after a user reaches the
@@ -8941,7 +8967,7 @@ type CreateWebhookSettingsData = {
         /**
          * Events to subscribe to (at least one required)
          */
-        events: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'comment.received' | 'review.new' | 'review.updated')>;
+        events: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'comment.received' | 'review.new' | 'review.updated')>;
         /**
          * Enable or disable webhook delivery. Defaults to `true` when omitted.
          */
@@ -8982,7 +9008,7 @@ type UpdateWebhookSettingsData = {
         /**
          * Events to subscribe to. Must contain at least one event if provided.
          */
-        events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'comment.received' | 'review.new' | 'review.updated')>;
+        events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'comment.received' | 'review.new' | 'review.updated')>;
         /**
          * Enable or disable webhook delivery
          */
@@ -12985,7 +13011,7 @@ type ListAdsData = {
          */
         campaignId?: string;
         /**
-         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch when scoped to a specific accountId.
+         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago.
          */
         fromDate?: string;
         limit?: number;
@@ -13293,7 +13319,7 @@ type GetAdTreeData = {
          */
         adAccountId?: string;
         /**
-         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch when scoped to a specific accountId.
+         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago.
          */
         fromDate?: string;
         /**
@@ -13427,7 +13453,7 @@ type GetAdAnalyticsData = {
          */
         breakdowns?: string;
         /**
-         * Start of date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch.
+         * Start of date range (YYYY-MM-DD). Defaults to 90 days ago.
          */
         fromDate?: string;
         /**

package/dist/index.d.ts

@@ -3786,6 +3786,32 @@ type WebhookPayloadMessage = {
         flowResponseData?: {
             [key: string]: unknown;
         };
+        /**
+         * Instagram only. Populated when an IG user replies to one of the
+         * account's stories (Meta `messaging_story_replies`). Mutually
+         * exclusive in practice with `isStoryMention`.
+         *
+         */
+        storyReply?: {
+            /**
+             * The Instagram story ID the user replied to.
+             */
+            storyId: string;
+            /**
+             * Meta CDN URL for the story media. Expires approximately
+             * 24 hours after the story posted; consumers must fetch
+             * promptly or treat 404s as expected.
+             *
+             */
+            storyUrl?: string;
+        };
+        /**
+         * Instagram only. True when the message was generated by an IG
+         * user mentioning the account in their own story (`story_mention`
+         * attachment type). Mutually exclusive in practice with `storyReply`.
+         *
+         */
+        isStoryMention?: boolean;
         /**
          * WhatsApp only. Click-to-WhatsApp (CTWA) ad attribution. Present
          * only on the FIRST inbound message after a user reaches the
@@ -8941,7 +8967,7 @@ type CreateWebhookSettingsData = {
         /**
          * Events to subscribe to (at least one required)
          */
-        events: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'comment.received' | 'review.new' | 'review.updated')>;
+        events: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'comment.received' | 'review.new' | 'review.updated')>;
         /**
          * Enable or disable webhook delivery. Defaults to `true` when omitted.
          */
@@ -8982,7 +9008,7 @@ type UpdateWebhookSettingsData = {
         /**
          * Events to subscribe to. Must contain at least one event if provided.
          */
-        events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'comment.received' | 'review.new' | 'review.updated')>;
+        events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'comment.received' | 'review.new' | 'review.updated')>;
         /**
          * Enable or disable webhook delivery
          */
@@ -12985,7 +13011,7 @@ type ListAdsData = {
          */
         campaignId?: string;
         /**
-         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch when scoped to a specific accountId.
+         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago.
          */
         fromDate?: string;
         limit?: number;
@@ -13293,7 +13319,7 @@ type GetAdTreeData = {
          */
         adAccountId?: string;
         /**
-         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch when scoped to a specific accountId.
+         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago.
          */
         fromDate?: string;
         /**
@@ -13427,7 +13453,7 @@ type GetAdAnalyticsData = {
          */
         breakdowns?: string;
         /**
-         * Start of date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch.
+         * Start of date range (YYYY-MM-DD). Defaults to 90 days ago.
          */
         fromDate?: string;
         /**

package/package.json

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

package/src/generated/sdk.gen.ts

@@ -3229,7 +3229,6 @@ export const listCommentAutomationLogs = <ThrowOnError extends boolean = false>(
  * Returns a paginated list of ads with metrics computed over an optional date range.
  * Use source=all to include externally-synced ads from platform ad managers.
  * If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max.
- * Ranges older than 90 days trigger a one-time on-demand fetch from the platform when scoped to a specific accountId, then serve from cache on subsequent requests.
  *
  */
 export const listAds = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<ListAdsData, ThrowOnError>) => {
@@ -3392,7 +3391,6 @@ export const updateAdSetStatus = <ThrowOnError extends boolean = false>(options:
  * and campaign levels. Pagination is at the campaign level. Ads without a campaign or ad set
  * ID are grouped into synthetic "Ungrouped" buckets.
  * If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max.
- * Ranges older than 90 days trigger a one-time on-demand fetch from the platform when scoped to a specific accountId, then serve from cache on subsequent requests.
  *
  */
 export const getAdTree = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<GetAdTreeData, ThrowOnError>) => {
@@ -3449,7 +3447,6 @@ export const deleteAd = <ThrowOnError extends boolean = false>(options: OptionsL
  * Returns detailed performance analytics for an ad. Includes summary metrics, a daily timeline
  * over the requested date range, and optional demographic breakdowns (Meta and TikTok only).
  * If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max.
- * Ranges older than 90 days trigger a one-time on-demand fetch from the platform, then serve from cache on subsequent requests.
  *
  */
 export const getAdAnalytics = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetAdAnalyticsData, ThrowOnError>) => {

package/src/generated/types.gen.ts

@@ -3322,6 +3322,32 @@ export type WebhookPayloadMessage = {
         flowResponseData?: {
             [key: string]: unknown;
         };
+        /**
+         * Instagram only. Populated when an IG user replies to one of the
+         * account's stories (Meta `messaging_story_replies`). Mutually
+         * exclusive in practice with `isStoryMention`.
+         *
+         */
+        storyReply?: {
+            /**
+             * The Instagram story ID the user replied to.
+             */
+            storyId: string;
+            /**
+             * Meta CDN URL for the story media. Expires approximately
+             * 24 hours after the story posted; consumers must fetch
+             * promptly or treat 404s as expected.
+             *
+             */
+            storyUrl?: string;
+        };
+        /**
+         * Instagram only. True when the message was generated by an IG
+         * user mentioning the account in their own story (`story_mention`
+         * attachment type). Mutually exclusive in practice with `storyReply`.
+         *
+         */
+        isStoryMention?: boolean;
         /**
          * WhatsApp only. Click-to-WhatsApp (CTWA) ad attribution. Present
          * only on the FIRST inbound message after a user reaches the
@@ -8878,7 +8904,7 @@ export type CreateWebhookSettingsData = {
         /**
          * Events to subscribe to (at least one required)
          */
-        events: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'comment.received' | 'review.new' | 'review.updated')>;
+        events: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'comment.received' | 'review.new' | 'review.updated')>;
         /**
          * Enable or disable webhook delivery. Defaults to `true` when omitted.
          */
@@ -8922,7 +8948,7 @@ export type UpdateWebhookSettingsData = {
         /**
          * Events to subscribe to. Must contain at least one event if provided.
          */
-        events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'comment.received' | 'review.new' | 'review.updated')>;
+        events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'comment.received' | 'review.new' | 'review.updated')>;
         /**
          * Enable or disable webhook delivery
          */
@@ -13276,7 +13302,7 @@ export type ListAdsData = {
          */
         campaignId?: string;
         /**
-         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch when scoped to a specific accountId.
+         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago.
          */
         fromDate?: string;
         limit?: number;
@@ -13611,7 +13637,7 @@ export type GetAdTreeData = {
          */
         adAccountId?: string;
         /**
-         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch when scoped to a specific accountId.
+         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago.
          */
         fromDate?: string;
         /**
@@ -13757,7 +13783,7 @@ export type GetAdAnalyticsData = {
          */
         breakdowns?: string;
         /**
-         * Start of date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch.
+         * Start of date range (YYYY-MM-DD). Defaults to 90 days ago.
          */
         fromDate?: string;
         /**