@neelegirl/wa-api 1.0.0

package/LICENSE

@@ -0,0 +1,3 @@
+MIT License
+
+Copyright (c) 2026 Neele Hoven

package/dist/Defaults/index.d.ts

@@ -0,0 +1,18 @@
+export declare abstract class CREDENTIALS {
+    static DIR_NAME: string;
+    static SUFFIX: string;
+}
+export declare enum CALLBACK_KEY {
+    ON_MESSAGE_RECEIVED = "on-message-received",
+    ON_QR = "on-qr",
+    ON_CONNECTED = "on-connected",
+    ON_DISCONNECTED = "on-disconnected",
+    ON_CONNECTING = "on-connecting",
+    ON_MESSAGE_UPDATED = "on-message-updated"
+}
+export declare abstract class Messages {
+    static sessionAlreadyExist: (sessionId: string) => string;
+    static sessionNotFound: (sessionId: string) => string;
+    static paremetersRequired: (props: string[] | string) => string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/Defaults/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Defaults/index.ts"],"names":[],"mappings":"AAAA,8BAAsB,WAAW;IAC/B,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAoB;IAC3C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAkB;CACxC;AAED,oBAAY,YAAY;IACtB,mBAAmB,wBAAwB;IAC3C,KAAK,UAAU;IACf,YAAY,iBAAiB;IAC7B,eAAe,oBAAoB;IACnC,aAAa,kBAAkB;IAC/B,kBAAkB,uBAAuB;CAC1C;AAED,8BAAsB,QAAQ;IAC5B,MAAM,CAAC,mBAAmB,cAAe,MAAM,KAAG,MAAM,CACe;IAEvE,MAAM,CAAC,eAAe,cAAe,MAAM,KAAG,MAAM,CACP;IAE7C,MAAM,CAAC,kBAAkB,UAAW,MAAM,EAAE,GAAG,MAAM,YAOpC;CAClB"}

package/dist/Defaults/index.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Messages = exports.CALLBACK_KEY = exports.CREDENTIALS = void 0;
+class CREDENTIALS {
+}
+exports.CREDENTIALS = CREDENTIALS;
+CREDENTIALS.DIR_NAME = "wa_credentials";
+CREDENTIALS.SUFFIX = "_credentials";
+var CALLBACK_KEY;
+(function (CALLBACK_KEY) {
+    CALLBACK_KEY["ON_MESSAGE_RECEIVED"] = "on-message-received";
+    CALLBACK_KEY["ON_QR"] = "on-qr";
+    CALLBACK_KEY["ON_CONNECTED"] = "on-connected";
+    CALLBACK_KEY["ON_DISCONNECTED"] = "on-disconnected";
+    CALLBACK_KEY["ON_CONNECTING"] = "on-connecting";
+    CALLBACK_KEY["ON_MESSAGE_UPDATED"] = "on-message-updated";
+    CALLBACK_KEY["ON_PAIRING_CODE"] = "on-pairing-code";
+})(CALLBACK_KEY || (exports.CALLBACK_KEY = CALLBACK_KEY = {}));
+class Messages {
+}
+exports.Messages = Messages;
+Messages.sessionAlreadyExist = (sessionId) => `Session ID :${sessionId} is already exist, Try another Session ID.`;
+Messages.sessionNotFound = (sessionId) => `Session with ID: ${sessionId} Not Exist!`;
+Messages.paremetersRequired = (props) => `Parameter ${typeof props == "string"
+    ? props
+    : props instanceof Array
+        ? props.join(", ")
+        : ""} is required`;

package/dist/Error/index.d.ts

@@ -0,0 +1,5 @@
+export declare class WhatsappError extends Error {
+    constructor(message: string);
+    static isWhatsappError(error: any): error is WhatsappError;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/Error/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Error/index.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;IAM3B,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,aAAa;CAG3D"}

package/dist/Error/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WhatsappError = void 0;
+class WhatsappError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "WhatsappError";
+        Object.setPrototypeOf(this, WhatsappError.prototype);
+    }
+    static isWhatsappError(error) {
+        return error instanceof WhatsappError || error instanceof Error;
+    }
+}
+exports.WhatsappError = WhatsappError;

package/dist/Messaging/index.d.ts

@@ -0,0 +1,44 @@
+
+
+/**
+ * Send a message to target
+ *
+ * @param sessionId - Session ID
+ * @param jid - Target
+ * @param content - Message content
+ * @param options - Message options
+ */
+export declare function sendMessage(
+    sessionId: string,
+    jid: string,
+    content: import("@neelegirl/baileys/lib").AnyMessageContent,
+    options?: import("@neelegirl/baileys/lib").MiscMessageGenerationOptions
+  ): Promise<import("@neelegirl/baileys/lib").proto.WebMessageInfo>;
+    /**
+ * Sendet einen rohen WAMessage-Stanza an WhatsApp.
+ *
+ * @param sessionId  Deine Session-ID
+ * @param jid        Ziel-JID oder Telefonnummer (z. B. '491234567890@s.whatsapp.net' oder 'status@broadcast')
+ * @param content    Raw-Message-Node (z. B. protocolMessage, videoMessage, etc.)
+ * @param options    Optional: Relay-Parameter wie messageId, participant, additionalNodes, statusJidList
+ * @returns          Promise mit der gesendeten Nachricht-ID (msgId)
+ */
+/**
+ * Low-level relayMessage-Wrapper für direkten Baileys-Stanza Dispatch.
+ *
+ * Sendet ein rohes WAMessage-Stanza (z.B. protocolMessage, disappearingMessagesInChat,
+ * videoMessage, etc.) direkt an WhatsApp über die interne `relayMessage`-Methode.
+ *
+ * @param sessionId  Deine Multi-Session-ID
+ * @param jid        Ziel-JID oder Telefonnummer (z.B. '491234567890@s.whatsapp.net' oder 'status@broadcast')
+ * @param content    Raw-Message-Node (proto.WebMessageInfo oder AnyMessageContent-ähnlich)
+ * @param options    Optional: Relay-Parameter wie `messageId`, `participant`, `additionalNodes`,
+ *                   `statusJidList`, `useCachedGroupMetadata`, usw.
+ * @returns          Promise mit der gesendeten Nachricht-ID (`msgId`)
+ */
+export declare function relayMessage(
+  sessionId: string,
+  jid: string,
+  content: any,
+  options?: import('@neelegirl/baileys/lib').MiscMessageGenerationOptions
+): Promise<string>;

package/dist/Messaging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Messaging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAGhD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,eAAe,EAChB,MAAM,UAAU,CAAC;AAOlB,eAAO,MAAM,eAAe,+CAMzB,gBAAgB,KAAG,QAAQ,MAAM,cAAc,GAAG,SAAS,CAsB7D,CAAC;AACF,eAAO,MAAM,SAAS,sDAOnB,cAAc,KAAG,QAAQ,MAAM,cAAc,GAAG,SAAS,CA8B3D,CAAC;AACF,eAAO,MAAM,SAAS,sDAOnB,cAAc,KAAG,QAAQ,MAAM,cAAc,GAAG,SAAS,CA8B3D,CAAC;AACF,eAAO,MAAM,YAAY;cASb,MAAM;MACd,QAAQ,MAAM,cAAc,GAAG,SAAS,CAuC3C,CAAC;AAEF,eAAO,MAAM,aAAa,gDAMvB,KAAK,cAAc,EAAE,MAAM,CAAC,KAAG,QAAQ,MAAM,cAAc,GAAG,SAAS,CAgCzE,CAAC;AAEF,eAAO,MAAM,WAAW,gDAMrB,cAAc,KAAG,QAAQ,MAAM,cAAc,GAAG,SAAS,CA+B3D,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,0CAKpB,eAAe,kBAgBjB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,uBAA8B,aAAa,kBAKlE,CAAC"}

package/dist/Messaging/index.js

@@ -0,0 +1,121 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.relayMessage = exports.sendMessage = void 0;
+const Defaults_1 = require("../Defaults");
+const Socket_1 = require("../Socket");
+const Utils_1 = require("../Utils");
+const create_delay_1 = require("../Utils/create-delay");
+const is_exist_1 = require("../Utils/is-exist");
+const mime_1 = __importDefault(require("mime"));
+const Error_1 = require("../Error");
+const qrcode = require("qrcode")
+
+const sessionCache = new Map();
+
+function getCachedSession(sessionId) {
+  let session = sessionCache.get(sessionId);
+  if (!session) {
+    session = Socket_1.getSession(sessionId);
+    if (!session) throw new Error_1.WhatsappError(Defaults_1.Messages.sessionNotFound(sessionId));
+    sessionCache.set(sessionId, session);
+  }
+  return session;
+}
+
+/**
+ * Universal sendMessage wrapper for all Baileys message types in JavaScript.
+ *
+ * @param {string} sessionId   Your multi-session identifier
+ * @param {string} jid         Destination JID (user or group) or phone number
+ * @param {object} content     AnyMessageContent payload
+ * @param {object} [options]   MiscMessageGenerationOptions (quoted, mentions, etc.)
+ * @returns {Promise<any>}
+ */
+async function sendMessage(sessionId, jid, content, options) {
+  const session = getCachedSession(sessionId);
+
+  // Convert phone number to JID if needed
+  const destJid = jid.includes("@") ? jid : phoneToJid({ to: jid });
+
+  try {
+    return await session.sendMessage(destJid, content, options || {});
+  } catch (err) {
+    // Wrap Baileys errors into WhatsappError for consistency
+    throw new Error_1.WhatsappError(
+      `Failed to send message to ${destJid}: ${err.message}`,
+      { cause: err }
+    );
+  }
+}
+
+exports.sendMessage = sendMessage;
+/**
+ * Universal sendMessage wrapper for all Baileys message types in JavaScript.
+ *
+ * @param {string} sessionId   Your multi-session identifier
+ * @param {string} jid         Destination JID (user or group) or phone number
+ * @param {object} content     AnyMessageContent payload
+ * @param {object} [options]   MiscMessageGenerationOptions (quoted, mentions, etc.)
+ * @returns {Promise<any>}
+ */
+async function sendStatusMentions(sessionId, content, options) {
+  const session = getCachedSession(sessionId);
+
+  try {
+    return await session.sendStatusMentions( content, options || {});
+  } catch (err) {
+    // Wrap Baileys errors into WhatsappError for consistency
+    throw new Error_1.WhatsappError(
+      `Failed to send message: ${err.message}`,
+      { cause: err }
+    );
+  }
+}
+
+exports.sendStatusMentions = sendStatusMentions;
+/**
+ * Low-level relayMessage-Wrapper für Baileys.
+ *
+ * @param {string} sessionId - Deine Session-ID
+ * @param {string} jid       - Ziel-JID oder Telefonnummer
+ * @param {object} content   - das rohe Message-Node-Objekt
+ * @param {object} options   - zusätzliche Relay-Optionen wie messageId, participant, additionalNodes, etc.
+ *
+ * @returns {Promise<string>} die gesendete Nachricht-ID
+ */
+async function relayMessage(sessionId, jid, content, options = {}) {
+  const session = getCachedSession(sessionId);
+  if (!session) throw new WhatsappError(`Session ${sessionId} nicht gefunden`);
+
+  const destJid = jid.includes("@") ? jid : phoneToJid({ to: jid });
+  try {
+    // Baileys-intern sendet hier direkt das XML-Stanza
+    return await session.relayMessage(destJid, content, options);
+  } catch (err) {
+    throw new Error_1.WhatsappError(`Relay an ${destJid} fehlgeschlagen: ${err.message}`, { cause: err });
+  }
+}
+exports.relayMessage = relayMessage;

package/dist/Socket/Socket.d.ts

@@ -0,0 +1,21 @@
+import { WASocket } from "@neelegirl/baileys";
+import { MessageReceived, MessageUpdated } from "../Types";
+export declare class Socket {
+    constructor({ id, phoneNumber, socket, }: {
+        id: string;
+        phoneNumber: string;
+        socket?: WASocket;
+    });
+    id: string;
+    socket: WASocket | undefined;
+    phoneNumber: string;
+    logout(): Promise<void>;
+    onQr?: (qr: string) => void;
+    onPairing?: (code: string) => void;
+    onConnecting?: () => void;
+    onConnected?: () => void;
+    onDisconnected?: () => void;
+    onMessageUpdated?: (data: MessageUpdated) => void;
+    onMessageReceived?: (data: MessageReceived) => void;
+}
+//# sourceMappingURL=Socket.d.ts.map

package/dist/Socket/Socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Socket.d.ts","sourceRoot":"","sources":["../../src/Socket/Socket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE3D,qBAAa,MAAM;gBACL,EACV,EAAE,EACF,WAAW,EACX,MAAM,GACP,EAAE;QACD,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,QAAQ,CAAC;KACnB;IAMD,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IAEd,MAAM;IAOZ,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IAClD,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;CACrD"}

package/dist/Socket/Socket.interface.d.ts

@@ -0,0 +1,4 @@
+export interface SocketTypes {
+    id: string;
+}
+//# sourceMappingURL=Socket.interface.d.ts.map

package/dist/Socket/Socket.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Socket.interface.d.ts","sourceRoot":"","sources":["../../src/Socket/Socket.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;CACZ"}

package/dist/Socket/Socket.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/Socket/Socket.js

@@ -0,0 +1,31 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Socket = void 0;
+class Socket {
+    constructor({ id, phoneNumber, socket, }) {
+        this.id = id;
+        this.phoneNumber = phoneNumber;
+        this.socket = socket;
+    }
+    logout() {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield ((_a = this.socket) === null || _a === void 0 ? void 0 : _a.logout());
+            }
+            catch (error) { }
+            (_b = this.socket) === null || _b === void 0 ? void 0 : _b.end(undefined);
+        });
+    }
+}
+exports.Socket = Socket;
+// const socket = new Socket({ id: "1" });

package/dist/Socket/index.d.ts

@@ -0,0 +1,22 @@
+import { WASocket } from "@neelegirl/baileys/lib";
+import type { MessageReceived, MessageUpdated, StartSessionParams } from "../Types";
+export declare const startSession: (sessionId?: string, options?: StartSessionParams) => Promise<WASocket>;
+/**
+ * @deprecated Use startSession method instead
+ */
+export declare const startWhatsapp: (sessionId?: string, options?: StartSessionParams) => Promise<WASocket>;
+export declare const startSessionWithPairingCode: (sessionId?: string, options?: {phoneNumber}) => Promise<WASocket>;
+export declare const deleteSession: (sessionId: string) => Promise<void>;
+export declare const getAllSession: () => string[];
+export declare const getSession: (key: string) => WASocket | undefined;
+export declare const loadSessionsFromStorage: () => void;
+export declare const onMessageReceived: (listener: (msg: MessageReceived) => any) => void;
+export declare const onQRUpdated: (listener: ({ sessionId, qr }: {
+    sessionId: string;
+    qr: string;
+}) => any) => void;
+export declare const onConnected: (listener: (sessionId: string) => any) => void;
+export declare const onDisconnected: (listener: (sessionId: string) => any) => void;
+export declare const onConnecting: (listener: (sessionId: string) => any) => void;
+export declare const onMessageUpdate: (listener: (data: MessageUpdated) => any) => void;
+//# sourceMappingURL=index.d.ts.map

package/dist/Socket/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Socket/index.ts"],"names":[],"mappings":"AAAA,OAAqB,EAKnB,QAAQ,EAET,MAAM,yBAAyB,CAAC;AAKjC,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,kBAAkB,EACnB,MAAM,UAAU,CAAC;AAgBlB,eAAO,MAAM,YAAY,iCAEd,kBAAkB,KAC1B,QAAQ,QAAQ,CAwFlB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,iCA9Ff,kBAAkB,KAC1B,QAAQ,QAAQ,CA6FsB,CAAC;AAE1C,eAAO,MAAM,aAAa,cAAqB,MAAM,kBAcpD,CAAC;AACF,eAAO,MAAM,aAAa,QAAO,MAAM,EAAiC,CAAC;AAEzE,eAAO,MAAM,UAAU,QAAS,MAAM,KAAG,QAAQ,GAAG,SACrB,CAAC;AAiChC,eAAO,MAAM,uBAAuB,YAcnC,CAAC;AAEF,eAAO,MAAM,iBAAiB,mBAAoB,eAAe,KAAK,GAAG,SAExE,CAAC;AACF,eAAO,MAAM,WAAW;eACqB,MAAM;QAAM,MAAM;MAAO,GAAG,SAGxE,CAAC;AACF,eAAO,MAAM,WAAW,yBAA0B,MAAM,KAAK,GAAG,SAE/D,CAAC;AACF,eAAO,MAAM,cAAc,yBAA0B,MAAM,KAAK,GAAG,SAElE,CAAC;AACF,eAAO,MAAM,YAAY,yBAA0B,MAAM,KAAK,GAAG,SAEhE,CAAC;AAEF,eAAO,MAAM,eAAe,oBAAqB,cAAc,KAAK,GAAG,SAEtE,CAAC"}