@getlatedev/node 0.2.475 → 0.2.477

package/dist/index.d.mts

@@ -22973,7 +22973,10 @@ type BulkCreateContactsData = {
         platform?: string;
         contacts: Array<{
             name: string;
-            platformIdentifier: string;
+            /**
+             * Required when the top-level accountId is set (channel mode). A row missing it in that mode is rejected individually and reported in errors[], not a 400 for the whole import.
+             */
+            platformIdentifier?: string;
             displayIdentifier?: string;
             email?: string;
             company?: string;
@@ -24646,6 +24649,10 @@ type ListAdCampaignsData = {
          * Start of metrics date range (YYYY-MM-DD, inclusive). Defaults to 90 days ago when both date params are omitted.
          */
         fromDate?: string;
+        /**
+         * Meta only. Campaign reads aggregate over ad documents, so a campaign with ZERO ads is normally invisible here — the state the two-step create (campaign, then ads via `existingCampaignId`) leaves behind whenever Meta rejects the ad step. Set true to list those too, with `adCount: 0` and zeroed metrics. Requires `accountId` and `adAccountId`, since an empty campaign has no ad row to resolve a token or ad account from.
+         */
+        includeEmpty?: boolean;
         limit?: number;
         /**
          * Page number (1-based)
@@ -24770,6 +24777,10 @@ type UpdateAdCampaignStatusError = (unknown | {
 });
 type UpdateAdCampaignData = {
     body: {
+        /**
+         * Zernio SocialAccount id owning the ad account. Required only to update an EMPTY campaign (zero ads), which has no local Ad documents to resolve a token from.
+         */
+        accountId?: string;
         platform: 'facebook' | 'instagram';
         budget?: {
             /**

package/dist/index.d.ts

@@ -22973,7 +22973,10 @@ type BulkCreateContactsData = {
         platform?: string;
         contacts: Array<{
             name: string;
-            platformIdentifier: string;
+            /**
+             * Required when the top-level accountId is set (channel mode). A row missing it in that mode is rejected individually and reported in errors[], not a 400 for the whole import.
+             */
+            platformIdentifier?: string;
             displayIdentifier?: string;
             email?: string;
             company?: string;
@@ -24646,6 +24649,10 @@ type ListAdCampaignsData = {
          * Start of metrics date range (YYYY-MM-DD, inclusive). Defaults to 90 days ago when both date params are omitted.
          */
         fromDate?: string;
+        /**
+         * Meta only. Campaign reads aggregate over ad documents, so a campaign with ZERO ads is normally invisible here — the state the two-step create (campaign, then ads via `existingCampaignId`) leaves behind whenever Meta rejects the ad step. Set true to list those too, with `adCount: 0` and zeroed metrics. Requires `accountId` and `adAccountId`, since an empty campaign has no ad row to resolve a token or ad account from.
+         */
+        includeEmpty?: boolean;
         limit?: number;
         /**
          * Page number (1-based)
@@ -24770,6 +24777,10 @@ type UpdateAdCampaignStatusError = (unknown | {
 });
 type UpdateAdCampaignData = {
     body: {
+        /**
+         * Zernio SocialAccount id owning the ad account. Required only to update an EMPTY campaign (zero ads), which has no local Ad documents to resolve a token from.
+         */
+        accountId?: string;
         platform: 'facebook' | 'instagram';
         budget?: {
             /**

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -6062,7 +6062,7 @@ export const getContactChannels = <ThrowOnError extends boolean = false>(options
 
 /**
  * Bulk create contacts
- * Import up to 1000 contacts at a time. Skips duplicates, merging any new tags onto the existing contact. accountId is required whenever contacts carry a platformIdentifier (or a row-level accountId); platform is always derived from the resolved account, never used to decide whether channels are created, and a mismatched platform 404s as account not found. On phone platforms (whatsapp, sms) the platformIdentifier is normalized to digits and a value that is not phone-shaped is rejected per contact and reported in errors[], not imported.
+ * Import up to 1000 contacts at a time. Skips duplicates, merging any new tags onto the existing contact. accountId is required whenever contacts carry a platformIdentifier (or a row-level accountId); platform is always derived from the resolved account, never used to decide whether channels are created, and a mismatched platform 404s as account not found. When accountId is set, each contact must carry a platformIdentifier; a row missing it is rejected individually (reported in errors[], HTTP 200), not a 400 for the whole import. On phone platforms (whatsapp, sms) the platformIdentifier is normalized to digits and a value that is not phone-shaped is rejected per contact and reported in errors[], not imported.
  */
 export const bulkCreateContacts = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<BulkCreateContactsData, ThrowOnError>) => {
     return (options?.client ?? client).post<BulkCreateContactsResponse, BulkCreateContactsError, ThrowOnError>({
@@ -6697,6 +6697,12 @@ export const updateAdCampaignStatus = <ThrowOnError extends boolean = false>(opt
  * Update a campaign
  * Campaign-level edits. At least one of `budget`, `bidStrategy`, `name` or `platformSpecificData` is required.
  *
+ * **Empty campaigns.** A campaign with zero ads has no local Ad documents to
+ * resolve, so this would 404 even though it exists on Meta. Send `accountId`
+ * in the body to skip the local lookup and forward the update to Meta. The
+ * response then carries `updated: 0`, since there are no local rows to mirror
+ * onto. `accountId` is ignored when the campaign does have ads.
+ *
  * - `budget` updates the CBO (Campaign Budget Optimization) budget. For ABO campaigns
  * (where the budget lives on the ad set), use PUT /v1/ads/ad-sets/{adSetId} instead — this endpoint
  * will return 409 with code BUDGET_LEVEL_MISMATCH.

package/src/generated/types.gen.ts

@@ -23202,7 +23202,10 @@ export type BulkCreateContactsData = {
         platform?: string;
         contacts: Array<{
             name: string;
-            platformIdentifier: string;
+            /**
+             * Required when the top-level accountId is set (channel mode). A row missing it in that mode is rejected individually and reported in errors[], not a 400 for the whole import.
+             */
+            platformIdentifier?: string;
             displayIdentifier?: string;
             email?: string;
             company?: string;
@@ -25022,6 +25025,10 @@ export type ListAdCampaignsData = {
          * Start of metrics date range (YYYY-MM-DD, inclusive). Defaults to 90 days ago when both date params are omitted.
          */
         fromDate?: string;
+        /**
+         * Meta only. Campaign reads aggregate over ad documents, so a campaign with ZERO ads is normally invisible here — the state the two-step create (campaign, then ads via `existingCampaignId`) leaves behind whenever Meta rejects the ad step. Set true to list those too, with `adCount: 0` and zeroed metrics. Requires `accountId` and `adAccountId`, since an empty campaign has no ad row to resolve a token or ad account from.
+         */
+        includeEmpty?: boolean;
         limit?: number;
         /**
          * Page number (1-based)
@@ -25155,6 +25162,10 @@ export type UpdateAdCampaignStatusError = (unknown | {
 
 export type UpdateAdCampaignData = {
     body: {
+        /**
+         * Zernio SocialAccount id owning the ad account. Required only to update an EMPTY campaign (zero ads), which has no local Ad documents to resolve a token from.
+         */
+        accountId?: string;
         platform: 'facebook' | 'instagram';
         budget?: {
             /**