runmat 0.6.1 → 0.6.2-dev.0

package/dist/package-cache/project-session.d.ts

@@ -0,0 +1,61 @@
+import type { RunMatFilesystemProvider } from "../fs/provider-types.js";
+import { type BrowserProjectResolveRequest, type BrowserProjectResolverConfig, type BrowserProjectResolverNative, type BrowserResolvedProject } from "./browser-resolver.js";
+import type { PackageCacheGcPlan, PackageCacheStatus, RunMatPackageCacheProvider } from "./provider-types.js";
+export interface BrowserProjectSessionHandle {
+    setFsProvider?(provider: RunMatFilesystemProvider): Promise<void> | void;
+    installProjectHandoff(handoff: unknown): Promise<unknown>;
+    clearProjectHandoff(): Promise<void>;
+    projectRevision(): Promise<unknown | null>;
+}
+export interface BrowserProjectSessionNative extends BrowserProjectResolverNative {
+    decodePackageLock(input: string): unknown;
+    encodePackageLock(lock: unknown): string;
+    handoffFromFrozenProject(project: unknown): unknown;
+    packageCacheStatus(provider: RunMatPackageCacheProvider): Promise<PackageCacheStatus>;
+    packageCacheGc(provider: RunMatPackageCacheProvider, targetBytes: bigint, retainRecentMs: bigint): Promise<PackageCacheGcPlan>;
+}
+export interface BrowserProjectSessionConfig extends Omit<BrowserProjectResolverConfig, "native"> {
+    native: BrowserProjectSessionNative;
+    session: BrowserProjectSessionHandle;
+}
+export interface BrowserProjectSessionResolveRequest extends BrowserProjectResolveRequest {
+    /**
+     * Defaults to `runmat.lock` beside the manifest. Set to `null` only for an
+     * intentionally ephemeral embedding that must neither read nor write a lock.
+     */
+    lockPath?: string | null;
+}
+export interface BrowserProjectSessionResolution {
+    project: BrowserResolvedProject;
+    handoff: unknown;
+    revision: unknown;
+    lockPath: string | null;
+    lockWritten: boolean;
+}
+/**
+ * Owns one resolved browser project and its immutable cache lease/mount table.
+ *
+ * Rust remains authoritative for lock parsing, solving, graph construction,
+ * handoff validation, and cache policy. This class only coordinates host ports
+ * and makes teardown explicit.
+ */
+export declare class BrowserProjectSession {
+    private readonly config;
+    private readonly resolver;
+    private active;
+    private disposed;
+    constructor(config: BrowserProjectSessionConfig);
+    get resolution(): BrowserProjectSessionResolution | null;
+    get filesystem(): RunMatFilesystemProvider;
+    get cacheLeaseError(): unknown;
+    resolve(request: BrowserProjectSessionResolveRequest): Promise<BrowserProjectSessionResolution>;
+    sourceRevision(): Promise<unknown | null>;
+    cacheStatus(): Promise<PackageCacheStatus>;
+    collectCache(targetBytes: bigint, retainRecentMs?: bigint): Promise<PackageCacheGcPlan>;
+    dispose(): Promise<void>;
+    private readExistingLock;
+    private writeLock;
+    private pathExists;
+    private rollback;
+}
+//# sourceMappingURL=project-session.d.ts.map

package/dist/package-cache/project-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-session.d.ts","sourceRoot":"","sources":["../../src/package-cache/project-session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAEL,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,KAAK,sBAAsB,EAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC3B,MAAM,qBAAqB,CAAC;AAI7B,MAAM,WAAW,2BAA2B;IAC1C,aAAa,CAAC,CAAC,QAAQ,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACzE,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1D,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,eAAe,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,2BAA4B,SAAQ,4BAA4B;IAC/E,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1C,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACzC,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;IACpD,kBAAkB,CAAC,QAAQ,EAAE,0BAA0B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACtF,cAAc,CACZ,QAAQ,EAAE,0BAA0B,EACpC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,2BACf,SAAQ,IAAI,CAAC,4BAA4B,EAAE,QAAQ,CAAC;IACpD,MAAM,EAAE,2BAA2B,CAAC;IACpC,OAAO,EAAE,2BAA2B,CAAC;CACtC;AAED,MAAM,WAAW,mCACf,SAAQ,4BAA4B;IACpC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,sBAAsB,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;GAMG;AACH,qBAAa,qBAAqB;IAKpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,MAAM,CAAgD;IAC9D,OAAO,CAAC,QAAQ,CAAS;gBAEI,MAAM,EAAE,2BAA2B;IAIhE,IAAI,UAAU,IAAI,+BAA+B,GAAG,IAAI,CAEvD;IAED,IAAI,UAAU,IAAI,wBAAwB,CAEzC;IAED,IAAI,eAAe,IAAI,OAAO,CAE7B;IAEK,OAAO,CACX,OAAO,EAAE,mCAAmC,GAC3C,OAAO,CAAC,+BAA+B,CAAC;IA4CrC,cAAc,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAIzC,WAAW,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAI1C,YAAY,CAChB,WAAW,EAAE,MAAM,EACnB,cAAc,SAAK,GAClB,OAAO,CAAC,kBAAkB,CAAC;IAWxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAQhB,gBAAgB;YAkBhB,SAAS;YA4BT,UAAU;YAYV,QAAQ;CAMvB"}

package/dist/package-cache/project-session.js

@@ -0,0 +1,160 @@
+import { dirname, normalizePath } from "../fs/path.js";
+import { BrowserProjectResolver } from "./browser-resolver.js";
+const LOCK_FILE_NAME = "runmat.lock";
+/**
+ * Owns one resolved browser project and its immutable cache lease/mount table.
+ *
+ * Rust remains authoritative for lock parsing, solving, graph construction,
+ * handoff validation, and cache policy. This class only coordinates host ports
+ * and makes teardown explicit.
+ */
+export class BrowserProjectSession {
+    config;
+    resolver;
+    active = null;
+    disposed = false;
+    constructor(config) {
+        this.config = config;
+        this.resolver = new BrowserProjectResolver(config);
+    }
+    get resolution() {
+        return this.active;
+    }
+    get filesystem() {
+        return this.resolver.filesystem;
+    }
+    get cacheLeaseError() {
+        return this.resolver.cacheLeaseError;
+    }
+    async resolve(request) {
+        if (this.disposed) {
+            throw new Error("Browser project session has been disposed");
+        }
+        if (this.active) {
+            throw new Error("Dispose the active browser project before resolving another project");
+        }
+        const lockPath = request.lockPath === undefined
+            ? normalizePath(`${dirname(request.manifestPath)}/${LOCK_FILE_NAME}`)
+            : request.lockPath;
+        const existingLock = request.existingLock ??
+            (lockPath === null ? undefined : await this.readExistingLock(lockPath));
+        const project = await this.resolver.resolve({
+            manifestPath: request.manifestPath,
+            existingLock,
+            options: request.options
+        });
+        try {
+            const handoff = await this.config.native.handoffFromFrozenProject(project.frozen);
+            await this.config.session.setFsProvider?.(this.resolver.filesystem);
+            const revision = await this.config.session.installProjectHandoff(handoff);
+            const lockWritten = lockPath !== null && project.lock_decision === "write-generated"
+                ? await this.writeLock(lockPath, project.lock)
+                : false;
+            this.active = {
+                project,
+                handoff,
+                revision,
+                lockPath,
+                lockWritten
+            };
+            return this.active;
+        }
+        catch (error) {
+            this.disposed = true;
+            await this.rollback().catch(() => { });
+            throw error;
+        }
+    }
+    async sourceRevision() {
+        return this.config.session.projectRevision();
+    }
+    async cacheStatus() {
+        return this.config.native.packageCacheStatus(this.config.packageCache);
+    }
+    async collectCache(targetBytes, retainRecentMs = 0n) {
+        if (targetBytes < 0n || retainRecentMs < 0n) {
+            throw new Error("Browser package cache GC values must be non-negative");
+        }
+        return this.config.native.packageCacheGc(this.config.packageCache, targetBytes, retainRecentMs);
+    }
+    async dispose() {
+        if (this.disposed) {
+            return;
+        }
+        this.disposed = true;
+        await this.rollback();
+    }
+    async readExistingLock(lockPath) {
+        try {
+            const metadata = await this.config.filesystem.metadata(lockPath);
+            if (metadata.fileType !== "file") {
+                throw new Error(`Project lock path is not a file: ${lockPath}`);
+            }
+        }
+        catch (error) {
+            if (isNotFound(error)) {
+                return undefined;
+            }
+            throw error;
+        }
+        const bytes = await this.config.filesystem.readFile(lockPath);
+        return this.config.native.decodePackageLock(new TextDecoder("utf-8", { fatal: true }).decode(normalizeBytes(bytes)));
+    }
+    async writeLock(lockPath, lock) {
+        const bytes = new TextEncoder().encode(await this.config.native.encodePackageLock(lock));
+        const exists = await this.pathExists(lockPath);
+        if (exists || !this.config.filesystem.rename) {
+            await this.config.filesystem.writeFile(lockPath, bytes);
+            return true;
+        }
+        const suffix = globalThis.crypto?.randomUUID?.() ??
+            `${Date.now()}-${Math.floor(Math.random() * Number.MAX_SAFE_INTEGER)}`;
+        const temporaryPath = `${lockPath}.runmat-${suffix}.tmp`;
+        await this.config.filesystem.writeFile(temporaryPath, bytes);
+        try {
+            await this.config.filesystem.rename(temporaryPath, lockPath);
+        }
+        catch (error) {
+            try {
+                await this.config.filesystem.removeFile(temporaryPath);
+            }
+            catch {
+                // Preserve the atomic rename failure; a best-effort temp cleanup is secondary.
+            }
+            throw error;
+        }
+        return true;
+    }
+    async pathExists(path) {
+        try {
+            await this.config.filesystem.metadata(path);
+            return true;
+        }
+        catch (error) {
+            if (isNotFound(error)) {
+                return false;
+            }
+            throw error;
+        }
+    }
+    async rollback() {
+        this.active = null;
+        await this.config.session.clearProjectHandoff().catch(() => { });
+        await this.config.session.setFsProvider?.(this.config.filesystem);
+        await this.resolver.dispose();
+    }
+}
+function normalizeBytes(value) {
+    return value instanceof Uint8Array ? value : new Uint8Array(value);
+}
+function isNotFound(error) {
+    if (typeof error === "object" && error !== null && "code" in error) {
+        if (error.code === "ENOENT") {
+            return true;
+        }
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    const normalized = message.toLowerCase();
+    return normalized.includes("not found") || normalized.includes("(404)");
+}
+//# sourceMappingURL=project-session.js.map

package/dist/package-cache/project-session.js.map

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

package/dist/package-cache/provider-types.d.ts

@@ -0,0 +1,58 @@
+export type PackageCacheRevision = number | bigint;
+export interface PackageCacheSnapshot {
+    revision: PackageCacheRevision;
+    state: unknown;
+}
+export interface PackageCacheObjectWrite {
+    object: unknown;
+    bytes?: number[] | Uint8Array | null;
+}
+export interface PackageCacheTransaction {
+    expected_revision: PackageCacheRevision;
+    next_state: unknown;
+    writes: Record<string, PackageCacheObjectWrite> | Map<string, PackageCacheObjectWrite>;
+    deletes: string[] | Set<string>;
+}
+export type PackageCacheCommitOutcome = {
+    outcome: "committed";
+    revision: PackageCacheRevision;
+} | {
+    outcome: "conflict";
+    actual_revision: PackageCacheRevision;
+};
+/**
+ * Storage-only port consumed by RunMat's portable Rust cache policy.
+ *
+ * Implementations atomically compare the revision and publish state plus payload changes.
+ * They do not interpret package objects, leases, pins, materialization, or GC policy.
+ */
+export interface RunMatPackageCacheProvider {
+    snapshot(): Promise<PackageCacheSnapshot | null>;
+    initialize(initial: PackageCacheSnapshot): Promise<PackageCacheSnapshot>;
+    commit(transaction: PackageCacheTransaction): Promise<PackageCacheCommitOutcome>;
+    readObjectBytes(digest: string): Promise<Uint8Array | null>;
+}
+export interface PackageCacheStatus {
+    schema_version: number;
+    object_count: number | bigint;
+    objects_by_kind: Record<"blob" | "tree" | "source-index", number | bigint>;
+    logical_bytes: number | bigint;
+    stored_payload_bytes: number | bigint;
+    pin_count: number | bigint;
+    lease_count: number | bigint;
+    corruption_count: number | bigint;
+    materialization_count: number | bigint;
+}
+export interface PackageCacheGcPlan {
+    delete: string[];
+    reclaim_bytes: number | bigint;
+}
+export interface PackageCacheLease {
+    id: string;
+    owner: string;
+    objects: string[];
+    acquired_at_ms: number | bigint;
+    expires_at_ms: number | bigint;
+    generation: number | bigint;
+}
+//# sourceMappingURL=provider-types.d.ts.map

package/dist/package-cache/provider-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-types.d.ts","sourceRoot":"","sources":["../../src/package-cache/provider-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,UAAU,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,uBAAuB;IACtC,iBAAiB,EAAE,oBAAoB,CAAC;IACxC,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IACvF,OAAO,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,MAAM,yBAAyB,GACjC;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,oBAAoB,CAAA;CAAE,GACxD;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,eAAe,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,IAAI,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IACjD,UAAU,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACzE,MAAM,CAAC,WAAW,EAAE,uBAAuB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACjF,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAC3E,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,oBAAoB,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,qBAAqB,EAAE,MAAM,GAAG,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B"}

package/dist/package-cache/provider-types.js

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

package/dist/package-cache/provider-types.js.map

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

package/dist/package-cache/registry.d.ts

@@ -0,0 +1,30 @@
+import { type BrowserPrivatePackageKeyProvider } from "./private-artifact.js";
+export interface RegistryCandidatePlan {
+    source_registry: string;
+    index: string;
+    package: string;
+    allow_network: boolean;
+}
+export interface RegistryAcquisitionPlan extends RegistryCandidatePlan {
+    requirement: string;
+    expected?: {
+        release: string;
+    };
+    lock_action: "preserve" | "write" | "replace";
+}
+export interface BrowserRegistryOptions {
+    authenticatedOrigin?: string;
+    authToken?: string | (() => string | null | Promise<string | null>);
+    fetch?: typeof globalThis.fetch;
+    signal?: AbortSignal;
+    maxArtifactBytes?: number;
+    privatePackageKeys?: BrowserPrivatePackageKeyProvider;
+}
+export interface RegistryReleaseTransfer {
+    release: unknown;
+    artifactBytes: Uint8Array;
+    privateArtifact?: boolean;
+}
+export declare function fetchRegistryCandidates(plan: RegistryCandidatePlan, options?: BrowserRegistryOptions): Promise<unknown>;
+export declare function fetchRegistryRelease(plan: RegistryAcquisitionPlan, options?: BrowserRegistryOptions): Promise<RegistryReleaseTransfer>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/package-cache/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/package-cache/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,uBAAuB,CAAC;AAK/B,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,uBAAwB,SAAQ,qBAAqB;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,WAAW,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,sBAAsB;IACrC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IACpE,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,gCAAgC,CAAC;CACvD;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,UAAU,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,qBAAqB,EAC3B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,OAAO,CAAC,CAkBlB;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,uBAAuB,EAC7B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,uBAAuB,CAAC,CA6DlC"}

package/dist/package-cache/registry.js

@@ -0,0 +1,229 @@
+import { decryptRegistryPrivateArtifact } from "./private-artifact.js";
+const METADATA_LIMIT_BYTES = 4 * 1024 * 1024;
+const DEFAULT_ARTIFACT_LIMIT_BYTES = 512 * 1024 * 1024;
+export async function fetchRegistryCandidates(plan, options = {}) {
+    if (!plan.allow_network) {
+        throw new Error("registry candidate network access is disabled");
+    }
+    const index = normalizeIndex(plan.index);
+    const { namespace, name } = parsePackage(plan.package);
+    return fetchJson(endpoint(index, [
+        "v1",
+        "packages",
+        "registry",
+        namespace,
+        name,
+        "candidates"
+    ]), index, options);
+}
+export async function fetchRegistryRelease(plan, options = {}) {
+    if (!plan.allow_network) {
+        throw new Error("registry release network access is disabled");
+    }
+    const index = normalizeIndex(plan.index);
+    const releaseUrl = plan.expected
+        ? endpoint(index, [
+            "v1",
+            "packages",
+            "registry",
+            "releases",
+            plan.expected.release
+        ])
+        : (() => {
+            const { namespace, name } = parsePackage(plan.package);
+            const url = endpoint(index, [
+                "v1",
+                "packages",
+                "registry",
+                namespace,
+                name,
+                "resolve"
+            ]);
+            url.searchParams.set("requirement", plan.requirement);
+            return url;
+        })();
+    const release = await fetchJson(releaseUrl, index, options);
+    const artifact = releaseArtifact(release);
+    const limit = options.maxArtifactBytes ?? DEFAULT_ARTIFACT_LIMIT_BYTES;
+    if (!Number.isSafeInteger(limit) || limit <= 0) {
+        throw new Error("registry artifact byte limit must be a positive safe integer");
+    }
+    if (!Number.isSafeInteger(artifact.byteLen) || artifact.byteLen < 0) {
+        throw new Error("registry release contains an invalid artifact length");
+    }
+    if (artifact.byteLen > limit) {
+        throw new Error(`registry artifact exceeds the ${limit}-byte browser limit`);
+    }
+    const artifactUrl = sameOriginArtifactUrl(index, artifact.downloadUrl);
+    const response = await request(artifactUrl, index, options);
+    if (!response.ok) {
+        throw new Error(`registry artifact request failed with HTTP ${response.status}`);
+    }
+    const bytes = await readBounded(response, limit, artifact.byteLen);
+    if (releaseEncryption(release)) {
+        if (!options.privatePackageKeys) {
+            bytes.fill(0);
+            throw new Error("private registry package key access is not configured");
+        }
+        try {
+            const plaintext = await decryptRegistryPrivateArtifact(release, bytes, options.privatePackageKeys);
+            return { release, artifactBytes: plaintext, privateArtifact: true };
+        }
+        finally {
+            bytes.fill(0);
+        }
+    }
+    return { release, artifactBytes: bytes };
+}
+function releaseEncryption(value) {
+    if (!value || typeof value !== "object")
+        return null;
+    return value.encryption ?? null;
+}
+async function fetchJson(url, index, options) {
+    const response = await request(url, index, options);
+    if (!response.ok) {
+        throw new Error(`registry metadata request failed with HTTP ${response.status}`);
+    }
+    const bytes = await readBounded(response, METADATA_LIMIT_BYTES);
+    let value;
+    try {
+        value = JSON.parse(new TextDecoder().decode(bytes));
+    }
+    catch {
+        throw new Error("registry returned invalid JSON metadata");
+    }
+    if (!value || typeof value !== "object") {
+        throw new Error("registry returned an invalid metadata payload");
+    }
+    return value;
+}
+async function request(url, index, options) {
+    const fetcher = options.fetch ?? globalThis.fetch;
+    if (typeof fetcher !== "function") {
+        throw new Error("fetch API is unavailable for registry requests");
+    }
+    const trusted = options.authenticatedOrigin
+        ? normalizeIndex(options.authenticatedOrigin)
+        : null;
+    const token = trusted?.origin === index.origin
+        ? typeof options.authToken === "function"
+            ? await options.authToken()
+            : options.authToken
+        : null;
+    const headers = {};
+    if (token)
+        headers.authorization = `Bearer ${token}`;
+    return fetcher(url, {
+        method: "GET",
+        headers,
+        cache: "no-store",
+        credentials: "omit",
+        redirect: "manual",
+        signal: options.signal
+    });
+}
+async function readBounded(response, limit, expectedLength) {
+    const declared = response.headers.get("content-length");
+    if (declared !== null) {
+        const length = Number(declared);
+        if (!Number.isSafeInteger(length) || length < 0 || length > limit) {
+            throw new Error(`registry response exceeds the ${limit}-byte transfer limit`);
+        }
+        if (expectedLength !== undefined && length !== expectedLength) {
+            throw new Error("registry artifact length differs from signed metadata");
+        }
+    }
+    if (!response.body) {
+        const bytes = new Uint8Array(await response.arrayBuffer());
+        validateLength(bytes.byteLength, limit, expectedLength);
+        return bytes;
+    }
+    const reader = response.body.getReader();
+    const chunks = [];
+    let length = 0;
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            length += value.byteLength;
+            validateLength(length, limit);
+            chunks.push(value);
+        }
+    }
+    catch (error) {
+        await reader.cancel().catch(() => { });
+        throw error;
+    }
+    validateLength(length, limit, expectedLength);
+    const bytes = new Uint8Array(length);
+    let offset = 0;
+    for (const chunk of chunks) {
+        bytes.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return bytes;
+}
+function validateLength(length, limit, expectedLength) {
+    if (length > limit) {
+        throw new Error(`registry response exceeds the ${limit}-byte transfer limit`);
+    }
+    if (expectedLength !== undefined && length !== expectedLength) {
+        throw new Error("registry artifact length differs from signed metadata");
+    }
+}
+function normalizeIndex(value) {
+    const url = new URL(value);
+    if (url.protocol !== "https:" ||
+        url.username ||
+        url.password ||
+        url.search ||
+        url.hash) {
+        throw new Error("registry index must be a credential-free HTTPS URL");
+    }
+    url.pathname = url.pathname.replace(/\/+$/, "");
+    return url;
+}
+function endpoint(index, segments) {
+    const url = new URL(index);
+    const base = url.pathname.replace(/\/+$/, "");
+    url.pathname = `${base}/${segments.map(encodeURIComponent).join("/")}`;
+    return url;
+}
+function sameOriginArtifactUrl(index, value) {
+    if (!value.startsWith("/") || value.startsWith("//")) {
+        throw new Error("registry returned an unsafe artifact URL");
+    }
+    const url = new URL(value, index);
+    if (url.origin !== index.origin ||
+        url.username ||
+        url.password ||
+        url.hash) {
+        throw new Error("registry returned an unsafe artifact URL");
+    }
+    return url;
+}
+function parsePackage(value) {
+    const colon = value.indexOf(":");
+    const slash = value.indexOf("/", colon + 1);
+    if (colon <= 0 || slash <= colon + 1 || value.indexOf("/", slash + 1) !== -1) {
+        throw new Error("registry plan contains an invalid canonical package ID");
+    }
+    return {
+        namespace: value.slice(colon + 1, slash),
+        name: value.slice(slash + 1)
+    };
+}
+function releaseArtifact(value) {
+    const artifact = value.artifact;
+    if (!artifact || typeof artifact !== "object") {
+        throw new Error("registry release is missing artifact metadata");
+    }
+    const { byteLen, downloadUrl } = artifact;
+    if (typeof byteLen !== "number" || typeof downloadUrl !== "string") {
+        throw new Error("registry release contains invalid artifact metadata");
+    }
+    return { byteLen, downloadUrl };
+}
+//# sourceMappingURL=registry.js.map

package/dist/package-cache/registry.js.map

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

package/dist/package-cache/server-project.d.ts

@@ -0,0 +1,54 @@
+export interface ServerProjectAcquisitionPlan {
+    service: string;
+    project: string;
+    selector: {
+        kind: "exact" | "tag";
+        value: string;
+    };
+    allow_network: boolean;
+    expected?: {
+        service: string;
+        project: string;
+        snapshot: string;
+        tree_digest: string;
+    };
+    lock_action: "preserve" | "write" | "replace";
+}
+export interface ServerProjectTreeInventoryWire {
+    project: string;
+    snapshot: string;
+    treeDigest: string;
+    entries: Array<{
+        path: string;
+        kind: "file" | "directory";
+        bytes?: string;
+        executable?: boolean;
+    }>;
+}
+export interface ServerProjectSnapshotOptions {
+    authenticatedOrigin?: string;
+    authToken?: string | (() => string | null | Promise<string | null>);
+    fetch?: typeof globalThis.fetch;
+    signal?: AbortSignal;
+    etag?: string;
+    range?: {
+        start: number;
+        end?: number;
+    };
+}
+export type ServerProjectSnapshotFetchOutcome = {
+    kind: "snapshot";
+    inventory: ServerProjectTreeInventoryWire;
+    etag?: string;
+} | {
+    kind: "not-modified";
+    etag?: string;
+} | {
+    kind: "partial";
+    bytes: Uint8Array;
+    contentRange: string;
+    etag?: string;
+};
+export declare function fetchServerProjectSnapshot(plan: ServerProjectAcquisitionPlan, options?: ServerProjectSnapshotOptions): Promise<ServerProjectTreeInventoryWire>;
+export declare function fetchServerProjectSnapshotResponse(plan: ServerProjectAcquisitionPlan, options?: ServerProjectSnapshotOptions): Promise<ServerProjectSnapshotFetchOutcome>;
+//# sourceMappingURL=server-project.d.ts.map

package/dist/package-cache/server-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-project.d.ts","sourceRoot":"","sources":["../../src/package-cache/server-project.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QAAE,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,WAAW,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,4BAA4B;IAC3C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IACpE,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC;AAED,MAAM,MAAM,iCAAiC,GACzC;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,8BAA8B,CAAC;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEN,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,4BAA4B,EAClC,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,8BAA8B,CAAC,CAQzC;AAED,wBAAsB,kCAAkC,CACtD,IAAI,EAAE,4BAA4B,EAClC,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,iCAAiC,CAAC,CA4E5C"}