@elaraai/e3-rack 0.0.0-bootstrap.0 → 1.0.94

package/dist/src/runner-event.js

@@ -0,0 +1,332 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * The runner event, v2 (#205): what a launcher sends a runner container, and
+ * what the container answers.
+ *
+ * The event is JSON. A value e3-core types as an East value (a detached call's
+ * runner, an intake's declared type) is in East's JSON encoding, whose
+ * integers are strings, and bytes are base64. Each mode names e3-core's own
+ * call the container makes:
+ * - `task`: `taskExecute`, a task over its inputs;
+ * - `unit`: `taskExecuteUnit`, a piece or a merge of a split task, which its
+ *   caller planned;
+ * - `run-detached`: `runDetached`, a function or one-shot call;
+ * - `intake`: `runIntake`, a delivery the store holds, or a run of its
+ *   segments.
+ *
+ * A launcher builds the event with the `…ToWire` functions here and sends it
+ * as JSON; the container reads it back with {@link decodeRunnerEvent} and the
+ * `…FromWire` functions.
+ */
+import { EastTypeType, fromJSONFor, toJSONFor } from '@elaraai/east';
+import { DeliveryRefusedError, isObjectHash, isUuidv7, } from '@elaraai/e3-core';
+import { RunnerType } from '@elaraai/e3-types';
+// =============================================================================
+// To and from the wire
+// =============================================================================
+const runnerToJSON = toJSONFor(RunnerType);
+const runnerFromJSON = fromJSONFor(RunnerType);
+const typeToJSON = toJSONFor(EastTypeType);
+const typeFromJSON = fromJSONFor(EastTypeType);
+/**
+ * A unit as the wire carries it.
+ *
+ * @param unit - The unit
+ * @returns Its wire form
+ */
+export function splitUnitToWire(unit) {
+    return {
+        inputs: [...unit.inputs],
+        merge: unit.merge === null ? null : { parts: [...unit.merge.parts], range: unit.merge.range },
+        own: unit.own,
+    };
+}
+/**
+ * A unit, from the wire.
+ *
+ * @param wire - Its wire form
+ * @returns The unit
+ */
+export function splitUnitFromWire(wire) {
+    return {
+        inputs: [...wire.inputs],
+        merge: wire.merge === null ? null : { parts: [...wire.merge.parts], range: wire.merge.range },
+        own: wire.own,
+    };
+}
+/**
+ * A detached call as the wire carries it.
+ *
+ * @param spec - The call
+ * @returns Its wire form
+ */
+export function detachedSpecToWire(spec) {
+    return {
+        bodyIr: Buffer.from(spec.bodyIr).toString('base64'),
+        args: spec.args.map((arg) => arg instanceof Uint8Array ? Buffer.from(arg).toString('base64') : { dataset: arg.dataset }),
+        runner: runnerToJSON(spec.runner),
+        limits: { timeoutMs: spec.limits.timeoutMs, maxResultBytes: spec.limits.maxResultBytes, maxLogBytes: spec.limits.maxLogBytes },
+        ...(spec.environment !== undefined && { environment: spec.environment }),
+    };
+}
+/**
+ * A detached call, from the wire.
+ *
+ * @param wire - Its wire form
+ * @returns The call
+ * @throws {RunnerEventError} When its runner does not decode as a `RunnerType`
+ */
+export function detachedSpecFromWire(wire) {
+    return {
+        bodyIr: new Uint8Array(Buffer.from(wire.bodyIr, 'base64')),
+        args: wire.args.map((arg) => typeof arg === 'string'
+            ? new Uint8Array(Buffer.from(arg, 'base64'))
+            : { dataset: arg.dataset }),
+        runner: decodeEast(runnerFromJSON, wire.runner, 'spec.runner'),
+        limits: { timeoutMs: wire.limits.timeoutMs, maxResultBytes: wire.limits.maxResultBytes, maxLogBytes: wire.limits.maxLogBytes },
+        ...(wire.environment !== undefined && { environment: wire.environment }),
+    };
+}
+/**
+ * An intake as the wire carries it.
+ *
+ * @param spec - The intake: of a delivery the store holds
+ * @returns Its wire form
+ * @throws {Error} When the delivery is a file, which a runner container
+ *   cannot read
+ */
+export function intakeSpecToWire(spec) {
+    if (!('object' in spec.source)) {
+        throw new Error('a runner container takes in a delivery the store holds: this intake names a file');
+    }
+    return {
+        object: spec.source.object,
+        type: typeToJSON(spec.type),
+        ...(spec.segments !== undefined && { segments: { from: spec.segments.from, to: spec.segments.to } }),
+    };
+}
+/**
+ * An intake, from the wire.
+ *
+ * @param wire - Its wire form
+ * @returns The intake
+ * @throws {RunnerEventError} When its type does not decode as an East type
+ */
+export function intakeSpecFromWire(wire) {
+    return {
+        source: { object: wire.object },
+        type: decodeEast(typeFromJSON, wire.type, 'spec.type'),
+        ...(wire.segments !== undefined && { segments: { from: wire.segments.from, to: wire.segments.to } }),
+    };
+}
+/**
+ * A detached call's outcome as the container answers it.
+ *
+ * @param result - The outcome
+ * @returns Its wire form
+ */
+export function detachedResultToWire(result) {
+    return result.kind === 'success' ? { ...result, value: Buffer.from(result.value).toString('base64') } : result;
+}
+/**
+ * A detached call's outcome, from the container's answer.
+ *
+ * @param response - The answer
+ * @returns The outcome
+ */
+export function detachedResultFromWire(response) {
+    return response.kind === 'success' ? { ...response, value: new Uint8Array(Buffer.from(response.value, 'base64')) } : response;
+}
+/**
+ * What an intake stored, from the container's answer.
+ *
+ * @param response - The answer
+ * @returns What the intake stored
+ * @throws {DeliveryRefusedError} When the runner refused the delivery
+ */
+export function intakeResultFromWire(response) {
+    if (response.kind === 'refused') {
+        throw new DeliveryRefusedError(response.runner, response.refusal, response.stderr, response.delivery);
+    }
+    return {
+        hash: response.hash,
+        runner: response.runner,
+        ...(response.fallback !== undefined && { fallback: response.fallback }),
+        ...(response.peakBytes !== undefined && { peakBytes: response.peakBytes }),
+    };
+}
+// =============================================================================
+// Reading an event
+// =============================================================================
+/** A runner event that does not read: what is wrong with it. */
+export class RunnerEventError extends Error {
+    /**
+     * @param problem - What is wrong with the event
+     */
+    constructor(problem) {
+        super(`runner event: ${problem}`);
+        this.name = 'RunnerEventError';
+    }
+}
+/**
+ * Reads a runner event: the JSON value a container was handed, checked
+ * against the v2 shape.
+ *
+ * @param value - The event, parsed from its JSON
+ * @returns The event
+ * @throws {RunnerEventError} When it is not a v2 runner event: a v1 event
+ *   (which no launcher sends since elaraai/e3-cloud#205), an unknown mode, or
+ *   a field that is missing or of the wrong kind
+ */
+export function decodeRunnerEvent(value) {
+    const event = record(value, 'the event');
+    if (event.mode === undefined && 'taskName' in event) {
+        throw new RunnerEventError('a v1 task event, which this runner no longer runs: launchers send v2 events since elaraai/e3-cloud#205');
+    }
+    const base = {
+        launchId: uuid(event.launchId, 'launchId'),
+        repo: text(event.repo, 'repo'),
+        timeoutMs: positive(event.timeoutMs, 'timeoutMs'),
+    };
+    switch (event.mode) {
+        case 'task':
+            return { mode: 'task', ...base, ...executionFields(event), inputHashes: hashes(event.inputHashes, 'inputHashes') };
+        case 'unit':
+            return { mode: 'unit', ...base, ...executionFields(event), unit: splitUnitWire(event.unit) };
+        case 'run-detached':
+            return {
+                mode: 'run-detached',
+                ...base,
+                spec: detachedSpecWire(event.spec),
+                ...(event.verbose !== undefined && { verbose: flag(event.verbose, 'verbose') }),
+                ...(event.deadline !== undefined && { deadline: count(event.deadline, 'deadline') }),
+            };
+        case 'intake':
+            return { mode: 'intake', ...base, spec: intakeSpecWire(event.spec) };
+        default:
+            throw new RunnerEventError(`mode is ${JSON.stringify(event.mode)}, not task, unit, run-detached or intake`);
+    }
+}
+/** The fields a task and a unit event share, checked. */
+function executionFields(event) {
+    return {
+        taskHash: objectHash(event.taskHash, 'taskHash'),
+        ...(event.run !== undefined && { run: runOf(event.run) }),
+        ...(event.force !== undefined && { force: flag(event.force, 'force') }),
+        ...(event.verbose !== undefined && { verbose: flag(event.verbose, 'verbose') }),
+        ...(event.expectedPeakBytes !== undefined && { expectedPeakBytes: count(event.expectedPeakBytes, 'expectedPeakBytes') }),
+        ...(event.notice !== undefined && { notice: text(event.notice, 'notice') }),
+    };
+}
+function runOf(value) {
+    const run = record(value, 'run');
+    return { workspace: text(run.workspace, 'run.workspace'), id: uuid(run.id, 'run.id') };
+}
+function splitUnitWire(value) {
+    const unit = record(value, 'unit');
+    let merge = null;
+    if (unit.merge !== null) {
+        const parts = record(unit.merge, 'unit.merge');
+        merge = {
+            parts: hashes(parts.parts, 'unit.merge.parts'),
+            range: parts.range === null ? null : objectHash(parts.range, 'unit.merge.range'),
+        };
+    }
+    // A merge unit's inputs name its tag and its parts, so they are text, not hashes
+    return { inputs: texts(unit.inputs, 'unit.inputs'), merge, own: flag(unit.own, 'unit.own') };
+}
+function detachedSpecWire(value) {
+    const spec = record(value, 'spec');
+    const limits = record(spec.limits, 'spec.limits');
+    const wire = {
+        bodyIr: text(spec.bodyIr, 'spec.bodyIr', true),
+        args: list(spec.args, 'spec.args').map((arg, i) => typeof arg === 'string'
+            ? arg
+            : { dataset: objectHash(record(arg, `spec.args[${i}]`).dataset, `spec.args[${i}].dataset`) }),
+        runner: spec.runner,
+        limits: {
+            timeoutMs: positive(limits.timeoutMs, 'spec.limits.timeoutMs'),
+            maxResultBytes: count(limits.maxResultBytes, 'spec.limits.maxResultBytes'),
+            maxLogBytes: count(limits.maxLogBytes, 'spec.limits.maxLogBytes'),
+        },
+        ...(spec.environment !== undefined && { environment: objectHash(spec.environment, 'spec.environment') }),
+    };
+    // The runner is checked now, so that a malformed one is refused before anything runs
+    decodeEast(runnerFromJSON, wire.runner, 'spec.runner');
+    return wire;
+}
+function intakeSpecWire(value) {
+    const spec = record(value, 'spec');
+    let segments;
+    if (spec.segments !== undefined) {
+        const run = record(spec.segments, 'spec.segments');
+        segments = { from: count(run.from, 'spec.segments.from'), to: count(run.to, 'spec.segments.to') };
+    }
+    decodeEast(typeFromJSON, spec.type, 'spec.type');
+    return {
+        object: objectHash(spec.object, 'spec.object'),
+        type: spec.type,
+        ...(segments !== undefined && { segments }),
+    };
+}
+function decodeEast(decode, value, at) {
+    try {
+        return decode(value);
+    }
+    catch (err) {
+        throw new RunnerEventError(`${at} does not decode: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+function record(value, at) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new RunnerEventError(`${at} is not an object`);
+    }
+    return value;
+}
+function list(value, at) {
+    if (!Array.isArray(value))
+        throw new RunnerEventError(`${at} is not an array`);
+    return value;
+}
+function text(value, at, empty = false) {
+    if (typeof value !== 'string' || (!empty && value === ''))
+        throw new RunnerEventError(`${at} is not a string`);
+    return value;
+}
+function texts(value, at) {
+    return list(value, at).map((item, i) => text(item, `${at}[${i}]`));
+}
+function objectHash(value, at) {
+    if (typeof value !== 'string' || !isObjectHash(value))
+        throw new RunnerEventError(`${at} is not an object hash`);
+    return value;
+}
+function hashes(value, at) {
+    return list(value, at).map((item, i) => objectHash(item, `${at}[${i}]`));
+}
+function uuid(value, at) {
+    if (typeof value !== 'string' || !isUuidv7(value))
+        throw new RunnerEventError(`${at} is not a UUIDv7`);
+    return value;
+}
+function flag(value, at) {
+    if (typeof value !== 'boolean')
+        throw new RunnerEventError(`${at} is not a boolean`);
+    return value;
+}
+function count(value, at) {
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 0) {
+        throw new RunnerEventError(`${at} is not a whole number`);
+    }
+    return value;
+}
+function positive(value, at) {
+    if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) {
+        throw new RunnerEventError(`${at} is not a positive number`);
+    }
+    return value;
+}
+//# sourceMappingURL=runner-event.js.map

package/dist/src/runner-event.js.map

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

package/dist/src/server/beast2.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * The BEAST2 envelopes over a Hono context: e3-types' request and answer
+ * helpers, as e3-api-server's `/beast2` entry wraps them. Declared here so
+ * this package needs nothing of the server, whose optional peer it is.
+ */
+import type { EastType, ValueTypeOf } from '@elaraai/east';
+import { type Error as ApiError } from '@elaraai/e3-types';
+import type { Context } from 'hono';
+/** Decodes a route's BEAST2 body as a value of a type. */
+export declare function decodeBody<T extends EastType>(c: Context, type: T): Promise<ValueTypeOf<T>>;
+/** Answers a success envelope. */
+export declare function sendSuccess<T extends EastType>(type: T, value: ValueTypeOf<T>): Response;
+/** Answers an error envelope. */
+export declare function sendError<T extends EastType>(type: T, error: ApiError): Response;
+//# sourceMappingURL=beast2.d.ts.map

package/dist/src/server/beast2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beast2.d.ts","sourceRoot":"","sources":["../../../src/server/beast2.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAmD,KAAK,KAAK,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC5G,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAE3F;AAED,kCAAkC;AAClC,wBAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,QAAQ,CAExF;AAED,iCAAiC;AACjC,wBAAgB,SAAS,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAEhF"}

package/dist/src/server/beast2.js

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { beast2Error, beast2Success, decodeBeast2Request } from '@elaraai/e3-types';
+/** Decodes a route's BEAST2 body as a value of a type. */
+export function decodeBody(c, type) {
+    return decodeBeast2Request(c.req.raw, type);
+}
+/** Answers a success envelope. */
+export function sendSuccess(type, value) {
+    return beast2Success(type, value);
+}
+/** Answers an error envelope. */
+export function sendError(type, error) {
+    return beast2Error(type, error);
+}
+//# sourceMappingURL=beast2.js.map

package/dist/src/server/beast2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"beast2.js","sourceRoot":"","sources":["../../../src/server/beast2.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,mBAAmB,EAA0B,MAAM,mBAAmB,CAAC;AAG5G,0DAA0D;AAC1D,MAAM,UAAU,UAAU,CAAqB,CAAU,EAAE,IAAO;IAChE,OAAO,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,WAAW,CAAqB,IAAO,EAAE,KAAqB;IAC5E,OAAO,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,SAAS,CAAqB,IAAO,EAAE,KAAe;IACpE,OAAO,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAClC,CAAC"}

package/dist/src/server/body-limit.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import type { MiddlewareHandler } from 'hono';
+/**
+ * Bound control messages before BEAST2 decoding, counting streamed bytes
+ * even when Content-Length lies. Object transfers use separate routes.
+ * @param maxBytes - Maximum encoded body size
+ * @param timeoutMs - Maximum time to receive the body
+ * @returns Middleware answering 413 on excess and 408 on timeout
+ * @example
+ * app.use('/api/rack/enroll', rackBodyLimit(64 * 1024));
+ */
+export declare function rackBodyLimit(maxBytes: number, timeoutMs?: number): MiddlewareHandler;
+//# sourceMappingURL=body-limit.d.ts.map

package/dist/src/server/body-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-limit.d.ts","sourceRoot":"","sources":["../../../src/server/body-limit.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAE9C;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,SAAS,GAAG,iBAAiB,CAgCrF"}

package/dist/src/server/body-limit.js

@@ -0,0 +1,53 @@
+/**
+ * Bound control messages before BEAST2 decoding, counting streamed bytes
+ * even when Content-Length lies. Object transfers use separate routes.
+ * @param maxBytes - Maximum encoded body size
+ * @param timeoutMs - Maximum time to receive the body
+ * @returns Middleware answering 413 on excess and 408 on timeout
+ * @example
+ * app.use('/api/rack/enroll', rackBodyLimit(64 * 1024));
+ */
+export function rackBodyLimit(maxBytes, timeoutMs = 15_000) {
+    return async (c, next) => {
+        const body = c.req.raw.body;
+        if (body === null) {
+            await next();
+            return;
+        }
+        const reader = body.getReader();
+        const chunks = [];
+        let bytes = 0;
+        let timer;
+        const timeout = new Promise((_resolve, reject) => {
+            timer = setTimeout(() => reject(new Error('Rack body timeout')), timeoutMs);
+        });
+        try {
+            for (;;) {
+                const chunk = await Promise.race([reader.read(), timeout]);
+                if (chunk.done)
+                    break;
+                bytes += chunk.value.byteLength;
+                if (bytes > maxBytes)
+                    return c.text('Rack request body too large', 413);
+                chunks.push(chunk.value);
+            }
+            const data = new Uint8Array(bytes);
+            let offset = 0;
+            for (const chunk of chunks) {
+                data.set(chunk, offset);
+                offset += chunk.byteLength;
+            }
+            c.req.raw = new Request(c.req.raw, { body: data });
+        }
+        catch (error) {
+            return c.text('Rack request body could not be received', error instanceof Error && error.message === 'Rack body timeout' ? 408 : 400);
+        }
+        finally {
+            clearTimeout(timer);
+            void reader.cancel().catch(() => { });
+            reader.releaseLock();
+        }
+        await next();
+    };
+}
+//# sourceMappingURL=body-limit.js.map

package/dist/src/server/body-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-limit.js","sourceRoot":"","sources":["../../../src/server/body-limit.ts"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,SAAS,GAAG,MAAM;IAChE,OAAO,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;QAC5B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAAC,MAAM,IAAI,EAAE,CAAC;YAAC,OAAO;QAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,MAAM,GAAiB,EAAE,CAAC;QAChC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,KAAgD,CAAC;QACrD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;YACtD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAC9E,CAAC,CAAC,CAAC;QACH,IAAI,CAAC;YACH,SAAS,CAAC;gBACR,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC3D,IAAI,KAAK,CAAC,IAAI;oBAAE,MAAM;gBACtB,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC;gBAChC,IAAI,KAAK,GAAG,QAAQ;oBAAE,OAAO,CAAC,CAAC,IAAI,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;gBACxE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;YACnC,IAAI,MAAM,GAAG,CAAC,CAAC;YACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBAAC,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC;YAAC,CAAC;YACpF,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,CAAC,IAAI,CAAC,yCAAyC,EAAE,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACxI,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAA6C,CAAC,CAAC,CAAC;YAChF,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,CAAC;QACD,MAAM,IAAI,EAAE,CAAC;IACf,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/server/body-limit.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=body-limit.spec.d.ts.map

package/dist/src/server/body-limit.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-limit.spec.d.ts","sourceRoot":"","sources":["../../../src/server/body-limit.spec.ts"],"names":[],"mappings":""}

package/dist/src/server/body-limit.spec.js

@@ -0,0 +1,32 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { it } from 'node:test';
+import assert from 'node:assert/strict';
+import { Hono } from 'hono';
+import { rackBodyLimit } from './body-limit.js';
+it('bounds actual request bytes before decoding, regardless of Content-Length', async () => {
+    const app = new Hono();
+    let decoded = 0;
+    app.use('*', rackBodyLimit(4));
+    app.post('/', async (c) => { decoded++; return c.text(await c.req.text()); });
+    const ok = await app.request('/', { method: 'POST', body: 'four' });
+    assert.equal(await ok.text(), 'four');
+    for (const headers of [new Headers(), new Headers({ 'content-length': '1' })]) {
+        const rejected = await app.request('/', { method: 'POST', body: 'too large', headers });
+        assert.equal(rejected.status, 413);
+    }
+    assert.equal(decoded, 1);
+});
+it('times out stalled bodies and cancels their streams', async () => {
+    const app = new Hono();
+    app.use('*', rackBodyLimit(4, 10));
+    app.post('/', c => c.text('unexpected'));
+    let cancelled = false;
+    const body = new ReadableStream({ cancel() { cancelled = true; } });
+    const request = new Request('http://localhost/', { method: 'POST', body, duplex: 'half' });
+    assert.equal((await app.request(request)).status, 408);
+    assert.ok(cancelled);
+});
+//# sourceMappingURL=body-limit.spec.js.map

package/dist/src/server/body-limit.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-limit.spec.js","sourceRoot":"","sources":["../../../src/server/body-limit.spec.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAC/B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,EAAE,CAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;IACvF,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAC,CAAC,EAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACpE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;IACtC,KAAK,MAAM,OAAO,IAAI,CAAC,IAAI,OAAO,EAAE,EAAE,IAAI,OAAO,CAAC,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;QAC5E,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;QACxF,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACvC,CAAC;IACD,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AAC7B,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;IAChE,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACnC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IACzC,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,MAAM,IAAI,GAAG,IAAI,cAAc,CAAa,EAAE,MAAM,KAAK,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAChF,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,mBAAmB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAiB,CAAC,CAAC;IAC1G,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACvD,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;AACzB,CAAC,CAAC,CAAC"}

package/dist/src/server/bounded.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Maps backend work with bounded concurrency, preserving request order.
+ * Stops scheduling after a failure and joins every started operation before
+ * rejecting, so the caller's lease fence covers all in-flight side effects.
+ * @param items - Backend requests
+ * @param atOnce - Maximum concurrent operations
+ * @param map - Operation for one request
+ * @returns Results in request order
+ * @internal
+ */
+export declare function mapBounded<T, R>(items: readonly T[], atOnce: number, map: (item: T) => Promise<R>): Promise<R[]>;
+//# sourceMappingURL=bounded.d.ts.map

package/dist/src/server/bounded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded.d.ts","sourceRoot":"","sources":["../../../src/server/bounded.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAkBtH"}

package/dist/src/server/bounded.js

@@ -0,0 +1,39 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Maps backend work with bounded concurrency, preserving request order.
+ * Stops scheduling after a failure and joins every started operation before
+ * rejecting, so the caller's lease fence covers all in-flight side effects.
+ * @param items - Backend requests
+ * @param atOnce - Maximum concurrent operations
+ * @param map - Operation for one request
+ * @returns Results in request order
+ * @internal
+ */
+export async function mapBounded(items, atOnce, map) {
+    const answers = new Array(items.length);
+    let next = 0;
+    let failed = false;
+    let failure;
+    const worker = async () => {
+        while (next < items.length && !failed) {
+            const index = next++;
+            try {
+                answers[index] = await map(items[index]);
+            }
+            catch (error) {
+                if (!failed) {
+                    failed = true;
+                    failure = error;
+                }
+            }
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(Math.max(1, atOnce), items.length) }, worker));
+    if (failed)
+        throw failure;
+    return answers;
+}
+//# sourceMappingURL=bounded.js.map

package/dist/src/server/bounded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded.js","sourceRoot":"","sources":["../../../src/server/bounded.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAO,KAAmB,EAAE,MAAc,EAAE,GAA4B;IACtG,MAAM,OAAO,GAAG,IAAI,KAAK,CAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,OAAgB,CAAC;IACrB,MAAM,MAAM,GAAG,KAAK,IAAmB,EAAE;QACvC,OAAO,IAAI,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC;YACrB,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,KAAK,CAAE,CAAC,CAAC;YAC5C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,EAAE,CAAC;oBAAC,MAAM,GAAG,IAAI,CAAC;oBAAC,OAAO,GAAG,KAAK,CAAC;gBAAC,CAAC;YAClD,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/F,IAAI,MAAM;QAAE,MAAM,OAAO,CAAC;IAC1B,OAAO,OAAO,CAAC;AACjB,CAAC"}