@zernio/node 0.2.787 → 0.2.789

package/dist/index.d.mts

@@ -1543,6 +1543,7 @@ interface ZernioErrorBody {
     type?: string;
     code?: string;
     param?: string;
+    docUrl?: string;
     platform?: string;
     platformError?: Record<string, unknown>;
     details?: Record<string, unknown>;
@@ -1555,6 +1556,8 @@ declare class ZernioApiError extends Error {
     readonly type?: string;
     /** The request field that caused the error, when the API names one. */
     readonly param?: string;
+    /** Link to the documentation for this error, when the API provides one. */
+    readonly docUrl?: string;
     /** Upstream platform, present when type is platform_error. */
     readonly platform?: string;
     /** The upstream platform's own payload, verbatim (Meta: code, subcode, fbtrace_id). */
@@ -10114,7 +10117,7 @@ type WebhookPayloadComment = {
             name?: string;
             picture?: (string) | null;
             /**
-             * True when this comment was authored by the connected account itself (Meta re-delivers the account's own replies as comments events). Populated on the Instagram and Facebook realtime webhooks only; absent means not evaluated, never "not the account".
+             * True when this comment was authored by the connected account itself. Populated on the Instagram and Facebook realtime webhooks (Meta re-delivers the account's own replies as comments events) and on TikTok, where it is inferred: comments created through this API are always flagged, and once the account's own author identifier is known (from one of those or from a comments listing) every author is compared against it. Absent means not evaluated, never "not the account".
              */
             isOwnAccount?: boolean;
             /**
@@ -39179,7 +39182,7 @@ type SearchAdTargetingData = {
 type SearchAdTargetingResponse = ({
     results?: Array<{
         /**
-         * The platform's opaque id. Use as a geo `key` (regions/cities/zips/metros) or an entity `id` (interests/behaviors) in TargetingSpec.
+         * The platform's opaque id. Use as a geo `key` (regions/cities/zips/metros) or an entity `id` (interests/behaviors) in TargetingSpec. A `country` result is the exception on every platform: its id is the ISO 3166-1 alpha-2 code, which is what `targeting.countries` takes.
          */
         id: string;
         /**

package/dist/index.d.ts

@@ -1543,6 +1543,7 @@ interface ZernioErrorBody {
     type?: string;
     code?: string;
     param?: string;
+    docUrl?: string;
     platform?: string;
     platformError?: Record<string, unknown>;
     details?: Record<string, unknown>;
@@ -1555,6 +1556,8 @@ declare class ZernioApiError extends Error {
     readonly type?: string;
     /** The request field that caused the error, when the API names one. */
     readonly param?: string;
+    /** Link to the documentation for this error, when the API provides one. */
+    readonly docUrl?: string;
     /** Upstream platform, present when type is platform_error. */
     readonly platform?: string;
     /** The upstream platform's own payload, verbatim (Meta: code, subcode, fbtrace_id). */
@@ -10114,7 +10117,7 @@ type WebhookPayloadComment = {
             name?: string;
             picture?: (string) | null;
             /**
-             * True when this comment was authored by the connected account itself (Meta re-delivers the account's own replies as comments events). Populated on the Instagram and Facebook realtime webhooks only; absent means not evaluated, never "not the account".
+             * True when this comment was authored by the connected account itself. Populated on the Instagram and Facebook realtime webhooks (Meta re-delivers the account's own replies as comments events) and on TikTok, where it is inferred: comments created through this API are always flagged, and once the account's own author identifier is known (from one of those or from a comments listing) every author is compared against it. Absent means not evaluated, never "not the account".
              */
             isOwnAccount?: boolean;
             /**
@@ -39179,7 +39182,7 @@ type SearchAdTargetingData = {
 type SearchAdTargetingResponse = ({
     results?: Array<{
         /**
-         * The platform's opaque id. Use as a geo `key` (regions/cities/zips/metros) or an entity `id` (interests/behaviors) in TargetingSpec.
+         * The platform's opaque id. Use as a geo `key` (regions/cities/zips/metros) or an entity `id` (interests/behaviors) in TargetingSpec. A `country` result is the exception on every platform: its id is the ISO 3166-1 alpha-2 code, which is what `targeting.countries` takes.
          */
         id: string;
         /**

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.787",
+  version: "0.2.789",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",
@@ -4764,6 +4764,7 @@ var ZernioApiError = class _ZernioApiError extends Error {
     this.details = details;
     this.type = body?.type;
     this.param = body?.param;
+    this.docUrl = body?.docUrl;
     this.platform = body?.platform;
     this.platformError = body?.platformError;
     this.body = body;

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.787",
+  version: "0.2.789",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",
@@ -4733,6 +4733,7 @@ var ZernioApiError = class _ZernioApiError extends Error {
     this.details = details;
     this.type = body?.type;
     this.param = body?.param;
+    this.docUrl = body?.docUrl;
     this.platform = body?.platform;
     this.platformError = body?.platformError;
     this.body = body;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zernio/node",
-  "version": "0.2.787",
+  "version": "0.2.789",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/errors.ts

@@ -15,6 +15,7 @@ export interface ZernioErrorBody {
   type?: string;
   code?: string;
   param?: string;
+  docUrl?: string;
   platform?: string;
   platformError?: Record<string, unknown>;
   details?: Record<string, unknown>;
@@ -28,6 +29,8 @@ export class ZernioApiError extends Error {
   public readonly type?: string;
   /** The request field that caused the error, when the API names one. */
   public readonly param?: string;
+  /** Link to the documentation for this error, when the API provides one. */
+  public readonly docUrl?: string;
   /** Upstream platform, present when type is platform_error. */
   public readonly platform?: string;
   /** The upstream platform's own payload, verbatim (Meta: code, subcode, fbtrace_id). */
@@ -49,6 +52,7 @@ export class ZernioApiError extends Error {
     this.details = details;
     this.type = body?.type;
     this.param = body?.param;
+    this.docUrl = body?.docUrl;
     this.platform = body?.platform;
     this.platformError = body?.platformError;
     this.body = body;

package/src/generated/sdk.gen.ts

@@ -10451,15 +10451,20 @@ export const searchAdInterests = <ThrowOnError extends boolean = false>(options:
  * TikTok geo searches return every matching level in one list (`type` is
  * `country`, `region`, `city`, `district`, or `metro` for DMA areas), and
  * `geoType` is not applied. Results are scoped to the advertiser's targetable
- * markets, and every id is usable in `regions`/`cities`/`metros` keys on
- * `POST /v1/ads/create`.
+ * markets. A `country` result's id is its ISO 3166-1 alpha-2 code, for
+ * `targeting.countries`; every other id is TikTok's numeric location id,
+ * usable in `regions`/`cities`/`metros` keys on `POST /v1/ads/create`.
  *
  * LinkedIn geo searches also return every matching level in one list, and
  * neither `geoType` nor `countryCode` is applied: LinkedIn's typeahead only
  * returns a name and a URN per result, with no level or country field to
- * filter on. Every result has `type` set to `location`, and its id is a
- * `urn:li:geo:*` URN usable as a `regions[].key` on `POST /v1/ads/create`,
- * `POST /v1/ads/boost` and `POST /v1/ads/targeting/reach-estimate`.
+ * filter on. A result whose URN is a country Zernio holds a code for has
+ * `type: country` and its ISO 3166-1 alpha-2 code as the id, for
+ * `targeting.countries`. Every other result has `type: region` and keeps
+ * its `urn:li:geo:*` URN as the id, usable as a `regions[].key` on
+ * `POST /v1/ads/create`, `POST /v1/ads/boost` and
+ * `POST /v1/ads/targeting/reach-estimate` (LinkedIn puts countries and
+ * regions in the same `locations` facet, so both target the same way).
  *
  * LinkedIn B2B searches (`industry`, `jobFunction`, `seniority`, `companySize`) return the
  * full URN to pass straight back, so no URN id fragment has to be assembled by hand:
@@ -10475,11 +10480,13 @@ export const searchAdInterests = <ThrowOnError extends boolean = false>(options:
  * `target_type` is an open taxonomy that does not map one-to-one onto the
  * `geoType` enum), so filter client-side on the returned `type` (`country`,
  * `region`, `city`, `zip`, `metro`, or the lowercased Google target type for
- * rarer levels). `countryCode` scopes the search to one country. Each id is
- * Google's numeric criterion id, usable as a `regions`/`cities`/`zips`/`metros`
- * `key` on `POST /v1/ads/create`. Google city radius is not supported (pass a
- * `customLocations` lat/lng pin for a radius); country targeting also accepts
- * plain ISO codes via `countries` with no search call.
+ * rarer levels). `countryCode` scopes the search to one country. A `country`
+ * result's id is its ISO 3166-1 alpha-2 code, for `targeting.countries`;
+ * every other id is Google's numeric criterion id, usable as a
+ * `regions`/`cities`/`zips`/`metros` `key` on `POST /v1/ads/create`. Google
+ * city radius is not supported (pass a `customLocations` lat/lng pin for a
+ * radius); country targeting also accepts plain ISO codes via `countries`
+ * with no search call.
  *
  * Pinterest resolves against three whole-catalog endpoints (interests, locations,
  * regions) with no server-side query or pagination, so matching, ranking and the

package/src/generated/types.gen.ts

@@ -8846,7 +8846,7 @@ export type WebhookPayloadComment = {
             name?: string;
             picture?: (string) | null;
             /**
-             * True when this comment was authored by the connected account itself (Meta re-delivers the account's own replies as comments events). Populated on the Instagram and Facebook realtime webhooks only; absent means not evaluated, never "not the account".
+             * True when this comment was authored by the connected account itself. Populated on the Instagram and Facebook realtime webhooks (Meta re-delivers the account's own replies as comments events) and on TikTok, where it is inferred: comments created through this API are always flagged, and once the account's own author identifier is known (from one of those or from a comments listing) every author is compared against it. Absent means not evaluated, never "not the account".
              */
             isOwnAccount?: boolean;
             /**
@@ -39831,7 +39831,7 @@ export type SearchAdTargetingData = {
 export type SearchAdTargetingResponse = ({
     results?: Array<{
         /**
-         * The platform's opaque id. Use as a geo `key` (regions/cities/zips/metros) or an entity `id` (interests/behaviors) in TargetingSpec.
+         * The platform's opaque id. Use as a geo `key` (regions/cities/zips/metros) or an entity `id` (interests/behaviors) in TargetingSpec. A `country` result is the exception on every platform: its id is the ISO 3166-1 alpha-2 code, which is what `targeting.countries` takes.
          */
         id: string;
         /**