@zernio/node 0.2.700 → 0.2.702

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/dist/index.d.mts CHANGED
@@ -5857,6 +5857,14 @@ type MetaAdsPlatformData = {
5857
5857
  * Decimal ROAS multiplier (2.0 = 2.0x). Required when bidStrategy is LOWEST_COST_WITH_MIN_ROAS; sending it without bidStrategy is a 400.
5858
5858
  */
5859
5859
  roasAverageFloor?: number;
5860
+ /**
5861
+ * Meta daily_min_spend_target on the ad set being created: the least it should spend per day, in whole currency units. It reserves a share of a CAMPAIGN budget, so it requires budgetLevel campaign or an existingCampaignId whose campaign has the budget (Advantage campaign budget / CBO); with an ad-set budget it is a 400, because Meta rejects a spend limit on an ad set that owns its budget. A target, not a guarantee. Mutually exclusive with lifetimeMinSpendTarget: the flavour must match the campaign budget type. Rejected with 400 on POST /v1/ads/boost and in adSetId attach mode: use PUT /v1/ads/ad-sets/{adSetId} for an ad set that already exists.
5862
+ */
5863
+ dailyMinSpendTarget?: number;
5864
+ /**
5865
+ * Meta lifetime_min_spend_target: the lifetime-budget flavour of dailyMinSpendTarget, in whole currency units. Same rules and same rejections.
5866
+ */
5867
+ lifetimeMinSpendTarget?: number;
5860
5868
  };
5861
5869
  type Money = {
5862
5870
  /**
@@ -13803,7 +13811,7 @@ type GetConnectUrlData = {
13803
13811
  */
13804
13812
  profileId: string;
13805
13813
  /**
13806
- * Your custom redirect URL after connection completes. Accepts an http(s) URL, a custom app scheme for mobile deeplinks (e.g. myapp://callback), or a relative path. Result params are appended with the URL API, so an existing query string is preserved. Standard mode appends connected={platform}&profileId=X&accountId=Y&username=Z. Headless mode appends OAuth data params for platforms requiring selection (e.g. LinkedIn orgs, Facebook pages). If no selection is needed, the account is created directly and the redirect includes accountId.
13814
+ * Your custom redirect URL after connection completes. MUST be an absolute http(s) URL or a custom app scheme for mobile deeplinks (e.g. myapp://callback); a relative path is rejected with 400 INVALID_REDIRECT_URL. Result params are appended with the URL API, so an existing query string is preserved. Standard mode appends connected={platform}&profileId=X&accountId=Y&username=Z. Headless mode appends OAuth data params for platforms requiring selection (e.g. LinkedIn orgs, Facebook pages). If no selection is needed, the account is created directly and the redirect includes accountId.
13807
13815
  *
13808
13816
  * On failure, the browser is sent to the same redirect_url with `error` and `platform` appended.
13809
13817
  * `error` and `platform` are always present. `error_message`, `is_user_fixable`, `reason` and
@@ -14061,8 +14069,9 @@ type ConnectAdsData = {
14061
14069
  /**
14062
14070
  * Custom URL the browser is sent to once the OAuth flow finishes. Honored on
14063
14071
  * every ads platform, including the separate-token (`tiktok`, `twitter`) and
14064
- * standalone (`googleads`) flows. Accepts an http(s) URL, a custom app scheme
14065
- * for mobile deeplinks (e.g. myapp://callback), or a relative path. On success
14072
+ * standalone (`googleads`) flows. MUST be an absolute http(s) URL or a custom
14073
+ * app scheme for mobile deeplinks (e.g. myapp://callback); a relative path is
14074
+ * rejected with 400 INVALID_REDIRECT_URL. On success
14066
14075
  * `tiktok`, `twitter` and `googleads` land on the URL unchanged, while the
14067
14076
  * same-token platforms (`facebook`, `instagram`, `linkedin`, `pinterest`)
14068
14077
  * append `connected`, `profileId`, `accountId`, `username` and, on API-key
@@ -14104,7 +14113,7 @@ type GetShopifyConnectUrlData = {
14104
14113
  */
14105
14114
  profileId: string;
14106
14115
  /**
14107
- * Your custom redirect URL after connection completes. Accepts an http(s) URL, a custom app scheme for mobile deeplinks (e.g. myapp://callback), or a relative path. On failure an `error` query param is appended.
14116
+ * Your custom redirect URL after connection completes. MUST be an absolute http(s) URL or a custom app scheme for mobile deeplinks (e.g. myapp://callback); a relative path is rejected with 400 INVALID_REDIRECT_URL. On failure an `error` query param is appended.
14108
14117
  */
14109
14118
  redirect_url?: string;
14110
14119
  /**
@@ -30374,6 +30383,27 @@ type UpdateAdSetData = {
30374
30383
  * Ad set end_time (ISO 8601).
30375
30384
  */
30376
30385
  endDate?: string;
30386
+ /**
30387
+ * Meta `daily_min_spend_target`: the least this ad set should spend per day, in whole
30388
+ * currency units of the ad account. It reserves a share of a CAMPAIGN budget for one ad
30389
+ * set, so it requires a campaign using Advantage campaign budget (CBO). On an ad set
30390
+ * that owns its budget (ABO) this returns 409 — move the budget to the campaign with
30391
+ * `PUT /v1/ads/campaigns/{campaignId}` first. Meta treats it as a target, not a
30392
+ * guarantee, and rejects the combined minimum of a campaign's ad sets going over the
30393
+ * campaign budget.
30394
+ * Mutually exclusive with `lifetimeMinSpendTarget` (400): the flavour must match the
30395
+ * campaign budget type, a daily budget takes a daily target.
30396
+ * Read it back with `GET /v1/ads/ad-sets/{adSetId}?fields=daily_min_spend_target`.
30397
+ *
30398
+ */
30399
+ dailyMinSpendTarget?: number;
30400
+ /**
30401
+ * Meta `lifetime_min_spend_target`: the lifetime-budget flavour of
30402
+ * `dailyMinSpendTarget`, in whole currency units. Send this one when the campaign
30403
+ * budget is a lifetime budget. Same rules and same rejections.
30404
+ *
30405
+ */
30406
+ lifetimeMinSpendTarget?: number;
30377
30407
  /**
30378
30408
  * Meta ad-set promoted_object, forwarded verbatim (same shape as /v1/ads/create). Unknown keys are rejected with 400.
30379
30409
  */
@@ -33583,6 +33613,9 @@ type CreateStandaloneAdData = {
33583
33613
  * Sending the bid fields in BOTH places returns a 400
33584
33614
  * (`mutually_exclusive_fields`), and sending any of them in
33585
33615
  * `adSetId` attach mode is a 400 too (the ad set already has its bid).
33616
+ * `dailyMinSpendTarget` / `lifetimeMinSpendTarget` set the new ad set's
33617
+ * minimum spend and live here only; they are rejected in `adSetId` attach
33618
+ * mode as well.
33586
33619
  *
33587
33620
  */
33588
33621
  platformSpecificData?: (LinkedInAdsPlatformData | MetaAdsPlatformData);
package/dist/index.d.ts CHANGED
@@ -5857,6 +5857,14 @@ type MetaAdsPlatformData = {
5857
5857
  * Decimal ROAS multiplier (2.0 = 2.0x). Required when bidStrategy is LOWEST_COST_WITH_MIN_ROAS; sending it without bidStrategy is a 400.
5858
5858
  */
5859
5859
  roasAverageFloor?: number;
5860
+ /**
5861
+ * Meta daily_min_spend_target on the ad set being created: the least it should spend per day, in whole currency units. It reserves a share of a CAMPAIGN budget, so it requires budgetLevel campaign or an existingCampaignId whose campaign has the budget (Advantage campaign budget / CBO); with an ad-set budget it is a 400, because Meta rejects a spend limit on an ad set that owns its budget. A target, not a guarantee. Mutually exclusive with lifetimeMinSpendTarget: the flavour must match the campaign budget type. Rejected with 400 on POST /v1/ads/boost and in adSetId attach mode: use PUT /v1/ads/ad-sets/{adSetId} for an ad set that already exists.
5862
+ */
5863
+ dailyMinSpendTarget?: number;
5864
+ /**
5865
+ * Meta lifetime_min_spend_target: the lifetime-budget flavour of dailyMinSpendTarget, in whole currency units. Same rules and same rejections.
5866
+ */
5867
+ lifetimeMinSpendTarget?: number;
5860
5868
  };
5861
5869
  type Money = {
5862
5870
  /**
@@ -13803,7 +13811,7 @@ type GetConnectUrlData = {
13803
13811
  */
13804
13812
  profileId: string;
13805
13813
  /**
13806
- * Your custom redirect URL after connection completes. Accepts an http(s) URL, a custom app scheme for mobile deeplinks (e.g. myapp://callback), or a relative path. Result params are appended with the URL API, so an existing query string is preserved. Standard mode appends connected={platform}&profileId=X&accountId=Y&username=Z. Headless mode appends OAuth data params for platforms requiring selection (e.g. LinkedIn orgs, Facebook pages). If no selection is needed, the account is created directly and the redirect includes accountId.
13814
+ * Your custom redirect URL after connection completes. MUST be an absolute http(s) URL or a custom app scheme for mobile deeplinks (e.g. myapp://callback); a relative path is rejected with 400 INVALID_REDIRECT_URL. Result params are appended with the URL API, so an existing query string is preserved. Standard mode appends connected={platform}&profileId=X&accountId=Y&username=Z. Headless mode appends OAuth data params for platforms requiring selection (e.g. LinkedIn orgs, Facebook pages). If no selection is needed, the account is created directly and the redirect includes accountId.
13807
13815
  *
13808
13816
  * On failure, the browser is sent to the same redirect_url with `error` and `platform` appended.
13809
13817
  * `error` and `platform` are always present. `error_message`, `is_user_fixable`, `reason` and
@@ -14061,8 +14069,9 @@ type ConnectAdsData = {
14061
14069
  /**
14062
14070
  * Custom URL the browser is sent to once the OAuth flow finishes. Honored on
14063
14071
  * every ads platform, including the separate-token (`tiktok`, `twitter`) and
14064
- * standalone (`googleads`) flows. Accepts an http(s) URL, a custom app scheme
14065
- * for mobile deeplinks (e.g. myapp://callback), or a relative path. On success
14072
+ * standalone (`googleads`) flows. MUST be an absolute http(s) URL or a custom
14073
+ * app scheme for mobile deeplinks (e.g. myapp://callback); a relative path is
14074
+ * rejected with 400 INVALID_REDIRECT_URL. On success
14066
14075
  * `tiktok`, `twitter` and `googleads` land on the URL unchanged, while the
14067
14076
  * same-token platforms (`facebook`, `instagram`, `linkedin`, `pinterest`)
14068
14077
  * append `connected`, `profileId`, `accountId`, `username` and, on API-key
@@ -14104,7 +14113,7 @@ type GetShopifyConnectUrlData = {
14104
14113
  */
14105
14114
  profileId: string;
14106
14115
  /**
14107
- * Your custom redirect URL after connection completes. Accepts an http(s) URL, a custom app scheme for mobile deeplinks (e.g. myapp://callback), or a relative path. On failure an `error` query param is appended.
14116
+ * Your custom redirect URL after connection completes. MUST be an absolute http(s) URL or a custom app scheme for mobile deeplinks (e.g. myapp://callback); a relative path is rejected with 400 INVALID_REDIRECT_URL. On failure an `error` query param is appended.
14108
14117
  */
14109
14118
  redirect_url?: string;
14110
14119
  /**
@@ -30374,6 +30383,27 @@ type UpdateAdSetData = {
30374
30383
  * Ad set end_time (ISO 8601).
30375
30384
  */
30376
30385
  endDate?: string;
30386
+ /**
30387
+ * Meta `daily_min_spend_target`: the least this ad set should spend per day, in whole
30388
+ * currency units of the ad account. It reserves a share of a CAMPAIGN budget for one ad
30389
+ * set, so it requires a campaign using Advantage campaign budget (CBO). On an ad set
30390
+ * that owns its budget (ABO) this returns 409 — move the budget to the campaign with
30391
+ * `PUT /v1/ads/campaigns/{campaignId}` first. Meta treats it as a target, not a
30392
+ * guarantee, and rejects the combined minimum of a campaign's ad sets going over the
30393
+ * campaign budget.
30394
+ * Mutually exclusive with `lifetimeMinSpendTarget` (400): the flavour must match the
30395
+ * campaign budget type, a daily budget takes a daily target.
30396
+ * Read it back with `GET /v1/ads/ad-sets/{adSetId}?fields=daily_min_spend_target`.
30397
+ *
30398
+ */
30399
+ dailyMinSpendTarget?: number;
30400
+ /**
30401
+ * Meta `lifetime_min_spend_target`: the lifetime-budget flavour of
30402
+ * `dailyMinSpendTarget`, in whole currency units. Send this one when the campaign
30403
+ * budget is a lifetime budget. Same rules and same rejections.
30404
+ *
30405
+ */
30406
+ lifetimeMinSpendTarget?: number;
30377
30407
  /**
30378
30408
  * Meta ad-set promoted_object, forwarded verbatim (same shape as /v1/ads/create). Unknown keys are rejected with 400.
30379
30409
  */
@@ -33583,6 +33613,9 @@ type CreateStandaloneAdData = {
33583
33613
  * Sending the bid fields in BOTH places returns a 400
33584
33614
  * (`mutually_exclusive_fields`), and sending any of them in
33585
33615
  * `adSetId` attach mode is a 400 too (the ad set already has its bid).
33616
+ * `dailyMinSpendTarget` / `lifetimeMinSpendTarget` set the new ad set's
33617
+ * minimum spend and live here only; they are rejected in `adSetId` attach
33618
+ * mode as well.
33586
33619
  *
33587
33620
  */
33588
33621
  platformSpecificData?: (LinkedInAdsPlatformData | MetaAdsPlatformData);
package/dist/index.js CHANGED
@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
36
36
  // package.json
37
37
  var package_default = {
38
38
  name: "@zernio/node",
39
- version: "0.2.700",
39
+ version: "0.2.702",
40
40
  description: "The official Node.js library for the Zernio API",
41
41
  main: "dist/index.js",
42
42
  module: "dist/index.mjs",
package/dist/index.mjs CHANGED
@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
5
5
  // package.json
6
6
  var package_default = {
7
7
  name: "@zernio/node",
8
- version: "0.2.700",
8
+ version: "0.2.702",
9
9
  description: "The official Node.js library for the Zernio API",
10
10
  main: "dist/index.js",
11
11
  module: "dist/index.mjs",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zernio/node",
3
- "version": "0.2.700",
3
+ "version": "0.2.702",
4
4
  "description": "The official Node.js library for the Zernio API",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -4668,6 +4668,14 @@ export type MetaAdsPlatformData = {
4668
4668
  * Decimal ROAS multiplier (2.0 = 2.0x). Required when bidStrategy is LOWEST_COST_WITH_MIN_ROAS; sending it without bidStrategy is a 400.
4669
4669
  */
4670
4670
  roasAverageFloor?: number;
4671
+ /**
4672
+ * Meta daily_min_spend_target on the ad set being created: the least it should spend per day, in whole currency units. It reserves a share of a CAMPAIGN budget, so it requires budgetLevel campaign or an existingCampaignId whose campaign has the budget (Advantage campaign budget / CBO); with an ad-set budget it is a 400, because Meta rejects a spend limit on an ad set that owns its budget. A target, not a guarantee. Mutually exclusive with lifetimeMinSpendTarget: the flavour must match the campaign budget type. Rejected with 400 on POST /v1/ads/boost and in adSetId attach mode: use PUT /v1/ads/ad-sets/{adSetId} for an ad set that already exists.
4673
+ */
4674
+ dailyMinSpendTarget?: number;
4675
+ /**
4676
+ * Meta lifetime_min_spend_target: the lifetime-budget flavour of dailyMinSpendTarget, in whole currency units. Same rules and same rejections.
4677
+ */
4678
+ lifetimeMinSpendTarget?: number;
4671
4679
  };
4672
4680
 
4673
4681
  export type Money = {
@@ -13062,7 +13070,7 @@ export type GetConnectUrlData = {
13062
13070
  */
13063
13071
  profileId: string;
13064
13072
  /**
13065
- * Your custom redirect URL after connection completes. Accepts an http(s) URL, a custom app scheme for mobile deeplinks (e.g. myapp://callback), or a relative path. Result params are appended with the URL API, so an existing query string is preserved. Standard mode appends connected={platform}&profileId=X&accountId=Y&username=Z. Headless mode appends OAuth data params for platforms requiring selection (e.g. LinkedIn orgs, Facebook pages). If no selection is needed, the account is created directly and the redirect includes accountId.
13073
+ * Your custom redirect URL after connection completes. MUST be an absolute http(s) URL or a custom app scheme for mobile deeplinks (e.g. myapp://callback); a relative path is rejected with 400 INVALID_REDIRECT_URL. Result params are appended with the URL API, so an existing query string is preserved. Standard mode appends connected={platform}&profileId=X&accountId=Y&username=Z. Headless mode appends OAuth data params for platforms requiring selection (e.g. LinkedIn orgs, Facebook pages). If no selection is needed, the account is created directly and the redirect includes accountId.
13066
13074
  *
13067
13075
  * On failure, the browser is sent to the same redirect_url with `error` and `platform` appended.
13068
13076
  * `error` and `platform` are always present. `error_message`, `is_user_fixable`, `reason` and
@@ -13326,8 +13334,9 @@ export type ConnectAdsData = {
13326
13334
  /**
13327
13335
  * Custom URL the browser is sent to once the OAuth flow finishes. Honored on
13328
13336
  * every ads platform, including the separate-token (`tiktok`, `twitter`) and
13329
- * standalone (`googleads`) flows. Accepts an http(s) URL, a custom app scheme
13330
- * for mobile deeplinks (e.g. myapp://callback), or a relative path. On success
13337
+ * standalone (`googleads`) flows. MUST be an absolute http(s) URL or a custom
13338
+ * app scheme for mobile deeplinks (e.g. myapp://callback); a relative path is
13339
+ * rejected with 400 INVALID_REDIRECT_URL. On success
13331
13340
  * `tiktok`, `twitter` and `googleads` land on the URL unchanged, while the
13332
13341
  * same-token platforms (`facebook`, `instagram`, `linkedin`, `pinterest`)
13333
13342
  * append `connected`, `profileId`, `accountId`, `username` and, on API-key
@@ -13372,7 +13381,7 @@ export type GetShopifyConnectUrlData = {
13372
13381
  */
13373
13382
  profileId: string;
13374
13383
  /**
13375
- * Your custom redirect URL after connection completes. Accepts an http(s) URL, a custom app scheme for mobile deeplinks (e.g. myapp://callback), or a relative path. On failure an `error` query param is appended.
13384
+ * Your custom redirect URL after connection completes. MUST be an absolute http(s) URL or a custom app scheme for mobile deeplinks (e.g. myapp://callback); a relative path is rejected with 400 INVALID_REDIRECT_URL. On failure an `error` query param is appended.
13376
13385
  */
13377
13386
  redirect_url?: string;
13378
13387
  /**
@@ -30833,6 +30842,27 @@ export type UpdateAdSetData = {
30833
30842
  * Ad set end_time (ISO 8601).
30834
30843
  */
30835
30844
  endDate?: string;
30845
+ /**
30846
+ * Meta `daily_min_spend_target`: the least this ad set should spend per day, in whole
30847
+ * currency units of the ad account. It reserves a share of a CAMPAIGN budget for one ad
30848
+ * set, so it requires a campaign using Advantage campaign budget (CBO). On an ad set
30849
+ * that owns its budget (ABO) this returns 409 — move the budget to the campaign with
30850
+ * `PUT /v1/ads/campaigns/{campaignId}` first. Meta treats it as a target, not a
30851
+ * guarantee, and rejects the combined minimum of a campaign's ad sets going over the
30852
+ * campaign budget.
30853
+ * Mutually exclusive with `lifetimeMinSpendTarget` (400): the flavour must match the
30854
+ * campaign budget type, a daily budget takes a daily target.
30855
+ * Read it back with `GET /v1/ads/ad-sets/{adSetId}?fields=daily_min_spend_target`.
30856
+ *
30857
+ */
30858
+ dailyMinSpendTarget?: number;
30859
+ /**
30860
+ * Meta `lifetime_min_spend_target`: the lifetime-budget flavour of
30861
+ * `dailyMinSpendTarget`, in whole currency units. Send this one when the campaign
30862
+ * budget is a lifetime budget. Same rules and same rejections.
30863
+ *
30864
+ */
30865
+ lifetimeMinSpendTarget?: number;
30836
30866
  /**
30837
30867
  * Meta ad-set promoted_object, forwarded verbatim (same shape as /v1/ads/create). Unknown keys are rejected with 400.
30838
30868
  */
@@ -34192,6 +34222,9 @@ export type CreateStandaloneAdData = {
34192
34222
  * Sending the bid fields in BOTH places returns a 400
34193
34223
  * (`mutually_exclusive_fields`), and sending any of them in
34194
34224
  * `adSetId` attach mode is a 400 too (the ad set already has its bid).
34225
+ * `dailyMinSpendTarget` / `lifetimeMinSpendTarget` set the new ad set's
34226
+ * minimum spend and live here only; they are rejected in `adSetId` attach
34227
+ * mode as well.
34195
34228
  *
34196
34229
  */
34197
34230
  platformSpecificData?: (LinkedInAdsPlatformData | MetaAdsPlatformData);