@awangxcode/qiro-baileys 0.0.0-stage → 7.0.0-rc16

package/engine-requirements.js

@@ -0,0 +1,10 @@
+const major = parseInt(process.versions.node.split('.')[0], 10);
+
+if (major < 20) {
+  console.error(
+    `\n❌ This package requires Node.js 20+ to run reliably.\n` +
+    `   You are using Node.js ${process.versions.node}.\n` +
+    `   Please upgrade to Node.js 20+ to proceed.\n`
+  );
+  process.exit(1);
+}

package/lib/Defaults/index.d.ts

@@ -0,0 +1,75 @@
+import { proto } from '../../WAProto/index.js';
+import type { SocketConfig } from '../Types/index.js';
+export declare const UNAUTHORIZED_CODES: number[];
+export declare const DEFAULT_ORIGIN = "https://web.whatsapp.com";
+export declare const CALL_VIDEO_PREFIX = "https://call.whatsapp.com/video/";
+export declare const CALL_AUDIO_PREFIX = "https://call.whatsapp.com/voice/";
+export declare const DEF_CALLBACK_PREFIX = "CB:";
+export declare const DEF_TAG_PREFIX = "TAG:";
+export declare const PHONE_CONNECTION_CB = "CB:Pong";
+export declare const WA_ADV_ACCOUNT_SIG_PREFIX: Buffer<ArrayBuffer>;
+export declare const WA_ADV_DEVICE_SIG_PREFIX: Buffer<ArrayBuffer>;
+export declare const WA_ADV_HOSTED_ACCOUNT_SIG_PREFIX: Buffer<ArrayBuffer>;
+export declare const WA_ADV_HOSTED_DEVICE_SIG_PREFIX: Buffer<ArrayBuffer>;
+export declare const WA_DEFAULT_EPHEMERAL: number;
+/** Status messages older than 24 hours are considered expired */
+export declare const STATUS_EXPIRY_SECONDS: number;
+/** WA Web enforces a 14-day maximum age for placeholder resend requests */
+export declare const PLACEHOLDER_MAX_AGE_SECONDS: number;
+export declare const NOISE_MODE = "Noise_XX_25519_AESGCM_SHA256\0\0\0\0";
+export declare const DICT_VERSION = 3;
+export declare const KEY_BUNDLE_TYPE: Buffer<ArrayBuffer>;
+export declare const NOISE_WA_HEADER: Buffer<ArrayBuffer>;
+/** from: https://stackoverflow.com/questions/3809401/what-is-a-good-regular-expression-to-match-a-url */
+export declare const URL_REGEX: RegExp;
+export declare const WA_CERT_DETAILS: {
+    SERIAL: number;
+    ISSUER: string;
+    PUBLIC_KEY: Buffer<ArrayBuffer>;
+};
+export declare const PROCESSABLE_HISTORY_TYPES: proto.HistorySync.HistorySyncType[];
+export declare const DEFAULT_CACHE_TTLS: {
+    SIGNAL_STORE: number;
+    MSG_RETRY: number;
+    CALL_OFFER: number;
+    USER_DEVICES: number;
+};
+export declare const DEFAULT_CONNECTION_CONFIG: SocketConfig;
+export declare const MEDIA_PATH_MAP: {
+    [T in MediaType]?: string;
+};
+export declare const MEDIA_HKDF_KEY_MAPPING: {
+    audio: string;
+    document: string;
+    gif: string;
+    image: string;
+    ppic: string;
+    product: string;
+    ptt: string;
+    sticker: string;
+    video: string;
+    'thumbnail-document': string;
+    'thumbnail-image': string;
+    'thumbnail-video': string;
+    'thumbnail-link': string;
+    'md-msg-hist': string;
+    'md-app-state': string;
+    'product-catalog-image': string;
+    'payment-bg-image': string;
+    ptv: string;
+    'biz-cover-photo': string;
+};
+export type MediaType = keyof typeof MEDIA_HKDF_KEY_MAPPING;
+export declare const MEDIA_KEYS: MediaType[];
+/** 120s timeout for history sync stall detection, same as WA Web's handleChunkProgress / restartPausedTimer (g = 120) */
+export declare const HISTORY_SYNC_PAUSED_TIMEOUT_MS = 120000;
+export declare const MIN_PREKEY_COUNT = 5;
+export declare const INITIAL_PREKEY_COUNT = 812;
+export declare const UPLOAD_TIMEOUT = 30000;
+export declare const TimeMs: {
+    Minute: number;
+    Hour: number;
+    Day: number;
+    Week: number;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Defaults/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAE9C,OAAO,KAAK,EAAuB,YAAY,EAAa,MAAM,UAAU,CAAA;AAM5E,eAAO,MAAM,kBAAkB,UAAkB,CAAA;AAEjD,eAAO,MAAM,cAAc,6BAA6B,CAAA;AACxD,eAAO,MAAM,iBAAiB,qCAAqC,CAAA;AACnE,eAAO,MAAM,iBAAiB,qCAAqC,CAAA;AACnE,eAAO,MAAM,mBAAmB,QAAQ,CAAA;AACxC,eAAO,MAAM,cAAc,SAAS,CAAA;AACpC,eAAO,MAAM,mBAAmB,YAAY,CAAA;AAE5C,eAAO,MAAM,yBAAyB,qBAAsB,CAAA;AAC5D,eAAO,MAAM,wBAAwB,qBAAsB,CAAA;AAC3D,eAAO,MAAM,gCAAgC,qBAAsB,CAAA;AACnE,eAAO,MAAM,+BAA+B,qBAAsB,CAAA;AAElE,eAAO,MAAM,oBAAoB,QAAmB,CAAA;AAEpD,iEAAiE;AACjE,eAAO,MAAM,qBAAqB,QAAe,CAAA;AAEjD,2EAA2E;AAC3E,eAAO,MAAM,2BAA2B,QAAoB,CAAA;AAE5D,eAAO,MAAM,UAAU,yCAAyC,CAAA;AAChE,eAAO,MAAM,YAAY,IAAI,CAAA;AAC7B,eAAO,MAAM,eAAe,qBAAmB,CAAA;AAC/C,eAAO,MAAM,eAAe,qBAAyC,CAAA;AACrE,yGAAyG;AACzG,eAAO,MAAM,SAAS,QAAwF,CAAA;AAE9G,eAAO,MAAM,eAAe;;;;CAI3B,CAAA;AAED,eAAO,MAAM,yBAAyB,qCAQrC,CAAA;AAED,eAAO,MAAM,kBAAkB;;;;;CAK9B,CAAA;AAED,eAAO,MAAM,yBAAyB,EAAE,YAmCvC,CAAA;AAED,eAAO,MAAM,cAAc,EAAE;KAAG,CAAC,IAAI,SAAS,CAAC,CAAC,EAAE,MAAM;CAWvD,CAAA;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;CAoBlC,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,sBAAsB,CAAA;AAE3D,eAAO,MAAM,UAAU,EAAkC,SAAS,EAAE,CAAA;AAEpE,yHAAyH;AACzH,eAAO,MAAM,8BAA8B,SAAU,CAAA;AAErD,eAAO,MAAM,gBAAgB,IAAI,CAAA;AAEjC,eAAO,MAAM,oBAAoB,MAAM,CAAA;AAEvC,eAAO,MAAM,cAAc,QAAQ,CAAA;AAEnC,eAAO,MAAM,MAAM;;;;;CAKlB,CAAA"}

package/lib/Defaults/index.js

@@ -0,0 +1,129 @@
+import { proto } from '../../WAProto/index.js';
+import { makeLibSignalRepository } from '../Signal/libsignal.js';
+import { Browsers } from '../Utils/browser-utils.js';
+import logger from '../Utils/logger.js';
+const version = [2, 3000, 1043857760];
+export const UNAUTHORIZED_CODES = [401, 403, 419];
+export const DEFAULT_ORIGIN = 'https://web.whatsapp.com';
+export const CALL_VIDEO_PREFIX = 'https://call.whatsapp.com/video/';
+export const CALL_AUDIO_PREFIX = 'https://call.whatsapp.com/voice/';
+export const DEF_CALLBACK_PREFIX = 'CB:';
+export const DEF_TAG_PREFIX = 'TAG:';
+export const PHONE_CONNECTION_CB = 'CB:Pong';
+export const WA_ADV_ACCOUNT_SIG_PREFIX = Buffer.from([6, 0]);
+export const WA_ADV_DEVICE_SIG_PREFIX = Buffer.from([6, 1]);
+export const WA_ADV_HOSTED_ACCOUNT_SIG_PREFIX = Buffer.from([6, 5]);
+export const WA_ADV_HOSTED_DEVICE_SIG_PREFIX = Buffer.from([6, 6]);
+export const WA_DEFAULT_EPHEMERAL = 7 * 24 * 60 * 60;
+/** Status messages older than 24 hours are considered expired */
+export const STATUS_EXPIRY_SECONDS = 24 * 60 * 60;
+/** WA Web enforces a 14-day maximum age for placeholder resend requests */
+export const PLACEHOLDER_MAX_AGE_SECONDS = 14 * 24 * 60 * 60;
+export const NOISE_MODE = 'Noise_XX_25519_AESGCM_SHA256\0\0\0\0';
+export const DICT_VERSION = 3;
+export const KEY_BUNDLE_TYPE = Buffer.from([5]);
+export const NOISE_WA_HEADER = Buffer.from([87, 65, 6, DICT_VERSION]); // last is "DICT_VERSION"
+/** from: https://stackoverflow.com/questions/3809401/what-is-a-good-regular-expression-to-match-a-url */
+export const URL_REGEX = /https:\/\/(?![^:@\/\s]+:[^:@\/\s]+@)[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}(:\d+)?(\/[^\s]*)?/g;
+export const WA_CERT_DETAILS = {
+    SERIAL: 0,
+    ISSUER: 'WhatsAppLongTerm1',
+    PUBLIC_KEY: Buffer.from('142375574d0a587166aae71ebe516437c4a28b73e3695c6ce1f7f9545da8ee6b', 'hex')
+};
+export const PROCESSABLE_HISTORY_TYPES = [
+    proto.HistorySync.HistorySyncType.INITIAL_BOOTSTRAP,
+    proto.HistorySync.HistorySyncType.PUSH_NAME,
+    proto.HistorySync.HistorySyncType.RECENT,
+    proto.HistorySync.HistorySyncType.FULL,
+    proto.HistorySync.HistorySyncType.ON_DEMAND,
+    proto.HistorySync.HistorySyncType.NON_BLOCKING_DATA,
+    proto.HistorySync.HistorySyncType.INITIAL_STATUS_V3
+];
+export const DEFAULT_CACHE_TTLS = {
+    SIGNAL_STORE: 5 * 60, // 5 minutes
+    MSG_RETRY: 60 * 60, // 1 hour
+    CALL_OFFER: 5 * 60, // 5 minutes
+    USER_DEVICES: 5 * 60 // 5 minutes
+};
+export const DEFAULT_CONNECTION_CONFIG = {
+    version: version,
+    browser: Browsers.macOS('Chrome'),
+    waWebSocketUrl: 'wss://web.whatsapp.com/ws/chat',
+    connectTimeoutMs: 20000,
+    keepAliveIntervalMs: 30000,
+    logger: logger.child({ class: 'baileys' }),
+    emitOwnEvents: true,
+    defaultQueryTimeoutMs: 60000,
+    customUploadHosts: [],
+    retryRequestDelayMs: 250,
+    maxMsgRetryCount: 5,
+    fireInitQueries: true,
+    auth: undefined,
+    markOnlineOnConnect: true,
+    syncFullHistory: true,
+    patchMessageBeforeSending: msg => msg,
+    shouldSyncHistoryMessage: ({ syncType }) => {
+        return syncType !== proto.HistorySync.HistorySyncType.FULL;
+    },
+    shouldIgnoreJid: () => false,
+    linkPreviewImageThumbnailWidth: 192,
+    transactionOpts: { maxCommitRetries: 10, delayBetweenTriesMs: 3000 },
+    generateHighQualityLinkPreview: false,
+    enableAutoSessionRecreation: true,
+    enableRecentMessageCache: true,
+    options: {},
+    appStateMacVerification: {
+        patch: false,
+        snapshot: false
+    },
+    countryCode: 'US',
+    getMessage: async () => undefined,
+    cachedGroupMetadata: async () => undefined,
+    makeSignalRepository: makeLibSignalRepository
+};
+export const MEDIA_PATH_MAP = {
+    image: '/mms/image',
+    video: '/mms/video',
+    document: '/mms/document',
+    audio: '/mms/audio',
+    sticker: '/mms/image',
+    'thumbnail-link': '/mms/image',
+    'product-catalog-image': '/product/image',
+    'md-app-state': '',
+    'md-msg-hist': '/mms/md-app-state',
+    'biz-cover-photo': '/pps/biz-cover-photo'
+};
+export const MEDIA_HKDF_KEY_MAPPING = {
+    audio: 'Audio',
+    document: 'Document',
+    gif: 'Video',
+    image: 'Image',
+    ppic: '',
+    product: 'Image',
+    ptt: 'Audio',
+    sticker: 'Image',
+    video: 'Video',
+    'thumbnail-document': 'Document Thumbnail',
+    'thumbnail-image': 'Image Thumbnail',
+    'thumbnail-video': 'Video Thumbnail',
+    'thumbnail-link': 'Link Thumbnail',
+    'md-msg-hist': 'History',
+    'md-app-state': 'App State',
+    'product-catalog-image': '',
+    'payment-bg-image': 'Payment Background',
+    ptv: 'Video',
+    'biz-cover-photo': 'Image'
+};
+export const MEDIA_KEYS = Object.keys(MEDIA_PATH_MAP);
+/** 120s timeout for history sync stall detection, same as WA Web's handleChunkProgress / restartPausedTimer (g = 120) */
+export const HISTORY_SYNC_PAUSED_TIMEOUT_MS = 120000;
+export const MIN_PREKEY_COUNT = 5;
+export const INITIAL_PREKEY_COUNT = 812;
+export const UPLOAD_TIMEOUT = 30000; // 30 seconds
+export const TimeMs = {
+    Minute: 60 * 1000,
+    Hour: 60 * 60 * 1000,
+    Day: 24 * 60 * 60 * 1000,
+    Week: 7 * 24 * 60 * 60 * 1000
+};
+//# sourceMappingURL=index.js.map

package/lib/Defaults/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Defaults/index.ts"],"names":[],"mappings":"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"}

package/lib/MessageBuilder/index.d.ts

@@ -0,0 +1,206 @@
+import type { MessageRelayOptions } from '../Types/Message.js';
+import { proto } from '../../WAProto/index.js';
+type RelaySocket = {
+    relayMessage: (jid: string, message: proto.IMessage, options: MessageRelayOptions) => Promise<string>;
+};
+export type NativeFlowPlatform = 'web' | 'ios' | 'android';
+export type NativeFlowButtonInput = {
+    name: string;
+    params: Record<string, unknown>;
+};
+export type NativeFlowButton = proto.Message.InteractiveMessage.NativeFlowMessage.INativeFlowButton;
+export type NativeFlowButtonValidation = {
+    ok: boolean;
+    platform: NativeFlowPlatform;
+    maxButtons: number;
+    errors: string[];
+};
+export type NativeFlowValidationOptions = {
+    /** Explicit opt-in for protocol button names that are not in the reviewed allow-list. */
+    allowExperimentalNativeFlowTypes?: boolean;
+};
+/**
+ * Validate native-flow button combinations against the currently documented WA Web/iOS
+ * constraints. This is a client-compatibility check, not a guarantee that WhatsApp will
+ * render a server-side or account-gated feature.
+ */
+export declare const checkNativeFlowButtons: (buttons: NativeFlowButtonInput[], platform?: NativeFlowPlatform, options?: NativeFlowValidationOptions) => NativeFlowButtonValidation;
+export declare const isWebSupportedNativeFlowButton: (name: string) => boolean;
+export type BuildOptions = {
+    platform?: NativeFlowPlatform;
+    /** Enable explicitly supplied native-flow names not present in the reviewed allow-list. */
+    allowExperimentalNativeFlowTypes?: boolean;
+};
+export type SendOptions = BuildOptions & {
+    messageId?: string;
+};
+/**
+ * Native-flow button builder integrated into Qiro Baileys. It intentionally builds only
+ * protocol payloads that are represented by the bundled WAProto types; it does not try
+ * to bypass device or server-side feature gates.
+ */
+export declare class Button {
+    protected readonly socket: RelaySocket;
+    protected titleText: string;
+    protected subtitleText: string;
+    protected body: string;
+    protected footerText: string;
+    protected headerPayload?: proto.Message.InteractiveMessage.IHeader;
+    protected readonly buttons: NativeFlowButtonInput[];
+    protected selection?: {
+        title: string;
+        sections: Array<{
+            title: string;
+            rows: Array<{
+                header?: string;
+                title: string;
+                description?: string;
+                id: string;
+            }>;
+        }>;
+    };
+    protected currentSection?: {
+        title: string;
+        rows: Array<{
+            header?: string;
+            title: string;
+            description?: string;
+            id: string;
+        }>;
+    };
+    constructor(socket: RelaySocket);
+    setTitle(value: string): this;
+    title(value: string): this;
+    /** Fluent alias compatible with common MessageBuilder APIs. */
+    header(value: string): this;
+    setSubtitle(value: string): this;
+    subtitle(value: string): this;
+    setBody(value: string): this;
+    /** Fluent alias compatible with common MessageBuilder APIs. */
+    text(value: string): this;
+    setFooter(value: string): this;
+    footer(value: string): this;
+    /** Set an already-prepared protobuf header; media upload is intentionally not hidden here. */
+    setHeader(value: proto.Message.InteractiveMessage.IHeader): this;
+    addReply(displayText: string, id: string): this;
+    /** Fluent alias for addReply(). */
+    button(displayText: string, id: string): this;
+    addUrl(displayText: string, url: string): this;
+    addCopy(displayText: string, copyCode: string): this;
+    addCall(displayText: string, phoneNumber: string): this;
+    /** Escape hatch for documented native-flow types not covered by a convenience method. */
+    addNativeButton(name: string, params: Record<string, unknown>): this;
+    addSelection(title: string): this;
+    makeSection(title: string): this;
+    makeRow(header: string, title: string, description: string, id: string): this;
+    protected getButtonInputs(): NativeFlowButtonInput[];
+    build(options?: BuildOptions): proto.IMessage;
+    toCard(options?: BuildOptions): proto.Message.IInteractiveMessage;
+    send(jid: string, options?: SendOptions): Promise<string>;
+}
+/** ButtonV2 exposes a compact quick-reply API over the same validated native-flow format. */
+export declare class ButtonV2 extends Button {
+    addButton(displayText: string, id: string): this;
+}
+/**
+ * Carousel builder for already-prepared protobuf cards. Each card must include image or
+ * video media metadata; use the normal media preparation utilities before adding it.
+ */
+export declare class Carousel {
+    private readonly socket;
+    private body;
+    private footerText;
+    private readonly cards;
+    constructor(socket: RelaySocket);
+    setBody(value: string): this;
+    text(value: string): this;
+    setFooter(value: string): this;
+    footer(value: string): this;
+    addCard(card: proto.Message.IInteractiveMessage | proto.Message.IInteractiveMessage[]): this;
+    build(): proto.IMessage;
+    send(jid: string, options?: {
+        messageId?: string;
+    }): Promise<string>;
+}
+export type AIRichSourceInput = {
+    title: string;
+    url: string;
+    provider?: proto.BotSourcesMetadata.BotSourceItem.SourceProvider;
+    query?: string;
+    thumbnailUrl?: string;
+    faviconUrl?: string;
+};
+/**
+ * Experimental builder for the AIRichResponse protobuf types already bundled in WAProto.
+ * This creates a validly-shaped payload only; WhatsApp may gate or change how these
+ * internal/experimental message types are rendered on different clients.
+ */
+export declare class AIRich {
+    private readonly socket?;
+    private readonly submessages;
+    private readonly sources;
+    constructor(socket?: RelaySocket);
+    text(value: string): this;
+    addText(value: string): this;
+    addCode(language: string, code: string): this;
+    addTable(rows: string[][], title?: string): this;
+    addLatex(expression: string, options?: {
+        renderedImageUrl?: string;
+        width?: number;
+        height?: number;
+    }): this;
+    addInlineImage(url: string, altText?: string, alignment?: proto.AIRichResponseInlineImageMetadata.AIRichResponseImageAlignment, tapLinkUrl?: string): this;
+    addMap(centerLatitude: number, centerLongitude: number, annotations: Array<{
+        latitude: number;
+        longitude: number;
+        title?: string;
+        body?: string;
+    }>): this;
+    addSource(source: AIRichSourceInput): this;
+    /** Add a WAProto submessage directly for advanced, version-aware use cases. */
+    addSubmessage(submessage: proto.IAIRichResponseSubMessage): this;
+    build(): proto.IMessage;
+    send(jid: string, options?: {
+        messageId?: string;
+    }): Promise<string>;
+}
+/** Small, deterministic utilities; unlike remote auto-update helpers, these never fetch or execute code. */
+export declare const Toolkit: Readonly<{
+    checkNativeFlowButtons: (buttons: NativeFlowButtonInput[], platform?: NativeFlowPlatform, options?: NativeFlowValidationOptions) => NativeFlowButtonValidation;
+    isWebSupportedNativeFlowButton: (name: string) => boolean;
+    validateHttpUrl: (url: string) => string;
+    textMessage: (text: string) => proto.IMessage;
+    cloneMessage: <T>(message: T) => T;
+}>;
+export declare const MessageBuilder: {
+    Button: typeof Button;
+    ButtonV2: typeof ButtonV2;
+    Carousel: typeof Carousel;
+    AIRich: typeof AIRich;
+    Toolkit: Readonly<{
+        checkNativeFlowButtons: (buttons: NativeFlowButtonInput[], platform?: NativeFlowPlatform, options?: NativeFlowValidationOptions) => NativeFlowButtonValidation;
+        isWebSupportedNativeFlowButton: (name: string) => boolean;
+        validateHttpUrl: (url: string) => string;
+        textMessage: (text: string) => proto.IMessage;
+        cloneMessage: <T>(message: T) => T;
+    }>;
+    checkNativeFlowButtons: (buttons: NativeFlowButtonInput[], platform?: NativeFlowPlatform, options?: NativeFlowValidationOptions) => NativeFlowButtonValidation;
+    isWebSupportedNativeFlowButton: (name: string) => boolean;
+};
+export declare const MB: {
+    Button: typeof Button;
+    ButtonV2: typeof ButtonV2;
+    Carousel: typeof Carousel;
+    AIRich: typeof AIRich;
+    Toolkit: Readonly<{
+        checkNativeFlowButtons: (buttons: NativeFlowButtonInput[], platform?: NativeFlowPlatform, options?: NativeFlowValidationOptions) => NativeFlowButtonValidation;
+        isWebSupportedNativeFlowButton: (name: string) => boolean;
+        validateHttpUrl: (url: string) => string;
+        textMessage: (text: string) => proto.IMessage;
+        cloneMessage: <T>(message: T) => T;
+    }>;
+    checkNativeFlowButtons: (buttons: NativeFlowButtonInput[], platform?: NativeFlowPlatform, options?: NativeFlowValidationOptions) => NativeFlowButtonValidation;
+    isWebSupportedNativeFlowButton: (name: string) => boolean;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/MessageBuilder/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/MessageBuilder/index.ts"],"names":[],"mappings":"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"}