321 lines
11 KiB
TypeScript
321 lines
11 KiB
TypeScript
import type { ChannelAccountSnapshot, ChannelPlugin, ClawdbotConfig } from "clawdbot/plugin-sdk";
|
|
import {
|
|
applyAccountNameToChannelSection,
|
|
buildChannelConfigSchema,
|
|
DEFAULT_ACCOUNT_ID,
|
|
deleteAccountFromConfigSection,
|
|
formatPairingApproveHint,
|
|
migrateBaseNameToDefaultAccount,
|
|
normalizeAccountId,
|
|
PAIRING_APPROVED_MESSAGE,
|
|
setAccountEnabledInConfigSection,
|
|
} from "clawdbot/plugin-sdk";
|
|
|
|
import {
|
|
listBlueBubblesAccountIds,
|
|
type ResolvedBlueBubblesAccount,
|
|
resolveBlueBubblesAccount,
|
|
resolveDefaultBlueBubblesAccountId,
|
|
} from "./accounts.js";
|
|
import { BlueBubblesConfigSchema } from "./config-schema.js";
|
|
import { probeBlueBubbles } from "./probe.js";
|
|
import { sendMessageBlueBubbles } from "./send.js";
|
|
import { sendBlueBubblesAttachment } from "./attachments.js";
|
|
import { normalizeBlueBubblesHandle } from "./targets.js";
|
|
import { bluebubblesMessageActions } from "./actions.js";
|
|
import { monitorBlueBubblesProvider, resolveWebhookPathFromConfig } from "./monitor.js";
|
|
import { blueBubblesOnboardingAdapter } from "./onboarding.js";
|
|
|
|
const meta = {
|
|
id: "bluebubbles",
|
|
label: "BlueBubbles",
|
|
selectionLabel: "BlueBubbles (macOS app)",
|
|
docsPath: "/channels/bluebubbles",
|
|
docsLabel: "bluebubbles",
|
|
blurb: "iMessage via the BlueBubbles mac app + REST API.",
|
|
order: 75,
|
|
};
|
|
|
|
export const bluebubblesPlugin: ChannelPlugin<ResolvedBlueBubblesAccount> = {
|
|
id: "bluebubbles",
|
|
meta,
|
|
capabilities: {
|
|
chatTypes: ["direct", "group"],
|
|
media: true,
|
|
reactions: true,
|
|
edit: true,
|
|
unsend: true,
|
|
reply: true,
|
|
effects: true,
|
|
groupManagement: true,
|
|
},
|
|
reload: { configPrefixes: ["channels.bluebubbles"] },
|
|
configSchema: buildChannelConfigSchema(BlueBubblesConfigSchema),
|
|
onboarding: blueBubblesOnboardingAdapter,
|
|
config: {
|
|
listAccountIds: (cfg) => listBlueBubblesAccountIds(cfg as ClawdbotConfig),
|
|
resolveAccount: (cfg, accountId) =>
|
|
resolveBlueBubblesAccount({ cfg: cfg as ClawdbotConfig, accountId }),
|
|
defaultAccountId: (cfg) => resolveDefaultBlueBubblesAccountId(cfg as ClawdbotConfig),
|
|
setAccountEnabled: ({ cfg, accountId, enabled }) =>
|
|
setAccountEnabledInConfigSection({
|
|
cfg: cfg as ClawdbotConfig,
|
|
sectionKey: "bluebubbles",
|
|
accountId,
|
|
enabled,
|
|
allowTopLevel: true,
|
|
}),
|
|
deleteAccount: ({ cfg, accountId }) =>
|
|
deleteAccountFromConfigSection({
|
|
cfg: cfg as ClawdbotConfig,
|
|
sectionKey: "bluebubbles",
|
|
accountId,
|
|
clearBaseFields: ["serverUrl", "password", "name", "webhookPath"],
|
|
}),
|
|
isConfigured: (account) => account.configured,
|
|
describeAccount: (account): ChannelAccountSnapshot => ({
|
|
accountId: account.accountId,
|
|
name: account.name,
|
|
enabled: account.enabled,
|
|
configured: account.configured,
|
|
baseUrl: account.baseUrl,
|
|
}),
|
|
resolveAllowFrom: ({ cfg, accountId }) =>
|
|
(resolveBlueBubblesAccount({ cfg: cfg as ClawdbotConfig, accountId }).config.allowFrom ??
|
|
[]).map(
|
|
(entry) => String(entry),
|
|
),
|
|
formatAllowFrom: ({ allowFrom }) =>
|
|
allowFrom
|
|
.map((entry) => String(entry).trim())
|
|
.filter(Boolean)
|
|
.map((entry) => entry.replace(/^bluebubbles:/i, ""))
|
|
.map((entry) => normalizeBlueBubblesHandle(entry)),
|
|
},
|
|
actions: bluebubblesMessageActions,
|
|
security: {
|
|
resolveDmPolicy: ({ cfg, accountId, account }) => {
|
|
const resolvedAccountId = accountId ?? account.accountId ?? DEFAULT_ACCOUNT_ID;
|
|
const useAccountPath = Boolean(
|
|
(cfg as ClawdbotConfig).channels?.bluebubbles?.accounts?.[resolvedAccountId],
|
|
);
|
|
const basePath = useAccountPath
|
|
? `channels.bluebubbles.accounts.${resolvedAccountId}.`
|
|
: "channels.bluebubbles.";
|
|
return {
|
|
policy: account.config.dmPolicy ?? "pairing",
|
|
allowFrom: account.config.allowFrom ?? [],
|
|
policyPath: `${basePath}dmPolicy`,
|
|
allowFromPath: basePath,
|
|
approveHint: formatPairingApproveHint("bluebubbles"),
|
|
normalizeEntry: (raw) => normalizeBlueBubblesHandle(raw.replace(/^bluebubbles:/i, "")),
|
|
};
|
|
},
|
|
collectWarnings: ({ account }) => {
|
|
const groupPolicy = account.config.groupPolicy ?? "allowlist";
|
|
if (groupPolicy !== "open") return [];
|
|
return [
|
|
`- BlueBubbles groups: groupPolicy="open" allows any member to trigger the bot. Set channels.bluebubbles.groupPolicy="allowlist" + channels.bluebubbles.groupAllowFrom to restrict senders.`,
|
|
];
|
|
},
|
|
},
|
|
setup: {
|
|
resolveAccountId: ({ accountId }) => normalizeAccountId(accountId),
|
|
applyAccountName: ({ cfg, accountId, name }) =>
|
|
applyAccountNameToChannelSection({
|
|
cfg: cfg as ClawdbotConfig,
|
|
channelKey: "bluebubbles",
|
|
accountId,
|
|
name,
|
|
}),
|
|
validateInput: ({ input }) => {
|
|
if (!input.httpUrl && !input.password) {
|
|
return "BlueBubbles requires --http-url and --password.";
|
|
}
|
|
if (!input.httpUrl) return "BlueBubbles requires --http-url.";
|
|
if (!input.password) return "BlueBubbles requires --password.";
|
|
return null;
|
|
},
|
|
applyAccountConfig: ({ cfg, accountId, input }) => {
|
|
const namedConfig = applyAccountNameToChannelSection({
|
|
cfg: cfg as ClawdbotConfig,
|
|
channelKey: "bluebubbles",
|
|
accountId,
|
|
name: input.name,
|
|
});
|
|
const next =
|
|
accountId !== DEFAULT_ACCOUNT_ID
|
|
? migrateBaseNameToDefaultAccount({
|
|
cfg: namedConfig,
|
|
channelKey: "bluebubbles",
|
|
})
|
|
: namedConfig;
|
|
if (accountId === DEFAULT_ACCOUNT_ID) {
|
|
return {
|
|
...next,
|
|
channels: {
|
|
...next.channels,
|
|
bluebubbles: {
|
|
...next.channels?.bluebubbles,
|
|
enabled: true,
|
|
...(input.httpUrl ? { serverUrl: input.httpUrl } : {}),
|
|
...(input.password ? { password: input.password } : {}),
|
|
...(input.webhookPath ? { webhookPath: input.webhookPath } : {}),
|
|
},
|
|
},
|
|
} as ClawdbotConfig;
|
|
}
|
|
return {
|
|
...next,
|
|
channels: {
|
|
...next.channels,
|
|
bluebubbles: {
|
|
...next.channels?.bluebubbles,
|
|
enabled: true,
|
|
accounts: {
|
|
...(next.channels?.bluebubbles?.accounts ?? {}),
|
|
[accountId]: {
|
|
...(next.channels?.bluebubbles?.accounts?.[accountId] ?? {}),
|
|
enabled: true,
|
|
...(input.httpUrl ? { serverUrl: input.httpUrl } : {}),
|
|
...(input.password ? { password: input.password } : {}),
|
|
...(input.webhookPath ? { webhookPath: input.webhookPath } : {}),
|
|
},
|
|
},
|
|
},
|
|
},
|
|
} as ClawdbotConfig;
|
|
},
|
|
},
|
|
pairing: {
|
|
idLabel: "bluebubblesSenderId",
|
|
normalizeAllowEntry: (entry) => normalizeBlueBubblesHandle(entry.replace(/^bluebubbles:/i, "")),
|
|
notifyApproval: async ({ cfg, id }) => {
|
|
await sendMessageBlueBubbles(id, PAIRING_APPROVED_MESSAGE, {
|
|
cfg: cfg as ClawdbotConfig,
|
|
});
|
|
},
|
|
},
|
|
outbound: {
|
|
deliveryMode: "direct",
|
|
textChunkLimit: 4000,
|
|
resolveTarget: ({ to }) => {
|
|
const trimmed = to?.trim();
|
|
if (!trimmed) {
|
|
return {
|
|
ok: false,
|
|
error: new Error("Delivering to BlueBubbles requires --to <handle|chat_guid:GUID>"),
|
|
};
|
|
}
|
|
return { ok: true, to: trimmed };
|
|
},
|
|
sendText: async ({ cfg, to, text, accountId }) => {
|
|
const result = await sendMessageBlueBubbles(to, text, {
|
|
cfg: cfg as ClawdbotConfig,
|
|
accountId: accountId ?? undefined,
|
|
});
|
|
return { channel: "bluebubbles", ...result };
|
|
},
|
|
sendMedia: async ({ cfg, to, mediaPath, mediaBuffer, contentType, filename, caption, accountId }) => {
|
|
// Prefer buffer if provided, otherwise read from path
|
|
let buffer: Uint8Array;
|
|
if (mediaBuffer) {
|
|
buffer = mediaBuffer;
|
|
} else if (mediaPath) {
|
|
const fs = await import("node:fs/promises");
|
|
buffer = new Uint8Array(await fs.readFile(mediaPath));
|
|
} else {
|
|
throw new Error("BlueBubbles media delivery requires mediaPath or mediaBuffer.");
|
|
}
|
|
|
|
// Resolve filename from path if not provided
|
|
const resolvedFilename = filename ?? (mediaPath ? mediaPath.split("/").pop() ?? "attachment" : "attachment");
|
|
|
|
const result = await sendBlueBubblesAttachment({
|
|
to,
|
|
buffer,
|
|
filename: resolvedFilename,
|
|
contentType: contentType ?? undefined,
|
|
caption: caption ?? undefined,
|
|
opts: {
|
|
cfg: cfg as ClawdbotConfig,
|
|
accountId: accountId ?? undefined,
|
|
},
|
|
});
|
|
|
|
return { channel: "bluebubbles", ...result };
|
|
},
|
|
},
|
|
status: {
|
|
defaultRuntime: {
|
|
accountId: DEFAULT_ACCOUNT_ID,
|
|
running: false,
|
|
lastStartAt: null,
|
|
lastStopAt: null,
|
|
lastError: null,
|
|
},
|
|
collectStatusIssues: (accounts) =>
|
|
accounts.flatMap((account) => {
|
|
const lastError = typeof account.lastError === "string" ? account.lastError.trim() : "";
|
|
if (!lastError) return [];
|
|
return [
|
|
{
|
|
channel: "bluebubbles",
|
|
accountId: account.accountId,
|
|
kind: "runtime",
|
|
message: `Channel error: ${lastError}`,
|
|
},
|
|
];
|
|
}),
|
|
buildChannelSummary: ({ snapshot }) => ({
|
|
configured: snapshot.configured ?? false,
|
|
baseUrl: snapshot.baseUrl ?? null,
|
|
running: snapshot.running ?? false,
|
|
lastStartAt: snapshot.lastStartAt ?? null,
|
|
lastStopAt: snapshot.lastStopAt ?? null,
|
|
lastError: snapshot.lastError ?? null,
|
|
probe: snapshot.probe,
|
|
lastProbeAt: snapshot.lastProbeAt ?? null,
|
|
}),
|
|
probeAccount: async ({ account, timeoutMs }) =>
|
|
probeBlueBubbles({
|
|
baseUrl: account.baseUrl,
|
|
password: account.config.password ?? null,
|
|
timeoutMs,
|
|
}),
|
|
buildAccountSnapshot: ({ account, runtime, probe }) => ({
|
|
accountId: account.accountId,
|
|
name: account.name,
|
|
enabled: account.enabled,
|
|
configured: account.configured,
|
|
baseUrl: account.baseUrl,
|
|
running: runtime?.running ?? false,
|
|
lastStartAt: runtime?.lastStartAt ?? null,
|
|
lastStopAt: runtime?.lastStopAt ?? null,
|
|
lastError: runtime?.lastError ?? null,
|
|
probe,
|
|
lastInboundAt: runtime?.lastInboundAt ?? null,
|
|
lastOutboundAt: runtime?.lastOutboundAt ?? null,
|
|
}),
|
|
},
|
|
gateway: {
|
|
startAccount: async (ctx) => {
|
|
const account = ctx.account;
|
|
const webhookPath = resolveWebhookPathFromConfig(account.config);
|
|
ctx.setStatus({
|
|
accountId: account.accountId,
|
|
baseUrl: account.baseUrl,
|
|
});
|
|
ctx.log?.info(`[${account.accountId}] starting provider (webhook=${webhookPath})`);
|
|
return monitorBlueBubblesProvider({
|
|
account,
|
|
config: ctx.cfg as ClawdbotConfig,
|
|
runtime: ctx.runtime,
|
|
abortSignal: ctx.abortSignal,
|
|
statusSink: (patch) => ctx.setStatus({ accountId: ctx.accountId, ...patch }),
|
|
webhookPath,
|
|
});
|
|
},
|
|
},
|
|
};
|