@getlatedev/node 0.2.369 → 0.2.370

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
@@ -10055,6 +10055,16 @@ type ConnectAdsData = {
10055
10055
  *
10056
10056
  */
10057
10057
  adAccountIds?: Array<(string)>;
10058
+ /**
10059
+ * Force a fresh OAuth even when an account already exists. Normally the
10060
+ * endpoint returns `alreadyConnected: true` whenever a connected account
10061
+ * is found, keying off its active state rather than token liveness.
10062
+ * Set `force=true` to bypass that and always receivean `authUrl`.
10063
+ * Completing the returned OAuth refreshes the stored token
10064
+ * on the existing posting and ads accounts in place.
10065
+ *
10066
+ */
10067
+ force?: boolean;
10058
10068
  /**
10059
10069
  * Enable headless mode (same-token platforms only)
10060
10070
  */
@@ -23367,13 +23377,76 @@ type BoostPostData = {
23367
23377
  */
23368
23378
  endDate?: string;
23369
23379
  };
23380
+ /**
23381
+ * Same geo/demographic fields as the `TargetingSpec` used by /v1/ads/create.
23382
+ * Geo keys (`regions`/`cities`/`zips`/`metros`) resolve via
23383
+ * GET /v1/ads/targeting/search?dimension=geo. City radius and lat/lng
23384
+ * `customLocations` are Meta-only and preserve the boosted post's
23385
+ * social proof (the ad references the existing post).
23386
+ *
23387
+ */
23370
23388
  targeting?: {
23371
23389
  ageMin?: number;
23372
23390
  ageMax?: number;
23391
+ /**
23392
+ * Meta only.
23393
+ */
23394
+ gender?: 'all' | 'male' | 'female';
23395
+ /**
23396
+ * Meta locale ids (numeric), passed through as given.
23397
+ */
23398
+ languages?: Array<(string)>;
23373
23399
  /**
23374
23400
  * ISO country codes. Required for TikTok boosts (TikTok's ad group requires location_ids); optional on other platforms.
23375
23401
  */
23376
23402
  countries?: Array<(string)>;
23403
+ /**
23404
+ * Region/state targeting. `key` from /v1/ads/targeting/search?dimension=geo&geoType=region.
23405
+ */
23406
+ regions?: Array<{
23407
+ key: string;
23408
+ name?: string;
23409
+ }>;
23410
+ /**
23411
+ * City targeting. Optional `radius` + `distance_unit` extend beyond the city limits (both set together, Meta only).
23412
+ */
23413
+ cities?: Array<{
23414
+ key: string;
23415
+ name?: string;
23416
+ /**
23417
+ * Requires distance_unit.
23418
+ */
23419
+ radius?: number;
23420
+ distance_unit?: 'mile' | 'kilometer';
23421
+ }>;
23422
+ /**
23423
+ * Postal/ZIP targeting. `key` is the platform's postal location ID (e.g. Meta `US:94304`).
23424
+ */
23425
+ zips?: Array<{
23426
+ key: string;
23427
+ name?: string;
23428
+ }>;
23429
+ /**
23430
+ * DMA / metro-area targeting. `key` is the platform's metro ID (e.g. Meta `DMA:807`).
23431
+ */
23432
+ metros?: Array<{
23433
+ key: string;
23434
+ name?: string;
23435
+ }>;
23436
+ /**
23437
+ * Point-radius (lat/lng) targeting (Meta custom_locations). No geo `key` lookup needed.
23438
+ */
23439
+ customLocations?: Array<{
23440
+ latitude: number;
23441
+ longitude: number;
23442
+ radius: number;
23443
+ distanceUnit: 'mile' | 'kilometer';
23444
+ name?: string;
23445
+ /**
23446
+ * Optional label, sent to Meta as `address_string`.
23447
+ */
23448
+ address?: string;
23449
+ }>;
23377
23450
  /**
23378
23451
  * Interest objects from /v1/ads/interests. Each must include id and name.
23379
23452
  */
@@ -23386,6 +23459,17 @@ type BoostPostData = {
23386
23459
  */
23387
23460
  advantage_audience?: 0 | 1;
23388
23461
  };
23462
+ /**
23463
+ * Meta only. A verbatim Meta-native targeting spec (e.g.
23464
+ * `{ "geo_locations": { "cities": [{ "key": "...", "radius": 15, "distance_unit": "kilometer" }] } }`),
23465
+ * forwarded unchanged. Mutually exclusive with `targeting` (sending both is a 400).
23466
+ * Use for advanced fields the structured object does not expose (flexible_spec,
23467
+ * excluded audiences, business places).
23468
+ *
23469
+ */
23470
+ rawTargeting?: {
23471
+ [key: string]: unknown;
23472
+ };
23389
23473
  /**
23390
23474
  * Meta bid strategy applied to the ad set. On TikTok, mapped to
23391
23475
  * `bid_type` / `bid_price` / `deep_bid_type` automatically.
package/dist/index.d.ts CHANGED
@@ -10055,6 +10055,16 @@ type ConnectAdsData = {
10055
10055
  *
10056
10056
  */
10057
10057
  adAccountIds?: Array<(string)>;
10058
+ /**
10059
+ * Force a fresh OAuth even when an account already exists. Normally the
10060
+ * endpoint returns `alreadyConnected: true` whenever a connected account
10061
+ * is found, keying off its active state rather than token liveness.
10062
+ * Set `force=true` to bypass that and always receivean `authUrl`.
10063
+ * Completing the returned OAuth refreshes the stored token
10064
+ * on the existing posting and ads accounts in place.
10065
+ *
10066
+ */
10067
+ force?: boolean;
10058
10068
  /**
10059
10069
  * Enable headless mode (same-token platforms only)
10060
10070
  */
@@ -23367,13 +23377,76 @@ type BoostPostData = {
23367
23377
  */
23368
23378
  endDate?: string;
23369
23379
  };
23380
+ /**
23381
+ * Same geo/demographic fields as the `TargetingSpec` used by /v1/ads/create.
23382
+ * Geo keys (`regions`/`cities`/`zips`/`metros`) resolve via
23383
+ * GET /v1/ads/targeting/search?dimension=geo. City radius and lat/lng
23384
+ * `customLocations` are Meta-only and preserve the boosted post's
23385
+ * social proof (the ad references the existing post).
23386
+ *
23387
+ */
23370
23388
  targeting?: {
23371
23389
  ageMin?: number;
23372
23390
  ageMax?: number;
23391
+ /**
23392
+ * Meta only.
23393
+ */
23394
+ gender?: 'all' | 'male' | 'female';
23395
+ /**
23396
+ * Meta locale ids (numeric), passed through as given.
23397
+ */
23398
+ languages?: Array<(string)>;
23373
23399
  /**
23374
23400
  * ISO country codes. Required for TikTok boosts (TikTok's ad group requires location_ids); optional on other platforms.
23375
23401
  */
23376
23402
  countries?: Array<(string)>;
23403
+ /**
23404
+ * Region/state targeting. `key` from /v1/ads/targeting/search?dimension=geo&geoType=region.
23405
+ */
23406
+ regions?: Array<{
23407
+ key: string;
23408
+ name?: string;
23409
+ }>;
23410
+ /**
23411
+ * City targeting. Optional `radius` + `distance_unit` extend beyond the city limits (both set together, Meta only).
23412
+ */
23413
+ cities?: Array<{
23414
+ key: string;
23415
+ name?: string;
23416
+ /**
23417
+ * Requires distance_unit.
23418
+ */
23419
+ radius?: number;
23420
+ distance_unit?: 'mile' | 'kilometer';
23421
+ }>;
23422
+ /**
23423
+ * Postal/ZIP targeting. `key` is the platform's postal location ID (e.g. Meta `US:94304`).
23424
+ */
23425
+ zips?: Array<{
23426
+ key: string;
23427
+ name?: string;
23428
+ }>;
23429
+ /**
23430
+ * DMA / metro-area targeting. `key` is the platform's metro ID (e.g. Meta `DMA:807`).
23431
+ */
23432
+ metros?: Array<{
23433
+ key: string;
23434
+ name?: string;
23435
+ }>;
23436
+ /**
23437
+ * Point-radius (lat/lng) targeting (Meta custom_locations). No geo `key` lookup needed.
23438
+ */
23439
+ customLocations?: Array<{
23440
+ latitude: number;
23441
+ longitude: number;
23442
+ radius: number;
23443
+ distanceUnit: 'mile' | 'kilometer';
23444
+ name?: string;
23445
+ /**
23446
+ * Optional label, sent to Meta as `address_string`.
23447
+ */
23448
+ address?: string;
23449
+ }>;
23377
23450
  /**
23378
23451
  * Interest objects from /v1/ads/interests. Each must include id and name.
23379
23452
  */
@@ -23386,6 +23459,17 @@ type BoostPostData = {
23386
23459
  */
23387
23460
  advantage_audience?: 0 | 1;
23388
23461
  };
23462
+ /**
23463
+ * Meta only. A verbatim Meta-native targeting spec (e.g.
23464
+ * `{ "geo_locations": { "cities": [{ "key": "...", "radius": 15, "distance_unit": "kilometer" }] } }`),
23465
+ * forwarded unchanged. Mutually exclusive with `targeting` (sending both is a 400).
23466
+ * Use for advanced fields the structured object does not expose (flexible_spec,
23467
+ * excluded audiences, business places).
23468
+ *
23469
+ */
23470
+ rawTargeting?: {
23471
+ [key: string]: unknown;
23472
+ };
23389
23473
  /**
23390
23474
  * Meta bid strategy applied to the ad set. On TikTok, mapped to
23391
23475
  * `bid_type` / `bid_price` / `deep_bid_type` automatically.
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.369",
39
+ version: "0.2.370",
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.369",
8
+ version: "0.2.370",
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.369",
3
+ "version": "0.2.370",
4
4
  "description": "The official Node.js library for the Zernio API",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -9658,6 +9658,16 @@ export type ConnectAdsData = {
9658
9658
  *
9659
9659
  */
9660
9660
  adAccountIds?: Array<(string)>;
9661
+ /**
9662
+ * Force a fresh OAuth even when an account already exists. Normally the
9663
+ * endpoint returns `alreadyConnected: true` whenever a connected account
9664
+ * is found, keying off its active state rather than token liveness.
9665
+ * Set `force=true` to bypass that and always receivean `authUrl`.
9666
+ * Completing the returned OAuth refreshes the stored token
9667
+ * on the existing posting and ads accounts in place.
9668
+ *
9669
+ */
9670
+ force?: boolean;
9661
9671
  /**
9662
9672
  * Enable headless mode (same-token platforms only)
9663
9673
  */
@@ -24026,13 +24036,76 @@ export type BoostPostData = {
24026
24036
  */
24027
24037
  endDate?: string;
24028
24038
  };
24039
+ /**
24040
+ * Same geo/demographic fields as the `TargetingSpec` used by /v1/ads/create.
24041
+ * Geo keys (`regions`/`cities`/`zips`/`metros`) resolve via
24042
+ * GET /v1/ads/targeting/search?dimension=geo. City radius and lat/lng
24043
+ * `customLocations` are Meta-only and preserve the boosted post's
24044
+ * social proof (the ad references the existing post).
24045
+ *
24046
+ */
24029
24047
  targeting?: {
24030
24048
  ageMin?: number;
24031
24049
  ageMax?: number;
24050
+ /**
24051
+ * Meta only.
24052
+ */
24053
+ gender?: 'all' | 'male' | 'female';
24054
+ /**
24055
+ * Meta locale ids (numeric), passed through as given.
24056
+ */
24057
+ languages?: Array<(string)>;
24032
24058
  /**
24033
24059
  * ISO country codes. Required for TikTok boosts (TikTok's ad group requires location_ids); optional on other platforms.
24034
24060
  */
24035
24061
  countries?: Array<(string)>;
24062
+ /**
24063
+ * Region/state targeting. `key` from /v1/ads/targeting/search?dimension=geo&geoType=region.
24064
+ */
24065
+ regions?: Array<{
24066
+ key: string;
24067
+ name?: string;
24068
+ }>;
24069
+ /**
24070
+ * City targeting. Optional `radius` + `distance_unit` extend beyond the city limits (both set together, Meta only).
24071
+ */
24072
+ cities?: Array<{
24073
+ key: string;
24074
+ name?: string;
24075
+ /**
24076
+ * Requires distance_unit.
24077
+ */
24078
+ radius?: number;
24079
+ distance_unit?: 'mile' | 'kilometer';
24080
+ }>;
24081
+ /**
24082
+ * Postal/ZIP targeting. `key` is the platform's postal location ID (e.g. Meta `US:94304`).
24083
+ */
24084
+ zips?: Array<{
24085
+ key: string;
24086
+ name?: string;
24087
+ }>;
24088
+ /**
24089
+ * DMA / metro-area targeting. `key` is the platform's metro ID (e.g. Meta `DMA:807`).
24090
+ */
24091
+ metros?: Array<{
24092
+ key: string;
24093
+ name?: string;
24094
+ }>;
24095
+ /**
24096
+ * Point-radius (lat/lng) targeting (Meta custom_locations). No geo `key` lookup needed.
24097
+ */
24098
+ customLocations?: Array<{
24099
+ latitude: number;
24100
+ longitude: number;
24101
+ radius: number;
24102
+ distanceUnit: 'mile' | 'kilometer';
24103
+ name?: string;
24104
+ /**
24105
+ * Optional label, sent to Meta as `address_string`.
24106
+ */
24107
+ address?: string;
24108
+ }>;
24036
24109
  /**
24037
24110
  * Interest objects from /v1/ads/interests. Each must include id and name.
24038
24111
  */
@@ -24045,6 +24118,17 @@ export type BoostPostData = {
24045
24118
  */
24046
24119
  advantage_audience?: 0 | 1;
24047
24120
  };
24121
+ /**
24122
+ * Meta only. A verbatim Meta-native targeting spec (e.g.
24123
+ * `{ "geo_locations": { "cities": [{ "key": "...", "radius": 15, "distance_unit": "kilometer" }] } }`),
24124
+ * forwarded unchanged. Mutually exclusive with `targeting` (sending both is a 400).
24125
+ * Use for advanced fields the structured object does not expose (flexible_spec,
24126
+ * excluded audiences, business places).
24127
+ *
24128
+ */
24129
+ rawTargeting?: {
24130
+ [key: string]: unknown;
24131
+ };
24048
24132
  /**
24049
24133
  * Meta bid strategy applied to the ad set. On TikTok, mapped to
24050
24134
  * `bid_type` / `bid_price` / `deep_bid_type` automatically.