nduka 1.0.0

package/dist/tools/tool-command-synthesis.js

@@ -0,0 +1,17 @@
+/**
+ * Tool command synthesis is disabled in the memory-only chat branch.
+ *
+ * Normal customer chat must not call search/news/fetch synthesis.
+ * Raw owner debug commands can still return raw tool results where allowed.
+ */
+export class ToolCommandSynthesizer {
+    completion;
+    constructor(completion) {
+        this.completion = completion;
+        void this.completion;
+    }
+    async synthesize(_input) {
+        throw new Error('Tool command synthesis is disabled in memory-only mode. Use raw owner debug commands or configure an explicit async tool workflow outside normal chat.');
+    }
+}
+//# sourceMappingURL=tool-command-synthesis.js.map

package/dist/tools/tool-command-synthesis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-command-synthesis.js","sourceRoot":"","sources":["../../src/tools/tool-command-synthesis.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,MAAM,OAAO,sBAAsB;IACb;IAApB,YAAoB,UAAkC;QAAlC,eAAU,GAAV,UAAU,CAAwB;QACpD,KAAK,IAAI,CAAC,UAAU,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAiC;QAChD,MAAM,IAAI,KAAK,CACb,wJAAwJ,CACzJ,CAAC;IACJ,CAAC;CACF"}

package/dist/tools/tool-policy.d.ts

@@ -0,0 +1,21 @@
+import { type ChatbotConfig } from '../config/chatbot-config.js';
+export type ToolActor = 'owner' | 'customer' | 'system';
+export interface ToolPolicyDecision {
+    allowed: boolean;
+    reason: 'allowed' | 'tools_disabled' | 'not_in_allowlist' | 'denied' | 'owner_only' | 'unknown_tool';
+}
+export interface ToolPolicyInput {
+    name: string;
+    actor?: ToolActor;
+    knownTools?: string[];
+    config?: ChatbotConfig;
+}
+export declare class ToolPolicy {
+    private config;
+    private catalog;
+    constructor(config?: ChatbotConfig);
+    reload(config?: ChatbotConfig): void;
+    decide(input: ToolPolicyInput): ToolPolicyDecision;
+    assertAllowed(input: ToolPolicyInput): void;
+}
+//# sourceMappingURL=tool-policy.d.ts.map

package/dist/tools/tool-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-policy.d.ts","sourceRoot":"","sources":["../../src/tools/tool-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGpF,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,QAAQ,GAAG,YAAY,GAAG,cAAc,CAAC;CACtG;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AA+BD,qBAAa,UAAU;IAGT,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,OAAO,CAAqB;gBAEhB,MAAM,GAAE,aAAmC;IAE/D,MAAM,CAAC,MAAM,GAAE,aAAmC,GAAG,IAAI;IAKzD,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,kBAAkB;IAuBlD,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;CAI5C"}

package/dist/tools/tool-policy.js

@@ -0,0 +1,66 @@
+import { loadChatbotConfig } from '../config/chatbot-config.js';
+import { ToolCatalog } from './tool-catalog.js';
+const OWNER_ONLY_TOOLS = new Set([
+    'tool_status',
+    'model_status',
+    'model_list',
+    'model_switch',
+    'doctor',
+    'config_get',
+    'config_set',
+    'tool_test',
+]);
+const BUILTIN_SAFE_TOOLS = new Set([
+    'web_search',
+    'news_search',
+    'url_fetch',
+    'fetch_url',
+    'vision_ocr',
+    'pdf_summary',
+]);
+function configuredDeny(config) {
+    const value = config.tools.deny;
+    return Array.isArray(value) ? value.filter((item) => typeof item === 'string') : [];
+}
+function normalize(name) {
+    return String(name || '').trim();
+}
+export class ToolPolicy {
+    config;
+    catalog = new ToolCatalog();
+    constructor(config = loadChatbotConfig()) {
+        this.config = config;
+    }
+    reload(config = loadChatbotConfig()) {
+        this.config = config;
+        this.catalog.reload();
+    }
+    decide(input) {
+        const name = normalize(input.name);
+        const actor = input.actor || 'customer';
+        const config = input.config || this.config;
+        const catalogTools = this.catalog.names();
+        const knownTools = new Set([...(input.knownTools || []), ...catalogTools, ...BUILTIN_SAFE_TOOLS, ...OWNER_ONLY_TOOLS]);
+        if (!name || !knownTools.has(name))
+            return { allowed: false, reason: 'unknown_tool' };
+        if (!config.tools.enabled)
+            return { allowed: false, reason: 'tools_disabled' };
+        if (configuredDeny(config).includes(name))
+            return { allowed: false, reason: 'denied' };
+        const catalogTool = this.catalog.findByNameOrAlias(name);
+        const ownerOnly = OWNER_ONLY_TOOLS.has(name) || catalogTool?.ownerOnly === true;
+        if (ownerOnly && actor !== 'owner' && actor !== 'system')
+            return { allowed: false, reason: 'owner_only' };
+        const allow = config.tools.allow || [];
+        if (!ownerOnly && allow.length > 0 && !allow.includes(name)) {
+            return { allowed: false, reason: 'not_in_allowlist' };
+        }
+        return { allowed: true, reason: 'allowed' };
+    }
+    assertAllowed(input) {
+        const decision = this.decide(input);
+        if (!decision.allowed)
+            throw new Error(`Tool ${input.name} is not allowed: ${decision.reason}`);
+    }
+}
+//# sourceMappingURL=tool-policy.js.map

package/dist/tools/tool-policy.js.map

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

package/dist/usage/tracker.d.ts

@@ -0,0 +1,35 @@
+export interface UsageEventInput {
+    chatJid: string;
+    userJid?: string | null;
+    provider: string;
+    model: string;
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    latencyMs: number;
+    cost?: number | null;
+}
+export interface UsageSummary {
+    chatJid?: string;
+    userJid?: string | null;
+    requests: number;
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    latencyMs: number;
+    cost: number;
+}
+export declare class UsageTracker {
+    private db;
+    private initialized;
+    constructor();
+    private init;
+    record(input: UsageEventInput): void;
+    summarize(chatJid?: string, sinceMs?: number): UsageSummary;
+    topChats(limit?: number, sinceMs?: number): UsageSummary[];
+    topUsers(limit?: number, sinceMs?: number): UsageSummary[];
+    formatSummary(summary: UsageSummary, title?: string): string;
+    formatTop(limit?: number, sinceMs?: number): string;
+    formatTopUsers(limit?: number, sinceMs?: number): string;
+}
+//# sourceMappingURL=tracker.d.ts.map

package/dist/usage/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../src/usage/tracker.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAkB;IAC5B,OAAO,CAAC,WAAW,CAAS;;IAO5B,OAAO,CAAC,IAAI;IAuBZ,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAqBpC,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY;IA0B3D,QAAQ,CAAC,KAAK,SAAK,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE;IAqBtD,QAAQ,CAAC,KAAK,SAAK,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE;IAqBtD,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,SAAU,GAAG,MAAM;IAe7D,SAAS,CAAC,KAAK,SAAK,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAU/C,cAAc,CAAC,KAAK,SAAK,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;CASrD"}

package/dist/usage/tracker.js

@@ -0,0 +1,141 @@
+import { DatabaseManager } from '../database/index.js';
+export class UsageTracker {
+    db;
+    initialized = false;
+    constructor() {
+        this.db = DatabaseManager.getInstance();
+        this.init();
+    }
+    init() {
+        if (this.initialized)
+            return;
+        this.db.getDb().exec(`
+      CREATE TABLE IF NOT EXISTS usage_events (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        chat_jid TEXT NOT NULL,
+        user_jid TEXT,
+        provider TEXT NOT NULL,
+        model TEXT NOT NULL,
+        prompt_tokens INTEGER NOT NULL DEFAULT 0,
+        completion_tokens INTEGER NOT NULL DEFAULT 0,
+        total_tokens INTEGER NOT NULL DEFAULT 0,
+        latency_ms INTEGER NOT NULL DEFAULT 0,
+        cost REAL NOT NULL DEFAULT 0,
+        created_at INTEGER NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_usage_chat_time ON usage_events(chat_jid, created_at);
+      CREATE INDEX IF NOT EXISTS idx_usage_time ON usage_events(created_at);
+      CREATE INDEX IF NOT EXISTS idx_usage_user_time ON usage_events(user_jid, created_at);
+    `);
+        this.initialized = true;
+    }
+    record(input) {
+        this.db.getDb().prepare(`
+      INSERT INTO usage_events (
+        chat_jid, user_jid, provider, model,
+        prompt_tokens, completion_tokens, total_tokens,
+        latency_ms, cost, created_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(input.chatJid, input.userJid || null, input.provider, input.model, input.promptTokens, input.completionTokens, input.totalTokens, input.latencyMs, input.cost || 0, Date.now());
+    }
+    summarize(chatJid, sinceMs) {
+        const clauses = [];
+        const params = [];
+        if (chatJid) {
+            clauses.push('chat_jid = ?');
+            params.push(chatJid);
+        }
+        if (sinceMs) {
+            clauses.push('created_at >= ?');
+            params.push(sinceMs);
+        }
+        const where = clauses.length ? `WHERE ${clauses.join(' AND ')}` : '';
+        const row = this.db.getDb().prepare(`
+      SELECT
+        COUNT(*) as requests,
+        COALESCE(SUM(prompt_tokens), 0) as promptTokens,
+        COALESCE(SUM(completion_tokens), 0) as completionTokens,
+        COALESCE(SUM(total_tokens), 0) as totalTokens,
+        COALESCE(SUM(latency_ms), 0) as latencyMs,
+        COALESCE(SUM(cost), 0) as cost
+      FROM usage_events
+      ${where}
+    `).get(...params);
+        return { chatJid, ...row };
+    }
+    topChats(limit = 10, sinceMs) {
+        const where = sinceMs ? 'WHERE created_at >= ?' : '';
+        const params = sinceMs ? [sinceMs, limit] : [limit];
+        const rows = this.db.getDb().prepare(`
+      SELECT
+        chat_jid as chatJid,
+        COUNT(*) as requests,
+        COALESCE(SUM(prompt_tokens), 0) as promptTokens,
+        COALESCE(SUM(completion_tokens), 0) as completionTokens,
+        COALESCE(SUM(total_tokens), 0) as totalTokens,
+        COALESCE(SUM(latency_ms), 0) as latencyMs,
+        COALESCE(SUM(cost), 0) as cost
+      FROM usage_events
+      ${where}
+      GROUP BY chat_jid
+      ORDER BY totalTokens DESC
+      LIMIT ?
+    `).all(...params);
+        return rows;
+    }
+    topUsers(limit = 10, sinceMs) {
+        const where = sinceMs ? 'WHERE created_at >= ? AND user_jid IS NOT NULL' : 'WHERE user_jid IS NOT NULL';
+        const params = sinceMs ? [sinceMs, limit] : [limit];
+        const rows = this.db.getDb().prepare(`
+      SELECT
+        user_jid as userJid,
+        COUNT(*) as requests,
+        COALESCE(SUM(prompt_tokens), 0) as promptTokens,
+        COALESCE(SUM(completion_tokens), 0) as completionTokens,
+        COALESCE(SUM(total_tokens), 0) as totalTokens,
+        COALESCE(SUM(latency_ms), 0) as latencyMs,
+        COALESCE(SUM(cost), 0) as cost
+      FROM usage_events
+      ${where}
+      GROUP BY user_jid
+      ORDER BY totalTokens DESC
+      LIMIT ?
+    `).all(...params);
+        return rows;
+    }
+    formatSummary(summary, title = 'Usage') {
+        const avg = summary.requests > 0 ? Math.round(summary.totalTokens / summary.requests) : 0;
+        return [
+            `📊 *${title}*`,
+            summary.chatJid ? `Chat: \`${summary.chatJid}\`` : '',
+            summary.userJid ? `User: \`${summary.userJid}\`` : '',
+            `Requests: ${summary.requests}`,
+            `Prompt tokens: ${summary.promptTokens.toLocaleString()}`,
+            `Completion tokens: ${summary.completionTokens.toLocaleString()}`,
+            `Total tokens: ${summary.totalTokens.toLocaleString()}`,
+            `Average/request: ${avg.toLocaleString()}`,
+            summary.cost ? `Cost credits: ${summary.cost.toFixed(6)}` : '',
+        ].filter(Boolean).join('\n');
+    }
+    formatTop(limit = 10, sinceMs) {
+        const rows = this.topChats(limit, sinceMs);
+        if (rows.length === 0)
+            return '📊 No usage recorded yet.';
+        return [
+            '📊 *Top Token Usage by Chat*',
+            '',
+            ...rows.map((r, i) => `${i + 1}. \`${r.chatJid}\` — ${r.totalTokens.toLocaleString()} tokens (${r.requests} requests)`),
+        ].join('\n');
+    }
+    formatTopUsers(limit = 10, sinceMs) {
+        const rows = this.topUsers(limit, sinceMs);
+        if (rows.length === 0)
+            return '📊 No user token usage recorded yet.';
+        return [
+            '📊 *Top Token Usage by User*',
+            '',
+            ...rows.map((r, i) => `${i + 1}. \`${r.userJid || 'unknown'}\` — ${r.totalTokens.toLocaleString()} tokens (${r.requests} requests)`),
+        ].join('\n');
+    }
+}
+//# sourceMappingURL=tracker.js.map

package/dist/usage/tracker.js.map

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

package/dist/validation/event-matrix.d.ts

@@ -0,0 +1,41 @@
+export type WhatsAppEventType = 'message.upsert' | 'messages.update' | 'messages.delete' | 'group-participants.update' | 'groups.update' | 'contacts.update' | 'presence.update' | 'connection.update' | 'message-receipt.update' | 'messages.reaction' | 'call' | 'creds.update' | 'messaging-history.set' | 'chats.upsert' | 'unknown';
+export interface EventMatrixEntry {
+    eventType: WhatsAppEventType;
+    scenario: string;
+    payload: unknown;
+    shouldProcess: boolean;
+    shouldNotCrash: boolean;
+    expectedBehavior: string;
+}
+export interface EventMatrixResult {
+    eventType: WhatsAppEventType;
+    scenario: string;
+    passed: boolean;
+    error?: string;
+    durationMs: number;
+}
+export interface EventMatrixReport {
+    totalScenarios: number;
+    passed: number;
+    failed: number;
+    coverage: number;
+    results: EventMatrixResult[];
+}
+export declare function generateEventMatrix(): EventMatrixEntry[];
+export declare class EventMatrixValidator {
+    private results;
+    /**
+     * Record a validation result for an event scenario.
+     */
+    recordResult(eventType: WhatsAppEventType, scenario: string, passed: boolean, error?: string): void;
+    /**
+     * Validate that a processing function handles an event safely.
+     * The function must not throw — catching errors internally is the test.
+     */
+    validateEventProcessing(eventType: WhatsAppEventType, scenario: string, processor: (payload: unknown) => void | Promise<void>): void;
+    /**
+     * Generate report.
+     */
+    generateReport(): EventMatrixReport;
+}
+//# sourceMappingURL=event-matrix.d.ts.map

package/dist/validation/event-matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-matrix.d.ts","sourceRoot":"","sources":["../../src/validation/event-matrix.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,iBAAiB,GACjB,iBAAiB,GACjB,2BAA2B,GAC3B,eAAe,GACf,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,GACnB,wBAAwB,GACxB,mBAAmB,GACnB,MAAM,GACN,cAAc,GACd,uBAAuB,GACvB,cAAc,GACd,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAID,wBAAgB,mBAAmB,IAAI,gBAAgB,EAAE,CAkExD;AAID,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,OAAO,CAA2B;IAE1C;;OAEG;IACH,YAAY,CACV,SAAS,EAAE,iBAAiB,EAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,EACf,KAAK,CAAC,EAAE,MAAM,GACb,IAAI;IAUP;;;OAGG;IACH,uBAAuB,CACrB,SAAS,EAAE,iBAAiB,EAC5B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACpD,IAAI;IAuBP;;OAEG;IACH,cAAc,IAAI,iBAAiB;CAapC"}

package/dist/validation/event-matrix.js

@@ -0,0 +1,119 @@
+// ─── Complete Event Matrix ───────────────────────────────────────────────────
+export function generateEventMatrix() {
+    const matrix = [];
+    const scenarios = [
+        { name: 'normal', modifier: (p) => p },
+        { name: 'duplicate', modifier: (p) => p },
+        { name: 'out-of-order', modifier: (p) => p },
+        { name: 'delayed', modifier: (p) => p },
+        { name: 'malformed', modifier: () => ({ corrupted: true, invalid: 'data' }) },
+        { name: 'null-payload', modifier: () => null },
+        { name: 'empty-payload', modifier: () => ({}) },
+        { name: 'unknown-fields', modifier: (p) => ({ ...p, __newField: 'unknown' }) },
+        { name: 'missing-required', modifier: () => ({ type: 'incomplete' }) },
+        { name: 'oversized', modifier: () => ({ text: 'x'.repeat(100_000) }) },
+    ];
+    const events = [
+        'message.upsert',
+        'messages.update',
+        'messages.delete',
+        'group-participants.update',
+        'groups.update',
+        'contacts.update',
+        'presence.update',
+        'connection.update',
+        'message-receipt.update',
+        'messages.reaction',
+        'call',
+        'creds.update',
+        'messaging-history.set',
+        'chats.upsert',
+        'unknown',
+    ];
+    const basePayloads = {
+        'message.upsert': { messages: [{ key: { id: 'msg1', remoteJid: '123@s.whatsapp.net' }, message: { conversation: 'hello' }, messageTimestamp: Date.now() }], type: 'notify' },
+        'messages.update': [{ key: { id: 'msg1' }, update: {} }],
+        'messages.delete': { keys: [{ id: 'msg1', remoteJid: '123@s.whatsapp.net' }] },
+        'group-participants.update': { id: 'g1@g.us', participants: ['user1@s.whatsapp.net'], action: 'add' },
+        'groups.update': [{ id: 'g1@g.us', subject: 'new' }],
+        'contacts.update': [{ jid: 'user1@s.whatsapp.net', name: 'User' }],
+        'presence.update': { id: 'user1@s.whatsapp.net', presences: { 'user1': { lastKnownPresence: 'available' } } },
+        'connection.update': { connection: 'open' },
+        'message-receipt.update': [{ key: { id: 'msg1' }, receipt: {} }],
+        'messages.reaction': [{ key: { id: 'msg1' }, reaction: { text: '👍' } }],
+        'call': [{ id: 'call1', from: 'user1@s.whatsapp.net', status: 'offer' }],
+        'creds.update': { me: { id: 'bot@s.whatsapp.net' } },
+        'messaging-history.set': { chats: [], contacts: [], messages: [] },
+        'chats.upsert': [{ id: 'c1@s.whatsapp.net' }],
+        'unknown': { __type: 'future_event', data: 'unknown' },
+    };
+    for (const event of events) {
+        for (const scenario of scenarios) {
+            matrix.push({
+                eventType: event,
+                scenario: `${event}/${scenario.name}`,
+                payload: scenario.modifier(basePayloads[event]),
+                shouldProcess: scenario.name !== 'malformed' && scenario.name !== 'null-payload',
+                shouldNotCrash: true,
+                expectedBehavior: scenario.name === 'malformed' ? 'logged and skipped' : 'processed or safely ignored',
+            });
+        }
+    }
+    return matrix;
+}
+// ─── Event Matrix Validator ──────────────────────────────────────────────────
+export class EventMatrixValidator {
+    results = [];
+    /**
+     * Record a validation result for an event scenario.
+     */
+    recordResult(eventType, scenario, passed, error) {
+        this.results.push({
+            eventType,
+            scenario,
+            passed,
+            error,
+            durationMs: 0,
+        });
+    }
+    /**
+     * Validate that a processing function handles an event safely.
+     * The function must not throw — catching errors internally is the test.
+     */
+    validateEventProcessing(eventType, scenario, processor) {
+        const entry = generateEventMatrix().find((e) => e.eventType === eventType && e.scenario === scenario);
+        if (!entry) {
+            this.recordResult(eventType, scenario, false, 'No matrix entry found');
+            return;
+        }
+        try {
+            const result = processor(entry.payload);
+            if (result instanceof Promise) {
+                // Async handler — we can't await in sync context, mark as pending
+                this.recordResult(eventType, scenario, true);
+            }
+            else {
+                this.recordResult(eventType, scenario, true);
+            }
+        }
+        catch (err) {
+            this.recordResult(eventType, scenario, false, err.message);
+        }
+    }
+    /**
+     * Generate report.
+     */
+    generateReport() {
+        const matrix = generateEventMatrix();
+        const passed = this.results.filter((r) => r.passed).length;
+        const failed = this.results.filter((r) => !r.passed).length;
+        return {
+            totalScenarios: matrix.length,
+            passed,
+            failed,
+            coverage: matrix.length > 0 ? Math.round((passed / matrix.length) * 100) : 0,
+            results: this.results,
+        };
+    }
+}
+//# sourceMappingURL=event-matrix.js.map

package/dist/validation/event-matrix.js.map

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

package/dist/validation/failure-simulator.d.ts

@@ -0,0 +1,40 @@
+export type FailureLayer = 'gateway' | 'event' | 'database' | 'media' | 'ai';
+export interface FailureScenario {
+    id: string;
+    layer: FailureLayer;
+    name: string;
+    description: string;
+    inject: () => void | Promise<void>;
+    detect: () => boolean;
+    recover: () => void | Promise<void>;
+    expectedRecovery: string;
+}
+export interface FailureSimResult {
+    scenarioId: string;
+    detected: boolean;
+    contained: boolean;
+    recovered: boolean;
+    durationMs: number;
+    error?: string;
+}
+export interface FailureSimReport {
+    totalScenarios: number;
+    passed: number;
+    failed: number;
+    detectedRate: number;
+    recoveryRate: number;
+    results: FailureSimResult[];
+}
+export declare function generateFailureScenarios(): FailureScenario[];
+export declare class FailureSimulator {
+    private results;
+    /**
+     * Run a single failure scenario and record the result.
+     */
+    runScenario(scenario: FailureScenario): Promise<FailureSimResult>;
+    /**
+     * Generate a pass/fail report.
+     */
+    generateReport(): FailureSimReport;
+}
+//# sourceMappingURL=failure-simulator.d.ts.map

package/dist/validation/failure-simulator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-simulator.d.ts","sourceRoot":"","sources":["../../src/validation/failure-simulator.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,IAAI,CAAC;AAE7E,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,OAAO,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAID,wBAAgB,wBAAwB,IAAI,eAAe,EAAE,CAkK5D;AAID,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAA0B;IAEzC;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgCvE;;OAEG;IACH,cAAc,IAAI,gBAAgB;CAgBnC"}