@elaraai/e3-api-server 1.0.78 → 1.0.80

package/dist/src/routes/objects.js

@@ -3,22 +3,53 @@
  * Licensed under BSL 1.1. See LICENSE for details.
  */
 import { Hono } from 'hono';
-import { BEAST2_CONTENT_TYPE } from '@elaraai/e3-core';
+import { isObjectHash } from '@elaraai/e3-core';
+import { BEAST2_CONTENT_TYPE } from '@elaraai/e3-types';
 import { sendJsonError } from '../errors.js';
-export function createObjectRoutes(storage, getRepoPath) {
+import { DOWNLOAD_REDIRECT_BYTES } from '../handlers/datasets.js';
+/**
+ * Creates the routes that read an object by its hash.
+ *
+ * @remarks
+ * A client downloading a collection by its segments reads each segment here.
+ * With a transfer backend, an object over {@link DOWNLOAD_REDIRECT_BYTES} is
+ * answered as a dataset download is: JSON `{ url }`, which the client fetches
+ * directly, so a host whose responses are capped never carries the bytes.
+ *
+ * @param storage - The storage backend the objects are read from
+ * @param getRepoPath - Maps a repository name to its path in the backend
+ * @param transferBackend - Serves large objects by URL; without it every object is answered inline
+ * @returns The Hono app, mounted at `/api/repos/:repo/objects`
+ */
+export function createObjectRoutes(storage, getRepoPath, transferBackend) {
     const app = new Hono();
     // GET /api/repos/:repo/objects/:hash — Read object by hash
     app.get('/:hash', async (c) => {
         const repo = c.req.param('repo');
         const repoPath = getRepoPath(repo);
         const hash = c.req.param('hash');
-        if (!/^[a-f0-9]{64}$/.test(hash)) {
+        if (!isObjectHash(hash)) {
             return new Response(JSON.stringify({ error: { type: 'bad_request', message: `invalid hash format: ${hash}` } }), {
                 status: 400,
                 headers: { 'Content-Type': 'application/json' },
             });
         }
         try {
+            if (transferBackend) {
+                const { size } = await storage.objects.stat(repoPath, hash);
+                if (size > DOWNLOAD_REDIRECT_BYTES) {
+                    let url = await transferBackend.datasetDownload.getDownloadUrl(repo, hash);
+                    if (url.startsWith('/'))
+                        url = `${new URL(c.req.url).origin}${url}`;
+                    return new Response(JSON.stringify({ url }), {
+                        headers: {
+                            'Content-Type': 'application/json',
+                            'X-Content-Length': String(size),
+                            'X-Content-SHA256': hash,
+                        },
+                    });
+                }
+            }
             const data = await storage.objects.read(repoPath, hash);
             return new Response(data, {
                 headers: {

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

@@ -1 +1 @@
-{"version":3,"file":"objects.js","sourceRoot":"","sources":["../../../src/routes/objects.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAuB,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,UAAU,kBAAkB,CAChC,OAAuB,EACvB,WAAqC;IAErC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,2DAA2D;IAC3D,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,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC;QAElC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,wBAAwB,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE;gBAC/G,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;aAChD,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACxD,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE;gBACxB,OAAO,EAAE;oBACP,cAAc,EAAE,mBAAmB;oBACnC,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;oBACzC,kBAAkB,EAAE,IAAI;iBACzB;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"objects.js","sourceRoot":"","sources":["../../../src/routes/objects.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,YAAY,EAA6C,MAAM,kBAAkB,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAuB,EACvB,WAAqC,EACrC,eAAiC;IAEjC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,2DAA2D;IAC3D,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,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC;QAElC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,wBAAwB,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE;gBAC/G,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;aAChD,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC;YACH,IAAI,eAAe,EAAE,CAAC;gBACpB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;gBAC5D,IAAI,IAAI,GAAG,uBAAuB,EAAE,CAAC;oBACnC,IAAI,GAAG,GAAG,MAAM,eAAe,CAAC,eAAe,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBAC3E,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;wBAAE,GAAG,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;oBACpE,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;wBAC3C,OAAO,EAAE;4BACP,cAAc,EAAE,kBAAkB;4BAClC,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC;4BAChC,kBAAkB,EAAE,IAAI;yBACzB;qBACF,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACxD,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE;gBACxB,OAAO,EAAE;oBACP,cAAc,EAAE,mBAAmB;oBACnC,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;oBACzC,kBAAkB,EAAE,IAAI;iBACzB;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { Hono } from 'hono';
+import type { StorageBackend } from '@elaraai/e3-core';
+/**
+ * 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
+ * `RepoStore`, so a host mounts them over its own — the local server over a
+ * directory of repositories, a cloud over its own stores — with the
+ * repository gate (`createRepositoryGate`) on `/api/repos/:repo/*`.
+ *
+ * @param storage - Storage backend, whose `RepoStore` keeps the repositories
+ * @returns The routes
+ */
+export declare function createRepositoriesRoutes(storage: StorageBackend): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+/**
+ * The routes of a server of one repository, mounted at `/api/repos`: they
+ * list it, as `default`, and create and remove none. A refusal is JSON with
+ * its HTTP status, as the gate's are.
+ *
+ * @returns The routes
+ */
+export declare function createSingleRepositoryRoutes(): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+//# sourceMappingURL=repositories.d.ts.map

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

@@ -0,0 +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"}

package/dist/src/routes/repositories.js

@@ -0,0 +1,58 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { Hono } from 'hono';
+import { ArrayType, StringType } from '@elaraai/east';
+import { createRepository, listRepositories, removeRepository } from '../handlers/repository.js';
+import { sendSuccess } from '../beast2.js';
+/**
+ * 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
+ * `RepoStore`, so a host mounts them over its own — the local server over a
+ * directory of repositories, a cloud over its own stores — with the
+ * repository gate (`createRepositoryGate`) on `/api/repos/:repo/*`.
+ *
+ * @param storage - Storage backend, whose `RepoStore` keeps the repositories
+ * @returns The routes
+ */
+export function createRepositoriesRoutes(storage) {
+    const app = new Hono();
+    // GET /api/repos - The repositories, by name
+    app.get('/', () => listRepositories(storage));
+    // PUT /api/repos/:repo - Create a repository
+    app.put('/:repo', (c) => createRepository(storage, c.req.param('repo')));
+    // DELETE /api/repos/:repo - Remove a repository
+    app.delete('/:repo', (c) => removeRepository(storage, c.req.param('repo')));
+    return app;
+}
+/**
+ * The routes of a server of one repository, mounted at `/api/repos`: they
+ * list it, as `default`, and create and remove none. A refusal is JSON with
+ * its HTTP status, as the gate's are.
+ *
+ * @returns The routes
+ */
+export function createSingleRepositoryRoutes() {
+    const app = new Hono();
+    // GET /api/repos - The one repository
+    app.get('/', () => sendSuccess(ArrayType(StringType), ['default']));
+    // PUT /api/repos/:repo - Refused: the server serves one repository
+    app.put('/:repo', (c) => c.json({
+        error: 'method_not_allowed',
+        message: 'Repository creation is disabled in single-repo mode',
+    }, 405));
+    // DELETE /api/repos/:repo - Refused for the one repository; any other is none
+    app.delete('/:repo', (c) => {
+        const repo = c.req.param('repo');
+        if (repo === 'default') {
+            return c.json({
+                error: 'method_not_allowed',
+                message: 'Repository deletion is disabled in single-repo mode',
+            }, 405);
+        }
+        return c.json({ error: 'not_found', message: `Repository '${repo}' not found` }, 404);
+    });
+    return app;
+}
+//# sourceMappingURL=repositories.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repositories.js","sourceRoot":"","sources":["../../../src/routes/repositories.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACjG,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAuB;IAC9D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,6CAA6C;IAC7C,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IAE9C,6CAA6C;IAC7C,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAEzE,gDAAgD;IAChD,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAE5E,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B;IAC1C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,sCAAsC;IACtC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAEpE,mEAAmE;IACnE,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9B,KAAK,EAAE,oBAAoB;QAC3B,OAAO,EAAE,qDAAqD;KAC/D,EAAE,GAAG,CAAC,CAAC,CAAC;IAET,8EAA8E;IAC9E,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;QACzB,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,oBAAoB;gBAC3B,OAAO,EAAE,qDAAqD;aAC/D,EAAE,GAAG,CAAC,CAAC;QACV,CAAC;QACD,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,IAAI,aAAa,EAAE,EAAE,GAAG,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/src/routes/repositories.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=repositories.spec.d.ts.map

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

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

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

@@ -0,0 +1,77 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * The routes of a host's repositories, and the gate every request to one
+ * passes, mounted over a backend other than the local server's — the
+ * in-memory one, as a cloud mounts them over its own: a repository is listed,
+ * created, opened at each request and removed, and one being removed answers
+ * its status alone. And a server of one repository serves it as `default`,
+ * whichever order the gate and the routes are mounted in.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { Hono } from 'hono';
+import { ArrayType, NullType, StringType, decodeBeast2For, variant } from '@elaraai/east';
+import { InMemoryStorage } from '@elaraai/e3-core/test';
+import { E3_RELEASE } from '@elaraai/e3-types';
+import { createRepositoryGate, createSingleRepositoryGate } from '../middleware/repository.js';
+import { ResponseType } from '../types.js';
+import { createRepositoriesRoutes, createSingleRepositoryRoutes } from './repositories.js';
+const decodeList = decodeBeast2For(ResponseType(ArrayType(StringType)));
+const decodeName = decodeBeast2For(ResponseType(StringType));
+const decodeNull = decodeBeast2For(ResponseType(NullType));
+const bytes = async (response) => new Uint8Array(await (await response).arrayBuffer());
+describe('the repositories routes and gate', () => {
+    it('list, create and remove a host\'s repositories, and open one at every request to it', async () => {
+        const storage = new InMemoryStorage();
+        const app = new Hono();
+        app.use('/api/repos/:repo/*', createRepositoryGate(storage, (repo) => repo));
+        app.route('/api/repos', createRepositoriesRoutes(storage));
+        app.get('/api/repos/:repo/probe', (c) => c.text('passed'));
+        app.get('/api/repos/:repo/status', (c) => c.text('its status'));
+        const notFound = (repo) => ({ error: 'not_found', message: `Repository '${repo}' not found` });
+        const created = await app.request('/api/repos/alpha', { method: 'PUT' });
+        assert.equal(created.status, 201);
+        assert.deepEqual(decodeName(await bytes(created)), variant('success', 'alpha'));
+        assert.deepEqual(decodeList(await bytes(app.request('/api/repos'))), variant('success', ['alpha']));
+        assert.equal((decodeName(await bytes(app.request('/api/repos/alpha', { method: 'PUT' })))).type, 'error', 'one that exists is not created again');
+        assert.equal(await (await app.request('/api/repos/alpha/probe')).text(), 'passed');
+        const missing = await app.request('/api/repos/beta/probe');
+        assert.equal(missing.status, 404);
+        assert.deepEqual(await missing.json(), notFound('beta'));
+        // One this e3 cannot open is refused, naming the release that upgraded it.
+        await app.request('/api/repos/gamma', { method: 'PUT' });
+        const record = await storage.refs.repositoryRead('gamma');
+        assert.ok(record !== null);
+        await storage.refs.repositoryWrite('gamma', { ...record, upgrades: [...record.upgrades, { name: 'from-a-newer-e3', release: '999.0.0' }] });
+        const refused = await app.request('/api/repos/gamma/probe');
+        assert.equal(refused.status, 500);
+        assert.deepEqual(await refused.json(), { error: { type: 'internal', message: `the repository at gamma has had the upgrade "from-a-newer-e3", which e3 999.0.0 applied and this e3, ${E3_RELEASE}, does not know — open it with e3 999.0.0 or a newer one` } });
+        // One being removed answers its status alone, and a removal asked again
+        // answers at once.
+        await storage.repos.setStatus('alpha', 'deleting', 'active');
+        assert.deepEqual(await (await app.request('/api/repos/alpha/probe')).json(), notFound('alpha'));
+        assert.equal(await (await app.request('/api/repos/alpha/status')).text(), 'its status');
+        assert.deepEqual(decodeNull(await bytes(app.request('/api/repos/alpha', { method: 'DELETE' }))), variant('success', null));
+        await storage.repos.setStatus('alpha', 'active', 'deleting');
+        assert.deepEqual(decodeNull(await bytes(app.request('/api/repos/alpha', { method: 'DELETE' }))), variant('success', null));
+        assert.deepEqual(decodeList(await bytes(app.request('/api/repos'))), variant('success', ['gamma']));
+        assert.deepEqual(await (await app.request('/api/repos/alpha/probe')).json(), notFound('alpha'));
+        assert.deepEqual(decodeNull(await bytes(app.request('/api/repos/alpha', { method: 'DELETE' }))), variant('error', variant('repository_not_found', { repo: 'alpha' })));
+    });
+    it('serve one repository as `default`, and create and remove none, the gate mounted ahead of the routes', async () => {
+        const app = new Hono();
+        app.use('/api/repos/:repo/*', createSingleRepositoryGate());
+        app.route('/api/repos', createSingleRepositoryRoutes());
+        app.get('/api/repos/:repo/probe', (c) => c.text('passed'));
+        assert.deepEqual(decodeList(await bytes(app.request('/api/repos'))), variant('success', ['default']));
+        assert.equal(await (await app.request('/api/repos/default/probe')).text(), 'passed');
+        assert.equal((await app.request('/api/repos/other/probe')).status, 404);
+        assert.equal((await app.request('/api/repos/new-repo', { method: 'PUT' })).status, 405);
+        assert.equal((await app.request('/api/repos/default', { method: 'DELETE' })).status, 405);
+        assert.equal((await app.request('/api/repos/other', { method: 'DELETE' })).status, 404);
+    });
+});
+//# sourceMappingURL=repositories.spec.js.map

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

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

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

@@ -3,6 +3,16 @@
  * Licensed under BSL 1.1. See LICENSE for details.
  */
 import { Hono } from 'hono';
-import type { StorageBackend } from '@elaraai/e3-core';
-export declare function createRepositoryRoutes(storage: StorageBackend, getRepoPath: (repo: string) => string): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+import type { StorageBackend, TransferBackend } from '@elaraai/e3-core';
+/**
+ * Repository routes, mounted at `/api/repos/:repo`: its status, its record,
+ * and gc.
+ *
+ * @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
+ *   the status a poll reads
+ * @returns The routes
+ */
+export declare function createRepositoryRoutes(storage: StorageBackend, getRepoPath: (repo: string) => string, transferBackend: TransferBackend): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
 //# sourceMappingURL=repository.d.ts.map

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,MAAM,kBAAkB,CAAC;AAKvD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,8EA2BtC"}
+{"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"}

package/dist/src/routes/repository.js

@@ -3,10 +3,20 @@
  * Licensed under BSL 1.1. See LICENSE for details.
  */
 import { Hono } from 'hono';
-import { getStatus, startGc, getGcStatus } from '../handlers/repository.js';
+import { getStatus, getRecord, startGc, getGcStatus } from '../handlers/repository.js';
 import { decodeBody } from '../beast2.js';
 import { GcRequestType } from '../types.js';
-export function createRepositoryRoutes(storage, getRepoPath) {
+/**
+ * Repository routes, mounted at `/api/repos/:repo`: its status, its record,
+ * and gc.
+ *
+ * @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
+ *   the status a poll reads
+ * @returns The routes
+ */
+export function createRepositoryRoutes(storage, getRepoPath, transferBackend) {
     const app = new Hono();
     // GET /api/repos/:repo/status - Get repository status
     app.get('/status', async (c) => {
@@ -14,18 +24,23 @@ export function createRepositoryRoutes(storage, getRepoPath) {
         const repoPath = getRepoPath(repo);
         return getStatus(storage, repoPath);
     });
-    // POST /api/repos/:repo/gc - Start garbage collection (async)
-    app.post('/gc', async (c) => {
+    // GET /api/repos/:repo/record - The repository's record: its release and upgrades
+    app.get('/record', async (c) => {
         const repo = c.req.param('repo');
         const repoPath = getRepoPath(repo);
-        const options = await decodeBody(c, GcRequestType);
-        const minAge = options.minAge?.type === 'some' ? Number(options.minAge.value) : undefined;
-        return startGc(storage, repoPath, { dryRun: options.dryRun, minAge });
+        return getRecord(storage, repoPath);
     });
-    // GET /api/repos/:repo/gc/:executionId - Get GC status
+    // POST /api/repos/:repo/gc - Start a gc job
+    app.post('/gc', async (c) => {
+        const repo = c.req.param('repo');
+        const request = await decodeBody(c, GcRequestType);
+        return startGc(repo, request, transferBackend.repoGc);
+    });
+    // GET /api/repos/:repo/gc/:executionId - Poll a gc job
     app.get('/gc/:executionId', (c) => {
+        const repo = c.req.param('repo');
         const executionId = c.req.param('executionId');
-        return getGcStatus(executionId);
+        return getGcStatus(transferBackend.repoGc, repo, executionId);
     });
     return app;
 }

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,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,UAAU,sBAAsB,CACpC,OAAuB,EACvB,WAAqC;IAErC,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,8DAA8D;IAC9D,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,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1F,OAAO,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,uDAAuD;IACvD,GAAG,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC,EAAE,EAAE;QAChC,MAAM,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAE,CAAC;QAChD,OAAO,WAAW,CAAC,WAAW,CAAC,CAAC;IAClC,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;;;;;;;;;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"}

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

@@ -7,9 +7,9 @@ import { type StorageBackend, type TransferBackend } from '@elaraai/e3-core';
 /** Options for {@link createTransferRoutes}. */
 export interface TransferRouteOptions {
     /**
-     * How long a protocol-2 commit waits for the staged bytes to be verified
-     * before it answers `processing` for the client to poll (default 5000 ms; 0
-     * answers `processing` at once). A protocol-1 commit always waits.
+     * How long a commit waits for the staged bytes to be verified before it
+     * answers `processing` for the client to poll (default 5000 ms; 0 answers
+     * `processing` at once).
      */
     commitWaitMs?: number;
 }
@@ -23,12 +23,14 @@ export interface TransferRouteOptions {
  * generic data endpoints in `data.ts`.
  *
  * @remarks
- * A protocol-2 client (`?protocol=2` on the init and the commit) is sent its
- * bytes' plan as parts, and its commit runs in the background: the request
- * waits up to `commitWaitMs` for it and otherwise answers `processing`, which
- * the client polls — so verifying a delivery of many gigabytes never holds one
- * request open for as long as its SHA-256 takes. A protocol-1 client gets the
- * single upload URL and a commit that answers only when it is done.
+ * The init and the commit name the protocol version they speak
+ * (`?protocol=N`) and the client's release (`&release=`), and one of another
+ * version, or none, is refused, naming both releases and the fix. A client is
+ * sent its bytes' plan as parts. The upload store commits the upload, where it
+ * runs its commits: the request waits up to `commitWaitMs` for it and
+ * otherwise answers `processing`, which the client polls from the store,
+ * whichever instance answers — so verifying a delivery of many gigabytes never
+ * holds one request open for as long as its SHA-256 takes.
  */
 export declare function createTransferRoutes(storage: StorageBackend, getRepoPath: (repo: string) => string, transferBackend: TransferBackend, options?: TransferRouteOptions): {
     api: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;

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;AAM5B,OAAO,EAOL,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAW1B,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAqDD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACrC,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE,oBAAyB;;EA0OnC"}
+{"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,EAKL,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;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACrC,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE,oBAAyB;;EAmLnC"}