@openclaw/crabline 0.0.0

package/dist/src/providers/builtin/telegram.js

@@ -0,0 +1,123 @@
+import path from "node:path";
+import { CrablineError } from "../../core/errors.js";
+import { LocalMockProviderAdapter } from "../local-mock.js";
+import { authorFromBotFlag, createNativeTargetCodec, genericMockPayloadWithNativeThread, isRecord, optionalRecord, optionalString, optionalStringish, requireNativeId, requireNativeInboundId, } from "./native-local-mock.js";
+export function resolveTelegramAdapterConfig(config, env = process.env) {
+    const telegramConfig = config.telegram;
+    return {
+        mode: telegramConfig?.mode ?? "auto",
+        ...((telegramConfig?.apiUrl ?? env.TELEGRAM_API_BASE_URL)
+            ? { apiUrl: telegramConfig?.apiUrl ?? env.TELEGRAM_API_BASE_URL }
+            : {}),
+        ...((telegramConfig?.secretToken ?? env.TELEGRAM_WEBHOOK_SECRET_TOKEN)
+            ? { secretToken: telegramConfig?.secretToken ?? env.TELEGRAM_WEBHOOK_SECRET_TOKEN }
+            : {}),
+        ...((telegramConfig?.userName ?? env.TELEGRAM_BOT_USERNAME)
+            ? { userName: telegramConfig?.userName ?? env.TELEGRAM_BOT_USERNAME }
+            : {}),
+    };
+}
+function toRecorderPath(providerId, config) {
+    const configuredPath = config.telegram?.recorder.path;
+    return configuredPath
+        ? path.resolve(configuredPath)
+        : path.resolve(".crabline", "recorders", `${providerId}.jsonl`);
+}
+const TELEGRAM_CHAT_ID_RULE = {
+    example: "-1001234567890 or @channelusername",
+    name: "Telegram chat id",
+    pattern: /^(?:-?\d+|@[A-Za-z][A-Za-z0-9_]{4,31})$/u,
+};
+const TELEGRAM_MESSAGE_THREAD_ID_RULE = {
+    example: "42",
+    name: "Telegram message_thread_id",
+    pattern: /^\d+$/u,
+};
+const TELEGRAM_BASE_CODEC = createNativeTargetCodec({
+    channel: TELEGRAM_CHAT_ID_RULE,
+    channelLabel: "Telegram chat_id",
+    thread: TELEGRAM_MESSAGE_THREAD_ID_RULE,
+    threadLabel: "Telegram message_thread_id",
+});
+const TELEGRAM_CODEC = {
+    normalize(target) {
+        const normalized = TELEGRAM_BASE_CODEC.normalize({
+            ...target,
+            threadId: undefined,
+        });
+        if (!target.threadId) {
+            return normalized;
+        }
+        const topicId = requireNativeId(target.threadId, TELEGRAM_MESSAGE_THREAD_ID_RULE, "Telegram message_thread_id");
+        return {
+            ...normalized,
+            threadId: `${normalized.channelId}:${topicId}`,
+        };
+    },
+    resolveThreadId(target) {
+        const normalized = this.normalize(target);
+        return normalized.threadId ?? normalized.channelId ?? normalized.id;
+    },
+};
+export function normalizeTelegramWebhookPayload(payload) {
+    if (!isRecord(payload)) {
+        throw new CrablineError("Telegram webhook payload must be an object", { kind: "inbound" });
+    }
+    const message = optionalRecord(payload, "message") ??
+        optionalRecord(payload, "edited_message") ??
+        optionalRecord(payload, "channel_post");
+    if (!message) {
+        return genericMockPayloadWithNativeThread({
+            channelRule: TELEGRAM_CHAT_ID_RULE,
+            payload,
+            threadRule: TELEGRAM_MESSAGE_THREAD_ID_RULE,
+        });
+    }
+    const chat = optionalRecord(message, "chat");
+    const chatId = chat ? optionalStringish(chat, "id") : undefined;
+    const text = optionalString(message, "text") ?? optionalString(message, "caption");
+    if (!chatId || !text) {
+        throw new CrablineError("Telegram update requires message.chat.id and message.text", {
+            kind: "inbound",
+        });
+    }
+    const topicId = optionalStringish(message, "message_thread_id");
+    const normalizedChatId = requireNativeInboundId(chatId, TELEGRAM_CHAT_ID_RULE, "Telegram message.chat.id");
+    const from = optionalRecord(message, "from");
+    return {
+        author: authorFromBotFlag(from?.is_bot === true),
+        ...(optionalStringish(message, "message_id")
+            ? { id: optionalStringish(message, "message_id") }
+            : optionalStringish(payload, "update_id")
+                ? { id: optionalStringish(payload, "update_id") }
+                : {}),
+        raw: payload,
+        text,
+        threadId: topicId
+            ? `${normalizedChatId}:${requireNativeInboundId(topicId, TELEGRAM_MESSAGE_THREAD_ID_RULE, "Telegram message.message_thread_id")}`
+            : normalizedChatId,
+    };
+}
+export class TelegramProviderAdapter extends LocalMockProviderAdapter {
+    constructor(id, config, _userName) {
+        super({
+            codec: TELEGRAM_CODEC,
+            config,
+            id,
+            options: {
+                defaultWebhook: {
+                    host: "127.0.0.1",
+                    path: "/telegram/webhook",
+                    port: 8790,
+                },
+                endpointLabel: "webhook endpoint",
+                normalizeWebhookPayload: normalizeTelegramWebhookPayload,
+                platform: "telegram",
+                publicUrl: config.telegram?.webhook.publicUrl,
+                recorderPath: toRecorderPath(id, config),
+                webhook: config.telegram?.webhook,
+            },
+        });
+    }
+}
+//# sourceMappingURL=telegram.js.map

package/dist/src/providers/builtin/telegram.js.map

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

package/dist/src/providers/builtin/whatsapp.d.ts

@@ -0,0 +1,19 @@
+import type { ProviderConfig } from "../../config/schema.js";
+import { LocalMockProviderAdapter } from "../local-mock.js";
+import type { ProviderAdapter } from "../types.js";
+export declare function resolveWhatsAppAdapterConfig(config: ProviderConfig, env?: NodeJS.ProcessEnv): {
+    accessToken: string;
+    appSecret: string;
+    phoneNumberId: string;
+    verifyToken: string;
+};
+export declare class WhatsAppProviderAdapter extends LocalMockProviderAdapter implements ProviderAdapter {
+    constructor(id: string, config: ProviderConfig, _userName: string, _runtime?: unknown);
+}
+export declare function normalizeWhatsAppWebhookPayload(payload: unknown): {
+    author?: "assistant" | "system" | "user" | undefined;
+    authorIsBot?: boolean;
+    id?: string | undefined;
+    raw: {};
+    text?: string | undefined;
+};

package/dist/src/providers/builtin/whatsapp.js

@@ -0,0 +1,90 @@
+import path from "node:path";
+import { CrablineError } from "../../core/errors.js";
+import { LocalMockProviderAdapter } from "../local-mock.js";
+import { authorFromBotFlag, createNativeTargetCodec, genericMockPayloadWithNativeThread, isRecord, optionalRecord, optionalString, requireNativeInboundId, } from "./native-local-mock.js";
+const WHATSAPP_WA_ID_RULE = {
+    example: "15551234567",
+    name: "WhatsApp wa_id",
+    pattern: /^\d{7,15}$/u,
+};
+export function resolveWhatsAppAdapterConfig(config, env = process.env) {
+    return {
+        accessToken: config.whatsapp?.accessToken ?? env.WHATSAPP_ACCESS_TOKEN ?? "local-mock-token",
+        appSecret: config.whatsapp?.appSecret ?? env.WHATSAPP_APP_SECRET ?? "local-mock-secret",
+        phoneNumberId: config.whatsapp?.phoneNumberId ?? env.WHATSAPP_PHONE_NUMBER_ID ?? "local-mock-phone",
+        verifyToken: config.whatsapp?.verifyToken ?? env.WHATSAPP_VERIFY_TOKEN ?? "local-mock-verify",
+    };
+}
+export class WhatsAppProviderAdapter extends LocalMockProviderAdapter {
+    constructor(id, config, _userName, _runtime) {
+        super({
+            codec: createNativeTargetCodec({
+                channel: WHATSAPP_WA_ID_RULE,
+                channelLabel: "WhatsApp wa_id",
+            }),
+            config,
+            id,
+            options: {
+                defaultWebhook: { host: "127.0.0.1", path: "/whatsapp/webhook", port: 8789 },
+                endpointLabel: "webhook endpoint",
+                normalizeWebhookPayload: normalizeWhatsAppWebhookPayload,
+                platform: "whatsapp",
+                publicUrl: config.whatsapp?.webhook.publicUrl,
+                recorderPath: config.whatsapp?.recorder.path
+                    ? path.resolve(config.whatsapp.recorder.path)
+                    : undefined,
+                webhook: config.whatsapp?.webhook,
+            },
+        });
+    }
+}
+export function normalizeWhatsAppWebhookPayload(payload) {
+    if (!isRecord(payload)) {
+        throw new CrablineError("WhatsApp webhook payload must be an object", { kind: "inbound" });
+    }
+    let message;
+    if (Array.isArray(payload.entry)) {
+        for (const entry of payload.entry) {
+            if (!isRecord(entry) || !Array.isArray(entry.changes)) {
+                continue;
+            }
+            for (const change of entry.changes) {
+                if (!isRecord(change)) {
+                    continue;
+                }
+                const value = optionalRecord(change, "value");
+                const candidate = value && Array.isArray(value.messages) ? value.messages.find(isRecord) : undefined;
+                if (candidate) {
+                    message = candidate;
+                    break;
+                }
+            }
+            if (message) {
+                break;
+            }
+        }
+    }
+    if (!message) {
+        return genericMockPayloadWithNativeThread({
+            channelRule: WHATSAPP_WA_ID_RULE,
+            payload,
+            threadRule: WHATSAPP_WA_ID_RULE,
+        });
+    }
+    const text = optionalRecord(message, "text");
+    const from = optionalString(message, "from");
+    const body = text ? optionalString(text, "body") : undefined;
+    if (!from || !body) {
+        throw new CrablineError("WhatsApp webhook payload requires messages[].from and text.body", {
+            kind: "inbound",
+        });
+    }
+    return {
+        author: authorFromBotFlag(false),
+        ...(optionalString(message, "id") ? { id: optionalString(message, "id") } : {}),
+        raw: payload,
+        text: body,
+        threadId: requireNativeInboundId(from, WHATSAPP_WA_ID_RULE, "WhatsApp messages[].from"),
+    };
+}
+//# sourceMappingURL=whatsapp.js.map

package/dist/src/providers/builtin/whatsapp.js.map

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

package/dist/src/providers/builtin/zalo.d.ts

@@ -0,0 +1,17 @@
+import type { ProviderConfig } from "../../config/schema.js";
+import { LocalMockProviderAdapter } from "../local-mock.js";
+import type { ProviderAdapter } from "../types.js";
+export declare function resolveZaloAdapterConfig(config: ProviderConfig, env?: NodeJS.ProcessEnv): {
+    botToken: string;
+    webhookSecret: string | undefined;
+};
+export declare class ZaloProviderAdapter extends LocalMockProviderAdapter implements ProviderAdapter {
+    constructor(id: string, config: ProviderConfig, _userName: string, _runtime?: unknown);
+}
+export declare function normalizeZaloWebhookPayload(payload: unknown): {
+    author?: "assistant" | "system" | "user" | undefined;
+    authorIsBot?: boolean;
+    id?: string | undefined;
+    raw: {};
+    text?: string | undefined;
+};

package/dist/src/providers/builtin/zalo.js

@@ -0,0 +1,70 @@
+import path from "node:path";
+import { CrablineError } from "../../core/errors.js";
+import { LocalMockProviderAdapter } from "../local-mock.js";
+import { authorFromBotFlag, createNativeTargetCodec, genericMockPayloadWithNativeThread, isRecord, optionalRecord, optionalString, requireNativeInboundId, } from "./native-local-mock.js";
+const ZALO_ID_RULE = {
+    example: "123456789012345678",
+    name: "Zalo user or OA id",
+    pattern: /^\d{6,20}$/u,
+};
+export function resolveZaloAdapterConfig(config, env = process.env) {
+    return {
+        botToken: config.zalo?.botToken ?? env.ZALO_BOT_TOKEN ?? "local-mock-zalo-token",
+        webhookSecret: config.zalo?.webhookSecret ?? env.ZALO_WEBHOOK_SECRET,
+    };
+}
+export class ZaloProviderAdapter extends LocalMockProviderAdapter {
+    constructor(id, config, _userName, _runtime) {
+        super({
+            codec: createNativeTargetCodec({
+                channel: ZALO_ID_RULE,
+                channelLabel: "Zalo user_id or oa_id",
+            }),
+            config,
+            id,
+            options: {
+                defaultWebhook: { host: "127.0.0.1", path: "/zalo/webhook", port: 8794 },
+                endpointLabel: "webhook endpoint",
+                normalizeWebhookPayload: normalizeZaloWebhookPayload,
+                platform: "zalo",
+                publicUrl: config.zalo?.webhook.publicUrl,
+                recorderPath: config.zalo?.recorder.path
+                    ? path.resolve(config.zalo.recorder.path)
+                    : undefined,
+                webhook: config.zalo?.webhook,
+            },
+        });
+    }
+}
+export function normalizeZaloWebhookPayload(payload) {
+    if (!isRecord(payload)) {
+        throw new CrablineError("Zalo webhook payload must be an object", { kind: "inbound" });
+    }
+    if (optionalRecord(payload, "message") &&
+        optionalString(optionalRecord(payload, "message"), "threadId")) {
+        return genericMockPayloadWithNativeThread({
+            channelRule: ZALO_ID_RULE,
+            payload,
+            threadRule: ZALO_ID_RULE,
+        });
+    }
+    const sender = optionalRecord(payload, "sender");
+    const message = optionalRecord(payload, "message");
+    const senderId = sender ? optionalString(sender, "id") : undefined;
+    const text = message ? optionalString(message, "text") : undefined;
+    if (!senderId || !text) {
+        throw new CrablineError("Zalo webhook payload requires sender.id and message.text", {
+            kind: "inbound",
+        });
+    }
+    return {
+        author: authorFromBotFlag(false),
+        ...(message && optionalString(message, "msg_id")
+            ? { id: optionalString(message, "msg_id") }
+            : {}),
+        raw: payload,
+        text,
+        threadId: requireNativeInboundId(senderId, ZALO_ID_RULE, "Zalo sender.id"),
+    };
+}
+//# sourceMappingURL=zalo.js.map

package/dist/src/providers/builtin/zalo.js.map

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

package/dist/src/providers/catalog.d.ts

@@ -0,0 +1,69 @@
+import type { FixtureMode, ProviderPlatform } from "../config/schema.js";
+import type { ProviderSupportStatus } from "./types.js";
+export type CatalogEntry = {
+    notes: string;
+    platform: ProviderPlatform;
+    status: ProviderSupportStatus;
+    supports: readonly FixtureMode[];
+};
+export declare const OPENCLAW_SUPPORT_CATALOG: readonly [{
+    readonly notes: "Built-in local reference mock for development and tests.";
+    readonly platform: "loopback";
+    readonly status: "ready";
+    readonly supports: readonly ["probe", "send", "roundtrip", "agent"];
+}, CatalogEntry, {
+    readonly notes: "Built-in local Discord mock with interactions webhook shape.";
+    readonly platform: "discord";
+    readonly status: "ready";
+    readonly supports: readonly ["probe", "send", "roundtrip", "agent"];
+}, {
+    readonly notes: "Built-in local Feishu/Lark mock.";
+    readonly platform: "feishu";
+    readonly status: "ready";
+    readonly supports: readonly ["probe", "send", "roundtrip", "agent"];
+}, {
+    readonly notes: "Built-in local Google Chat mock.";
+    readonly platform: "googlechat";
+    readonly status: "ready";
+    readonly supports: readonly ["probe", "send", "roundtrip", "agent"];
+}, {
+    readonly notes: "Built-in local iMessage mock.";
+    readonly platform: "imessage";
+    readonly status: "ready";
+    readonly supports: readonly ["probe", "send", "roundtrip", "agent"];
+}, CatalogEntry, CatalogEntry, {
+    readonly notes: "Built-in local Matrix mock.";
+    readonly platform: "matrix";
+    readonly status: "ready";
+    readonly supports: readonly ["probe", "send", "roundtrip", "agent"];
+}, {
+    readonly notes: "Built-in local Mattermost mock.";
+    readonly platform: "mattermost";
+    readonly status: "ready";
+    readonly supports: readonly ["probe", "send", "roundtrip", "agent"];
+}, {
+    readonly notes: "Built-in local Microsoft Teams mock.";
+    readonly platform: "msteams";
+    readonly status: "ready";
+    readonly supports: readonly ["probe", "send", "roundtrip", "agent"];
+}, CatalogEntry, CatalogEntry, CatalogEntry, {
+    readonly notes: "Built-in local Slack mock with events webhook shape.";
+    readonly platform: "slack";
+    readonly status: "ready";
+    readonly supports: readonly ["probe", "send", "roundtrip", "agent"];
+}, CatalogEntry, {
+    readonly notes: "Built-in local Telegram mock with Bot API-style webhook shape.";
+    readonly platform: "telegram";
+    readonly status: "ready";
+    readonly supports: readonly ["probe", "send", "roundtrip", "agent"];
+}, CatalogEntry, CatalogEntry, CatalogEntry, {
+    readonly notes: "Built-in local WhatsApp mock with Business webhook shape.";
+    readonly platform: "whatsapp";
+    readonly status: "ready";
+    readonly supports: readonly ["probe", "send", "roundtrip", "agent"];
+}, {
+    readonly notes: "Built-in local Zalo mock.";
+    readonly platform: "zalo";
+    readonly status: "ready";
+    readonly supports: readonly ["probe", "send", "roundtrip", "agent"];
+}, CatalogEntry];

package/dist/src/providers/catalog.js

@@ -0,0 +1,95 @@
+const COMMON_BRIDGE_SUPPORT = ["probe", "send", "roundtrip", "agent"];
+function createBridgeEntry(platform, notes) {
+    return {
+        notes,
+        platform,
+        status: "bridge",
+        supports: COMMON_BRIDGE_SUPPORT,
+    };
+}
+export const OPENCLAW_SUPPORT_CATALOG = [
+    {
+        notes: "Built-in local reference mock for development and tests.",
+        platform: "loopback",
+        status: "ready",
+        supports: COMMON_BRIDGE_SUPPORT,
+    },
+    createBridgeEntry("bluebubbles", "OpenClaw channel via script bridge. Recommended iMessage path."),
+    {
+        notes: "Built-in local Discord mock with interactions webhook shape.",
+        platform: "discord",
+        status: "ready",
+        supports: COMMON_BRIDGE_SUPPORT,
+    },
+    {
+        notes: "Built-in local Feishu/Lark mock.",
+        platform: "feishu",
+        status: "ready",
+        supports: COMMON_BRIDGE_SUPPORT,
+    },
+    {
+        notes: "Built-in local Google Chat mock.",
+        platform: "googlechat",
+        status: "ready",
+        supports: COMMON_BRIDGE_SUPPORT,
+    },
+    {
+        notes: "Built-in local iMessage mock.",
+        platform: "imessage",
+        status: "ready",
+        supports: COMMON_BRIDGE_SUPPORT,
+    },
+    createBridgeEntry("irc", "OpenClaw channel via script bridge."),
+    createBridgeEntry("line", "OpenClaw plugin channel via script bridge."),
+    {
+        notes: "Built-in local Matrix mock.",
+        platform: "matrix",
+        status: "ready",
+        supports: COMMON_BRIDGE_SUPPORT,
+    },
+    {
+        notes: "Built-in local Mattermost mock.",
+        platform: "mattermost",
+        status: "ready",
+        supports: COMMON_BRIDGE_SUPPORT,
+    },
+    {
+        notes: "Built-in local Microsoft Teams mock.",
+        platform: "msteams",
+        status: "ready",
+        supports: COMMON_BRIDGE_SUPPORT,
+    },
+    createBridgeEntry("nextcloudtalk", "OpenClaw plugin channel via script bridge."),
+    createBridgeEntry("nostr", "OpenClaw plugin channel via script bridge."),
+    createBridgeEntry("signal", "OpenClaw channel via script bridge."),
+    {
+        notes: "Built-in local Slack mock with events webhook shape.",
+        platform: "slack",
+        status: "ready",
+        supports: COMMON_BRIDGE_SUPPORT,
+    },
+    createBridgeEntry("synologychat", "OpenClaw plugin channel via script bridge."),
+    {
+        notes: "Built-in local Telegram mock with Bot API-style webhook shape.",
+        platform: "telegram",
+        status: "ready",
+        supports: COMMON_BRIDGE_SUPPORT,
+    },
+    createBridgeEntry("tlon", "OpenClaw plugin channel via script bridge."),
+    createBridgeEntry("twitch", "OpenClaw plugin channel via script bridge."),
+    createBridgeEntry("webchat", "OpenClaw web channel via script bridge."),
+    {
+        notes: "Built-in local WhatsApp mock with Business webhook shape.",
+        platform: "whatsapp",
+        status: "ready",
+        supports: COMMON_BRIDGE_SUPPORT,
+    },
+    {
+        notes: "Built-in local Zalo mock.",
+        platform: "zalo",
+        status: "ready",
+        supports: COMMON_BRIDGE_SUPPORT,
+    },
+    createBridgeEntry("zalouser", "OpenClaw plugin personal-account channel via script bridge."),
+];
+//# sourceMappingURL=catalog.js.map

package/dist/src/providers/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../src/providers/catalog.ts"],"names":[],"mappings":"AAUA,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,CAAU,CAAC;AAE/E,SAAS,iBAAiB,CAAC,QAA0B,EAAE,KAAa;IAClE,OAAO;QACL,KAAK;QACL,QAAQ;QACR,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,qBAAqB;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC;QACE,KAAK,EAAE,0DAA0D;QACjE,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,qBAAqB;KAChC;IACD,iBAAiB,CACf,aAAa,EACb,gEAAgE,CACjE;IACD;QACE,KAAK,EAAE,8DAA8D;QACrE,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,qBAAqB;KAChC;IACD;QACE,KAAK,EAAE,kCAAkC;QACzC,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,qBAAqB;KAChC;IACD;QACE,KAAK,EAAE,kCAAkC;QACzC,QAAQ,EAAE,YAAY;QACtB,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,qBAAqB;KAChC;IACD;QACE,KAAK,EAAE,+BAA+B;QACtC,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,qBAAqB;KAChC;IACD,iBAAiB,CAAC,KAAK,EAAE,qCAAqC,CAAC;IAC/D,iBAAiB,CAAC,MAAM,EAAE,4CAA4C,CAAC;IACvE;QACE,KAAK,EAAE,6BAA6B;QACpC,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,qBAAqB;KAChC;IACD;QACE,KAAK,EAAE,iCAAiC;QACxC,QAAQ,EAAE,YAAY;QACtB,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,qBAAqB;KAChC;IACD;QACE,KAAK,EAAE,sCAAsC;QAC7C,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,qBAAqB;KAChC;IACD,iBAAiB,CAAC,eAAe,EAAE,4CAA4C,CAAC;IAChF,iBAAiB,CAAC,OAAO,EAAE,4CAA4C,CAAC;IACxE,iBAAiB,CAAC,QAAQ,EAAE,qCAAqC,CAAC;IAClE;QACE,KAAK,EAAE,sDAAsD;QAC7D,QAAQ,EAAE,OAAO;QACjB,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,qBAAqB;KAChC;IACD,iBAAiB,CAAC,cAAc,EAAE,4CAA4C,CAAC;IAC/E;QACE,KAAK,EAAE,gEAAgE;QACvE,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,qBAAqB;KAChC;IACD,iBAAiB,CAAC,MAAM,EAAE,4CAA4C,CAAC;IACvE,iBAAiB,CAAC,QAAQ,EAAE,4CAA4C,CAAC;IACzE,iBAAiB,CAAC,SAAS,EAAE,yCAAyC,CAAC;IACvE;QACE,KAAK,EAAE,2DAA2D;QAClE,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,qBAAqB;KAChC;IACD;QACE,KAAK,EAAE,2BAA2B;QAClC,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,qBAAqB;KAChC;IACD,iBAAiB,CAAC,UAAU,EAAE,6DAA6D,CAAC;CAClD,CAAC"}

package/dist/src/providers/local-mock.d.ts

@@ -0,0 +1,41 @@
+import type { ProviderConfig, ProviderPlatform } from "../config/schema.js";
+import type { InboundEnvelope, NormalizedTarget, ProbeResult, ProviderAdapter, ProviderContext, SendContext, SendResult, WaitContext, WatchContext } from "./types.js";
+export type LocalMockWebhookConfig = {
+    host?: string;
+    path?: string;
+    port?: number;
+    publicUrl?: string | undefined;
+};
+export type LocalMockAdapterOptions = {
+    defaultWebhook: Required<Pick<LocalMockWebhookConfig, "host" | "path" | "port">>;
+    endpointLabel: string;
+    normalizeWebhookPayload?: (payload: unknown) => unknown;
+    platform: ProviderPlatform;
+    publicUrl?: string | undefined;
+    recorderPath?: string | undefined;
+    webhook?: LocalMockWebhookConfig | undefined;
+};
+export type LocalMockTargetCodec = {
+    normalize(target: ProviderContext["fixture"]["target"]): NormalizedTarget;
+    resolveThreadId(target: ProviderContext["fixture"]["target"]): string;
+};
+export declare function createGenericLocalMockTargetCodec(platform: ProviderPlatform): LocalMockTargetCodec;
+export declare class LocalMockProviderAdapter implements ProviderAdapter {
+    #private;
+    readonly id: string;
+    readonly platform: "bluebubbles" | "discord" | "feishu" | "googlechat" | "imessage" | "irc" | "line" | "loopback" | "matrix" | "mattermost" | "msteams" | "nextcloudtalk" | "nostr" | "signal" | "slack" | "synologychat" | "telegram" | "tlon" | "twitch" | "webchat" | "whatsapp" | "zalo" | "zalouser";
+    readonly status: "ready";
+    readonly supports: readonly ["probe", "send", "roundtrip", "agent"];
+    constructor(params: {
+        codec: LocalMockTargetCodec;
+        config: ProviderConfig;
+        id: string;
+        options: LocalMockAdapterOptions;
+    });
+    normalizeTarget(target: ProviderContext["fixture"]["target"]): NormalizedTarget;
+    probe(context: ProviderContext): Promise<ProbeResult>;
+    send(context: SendContext): Promise<SendResult>;
+    waitForInbound(context: WaitContext): Promise<InboundEnvelope | null>;
+    watch(context: WatchContext): AsyncIterable<InboundEnvelope>;
+    cleanup(): Promise<void>;
+}