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

package/dist/src/server/storage-bridge.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * The rack data-plane seam (#74, epic #67 design §10) — how the /rack
+ * storage routes hand object bytes to a credential-free agent:
+ *
+ * - objects travel by **presigned URL** — the API mints URLs, the agent
+ *   transfers directly against the store, the API is never a byte proxy. A
+ *   bridge that holds an object's bytes at hand may send them **inline** in
+ *   the response body instead; the AWS bridge does not, as every object's
+ *   bytes are in S3 (elaraai/e3-cloud#201);
+ * - each object a lease's guest wrote is **PUT at its content address**
+ *   through a target bound to its SHA-256 and to the lease (#214), so the
+ *   store refuses any other bytes; its commit checks the version the agent
+ *   made (size, checksum, lease) and registers it, and never reads its body;
+ * - a lease that ends without committing what it wrote has those versions
+ *   **discarded**: no uncatalogued version is left at a content address.
+ *
+ * Implemented by `S3DynamoRackStorageBridge` (e3-aws, over S3 and the object
+ * catalogue) and `InMemoryRackStorageBridge` (testing).
+ */
+/** How the agent should obtain one object. */
+export type RackObjectRead = {
+    kind: 'inline';
+    data: Uint8Array;
+} | {
+    kind: 'url';
+    url: string;
+};
+/** A PUT target for one object at its content address (#214). */
+export interface RackPutTarget {
+    /** The presigned URL */
+    readonly url: string;
+    /** The headers the PUT must send, as given: they are signed into its URL
+     *  (the SHA-256 the store checks, and the lease's tag) */
+    readonly headers: Readonly<Record<string, string>>;
+}
+/** Supplies scoped object transfers and environment layers to rack routes. */
+export interface RackStorageBridge {
+    /**
+     * Descriptor for an object the agent lacks: a presigned GET URL, or the
+     * bytes inline when the bridge holds them at hand.
+     *
+     * @param repo - The lease's repo
+     * @param hash - The object hash (already scope-validated by the route)
+     */
+    readDescriptor(repo: string, hash: string): Promise<RackObjectRead>;
+    /**
+     * A PUT target for an object a lease's guest wrote, at its content address,
+     * bound to its SHA-256 (the store refuses other bytes) and tagged with the
+     * lease (what {@link discardWrites} deletes). When the store holds the
+     * object already, it is re-referenced instead, as a write of it would be,
+     * and nothing is to be sent.
+     *
+     * @param repo - The lease's repo
+     * @param leaseId - The lease
+     * @param hash - The object's hash, as the agent declares it
+     * @param size - Its size in bytes
+     * @returns The target, or null when the store holds the object
+     */
+    writeTarget(repo: string, leaseId: string, hash: string, size: number): Promise<RackPutTarget | null>;
+    /**
+     * Takes in an object the agent PUT through a {@link writeTarget}: the
+     * version it made is checked (its size, its SHA-256 as the store computed
+     * it, and the lease's tag) and registered in the object catalogue, in one
+     * write with the condition that the rack holds the lease. So a commit that
+     * races its lease's end registers nothing, and the end's
+     * {@link discardWrites} never deletes a version the catalogue pins. Never a
+     * body read. An object another writer registered first is re-referenced,
+     * and this version deleted; a commit sent again is answered as the first.
+     *
+     * @param repo - The lease's repo
+     * @param leaseId - The lease
+     * @param rackId - The rack that holds it
+     * @param hash - The object's hash
+     * @param size - Its size in bytes
+     * @param version - The version the agent's PUT made, as the store answered it
+     * @returns false when the version is not the lease's, not these bytes, or
+     *   the lease is not the rack's
+     */
+    commitWrite(repo: string, leaseId: string, rackId: string, hash: string, size: number, version: string): Promise<boolean>;
+    /**
+     * Deletes what a lease wrote that no catalogue row pins: every version at
+     * the keys it was issued targets for that carries its tag. A version the
+     * catalogue pins, and another lease's, are kept. Called only once the lease
+     * has ended.
+     *
+     * @param repo - The lease's repo
+     * @param leaseId - The lease
+     * @param hashes - The keys it was issued targets for
+     * @returns How many versions it deleted
+     */
+    discardWrites(repo: string, leaseId: string, hashes: readonly string[]): Promise<number>;
+    /**
+     * A presigned PUT target to a staging key for a whole output (#74, #210):
+     * nothing is trusted until {@link commitStaged} takes it in.
+     *
+     * @param repo - The lease's repo
+     * @param workspace - The lease's workspace (recorded on the transfer)
+     * @param hash - The agent-declared output hash
+     * @param size - The agent-declared output size in bytes
+     */
+    stagedTarget(repo: string, workspace: string, hash: string, size: bigint): Promise<{
+        url: string;
+        uploadId: string;
+    }>;
+    /**
+     * Takes a staged output in once the store's server-side copy of it hashes
+     * to the declared hash (#210): the large-output commit of an output sent
+     * whole.
+     *
+     * @returns false when verification fails (tampered/wrong upload) — the
+     *   caller must then reject the completion
+     */
+    commitStaged(repo: string, hash: string, uploadId: string): Promise<boolean>;
+    /**
+     * Write an inline (small) output through the normal object-store write —
+     * the server computes the hash itself.
+     *
+     * @returns The server-computed content hash
+     */
+    writeInline(repo: string, data: Uint8Array): Promise<string>;
+    /**
+     * Read a published env-layer manifest (#94 Slice B) from the data
+     * bucket. Deployment-global (not repo-scoped) — the route has already
+     * scope-checked the env hash against the lease.
+     *
+     * @returns The manifest JSON, or null when unpublished
+     */
+    readEnvManifest(manifestKey: string): Promise<string | null>;
+    /**
+     * Mint a presigned GET for one published env-layer blob (#94 Slice B).
+     *
+     * @param blobKey - The content-addressed data-bucket key
+     */
+    presignEnvLayer(blobKey: string): Promise<string>;
+}
+//# sourceMappingURL=storage-bridge.d.ts.map

package/dist/src/server/storage-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-bridge.d.ts","sourceRoot":"","sources":["../../../src/server/storage-bridge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AAEH,8CAA8C;AAC9C,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;8DAC0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD;AAED,8EAA8E;AAC9E,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEpE;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAEtG;;;;;;;;;;;;;;;;;;OAkBG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE1H;;;;;;;;;;OAUG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzF;;;;;;;;OAQG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEtH;;;;;;;OAOG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7E;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE7D;;;;;;OAMG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE7D;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACnD"}

package/dist/src/server/storage-bridge.js

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

package/dist/src/server/storage-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-bridge.js","sourceRoot":"","sources":["../../../src/server/storage-bridge.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/state-file.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+export { MutationQueue } from './mutation-queue.js';
+/** Reads a hub state payload, refusing an unknown format. @internal */
+export declare function readStateFile(file: string): Promise<Uint8Array | null>;
+/** Atomically replaces a hub state value inside its private home. @internal */
+export declare function writeStateFile(file: string, value: Uint8Array): Promise<void>;
+//# sourceMappingURL=state-file.d.ts.map

package/dist/src/state-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-file.d.ts","sourceRoot":"","sources":["../../src/state-file.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,uEAAuE;AACvE,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAS5E;AAED,+EAA+E;AAC/E,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnF"}

package/dist/src/state-file.js

@@ -0,0 +1,38 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { chmod, readFile } from 'node:fs/promises';
+import { BlobType, IntegerType, StringType, StructType, decodeBeast2For, encodeBeast2For, equalFor, printFor } from '@elaraai/east';
+import { atomicWriteFile } from '@elaraai/e3-core';
+import { E3_RACK_VERSION } from './version.js';
+// Hub state is outside a repository and has its own explicit format. Its
+// envelope remains readable before decoding the inner value, so a future
+// release can refuse or migrate a form without guessing from corrupt bytes.
+const Envelope = StructType({ release: StringType, format: IntegerType, value: BlobType });
+const encode = encodeBeast2For(Envelope);
+const decode = decodeBeast2For(Envelope);
+export { MutationQueue } from './mutation-queue.js';
+/** Reads a hub state payload, refusing an unknown format. @internal */
+export async function readStateFile(file) {
+    let bytes;
+    try {
+        bytes = await readFile(file);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return null;
+        throw err;
+    }
+    const envelope = decode(bytes);
+    if (!equalFor(IntegerType)(envelope.format, 1n))
+        throw new Error(`${file} uses rack state format ${printFor(IntegerType)(envelope.format)}, written by e3 ${envelope.release}; update e3`);
+    return envelope.value;
+}
+/** Atomically replaces a hub state value inside its private home. @internal */
+export async function writeStateFile(file, value) {
+    await atomicWriteFile(file, encode({ release: E3_RACK_VERSION, format: 1n, value }));
+    if (process.platform !== 'win32')
+        await chmod(file, 0o600);
+}
+//# sourceMappingURL=state-file.js.map

package/dist/src/state-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-file.js","sourceRoot":"","sources":["../../src/state-file.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACpI,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,yEAAyE;AACzE,yEAAyE;AACzE,4EAA4E;AAC5E,MAAM,QAAQ,GAAG,UAAU,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC3F,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;AACzC,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY;IAC9C,IAAI,KAAiB,CAAC;IACtB,IAAI,CAAC;QAAC,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACjD,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAClE,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,2BAA2B,QAAQ,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,mBAAmB,QAAQ,CAAC,OAAO,aAAa,CAAC,CAAC;IAC3L,OAAO,QAAQ,CAAC,KAAK,CAAC;AACxB,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY,EAAE,KAAiB;IAClE,MAAM,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACrF,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC7D,CAAC"}

package/dist/src/testing/in-memory.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import type { StorageBackend } from '@elaraai/e3-core';
+import type { RackLeaseStore } from '../lease/lease-store.js';
+import type { RackObjectRead, RackPutTarget, RackStorageBridge } from '../server/storage-bridge.js';
+/**
+ * Models versioned rack uploads in memory over an explicit repository backend.
+ * Ported from pinned e3-cloud testing; this is not an isolation boundary.
+ * @example
+ * const bridge = new InMemoryRackStorageBridge(storage, leases);
+ */
+export declare class InMemoryRackStorageBridge implements RackStorageBridge {
+    private readonly leases?;
+    /** Serves objects up to this size inline. */
+    inlineThreshold: number;
+    /** The store objects are read from, and committed to */
+    readonly storage: StorageBackend;
+    /** `${repo} ${hash}` → the versions PUTs made at the address, oldest first */
+    readonly versions: Map<string, {
+        version: string;
+        bytes: Uint8Array;
+        lease: string;
+        pinned: boolean;
+    }[]>;
+    /** uploadId → declared staged output (#210). */
+    readonly targets: Map<string, {
+        repo: string;
+        hash: string;
+        size: bigint;
+    }>;
+    /** uploadId → bytes the fake agent staged (#210). */
+    readonly staged: Map<string, Uint8Array<ArrayBufferLike>>;
+    /** manifestKey → published manifest JSON (#94 Slice B test seam). */
+    readonly envManifests: Map<string, string>;
+    private seq;
+    /**
+     * @param storage - The store objects are read from and committed to
+     *   (required: tests use a real temporary repository)
+     * @param leases - The leases a commit is held to (default: none, and every
+     *   commit is taken as held)
+     */
+    constructor(storage: StorageBackend, leases?: Pick<RackLeaseStore, "get"> | undefined);
+    private key;
+    /** Test hook: seed a committed object, returning its hash. */
+    seedObject(repo: string, data: Uint8Array): Promise<string>;
+    /** Test hook: simulate the agent's staged PUT of a whole output (#210). */
+    stageUpload(uploadId: string, data: Uint8Array): void;
+    /**
+     * Test hook: a presigned GET of `mem://{repo}/{hash}`, as the agent sends it.
+     *
+     * @returns The object's bytes, or null when the store holds none
+     */
+    fetch(url: string): Promise<Uint8Array | null>;
+    /**
+     * Test hook: a PUT through a write target, as S3 serves it: refused unless
+     * its bytes hash to the address and it sends the headers signed into its
+     * URL; otherwise a new version at the address.
+     *
+     * @returns The version the PUT made, or why it was refused
+     */
+    put(url: string, bytes: Uint8Array, headers: Readonly<Record<string, string>>): {
+        version: string;
+    } | {
+        refused: string;
+    };
+    /** Serves small objects inline and larger objects through the test transport. */
+    readDescriptor(repo: string, hash: string): Promise<RackObjectRead>;
+    /** Allocates a checksum-bound versioned upload unless the object is already held. */
+    writeTarget(repo: string, leaseId: string, hash: string, _size: number): Promise<RackPutTarget | null>;
+    /** Verifies a version and its claimant before committing the object. */
+    commitWrite(repo: string, leaseId: string, rackId: string, hash: string, size: number, version: string): Promise<boolean>;
+    /** Discards uncommitted versions belonging to the lease. */
+    discardWrites(repo: string, leaseId: string, hashes: readonly string[]): Promise<number>;
+    /** The versions at an address that nothing pinned: what a discard leaves none of. */
+    unpinned(repo: string, hash: string): number;
+    /** Allocates a legacy whole-output staging target. */
+    stagedTarget(repo: string, _workspace: string, hash: string, size: bigint): Promise<{
+        url: string;
+        uploadId: string;
+    }>;
+    /** Verifies and commits a legacy whole-output upload. */
+    commitStaged(repo: string, hash: string, uploadId: string): Promise<boolean>;
+    /** Reads an environment manifest seeded by a test. */
+    readEnvManifest(manifestKey: string): Promise<string | null>;
+    /** Names an environment layer in the test transport. */
+    presignEnvLayer(blobKey: string): Promise<string>;
+    /** Stores inline bytes and returns their computed hash. */
+    writeInline(repo: string, data: Uint8Array): Promise<string>;
+}
+/**
+ * Recording LogStore fake for route tests: its appends, and its flushes, each
+ * after the appends before it.
+ */
+export declare class RecordingLogStore {
+    /** Appends received in transport order. */
+    readonly entries: Array<{
+        repo: string;
+        taskHash: string;
+        inputsHash: string;
+        executionId: string;
+        stream: 'stdout' | 'stderr';
+        data: string;
+    }>;
+    /** Each flush, with how many appends came before it: an attempt's, or every log's (none named) */
+    readonly flushes: Array<{
+        executionId?: string;
+        after: number;
+    }>;
+    /** Records an ordered log append. */
+    append(repo: string, taskHash: string, inputsHash: string, executionId: string, stream: 'stdout' | 'stderr', data: string): Promise<void>;
+    /** An attempt's flush (east-workspace#1051), or, named none, every log's. */
+    flush(_repo?: string, _taskHash?: string, _inputsHash?: string, executionId?: string): Promise<void>;
+}
+//# sourceMappingURL=in-memory.d.ts.map

package/dist/src/testing/in-memory.d.ts.map

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

package/dist/src/testing/in-memory.js

@@ -0,0 +1,193 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { createHash } from 'node:crypto';
+/**
+ * Models versioned rack uploads in memory over an explicit repository backend.
+ * Ported from pinned e3-cloud testing; this is not an isolation boundary.
+ * @example
+ * const bridge = new InMemoryRackStorageBridge(storage, leases);
+ */
+export class InMemoryRackStorageBridge {
+    leases;
+    /** Serves objects up to this size inline. */
+    inlineThreshold = 4096;
+    /** The store objects are read from, and committed to */
+    storage;
+    /** `${repo} ${hash}` → the versions PUTs made at the address, oldest first */
+    versions = new Map();
+    /** uploadId → declared staged output (#210). */
+    targets = new Map();
+    /** uploadId → bytes the fake agent staged (#210). */
+    staged = new Map();
+    /** manifestKey → published manifest JSON (#94 Slice B test seam). */
+    envManifests = new Map();
+    seq = 0;
+    /**
+     * @param storage - The store objects are read from and committed to
+     *   (required: tests use a real temporary repository)
+     * @param leases - The leases a commit is held to (default: none, and every
+     *   commit is taken as held)
+     */
+    constructor(storage, leases) {
+        this.leases = leases;
+        this.storage = storage;
+    }
+    key(repo, hash) {
+        return `${repo} ${hash}`;
+    }
+    /** Test hook: seed a committed object, returning its hash. */
+    async seedObject(repo, data) {
+        return this.storage.objects.write(repo, data);
+    }
+    /** Test hook: simulate the agent's staged PUT of a whole output (#210). */
+    stageUpload(uploadId, data) {
+        this.staged.set(uploadId, data);
+    }
+    /**
+     * Test hook: a presigned GET of `mem://{repo}/{hash}`, as the agent sends it.
+     *
+     * @returns The object's bytes, or null when the store holds none
+     */
+    async fetch(url) {
+        const [repo, hash] = url.slice('mem://'.length).split('/');
+        try {
+            return await this.storage.objects.read(decodeURIComponent(repo), hash);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Test hook: a PUT through a write target, as S3 serves it: refused unless
+     * its bytes hash to the address and it sends the headers signed into its
+     * URL; otherwise a new version at the address.
+     *
+     * @returns The version the PUT made, or why it was refused
+     */
+    put(url, bytes, headers) {
+        const match = /^mem:\/\/put\/([^/]+)\/([0-9a-f]{64})\?lease=(.+)$/.exec(url);
+        if (match === null)
+            return { refused: `not a write target: ${url}` };
+        const [, repo, hash, lease] = match;
+        const checksum = Buffer.from(hash, 'hex').toString('base64');
+        if (headers['x-amz-checksum-sha256'] !== checksum || headers['x-amz-meta-e3-lease'] !== decodeURIComponent(lease)) {
+            return { refused: 'SignatureDoesNotMatch: the PUT sent other headers than its URL signs' };
+        }
+        if (createHash('sha256').update(bytes).digest('base64') !== checksum) {
+            return { refused: 'BadDigest: the SHA256 you specified did not match the calculated checksum' };
+        }
+        const version = `v${++this.seq}`;
+        const key = this.key(decodeURIComponent(repo), hash);
+        this.versions.set(key, [...(this.versions.get(key) ?? []), { version, bytes: new Uint8Array(bytes), lease: decodeURIComponent(lease), pinned: false }]);
+        return { version };
+    }
+    /** Serves small objects inline and larger objects through the test transport. */
+    async readDescriptor(repo, hash) {
+        const data = await this.storage.objects.read(repo, hash);
+        if (data.length <= this.inlineThreshold) {
+            return { kind: 'inline', data };
+        }
+        return { kind: 'url', url: `mem://${encodeURIComponent(repo)}/${hash}` };
+    }
+    /** Allocates a checksum-bound versioned upload unless the object is already held. */
+    async writeTarget(repo, leaseId, hash, _size) {
+        const [held] = await this.storage.objects.touch(repo, [hash]);
+        if (held === true)
+            return null;
+        return {
+            url: `mem://put/${encodeURIComponent(repo)}/${hash}?lease=${encodeURIComponent(leaseId)}`,
+            headers: { 'x-amz-checksum-sha256': Buffer.from(hash, 'hex').toString('base64'), 'x-amz-meta-e3-lease': leaseId },
+        };
+    }
+    /** Verifies a version and its claimant before committing the object. */
+    async commitWrite(repo, leaseId, rackId, hash, size, version) {
+        const put = this.versions.get(this.key(repo, hash))?.find((candidate) => candidate.version === version);
+        if (put === undefined || put.lease !== leaseId || put.bytes.length !== size)
+            return false;
+        if (createHash('sha256').update(put.bytes).digest('hex') !== hash)
+            return false;
+        if (this.leases !== undefined) {
+            // Held to the lease, as the catalogue's conditional write holds it
+            const lease = await this.leases.get(repo, leaseId);
+            if (lease?.status !== 'claimed' || lease.claimedBy !== rackId)
+                return false;
+        }
+        const [held] = await this.storage.objects.touch(repo, [hash]);
+        if (held !== true && (await this.storage.objects.write(repo, put.bytes)) !== hash)
+            return false;
+        put.pinned = true;
+        return true;
+    }
+    /** Discards uncommitted versions belonging to the lease. */
+    discardWrites(repo, leaseId, hashes) {
+        let deleted = 0;
+        for (const hash of hashes) {
+            const key = this.key(repo, hash);
+            const versions = this.versions.get(key) ?? [];
+            const kept = versions.filter((candidate) => candidate.pinned || candidate.lease !== leaseId);
+            deleted += versions.length - kept.length;
+            this.versions.set(key, kept);
+        }
+        return Promise.resolve(deleted);
+    }
+    /** The versions at an address that nothing pinned: what a discard leaves none of. */
+    unpinned(repo, hash) {
+        return (this.versions.get(this.key(repo, hash)) ?? []).filter((candidate) => !candidate.pinned).length;
+    }
+    /** Allocates a legacy whole-output staging target. */
+    stagedTarget(repo, _workspace, hash, size) {
+        const uploadId = `up-${++this.seq}`;
+        this.targets.set(uploadId, { repo, hash, size });
+        return Promise.resolve({ url: `mem://stage/${encodeURIComponent(repo)}/${hash}`, uploadId });
+    }
+    /** Verifies and commits a legacy whole-output upload. */
+    async commitStaged(repo, hash, uploadId) {
+        const target = this.targets.get(uploadId);
+        const data = this.staged.get(uploadId);
+        if (!target || !data || target.repo !== repo || target.hash !== hash)
+            return false;
+        if (BigInt(data.length) !== target.size)
+            return false;
+        if (createHash('sha256').update(data).digest('hex') !== hash)
+            return false;
+        await this.storage.objects.write(repo, data);
+        this.targets.delete(uploadId);
+        this.staged.delete(uploadId);
+        return true;
+    }
+    /** Reads an environment manifest seeded by a test. */
+    readEnvManifest(manifestKey) {
+        return Promise.resolve(this.envManifests.get(manifestKey) ?? null);
+    }
+    /** Names an environment layer in the test transport. */
+    presignEnvLayer(blobKey) {
+        return Promise.resolve(`mem://env/${blobKey}`);
+    }
+    /** Stores inline bytes and returns their computed hash. */
+    async writeInline(repo, data) {
+        return this.storage.objects.write(repo, data);
+    }
+}
+/**
+ * Recording LogStore fake for route tests: its appends, and its flushes, each
+ * after the appends before it.
+ */
+export class RecordingLogStore {
+    /** Appends received in transport order. */
+    entries = [];
+    /** Each flush, with how many appends came before it: an attempt's, or every log's (none named) */
+    flushes = [];
+    /** Records an ordered log append. */
+    append(repo, taskHash, inputsHash, executionId, stream, data) {
+        this.entries.push({ repo, taskHash, inputsHash, executionId, stream, data });
+        return Promise.resolve();
+    }
+    /** An attempt's flush (east-workspace#1051), or, named none, every log's. */
+    flush(_repo, _taskHash, _inputsHash, executionId) {
+        this.flushes.push({ ...(executionId !== undefined && { executionId }), after: this.entries.length });
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=in-memory.js.map

package/dist/src/testing/in-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.js","sourceRoot":"","sources":["../../../src/testing/in-memory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKzC;;;;;GAKG;AACH,MAAM,OAAO,yBAAyB;IAqBkB;IApBtD,6CAA6C;IAC7C,eAAe,GAAG,IAAI,CAAC;IACvB,wDAAwD;IAC/C,OAAO,CAAiB;IACjC,8EAA8E;IACrE,QAAQ,GAAG,IAAI,GAAG,EAAyF,CAAC;IACrH,gDAAgD;IACvC,OAAO,GAAG,IAAI,GAAG,EAAwD,CAAC;IACnF,qDAAqD;IAC5C,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAC;IAChD,qEAAqE;IAC5D,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,GAAG,GAAG,CAAC,CAAC;IAEhB;;;;;OAKG;IACH,YAAY,OAAuB,EAAmB,MAAoC;QAApC,WAAM,GAAN,MAAM,CAA8B;QACxF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAEO,GAAG,CAAC,IAAY,EAAE,IAAY;QACpC,OAAO,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,8DAA8D;IAC9D,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,IAAgB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,2EAA2E;IAC3E,WAAW,CAAC,QAAgB,EAAE,IAAgB;QAC5C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,GAAW;QACrB,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAqB,CAAC;QAC/E,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QACzE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CAAC,GAAW,EAAE,KAAiB,EAAE,OAAyC;QAC3E,MAAM,KAAK,GAAG,oDAAoD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7E,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,EAAE,OAAO,EAAE,uBAAuB,GAAG,EAAE,EAAE,CAAC;QACrE,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,KAAoD,CAAC;QACnF,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC7D,IAAI,OAAO,CAAC,uBAAuB,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,qBAAqB,CAAC,KAAK,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAClH,OAAO,EAAE,OAAO,EAAE,sEAAsE,EAAE,CAAC;QAC7F,CAAC;QACD,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ,EAAE,CAAC;YACrE,OAAO,EAAE,OAAO,EAAE,2EAA2E,EAAE,CAAC;QAClG,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QACxJ,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC;IAED,iFAAiF;IACjF,KAAK,CAAC,cAAc,CAAC,IAAY,EAAE,IAAY;QAC7C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzD,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACxC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAClC,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,kBAAkB,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;IAC3E,CAAC;IAED,qFAAqF;IACrF,KAAK,CAAC,WAAW,CAAC,IAAY,EAAE,OAAe,EAAE,IAAY,EAAE,KAAa;QAC1E,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9D,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC/B,OAAO;YACL,GAAG,EAAE,aAAa,kBAAkB,CAAC,IAAI,CAAC,IAAI,IAAI,UAAU,kBAAkB,CAAC,OAAO,CAAC,EAAE;YACzF,OAAO,EAAE,EAAE,uBAAuB,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,EAAE,OAAO,EAAE;SAClH,CAAC;IACJ,CAAC;IAED,wEAAwE;IACxE,KAAK,CAAC,WAAW,CAAC,IAAY,EAAE,OAAe,EAAE,MAAc,EAAE,IAAY,EAAE,IAAY,EAAE,OAAe;QAC1G,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;QACxG,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,KAAK,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC1F,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAChF,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,mEAAmE;YACnE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACnD,IAAI,KAAK,EAAE,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM;gBAAE,OAAO,KAAK,CAAC;QAC9E,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9D,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAChG,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4DAA4D;IAC5D,aAAa,CAAC,IAAY,EAAE,OAAe,EAAE,MAAyB;QACpE,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAC9C,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC;YAC7F,OAAO,IAAI,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YACzC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,qFAAqF;IACrF,QAAQ,CAAC,IAAY,EAAE,IAAY;QACjC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;IACzG,CAAC;IAED,sDAAsD;IACtD,YAAY,CAAC,IAAY,EAAE,UAAkB,EAAE,IAAY,EAAE,IAAY;QACvE,MAAM,QAAQ,GAAG,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;QACpC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,eAAe,kBAAkB,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,IAAY,EAAE,QAAgB;QAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACnF,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACtD,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC3E,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sDAAsD;IACtD,eAAe,CAAC,WAAmB;QACjC,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,CAAC;IACrE,CAAC;IAED,wDAAwD;IACxD,eAAe,CAAC,OAAe;QAC7B,OAAO,OAAO,CAAC,OAAO,CAAC,aAAa,OAAO,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,2DAA2D;IAC3D,KAAK,CAAC,WAAW,CAAC,IAAY,EAAE,IAAgB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IAC5B,2CAA2C;IAClC,OAAO,GAAkI,EAAE,CAAC;IACrJ,kGAAkG;IACzF,OAAO,GAAmD,EAAE,CAAC;IAEtE,qCAAqC;IACrC,MAAM,CAAC,IAAY,EAAE,QAAgB,EAAE,UAAkB,EAAE,WAAmB,EAAE,MAA2B,EAAE,IAAY;QACvH,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7E,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,KAAc,EAAE,SAAkB,EAAE,WAAoB,EAAE,WAAoB;QAClF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACrG,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/src/testing/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+export { InMemoryRackLeaseStore } from '../lease/in-memory-lease-store.js';
+export { InMemoryMachineIdentityStore } from '../identity/in-memory-identity-store.js';
+export { InMemoryRackRegistry } from '../registry/rack-registry.js';
+export { rackRegistryContract } from './rack-registry-contract.js';
+export { leaseStoreContract } from './lease-store-contract.js';
+export { wireSamples } from '../protocol/wire-samples.js';
+export { TestRackAgent, type TestRackAgentOptions, type TestRackAgentFaults } from './test-rack-agent.js';
+export { InMemoryRackStorageBridge, RecordingLogStore } from './in-memory.js';
+export { rackProtocolSuite, type RackProtocolFixture } from './protocol-suite.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC1G,OAAO,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/testing/index.js

@@ -0,0 +1,14 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+export { InMemoryRackLeaseStore } from '../lease/in-memory-lease-store.js';
+export { InMemoryMachineIdentityStore } from '../identity/in-memory-identity-store.js';
+export { InMemoryRackRegistry } from '../registry/rack-registry.js';
+export { rackRegistryContract } from './rack-registry-contract.js';
+export { leaseStoreContract } from './lease-store-contract.js';
+export { wireSamples } from '../protocol/wire-samples.js';
+export { TestRackAgent } from './test-rack-agent.js';
+export { InMemoryRackStorageBridge, RecordingLogStore } from './in-memory.js';
+export { rackProtocolSuite } from './protocol-suite.js';
+//# sourceMappingURL=index.js.map

package/dist/src/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAuD,MAAM,sBAAsB,CAAC;AAC1G,OAAO,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAA4B,MAAM,qBAAqB,CAAC"}

package/dist/src/testing/lease-store-contract.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { type RackLeaseStore } from '../lease/lease-store.js';
+/**
+ * Tests the conditional lease transitions every backend implements.
+ * @param label - The backend's name
+ * @param makeStore - Creates an empty store for each case
+ * @example
+ * leaseStoreContract('memory', () => new InMemoryRackLeaseStore());
+ */
+export declare function leaseStoreContract(label: string, makeStore: () => RackLeaseStore | Promise<RackLeaseStore>): void;
+//# sourceMappingURL=lease-store-contract.d.ts.map

package/dist/src/testing/lease-store-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lease-store-contract.d.ts","sourceRoot":"","sources":["../../../src/testing/lease-store-contract.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAqC,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEjG;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CA8DjH"}