tglfs 0.1.0

package/dist/search.js

@@ -0,0 +1,81 @@
+import { FILE_CARD_SEARCH_SORT_VALUES, formatFileCardDate, formatFileCardSize, sortFileCardRecords, } from "./shared/file-cards.js";
+import { listFileCards } from "./shared/telegram-files.js";
+export { FILE_CARD_SEARCH_SORT_VALUES } from "./shared/file-cards.js";
+const DEFAULT_SEARCH_LIMIT = 50;
+function shellQuote(value) {
+    if (value === "") {
+        return "''";
+    }
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function padCell(value, width) {
+    return value.padEnd(width, " ");
+}
+export async function searchFileCards(client, options = {}) {
+    const peer = options.peer?.trim() || "me";
+    const query = options.query?.trim() ?? "";
+    const limit = options.limit ?? DEFAULT_SEARCH_LIMIT;
+    const sort = options.sort ?? FILE_CARD_SEARCH_SORT_VALUES[0];
+    const offsetId = options.offsetId;
+    const rawResults = await listFileCards(client, {
+        peer,
+        query,
+        limit,
+        offsetId,
+    });
+    const results = rawResults.slice();
+    sortFileCardRecords(results, sort);
+    return {
+        peer,
+        query,
+        sort,
+        limit,
+        offsetId,
+        nextOffsetId: rawResults.length === limit ? rawResults.at(-1)?.msgId : undefined,
+        hasMore: rawResults.length === limit,
+        results,
+    };
+}
+export function formatSearchResultsTable(result) {
+    const peer = result.peer ?? "me";
+    if (result.results.length === 0) {
+        const location = peer === "me" ? "Saved Messages" : peer;
+        return result.query === ""
+            ? peer === "me"
+                ? "No TGLFS files found."
+                : `No TGLFS files found in ${location}.`
+            : `No TGLFS files found for query ${shellQuote(result.query)} in ${location}.`;
+    }
+    const headers = ["Name", "Size", "Date", "UFID", "Status"];
+    const rows = result.results.map((record) => [
+        record.data.name,
+        formatFileCardSize(record.data.size),
+        formatFileCardDate(record.date),
+        record.data.ufid,
+        record.data.uploadComplete ? "Complete" : "Incomplete",
+    ]);
+    const widths = headers.map((header, index) => Math.max(header.length, ...rows.map((row) => row[index].length)));
+    const lines = [
+        headers.map((header, index) => padCell(header, widths[index])).join("  "),
+        widths.map((width) => "-".repeat(width)).join("  "),
+        ...rows.map((row) => row.map((cell, index) => padCell(cell, widths[index])).join("  ")),
+        "",
+        `Showing ${result.results.length} result(s).`,
+    ];
+    if (result.hasMore && result.nextOffsetId !== undefined) {
+        const parts = ["tglfs", "search"];
+        if (result.query !== "") {
+            parts.push(shellQuote(result.query));
+        }
+        if (peer !== "me") {
+            parts.push("--peer", shellQuote(peer));
+        }
+        parts.push("--limit", String(result.limit), "--offset-id", String(result.nextOffsetId));
+        if (result.sort !== FILE_CARD_SEARCH_SORT_VALUES[0]) {
+            parts.push("--sort", result.sort);
+        }
+        lines.push(`Next page: ${parts.join(" ")}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

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

package/dist/secrets.d.ts

@@ -0,0 +1,12 @@
+type ResolveOptionalPasswordOptions = {
+    password?: string;
+    passwordEnv?: string | boolean;
+    passwordStdin?: boolean;
+    defaultEnv: string;
+    promptMessage: string;
+    stdinMessage: string;
+    fallbackValue?: string;
+    promptOnInteractive?: boolean;
+};
+export declare function resolveOptionalPassword(options: ResolveOptionalPasswordOptions): Promise<string | undefined>;
+export {};

package/dist/secrets.js

@@ -0,0 +1,29 @@
+import { CliError, EXIT_CODES } from "./errors.js";
+import { isInteractiveSession, promptPassword, readTrimmedStdin } from "./interactive.js";
+export async function resolveOptionalPassword(options) {
+    if (options.password !== undefined) {
+        return options.password;
+    }
+    const envName = typeof options.passwordEnv === "string" && options.passwordEnv.trim() !== ""
+        ? options.passwordEnv.trim()
+        : options.passwordEnv
+            ? options.defaultEnv
+            : undefined;
+    if (envName && process.env[envName] !== undefined) {
+        return process.env[envName] ?? "";
+    }
+    if (process.env[options.defaultEnv] !== undefined) {
+        return process.env[options.defaultEnv] ?? "";
+    }
+    if (options.passwordStdin) {
+        if (process.stdin.isTTY) {
+            throw new CliError("interactive_required", options.stdinMessage, EXIT_CODES.INTERACTIVE_REQUIRED);
+        }
+        return readTrimmedStdin(options.stdinMessage);
+    }
+    if (!isInteractiveSession() || options.promptOnInteractive === false) {
+        return options.fallbackValue;
+    }
+    return promptPassword(options.promptMessage);
+}
+//# sourceMappingURL=secrets.js.map

package/dist/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAazF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,OAAuC;IACjF,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC,QAAQ,CAAA;IAC3B,CAAC;IAED,MAAM,OAAO,GACT,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE;QACxE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE;QAC5B,CAAC,CAAC,OAAO,CAAC,WAAW;YACnB,CAAC,CAAC,OAAO,CAAC,UAAU;YACpB,CAAC,CAAC,SAAS,CAAA;IAErB,IAAI,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;QAChD,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;IACrC,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,SAAS,EAAE,CAAC;QAChD,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,CAAA;IAChD,CAAC;IACD,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QACxB,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACtB,MAAM,IAAI,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC,YAAY,EAAE,UAAU,CAAC,oBAAoB,CAAC,CAAA;QACrG,CAAC;QACD,OAAO,gBAAgB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;IACjD,CAAC;IACD,IAAI,CAAC,oBAAoB,EAAE,IAAI,OAAO,CAAC,mBAAmB,KAAK,KAAK,EAAE,CAAC;QACnE,OAAO,OAAO,CAAC,aAAa,CAAA;IAChC,CAAC;IACD,OAAO,cAAc,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;AAChD,CAAC"}

package/dist/shared/archive.d.ts

@@ -0,0 +1,9 @@
+export type ArchiveEntry = {
+    name: string;
+    size: number;
+    lastModified: number;
+    stream(): ReadableStream<Uint8Array> | Promise<ReadableStream<Uint8Array>>;
+};
+export declare function computeTarSize(files: ArchiveEntry[]): number;
+export declare function defaultArchiveName(now?: Date): string;
+export declare function createTarStream(files: ArchiveEntry[]): ReadableStream<Uint8Array>;

package/dist/shared/archive.js

@@ -0,0 +1,95 @@
+export function computeTarSize(files) {
+    const block = 512;
+    let total = 0;
+    for (const file of files) {
+        const dataSize = Math.ceil(file.size / block) * block;
+        total += block + dataSize;
+    }
+    total += block * 2;
+    return total;
+}
+export function defaultArchiveName(now = new Date()) {
+    const pad2 = (value) => value.toString().padStart(2, "0");
+    return `files_${now.getFullYear()}${pad2(now.getMonth() + 1)}${pad2(now.getDate())}_${pad2(now.getHours())}${pad2(now.getMinutes())}${pad2(now.getSeconds())}.tar`;
+}
+export function createTarStream(files) {
+    async function* generate() {
+        const block = 512;
+        const textEncoder = new TextEncoder();
+        const writeString = (buf, offset, value, length) => {
+            const bytes = textEncoder.encode(value);
+            const copied = Math.min(bytes.length, length);
+            buf.set(bytes.subarray(0, copied), offset);
+            for (let index = offset + copied; index < offset + length; index += 1) {
+                buf[index] = 0;
+            }
+        };
+        const writeOctal = (buf, offset, value, length) => {
+            const octal = value.toString(8);
+            writeString(buf, offset, octal.padStart(length - 1, "0") + "\0", length);
+        };
+        for (const file of files) {
+            const header = new Uint8Array(block);
+            writeString(header, 0, file.name.slice(0, 100), 100);
+            writeString(header, 100, "0000777\0", 8);
+            writeString(header, 108, "0000000\0", 8);
+            writeString(header, 116, "0000000\0", 8);
+            writeOctal(header, 124, file.size, 12);
+            writeOctal(header, 136, Math.floor(file.lastModified / 1000) || Math.floor(Date.now() / 1000), 12);
+            for (let index = 148; index < 156; index += 1) {
+                header[index] = 32;
+            }
+            header[156] = "0".charCodeAt(0);
+            writeString(header, 257, "ustar\0", 6);
+            writeString(header, 263, "00", 2);
+            writeString(header, 265, "user", 32);
+            writeString(header, 297, "group", 32);
+            writeString(header, 329, "\0", 8);
+            writeString(header, 337, "\0", 8);
+            let checksum = 0;
+            for (let index = 0; index < block; index += 1) {
+                checksum += header[index];
+            }
+            const checksumString = checksum.toString(8).padStart(6, "0");
+            for (let index = 0; index < 6; index += 1) {
+                header[148 + index] = checksumString.charCodeAt(index);
+            }
+            header[154] = 0;
+            header[155] = 32;
+            yield header;
+            const reader = (await file.stream()).getReader();
+            let totalRead = 0;
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    break;
+                }
+                if (value && value.length > 0) {
+                    yield value;
+                    totalRead += value.length;
+                }
+            }
+            const padding = (block - (totalRead % block)) % block;
+            if (padding > 0) {
+                yield new Uint8Array(padding);
+            }
+        }
+        yield new Uint8Array(block);
+        yield new Uint8Array(block);
+    }
+    return new ReadableStream({
+        async start(controller) {
+            try {
+                for await (const chunk of generate()) {
+                    controller.enqueue(chunk);
+                }
+            }
+            catch (error) {
+                controller.error(error);
+                return;
+            }
+            controller.close();
+        },
+    });
+}
+//# sourceMappingURL=archive.js.map

package/dist/shared/archive.js.map

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

package/dist/shared/constants.d.ts

@@ -0,0 +1,5 @@
+export declare const BUNDLED_CHUNK_SIZE: number;
+export declare const DOWNLOAD_PART_SIZE: number;
+export declare const UPLOAD_PART_SIZE: number;
+export declare const BATCH_LIMIT = 50;
+export declare const BATCH_DELAY_MS = 1000;

package/dist/shared/constants.js

@@ -0,0 +1,6 @@
+export const BUNDLED_CHUNK_SIZE = 1024 ** 3 * 2;
+export const DOWNLOAD_PART_SIZE = 1024 * 1024;
+export const UPLOAD_PART_SIZE = 512 * 1024;
+export const BATCH_LIMIT = 50;
+export const BATCH_DELAY_MS = 1000;
+//# sourceMappingURL=constants.js.map

package/dist/shared/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAA;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAAA;AAC7C,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,GAAG,IAAI,CAAA;AAC1C,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAA;AAC7B,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAA"}

package/dist/shared/file-cards.d.ts

@@ -0,0 +1,31 @@
+export type FileCardData = {
+    name: string;
+    ufid: string;
+    size: number;
+    uploadComplete: boolean;
+    chunks: number[];
+    IV: string;
+};
+export type FileCardRecord = {
+    msgId: number;
+    date: number;
+    data: FileCardData;
+};
+export type FileCardMessageLike = {
+    id: number;
+    date: number;
+    message?: string | null;
+};
+export declare const FILE_CARD_PREFIX = "tglfs:file";
+export declare const FILE_CARD_SEARCH_SORT_VALUES: readonly ["date_desc", "date_asc", "name_asc", "name_desc", "size_desc", "size_asc"];
+export type FileCardSearchSort = (typeof FILE_CARD_SEARCH_SORT_VALUES)[number];
+export declare function isFileCardData(value: unknown): value is FileCardData;
+export declare function parseFileCardMessage(message: string): FileCardData | null;
+export declare function serializeFileCardMessage(data: FileCardData): string;
+export declare function extractFileCardRecord(message: FileCardMessageLike): FileCardRecord | null;
+export declare function extractFileCardRecords(messages: Iterable<FileCardMessageLike>): FileCardRecord[];
+export declare function buildFileCardSearchQuery(query?: string): string;
+export declare function buildFileCardUfidLookupQuery(ufid: string): string;
+export declare function sortFileCardRecords(records: FileCardRecord[], sort: FileCardSearchSort): void;
+export declare function formatFileCardSize(size: number): string;
+export declare function formatFileCardDate(epochSec: number): string;

package/dist/shared/file-cards.js

@@ -0,0 +1,103 @@
+export const FILE_CARD_PREFIX = "tglfs:file";
+export const FILE_CARD_SEARCH_SORT_VALUES = [
+    "date_desc",
+    "date_asc",
+    "name_asc",
+    "name_desc",
+    "size_desc",
+    "size_asc",
+];
+export function isFileCardData(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const candidate = value;
+    return (typeof candidate.name === "string" &&
+        typeof candidate.ufid === "string" &&
+        typeof candidate.size === "number" &&
+        typeof candidate.uploadComplete === "boolean" &&
+        Array.isArray(candidate.chunks) &&
+        candidate.chunks.every((chunk) => typeof chunk === "number") &&
+        typeof candidate.IV === "string");
+}
+export function parseFileCardMessage(message) {
+    if (!message.startsWith(FILE_CARD_PREFIX)) {
+        return null;
+    }
+    try {
+        const payload = JSON.parse(message.substring(message.indexOf("{")));
+        return isFileCardData(payload) ? payload : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function serializeFileCardMessage(data) {
+    return `${FILE_CARD_PREFIX}\n${JSON.stringify(data)}`;
+}
+export function extractFileCardRecord(message) {
+    if (typeof message.message !== "string") {
+        return null;
+    }
+    const data = parseFileCardMessage(message.message);
+    if (!data) {
+        return null;
+    }
+    return {
+        msgId: message.id,
+        date: message.date,
+        data,
+    };
+}
+export function extractFileCardRecords(messages) {
+    const results = [];
+    for (const message of messages) {
+        const record = extractFileCardRecord(message);
+        if (record) {
+            results.push(record);
+        }
+    }
+    return results;
+}
+export function buildFileCardSearchQuery(query = "") {
+    return `${FILE_CARD_PREFIX} ${query.trim()}`.trim();
+}
+export function buildFileCardUfidLookupQuery(ufid) {
+    return `${FILE_CARD_PREFIX} "ufid":"${ufid.trim()}"`;
+}
+export function sortFileCardRecords(records, sort) {
+    records.sort((a, b) => {
+        switch (sort) {
+            case "date_desc":
+                return b.date - a.date;
+            case "date_asc":
+                return a.date - b.date;
+            case "name_asc":
+                return a.data.name.localeCompare(b.data.name);
+            case "name_desc":
+                return b.data.name.localeCompare(a.data.name);
+            case "size_desc":
+                return b.data.size - a.data.size;
+            case "size_asc":
+                return a.data.size - b.data.size;
+        }
+    });
+}
+export function formatFileCardSize(size) {
+    if (size <= 0 || !Number.isFinite(size)) {
+        return "0 B";
+    }
+    const units = ["B", "KiB", "MiB", "GiB", "TiB"];
+    const unitIndex = Math.floor(Math.log(size) / Math.log(1024));
+    const value = size / Math.pow(1024, unitIndex);
+    return `${value.toFixed(unitIndex === 0 ? 0 : 2)} ${units[unitIndex]}`;
+}
+export function formatFileCardDate(epochSec) {
+    const date = new Date(epochSec * 1000);
+    const pad = (value) => (value < 10 ? `0${value}` : String(value));
+    return [
+        `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`,
+        `${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`,
+    ].join(" ");
+}
+//# sourceMappingURL=file-cards.js.map

package/dist/shared/file-cards.js.map

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

package/dist/shared/telegram-files.d.ts

@@ -0,0 +1,84 @@
+import type { FileCardData, FileCardRecord } from "./file-cards.js";
+type ApiLike = {
+    messages: {
+        EditMessage: new (args: any) => any;
+        DeleteMessages: new (args: any) => any;
+        ForwardMessages: new (args: any) => any;
+    };
+};
+type TelegramFileClient = {
+    getMessages(peer: string, options: unknown): Promise<any[]>;
+    invoke(request: any): Promise<any>;
+    sendMessage(peer: string, options: {
+        message: string;
+    }): Promise<any>;
+};
+type ListFileCardsOptions = {
+    peer?: string;
+    query?: string;
+    limit?: number;
+    offsetId?: number;
+};
+type LookupFileCardByUfidOptions = {
+    peer?: string;
+    limit?: number;
+};
+type WriteFileCardOptions = {
+    Api: ApiLike;
+    peer?: string;
+    msgId?: number;
+    peerId?: unknown;
+    data: FileCardData;
+};
+type DeleteFileCardOptions = {
+    Api: ApiLike;
+    msgId: number;
+    data: FileCardData;
+};
+type ForwardChunkMessagesOptions = {
+    Api: ApiLike;
+    fromPeer?: string;
+    toPeer: string;
+    chunkIds: number[];
+    silent?: boolean;
+    batchLimit?: number;
+    batchDelayMs?: number;
+    onChunkForwarded?: (progress: {
+        completed: number;
+        total: number;
+        sourceChunkId: number;
+        targetChunkId: number;
+    }) => void;
+};
+type TransferFileCardOptions = {
+    Api: ApiLike;
+    record: FileCardRecord;
+    sourcePeer?: string;
+    targetPeer: string;
+    silent?: boolean;
+    batchLimit?: number;
+    batchDelayMs?: number;
+    onChunkForwarded?: ForwardChunkMessagesOptions["onChunkForwarded"];
+};
+type UnsendFileCardOptions = {
+    Api: ApiLike;
+    record: FileCardRecord;
+    peer?: string;
+    batchLimit?: number;
+    batchDelayMs?: number;
+};
+export declare function listFileCards(client: TelegramFileClient, options?: ListFileCardsOptions): Promise<FileCardRecord[]>;
+export declare function lookupFileCardByUfid(client: TelegramFileClient, ufid: string, options?: LookupFileCardByUfidOptions): Promise<FileCardRecord | null>;
+export declare function writeFileCardMessage(client: TelegramFileClient, options: WriteFileCardOptions): Promise<any>;
+export declare function renameFileCardMessage(client: TelegramFileClient, options: WriteFileCardOptions & {
+    newName: string;
+}): Promise<any>;
+export declare function deleteFileCardMessages(client: TelegramFileClient, options: DeleteFileCardOptions): Promise<any>;
+export declare function forwardChunkMessages(client: TelegramFileClient, options: ForwardChunkMessagesOptions): Promise<number[]>;
+export declare function transferFileCard(client: TelegramFileClient & {
+    sendMessage(peer: string, options: {
+        message: string;
+    }): Promise<any>;
+}, options: TransferFileCardOptions): Promise<FileCardRecord>;
+export declare function unsendFileCard(client: TelegramFileClient, options: UnsendFileCardOptions): Promise<any>;
+export {};

package/dist/shared/telegram-files.js

@@ -0,0 +1,137 @@
+import { BATCH_DELAY_MS, BATCH_LIMIT } from "./constants.js";
+import { buildFileCardSearchQuery, buildFileCardUfidLookupQuery, extractFileCardRecords, serializeFileCardMessage, } from "./file-cards.js";
+function resolvePeer(peer) {
+    return peer?.trim() ? peer.trim() : "me";
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function extractForwardedMessageId(result) {
+    const updateWithId = result?.updates?.find?.((update) => typeof update?.id === "number");
+    const id = updateWithId?.id ?? result?.updates?.[0]?.id;
+    return typeof id === "number" ? id : null;
+}
+export async function listFileCards(client, options = {}) {
+    const peer = resolvePeer(options.peer);
+    const messages = await client.getMessages(peer, {
+        search: buildFileCardSearchQuery(options.query),
+        limit: options.limit ?? 50,
+        addOffset: 0,
+        minId: 0,
+        maxId: options.offsetId ?? 0,
+        waitTime: 0,
+    });
+    return extractFileCardRecords(messages);
+}
+export async function lookupFileCardByUfid(client, ufid, options = {}) {
+    const trimmed = ufid.trim();
+    if (trimmed === "") {
+        return null;
+    }
+    const peer = resolvePeer(options.peer);
+    const messages = await client.getMessages(peer, {
+        search: buildFileCardUfidLookupQuery(trimmed),
+        limit: options.limit ?? 10,
+        waitTime: 0,
+    });
+    return extractFileCardRecords(messages).find((record) => record.data.ufid === trimmed) ?? null;
+}
+export async function writeFileCardMessage(client, options) {
+    const peer = resolvePeer(options.peer);
+    const message = serializeFileCardMessage(options.data);
+    if (options.msgId === undefined) {
+        return client.sendMessage(peer, { message });
+    }
+    return client.invoke(new options.Api.messages.EditMessage({
+        peer: options.peerId ?? peer,
+        id: options.msgId,
+        message,
+    }));
+}
+export async function renameFileCardMessage(client, options) {
+    return writeFileCardMessage(client, {
+        ...options,
+        data: {
+            ...options.data,
+            name: options.newName,
+        },
+    });
+}
+export async function deleteFileCardMessages(client, options) {
+    return client.invoke(new options.Api.messages.DeleteMessages({
+        id: [...options.data.chunks, options.msgId],
+    }));
+}
+export async function forwardChunkMessages(client, options) {
+    const sourcePeer = resolvePeer(options.fromPeer);
+    const batchLimit = options.batchLimit ?? BATCH_LIMIT;
+    const batchDelayMs = options.batchDelayMs ?? BATCH_DELAY_MS;
+    const targetChunkIds = [];
+    for (let index = 0; index < options.chunkIds.length; index += 1) {
+        const sourceChunkId = options.chunkIds[index];
+        const result = await client.invoke(new options.Api.messages.ForwardMessages({
+            fromPeer: sourcePeer,
+            toPeer: options.toPeer,
+            id: [sourceChunkId],
+            silent: options.silent ?? false,
+        }));
+        const targetChunkId = extractForwardedMessageId(result);
+        if (targetChunkId === null) {
+            throw new Error(`Unable to determine forwarded Telegram message id for chunk ${sourceChunkId}.`);
+        }
+        targetChunkIds.push(targetChunkId);
+        options.onChunkForwarded?.({
+            completed: targetChunkIds.length,
+            total: options.chunkIds.length,
+            sourceChunkId,
+            targetChunkId,
+        });
+        const completed = index + 1;
+        if (completed % batchLimit === 0 && completed < options.chunkIds.length) {
+            await sleep(batchDelayMs);
+        }
+    }
+    return targetChunkIds;
+}
+export async function transferFileCard(client, options) {
+    const updatedChunks = await forwardChunkMessages(client, {
+        Api: options.Api,
+        fromPeer: options.sourcePeer,
+        toPeer: options.targetPeer,
+        chunkIds: options.record.data.chunks,
+        silent: options.silent,
+        batchLimit: options.batchLimit,
+        batchDelayMs: options.batchDelayMs,
+        onChunkForwarded: options.onChunkForwarded,
+    });
+    const updatedData = {
+        ...options.record.data,
+        chunks: updatedChunks,
+    };
+    const message = await client.sendMessage(resolvePeer(options.targetPeer), {
+        message: serializeFileCardMessage(updatedData),
+    });
+    return {
+        msgId: message.id,
+        date: message.date,
+        data: updatedData,
+    };
+}
+export async function unsendFileCard(client, options) {
+    const peer = resolvePeer(options.peer);
+    const batchLimit = options.batchLimit ?? BATCH_LIMIT;
+    const batchDelayMs = options.batchDelayMs ?? BATCH_DELAY_MS;
+    for (let index = 0; index < options.record.data.chunks.length; index += batchLimit) {
+        const batch = options.record.data.chunks.slice(index, index + batchLimit);
+        await client.invoke(new options.Api.messages.DeleteMessages({
+            id: batch,
+        }));
+        if (index + batch.length < options.record.data.chunks.length) {
+            await sleep(batchDelayMs);
+        }
+    }
+    return client.invoke(new options.Api.messages.DeleteMessages({
+        id: [options.record.msgId],
+    }));
+}
+//# sourceMappingURL=telegram-files.js.map

package/dist/shared/telegram-files.js.map

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