@zernio/node 0.2.1035 → 0.2.1037

package/dist/index.d.mts

@@ -4825,6 +4825,14 @@ type CommentAutomationAudience = {
      *
      */
     whenUnknown?: 'send' | 'skip' | 'verify';
+    /**
+     * Send `followGate.message` with its button to EVERY commenter and deliver the real
+     * DM when they tap it, with no follow check at any point. Cannot be combined with a
+     * `followerStatus` other than `any` or with `minFollowerCount` (400); `whenUnknown`
+     * is ignored. Instagram only. A PATCH that sends `audience` without this field clears it.
+     *
+     */
+    tapToUnlock?: boolean;
 };
 type followerStatus = 'any' | 'follower' | 'non_follower';
 /**
@@ -4842,11 +4850,11 @@ type whenUnknown = 'send' | 'skip' | 'verify';
  */
 type CommentAutomationFollowGate = {
     /**
-     * Confirmation DM sent when whenUnknown=verify.
+     * Confirmation DM sent when whenUnknown=verify or tapToUnlock=true. The default copy asks for a follow under whenUnknown=verify and only for the tap under tapToUnlock.
      */
     message?: string;
     /**
-     * Confirm button label. Defaults to "I'm following".
+     * Confirm button label. Defaults to "I'm following" (whenUnknown=verify) or "Unlock" (tapToUnlock).
      */
     buttonLabel?: string;
     /**
@@ -6094,7 +6102,7 @@ type CtwaAdRequestBody = {
         [key: string]: unknown;
     };
     /**
-     * Meta behavior ids. Each dimension is its own flexible_spec entry: OR within, AND across.
+     * Behavior ids from /v1/ads/targeting/search?dimension=behavior. Meta: each dimension is its own flexible_spec entry (OR within, AND across). TikTok: video/creator interaction categories, sent as the ad group's actions.
      */
     behaviors?: Array<{
         id: string;
@@ -11610,7 +11618,7 @@ type TargetingSpec = {
         name?: string;
     }>;
     /**
-     * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta only (TikTok behaviours are rejected with a 400).
+     * Behaviour entities from /v1/ads/targeting/search?dimension=behavior (Meta and TikTok). On TikTok they target people who interacted with videos (watched to the end, liked, commented or shared, last 15 days) or creators (followed or viewed the profile) in the picked categories, and the ad group uses the TikTok placement only.
      */
     behaviors?: Array<{
         id: string;
@@ -45476,7 +45484,7 @@ type CreateStandaloneAdData = {
             address?: string;
         }>;
         /**
-         * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta only (TikTok behaviours are rejected with a 400). Each must include id.
+         * Behaviour entities from /v1/ads/targeting/search?dimension=behavior (Meta and TikTok). On TikTok they target people who interacted with videos (watched to the end, liked, commented or shared, last 15 days) or creators (followed or viewed the profile) in the picked categories, and the ad group uses the TikTok placement only. Each must include id.
          */
         behaviors?: Array<{
             id: string;

package/dist/index.d.ts

@@ -4825,6 +4825,14 @@ type CommentAutomationAudience = {
      *
      */
     whenUnknown?: 'send' | 'skip' | 'verify';
+    /**
+     * Send `followGate.message` with its button to EVERY commenter and deliver the real
+     * DM when they tap it, with no follow check at any point. Cannot be combined with a
+     * `followerStatus` other than `any` or with `minFollowerCount` (400); `whenUnknown`
+     * is ignored. Instagram only. A PATCH that sends `audience` without this field clears it.
+     *
+     */
+    tapToUnlock?: boolean;
 };
 type followerStatus = 'any' | 'follower' | 'non_follower';
 /**
@@ -4842,11 +4850,11 @@ type whenUnknown = 'send' | 'skip' | 'verify';
  */
 type CommentAutomationFollowGate = {
     /**
-     * Confirmation DM sent when whenUnknown=verify.
+     * Confirmation DM sent when whenUnknown=verify or tapToUnlock=true. The default copy asks for a follow under whenUnknown=verify and only for the tap under tapToUnlock.
      */
     message?: string;
     /**
-     * Confirm button label. Defaults to "I'm following".
+     * Confirm button label. Defaults to "I'm following" (whenUnknown=verify) or "Unlock" (tapToUnlock).
      */
     buttonLabel?: string;
     /**
@@ -6094,7 +6102,7 @@ type CtwaAdRequestBody = {
         [key: string]: unknown;
     };
     /**
-     * Meta behavior ids. Each dimension is its own flexible_spec entry: OR within, AND across.
+     * Behavior ids from /v1/ads/targeting/search?dimension=behavior. Meta: each dimension is its own flexible_spec entry (OR within, AND across). TikTok: video/creator interaction categories, sent as the ad group's actions.
      */
     behaviors?: Array<{
         id: string;
@@ -11610,7 +11618,7 @@ type TargetingSpec = {
         name?: string;
     }>;
     /**
-     * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta only (TikTok behaviours are rejected with a 400).
+     * Behaviour entities from /v1/ads/targeting/search?dimension=behavior (Meta and TikTok). On TikTok they target people who interacted with videos (watched to the end, liked, commented or shared, last 15 days) or creators (followed or viewed the profile) in the picked categories, and the ad group uses the TikTok placement only.
      */
     behaviors?: Array<{
         id: string;
@@ -45476,7 +45484,7 @@ type CreateStandaloneAdData = {
             address?: string;
         }>;
         /**
-         * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta only (TikTok behaviours are rejected with a 400). Each must include id.
+         * Behaviour entities from /v1/ads/targeting/search?dimension=behavior (Meta and TikTok). On TikTok they target people who interacted with videos (watched to the end, liked, commented or shared, last 15 days) or creators (followed or viewed the profile) in the picked categories, and the ad group uses the TikTok placement only. Each must include id.
          */
         behaviors?: Array<{
             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.1035",
+  version: "0.2.1037",
   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.1035",
+  version: "0.2.1037",
   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.1035",
+  "version": "0.2.1037",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -9041,7 +9041,9 @@ export const listCommentAutomations = <ThrowOnError extends boolean = false>(opt
  * follow relationship for people who have messaged the account, so `audience.whenUnknown`
  * decides what happens for everyone else - including `verify`, which sends a one-tap
  * confirmation DM (`followGate`) and then delivers the real DM automatically. People we
- * already know follow you skip the tap entirely.
+ * already know follow you skip the tap entirely. Set `audience.tapToUnlock: true` instead
+ * to send that button DM to every commenter and deliver the real DM on the tap with no
+ * follow check.
  *
  * Set `alsoMatchInDms: true` on a `comment` automation to also answer people who send
  * a keyword as a direct message instead of commenting it. One automation then covers
@@ -11999,8 +12001,11 @@ export const searchAdInterests = <ThrowOnError extends boolean = false>(options:
  *
  * - `geo`: locations, further scoped by `geoType`
  * - `interest`
- * - `behavior`: Meta-only, matched by name against Meta's fixed behaviors catalog
- * (e.g. `Small business owners`, `Frequent Travelers`); ids feed `TargetingSpec.behaviors`
+ * - `behavior`: Meta and TikTok, matched by name; ids feed `TargetingSpec.behaviors`.
+ * Meta: its fixed behaviors catalog (e.g. `Small business owners`, `Frequent Travelers`).
+ * TikTok: video and creator interaction categories (e.g. `Software & Apps`), with ids like
+ * `video:1913101` or `creator:24001` and `path` starting with `Video interactions` or
+ * `Creator interactions`
  * - `income`: the household-income tiers the platform can target (Meta, TikTok, Google).
  * The id is the normalized tier (`top_5`, `top_10`, `top_10_25`, `top_25_50`) to pass as
  * `TargetingSpec.incomeTier`, never a platform segment id. Meta's tiers are US-only

package/src/generated/types.gen.ts

@@ -2986,6 +2986,14 @@ export type CommentAutomationAudience = {
      *
      */
     whenUnknown?: 'send' | 'skip' | 'verify';
+    /**
+     * Send `followGate.message` with its button to EVERY commenter and deliver the real
+     * DM when they tap it, with no follow check at any point. Cannot be combined with a
+     * `followerStatus` other than `any` or with `minFollowerCount` (400); `whenUnknown`
+     * is ignored. Instagram only. A PATCH that sends `audience` without this field clears it.
+     *
+     */
+    tapToUnlock?: boolean;
 };
 
 export type followerStatus = 'any' | 'follower' | 'non_follower';
@@ -3006,11 +3014,11 @@ export type whenUnknown = 'send' | 'skip' | 'verify';
  */
 export type CommentAutomationFollowGate = {
     /**
-     * Confirmation DM sent when whenUnknown=verify.
+     * Confirmation DM sent when whenUnknown=verify or tapToUnlock=true. The default copy asks for a follow under whenUnknown=verify and only for the tap under tapToUnlock.
      */
     message?: string;
     /**
-     * Confirm button label. Defaults to "I'm following".
+     * Confirm button label. Defaults to "I'm following" (whenUnknown=verify) or "Unlock" (tapToUnlock).
      */
     buttonLabel?: string;
     /**
@@ -4302,7 +4310,7 @@ export type CtwaAdRequestBody = {
         [key: string]: unknown;
     };
     /**
-     * Meta behavior ids. Each dimension is its own flexible_spec entry: OR within, AND across.
+     * Behavior ids from /v1/ads/targeting/search?dimension=behavior. Meta: each dimension is its own flexible_spec entry (OR within, AND across). TikTok: video/creator interaction categories, sent as the ad group's actions.
      */
     behaviors?: Array<{
         id: string;
@@ -10088,7 +10096,7 @@ export type TargetingSpec = {
         name?: string;
     }>;
     /**
-     * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta only (TikTok behaviours are rejected with a 400).
+     * Behaviour entities from /v1/ads/targeting/search?dimension=behavior (Meta and TikTok). On TikTok they target people who interacted with videos (watched to the end, liked, commented or shared, last 15 days) or creators (followed or viewed the profile) in the picked categories, and the ad group uses the TikTok placement only.
      */
     behaviors?: Array<{
         id: string;
@@ -46205,7 +46213,7 @@ export type CreateStandaloneAdData = {
             address?: string;
         }>;
         /**
-         * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta only (TikTok behaviours are rejected with a 400). Each must include id.
+         * Behaviour entities from /v1/ads/targeting/search?dimension=behavior (Meta and TikTok). On TikTok they target people who interacted with videos (watched to the end, liked, commented or shared, last 15 days) or creators (followed or viewed the profile) in the picked categories, and the ad group uses the TikTok placement only. Each must include id.
          */
         behaviors?: Array<{
             id: string;