@relayfile/sdk 0.10.32 → 0.10.33

package/dist/setup.d.ts

@@ -42,6 +42,7 @@ export declare class RelayfileSetup {
     private readonly accessToken?;
     private readonly requestTimeoutMs;
     private readonly retryOptions;
+    private readonly ensuredMounts;
     static login(options?: RelayfileCloudLoginOptions): Promise<RelayfileSetup>;
     static fromCloudTokens(tokens: RelayfileCloudTokenSet, options?: RelayfileCloudTokenSetupOptions): RelayfileSetup;
     constructor(options?: RelayfileSetupOptions);
@@ -49,6 +50,7 @@ export declare class RelayfileSetup {
     joinWorkspace(workspaceId: string, options?: JoinWorkspaceOptions): Promise<WorkspaceHandle>;
     mountWorkspace(input: MountWorkspaceInput): Promise<MountedWorkspaceHandle>;
     ensureMountedWorkspace(input: EnsureMountedWorkspaceInput): Promise<MountedWorkspaceHandle>;
+    private startEnsuredMount;
     joinWorkspaceResponse(workspaceId: string, options: NormalizedJoinWorkspaceOptions, overrides?: {
         tokenProvider?: AccessTokenProvider;
     }): Promise<ValidatedJoinWorkspaceResponse>;

package/dist/setup.js

@@ -32,6 +32,7 @@ export class RelayfileSetup {
     accessToken;
     requestTimeoutMs;
     retryOptions;
+    ensuredMounts = new Map();
     static async login(options = {}) {
         void options;
         throw new RelayfileSetupError("RelayfileSetup.login() starts a local HTTP callback server and is only available from @relayfile/sdk/cli. Import RelayfileSetup from @relayfile/sdk/cli for interactive Cloud login.", "node_only_sdk_feature");
@@ -136,6 +137,35 @@ export class RelayfileSetup {
     async ensureMountedWorkspace(input) {
         const normalized = normalizeEnsureMountedWorkspaceInput(input);
         const workspace = await this.resolveWorkspaceForMount(normalized);
+        throwIfAborted(normalized.signal, "ensureMountedWorkspace");
+        const mountKey = ensuredMountKey(workspace, normalized);
+        const existing = this.ensuredMounts.get(mountKey);
+        if (existing) {
+            return waitForEnsuredMount(existing, normalized.signal);
+        }
+        let shared;
+        // The physical mount belongs to the logical target, not the first caller.
+        // Individual abort signals only cancel that caller's wait below.
+        shared = this.startEnsuredMount(workspace, {
+            ...normalized,
+            signal: undefined
+        }).then((mounted) => new SharedMountedWorkspaceHandle({
+            mounted,
+            onStopped: () => {
+                if (this.ensuredMounts.get(mountKey) === shared) {
+                    this.ensuredMounts.delete(mountKey);
+                }
+            }
+        }));
+        this.ensuredMounts.set(mountKey, shared);
+        void shared.catch(() => {
+            if (this.ensuredMounts.get(mountKey) === shared) {
+                this.ensuredMounts.delete(mountKey);
+            }
+        });
+        return waitForEnsuredMount(shared, normalized.signal);
+    }
+    async startEnsuredMount(workspace, normalized) {
         if (normalized.verifyProvider) {
             if (!normalized.provider) {
                 throw new MountSessionInputError("provider required when verifyProvider=true");
@@ -781,6 +811,55 @@ class MountedWorkspaceHandleImpl {
         await safeStopLauncher(this.launcherInstance);
     }
 }
+class SharedMountedWorkspaceHandle {
+    mounted;
+    onStopped;
+    stopPromise;
+    constructor(input) {
+        this.mounted = input.mounted;
+        this.onStopped = input.onStopped;
+    }
+    get workspaceId() {
+        return this.mounted.workspaceId;
+    }
+    get localDir() {
+        return this.mounted.localDir;
+    }
+    get remotePath() {
+        return this.mounted.remotePath;
+    }
+    get mode() {
+        return this.mounted.mode;
+    }
+    get ready() {
+        return this.mounted.ready;
+    }
+    get expiresAt() {
+        return this.mounted.expiresAt;
+    }
+    get suggestedRefreshAt() {
+        return this.mounted.suggestedRefreshAt;
+    }
+    env() {
+        return this.mounted.env();
+    }
+    status() {
+        return this.mounted.status();
+    }
+    async stop() {
+        if (!this.stopPromise)
+            this.stopPromise = this.performStop();
+        await this.stopPromise;
+    }
+    async performStop() {
+        try {
+            await this.mounted.stop();
+        }
+        finally {
+            this.onStopped();
+        }
+    }
+}
 class SupervisedMountedWorkspaceHandle {
     mounted;
     launch;
@@ -941,6 +1020,37 @@ class SupervisedMountedWorkspaceHandle {
         void Promise.resolve(this.onEvent?.(event)).catch(() => { });
     }
 }
+function ensuredMountKey(workspace, input) {
+    return JSON.stringify([
+        workspace.workspaceId,
+        input.localDir,
+        input.remotePath,
+        input.mode,
+        input.localLayout,
+        input.syncMode,
+        input.background
+    ]);
+}
+async function waitForEnsuredMount(mounted, signal) {
+    if (!signal)
+        return mounted;
+    if (signal.aborted)
+        throw new CloudAbortError("ensureMountedWorkspace");
+    let onAbort;
+    try {
+        return await Promise.race([
+            mounted,
+            new Promise((_, reject) => {
+                onAbort = () => reject(new CloudAbortError("ensureMountedWorkspace"));
+                signal.addEventListener("abort", onAbort, { once: true });
+            })
+        ]);
+    }
+    finally {
+        if (onAbort)
+            signal.removeEventListener("abort", onAbort);
+    }
+}
 function setupErrorCode(error) {
     return error instanceof RelayfileSetupError ? error.code : "mount_refresh_failed";
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relayfile/sdk",
-  "version": "0.10.32",
+  "version": "0.10.33",
   "description": "TypeScript SDK for relayfile — real-time filesystem for humans and agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -59,15 +59,15 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@relayfile/core": "0.10.32",
+    "@relayfile/core": "0.10.33",
     "ignore": "^7.0.5",
     "tar": "^7.5.10"
   },
   "optionalDependencies": {
-    "@relayfile/mount-darwin-arm64": "0.10.32",
-    "@relayfile/mount-darwin-x64": "0.10.32",
-    "@relayfile/mount-linux-arm64": "0.10.32",
-    "@relayfile/mount-linux-x64": "0.10.32"
+    "@relayfile/mount-darwin-arm64": "0.10.33",
+    "@relayfile/mount-darwin-x64": "0.10.33",
+    "@relayfile/mount-linux-arm64": "0.10.33",
+    "@relayfile/mount-linux-x64": "0.10.33"
   },
   "devDependencies": {
     "typescript": "^5.7.3",