@zernio/node 0.2.95 → 0.2.97

package/dist/index.d.mts

@@ -3496,6 +3496,29 @@ type WebhookPayloadMessage = {
         flowResponseData?: {
             [key: string]: unknown;
         };
+        /**
+         * WhatsApp only. Click-to-WhatsApp (CTWA) ad attribution. Present
+         * only on the FIRST inbound message after a user reaches the
+         * business via a CTWA ad. Forwarded verbatim from Meta's referral
+         * envelope so it can be replayed to the Conversions API for
+         * Business Messaging. Attribution window is 7 days from click.
+         *
+         */
+        referral?: {
+            /**
+             * Meta's GCLID-equivalent click identifier.
+             */
+            ctwa_clid?: string;
+            source_id?: string;
+            source_type?: string;
+            source_url?: string;
+            headline?: string;
+            body?: string;
+            media_type?: string;
+            image_url?: string;
+            video_url?: string;
+            thumbnail_url?: string;
+        };
     } | null;
     timestamp: string;
 };
@@ -8611,10 +8634,43 @@ type GetInboxConversationMessagesData = {
          * Social account ID
          */
         accountId: string;
+        /**
+         * Opaque pagination cursor. Pass `pagination.nextCursor` from a prior response.
+         */
+        cursor?: string;
+        /**
+         * Number of messages to return per page. Default 100, max 100.
+         */
+        limit?: number;
+        /**
+         * Order of returned messages. Default `asc` (oldest first, chat style).
+         * For Twitter, Facebook and Bluesky, only intra-page ordering is
+         * affected — pages always walk newest→oldest. See `sortOrderApplied`
+         * in the response.
+         *
+         */
+        sortOrder?: 'asc' | 'desc';
     };
 };
 type GetInboxConversationMessagesResponse = ({
     status?: string;
+    pagination?: {
+        /**
+         * Whether more messages are available beyond this page.
+         */
+        hasMore?: boolean;
+        /**
+         * Opaque cursor to fetch the next page. `null` on the last page.
+         */
+        nextCursor?: (string) | null;
+    };
+    /**
+     * Sort order actually applied to the returned page. May
+     * differ from the requested `sortOrder` for Twitter,
+     * Facebook and Bluesky (always `desc` regardless of request).
+     *
+     */
+    sortOrderApplied?: 'asc' | 'desc';
     messages?: Array<{
         id?: string;
         conversationId?: string;
@@ -12675,6 +12731,20 @@ type BoostPostData = {
          * Meta only. Required for housing, employment, credit, or political ads.
          */
         specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'ISSUES_ELECTIONS_POLITICS')>;
+        /**
+         * Name of the legal entity benefiting from the ad.
+         * Required by Meta when targeting EU users (DSA Article 26).
+         * Not enforced at schema level; enforced server-side when targeting intersects EU member states.
+         *
+         */
+        dsaBeneficiary?: string;
+        /**
+         * Name of the legal entity paying for the ad.
+         * Required by Meta when targeting EU users (DSA Article 26).
+         * Note Meta API spelling: dsa_payor (not dsa_payer).
+         *
+         */
+        dsaPayor?: string;
     };
 };
 type BoostPostResponse = ({
@@ -12834,6 +12904,20 @@ type CreateStandaloneAdData = {
          * Meta only. Restrict the audience by gender. 'male' targets men only, 'female' targets women only, 'all' (default) targets everyone. Ignored by non-Meta platforms.
          */
         gender?: 'all' | 'male' | 'female';
+        /**
+         * Name of the legal entity benefiting from the ad.
+         * Required by Meta when targeting EU users (DSA Article 26).
+         * Not enforced at schema level; enforced server-side when targeting intersects EU member states.
+         *
+         */
+        dsaBeneficiary?: string;
+        /**
+         * Name of the legal entity paying for the ad.
+         * Required by Meta when targeting EU users (DSA Article 26).
+         * Note Meta API spelling: dsa_payor (not dsa_payer).
+         *
+         */
+        dsaPayor?: string;
     };
 };
 type CreateStandaloneAdResponse = (({
@@ -13292,6 +13376,20 @@ type CreateCtwaAdData = {
          *
          */
         objective?: 'OUTCOME_ENGAGEMENT' | 'OUTCOME_SALES' | 'OUTCOME_LEADS';
+        /**
+         * Name of the legal entity benefiting from the ad.
+         * Required by Meta when targeting EU users (DSA Article 26).
+         * Not enforced at schema level; enforced server-side when targeting intersects EU member states.
+         *
+         */
+        dsaBeneficiary?: string;
+        /**
+         * Name of the legal entity paying for the ad.
+         * Required by Meta when targeting EU users (DSA Article 26).
+         * Note Meta API spelling: dsa_payor (not dsa_payer).
+         *
+         */
+        dsaPayor?: string;
     };
 };
 type CreateCtwaAdResponse = ({

package/dist/index.d.ts

@@ -3496,6 +3496,29 @@ type WebhookPayloadMessage = {
         flowResponseData?: {
             [key: string]: unknown;
         };
+        /**
+         * WhatsApp only. Click-to-WhatsApp (CTWA) ad attribution. Present
+         * only on the FIRST inbound message after a user reaches the
+         * business via a CTWA ad. Forwarded verbatim from Meta's referral
+         * envelope so it can be replayed to the Conversions API for
+         * Business Messaging. Attribution window is 7 days from click.
+         *
+         */
+        referral?: {
+            /**
+             * Meta's GCLID-equivalent click identifier.
+             */
+            ctwa_clid?: string;
+            source_id?: string;
+            source_type?: string;
+            source_url?: string;
+            headline?: string;
+            body?: string;
+            media_type?: string;
+            image_url?: string;
+            video_url?: string;
+            thumbnail_url?: string;
+        };
     } | null;
     timestamp: string;
 };
@@ -8611,10 +8634,43 @@ type GetInboxConversationMessagesData = {
          * Social account ID
          */
         accountId: string;
+        /**
+         * Opaque pagination cursor. Pass `pagination.nextCursor` from a prior response.
+         */
+        cursor?: string;
+        /**
+         * Number of messages to return per page. Default 100, max 100.
+         */
+        limit?: number;
+        /**
+         * Order of returned messages. Default `asc` (oldest first, chat style).
+         * For Twitter, Facebook and Bluesky, only intra-page ordering is
+         * affected — pages always walk newest→oldest. See `sortOrderApplied`
+         * in the response.
+         *
+         */
+        sortOrder?: 'asc' | 'desc';
     };
 };
 type GetInboxConversationMessagesResponse = ({
     status?: string;
+    pagination?: {
+        /**
+         * Whether more messages are available beyond this page.
+         */
+        hasMore?: boolean;
+        /**
+         * Opaque cursor to fetch the next page. `null` on the last page.
+         */
+        nextCursor?: (string) | null;
+    };
+    /**
+     * Sort order actually applied to the returned page. May
+     * differ from the requested `sortOrder` for Twitter,
+     * Facebook and Bluesky (always `desc` regardless of request).
+     *
+     */
+    sortOrderApplied?: 'asc' | 'desc';
     messages?: Array<{
         id?: string;
         conversationId?: string;
@@ -12675,6 +12731,20 @@ type BoostPostData = {
          * Meta only. Required for housing, employment, credit, or political ads.
          */
         specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'ISSUES_ELECTIONS_POLITICS')>;
+        /**
+         * Name of the legal entity benefiting from the ad.
+         * Required by Meta when targeting EU users (DSA Article 26).
+         * Not enforced at schema level; enforced server-side when targeting intersects EU member states.
+         *
+         */
+        dsaBeneficiary?: string;
+        /**
+         * Name of the legal entity paying for the ad.
+         * Required by Meta when targeting EU users (DSA Article 26).
+         * Note Meta API spelling: dsa_payor (not dsa_payer).
+         *
+         */
+        dsaPayor?: string;
     };
 };
 type BoostPostResponse = ({
@@ -12834,6 +12904,20 @@ type CreateStandaloneAdData = {
          * Meta only. Restrict the audience by gender. 'male' targets men only, 'female' targets women only, 'all' (default) targets everyone. Ignored by non-Meta platforms.
          */
         gender?: 'all' | 'male' | 'female';
+        /**
+         * Name of the legal entity benefiting from the ad.
+         * Required by Meta when targeting EU users (DSA Article 26).
+         * Not enforced at schema level; enforced server-side when targeting intersects EU member states.
+         *
+         */
+        dsaBeneficiary?: string;
+        /**
+         * Name of the legal entity paying for the ad.
+         * Required by Meta when targeting EU users (DSA Article 26).
+         * Note Meta API spelling: dsa_payor (not dsa_payer).
+         *
+         */
+        dsaPayor?: string;
     };
 };
 type CreateStandaloneAdResponse = (({
@@ -13292,6 +13376,20 @@ type CreateCtwaAdData = {
          *
          */
         objective?: 'OUTCOME_ENGAGEMENT' | 'OUTCOME_SALES' | 'OUTCOME_LEADS';
+        /**
+         * Name of the legal entity benefiting from the ad.
+         * Required by Meta when targeting EU users (DSA Article 26).
+         * Not enforced at schema level; enforced server-side when targeting intersects EU member states.
+         *
+         */
+        dsaBeneficiary?: string;
+        /**
+         * Name of the legal entity paying for the ad.
+         * Required by Meta when targeting EU users (DSA Article 26).
+         * Note Meta API spelling: dsa_payor (not dsa_payer).
+         *
+         */
+        dsaPayor?: string;
     };
 };
 type CreateCtwaAdResponse = ({

package/package.json

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

package/src/generated/sdk.gen.ts

@@ -1710,7 +1710,25 @@ export const updateInboxConversation = <ThrowOnError extends boolean = false>(op
 
 /**
  * List messages
- * Fetch messages for a specific conversation. Requires accountId query parameter.
+ * Fetch messages for a specific conversation, with cursor-based pagination
+ * and ordering control.
+ *
+ * Pagination: pass `pagination.nextCursor` from a prior response back as
+ * the `cursor` query param to fetch the next page. The cursor is opaque;
+ * do not parse or construct it client-side.
+ *
+ * Sort order: defaults to `asc` (oldest first, chat style). For the
+ * "show me the latest messages" pattern, pass `?sortOrder=desc&limit=N`.
+ * For Twitter, Facebook and Bluesky, the upstream APIs only return
+ * newest-first and have no order parameter — sort order is best-effort
+ * and only reverses items within a single page (pages still walk
+ * newest→oldest). The response field `sortOrderApplied` tells you what
+ * was actually applied.
+ *
+ * Reddit threads are paginated client-side because Reddit's API has no
+ * per-thread cursor. Very long threads may be upstream-truncated by
+ * Reddit's inbox/sent windows (~100 most-recent items each); this is a
+ * Reddit platform limitation.
  *
  * Twitter/X limitation: X's encrypted "X Chat" messages are not accessible via the API. Conversations where the other participant uses encrypted X Chat may only show your outgoing messages. See the list conversations endpoint for more details.
  *

package/src/generated/types.gen.ts

@@ -3034,6 +3034,29 @@ export type WebhookPayloadMessage = {
         flowResponseData?: {
             [key: string]: unknown;
         };
+        /**
+         * WhatsApp only. Click-to-WhatsApp (CTWA) ad attribution. Present
+         * only on the FIRST inbound message after a user reaches the
+         * business via a CTWA ad. Forwarded verbatim from Meta's referral
+         * envelope so it can be replayed to the Conversions API for
+         * Business Messaging. Attribution window is 7 days from click.
+         *
+         */
+        referral?: {
+            /**
+             * Meta's GCLID-equivalent click identifier.
+             */
+            ctwa_clid?: string;
+            source_id?: string;
+            source_type?: string;
+            source_url?: string;
+            headline?: string;
+            body?: string;
+            media_type?: string;
+            image_url?: string;
+            video_url?: string;
+            thumbnail_url?: string;
+        };
     } | null;
     timestamp: string;
 };
@@ -8563,11 +8586,44 @@ export type GetInboxConversationMessagesData = {
          * Social account ID
          */
         accountId: string;
+        /**
+         * Opaque pagination cursor. Pass `pagination.nextCursor` from a prior response.
+         */
+        cursor?: string;
+        /**
+         * Number of messages to return per page. Default 100, max 100.
+         */
+        limit?: number;
+        /**
+         * Order of returned messages. Default `asc` (oldest first, chat style).
+         * For Twitter, Facebook and Bluesky, only intra-page ordering is
+         * affected — pages always walk newest→oldest. See `sortOrderApplied`
+         * in the response.
+         *
+         */
+        sortOrder?: 'asc' | 'desc';
     };
 };
 
 export type GetInboxConversationMessagesResponse = ({
     status?: string;
+    pagination?: {
+        /**
+         * Whether more messages are available beyond this page.
+         */
+        hasMore?: boolean;
+        /**
+         * Opaque cursor to fetch the next page. `null` on the last page.
+         */
+        nextCursor?: (string) | null;
+    };
+    /**
+     * Sort order actually applied to the returned page. May
+     * differ from the requested `sortOrder` for Twitter,
+     * Facebook and Bluesky (always `desc` regardless of request).
+     *
+     */
+    sortOrderApplied?: 'asc' | 'desc';
     messages?: Array<{
         id?: string;
         conversationId?: string;
@@ -13002,6 +13058,20 @@ export type BoostPostData = {
          * Meta only. Required for housing, employment, credit, or political ads.
          */
         specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'ISSUES_ELECTIONS_POLITICS')>;
+        /**
+         * Name of the legal entity benefiting from the ad.
+         * Required by Meta when targeting EU users (DSA Article 26).
+         * Not enforced at schema level; enforced server-side when targeting intersects EU member states.
+         *
+         */
+        dsaBeneficiary?: string;
+        /**
+         * Name of the legal entity paying for the ad.
+         * Required by Meta when targeting EU users (DSA Article 26).
+         * Note Meta API spelling: dsa_payor (not dsa_payer).
+         *
+         */
+        dsaPayor?: string;
     };
 };
 
@@ -13164,6 +13234,20 @@ export type CreateStandaloneAdData = {
          * Meta only. Restrict the audience by gender. 'male' targets men only, 'female' targets women only, 'all' (default) targets everyone. Ignored by non-Meta platforms.
          */
         gender?: 'all' | 'male' | 'female';
+        /**
+         * Name of the legal entity benefiting from the ad.
+         * Required by Meta when targeting EU users (DSA Article 26).
+         * Not enforced at schema level; enforced server-side when targeting intersects EU member states.
+         *
+         */
+        dsaBeneficiary?: string;
+        /**
+         * Name of the legal entity paying for the ad.
+         * Required by Meta when targeting EU users (DSA Article 26).
+         * Note Meta API spelling: dsa_payor (not dsa_payer).
+         *
+         */
+        dsaPayor?: string;
     };
 };
 
@@ -13652,6 +13736,20 @@ export type CreateCtwaAdData = {
          *
          */
         objective?: 'OUTCOME_ENGAGEMENT' | 'OUTCOME_SALES' | 'OUTCOME_LEADS';
+        /**
+         * Name of the legal entity benefiting from the ad.
+         * Required by Meta when targeting EU users (DSA Article 26).
+         * Not enforced at schema level; enforced server-side when targeting intersects EU member states.
+         *
+         */
+        dsaBeneficiary?: string;
+        /**
+         * Name of the legal entity paying for the ad.
+         * Required by Meta when targeting EU users (DSA Article 26).
+         * Note Meta API spelling: dsa_payor (not dsa_payer).
+         *
+         */
+        dsaPayor?: string;
     };
 };