@zernio/node 0.2.93 → 0.2.95

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -365,7 +365,7 @@ try {
365
365
  | `ads.listAdAccounts()` | List ad accounts |
366
366
  | `ads.listAds()` | List ads |
367
367
  | `ads.listConversionDestinations()` | List destinations for the Conversions API |
368
- | `ads.createCtwaAd()` | Create a Click-to-WhatsApp (CTWA) ad |
368
+ | `ads.createCtwaAd()` | Create Click-to-WhatsApp ad |
369
369
  | `ads.createStandaloneAd()` | Create standalone ad |
370
370
  | `ads.getAd()` | Get ad details |
371
371
  | `ads.getAdAnalytics()` | Get ad analytics |
@@ -558,7 +558,7 @@ try {
558
558
  | `whatsapp.approveWhatsAppGroupJoinRequests()` | Approve join requests |
559
559
  | `whatsapp.rejectWhatsAppGroupJoinRequests()` | Reject join requests |
560
560
  | `whatsapp.removeWhatsAppGroupParticipants()` | Remove participants |
561
- | `whatsapp.sendWhatsAppConversion()` | Send a WhatsApp conversation event to Meta CAPI for Business Messaging |
561
+ | `whatsapp.sendWhatsAppConversion()` | Send WhatsApp conversion event |
562
562
  | `whatsapp.uploadWhatsAppProfilePhoto()` | Upload profile picture |
563
563
 
564
564
  ### WhatsApp Flows
package/dist/index.d.mts CHANGED
@@ -12830,6 +12830,10 @@ type CreateStandaloneAdData = {
12830
12830
  * Meta only. Controls the Advantage audience feature (targeting_automation). 0 = disabled (default), 1 = enabled. Meta Marketing API requires this field on all ad set creation requests.
12831
12831
  */
12832
12832
  advantageAudience?: 0 | 1;
12833
+ /**
12834
+ * Meta only. Restrict the audience by gender. 'male' targets men only, 'female' targets women only, 'all' (default) targets everyone. Ignored by non-Meta platforms.
12835
+ */
12836
+ gender?: 'all' | 'male' | 'female';
12833
12837
  };
12834
12838
  };
12835
12839
  type CreateStandaloneAdResponse = (({
@@ -13248,7 +13252,7 @@ type CreateCtwaAdData = {
13248
13252
  budgetType: 'daily' | 'lifetime';
13249
13253
  /**
13250
13254
  * ISO 4217 currency code matching the ad account's currency
13251
- * (e.g. `USD`). Optional Meta infers from the ad account
13255
+ * (e.g. `USD`). Optional; Meta infers from the ad account
13252
13256
  * when omitted.
13253
13257
  *
13254
13258
  */
package/dist/index.d.ts CHANGED
@@ -12830,6 +12830,10 @@ type CreateStandaloneAdData = {
12830
12830
  * Meta only. Controls the Advantage audience feature (targeting_automation). 0 = disabled (default), 1 = enabled. Meta Marketing API requires this field on all ad set creation requests.
12831
12831
  */
12832
12832
  advantageAudience?: 0 | 1;
12833
+ /**
12834
+ * Meta only. Restrict the audience by gender. 'male' targets men only, 'female' targets women only, 'all' (default) targets everyone. Ignored by non-Meta platforms.
12835
+ */
12836
+ gender?: 'all' | 'male' | 'female';
12833
12837
  };
12834
12838
  };
12835
12839
  type CreateStandaloneAdResponse = (({
@@ -13248,7 +13252,7 @@ type CreateCtwaAdData = {
13248
13252
  budgetType: 'daily' | 'lifetime';
13249
13253
  /**
13250
13254
  * ISO 4217 currency code matching the ad account's currency
13251
- * (e.g. `USD`). Optional Meta infers from the ad account
13255
+ * (e.g. `USD`). Optional; Meta infers from the ad account
13252
13256
  * when omitted.
13253
13257
  *
13254
13258
  */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zernio/node",
3
- "version": "0.2.93",
3
+ "version": "0.2.95",
4
4
  "description": "The official Node.js library for the Zernio API",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -3482,7 +3482,7 @@ export const listConversionDestinations = <ThrowOnError extends boolean = false>
3482
3482
  };
3483
3483
 
3484
3484
  /**
3485
- * Send a WhatsApp conversation event to Meta CAPI for Business Messaging
3485
+ * Send WhatsApp conversion event
3486
3486
  * Forward a WhatsApp Business Messaging conversion event (`LeadSubmitted`,
3487
3487
  * `Purchase`, `AddToCart`, `InitiateCheckout`, `ViewContent`) to Meta's
3488
3488
  * Conversions API with `action_source = business_messaging` and
@@ -3497,14 +3497,14 @@ export const listConversionDestinations = <ThrowOnError extends boolean = false>
3497
3497
  * WhatsApp Business number.
3498
3498
  *
3499
3499
  * Identify the conversation by either `conversationId` (preferred) or
3500
- * `phoneE164` (digits only, no '+') at least one is required. If the
3501
- * conversation has no captured `ctwa_clid`, the request returns 422
3502
- * there's nothing to attribute.
3500
+ * `phoneE164` (digits only, no `+`). At least one is required. If the
3501
+ * conversation has no captured `ctwa_clid`, the request returns 422
3502
+ * because there is nothing to attribute.
3503
3503
  *
3504
- * Token + dataset coupling: the WhatsApp account's accessToken must have
3505
- * access to the configured `metaCapiDatasetId`. By default a WABA's
3504
+ * Token and dataset coupling: the WhatsApp account's accessToken must
3505
+ * have access to the configured `metaCapiDatasetId`. By default a WABA's
3506
3506
  * system-user token is scoped to the WABA's own Business Manager and
3507
- * cannot post to a pixel owned by a different Business Meta returns
3507
+ * cannot post to a pixel owned by a different Business; Meta returns
3508
3508
  * code 100 in that case. Either share the dataset with the WhatsApp
3509
3509
  * app's Business in BM, or use a dataset already in the same Business
3510
3510
  * as the WABA.
@@ -3518,18 +3518,18 @@ export const sendWhatsAppConversion = <ThrowOnError extends boolean = false>(opt
3518
3518
  };
3519
3519
 
3520
3520
  /**
3521
- * Create a Click-to-WhatsApp (CTWA) ad
3522
- * Create a CTWA ad on Meta when tapped, the ad opens a WhatsApp
3523
- * conversation with the business attached to the supplied Facebook
3524
- * Page. The full hierarchy (campaign ad set → creative → ad) is
3525
- * created and activated in one call.
3521
+ * Create Click-to-WhatsApp ad
3522
+ * Create a Click-to-WhatsApp (CTWA) ad on Meta. When tapped, the ad
3523
+ * opens a WhatsApp conversation with the business attached to the
3524
+ * supplied Facebook Page. The full hierarchy (campaign, ad set,
3525
+ * creative, ad) is created and activated in one call.
3526
3526
  *
3527
3527
  * The CTA is locked to `WHATSAPP_MESSAGE` and the destination is
3528
- * hard-coded to `https://api.whatsapp.com/send` Meta resolves the
3528
+ * hard-coded to `https://api.whatsapp.com/send`. Meta resolves the
3529
3529
  * actual WhatsApp number from the Page-to-WA pairing the user
3530
3530
  * configured in Page settings or Business Manager.
3531
3531
  *
3532
- * Prerequisites enforced by Meta (failure surfaces as a `platform_error`):
3532
+ * Prerequisites enforced by Meta (failure surfaces as a platform_error):
3533
3533
  * - The Facebook Page must already be paired with a verified WhatsApp
3534
3534
  * Business number.
3535
3535
  * - The WhatsApp Business Account must be business-verified.
@@ -13160,6 +13160,10 @@ export type CreateStandaloneAdData = {
13160
13160
  * Meta only. Controls the Advantage audience feature (targeting_automation). 0 = disabled (default), 1 = enabled. Meta Marketing API requires this field on all ad set creation requests.
13161
13161
  */
13162
13162
  advantageAudience?: 0 | 1;
13163
+ /**
13164
+ * Meta only. Restrict the audience by gender. 'male' targets men only, 'female' targets women only, 'all' (default) targets everyone. Ignored by non-Meta platforms.
13165
+ */
13166
+ gender?: 'all' | 'male' | 'female';
13163
13167
  };
13164
13168
  };
13165
13169
 
@@ -13608,7 +13612,7 @@ export type CreateCtwaAdData = {
13608
13612
  budgetType: 'daily' | 'lifetime';
13609
13613
  /**
13610
13614
  * ISO 4217 currency code matching the ad account's currency
13611
- * (e.g. `USD`). Optional Meta infers from the ad account
13615
+ * (e.g. `USD`). Optional; Meta infers from the ad account
13612
13616
  * when omitted.
13613
13617
  *
13614
13618
  */