@elie-laloum/outpost 2.0.0 → 4.0.0

package/dist/infrastructure/storage-inventory.js

@@ -0,0 +1,123 @@
+import { lstat, opendir } from "node:fs/promises";
+import { basename, join } from "node:path";
+import { positive } from "../domain/errors.js";
+import { storageCategories, storageInventoryDefaults, } from "./storage-inventory.constants.js";
+function usage() {
+    return { bytes: 0, files: 0, directories: 0, symlinks: 0, other: 0 };
+}
+function addUsage(target, incoming) {
+    target.bytes += incoming.bytes;
+    target.files += incoming.files;
+    target.directories += incoming.directories;
+    target.symlinks += incoming.symlinks;
+    target.other += incoming.other;
+}
+function errorCode(error) {
+    if (error &&
+        typeof error === "object" &&
+        "code" in error &&
+        typeof error.code === "string")
+        return error.code;
+    return "UNAVAILABLE";
+}
+async function availableDirectory(path, scan) {
+    try {
+        const info = await lstat(path);
+        if (info.isDirectory() && !info.isSymbolicLink())
+            return true;
+        scan.issues.push({
+            path,
+            code: info.isSymbolicLink() ? "SYMLINK_ROOT" : "NOT_DIRECTORY",
+        });
+    }
+    catch (error) {
+        if (errorCode(error) !== "ENOENT")
+            scan.issues.push({ path, code: errorCode(error) });
+    }
+    return false;
+}
+async function measure(path, scan, depth) {
+    const startIssues = scan.issues.length;
+    const entry = {
+        ...usage(),
+        name: basename(path),
+        path,
+        kind: "unknown",
+        complete: true,
+    };
+    if (scan.remaining === 0) {
+        scan.issues.push({ path, code: "ENTRY_LIMIT" });
+        return { ...entry, complete: false };
+    }
+    scan.remaining--;
+    try {
+        const info = await lstat(path);
+        entry.modifiedAt = info.mtime.toISOString();
+        if (info.isSymbolicLink())
+            return { ...entry, kind: "symlink", symlinks: 1 };
+        if (info.isFile())
+            return { ...entry, kind: "file", files: 1, bytes: info.size };
+        if (!info.isDirectory()) {
+            scan.issues.push({ path, code: "UNSUPPORTED_TYPE" });
+            return { ...entry, kind: "other", other: 1, complete: false };
+        }
+        entry.kind = "directory";
+        entry.directories = 1;
+        if (depth >= storageInventoryDefaults.maxDepth) {
+            scan.issues.push({ path, code: "DEPTH_LIMIT" });
+            return { ...entry, complete: false };
+        }
+        for await (const child of await opendir(path)) {
+            const nested = await measure(join(path, child.name), scan, depth + 1);
+            addUsage(entry, nested);
+            if (nested.modifiedAt && nested.modifiedAt > entry.modifiedAt)
+                entry.modifiedAt = nested.modifiedAt;
+            if (!nested.complete)
+                entry.complete = false;
+            if (scan.remaining === 0 && !nested.complete)
+                break;
+        }
+    }
+    catch (error) {
+        scan.issues.push({ path, code: errorCode(error) });
+    }
+    entry.complete = entry.complete && scan.issues.length === startIssues;
+    return entry;
+}
+export async function storageInventory(root, maxEntries = storageInventoryDefaults.maxEntries) {
+    positive(maxEntries, "maxEntries");
+    const scan = { remaining: maxEntries, issues: [] };
+    const categories = [];
+    const total = usage();
+    const available = await availableDirectory(root, scan);
+    for (const name of storageCategories) {
+        const path = join(root, name);
+        const entries = [];
+        if (available && (await availableDirectory(path, scan))) {
+            try {
+                for await (const child of await opendir(path)) {
+                    const entry = await measure(join(path, child.name), scan, 0);
+                    entries.push(entry);
+                    addUsage(total, entry);
+                    if (scan.remaining === 0 && !entry.complete)
+                        break;
+                }
+            }
+            catch (error) {
+                scan.issues.push({ path, code: errorCode(error) });
+            }
+        }
+        entries.sort((left, right) => left.name < right.name ? -1 : Number(left.name > right.name));
+        categories.push({ name, path, entries });
+    }
+    return {
+        root,
+        categories,
+        usage: total,
+        issues: scan.issues,
+        complete: scan.issues.length === 0,
+        scannedEntries: maxEntries - scan.remaining,
+        maxEntries,
+    };
+}
+//# sourceMappingURL=storage-inventory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-inventory.js","sourceRoot":"","sources":["../../src/infrastructure/storage-inventory.ts"],"names":[],"mappings":"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","sourcesContent":["import { lstat, opendir } from \"node:fs/promises\";\nimport { basename, join } from \"node:path\";\nimport { positive } from \"../domain/errors.ts\";\nimport {\n  storageCategories,\n  storageInventoryDefaults,\n} from \"./storage-inventory.constants.ts\";\nimport type {\n  StorageCategory,\n  StorageEntry,\n  StorageInventory,\n  StorageScan,\n  StorageUsage,\n} from \"./storage-inventory.types.ts\";\n\nfunction usage(): StorageUsage {\n  return { bytes: 0, files: 0, directories: 0, symlinks: 0, other: 0 };\n}\nfunction addUsage(\n  target: StorageUsage,\n  incoming: Readonly<StorageUsage>,\n): void {\n  target.bytes += incoming.bytes;\n  target.files += incoming.files;\n  target.directories += incoming.directories;\n  target.symlinks += incoming.symlinks;\n  target.other += incoming.other;\n}\nfunction errorCode(error: unknown): string {\n  if (\n    error &&\n    typeof error === \"object\" &&\n    \"code\" in error &&\n    typeof error.code === \"string\"\n  )\n    return error.code;\n  return \"UNAVAILABLE\";\n}\nasync function availableDirectory(\n  path: string,\n  scan: StorageScan,\n): Promise<boolean> {\n  try {\n    const info = await lstat(path);\n    if (info.isDirectory() && !info.isSymbolicLink()) return true;\n    scan.issues.push({\n      path,\n      code: info.isSymbolicLink() ? \"SYMLINK_ROOT\" : \"NOT_DIRECTORY\",\n    });\n  } catch (error) {\n    if (errorCode(error) !== \"ENOENT\")\n      scan.issues.push({ path, code: errorCode(error) });\n  }\n  return false;\n}\nasync function measure(\n  path: string,\n  scan: StorageScan,\n  depth: number,\n): Promise<StorageEntry> {\n  const startIssues = scan.issues.length;\n  const entry: StorageEntry = {\n    ...usage(),\n    name: basename(path),\n    path,\n    kind: \"unknown\",\n    complete: true,\n  };\n  if (scan.remaining === 0) {\n    scan.issues.push({ path, code: \"ENTRY_LIMIT\" });\n    return { ...entry, complete: false };\n  }\n  scan.remaining--;\n  try {\n    const info = await lstat(path);\n    entry.modifiedAt = info.mtime.toISOString();\n    if (info.isSymbolicLink())\n      return { ...entry, kind: \"symlink\", symlinks: 1 };\n    if (info.isFile())\n      return { ...entry, kind: \"file\", files: 1, bytes: info.size };\n    if (!info.isDirectory()) {\n      scan.issues.push({ path, code: \"UNSUPPORTED_TYPE\" });\n      return { ...entry, kind: \"other\", other: 1, complete: false };\n    }\n    entry.kind = \"directory\";\n    entry.directories = 1;\n    if (depth >= storageInventoryDefaults.maxDepth) {\n      scan.issues.push({ path, code: \"DEPTH_LIMIT\" });\n      return { ...entry, complete: false };\n    }\n    for await (const child of await opendir(path)) {\n      const nested = await measure(join(path, child.name), scan, depth + 1);\n      addUsage(entry, nested);\n      if (nested.modifiedAt && nested.modifiedAt > entry.modifiedAt)\n        entry.modifiedAt = nested.modifiedAt;\n      if (!nested.complete) entry.complete = false;\n      if (scan.remaining === 0 && !nested.complete) break;\n    }\n  } catch (error) {\n    scan.issues.push({ path, code: errorCode(error) });\n  }\n  entry.complete = entry.complete && scan.issues.length === startIssues;\n  return entry;\n}\n\nexport async function storageInventory(\n  root: string,\n  maxEntries: number = storageInventoryDefaults.maxEntries,\n): Promise<StorageInventory> {\n  positive(maxEntries, \"maxEntries\");\n  const scan: StorageScan = { remaining: maxEntries, issues: [] };\n  const categories: StorageCategory[] = [];\n  const total = usage();\n  const available = await availableDirectory(root, scan);\n  for (const name of storageCategories) {\n    const path = join(root, name);\n    const entries: StorageEntry[] = [];\n    if (available && (await availableDirectory(path, scan))) {\n      try {\n        for await (const child of await opendir(path)) {\n          const entry = await measure(join(path, child.name), scan, 0);\n          entries.push(entry);\n          addUsage(total, entry);\n          if (scan.remaining === 0 && !entry.complete) break;\n        }\n      } catch (error) {\n        scan.issues.push({ path, code: errorCode(error) });\n      }\n    }\n    entries.sort((left, right) =>\n      left.name < right.name ? -1 : Number(left.name > right.name),\n    );\n    categories.push({ name, path, entries });\n  }\n  return {\n    root,\n    categories,\n    usage: total,\n    issues: scan.issues,\n    complete: scan.issues.length === 0,\n    scannedEntries: maxEntries - scan.remaining,\n    maxEntries,\n  };\n}\n"]}

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

@@ -0,0 +1,38 @@
+export type StorageCategoryName = "recovery" | "logs" | "locks" | "workspaces";
+export type StorageEntryKind = "file" | "directory" | "symlink" | "other" | "unknown";
+export interface StorageIssue {
+    readonly path: string;
+    readonly code: string;
+}
+export interface StorageUsage {
+    bytes: number;
+    files: number;
+    directories: number;
+    symlinks: number;
+    other: number;
+}
+export interface StorageEntry extends StorageUsage {
+    readonly name: string;
+    readonly path: string;
+    kind: StorageEntryKind;
+    modifiedAt?: string;
+    complete: boolean;
+}
+export interface StorageCategory {
+    readonly name: StorageCategoryName;
+    readonly path: string;
+    readonly entries: readonly StorageEntry[];
+}
+export interface StorageInventory {
+    readonly root: string;
+    readonly categories: readonly StorageCategory[];
+    readonly usage: Readonly<StorageUsage>;
+    readonly issues: readonly StorageIssue[];
+    readonly complete: boolean;
+    readonly scannedEntries: number;
+    readonly maxEntries: number;
+}
+export interface StorageScan {
+    remaining: number;
+    readonly issues: StorageIssue[];
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-inventory.types.js","sourceRoot":"","sources":["../../src/infrastructure/storage-inventory.types.ts"],"names":[],"mappings":"","sourcesContent":["export type StorageCategoryName = \"recovery\" | \"logs\" | \"locks\" | \"workspaces\";\nexport type StorageEntryKind =\n  \"file\" | \"directory\" | \"symlink\" | \"other\" | \"unknown\";\n\nexport interface StorageIssue {\n  readonly path: string;\n  readonly code: string;\n}\nexport interface StorageUsage {\n  bytes: number;\n  files: number;\n  directories: number;\n  symlinks: number;\n  other: number;\n}\nexport interface StorageEntry extends StorageUsage {\n  readonly name: string;\n  readonly path: string;\n  kind: StorageEntryKind;\n  modifiedAt?: string;\n  complete: boolean;\n}\nexport interface StorageCategory {\n  readonly name: StorageCategoryName;\n  readonly path: string;\n  readonly entries: readonly StorageEntry[];\n}\nexport interface StorageInventory {\n  readonly root: string;\n  readonly categories: readonly StorageCategory[];\n  readonly usage: Readonly<StorageUsage>;\n  readonly issues: readonly StorageIssue[];\n  readonly complete: boolean;\n  readonly scannedEntries: number;\n  readonly maxEntries: number;\n}\nexport interface StorageScan {\n  remaining: number;\n  readonly issues: StorageIssue[];\n}\n"]}

package/dist/infrastructure/storage-mutation-lock.constants.d.ts

@@ -0,0 +1,5 @@
+export declare const storageMutationLockDefaults: {
+    readonly lockKey: "storage-reservations:v1";
+    readonly lockWaitMs: 5000;
+    readonly lockPollMs: 20;
+};

package/dist/infrastructure/storage-mutation-lock.constants.js

@@ -0,0 +1,6 @@
+export const storageMutationLockDefaults = {
+    lockKey: "storage-reservations:v1",
+    lockWaitMs: 5_000,
+    lockPollMs: 20,
+};
+//# sourceMappingURL=storage-mutation-lock.constants.js.map

package/dist/infrastructure/storage-mutation-lock.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-mutation-lock.constants.js","sourceRoot":"","sources":["../../src/infrastructure/storage-mutation-lock.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,OAAO,EAAE,yBAAyB;IAClC,UAAU,EAAE,KAAK;IACjB,UAAU,EAAE,EAAE;CACN,CAAC","sourcesContent":["export const storageMutationLockDefaults = {\n  lockKey: \"storage-reservations:v1\",\n  lockWaitMs: 5_000,\n  lockPollMs: 20,\n} as const;\n"]}

package/dist/infrastructure/storage-mutation-lock.d.ts

@@ -0,0 +1 @@
+export declare function lockStorageMutation(root: string, signal?: AbortSignal): Promise<() => Promise<void>>;

package/dist/infrastructure/storage-mutation-lock.js

@@ -0,0 +1,21 @@
+import { setTimeout } from "node:timers/promises";
+import { OutpostError } from "../domain/errors.js";
+import { lock } from "./git/lock.js";
+import { storageMutationLockDefaults as defaults } from "./storage-mutation-lock.constants.js";
+export async function lockStorageMutation(root, signal) {
+    const deadline = Date.now() + defaults.lockWaitMs;
+    while (true) {
+        signal?.throwIfAborted();
+        try {
+            return await lock(root, defaults.lockKey);
+        }
+        catch (error) {
+            if (!(error instanceof OutpostError) ||
+                error.code !== "conflict" ||
+                Date.now() >= deadline)
+                throw error;
+            await setTimeout(defaults.lockPollMs, undefined, { signal });
+        }
+    }
+}
+//# sourceMappingURL=storage-mutation-lock.js.map

package/dist/infrastructure/storage-mutation-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-mutation-lock.js","sourceRoot":"","sources":["../../src/infrastructure/storage-mutation-lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,2BAA2B,IAAI,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAE/F,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAY,EAAE,MAAoB;IAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,UAAU,CAAC;IAClD,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IACE,CAAC,CAAC,KAAK,YAAY,YAAY,CAAC;gBAChC,KAAK,CAAC,IAAI,KAAK,UAAU;gBACzB,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ;gBAEtB,MAAM,KAAK,CAAC;YACd,MAAM,UAAU,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["import { setTimeout } from \"node:timers/promises\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport { lock } from \"./git/lock.ts\";\nimport { storageMutationLockDefaults as defaults } from \"./storage-mutation-lock.constants.ts\";\n\nexport async function lockStorageMutation(root: string, signal?: AbortSignal) {\n  const deadline = Date.now() + defaults.lockWaitMs;\n  while (true) {\n    signal?.throwIfAborted();\n    try {\n      return await lock(root, defaults.lockKey);\n    } catch (error) {\n      if (\n        !(error instanceof OutpostError) ||\n        error.code !== \"conflict\" ||\n        Date.now() >= deadline\n      )\n        throw error;\n      await setTimeout(defaults.lockPollMs, undefined, { signal });\n    }\n  }\n}\n"]}

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

@@ -0,0 +1,4 @@
+export declare const storageReservationDefaults: {
+    readonly maxRecordBytes: 4096;
+    readonly maxRecords: 10000;
+};

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

@@ -0,0 +1,5 @@
+export const storageReservationDefaults = {
+    maxRecordBytes: 4_096,
+    maxRecords: 10_000,
+};
+//# sourceMappingURL=storage-reservations.constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-reservations.constants.js","sourceRoot":"","sources":["../../src/infrastructure/storage-reservations.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,cAAc,EAAE,KAAK;IACrB,UAAU,EAAE,MAAM;CACV,CAAC","sourcesContent":["export const storageReservationDefaults = {\n  maxRecordBytes: 4_096,\n  maxRecords: 10_000,\n} as const;\n"]}

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

@@ -0,0 +1,2 @@
+import type { StorageReservation, StorageReservationOptions } from "./storage-reservations.types.ts";
+export declare function reserveStorage(repository: string, options: StorageReservationOptions): Promise<StorageReservation>;

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;