@ticketpm/core 0.0.4

package/dist/upload-client.d.ts

@@ -0,0 +1,99 @@
+import { MAX_TRANSCRIPT_COMPRESSED_BYTES, MAX_TRANSCRIPT_DECOMPRESSED_BYTES } from "./constants.js";
+import { TicketPmMediaProxyClient, type TicketPmMediaProxyClientOptions, type UploadProgressCallback } from "./media-proxy.js";
+import type { StoredTranscript, TranscriptBuildInput } from "./types.js";
+export interface TicketPmUploadClientOptions {
+    /**
+     * Base transcript API URL, for example `https://ticket.pm/v2`.
+     */
+    baseUrl: string;
+    /**
+     * Optional bearer token or raw token string. Raw values are normalized into
+     * the `Authorization: Bearer ...` header automatically.
+     */
+    token?: string;
+    /**
+     * Optional custom fetch implementation for environments that need their own
+     * HTTP transport, instrumentation, retries, or authentication pipeline.
+     */
+    fetch?: typeof fetch;
+    /**
+     * Base URL used when `uploadDraftTranscript()` auto-creates a media proxy
+     * client for you.
+     *
+     * Defaults to `https://m.ticket.pm/v2`.
+     */
+    defaultMediaProxyBaseUrl?: string;
+}
+export interface UploadCompressedTranscriptOptions {
+    /**
+     * Match the current first-party bot behavior of requesting URL-safe random IDs
+     * via `?uuid=uuid`.
+     */
+    uuidStyleIds?: boolean;
+}
+export type UploadDraftTranscriptMediaProxy = false | TicketPmMediaProxyClient | Partial<Pick<TicketPmMediaProxyClientOptions, "baseUrl" | "token" | "fetch">>;
+export interface UploadDraftTranscriptOptions extends UploadCompressedTranscriptOptions {
+    /**
+     * Optional ZSTD compression level forwarded to `compressStoredTranscript()`.
+     */
+    level?: number;
+    /**
+     * Media proxy configuration for draft uploads.
+     *
+     * - omit this value to auto-create a proxy client with the uploader token and
+     *   `https://m.ticket.pm/v2`
+     * - pass an existing `TicketPmMediaProxyClient` to fully control media proxy
+     *   behavior
+     * - pass a partial options object to override only `baseUrl`, `token`, and/or
+     *   `fetch`
+     * - pass `false` to disable media proxying entirely for this upload
+     */
+    mediaProxy?: UploadDraftTranscriptMediaProxy;
+    /**
+     * Optional progress callback for avatar cache uploads performed before the
+     * transcript is built.
+     */
+    avatarProgress?: UploadProgressCallback;
+    /**
+     * Optional progress callback for attachment/embed/icon proxy rewrites
+     * performed before the transcript is built.
+     */
+    mediaProgress?: UploadProgressCallback;
+}
+export interface TicketPmUploadResult {
+    id: string;
+    rateLimitRemaining?: number;
+    rateLimitReset?: number;
+}
+/**
+ * Minimal upload client for `POST /v2/upload`.
+ */
+export declare class TicketPmUploadClient {
+    private readonly options;
+    private readonly fetchImpl;
+    constructor(options: TicketPmUploadClientOptions);
+    uploadCompressedTranscript(compressed: Uint8Array, options?: UploadCompressedTranscriptOptions): Promise<TicketPmUploadResult>;
+    uploadTranscript(transcript: StoredTranscript, options?: UploadCompressedTranscriptOptions & {
+        level?: number;
+    }): Promise<TicketPmUploadResult>;
+    /**
+     * High-level draft upload helper.
+     *
+     * This clones the draft transcript, proxies assets when enabled, compacts the
+     * draft into the stored transcript contract, compresses it, and uploads it.
+     *
+     * When `options.mediaProxy` is omitted, the client auto-creates a
+     * `TicketPmMediaProxyClient` using:
+     *
+     * - `baseUrl`: `options.defaultMediaProxyBaseUrl ?? https://m.ticket.pm/v2`
+     * - `token`: the uploader token
+     * - `fetch`: the uploader fetch implementation
+     *
+     * Pass `mediaProxy: false` to skip proxying and upload the original media
+     * fields unchanged.
+     */
+    uploadDraftTranscript(draftTranscript: TranscriptBuildInput, options?: UploadDraftTranscriptOptions): Promise<TicketPmUploadResult>;
+    private resolveMediaProxyClient;
+}
+export { MAX_TRANSCRIPT_COMPRESSED_BYTES, MAX_TRANSCRIPT_DECOMPRESSED_BYTES };
+//# sourceMappingURL=upload-client.d.ts.map

package/dist/upload-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-client.d.ts","sourceRoot":"","sources":["../src/upload-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAEN,+BAA+B,EAC/B,iCAAiC,EACjC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEN,wBAAwB,EACxB,KAAK,+BAA+B,EACpC,KAAK,sBAAsB,EAC3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGzE,MAAM,WAAW,2BAA2B;IAC3C;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,iCAAiC;IACjD;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,+BAA+B,GACxC,KAAK,GACL,wBAAwB,GACxB,OAAO,CAAC,IAAI,CAAC,+BAA+B,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;AAEjF,MAAM,WAAW,4BAA6B,SAAQ,iCAAiC;IACtF;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,+BAA+B,CAAC;IAC7C;;;OAGG;IACH,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC;;;OAGG;IACH,aAAa,CAAC,EAAE,sBAAsB,CAAC;CACvC;AAED,MAAM,WAAW,oBAAoB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAUD;;GAEG;AACH,qBAAa,oBAAoB;IAGb,OAAO,CAAC,QAAQ,CAAC,OAAO;IAF3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAEL,OAAO,EAAE,2BAA2B;IAI3D,0BAA0B,CACtC,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,iCAAiC,GACzC,OAAO,CAAC,oBAAoB,CAAC;IAgCnB,gBAAgB,CAC5B,UAAU,EAAE,gBAAgB,EAC5B,OAAO,CAAC,EAAE,iCAAiC,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9D,OAAO,CAAC,oBAAoB,CAAC;IAOhC;;;;;;;;;;;;;;;OAeG;IACU,qBAAqB,CACjC,eAAe,EAAE,oBAAoB,EACrC,OAAO,CAAC,EAAE,4BAA4B,GACpC,OAAO,CAAC,oBAAoB,CAAC;IAehC,OAAO,CAAC,uBAAuB;CAe/B;AAuBD,OAAO,EAAE,+BAA+B,EAAE,iCAAiC,EAAE,CAAC"}

package/dist/upload-client.js

@@ -0,0 +1,115 @@
+import { compressStoredTranscript } from "./canonical.js";
+import { buildStoredTranscript } from "./compact.js";
+import { DEFAULT_TICKETPM_MEDIA_PROXY_BASE_URL, MAX_TRANSCRIPT_COMPRESSED_BYTES, MAX_TRANSCRIPT_DECOMPRESSED_BYTES } from "./constants.js";
+import { proxyTranscriptAssetsInPlace, TicketPmMediaProxyClient } from "./media-proxy.js";
+import { joinUrl } from "./utils.js";
+function buildUploadHeaders(token) {
+    const headers = new Headers({ "Content-Type": "application/octet-stream" });
+    if (token) {
+        headers.set("Authorization", token.startsWith("Bearer ") ? token : `Bearer ${token}`);
+    }
+    return headers;
+}
+/**
+ * Minimal upload client for `POST /v2/upload`.
+ */
+export class TicketPmUploadClient {
+    options;
+    fetchImpl;
+    constructor(options) {
+        this.options = options;
+        this.fetchImpl = options.fetch ?? fetch;
+    }
+    async uploadCompressedTranscript(compressed, options) {
+        if (compressed.byteLength > MAX_TRANSCRIPT_COMPRESSED_BYTES) {
+            throw new Error(`Compressed transcript exceeds ${MAX_TRANSCRIPT_COMPRESSED_BYTES} bytes.`);
+        }
+        const uploadUrl = new URL(joinUrl(this.options.baseUrl, "/upload"));
+        if (options?.uuidStyleIds !== false) {
+            uploadUrl.searchParams.set("uuid", "uuid");
+        }
+        const response = await this.fetchImpl(uploadUrl, {
+            method: "POST",
+            headers: buildUploadHeaders(this.options.token),
+            body: Buffer.from(compressed)
+        });
+        if (!response.ok) {
+            throw new Error(await response.text());
+        }
+        const payload = (await response.json());
+        if (typeof payload.id !== "string" || payload.id.length === 0) {
+            throw new Error("ticket.pm upload completed without returning a transcript id.");
+        }
+        return {
+            id: payload.id,
+            rateLimitRemaining: readNumericHeader(response.headers, "X-RateLimit-Remaining"),
+            rateLimitReset: readNumericHeader(response.headers, "X-RateLimit-Reset")
+        };
+    }
+    async uploadTranscript(transcript, options) {
+        const compressed = await compressStoredTranscript(transcript, {
+            level: options?.level
+        });
+        return this.uploadCompressedTranscript(compressed, options);
+    }
+    /**
+     * High-level draft upload helper.
+     *
+     * This clones the draft transcript, proxies assets when enabled, compacts the
+     * draft into the stored transcript contract, compresses it, and uploads it.
+     *
+     * When `options.mediaProxy` is omitted, the client auto-creates a
+     * `TicketPmMediaProxyClient` using:
+     *
+     * - `baseUrl`: `options.defaultMediaProxyBaseUrl ?? https://m.ticket.pm/v2`
+     * - `token`: the uploader token
+     * - `fetch`: the uploader fetch implementation
+     *
+     * Pass `mediaProxy: false` to skip proxying and upload the original media
+     * fields unchanged.
+     */
+    async uploadDraftTranscript(draftTranscript, options) {
+        const workingDraft = cloneTranscriptBuildInput(draftTranscript);
+        const mediaProxyClient = this.resolveMediaProxyClient(options?.mediaProxy);
+        if (mediaProxyClient) {
+            await proxyTranscriptAssetsInPlace(workingDraft, mediaProxyClient, {
+                avatarProgress: options?.avatarProgress,
+                mediaProgress: options?.mediaProgress
+            });
+        }
+        const transcript = buildStoredTranscript(workingDraft);
+        return this.uploadTranscript(transcript, options);
+    }
+    resolveMediaProxyClient(mediaProxy) {
+        if (mediaProxy === false) {
+            return undefined;
+        }
+        if (mediaProxy instanceof TicketPmMediaProxyClient) {
+            return mediaProxy;
+        }
+        return new TicketPmMediaProxyClient({
+            baseUrl: mediaProxy?.baseUrl ?? this.options.defaultMediaProxyBaseUrl ?? DEFAULT_TICKETPM_MEDIA_PROXY_BASE_URL,
+            token: mediaProxy?.token ?? this.options.token,
+            fetch: mediaProxy?.fetch ?? this.fetchImpl
+        });
+    }
+}
+function cloneTranscriptBuildInput(draftTranscript) {
+    if (typeof structuredClone === "function") {
+        return structuredClone(draftTranscript);
+    }
+    return {
+        context: JSON.parse(JSON.stringify(draftTranscript.context)),
+        messages: JSON.parse(JSON.stringify(draftTranscript.messages))
+    };
+}
+function readNumericHeader(headers, key) {
+    const value = headers.get(key);
+    if (!value) {
+        return undefined;
+    }
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+export { MAX_TRANSCRIPT_COMPRESSED_BYTES, MAX_TRANSCRIPT_DECOMPRESSED_BYTES };
+//# sourceMappingURL=upload-client.js.map

package/dist/upload-client.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,7 @@
+export type UnknownRecord = Record<string, unknown>;
+export declare function isRecord(value: unknown): value is UnknownRecord;
+export declare function readTrimmedString(record: UnknownRecord, key: string): string | undefined;
+export declare function sortRecordByKey<T>(record: Record<string, T> | undefined): Record<string, T> | undefined;
+export declare function toUint8Array(value: Uint8Array | ArrayBuffer): Uint8Array;
+export declare function joinUrl(baseUrl: string, path: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAE/D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQxF;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,CAcvG;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,UAAU,CAExE;AAGD,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI7D"}

package/dist/utils.js

@@ -0,0 +1,35 @@
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function readTrimmedString(record, key) {
+    const value = record[key];
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const normalized = value.trim();
+    return normalized.length > 0 ? normalized : undefined;
+}
+export function sortRecordByKey(record) {
+    if (!record) {
+        return undefined;
+    }
+    return Object.keys(record)
+        .sort()
+        .reduce((accumulator, key) => {
+        const value = record[key];
+        if (value !== undefined) {
+            accumulator[key] = value;
+        }
+        return accumulator;
+    }, {});
+}
+export function toUint8Array(value) {
+    return value instanceof Uint8Array ? value : new Uint8Array(value);
+}
+// Ensure the endpoint joining works as intended without duping slashes
+export function joinUrl(baseUrl, path) {
+    const normalizedBaseUrl = baseUrl.replace(/\/+$/, "");
+    const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+    return `${normalizedBaseUrl}${normalizedPath}`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,QAAQ,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAqB,EAAE,GAAW;IACnE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,eAAe,CAAI,MAAqC;IACvE,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;SACxB,IAAI,EAAE;SACN,MAAM,CAAoB,CAAC,WAAW,EAAE,GAAG,EAAE,EAAE;QAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACzB,WAAW,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC1B,CAAC;QACD,OAAO,WAAW,CAAC;IACpB,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAA+B;IAC3D,OAAO,KAAK,YAAY,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,OAAO,CAAC,OAAe,EAAE,IAAY;IACpD,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACtD,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IAChE,OAAO,GAAG,iBAAiB,GAAG,cAAc,EAAE,CAAC;AAChD,CAAC"}

package/dist/validation.d.ts

@@ -0,0 +1,34 @@
+import type { StoredTranscript, UploadValidationResult } from "./types.js";
+type UrlValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    path: string;
+    reason: string;
+    url?: string;
+};
+/**
+ * Media URLs are tighter than regular links because the viewer renders them
+ * directly.
+ */
+export declare function isValidMediaUrl(url: string | null | undefined): url is string;
+/**
+ * Clickable links can point anywhere as long as the scheme is safe.
+ */
+export declare function isValidLinkUrl(url: string | null | undefined): url is string;
+/**
+ * Mirror the server-side URL walk so consumers can reject unsafe payloads
+ * before they reach `POST /v2/upload`.
+ */
+export declare function validateTranscriptUrls(payload: unknown): UrlValidationResult;
+/**
+ * Validate the same structural requirements enforced by the upload API itself.
+ */
+export declare function validateTicketPmUploadPayload(transcript: unknown): UploadValidationResult;
+/**
+ * Upload acceptance is looser than viewer rendering. This helper closes that
+ * gap by checking the compact hydration references that the renderer needs.
+ */
+export declare function validateViewerCompatibility(transcript: StoredTranscript): UploadValidationResult;
+export {};
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAwB,gBAAgB,EAAyB,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAMxH,KAAK,mBAAmB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AA0BpG;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,GAAG,IAAI,MAAM,CAY7E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,GAAG,IAAI,MAAM,CAM5E;AAuSD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,CAwB5E;AAiCD;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,OAAO,GAAG,sBAAsB,CAuBzF;AA4BD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,gBAAgB,GAAG,sBAAsB,CAuDhG"}