@neelegirl/wa-api 1.6.8 → 1.6.9

package/dist/Messaging/index.d.ts

@@ -1,28 +1,44 @@
-/**
- * Send a message to a chat JID or phone number.
- */
-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>;
+
 
 /**
- * Send status mentions using the current session socket.
+ * 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)
  */
-export declare function sendStatusMentions(
-  sessionId: string,
-  content: any,
-  options?: import("@neelegirl/baileys/lib").MiscMessageGenerationOptions
-): Promise<any>;
-
 /**
- * Low-level relayMessage wrapper.
+ * 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>;
+  options?: import('@neelegirl/baileys/lib').MiscMessageGenerationOptions
+): Promise<string>;

package/dist/Socket/index.d.ts

@@ -1,45 +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>;
-
-export declare const onimaii: (sessionId: string, connect: (config: any) => WASocket) => Promise<WASocket>;
-
-export declare const startSessionWithPairingCode: (
-  sessionId?: string,
-  options?: {
-    phoneNumber: string;
-  },
-  pairingCode?: string
-) => Promise<WASocket>;
-
 /**
- * @deprecated Use startSession method instead.
+ * @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 getAllSessionData: () => Record<string, WASocket | undefined>;
-
-export declare const loadSessionsFromStorage: () => Promise<string[]>;
-
-export declare const sock: (conn: any) => any;
-
+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 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: (sessionId: string, data: MessageUpdated) => any) => void;
-
-export declare const onPairingCode: (listener: (sessionId: string, code: string) => any) => void;
+export declare const onMessageUpdate: (listener: (data: MessageUpdated) => any) => void;
+//# sourceMappingURL=index.d.ts.map

package/dist/Socket/index.js

@@ -15,6 +15,7 @@ const message_status_1 = require("../Utils/message-status");
 const sessions = new Map();
 const callback = new Map();
 const retryCount = new Map();
+const TERMINAL_QR_FORCE_ENV = String(process.env.ONIMAI_FORCE_TERMINAL_QR || "").trim();
 
 let CURRENT_WA_API_VERSION = "1.6.5";
 let waApiUpdateCheckDone = false;
@@ -95,6 +96,52 @@ const checkWaApiUpdate = () => {
     });
 };
 
+const getSessionCredsDir = (sessionId) =>
+    path_1.resolve(Defaults_1.CREDENTIALS.DIR_NAME, sessionId + Defaults_1.CREDENTIALS.SUFFIX);
+
+const readStoredSessionCreds = (sessionId) => {
+    try {
+        const credsPath = path_1.join(getSessionCredsDir(sessionId), "creds.json");
+        if (!fs_1.existsSync(credsPath)) {
+            return null;
+        }
+        const raw = fs_1.readFileSync(credsPath, "utf8");
+        return JSON.parse(raw || "{}");
+    }
+    catch (_) {
+        return null;
+    }
+};
+
+const hasStoredLinkedSessionCreds = (sessionId) => {
+    try {
+        const dir = getSessionCredsDir(sessionId);
+        if (!fs_1.existsSync(dir) || !fs_1.lstatSync(dir).isDirectory()) {
+            return false;
+        }
+        const creds = readStoredSessionCreds(sessionId);
+        const me = creds?.me || {};
+        if (creds?.registered === true || me?.id || me?.lid) {
+            return true;
+        }
+        const files = fs_1.readdirSync(dir);
+        return files.some((file) => /^(session-|sender-key-|app-state-sync-key-|pre-key-)/i.test(String(file || "").trim()));
+    }
+    catch (_) {
+        return false;
+    }
+};
+
+const shouldPrintQrInTerminal = (sessionId, options = {}) => {
+    if (TERMINAL_QR_FORCE_ENV === "1") {
+        return true;
+    }
+    if (TERMINAL_QR_FORCE_ENV === "0") {
+        return false;
+    }
+    return true;
+};
+
 const emitMessageUpsert = (sessionId, msg) => {
     msg.sessionId = sessionId;
     msg.saveImage = (path) => (0, save_media_1.saveImageHandler)(msg, path);
@@ -164,11 +211,11 @@ const createSessionSocket = async (sessionId, options = {}, retryStarter) => {
     const logger = (0, pino_1)({ level: "silent" });
     const { version } = await (0, baileys_1.fetchLatestBaileysVersion)();
     const { state, saveCreds } = await (0, baileys_1.useMultiFileAuthState)(
-        path_1.resolve(Defaults_1.CREDENTIALS.DIR_NAME, sessionId + Defaults_1.CREDENTIALS.SUFFIX)
+        getSessionCredsDir(sessionId)
     );
     const sock = (0, baileys_1.default)({
         version,
-        printQRInTerminal: !!options.printQR,
+        printQRInTerminal: shouldPrintQrInTerminal(sessionId, options),
         auth: state,
         logger,
         markOnlineOnConnect: false,
@@ -214,7 +261,7 @@ const startSession = async (sessionId = "mysession", options = { printQR: true }
     if (isSessionExistAndRunning(sessionId)) {
         throw new Error_1.WhatsappError(Defaults_1.Messages.sessionAlreadyExist(sessionId));
     }
-    const starter = () => createSessionSocket(sessionId, { printQR: options?.printQR !== false }, starter);
+    const starter = () => createSessionSocket(sessionId, { ...options, printQR: options?.printQR !== false }, starter);
     return starter();
 };
 exports.startSession = startSession;
@@ -229,11 +276,11 @@ const onimaii = async (sessionId = "mysession", connect) => {
     const logger = (0, pino_1)({ level: "silent" });
     const { version } = await (0, baileys_1.fetchLatestBaileysVersion)();
     const { state, saveCreds } = await (0, baileys_1.useMultiFileAuthState)(
-        path_1.resolve(Defaults_1.CREDENTIALS.DIR_NAME, sessionId + Defaults_1.CREDENTIALS.SUFFIX)
+        getSessionCredsDir(sessionId)
     );
     const sock = connect({
         version,
-        printQRInTerminal: true,
+        printQRInTerminal: shouldPrintQrInTerminal(sessionId, { printQR: true }),
         auth: state,
         logger,
         markOnlineOnConnect: false,
@@ -319,13 +366,14 @@ const loadSessionsFromStorage = async () => {
         if (!stat.isDirectory()) {
             continue;
         }
-        const underscoreIndex = entry.indexOf("_");
-        const sessionId = underscoreIndex > 0 ? entry.slice(0, underscoreIndex) : entry;
+        const sessionId = entry.endsWith(Defaults_1.CREDENTIALS.SUFFIX)
+            ? entry.slice(0, -Defaults_1.CREDENTIALS.SUFFIX.length)
+            : entry;
         if (!shouldLoadSession(sessionId)) {
             continue;
         }
         try {
-            await (0, exports.startSession)(sessionId);
+            await (0, exports.startSession)(sessionId, { printQR: false });
             loadedSessions.push(sessionId);
         }
         catch (_) {
@@ -376,4 +424,4 @@ exports.onMessageUpdate = onMessageUpdate;
 const onPairingCode = (listener) => {
     callback.set(Defaults_1.CALLBACK_KEY.ON_PAIRING_CODE, listener);
 };
-exports.onPairingCode = onPairingCode;
+exports.onPairingCode = onPairingCode;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neelegirl/wa-api",
-  "version": "1.6.8",
+  "version": "1.6.9",
   "description": "Multi-session WhatsApp wrapper built on top of @neelegirl/baileys",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -13,8 +13,7 @@
     "url": "https://github.com/neelegirl/wa-api/issues"
   },
   "files": [
-    "dist/**/*",
-    "readme.md"
+    "dist/**/*"
   ],
   "scripts": {
     "build": "tsc",
@@ -25,24 +24,13 @@
   "author": "Neele",
   "license": "MIT",
   "dependencies": {
-    "@neelegirl/baileys": "^2.1.8",
+    "@neelegirl/baileys": "^2.1.9",
     "pino": "^8.11.0"
   },
   "devDependencies": {
     "@types/mime": "^3.0.1",
     "jest": "^29.0.0"
   },
-  "keywords": [
-    "whatsapp",
-    "baileys",
-    "api",
-    "multi-session",
-    "automation",
-    "neelegirl"
-  ],
-  "peerDependencies": {
-    "@neelegirl/baileys": "^2.1.8"
-  },
   "engines": {
     "node": ">=20.0.0"
   }

package/readme.md

@@ -18,7 +18,7 @@
 
 | Package | Version | Role |
 |---|---:|---|
-| `@neelegirl/wa-api` | `1.6.8` | Convenience wrapper for session lifecycle and event-driven bot workflows |
+| `@neelegirl/wa-api` | `1.6.9` | Convenience wrapper for session lifecycle and event-driven bot workflows |
 
 [Installation](#installation) · [Quickstart](#quickstart) · [API surface](#verified-api-surface) · [Events](#event-hooks) · [Storage](#session-storage) · [Release notes](#release-notes)
 
@@ -29,6 +29,7 @@
 ## Table of Contents
 
 - [Overview](#overview)
+- [Stack relationship](#stack-relationship)
 - [What this package is](#what-this-package-is)
 - [What this package is not](#what-this-package-is-not)
 - [Installation](#installation)
@@ -54,6 +55,18 @@
 
 It keeps the actual WhatsApp protocol handling inside the underlying Baileys fork.
 
+## Stack relationship
+
+`@neelegirl/wa-api` is intentionally the thin layer at the top of the local stack:
+
+| Package | Layer | Responsibility |
+|---|---|---|
+| `@neelegirl/libsignal` | crypto/session layer | session cipher state, identity keys, protocol primitives |
+| `@neelegirl/baileys` | WhatsApp Web runtime | socket, QR/pairing flow, device handling, events, media and message transport |
+| `@neelegirl/wa-api` | wrapper layer | multi-session lifecycle, convenience events, simplified send helpers |
+
+The wrapper should stay small on purpose: it makes common flows easier without pretending to be a separate protocol implementation.
+
 ## What this package is
 
 | Area | Purpose |
@@ -352,9 +365,12 @@ The following exports were verified in the currently prepared package:
 
 ## Recent maintenance notes
 
+- the README was rechecked on `2026-03-20` against the local source wrapper and the target runtime package
+- descriptions were kept aligned with the actual wrapper role instead of repeating full Baileys runtime claims
 - the type surface now includes `ON_PAIRING_CODE` in `dist/Defaults/index.d.ts`
 - `setCredentials` is now reflected in `dist/Utils/index.d.ts`
-- the package depends on `@neelegirl/baileys@^2.1.8`
+- the package now tracks `@neelegirl/baileys@^2.1.9`
+- the README was kept aligned with the actual wrapper surface instead of promising Baileys internals that belong only to the lower runtime package
 - the README image was updated to the requested wa-api image
 
 ## Wrapper design notes
@@ -561,6 +577,12 @@ Yes.
 
 ## Release notes
 
+### 1.6.9
+
+- dependency metadata aligned to `@neelegirl/baileys@2.1.9`
+- documentation refreshed after the hosted LID/session migration stabilization in the underlying runtime
+- public wrapper guidance rechecked against the current `dist` surface on `2026-03-20`
+
 ### 1.6.8
 
 - patch release aligned to `@neelegirl/baileys@2.1.8`