@atomic-chat/core 0.5.1

package/dist/diffusion/mutex.d.ts

@@ -0,0 +1,16 @@
+/**
+ * A lock for work that must not interleave: one load or unload at a time, one reader-writer of the
+ * gallery's flags file at a time. Fair (first come, first served), and a holder that throws still
+ * lets the next one in. `tryAcquire` is for the idle timer, which must never wait behind a load.
+ */
+export declare class AsyncMutex {
+    private held;
+    private readonly waiters;
+    private grant;
+    get locked(): boolean;
+    /** Wait for the lock; the returned function gives it back (calling it twice is harmless). */
+    acquire(): Promise<() => void>;
+    /** The lock at once, or `undefined` when someone holds it. */
+    tryAcquire(): (() => void) | undefined;
+    run<T>(work: () => Promise<T>): Promise<T>;
+}

package/dist/diffusion/mutex.js

@@ -0,0 +1,46 @@
+/**
+ * A lock for work that must not interleave: one load or unload at a time, one reader-writer of the
+ * gallery's flags file at a time. Fair (first come, first served), and a holder that throws still
+ * lets the next one in. `tryAcquire` is for the idle timer, which must never wait behind a load.
+ */
+export class AsyncMutex {
+    held = false;
+    waiters = [];
+    grant() {
+        this.held = true;
+        let released = false;
+        return () => {
+            if (released)
+                return;
+            released = true;
+            const next = this.waiters.shift();
+            if (next)
+                next(this.grant());
+            else
+                this.held = false;
+        };
+    }
+    get locked() {
+        return this.held;
+    }
+    /** Wait for the lock; the returned function gives it back (calling it twice is harmless). */
+    acquire() {
+        if (!this.held)
+            return Promise.resolve(this.grant());
+        return new Promise((resolve) => this.waiters.push(resolve));
+    }
+    /** The lock at once, or `undefined` when someone holds it. */
+    tryAcquire() {
+        return this.held ? undefined : this.grant();
+    }
+    async run(work) {
+        const release = await this.acquire();
+        try {
+            return await work();
+        }
+        finally {
+            release();
+        }
+    }
+}
+//# sourceMappingURL=mutex.js.map

package/dist/diffusion/mutex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex.js","sourceRoot":"","sources":["../../src/diffusion/mutex.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,UAAU;IACb,IAAI,GAAG,KAAK,CAAA;IACH,OAAO,GAAyC,EAAE,CAAA;IAE3D,KAAK;QACX,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,QAAQ,GAAG,KAAK,CAAA;QACpB,OAAO,GAAG,EAAE;YACV,IAAI,QAAQ;gBAAE,OAAM;YACpB,QAAQ,GAAG,IAAI,CAAA;YACf,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;YACjC,IAAI,IAAI;gBAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;;gBACvB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAA;QACxB,CAAC,CAAA;IACH,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,IAAI,CAAA;IAClB,CAAC;IAED,6FAA6F;IAC7F,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;QACpD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;IAC7D,CAAC;IAED,8DAA8D;IAC9D,UAAU;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAA;IAC7C,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,IAAsB;QACjC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,EAAE,CAAA;QACrB,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAA;QACX,CAAC;IACH,CAAC;CACF"}

package/dist/diffusion/parse.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Request bodies, read strictly. This stands where serde stood in the plugin: whole numbers where
+ * Rust had `u32`/`u64`/`i64`, closed enums, `null` accepted for anything optional, unknown fields
+ * ignored. A body that does not fit is `INVALID_REQUEST`, and nothing downstream has to doubt a
+ * type again (ADR 2026-09-17-diffusion-speaks-the-apps-camelcase-and-error-codes-verbatim).
+ */
+import type { DiffusionConfig, FinalizeBackendInstallArgs, GalleryFlags, GalleryListOptions, ImageGenerateRequest, LoadDiffusionModelRequest, VideoGenerateRequest } from '../contracts/index.js';
+export declare function parseLoadModelRequest(body: unknown): LoadDiffusionModelRequest;
+export declare function parseImageGenerateRequest(body: unknown): ImageGenerateRequest;
+export declare function parseVideoGenerateRequest(body: unknown): VideoGenerateRequest;
+/** `{png}`: the poster the app rendered, as base64 (a data-URL prefix accepted); the bare payload. */
+export declare function parseVideoPoster(body: unknown): string;
+export declare function parseDiffusionConfig(body: unknown): DiffusionConfig;
+export declare function parseFinalizeArgs(body: unknown): FinalizeBackendInstallArgs;
+export declare function parseGalleryListOptions(body: unknown): GalleryListOptions;
+export declare function parseGalleryFlags(body: unknown): GalleryFlags;
+/** One required string out of a body, for the routes that take nothing else (`path`, `dir`, `id`). */
+export declare function requireString(body: unknown, key: string): string;
+export declare function requireStringList(body: unknown, key: string): string[];

package/dist/diffusion/parse.js

@@ -0,0 +1,274 @@
+/**
+ * Request bodies, read strictly. This stands where serde stood in the plugin: whole numbers where
+ * Rust had `u32`/`u64`/`i64`, closed enums, `null` accepted for anything optional, unknown fields
+ * ignored. A body that does not fit is `INVALID_REQUEST`, and nothing downstream has to doubt a
+ * type again (ADR 2026-09-17-diffusion-speaks-the-apps-camelcase-and-error-codes-verbatim).
+ */
+import { diffusionError } from './errors.js';
+import { isCanonicalBase64, stripDataUrl } from './validate.js';
+import { IMAGE_WORKFLOWS, VIDEO_WORKFLOWS } from './workflow.js';
+const U32_MAX = 0xffff_ffff;
+const ENGINES = ['sd-cpp', 'diffusers'];
+const BACKENDS = ['cpu', 'metal', 'cuda', 'vulkan', 'rocm'];
+const OFFLOADS = ['none', 'group', 'model'];
+const MODALITIES = ['image', 'video'];
+function invalid(field, expected) {
+    throw diffusionError('INVALID_REQUEST', 'The request is not valid.', `${field}: expected ${expected}`);
+}
+function fields(value, field) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        invalid(field, 'an object');
+    return value;
+}
+/** `undefined` for a field that is absent or `null`, which serde's `Option` treats alike. */
+function present(source, key) {
+    const value = source[key];
+    return value === null ? undefined : value;
+}
+function string(value, field) {
+    if (typeof value !== 'string')
+        invalid(field, 'a string');
+    return value;
+}
+function number(value, field) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        invalid(field, 'a number');
+    return value;
+}
+function wholeNumber(value, field, max) {
+    if (typeof value !== 'number' || !Number.isInteger(value) || value < 0 || value > max)
+        invalid(field, 'a whole number, zero or more');
+    return value;
+}
+function signedWholeNumber(value, field) {
+    if (typeof value !== 'number' || !Number.isSafeInteger(value))
+        invalid(field, 'a whole number');
+    return value;
+}
+function boolean(value, field) {
+    if (typeof value !== 'boolean')
+        invalid(field, 'true or false');
+    return value;
+}
+function oneOf(value, allowed, field) {
+    if (typeof value !== 'string' || !allowed.includes(value))
+        invalid(field, `one of ${allowed.join(', ')}`);
+    return value;
+}
+/** Set `key` on `target` only when the source has a value, so absent stays absent on the way out. */
+function copyOptional(target, key, source, field, read) {
+    const value = present(source, key);
+    if (value !== undefined)
+        target[key] = read(value, field);
+}
+const u32 = (value, field) => wholeNumber(value, field, U32_MAX);
+const u64 = (value, field) => wholeNumber(value, field, Number.MAX_SAFE_INTEGER);
+function pair(value, field) {
+    if (!Array.isArray(value) || value.length !== 2)
+        invalid(field, 'a pair of whole numbers');
+    return [u32(value[0], `${field}[0]`), u32(value[1], `${field}[1]`)];
+}
+function parseFiles(value) {
+    const source = fields(value, 'files');
+    const files = {
+        diffusionModel: string(source['diffusionModel'], 'files.diffusionModel'),
+    };
+    for (const key of [
+        'vae',
+        'vaeFormat',
+        'clipL',
+        't5xxl',
+        'llm',
+        'llmVision',
+        'qwen2vl',
+        'audioVae',
+        'embeddingsConnectors',
+    ])
+        copyOptional(files, key, source, `files.${key}`, string);
+    return files;
+}
+function positive(value, field) {
+    const whole = u32(value, field);
+    if (whole === 0)
+        invalid(field, 'a whole number, one or more');
+    return whole;
+}
+function parseResolutionPresets(value, field) {
+    if (!Array.isArray(value))
+        invalid(field, 'a list of [width, height] pairs');
+    return value.map((item, index) => pair(item, `${field}[${index}]`));
+}
+function parseVideoDefaults(value, field) {
+    const source = fields(value, field);
+    return {
+        fps: positive(source['fps'], `${field}.fps`),
+        frames: positive(source['frames'], `${field}.frames`),
+        frameStep: positive(source['frameStep'], `${field}.frameStep`),
+        frameOffset: u32(source['frameOffset'], `${field}.frameOffset`),
+        resolutionPresets: parseResolutionPresets(source['resolutionPresets'], `${field}.resolutionPresets`),
+    };
+}
+function parseSigmas(value, field) {
+    if (!Array.isArray(value) || value.length === 0)
+        invalid(field, 'a non-empty list of numbers');
+    return value.map((item, index) => number(item, `${field}[${index}]`));
+}
+function parseDefaults(value) {
+    const source = fields(value, 'defaults');
+    const defaults = {
+        steps: u32(source['steps'], 'defaults.steps'),
+        cfgScale: number(source['cfgScale'], 'defaults.cfgScale'),
+        width: u32(source['width'], 'defaults.width'),
+        height: u32(source['height'], 'defaults.height'),
+    };
+    copyOptional(defaults, 'guidance', source, 'defaults.guidance', number);
+    copyOptional(defaults, 'samplingMethod', source, 'defaults.samplingMethod', string);
+    copyOptional(defaults, 'flowShift', source, 'defaults.flowShift', number);
+    copyOptional(defaults, 'sigmas', source, 'defaults.sigmas', parseSigmas);
+    copyOptional(defaults, 'video', source, 'defaults.video', parseVideoDefaults);
+    return defaults;
+}
+function parseRanges(value) {
+    const source = fields(value, 'ranges');
+    const ranges = {
+        steps: pair(source['steps'], 'ranges.steps'),
+        dims: pair(source['dims'], 'ranges.dims'),
+        dimMultiple: u32(source['dimMultiple'], 'ranges.dimMultiple'),
+    };
+    copyOptional(ranges, 'frames', source, 'ranges.frames', pair);
+    return ranges;
+}
+export function parseLoadModelRequest(body) {
+    const source = fields(body, 'request');
+    const request = {
+        modelId: string(source['modelId'], 'modelId'),
+        family: string(source['family'], 'family'),
+        modality: oneOf(source['modality'], MODALITIES, 'modality'),
+        displayName: string(source['displayName'], 'displayName'),
+        files: parseFiles(source['files']),
+        defaults: parseDefaults(source['defaults']),
+        ranges: parseRanges(source['ranges']),
+        offload: oneOf(source['offload'], OFFLOADS, 'offload'),
+    };
+    copyOptional(request, 'engine', source, 'engine', (value, field) => oneOf(value, ENGINES, field));
+    copyOptional(request, 'threads', source, 'threads', u32);
+    copyOptional(request, 'startupTimeoutSecs', source, 'startupTimeoutSecs', u64);
+    // A video family must say how it counts frames, or nothing downstream can validate a request.
+    if (request.modality === 'video') {
+        if (request.defaults.video === undefined)
+            invalid('defaults.video', 'the video defaults of a video family');
+        if (request.ranges.frames === undefined)
+            invalid('ranges.frames', 'the frame range of a video family');
+    }
+    return request;
+}
+/** `{path}` is tried first, as the plugin's untagged enum did; an object with neither is refused. */
+function parseSource(value, field) {
+    const source = fields(value, field);
+    if (typeof source['path'] === 'string')
+        return { path: source['path'] };
+    if (typeof source['base64'] === 'string')
+        return { base64: source['base64'] };
+    return invalid(field, 'an image: {path} or {base64}');
+}
+export function parseImageGenerateRequest(body) {
+    const source = fields(body, 'request');
+    const request = {
+        prompt: string(source['prompt'], 'prompt'),
+        width: u32(source['width'], 'width'),
+        height: u32(source['height'], 'height'),
+        steps: u32(source['steps'], 'steps'),
+        cfgScale: number(source['cfgScale'], 'cfgScale'),
+        batchSize: u32(source['batchSize'], 'batchSize'),
+    };
+    copyOptional(request, 'negativePrompt', source, 'negativePrompt', string);
+    copyOptional(request, 'guidance', source, 'guidance', number);
+    copyOptional(request, 'seed', source, 'seed', signedWholeNumber);
+    copyOptional(request, 'samplingMethod', source, 'samplingMethod', string);
+    copyOptional(request, 'flowShift', source, 'flowShift', number);
+    copyOptional(request, 'workflow', source, 'workflow', (value, field) => oneOf(value, IMAGE_WORKFLOWS, field));
+    copyOptional(request, 'initImage', source, 'initImage', parseSource);
+    copyOptional(request, 'maskImage', source, 'maskImage', parseSource);
+    copyOptional(request, 'referenceImages', source, 'referenceImages', (value, field) => {
+        if (!Array.isArray(value))
+            invalid(field, 'a list of images');
+        return value.map((item, index) => parseSource(item, `${field}[${index}]`));
+    });
+    copyOptional(request, 'strength', source, 'strength', number);
+    return request;
+}
+export function parseVideoGenerateRequest(body) {
+    const source = fields(body, 'request');
+    const request = {
+        prompt: string(source['prompt'], 'prompt'),
+        width: u32(source['width'], 'width'),
+        height: u32(source['height'], 'height'),
+        steps: u32(source['steps'], 'steps'),
+        cfgScale: number(source['cfgScale'], 'cfgScale'),
+    };
+    copyOptional(request, 'negativePrompt', source, 'negativePrompt', string);
+    copyOptional(request, 'frames', source, 'frames', u32);
+    copyOptional(request, 'fps', source, 'fps', u32);
+    copyOptional(request, 'guidance', source, 'guidance', number);
+    copyOptional(request, 'seed', source, 'seed', signedWholeNumber);
+    copyOptional(request, 'samplingMethod', source, 'samplingMethod', string);
+    copyOptional(request, 'flowShift', source, 'flowShift', number);
+    copyOptional(request, 'workflow', source, 'workflow', (value, field) => oneOf(value, VIDEO_WORKFLOWS, field));
+    copyOptional(request, 'initImage', source, 'initImage', parseSource);
+    copyOptional(request, 'endImage', source, 'endImage', parseSource);
+    return request;
+}
+/** `{png}`: the poster the app rendered, as base64 (a data-URL prefix accepted); the bare payload. */
+export function parseVideoPoster(body) {
+    const payload = stripDataUrl(string(fields(body, 'body')['png'], 'png'));
+    if (payload === '' || !isCanonicalBase64(payload))
+        invalid('png', 'a base64 PNG');
+    return payload;
+}
+export function parseDiffusionConfig(body) {
+    const source = fields(body, 'config');
+    const config = { dataFolder: string(source['dataFolder'], 'dataFolder') };
+    copyOptional(config, 'outputDir', source, 'outputDir', string);
+    copyOptional(config, 'videoOutputDir', source, 'videoOutputDir', string);
+    copyOptional(config, 'idleUnloadSecs', source, 'idleUnloadSecs', u64);
+    return config;
+}
+export function parseFinalizeArgs(body) {
+    const source = fields(body, 'args');
+    const args = {
+        dir: string(source['dir'], 'dir'),
+        tag: string(source['tag'], 'tag'),
+        backendId: string(source['backendId'], 'backendId'),
+        backend: oneOf(source['backend'], BACKENDS, 'backend'),
+        engine: oneOf(source['engine'], ENGINES, 'engine'),
+    };
+    copyOptional(args, 'sha256', source, 'sha256', string);
+    return args;
+}
+export function parseGalleryListOptions(body) {
+    const source = fields(body, 'options');
+    const options = {
+        offset: u64(source['offset'], 'offset'),
+        limit: u64(source['limit'], 'limit'),
+    };
+    copyOptional(options, 'includeArchived', source, 'includeArchived', boolean);
+    return options;
+}
+export function parseGalleryFlags(body) {
+    const source = fields(body, 'flags');
+    const flags = {};
+    copyOptional(flags, 'pinned', source, 'pinned', boolean);
+    copyOptional(flags, 'archived', source, 'archived', boolean);
+    return flags;
+}
+/** One required string out of a body, for the routes that take nothing else (`path`, `dir`, `id`). */
+export function requireString(body, key) {
+    return string(fields(body, 'body')[key], key);
+}
+export function requireStringList(body, key) {
+    const value = fields(body, 'body')[key];
+    if (!Array.isArray(value))
+        invalid(key, 'a list of strings');
+    return value.map((item, index) => string(item, `${key}[${index}]`));
+}
+//# sourceMappingURL=parse.js.map

package/dist/diffusion/parse.js.map

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

package/dist/diffusion/png.d.ts

@@ -0,0 +1,77 @@
+/**
+ * The little of PNG the gallery needs, on `node:zlib` alone: chunk splicing that never touches the
+ * image data, a header reader that stops at the first `IDAT`, and a decoder, box downscale and
+ * encoder for thumbnails of what stable-diffusion.cpp writes: 8-bit RGB or RGBA, non-interlaced
+ * (ADR 2026-09-17-a-minimal-png-codec-on-node-zlib-for-recipes-and-thumbnails).
+ */
+export declare const PNG_SIGNATURE: Buffer<ArrayBuffer>;
+export declare function isPng(bytes: Buffer): boolean;
+export interface PngChunk {
+    type: string;
+    data: Buffer;
+    /** Offset just past the chunk (length + type + data + CRC). */
+    end: number;
+}
+/** The chunk starting at `offset`, or `undefined` when it is not complete in `png`. */
+export declare function readChunk(png: Buffer, offset: number): PngChunk | undefined;
+/** CRC-32 (ISO 3309, as PNG uses it) over the parts in order. */
+export declare function crc32(...parts: Buffer[]): number;
+export declare function makeChunk(type: string, data: Buffer): Buffer;
+/** A `tEXt` chunk. The text goes in as UTF-8, which is what the app has always written and read. */
+export declare function textChunk(keyword: string, text: string): Buffer;
+/**
+ * `png` with `chunks` inserted right after `IHDR`, everything else byte for byte. `not-png` and
+ * `no-ihdr` tell the caller which of the two things was wrong.
+ */
+export declare function insertAfterHeader(png: Buffer, chunks: Buffer[]): Buffer | 'not-png' | 'no-ihdr';
+export interface PngHeader {
+    width: number;
+    height: number;
+    /** `tEXt` chunks before the first `IDAT`, keyword → text (UTF-8, lossy); the first of a keyword wins. */
+    texts: Map<string, string>;
+}
+/** How much of a file a header may occupy: recipes are a few hundred bytes. */
+export declare const HEADER_READ_LIMIT: number;
+/** `IHDR` and the text chunks of what has been read so far; `done` once `IDAT` or `IEND` was reached. */
+export declare function parseHeader(bytes: Buffer): {
+    header: PngHeader | undefined;
+    done: boolean;
+} | 'not-png';
+/**
+ * Read `IHDR` and the text chunks before the first `IDAT`, and no further: listing a gallery must
+ * not read every image. `undefined` for anything that is not a readable PNG.
+ */
+export declare function readPngHeader(path: string): Promise<PngHeader | undefined>;
+/** Decoded pixels, rows top to bottom, `channels` bytes per pixel, no padding. */
+export interface RasterImage {
+    width: number;
+    height: number;
+    channels: 3 | 4;
+    data: Buffer;
+}
+/** A well-formed PNG this decoder does not read (16-bit, grey, palette, interlaced). */
+export declare class UnsupportedPngError extends Error {
+}
+/** Refuse a header that claims more than this before allocating for it (2048² is the largest output). */
+export declare const MAX_PIXELS: number;
+/**
+ * Decode an 8-bit RGB or RGBA, non-interlaced PNG. Anything else throws: the caller goes without a
+ * thumbnail rather than guessing.
+ */
+export declare function decodePng(png: Buffer): Promise<RasterImage>;
+/**
+ * Whether every colour channel sits within 2 of every other and all of them at one extreme: a pure
+ * black or pure white frame. Alpha is not looked at. Deliberately flat coloured artwork is not blank.
+ */
+export declare function isBlankRaster(image: RasterImage): boolean;
+/** The size `width`×`height` takes when its longest side is brought down to `maxEdge`; never larger than it was. */
+export declare function fitWithin(width: number, height: number, maxEdge: number): {
+    width: number;
+    height: number;
+};
+/** Box downscale: every destination pixel is the mean of the source pixels it covers. */
+export declare function downscale(image: RasterImage, maxEdge: number): Promise<RasterImage>;
+/** Encode with the usual heuristic: per row, the filter whose output has the smallest sum of absolute values. */
+export declare function encodePng(image: RasterImage): Promise<Buffer>;
+/** A PNG no larger than `maxEdge` on its longest side. Throws for a PNG flavour the decoder does not read. */
+export declare function thumbnailPng(png: Buffer, maxEdge: number): Promise<Buffer>;