@cogenta/channels 0.1.0

package/dist/providers/discord/inbound.js

@@ -0,0 +1,75 @@
+const CHANNEL_NAME = 'discord';
+const MESSAGE_COMPONENT = 3;
+/**
+ * The real routing/authorization wiring for one Discord dispatch event —
+ * extracted from the adapter, same shape as `providers/slack/inbound.ts`.
+ * Handles both a typed message (`MESSAGE_CREATE`) and a button press
+ * (`INTERACTION_CREATE` with `type: MESSAGE_COMPONENT`, whose `custom_id` is
+ * itself a command string rendered by `render.ts`) through the exact same
+ * `CommandRouter.route()`, never a second, parallel authorization path.
+ */
+export function createDiscordInboundHandler(deps) {
+    async function resolveIdentity(channelUserId) {
+        return deps.linkStore.resolveIdentity(CHANNEL_NAME, channelUserId);
+    }
+    async function reply(channelId, content) {
+        await deps.client.sendMessage({ channelId, content });
+    }
+    async function handleText(channelId, channelUserId, text) {
+        let identity = await resolveIdentity(channelUserId);
+        if (identity.linkedUserId === null) {
+            // An unlinked identity gets exactly one thing to try: the message AS
+            // a linking code. Any other failure stays silent — "Une identité de
+            // canal non liée à un compte est ignorée, sans réponse."
+            try {
+                await deps.linkStore.verifyCode(text.trim(), CHANNEL_NAME, channelUserId);
+                identity = await resolveIdentity(channelUserId);
+                await reply(channelId, '✅ Compte lié. Vous pouvez maintenant utiliser les commandes.');
+            }
+            catch {
+                // Wrong/expired/nonexistent code from an unlinked identity: silence.
+            }
+            const handler = deps.getExternalHandler();
+            if (handler !== undefined)
+                await handler({ text, identity });
+            return;
+        }
+        const handler = deps.getExternalHandler();
+        if (handler !== undefined)
+            await handler({ text, identity });
+        const result = await deps.router.route(text, identity);
+        if (!result.shouldReply)
+            return;
+        if (result.kind === 'forbidden') {
+            await reply(channelId, "⛔ Vous n'avez pas la permission d'exécuter cette commande.");
+        }
+        else if (result.kind === 'unrecognized') {
+            await reply(channelId, `Commande inconnue : ${result.commandName}`);
+        }
+    }
+    return async function handleDispatch(event) {
+        if (event.type === 'MESSAGE_CREATE') {
+            const data = event.data;
+            if (data.author.bot === true)
+                return;
+            await handleText(data.channel_id, data.author.id, data.content);
+            return;
+        }
+        if (event.type === 'INTERACTION_CREATE') {
+            const data = event.data;
+            if (data.type !== MESSAGE_COMPONENT)
+                return;
+            const channelUserId = data.member?.user.id ?? data.user?.id;
+            const customId = data.data?.custom_id;
+            if (channelUserId === undefined || customId === undefined || data.channel_id === undefined) {
+                return;
+            }
+            // Discord requires an ack within 3s or the component shows "This
+            // interaction failed" — a deferred update, no visible change; any
+            // real reply is a normal follow-up message, same as the text path.
+            await deps.client.acknowledgeInteraction(data.id, data.token);
+            await handleText(data.channel_id, channelUserId, customId);
+        }
+    };
+}
+//# sourceMappingURL=inbound.js.map

package/dist/providers/discord/inbound.js.map

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

package/dist/providers/discord/render.d.ts

@@ -0,0 +1,9 @@
+import type { ChannelMessage } from '../../adapter.js';
+import type { DiscordActionRow, DiscordEmbed } from './client.js';
+export interface RenderedDiscordMessage {
+    readonly content?: string;
+    readonly embeds: readonly DiscordEmbed[];
+    readonly components: readonly DiscordActionRow[];
+}
+export declare function renderDiscordMessage(message: ChannelMessage): RenderedDiscordMessage;
+//# sourceMappingURL=render.d.ts.map

package/dist/providers/discord/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/providers/discord/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,cAAc,EAAmB,MAAM,kBAAkB,CAAA;AACtF,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAuCjE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAA;IACxC,QAAQ,CAAC,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAA;CACjD;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,sBAAsB,CAyCpF"}

package/dist/providers/discord/render.js

@@ -0,0 +1,73 @@
+/**
+ * "On n'écrit pas de Markdown Telegram dans le code métier" applies just as
+ * much to Discord's own embed format — everything platform-specific lives
+ * in this module, `ChannelMessage` never knows embeds exist.
+ */
+const SEVERITY_COLOR = {
+    info: 0x5865f2, // Discord blurple
+    warning: 0xfaa61a,
+    critical: 0xed4245,
+};
+const SEVERITY_PREFIX = {
+    info: 'ℹ️',
+    warning: '⚠️',
+    critical: '🔴',
+};
+function renderActionsRow(actions) {
+    if (actions === undefined || actions.length === 0)
+        return undefined;
+    return {
+        type: 1,
+        components: actions.map((action) => ({
+            type: 2,
+            style: 1,
+            label: action.label,
+            // `custom_id` is the command text a component interaction routes as
+            // (mirrors Telegram's `callback_data`, Slack's `action_id`/`value`) —
+            // the same `CommandRouter.route()`, never a second, parallel
+            // authorization path.
+            custom_id: action.id,
+        })),
+    };
+}
+export function renderDiscordMessage(message) {
+    if (message.level === 'notification') {
+        return { content: message.text, embeds: [], components: [] };
+    }
+    if (message.level === 'alert') {
+        const prefix = SEVERITY_PREFIX[message.severity];
+        const embed = {
+            title: `${prefix} ${message.title}`,
+            description: message.context,
+            url: message.adminUrl,
+            color: SEVERITY_COLOR[message.severity],
+            fields: [
+                { name: 'Action attendue', value: message.expectedAction },
+                { name: 'Admin', value: `[Voir dans l'admin](${message.adminUrl})` },
+            ],
+        };
+        const actionsRow = renderActionsRow(message.actions);
+        return { embeds: [embed], components: actionsRow === undefined ? [] : [actionsRow] };
+    }
+    // 'report'
+    const fields = [
+        ...message.keyFigures.map((figure) => ({
+            name: figure.label,
+            value: figure.value,
+            inline: true,
+        })),
+        ...message.sections.map((section) => ({
+            name: section.heading ?? 'Détail',
+            value: section.body,
+        })),
+    ];
+    const embed = {
+        title: message.title,
+        ...(fields.length > 0 ? { fields } : {}),
+        ...(message.moreUrl === undefined
+            ? {}
+            : { description: `[Voir le détail](${message.moreUrl})` }),
+    };
+    return { embeds: [embed], components: [] };
+}
+//# sourceMappingURL=render.js.map

package/dist/providers/discord/render.js.map

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

package/dist/providers/email/adapter.d.ts

@@ -0,0 +1,18 @@
+import type { ChannelAdapter } from '../../adapter.js';
+import { type EmailActionLinkOptions } from './render.js';
+import type { EmailTransport } from './transport.js';
+export interface EmailAdapterOptions {
+    readonly transport: EmailTransport;
+    /** Required only if messages with actions (e.g. approvals) are ever sent — see `render.ts`. */
+    readonly actionLinks?: EmailActionLinkOptions;
+}
+/**
+ * "Adaptateur email" (L6 task 8), outbound-only — the lot's task list names
+ * this adapter without the "commandes entrantes" wording task 4 gave
+ * Telegram, so no inbound parsing is built: `capabilities.inbound` is
+ * `false`, `verifyIdentity`/`onInbound` are honest refusals rather than a
+ * half-built reply-to-link-a-channel flow. `buttons` is `false` too — email
+ * has none, hence `render.ts`'s signed-link rendering for actions.
+ */
+export declare function createEmailAdapter(options: EmailAdapterOptions): ChannelAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/providers/email/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/email/adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EAKf,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,KAAK,sBAAsB,EAAsB,MAAM,aAAa,CAAA;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAIpD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAA;IAClC,+FAA+F;IAC/F,QAAQ,CAAC,WAAW,CAAC,EAAE,sBAAsB,CAAA;CAC9C;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,cAAc,CA8B/E"}

package/dist/providers/email/adapter.js

@@ -0,0 +1,41 @@
+import { CogentaError } from '@cogenta/core';
+import { renderEmailMessage } from './render.js';
+const CHANNEL_NAME = 'email';
+/**
+ * "Adaptateur email" (L6 task 8), outbound-only — the lot's task list names
+ * this adapter without the "commandes entrantes" wording task 4 gave
+ * Telegram, so no inbound parsing is built: `capabilities.inbound` is
+ * `false`, `verifyIdentity`/`onInbound` are honest refusals rather than a
+ * half-built reply-to-link-a-channel flow. `buttons` is `false` too — email
+ * has none, hence `render.ts`'s signed-link rendering for actions.
+ */
+export function createEmailAdapter(options) {
+    return {
+        name: CHANNEL_NAME,
+        capabilities: {
+            richText: true,
+            buttons: false,
+            threads: false,
+            attachments: false,
+            inbound: false,
+        },
+        async send(target, message) {
+            const rendered = renderEmailMessage(message, options.actionLinks);
+            const sent = await options.transport.send({
+                to: target.id,
+                subject: rendered.subject,
+                text: rendered.text,
+                html: rendered.html,
+            });
+            return sent.messageId;
+        },
+        async verifyIdentity() {
+            throw new CogentaError({
+                code: 'CHANNEL_EMAIL_INBOUND_UNSUPPORTED',
+                message: 'The email adapter does not support identity linking — it is outbound-only.',
+                hint: 'Link accounts through a channel with capabilities.inbound === true (e.g. Telegram).',
+            });
+        },
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/providers/email/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/providers/email/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAQ5C,OAAO,EAA+B,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAG7E,MAAM,YAAY,GAAG,OAAO,CAAA;AAQ5B;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC7D,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,YAAY,EAAE;YACZ,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,KAAK;YAClB,OAAO,EAAE,KAAK;SACf;QAED,KAAK,CAAC,IAAI,CAAC,MAAqB,EAAE,OAAuB;YACvD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;YACjE,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC;gBACxC,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;aACpB,CAAC,CAAA;YACF,OAAO,IAAI,CAAC,SAAS,CAAA;QACvB,CAAC;QAED,KAAK,CAAC,cAAc;YAClB,MAAM,IAAI,YAAY,CAAC;gBACrB,IAAI,EAAE,mCAAmC;gBACzC,OAAO,EAAE,4EAA4E;gBACrF,IAAI,EAAE,qFAAqF;aAC5F,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/providers/email/file-transport.d.ts

@@ -0,0 +1,14 @@
+import type { EmailTransport } from './transport.js';
+export interface FileEmailTransportOptions {
+    /** Directory an outgoing message is written into — created if missing. */
+    readonly directory: string;
+}
+/**
+ * The degraded, no-external-service `EmailTransport` (R1) — writes each
+ * message as a real file (subject/to headers plus both bodies) rather than
+ * sending it anywhere. Useful for local development and for driving real
+ * tests without a network, exactly like `StorageDriver`'s local filesystem
+ * implementation stands in for S3/R2/MinIO.
+ */
+export declare function createFileEmailTransport(options: FileEmailTransportOptions): EmailTransport;
+//# sourceMappingURL=file-transport.d.ts.map

package/dist/providers/email/file-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-transport.d.ts","sourceRoot":"","sources":["../../../src/providers/email/file-transport.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAA4B,MAAM,gBAAgB,CAAA;AAE9E,MAAM,WAAW,yBAAyB;IACxC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,cAAc,CAqB3F"}

package/dist/providers/email/file-transport.js

@@ -0,0 +1,33 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * The degraded, no-external-service `EmailTransport` (R1) — writes each
+ * message as a real file (subject/to headers plus both bodies) rather than
+ * sending it anywhere. Useful for local development and for driving real
+ * tests without a network, exactly like `StorageDriver`'s local filesystem
+ * implementation stands in for S3/R2/MinIO.
+ */
+export function createFileEmailTransport(options) {
+    return {
+        async send(email) {
+            await mkdir(options.directory, { recursive: true });
+            const messageId = randomUUID();
+            const contents = [
+                `To: ${email.to}`,
+                `Subject: ${email.subject}`,
+                `Message-Id: ${messageId}`,
+                '',
+                '--- text/plain ---',
+                email.text,
+                '',
+                '--- text/html ---',
+                email.html,
+                '',
+            ].join('\n');
+            await writeFile(join(options.directory, `${messageId}.eml.txt`), contents, 'utf8');
+            return { messageId };
+        },
+    };
+}
+//# sourceMappingURL=file-transport.js.map

package/dist/providers/email/file-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-transport.js","sourceRoot":"","sources":["../../../src/providers/email/file-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAQhC;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAkC;IACzE,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,KAAoB;YAC7B,MAAM,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YACnD,MAAM,SAAS,GAAG,UAAU,EAAE,CAAA;YAC9B,MAAM,QAAQ,GAAG;gBACf,OAAO,KAAK,CAAC,EAAE,EAAE;gBACjB,YAAY,KAAK,CAAC,OAAO,EAAE;gBAC3B,eAAe,SAAS,EAAE;gBAC1B,EAAE;gBACF,oBAAoB;gBACpB,KAAK,CAAC,IAAI;gBACV,EAAE;gBACF,mBAAmB;gBACnB,KAAK,CAAC,IAAI;gBACV,EAAE;aACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACZ,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,SAAS,UAAU,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;YAClF,OAAO,EAAE,SAAS,EAAE,CAAA;QACtB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/providers/email/render.d.ts

@@ -0,0 +1,20 @@
+import type { ChannelMessage } from '../../adapter.js';
+export interface EmailActionLinkOptions {
+    /** Where a future verification route lives — no such route is built yet (same gap `signed-link.ts` already documents for every buttonless channel). */
+    readonly baseUrl: string;
+    readonly signingKey: string;
+    readonly expiresInSeconds: number;
+}
+export interface RenderedEmailMessage {
+    readonly subject: string;
+    readonly text: string;
+    readonly html: string;
+}
+/**
+ * Fresh, email-native rendering — the "on n'écrit pas de Markdown Telegram
+ * dans le code métier" boundary (L6, `## Interface`) cuts both ways: nothing
+ * from `providers/telegram/render.ts` is reused here, and nothing here leaks
+ * into `ChannelMessage` itself.
+ */
+export declare function renderEmailMessage(message: ChannelMessage, actionLinks?: EmailActionLinkOptions): RenderedEmailMessage;
+//# sourceMappingURL=render.d.ts.map

package/dist/providers/email/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/providers/email/render.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGrE,MAAM,WAAW,sBAAsB;IACrC,uJAAuJ;IACvJ,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AA4DD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,cAAc,EACvB,WAAW,CAAC,EAAE,sBAAsB,GACnC,oBAAoB,CA0CtB"}

package/dist/providers/email/render.js

@@ -0,0 +1,89 @@
+import { CogentaError } from '@cogenta/core';
+import { buildSignedApprovalLink } from '../../approvals/signed-link.js';
+function escapeHtml(value) {
+    return value
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+/**
+ * `action.id` is command text (`"approve <token>"`/`"deny <token>"`,
+ * `approvals/message.ts`) — the same string a button-capable channel routes
+ * through `CommandRouter`. Email has no buttons ("## Approbations depuis le
+ * canal": "Sur un canal sans boutons [...] l'action est un lien signé à
+ * usage unique."), so it turns that same command text into the equivalent
+ * signed link instead of inventing a parallel action representation.
+ * Approve/deny is the only action shape any real producer emits today
+ * (`dispatchApproval`) — anything else is refused rather than guessed at.
+ */
+function actionToLink(action, links) {
+    const match = /^(approve|deny)\s+(.+)$/.exec(action.id);
+    if (match === null) {
+        throw new CogentaError({
+            code: 'CHANNEL_EMAIL_TRANSPORT_ERROR',
+            message: `Email cannot render the action "${action.id}" as a signed link — its id is not in the "approve <token>"/"deny <token>" shape every real producer emits.`,
+            hint: 'Only approval actions (dispatchApproval) are rendered by this adapter today.',
+            details: { actionId: action.id },
+        });
+    }
+    const [, word = '', token = ''] = match;
+    const decision = word === 'approve' ? 'approved' : 'rejected';
+    return buildSignedApprovalLink(links.baseUrl, links.signingKey, token, decision, links.expiresInSeconds);
+}
+function renderActions(actions, links) {
+    if (actions === undefined || actions.length === 0)
+        return { text: '', html: '' };
+    if (links === undefined) {
+        throw new CogentaError({
+            code: 'CHANNEL_EMAIL_TRANSPORT_ERROR',
+            message: 'This message carries actions but the email adapter was not configured with actionLinks.',
+            hint: 'Pass { actionLinks: { baseUrl, signingKey, expiresInSeconds } } to createEmailAdapter.',
+        });
+    }
+    const rows = actions.map((action) => ({ label: action.label, url: actionToLink(action, links) }));
+    const text = `\n\n${rows.map((row) => `${row.label} : ${row.url}`).join('\n')}`;
+    const html = `<p>${rows.map((row) => `<a href="${escapeHtml(row.url)}">${escapeHtml(row.label)}</a>`).join(' &nbsp;|&nbsp; ')}</p>`;
+    return { text, html };
+}
+/**
+ * Fresh, email-native rendering — the "on n'écrit pas de Markdown Telegram
+ * dans le code métier" boundary (L6, `## Interface`) cuts both ways: nothing
+ * from `providers/telegram/render.ts` is reused here, and nothing here leaks
+ * into `ChannelMessage` itself.
+ */
+export function renderEmailMessage(message, actionLinks) {
+    if (message.level === 'alert') {
+        const actions = renderActions(message.actions, actionLinks);
+        const severityLabel = message.severity.toUpperCase();
+        return {
+            subject: `[${severityLabel}] ${message.title}`,
+            text: `${message.context}\n\nAction attendue : ${message.expectedAction}\n\nAdmin : ${message.adminUrl}${actions.text}`,
+            html: `<p><strong>${escapeHtml(message.context)}</strong></p>` +
+                `<p>Action attendue : ${escapeHtml(message.expectedAction)}</p>` +
+                `<p><a href="${escapeHtml(message.adminUrl)}">Voir dans l'admin</a></p>${actions.html}`,
+        };
+    }
+    if (message.level === 'report') {
+        const figures = message.keyFigures.map((figure) => `${figure.label} : ${figure.value}`);
+        const sections = message.sections.map((section) => section.heading === undefined ? section.body : `${section.heading}\n${section.body}`);
+        const moreLine = message.moreUrl === undefined ? '' : `\n\nVoir plus : ${message.moreUrl}`;
+        return {
+            subject: message.title,
+            text: `${figures.join(' · ')}\n\n${sections.join('\n\n')}${moreLine}`,
+            html: `<p>${figures.map(escapeHtml).join(' &middot; ')}</p>` +
+                message.sections
+                    .map((section) => `<div>${section.heading === undefined ? '' : `<h3>${escapeHtml(section.heading)}</h3>`}<p>${escapeHtml(section.body)}</p></div>`)
+                    .join('') +
+                (message.moreUrl === undefined
+                    ? ''
+                    : `<p><a href="${escapeHtml(message.moreUrl)}">Voir plus</a></p>`),
+        };
+    }
+    return {
+        subject: message.text,
+        text: message.text,
+        html: `<p>${escapeHtml(message.text)}</p>`,
+    };
+}
+//# sourceMappingURL=render.js.map

package/dist/providers/email/render.js.map

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

package/dist/providers/email/transport.d.ts

@@ -0,0 +1,25 @@
+/**
+ * R1 — "Aucune dépendance dure à une infrastructure... Tout besoin
+ * d'infrastructure passe par une interface avec au moins deux
+ * implémentations, dont une sans service externe." Real SMTP (protocol
+ * state machine, STARTTLS negotiation, MIME) is a materially larger
+ * undertaking than Telegram's plain-HTTP Bot API (L6 task 4) — closer to
+ * the WXR-XML-parsing precedent (`@cogenta/import`) than to a REST client.
+ * This interface exists so `createEmailAdapter` never depends on how mail
+ * actually leaves the process; only the local, degraded `FileEmailTransport`
+ * is built in this pass — a real SMTP/HTTP-API transport is a documented,
+ * deliberate follow-up (see `email` package doc comment), not built here.
+ */
+export interface OutgoingEmail {
+    readonly to: string;
+    readonly subject: string;
+    readonly text: string;
+    readonly html: string;
+}
+export interface SentEmail {
+    readonly messageId: string;
+}
+export interface EmailTransport {
+    send(email: OutgoingEmail): Promise<SentEmail>;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/providers/email/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/providers/email/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;CAC/C"}

package/dist/providers/email/transport.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transport.js.map

package/dist/providers/email/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/providers/email/transport.ts"],"names":[],"mappings":""}

package/dist/providers/slack/adapter.d.ts

@@ -0,0 +1,35 @@
+import type { ChannelAdapter, ChannelMessage, InboundHandler, MessageId } from '../../adapter.js';
+import type { CommandRouter } from '../../inbound/router.js';
+import type { ChannelLinkStore } from '../../linking/store.js';
+import { type SlackClientConfig } from './client.js';
+import { type SlackSocketClient } from './socket.js';
+export interface SlackLinkProof {
+    readonly code: string;
+    readonly channelUserId: string;
+}
+export interface SlackAdapterOptions extends SlackClientConfig {
+    readonly appToken: string;
+    readonly linkStore: ChannelLinkStore;
+    readonly router: CommandRouter;
+    readonly socketClient?: SlackSocketClient;
+}
+/**
+ * A live channel adapter beyond the generic interface: `start()`/`stop()`
+ * manage the Socket Mode connection, which has no counterpart in
+ * `ChannelAdapter` — same shape as `TelegramAdapter`'s polling lifecycle.
+ */
+export interface SlackAdapter extends ChannelAdapter {
+    update(id: MessageId, message: ChannelMessage): Promise<void>;
+    onInbound(handler: InboundHandler): void;
+    start(): Promise<void>;
+    stop(): void;
+}
+/**
+ * "Adaptateur Slack." Socket Mode, not the Events API webhook — same
+ * reasoning as Telegram's long-polling choice (`providers/telegram/adapter.ts`):
+ * no plane of this project is deployed publicly yet, and Socket Mode is
+ * Slack's own real, officially-supported answer to "no public URL,"
+ * requiring no signature-verification infrastructure to half-build.
+ */
+export declare function createSlackAdapter(options: SlackAdapterOptions): SlackAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/providers/slack/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/slack/adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EAEd,cAAc,EAEd,cAAc,EACd,SAAS,EACV,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,EAAuC,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAGzF,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAI7E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B;AAWD,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAA;IACpC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAA;CAC1C;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7D,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAA;IACxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,IAAI,IAAI,IAAI,CAAA;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAgF7E"}

package/dist/providers/slack/adapter.js

@@ -0,0 +1,91 @@
+import { CogentaError } from '@cogenta/core';
+import { createSlackClient } from './client.js';
+import { createSlackInboundHandler } from './inbound.js';
+import { renderSlackMessage } from './render.js';
+import { createSlackSocketClient } from './socket.js';
+const CHANNEL_NAME = 'slack';
+function isSlackLinkProof(proof) {
+    return (typeof proof === 'object' &&
+        proof !== null &&
+        typeof proof.code === 'string' &&
+        typeof proof.channelUserId === 'string');
+}
+/**
+ * "Adaptateur Slack." Socket Mode, not the Events API webhook — same
+ * reasoning as Telegram's long-polling choice (`providers/telegram/adapter.ts`):
+ * no plane of this project is deployed publicly yet, and Socket Mode is
+ * Slack's own real, officially-supported answer to "no public URL,"
+ * requiring no signature-verification infrastructure to half-build.
+ */
+export function createSlackAdapter(options) {
+    const client = createSlackClient(options);
+    const socket = options.socketClient ??
+        createSlackSocketClient({
+            appToken: options.appToken,
+            ...(options.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+        });
+    let inboundHandler;
+    const handleEnvelope = createSlackInboundHandler({
+        client,
+        linkStore: options.linkStore,
+        router: options.router,
+        getExternalHandler: () => inboundHandler,
+    });
+    return {
+        name: CHANNEL_NAME,
+        capabilities: {
+            richText: true,
+            buttons: true,
+            threads: false,
+            attachments: false,
+            inbound: true,
+        },
+        async send(target, message) {
+            const rendered = renderSlackMessage(message);
+            const sent = await client.postMessage({
+                channel: target.id,
+                text: rendered.text,
+                ...(rendered.blocks.length > 0 ? { blocks: rendered.blocks } : {}),
+            });
+            return `${sent.channel}:${sent.ts}`;
+        },
+        async update(id, message) {
+            const [channel, ts] = id.split(':');
+            if (channel === undefined || ts === undefined) {
+                throw new CogentaError({
+                    code: 'CHANNEL_SLACK_API_ERROR',
+                    message: `"${id}" is not a message id this adapter produced.`,
+                    hint: "Only pass a MessageId returned by this adapter's own send() to update().",
+                });
+            }
+            const rendered = renderSlackMessage(message);
+            await client.updateMessage({
+                channel,
+                ts,
+                text: rendered.text,
+                ...(rendered.blocks.length > 0 ? { blocks: rendered.blocks } : {}),
+            });
+        },
+        onInbound(handler) {
+            inboundHandler = handler;
+        },
+        async verifyIdentity(proof) {
+            if (!isSlackLinkProof(proof)) {
+                throw new CogentaError({
+                    code: 'CHANNEL_SLACK_API_ERROR',
+                    message: 'Slack identity proof must be { code, channelUserId }.',
+                    hint: 'Pass the linking code submitted in the channel and the Slack user id it came from.',
+                });
+            }
+            await options.linkStore.verifyCode(proof.code, CHANNEL_NAME, proof.channelUserId);
+            return options.linkStore.resolveIdentity(CHANNEL_NAME, proof.channelUserId);
+        },
+        async start() {
+            await socket.connect(handleEnvelope);
+        },
+        stop() {
+            socket.disconnect();
+        },
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/providers/slack/adapter.js.map

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