Jean-Marc 03586e3d00
feat(channels): add Synology Chat native channel (#23012)
* feat(channels): add Synology Chat native channel

Webhook-based integration with Synology NAS Chat (DSM 7+).
Supports outgoing webhooks, incoming messages, multi-account,
DM policies, rate limiting, and input sanitization.

- HMAC-based constant-time token validation
- Configurable SSL verification (allowInsecureSsl) for self-signed NAS certs
- 54 unit tests across 5 test suites
- Follows the same ChannelPlugin pattern as LINE/Discord/Telegram

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(synology-chat): add pairing, warnings, messaging, agent hints

- Enable media capability (file_url already supported by client)
- Add pairing.notifyApproval to message approved users
- Add security.collectWarnings for missing token/URL, insecure SSL, open DM policy
- Add messaging.normalizeTarget and targetResolver for user ID resolution
- Add directory stubs (self, listPeers, listGroups)
- Add agentPrompt.messageToolHints with Synology Chat formatting guide
- 63 tests (up from 54), all passing

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-22 00:09:58 +01:00

134 lines
4.1 KiB
TypeScript

import { describe, it, expect, vi, beforeEach } from "vitest";
import { listAccountIds, resolveAccount } from "./accounts.js";
// Save and restore env vars
const originalEnv = { ...process.env };
beforeEach(() => {
// Clean synology-related env vars before each test
delete process.env.SYNOLOGY_CHAT_TOKEN;
delete process.env.SYNOLOGY_CHAT_INCOMING_URL;
delete process.env.SYNOLOGY_NAS_HOST;
delete process.env.SYNOLOGY_ALLOWED_USER_IDS;
delete process.env.SYNOLOGY_RATE_LIMIT;
delete process.env.OPENCLAW_BOT_NAME;
});
describe("listAccountIds", () => {
it("returns empty array when no channel config", () => {
expect(listAccountIds({})).toEqual([]);
expect(listAccountIds({ channels: {} })).toEqual([]);
});
it("returns ['default'] when base config has token", () => {
const cfg = { channels: { "synology-chat": { token: "abc" } } };
expect(listAccountIds(cfg)).toEqual(["default"]);
});
it("returns ['default'] when env var has token", () => {
process.env.SYNOLOGY_CHAT_TOKEN = "env-token";
const cfg = { channels: { "synology-chat": {} } };
expect(listAccountIds(cfg)).toEqual(["default"]);
});
it("returns named accounts", () => {
const cfg = {
channels: {
"synology-chat": {
accounts: { work: { token: "t1" }, home: { token: "t2" } },
},
},
};
const ids = listAccountIds(cfg);
expect(ids).toContain("work");
expect(ids).toContain("home");
});
it("returns default + named accounts", () => {
const cfg = {
channels: {
"synology-chat": {
token: "base-token",
accounts: { work: { token: "t1" } },
},
},
};
const ids = listAccountIds(cfg);
expect(ids).toContain("default");
expect(ids).toContain("work");
});
});
describe("resolveAccount", () => {
it("returns full defaults for empty config", () => {
const cfg = { channels: { "synology-chat": {} } };
const account = resolveAccount(cfg, "default");
expect(account.accountId).toBe("default");
expect(account.enabled).toBe(true);
expect(account.webhookPath).toBe("/webhook/synology");
expect(account.dmPolicy).toBe("allowlist");
expect(account.rateLimitPerMinute).toBe(30);
expect(account.botName).toBe("OpenClaw");
});
it("uses env var fallbacks", () => {
process.env.SYNOLOGY_CHAT_TOKEN = "env-tok";
process.env.SYNOLOGY_CHAT_INCOMING_URL = "https://nas/incoming";
process.env.SYNOLOGY_NAS_HOST = "192.0.2.1";
process.env.OPENCLAW_BOT_NAME = "TestBot";
const cfg = { channels: { "synology-chat": {} } };
const account = resolveAccount(cfg);
expect(account.token).toBe("env-tok");
expect(account.incomingUrl).toBe("https://nas/incoming");
expect(account.nasHost).toBe("192.0.2.1");
expect(account.botName).toBe("TestBot");
});
it("config overrides env vars", () => {
process.env.SYNOLOGY_CHAT_TOKEN = "env-tok";
const cfg = {
channels: { "synology-chat": { token: "config-tok" } },
};
const account = resolveAccount(cfg);
expect(account.token).toBe("config-tok");
});
it("account override takes priority over base config", () => {
const cfg = {
channels: {
"synology-chat": {
token: "base-tok",
botName: "BaseName",
accounts: {
work: { token: "work-tok", botName: "WorkBot" },
},
},
},
};
const account = resolveAccount(cfg, "work");
expect(account.token).toBe("work-tok");
expect(account.botName).toBe("WorkBot");
});
it("parses comma-separated allowedUserIds string", () => {
const cfg = {
channels: {
"synology-chat": { allowedUserIds: "user1, user2, user3" },
},
};
const account = resolveAccount(cfg);
expect(account.allowedUserIds).toEqual(["user1", "user2", "user3"]);
});
it("handles allowedUserIds as array", () => {
const cfg = {
channels: {
"synology-chat": { allowedUserIds: ["u1", "u2"] },
},
};
const account = resolveAccount(cfg);
expect(account.allowedUserIds).toEqual(["u1", "u2"]);
});
});