@relayfile/sdk 0.7.8 → 0.7.9

package/dist/setup.d.ts

@@ -74,6 +74,34 @@ export declare class WorkspaceHandle {
     waitForNotion(options?: WaitForConnectionOptions): Promise<void>;
     isConnected(provider: WorkspaceIntegrationProvider, connectionId: string): Promise<boolean>;
     disconnectIntegration(provider: WorkspaceIntegrationProvider, _connectionId?: string): Promise<void>;
+    /**
+     * Bind an existing Nango connection to this workspace + provider slot
+     * without going through the OAuth re-mint flow. Use this when an operator
+     * has already minted the connection out-of-band (Nango UI, third-party
+     * setup) and just wants Cloud to start routing sync webhooks for it.
+     *
+     * The Cloud-side adopt route validates that the Nango connection exists
+     * upstream and that its end-user/workspace tag matches this workspace.
+     * On success returns the bound `connectionId` and, when a stale prior
+     * row was atomically replaced, a `replacedConnectionId` so callers can
+     * surface that a migration happened.
+     *
+     * Failure modes (HTTP body carries `code`):
+     *   - `connection_not_found` (404): Nango doesn't know this connectionId
+     *   - `workspace_mismatch` (409): connection belongs to a different
+     *     workspace; the body includes `pathWorkspaceId` and
+     *     `connectionWorkspaceId`
+     *   - `existing_connection_live_or_unknown` (409): a different
+     *     connection is already bound here and is either still live
+     *     upstream or has indeterminate state; operator must disconnect
+     *     first
+     */
+    adoptIntegration(provider: WorkspaceIntegrationProvider, connectionId: string, options?: {
+        providerConfigKey?: string;
+    }): Promise<{
+        connectionId: string;
+        replacedConnectionId?: string;
+    }>;
     getToken(): string;
     requestJson(options: Omit<CloudRequestOptions, "tokenProvider">): Promise<unknown>;
     mountEnv(options?: WorkspaceMountEnvOptions): WorkspaceMountEnv;

package/dist/setup.js

@@ -388,6 +388,58 @@ export class WorkspaceHandle {
         });
         this._pendingConnections.delete(provider);
     }
+    /**
+     * Bind an existing Nango connection to this workspace + provider slot
+     * without going through the OAuth re-mint flow. Use this when an operator
+     * has already minted the connection out-of-band (Nango UI, third-party
+     * setup) and just wants Cloud to start routing sync webhooks for it.
+     *
+     * The Cloud-side adopt route validates that the Nango connection exists
+     * upstream and that its end-user/workspace tag matches this workspace.
+     * On success returns the bound `connectionId` and, when a stale prior
+     * row was atomically replaced, a `replacedConnectionId` so callers can
+     * surface that a migration happened.
+     *
+     * Failure modes (HTTP body carries `code`):
+     *   - `connection_not_found` (404): Nango doesn't know this connectionId
+     *   - `workspace_mismatch` (409): connection belongs to a different
+     *     workspace; the body includes `pathWorkspaceId` and
+     *     `connectionWorkspaceId`
+     *   - `existing_connection_live_or_unknown` (409): a different
+     *     connection is already bound here and is either still live
+     *     upstream or has indeterminate state; operator must disconnect
+     *     first
+     */
+    async adoptIntegration(provider, connectionId, options = {}) {
+        assertProvider(provider);
+        const trimmedConnectionId = connectionId?.trim();
+        if (!trimmedConnectionId) {
+            throw new Error("connectionId is required to adopt an integration");
+        }
+        const body = { connectionId: trimmedConnectionId };
+        const providerConfigKey = options.providerConfigKey?.trim();
+        if (providerConfigKey) {
+            body.providerConfigKey = providerConfigKey;
+        }
+        const response = (await this._setup.requestJson({
+            operation: "adoptIntegration",
+            method: "POST",
+            path: `api/v1/workspaces/${encodeURIComponent(this.workspaceId)}/integrations/${encodeURIComponent(provider)}/adopt`,
+            body,
+            tokenProvider: async () => this.getOrRefreshToken()
+        }));
+        const boundConnectionId = typeof response.connectionId === "string" && response.connectionId.trim()
+            ? response.connectionId.trim()
+            : trimmedConnectionId;
+        const replacedConnectionId = typeof response.replacedConnectionId === "string" &&
+            response.replacedConnectionId.trim()
+            ? response.replacedConnectionId.trim()
+            : undefined;
+        this._pendingConnections.delete(provider);
+        return replacedConnectionId
+            ? { connectionId: boundConnectionId, replacedConnectionId }
+            : { connectionId: boundConnectionId };
+    }
     getToken() {
         return this._token;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relayfile/sdk",
-  "version": "0.7.8",
+  "version": "0.7.9",
   "description": "TypeScript SDK for relayfile — real-time filesystem for humans and agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -22,7 +22,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@relayfile/core": "0.7.8"
+    "@relayfile/core": "0.7.9"
   },
   "devDependencies": {
     "typescript": "^5.7.3",