self-bench 0.3.6 → 0.3.8

package/dist/artifacts/gcs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcs.d.ts","sourceRoot":"","sources":["../../src/artifacts/gcs.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/D,qBAAa,gBAAiB,YAAW,aAAa;;gBAKxC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAKpC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAiC9E,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA2CnF,GAAG,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAiBhD,aAAa,CAAC,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASrE,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAYnD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAUtD,aAAa,CACjB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GACxC,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAS1B,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;CA4CrD"}

package/dist/artifacts/gcs.js

@@ -0,0 +1,178 @@
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { Storage } from "@google-cloud/storage";
+import { sha256 } from "../hash.js";
+import { copyWithDigest, verifiedArtifactReadStream, verifyArtifact } from "./common.js";
+export class GcsArtifactStore {
+    #storage = new Storage();
+    #bucket;
+    #prefix;
+    constructor(bucket, prefix) {
+        this.#bucket = bucket;
+        this.#prefix = prefix.replace(/^\/+|\/+$/g, "");
+    }
+    async put(key, value, contentType) {
+        const object = this.#objectFor(key);
+        const digest = sha256(value);
+        const file = this.#storage.bucket(this.#bucket).file(object);
+        try {
+            await file.save(value, {
+                resumable: false,
+                preconditionOpts: { ifGenerationMatch: 0 },
+                metadata: {
+                    contentType,
+                    metadata: { sha256: digest },
+                },
+            });
+        }
+        catch (error) {
+            const [exists] = await file.exists();
+            if (!exists) {
+                throw error;
+            }
+            const [metadata] = await file.getMetadata();
+            if (metadata.metadata?.sha256 !== digest) {
+                throw new Error(`artifact already exists with different contents: gs://${this.#bucket}/${object}`);
+            }
+        }
+        return {
+            uri: `gs://${this.#bucket}/${object}`,
+            sha256: digest,
+            sizeBytes: value.byteLength,
+            contentType,
+        };
+    }
+    async putFile(key, sourcePath, contentType) {
+        const object = this.#objectFor(key);
+        const bucket = this.#storage.bucket(this.#bucket);
+        const file = bucket.file(object);
+        const snapshotDirectory = await mkdtemp(join(tmpdir(), "selfbench-artifact-"));
+        const snapshotPath = join(snapshotDirectory, "upload");
+        try {
+            const digest = await copyWithDigest(sourcePath, snapshotPath);
+            try {
+                await bucket.upload(snapshotPath, {
+                    destination: object,
+                    resumable: true,
+                    preconditionOpts: { ifGenerationMatch: 0 },
+                    metadata: {
+                        contentType,
+                        metadata: { sha256: digest.sha256 },
+                    },
+                });
+            }
+            catch (error) {
+                const [exists] = await file.exists();
+                if (!exists) {
+                    throw error;
+                }
+                const [metadata] = await file.getMetadata();
+                if (metadata.metadata?.sha256 !== digest.sha256 ||
+                    Number(metadata.size) !== digest.sizeBytes) {
+                    throw new Error(`artifact already exists with different contents: gs://${this.#bucket}/${object}`);
+                }
+            }
+            return {
+                uri: `gs://${this.#bucket}/${object}`,
+                ...digest,
+                contentType,
+            };
+        }
+        finally {
+            await rm(snapshotDirectory, { recursive: true, force: true });
+        }
+    }
+    async get(reference) {
+        const match = /^gs:\/\/([^/]+)\/(.+)$/.exec(reference.uri);
+        if (!match) {
+            throw new Error(`GCS artifact store cannot read ${reference.uri}`);
+        }
+        const [, bucket, object] = match;
+        if (bucket !== this.#bucket || !object) {
+            throw new Error(`artifact is outside configured bucket: ${reference.uri}`);
+        }
+        if (this.#prefix && object !== this.#prefix && !object.startsWith(`${this.#prefix}/`)) {
+            throw new Error(`artifact is outside configured bucket: ${reference.uri}`);
+        }
+        const [value] = await this.#storage.bucket(bucket).file(object).download();
+        verifyArtifact(reference, value);
+        return value;
+    }
+    async signedReadUrl(reference, ttlMs) {
+        const [url] = await this.#fileForReference(reference).getSignedUrl({
+            version: "v4",
+            action: "read",
+            expires: Date.now() + ttlMs,
+        });
+        return url;
+    }
+    async openRead(reference) {
+        const file = this.#fileForReference(reference);
+        const [metadata] = await file.getMetadata();
+        if (Number(metadata.size) !== reference.sizeBytes ||
+            metadata.metadata?.sha256 !== reference.sha256) {
+            throw new Error(`artifact integrity check failed: ${reference.uri}`);
+        }
+        return verifiedArtifactReadStream(reference, file.createReadStream());
+    }
+    async getByKey(key) {
+        const file = this.#storage.bucket(this.#bucket).file(this.#objectFor(key));
+        const [exists] = await file.exists();
+        if (!exists) {
+            return undefined;
+        }
+        const [value] = await file.download();
+        return value;
+    }
+    async openReadByKey(key, options = {}) {
+        const file = this.#storage.bucket(this.#bucket).file(this.#objectFor(key));
+        const [exists] = await file.exists();
+        if (!exists) {
+            return undefined;
+        }
+        return file.createReadStream(options.start ? { start: options.start } : {});
+    }
+    async list(prefix) {
+        const object = this.#objectFor(prefix);
+        const [files] = await this.#storage.bucket(this.#bucket).getFiles({ prefix: `${object}/` });
+        const base = this.#prefix ? `${this.#prefix}/` : "";
+        const entries = [];
+        for (const file of files) {
+            if (!file.name.startsWith(base) || file.name.endsWith("/"))
+                continue;
+            const updated = file.metadata.updated;
+            entries.push({
+                key: file.name.slice(base.length),
+                sizeBytes: Number(file.metadata.size ?? 0),
+                ...(updated ? { updatedAt: String(updated) } : {}),
+            });
+        }
+        return entries.sort((left, right) => left.key.localeCompare(right.key));
+    }
+    #fileForReference(reference) {
+        const match = /^gs:\/\/([^/]+)\/(.+)$/.exec(reference.uri);
+        if (!match) {
+            throw new Error(`GCS artifact store cannot read ${reference.uri}`);
+        }
+        const [, bucket, object] = match;
+        if (bucket !== this.#bucket || !object) {
+            throw new Error(`artifact is outside configured bucket: ${reference.uri}`);
+        }
+        if (this.#prefix && object !== this.#prefix && !object.startsWith(`${this.#prefix}/`)) {
+            throw new Error(`artifact is outside configured bucket: ${reference.uri}`);
+        }
+        return this.#storage.bucket(bucket).file(object);
+    }
+    #objectFor(key) {
+        if (!key ||
+            key.startsWith("/") ||
+            key.includes("\\") ||
+            key.includes("\0") ||
+            key.split("/").some((part) => !part || part === "." || part === "..")) {
+            throw new Error(`unsafe artifact key: ${key}`);
+        }
+        return this.#prefix ? `${this.#prefix}/${key}` : key;
+    }
+}
+//# sourceMappingURL=gcs.js.map

package/dist/artifacts/gcs.js.map

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

package/dist/artifacts/local.d.ts

@@ -0,0 +1,17 @@
+import type { Readable } from "node:stream";
+import type { ArtifactRef } from "../contracts.js";
+import type { ArtifactEntry, ArtifactStore } from "./types.js";
+export declare class LocalArtifactStore implements ArtifactStore {
+    #private;
+    constructor(root: string);
+    put(key: string, value: Uint8Array, contentType: string): Promise<ArtifactRef>;
+    putFile(key: string, sourcePath: string, contentType: string): Promise<ArtifactRef>;
+    get(reference: ArtifactRef): Promise<Uint8Array>;
+    openRead(reference: ArtifactRef): Promise<Readable>;
+    getByKey(key: string): Promise<Uint8Array | undefined>;
+    openReadByKey(key: string, options?: {
+        readonly start?: number;
+    }): Promise<Readable | undefined>;
+    list(prefix: string): Promise<ArtifactEntry[]>;
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/artifacts/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/artifacts/local.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAUnD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/D,qBAAa,kBAAmB,YAAW,aAAa;;gBAG1C,IAAI,EAAE,MAAM;IAIlB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAsB9E,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAmCnF,GAAG,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAahD,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IASnD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAatD,aAAa,CACjB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GACxC,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAa1B,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;CA6FrD"}

package/dist/artifacts/local.js

@@ -0,0 +1,205 @@
+import { randomUUID } from "node:crypto";
+import { createReadStream } from "node:fs";
+import { chmod, link, lstat, mkdir, readdir, readFile, rm, stat, writeFile, } from "node:fs/promises";
+import { dirname, relative, resolve, sep } from "node:path";
+import { pathToFileURL } from "node:url";
+import { sha256 } from "../hash.js";
+import { copyWithDigest, fileDigest, hasCode, isNotFound, verifiedArtifactReadStream, verifyArtifact, } from "./common.js";
+export class LocalArtifactStore {
+    #root;
+    constructor(root) {
+        this.#root = resolve(root);
+    }
+    async put(key, value, contentType) {
+        const path = this.#pathFor(key);
+        await this.#prepareParent(path);
+        const digest = sha256(value);
+        try {
+            await writeFile(path, value, { flag: "wx", mode: 0o600 });
+        }
+        catch (error) {
+            await this.#assertRegularFile(path);
+            const existing = await fileDigest(path).catch(() => undefined);
+            if (!existing || existing.sha256 !== digest || existing.sizeBytes !== value.byteLength) {
+                throw error;
+            }
+            await chmod(path, 0o600);
+        }
+        return {
+            uri: pathToFileURL(path).href,
+            sha256: digest,
+            sizeBytes: value.byteLength,
+            contentType,
+        };
+    }
+    async putFile(key, sourcePath, contentType) {
+        const path = this.#pathFor(key);
+        await this.#prepareParent(path);
+        const temporaryPath = `${path}.${randomUUID()}.tmp`;
+        try {
+            const digest = await copyWithDigest(sourcePath, temporaryPath);
+            try {
+                await link(temporaryPath, path);
+            }
+            catch (error) {
+                if (!hasCode(error, "EEXIST")) {
+                    throw error;
+                }
+                await this.#assertRegularFile(path);
+                const existing = await fileDigest(path).catch(() => undefined);
+                if (!existing ||
+                    existing.sha256 !== digest.sha256 ||
+                    existing.sizeBytes !== digest.sizeBytes) {
+                    throw new Error(`artifact already exists with different contents: ${pathToFileURL(path).href}`);
+                }
+                await chmod(path, 0o600);
+            }
+            return {
+                uri: pathToFileURL(path).href,
+                ...digest,
+                contentType,
+            };
+        }
+        finally {
+            await rm(temporaryPath, { force: true });
+        }
+    }
+    async get(reference) {
+        const url = new URL(reference.uri);
+        if (url.protocol !== "file:") {
+            throw new Error(`local artifact store cannot read ${reference.uri}`);
+        }
+        const path = resolve(decodeURIComponent(url.pathname));
+        this.#assertInsideRoot(path);
+        await this.#assertRegularFile(path);
+        const value = await readFile(path);
+        verifyArtifact(reference, value);
+        return value;
+    }
+    async openRead(reference) {
+        const path = this.#pathForReference(reference);
+        await this.#assertRegularFile(path);
+        if ((await stat(path)).size !== reference.sizeBytes) {
+            throw new Error(`artifact integrity check failed: ${reference.uri}`);
+        }
+        return verifiedArtifactReadStream(reference, createReadStream(path));
+    }
+    async getByKey(key) {
+        try {
+            const path = this.#pathFor(key);
+            await this.#assertRegularFile(path);
+            return await readFile(path);
+        }
+        catch (error) {
+            if (isNotFound(error)) {
+                return undefined;
+            }
+            throw error;
+        }
+    }
+    async openReadByKey(key, options = {}) {
+        const path = this.#pathFor(key);
+        try {
+            await this.#assertRegularFile(path);
+        }
+        catch (error) {
+            if (isNotFound(error)) {
+                return undefined;
+            }
+            throw error;
+        }
+        return createReadStream(path, options.start ? { start: options.start } : {});
+    }
+    async list(prefix) {
+        const root = this.#pathFor(prefix);
+        const entries = [];
+        const visit = async (directory, relativePrefix) => {
+            let names;
+            try {
+                names = await readdir(directory, { withFileTypes: true });
+            }
+            catch (error) {
+                if (isNotFound(error))
+                    return;
+                throw error;
+            }
+            for (const entry of names) {
+                if (entry.isSymbolicLink())
+                    continue;
+                const path = resolve(directory, entry.name);
+                const key = `${relativePrefix}/${entry.name}`;
+                if (entry.isDirectory()) {
+                    await visit(path, key);
+                }
+                else if (entry.isFile()) {
+                    const stats = await stat(path);
+                    entries.push({ key, sizeBytes: stats.size, updatedAt: stats.mtime.toISOString() });
+                }
+            }
+        };
+        await visit(root, prefix);
+        return entries.sort((left, right) => left.key.localeCompare(right.key));
+    }
+    #pathForReference(reference) {
+        const url = new URL(reference.uri);
+        if (url.protocol !== "file:") {
+            throw new Error(`local artifact store cannot read ${reference.uri}`);
+        }
+        const path = resolve(decodeURIComponent(url.pathname));
+        this.#assertInsideRoot(path);
+        return path;
+    }
+    #pathFor(key) {
+        if (!key ||
+            key.startsWith("/") ||
+            key.includes("\\") ||
+            key.includes("\0") ||
+            key.split("/").some((part) => !part || part === "." || part === "..")) {
+            throw new Error(`unsafe artifact key: ${key}`);
+        }
+        const path = resolve(this.#root, key);
+        this.#assertInsideRoot(path);
+        return path;
+    }
+    async #prepareParent(path) {
+        const parent = dirname(path);
+        await mkdir(this.#root, { recursive: true, mode: 0o700 });
+        const fromRoot = relative(this.#root, parent);
+        let current = this.#root;
+        for (const part of ["", ...fromRoot.split(sep).filter(Boolean)]) {
+            current = part ? resolve(current, part) : current;
+            if (part) {
+                await mkdir(current, { mode: 0o700 }).catch((error) => {
+                    if (!hasCode(error, "EEXIST"))
+                        throw error;
+                });
+            }
+            const stats = await lstat(current);
+            if (!stats.isDirectory() || stats.isSymbolicLink()) {
+                throw new Error(`artifact path contains a non-directory component: ${current}`);
+            }
+            await chmod(current, 0o700);
+        }
+    }
+    async #assertRegularFile(path) {
+        const fromRoot = relative(this.#root, dirname(path));
+        let current = this.#root;
+        for (const part of ["", ...fromRoot.split(sep).filter(Boolean)]) {
+            current = part ? resolve(current, part) : current;
+            const directory = await lstat(current);
+            if (!directory.isDirectory() || directory.isSymbolicLink()) {
+                throw new Error(`artifact path contains a non-directory component: ${current}`);
+            }
+        }
+        const stats = await lstat(path);
+        if (!stats.isFile() || stats.isSymbolicLink()) {
+            throw new Error(`artifact path is not a regular file: ${path}`);
+        }
+    }
+    #assertInsideRoot(path) {
+        if (path !== this.#root && !path.startsWith(`${this.#root}${sep}`)) {
+            throw new Error(`artifact path escapes root: ${path}`);
+        }
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/artifacts/local.js.map

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

package/dist/artifacts/types.d.ts

@@ -0,0 +1,18 @@
+import type { Readable } from "node:stream";
+import type { ArtifactRef } from "../contracts.js";
+import type { ArtifactEntry } from "../viewer/types.js";
+export type { ArtifactEntry };
+export interface ArtifactStore {
+    put(key: string, value: Uint8Array, contentType: string): Promise<ArtifactRef>;
+    putFile(key: string, sourcePath: string, contentType: string): Promise<ArtifactRef>;
+    get(reference: ArtifactRef): Promise<Uint8Array>;
+    openRead(reference: ArtifactRef): Promise<Readable>;
+    getByKey(key: string): Promise<Uint8Array | undefined>;
+    /** A time-limited URL a sandbox can GET the artifact from, when the backend supports it. */
+    signedReadUrl?(reference: ArtifactRef, ttlMs: number): Promise<string | undefined>;
+    openReadByKey(key: string, options?: {
+        readonly start?: number;
+    }): Promise<Readable | undefined>;
+    list(prefix: string): Promise<ArtifactEntry[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/artifacts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/artifacts/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/E,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACpF,GAAG,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IACvD,4FAA4F;IAC5F,aAAa,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACnF,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;IACjG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;CAChD"}

package/dist/artifacts/types.js

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

package/dist/artifacts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/artifacts/types.ts"],"names":[],"mappings":""}

package/dist/artifacts.d.ts

@@ -1,31 +1,8 @@
-import { Readable } from "node:stream";
+import type { ArtifactStore } from "./artifacts/types.js";
 import type { SelfBenchConfig } from "./config.js";
-import type { ArtifactRef } from "./contracts.js";
-export interface ArtifactStore {
-    put(key: string, value: Uint8Array, contentType: string): Promise<ArtifactRef>;
-    putFile(key: string, sourcePath: string, contentType: string): Promise<ArtifactRef>;
-    get(reference: ArtifactRef): Promise<Uint8Array>;
-    openRead(reference: ArtifactRef): Promise<Readable>;
-    getByKey(key: string): Promise<Uint8Array | undefined>;
-}
+export type { ArtifactStore } from "./artifacts/types.js";
 export declare function createArtifactStore(config: SelfBenchConfig["artifact"]): ArtifactStore;
-export declare class LocalArtifactStore implements ArtifactStore {
-    #private;
-    constructor(root: string);
-    put(key: string, value: Uint8Array, contentType: string): Promise<ArtifactRef>;
-    putFile(key: string, sourcePath: string, contentType: string): Promise<ArtifactRef>;
-    get(reference: ArtifactRef): Promise<Uint8Array>;
-    openRead(reference: ArtifactRef): Promise<Readable>;
-    getByKey(key: string): Promise<Uint8Array | undefined>;
-}
-export declare class GcsArtifactStore implements ArtifactStore {
-    #private;
-    constructor(bucket: string, prefix: string);
-    put(key: string, value: Uint8Array, contentType: string): Promise<ArtifactRef>;
-    putFile(key: string, sourcePath: string, contentType: string): Promise<ArtifactRef>;
-    get(reference: ArtifactRef): Promise<Uint8Array>;
-    openRead(reference: ArtifactRef): Promise<Readable>;
-    getByKey(key: string): Promise<Uint8Array | undefined>;
-}
-export declare function verifiedArtifactReadStream(reference: ArtifactRef, input: Readable): Readable;
+export { verifiedArtifactReadStream } from "./artifacts/common.js";
+export { GcsArtifactStore } from "./artifacts/gcs.js";
+export { LocalArtifactStore } from "./artifacts/local.js";
 //# sourceMappingURL=artifacts.d.ts.map

package/dist/artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../src/artifacts.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAa,MAAM,aAAa,CAAC;AAGlD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/E,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACpF,GAAG,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;CACxD;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,CAAC,UAAU,CAAC,GAAG,aAAa,CAItF;AAED,qBAAa,kBAAmB,YAAW,aAAa;;gBAG1C,IAAI,EAAE,MAAM;IAIlB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAoB9E,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA+BnF,GAAG,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAYhD,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQnD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;CAmC7D;AAED,qBAAa,gBAAiB,YAAW,aAAa;;gBAKxC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAKpC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAiC9E,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA2CnF,GAAG,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAiBhD,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAYnD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;CA+B7D;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAgB5F"}
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../src/artifacts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,CAAC,UAAU,CAAC,GAAG,aAAa,CAItF;AAED,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}