@elaraai/e3-api-server 1.0.84 → 1.0.86

package/dist/src/routes/query.js

@@ -0,0 +1,86 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { parseKeypath } from '@elaraai/e3-types';
+/** A whole number as a query spells it: decimal digits, nothing else. */
+const DIGITS = /^\d+$/;
+/** What a parameter taking each least must be, as the dataset routes word it. */
+const TAKES = {
+    0: 'a non-negative integer',
+    1: 'a positive integer',
+};
+/**
+ * The `400 bad_request` that refuses a malformed query, as the dataset routes
+ * answer one: JSON naming what was wrong, which the client reads as an
+ * `ApiError` of that type.
+ *
+ * @param message - What was wrong, naming the parameter and what it was given
+ * @returns The response
+ */
+export function badQuery(message) {
+    return new Response(JSON.stringify({ error: { type: 'bad_request', message } }), {
+        status: 400,
+        headers: { 'Content-Type': 'application/json' },
+    });
+}
+/**
+ * Reads whole-number query parameters, each at or above the least it takes.
+ *
+ * @remarks
+ * A parameter absent, or given empty, is left out. One given that is not a
+ * whole number at or above its least — `abc`, `-1`, `1.5`, `NaN` — or that is
+ * past the integers a number holds exactly, is refused before any store is
+ * asked: `400 bad_request`, naming it and what it was given.
+ *
+ * @param c - The request's context
+ * @param least - Each parameter by name, and the least value it takes
+ * @returns The parameters given, by name; or the 400 that refuses one
+ */
+export function wholeQuery(c, least) {
+    const read = {};
+    for (const name of Object.keys(least)) {
+        const given = c.req.query(name);
+        if (given === undefined || given === '')
+            continue;
+        const value = DIGITS.test(given) ? Number(given) : NaN;
+        if (!(value >= least[name])) {
+            return badQuery(`${name} must be ${TAKES[least[name]]}, got ${JSON.stringify(given)}`);
+        }
+        if (!Number.isSafeInteger(value)) {
+            return badQuery(`${name} must be at most ${Number.MAX_SAFE_INTEGER}, got ${JSON.stringify(given)}`);
+        }
+        read[name] = value;
+    }
+    return read;
+}
+/**
+ * Reads the dataset paths a query names: each `path` parameter one keypath, as
+ * a status names a dataset (`.inputs.x`, `` .inputs.`my field` ``).
+ *
+ * @remarks
+ * Absent, or given only empty, there are none. One that is not a keypath —
+ * `inputs.x`, `.inputs.` — is refused before any store is asked:
+ * `400 bad_request`, naming it. Whether a path names anything is the route's
+ * to judge.
+ *
+ * @param c - The request's context
+ * @returns The paths given, or `undefined` when none is; or the 400 that
+ *   refuses one
+ */
+export function pathsQuery(c) {
+    const given = (c.req.queries('path') ?? []).filter((path) => path !== '');
+    if (given.length === 0)
+        return undefined;
+    const paths = [];
+    for (const path of given) {
+        try {
+            paths.push(parseKeypath(path));
+        }
+        catch (err) {
+            return badQuery(`path must be a dataset's path, as a status names it (.inputs.x), got ${JSON.stringify(path)}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    return paths;
+}
+//# sourceMappingURL=query.js.map

package/dist/src/routes/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/routes/query.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,EAAE,YAAY,EAAiB,MAAM,mBAAmB,CAAC;AAEhE,yEAAyE;AACzE,MAAM,MAAM,GAAG,OAAO,CAAC;AAOvB,iFAAiF;AACjF,MAAM,KAAK,GAA+B;IACxC,CAAC,EAAE,wBAAwB;IAC3B,CAAC,EAAE,oBAAoB;CACxB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE;QAC/E,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;KAChD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,UAAU,CAAmB,CAAU,EAAE,KAAsC;IAC7F,MAAM,IAAI,GAA+B,EAAE,CAAC;IAC5C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAQ,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;YAAE,SAAS;QAClD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACvD,IAAI,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC5B,OAAO,QAAQ,CAAC,GAAG,IAAI,YAAY,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,QAAQ,CAAC,GAAG,IAAI,oBAAoB,MAAM,CAAC,gBAAgB,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtG,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACrB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,UAAU,CAAC,CAAU;IACnC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;IAC1E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC,wEAAwE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvK,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/routes/query.spec.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+export {};
+//# sourceMappingURL=query.spec.d.ts.map

package/dist/src/routes/query.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.spec.d.ts","sourceRoot":"","sources":["../../../src/routes/query.spec.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/routes/query.spec.js

@@ -0,0 +1,49 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * What a route reads from a query, as a host's own route reads it through the
+ * helpers both entries export: a window's offset and limit, refused as the
+ * dataset routes refuse them.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { Hono } from 'hono';
+import * as root from '../index.js';
+import * as portable from '../portable.js';
+import { badQuery, pathsQuery, wholeQuery } from './query.js';
+/** A host's own route over a window, reading its offset and limit as upstream's do. */
+function windowRoute() {
+    const app = new Hono();
+    app.get('/window', (c) => {
+        const read = wholeQuery(c, { offset: 0, limit: 1 });
+        return read instanceof Response ? read : c.json(read);
+    });
+    return app;
+}
+describe('the query a route reads', () => {
+    it('reads a window\'s offset and limit, and refuses one that is no whole number at or above its least', async () => {
+        const app = windowRoute();
+        assert.deepEqual(await (await app.request('/window?offset=0&limit=5')).json(), { offset: 0, limit: 5 });
+        assert.deepEqual(await (await app.request('/window?limit=')).json(), {}, 'a parameter given empty is left out');
+        for (const [query, message] of [
+            ['limit=0', 'limit must be a positive integer, got "0"'],
+            ['offset=-1', 'offset must be a non-negative integer, got "-1"'],
+            ['offset=1.5', 'offset must be a non-negative integer, got "1.5"'],
+            ['limit=9007199254740993', 'limit must be at most 9007199254740991, got "9007199254740993"'],
+        ]) {
+            const refused = await app.request(`/window?${query}`);
+            assert.equal(refused.status, 400, query);
+            assert.deepEqual(await refused.json(), { error: { type: 'bad_request', message } }, query);
+        }
+    });
+    it('is read through the helpers both entries export', () => {
+        for (const entry of [root, portable]) {
+            assert.equal(entry.wholeQuery, wholeQuery);
+            assert.equal(entry.badQuery, badQuery);
+            assert.equal(entry.pathsQuery, pathsQuery);
+        }
+    });
+});
+//# sourceMappingURL=query.spec.js.map

package/dist/src/routes/query.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.spec.js","sourceRoot":"","sources":["../../../src/routes/query.spec.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE9D,uFAAuF;AACvF,SAAS,WAAW;IAClB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACpD,OAAO,IAAI,YAAY,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC;AAED,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,mGAAmG,EAAE,KAAK,IAAI,EAAE;QACjH,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;QAC1B,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACxG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,qCAAqC,CAAC,CAAC;QAChH,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI;YAC7B,CAAC,SAAS,EAAE,2CAA2C,CAAC;YACxD,CAAC,WAAW,EAAE,iDAAiD,CAAC;YAChE,CAAC,YAAY,EAAE,kDAAkD,CAAC;YAClE,CAAC,wBAAwB,EAAE,gEAAgE,CAAC;SACpF,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC;YACtD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YACzC,MAAM,CAAC,SAAS,CAAC,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,KAAK,MAAM,KAAK,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;YACrC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YAC3C,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACvC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/routes/records.d.ts

@@ -12,12 +12,41 @@
  * When auth is configured the committed `actor` is derived from the verified
  * identity (the client-supplied actor is ignored), so the audit trail cannot
  * be forged. Compaction is gated to an elevated role.
+ *
+ * A host whose requests have a time limit gives the routes its deadline, which
+ * a mutation and a compaction answer under, and the page a history request
+ * that names no limit is answered with.
  */
 import { Hono } from 'hono';
-import type { StorageBackend } from '@elaraai/e3-core';
-import type { Identity } from '../middleware/auth.js';
+import type { StorageBackend } from '@elaraai/e3-core/portable';
+import type { Identity } from '../identity.js';
 import type { GetRunner } from './functions.js';
-export declare function createWorkspaceRecordRoutes(storage: StorageBackend, getRepoPath: (repo: string) => string, getRunner: GetRunner): Hono<{
+/** Options for {@link createWorkspaceRecordRoutes}: the limits a host's
+ *  requests have, which the local server, with none, leaves unset. */
+export interface RecordRoutesOptions {
+    /** A mutation's and a compaction's deadline, under the host's request
+     *  timeout: each answers its typed outcome, `timed_out` or `conflict`, 2 s
+     *  under it rather than outlasting it. Unset, neither has one but its own
+     *  limits. */
+    syncDeadlineMs?: number;
+    /** How many commits a history request that names no `limit` is answered
+     *  with, the newest first; the client pages on from the last one's parent.
+     *  Unset, the whole chain. */
+    historyLimit?: number;
+}
+/**
+ * Record routes, mounted at `/api/repos/:repo/workspaces/:ws/records`.
+ *
+ * @param storage - Storage backend
+ * @param getRepoPath - A repository's identifier from its name
+ * @param getRunner - Each repository's task runner, which a mutation's
+ *   program runs on
+ * @param options - The host's sync deadline, and its history page
+ * @returns The routes
+ * @throws {RangeError} When `syncDeadlineMs` is not a positive number of
+ *   milliseconds, or `historyLimit` not a positive whole number of commits.
+ */
+export declare function createWorkspaceRecordRoutes(storage: StorageBackend, getRepoPath: (repo: string) => string, getRunner: GetRunner, options?: RecordRoutesOptions): Hono<{
     Variables: {
         identity?: Identity;
     };

package/dist/src/routes/records.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../../src/routes/records.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAYhD,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACrC,SAAS,EAAE,SAAS;eAEc;QAAE,QAAQ,CAAC,EAAE,QAAQ,CAAA;KAAE;0CAwD1D"}
+{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../../src/routes/records.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGhE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAahD;sEACsE;AACtE,MAAM,WAAW,mBAAmB;IAClC;;;kBAGc;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;kCAE8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACrC,SAAS,EAAE,SAAS,EACpB,OAAO,GAAE,mBAAwB;eAUC;QAAE,QAAQ,CAAC,EAAE,QAAQ,CAAA;KAAE;0CAyD1D"}

package/dist/src/routes/records.js

@@ -12,6 +12,10 @@
  * When auth is configured the committed `actor` is derived from the verified
  * identity (the client-supplied actor is ignored), so the audit trail cannot
  * be forged. Compaction is gated to an elevated role.
+ *
+ * A host whose requests have a time limit gives the routes its deadline, which
+ * a mutation and a compaction answer under, and the page a history request
+ * that names no limit is answered with.
  */
 import { Hono } from 'hono';
 import { variant } from '@elaraai/east';
@@ -19,6 +23,7 @@ import { decodeBody, sendError } from '../beast2.js';
 import { errorToVariant } from '../errors.js';
 import { MutationCallRequestType, MutationResultType, RecordSignatureType } from '../types.js';
 import { callMutationSync, getRecordHistory, describeRecord, compactRecord } from '../handlers/records.js';
+import { wholeQuery } from './query.js';
 /** Roles allowed to compact a record's history (drops the prior chain). */
 const COMPACT_ROLES = ['admin', 'owner'];
 /** The audited actor + whether it is authoritative (auth-verified, so the
@@ -28,7 +33,27 @@ function resolveActor(identity) {
         return { actor: `auth:${identity.email ?? identity.sub}`, authoritative: true };
     return { actor: 'api', authoritative: false };
 }
-export function createWorkspaceRecordRoutes(storage, getRepoPath, getRunner) {
+/**
+ * Record routes, mounted at `/api/repos/:repo/workspaces/:ws/records`.
+ *
+ * @param storage - Storage backend
+ * @param getRepoPath - A repository's identifier from its name
+ * @param getRunner - Each repository's task runner, which a mutation's
+ *   program runs on
+ * @param options - The host's sync deadline, and its history page
+ * @returns The routes
+ * @throws {RangeError} When `syncDeadlineMs` is not a positive number of
+ *   milliseconds, or `historyLimit` not a positive whole number of commits.
+ */
+export function createWorkspaceRecordRoutes(storage, getRepoPath, getRunner, options = {}) {
+    // A limit no request could meet would refuse every one of them, or answer
+    // each with nothing, so a host is told when it mounts the routes.
+    if (options.syncDeadlineMs !== undefined && !(options.syncDeadlineMs > 0)) {
+        throw new RangeError(`syncDeadlineMs must be a positive number of milliseconds, got ${options.syncDeadlineMs}`);
+    }
+    if (options.historyLimit !== undefined && !(Number.isSafeInteger(options.historyLimit) && options.historyLimit >= 1)) {
+        throw new RangeError(`historyLimit must be a positive whole number of commits, got ${options.historyLimit}`);
+    }
     const app = new Hono();
     // GET /:rec — describe the record's mutations (for encoding arguments)
     app.get('/:rec', async (c) => {
@@ -43,11 +68,13 @@ export function createWorkspaceRecordRoutes(storage, getRepoPath, getRunner) {
     // GET /:rec/history?from=<hash>&limit=N — commit chain, newest first
     app.get('/:rec/history', async (c) => {
         const repoPath = getRepoPath(c.req.param('repo'));
-        const limitRaw = c.req.query('limit');
-        const parsed = limitRaw !== undefined ? Number(limitRaw) : NaN;
-        const limit = Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
+        // A limit of 0, or a malformed one, is refused rather than read as none:
+        // an absent limit asks for the host's page, or the whole chain.
+        const window = wholeQuery(c, { limit: 1 });
+        if (window instanceof Response)
+            return window;
         const from = c.req.query('from') || undefined;
-        return getRecordHistory(storage, repoPath, c.req.param('ws'), c.req.param('rec'), limit, from);
+        return getRecordHistory(storage, repoPath, c.req.param('ws'), c.req.param('rec'), window.limit ?? options.historyLimit, from);
     });
     // POST /:rec/mutations/:mut — apply a mutation synchronously (200 MutationResult)
     app.post('/:rec/mutations/:mut', async (c) => {
@@ -58,7 +85,7 @@ export function createWorkspaceRecordRoutes(storage, getRepoPath, getRunner) {
             // Idempotency key travels out-of-band as a header (not the Beast2 body), so
             // adding it changes no wire type; the request signal aborts on disconnect.
             const idempotencyKey = c.req.header('Idempotency-Key') || undefined;
-            return await callMutationSync(storage, repoPath, getRunner(repoPath), c.req.param('ws'), c.req.param('rec'), c.req.param('mut'), req, actor, authoritative, { signal: c.req.raw.signal, idempotencyKey, verbose: c.req.query('verbose') === '1' });
+            return await callMutationSync(storage, repoPath, getRunner(repoPath), c.req.param('ws'), c.req.param('rec'), c.req.param('mut'), req, actor, authoritative, { signal: c.req.raw.signal, idempotencyKey, verbose: c.req.query('verbose') === '1', budgetMs: options.syncDeadlineMs });
         }
         catch (err) {
             return sendError(MutationResultType, errorToVariant(err));
@@ -72,7 +99,7 @@ export function createWorkspaceRecordRoutes(storage, getRepoPath, getRunner) {
             return sendError(MutationResultType, variant('permission_denied', { path: 'compact' }));
         }
         try {
-            return await compactRecord(storage, repoPath, c.req.param('ws'), c.req.param('rec'), resolveActor(identity).actor);
+            return await compactRecord(storage, repoPath, c.req.param('ws'), c.req.param('rec'), resolveActor(identity).actor, options.syncDeadlineMs);
         }
         catch (err) {
             return sendError(MutationResultType, errorToVariant(err));

package/dist/src/routes/records.js.map

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

package/dist/src/routes/repositories.d.ts

@@ -3,7 +3,7 @@
  * Licensed under BSL 1.1. See LICENSE for details.
  */
 import { Hono } from 'hono';
-import type { StorageBackend } from '@elaraai/e3-core';
+import type { StorageBackend } from '@elaraai/e3-core/portable';
 /**
  * The routes of the repositories a host keeps, mounted at `/api/repos`: list
  * them, create one and remove one. They go through the storage backend's

package/dist/src/routes/repositories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repositories.d.ts","sourceRoot":"","sources":["../../../src/routes/repositories.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,cAAc,8EAa/D;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,+EAyB3C"}
+{"version":3,"file":"repositories.d.ts","sourceRoot":"","sources":["../../../src/routes/repositories.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,cAAc,8EAa/D;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,+EAyB3C"}

package/dist/src/routes/repository.d.ts

@@ -3,11 +3,16 @@
  * Licensed under BSL 1.1. See LICENSE for details.
  */
 import { Hono } from 'hono';
-import type { StorageBackend, TransferBackend } from '@elaraai/e3-core';
+import type { StorageBackend, TransferBackend } from '@elaraai/e3-core/portable';
 /**
  * Repository routes, mounted at `/api/repos/:repo`: its status, its record,
  * and gc.
  *
+ * @remarks
+ * The record is read, never upgraded: mounted without the repository gate, the
+ * route answers a repository that owes upgrades as the gate does, 503
+ * `repository_upgrade_pending` with a `Retry-After` ({@link getRecord}).
+ *
  * @param storage - Storage backend
  * @param getRepoPath - The repository identifier for a repo name
  * @param transferBackend - Files and dispatches the job gc runs as, and holds

package/dist/src/routes/repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../src/routes/repository.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAKxE;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACrC,eAAe,EAAE,eAAe,8EAiCjC"}
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../src/routes/repository.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAKjF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACrC,eAAe,EAAE,eAAe,8EAiCjC"}

package/dist/src/routes/repository.js

@@ -10,6 +10,11 @@ import { GcRequestType } from '../types.js';
  * Repository routes, mounted at `/api/repos/:repo`: its status, its record,
  * and gc.
  *
+ * @remarks
+ * The record is read, never upgraded: mounted without the repository gate, the
+ * route answers a repository that owes upgrades as the gate does, 503
+ * `repository_upgrade_pending` with a `Retry-After` ({@link getRecord}).
+ *
  * @param storage - Storage backend
  * @param getRepoPath - The repository identifier for a repo name
  * @param transferBackend - Files and dispatches the job gc runs as, and holds

package/dist/src/routes/repository.js.map

@@ -1 +1 @@
-{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../../src/routes/repository.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAuB,EACvB,WAAqC,EACrC,eAAgC;IAEhC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,sDAAsD;IACtD,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,kFAAkF;IAClF,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,4CAA4C;IAC5C,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC;QAClC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QACnD,OAAO,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,uDAAuD;IACvD,GAAG,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC,EAAE,EAAE;QAChC,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC;QAClC,MAAM,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAE,CAAC;QAChD,OAAO,WAAW,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../../src/routes/repository.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAuB,EACvB,WAAqC,EACrC,eAAgC;IAEhC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,sDAAsD;IACtD,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,kFAAkF;IAClF,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,4CAA4C;IAC5C,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC;QAClC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QACnD,OAAO,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,uDAAuD;IACvD,GAAG,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC,EAAE,EAAE;QAChC,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC;QAClC,MAAM,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAE,CAAC;QAChD,OAAO,WAAW,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/src/routes/repository.spec.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+export {};
+//# sourceMappingURL=repository.spec.d.ts.map

package/dist/src/routes/repository.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.spec.d.ts","sourceRoot":"","sources":["../../../src/routes/repository.spec.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/routes/repository.spec.js

@@ -0,0 +1,84 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * The repository routes' record: a read, which applies no upgrade the
+ * repository owes and waits on no work running in it, whether the repository
+ * gate is mounted ahead of it or not. Without the gate, a repository that owes
+ * upgrades is refused as the gate refuses it.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { Hono } from 'hono';
+import { decodeBeast2For, variant } from '@elaraai/east';
+import { InMemoryTransferBackend, TASKS_LOCK, repositoryUpgradeStep } from '@elaraai/e3-core';
+import { InMemoryStorage } from '@elaraai/e3-core/test';
+import { RepositoryRecordType } from '@elaraai/e3-types';
+import { getRecord } from '../handlers/repository.js';
+import { createRepositoryGate } from '../middleware/repository.js';
+import { ResponseType } from '../types.js';
+import { createRepositoryRoutes } from './repository.js';
+const decodeRecord = decodeBeast2For(ResponseType(RepositoryRecordType));
+/** A repository written before its host's backend shipped a layout step,
+ *  which it now owes, and the names of the steps applied. */
+async function owing() {
+    const storage = new InMemoryStorage();
+    await storage.repos.create('owing');
+    const applied = [];
+    storage.upgrades.push({ name: 'host-layout-2', apply: async () => { applied.push('host-layout-2'); return null; } });
+    return { storage, applied };
+}
+/** The refusal the gate answers too, with when to ask again. */
+async function assertRefused(response, what) {
+    assert.equal(response.status, 503, what);
+    assert.equal(response.headers.get('Retry-After'), '5', what);
+    assert.deepEqual(await response.json(), {
+        error: {
+            type: 'repository_upgrade_pending',
+            message: 'the repository owing owes the upgrade "host-layout-2", which a job applies before the repository is read — retry once it has',
+        },
+    }, what);
+}
+describe('the repository record route', () => {
+    it('reads a repository that owes an upgrade without applying it, refused at once as the gate refuses it, while a task runs or not', async () => {
+        const { storage, applied } = await owing();
+        const app = new Hono();
+        app.route('/api/repos/:repo', createRepositoryRoutes(storage, (repo) => repo, new InMemoryTransferBackend({ storage, getRepoPath: (repo) => repo })));
+        await assertRefused(await app.request('/api/repos/owing/record'), 'the route, with no gate ahead of it');
+        await assertRefused(await getRecord(storage, 'owing'), 'the handler, as a host calls it');
+        // A task running in the repository holds no read: the refusal is at once.
+        const task = await storage.locks.acquire('owing', TASKS_LOCK, variant('dataflow', null), { mode: 'shared' });
+        assert.ok(task !== null);
+        try {
+            const started = Date.now();
+            await assertRefused(await app.request('/api/repos/owing/record'), 'the route, while a task runs');
+            assert.ok(Date.now() - started < 5_000, 'the read waited on the running task');
+        }
+        finally {
+            await task.release();
+        }
+        assert.deepEqual(applied, [], 'no read applies the step');
+        // Once the host's job has applied it, the record is read.
+        assert.deepEqual(await repositoryUpgradeStep(storage, 'owing', { budgetMs: 10_000 }), { owed: [] });
+        const read = decodeRecord(new Uint8Array(await (await app.request('/api/repos/owing/record')).arrayBuffer()));
+        assert.equal(read.type, 'success');
+        if (read.type !== 'success')
+            return;
+        assert.ok(read.value.upgrades.some(({ name }) => name === 'host-layout-2'), 'the record names the step the job applied');
+        assert.deepEqual(applied, ['host-layout-2']);
+    });
+    it('answers the record behind the gate as it always has: the gate applies the step, and the route reads it', async () => {
+        const { storage, applied } = await owing();
+        const app = new Hono();
+        app.use('/api/repos/:repo/*', createRepositoryGate(storage, (repo) => repo));
+        app.route('/api/repos/:repo', createRepositoryRoutes(storage, (repo) => repo, new InMemoryTransferBackend({ storage, getRepoPath: (repo) => repo })));
+        const read = decodeRecord(new Uint8Array(await (await app.request('/api/repos/owing/record')).arrayBuffer()));
+        assert.equal(read.type, 'success');
+        if (read.type !== 'success')
+            return;
+        assert.ok(read.value.upgrades.some(({ name }) => name === 'host-layout-2'), 'the record names the step the gate applied');
+        assert.deepEqual(applied, ['host-layout-2']);
+    });
+});
+//# sourceMappingURL=repository.spec.js.map

package/dist/src/routes/repository.spec.js.map

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

package/dist/src/routes/tasks.d.ts

@@ -3,6 +3,6 @@
  * Licensed under BSL 1.1. See LICENSE for details.
  */
 import { Hono } from 'hono';
-import type { StorageBackend } from '@elaraai/e3-core';
+import type { StorageBackend } from '@elaraai/e3-core/portable';
 export declare function createTaskRoutes(storage: StorageBackend, getRepoPath: (repo: string) => string): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
 //# sourceMappingURL=tasks.d.ts.map

package/dist/src/routes/tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../src/routes/tasks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,8EAiCtC"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../src/routes/tasks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAKhE,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,8EA0CtC"}

package/dist/src/routes/tasks.js

@@ -4,6 +4,8 @@
  */
 import { Hono } from 'hono';
 import { listTasks, getTask, listExecutions } from '../handlers/tasks.js';
+import { TASK_EXECUTIONS_PAGE_DEFAULT, TASK_EXECUTIONS_PAGE_MAX } from '../types.js';
+import { wholeQuery } from './query.js';
 export function createTaskRoutes(storage, getRepoPath) {
     const app = new Hono();
     // GET /api/repos/:repo/workspaces/:ws/tasks - List tasks
@@ -21,15 +23,25 @@ export function createTaskRoutes(storage, getRepoPath) {
         const taskName = c.req.param('task');
         return getTask(storage, repoPath, ws, taskName);
     });
-    // GET /api/repos/:repo/workspaces/:ws/tasks/:task/executions[?all=true] - List execution history
-    // (the latest attempt per inputs hash; `all=true` lists every attempt)
+    // GET /api/repos/:repo/workspaces/:ws/tasks/:task/executions[?limit=<n>&before=<executionId>] - A page
+    // of a task's history: its runs, the latest first, at most `limit` of them —
+    // TASK_EXECUTIONS_PAGE_DEFAULT unless given, and never more than
+    // TASK_EXECUTIONS_PAGE_MAX — those before the run `before` names. A limit
+    // that is not a positive integer is refused before any store is asked, and
+    // an id that is no UUIDv7 by the store.
     app.get('/:task/executions', async (c) => {
         const repo = c.req.param('repo');
         const repoPath = getRepoPath(repo);
         const ws = c.req.param('ws');
         const taskName = c.req.param('task');
-        const all = c.req.query('all') === 'true';
-        return listExecutions(storage, repoPath, ws, taskName, all);
+        const window = wholeQuery(c, { limit: 1 });
+        if (window instanceof Response)
+            return window;
+        const before = c.req.query('before');
+        return listExecutions(storage, repoPath, ws, taskName, {
+            limit: Math.min(window.limit ?? TASK_EXECUTIONS_PAGE_DEFAULT, TASK_EXECUTIONS_PAGE_MAX),
+            ...(before !== undefined && before !== '' && { before }),
+        });
     });
     return app;
 }

package/dist/src/routes/tasks.js.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../../src/routes/tasks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE1E,MAAM,UAAU,gBAAgB,CAC9B,OAAuB,EACvB,WAAqC;IAErC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,yDAAyD;IACzD,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAE,CAAC;QAC9B,OAAO,SAAS,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,qEAAqE;IACrE,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAC5B,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC;QACtC,OAAO,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,iGAAiG;IACjG,uEAAuE;IACvE,GAAG,CAAC,GAAG,CAAC,mBAAmB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACvC,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC;QACtC,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC;QAC1C,OAAO,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../../src/routes/tasks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,UAAU,gBAAgB,CAC9B,OAAuB,EACvB,WAAqC;IAErC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,yDAAyD;IACzD,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAE,CAAC;QAC9B,OAAO,SAAS,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,qEAAqE;IACrE,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAC5B,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC;QACtC,OAAO,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,uGAAuG;IACvG,6EAA6E;IAC7E,iEAAiE;IACjE,0EAA0E;IAC1E,2EAA2E;IAC3E,wCAAwC;IACxC,GAAG,CAAC,GAAG,CAAC,mBAAmB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACvC,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC;QACtC,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3C,IAAI,MAAM,YAAY,QAAQ;YAAE,OAAO,MAAM,CAAC;QAC9C,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACrC,OAAO,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE;YACrD,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,4BAA4B,EAAE,wBAAwB,CAAC;YACvF,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;SACzD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/src/routes/transfer.d.ts

@@ -3,7 +3,7 @@
  * Licensed under BSL 1.1. See LICENSE for details.
  */
 import { Hono } from 'hono';
-import { type StorageBackend, type TransferBackend } from '@elaraai/e3-core';
+import { type StorageBackend, type TransferBackend } from '@elaraai/e3-core/portable';
 /** Options for {@link createTransferRoutes}. */
 export interface TransferRouteOptions {
     /**

package/dist/src/routes/transfer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transfer.d.ts","sourceRoot":"","sources":["../../../src/routes/transfer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAK5B,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAU1B,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA2DD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACrC,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE,oBAAyB;;EAyLnC"}
+{"version":3,"file":"transfer.d.ts","sourceRoot":"","sources":["../../../src/routes/transfer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,2BAA2B,CAAC;AAWnC,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA2DD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACrC,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE,oBAAyB;;EAoKnC"}