@zernio/node 0.2.184 → 0.2.185

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
@@ -17374,9 +17374,65 @@ type CreateCtwaAdData = {
17374
17374
  */
17375
17375
  endDate?: string;
17376
17376
  /**
17377
- * ISO 3166-1 alpha-2 country codes. Defaults to `["US"]`.
17377
+ * ISO 3166-1 alpha-2 country codes. Defaults to `["US"]` only
17378
+ * when no other geo (`cities`, `regions`, `zips`, `metros`,
17379
+ * `customLocations`) is supplied.
17380
+ *
17378
17381
  */
17379
17382
  countries?: Array<(string)>;
17383
+ /**
17384
+ * City-level geo targeting for local CTWA campaigns (e.g.
17385
+ * 25km radius around Milan). Each entry maps to Meta's
17386
+ * TargetingGeoLocationCity. `key` is Meta's city ID
17387
+ * (lookupable via GET /v1/ads/targeting/search). `radius`
17388
+ * and `distance_unit` are coupled: set both or neither.
17389
+ *
17390
+ */
17391
+ cities?: Array<{
17392
+ key: string;
17393
+ radius?: number;
17394
+ distance_unit?: 'mile' | 'kilometer';
17395
+ }>;
17396
+ /**
17397
+ * Region / state-level geo targeting. `key` is Meta's region
17398
+ * ID (lookupable via GET /v1/ads/targeting/search?type=region).
17399
+ *
17400
+ */
17401
+ regions?: Array<{
17402
+ key: string;
17403
+ }>;
17404
+ /**
17405
+ * ZIP / postal-code geo targeting. `key` is the platform's
17406
+ * postal id resolved via /v1/ads/targeting/search.
17407
+ *
17408
+ */
17409
+ zips?: Array<{
17410
+ key: string;
17411
+ name?: string;
17412
+ }>;
17413
+ /**
17414
+ * DMA / metro-area geo targeting. `key` is Meta's metro id
17415
+ * (e.g. `DMA:807`).
17416
+ *
17417
+ */
17418
+ metros?: Array<{
17419
+ key: string;
17420
+ name?: string;
17421
+ }>;
17422
+ /**
17423
+ * Point-radius geo (Meta `geo_locations.custom_locations`).
17424
+ * Use for targeting a radius around a specific lat/long when
17425
+ * no Meta city/region key fits. `distanceUnit` is required.
17426
+ *
17427
+ */
17428
+ customLocations?: Array<{
17429
+ latitude: number;
17430
+ longitude: number;
17431
+ radius: number;
17432
+ distanceUnit: 'mile' | 'kilometer';
17433
+ name?: string;
17434
+ address?: string;
17435
+ }>;
17380
17436
  ageMin?: number;
17381
17437
  ageMax?: number;
17382
17438
  interests?: Array<{
package/dist/index.d.ts CHANGED
@@ -17374,9 +17374,65 @@ type CreateCtwaAdData = {
17374
17374
  */
17375
17375
  endDate?: string;
17376
17376
  /**
17377
- * ISO 3166-1 alpha-2 country codes. Defaults to `["US"]`.
17377
+ * ISO 3166-1 alpha-2 country codes. Defaults to `["US"]` only
17378
+ * when no other geo (`cities`, `regions`, `zips`, `metros`,
17379
+ * `customLocations`) is supplied.
17380
+ *
17378
17381
  */
17379
17382
  countries?: Array<(string)>;
17383
+ /**
17384
+ * City-level geo targeting for local CTWA campaigns (e.g.
17385
+ * 25km radius around Milan). Each entry maps to Meta's
17386
+ * TargetingGeoLocationCity. `key` is Meta's city ID
17387
+ * (lookupable via GET /v1/ads/targeting/search). `radius`
17388
+ * and `distance_unit` are coupled: set both or neither.
17389
+ *
17390
+ */
17391
+ cities?: Array<{
17392
+ key: string;
17393
+ radius?: number;
17394
+ distance_unit?: 'mile' | 'kilometer';
17395
+ }>;
17396
+ /**
17397
+ * Region / state-level geo targeting. `key` is Meta's region
17398
+ * ID (lookupable via GET /v1/ads/targeting/search?type=region).
17399
+ *
17400
+ */
17401
+ regions?: Array<{
17402
+ key: string;
17403
+ }>;
17404
+ /**
17405
+ * ZIP / postal-code geo targeting. `key` is the platform's
17406
+ * postal id resolved via /v1/ads/targeting/search.
17407
+ *
17408
+ */
17409
+ zips?: Array<{
17410
+ key: string;
17411
+ name?: string;
17412
+ }>;
17413
+ /**
17414
+ * DMA / metro-area geo targeting. `key` is Meta's metro id
17415
+ * (e.g. `DMA:807`).
17416
+ *
17417
+ */
17418
+ metros?: Array<{
17419
+ key: string;
17420
+ name?: string;
17421
+ }>;
17422
+ /**
17423
+ * Point-radius geo (Meta `geo_locations.custom_locations`).
17424
+ * Use for targeting a radius around a specific lat/long when
17425
+ * no Meta city/region key fits. `distanceUnit` is required.
17426
+ *
17427
+ */
17428
+ customLocations?: Array<{
17429
+ latitude: number;
17430
+ longitude: number;
17431
+ radius: number;
17432
+ distanceUnit: 'mile' | 'kilometer';
17433
+ name?: string;
17434
+ address?: string;
17435
+ }>;
17380
17436
  ageMin?: number;
17381
17437
  ageMax?: number;
17382
17438
  interests?: Array<{
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.184",
39
+ version: "0.2.185",
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.184",
8
+ version: "0.2.185",
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.184",
3
+ "version": "0.2.185",
4
4
  "description": "The official Node.js library for the Zernio API",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -17828,9 +17828,65 @@ export type CreateCtwaAdData = {
17828
17828
  */
17829
17829
  endDate?: string;
17830
17830
  /**
17831
- * ISO 3166-1 alpha-2 country codes. Defaults to `["US"]`.
17831
+ * ISO 3166-1 alpha-2 country codes. Defaults to `["US"]` only
17832
+ * when no other geo (`cities`, `regions`, `zips`, `metros`,
17833
+ * `customLocations`) is supplied.
17834
+ *
17832
17835
  */
17833
17836
  countries?: Array<(string)>;
17837
+ /**
17838
+ * City-level geo targeting for local CTWA campaigns (e.g.
17839
+ * 25km radius around Milan). Each entry maps to Meta's
17840
+ * TargetingGeoLocationCity. `key` is Meta's city ID
17841
+ * (lookupable via GET /v1/ads/targeting/search). `radius`
17842
+ * and `distance_unit` are coupled: set both or neither.
17843
+ *
17844
+ */
17845
+ cities?: Array<{
17846
+ key: string;
17847
+ radius?: number;
17848
+ distance_unit?: 'mile' | 'kilometer';
17849
+ }>;
17850
+ /**
17851
+ * Region / state-level geo targeting. `key` is Meta's region
17852
+ * ID (lookupable via GET /v1/ads/targeting/search?type=region).
17853
+ *
17854
+ */
17855
+ regions?: Array<{
17856
+ key: string;
17857
+ }>;
17858
+ /**
17859
+ * ZIP / postal-code geo targeting. `key` is the platform's
17860
+ * postal id resolved via /v1/ads/targeting/search.
17861
+ *
17862
+ */
17863
+ zips?: Array<{
17864
+ key: string;
17865
+ name?: string;
17866
+ }>;
17867
+ /**
17868
+ * DMA / metro-area geo targeting. `key` is Meta's metro id
17869
+ * (e.g. `DMA:807`).
17870
+ *
17871
+ */
17872
+ metros?: Array<{
17873
+ key: string;
17874
+ name?: string;
17875
+ }>;
17876
+ /**
17877
+ * Point-radius geo (Meta `geo_locations.custom_locations`).
17878
+ * Use for targeting a radius around a specific lat/long when
17879
+ * no Meta city/region key fits. `distanceUnit` is required.
17880
+ *
17881
+ */
17882
+ customLocations?: Array<{
17883
+ latitude: number;
17884
+ longitude: number;
17885
+ radius: number;
17886
+ distanceUnit: 'mile' | 'kilometer';
17887
+ name?: string;
17888
+ address?: string;
17889
+ }>;
17834
17890
  ageMin?: number;
17835
17891
  ageMax?: number;
17836
17892
  interests?: Array<{