@glitchgrab/whatsapp 0.1.0

package/dist/types-BKOEzRzb.d.ts

@@ -0,0 +1,97 @@
+/** Shared shapes. Mirrors the `/api/v1/wa` responses. */
+type WaTemplateCategory = "MARKETING" | "UTILITY" | "AUTHENTICATION" | "SERVICE";
+type WaTemplateStatus = "DRAFT" | "PENDING" | "APPROVED" | "REJECTED" | "PAUSED" | "DISABLED";
+type WaMessageDirection = "INBOUND" | "OUTBOUND";
+type WaMessageStatus = "QUEUED" | "SENT" | "DELIVERED" | "READ" | "FAILED";
+type WaConversationStatus = "OPEN" | "SNOOZED" | "CLOSED";
+type WaMatchType = "EXACT" | "CONTAINS" | "STARTS_WITH" | "REGEX" | "ANY";
+/**
+ * Every failure carries a stable `code`, so callers branch on that rather than
+ * matching on a message that may be reworded.
+ */
+type WaErrorCode = "UNAUTHORIZED" | "PLATFORM_INACTIVE" | "TENANT_NOT_FOUND" | "INSUFFICIENT_FUNDS" | "NO_PRICE_RULE" | "INVALID_AMOUNT" | "DUPLICATE_REQUEST" | "INTERNAL";
+declare class WhatsappError extends Error {
+    readonly code: WaErrorCode | string;
+    readonly status: number;
+    readonly detail?: Record<string, unknown> | undefined;
+    constructor(code: WaErrorCode | string, message: string, status: number, detail?: Record<string, unknown> | undefined);
+    /** The owner has run out of balance. `detail.shortfallPaise` says by how much. */
+    get isInsufficientFunds(): boolean;
+}
+interface WaNumber {
+    phoneNumberId: string;
+    displayNumber: string;
+    verifiedName: string;
+    status: "PENDING" | "VERIFIED" | "REGISTERED" | "DISCONNECTED";
+    qualityRating?: string | null;
+    messagingLimitTier?: string | null;
+}
+interface WaMessage {
+    id: string;
+    direction: WaMessageDirection;
+    status: WaMessageStatus;
+    contactPhone?: string;
+    category?: WaTemplateCategory | null;
+    payload: unknown;
+    error?: string | null;
+    sentAt?: string | null;
+    deliveredAt?: string | null;
+    readAt?: string | null;
+    createdAt: string;
+}
+interface WaConversation {
+    id: string;
+    contactPhone: string;
+    contactName?: string | null;
+    windowExpiresAt?: string | null;
+    /** Whether free-form text is legal right now. Computed server-side. */
+    windowOpen: boolean;
+    lastInboundAt?: string | null;
+    lastOutboundAt?: string | null;
+    optedOut: boolean;
+    status: WaConversationStatus;
+    assignedAgentId?: string | null;
+    unreadCount: number;
+    updatedAt: string;
+    lastMessage?: WaMessage | null;
+}
+interface WaTemplate {
+    id: string;
+    name: string;
+    language: string;
+    category: WaTemplateCategory;
+    status: WaTemplateStatus;
+    rejectionReason?: string | null;
+    components?: unknown;
+    submittedAt?: string | null;
+    lastSyncedAt?: string | null;
+}
+interface WaAgent {
+    id: string;
+    externalAgentId: string;
+    name: string;
+    email?: string | null;
+    role: "AGENT" | "ADMIN";
+    active: boolean;
+}
+interface WaBalance {
+    balancePaise: number;
+    heldPaise: number;
+    spendablePaise: number;
+}
+interface WaSendResult {
+    messageId: string;
+    metaMessageId: string;
+    status: "SENT";
+    category: WaTemplateCategory;
+    tenantPricePaise: number;
+    tenantBalancePaise: number;
+}
+interface WaSignupLaunch {
+    appId: string;
+    configId: string;
+    scopes: string[];
+    state: string;
+}
+
+export { type WaAgent as W, type WaBalance as a, type WaConversation as b, type WaConversationStatus as c, type WaErrorCode as d, type WaMatchType as e, type WaMessage as f, type WaMessageDirection as g, type WaMessageStatus as h, type WaNumber as i, type WaSendResult as j, type WaSignupLaunch as k, type WaTemplate as l, type WaTemplateCategory as m, type WaTemplateStatus as n, WhatsappError as o };

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@glitchgrab/whatsapp",
+  "version": "0.1.0",
+  "description": "WhatsApp Business messaging for SaaS products \u2014 connect a customer's own number, send templates, and run a shared inbox.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.mjs",
+      "require": "./dist/react.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^19",
+    "react": "^19",
+    "tsup": "^8",
+    "typescript": "^5",
+    "vitest": "^4.1.3"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Navibyte-Innovations-Pvt-Ltd/glitchgrab.git",
+    "directory": "packages/sdk-whatsapp"
+  },
+  "license": "MIT",
+  "keywords": [
+    "whatsapp",
+    "whatsapp-business",
+    "messaging",
+    "saas",
+    "multi-tenant"
+  ]
+}