@zernio/node 0.2.170 → 0.2.172

package/dist/index.d.mts

@@ -2804,6 +2804,14 @@ type PostAnalytics = {
     saves?: number;
     clicks?: number;
     views?: number;
+    /**
+     * Instagram Reels only: average watch time per play, in milliseconds. 0 for non-Reels media and other platforms.
+     */
+    igReelsAvgWatchTime?: number;
+    /**
+     * Instagram Reels only: total watch time including replays, in milliseconds. 0 for non-Reels media and other platforms.
+     */
+    igReelsVideoViewTotalTime?: number;
     engagementRate?: number;
     lastUpdated?: string;
 };
@@ -10574,21 +10582,33 @@ type CreateInboxConversationData = {
          */
         accountId: string;
         /**
-         * Twitter numeric user ID of the recipient. Provide either this or participantUsername.
+         * Recipient identifier. For X this is the numeric user ID; for WhatsApp, the recipient phone number in international format (digits, country code included). Provide either this or participantUsername.
          */
         participantId?: string;
         /**
-         * Twitter username (with or without @) of the recipient. Resolved to a user ID via lookup. Provide either this or participantId.
+         * Recipient handle/username — an X or Bluesky handle (with or without @) or a Reddit username (with or without u/). Resolved via lookup. Provide either this or participantId.
          */
         participantUsername?: string;
         /**
-         * Text content of the message. At least one of message or attachment is required.
+         * Text content of the message. At least one of message, attachment, or (for WhatsApp) templateName is required.
          */
         message?: string;
         /**
-         * Skip the receives_your_dm eligibility check before sending. Use if you have already verified the recipient accepts DMs.
+         * X/Twitter only. Skip the receives_your_dm eligibility check before sending. Use if you have already verified the recipient accepts DMs.
          */
         skipDmCheck?: boolean;
+        /**
+         * WhatsApp only. Name of the approved template to start the conversation with (required for WhatsApp).
+         */
+        templateName?: string;
+        /**
+         * WhatsApp only. Template language code (e.g. en_US).
+         */
+        templateLanguage?: string;
+        /**
+         * WhatsApp only. Body variable values, in order, substituted into the template body ({{1}}, {{2}}, ...).
+         */
+        templateParams?: Array<(string)>;
     };
 };
 type CreateInboxConversationResponse = ({

package/dist/index.d.ts

@@ -2804,6 +2804,14 @@ type PostAnalytics = {
     saves?: number;
     clicks?: number;
     views?: number;
+    /**
+     * Instagram Reels only: average watch time per play, in milliseconds. 0 for non-Reels media and other platforms.
+     */
+    igReelsAvgWatchTime?: number;
+    /**
+     * Instagram Reels only: total watch time including replays, in milliseconds. 0 for non-Reels media and other platforms.
+     */
+    igReelsVideoViewTotalTime?: number;
     engagementRate?: number;
     lastUpdated?: string;
 };
@@ -10574,21 +10582,33 @@ type CreateInboxConversationData = {
          */
         accountId: string;
         /**
-         * Twitter numeric user ID of the recipient. Provide either this or participantUsername.
+         * Recipient identifier. For X this is the numeric user ID; for WhatsApp, the recipient phone number in international format (digits, country code included). Provide either this or participantUsername.
          */
         participantId?: string;
         /**
-         * Twitter username (with or without @) of the recipient. Resolved to a user ID via lookup. Provide either this or participantId.
+         * Recipient handle/username — an X or Bluesky handle (with or without @) or a Reddit username (with or without u/). Resolved via lookup. Provide either this or participantId.
          */
         participantUsername?: string;
         /**
-         * Text content of the message. At least one of message or attachment is required.
+         * Text content of the message. At least one of message, attachment, or (for WhatsApp) templateName is required.
          */
         message?: string;
         /**
-         * Skip the receives_your_dm eligibility check before sending. Use if you have already verified the recipient accepts DMs.
+         * X/Twitter only. Skip the receives_your_dm eligibility check before sending. Use if you have already verified the recipient accepts DMs.
          */
         skipDmCheck?: boolean;
+        /**
+         * WhatsApp only. Name of the approved template to start the conversation with (required for WhatsApp).
+         */
+        templateName?: string;
+        /**
+         * WhatsApp only. Template language code (e.g. en_US).
+         */
+        templateLanguage?: string;
+        /**
+         * WhatsApp only. Body variable values, in order, substituted into the template body ({{1}}, {{2}}, ...).
+         */
+        templateParams?: Array<(string)>;
     };
 };
 type CreateInboxConversationResponse = ({

package/dist/index.js

@@ -33,6 +33,92 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// package.json
+var package_default = {
+  name: "@zernio/node",
+  version: "0.2.172",
+  description: "The official Node.js library for the Zernio API",
+  main: "dist/index.js",
+  module: "dist/index.mjs",
+  types: "dist/index.d.ts",
+  sideEffects: false,
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      import: "./dist/index.mjs",
+      require: "./dist/index.js"
+    },
+    "./_shims/*": {
+      types: "./dist/_shims/*.d.ts",
+      import: "./dist/_shims/*.mjs",
+      require: "./dist/_shims/*.js"
+    }
+  },
+  files: [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  scripts: {
+    generate: "openapi-ts -i openapi.yaml -o src/generated -c @hey-api/client-fetch && npm run generate:client",
+    "generate:client": "npx tsx scripts/generate-client.ts",
+    build: "tsup src/index.ts --format cjs,esm --dts --clean",
+    dev: "tsup src/index.ts --format cjs,esm --dts --watch",
+    lint: "eslint src",
+    typecheck: "tsc --noEmit",
+    test: "vitest run",
+    "test:watch": "vitest",
+    prepublishOnly: "npm run build",
+    "fetch-spec": "curl -o openapi.yaml https://zernio.com/openapi.yaml"
+  },
+  keywords: [
+    "zernio",
+    "social-media",
+    "scheduling",
+    "api",
+    "sdk",
+    "instagram",
+    "tiktok",
+    "youtube",
+    "linkedin",
+    "twitter",
+    "x",
+    "facebook",
+    "pinterest",
+    "threads",
+    "bluesky",
+    "snapchat",
+    "telegram"
+  ],
+  author: "Zernio <support@zernio.com>",
+  license: "Apache-2.0",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/zernio-dev/zernio-node.git"
+  },
+  homepage: "https://zernio.com/docs/api",
+  bugs: {
+    url: "https://github.com/zernio-dev/zernio-node/issues"
+  },
+  engines: {
+    node: ">=18"
+  },
+  devDependencies: {
+    "@hey-api/client-fetch": "^0.6.0",
+    "@hey-api/openapi-ts": "^0.61.0",
+    "@types/node": "^20.11.0",
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
+    eslint: "^8.56.0",
+    tsup: "^8.0.1",
+    tsx: "^4.7.0",
+    typescript: "^5.3.3",
+    vitest: "^1.2.0",
+    yaml: "^2.3.4"
+  }
+};
+
 // node_modules/@hey-api/client-fetch/dist/index.js
 var U = /\{[^{}]+\}/g;
 var S = ({ allowReserved: t, name: r, value: e }) => {
@@ -2777,15 +2863,14 @@ var Zernio = class {
     this.baseURL = options.baseURL ?? "https://zernio.com/api";
     this._options = options;
     client.setConfig({
-      baseUrl: this.baseURL
+      baseUrl: this.baseURL,
+      headers: {
+        "User-Agent": `zernio-node/${package_default.version}`,
+        ...options.defaultHeaders ?? {}
+      }
     });
     client.interceptors.request.use((request) => {
       request.headers.set("Authorization", `Bearer ${this.apiKey}`);
-      if (options.defaultHeaders) {
-        for (const [key, value] of Object.entries(options.defaultHeaders)) {
-          request.headers.set(key, value);
-        }
-      }
       return request;
     });
     client.interceptors.response.use(async (response) => {

package/dist/index.mjs

@@ -2,6 +2,92 @@ var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
+// package.json
+var package_default = {
+  name: "@zernio/node",
+  version: "0.2.172",
+  description: "The official Node.js library for the Zernio API",
+  main: "dist/index.js",
+  module: "dist/index.mjs",
+  types: "dist/index.d.ts",
+  sideEffects: false,
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      import: "./dist/index.mjs",
+      require: "./dist/index.js"
+    },
+    "./_shims/*": {
+      types: "./dist/_shims/*.d.ts",
+      import: "./dist/_shims/*.mjs",
+      require: "./dist/_shims/*.js"
+    }
+  },
+  files: [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  scripts: {
+    generate: "openapi-ts -i openapi.yaml -o src/generated -c @hey-api/client-fetch && npm run generate:client",
+    "generate:client": "npx tsx scripts/generate-client.ts",
+    build: "tsup src/index.ts --format cjs,esm --dts --clean",
+    dev: "tsup src/index.ts --format cjs,esm --dts --watch",
+    lint: "eslint src",
+    typecheck: "tsc --noEmit",
+    test: "vitest run",
+    "test:watch": "vitest",
+    prepublishOnly: "npm run build",
+    "fetch-spec": "curl -o openapi.yaml https://zernio.com/openapi.yaml"
+  },
+  keywords: [
+    "zernio",
+    "social-media",
+    "scheduling",
+    "api",
+    "sdk",
+    "instagram",
+    "tiktok",
+    "youtube",
+    "linkedin",
+    "twitter",
+    "x",
+    "facebook",
+    "pinterest",
+    "threads",
+    "bluesky",
+    "snapchat",
+    "telegram"
+  ],
+  author: "Zernio <support@zernio.com>",
+  license: "Apache-2.0",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/zernio-dev/zernio-node.git"
+  },
+  homepage: "https://zernio.com/docs/api",
+  bugs: {
+    url: "https://github.com/zernio-dev/zernio-node/issues"
+  },
+  engines: {
+    node: ">=18"
+  },
+  devDependencies: {
+    "@hey-api/client-fetch": "^0.6.0",
+    "@hey-api/openapi-ts": "^0.61.0",
+    "@types/node": "^20.11.0",
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
+    eslint: "^8.56.0",
+    tsup: "^8.0.1",
+    tsx: "^4.7.0",
+    typescript: "^5.3.3",
+    vitest: "^1.2.0",
+    yaml: "^2.3.4"
+  }
+};
+
 // node_modules/@hey-api/client-fetch/dist/index.js
 var U = /\{[^{}]+\}/g;
 var S = ({ allowReserved: t, name: r, value: e }) => {
@@ -2746,15 +2832,14 @@ var Zernio = class {
     this.baseURL = options.baseURL ?? "https://zernio.com/api";
     this._options = options;
     client.setConfig({
-      baseUrl: this.baseURL
+      baseUrl: this.baseURL,
+      headers: {
+        "User-Agent": `zernio-node/${package_default.version}`,
+        ...options.defaultHeaders ?? {}
+      }
     });
     client.interceptors.request.use((request) => {
       request.headers.set("Authorization", `Bearer ${this.apiKey}`);
-      if (options.defaultHeaders) {
-        for (const [key, value] of Object.entries(options.defaultHeaders)) {
-          request.headers.set(key, value);
-        }
-      }
       return request;
     });
     client.interceptors.response.use(async (response) => {

package/package.json

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

package/src/client.ts

@@ -1,3 +1,4 @@
+import packageJson from '../package.json';
 import {
   client,
   activateSequence,
@@ -965,19 +966,21 @@ export class Zernio {
     this.baseURL = options.baseURL ?? 'https://zernio.com/api';
     this._options = options;
 
-    // Configure the generated client
+    // Configure the generated client. User-Agent and defaultHeaders are
+    // applied at config time (not via the interceptor) because Node 20's
+    // undici treats User-Agent as a forbidden header on already-constructed
+    // Request objects, silently dropping `headers.set('User-Agent', …)`.
     client.setConfig({
       baseUrl: this.baseURL,
+      headers: {
+        'User-Agent': `zernio-node/${packageJson.version}`,
+        ...(options.defaultHeaders ?? {}),
+      },
     });
 
     // Add auth interceptor
     client.interceptors.request.use((request) => {
       request.headers.set('Authorization', `Bearer ${this.apiKey}`);
-      if (options.defaultHeaders) {
-        for (const [key, value] of Object.entries(options.defaultHeaders)) {
-          request.headers.set(key, value);
-        }
-      }
       return request;
     });
 

package/src/generated/sdk.gen.ts

@@ -1932,9 +1932,9 @@ export const listInboxConversations = <ThrowOnError extends boolean = false>(opt
  * Create conversation
  * Initiate a new direct message conversation with a specified user. If a conversation already exists with the recipient, the message is added to the existing thread.
  *
- * Currently supported platforms: Twitter/X only. Other platforms will return PLATFORM_NOT_SUPPORTED.
+ * Supported platforms: X/Twitter, Bluesky, Reddit, and WhatsApp. Other platforms return PLATFORM_NOT_SUPPORTED. For WhatsApp, a conversation can only be started with an approved template (provide templateName, templateLanguage, and any templateParams) — freeform initial messages are not permitted by WhatsApp; a missing template returns TEMPLATE_REQUIRED.
  *
- * DM eligibility: Before sending, the endpoint checks if the recipient accepts DMs from your account (via the receives_your_dm field). If not, a 422 error with code DM_NOT_ALLOWED is returned. You can skip this check with skipDmCheck: true if you have already verified eligibility.
+ * DM eligibility (X/Twitter): Before sending, the endpoint checks if the recipient accepts DMs from your account (via the receives_your_dm field). If not, a 422 error with code DM_NOT_ALLOWED is returned. You can skip this check with skipDmCheck: true if you have already verified eligibility.
  *
  * X API tier requirement: DM write endpoints require X API Pro tier ($5,000/month) or Enterprise access. This applies to BYOK (Bring Your Own Key) users who provide their own X API credentials.
  *

package/src/generated/types.gen.ts

@@ -2236,6 +2236,14 @@ export type PostAnalytics = {
     saves?: number;
     clicks?: number;
     views?: number;
+    /**
+     * Instagram Reels only: average watch time per play, in milliseconds. 0 for non-Reels media and other platforms.
+     */
+    igReelsAvgWatchTime?: number;
+    /**
+     * Instagram Reels only: total watch time including replays, in milliseconds. 0 for non-Reels media and other platforms.
+     */
+    igReelsVideoViewTotalTime?: number;
     engagementRate?: number;
     lastUpdated?: string;
 };
@@ -10537,21 +10545,33 @@ export type CreateInboxConversationData = {
          */
         accountId: string;
         /**
-         * Twitter numeric user ID of the recipient. Provide either this or participantUsername.
+         * Recipient identifier. For X this is the numeric user ID; for WhatsApp, the recipient phone number in international format (digits, country code included). Provide either this or participantUsername.
          */
         participantId?: string;
         /**
-         * Twitter username (with or without @) of the recipient. Resolved to a user ID via lookup. Provide either this or participantId.
+         * Recipient handle/username — an X or Bluesky handle (with or without @) or a Reddit username (with or without u/). Resolved via lookup. Provide either this or participantId.
          */
         participantUsername?: string;
         /**
-         * Text content of the message. At least one of message or attachment is required.
+         * Text content of the message. At least one of message, attachment, or (for WhatsApp) templateName is required.
          */
         message?: string;
         /**
-         * Skip the receives_your_dm eligibility check before sending. Use if you have already verified the recipient accepts DMs.
+         * X/Twitter only. Skip the receives_your_dm eligibility check before sending. Use if you have already verified the recipient accepts DMs.
          */
         skipDmCheck?: boolean;
+        /**
+         * WhatsApp only. Name of the approved template to start the conversation with (required for WhatsApp).
+         */
+        templateName?: string;
+        /**
+         * WhatsApp only. Template language code (e.g. en_US).
+         */
+        templateLanguage?: string;
+        /**
+         * WhatsApp only. Body variable values, in order, substituted into the template body ({{1}}, {{2}}, ...).
+         */
+        templateParams?: Array<(string)>;
     };
 };