@phpsandbox/sdk 0.3.4 → 0.3.5

package/README.md

@@ -55,6 +55,25 @@ PHPSandbox.rest('token', 'https://api.phpsandbox.io/v1', {
 });
 ```
 
+## Server invitations
+
+Server administrators can invite someone by email and inspect the shared invitation state:
+
+```typescript
+const server = await client.servers.get('SERVER_ID');
+const invitation = await server.share({ email: 'person@example.com', requestId: crypto.randomUUID() });
+const invitations = await server.invitations();
+
+// The recipient uses their own workspace credential and the proof from their invitation link.
+await recipientClient.servers.acceptInvitation(invitation.id, invitationProof);
+```
+
+Keep the same `requestId` when retrying creation. Use `client.servers.inspectInvitation()`, `acceptInvitation()` and `declineInvitation()` to respond, and `server.resendInvitation()` or `cancelInvitation()` to manage pending invitations. An `accepting` status means access confirmation is still in progress; retry acceptance with the same recipient workspace.
+
+For an immediate grant to an existing workspace, use `server.share({ organizationId: 'WORKSPACE_ID', requestId })`.
+
+Invitation operations use the same API base URL and credential as all other operations. No additional endpoint configuration is required.
+
 ## Notebook Lifecycle
 
 ```ts

package/dist/browser/phpsandbox-sdk.esm.js

@@ -19676,6 +19676,15 @@ var ServerApi = class {
   constructor(client) {
     this.client = client;
   }
+  async inspectInvitation(id, token) {
+    return (await this.client.post(`/platform/server-invitations/${encodeURIComponent(id)}/inspect`, { token })).data;
+  }
+  async acceptInvitation(id, token) {
+    return (await this.client.post(`/platform/server-invitations/${encodeURIComponent(id)}/accept`, { token })).data;
+  }
+  async declineInvitation(id, token) {
+    return (await this.client.post(`/platform/server-invitations/${encodeURIComponent(id)}/decline`, { token })).data;
+  }
   async list(options = {}) {
     const query = options.page === void 0 ? "" : `?${new URLSearchParams({ page: String(options.page) }).toString()}`;
     return this.client.get(`/servers${query}`);
@@ -19701,17 +19710,40 @@ var ServerInstance = class {
     const query = options.page === void 0 ? "" : `?${new URLSearchParams({ page: String(options.page) }).toString()}`;
     return this.client.get(`/servers/${encodeURIComponent(this.data.id)}/members${query}`);
   }
-  async share(email3) {
-    return (await this.client.post(`/servers/${encodeURIComponent(this.data.id)}/members`, { email: email3 })).data;
-  }
-  async shareWithOrganization(organizationId) {
-    return (await this.client.post(`/servers/${encodeURIComponent(this.data.id)}/members`, { organizationId })).data;
+  async share(target) {
+    if (target.email !== void 0) {
+      return (await this.client.post(`/platform/servers/${encodeURIComponent(this.data.id)}/invitations`, {
+        email: target.email,
+        requestId: target.requestId ?? crypto.randomUUID()
+      })).data;
+    }
+    const body = { organizationId: target.organizationId, requestId: target.requestId };
+    return (await this.client.post(`/servers/${encodeURIComponent(this.data.id)}/members`, body)).data;
   }
   async revokeAccess(memberId) {
     await this.client.delete(
       `/servers/${encodeURIComponent(this.data.id)}/members/${encodeURIComponent(String(memberId))}`
     );
   }
+  async invitations(options = {}) {
+    const query = options.page === void 0 ? "" : `?${new URLSearchParams({ page: String(options.page) }).toString()}`;
+    return this.client.get(`/platform/servers/${encodeURIComponent(this.data.id)}/invitations${query}`);
+  }
+  async cancelInvitation(id) {
+    const response = await this.client.delete(
+      `/platform/servers/${encodeURIComponent(this.data.id)}/invitations/${encodeURIComponent(id)}`
+    );
+    if (response.data === void 0) {
+      throw new PHPSandboxError("Missing invitation cancellation response.");
+    }
+    return response.data;
+  }
+  async resendInvitation(id) {
+    return (await this.client.post(
+      `/platform/servers/${encodeURIComponent(this.data.id)}/invitations/${encodeURIComponent(id)}/resend`,
+      {}
+    )).data;
+  }
   refresh() {
     return this.client.servers.get(this.data.id);
   }
@@ -20250,7 +20282,7 @@ var ClientImplementation = class {
       })
     );
     if (!response.ok) {
-      throw await responseError(response);
+      throw await responseError(response, path.startsWith("/platform/") ? "platform" : "core");
     }
     if (response.status === 204) {
       return { data: void 0 };
@@ -20283,10 +20315,10 @@ var ClientImplementation = class {
     }
   }
 };
-async function responseError(response) {
+async function responseError(response, source = "core") {
   const body = await response.text();
   try {
-    return remoteError("core", errorPayload(body === "" ? void 0 : JSON.parse(body)), response);
+    return remoteError(source, errorPayload(body === "" ? void 0 : JSON.parse(body)), response);
   } catch {
     return new TransportError(
       `PHPSandbox API returned an invalid error response (HTTP ${response.status}).`,