@zernio/node 0.2.854 → 0.2.856

package/dist/index.d.mts

@@ -500,7 +500,7 @@ declare class Zernio {
         getWebhookSettings: <ThrowOnError extends boolean = false>(options?: _hey_api_client_fetch.OptionsLegacyParser<unknown, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetWebhookSettingsResponse, GetWebhookSettingsError, ThrowOnError>;
         createWebhookSettings: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<CreateWebhookSettingsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<CreateWebhookSettingsResponse, unknown, ThrowOnError>;
         updateWebhookSettings: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<UpdateWebhookSettingsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<UpdateWebhookSettingsResponse, unknown, ThrowOnError>;
-        deleteWebhookSettings: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<DeleteWebhookSettingsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<DeleteWebhookSettingsResponse, unknown, ThrowOnError>;
+        deleteWebhookSettings: <ThrowOnError extends boolean = false>(options?: _hey_api_client_fetch.OptionsLegacyParser<DeleteWebhookSettingsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<DeleteWebhookSettingsResponse, unknown, ThrowOnError>;
         getWebhookLogs: <ThrowOnError extends boolean = false>(options?: _hey_api_client_fetch.OptionsLegacyParser<GetWebhookLogsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetWebhookLogsResponse, unknown, ThrowOnError>;
         redeliverWebhookEvent: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<RedeliverWebhookEventData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<RedeliverWebhookEventResponse, unknown, ThrowOnError>;
         testWebhook: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<TestWebhookData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<TestWebhookResponse, unknown, ThrowOnError>;
@@ -4734,7 +4734,7 @@ type actionSource = 'web' | 'app' | 'offline' | 'crm' | 'phone_call' | 'system_g
  * EXACTLY ONE of the two shapes:
  *
  * - Single-creative: `headline`, `body`, and one of `imageUrl` / `video`,
- * OR `existingPostId` / `objectStoryId` to reuse an organic post.
+ * OR `platformPostId` / `objectStoryId` to reuse an organic post.
  * - Multi-creative: a non-empty `creatives[]` array. Top-level
  * creative fields must NOT be set on this shape.
  *
@@ -4778,11 +4778,16 @@ type CtwaAdRequestBody = {
      */
     adSetName?: string;
     /**
-     * Messaging and CTWA only. Platform post or reel ID, resolved like boost platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+     * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+     */
+    platformPostId?: string;
+    /**
+     * Alias of platformPostId, kept for existing callers. Sending both with different values is a 400.
+     * @deprecated
      */
     existingPostId?: string;
     /**
-     * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with existingPostId and fresh creative fields.
+     * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with platformPostId and fresh creative fields.
      */
     objectStoryId?: string;
     /**
@@ -4879,17 +4884,22 @@ type CtwaAdRequestBody = {
      * `body` / `imageUrl` / `video`): setting both is a 400,
      * unlike `POST /v1/ads/create` where the top-level fields
      * are silently ignored in multi-creative mode. Each entry
-     * supplies headline, body, and image/video, or an existingPostId or
+     * supplies headline, body, and image/video, or a platformPostId or
      * objectStoryId reference. Fresh and existing creatives can be mixed.
      *
      */
     creatives?: Array<{
         /**
-         * Messaging and CTWA only. Platform post or reel ID, resolved like boost platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+         * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+         */
+        platformPostId?: string;
+        /**
+         * Alias of platformPostId, kept for existing callers. Sending both with different values is a 400.
+         * @deprecated
          */
         existingPostId?: string;
         /**
-         * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with existingPostId and fresh creative fields.
+         * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with platformPostId and fresh creative fields.
          */
         objectStoryId?: string;
         /**
@@ -22098,9 +22108,14 @@ type CreateWebhookSettingsError = (unknown | {
 type UpdateWebhookSettingsData = {
     body: {
         /**
-         * Webhook ID to update (required)
+         * Webhook ID to update. Required unless the deprecated `_id` is sent instead.
          */
-        _id: string;
+        webhookId?: string;
+        /**
+         * Alias of webhookId, kept for existing callers
+         * @deprecated
+         */
+        _id?: string;
         /**
          * Webhook name (1-50 characters). Must be non-empty if provided.
          */
@@ -22148,11 +22163,16 @@ type UpdateWebhookSettingsError = (unknown | {
     required_group?: 'publishing' | 'engagement' | 'messages' | 'contacts' | 'analytics' | 'ads' | 'telephony' | 'accounts' | 'billing' | 'webhooks';
 });
 type DeleteWebhookSettingsData = {
-    query: {
+    query?: {
+        /**
+         * Alias of webhookId, kept for existing callers
+         * @deprecated
+         */
+        id?: string;
         /**
-         * Webhook ID to delete
+         * Webhook ID to delete, the same name the other /v1/webhooks operations use (logs, redeliver, test). Required unless the deprecated `id` is sent instead.
          */
-        id: string;
+        webhookId?: string;
     };
 };
 type DeleteWebhookSettingsResponse = ({

package/dist/index.d.ts

@@ -500,7 +500,7 @@ declare class Zernio {
         getWebhookSettings: <ThrowOnError extends boolean = false>(options?: _hey_api_client_fetch.OptionsLegacyParser<unknown, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetWebhookSettingsResponse, GetWebhookSettingsError, ThrowOnError>;
         createWebhookSettings: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<CreateWebhookSettingsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<CreateWebhookSettingsResponse, unknown, ThrowOnError>;
         updateWebhookSettings: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<UpdateWebhookSettingsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<UpdateWebhookSettingsResponse, unknown, ThrowOnError>;
-        deleteWebhookSettings: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<DeleteWebhookSettingsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<DeleteWebhookSettingsResponse, unknown, ThrowOnError>;
+        deleteWebhookSettings: <ThrowOnError extends boolean = false>(options?: _hey_api_client_fetch.OptionsLegacyParser<DeleteWebhookSettingsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<DeleteWebhookSettingsResponse, unknown, ThrowOnError>;
         getWebhookLogs: <ThrowOnError extends boolean = false>(options?: _hey_api_client_fetch.OptionsLegacyParser<GetWebhookLogsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetWebhookLogsResponse, unknown, ThrowOnError>;
         redeliverWebhookEvent: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<RedeliverWebhookEventData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<RedeliverWebhookEventResponse, unknown, ThrowOnError>;
         testWebhook: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<TestWebhookData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<TestWebhookResponse, unknown, ThrowOnError>;
@@ -4734,7 +4734,7 @@ type actionSource = 'web' | 'app' | 'offline' | 'crm' | 'phone_call' | 'system_g
  * EXACTLY ONE of the two shapes:
  *
  * - Single-creative: `headline`, `body`, and one of `imageUrl` / `video`,
- * OR `existingPostId` / `objectStoryId` to reuse an organic post.
+ * OR `platformPostId` / `objectStoryId` to reuse an organic post.
  * - Multi-creative: a non-empty `creatives[]` array. Top-level
  * creative fields must NOT be set on this shape.
  *
@@ -4778,11 +4778,16 @@ type CtwaAdRequestBody = {
      */
     adSetName?: string;
     /**
-     * Messaging and CTWA only. Platform post or reel ID, resolved like boost platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+     * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+     */
+    platformPostId?: string;
+    /**
+     * Alias of platformPostId, kept for existing callers. Sending both with different values is a 400.
+     * @deprecated
      */
     existingPostId?: string;
     /**
-     * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with existingPostId and fresh creative fields.
+     * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with platformPostId and fresh creative fields.
      */
     objectStoryId?: string;
     /**
@@ -4879,17 +4884,22 @@ type CtwaAdRequestBody = {
      * `body` / `imageUrl` / `video`): setting both is a 400,
      * unlike `POST /v1/ads/create` where the top-level fields
      * are silently ignored in multi-creative mode. Each entry
-     * supplies headline, body, and image/video, or an existingPostId or
+     * supplies headline, body, and image/video, or a platformPostId or
      * objectStoryId reference. Fresh and existing creatives can be mixed.
      *
      */
     creatives?: Array<{
         /**
-         * Messaging and CTWA only. Platform post or reel ID, resolved like boost platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+         * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+         */
+        platformPostId?: string;
+        /**
+         * Alias of platformPostId, kept for existing callers. Sending both with different values is a 400.
+         * @deprecated
          */
         existingPostId?: string;
         /**
-         * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with existingPostId and fresh creative fields.
+         * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with platformPostId and fresh creative fields.
          */
         objectStoryId?: string;
         /**
@@ -22098,9 +22108,14 @@ type CreateWebhookSettingsError = (unknown | {
 type UpdateWebhookSettingsData = {
     body: {
         /**
-         * Webhook ID to update (required)
+         * Webhook ID to update. Required unless the deprecated `_id` is sent instead.
          */
-        _id: string;
+        webhookId?: string;
+        /**
+         * Alias of webhookId, kept for existing callers
+         * @deprecated
+         */
+        _id?: string;
         /**
          * Webhook name (1-50 characters). Must be non-empty if provided.
          */
@@ -22148,11 +22163,16 @@ type UpdateWebhookSettingsError = (unknown | {
     required_group?: 'publishing' | 'engagement' | 'messages' | 'contacts' | 'analytics' | 'ads' | 'telephony' | 'accounts' | 'billing' | 'webhooks';
 });
 type DeleteWebhookSettingsData = {
-    query: {
+    query?: {
+        /**
+         * Alias of webhookId, kept for existing callers
+         * @deprecated
+         */
+        id?: string;
         /**
-         * Webhook ID to delete
+         * Webhook ID to delete, the same name the other /v1/webhooks operations use (logs, redeliver, test). Required unless the deprecated `id` is sent instead.
          */
-        id: string;
+        webhookId?: string;
     };
 };
 type DeleteWebhookSettingsResponse = ({

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -3557,7 +3557,7 @@ export const createWebhookSettings = <ThrowOnError extends boolean = false>(opti
 
 /**
  * Update webhook
- * Update an existing webhook configuration. All fields except `_id` are optional; only provided fields will be updated.
+ * Update an existing webhook configuration. All fields except `webhookId` are optional; only provided fields will be updated. `webhookId` is the same name the other /v1/webhooks operations use (logs, redeliver, test); the deprecated `_id` is still accepted in its place.
  *
  * When provided, `name` must be 1-50 characters, `url` must be a valid URL, and `events` must contain at least one event. Whitespace is trimmed from `url` before validation.
  *
@@ -3593,7 +3593,7 @@ export const updateWebhookSettings = <ThrowOnError extends boolean = false>(opti
  * Delete webhook
  * Permanently delete a webhook configuration.
  */
-export const deleteWebhookSettings = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<DeleteWebhookSettingsData, ThrowOnError>) => {
+export const deleteWebhookSettings = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<DeleteWebhookSettingsData, ThrowOnError>) => {
     return (options?.client ?? client).delete<DeleteWebhookSettingsResponse, DeleteWebhookSettingsError, ThrowOnError>({
         ...options,
         url: '/v1/webhooks/settings'
@@ -11747,8 +11747,8 @@ export const sendWhatsAppConversion = <ThrowOnError extends boolean = false>(opt
  * CONVERSATIONS optimization; the campaign objective defaults to OUTCOME_ENGAGEMENT.
  * Supports single-creative and multi-creative shapes. Supersedes POST /v1/ads/ctwa
  * (deprecated, equivalent to `destination: whatsapp`).
- * Existing posts and reels are supported through `existingPostId` or
- * `objectStoryId`, either per creative or at the top level. Omit fresh
+ * Existing posts and reels are supported through `platformPostId` (alias
+ * `existingPostId`) or `objectStoryId`, either per creative or at the top level. Omit fresh
  * media and copy for that creative. Optional `whatsappPhoneNumber` selects
  * a number already paired with the Page (WhatsApp destination only).
  * `accountId` is a Facebook, Instagram or Meta ads (business login) connection;
@@ -11784,15 +11784,15 @@ export const createCallAd = <ThrowOnError extends boolean = false>(options: Opti
  *
  * Supports two mutually-exclusive shapes:
  *
- * - **Single-creative**: supply top-level `headline`, `body`, and one of `imageUrl` / `video`, or an `existingPostId` / `objectStoryId` reference. Creates 1 campaign + 1 ad set + 1 ad.
+ * - **Single-creative**: supply top-level `headline`, `body`, and one of `imageUrl` / `video`, or a `platformPostId` / `objectStoryId` reference. Creates 1 campaign + 1 ad set + 1 ad.
  *
  * - **Multi-creative**: supply a `creatives[]` array with N entries (each carrying fresh media and copy or an existing post reference). Creates 1 campaign + 1 ad set + N ads sharing budget and targeting so Meta A/Bs the creatives inside a single auction instead of fragmenting budget across N parallel campaigns. Recommended when launching multiple creative variants for the same campaign.
  *
  * **Attach shape.** Send `adSetId` (with either creative shape) to add the ads to an EXISTING messaging ad set instead of building a campaign, so the ad set keeps its learning phase, the way to refresh a CTWA creative without resetting delivery. The ad set then owns budget, targeting and schedule, so `budgetAmount`, `budgetType`, `endDate`, `objective`, `countries`, `interests` and `audienceId` are rejected with a 400 alongside it rather than silently dropped. The target ad set's `destination_type` must match the ad's destination (a WhatsApp ad needs a `WHATSAPP` ad set), otherwise Meta would accept an ad that never delivers.
  *
  * Prerequisites enforced by Meta (surfaced as platform_error on failure): the Facebook Page must be paired with a verified WhatsApp Business number, the WhatsApp Business Account must be business-verified, and the Meta access token must carry ads_management.
- * Existing posts and reels are supported through `existingPostId` or
- * `objectStoryId`, either per creative or at the top level. Omit fresh
+ * Existing posts and reels are supported through `platformPostId` (alias
+ * `existingPostId`) or `objectStoryId`, either per creative or at the top level. Omit fresh
  * media and copy for that creative. Optional `whatsappPhoneNumber` selects
  * a number already paired with the Page (WhatsApp destination only).
  */

package/src/generated/types.gen.ts

@@ -3174,7 +3174,7 @@ export type actionSource = 'web' | 'app' | 'offline' | 'crm' | 'phone_call' | 's
  * EXACTLY ONE of the two shapes:
  *
  * - Single-creative: `headline`, `body`, and one of `imageUrl` / `video`,
- * OR `existingPostId` / `objectStoryId` to reuse an organic post.
+ * OR `platformPostId` / `objectStoryId` to reuse an organic post.
  * - Multi-creative: a non-empty `creatives[]` array. Top-level
  * creative fields must NOT be set on this shape.
  *
@@ -3218,11 +3218,16 @@ export type CtwaAdRequestBody = {
      */
     adSetName?: string;
     /**
-     * Messaging and CTWA only. Platform post or reel ID, resolved like boost platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+     * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+     */
+    platformPostId?: string;
+    /**
+     * Alias of platformPostId, kept for existing callers. Sending both with different values is a 400.
+     * @deprecated
      */
     existingPostId?: string;
     /**
-     * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with existingPostId and fresh creative fields.
+     * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with platformPostId and fresh creative fields.
      */
     objectStoryId?: string;
     /**
@@ -3319,17 +3324,22 @@ export type CtwaAdRequestBody = {
      * `body` / `imageUrl` / `video`): setting both is a 400,
      * unlike `POST /v1/ads/create` where the top-level fields
      * are silently ignored in multi-creative mode. Each entry
-     * supplies headline, body, and image/video, or an existingPostId or
+     * supplies headline, body, and image/video, or a platformPostId or
      * objectStoryId reference. Fresh and existing creatives can be mixed.
      *
      */
     creatives?: Array<{
         /**
-         * Messaging and CTWA only. Platform post or reel ID, resolved like boost platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+         * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+         */
+        platformPostId?: string;
+        /**
+         * Alias of platformPostId, kept for existing callers. Sending both with different values is a 400.
+         * @deprecated
          */
         existingPostId?: string;
         /**
-         * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with existingPostId and fresh creative fields.
+         * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with platformPostId and fresh creative fields.
          */
         objectStoryId?: string;
         /**
@@ -21528,9 +21538,14 @@ export type CreateWebhookSettingsError = (unknown | {
 export type UpdateWebhookSettingsData = {
     body: {
         /**
-         * Webhook ID to update (required)
+         * Webhook ID to update. Required unless the deprecated `_id` is sent instead.
          */
-        _id: string;
+        webhookId?: string;
+        /**
+         * Alias of webhookId, kept for existing callers
+         * @deprecated
+         */
+        _id?: string;
         /**
          * Webhook name (1-50 characters). Must be non-empty if provided.
          */
@@ -21581,11 +21596,16 @@ export type UpdateWebhookSettingsError = (unknown | {
 });
 
 export type DeleteWebhookSettingsData = {
-    query: {
+    query?: {
+        /**
+         * Alias of webhookId, kept for existing callers
+         * @deprecated
+         */
+        id?: string;
         /**
-         * Webhook ID to delete
+         * Webhook ID to delete, the same name the other /v1/webhooks operations use (logs, redeliver, test). Required unless the deprecated `id` is sent instead.
          */
-        id: string;
+        webhookId?: string;
     };
 };