@zernio/node 0.2.653 → 0.2.655

package/dist/index.d.mts

@@ -6562,7 +6562,7 @@ type TargetingSpec = {
         name?: string;
     }>;
     /**
-     * Point-radius (lat/lng) targeting (Meta custom_locations / Google proximity). Honoured only where the capability map allows radius (Meta).
+     * Point-radius (lat/lng) targeting (Meta custom_locations / Google proximity). Honoured on Meta and Google; ignored on platforms without radius support.
      */
     customLocations?: Array<{
         latitude: number;

package/dist/index.d.ts

@@ -6562,7 +6562,7 @@ type TargetingSpec = {
         name?: string;
     }>;
     /**
-     * Point-radius (lat/lng) targeting (Meta custom_locations / Google proximity). Honoured only where the capability map allows radius (Meta).
+     * Point-radius (lat/lng) targeting (Meta custom_locations / Google proximity). Honoured on Meta and Google; ignored on platforms without radius support.
      */
     customLocations?: Array<{
         latitude: number;

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.653",
+  version: "0.2.655",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

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.653",
+  version: "0.2.655",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/package.json

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

package/src/generated/sdk.gen.ts

@@ -3825,12 +3825,29 @@ export const unhideInboxComment = <ThrowOnError extends boolean = false>(options
 /**
  * Like comment
  * Like or upvote a comment on a post. Supported platforms: Facebook, Twitter/X,
- * Bluesky, Reddit, LinkedIn. For Bluesky, the cid (content identifier) is required
- * in the request body. For LinkedIn, pass the composite comment URN returned by the
- * comments endpoints as commentId; an optional reactionType picks the reaction
+ * Bluesky, Reddit, LinkedIn, and Instagram in limited release (see below). For
+ * Bluesky, the cid (content identifier) is
+ * required in the request body. For LinkedIn, pass the composite comment URN returned
+ * by the comments endpoints as commentId; an optional reactionType picks the reaction
  * (defaults to LIKE), and accounts connected before the social-feed scopes were
  * requested get a 403 with code `linkedin_reconnect_required`.
  *
+ * Instagram is in LIMITED RELEASE and not generally available: the call needs
+ * `instagram_manage_engagement`, which Meta has so far granted this app only under
+ * Standard Access, so it works for app admins, developers and testers of our Meta app
+ * and returns a 403 with code `PLATFORM_BETA_RESTRICTED` for every other account.
+ * That restriction lifts when Meta App Review grants Advanced Access; the constraints
+ * below apply once it does.
+ *
+ * Instagram covers comments and replies on feed posts, reels and carousels. Only an
+ * account connected through Facebook Login can be granted
+ * `instagram_manage_engagement`: an Instagram Login connection returns a 400 with
+ * code `instagram_likes_require_facebook_login`, and an account whose token predates
+ * the permission returns a 403 with code `reconnect_required`. Content from private
+ * accounts cannot be liked. Instagram also enforces a burst limit of 50 like or
+ * unlike calls per 5 seconds per Instagram account, and exceeding it locks that
+ * account out of the like API for an hour, so pace bulk loops.
+ *
  */
 export const likeInboxComment = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<LikeInboxCommentData, ThrowOnError>) => {
     return (options?.client ?? client).post<LikeInboxCommentResponse, LikeInboxCommentError, ThrowOnError>({
@@ -3842,7 +3859,9 @@ export const likeInboxComment = <ThrowOnError extends boolean = false>(options:
 /**
  * Unlike comment
  * Remove a like from a comment. Supported platforms: Facebook, Twitter/X, Bluesky,
- * Reddit, LinkedIn. For Bluesky, the likeUri query parameter is required.
+ * Reddit, LinkedIn, and Instagram in limited release. For Bluesky, the likeUri query
+ * parameter is required. Instagram has the same limited release, Facebook Login,
+ * `instagram_manage_engagement` and burst-limit constraints as liking.
  *
  */
 export const unlikeInboxComment = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UnlikeInboxCommentData, ThrowOnError>) => {
@@ -3855,7 +3874,8 @@ export const unlikeInboxComment = <ThrowOnError extends boolean = false>(options
 /**
  * Like post
  * Like (or react to) a post as a connected account. Supported platforms: LinkedIn,
- * Twitter/X, Facebook, YouTube, Bluesky. Instagram, Threads, TikTok and Pinterest
+ * Twitter/X, Facebook, YouTube, Bluesky, and Instagram in limited release (see below).
+ * Threads, TikTok and Pinterest
  * expose no like endpoint in their APIs and return 400. Reddit returns 400 too,
  * pointing at `POST /v1/accounts/{accountId}/reddit-vote`, which covers upvote,
  * downvote and clear on both posts and comments.
@@ -3872,6 +3892,22 @@ export const unlikeInboxComment = <ThrowOnError extends boolean = false>(options
  * get a 403 with code `linkedin_reconnect_required` until the user reconnects the
  * account. YouTube spends 50 quota units per call.
  *
+ * Instagram is in LIMITED RELEASE and not generally available: the call needs
+ * `instagram_manage_engagement`, which Meta has so far granted this app only under
+ * Standard Access, so it works for app admins, developers and testers of our Meta app
+ * and returns a 403 with code `PLATFORM_BETA_RESTRICTED` for every other account.
+ * That restriction lifts when Meta App Review grants Advanced Access; the constraints
+ * below apply once it does.
+ *
+ * Instagram covers feed images, reels and carousels (stories and private-account
+ * media are not likeable). Only an account connected through Facebook Login can be
+ * granted `instagram_manage_engagement`: an Instagram Login
+ * connection returns a 400 with code `instagram_likes_require_facebook_login`, and an
+ * account whose token predates the permission returns a 403 with code
+ * `reconnect_required`. Instagram also enforces a burst limit of 50 like or unlike
+ * calls per 5 seconds per Instagram account, and exceeding it locks that account out
+ * of the like API for an hour, so pace bulk loops.
+ *
  */
 export const likePost = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<LikePostData, ThrowOnError>) => {
     return (options?.client ?? client).post<LikePostResponse, LikePostError, ThrowOnError>({
@@ -3883,7 +3919,9 @@ export const likePost = <ThrowOnError extends boolean = false>(options: OptionsL
 /**
  * Unlike post
  * Remove this account's like from a post. Supported platforms: LinkedIn, Twitter/X,
- * Facebook, YouTube, Bluesky. On YouTube this clears the rating. For Bluesky,
+ * Facebook, YouTube, Bluesky, and Instagram in limited release. On YouTube this clears
+ * the rating. Instagram has the same limited release, Facebook Login,
+ * `instagram_manage_engagement` and burst-limit constraints as liking. For Bluesky,
  * `likeUri` (returned when the post was liked) is required. Reddit uses
  * `POST /v1/accounts/{accountId}/reddit-vote` with `direction: 0`.
  *
@@ -8751,6 +8789,17 @@ export const searchAdInterests = <ThrowOnError extends boolean = false>(options:
  * `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`.
  *
+ * Google geo searches resolve against Google's geoTargetConstants and return
+ * every matching level in one list; `geoType` is not applied (Google's
+ * `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.
+ *
  * Pinterest resolves against three whole-catalog endpoints (interests, locations,
  * regions) with no server-side query or pagination, so matching, ranking and the
  * `limit` cutoff all happen in Zernio; the catalog is independent of any ad account

package/src/generated/types.gen.ts

@@ -5437,7 +5437,7 @@ export type TargetingSpec = {
         name?: string;
     }>;
     /**
-     * Point-radius (lat/lng) targeting (Meta custom_locations / Google proximity). Honoured only where the capability map allows radius (Meta).
+     * Point-radius (lat/lng) targeting (Meta custom_locations / Google proximity). Honoured on Meta and Google; ignored on platforms without radius support.
      */
     customLocations?: Array<{
         latitude: number;