@elie-laloum/outpost 3.0.0 → 4.0.0

package/dist/infrastructure/storage-reservations.js

@@ -0,0 +1,150 @@
+import { randomUUID } from "node:crypto";
+import { mkdir, open, readdir, realpath, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { invariant, OutpostError } from "../domain/errors.js";
+import { lockStorageMutation } from "./storage-mutation-lock.js";
+import { localProcessIdentity, observeOwnership, } from "./git/process-identity.js";
+import { readInspectionFile } from "./inspection-file.js";
+import { storageInventory } from "./storage-inventory.js";
+import { storageReservationDefaults as defaults } from "./storage-reservations.constants.js";
+async function reservationDirectory(root) {
+    const paths = [
+        join(root, ".outpost"),
+        join(root, ".outpost", "locks"),
+        join(root, ".outpost", "locks", "storage-reservations"),
+    ];
+    for (const path of paths) {
+        await mkdir(path, { recursive: true, mode: 0o700 });
+        invariant((await realpath(path)) === path, "Storage reservation directory must not use symlinks");
+    }
+    return paths[2];
+}
+function validRecord(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    return ("version" in value &&
+        value.version === 1 &&
+        "id" in value &&
+        typeof value.id === "string" &&
+        "pid" in value &&
+        typeof value.pid === "number" &&
+        Number.isSafeInteger(value.pid) &&
+        value.pid > 0 &&
+        value.pid <= 2_147_483_647 &&
+        "reserveBytes" in value &&
+        typeof value.reserveBytes === "number" &&
+        Number.isSafeInteger(value.reserveBytes) &&
+        value.reserveBytes >= 0 &&
+        "createdAt" in value &&
+        typeof value.createdAt === "string" &&
+        Number.isFinite(Date.parse(value.createdAt)));
+}
+async function readRecord(path) {
+    try {
+        const value = JSON.parse((await readInspectionFile(path, defaults.maxRecordBytes)).toString("utf8"));
+        if (validRecord(value))
+            return value;
+    }
+    catch (cause) {
+        throw new OutpostError("workspace", "Storage reservation record is unreadable; admission refused", { path }, cause);
+    }
+    throw new OutpostError("workspace", "Storage reservation record is invalid; admission refused", { path });
+}
+async function reservedBytes(directory) {
+    const names = await readdir(directory);
+    invariant(names.length <= defaults.maxRecords, "Too many storage reservation records");
+    let reserved = 0;
+    for (const name of names) {
+        const path = join(directory, name);
+        const record = await readRecord(path);
+        invariant(name === `${record.id}.json`, "Storage reservation identity mismatch");
+        const owner = await observeOwnership(record.pid, record.identity);
+        if (owner.status === "inactive") {
+            await rm(path);
+            continue;
+        }
+        reserved += record.reserveBytes;
+        invariant(Number.isSafeInteger(reserved), "Storage reservation total exceeds safe integer range");
+    }
+    return reserved;
+}
+async function releaseRecord(root, path, id) {
+    await reservationDirectory(root);
+    const unlock = await lockStorageMutation(root);
+    try {
+        const names = await readdir(join(root, ".outpost", "locks", "storage-reservations"));
+        if (!names.includes(`${id}.json`))
+            return;
+        const record = await readRecord(path);
+        invariant(record.id === id, "Storage reservation identity changed; refusing release");
+        await rm(path);
+    }
+    finally {
+        await unlock();
+    }
+}
+export async function reserveStorage(repository, options) {
+    invariant(Number.isSafeInteger(options.maxBytes) && options.maxBytes >= 0, "maxBytes must be a nonnegative integer");
+    invariant(Number.isSafeInteger(options.reserveBytes) && options.reserveBytes >= 0, "reserveBytes must be a nonnegative integer");
+    options.signal?.throwIfAborted();
+    const directory = await reservationDirectory(repository);
+    const unlock = await lockStorageMutation(repository, options.signal);
+    const id = randomUUID();
+    const path = join(directory, `${id}.json`);
+    try {
+        const reserved = await reservedBytes(directory);
+        const inventory = await storageInventory(join(repository, ".outpost"), options.maxEntries);
+        const record = {
+            version: 1,
+            id,
+            pid: process.pid,
+            identity: await localProcessIdentity(),
+            reserveBytes: options.reserveBytes,
+            createdAt: new Date().toISOString(),
+        };
+        const data = JSON.stringify(record);
+        if (!inventory.complete ||
+            inventory.usage.bytes +
+                reserved +
+                options.reserveBytes +
+                Buffer.byteLength(data) >
+                options.maxBytes)
+            throw new OutpostError("workspace", "Outpost storage reservation admission refused", {
+                usageBytes: inventory.usage.bytes,
+                reservedBytes: reserved,
+                reserveBytes: options.reserveBytes,
+                maxBytes: options.maxBytes,
+                complete: inventory.complete,
+            });
+        options.signal?.throwIfAborted();
+        const file = await open(path, "wx", 0o600);
+        try {
+            await file.writeFile(data);
+            await file.sync();
+        }
+        catch (error) {
+            await file.close();
+            await rm(path, { force: true });
+            throw error;
+        }
+        await file.close();
+    }
+    finally {
+        await unlock();
+    }
+    let released = false;
+    const release = async () => {
+        if (released)
+            return;
+        await releaseRecord(repository, path, id);
+        released = true;
+    };
+    return {
+        id,
+        repository,
+        reserveBytes: options.reserveBytes,
+        release,
+        [Symbol.asyncDispose]: release,
+    };
+}
+//# sourceMappingURL=storage-reservations.js.map

package/dist/infrastructure/storage-reservations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-reservations.js","sourceRoot":"","sources":["../../src/infrastructure/storage-reservations.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { mkdir, open, readdir, realpath, rm } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { invariant, OutpostError } from \"../domain/errors.ts\";\nimport { lockStorageMutation } from \"./storage-mutation-lock.ts\";\nimport {\n  localProcessIdentity,\n  observeOwnership,\n} from \"./git/process-identity.ts\";\nimport { readInspectionFile } from \"./inspection-file.ts\";\nimport { storageInventory } from \"./storage-inventory.ts\";\nimport { storageReservationDefaults as defaults } from \"./storage-reservations.constants.ts\";\nimport type {\n  StorageReservation,\n  StorageReservationOptions,\n  StorageReservationRecord,\n} from \"./storage-reservations.types.ts\";\n\nasync function reservationDirectory(root: string): Promise<string> {\n  const paths = [\n    join(root, \".outpost\"),\n    join(root, \".outpost\", \"locks\"),\n    join(root, \".outpost\", \"locks\", \"storage-reservations\"),\n  ];\n  for (const path of paths) {\n    await mkdir(path, { recursive: true, mode: 0o700 });\n    invariant(\n      (await realpath(path)) === path,\n      \"Storage reservation directory must not use symlinks\",\n    );\n  }\n  return paths[2]!;\n}\n\nfunction validRecord(value: unknown): value is StorageReservationRecord {\n  if (!value || typeof value !== \"object\") return false;\n  return (\n    \"version\" in value &&\n    value.version === 1 &&\n    \"id\" in value &&\n    typeof value.id === \"string\" &&\n    \"pid\" in value &&\n    typeof value.pid === \"number\" &&\n    Number.isSafeInteger(value.pid) &&\n    value.pid > 0 &&\n    value.pid <= 2_147_483_647 &&\n    \"reserveBytes\" in value &&\n    typeof value.reserveBytes === \"number\" &&\n    Number.isSafeInteger(value.reserveBytes) &&\n    value.reserveBytes >= 0 &&\n    \"createdAt\" in value &&\n    typeof value.createdAt === \"string\" &&\n    Number.isFinite(Date.parse(value.createdAt))\n  );\n}\n\nasync function readRecord(path: string): Promise<StorageReservationRecord> {\n  try {\n    const value: unknown = JSON.parse(\n      (await readInspectionFile(path, defaults.maxRecordBytes)).toString(\n        \"utf8\",\n      ),\n    );\n    if (validRecord(value)) return value;\n  } catch (cause) {\n    throw new OutpostError(\n      \"workspace\",\n      \"Storage reservation record is unreadable; admission refused\",\n      { path },\n      cause,\n    );\n  }\n  throw new OutpostError(\n    \"workspace\",\n    \"Storage reservation record is invalid; admission refused\",\n    { path },\n  );\n}\n\nasync function reservedBytes(directory: string): Promise<number> {\n  const names = await readdir(directory);\n  invariant(\n    names.length <= defaults.maxRecords,\n    \"Too many storage reservation records\",\n  );\n  let reserved = 0;\n  for (const name of names) {\n    const path = join(directory, name);\n    const record = await readRecord(path);\n    invariant(\n      name === `${record.id}.json`,\n      \"Storage reservation identity mismatch\",\n    );\n    const owner = await observeOwnership(record.pid, record.identity);\n    if (owner.status === \"inactive\") {\n      await rm(path);\n      continue;\n    }\n    reserved += record.reserveBytes;\n    invariant(\n      Number.isSafeInteger(reserved),\n      \"Storage reservation total exceeds safe integer range\",\n    );\n  }\n  return reserved;\n}\n\nasync function releaseRecord(\n  root: string,\n  path: string,\n  id: string,\n): Promise<void> {\n  await reservationDirectory(root);\n  const unlock = await lockStorageMutation(root);\n  try {\n    const names = await readdir(\n      join(root, \".outpost\", \"locks\", \"storage-reservations\"),\n    );\n    if (!names.includes(`${id}.json`)) return;\n    const record = await readRecord(path);\n    invariant(\n      record.id === id,\n      \"Storage reservation identity changed; refusing release\",\n    );\n    await rm(path);\n  } finally {\n    await unlock();\n  }\n}\n\nexport async function reserveStorage(\n  repository: string,\n  options: StorageReservationOptions,\n): Promise<StorageReservation> {\n  invariant(\n    Number.isSafeInteger(options.maxBytes) && options.maxBytes >= 0,\n    \"maxBytes must be a nonnegative integer\",\n  );\n  invariant(\n    Number.isSafeInteger(options.reserveBytes) && options.reserveBytes >= 0,\n    \"reserveBytes must be a nonnegative integer\",\n  );\n  options.signal?.throwIfAborted();\n  const directory = await reservationDirectory(repository);\n  const unlock = await lockStorageMutation(repository, options.signal);\n  const id = randomUUID();\n  const path = join(directory, `${id}.json`);\n  try {\n    const reserved = await reservedBytes(directory);\n    const inventory = await storageInventory(\n      join(repository, \".outpost\"),\n      options.maxEntries,\n    );\n    const record: StorageReservationRecord = {\n      version: 1,\n      id,\n      pid: process.pid,\n      identity: await localProcessIdentity(),\n      reserveBytes: options.reserveBytes,\n      createdAt: new Date().toISOString(),\n    };\n    const data = JSON.stringify(record);\n    if (\n      !inventory.complete ||\n      inventory.usage.bytes +\n        reserved +\n        options.reserveBytes +\n        Buffer.byteLength(data) >\n        options.maxBytes\n    )\n      throw new OutpostError(\n        \"workspace\",\n        \"Outpost storage reservation admission refused\",\n        {\n          usageBytes: inventory.usage.bytes,\n          reservedBytes: reserved,\n          reserveBytes: options.reserveBytes,\n          maxBytes: options.maxBytes,\n          complete: inventory.complete,\n        },\n      );\n    options.signal?.throwIfAborted();\n    const file = await open(path, \"wx\", 0o600);\n    try {\n      await file.writeFile(data);\n      await file.sync();\n    } catch (error) {\n      await file.close();\n      await rm(path, { force: true });\n      throw error;\n    }\n    await file.close();\n  } finally {\n    await unlock();\n  }\n  let released = false;\n  const release = async () => {\n    if (released) return;\n    await releaseRecord(repository, path, id);\n    released = true;\n  };\n  return {\n    id,\n    repository,\n    reserveBytes: options.reserveBytes,\n    release,\n    [Symbol.asyncDispose]: release,\n  };\n}\n"]}

package/dist/infrastructure/storage-reservations.types.d.ts

@@ -0,0 +1,21 @@
+export interface StorageReservationOptions {
+    readonly maxBytes: number;
+    readonly reserveBytes: number;
+    readonly maxEntries?: number;
+    readonly signal?: AbortSignal;
+}
+export interface StorageReservation {
+    readonly id: string;
+    readonly repository: string;
+    readonly reserveBytes: number;
+    release(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+export interface StorageReservationRecord {
+    readonly version: 1;
+    readonly id: string;
+    readonly pid: number;
+    readonly identity?: unknown;
+    readonly reserveBytes: number;
+    readonly createdAt: string;
+}

package/dist/infrastructure/storage-reservations.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=storage-reservations.types.js.map

package/dist/infrastructure/storage-reservations.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-reservations.types.js","sourceRoot":"","sources":["../../src/infrastructure/storage-reservations.types.ts"],"names":[],"mappings":"","sourcesContent":["export interface StorageReservationOptions {\n  readonly maxBytes: number;\n  readonly reserveBytes: number;\n  readonly maxEntries?: number;\n  readonly signal?: AbortSignal;\n}\n\nexport interface StorageReservation {\n  readonly id: string;\n  readonly repository: string;\n  readonly reserveBytes: number;\n  release(): Promise<void>;\n  [Symbol.asyncDispose](): Promise<void>;\n}\n\nexport interface StorageReservationRecord {\n  readonly version: 1;\n  readonly id: string;\n  readonly pid: number;\n  readonly identity?: unknown;\n  readonly reserveBytes: number;\n  readonly createdAt: string;\n}\n"]}

package/dist/infrastructure/task-queue-http.constants.d.ts

@@ -0,0 +1,2 @@
+export declare const queueHttpTimeoutMs = 10000;
+export declare const queueHttpMaxHeaderBytes = 8192;

package/dist/infrastructure/task-queue-http.constants.js

@@ -0,0 +1,3 @@
+export const queueHttpTimeoutMs = 10_000;
+export const queueHttpMaxHeaderBytes = 8192;
+//# sourceMappingURL=task-queue-http.constants.js.map

package/dist/infrastructure/task-queue-http.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-queue-http.constants.js","sourceRoot":"","sources":["../../src/infrastructure/task-queue-http.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AACzC,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC","sourcesContent":["export const queueHttpTimeoutMs = 10_000;\nexport const queueHttpMaxHeaderBytes = 8192;\n"]}

package/dist/infrastructure/task-queue-http.d.ts

@@ -0,0 +1,4 @@
+import type { TaskQueue } from "../domain/task-queue.types.ts";
+import type { QueueClientOptions, QueueServer, QueueServerOptions } from "./task-queue-http.types.ts";
+export declare function serveTaskQueue(options: QueueServerOptions): Promise<QueueServer>;
+export declare function httpTaskQueue(options: QueueClientOptions): TaskQueue;

package/dist/infrastructure/task-queue-http.js

@@ -0,0 +1,158 @@
+import { queueHttpTimeoutMs, queueHttpMaxHeaderBytes, } from "./task-queue-http.constants.js";
+import { createServer } from "node:http";
+import { timingSafeEqual } from "node:crypto";
+import { queueMaxBytes } from "../domain/task-queue.constants.js";
+import { queueClaim, queueJob, queueLease, queueLeaseMs, queueNumber, queueObject, queueRequest, queueResult, queueString, } from "../domain/task-queue.js";
+function tokenValue(token) {
+    if (typeof token !== "string" ||
+        token.length < 32 ||
+        token.length > 512 ||
+        /\s/.test(token))
+        throw new Error("Queue bearer token must contain 32 to 512 non-whitespace characters");
+    return `Bearer ${token}`;
+}
+async function message(stream) {
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of stream) {
+        size += chunk.byteLength;
+        if (size > queueMaxBytes)
+            throw new Error("Queue message exceeds size limit");
+        chunks.push(chunk);
+    }
+    return JSON.parse(Buffer.concat(chunks).toString("utf8"));
+}
+export async function serveTaskQueue(options) {
+    const expected = Buffer.from(tokenValue(options.token));
+    const queue = options.queue;
+    const server = createServer({
+        requestTimeout: queueHttpTimeoutMs,
+        headersTimeout: queueHttpTimeoutMs,
+        maxHeaderSize: queueHttpMaxHeaderBytes,
+    }, async (request, response) => {
+        const supplied = Buffer.from(request.headers.authorization ?? "");
+        if (supplied.length !== expected.length ||
+            !timingSafeEqual(supplied, expected)) {
+            response.writeHead(401).end();
+            request.resume();
+            return;
+        }
+        if (request.method !== "POST" || request.url !== "/queue") {
+            response.writeHead(404).end();
+            request.resume();
+            return;
+        }
+        try {
+            const data = queueObject(await message(request));
+            const operations = new Map([
+                ["enqueue", () => queue.enqueue(queueRequest(data.request))],
+                ["get", () => queue.get(queueString(data.id))],
+                ["claim", () => queue.claim(queueClaim(data.request))],
+                [
+                    "renew",
+                    () => queue.renew(queueLease(data.lease), queueLeaseMs(data.leaseMs)),
+                ],
+                [
+                    "complete",
+                    () => queue.complete(queueLease(data.lease), queueResult(data.result)),
+                ],
+                [
+                    "cancel",
+                    () => queue.cancel(queueString(data.id), queueNumber(data.fence)),
+                ],
+            ]);
+            const operation = operations.get(queueString(data.operation));
+            if (!operation)
+                throw new Error("Unknown queue operation");
+            const body = JSON.stringify((await operation()) ?? null);
+            if (Buffer.byteLength(body) > queueMaxBytes)
+                throw new Error("Queue response exceeds size limit");
+            response
+                .writeHead(200, {
+                "content-type": "application/json",
+                "cache-control": "no-store",
+            })
+                .end(body);
+        }
+        catch {
+            response.writeHead(400).end("Queue request rejected");
+        }
+    });
+    server.setTimeout(queueHttpTimeoutMs, (socket) => socket.destroy());
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(options.port ?? 0, options.host ?? "127.0.0.1", resolve);
+    });
+    const address = server.address();
+    if (!address || typeof address === "string")
+        throw new Error("Queue server address unavailable");
+    const host = address.family === "IPv6" ? `[${address.address}]` : address.address;
+    return {
+        url: `http://${host}:${address.port}`,
+        close: () => new Promise((resolve, reject) => {
+            server.close((error) => (error ? reject(error) : resolve()));
+            server.closeIdleConnections();
+        }),
+    };
+}
+export function httpTaskQueue(options) {
+    const authorization = tokenValue(options.token);
+    const url = new URL(options.url);
+    if (!["http:", "https:"].includes(url.protocol) ||
+        url.username ||
+        url.password ||
+        url.search ||
+        url.hash)
+        throw new Error("Invalid queue URL");
+    const endpoint = new URL("queue", `${url.href.replace(/\/$/, "")}/`);
+    const timeoutMs = options.timeoutMs ?? queueHttpTimeoutMs;
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs <= 0)
+        throw new Error("Invalid queue request timeout");
+    async function call(data) {
+        const body = JSON.stringify(data);
+        if (Buffer.byteLength(body) > queueMaxBytes)
+            throw new Error("Queue message exceeds size limit");
+        const response = await fetch(endpoint, {
+            method: "POST",
+            headers: { authorization, "content-type": "application/json" },
+            body,
+            signal: AbortSignal.timeout(timeoutMs),
+            redirect: "error",
+        });
+        if (!response.ok) {
+            await response.body?.cancel();
+            throw new Error(`Queue request rejected (${response.status})`);
+        }
+        if (!response.body)
+            throw new Error("Missing queue response");
+        const value = await message(response.body);
+        return value === null ? undefined : queueJob(value);
+    }
+    async function required(data) {
+        const job = await call(data);
+        if (!job)
+            throw new Error("Missing queue job");
+        return job;
+    }
+    return {
+        enqueue: (request) => required({ operation: "enqueue", request: queueRequest(request) }),
+        get: (id) => call({ operation: "get", id: queueString(id) }),
+        claim: (request) => call({ operation: "claim", request: queueClaim(request) }),
+        renew: (lease, leaseMs) => required({
+            operation: "renew",
+            lease: queueLease(lease),
+            leaseMs: queueLeaseMs(leaseMs),
+        }),
+        complete: (lease, result) => required({
+            operation: "complete",
+            lease: queueLease(lease),
+            result: queueResult(result),
+        }),
+        cancel: (id, fence) => required({
+            operation: "cancel",
+            id: queueString(id),
+            fence: queueNumber(fence),
+        }),
+    };
+}
+//# sourceMappingURL=task-queue-http.js.map

package/dist/infrastructure/task-queue-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-queue-http.js","sourceRoot":"","sources":["../../src/infrastructure/task-queue-http.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  queueHttpTimeoutMs,\n  queueHttpMaxHeaderBytes,\n} from \"./task-queue-http.constants.ts\";\nimport { createServer } from \"node:http\";\nimport { timingSafeEqual } from \"node:crypto\";\nimport { queueMaxBytes } from \"../domain/task-queue.constants.ts\";\nimport {\n  queueClaim,\n  queueJob,\n  queueLease,\n  queueLeaseMs,\n  queueNumber,\n  queueObject,\n  queueRequest,\n  queueResult,\n  queueString,\n} from \"../domain/task-queue.ts\";\nimport type { TaskQueue } from \"../domain/task-queue.types.ts\";\nimport type {\n  QueueClientOptions,\n  QueueServer,\n  QueueServerOptions,\n} from \"./task-queue-http.types.ts\";\n\nfunction tokenValue(token: string): string {\n  if (\n    typeof token !== \"string\" ||\n    token.length < 32 ||\n    token.length > 512 ||\n    /\\s/.test(token)\n  )\n    throw new Error(\n      \"Queue bearer token must contain 32 to 512 non-whitespace characters\",\n    );\n  return `Bearer ${token}`;\n}\nasync function message(stream: AsyncIterable<Uint8Array>): Promise<unknown> {\n  const chunks: Uint8Array[] = [];\n  let size = 0;\n  for await (const chunk of stream) {\n    size += chunk.byteLength;\n    if (size > queueMaxBytes)\n      throw new Error(\"Queue message exceeds size limit\");\n    chunks.push(chunk);\n  }\n  return JSON.parse(Buffer.concat(chunks).toString(\"utf8\"));\n}\nexport async function serveTaskQueue(\n  options: QueueServerOptions,\n): Promise<QueueServer> {\n  const expected = Buffer.from(tokenValue(options.token));\n  const queue = options.queue;\n  const server = createServer(\n    {\n      requestTimeout: queueHttpTimeoutMs,\n      headersTimeout: queueHttpTimeoutMs,\n      maxHeaderSize: queueHttpMaxHeaderBytes,\n    },\n    async (request, response) => {\n      const supplied = Buffer.from(request.headers.authorization ?? \"\");\n      if (\n        supplied.length !== expected.length ||\n        !timingSafeEqual(supplied, expected)\n      ) {\n        response.writeHead(401).end();\n        request.resume();\n        return;\n      }\n      if (request.method !== \"POST\" || request.url !== \"/queue\") {\n        response.writeHead(404).end();\n        request.resume();\n        return;\n      }\n      try {\n        const data = queueObject(await message(request));\n        const operations = new Map<string, () => Promise<unknown>>([\n          [\"enqueue\", () => queue.enqueue(queueRequest(data.request))],\n          [\"get\", () => queue.get(queueString(data.id))],\n          [\"claim\", () => queue.claim(queueClaim(data.request))],\n          [\n            \"renew\",\n            () =>\n              queue.renew(queueLease(data.lease), queueLeaseMs(data.leaseMs)),\n          ],\n          [\n            \"complete\",\n            () =>\n              queue.complete(queueLease(data.lease), queueResult(data.result)),\n          ],\n          [\n            \"cancel\",\n            () => queue.cancel(queueString(data.id), queueNumber(data.fence)),\n          ],\n        ]);\n        const operation = operations.get(queueString(data.operation));\n        if (!operation) throw new Error(\"Unknown queue operation\");\n        const body = JSON.stringify((await operation()) ?? null);\n        if (Buffer.byteLength(body) > queueMaxBytes)\n          throw new Error(\"Queue response exceeds size limit\");\n        response\n          .writeHead(200, {\n            \"content-type\": \"application/json\",\n            \"cache-control\": \"no-store\",\n          })\n          .end(body);\n      } catch {\n        response.writeHead(400).end(\"Queue request rejected\");\n      }\n    },\n  );\n  server.setTimeout(queueHttpTimeoutMs, (socket) => socket.destroy());\n  await new Promise<void>((resolve, reject) => {\n    server.once(\"error\", reject);\n    server.listen(options.port ?? 0, options.host ?? \"127.0.0.1\", resolve);\n  });\n  const address = server.address();\n  if (!address || typeof address === \"string\")\n    throw new Error(\"Queue server address unavailable\");\n  const host =\n    address.family === \"IPv6\" ? `[${address.address}]` : address.address;\n  return {\n    url: `http://${host}:${address.port}`,\n    close: () =>\n      new Promise<void>((resolve, reject) => {\n        server.close((error) => (error ? reject(error) : resolve()));\n        server.closeIdleConnections();\n      }),\n  };\n}\nexport function httpTaskQueue(options: QueueClientOptions): TaskQueue {\n  const authorization = tokenValue(options.token);\n  const url = new URL(options.url);\n  if (\n    ![\"http:\", \"https:\"].includes(url.protocol) ||\n    url.username ||\n    url.password ||\n    url.search ||\n    url.hash\n  )\n    throw new Error(\"Invalid queue URL\");\n  const endpoint = new URL(\"queue\", `${url.href.replace(/\\/$/, \"\")}/`);\n  const timeoutMs = options.timeoutMs ?? queueHttpTimeoutMs;\n  if (!Number.isSafeInteger(timeoutMs) || timeoutMs <= 0)\n    throw new Error(\"Invalid queue request timeout\");\n  async function call(data: unknown) {\n    const body = JSON.stringify(data);\n    if (Buffer.byteLength(body) > queueMaxBytes)\n      throw new Error(\"Queue message exceeds size limit\");\n    const response = await fetch(endpoint, {\n      method: \"POST\",\n      headers: { authorization, \"content-type\": \"application/json\" },\n      body,\n      signal: AbortSignal.timeout(timeoutMs),\n      redirect: \"error\",\n    });\n    if (!response.ok) {\n      await response.body?.cancel();\n      throw new Error(`Queue request rejected (${response.status})`);\n    }\n    if (!response.body) throw new Error(\"Missing queue response\");\n    const value = await message(response.body);\n    return value === null ? undefined : queueJob(value);\n  }\n  async function required(data: unknown) {\n    const job = await call(data);\n    if (!job) throw new Error(\"Missing queue job\");\n    return job;\n  }\n  return {\n    enqueue: (request) =>\n      required({ operation: \"enqueue\", request: queueRequest(request) }),\n    get: (id) => call({ operation: \"get\", id: queueString(id) }),\n    claim: (request) =>\n      call({ operation: \"claim\", request: queueClaim(request) }),\n    renew: (lease, leaseMs) =>\n      required({\n        operation: \"renew\",\n        lease: queueLease(lease),\n        leaseMs: queueLeaseMs(leaseMs),\n      }),\n    complete: (lease, result) =>\n      required({\n        operation: \"complete\",\n        lease: queueLease(lease),\n        result: queueResult(result),\n      }),\n    cancel: (id, fence) =>\n      required({\n        operation: \"cancel\",\n        id: queueString(id),\n        fence: queueNumber(fence),\n      }),\n  };\n}\n"]}

package/dist/infrastructure/task-queue-http.types.d.ts

@@ -0,0 +1,16 @@
+import type { TaskQueue } from "../domain/task-queue.types.ts";
+export interface QueueServerOptions {
+    readonly queue: TaskQueue;
+    readonly token: string;
+    readonly host?: string;
+    readonly port?: number;
+}
+export interface QueueServer {
+    readonly url: string;
+    close(): Promise<void>;
+}
+export interface QueueClientOptions {
+    readonly url: string;
+    readonly token: string;
+    readonly timeoutMs?: number;
+}

package/dist/infrastructure/task-queue-http.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=task-queue-http.types.js.map

package/dist/infrastructure/task-queue-http.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-queue-http.types.js","sourceRoot":"","sources":["../../src/infrastructure/task-queue-http.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { TaskQueue } from \"../domain/task-queue.types.ts\";\nexport interface QueueServerOptions {\n  readonly queue: TaskQueue;\n  readonly token: string;\n  readonly host?: string;\n  readonly port?: number;\n}\nexport interface QueueServer {\n  readonly url: string;\n  close(): Promise<void>;\n}\nexport interface QueueClientOptions {\n  readonly url: string;\n  readonly token: string;\n  readonly timeoutMs?: number;\n}\n"]}

package/dist/infrastructure/task-queue.d.ts

@@ -0,0 +1,2 @@
+import type { DurableTaskQueue } from "../domain/task-queue.types.ts";
+export declare function sqliteTaskQueue(path: string): Promise<DurableTaskQueue>;

package/dist/infrastructure/task-queue.js

@@ -0,0 +1,134 @@
+import { mkdirSync, chmodSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { queueClaim, queueJob, queueLease, queueLeaseMs, queueNumber, queueRequest, queueResult, queueString, } from "../domain/task-queue.js";
+export async function sqliteTaskQueue(path) {
+    const { DatabaseSync } = await import("node:sqlite");
+    const file = resolve(path);
+    mkdirSync(dirname(file), { recursive: true, mode: 0o700 });
+    const db = new DatabaseSync(file);
+    chmodSync(file, 0o600);
+    db.exec("PRAGMA busy_timeout=5000; PRAGMA synchronous=FULL; CREATE TABLE IF NOT EXISTS queue_jobs (id TEXT PRIMARY KEY, body TEXT NOT NULL, status TEXT NOT NULL, handler TEXT NOT NULL, expires INTEGER, deadline INTEGER); CREATE INDEX IF NOT EXISTS queue_eligible ON queue_jobs(status, handler, expires, deadline, id)");
+    function read(id) {
+        const row = db.prepare("SELECT body FROM queue_jobs WHERE id = ?").get(id);
+        return row ? queueJob(JSON.parse(String(row.body))) : undefined;
+    }
+    function save(job) {
+        db.prepare("INSERT INTO queue_jobs(id, body, status, handler, expires, deadline) VALUES (?, ?, ?, ?, ?, ?) ON CONFLICT(id) DO UPDATE SET body=excluded.body, status=excluded.status, handler=excluded.handler, expires=excluded.expires, deadline=excluded.deadline").run(job.id, JSON.stringify(job), job.status, job.handler, job.expires ?? null, job.deadline ?? null);
+        return job;
+    }
+    function transaction(operation) {
+        db.exec("BEGIN IMMEDIATE");
+        try {
+            const result = operation();
+            db.exec("COMMIT");
+            return result;
+        }
+        catch (error) {
+            db.exec("ROLLBACK");
+            throw error;
+        }
+    }
+    function expire(job) {
+        if ((job.status === "pending" || job.status === "active") &&
+            job.deadline !== undefined &&
+            job.deadline <= Date.now())
+            return save({ ...job, status: "cancelled", fence: job.fence + 1 });
+        return job;
+    }
+    function required(id) {
+        const job = read(queueString(id));
+        if (!job)
+            throw new Error("Queue job does not exist");
+        return expire(job);
+    }
+    function owned(input) {
+        const lease = queueLease(input);
+        const job = required(lease.id);
+        if (job.status !== "active" ||
+            job.worker !== lease.worker ||
+            job.fence !== lease.fence ||
+            (job.expires ?? 0) <= Date.now())
+            throw new Error("Stale queue lease");
+        return job;
+    }
+    return {
+        async enqueue(input) {
+            return transaction(() => {
+                const request = queueRequest(input);
+                const existing = read(request.id);
+                if (existing) {
+                    if (JSON.stringify(queueRequest(existing)) !== JSON.stringify(request))
+                        throw new Error("Queue identity already has a different request");
+                    return expire(existing);
+                }
+                return expire(save({ ...request, status: "pending", fence: 0 }));
+            });
+        },
+        async get(id) {
+            return transaction(() => {
+                const job = read(queueString(id));
+                return job ? expire(job) : undefined;
+            });
+        },
+        async claim(input) {
+            return transaction(() => {
+                const claim = queueClaim(input);
+                const now = Date.now();
+                const placeholders = claim.handlers.map(() => "?").join(",");
+                const selected = db
+                    .prepare(`SELECT id FROM queue_jobs INDEXED BY queue_eligible
+           WHERE status IN ('pending', 'active') AND handler IN (${placeholders})
+           AND (status = 'pending' OR expires <= ?)
+           AND (deadline IS NULL OR deadline > ?)
+           ORDER BY rowid LIMIT 1`)
+                    .get(...claim.handlers, now, now);
+                if (!selected)
+                    return undefined;
+                const job = required(String(selected.id));
+                if (job.status === "cancelled")
+                    return undefined;
+                return save({
+                    ...job,
+                    status: "active",
+                    worker: claim.worker,
+                    fence: job.fence + 1,
+                    expires: Math.min(now + claim.leaseMs, job.deadline ?? Infinity),
+                });
+            });
+        },
+        async renew(lease, ms) {
+            return transaction(() => {
+                const job = owned(lease);
+                return save({
+                    ...job,
+                    expires: Math.min(Date.now() + queueLeaseMs(ms), job.deadline ?? Infinity),
+                });
+            });
+        },
+        async complete(lease, input) {
+            return transaction(() => {
+                const job = owned(lease);
+                const result = queueResult(input);
+                return save({
+                    ...job,
+                    status: result.error === undefined ? "done" : "failed",
+                    result,
+                });
+            });
+        },
+        async cancel(id, fence) {
+            return transaction(() => {
+                const job = required(id);
+                if (job.fence !== queueNumber(fence))
+                    throw new Error("Stale queue fence");
+                if (job.status !== "pending" && job.status !== "active")
+                    return job;
+                return save({ ...job, status: "cancelled", fence: job.fence + 1 });
+            });
+        },
+        close() {
+            db.close();
+        },
+    };
+}
+//# sourceMappingURL=task-queue.js.map

package/dist/infrastructure/task-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-queue.js","sourceRoot":"","sources":["../../src/infrastructure/task-queue.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdirSync, chmodSync } from \"node:fs\";\nimport { dirname, resolve } from \"node:path\";\nimport {\n  queueClaim,\n  queueJob,\n  queueLease,\n  queueLeaseMs,\n  queueNumber,\n  queueRequest,\n  queueResult,\n  queueString,\n} from \"../domain/task-queue.ts\";\nimport type {\n  DurableTaskQueue,\n  QueueJob,\n  QueueLease,\n} from \"../domain/task-queue.types.ts\";\n\nexport async function sqliteTaskQueue(path: string): Promise<DurableTaskQueue> {\n  const { DatabaseSync } = await import(\"node:sqlite\");\n  const file = resolve(path);\n  mkdirSync(dirname(file), { recursive: true, mode: 0o700 });\n  const db = new DatabaseSync(file);\n  chmodSync(file, 0o600);\n  db.exec(\n    \"PRAGMA busy_timeout=5000; PRAGMA synchronous=FULL; CREATE TABLE IF NOT EXISTS queue_jobs (id TEXT PRIMARY KEY, body TEXT NOT NULL, status TEXT NOT NULL, handler TEXT NOT NULL, expires INTEGER, deadline INTEGER); CREATE INDEX IF NOT EXISTS queue_eligible ON queue_jobs(status, handler, expires, deadline, id)\",\n  );\n  function read(id: string): QueueJob | undefined {\n    const row = db.prepare(\"SELECT body FROM queue_jobs WHERE id = ?\").get(id);\n    return row ? queueJob(JSON.parse(String(row.body))) : undefined;\n  }\n  function save(job: QueueJob): QueueJob {\n    db.prepare(\n      \"INSERT INTO queue_jobs(id, body, status, handler, expires, deadline) VALUES (?, ?, ?, ?, ?, ?) ON CONFLICT(id) DO UPDATE SET body=excluded.body, status=excluded.status, handler=excluded.handler, expires=excluded.expires, deadline=excluded.deadline\",\n    ).run(\n      job.id,\n      JSON.stringify(job),\n      job.status,\n      job.handler,\n      job.expires ?? null,\n      job.deadline ?? null,\n    );\n    return job;\n  }\n  function transaction<T>(operation: () => T): T {\n    db.exec(\"BEGIN IMMEDIATE\");\n    try {\n      const result = operation();\n      db.exec(\"COMMIT\");\n      return result;\n    } catch (error) {\n      db.exec(\"ROLLBACK\");\n      throw error;\n    }\n  }\n  function expire(job: QueueJob): QueueJob {\n    if (\n      (job.status === \"pending\" || job.status === \"active\") &&\n      job.deadline !== undefined &&\n      job.deadline <= Date.now()\n    )\n      return save({ ...job, status: \"cancelled\", fence: job.fence + 1 });\n    return job;\n  }\n  function required(id: string): QueueJob {\n    const job = read(queueString(id));\n    if (!job) throw new Error(\"Queue job does not exist\");\n    return expire(job);\n  }\n  function owned(input: QueueLease): QueueJob {\n    const lease = queueLease(input);\n    const job = required(lease.id);\n    if (\n      job.status !== \"active\" ||\n      job.worker !== lease.worker ||\n      job.fence !== lease.fence ||\n      (job.expires ?? 0) <= Date.now()\n    )\n      throw new Error(\"Stale queue lease\");\n    return job;\n  }\n  return {\n    async enqueue(input) {\n      return transaction(() => {\n        const request = queueRequest(input);\n        const existing = read(request.id);\n        if (existing) {\n          if (\n            JSON.stringify(queueRequest(existing)) !== JSON.stringify(request)\n          )\n            throw new Error(\"Queue identity already has a different request\");\n          return expire(existing);\n        }\n        return expire(save({ ...request, status: \"pending\", fence: 0 }));\n      });\n    },\n    async get(id) {\n      return transaction(() => {\n        const job = read(queueString(id));\n        return job ? expire(job) : undefined;\n      });\n    },\n    async claim(input) {\n      return transaction(() => {\n        const claim = queueClaim(input);\n        const now = Date.now();\n        const placeholders = claim.handlers.map(() => \"?\").join(\",\");\n        const selected = db\n          .prepare(\n            `SELECT id FROM queue_jobs INDEXED BY queue_eligible\n           WHERE status IN ('pending', 'active') AND handler IN (${placeholders})\n           AND (status = 'pending' OR expires <= ?)\n           AND (deadline IS NULL OR deadline > ?)\n           ORDER BY rowid LIMIT 1`,\n          )\n          .get(...claim.handlers, now, now);\n        if (!selected) return undefined;\n        const job = required(String(selected.id));\n        if (job.status === \"cancelled\") return undefined;\n        return save({\n          ...job,\n          status: \"active\",\n          worker: claim.worker,\n          fence: job.fence + 1,\n          expires: Math.min(now + claim.leaseMs, job.deadline ?? Infinity),\n        });\n      });\n    },\n    async renew(lease, ms) {\n      return transaction(() => {\n        const job = owned(lease);\n        return save({\n          ...job,\n          expires: Math.min(\n            Date.now() + queueLeaseMs(ms),\n            job.deadline ?? Infinity,\n          ),\n        });\n      });\n    },\n    async complete(lease, input) {\n      return transaction(() => {\n        const job = owned(lease);\n        const result = queueResult(input);\n        return save({\n          ...job,\n          status: result.error === undefined ? \"done\" : \"failed\",\n          result,\n        });\n      });\n    },\n    async cancel(id, fence) {\n      return transaction(() => {\n        const job = required(id);\n        if (job.fence !== queueNumber(fence))\n          throw new Error(\"Stale queue fence\");\n        if (job.status !== \"pending\" && job.status !== \"active\") return job;\n        return save({ ...job, status: \"cancelled\", fence: job.fence + 1 });\n      });\n    },\n    close() {\n      db.close();\n    },\n  };\n}\n"]}

package/dist/infrastructure/transfer.js

@@ -28,6 +28,11 @@ export function boundedTransfers(lease, defaults) {
         ...(lease.fileTransfers
             ? {
                 fileTransfers: {
+                    ...(lease.fileTransfers.uploadBatch
+                        ? {
+                            uploadBatch: (source, entries, destination, options = {}) => transfer({ ...defaults, ...options }, (signal) => lease.fileTransfers.uploadBatch(source, entries, destination, { ...defaults, ...options, signal })),
+                        }
+                        : {}),
                     manifest: (source, paths, options = {}) => transfer({ ...defaults, ...options }, (signal) => lease.fileTransfers.manifest(source, paths, {
                         ...defaults,
                         ...options,