@ticketpm/core 0.0.4

package/dist/media-proxy.js

@@ -0,0 +1,318 @@
+import { isRecord, joinUrl, readTrimmedString } from "./utils.js";
+function buildUploadHeaders(options) {
+    const headers = new Headers({ "Content-Type": options.contentType });
+    if (options.token) {
+        headers.set("Authorization", options.token.startsWith("Bearer ") ? options.token : `Bearer ${options.token}`);
+    }
+    return headers;
+}
+function isValidAvatarHash(avatar) {
+    if (typeof avatar !== "string") {
+        return false;
+    }
+    const normalized = avatar.trim();
+    return normalized.length > 0 && /^[a-zA-Z0-9_]+$/.test(normalized);
+}
+function buildAnimatedAssetUrl(baseUrl, kind, hash, animated) {
+    const url = new URL(joinUrl(baseUrl, `/${kind}/${hash}`));
+    if (animated) {
+        url.searchParams.set("animated", "true");
+    }
+    return url.toString();
+}
+function isLikelyMediaObject(record) {
+    return (readTrimmedString(record, "proxy_url") !== undefined ||
+        readTrimmedString(record, "content_type") !== undefined ||
+        readTrimmedString(record, "filename") !== undefined ||
+        typeof record.width === "number" ||
+        typeof record.height === "number" ||
+        typeof record.size === "number");
+}
+/**
+ * Stateful client with in-memory dedupe so repeated avatar/icon/media uploads
+ * inside a single export run do not fan out into redundant requests.
+ */
+export class TicketPmMediaProxyClient {
+    options;
+    fetchImpl;
+    avatarUploadCache = new Map();
+    iconUploadCache = new Map();
+    attachmentUploadCache = new Map();
+    constructor(options) {
+        this.options = options;
+        this.fetchImpl = options.fetch ?? fetch;
+    }
+    get baseUrl() {
+        return this.options.baseUrl;
+    }
+    /**
+     * Upload a Discord avatar hash to the configured media proxy.
+     *
+     * On success, the returned value is the proxy avatar URL. On failure, this
+     * returns `undefined` and the caller is expected to keep the original avatar
+     * hash untouched in transcript data.
+     */
+    async uploadAvatarHash(hash, userId) {
+        if (!isValidAvatarHash(hash)) {
+            return undefined;
+        }
+        const normalizedHash = hash.trim();
+        const cached = this.avatarUploadCache.get(normalizedHash);
+        if (cached) {
+            return cached;
+        }
+        const request = (async () => {
+            const response = await this.fetchImpl(joinUrl(this.options.baseUrl, "/avatars/upload"), {
+                method: "POST",
+                headers: buildUploadHeaders({
+                    contentType: "application/json",
+                    token: this.options.token
+                }),
+                body: JSON.stringify({ hash: normalizedHash, id: userId })
+            });
+            if (!response.ok) {
+                return undefined;
+            }
+            const payload = (await response.json());
+            if (typeof payload.hash !== "string" || payload.hash.length === 0) {
+                return undefined;
+            }
+            return buildAnimatedAssetUrl(this.options.baseUrl, "avatars", payload.hash, normalizedHash.startsWith("a_"));
+        })();
+        this.avatarUploadCache.set(normalizedHash, request);
+        request.catch(() => {
+            this.avatarUploadCache.delete(normalizedHash);
+        });
+        return request;
+    }
+    async uploadGuildIconHash(hash, guildId) {
+        if (!isValidAvatarHash(hash)) {
+            return undefined;
+        }
+        const normalizedHash = hash.trim();
+        const cached = this.iconUploadCache.get(normalizedHash);
+        if (cached) {
+            return cached;
+        }
+        const request = (async () => {
+            const response = await this.fetchImpl(joinUrl(this.options.baseUrl, "/icons/upload"), {
+                method: "POST",
+                headers: buildUploadHeaders({
+                    contentType: "application/json",
+                    token: this.options.token
+                }),
+                body: JSON.stringify({ hash: normalizedHash, id: guildId })
+            });
+            if (!response.ok) {
+                return undefined;
+            }
+            const payload = (await response.json());
+            if (typeof payload.hash !== "string" || payload.hash.length === 0) {
+                return undefined;
+            }
+            return buildAnimatedAssetUrl(this.options.baseUrl, "icons", payload.hash, normalizedHash.startsWith("a_"));
+        })();
+        this.iconUploadCache.set(normalizedHash, request);
+        request.catch(() => {
+            this.iconUploadCache.delete(normalizedHash);
+        });
+        return request;
+    }
+    /**
+     * Upload a media URL to the configured proxy.
+     *
+     * If the proxy is unavailable, returns a non-2xx response, or produces an
+     * invalid payload, this returns `undefined`. Callers should treat that as a
+     * no-rewrite outcome and keep the original media URL fields.
+     */
+    async uploadAttachmentUrl(url) {
+        const cached = this.attachmentUploadCache.get(url);
+        if (cached) {
+            return cached;
+        }
+        const request = (async () => {
+            const response = await this.fetchImpl(joinUrl(this.options.baseUrl, "/attachments/upload"), {
+                method: "POST",
+                headers: buildUploadHeaders({
+                    contentType: "application/json",
+                    token: this.options.token
+                }),
+                body: JSON.stringify({ url })
+            });
+            if (!response.ok) {
+                return undefined;
+            }
+            const payload = (await response.json());
+            return typeof payload.hash === "string" && payload.hash.length > 0
+                ? joinUrl(this.options.baseUrl, `/attachments/${payload.hash}`)
+                : undefined;
+        })();
+        this.attachmentUploadCache.set(url, request);
+        request.catch(() => {
+            this.attachmentUploadCache.delete(url);
+        });
+        return request;
+    }
+}
+/**
+ * Walk a transcript recursively and collect the media URLs that would be sent
+ * to the proxy service.
+ */
+export function collectTranscriptMediaUrls(messages) {
+    const urls = new Set();
+    const visited = new WeakSet();
+    const maybeAdd = (value) => {
+        if (!value) {
+            return;
+        }
+        try {
+            new URL(value);
+            urls.add(value);
+        }
+        catch {
+            // Skip invalid URLs so callers can still use the set size as progress.
+        }
+    };
+    const visit = (value) => {
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                visit(item);
+            }
+            return;
+        }
+        if (!isRecord(value) || visited.has(value)) {
+            return;
+        }
+        visited.add(value);
+        const mediaSourceUrl = readTrimmedString(value, "proxy_url") ?? readTrimmedString(value, "url");
+        if (mediaSourceUrl && isLikelyMediaObject(value)) {
+            maybeAdd(mediaSourceUrl);
+        }
+        const iconSourceUrl = readTrimmedString(value, "proxy_icon_url") ?? readTrimmedString(value, "icon_url");
+        if (iconSourceUrl) {
+            maybeAdd(iconSourceUrl);
+        }
+        for (const nestedValue of Object.values(value)) {
+            visit(nestedValue);
+        }
+    };
+    for (const message of messages) {
+        visit(message);
+    }
+    return urls;
+}
+/**
+ * Upload all avatar hashes already present in `context.users` so the media API
+ * can cache them, but keep `user.avatar` as the original Discord hash.
+ *
+ * The viewer still expects `user.avatar` to be a raw Discord avatar hash and
+ * derives the final CDN URL from `user.id + user.avatar`. Replacing the field
+ * with a proxy URL would make the serialized transcript incompatible with the
+ * existing viewer contract.
+ */
+export async function proxyTranscriptAvatarsInPlace(users, client, options) {
+    const uploads = Object.values(users)
+        .filter((user) => isValidAvatarHash(user.avatar))
+        .map((user) => ({ hash: user.avatar.trim(), userId: user.id }));
+    const total = uploads.length;
+    let completed = 0;
+    options?.onProgress?.(completed, total);
+    for (const upload of uploads) {
+        await client.uploadAvatarHash(upload.hash, upload.userId);
+        completed += 1;
+        options?.onProgress?.(completed, total);
+    }
+}
+/**
+ * Proxy the guild icon if one exists and mutate the guild object in place.
+ */
+export async function proxyGuildIconInPlace(guild, client) {
+    if (!isValidAvatarHash(guild.icon)) {
+        return undefined;
+    }
+    const proxied = await client.uploadGuildIconHash(guild.icon.trim(), guild.id);
+    if (proxied) {
+        guild.proxy_icon_url = proxied;
+    }
+    return proxied;
+}
+function isAlreadyRewrittenAttachmentUrl(baseUrl, url) {
+    return url.startsWith(joinUrl(baseUrl, "/attachments/"));
+}
+async function rewriteMediaUrlFields(record, client) {
+    const mediaSourceUrl = readTrimmedString(record, "proxy_url") ?? readTrimmedString(record, "url");
+    if (mediaSourceUrl && isLikelyMediaObject(record) && !isAlreadyRewrittenAttachmentUrl(client.baseUrl, mediaSourceUrl)) {
+        const proxiedUrl = await client.uploadAttachmentUrl(mediaSourceUrl);
+        if (proxiedUrl) {
+            record.proxy_url = proxiedUrl;
+        }
+    }
+    const iconSourceUrl = readTrimmedString(record, "proxy_icon_url") ?? readTrimmedString(record, "icon_url");
+    if (iconSourceUrl && !isAlreadyRewrittenAttachmentUrl(client.baseUrl, iconSourceUrl)) {
+        const proxiedIconUrl = await client.uploadAttachmentUrl(iconSourceUrl);
+        if (proxiedIconUrl) {
+            record.proxy_icon_url = proxiedIconUrl;
+        }
+    }
+}
+/**
+ * Rewrite nested media-bearing fields to prefer the ticket.pm proxy service.
+ *
+ * Failure behavior:
+ *
+ * - successful proxy uploads write `proxy_url` or `proxy_icon_url`
+ * - failed proxy uploads leave existing fields unchanged
+ * - original Discord-hosted media URLs remain available as fallback
+ */
+export async function rewriteTranscriptMediaUrlsInPlace(messages, client, options) {
+    const visited = new WeakSet();
+    const expectedUrls = options?.expectedUrls ?? collectTranscriptMediaUrls(messages);
+    const total = expectedUrls.size;
+    let completed = 0;
+    options?.onProgress?.(completed, total);
+    const visit = async (value) => {
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                await visit(item);
+            }
+            return;
+        }
+        if (!isRecord(value) || visited.has(value)) {
+            return;
+        }
+        visited.add(value);
+        const mediaSourceUrl = readTrimmedString(value, "proxy_url") ?? readTrimmedString(value, "url");
+        if (mediaSourceUrl && expectedUrls.delete(mediaSourceUrl)) {
+            completed += 1;
+            options?.onProgress?.(completed, total);
+        }
+        await rewriteMediaUrlFields(value, client);
+        for (const nestedValue of Object.values(value)) {
+            await visit(nestedValue);
+        }
+    };
+    for (const message of messages) {
+        await visit(message);
+    }
+}
+/**
+ * Convenience wrapper for callers that keep the whole transcript structure
+ * together while proxying assets.
+ *
+ * This helper is best-effort. Media proxy failures do not throw away the
+ * original transcript media fields; they simply leave them as they were.
+ */
+export async function proxyTranscriptAssetsInPlace(transcript, client, options) {
+    if (transcript.context.users) {
+        await proxyTranscriptAvatarsInPlace(transcript.context.users, client, {
+            onProgress: options?.avatarProgress
+        });
+    }
+    if (transcript.context.guild) {
+        await proxyGuildIconInPlace(transcript.context.guild, client);
+    }
+    await rewriteTranscriptMediaUrlsInPlace(transcript.messages, client, {
+        onProgress: options?.mediaProgress
+    });
+}
+//# sourceMappingURL=media-proxy.js.map

package/dist/media-proxy.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,12 @@
+type ZstdCompressOptions = {
+    level?: number;
+    runtime?: "auto" | "bun" | "node";
+};
+type BunLike = {
+    zstdCompress(bytes: Uint8Array, options?: ZstdCompressOptions): Uint8Array | ArrayBuffer | Promise<Uint8Array | ArrayBuffer>;
+};
+export declare function getBunRuntime(): BunLike | undefined;
+export declare function isRunningOnBun(): boolean;
+export declare function compressWithRuntimeZstd(bytes: Uint8Array, options?: ZstdCompressOptions): Promise<Uint8Array>;
+export {};
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAIA,KAAK,mBAAmB,GAAG;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;CAClC,CAAC;AAEF,KAAK,OAAO,GAAG;IACd,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,WAAW,CAAC,CAAC;CAC7H,CAAC;AAMF,wBAAgB,aAAa,IAAI,OAAO,GAAG,SAAS,CAYnD;AAED,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAyBD,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAenH"}

package/dist/runtime.js

@@ -0,0 +1,48 @@
+import { promisify } from "node:util";
+import { toUint8Array } from "./utils.js";
+let nodeZstdCompressPromise;
+export function getBunRuntime() {
+    const maybeBun = globalThis.Bun;
+    if (typeof maybeBun === "object" &&
+        maybeBun !== null &&
+        "zstdCompress" in maybeBun &&
+        typeof maybeBun.zstdCompress === "function") {
+        return maybeBun;
+    }
+    return undefined;
+}
+export function isRunningOnBun() {
+    return getBunRuntime() !== undefined;
+}
+async function getNodeZstdCompress() {
+    if (!nodeZstdCompressPromise) {
+        nodeZstdCompressPromise = (async () => {
+            const { zstdCompress } = await import("node:zlib");
+            // Polyfill node versions without zstd
+            if (typeof zstdCompress !== "function") {
+                throw new Error("Node.js runtime does not expose zstd compression. Use Bun or a Node.js version with node:zlib zstd support.");
+            }
+            const zstdCompressAsync = promisify(zstdCompress);
+            return async (bytes, options) => {
+                const compressed = await zstdCompressAsync(bytes, options);
+                return toUint8Array(compressed);
+            };
+        })();
+    }
+    return nodeZstdCompressPromise;
+}
+// Bun is much faster for this native zstd path, otherwise fallback to standard Node zlib
+export async function compressWithRuntimeZstd(bytes, options) {
+    const runtime = options?.runtime ?? "auto";
+    const bun = getBunRuntime();
+    if (runtime !== "node" && bun) {
+        const compressed = await bun.zstdCompress(bytes, options);
+        return toUint8Array(compressed);
+    }
+    if (runtime === "bun") {
+        throw new Error("Bun runtime was requested for ZSTD compression, but Bun is not available.");
+    }
+    const nodeZstdCompress = await getNodeZstdCompress();
+    return nodeZstdCompress(bytes, options);
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAa1C,IAAI,uBAA8D,CAAC;AAEnE,MAAM,UAAU,aAAa;IAC5B,MAAM,QAAQ,GAAI,UAAgC,CAAC,GAAG,CAAC;IACvD,IACC,OAAO,QAAQ,KAAK,QAAQ;QAC5B,QAAQ,KAAK,IAAI;QACjB,cAAc,IAAI,QAAQ;QAC1B,OAAO,QAAQ,CAAC,YAAY,KAAK,UAAU,EAC1C,CAAC;QACF,OAAO,QAAmB,CAAC;IAC5B,CAAC;IAED,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,cAAc;IAC7B,OAAO,aAAa,EAAE,KAAK,SAAS,CAAC;AACtC,CAAC;AAED,KAAK,UAAU,mBAAmB;IACjC,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAC9B,uBAAuB,GAAG,CAAC,KAAK,IAAI,EAAE;YACrC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;YACnD,sCAAsC;YACtC,IAAI,OAAO,YAAY,KAAK,UAAU,EAAE,CAAC;gBACxC,MAAM,IAAI,KAAK,CACd,6GAA6G,CAC7G,CAAC;YACH,CAAC;YACD,MAAM,iBAAiB,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;YAElD,OAAO,KAAK,EAAE,KAAiB,EAAE,OAA6B,EAAuB,EAAE;gBACtF,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,OAAgB,CAAC,CAAC;gBACpE,OAAO,YAAY,CAAC,UAAU,CAAC,CAAC;YACjC,CAAC,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;IACN,CAAC;IAED,OAAO,uBAAuB,CAAC;AAChC,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,KAAiB,EAAE,OAA6B;IAC7F,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,MAAM,CAAC;IAC3C,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAE5B,IAAI,OAAO,KAAK,MAAM,IAAI,GAAG,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC1D,OAAO,YAAY,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAC9F,CAAC;IAED,MAAM,gBAAgB,GAAG,MAAM,mBAAmB,EAAE,CAAC;IACrD,OAAO,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC"}