paperkite 0.1.0

package/dist/packages/archive/src/console/live.js

@@ -0,0 +1,144 @@
+import { Readable } from "node:stream";
+import bigInt from "big-integer";
+import { utils } from "telegram";
+import { iterDownload } from "telegram/client/downloads.js";
+import { extFromMime, fetchMessage, fileNameOf, isMissingPeer, liveMediaMime, parseRange, unwrapWebPage } from "./media.js";
+const CHUNK_BYTES = 512 * 1024;
+const DELETED_MESSAGE = "消息已从 Telegram 删除或会话无法访问";
+const UNAVAILABLE_MESSAGE = "无法从 Telegram 取回该媒体";
+export class LiveMediaError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+    }
+}
+/**
+ * 在线媒体直通：一次请求独立从 Telegram 取对应字节区间并转发给响应，
+ * 逐块取用、即时释放会话，播放器的尾部元数据或拖动请求可随时插队。
+ */
+export class LiveMediaStreamer {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async serve(request, reply, file, chatUsername, download) {
+        const { media, size, mime } = await this.resolveMedia(file, chatUsername);
+        const range = request.headers.range;
+        const part = range === undefined ? undefined : parseRange(range, size);
+        if (range !== undefined && part === undefined) {
+            reply.header("content-type", "application/json; charset=utf-8");
+            reply.code(416).header("content-range", `bytes */${size}`);
+            reply.send({ error: "range 请求无效" });
+            return undefined;
+        }
+        const start = part?.start ?? 0;
+        const end = part?.end ?? size - 1;
+        reply.header("content-type", mime);
+        reply.header("accept-ranges", "bytes");
+        reply.header("cache-control", "no-store");
+        if (part !== undefined) {
+            reply.code(206);
+            reply.header("content-range", `bytes ${start}-${end}/${size}`);
+        }
+        reply.header("content-length", String(end - start + 1));
+        if (download) {
+            reply.header("content-disposition", `attachment; filename="${downloadName(file, mime)}"`);
+        }
+        return Readable.from(this.pump(media, start, end - start + 1));
+    }
+    async *pump(media, offset, totalBytes) {
+        let remaining = totalBytes;
+        let position = offset;
+        while (remaining > 0) {
+            const length = Math.min(CHUNK_BYTES, remaining);
+            const bytes = await this.fetchPart(media, position, length);
+            if (bytes === undefined || bytes.length !== length) {
+                throw new Error("live media download truncated");
+            }
+            remaining -= bytes.length;
+            position += bytes.length;
+            yield bytes;
+        }
+    }
+    async fetchPart(media, offset, length) {
+        return this.deps.sessions.run(async (client) => {
+            const host = client;
+            const parts = [];
+            let received = 0;
+            for await (const chunk of liveChunksOf(host, media, offset, Math.ceil(length / CHUNK_BYTES))) {
+                parts.push(chunk);
+                received += chunk.length;
+                if (received >= length)
+                    break;
+            }
+            if (received === 0)
+                return undefined;
+            return Buffer.concat(parts).subarray(0, length);
+        });
+    }
+    async resolveMedia(file, chatUsername) {
+        try {
+            const result = await this.deps.sessions.run(async (client) => {
+                const host = client;
+                const message = await fetchMessage(host, file, chatUsername);
+                if (message === undefined)
+                    return "missing";
+                if (message.media === undefined || message.media === null)
+                    return "unavailable";
+                const media = unwrapWebPage(message.media);
+                const info = utils.getFileInfo(media);
+                const size = totalBytesOf(info.size);
+                if (!(size > 0))
+                    return "unavailable";
+                return { media, size, mime: liveMediaMime(message) };
+            });
+            if (result === "missing")
+                throw new LiveMediaError(410, DELETED_MESSAGE);
+            if (result === "unavailable")
+                throw new LiveMediaError(404, UNAVAILABLE_MESSAGE);
+            return result;
+        }
+        catch (error) {
+            if (error instanceof LiveMediaError)
+                throw error;
+            const missing = isMissingPeer(error);
+            if (missing) {
+                this.deps.logger.debug("live media peer missing for message " + file.messageId + ", likely deleted");
+            }
+            else {
+                this.deps.logger.warn("live media fetch failed for message " + file.messageId, error);
+            }
+            throw new LiveMediaError(missing ? 410 : 404, missing ? DELETED_MESSAGE : UNAVAILABLE_MESSAGE);
+        }
+    }
+}
+function liveChunksOf(client, media, offset, limit) {
+    const provided = client.iterMediaChunks?.(media, { offset, limit });
+    if (provided !== undefined)
+        return provided;
+    return iterDownload(client, {
+        file: media,
+        offset: bigInt(offset),
+        limit,
+        requestSize: CHUNK_BYTES
+    });
+}
+/** gramjs 长整型在不同来源（原生 BigInt / number / big-integer 包装）下的字节数提取。 */
+function totalBytesOf(size) {
+    if (typeof size === "bigint")
+        return Number(size);
+    if (typeof size === "number")
+        return size;
+    if (size !== undefined && size !== null && typeof size.toJSNumber === "function") {
+        return size.toJSNumber();
+    }
+    return 0;
+}
+/** 下载文件名：缺扩展名时按 mime 补齐。 */
+function downloadName(file, mime) {
+    const name = fileNameOf(file, "");
+    const ext = extFromMime(mime);
+    return ext !== "" && !name.includes(".") ? name + ext : name;
+}
+//# sourceMappingURL=live.js.map

package/dist/packages/archive/src/console/live.js.map

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

package/dist/packages/archive/src/console/media.d.ts

@@ -0,0 +1,66 @@
+import type { RuntimeLogger, SessionAccess } from "@paperkite/sdk";
+import type { ArchiveClient, TelegramMessage } from "../archiver.js";
+import type { StoredMediaFile } from "../storage/index.js";
+export interface LiveMediaResult {
+    readonly bytes: Buffer;
+    readonly mime: string;
+}
+/** 在线取回结果：ok 带字节流；missing 表示目标会话/消息已不可达（消息被删等常态情形）。 */
+export type LiveMediaOutcome = ({
+    readonly ok: true;
+} & LiveMediaResult) | {
+    readonly ok: false;
+    readonly missing: boolean;
+};
+/** 在线缩略图结果：noThumb 表示媒体有缩略图可用的判定失败（文档类无 thumbs）。 */
+export type LiveThumbOutcome = ({
+    readonly ok: true;
+} & LiveMediaResult) | {
+    readonly ok: false;
+    readonly missing: boolean;
+    readonly noThumb?: boolean;
+};
+export interface LiveMediaOptions {
+    /** 归档 chats 表里的会话句柄，供在线取回冷启动时解析实体。 */
+    readonly chatUsername?: string;
+    readonly logger: RuntimeLogger;
+}
+/** 落盘路径解析：配置 mediaDir 时限定其内，否则相对进程工作目录解析。 */
+export declare function resolveMediaPath(raw: string | undefined, mediaDir: string | undefined): string | undefined;
+export declare function mimeFromName(path: string): string;
+/** 图片类媒体整图取回，其余（视频/音频/文档）走渐进式流。 */
+export declare function isPhotoLike(value: {
+    readonly mediaType?: string;
+    readonly mimeType?: string;
+}): boolean;
+/** MIME 反查扩展名（用于在线取回媒体的下载命名）。 */
+export declare function extFromMime(mime: string): string;
+export declare function fileNameOf(file: StoredMediaFile, path: string): string;
+export declare function parseRange(header: string, size: number): {
+    start: number;
+    end: number;
+} | undefined;
+/** 经注入会话从 Telegram 取回未落盘媒体；消息/媒体不可得时返回不可用结果。 */
+export declare function fetchLiveMedia(file: StoredMediaFile, sessions: SessionAccess, options: LiveMediaOptions): Promise<LiveMediaOutcome>;
+/**
+ * 在线取回原生缩略图：photo 用最小可用 size，document 系用 videoThumbs/thumbs 首项；
+ * 图片类无任何 size 时回退整图，其余类型（无 thumbs 的文档/音频等）报告 noThumb。
+ */
+export declare function fetchLiveThumb(file: StoredMediaFile, sessions: SessionAccess, options: LiveMediaOptions): Promise<LiveThumbOutcome>;
+/** 消息内嵌网页链接的媒体（链接卡片图），解开到内部 photo/document 再判定。 */
+export declare function unwrapWebPage(media: unknown): unknown;
+/**
+ * 取回目标消息。冷启动会话没有实体缓存时，先按归档用户名解析实体再重试；
+ * 解析不到（渠道私密/不可达）时抛出原始错误，由缺失判定统一归类。
+ */
+export declare function fetchMessage(host: ArchiveClient, file: StoredMediaFile, chatUsername: string | undefined): Promise<TelegramMessage | undefined>;
+/** 按归档用户名解析，失败后回退到会话清单扫描；返回与目标 chatId 匹配的实体。 */
+export declare function resolveChatEntity(host: ArchiveClient, chatId: string, chatUsername: string | undefined): Promise<unknown | undefined>;
+/** 会话/消息已删除或对当前账号不可见时的典型错误。 */
+export declare function isMissingPeer(error: unknown): boolean;
+export declare function liveMediaMime(message: TelegramMessage): string;
+export interface DiskMediaInfo {
+    readonly path: string;
+    readonly size: number;
+}
+export declare function diskMediaInfo(file: StoredMediaFile, mediaDir: string | undefined): Promise<DiskMediaInfo | undefined>;

package/dist/packages/archive/src/console/media.js

@@ -0,0 +1,368 @@
+import { readFile, stat } from "node:fs/promises";
+import { extname, resolve, sep } from "node:path";
+import { utils } from "telegram";
+const EXT_MIME = {
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".png": "image/png",
+    ".webp": "image/webp",
+    ".gif": "image/gif",
+    ".heic": "image/heic",
+    ".avif": "image/avif",
+    ".svg": "image/svg+xml",
+    ".mp4": "video/mp4",
+    ".mov": "video/quicktime",
+    ".webm": "video/webm",
+    ".mkv": "video/x-matroska",
+    ".mp3": "audio/mpeg",
+    ".ogg": "audio/ogg",
+    ".wav": "audio/wav",
+    ".m4a": "audio/mp4",
+    ".pdf": "application/pdf",
+    ".txt": "text/plain",
+    ".md": "text/markdown",
+    ".json": "application/json",
+    ".zip": "application/zip",
+    ".7z": "application/x-7z-compressed",
+    ".rar": "application/vnd.rar"
+};
+/** 落盘路径解析：配置 mediaDir 时限定其内，否则相对进程工作目录解析。 */
+export function resolveMediaPath(raw, mediaDir) {
+    const text = raw?.trim();
+    if (!text)
+        return undefined;
+    const root = mediaDir?.trim() ? resolve(mediaDir) : undefined;
+    const path = root ? resolve(root, text) : resolve(process.cwd(), text);
+    if (root && path !== root && !path.startsWith(root + sep))
+        return undefined;
+    return path;
+}
+export function mimeFromName(path) {
+    return EXT_MIME[extname(path).toLowerCase()] ?? "application/octet-stream";
+}
+/** 图片类媒体整图取回，其余（视频/音频/文档）走渐进式流。 */
+export function isPhotoLike(value) {
+    const mime = value.mimeType ?? "";
+    if (mime.startsWith("image/"))
+        return true;
+    const type = value.mediaType;
+    return type === "photo" || type === "sticker";
+}
+/** MIME 反查扩展名（用于在线取回媒体的下载命名）。 */
+export function extFromMime(mime) {
+    return Object.entries(EXT_MIME).find(([, value]) => value === mime)?.[0] ?? "";
+}
+export function fileNameOf(file, path) {
+    const name = file.fileName?.trim().replace(/["\\]/g, "_");
+    if (name)
+        return name;
+    const base = path.split("/").pop()?.split("\\").pop();
+    return base || `media_${file.id}`;
+}
+export function parseRange(header, size) {
+    const match = /^bytes=(\d*)-(\d*)$/.exec(header.trim());
+    if (!match || size <= 0)
+        return undefined;
+    const startText = match[1] ?? "";
+    const endText = match[2] ?? "";
+    if (startText === "") {
+        if (endText === "")
+            return undefined;
+        const suffix = Number(endText);
+        if (!Number.isInteger(suffix) || suffix <= 0)
+            return undefined;
+        return { start: Math.max(0, size - suffix), end: size - 1 };
+    }
+    const start = Number(startText);
+    if (!Number.isInteger(start) || start < 0 || start >= size)
+        return undefined;
+    if (endText === "")
+        return { start, end: size - 1 };
+    const end = Math.min(Number(endText), size - 1);
+    if (!Number.isInteger(end) || end < start)
+        return undefined;
+    return { start, end };
+}
+/** 经注入会话从 Telegram 取回未落盘媒体；消息/媒体不可得时返回不可用结果。 */
+export async function fetchLiveMedia(file, sessions, options) {
+    const { chatUsername, logger } = options;
+    try {
+        const result = await sessions.run(async (client) => {
+            const host = client;
+            const message = await fetchMessage(host, file, chatUsername);
+            if (!message)
+                return { state: "missing" };
+            if (!message.media)
+                return { state: "unavailable" };
+            const bytes = await host.downloadMedia(message, {});
+            if (bytes === undefined)
+                return { state: "unavailable" };
+            return { state: "ok", bytes, mime: liveMediaMime(message) };
+        });
+        if (result.state === "missing")
+            return { ok: false, missing: true };
+        if (result.state === "unavailable")
+            return { ok: false, missing: false };
+        const buffer = result.bytes instanceof Buffer ? result.bytes : await readFile(result.bytes);
+        return { ok: true, bytes: buffer, mime: result.mime };
+    }
+    catch (error) {
+        const missing = isMissingPeer(error);
+        if (missing) {
+            logger.debug("live media peer missing for message " + file.messageId + ", likely deleted");
+        }
+        else {
+            logger.warn("live media fetch failed for message " + file.messageId, error);
+        }
+        return { ok: false, missing };
+    }
+}
+/** photo 的最小可用 sizeType 次序（GramJS sizeTypes 中同序的最小两档）。 */
+const PHOTO_THUMB_TYPES = ["s", "m"];
+/**
+ * 在线取回原生缩略图：photo 用最小可用 size，document 系用 videoThumbs/thumbs 首项；
+ * 图片类无任何 size 时回退整图，其余类型（无 thumbs 的文档/音频等）报告 noThumb。
+ */
+export async function fetchLiveThumb(file, sessions, options) {
+    const { chatUsername, logger } = options;
+    try {
+        const result = await sessions.run(async (client) => {
+            const host = client;
+            const message = await fetchMessage(host, file, chatUsername);
+            if (!message)
+                return { state: "missing" };
+            if (!message.media)
+                return { state: "unavailable" };
+            const spec = thumbSpecOf(unwrapWebPage(message.media));
+            if (spec === undefined)
+                return { state: "no-thumb" };
+            if (spec.thumb === undefined) {
+                const bytes = await host.downloadMedia(message, {});
+                if (bytes === undefined)
+                    return { state: "unavailable" };
+                return { state: "ok", bytes, mime: liveMediaMime(message) };
+            }
+            const bytes = await host.downloadMedia(message, { thumb: spec.thumb });
+            if (bytes === undefined || (Buffer.isBuffer(bytes) && bytes.length === 0)) {
+                return { state: "unavailable" };
+            }
+            return { state: "ok", bytes, mime: spec.mime };
+        });
+        if (result.state === "missing")
+            return { ok: false, missing: true };
+        if (result.state === "no-thumb")
+            return { ok: false, missing: false, noThumb: true };
+        if (result.state === "unavailable")
+            return { ok: false, missing: false };
+        const buffer = result.bytes instanceof Buffer ? result.bytes : await readFile(result.bytes);
+        return { ok: true, bytes: buffer, mime: snifImageMime(buffer) ?? result.mime };
+    }
+    catch (error) {
+        const missing = isMissingPeer(error);
+        if (missing) {
+            logger.debug("live media peer missing for message " + file.messageId + ", likely deleted");
+        }
+        else {
+            logger.warn("live media thumb fetch failed for message " + file.messageId, error);
+        }
+        return { ok: false, missing };
+    }
+}
+function thumbSpecOf(media) {
+    const name = className(media);
+    if (name === "MessageMediaPhoto") {
+        const photo = recordOf(recordOf(media)?.photo);
+        const sizes = [...arrayOf(photo?.sizes), ...arrayOf(photo?.videoSizes)];
+        const size = pickPhotoThumb(sizes);
+        return { thumb: size === undefined ? undefined : typeOf(size) ?? size, mime: "image/jpeg" };
+    }
+    if (name === "MessageMediaDocument") {
+        const document = recordOf(recordOf(media)?.document);
+        if (document === undefined)
+            return undefined;
+        const videoThumbs = arrayOf(document.videoThumbs);
+        if (videoThumbs.length > 0)
+            return { thumb: videoThumbs[0], mime: "image/jpeg" };
+        const size = arrayOf(document.thumbs).find(isUsableThumb);
+        if (size === undefined)
+            return undefined;
+        return { thumb: typeOf(size) ?? size, mime: "image/jpeg" };
+    }
+    return undefined;
+}
+/** 消息内嵌网页链接的媒体（链接卡片图），解开到内部 photo/document 再判定。 */
+export function unwrapWebPage(media) {
+    if (className(media) !== "MessageMediaWebPage")
+        return media;
+    const webpage = recordOf(recordOf(media)?.webpage);
+    if (webpage === undefined)
+        return media;
+    return webpage.document ?? webpage.photo ?? media;
+}
+/** 按 sizeType 优先取最小可用 photo size；无匹配时按字节量取最小项。 */
+function pickPhotoThumb(sizes) {
+    for (const type of PHOTO_THUMB_TYPES) {
+        const size = sizes.find((item) => typeOf(item) === type && isUsableThumb(item));
+        if (size !== undefined)
+            return size;
+    }
+    return smallestThumb(sizes);
+}
+function smallestThumb(thumbs) {
+    const usable = thumbs.filter(isUsableThumb);
+    if (usable.length === 0)
+        return undefined;
+    return usable.reduce((best, item) => (thumbWeight(item) < thumbWeight(best) ? item : best));
+}
+function isUsableThumb(value) {
+    const name = className(value);
+    return name !== "PhotoSizeEmpty" && name !== "PhotoPathSize";
+}
+function typeOf(value) {
+    const record = recordOf(value);
+    return record && typeof record.type === "string" && record.type ? record.type : undefined;
+}
+/** 与 gramjs getThumb 排序一致的最小化权重：越小越接近最小缩略图。 */
+function thumbWeight(value) {
+    const record = recordOf(value);
+    if (record === undefined)
+        return 0;
+    switch (className(value)) {
+        case "PhotoStrippedSize":
+        case "PhotoCachedSize":
+            return numberValue(record.bytes?.length) ?? 0;
+        case "PhotoSize":
+            return numberValue(record.size) ?? 0;
+        case "PhotoSizeProgressive": {
+            const sizes = arrayOf(record.sizes).map((item) => numberValue(item) ?? 0);
+            return sizes.length > 0 ? Math.max(...sizes) : 0;
+        }
+        case "VideoSize":
+            return numberValue(record.size) ?? 0;
+        default:
+            return 0;
+    }
+}
+function numberValue(value) {
+    if (value === undefined || value === null || value === "")
+        return undefined;
+    const number = Number(value);
+    return Number.isFinite(number) ? number : undefined;
+}
+/** 贴纸/动图缩略图常以 webp 字节返回：按魔数修正 content-type。 */
+function snifImageMime(bytes) {
+    if (bytes.length >= 12 && bytes[0] === 0x52 && bytes[1] === 0x49 && bytes[2] === 0x46 && bytes[3] === 0x46 &&
+        bytes[8] === 0x57 && bytes[9] === 0x45 && bytes[10] === 0x42 && bytes[11] === 0x50) {
+        return "image/webp";
+    }
+    if (bytes.length >= 3 && bytes[0] === 0xff && bytes[1] === 0xd8 && bytes[2] === 0xff)
+        return "image/jpeg";
+    if (bytes.length >= 8 && bytes[0] === 0x89 && bytes[1] === 0x50 && bytes[2] === 0x4e && bytes[3] === 0x47)
+        return "image/png";
+    if (bytes.length >= 6 && bytes[0] === 0x47 && bytes[1] === 0x49 && bytes[2] === 0x46 && bytes[3] === 0x46)
+        return "image/gif";
+    return undefined;
+}
+function arrayOf(value) {
+    return Array.isArray(value) ? value : [];
+}
+/**
+ * 取回目标消息。冷启动会话没有实体缓存时，先按归档用户名解析实体再重试；
+ * 解析不到（渠道私密/不可达）时抛出原始错误，由缺失判定统一归类。
+ */
+export async function fetchMessage(host, file, chatUsername) {
+    try {
+        return await fetchById(host, file, file.chatId);
+    }
+    catch (error) {
+        if (!isUnresolvedEntityError(error))
+            throw error;
+        const entity = await resolveChatEntity(host, file.chatId, chatUsername);
+        if (entity === undefined)
+            throw error;
+        return fetchById(host, file, entity);
+    }
+}
+async function fetchById(host, file, entity) {
+    const messages = await host.getMessages(entity, { ids: [file.messageId] });
+    return messages.find((item) => item !== undefined && item !== null && item.id === file.messageId);
+}
+/** 按归档用户名解析，失败后回退到会话清单扫描；返回与目标 chatId 匹配的实体。 */
+export async function resolveChatEntity(host, chatId, chatUsername) {
+    const handle = chatUsername?.trim().replace(/^@/, "");
+    if (handle) {
+        try {
+            const entity = await host.getEntity("@" + handle);
+            if (peerIdOf(entity) === chatId)
+                return entity;
+        }
+        catch (error) {
+            // 句柄失效（删除/更名/私密），继续尝试会话清单
+        }
+    }
+    try {
+        for await (const dialog of host.iterDialogs()) {
+            const entity = dialog.entity;
+            if (entity !== undefined && entity !== null && peerIdOf(entity) === chatId)
+                return entity;
+        }
+    }
+    catch (error) {
+        // 会话清单不可迭代时按解析失败处理
+    }
+    return undefined;
+}
+function peerIdOf(entity) {
+    try {
+        return String(utils.getPeerId(entity));
+    }
+    catch {
+        return "";
+    }
+}
+/** 会话/消息已删除或对当前账号不可见时的典型错误。 */
+export function isMissingPeer(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return /could not find (the )?input entity|could not find the entity|CHANNEL_PRIVATE|CHANNEL_INVALID|CHANNEL_FORBIDDEN|CHAT_FORBIDDEN|chat (was )?not found|peer id is invalid/i.test(message);
+}
+/** gramjs 本地实体缓存缺失、尚可尝试解析的错误。 */
+function isUnresolvedEntityError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return /could not find (the )?input entity/i.test(message);
+}
+export function liveMediaMime(message) {
+    const media = message.media;
+    if (className(media) === "MessageMediaPhoto")
+        return "image/jpeg";
+    if (className(media) === "MessageMediaDocument") {
+        const document = recordOf(recordOf(media)?.document);
+        const mime = document?.mimeType;
+        if (typeof mime === "string" && mime.trim())
+            return mime.trim();
+    }
+    return "application/octet-stream";
+}
+function className(value) {
+    if (value === null || value === undefined)
+        return "";
+    const record = recordOf(value);
+    if (record && typeof record.className === "string" && record.className)
+        return record.className;
+    return value.constructor?.name ?? "";
+}
+function recordOf(value) {
+    return typeof value === "object" && value !== null ? value : undefined;
+}
+export async function diskMediaInfo(file, mediaDir) {
+    const path = resolveMediaPath(file.filePath, mediaDir);
+    if (!path)
+        return undefined;
+    try {
+        const info = await stat(path);
+        return info.isFile() ? { path, size: info.size } : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=media.js.map

package/dist/packages/archive/src/console/media.js.map

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

package/dist/packages/archive/src/console/server.d.ts

@@ -0,0 +1,12 @@
+import type { FastifyInstance } from "fastify";
+import type { RuntimeLogger, SessionAccess } from "@paperkite/sdk";
+import type { ArchiveStore } from "../storage/index.js";
+export interface ArchiveConsoleServerOptions {
+    readonly store: ArchiveStore;
+    readonly backend?: string;
+    readonly mediaDir?: string;
+    readonly session?: string;
+    readonly sessions?: SessionAccess;
+    readonly logger: RuntimeLogger;
+}
+export declare function createArchiveConsoleServer(options: ArchiveConsoleServerOptions): FastifyInstance;