@getlatedev/node 0.2.1087 → 0.2.1088

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
@@ -38775,6 +38775,10 @@ type ListAdCampaignsData = {
38775
38775
  * Platform ad account ID (e.g. act_123 for Meta)
38776
38776
  */
38777
38777
  adAccountId?: string;
38778
+ /**
38779
+ * Platform campaign ID (the `platformCampaignId` on each returned campaign). Returns only that campaign, or an empty list when it is not visible to the caller. Mirrors the same filter on /v1/ads and /v1/ads/tree.
38780
+ */
38781
+ campaignId?: string;
38778
38782
  /**
38779
38783
  * Start of metrics date range (YYYY-MM-DD, inclusive). Defaults to 90 days ago when both date params are omitted.
38780
38784
  */
@@ -39347,8 +39351,17 @@ type DuplicateAdCampaignData = {
39347
39351
  * Reschedule the copied hierarchy's end, read like `startTime`; a date-only end runs to 23:59:59 local. Defaults to the source's end.
39348
39352
  */
39349
39353
  endTime?: string;
39354
+ /**
39355
+ * Meta's native `rename_strategy` values. `DEEP_RENAME` renames the copied campaign and every copied child (ad sets, ads) with `renamePrefix` / `renameSuffix`. `ONLY_TOP_LEVEL_RENAME` renames only the copied campaign; children keep their source names. `NO_RENAME` keeps every source name. With no rename option at all, Meta appends its own ` - Copy` suffix; LinkedIn defaults to `DEEP_RENAME` (its campaign group and campaigns are renamed). Ignored on TikTok, where `renamePrefix` / `renameSuffix` apply to every copied object.
39356
+ */
39350
39357
  renameStrategy?: 'DEEP_RENAME' | 'ONLY_TOP_LEVEL_RENAME' | 'NO_RENAME';
39358
+ /**
39359
+ * Text prepended to each renamed object's name.
39360
+ */
39351
39361
  renamePrefix?: string;
39362
+ /**
39363
+ * Text appended to each renamed object's name. On LinkedIn an omitted suffix defaults to ` (Copy)`.
39364
+ */
39352
39365
  renameSuffix?: string;
39353
39366
  /**
39354
39367
  * Trigger ads discovery on the owning account after the copy succeeds
@@ -39724,7 +39737,7 @@ type CreateAdSetResponse = ({
39724
39737
  type CreateAdSetError = (ErrorResponse | unknown);
39725
39738
  type DuplicateAdSetData = {
39726
39739
  body: {
39727
- platform: 'facebook' | 'instagram';
39740
+ platform: 'facebook' | 'instagram' | 'tiktok';
39728
39741
  /**
39729
39742
  * Destination platform campaign id (defaults to the source's campaign)
39730
39743
  */
@@ -39742,8 +39755,17 @@ type DuplicateAdSetData = {
39742
39755
  * Reschedule the copy's end, read like `startTime`; a date-only end runs to 23:59:59 local.
39743
39756
  */
39744
39757
  endTime?: string;
39758
+ /**
39759
+ * Meta's native `rename_strategy` values. `DEEP_RENAME` renames the copied ad set and its copied ads with `renamePrefix` / `renameSuffix`. `ONLY_TOP_LEVEL_RENAME` renames only the copied ad set; its ads keep their source names. `NO_RENAME` keeps every source name. With no rename option at all, Meta appends its own ` - Copy` suffix. Ignored on TikTok, where `renamePrefix` / `renameSuffix` still apply.
39760
+ */
39745
39761
  renameStrategy?: 'DEEP_RENAME' | 'ONLY_TOP_LEVEL_RENAME' | 'NO_RENAME';
39762
+ /**
39763
+ * Text prepended to each renamed object's name.
39764
+ */
39746
39765
  renamePrefix?: string;
39766
+ /**
39767
+ * Text appended to each renamed object's name.
39768
+ */
39747
39769
  renameSuffix?: string;
39748
39770
  syncAfter?: boolean;
39749
39771
  };
@@ -39781,8 +39803,17 @@ type DuplicateAdData = {
39781
39803
  */
39782
39804
  adSetId?: string;
39783
39805
  statusOption?: 'ACTIVE' | 'PAUSED' | 'INHERITED_FROM_SOURCE';
39806
+ /**
39807
+ * Meta's native `rename_strategy` values. An ad has no copied children, so `DEEP_RENAME` and `ONLY_TOP_LEVEL_RENAME` both rename the copy with `renamePrefix` / `renameSuffix`, and `NO_RENAME` keeps the source name. With no rename option at all, Meta appends its own ` - Copy` suffix.
39808
+ */
39784
39809
  renameStrategy?: 'DEEP_RENAME' | 'ONLY_TOP_LEVEL_RENAME' | 'NO_RENAME';
39810
+ /**
39811
+ * Text prepended to the copy's name.
39812
+ */
39785
39813
  renamePrefix?: string;
39814
+ /**
39815
+ * Text appended to the copy's name.
39816
+ */
39786
39817
  renameSuffix?: string;
39787
39818
  syncAfter?: boolean;
39788
39819
  /**
package/dist/index.d.ts CHANGED
@@ -38775,6 +38775,10 @@ type ListAdCampaignsData = {
38775
38775
  * Platform ad account ID (e.g. act_123 for Meta)
38776
38776
  */
38777
38777
  adAccountId?: string;
38778
+ /**
38779
+ * Platform campaign ID (the `platformCampaignId` on each returned campaign). Returns only that campaign, or an empty list when it is not visible to the caller. Mirrors the same filter on /v1/ads and /v1/ads/tree.
38780
+ */
38781
+ campaignId?: string;
38778
38782
  /**
38779
38783
  * Start of metrics date range (YYYY-MM-DD, inclusive). Defaults to 90 days ago when both date params are omitted.
38780
38784
  */
@@ -39347,8 +39351,17 @@ type DuplicateAdCampaignData = {
39347
39351
  * Reschedule the copied hierarchy's end, read like `startTime`; a date-only end runs to 23:59:59 local. Defaults to the source's end.
39348
39352
  */
39349
39353
  endTime?: string;
39354
+ /**
39355
+ * Meta's native `rename_strategy` values. `DEEP_RENAME` renames the copied campaign and every copied child (ad sets, ads) with `renamePrefix` / `renameSuffix`. `ONLY_TOP_LEVEL_RENAME` renames only the copied campaign; children keep their source names. `NO_RENAME` keeps every source name. With no rename option at all, Meta appends its own ` - Copy` suffix; LinkedIn defaults to `DEEP_RENAME` (its campaign group and campaigns are renamed). Ignored on TikTok, where `renamePrefix` / `renameSuffix` apply to every copied object.
39356
+ */
39350
39357
  renameStrategy?: 'DEEP_RENAME' | 'ONLY_TOP_LEVEL_RENAME' | 'NO_RENAME';
39358
+ /**
39359
+ * Text prepended to each renamed object's name.
39360
+ */
39351
39361
  renamePrefix?: string;
39362
+ /**
39363
+ * Text appended to each renamed object's name. On LinkedIn an omitted suffix defaults to ` (Copy)`.
39364
+ */
39352
39365
  renameSuffix?: string;
39353
39366
  /**
39354
39367
  * Trigger ads discovery on the owning account after the copy succeeds
@@ -39724,7 +39737,7 @@ type CreateAdSetResponse = ({
39724
39737
  type CreateAdSetError = (ErrorResponse | unknown);
39725
39738
  type DuplicateAdSetData = {
39726
39739
  body: {
39727
- platform: 'facebook' | 'instagram';
39740
+ platform: 'facebook' | 'instagram' | 'tiktok';
39728
39741
  /**
39729
39742
  * Destination platform campaign id (defaults to the source's campaign)
39730
39743
  */
@@ -39742,8 +39755,17 @@ type DuplicateAdSetData = {
39742
39755
  * Reschedule the copy's end, read like `startTime`; a date-only end runs to 23:59:59 local.
39743
39756
  */
39744
39757
  endTime?: string;
39758
+ /**
39759
+ * Meta's native `rename_strategy` values. `DEEP_RENAME` renames the copied ad set and its copied ads with `renamePrefix` / `renameSuffix`. `ONLY_TOP_LEVEL_RENAME` renames only the copied ad set; its ads keep their source names. `NO_RENAME` keeps every source name. With no rename option at all, Meta appends its own ` - Copy` suffix. Ignored on TikTok, where `renamePrefix` / `renameSuffix` still apply.
39760
+ */
39745
39761
  renameStrategy?: 'DEEP_RENAME' | 'ONLY_TOP_LEVEL_RENAME' | 'NO_RENAME';
39762
+ /**
39763
+ * Text prepended to each renamed object's name.
39764
+ */
39746
39765
  renamePrefix?: string;
39766
+ /**
39767
+ * Text appended to each renamed object's name.
39768
+ */
39747
39769
  renameSuffix?: string;
39748
39770
  syncAfter?: boolean;
39749
39771
  };
@@ -39781,8 +39803,17 @@ type DuplicateAdData = {
39781
39803
  */
39782
39804
  adSetId?: string;
39783
39805
  statusOption?: 'ACTIVE' | 'PAUSED' | 'INHERITED_FROM_SOURCE';
39806
+ /**
39807
+ * Meta's native `rename_strategy` values. An ad has no copied children, so `DEEP_RENAME` and `ONLY_TOP_LEVEL_RENAME` both rename the copy with `renamePrefix` / `renameSuffix`, and `NO_RENAME` keeps the source name. With no rename option at all, Meta appends its own ` - Copy` suffix.
39808
+ */
39784
39809
  renameStrategy?: 'DEEP_RENAME' | 'ONLY_TOP_LEVEL_RENAME' | 'NO_RENAME';
39810
+ /**
39811
+ * Text prepended to the copy's name.
39812
+ */
39785
39813
  renamePrefix?: string;
39814
+ /**
39815
+ * Text appended to the copy's name.
39816
+ */
39786
39817
  renameSuffix?: string;
39787
39818
  syncAfter?: boolean;
39788
39819
  /**
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: "@getlatedev/node",
39
- version: "0.2.1087",
39
+ version: "0.2.1088",
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: "@getlatedev/node",
8
- version: "0.2.1087",
8
+ version: "0.2.1088",
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": "@getlatedev/node",
3
- "version": "0.2.1087",
3
+ "version": "0.2.1088",
4
4
  "description": "The official Node.js library for the Zernio API",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -9453,7 +9453,9 @@ export const createAdCampaign = <ThrowOnError extends boolean = false>(options:
9453
9453
  * `skipped: 1`, with the reason). Otherwise the switch is written (`updated: 1`), read back and
9454
9454
  * stored, and the delivery status of the ads under it (up to 20) is re-read and stored, so an
9455
9455
  * immediate GET returns what the platform now reports. A stored switch never skips a write, and
9456
- * when the platform cannot be read the write always goes out.
9456
+ * when the platform cannot be read the write always goes out. On Meta the check reads the
9457
+ * campaign's own `status`, so a delivery status such as `IN_PROCESS` or `WITH_ISSUES` does not
9458
+ * force a write.
9457
9459
  *
9458
9460
  */
9459
9461
  export const updateAdCampaignStatus = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UpdateAdCampaignStatusData, ThrowOnError>) => {
@@ -10005,7 +10007,9 @@ export const deleteAdSet = <ThrowOnError extends boolean = false>(options: Optio
10005
10007
  * the delivery status of its ads (up to 20) is re-read and stored, so an
10006
10008
  * immediate GET returns what the platform now reports. A stored switch
10007
10009
  * never skips a write, and when the platform cannot be read the write
10008
- * always goes out.
10010
+ * always goes out. On Meta the check reads the ad set's own `status`, so
10011
+ * a repeated request skips even while `platformAdSetStatus` reads
10012
+ * `CAMPAIGN_PAUSED`, `WITH_ISSUES` or `IN_PROCESS`.
10009
10013
  *
10010
10014
  */
10011
10015
  export const updateAdSetStatus = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UpdateAdSetStatusData, ThrowOnError>) => {
@@ -39127,6 +39127,10 @@ export type ListAdCampaignsData = {
39127
39127
  * Platform ad account ID (e.g. act_123 for Meta)
39128
39128
  */
39129
39129
  adAccountId?: string;
39130
+ /**
39131
+ * Platform campaign ID (the `platformCampaignId` on each returned campaign). Returns only that campaign, or an empty list when it is not visible to the caller. Mirrors the same filter on /v1/ads and /v1/ads/tree.
39132
+ */
39133
+ campaignId?: string;
39130
39134
  /**
39131
39135
  * Start of metrics date range (YYYY-MM-DD, inclusive). Defaults to 90 days ago when both date params are omitted.
39132
39136
  */
@@ -39735,8 +39739,17 @@ export type DuplicateAdCampaignData = {
39735
39739
  * Reschedule the copied hierarchy's end, read like `startTime`; a date-only end runs to 23:59:59 local. Defaults to the source's end.
39736
39740
  */
39737
39741
  endTime?: string;
39742
+ /**
39743
+ * Meta's native `rename_strategy` values. `DEEP_RENAME` renames the copied campaign and every copied child (ad sets, ads) with `renamePrefix` / `renameSuffix`. `ONLY_TOP_LEVEL_RENAME` renames only the copied campaign; children keep their source names. `NO_RENAME` keeps every source name. With no rename option at all, Meta appends its own ` - Copy` suffix; LinkedIn defaults to `DEEP_RENAME` (its campaign group and campaigns are renamed). Ignored on TikTok, where `renamePrefix` / `renameSuffix` apply to every copied object.
39744
+ */
39738
39745
  renameStrategy?: 'DEEP_RENAME' | 'ONLY_TOP_LEVEL_RENAME' | 'NO_RENAME';
39746
+ /**
39747
+ * Text prepended to each renamed object's name.
39748
+ */
39739
39749
  renamePrefix?: string;
39750
+ /**
39751
+ * Text appended to each renamed object's name. On LinkedIn an omitted suffix defaults to ` (Copy)`.
39752
+ */
39740
39753
  renameSuffix?: string;
39741
39754
  /**
39742
39755
  * Trigger ads discovery on the owning account after the copy succeeds
@@ -40127,7 +40140,7 @@ export type CreateAdSetError = (ErrorResponse | unknown);
40127
40140
 
40128
40141
  export type DuplicateAdSetData = {
40129
40142
  body: {
40130
- platform: 'facebook' | 'instagram';
40143
+ platform: 'facebook' | 'instagram' | 'tiktok';
40131
40144
  /**
40132
40145
  * Destination platform campaign id (defaults to the source's campaign)
40133
40146
  */
@@ -40145,8 +40158,17 @@ export type DuplicateAdSetData = {
40145
40158
  * Reschedule the copy's end, read like `startTime`; a date-only end runs to 23:59:59 local.
40146
40159
  */
40147
40160
  endTime?: string;
40161
+ /**
40162
+ * Meta's native `rename_strategy` values. `DEEP_RENAME` renames the copied ad set and its copied ads with `renamePrefix` / `renameSuffix`. `ONLY_TOP_LEVEL_RENAME` renames only the copied ad set; its ads keep their source names. `NO_RENAME` keeps every source name. With no rename option at all, Meta appends its own ` - Copy` suffix. Ignored on TikTok, where `renamePrefix` / `renameSuffix` still apply.
40163
+ */
40148
40164
  renameStrategy?: 'DEEP_RENAME' | 'ONLY_TOP_LEVEL_RENAME' | 'NO_RENAME';
40165
+ /**
40166
+ * Text prepended to each renamed object's name.
40167
+ */
40149
40168
  renamePrefix?: string;
40169
+ /**
40170
+ * Text appended to each renamed object's name.
40171
+ */
40150
40172
  renameSuffix?: string;
40151
40173
  syncAfter?: boolean;
40152
40174
  };
@@ -40187,8 +40209,17 @@ export type DuplicateAdData = {
40187
40209
  */
40188
40210
  adSetId?: string;
40189
40211
  statusOption?: 'ACTIVE' | 'PAUSED' | 'INHERITED_FROM_SOURCE';
40212
+ /**
40213
+ * Meta's native `rename_strategy` values. An ad has no copied children, so `DEEP_RENAME` and `ONLY_TOP_LEVEL_RENAME` both rename the copy with `renamePrefix` / `renameSuffix`, and `NO_RENAME` keeps the source name. With no rename option at all, Meta appends its own ` - Copy` suffix.
40214
+ */
40190
40215
  renameStrategy?: 'DEEP_RENAME' | 'ONLY_TOP_LEVEL_RENAME' | 'NO_RENAME';
40216
+ /**
40217
+ * Text prepended to the copy's name.
40218
+ */
40191
40219
  renamePrefix?: string;
40220
+ /**
40221
+ * Text appended to the copy's name.
40222
+ */
40192
40223
  renameSuffix?: string;
40193
40224
  syncAfter?: boolean;
40194
40225
  /**