tglfs 0.1.0

package/dist/file-ops.js

@@ -0,0 +1,234 @@
+import { coerceTelegramDocumentSize, inspectFileFromEncryptedParts, iterateEncryptedFile, } from "./download.js";
+import { CliError, EXIT_CODES } from "./errors.js";
+import { getGramJs } from "./gramjs.js";
+import { validateDownloadableFileCard } from "./protocol.js";
+import { deleteFileCardMessages, lookupFileCardByUfid, renameFileCardMessage, transferFileCard, unsendFileCard, } from "./shared/telegram-files.js";
+import { formatFileCardDate, formatFileCardSize } from "./shared/file-cards.js";
+function normalizePeer(peer, fallback = "me") {
+    const normalized = peer?.trim() ?? fallback;
+    if (normalized === "") {
+        throw new CliError("invalid_input", "Peer must not be empty.", EXIT_CODES.GENERAL_ERROR);
+    }
+    return normalized;
+}
+export async function resolveFileCardRecord(client, ufid, peer = "me") {
+    const normalizedPeer = normalizePeer(peer);
+    const record = await lookupFileCardByUfid(client, ufid.trim(), { peer: normalizedPeer });
+    if (!record) {
+        throw new CliError("file_not_found", `No TGLFS file card was found for UFID ${ufid.trim()} in ${normalizedPeer === "me" ? "Saved Messages" : normalizedPeer}.`, EXIT_CODES.FILE_NOT_FOUND);
+    }
+    return record;
+}
+export async function resolveFileCardRecords(client, ufids, peer = "me") {
+    const records = [];
+    for (const ufid of ufids) {
+        records.push(await resolveFileCardRecord(client, ufid, peer));
+    }
+    return records;
+}
+export async function renameFile(client, ufid, newName) {
+    const record = await resolveFileCardRecord(client, ufid, "me");
+    const trimmedName = newName.trim();
+    if (trimmedName === "") {
+        throw new CliError("invalid_input", "New file name must not be empty.", EXIT_CODES.GENERAL_ERROR);
+    }
+    const { Api } = getGramJs();
+    const updated = { ...record.data, name: trimmedName };
+    await renameFileCardMessage(client, {
+        Api: Api,
+        peer: "me",
+        msgId: record.msgId,
+        peerId: "me",
+        data: record.data,
+        newName: trimmedName,
+    });
+    return {
+        before: record,
+        after: {
+            ...record,
+            data: updated,
+        },
+    };
+}
+export async function deleteResolvedFiles(client, records) {
+    const { Api } = getGramJs();
+    for (const record of records) {
+        await deleteFileCardMessages(client, {
+            Api: Api,
+            msgId: record.msgId,
+            data: record.data,
+        });
+    }
+    return records;
+}
+export async function deleteFiles(client, ufids) {
+    const records = await resolveFileCardRecords(client, ufids, "me");
+    return deleteResolvedFiles(client, records);
+}
+export async function sendFiles(client, ufids, recipient) {
+    const normalizedRecipient = normalizePeer(recipient, "");
+    const { Api } = getGramJs();
+    const sent = [];
+    for (const ufid of ufids) {
+        const record = await resolveFileCardRecord(client, ufid, "me");
+        validateDownloadableFileCard(record.data);
+        const result = await transferFileCard(client, {
+            Api: Api,
+            record,
+            sourcePeer: "me",
+            targetPeer: normalizedRecipient,
+            silent: true,
+        });
+        sent.push({
+            source: record,
+            recipient: normalizedRecipient,
+            data: result.data,
+        });
+    }
+    return sent;
+}
+export async function receiveFiles(client, source, ufids) {
+    const normalizedSource = normalizePeer(source, "");
+    const { Api } = getGramJs();
+    const received = [];
+    for (const ufid of ufids) {
+        const record = await resolveFileCardRecord(client, ufid, normalizedSource);
+        validateDownloadableFileCard(record.data);
+        const result = await transferFileCard(client, {
+            Api: Api,
+            record,
+            sourcePeer: normalizedSource,
+            targetPeer: "me",
+        });
+        received.push({
+            source: normalizedSource,
+            original: record,
+            data: result.data,
+        });
+    }
+    return received;
+}
+export async function unsendFiles(client, source, ufids) {
+    const normalizedSource = normalizePeer(source, "");
+    const { Api } = getGramJs();
+    const unsent = [];
+    for (const ufid of ufids) {
+        const record = await resolveFileCardRecord(client, ufid, normalizedSource);
+        await unsendFileCard(client, {
+            Api: Api,
+            record,
+            peer: normalizedSource,
+        });
+        unsent.push(record);
+    }
+    return unsent;
+}
+async function inspectChunkMessages(client, peer, data) {
+    const messages = await client.getMessages(peer, { ids: data.chunks, waitTime: 0 });
+    const byId = new Map();
+    for (const message of messages) {
+        if (typeof message?.id === "number") {
+            byId.set(message.id, message);
+        }
+    }
+    return data.chunks.map((chunkId) => {
+        const message = byId.get(chunkId);
+        if (!message) {
+            return { msgId: chunkId, status: "missing" };
+        }
+        if (!message?.media?.document) {
+            return {
+                msgId: chunkId,
+                status: "not_document",
+                className: message.className,
+            };
+        }
+        const size = coerceTelegramDocumentSize(message.media.document.size);
+        if (size === null) {
+            return {
+                msgId: chunkId,
+                status: "invalid_size",
+                className: message.className,
+            };
+        }
+        return {
+            msgId: chunkId,
+            status: "ok",
+            size,
+            className: message.className,
+        };
+    });
+}
+export async function detectFileMode(expected, inspectMode) {
+    let lastError;
+    for (const mode of ["current", "legacy"]) {
+        try {
+            const result = await inspectMode(mode);
+            if (result.bytesWritten === expected.size && result.computedUfid === expected.ufid) {
+                return {
+                    probe: {
+                        mode,
+                        bytesWritten: result.bytesWritten,
+                        computedUfid: result.computedUfid,
+                    },
+                };
+            }
+            lastError = `The ${mode} probe did not match the expected UFID.`;
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error.message : String(error);
+        }
+    }
+    return { lastError };
+}
+async function probeFileMode(client, peer, data, password) {
+    return detectFileMode({ size: data.size, ufid: data.ufid }, (mode) => inspectFileFromEncryptedParts(data, password, iterateEncryptedFile(client, data, peer), mode));
+}
+export async function inspectFileCard(client, ufid, options = {}) {
+    const peer = normalizePeer(options.peer);
+    const record = await resolveFileCardRecord(client, ufid, peer);
+    const chunks = await inspectChunkMessages(client, peer, record.data);
+    const everyChunkReadable = chunks.every((chunk) => chunk.status === "ok");
+    let probe;
+    let probeError;
+    if (!options.probe) {
+        probeError = "Format probe skipped. Re-run with --probe to verify current vs legacy format.";
+    }
+    else if (everyChunkReadable) {
+        try {
+            const detection = await probeFileMode(client, peer, record.data, options.password ?? "");
+            probe = detection.probe;
+            if (!probe) {
+                probeError =
+                    detection.lastError ??
+                        (options.password === undefined
+                            ? "Format probe could not distinguish current vs legacy with an empty password."
+                            : "Format probe failed with the supplied password.");
+            }
+        }
+        catch (error) {
+            probeError = error instanceof Error ? error.message : String(error);
+        }
+    }
+    else {
+        probeError = "One or more Telegram chunk messages are missing or malformed.";
+    }
+    return {
+        peer,
+        msgId: record.msgId,
+        date: record.date,
+        data: record.data,
+        chunks,
+        format: probe?.mode ?? "unknown",
+        probe,
+        probeError,
+    };
+}
+export function formatDeleteConfirmation(records) {
+    const lines = [`Delete ${records.length} file(s) from Saved Messages?`, ""];
+    for (const record of records) {
+        lines.push(`${record.data.name} | ${formatFileCardSize(record.data.size)} | ${formatFileCardDate(record.date)} | ${record.data.ufid}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=file-ops.js.map

package/dist/file-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-ops.js","sourceRoot":"","sources":["../src/file-ops.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,0BAA0B,EAC1B,6BAA6B,EAC7B,oBAAoB,GACvB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAA;AAE5D,OAAO,EACH,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,GACjB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAiC/E,SAAS,aAAa,CAAC,IAAwB,EAAE,QAAQ,GAAG,IAAI;IAC5D,MAAM,UAAU,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAA;IAC3C,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,QAAQ,CAAC,eAAe,EAAE,yBAAyB,EAAE,UAAU,CAAC,aAAa,CAAC,CAAA;IAC5F,CAAC;IACD,OAAO,UAAU,CAAA;AACrB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAAsB,EAAE,IAAY,EAAE,IAAI,GAAG,IAAI;IACzF,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;IAC1C,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,MAAa,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAA;IAC/F,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,MAAM,IAAI,QAAQ,CACd,gBAAgB,EAChB,yCAAyC,IAAI,CAAC,IAAI,EAAE,OAAO,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,cAAc,GAAG,EACzH,UAAU,CAAC,cAAc,CAC5B,CAAA;IACL,CAAC;IACD,OAAO,MAAM,CAAA;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAAsB,EAAE,KAAe,EAAE,IAAI,GAAG,IAAI;IAC7F,MAAM,OAAO,GAAqB,EAAE,CAAA;IACpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,MAAM,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;IACjE,CAAC;IACD,OAAO,OAAO,CAAA;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAsB,EAAE,IAAY,EAAE,OAAe;IAClF,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IAC9D,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;IAClC,IAAI,WAAW,KAAK,EAAE,EAAE,CAAC;QACrB,MAAM,IAAI,QAAQ,CAAC,eAAe,EAAE,kCAAkC,EAAE,UAAU,CAAC,aAAa,CAAC,CAAA;IACrG,CAAC;IAED,MAAM,EAAE,GAAG,EAAE,GAAG,SAAS,EAAE,CAAA;IAC3B,MAAM,OAAO,GAAG,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAA;IACrD,MAAM,qBAAqB,CAAC,MAAa,EAAE;QACvC,GAAG,EAAE,GAAU;QACf,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,WAAW;KACvB,CAAC,CAAA;IACF,OAAO;QACH,MAAM,EAAE,MAAM;QACd,KAAK,EAAE;YACH,GAAG,MAAM;YACT,IAAI,EAAE,OAAO;SAChB;KACJ,CAAA;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAAsB,EAAE,OAAyB;IACvF,MAAM,EAAE,GAAG,EAAE,GAAG,SAAS,EAAE,CAAA;IAC3B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,sBAAsB,CAAC,MAAa,EAAE;YACxC,GAAG,EAAE,GAAU;YACf,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,MAAM,CAAC,IAAI;SACpB,CAAC,CAAA;IACN,CAAC;IACD,OAAO,OAAO,CAAA;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAsB,EAAE,KAAe;IACrE,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;IACjE,OAAO,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAsB,EAAE,KAAe,EAAE,SAAiB;IACtF,MAAM,mBAAmB,GAAG,aAAa,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;IACxD,MAAM,EAAE,GAAG,EAAE,GAAG,SAAS,EAAE,CAAA;IAC3B,MAAM,IAAI,GAA6E,EAAE,CAAA;IACzF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;QAC9D,4BAA4B,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACzC,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,MAAa,EAAE;YACjD,GAAG,EAAE,GAAU;YACf,MAAM;YACN,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,mBAAmB;YAC/B,MAAM,EAAE,IAAI;SACf,CAAC,CAAA;QACF,IAAI,CAAC,IAAI,CAAC;YACN,MAAM,EAAE,MAAM;YACd,SAAS,EAAE,mBAAmB;YAC9B,IAAI,EAAE,MAAM,CAAC,IAAI;SACpB,CAAC,CAAA;IACN,CAAC;IACD,OAAO,IAAI,CAAA;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAsB,EAAE,MAAc,EAAE,KAAe;IACtF,MAAM,gBAAgB,GAAG,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAClD,MAAM,EAAE,GAAG,EAAE,GAAG,SAAS,EAAE,CAAA;IAC3B,MAAM,QAAQ,GAA4E,EAAE,CAAA;IAC5F,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAA;QAC1E,4BAA4B,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACzC,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,MAAa,EAAE;YACjD,GAAG,EAAE,GAAU;YACf,MAAM;YACN,UAAU,EAAE,gBAAgB;YAC5B,UAAU,EAAE,IAAI;SACnB,CAAC,CAAA;QACF,QAAQ,CAAC,IAAI,CAAC;YACV,MAAM,EAAE,gBAAgB;YACxB,QAAQ,EAAE,MAAM;YAChB,IAAI,EAAE,MAAM,CAAC,IAAI;SACpB,CAAC,CAAA;IACN,CAAC;IACD,OAAO,QAAQ,CAAA;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAsB,EAAE,MAAc,EAAE,KAAe;IACrF,MAAM,gBAAgB,GAAG,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAClD,MAAM,EAAE,GAAG,EAAE,GAAG,SAAS,EAAE,CAAA;IAC3B,MAAM,MAAM,GAAqB,EAAE,CAAA;IACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAA;QAC1E,MAAM,cAAc,CAAC,MAAa,EAAE;YAChC,GAAG,EAAE,GAAU;YACf,MAAM;YACN,IAAI,EAAE,gBAAgB;SACzB,CAAC,CAAA;QACF,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACvB,CAAC;IACD,OAAO,MAAM,CAAA;AACjB,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,MAAsB,EAAE,IAAY,EAAE,IAAkB;IACxF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAS,CAAC,CAAA;IACzF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAe,CAAA;IACnC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,OAAO,OAAO,EAAE,EAAE,KAAK,QAAQ,EAAE,CAAC;YAClC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QACjC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACjC,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;QAChD,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;YAC5B,OAAO;gBACH,KAAK,EAAE,OAAO;gBACd,MAAM,EAAE,cAAc;gBACtB,SAAS,EAAE,OAAO,CAAC,SAAS;aAC/B,CAAA;QACL,CAAC;QAED,MAAM,IAAI,GAAG,0BAA0B,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QACpE,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAChB,OAAO;gBACH,KAAK,EAAE,OAAO;gBACd,MAAM,EAAE,cAAc;gBACtB,SAAS,EAAE,OAAO,CAAC,SAAS;aAC/B,CAAA;QACL,CAAC;QAED,OAAO;YACH,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,IAAI;YACZ,IAAI;YACJ,SAAS,EAAE,OAAO,CAAC,SAAS;SAC/B,CAAA;IACL,CAAC,CAAC,CAAA;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,QAAwC,EACxC,WAA4F;IAE5F,IAAI,SAA6B,CAAA;IAEjC,KAAK,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,QAAQ,CAA0B,EAAE,CAAC;QAChE,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAA;YACtC,IAAI,MAAM,CAAC,YAAY,KAAK,QAAQ,CAAC,IAAI,IAAI,MAAM,CAAC,YAAY,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACjF,OAAO;oBACH,KAAK,EAAE;wBACH,IAAI;wBACJ,YAAY,EAAE,MAAM,CAAC,YAAY;wBACjC,YAAY,EAAE,MAAM,CAAC,YAAY;qBACpC;iBACJ,CAAA;YACL,CAAC;YACD,SAAS,GAAG,OAAO,IAAI,yCAAyC,CAAA;QACpE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACtE,CAAC;IACL,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,CAAA;AACxB,CAAC;AAED,KAAK,UAAU,aAAa,CACxB,MAAsB,EACtB,IAAY,EACZ,IAAkB,EAClB,QAAgB;IAEhB,OAAO,cAAc,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CACjE,6BAA6B,CAAC,IAAI,EAAE,QAAQ,EAAE,oBAAoB,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAChG,CAAA;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACjC,MAAsB,EACtB,IAAY,EACZ,UAII,EAAE;IAEN,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IAC9D,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;IACpE,MAAM,kBAAkB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,CAAA;IAEzE,IAAI,KAAoC,CAAA;IACxC,IAAI,UAA8B,CAAA;IAClC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACjB,UAAU,GAAG,+EAA+E,CAAA;IAChG,CAAC;SAAM,IAAI,kBAAkB,EAAE,CAAC;QAC5B,IAAI,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAA;YACxF,KAAK,GAAG,SAAS,CAAC,KAAK,CAAA;YACvB,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,UAAU;oBACN,SAAS,CAAC,SAAS;wBACnB,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS;4BAC3B,CAAC,CAAC,8EAA8E;4BAChF,CAAC,CAAC,iDAAiD,CAAC,CAAA;YAChE,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,UAAU,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACvE,CAAC;IACL,CAAC;SAAM,CAAC;QACJ,UAAU,GAAG,+DAA+D,CAAA;IAChF,CAAC;IAED,OAAO;QACH,IAAI;QACJ,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM;QACN,MAAM,EAAE,KAAK,EAAE,IAAI,IAAI,SAAS;QAChC,KAAK;QACL,UAAU;KACb,CAAA;AACL,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAyB;IAC9D,MAAM,KAAK,GAAG,CAAC,UAAU,OAAO,CAAC,MAAM,+BAA+B,EAAE,EAAE,CAAC,CAAA;IAC3E,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CACN,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAC7H,CAAA;IACL,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC3B,CAAC"}

package/dist/gramjs.d.ts

@@ -0,0 +1,14 @@
+import type { TelegramClient } from "telegram/client/TelegramClient.js";
+import type { StringSession } from "telegram/sessions/StringSession.js";
+type GramJsModules = {
+    TelegramClient: typeof import("telegram")["TelegramClient"];
+    Api: typeof import("telegram")["Api"];
+    StringSession: typeof import("telegram/sessions/StringSession.js")["StringSession"];
+    getFileInfo: typeof import("telegram/Utils.js")["getFileInfo"];
+    Logger: typeof import("telegram/extensions/Logger.js")["Logger"];
+    LogLevel: typeof import("telegram/extensions/Logger.js")["LogLevel"];
+};
+export declare function getGramJs(): GramJsModules;
+export declare function createQuietTelegramClient(session: StringSession, apiId: number, apiHash: string): TelegramClient;
+export declare function createStringSession(value: string): StringSession;
+export {};

package/dist/gramjs.js

@@ -0,0 +1,70 @@
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+let gramJsModules = null;
+function installLocalStorageShim() {
+    const descriptor = Object.getOwnPropertyDescriptor(globalThis, "localStorage");
+    if (!descriptor?.configurable || !descriptor.get) {
+        return;
+    }
+    const storage = new Map();
+    const shim = {
+        getItem(key) {
+            return storage.has(key) ? storage.get(key) : null;
+        },
+        setItem(key, value) {
+            storage.set(String(key), String(value));
+        },
+        removeItem(key) {
+            storage.delete(String(key));
+        },
+        clear() {
+            storage.clear();
+        },
+        key(index) {
+            return Array.from(storage.keys())[index] ?? null;
+        },
+        get length() {
+            return storage.size;
+        },
+    };
+    Object.defineProperty(globalThis, "localStorage", {
+        configurable: true,
+        enumerable: descriptor.enumerable,
+        writable: true,
+        value: shim,
+    });
+}
+function loadGramJsModules() {
+    installLocalStorageShim();
+    const telegram = require("telegram");
+    const stringSessionModule = require("telegram/sessions/StringSession.js");
+    const utilsModule = require("telegram/Utils.js");
+    const loggerModule = require("telegram/extensions/Logger.js");
+    return {
+        TelegramClient: telegram.TelegramClient,
+        Api: telegram.Api,
+        StringSession: stringSessionModule.StringSession,
+        getFileInfo: utilsModule.getFileInfo,
+        Logger: loggerModule.Logger,
+        LogLevel: loggerModule.LogLevel,
+    };
+}
+export function getGramJs() {
+    if (!gramJsModules) {
+        gramJsModules = loadGramJsModules();
+    }
+    return gramJsModules;
+}
+export function createQuietTelegramClient(session, apiId, apiHash) {
+    const { TelegramClient, Logger, LogLevel } = getGramJs();
+    const logger = new Logger(LogLevel.NONE);
+    return new TelegramClient(session, apiId, apiHash, {
+        connectionRetries: 5,
+        baseLogger: logger,
+    });
+}
+export function createStringSession(value) {
+    const { StringSession } = getGramJs();
+    return new StringSession(value);
+}
+//# sourceMappingURL=gramjs.js.map

package/dist/gramjs.js.map

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

package/dist/interactive.d.ts

@@ -0,0 +1,11 @@
+export declare function isInteractiveSession(): boolean;
+export declare function readTrimmedStdin(message: string): Promise<string>;
+export declare function promptText(message: string, initial?: string): Promise<string>;
+export declare function promptOptionalText(message: string, initial?: string): Promise<string>;
+export declare function promptPassword(message: string, initial?: string): Promise<string>;
+export declare function promptConfirm(message: string, initial?: boolean): Promise<boolean>;
+export declare function promptSelect<T extends string>(message: string, choices: Array<{
+    title: string;
+    value: T;
+    description?: string;
+}>): Promise<T>;

package/dist/interactive.js

@@ -0,0 +1,81 @@
+import prompts from "prompts";
+import { CliError, EXIT_CODES } from "./errors.js";
+export function isInteractiveSession() {
+    return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
+export async function readTrimmedStdin(message) {
+    if (process.stdin.isTTY) {
+        throw new CliError("interactive_required", message, EXIT_CODES.INTERACTIVE_REQUIRED);
+    }
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    const value = Buffer.concat(chunks).toString("utf8").trim();
+    if (value === "") {
+        throw new CliError("interactive_required", message, EXIT_CODES.INTERACTIVE_REQUIRED);
+    }
+    return value;
+}
+async function ask(questions) {
+    const result = await prompts(questions, {
+        onCancel: () => {
+            throw new CliError("cancelled", "Operation cancelled.", EXIT_CODES.GENERAL_ERROR);
+        },
+    });
+    return result;
+}
+export async function promptText(message, initial) {
+    const response = await ask({
+        type: "text",
+        name: "value",
+        message,
+        initial,
+        validate: (value) => (value.trim() === "" ? "A value is required." : true),
+    });
+    return response.value?.trim() ?? "";
+}
+export async function promptOptionalText(message, initial = "") {
+    const response = await ask({
+        type: "text",
+        name: "value",
+        message,
+        initial,
+    });
+    return response.value?.trim() ?? "";
+}
+export async function promptPassword(message, initial = "") {
+    const response = await ask({
+        type: "password",
+        name: "value",
+        message,
+        initial,
+    });
+    return response.value ?? "";
+}
+export async function promptConfirm(message, initial = false) {
+    const response = await ask({
+        type: "confirm",
+        name: "value",
+        message,
+        initial,
+    });
+    return Boolean(response.value);
+}
+export async function promptSelect(message, choices) {
+    const response = await ask({
+        type: "select",
+        name: "value",
+        message,
+        choices: choices.map((choice) => ({
+            title: choice.title,
+            value: choice.value,
+            description: choice.description,
+        })),
+    });
+    if (!response.value) {
+        throw new CliError("cancelled", "Operation cancelled.", EXIT_CODES.GENERAL_ERROR);
+    }
+    return response.value;
+}
+//# sourceMappingURL=interactive.js.map

package/dist/interactive.js.map

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

package/dist/json.d.ts

@@ -0,0 +1,2 @@
+import type { JsonEnvelope } from "./types.js";
+export declare function printJson<T>(payload: JsonEnvelope<T>): void;

package/dist/json.js

@@ -0,0 +1,4 @@
+export function printJson(payload) {
+    process.stdout.write(JSON.stringify(payload, null, 2) + "\n");
+}
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS,CAAI,OAAwB;IACjD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;AACjE,CAAC"}

package/dist/progress.d.ts

@@ -0,0 +1,16 @@
+export type ProgressStream = {
+    isTTY?: boolean;
+    columns?: number;
+    write(chunk: string): boolean;
+};
+export declare function renderProgressLine(label: string, bytesWritten: number, totalBytes: number, width?: number): string;
+export declare function createByteProgressReporter(options: {
+    label: string;
+    totalBytes: number;
+    stream?: ProgressStream;
+    enabled?: boolean;
+}): {
+    update(bytesWritten: number): void;
+    complete(): void;
+    abort(): void;
+};

package/dist/progress.js

@@ -0,0 +1,62 @@
+import process from "node:process";
+function formatBytes(bytes) {
+    const units = ["B", "KiB", "MiB", "GiB", "TiB"];
+    let value = Math.max(0, bytes);
+    let unitIndex = 0;
+    while (value >= 1024 && unitIndex < units.length - 1) {
+        value /= 1024;
+        unitIndex += 1;
+    }
+    const formatted = value >= 10 || unitIndex === 0 ? value.toFixed(0) : value.toFixed(1);
+    return `${formatted} ${units[unitIndex]}`;
+}
+export function renderProgressLine(label, bytesWritten, totalBytes, width = 24) {
+    const safeTotal = Math.max(totalBytes, 1);
+    const ratio = Math.min(Math.max(bytesWritten / safeTotal, 0), 1);
+    const filled = Math.round(ratio * width);
+    const bar = `${"#".repeat(filled)}${"-".repeat(width - filled)}`;
+    const percent = Math.round(ratio * 100);
+    return `${label} [${bar}] ${percent}% ${formatBytes(bytesWritten)} / ${formatBytes(totalBytes)}`;
+}
+export function createByteProgressReporter(options) {
+    const stream = options.stream ?? process.stderr;
+    const enabled = options.enabled ?? Boolean(stream.isTTY);
+    const minDelta = Math.max(64 * 1024, Math.floor(options.totalBytes / 100));
+    let lastRenderedBytes = -1;
+    let hasRendered = false;
+    const render = (bytesWritten) => {
+        if (!enabled) {
+            return;
+        }
+        const boundedBytes = Math.min(Math.max(bytesWritten, 0), options.totalBytes);
+        if (lastRenderedBytes >= 0 &&
+            boundedBytes !== options.totalBytes &&
+            boundedBytes - lastRenderedBytes < minDelta) {
+            return;
+        }
+        const columns = typeof stream.columns === "number" && stream.columns > 0 ? stream.columns : 80;
+        const line = renderProgressLine(options.label, boundedBytes, options.totalBytes).slice(0, Math.max(columns - 1, 20));
+        stream.write(`\r${line}`);
+        lastRenderedBytes = boundedBytes;
+        hasRendered = true;
+    };
+    return {
+        update(bytesWritten) {
+            render(bytesWritten);
+        },
+        complete() {
+            if (lastRenderedBytes !== options.totalBytes) {
+                render(options.totalBytes);
+            }
+            if (enabled && hasRendered) {
+                stream.write("\n");
+            }
+        },
+        abort() {
+            if (enabled && hasRendered) {
+                stream.write("\n");
+            }
+        },
+    };
+}
+//# sourceMappingURL=progress.js.map

package/dist/progress.js.map

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

package/dist/protocol.d.ts

@@ -0,0 +1,5 @@
+import type { TelegramClient } from "telegram";
+import type { FileCardData, FileCardRecord } from "./types.js";
+export { parseFileCardMessage } from "./shared/file-cards.js";
+export declare function validateDownloadableFileCard(data: FileCardData): void;
+export declare function getFileCardByUfid(client: TelegramClient, ufid: string, peer?: string): Promise<FileCardRecord>;

package/dist/protocol.js

@@ -0,0 +1,27 @@
+import { CliError, EXIT_CODES } from "./errors.js";
+import { lookupFileCardByUfid } from "./shared/telegram-files.js";
+export { parseFileCardMessage } from "./shared/file-cards.js";
+export function validateDownloadableFileCard(data) {
+    if (!data.uploadComplete) {
+        throw new CliError("invalid_file_card", "The requested file is not marked as fully uploaded.", EXIT_CODES.INVALID_FILE_CARD);
+    }
+    if (data.ufid.trim() === "" || data.name.trim() === "" || data.IV.trim() === "") {
+        throw new CliError("invalid_file_card", "The requested file card is missing required metadata.", EXIT_CODES.INVALID_FILE_CARD);
+    }
+    if (data.size < 0 || !Number.isFinite(data.size) || data.chunks.length === 0) {
+        throw new CliError("invalid_file_card", "The requested file card is malformed or unsupported.", EXIT_CODES.INVALID_FILE_CARD);
+    }
+}
+export async function getFileCardByUfid(client, ufid, peer = "me") {
+    const trimmed = ufid.trim();
+    if (trimmed === "") {
+        throw new CliError("invalid_ufid", "UFID must not be empty.", EXIT_CODES.GENERAL_ERROR);
+    }
+    const match = await lookupFileCardByUfid(client, trimmed, { peer });
+    if (!match) {
+        throw new CliError("file_not_found", `No TGLFS file card was found for UFID ${trimmed} in ${peer === "me" ? "Saved Messages" : peer}.`, EXIT_CODES.FILE_NOT_FOUND);
+    }
+    validateDownloadableFileCard(match.data);
+    return match;
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAIlD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAGjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAE7D,MAAM,UAAU,4BAA4B,CAAC,IAAkB;IAC3D,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;QACvB,MAAM,IAAI,QAAQ,CACd,mBAAmB,EACnB,qDAAqD,EACrD,UAAU,CAAC,iBAAiB,CAC/B,CAAA;IACL,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC9E,MAAM,IAAI,QAAQ,CACd,mBAAmB,EACnB,uDAAuD,EACvD,UAAU,CAAC,iBAAiB,CAC/B,CAAA;IACL,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,QAAQ,CACd,mBAAmB,EACnB,sDAAsD,EACtD,UAAU,CAAC,iBAAiB,CAC/B,CAAA;IACL,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAsB,EAAE,IAAY,EAAE,IAAI,GAAG,IAAI;IACrF,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAC3B,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,yBAAyB,EAAE,UAAU,CAAC,aAAa,CAAC,CAAA;IAC3F,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,MAAa,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;IAC1E,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,MAAM,IAAI,QAAQ,CACd,gBAAgB,EAChB,yCAAyC,OAAO,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,GAAG,EACjG,UAAU,CAAC,cAAc,CAC5B,CAAA;IACL,CAAC;IAED,4BAA4B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACxC,OAAO,KAAK,CAAA;AAChB,CAAC"}

package/dist/search.d.ts

@@ -0,0 +1,23 @@
+import type { TelegramClient } from "telegram/client/TelegramClient.js";
+import type { FileCardRecord, FileCardSearchSort } from "./shared/file-cards.js";
+export { FILE_CARD_SEARCH_SORT_VALUES } from "./shared/file-cards.js";
+export type { FileCardSearchSort } from "./shared/file-cards.js";
+export type SearchFileCardsOptions = {
+    peer?: string;
+    query?: string;
+    limit?: number;
+    offsetId?: number;
+    sort?: FileCardSearchSort;
+};
+export type SearchFileCardsResult = {
+    peer: string;
+    query: string;
+    sort: FileCardSearchSort;
+    limit: number;
+    offsetId?: number;
+    nextOffsetId?: number;
+    hasMore: boolean;
+    results: FileCardRecord[];
+};
+export declare function searchFileCards(client: TelegramClient, options?: SearchFileCardsOptions): Promise<SearchFileCardsResult>;
+export declare function formatSearchResultsTable(result: SearchFileCardsResult): string;