@atomic-chat/core 0.5.1

package/dist/server/public/videos-params.js

@@ -0,0 +1,220 @@
+/**
+ * The client's `/v1/videos` bodies and the objects it reads back, in the shape of the OpenAI Videos
+ * API, structurally validated but not yet bound to a model. Pure: what the facade in `videos.ts`
+ * parses and serialises.
+ */
+import { nearestValidFrames } from '../../diffusion/index.js';
+import { ParamError } from './images-params.js';
+export const MAX_SECONDS = 600;
+export const DEFAULT_LIST_LIMIT = 20;
+export const MAX_LIST_LIMIT = 100;
+const bad = (param, message) => new ParamError(param, message);
+const isNil = (value) => value === undefined || value === null;
+const SIZE_MESSAGE = "size must be 'WIDTHxHEIGHT' (e.g. '768x512') or 'auto'";
+/**
+ * `'768x512'` → the dimensions; `'auto'` or `''` → `undefined`. Unlike the image facade this sets no
+ * bounds of its own: a video family's range and grid differ per model, and the runner holds the
+ * request to them.
+ */
+export function parseVideoSize(size) {
+    const trimmed = size.trim();
+    if (trimmed === '' || trimmed.toLowerCase() === 'auto')
+        return undefined;
+    const at = trimmed.search(/[xX]/);
+    if (at < 0)
+        throw bad('size', SIZE_MESSAGE);
+    const parse = (text) => /^\+?\d+$/.test(text.trim()) ? Number(text.trim()) : undefined;
+    const width = parse(trimmed.slice(0, at));
+    const height = parse(trimmed.slice(at + 1));
+    if (width === undefined ||
+        height === undefined ||
+        width === 0 ||
+        height === 0 ||
+        width > 0xffff_ffff ||
+        height > 0xffff_ffff)
+        throw bad('size', SIZE_MESSAGE);
+    return { width, height };
+}
+/** `seconds` as OpenAI takes it: a number, or a numeric string such as `"4"`. */
+function parseSeconds(value) {
+    const seconds = typeof value === 'string' && value.trim() !== '' ? Number(value) : value;
+    if (typeof seconds !== 'number' || !Number.isFinite(seconds) || seconds <= 0 || seconds > MAX_SECONDS)
+        throw bad('seconds', `seconds must be a number between 0 and ${MAX_SECONDS}`);
+    return seconds;
+}
+export function parseVideoParams(body) {
+    if (body === null || typeof body !== 'object' || Array.isArray(body))
+        throw bad('body', 'request body must be a JSON object');
+    const obj = body;
+    const rawPrompt = obj['prompt'];
+    const prompt = typeof rawPrompt === 'string' ? rawPrompt.trim() : '';
+    if (prompt === '')
+        throw bad('prompt', 'prompt is required');
+    if (!isNil(obj['input_reference']))
+        throw bad('input_reference', 'input_reference is not supported; the local server generates from text only');
+    const params = { prompt };
+    if (!isNil(obj['seconds']))
+        params.seconds = parseSeconds(obj['seconds']);
+    if (!isNil(obj['size'])) {
+        if (typeof obj['size'] !== 'string')
+            throw bad('size', 'size must be a string');
+        const size = parseVideoSize(obj['size']);
+        if (size)
+            params.size = size;
+    }
+    if (!isNil(obj['seed'])) {
+        const seed = obj['seed'];
+        if (typeof seed !== 'number' || !Number.isSafeInteger(seed))
+            throw bad('seed', 'seed must be an integer');
+        params.seed = seed;
+    }
+    const negative = obj['negative_prompt'];
+    if (!isNil(negative)) {
+        if (typeof negative !== 'string')
+            throw bad('negative_prompt', 'negative_prompt must be a string');
+        if (negative.trim() !== '')
+            params.negativePrompt = negative;
+    }
+    const model = obj['model'];
+    if (!isNil(model)) {
+        if (typeof model !== 'string')
+            throw bad('model', 'model must be a string');
+        if (model.trim() !== '')
+            params.model = model.trim();
+    }
+    return params;
+}
+/**
+ * Bind the request to the loaded family: steps, guidance, sampler and the default size are what the
+ * model was loaded with; `seconds` becomes the nearest valid frame count, clamped to the family's range.
+ */
+export function buildVideoRequest(params, loaded) {
+    const { defaults, ranges } = loaded;
+    const video = defaults.video;
+    const range = ranges.frames;
+    if (video === undefined || range === undefined)
+        throw bad('model', 'the loaded model has no video defaults');
+    const request = {
+        prompt: params.prompt,
+        width: params.size?.width ?? defaults.width,
+        height: params.size?.height ?? defaults.height,
+        frames: video.frames,
+        fps: video.fps,
+        steps: defaults.steps,
+        cfgScale: defaults.cfgScale,
+    };
+    if (params.seconds !== undefined)
+        request.frames = nearestValidFrames(params.seconds * video.fps, { step: video.frameStep, offset: video.frameOffset }, range);
+    if (params.negativePrompt !== undefined)
+        request.negativePrompt = params.negativePrompt;
+    if (defaults.guidance !== undefined)
+        request.guidance = defaults.guidance;
+    if (params.seed !== undefined)
+        request.seed = params.seed;
+    if (defaults.samplingMethod !== undefined)
+        request.samplingMethod = defaults.samplingMethod;
+    if (defaults.flowShift !== undefined)
+        request.flowShift = defaults.flowShift;
+    return request;
+}
+export function videoStatusOf(state) {
+    switch (state) {
+        case 'queued':
+            return 'queued';
+        case 'generating':
+            return 'in_progress';
+        case 'completed':
+            return 'completed';
+        default:
+            return 'failed';
+    }
+}
+const seconds = (frames, fps) => fps > 0 ? String(Math.round((frames / fps) * 100) / 100) : '0';
+export function videoObjectFromJob(job) {
+    const item = job.outputs[0];
+    const fps = job.request.fps ?? item?.fps ?? 0;
+    const frames = item?.frameCount ?? job.request.frames ?? 0;
+    const error = job.state === 'cancelled'
+        ? { code: 'cancelled', message: job.error?.message ?? 'Generation was cancelled.' }
+        : job.error
+            ? { code: job.error.code.toLowerCase(), message: job.error.message }
+            : null;
+    return {
+        id: job.id,
+        object: 'video',
+        model: job.modelId,
+        status: videoStatusOf(job.state),
+        progress: job.state === 'completed'
+            ? 100
+            : Math.max(0, Math.min(100, Math.round((job.progress?.fraction ?? 0) * 100))),
+        created_at: Math.floor(job.createdAtMs / 1000),
+        completed_at: job.finishedAtMs === undefined ? null : Math.floor(job.finishedAtMs / 1000),
+        expires_at: null,
+        seconds: seconds(frames, fps),
+        size: `${job.request.width}x${job.request.height}`,
+        prompt: job.request.prompt,
+        remixed_from_video_id: null,
+        error,
+        atomic: {
+            job_id: job.id,
+            seed: item?.recipe.seed ?? null,
+            path: item?.path ?? null,
+            poster_path: item?.posterPath ?? null,
+        },
+    };
+}
+/** A clip the gallery still holds after the job record is gone: always completed. */
+export function videoObjectFromItem(item) {
+    return {
+        id: item.id,
+        object: 'video',
+        model: item.recipe.model.modelId,
+        status: 'completed',
+        progress: 100,
+        created_at: Math.floor(item.createdAtMs / 1000),
+        completed_at: Math.floor((item.createdAtMs + item.recipe.durationMs) / 1000),
+        expires_at: null,
+        seconds: seconds(item.frameCount, item.fps),
+        size: `${item.width}x${item.height}`,
+        prompt: item.recipe.prompt,
+        remixed_from_video_id: null,
+        error: null,
+        atomic: { job_id: item.id, seed: item.recipe.seed, path: item.path, poster_path: item.posterPath },
+    };
+}
+/** `/videos`, `/videos/{id}` and `/videos/{id}/content`; anything else under `/videos/` is nothing. */
+export function matchVideoPath(path) {
+    if (path === '/videos')
+        return { kind: 'collection' };
+    const m = /^\/videos\/([^/]+)(\/content)?$/.exec(path);
+    if (!m)
+        return undefined;
+    const id = decodeURIComponent(m[1]);
+    return m[2] ? { kind: 'content', id } : { kind: 'video', id };
+}
+/** The methods a matched path accepts, for the 405's `Allow`. */
+export function allowedVideoMethods(match) {
+    switch (match.kind) {
+        case 'collection':
+            return ['GET', 'POST'];
+        case 'video':
+            return ['GET', 'DELETE'];
+        default:
+            return ['GET'];
+    }
+}
+/** `?limit&after&order` of the listing; `order` is accepted and the list is newest first either way. */
+export function parseListQuery(query) {
+    const params = new URLSearchParams(query ?? '');
+    const rawLimit = params.get('limit');
+    let limit = DEFAULT_LIST_LIMIT;
+    if (rawLimit !== null && rawLimit !== '') {
+        const value = Number(rawLimit);
+        if (!Number.isInteger(value) || value < 1 || value > MAX_LIST_LIMIT)
+            throw bad('limit', `limit must be an integer between 1 and ${MAX_LIST_LIMIT}`);
+        limit = value;
+    }
+    const after = params.get('after');
+    return after ? { limit, after } : { limit };
+}
+//# sourceMappingURL=videos-params.js.map

package/dist/server/public/videos-params.js.map

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

package/dist/server/public/videos.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `/v1/videos`: an asynchronous facade over the video job runner in the shape of the OpenAI Videos
+ * API. `POST` queues a clip and answers its video object at once; `GET /videos/{id}` is the poll,
+ * `GET /videos/{id}/content` streams the WebM, `DELETE` cancels a running job or removes a finished
+ * clip, `GET /videos` lists what is in memory and in the gallery. There is no job table: a running
+ * job is the runner's record, a finished clip is its gallery item, so a completed video outlives a
+ * restart of the core. The resident video model is the only model, and it is absent from `/models`.
+ */
+import type { Exchange } from './exchange.js';
+import type { VideoPathMatch } from './videos-params.js';
+export declare const NO_VIDEO_MODEL_MESSAGE = "No video model loaded. Load a video model in Atomic Chat first.";
+export declare const VIDEO_CONTENT_TYPE = "video/webm";
+/** How much of the gallery a listing looks at: the newest clips, which is what a client pages through. */
+export declare const LIST_SCAN_LIMIT = 1000;
+/** Every `/videos*` request; `match` is what `matchVideoPath` made of the path. */
+export declare function serveVideos(ex: Exchange, match: VideoPathMatch): Promise<void>;

package/dist/server/public/videos.js

@@ -0,0 +1,188 @@
+/**
+ * `/v1/videos`: an asynchronous facade over the video job runner in the shape of the OpenAI Videos
+ * API. `POST` queues a clip and answers its video object at once; `GET /videos/{id}` is the poll,
+ * `GET /videos/{id}/content` streams the WebM, `DELETE` cancels a running job or removes a finished
+ * clip, `GET /videos` lists what is in memory and in the gallery. There is no job table: a running
+ * job is the runner's record, a finished clip is its gallery item, so a completed video outlives a
+ * restart of the core. The resident video model is the only model, and it is absent from `/models`.
+ */
+import { createReadStream } from 'node:fs';
+import { stat } from 'node:fs/promises';
+import { answer, invalidJsonMessage } from './exchange.js';
+import { errorBody, errorKindFor, mapError, modelMatches, ParamError } from './images-params.js';
+import { IMAGES_BACKEND_LABEL } from './images.js';
+import { allowedVideoMethods, buildVideoRequest, parseListQuery, parseVideoParams, videoObjectFromItem, videoObjectFromJob, } from './videos-params.js';
+import { readBody } from './wire.js';
+export const NO_VIDEO_MODEL_MESSAGE = 'No video model loaded. Load a video model in Atomic Chat first.';
+export const VIDEO_CONTENT_TYPE = 'video/webm';
+/** How much of the gallery a listing looks at: the newest clips, which is what a client pages through. */
+export const LIST_SCAN_LIMIT = 1000;
+const JSON_HEADERS = [['Content-Type', 'application/json']];
+function fail(ex, status, body, errorKind) {
+    ex.trace.errorKind = errorKind;
+    answer(ex, status, body, JSON_HEADERS);
+}
+const notFound = (ex) => fail(ex, 404, errorBody('Video not found.', 'invalid_request_error', 'not_found', null), 'not_found');
+/** The video object of `id`: the runner's record while it has one, else the gallery's clip. */
+async function lookup(videos, id) {
+    const job = videos.job(id);
+    if (job) {
+        const item = job.outputs[0];
+        return item ? { object: videoObjectFromJob(job), item } : { object: videoObjectFromJob(job) };
+    }
+    const item = await videos.item(id);
+    return item ? { object: videoObjectFromItem(item), item } : undefined;
+}
+async function serveCreate(ex, videos) {
+    const { trace } = ex;
+    let parsed;
+    try {
+        parsed = JSON.parse((ex.body ?? (await readBody(ex.req))).toString('utf8'));
+    }
+    catch (e) {
+        return fail(ex, 400, errorBody(invalidJsonMessage(e), 'invalid_request_error', null, null), 'bad_request');
+    }
+    let started;
+    try {
+        const params = parseVideoParams(parsed);
+        trace.modelId = params.model ?? null;
+        const loaded = videos.loaded();
+        if (!loaded || loaded.modality !== 'video' || !modelMatches(params.model, loaded))
+            return fail(ex, 503, errorBody(NO_VIDEO_MODEL_MESSAGE, 'server_error', 'model_not_loaded', null), 'not_found');
+        trace.modelId = loaded.modelId;
+        trace.backend = IMAGES_BACKEND_LABEL;
+        started = await videos.start(buildVideoRequest(params, loaded));
+    }
+    catch (raw) {
+        if (raw instanceof ParamError)
+            return fail(ex, 400, errorBody(raw.message, 'invalid_request_error', null, raw.param), 'bad_request');
+        const error = raw;
+        const mapped = mapError((error.code ?? 'INTERNAL'));
+        const message = mapped.status === 400 && error.details ? `${error.message} (${error.details})` : error.message;
+        return fail(ex, mapped.status, errorBody(message, mapped.type, mapped.code, null), errorKindFor(mapped.status));
+    }
+    // Nobody awaits `done` here: the client polls, and the runner's record is the truth.
+    void started.done;
+    const job = videos.job(started.id);
+    if (!job)
+        return fail(ex, 500, errorBody('The job vanished.', 'server_error', 'server_error', null), 'upstream');
+    answer(ex, 200, JSON.stringify(videoObjectFromJob(job)), JSON_HEADERS);
+}
+async function serveList(ex, videos) {
+    let query;
+    try {
+        query = parseListQuery(ex.query);
+    }
+    catch (raw) {
+        if (!(raw instanceof ParamError))
+            throw raw;
+        return fail(ex, 400, errorBody(raw.message, 'invalid_request_error', null, raw.param), 'bad_request');
+    }
+    // Running and failed jobs first (they have no clip yet), then the gallery, newest first, no duplicates.
+    const seen = new Set();
+    const all = [];
+    for (const job of videos.jobs()) {
+        if (job.state === 'completed')
+            continue;
+        seen.add(job.id);
+        all.push(videoObjectFromJob(job));
+    }
+    const page = await videos.list({ offset: 0, limit: LIST_SCAN_LIMIT, includeArchived: true });
+    for (const item of page.items) {
+        if (seen.has(item.id))
+            continue;
+        seen.add(item.id);
+        all.push(videoObjectFromItem(item));
+    }
+    let start = 0;
+    if (query.after !== undefined) {
+        const at = all.findIndex((video) => video.id === query.after);
+        start = at < 0 ? all.length : at + 1;
+    }
+    const data = all.slice(start, start + query.limit);
+    const body = {
+        object: 'list',
+        data,
+        first_id: data[0]?.id ?? null,
+        last_id: data[data.length - 1]?.id ?? null,
+        has_more: start + data.length < all.length,
+    };
+    answer(ex, 200, JSON.stringify(body), JSON_HEADERS);
+}
+async function serveContent(ex, videos, id) {
+    const found = await lookup(videos, id);
+    if (!found || found.object.status !== 'completed' || !found.item)
+        return notFound(ex);
+    const variant = new URLSearchParams(ex.query ?? '').get('variant') ?? 'video';
+    let path;
+    let type;
+    let name;
+    if (variant === 'video') {
+        path = found.item.path;
+        type = VIDEO_CONTENT_TYPE;
+        name = `${id}.webm`;
+    }
+    else if (variant === 'thumbnail' && found.item.posterPath) {
+        path = found.item.posterPath;
+        type = 'image/png';
+        name = `${id}.png`;
+    }
+    else
+        return notFound(ex);
+    const meta = await stat(path).catch(() => undefined);
+    if (!meta?.isFile())
+        return notFound(ex);
+    ex.res.writeHead(200, [
+        ['Content-Type', type],
+        ['Content-Length', String(meta.size)],
+        ['Content-Disposition', `inline; filename="${name}"`],
+        ...ex.cors,
+    ].flat());
+    await new Promise((resolve) => {
+        const stream = createReadStream(path);
+        stream.on('error', () => {
+            ex.res.destroy();
+            resolve();
+        });
+        ex.res.on('close', resolve);
+        stream.pipe(ex.res);
+    });
+}
+async function serveDelete(ex, videos, id) {
+    const job = videos.job(id);
+    if (job && (job.state === 'queued' || job.state === 'generating'))
+        await videos.cancel(id);
+    const item = await videos.item(id);
+    if (item)
+        await videos.delete(id);
+    else if (!job)
+        return notFound(ex);
+    answer(ex, 200, JSON.stringify({ id, object: 'video', deleted: true }), JSON_HEADERS);
+}
+/** Every `/videos*` request; `match` is what `matchVideoPath` made of the path. */
+export async function serveVideos(ex, match) {
+    const videos = ex.deps.videos;
+    const allowed = allowedVideoMethods(match);
+    if (!allowed.includes(ex.method)) {
+        ex.trace.errorKind = 'method_not_allowed';
+        return answer(ex, 405, 'Method Not Allowed', [['Allow', allowed.join(', ')]]);
+    }
+    if (!videos)
+        return fail(ex, 503, errorBody(NO_VIDEO_MODEL_MESSAGE, 'server_error', 'model_not_loaded', null), 'not_found');
+    // Polls and downloads are client bookkeeping: never reported.
+    if (ex.method === 'GET')
+        ex.trace.skipEmit = true;
+    switch (match.kind) {
+        case 'collection':
+            return ex.method === 'POST' ? serveCreate(ex, videos) : serveList(ex, videos);
+        case 'video': {
+            if (ex.method === 'DELETE')
+                return serveDelete(ex, videos, match.id);
+            const found = await lookup(videos, match.id);
+            return found ? answer(ex, 200, JSON.stringify(found.object), JSON_HEADERS) : notFound(ex);
+        }
+        default:
+            return serveContent(ex, videos, match.id);
+    }
+}
+//# sourceMappingURL=videos.js.map

package/dist/server/public/videos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"videos.js","sourceRoot":"","sources":["../../../src/server/public/videos.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAEvC,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAE1D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAChG,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAElD,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEpC,MAAM,CAAC,MAAM,sBAAsB,GAAG,iEAAiE,CAAA;AACvG,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAA;AAC9C,0GAA0G;AAC1G,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAA;AAEnC,MAAM,YAAY,GAA4B,CAAC,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC,CAAA;AAEpF,SAAS,IAAI,CAAC,EAAY,EAAE,MAAc,EAAE,IAAY,EAAE,SAAiB;IACzE,EAAE,CAAC,KAAK,CAAC,SAAS,GAAG,SAAS,CAAA;IAC9B,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,CAAC,CAAA;AACxC,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,EAAY,EAAE,EAAE,CAChC,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,kBAAkB,EAAE,uBAAuB,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,WAAW,CAAC,CAAA;AAEvG,+FAA+F;AAC/F,KAAK,UAAU,MAAM,CACnB,MAAqB,EACrB,EAAU;IAEV,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC1B,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;QAC3B,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAA;IAC/F,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAClC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;AACvE,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,EAAY,EAAE,MAAqB;IAC5D,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;IACpB,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;IAC7E,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,uBAAuB,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,aAAa,CAAC,CAAA;IAC5G,CAAC;IACD,IAAI,OAAoD,CAAA;IACxD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;QACvC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,IAAI,IAAI,CAAA;QACpC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAA;QAC9B,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC;YAC/E,OAAO,IAAI,CACT,EAAE,EACF,GAAG,EACH,SAAS,CAAC,sBAAsB,EAAE,cAAc,EAAE,kBAAkB,EAAE,IAAI,CAAC,EAC3E,WAAW,CACZ,CAAA;QACH,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAA;QAC9B,KAAK,CAAC,OAAO,GAAG,oBAAoB,CAAA;QACpC,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACjE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,UAAU;YAC3B,OAAO,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,uBAAuB,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,CAAA;QACvG,MAAM,KAAK,GAAG,GAA2D,CAAA;QACzE,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,UAAU,CAAmC,CAAC,CAAA;QACrF,MAAM,OAAO,GACX,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAA;QAChG,OAAO,IAAI,CACT,EAAE,EACF,MAAM,CAAC,MAAM,EACb,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,EAClD,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAC5B,CAAA;IACH,CAAC;IACD,qFAAqF;IACrF,KAAK,OAAO,CAAC,IAAI,CAAA;IACjB,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAClC,IAAI,CAAC,GAAG;QACN,OAAO,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,mBAAmB,EAAE,cAAc,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,UAAU,CAAC,CAAA;IACxG,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,CAAA;AACxE,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,EAAY,EAAE,MAAqB;IAC1D,IAAI,KAAwC,CAAA;IAC5C,IAAI,CAAC;QACH,KAAK,GAAG,cAAc,CAAC,EAAE,CAAC,KAAK,CAAC,CAAA;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,CAAC,GAAG,YAAY,UAAU,CAAC;YAAE,MAAM,GAAG,CAAA;QAC3C,OAAO,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,uBAAuB,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,CAAA;IACvG,CAAC;IACD,wGAAwG;IACxG,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,MAAM,GAAG,GAAkB,EAAE,CAAA;IAC7B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAChC,IAAI,GAAG,CAAC,KAAK,KAAK,WAAW;YAAE,SAAQ;QACvC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAChB,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAA;IACnC,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAA;IAC5F,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,SAAQ;QAC/B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACjB,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAA;IACrC,CAAC;IACD,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,KAAK,CAAC,CAAA;QAC7D,KAAK,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACtC,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;IAClD,MAAM,IAAI,GAAG;QACX,MAAM,EAAE,MAAM;QACd,IAAI;QACJ,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,IAAI;QAC7B,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,IAAI,IAAI;QAC1C,QAAQ,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM;KAC3C,CAAA;IACD,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAA;AACrD,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,EAAY,EAAE,MAAqB,EAAE,EAAU;IACzE,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACtC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,KAAK,CAAC,IAAI;QAAE,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAA;IACrF,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,OAAO,CAAA;IAC7E,IAAI,IAAY,CAAA;IAChB,IAAI,IAAY,CAAA;IAChB,IAAI,IAAY,CAAA;IAChB,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAA;QACtB,IAAI,GAAG,kBAAkB,CAAA;QACzB,IAAI,GAAG,GAAG,EAAE,OAAO,CAAA;IACrB,CAAC;SAAM,IAAI,OAAO,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QAC5D,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAA;QAC5B,IAAI,GAAG,WAAW,CAAA;QAClB,IAAI,GAAG,GAAG,EAAE,MAAM,CAAA;IACpB,CAAC;;QAAM,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAA;IAC1B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IACpD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE;QAAE,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAA;IACxC,EAAE,CAAC,GAAG,CAAC,SAAS,CACd,GAAG,EACH;QACE,CAAC,cAAc,EAAE,IAAI,CAAC;QACtB,CAAC,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC,qBAAqB,EAAE,qBAAqB,IAAI,GAAG,CAAC;QACrD,GAAG,EAAE,CAAC,IAAI;KACX,CAAC,IAAI,EAAE,CACT,CAAA;IACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAA;QACrC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAA;YAChB,OAAO,EAAE,CAAA;QACX,CAAC,CAAC,CAAA;QACF,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAC3B,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;IACrB,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,EAAY,EAAE,MAAqB,EAAE,EAAU;IACxE,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC1B,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,KAAK,YAAY,CAAC;QAAE,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAC1F,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAClC,IAAI,IAAI;QAAE,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;SAC5B,IAAI,CAAC,GAAG;QAAE,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAA;IAClC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,YAAY,CAAC,CAAA;AACvF,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAAY,EAAE,KAAqB;IACnE,MAAM,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAA;IAC7B,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAA;IAC1C,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;QACjC,EAAE,CAAC,KAAK,CAAC,SAAS,GAAG,oBAAoB,CAAA;QACzC,OAAO,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,oBAAoB,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;IAC/E,CAAC;IACD,IAAI,CAAC,MAAM;QACT,OAAO,IAAI,CACT,EAAE,EACF,GAAG,EACH,SAAS,CAAC,sBAAsB,EAAE,cAAc,EAAE,kBAAkB,EAAE,IAAI,CAAC,EAC3E,WAAW,CACZ,CAAA;IACH,8DAA8D;IAC9D,IAAI,EAAE,CAAC,MAAM,KAAK,KAAK;QAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAA;IACjD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,YAAY;YACf,OAAO,EAAE,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;QAC/E,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,IAAI,EAAE,CAAC,MAAM,KAAK,QAAQ;gBAAE,OAAO,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;YACpE,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;YAC5C,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;QAC3F,CAAC;QACD;YACE,OAAO,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;IAC7C,CAAC;AACH,CAAC"}

package/dist/server/public/wire.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Talking to upstreams and writing answers back: the plumbing every public route shares.
+ *
+ * Upstream requests go through `node:http` rather than `fetch`. The proxy forwards the client's own
+ * headers, and `fetch` refuses or rewrites several of them; it also cannot report a transport error
+ * apart from a timeout without guessing. A plain request keeps the forwarded header set, the body
+ * and the error under this module's control.
+ *
+ * Ported from: src-tauri/src/core/server/proxy.rs (`build_streaming_response`, `next_stream_chunk`,
+ * the header loops in `inner_proxy_request`), utils/src/http.rs (`is_cors_header`).
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+/** A stream that delivers nothing for this long is abandoned (the proxy's `STREAM_IDLE_TIMEOUT`). */
+export declare const STREAM_IDLE_TIMEOUT_MS = 600000;
+export type HeaderPairs = Array<[string, string]>;
+export declare function isCorsHeader(name: string): boolean;
+/** The client's headers as sent, names and duplicates preserved. */
+export declare function rawHeaderPairs(req: IncomingMessage): HeaderPairs;
+/** The client's headers minus the named ones (case-insensitive) and the hop-by-hop set. */
+export declare function forwardableHeaders(req: IncomingMessage, exclude: readonly string[]): HeaderPairs;
+export declare function readBody(stream: IncomingMessage): Promise<Buffer>;
+export interface UpstreamResponse {
+    status: number;
+    headers: HeaderPairs;
+    contentType: string | undefined;
+    body: IncomingMessage;
+}
+export interface UpstreamInit {
+    method: string;
+    headers: HeaderPairs;
+    body?: Buffer | string;
+    /** Bounds getting connected, not the exchange: a slow but live generation is never cut off. */
+    connectTimeoutMs: number;
+    /** Aborted when the client goes away, so a half-finished generation stops too. */
+    signal?: AbortSignal;
+}
+/** A transport failure, worded like the proxy's so logs and error bodies stay recognisable. */
+export declare class UpstreamUnreachable extends Error {
+}
+export declare function sendUpstream(url: string, init: UpstreamInit): Promise<UpstreamResponse>;
+export declare function readUpstreamText(response: UpstreamResponse): Promise<string>;
+/** Write a complete answer. */
+export declare function sendWhole(res: ServerResponse, status: number, headers: HeaderPairs, body: string | Buffer): void;
+/** The upstream's headers as the proxy relays them: its own CORS and length dropped, ours added. */
+export declare function relayedHeaders(upstream: UpstreamResponse, cors: HeaderPairs): HeaderPairs;
+/**
+ * Stream an upstream body to the client as it arrives. A stall longer than the idle timeout ends
+ * the response; a client that disconnects tears the upstream down.
+ */
+export declare function pipeBody(res: ServerResponse, source: AsyncIterable<Buffer | string>, onClose?: () => void): Promise<void>;
+/** Relay an upstream answer unchanged (`build_streaming_response`). */
+export declare function relay(res: ServerResponse, upstream: UpstreamResponse, cors: HeaderPairs): Promise<void>;
+export declare function withIdleTimeout<T>(source: AsyncIterable<T>, idleMs: number): AsyncGenerator<T>;