@zindua/sdk 1.4.0 → 1.4.1

package/README.md

@@ -89,7 +89,7 @@ Guide: [WhatsApp anti-ban Guardian](https://zindua.run/whatsapp/anti-ban)
 ### Upgrade (already installed?)
 
 ```bash
-npm install @zindua/sdk@1.4.0
+npm install @zindua/sdk@1.4.1
 ```
 
 ```typescript

package/dist/client.d.ts

@@ -1,6 +1,6 @@
 export type SendChannel = "email" | "whatsapp";
 export type ZinduaSendOptions = {
-    to: string;
+    to: string | string[];
     template: string;
     channel?: SendChannel;
     lang?: string;
@@ -26,6 +26,9 @@ export type ZinduaEmailVerifyResult = {
     suppressed: boolean;
     suppressionReason: string | null;
     deliverable: boolean;
+    catchAll?: boolean;
+    headline?: string;
+    youShould?: string;
 };
 export type ZinduaClientOptions = {
     apiKey: string;
@@ -149,6 +152,8 @@ export type ZinduaSendResult = {
     channel: SendChannel;
     status: string;
     logId: string;
+    logIds?: string[];
+    billed?: number;
     langUsed?: string;
     langFallback?: boolean;
     testMode?: boolean;
@@ -208,7 +213,9 @@ export declare class Zindua {
                 expiresAt: string;
             };
         }>;
-        respond: (challengeId: string, value: string) => Promise<{
+        respond: (challengeId: string, value: string, options?: {
+            userExternalId?: string;
+        }) => Promise<{
             ok: boolean;
             status: string;
             error?: string;
@@ -274,7 +281,9 @@ export declare class Zindua {
                 expiresAt: string;
             };
         }>;
-        respond: (challengeId: string, value: string) => Promise<{
+        respond: (challengeId: string, value: string, options?: {
+            userExternalId?: string;
+        }) => Promise<{
             ok: boolean;
             status: string;
             error?: string;

package/dist/client.js

@@ -4,7 +4,7 @@ exports.Zindua = void 0;
 const errors_1 = require("./errors");
 const validate_1 = require("./validate");
 const whatsapp_anti_ban_1 = require("./whatsapp-anti-ban");
-const SDK_VERSION = "1.4.0";
+const SDK_VERSION = "1.4.1";
 const USER_AGENT = `Zindua-JS/${SDK_VERSION}`;
 function buildPayload(options, channel) {
     const to = (0, validate_1.validateRecipient)(options.to, channel);
@@ -120,8 +120,8 @@ class Zindua {
         getStatus: async (challengeId) => {
             return this.request("GET", `challenges/${encodeURIComponent(challengeId)}`);
         },
-        respond: async (challengeId, value) => {
-            return this.request("POST", `challenges/${encodeURIComponent(challengeId)}/respond`, { value });
+        respond: async (challengeId, value, options) => {
+            return this.request("POST", `challenges/${encodeURIComponent(challengeId)}/respond`, { value, userExternalId: options?.userExternalId });
         },
         /**
          * SSE listener for challenge status (requires API key — server-side or trusted runtime).
@@ -360,6 +360,9 @@ class Zindua {
             suppressed: Boolean(data.suppressed),
             suppressionReason: typeof data.suppressionReason === "string" ? data.suppressionReason : null,
             deliverable: Boolean(data.deliverable),
+            catchAll: Boolean(data.catchAll),
+            headline: typeof data.headline === "string" ? data.headline : undefined,
+            youShould: typeof data.youShould === "string" ? data.youShould : undefined,
         };
     }
     /** Delivery status for a logId returned by send() (GET /logs/{logId}). */
@@ -398,6 +401,10 @@ class Zindua {
             channel: (data.channel === "whatsapp" ? "whatsapp" : "email"),
             status: typeof data.status === "string" ? data.status : "queued",
             logId: data.logId,
+            logIds: Array.isArray(data.logIds)
+                ? data.logIds.filter((id) => typeof id === "string")
+                : undefined,
+            billed: typeof data.billed === "number" ? data.billed : undefined,
             langUsed: typeof data.langUsed === "string" ? data.langUsed : undefined,
             langFallback: typeof data.langFallback === "boolean" ? data.langFallback : undefined,
             testMode: typeof data.testMode === "boolean" ? data.testMode : undefined,

package/dist/validate.d.ts

@@ -16,7 +16,7 @@ export declare function validateApiKey(apiKey: string): string;
 export declare function validateBaseUrl(raw: string): string;
 export declare function resolveBaseUrl(explicit?: string): string;
 export declare function validateTemplateSlug(template: string): string;
-export declare function validateRecipient(to: string, channel: "email" | "whatsapp"): string;
+export declare function validateRecipient(to: string | string[], channel: "email" | "whatsapp"): string | string[];
 export declare function validateChannel(channel?: string): "email" | "whatsapp";
 export declare function validateLang(lang?: string): string | undefined;
 export declare function sanitizeVariables(variables?: Record<string, string>): Record<string, string> | undefined;

package/dist/validate.js

@@ -104,6 +104,20 @@ function validateTemplateSlug(template) {
     return slug;
 }
 function validateRecipient(to, channel) {
+    const parts = (Array.isArray(to) ? to : [to])
+        .flatMap((value) => String(value).split(/[,;]/))
+        .map((value) => value.trim())
+        .filter(Boolean);
+    if (parts.length === 0) {
+        throw new errors_1.ZinduaError("to is required and must be under 320 characters.", {
+            status: 0,
+            code: "MISSING_FIELDS",
+        });
+    }
+    const validated = parts.map((part) => validateOneRecipient(part, channel));
+    return validated.length === 1 ? validated[0] : validated;
+}
+function validateOneRecipient(to, channel) {
     const recipient = to.trim();
     if (!recipient || recipient.length > exports.LIMITS.maxToLength) {
         throw new errors_1.ZinduaError("to is required and must be under 320 characters.", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zindua/sdk",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "Official Zindua SDK for Node.js — transactional email, WhatsApp, template upsert/render via /api/v1.",
   "author": "Zindua",
   "license": "MIT",