@zernio/node 0.2.207 → 0.2.209

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
@@ -992,6 +992,15 @@ type Ad = {
992
992
  pinterestTitle?: string;
993
993
  pinterestDescription?: string;
994
994
  } | null;
995
+ /**
996
+ * The ad set's targeting (age, gender, geo, interests, placements, audience inclusions/exclusions).
997
+ * For ads created through Zernio this is the spec you supplied. For external ads (synced from
998
+ * Meta Ads Manager, `isExternal: true`) targeting lives at the ad set and isn't stored at ingest,
999
+ * so on the first `GET /v1/ads/{adId}` Zernio resolves it live from Meta and caches it on the ad;
1000
+ * the value is then Meta's raw `targeting` shape (snake_case, e.g. `geo_locations`, `age_min`),
1001
+ * the same object Ads Manager shows. May be absent if the ad set exposes no targeting or the lookup fails.
1002
+ *
1003
+ */
995
1004
  targeting?: {
996
1005
  [key: string]: unknown;
997
1006
  };
@@ -8198,6 +8207,11 @@ type SelectFacebookPageError = (unknown | {
8198
8207
  });
8199
8208
  type ListGoogleBusinessLocationsData = {
8200
8209
  query?: {
8210
+ /**
8211
+ * Raw Google Business Information API filter expression (advanced; takes precedence over search). Supports fields such as title, storeCode, storefront_address.postal_code, labels and categories, e.g. storeCode="LH279411". See Google's "Work with location data" guide.
8212
+ *
8213
+ */
8214
+ filter?: string;
8201
8215
  /**
8202
8216
  * Token from the OAuth callback redirect. Preferred over tempToken because it preserves server-side token storage. One of pendingDataToken or tempToken is required.
8203
8217
  */
@@ -8206,6 +8220,11 @@ type ListGoogleBusinessLocationsData = {
8206
8220
  * Profile ID from your connection flow. Required for auth validation when provided.
8207
8221
  */
8208
8222
  profileId?: string;
8223
+ /**
8224
+ * Free-text search on the business name, applied server-side by Google. Use this for accounts that own many locations (the response is bounded, see hasMore) so the user can find a specific location without loading the full list.
8225
+ *
8226
+ */
8227
+ search?: string;
8209
8228
  /**
8210
8229
  * Legacy. Direct Google access token. Use pendingDataToken instead when available.
8211
8230
  */
@@ -8238,7 +8257,16 @@ type ListGoogleBusinessLocationsResponse = ({
8238
8257
  * Business category
8239
8258
  */
8240
8259
  category?: string;
8260
+ /**
8261
+ * Store code set on the location in Google Business Profile (if any)
8262
+ */
8263
+ storeCode?: string;
8241
8264
  }>;
8265
+ /**
8266
+ * True when more locations exist than were returned (the list is bounded). Prompt the user to narrow the result set with search.
8267
+ *
8268
+ */
8269
+ hasMore?: boolean;
8242
8270
  });
8243
8271
  type ListGoogleBusinessLocationsError = (unknown | {
8244
8272
  error?: string;
@@ -8253,6 +8281,11 @@ type SelectGoogleBusinessLocationData = {
8253
8281
  * The Google Business location ID selected by the user
8254
8282
  */
8255
8283
  locationId: string;
8284
+ /**
8285
+ * Optional but recommended. The Google Business Account resource name ("accounts/123") that owns the selected location (returned per-location by GET /v1/connect/googlebusiness/locations). When provided, the location is resolved directly instead of by enumerating the account, which is required for accounts that own many locations. Omit only for small accounts.
8286
+ *
8287
+ */
8288
+ accountId?: string;
8256
8289
  /**
8257
8290
  * Token from the OAuth callback redirect (pendingDataToken query param). Tokens and profile data are retrieved server-side from this token.
8258
8291
  */
@@ -10462,6 +10495,16 @@ type GetGmbLocationsData = {
10462
10495
  path: {
10463
10496
  accountId: string;
10464
10497
  };
10498
+ query?: {
10499
+ /**
10500
+ * Raw Google Business Information API filter expression (advanced; takes precedence over search), e.g. storeCode="LH279411".
10501
+ */
10502
+ filter?: string;
10503
+ /**
10504
+ * Free-text search on the business name, applied server-side by Google. Use for accounts with many locations.
10505
+ */
10506
+ search?: string;
10507
+ };
10465
10508
  };
10466
10509
  type GetGmbLocationsResponse = ({
10467
10510
  locations?: Array<{
@@ -10472,7 +10515,12 @@ type GetGmbLocationsResponse = ({
10472
10515
  address?: string;
10473
10516
  category?: string;
10474
10517
  websiteUrl?: string;
10518
+ storeCode?: string;
10475
10519
  }>;
10520
+ /**
10521
+ * True when more locations exist than were returned (use search to narrow down).
10522
+ */
10523
+ hasMore?: boolean;
10476
10524
  selectedLocationId?: string;
10477
10525
  cached?: boolean;
10478
10526
  });
@@ -10482,6 +10530,11 @@ type GetGmbLocationsError = ({
10482
10530
  type UpdateGmbLocationData = {
10483
10531
  body: {
10484
10532
  selectedLocationId: string;
10533
+ /**
10534
+ * Optional but recommended. The Google Business Account resource name ("accounts/123") that owns the new location (from GET gmb-locations). When provided, the location is resolved directly instead of by enumerating the account, which is required for accounts with many locations.
10535
+ *
10536
+ */
10537
+ accountId?: string;
10485
10538
  };
10486
10539
  path: {
10487
10540
  accountId: string;
package/dist/index.d.ts CHANGED
@@ -992,6 +992,15 @@ type Ad = {
992
992
  pinterestTitle?: string;
993
993
  pinterestDescription?: string;
994
994
  } | null;
995
+ /**
996
+ * The ad set's targeting (age, gender, geo, interests, placements, audience inclusions/exclusions).
997
+ * For ads created through Zernio this is the spec you supplied. For external ads (synced from
998
+ * Meta Ads Manager, `isExternal: true`) targeting lives at the ad set and isn't stored at ingest,
999
+ * so on the first `GET /v1/ads/{adId}` Zernio resolves it live from Meta and caches it on the ad;
1000
+ * the value is then Meta's raw `targeting` shape (snake_case, e.g. `geo_locations`, `age_min`),
1001
+ * the same object Ads Manager shows. May be absent if the ad set exposes no targeting or the lookup fails.
1002
+ *
1003
+ */
995
1004
  targeting?: {
996
1005
  [key: string]: unknown;
997
1006
  };
@@ -8198,6 +8207,11 @@ type SelectFacebookPageError = (unknown | {
8198
8207
  });
8199
8208
  type ListGoogleBusinessLocationsData = {
8200
8209
  query?: {
8210
+ /**
8211
+ * Raw Google Business Information API filter expression (advanced; takes precedence over search). Supports fields such as title, storeCode, storefront_address.postal_code, labels and categories, e.g. storeCode="LH279411". See Google's "Work with location data" guide.
8212
+ *
8213
+ */
8214
+ filter?: string;
8201
8215
  /**
8202
8216
  * Token from the OAuth callback redirect. Preferred over tempToken because it preserves server-side token storage. One of pendingDataToken or tempToken is required.
8203
8217
  */
@@ -8206,6 +8220,11 @@ type ListGoogleBusinessLocationsData = {
8206
8220
  * Profile ID from your connection flow. Required for auth validation when provided.
8207
8221
  */
8208
8222
  profileId?: string;
8223
+ /**
8224
+ * Free-text search on the business name, applied server-side by Google. Use this for accounts that own many locations (the response is bounded, see hasMore) so the user can find a specific location without loading the full list.
8225
+ *
8226
+ */
8227
+ search?: string;
8209
8228
  /**
8210
8229
  * Legacy. Direct Google access token. Use pendingDataToken instead when available.
8211
8230
  */
@@ -8238,7 +8257,16 @@ type ListGoogleBusinessLocationsResponse = ({
8238
8257
  * Business category
8239
8258
  */
8240
8259
  category?: string;
8260
+ /**
8261
+ * Store code set on the location in Google Business Profile (if any)
8262
+ */
8263
+ storeCode?: string;
8241
8264
  }>;
8265
+ /**
8266
+ * True when more locations exist than were returned (the list is bounded). Prompt the user to narrow the result set with search.
8267
+ *
8268
+ */
8269
+ hasMore?: boolean;
8242
8270
  });
8243
8271
  type ListGoogleBusinessLocationsError = (unknown | {
8244
8272
  error?: string;
@@ -8253,6 +8281,11 @@ type SelectGoogleBusinessLocationData = {
8253
8281
  * The Google Business location ID selected by the user
8254
8282
  */
8255
8283
  locationId: string;
8284
+ /**
8285
+ * Optional but recommended. The Google Business Account resource name ("accounts/123") that owns the selected location (returned per-location by GET /v1/connect/googlebusiness/locations). When provided, the location is resolved directly instead of by enumerating the account, which is required for accounts that own many locations. Omit only for small accounts.
8286
+ *
8287
+ */
8288
+ accountId?: string;
8256
8289
  /**
8257
8290
  * Token from the OAuth callback redirect (pendingDataToken query param). Tokens and profile data are retrieved server-side from this token.
8258
8291
  */
@@ -10462,6 +10495,16 @@ type GetGmbLocationsData = {
10462
10495
  path: {
10463
10496
  accountId: string;
10464
10497
  };
10498
+ query?: {
10499
+ /**
10500
+ * Raw Google Business Information API filter expression (advanced; takes precedence over search), e.g. storeCode="LH279411".
10501
+ */
10502
+ filter?: string;
10503
+ /**
10504
+ * Free-text search on the business name, applied server-side by Google. Use for accounts with many locations.
10505
+ */
10506
+ search?: string;
10507
+ };
10465
10508
  };
10466
10509
  type GetGmbLocationsResponse = ({
10467
10510
  locations?: Array<{
@@ -10472,7 +10515,12 @@ type GetGmbLocationsResponse = ({
10472
10515
  address?: string;
10473
10516
  category?: string;
10474
10517
  websiteUrl?: string;
10518
+ storeCode?: string;
10475
10519
  }>;
10520
+ /**
10521
+ * True when more locations exist than were returned (use search to narrow down).
10522
+ */
10523
+ hasMore?: boolean;
10476
10524
  selectedLocationId?: string;
10477
10525
  cached?: boolean;
10478
10526
  });
@@ -10482,6 +10530,11 @@ type GetGmbLocationsError = ({
10482
10530
  type UpdateGmbLocationData = {
10483
10531
  body: {
10484
10532
  selectedLocationId: string;
10533
+ /**
10534
+ * Optional but recommended. The Google Business Account resource name ("accounts/123") that owns the new location (from GET gmb-locations). When provided, the location is resolved directly instead of by enumerating the account, which is required for accounts with many locations.
10535
+ *
10536
+ */
10537
+ accountId?: string;
10485
10538
  };
10486
10539
  path: {
10487
10540
  accountId: string;
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.207",
39
+ version: "0.2.209",
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.207",
8
+ version: "0.2.209",
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.207",
3
+ "version": "0.2.209",
4
4
  "description": "The official Node.js library for the Zernio API",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -1672,7 +1672,8 @@ export const updateYoutubeDefaultPlaylist = <ThrowOnError extends boolean = fals
1672
1672
 
1673
1673
  /**
1674
1674
  * List GBP locations
1675
- * Returns all Google Business Profile locations the connected account has access to, including the currently selected location.
1675
+ * Returns Google Business Profile locations the connected account can access, plus the currently selected location. The list is bounded (see hasMore); for accounts that own many locations, use the search or filter query params to find a specific one instead of loading them all.
1676
+ *
1676
1677
  */
1677
1678
  export const getGmbLocations = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetGmbLocationsData, ThrowOnError>) => {
1678
1679
  return (options?.client ?? client).get<GetGmbLocationsResponse, GetGmbLocationsError, ThrowOnError>({
@@ -260,6 +260,15 @@ export type Ad = {
260
260
  pinterestTitle?: string;
261
261
  pinterestDescription?: string;
262
262
  } | null;
263
+ /**
264
+ * The ad set's targeting (age, gender, geo, interests, placements, audience inclusions/exclusions).
265
+ * For ads created through Zernio this is the spec you supplied. For external ads (synced from
266
+ * Meta Ads Manager, `isExternal: true`) targeting lives at the ad set and isn't stored at ingest,
267
+ * so on the first `GET /v1/ads/{adId}` Zernio resolves it live from Meta and caches it on the ad;
268
+ * the value is then Meta's raw `targeting` shape (snake_case, e.g. `geo_locations`, `age_min`),
269
+ * the same object Ads Manager shows. May be absent if the ad set exposes no targeting or the lookup fails.
270
+ *
271
+ */
263
272
  targeting?: {
264
273
  [key: string]: unknown;
265
274
  };
@@ -7892,6 +7901,11 @@ export type SelectFacebookPageError = (unknown | {
7892
7901
 
7893
7902
  export type ListGoogleBusinessLocationsData = {
7894
7903
  query?: {
7904
+ /**
7905
+ * Raw Google Business Information API filter expression (advanced; takes precedence over search). Supports fields such as title, storeCode, storefront_address.postal_code, labels and categories, e.g. storeCode="LH279411". See Google's "Work with location data" guide.
7906
+ *
7907
+ */
7908
+ filter?: string;
7895
7909
  /**
7896
7910
  * Token from the OAuth callback redirect. Preferred over tempToken because it preserves server-side token storage. One of pendingDataToken or tempToken is required.
7897
7911
  */
@@ -7900,6 +7914,11 @@ export type ListGoogleBusinessLocationsData = {
7900
7914
  * Profile ID from your connection flow. Required for auth validation when provided.
7901
7915
  */
7902
7916
  profileId?: string;
7917
+ /**
7918
+ * Free-text search on the business name, applied server-side by Google. Use this for accounts that own many locations (the response is bounded, see hasMore) so the user can find a specific location without loading the full list.
7919
+ *
7920
+ */
7921
+ search?: string;
7903
7922
  /**
7904
7923
  * Legacy. Direct Google access token. Use pendingDataToken instead when available.
7905
7924
  */
@@ -7933,7 +7952,16 @@ export type ListGoogleBusinessLocationsResponse = ({
7933
7952
  * Business category
7934
7953
  */
7935
7954
  category?: string;
7955
+ /**
7956
+ * Store code set on the location in Google Business Profile (if any)
7957
+ */
7958
+ storeCode?: string;
7936
7959
  }>;
7960
+ /**
7961
+ * True when more locations exist than were returned (the list is bounded). Prompt the user to narrow the result set with search.
7962
+ *
7963
+ */
7964
+ hasMore?: boolean;
7937
7965
  });
7938
7966
 
7939
7967
  export type ListGoogleBusinessLocationsError = (unknown | {
@@ -7950,6 +7978,11 @@ export type SelectGoogleBusinessLocationData = {
7950
7978
  * The Google Business location ID selected by the user
7951
7979
  */
7952
7980
  locationId: string;
7981
+ /**
7982
+ * Optional but recommended. The Google Business Account resource name ("accounts/123") that owns the selected location (returned per-location by GET /v1/connect/googlebusiness/locations). When provided, the location is resolved directly instead of by enumerating the account, which is required for accounts that own many locations. Omit only for small accounts.
7983
+ *
7984
+ */
7985
+ accountId?: string;
7953
7986
  /**
7954
7987
  * Token from the OAuth callback redirect (pendingDataToken query param). Tokens and profile data are retrieved server-side from this token.
7955
7988
  */
@@ -10315,6 +10348,16 @@ export type GetGmbLocationsData = {
10315
10348
  path: {
10316
10349
  accountId: string;
10317
10350
  };
10351
+ query?: {
10352
+ /**
10353
+ * Raw Google Business Information API filter expression (advanced; takes precedence over search), e.g. storeCode="LH279411".
10354
+ */
10355
+ filter?: string;
10356
+ /**
10357
+ * Free-text search on the business name, applied server-side by Google. Use for accounts with many locations.
10358
+ */
10359
+ search?: string;
10360
+ };
10318
10361
  };
10319
10362
 
10320
10363
  export type GetGmbLocationsResponse = ({
@@ -10326,7 +10369,12 @@ export type GetGmbLocationsResponse = ({
10326
10369
  address?: string;
10327
10370
  category?: string;
10328
10371
  websiteUrl?: string;
10372
+ storeCode?: string;
10329
10373
  }>;
10374
+ /**
10375
+ * True when more locations exist than were returned (use search to narrow down).
10376
+ */
10377
+ hasMore?: boolean;
10330
10378
  selectedLocationId?: string;
10331
10379
  cached?: boolean;
10332
10380
  });
@@ -10338,6 +10386,11 @@ export type GetGmbLocationsError = ({
10338
10386
  export type UpdateGmbLocationData = {
10339
10387
  body: {
10340
10388
  selectedLocationId: string;
10389
+ /**
10390
+ * Optional but recommended. The Google Business Account resource name ("accounts/123") that owns the new location (from GET gmb-locations). When provided, the location is resolved directly instead of by enumerating the account, which is required for accounts with many locations.
10391
+ *
10392
+ */
10393
+ accountId?: string;
10341
10394
  };
10342
10395
  path: {
10343
10396
  accountId: string;