@zernio/node 0.2.720 → 0.2.722

package/dist/index.d.mts

@@ -980,7 +980,7 @@ declare class Zernio {
      * adlibrary API
      */
     adlibrary: {
-        searchAdLibrary: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<SearchAdLibraryData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<SearchAdLibraryResponse, unknown, ThrowOnError>;
+        searchAdLibrary: <ThrowOnError extends boolean = false>(options?: _hey_api_client_fetch.OptionsLegacyParser<SearchAdLibraryData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<SearchAdLibraryResponse, unknown, ThrowOnError>;
     };
     /**
      * adaudiences API
@@ -22654,6 +22654,10 @@ type GetWhatsAppTemplatesResponse = ({
         status?: 'APPROVED' | 'PENDING' | 'REJECTED';
         category?: 'AUTHENTICATION' | 'MARKETING' | 'UTILITY';
         language?: string;
+        /**
+         * Only when a custom TTL is set; absent while the category default applies.
+         */
+        message_send_ttl_seconds?: number;
         components?: Array<{
             [key: string]: unknown;
         }>;
@@ -22716,6 +22720,10 @@ type CreateWhatsAppTemplateData = {
             };
             phone_number?: string;
         }>;
+        /**
+         * Delivery validity window in seconds: a message not delivered within it is dropped. Range depends on category: AUTHENTICATION 30 to 900, UTILITY 30 to 43200 (12h), MARKETING 43200 to 2592000 (30 days); -1 restores the 30-day default on AUTHENTICATION and UTILITY. Meta defaults to 600 for AUTHENTICATION and 30 days otherwise. If Meta later recategorises the template, it clears the TTL (read it back to check).
+         */
+        message_send_ttl_seconds?: number;
     };
 };
 type CreateWhatsAppTemplateResponse = ({
@@ -22729,6 +22737,10 @@ type CreateWhatsAppTemplateResponse = ({
         status?: string;
         category?: string;
         language?: string;
+        /**
+         * Echoed when supplied on the request.
+         */
+        message_send_ttl_seconds?: number;
     };
 });
 type CreateWhatsAppTemplateError = (unknown | {
@@ -22769,6 +22781,10 @@ type GetWhatsAppTemplateResponse = ({
         components?: Array<{
             [key: string]: unknown;
         }>;
+        /**
+         * Only when a custom TTL is set; absent while the category default applies.
+         */
+        message_send_ttl_seconds?: number;
         /**
          * Only when status is REJECTED.
          */
@@ -22803,9 +22819,13 @@ type UpdateWhatsAppTemplateData = {
          */
         language?: string;
         /**
-         * Updated template components
+         * Updated template components. Optional when only message_send_ttl_seconds changes; at least one of the two is required.
+         */
+        components?: Array<WhatsAppTemplateComponent>;
+        /**
+         * Delivery validity window in seconds: a message not delivered within it is dropped. Range depends on category: AUTHENTICATION 30 to 900, UTILITY 30 to 43200 (12h), MARKETING 43200 to 2592000 (30 days); -1 restores the 30-day default on AUTHENTICATION and UTILITY. Meta defaults to 600 for AUTHENTICATION and 30 days otherwise. If Meta later recategorises the template, it clears the TTL (read it back to check).
          */
-        components: Array<WhatsAppTemplateComponent>;
+        message_send_ttl_seconds?: number;
     };
     path: {
         /**
@@ -22915,6 +22935,10 @@ type GetWhatsAppTemplateByIdResponse = ({
         components?: Array<{
             [key: string]: unknown;
         }>;
+        /**
+         * Only when a custom TTL is set; absent while the category default applies.
+         */
+        message_send_ttl_seconds?: number;
         /**
          * Only when status is REJECTED.
          */
@@ -22937,9 +22961,13 @@ type UpdateWhatsAppTemplateByIdData = {
          */
         accountId: string;
         /**
-         * Updated template components
+         * Updated template components. Optional when only message_send_ttl_seconds changes; at least one of the two is required.
+         */
+        components?: Array<WhatsAppTemplateComponent>;
+        /**
+         * Delivery validity window in seconds: a message not delivered within it is dropped. Range depends on category: AUTHENTICATION 30 to 900, UTILITY 30 to 43200 (12h), MARKETING 43200 to 2592000 (30 days); -1 restores the 30-day default on AUTHENTICATION and UTILITY. Meta defaults to 600 for AUTHENTICATION and 30 days otherwise. If Meta later recategorises the template, it clears the TTL (read it back to check).
          */
-        components: Array<WhatsAppTemplateComponent>;
+        message_send_ttl_seconds?: number;
     };
     path: {
         /**
@@ -35563,11 +35591,11 @@ type SearchAdTargetingError = (unknown | {
     error?: string;
 });
 type SearchAdLibraryData = {
-    query: {
+    query?: {
         /**
-         * Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches.
+         * Zernio SocialAccount id. Required for LinkedIn (linkedin / linkedinads: its token searches). Optional for Meta, where any facebook / instagram / metaads account just selects the platform.
          */
-        accountId: string;
+        accountId?: string;
         /**
          * Meta only.
          */
@@ -35604,6 +35632,10 @@ type SearchAdLibraryData = {
          * Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list.
          */
         pageIds?: string;
+        /**
+         * Which archive to search. `meta` needs no accountId. Required unless accountId is given.
+         */
+        platform?: 'meta' | 'linkedin';
         /**
          * Meta only. Comma-separated publisher platforms: FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER, WHATSAPP, OCULUS, THREADS, STREAMING_SERVICES.
          */

package/dist/index.d.ts

@@ -980,7 +980,7 @@ declare class Zernio {
      * adlibrary API
      */
     adlibrary: {
-        searchAdLibrary: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<SearchAdLibraryData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<SearchAdLibraryResponse, unknown, ThrowOnError>;
+        searchAdLibrary: <ThrowOnError extends boolean = false>(options?: _hey_api_client_fetch.OptionsLegacyParser<SearchAdLibraryData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<SearchAdLibraryResponse, unknown, ThrowOnError>;
     };
     /**
      * adaudiences API
@@ -22654,6 +22654,10 @@ type GetWhatsAppTemplatesResponse = ({
         status?: 'APPROVED' | 'PENDING' | 'REJECTED';
         category?: 'AUTHENTICATION' | 'MARKETING' | 'UTILITY';
         language?: string;
+        /**
+         * Only when a custom TTL is set; absent while the category default applies.
+         */
+        message_send_ttl_seconds?: number;
         components?: Array<{
             [key: string]: unknown;
         }>;
@@ -22716,6 +22720,10 @@ type CreateWhatsAppTemplateData = {
             };
             phone_number?: string;
         }>;
+        /**
+         * Delivery validity window in seconds: a message not delivered within it is dropped. Range depends on category: AUTHENTICATION 30 to 900, UTILITY 30 to 43200 (12h), MARKETING 43200 to 2592000 (30 days); -1 restores the 30-day default on AUTHENTICATION and UTILITY. Meta defaults to 600 for AUTHENTICATION and 30 days otherwise. If Meta later recategorises the template, it clears the TTL (read it back to check).
+         */
+        message_send_ttl_seconds?: number;
     };
 };
 type CreateWhatsAppTemplateResponse = ({
@@ -22729,6 +22737,10 @@ type CreateWhatsAppTemplateResponse = ({
         status?: string;
         category?: string;
         language?: string;
+        /**
+         * Echoed when supplied on the request.
+         */
+        message_send_ttl_seconds?: number;
     };
 });
 type CreateWhatsAppTemplateError = (unknown | {
@@ -22769,6 +22781,10 @@ type GetWhatsAppTemplateResponse = ({
         components?: Array<{
             [key: string]: unknown;
         }>;
+        /**
+         * Only when a custom TTL is set; absent while the category default applies.
+         */
+        message_send_ttl_seconds?: number;
         /**
          * Only when status is REJECTED.
          */
@@ -22803,9 +22819,13 @@ type UpdateWhatsAppTemplateData = {
          */
         language?: string;
         /**
-         * Updated template components
+         * Updated template components. Optional when only message_send_ttl_seconds changes; at least one of the two is required.
+         */
+        components?: Array<WhatsAppTemplateComponent>;
+        /**
+         * Delivery validity window in seconds: a message not delivered within it is dropped. Range depends on category: AUTHENTICATION 30 to 900, UTILITY 30 to 43200 (12h), MARKETING 43200 to 2592000 (30 days); -1 restores the 30-day default on AUTHENTICATION and UTILITY. Meta defaults to 600 for AUTHENTICATION and 30 days otherwise. If Meta later recategorises the template, it clears the TTL (read it back to check).
          */
-        components: Array<WhatsAppTemplateComponent>;
+        message_send_ttl_seconds?: number;
     };
     path: {
         /**
@@ -22915,6 +22935,10 @@ type GetWhatsAppTemplateByIdResponse = ({
         components?: Array<{
             [key: string]: unknown;
         }>;
+        /**
+         * Only when a custom TTL is set; absent while the category default applies.
+         */
+        message_send_ttl_seconds?: number;
         /**
          * Only when status is REJECTED.
          */
@@ -22937,9 +22961,13 @@ type UpdateWhatsAppTemplateByIdData = {
          */
         accountId: string;
         /**
-         * Updated template components
+         * Updated template components. Optional when only message_send_ttl_seconds changes; at least one of the two is required.
+         */
+        components?: Array<WhatsAppTemplateComponent>;
+        /**
+         * Delivery validity window in seconds: a message not delivered within it is dropped. Range depends on category: AUTHENTICATION 30 to 900, UTILITY 30 to 43200 (12h), MARKETING 43200 to 2592000 (30 days); -1 restores the 30-day default on AUTHENTICATION and UTILITY. Meta defaults to 600 for AUTHENTICATION and 30 days otherwise. If Meta later recategorises the template, it clears the TTL (read it back to check).
          */
-        components: Array<WhatsAppTemplateComponent>;
+        message_send_ttl_seconds?: number;
     };
     path: {
         /**
@@ -35563,11 +35591,11 @@ type SearchAdTargetingError = (unknown | {
     error?: string;
 });
 type SearchAdLibraryData = {
-    query: {
+    query?: {
         /**
-         * Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches.
+         * Zernio SocialAccount id. Required for LinkedIn (linkedin / linkedinads: its token searches). Optional for Meta, where any facebook / instagram / metaads account just selects the platform.
          */
-        accountId: string;
+        accountId?: string;
         /**
          * Meta only.
          */
@@ -35604,6 +35632,10 @@ type SearchAdLibraryData = {
          * Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list.
          */
         pageIds?: string;
+        /**
+         * Which archive to search. `meta` needs no accountId. Required unless accountId is given.
+         */
+        platform?: 'meta' | 'linkedin';
         /**
          * Meta only. Comma-separated publisher platforms: FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER, WHATSAPP, OCULUS, THREADS, STREAMING_SERVICES.
          */

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -4472,7 +4472,7 @@ export const getWhatsAppTemplate = <ThrowOnError extends boolean = false>(option
 
 /**
  * Update template
- * Update one variant's components. Name, language and category cannot change after creation.
+ * Update one variant's components and/or its message_send_ttl_seconds. Name, language and category cannot change after creation.
  *
  * Meta stores one template per **name + language**, so a name identifies a family of variants,
  * each with its own Meta id. Pass `language` to address one variant. Without it, a name with a
@@ -4528,7 +4528,7 @@ export const getWhatsAppTemplateById = <ThrowOnError extends boolean = false>(op
 
 /**
  * Update template by id
- * Update one variant's components by its Meta id. Name, language and category cannot change.
+ * Update one variant's components and/or its message_send_ttl_seconds by its Meta id. Name, language and category cannot change.
  *
  * Meta only allows editing templates in `APPROVED`, `REJECTED` or `PAUSED` state; an approved
  * template can be edited once per 24 hours and up to 10 times per 30 days. A successful update
@@ -9563,19 +9563,18 @@ export const searchAdTargeting = <ThrowOnError extends boolean = false>(options:
 
 /**
  * Search the public Ad Library
- * Competitor and market research over the platform's public ad archive, searched with the
- * customer's own connected token (no extra scope): Meta's Ad Library (`GET /ads_archive`) for
- * a `facebook` / `instagram` / `metaads` account, LinkedIn's Ad Library (`GET /rest/adLibrary`)
- * for a `linkedin` / `linkedinads` account. Rows are returned in the platform's raw shape under
- * `data`; `paging.after` is an opaque cursor on both (`null` when exhausted).
+ * Competitor and market research over the public ad archives. Meta's Ad Library
+ * (`GET /ads_archive`) is searched with Zernio's own developer access, so `platform=meta` needs
+ * no connected account at all. LinkedIn's Ad Library (`GET /rest/adLibrary`) runs on a connected
+ * `linkedin` / `linkedinads` account, passed as `accountId`. Passing a Meta account as `accountId`
+ * also selects Meta. Rows are returned in the platform's raw shape under `data`; `paging.after`
+ * is an opaque cursor on both (`null` when exhausted).
  *
  * **Meta coverage.** Political and social-issue ads are searchable worldwide. Every other ad is
  * in the archive only if it was delivered to the EU or UK within the last year, so a US-only
  * commercial advertiser is invisible. Spend, impressions and demographics are political-only
- * fields and are left out of the default projection; request them via `fields`. Meta serves the
- * archive only to people who confirmed their identity and location at facebook.com/ID: until the
- * Facebook user behind the connection has done so, the call fails with
- * `meta_identity_confirmation_required` (403).
+ * fields and are left out of the default projection; request them via `fields`. All customers
+ * share Zernio's Meta quota, so a `429` means back off for a minute.
  *
  * **LinkedIn coverage.** Ads served after June 1 2023, worldwide, kept for a year after their
  * last impression. EU-delivered ads carry impression ranges and the disclosed targeting facets.
@@ -9586,7 +9585,7 @@ export const searchAdTargeting = <ThrowOnError extends boolean = false>(options:
  * `advertiser` is LinkedIn-only. Passing a param the account's platform does not support is a 400
  * naming the param.
  */
-export const searchAdLibrary = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<SearchAdLibraryData, ThrowOnError>) => {
+export const searchAdLibrary = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<SearchAdLibraryData, ThrowOnError>) => {
     return (options?.client ?? client).get<SearchAdLibraryResponse, SearchAdLibraryError, ThrowOnError>({
         ...options,
         url: '/v1/ads/library'

package/src/generated/types.gen.ts

@@ -22402,6 +22402,10 @@ export type GetWhatsAppTemplatesResponse = ({
         status?: 'APPROVED' | 'PENDING' | 'REJECTED';
         category?: 'AUTHENTICATION' | 'MARKETING' | 'UTILITY';
         language?: string;
+        /**
+         * Only when a custom TTL is set; absent while the category default applies.
+         */
+        message_send_ttl_seconds?: number;
         components?: Array<{
             [key: string]: unknown;
         }>;
@@ -22466,6 +22470,10 @@ export type CreateWhatsAppTemplateData = {
             };
             phone_number?: string;
         }>;
+        /**
+         * Delivery validity window in seconds: a message not delivered within it is dropped. Range depends on category: AUTHENTICATION 30 to 900, UTILITY 30 to 43200 (12h), MARKETING 43200 to 2592000 (30 days); -1 restores the 30-day default on AUTHENTICATION and UTILITY. Meta defaults to 600 for AUTHENTICATION and 30 days otherwise. If Meta later recategorises the template, it clears the TTL (read it back to check).
+         */
+        message_send_ttl_seconds?: number;
     };
 };
 
@@ -22480,6 +22488,10 @@ export type CreateWhatsAppTemplateResponse = ({
         status?: string;
         category?: string;
         language?: string;
+        /**
+         * Echoed when supplied on the request.
+         */
+        message_send_ttl_seconds?: number;
     };
 });
 
@@ -22523,6 +22535,10 @@ export type GetWhatsAppTemplateResponse = ({
         components?: Array<{
             [key: string]: unknown;
         }>;
+        /**
+         * Only when a custom TTL is set; absent while the category default applies.
+         */
+        message_send_ttl_seconds?: number;
         /**
          * Only when status is REJECTED.
          */
@@ -22559,9 +22575,13 @@ export type UpdateWhatsAppTemplateData = {
          */
         language?: string;
         /**
-         * Updated template components
+         * Updated template components. Optional when only message_send_ttl_seconds changes; at least one of the two is required.
+         */
+        components?: Array<WhatsAppTemplateComponent>;
+        /**
+         * Delivery validity window in seconds: a message not delivered within it is dropped. Range depends on category: AUTHENTICATION 30 to 900, UTILITY 30 to 43200 (12h), MARKETING 43200 to 2592000 (30 days); -1 restores the 30-day default on AUTHENTICATION and UTILITY. Meta defaults to 600 for AUTHENTICATION and 30 days otherwise. If Meta later recategorises the template, it clears the TTL (read it back to check).
          */
-        components: Array<WhatsAppTemplateComponent>;
+        message_send_ttl_seconds?: number;
     };
     path: {
         /**
@@ -22678,6 +22698,10 @@ export type GetWhatsAppTemplateByIdResponse = ({
         components?: Array<{
             [key: string]: unknown;
         }>;
+        /**
+         * Only when a custom TTL is set; absent while the category default applies.
+         */
+        message_send_ttl_seconds?: number;
         /**
          * Only when status is REJECTED.
          */
@@ -22702,9 +22726,13 @@ export type UpdateWhatsAppTemplateByIdData = {
          */
         accountId: string;
         /**
-         * Updated template components
+         * Updated template components. Optional when only message_send_ttl_seconds changes; at least one of the two is required.
+         */
+        components?: Array<WhatsAppTemplateComponent>;
+        /**
+         * Delivery validity window in seconds: a message not delivered within it is dropped. Range depends on category: AUTHENTICATION 30 to 900, UTILITY 30 to 43200 (12h), MARKETING 43200 to 2592000 (30 days); -1 restores the 30-day default on AUTHENTICATION and UTILITY. Meta defaults to 600 for AUTHENTICATION and 30 days otherwise. If Meta later recategorises the template, it clears the TTL (read it back to check).
          */
-        components: Array<WhatsAppTemplateComponent>;
+        message_send_ttl_seconds?: number;
     };
     path: {
         /**
@@ -36220,11 +36248,11 @@ export type SearchAdTargetingError = (unknown | {
 });
 
 export type SearchAdLibraryData = {
-    query: {
+    query?: {
         /**
-         * Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches.
+         * Zernio SocialAccount id. Required for LinkedIn (linkedin / linkedinads: its token searches). Optional for Meta, where any facebook / instagram / metaads account just selects the platform.
          */
-        accountId: string;
+        accountId?: string;
         /**
          * Meta only.
          */
@@ -36261,6 +36289,10 @@ export type SearchAdLibraryData = {
          * Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list.
          */
         pageIds?: string;
+        /**
+         * Which archive to search. `meta` needs no accountId. Required unless accountId is given.
+         */
+        platform?: 'meta' | 'linkedin';
         /**
          * Meta only. Comma-separated publisher platforms: FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER, WHATSAPP, OCULUS, THREADS, STREAMING_SERVICES.
          */