@will-17173/telegram-cli 0.1.0

package/dist/presenters/ink/render.js

@@ -0,0 +1,45 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text, render } from 'ink';
+import { DetailView } from './DetailView.js';
+import { TableView } from './TableView.js';
+import { TimelineView } from './TimelineView.js';
+export async function renderInkResult(result, options = {}) {
+    if (!result.ok)
+        return;
+    let markRendered = () => { };
+    const firstRender = new Promise((resolve) => {
+        markRendered = resolve;
+    });
+    const terminalWidth = options.stdout?.columns ?? process.stdout.columns ?? 80;
+    const app = render(_jsx(InkRenderer, { result: result, terminalWidth: terminalWidth }), {
+        ...options,
+        patchConsole: false,
+        onRender: markRendered,
+    });
+    const exit = app.waitUntilExit();
+    await firstRender;
+    app.unmount();
+    await exit;
+}
+export function InkRenderer({ result, terminalWidth, }) {
+    if (!result.ok)
+        return _jsx(Text, { children: "error" });
+    const human = result.human ?? { kind: 'text', text: JSON.stringify(result.data, null, 2) };
+    if (human.kind === 'text') {
+        return (_jsx(Text, { children: human.text }));
+    }
+    if (human.kind === 'table') {
+        return _jsx(TableView, { ...human, terminalWidth: terminalWidth });
+    }
+    if (human.kind === 'detail') {
+        return _jsx(DetailView, { ...human });
+    }
+    if (human.kind === 'summary') {
+        return (_jsxs(Box, { flexDirection: "column", children: [_jsx(DetailView, { title: human.title, fields: human.fields }), human.table ? _jsx(TableView, { ...human.table, terminalWidth: terminalWidth }) : null] }));
+    }
+    if (human.kind === 'timeline') {
+        return _jsx(TimelineView, { ...human, terminalWidth: terminalWidth });
+    }
+    return _jsx(Text, { children: "No output." });
+}
+//# sourceMappingURL=render.js.map

package/dist/presenters/ink/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/presenters/ink/render.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAsB,MAAM,KAAK,CAAA;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAqB,EACrB,UAAyC,EAAE;IAE3C,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAM;IACtB,IAAI,YAAY,GAAe,GAAG,EAAE,GAAE,CAAC,CAAA;IACvC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAChD,YAAY,GAAG,OAAO,CAAA;IACxB,CAAC,CAAC,CAAA;IACF,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAA;IAC7E,MAAM,GAAG,GAAG,MAAM,CAAC,KAAC,WAAW,IAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,GAAI,EAAE;QAChF,GAAG,OAAO;QACV,YAAY,EAAE,KAAK;QACnB,QAAQ,EAAE,YAAY;KACvB,CAAC,CAAA;IACF,MAAM,IAAI,GAAG,GAAG,CAAC,aAAa,EAAE,CAAA;IAChC,MAAM,WAAW,CAAA;IACjB,GAAG,CAAC,OAAO,EAAE,CAAA;IACb,MAAM,IAAI,CAAA;AACZ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAC1B,MAAM,EACN,aAAa,GAId;IACC,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,KAAC,IAAI,wBAAa,CAAA;IACzC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAA;IAE1F,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,OAAO,CACL,KAAC,IAAI,cAAE,KAAK,CAAC,IAAI,GAAQ,CAC1B,CAAA;IACH,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC3B,OAAO,KAAC,SAAS,OAAK,KAAK,EAAE,aAAa,EAAE,aAAa,GAAI,CAAA;IAC/D,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,KAAC,UAAU,OAAK,KAAK,GAAI,CAAA;IAClC,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,CACL,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,aACzB,KAAC,UAAU,IAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,GAAI,EACvD,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAC,SAAS,OAAK,KAAK,CAAC,KAAK,EAAE,aAAa,EAAE,aAAa,GAAI,CAAC,CAAC,CAAC,IAAI,IAC9E,CACP,CAAA;IACH,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC9B,OAAO,KAAC,YAAY,OAAK,KAAK,EAAE,aAAa,EAAE,aAAa,GAAI,CAAA;IAClE,CAAC;IAED,OAAO,KAAC,IAAI,6BAAkB,CAAA;AAChC,CAAC"}

package/dist/presenters/listen-message.js

@@ -0,0 +1,267 @@
+const MESSAGE_SEPARATOR = '────────────────────────────────────────────';
+export function buildListenMessage(input, options = {}) {
+    const messages = Array.isArray(input) ? input : [input];
+    const message = messages[0];
+    if (message == null)
+        throw new Error('Cannot format an empty listen message group');
+    const media = options.showMedia
+        ? messages.flatMap((item) => {
+            let previewAssigned = false;
+            return extractMediaLabels(item.raw_json).map((attachment) => {
+                const preview = attachment.kind === 'Photo' && !previewAssigned
+                    ? item.preview_jpeg_base64
+                    : undefined;
+                if (attachment.kind === 'Photo' && !previewAssigned)
+                    previewAssigned = true;
+                return {
+                    ...attachment,
+                    chatId: item.chat_id,
+                    messageId: item.msg_id,
+                    ...(preview == null ? {} : { previewJpegBase64: preview }),
+                };
+            });
+        })
+        : [];
+    const content = messages.find((item) => item.content != null && item.content.trim() !== '')?.content ?? null;
+    return {
+        time: formatListenTimestamp(message.timestamp),
+        sender: message.sender_name ?? (message.sender_id == null ? 'Unknown' : String(message.sender_id)),
+        content: contentPreview(content, media.length > 0),
+        media,
+    };
+}
+export function formatListenLine(message, options = {}) {
+    const row = buildListenMessage(message, options);
+    const lines = [`[${row.time}] ${row.sender}`, ...(row.content == null ? [] : [row.content]), ...row.media.map((item) => item.label), MESSAGE_SEPARATOR];
+    return `${lines.join('\n')}\n`;
+}
+function contentPreview(content, hasVisibleMedia) {
+    if (content == null || content.trim() === '')
+        return hasVisibleMedia ? null : '(no text)';
+    return content.replaceAll('\n', ' ');
+}
+function formatListenTimestamp(value) {
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime()))
+        return value;
+    return `${String(date.getHours()).padStart(2, '0')}:${String(date.getMinutes()).padStart(2, '0')}`;
+}
+function extractMediaLabels(raw) {
+    const root = parseRawJson(raw);
+    if (root == null)
+        return [];
+    const nodes = collectMediaNodes(root);
+    const lines = nodes
+        .map((node) => describeMediaNode(node))
+        .flat();
+    return dedupeAttachments(lines);
+}
+function collectMediaNodes(root) {
+    if (root == null)
+        return [];
+    const nodes = [];
+    nodes.push(root);
+    const pushIfObject = (value) => {
+        if (value == null)
+            return;
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                if (item == null)
+                    continue;
+                if (typeof item === 'object' && !Array.isArray(item))
+                    nodes.push(item);
+            }
+            return;
+        }
+        if (typeof value === 'object')
+            nodes.push(value);
+    };
+    pushIfObject(root.media);
+    pushIfObject(root.photo);
+    pushIfObject(root.document);
+    pushIfObject(root.video);
+    pushIfObject(root.audio);
+    pushIfObject(root.voice);
+    pushIfObject(root.sticker);
+    pushIfObject(root.animation);
+    pushIfObject(root.poll);
+    pushIfObject(root.geo);
+    pushIfObject(root.location);
+    pushIfObject(root.contact);
+    pushIfObject(root.venue);
+    pushIfObject(root.file);
+    pushIfObject(root.webpage);
+    pushIfObject(root.invoice);
+    pushIfObject(root.round_message);
+    const mediaItem = root['media_item'];
+    if (mediaItem != null && !Array.isArray(mediaItem) && typeof mediaItem === 'object')
+        nodes.push(mediaItem);
+    return nodes;
+}
+function describeMediaNode(node) {
+    if (node == null)
+        return [];
+    const kind = detectMediaKind(node);
+    if (kind == null)
+        return [];
+    const details = buildMediaDetails(node, kind);
+    const label = `📎 ${kind}${details.length > 0 ? ` (${details})` : ''}`;
+    const source = mediaDetailSource(node, kind);
+    return [{
+            kind,
+            label,
+            fileName: firstString(source.fileName, source.file_name, source.filename, source.name),
+            downloadable: DOWNLOADABLE_MEDIA_KINDS.has(kind),
+        }];
+}
+function detectMediaKind(node) {
+    const typeTag = firstString(node._);
+    if (typeTag != null && MEDIA_TYPE_LABELS[typeTag] != null)
+        return MEDIA_TYPE_LABELS[typeTag];
+    if (node.photo != null)
+        return 'Photo';
+    if (node.document != null || node.file != null || node.mime_type != null || node.mimeType != null)
+        return 'Document';
+    if (node.video != null || node.video_duration != null || node.videoStartTs != null)
+        return 'Video';
+    if (node.audio != null || node.duration != null || node.voice != null || node.voice_note != null)
+        return 'Audio';
+    if (node.sticker != null)
+        return 'Sticker';
+    if (node.animation != null)
+        return 'Animation';
+    if (node.poll != null)
+        return 'Poll';
+    if (node.location != null || node.geo != null)
+        return 'Location';
+    if (node.contact != null)
+        return 'Contact';
+    if (node.venue != null)
+        return 'Venue';
+    if (node.webpage != null)
+        return 'Webpage';
+    if (node.invoice != null)
+        return 'Invoice';
+    return null;
+}
+function buildMediaDetails(node, kind) {
+    const source = mediaDetailSource(node, kind);
+    const fileName = firstString(source.fileName, source.file_name, source.filename, source.name);
+    const mimeType = firstString(source.mime_type, source.mimeType, source.mime);
+    const size = firstNumber(source.size, source.size_bytes, source.file_size);
+    const caption = firstString(node.caption);
+    const parts = [];
+    if (kind === 'Poll')
+        return 'poll';
+    if (fileName != null)
+        parts.push(fileName);
+    if (mimeType != null)
+        parts.push(mimeType);
+    if (size != null)
+        parts.push(humanizeBytes(size));
+    if (caption != null)
+        parts.push(`caption: ${caption}`);
+    return parts.join(' • ');
+}
+function mediaDetailSource(node, kind) {
+    if (kind === 'Photo' && node.photo != null && typeof node.photo === 'object')
+        return node.photo;
+    if (kind === 'Video' && node.video != null && typeof node.video === 'object')
+        return node.video;
+    if ((kind === 'Audio' || kind === 'Voice') && node.audio != null && typeof node.audio === 'object')
+        return node.audio;
+    if (kind === 'Document' && node.document != null && typeof node.document === 'object')
+        return node.document;
+    if (node.document != null && typeof node.document === 'object')
+        return node.document;
+    if (node.file != null && typeof node.file === 'object')
+        return node.file;
+    return node;
+}
+function parseRawJson(raw) {
+    if (raw == null)
+        return null;
+    if (typeof raw === 'string') {
+        try {
+            const parsed = JSON.parse(raw);
+            return isRecord(parsed) ? parsed : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    return isRecord(raw) ? raw : null;
+}
+function isRecord(value) {
+    return value != null && typeof value === 'object' && !Array.isArray(value);
+}
+function dedupeAttachments(values) {
+    const unique = new Set();
+    const next = [];
+    for (const value of values) {
+        const lower = value.label.toLowerCase();
+        if (unique.has(lower))
+            continue;
+        unique.add(lower);
+        next.push(value);
+    }
+    return next;
+}
+function firstString(...values) {
+    for (const value of values) {
+        if (typeof value === 'string') {
+            const trimmed = value.trim();
+            if (trimmed.length > 0)
+                return trimmed;
+        }
+    }
+    return null;
+}
+function firstNumber(...values) {
+    for (const value of values) {
+        if (typeof value === 'number' && Number.isFinite(value))
+            return value;
+        if (typeof value === 'string') {
+            const parsed = Number.parseInt(value, 10);
+            if (!Number.isNaN(parsed))
+                return parsed;
+        }
+    }
+    return null;
+}
+function humanizeBytes(size) {
+    const units = ['B', 'KB', 'MB', 'GB'];
+    let value = size;
+    let index = 0;
+    while (value >= 1024 && index < units.length - 1) {
+        value /= 1024;
+        index += 1;
+    }
+    return `${value.toFixed(index === 0 ? 0 : 1)} ${units[index]}`;
+}
+const MEDIA_TYPE_LABELS = {
+    messageMediaPhoto: 'Photo',
+    messageMediaDocument: 'Document',
+    messageMediaVideo: 'Video',
+    messageMediaAudio: 'Audio',
+    messageMediaVoice: 'Voice',
+    messageMediaDoc: 'Document',
+    messageMediaWebPage: 'Webpage',
+    messageMediaGeo: 'Location',
+    messageMediaContact: 'Contact',
+    messageMediaVenue: 'Venue',
+    messageMediaPoll: 'Poll',
+    messageMediaInvoice: 'Invoice',
+    messageMediaSticker: 'Sticker',
+    messageMediaAnimation: 'Animation',
+};
+const DOWNLOADABLE_MEDIA_KINDS = new Set([
+    'Photo',
+    'Document',
+    'Video',
+    'Audio',
+    'Voice',
+    'Sticker',
+    'Animation',
+]);
+//# sourceMappingURL=listen-message.js.map

package/dist/presenters/listen-message.js.map

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

package/dist/presenters/structured.js

@@ -0,0 +1,30 @@
+import YAML from 'yaml';
+const SCHEMA_VERSION = '1';
+export function resolveOutputFormat(options) {
+    if (options.json && options.yaml) {
+        throw new Error('Use only one of --json or --yaml.');
+    }
+    if (options.yaml)
+        return 'yaml';
+    if (options.json)
+        return 'json';
+    const mode = (process.env.OUTPUT || 'auto').trim().toLowerCase();
+    if (mode === 'yaml' || mode === 'json' || mode === 'rich')
+        return mode;
+    return options.isTty === false ? 'yaml' : 'rich';
+}
+export function successPayload(data) {
+    return { ok: true, schema_version: SCHEMA_VERSION, data };
+}
+export function errorPayload(code, message, details) {
+    const error = { code, message };
+    if (details !== undefined)
+        error.details = details;
+    return { ok: false, schema_version: SCHEMA_VERSION, error };
+}
+export function dumpStructured(payload, format) {
+    if (format === 'json')
+        return JSON.stringify(payload, null, 2);
+    return YAML.stringify(payload, { sortMapEntries: false });
+}
+//# sourceMappingURL=structured.js.map

package/dist/presenters/structured.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured.js","sourceRoot":"","sources":["../../src/presenters/structured.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAA;AAGvB,MAAM,cAAc,GAAG,GAAG,CAAA;AAQ1B,MAAM,UAAU,mBAAmB,CAAC,OAA6B;IAC/D,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;IACtD,CAAC;IACD,IAAI,OAAO,CAAC,IAAI;QAAE,OAAO,MAAM,CAAA;IAC/B,IAAI,OAAO,CAAC,IAAI;QAAE,OAAO,MAAM,CAAA;IAE/B,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAChE,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAA;IACtE,OAAO,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAA;AAClD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,cAAc,EAAE,IAAI,EAAE,CAAA;AAC3D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,OAAe,EAAE,OAAiB;IAC3E,MAAM,KAAK,GAA4B,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;IACxD,IAAI,OAAO,KAAK,SAAS;QAAE,KAAK,CAAC,OAAO,GAAG,OAAO,CAAA;IAClD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,EAAE,CAAA;AAC7D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAgB,EAAE,MAAuB;IACtE,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAC9D,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAA;AAC3D,CAAC"}

package/dist/services/attachment-download.js

@@ -0,0 +1,21 @@
+import { extname, join, parse } from 'node:path';
+export function resolveAttachmentDestination(options) {
+    const directory = join(options.homeDir, 'Downloads', 'telegram-cli');
+    const safeName = sanitizeFileName(options.fileName);
+    let destination = join(directory, safeName);
+    if (!options.exists(destination))
+        return destination;
+    const extension = extname(safeName);
+    const baseName = parse(safeName).name;
+    let index = 2;
+    do {
+        destination = join(directory, `${baseName} (${index})${extension}`);
+        index += 1;
+    } while (options.exists(destination));
+    return destination;
+}
+function sanitizeFileName(fileName) {
+    const leaf = fileName.replaceAll('\\', '/').split('/').at(-1)?.trim() || 'attachment';
+    return leaf.replace(/[<>:"|?*\u0000-\u001F]/g, '_') || 'attachment';
+}
+//# sourceMappingURL=attachment-download.js.map

package/dist/services/attachment-download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-download.js","sourceRoot":"","sources":["../../src/services/attachment-download.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AAQhD,MAAM,UAAU,4BAA4B,CAAC,OAA4C;IACvF,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,cAAc,CAAC,CAAA;IACpE,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IACnD,IAAI,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IAC3C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC;QAAE,OAAO,WAAW,CAAA;IAEpD,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IACnC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAA;IACrC,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,GAAG,CAAC;QACF,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,QAAQ,KAAK,KAAK,IAAI,SAAS,EAAE,CAAC,CAAA;QACnE,KAAK,IAAI,CAAC,CAAA;IACZ,CAAC,QAAQ,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,EAAC;IACrC,OAAO,WAAW,CAAA;AACpB,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgB;IACxC,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,YAAY,CAAA;IACrF,OAAO,IAAI,CAAC,OAAO,CAAC,yBAAyB,EAAE,GAAG,CAAC,IAAI,YAAY,CAAA;AACrE,CAAC"}

package/dist/services/data-service.js

@@ -0,0 +1,76 @@
+import { writeFileSync } from 'node:fs';
+import { actionDetail } from '../presenters/human.js';
+import { dumpStructured, successPayload } from '../presenters/structured.js';
+import { MessageDB } from '../storage/message-db.js';
+export class DataService {
+    db;
+    constructor(db = new MessageDB()) {
+        this.db = db;
+    }
+    close() {
+        this.db.close();
+    }
+    exportMessages(options) {
+        if (!['text', 'json', 'yaml'].includes(options.format)) {
+            return { ok: false, error: { code: 'invalid_option', message: 'Format must be text, json, or yaml.', details: { option: 'format' } } };
+        }
+        if (options.hours != null && (!Number.isFinite(options.hours) || options.hours <= 0)) {
+            return { ok: false, error: { code: 'invalid_option', message: 'Hours must be a positive number.', details: { option: 'hours' } } };
+        }
+        const chatId = this.resolveChat(options.chat);
+        if (!chatId.ok)
+            return chatId;
+        const messages = this.db.getRecent({ chatId: chatId.data, hours: options.hours, limit: 100000 });
+        if (messages.length === 0)
+            return { ok: false, error: { code: 'no_messages', message: `No messages found for '${options.chat}'.` } };
+        const text = options.format === 'json'
+            ? dumpStructured(successPayload(messages), 'json')
+            : options.format === 'yaml'
+                ? dumpStructured(successPayload(messages), 'yaml')
+                : messages.map((msg) => `[${msg.timestamp.slice(0, 19)}] ${msg.sender_name ?? 'Unknown'}: ${msg.content ?? ''}`).join('\n');
+        if (options.output) {
+            try {
+                writeFileSync(options.output, text, 'utf8');
+            }
+            catch (error) {
+                const reason = error instanceof Error ? error.message : String(error);
+                const details = fileErrorDetails(error, options.output);
+                return {
+                    ok: false,
+                    error: {
+                        code: 'export_failed',
+                        message: `Failed to export messages to '${options.output}': ${reason}`,
+                        details,
+                    },
+                };
+            }
+            const data = { exported: messages.length, output: options.output };
+            return { ok: true, data, human: actionDetail('Export Complete', data) };
+        }
+        return { ok: true, data: messages, human: { kind: 'text', text } };
+    }
+    purge(options) {
+        const chatId = this.resolveChat(options.chat);
+        if (!chatId.ok)
+            return chatId;
+        if (!options.yes)
+            return { ok: false, error: { code: 'confirmation_required', message: 'Use --yes to confirm purge in this Node port.' } };
+        const data = { deleted: this.db.deleteChat(chatId.data) };
+        return { ok: true, data, human: actionDetail('Messages Deleted', data) };
+    }
+    resolveChat(chat) {
+        const matches = this.db.findChats(chat);
+        if (matches.length === 1)
+            return { ok: true, data: matches[0].chat_id };
+        if (matches.length === 0)
+            return { ok: false, error: { code: 'chat_not_found', message: `Chat '${chat}' not found in database.` } };
+        return { ok: false, error: { code: 'ambiguous_chat', message: `Chat '${chat}' is ambiguous. Matches: ${matches.map((m) => m.chat_name ?? m.chat_id).join(', ')}` } };
+    }
+}
+function fileErrorDetails(error, output) {
+    if (typeof error === 'object' && error !== null && 'code' in error && typeof error.code === 'string') {
+        return { code: error.code, path: output };
+    }
+    return { path: output };
+}
+//# sourceMappingURL=data-service.js.map

package/dist/services/data-service.js.map

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

package/dist/services/listen-album-aggregator.js

@@ -0,0 +1,72 @@
+export class ListenAlbumAggregator {
+    options;
+    pending = new Map();
+    delayMs;
+    constructor(options) {
+        this.options = options;
+        this.delayMs = options.delayMs ?? 300;
+    }
+    add(message) {
+        const groupedId = extractGroupedId(message.raw_json);
+        if (groupedId == null) {
+            this.options.emit([message]);
+            return;
+        }
+        const key = `${message.chat_id}:${groupedId}`;
+        const existing = this.pending.get(key);
+        if (existing != null)
+            clearTimeout(existing.timer);
+        const messages = existing == null ? [message] : [...existing.messages, message];
+        const timer = setTimeout(() => this.emitPending(key), this.delayMs);
+        this.pending.set(key, { messages, timer });
+    }
+    flush() {
+        for (const key of [...this.pending.keys()])
+            this.emitPending(key);
+    }
+    dispose() {
+        for (const album of this.pending.values())
+            clearTimeout(album.timer);
+        this.pending.clear();
+    }
+    emitPending(key) {
+        const album = this.pending.get(key);
+        if (album == null)
+            return;
+        clearTimeout(album.timer);
+        this.pending.delete(key);
+        this.options.emit([...album.messages].sort((left, right) => left.msg_id - right.msg_id));
+    }
+}
+function extractGroupedId(rawJson) {
+    const raw = parseRawJson(rawJson);
+    if (raw == null)
+        return null;
+    const groupedId = raw.groupedId ?? raw.grouped_id;
+    if (typeof groupedId === 'string' || typeof groupedId === 'number')
+        return String(groupedId);
+    if (isRecord(groupedId)) {
+        const low = groupedId.low;
+        const high = groupedId.high;
+        if ((typeof low === 'number' || typeof low === 'string') && (typeof high === 'number' || typeof high === 'string')) {
+            return `${low}:${high}`;
+        }
+    }
+    return null;
+}
+function parseRawJson(value) {
+    if (typeof value === 'string') {
+        try {
+            const parsed = JSON.parse(value);
+            return isRecord(parsed) ? parsed : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    return isRecord(value) ? value : null;
+}
+function isRecord(value) {
+    return value != null && typeof value === 'object' && !Array.isArray(value);
+}
+//# sourceMappingURL=listen-album-aggregator.js.map

package/dist/services/listen-album-aggregator.js.map

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