runmat 0.6.1-dev.1 → 0.6.2-dev.0

package/dist/package-cache/browser-resolver.d.ts

@@ -0,0 +1,83 @@
+import type { RunMatFilesystemProvider } from "../fs/provider-types.js";
+import type { GitAcquisitionIntent, GitAcquisitionPlan, GitAcquisitionPolicy, GitSnapshotWire, ServerGitGatewayOptions } from "./git-gateway.js";
+import type { ServerProjectAcquisitionPlan, ServerProjectSnapshotOptions } from "./server-project.js";
+import type { BrowserRegistryOptions, RegistryAcquisitionPlan, RegistryCandidatePlan } from "./registry.js";
+import { BrowserPackageMountFilesystem } from "./mount.js";
+import type { RunMatPackageCacheProvider } from "./provider-types.js";
+import type { PackageCacheLease } from "./provider-types.js";
+export interface BrowserProjectResolveOptions {
+    target: string;
+    default_server_origin: string;
+    default_registry_index: string;
+    groups: Array<"runtime" | "development" | "test">;
+    root_features: string[];
+    host_capabilities: string[];
+    source_intent: GitAcquisitionIntent;
+    source_policy: GitAcquisitionPolicy;
+}
+export interface BrowserProjectResolveRequest {
+    manifestPath: string;
+    existingLock?: unknown;
+    options: BrowserProjectResolveOptions;
+}
+export interface BrowserResolvedProject {
+    frozen: unknown;
+    lock: unknown;
+    lock_decision: "use-existing" | "write-generated";
+    acquired_git_sources: unknown[];
+    acquired_server_sources: unknown[];
+    acquired_registry_sources: unknown[];
+    source_inventories: unknown[];
+}
+interface BrowserResolveWireResult extends BrowserResolvedProject {
+    cache_lease?: PackageCacheLease | null;
+}
+export interface BrowserProjectResolverNative {
+    resolveProject(request: BrowserProjectResolveRequest, provider: {
+        packageCache: RunMatPackageCacheProvider;
+        leaseOwner: string;
+        fetchGitInventory(plan: GitAcquisitionPlan): Promise<unknown>;
+        fetchServerSnapshot(plan: ServerProjectAcquisitionPlan): Promise<unknown>;
+        fetchRegistryCandidates(plan: RegistryCandidatePlan): Promise<unknown>;
+        fetchRegistryRelease(plan: RegistryAcquisitionPlan): Promise<unknown>;
+        mountPackageSnapshot(snapshot: GitSnapshotWire): string;
+        mountPrivatePackageSnapshot(snapshot: GitSnapshotWire): string;
+    }, filesystem: RunMatFilesystemProvider): Promise<BrowserResolveWireResult>;
+    packageCacheRenewLease(provider: RunMatPackageCacheProvider, lease: PackageCacheLease, ttlMs: bigint): Promise<PackageCacheLease>;
+    packageCacheReleaseLease(provider: RunMatPackageCacheProvider, lease: PackageCacheLease): Promise<void>;
+}
+export interface BrowserProjectResolverConfig {
+    native: BrowserProjectResolverNative;
+    filesystem: RunMatFilesystemProvider;
+    packageCache: RunMatPackageCacheProvider;
+    gitGateway: ServerGitGatewayOptions;
+    serverSnapshots?: ServerProjectSnapshotOptions;
+    registry?: BrowserRegistryOptions;
+}
+/**
+ * Browser composition root for the portable Rust package resolver.
+ *
+ * JavaScript supplies storage, authenticated transport, and immutable mount mechanics;
+ * selector/lock/network policy, snapshot verification, CAS publication, graph building,
+ * and lock reconciliation remain in Rust.
+ */
+export declare class BrowserProjectResolver {
+    private readonly config;
+    readonly filesystem: BrowserPackageMountFilesystem;
+    private readonly leaseOwner;
+    private cacheLease;
+    private renewalTimer;
+    private renewalInFlight;
+    private resolving;
+    private disposed;
+    private leaseFailure;
+    private readonly unsubscribePrivateArtifactInvalidation;
+    constructor(config: BrowserProjectResolverConfig);
+    resolve(request: BrowserProjectResolveRequest): Promise<BrowserResolvedProject>;
+    get cacheLeaseError(): unknown;
+    dispose(): Promise<void>;
+    private startRenewal;
+    private renewLease;
+}
+export {};
+//# sourceMappingURL=browser-resolver.d.ts.map

package/dist/package-cache/browser-resolver.d.ts.map

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

package/dist/package-cache/browser-resolver.js

@@ -0,0 +1,120 @@
+import { fetchGitTreeInventoryWire } from "./git-gateway.js";
+import { fetchServerProjectSnapshot } from "./server-project.js";
+import { fetchRegistryCandidates, fetchRegistryRelease } from "./registry.js";
+import { BrowserPackageMountFilesystem } from "./mount.js";
+import { subscribePrivateArtifactInvalidation } from "./private-artifact-lifecycle.js";
+const LEASE_TTL_MS = 120000n;
+const LEASE_RENEW_MS = 40_000;
+let nextResolverOwner = 1;
+/**
+ * Browser composition root for the portable Rust package resolver.
+ *
+ * JavaScript supplies storage, authenticated transport, and immutable mount mechanics;
+ * selector/lock/network policy, snapshot verification, CAS publication, graph building,
+ * and lock reconciliation remain in Rust.
+ */
+export class BrowserProjectResolver {
+    config;
+    filesystem;
+    leaseOwner = createLeaseOwner();
+    cacheLease = null;
+    renewalTimer = null;
+    renewalInFlight = null;
+    resolving = false;
+    disposed = false;
+    leaseFailure = null;
+    unsubscribePrivateArtifactInvalidation;
+    constructor(config) {
+        this.config = config;
+        this.filesystem = new BrowserPackageMountFilesystem(config.filesystem);
+        this.unsubscribePrivateArtifactInvalidation =
+            subscribePrivateArtifactInvalidation(() => this.filesystem.clear());
+    }
+    async resolve(request) {
+        if (this.disposed) {
+            throw new Error("Browser project resolver has been disposed");
+        }
+        if (this.resolving || this.cacheLease) {
+            throw new Error("Dispose the active browser project before resolving another project");
+        }
+        this.resolving = true;
+        try {
+            const { cache_lease: cacheLease, ...resolved } = await this.config.native.resolveProject(request, {
+                packageCache: this.config.packageCache,
+                leaseOwner: this.leaseOwner,
+                fetchGitInventory: (plan) => fetchGitTreeInventoryWire({
+                    repository: plan.repository,
+                    selector: plan.selector,
+                    subdir: plan.subdir
+                }, this.config.gitGateway),
+                fetchServerSnapshot: (plan) => fetchServerProjectSnapshot(plan, this.config.serverSnapshots),
+                fetchRegistryCandidates: (plan) => fetchRegistryCandidates(plan, this.config.registry),
+                fetchRegistryRelease: (plan) => fetchRegistryRelease(plan, this.config.registry),
+                mountPackageSnapshot: (snapshot) => this.filesystem.register(snapshot, this.config.packageCache),
+                mountPrivatePackageSnapshot: (snapshot) => this.filesystem.registerVolatile(snapshot)
+            }, this.filesystem);
+            this.cacheLease = cacheLease ?? null;
+            if (this.cacheLease) {
+                this.startRenewal();
+            }
+            return resolved;
+        }
+        catch (error) {
+            this.filesystem.clear();
+            throw error;
+        }
+        finally {
+            this.resolving = false;
+        }
+    }
+    get cacheLeaseError() {
+        return this.leaseFailure;
+    }
+    async dispose() {
+        if (this.disposed) {
+            return;
+        }
+        this.disposed = true;
+        this.unsubscribePrivateArtifactInvalidation();
+        if (this.renewalTimer) {
+            clearInterval(this.renewalTimer);
+            this.renewalTimer = null;
+        }
+        await this.renewalInFlight;
+        const lease = this.cacheLease;
+        this.cacheLease = null;
+        this.filesystem.clear();
+        if (lease) {
+            await this.config.native.packageCacheReleaseLease(this.config.packageCache, lease);
+        }
+    }
+    startRenewal() {
+        this.renewalTimer = setInterval(() => {
+            if (!this.renewalInFlight) {
+                this.renewalInFlight = this.renewLease().finally(() => {
+                    this.renewalInFlight = null;
+                });
+            }
+        }, LEASE_RENEW_MS);
+    }
+    async renewLease() {
+        const lease = this.cacheLease;
+        if (!lease || this.disposed) {
+            return;
+        }
+        try {
+            this.cacheLease = await this.config.native.packageCacheRenewLease(this.config.packageCache, lease, LEASE_TTL_MS);
+            this.leaseFailure = null;
+        }
+        catch (error) {
+            this.leaseFailure = error;
+        }
+    }
+}
+function createLeaseOwner() {
+    const random = globalThis.crypto?.randomUUID?.();
+    return random
+        ? `browser-${random}`
+        : `browser-${Date.now()}-${nextResolverOwner++}`;
+}
+//# sourceMappingURL=browser-resolver.js.map

package/dist/package-cache/browser-resolver.js.map

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

package/dist/package-cache/git-gateway.d.ts

@@ -0,0 +1,69 @@
+export type GitGatewaySelector = {
+    kind: "rev";
+    value: string;
+} | {
+    kind: "tag";
+    value: string;
+} | {
+    kind: "branch";
+    value: string;
+};
+export interface GitGatewayRequest {
+    repository: string;
+    selector: GitGatewaySelector;
+    subdir?: string;
+}
+export interface GitSnapshotWire {
+    source: unknown;
+    tree: unknown;
+    blobs: Array<{
+        digest: string;
+        bytes: string;
+    }>;
+}
+export type GitAcquisitionIntent = "execute" | "fetch" | "update";
+export interface GitSourceWire {
+    repository: string;
+    commit: {
+        algorithm: "sha1" | "sha256";
+        hex: string;
+    };
+    subdir: string;
+    tree_digest: string;
+}
+export interface GitAcquisitionPolicy {
+    locked?: boolean;
+    frozen?: boolean;
+    offline?: boolean;
+}
+export interface GitAcquisitionPlanRequest extends GitGatewayRequest {
+    lockedSource?: GitSourceWire;
+    intent: GitAcquisitionIntent;
+    policy?: GitAcquisitionPolicy;
+}
+export interface GitAcquisitionPlan {
+    repository: string;
+    selector: GitGatewaySelector;
+    subdir: string;
+    allow_network: boolean;
+    expected?: GitSourceWire;
+    lock_action: "preserve" | "write" | "replace";
+}
+export interface GitTreeInventoryWire {
+    commit: string;
+    entries: Array<{
+        path: string;
+        kind: "file" | "directory" | "symlink";
+        bytes?: string;
+        executable?: boolean;
+        linkTarget?: string;
+    }>;
+}
+export interface ServerGitGatewayOptions {
+    baseUrl: string;
+    authToken?: string | (() => string | null | Promise<string | null>);
+    fetch?: typeof globalThis.fetch;
+    signal?: AbortSignal;
+}
+export declare function fetchGitTreeInventoryWire(request: GitGatewayRequest, options: ServerGitGatewayOptions): Promise<GitTreeInventoryWire>;
+//# sourceMappingURL=git-gateway.d.ts.map

package/dist/package-cache/git-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-gateway.d.ts","sourceRoot":"","sources":["../../src/package-cache/git-gateway.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAElE,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE;QACN,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC;QAC7B,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAClE,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,WAAW,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;QACvC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,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;CACtB;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,oBAAoB,CAAC,CAoC/B"}

package/dist/package-cache/git-gateway.js

@@ -0,0 +1,32 @@
+export async function fetchGitTreeInventoryWire(request, options) {
+    const fetcher = options.fetch ?? globalThis.fetch;
+    if (typeof fetcher !== "function") {
+        throw new Error("fetch API is unavailable for the RunMat Git gateway");
+    }
+    const token = typeof options.authToken === "function" ? await options.authToken() : options.authToken;
+    const response = await fetcher(`${options.baseUrl.replace(/\/+$/, "")}/v1/packages/git/snapshot`, {
+        method: "POST",
+        headers: {
+            "content-type": "application/json",
+            ...(token ? { authorization: `Bearer ${token}` } : {})
+        },
+        body: JSON.stringify({
+            repository: request.repository,
+            selector: request.selector,
+            subdir: request.subdir ?? "."
+        }),
+        cache: "no-store",
+        credentials: "omit",
+        signal: options.signal
+    });
+    if (!response.ok) {
+        const detail = await response.text().catch(() => "");
+        throw new Error(`RunMat Git gateway failed with HTTP ${response.status}${detail ? `: ${detail}` : ""}`);
+    }
+    const value = await response.json();
+    if (!value || typeof value !== "object") {
+        throw new Error("RunMat Git gateway returned an invalid tree inventory payload");
+    }
+    return value;
+}
+//# sourceMappingURL=git-gateway.js.map

package/dist/package-cache/git-gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-gateway.js","sourceRoot":"","sources":["../../src/package-cache/git-gateway.ts"],"names":[],"mappings":"AAuEA,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAA0B,EAC1B,OAAgC;IAEhC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;IAClD,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,KAAK,GACT,OAAO,OAAO,CAAC,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC1F,MAAM,QAAQ,GAAG,MAAM,OAAO,CAC5B,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,2BAA2B,EACjE;QACE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvD;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,GAAG;SAC9B,CAAC;QACF,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,MAAM;QACnB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CACF,CAAC;IACF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACrD,MAAM,IAAI,KAAK,CACb,uCAAuC,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACvF,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC7C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,KAA6B,CAAC;AACvC,CAAC"}

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

@@ -0,0 +1,20 @@
+export { createIndexedDbPackageCache } from "./indexeddb.js";
+export type { IndexedDbPackageCacheHandle, IndexedDbPackageCacheOptions, PackageCacheFaultInjector } from "./indexeddb.js";
+export { ImmutableBrowserPackageMount } from "./mount.js";
+export { BrowserPackageMountFilesystem } from "./mount.js";
+export { BrowserProjectResolver } from "./browser-resolver.js";
+export type { BrowserProjectResolveOptions, BrowserProjectResolveRequest, BrowserProjectResolverConfig, BrowserProjectResolverNative, BrowserResolvedProject } from "./browser-resolver.js";
+export { BrowserProjectSession } from "./project-session.js";
+export type { BrowserProjectSessionConfig, BrowserProjectSessionHandle, BrowserProjectSessionNative, BrowserProjectSessionResolution, BrowserProjectSessionResolveRequest } from "./project-session.js";
+export type { GitAcquisitionIntent, GitAcquisitionPlan, GitAcquisitionPlanRequest, GitAcquisitionPolicy, GitGatewayRequest, GitGatewaySelector, GitSnapshotWire, GitSourceWire, GitTreeInventoryWire, ServerGitGatewayOptions } from "./git-gateway.js";
+export { fetchServerProjectSnapshot } from "./server-project.js";
+export { fetchRegistryCandidates, fetchRegistryRelease } from "./registry.js";
+export { decryptRegistryPrivateArtifact, type BrowserPrivatePackageKeyProvider, type PrivatePackageEnvelopeContext } from "./private-artifact.js";
+export { createAndRegisterBrowserRecipientKey, createBrowserPrivatePackageKeyStore, generateBrowserRecipientKey, revokeAndRemoveBrowserRecipientKey } from "./browser-private-keys.js";
+export type { BrowserRecipientKeyRegistration, BrowserPrivatePackageKeyStore, GeneratedBrowserRecipientKey, RegisterBrowserRecipientKey, RevokeBrowserRecipientKey } from "./browser-private-keys.js";
+export { invalidateBrowserPrivatePackageArtifacts } from "./private-artifact-lifecycle.js";
+export type { BrowserRegistryOptions, RegistryAcquisitionPlan, RegistryCandidatePlan, RegistryReleaseTransfer } from "./registry.js";
+export type { ServerProjectAcquisitionPlan, ServerProjectSnapshotOptions, ServerProjectTreeInventoryWire } from "./server-project.js";
+export type { BrowserMountEntry, BrowserTreeEntry, BrowserTreeManifest, GitSnapshotMountInput, PackageSnapshotMountInput } from "./mount.js";
+export type { PackageCacheCommitOutcome, PackageCacheGcPlan, PackageCacheLease, PackageCacheObjectWrite, PackageCacheRevision, PackageCacheSnapshot, PackageCacheStatus, PackageCacheTransaction, RunMatPackageCacheProvider } from "./provider-types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/package-cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC7D,YAAY,EACV,2BAA2B,EAC3B,4BAA4B,EAC5B,yBAAyB,EAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,YAAY,EACV,4BAA4B,EAC5B,4BAA4B,EAC5B,4BAA4B,EAC5B,4BAA4B,EAC5B,sBAAsB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,YAAY,EACV,2BAA2B,EAC3B,2BAA2B,EAC3B,2BAA2B,EAC3B,+BAA+B,EAC/B,mCAAmC,EACpC,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,8BAA8B,EAC9B,KAAK,gCAAgC,EACrC,KAAK,6BAA6B,EACnC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,oCAAoC,EACpC,mCAAmC,EACnC,2BAA2B,EAC3B,kCAAkC,EACnC,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,+BAA+B,EAC/B,6BAA6B,EAC7B,4BAA4B,EAC5B,2BAA2B,EAC3B,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,wCAAwC,EAAE,MAAM,iCAAiC,CAAC;AAC3F,YAAY,EACV,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,4BAA4B,EAC5B,4BAA4B,EAC5B,8BAA8B,EAC/B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,yBAAyB,EACzB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,qBAAqB,CAAC"}

package/dist/package-cache/index.js

@@ -0,0 +1,11 @@
+export { createIndexedDbPackageCache } from "./indexeddb.js";
+export { ImmutableBrowserPackageMount } from "./mount.js";
+export { BrowserPackageMountFilesystem } from "./mount.js";
+export { BrowserProjectResolver } from "./browser-resolver.js";
+export { BrowserProjectSession } from "./project-session.js";
+export { fetchServerProjectSnapshot } from "./server-project.js";
+export { fetchRegistryCandidates, fetchRegistryRelease } from "./registry.js";
+export { decryptRegistryPrivateArtifact } from "./private-artifact.js";
+export { createAndRegisterBrowserRecipientKey, createBrowserPrivatePackageKeyStore, generateBrowserRecipientKey, revokeAndRemoveBrowserRecipientKey } from "./browser-private-keys.js";
+export { invalidateBrowserPrivatePackageArtifacts } from "./private-artifact-lifecycle.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/package-cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAM7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAQ/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAoB7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,8BAA8B,EAG/B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,oCAAoC,EACpC,mCAAmC,EACnC,2BAA2B,EAC3B,kCAAkC,EACnC,MAAM,2BAA2B,CAAC;AAQnC,OAAO,EAAE,wCAAwC,EAAE,MAAM,iCAAiC,CAAC"}

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

@@ -0,0 +1,17 @@
+import type { RunMatPackageCacheProvider } from "./provider-types.js";
+export interface IndexedDbPackageCacheOptions {
+    dbName?: string;
+    version?: number;
+    requestPersistence?: boolean;
+    faultInjector?: PackageCacheFaultInjector;
+}
+export interface PackageCacheFaultInjector {
+    beforeApply?(transaction: IDBTransaction): void;
+}
+export interface IndexedDbPackageCacheHandle {
+    provider: RunMatPackageCacheProvider;
+    persistenceGranted: boolean | null;
+    close(): void;
+}
+export declare function createIndexedDbPackageCache(options?: IndexedDbPackageCacheOptions): Promise<IndexedDbPackageCacheHandle>;
+//# sourceMappingURL=indexeddb.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"indexeddb.d.ts","sourceRoot":"","sources":["../../src/package-cache/indexeddb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,0BAA0B,EAC3B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,4BAA4B;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,aAAa,CAAC,EAAE,yBAAyB,CAAC;CAC3C;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,CAAC,CAAC,WAAW,EAAE,cAAc,GAAG,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,0BAA0B,CAAC;IACrC,kBAAkB,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,KAAK,IAAI,IAAI,CAAC;CACf;AAiBD,wBAAsB,2BAA2B,CAC/C,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,2BAA2B,CAAC,CAiBtC"}

package/dist/package-cache/indexeddb.js

@@ -0,0 +1,217 @@
+const DEFAULT_DB_NAME = "runmat-package-cache";
+const DEFAULT_VERSION = 1;
+const META_STORE = "meta";
+const PAYLOAD_STORE = "payloads";
+const STATE_KEY = "state";
+export async function createIndexedDbPackageCache(options = {}) {
+    if (typeof indexedDB === "undefined") {
+        throw new Error("indexedDB API is unavailable in this environment");
+    }
+    const db = await openDatabase(indexedDB, options.dbName ?? DEFAULT_DB_NAME, options.version ?? DEFAULT_VERSION);
+    const persistenceGranted = options.requestPersistence
+        ? await requestPersistentStorage()
+        : null;
+    return {
+        provider: new IndexedDbPackageCacheProvider(db, options.faultInjector),
+        persistenceGranted,
+        close: () => db.close()
+    };
+}
+class IndexedDbPackageCacheProvider {
+    db;
+    faultInjector;
+    constructor(db, faultInjector) {
+        this.db = db;
+        this.faultInjector = faultInjector;
+    }
+    snapshot() {
+        return new Promise((resolve, reject) => {
+            const transaction = this.db.transaction(META_STORE, "readonly");
+            const request = transaction.objectStore(META_STORE).get(STATE_KEY);
+            request.onsuccess = () => {
+                const record = request.result;
+                resolve(record ? cloneSnapshot(record) : null);
+            };
+            rejectOnRequest(request, reject, "Failed to read package cache state");
+            rejectOnTransaction(transaction, reject, "Package cache snapshot transaction failed");
+        });
+    }
+    initialize(initial) {
+        return new Promise((resolve, reject) => {
+            const transaction = this.db.transaction(META_STORE, "readwrite");
+            const store = transaction.objectStore(META_STORE);
+            const read = store.get(STATE_KEY);
+            let result = null;
+            read.onsuccess = () => {
+                const existing = read.result;
+                if (existing) {
+                    result = cloneSnapshot(existing);
+                    return;
+                }
+                const record = {
+                    key: STATE_KEY,
+                    revision: initial.revision,
+                    state: structuredClone(initial.state)
+                };
+                store.add(record);
+                result = cloneSnapshot(record);
+            };
+            rejectOnRequest(read, reject, "Failed to initialize package cache state");
+            transaction.oncomplete = () => {
+                if (!result) {
+                    reject(new Error("Package cache initialization completed without state"));
+                }
+                else {
+                    resolve(result);
+                }
+            };
+            rejectOnTransaction(transaction, reject, "Package cache initialization failed");
+        });
+    }
+    commit(input) {
+        return new Promise((resolve, reject) => {
+            const transaction = this.db.transaction([META_STORE, PAYLOAD_STORE], "readwrite");
+            const stateStore = transaction.objectStore(META_STORE);
+            const payloadStore = transaction.objectStore(PAYLOAD_STORE);
+            const read = stateStore.get(STATE_KEY);
+            let outcome = null;
+            read.onsuccess = () => {
+                const current = read.result;
+                if (!current) {
+                    transaction.abort();
+                    reject(new Error("Package cache must be initialized before commit"));
+                    return;
+                }
+                if (!revisionEquals(current.revision, input.expected_revision)) {
+                    outcome = {
+                        outcome: "conflict",
+                        actual_revision: current.revision
+                    };
+                    return;
+                }
+                try {
+                    this.faultInjector?.beforeApply?.(transaction);
+                    for (const digest of normalizeDeletes(input.deletes)) {
+                        payloadStore.delete(digest);
+                    }
+                    for (const [digest, write] of normalizeWrites(input.writes)) {
+                        const bytes = normalizeBytes(write);
+                        if (bytes) {
+                            const copy = bytes.slice();
+                            payloadStore.put({
+                                digest,
+                                bytes: copy.buffer
+                            });
+                        }
+                        else {
+                            payloadStore.delete(digest);
+                        }
+                    }
+                    const revision = incrementRevision(current.revision);
+                    stateStore.put({
+                        key: STATE_KEY,
+                        revision,
+                        state: structuredClone(input.next_state)
+                    });
+                    outcome = { outcome: "committed", revision };
+                }
+                catch (error) {
+                    transaction.abort();
+                    reject(error);
+                }
+            };
+            rejectOnRequest(read, reject, "Failed to read package cache commit revision");
+            transaction.oncomplete = () => {
+                if (!outcome) {
+                    reject(new Error("Package cache commit completed without an outcome"));
+                }
+                else {
+                    resolve(outcome);
+                }
+            };
+            rejectOnTransaction(transaction, reject, "Package cache commit failed");
+        });
+    }
+    readObjectBytes(digest) {
+        return new Promise((resolve, reject) => {
+            const transaction = this.db.transaction(PAYLOAD_STORE, "readonly");
+            const request = transaction.objectStore(PAYLOAD_STORE).get(digest);
+            request.onsuccess = () => {
+                const record = request.result;
+                resolve(record ? new Uint8Array(record.bytes.slice(0)) : null);
+            };
+            rejectOnRequest(request, reject, "Failed to read package cache payload");
+            rejectOnTransaction(transaction, reject, "Package cache payload transaction failed");
+        });
+    }
+}
+function openDatabase(factory, name, version) {
+    return new Promise((resolve, reject) => {
+        const request = factory.open(name, version);
+        request.onupgradeneeded = () => {
+            const db = request.result;
+            if (!db.objectStoreNames.contains(META_STORE)) {
+                db.createObjectStore(META_STORE, { keyPath: "key" });
+            }
+            if (!db.objectStoreNames.contains(PAYLOAD_STORE)) {
+                db.createObjectStore(PAYLOAD_STORE, { keyPath: "digest" });
+            }
+        };
+        request.onsuccess = () => {
+            const db = request.result;
+            db.onversionchange = () => db.close();
+            resolve(db);
+        };
+        request.onerror = () => reject(request.error ?? new Error("Failed to open package cache database"));
+        request.onblocked = () => reject(new Error("Package cache database upgrade was blocked by another connection"));
+    });
+}
+async function requestPersistentStorage() {
+    if (typeof navigator === "undefined") {
+        return false;
+    }
+    try {
+        return (await navigator.storage?.persist?.()) ?? false;
+    }
+    catch {
+        return false;
+    }
+}
+function normalizeWrites(writes) {
+    return writes instanceof Map ? Array.from(writes.entries()) : Object.entries(writes);
+}
+function normalizeDeletes(deletes) {
+    return deletes instanceof Set ? Array.from(deletes) : deletes;
+}
+function normalizeBytes(write) {
+    if (write.bytes === null || write.bytes === undefined) {
+        return null;
+    }
+    return write.bytes instanceof Uint8Array ? write.bytes : Uint8Array.from(write.bytes);
+}
+function cloneSnapshot(snapshot) {
+    return {
+        revision: snapshot.revision,
+        state: structuredClone(snapshot.state)
+    };
+}
+function revisionEquals(left, right) {
+    return BigInt(left) === BigInt(right);
+}
+function incrementRevision(revision) {
+    if (typeof revision === "bigint") {
+        return revision + 1n;
+    }
+    if (!Number.isSafeInteger(revision) || revision < 0 || revision === Number.MAX_SAFE_INTEGER) {
+        throw new Error("Package cache revision is outside JavaScript's safe integer range");
+    }
+    return revision + 1;
+}
+function rejectOnRequest(request, reject, message) {
+    request.onerror = () => reject(request.error ?? new Error(message));
+}
+function rejectOnTransaction(transaction, reject, message) {
+    transaction.onerror = () => reject(transaction.error ?? new Error(message));
+    transaction.onabort = () => reject(transaction.error ?? new Error(message));
+}
+//# sourceMappingURL=indexeddb.js.map

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

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