@api-client/core 0.9.9 → 0.9.11

package/src/runtime/store/CertificatesSdk.ts

@@ -1,3 +1,4 @@
+import WebSocketNode from 'ws';
 import { SdkBase, E_RESPONSE_STATUS, E_RESPONSE_NO_VALUE, E_INVALID_JSON, E_RESPONSE_UNKNOWN, ISdkRequestOptions } from './SdkBase.js';
 import { RouteBuilder } from './RouteBuilder.js';
 import { ContextChangeRecord, ContextDeleteRecord, ContextListResult, ContextSpaceListOptions, IBulkOperationResult } from '../../events/BaseEvents.js';
@@ -17,7 +18,7 @@ export class CertificatesSdk extends SdkBase {
     url.searchParams.set('space', space);
     const body = JSON.stringify(value);
     const result = await this.sdk.http.post(url.toString(), { token, body });
-    this.inspectCommonStatusCodes(result.status);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to create a certificate. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -55,7 +56,7 @@ export class CertificatesSdk extends SdkBase {
     url.searchParams.set('space', space);
     const body = JSON.stringify(values);
     const result = await this.sdk.http.post(url.toString(), { token, body });
-    this.inspectCommonStatusCodes(result.status);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to create a bulk certificates. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -88,7 +89,7 @@ export class CertificatesSdk extends SdkBase {
     const token = request.token || this.sdk.token;
     const url = this.sdk.getUrl(RouteBuilder.certificate(key));
     const result = await this.sdk.http.get(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to read a certificate. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -125,7 +126,7 @@ export class CertificatesSdk extends SdkBase {
     const url = this.sdk.getUrl(RouteBuilder.certificates());
     this.sdk.appendListOptions(url, options);
     const result = await this.sdk.http.get(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to list certificates. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -160,7 +161,7 @@ export class CertificatesSdk extends SdkBase {
     const token = request.token || this.sdk.token;
     const url = this.sdk.getUrl(RouteBuilder.certificate(key));
     const result = await this.sdk.http.delete(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status, result.body);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to delete the certificate. ';
     if (result.status !== 204) {
       this.logInvalidResponse(result);
@@ -181,7 +182,7 @@ export class CertificatesSdk extends SdkBase {
     const token = request.token || this.sdk.token;
     const url = this.sdk.getUrl(RouteBuilder.certificateBatchDelete());
     const result = await this.sdk.http.post(url.toString(), { token, body: JSON.stringify(keys) });
-    this.inspectCommonStatusCodes(result.status);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to delete history. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -216,7 +217,7 @@ export class CertificatesSdk extends SdkBase {
     const token = request.token || this.sdk.token;
     const url = this.sdk.getUrl(RouteBuilder.certificatesEmpty(space));
     const result = await this.sdk.http.delete(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status, result.body);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to delete the certificate. ';
     if (result.status !== 204) {
       this.logInvalidResponse(result);
@@ -228,4 +229,16 @@ export class CertificatesSdk extends SdkBase {
       throw e;
     }
   }
+
+  /**
+   * Creates a WS client that listens to the certificate events.
+   * @param space The parent space.
+   * @param request Optional request options.
+   */
+  async observe(space: string, request: ISdkRequestOptions = {}): Promise<WebSocketNode | WebSocket> {
+    const token = request.token || this.sdk.token;
+    const url = this.sdk.getUrl(RouteBuilder.certificates());
+    url.searchParams.set('space', space);
+    return this.sdk.ws.createAndConnect(url.toString(), token);
+  }
 }

package/src/runtime/store/FilesSdk.ts

@@ -7,7 +7,19 @@ import { Kind as ProjectKind } from '../../models/Project.js';
 import { Kind as FolderKind } from '../../models/Folder.js';
 import { Kind as DataNamespaceKind } from '../../models/data/DataNamespace.js';
 import { SdkError } from './Errors.js';
-import { ContextListResult, IPatchInfo, IPatchRevision, IAccessPatchInfo, ContextChangeRecord, IBulkOperationResult, ContextListOptions } from '../../events/BaseEvents.js';
+import { 
+  ContextListResult, 
+  IPatchInfo, 
+  IPatchRevision, 
+  IAccessPatchInfo, 
+  ContextChangeRecord, 
+  IBulkOperationResult, 
+  ContextListOptions,
+} from '../../events/BaseEvents.js';
+import { 
+  IAccessAddOperation, IAccessRemoveOperation, PermissionRole 
+} from '../..//models/store/Permission.js';
+import uuid from '../../lib/uuid.js';
 
 export interface IMetaCreateOptions {
   /**
@@ -55,7 +67,7 @@ export class FilesSdk extends SdkBase {
     }
     url.searchParams.set('space', space);
     const result = await this.sdk.http.get(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status, result.body);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to list files. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -119,7 +131,7 @@ export class FilesSdk extends SdkBase {
         'content-type': 'application/json'
       },
     });
-    this.inspectCommonStatusCodes(result.status, result.body);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to create a file. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -174,7 +186,7 @@ export class FilesSdk extends SdkBase {
         'content-type': mime
       },
     });
-    this.inspectCommonStatusCodes(result.status, result.body);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to create a file. ';
     if (result.status !== 204) {
       this.logInvalidResponse(result);
@@ -219,7 +231,7 @@ export class FilesSdk extends SdkBase {
       url.searchParams.set('alt', 'media');
     }
     const result = await this.sdk.http.get(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status, result.body);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to read a file. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -260,7 +272,7 @@ export class FilesSdk extends SdkBase {
     url.searchParams.set('space', space);
     const body = JSON.stringify(keys);
     const result = await this.sdk.http.post(url.toString(), { token, body });
-    this.inspectCommonStatusCodes(result.status, result.body);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to read files in bulk. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -320,7 +332,7 @@ export class FilesSdk extends SdkBase {
     }
     const body = JSON.stringify(value);
     const result = await this.sdk.http.patch(url.toString(), { token, body });
-    this.inspectCommonStatusCodes(result.status, result.body);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to patch a file. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -358,7 +370,7 @@ export class FilesSdk extends SdkBase {
     const url = this.sdk.getUrl(RouteBuilder.file(key));
     url.searchParams.set('space', space);
     const result = await this.sdk.http.delete(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status, result.body);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to delete a file. ';
     if (result.status !== 204) {
       this.logInvalidResponse(result);
@@ -374,6 +386,7 @@ export class FilesSdk extends SdkBase {
   /**
    * Updates the sharing options of the file.
    * 
+   * @param space The parent space key
    * @param key The file key
    * @param value The patch operation on the file's ACL
    * @param request Optional request options.
@@ -384,8 +397,8 @@ export class FilesSdk extends SdkBase {
     url.searchParams.set('space', space);
     const body = JSON.stringify(value);
     const result = await this.sdk.http.patch(url.toString(), { token, body });
-    this.inspectCommonStatusCodes(result.status, result.body);
-    const E_PREFIX = 'Unable to patch a file. ';
+    this.inspectCommonStatusCodes(result);
+    const E_PREFIX = 'Unable to patch the file. ';
     if (result.status !== 204) {
       this.logInvalidResponse(result);
       let e = this.createGenericSdkError(result.body)
@@ -397,6 +410,52 @@ export class FilesSdk extends SdkBase {
     }
   }
 
+  /**
+   * A shorthand method to add access to the file to a single user.
+   * 
+   * @param space The parent space key
+   * @param key The file key
+   * @param otherUserKey The key of the user that gets access to the space
+   * @param role The user role to grant
+   * @param expires Optionally, when the permission expires.
+   */
+  async addUser(space: string, key: string, otherUserKey: string, role: PermissionRole, expires?: number, request?: ISdkRequestOptions): Promise<void> {
+    const op: IAccessAddOperation = {
+      op: 'add',
+      type: 'user',
+      value: role,
+      id: otherUserKey,
+    };
+    if (typeof expires === 'number') {
+      op.expirationTime = expires;
+    }
+    const patch: IAccessPatchInfo = {
+      patch: [op],
+      id: uuid(),
+    };
+    return this.patchUsers(space, key, patch, request);
+  }
+
+  /**
+   * A shorthand method to remove access to the space to a single user.
+   * 
+   * @param space The space key to share
+   * @param key The file key
+   * @param otherUserKey The key of the user that gets access to the space
+   */
+  async removeUser(space: string, key: string, otherUserKey: string, request?: ISdkRequestOptions): Promise<void> {
+    const op: IAccessRemoveOperation = {
+      op: 'remove',
+      type: 'user',
+      id: otherUserKey,
+    };
+    const patch: IAccessPatchInfo = {
+      patch: [op],
+      id: uuid(),
+    };
+    return this.patchUsers(space, key, patch, request);
+  }
+
   /**
    * Lists uses having access to the file.
    * 
@@ -408,7 +467,7 @@ export class FilesSdk extends SdkBase {
     const url = this.sdk.getUrl(RouteBuilder.fileUsers(key));
     url.searchParams.set('space', space);
     const result = await this.sdk.http.get(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status, result.body);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to list users in the file. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -436,11 +495,13 @@ export class FilesSdk extends SdkBase {
 
   /**
    * Creates a WS client that listens to the files events.
+   * @param space The parent space.
    * @param request Optional request options.
    */
-  async observeFiles(request: ISdkRequestOptions = {}): Promise<WebSocketNode | WebSocket> {
+  async observeFiles(space: string, request: ISdkRequestOptions = {}): Promise<WebSocketNode | WebSocket> {
     const token = request.token || this.sdk.token;
     const url = this.sdk.getUrl(RouteBuilder.files());
+    url.searchParams.set('space', space);
     return this.sdk.ws.createAndConnect(url.toString(), token);
   }
 
@@ -470,7 +531,7 @@ export class FilesSdk extends SdkBase {
     const url = this.sdk.getUrl(RouteBuilder.fileBreadcrumbs(key));
     url.searchParams.set('space', space);
     const result = await this.sdk.http.get(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status, result.body);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to read a file. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);

package/src/runtime/store/HistorySdk.ts

@@ -1,3 +1,4 @@
+import WebSocketNode from 'ws';
 import { SdkBase, E_RESPONSE_STATUS, E_RESPONSE_NO_VALUE, E_INVALID_JSON, E_RESPONSE_UNKNOWN, ISdkRequestOptions } from './SdkBase.js';
 import { RouteBuilder } from './RouteBuilder.js';
 import { IHttpHistory, IHttpHistoryBulkAdd, Kind as HttpHistoryKind } from '../../models/HttpHistory.js';
@@ -23,7 +24,7 @@ export class HistorySdk extends SdkBase {
     const url = this.sdk.getUrl(RouteBuilder.history());
     const body = JSON.stringify(history);
     const result = await this.sdk.http.post(url.toString(), { token, body });
-    this.inspectCommonStatusCodes(result.status);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to create a history. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -60,7 +61,7 @@ export class HistorySdk extends SdkBase {
     const url = this.sdk.getUrl(RouteBuilder.historyBatchCreate());
     const body = JSON.stringify(info);
     const result = await this.sdk.http.post(url.toString(), { token, body });
-    this.inspectCommonStatusCodes(result.status);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to create a bulk history. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -97,7 +98,7 @@ export class HistorySdk extends SdkBase {
     const url = this.sdk.getUrl(RouteBuilder.history());
     this.appendHistoryListParameters(url, options);
     const result = await this.sdk.http.get(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to list history. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -154,7 +155,7 @@ export class HistorySdk extends SdkBase {
     const url = this.sdk.getUrl(path);
 
     const result = await this.sdk.http.delete(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to delete history. ';
     if (result.status !== 204) {
       this.logInvalidResponse(result);
@@ -178,7 +179,7 @@ export class HistorySdk extends SdkBase {
     const path = RouteBuilder.historyBatchDelete();
     const url = this.sdk.getUrl(path);
     const result = await this.sdk.http.post(url.toString(), { token, body: JSON.stringify(keys) });
-    this.inspectCommonStatusCodes(result.status);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to delete history. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -215,7 +216,7 @@ export class HistorySdk extends SdkBase {
     const token = request.token || this.sdk.token;
     const url = this.sdk.getUrl(RouteBuilder.historyItem(key));
     const result = await this.sdk.http.get(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to read a history. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -245,7 +246,7 @@ export class HistorySdk extends SdkBase {
     const token = request.token || this.sdk.token;
     const url = this.sdk.getUrl(RouteBuilder.historyClear('space', spaceKey));
     const result = await this.sdk.http.delete(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status, result.body);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to clear history for the space. ';
     if (result.status !== 204) {
       this.logInvalidResponse(result);
@@ -262,7 +263,7 @@ export class HistorySdk extends SdkBase {
     const token = request.token || this.sdk.token;
     const url = this.sdk.getUrl(RouteBuilder.historyClear('project', spaceKey, projectKey));
     const result = await this.sdk.http.delete(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status, result.body);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to clear history for the project. ';
     if (result.status !== 204) {
       this.logInvalidResponse(result);
@@ -279,7 +280,7 @@ export class HistorySdk extends SdkBase {
     const token = request.token || this.sdk.token;
     const url = this.sdk.getUrl(RouteBuilder.historyClear('request', spaceKey, projectKey, requestKey));
     const result = await this.sdk.http.delete(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status, result.body);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to clear history for the request. ';
     if (result.status !== 204) {
       this.logInvalidResponse(result);
@@ -291,4 +292,16 @@ export class HistorySdk extends SdkBase {
       throw e;
     }
   }
+
+  /**
+   * Creates a WS client that listens to the certificate events.
+   * @param space The parent space.
+   * @param request Optional request options.
+   */
+  async observe(space: string, request: ISdkRequestOptions = {}): Promise<WebSocketNode | WebSocket> {
+    const token = request.token || this.sdk.token;
+    const url = this.sdk.getUrl(RouteBuilder.history());
+    url.searchParams.set('space', space);
+    return this.sdk.ws.createAndConnect(url.toString(), token);
+  }
 }

package/src/runtime/store/RevisionsSdk.ts

@@ -16,7 +16,7 @@ export class RevisionsSdk extends SdkBase {
     const url = this.sdk.getUrl(RouteBuilder.fileRevisions(key));
     this.sdk.appendListOptions(url, options);
     const result = await this.sdk.http.get(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to list revisions for a file. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);

package/src/runtime/store/RouteBuilder.ts

@@ -10,6 +10,10 @@ export class RouteBuilder {
     return `/spaces/${key}`;
   }
 
+  static spaceUsers(key: string): string {
+    return `/spaces/${key}/users`;
+  }
+
   /**
    * @returns The path to the /files route.
    */

package/src/runtime/store/SdkBase.ts

@@ -66,11 +66,12 @@ export class SdkBase {
    * Throws unified message for a common error status codes.
    * It handles 404, 403, and 401 status codes.
    */
-  protected inspectCommonStatusCodes(status: number, body?: string): void {
+  protected inspectCommonStatusCodes(response: IStoreResponse): void {
+    const { status, body } = response;
     if (status === 404) {
       let e = this.createGenericSdkError(body)
       if (!e) {
-        e = new SdkError(`Not found.`, 400);
+        e = new SdkError(`Not found.`, status);
         e.response = body;
       }
       throw e;
@@ -78,7 +79,7 @@ export class SdkBase {
     if (status === 403) {
       let e = this.createGenericSdkError(body)
       if (!e) {
-        e = new SdkError(`You have no access to this resource.`, 403);
+        e = new SdkError(`You have no access to this resource.`, status);
         e.response = body;
       }
       throw e;
@@ -86,7 +87,7 @@ export class SdkBase {
     if (status === 401) {
       let e = this.createGenericSdkError(body)
       if (!e) {
-        e = new SdkError(`Not authorized.`, 401);
+        e = new SdkError(`Not authorized.`, status);
         e.response = body;
       }
       throw e;

package/src/runtime/store/SharedSdk.ts

@@ -22,7 +22,7 @@ export class SharedSdk extends SdkBase {
     }
     url.searchParams.set('space', space);
     const result = await this.sdk.http.get(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status, result.body);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to list spaces. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);

package/src/runtime/store/SpacesSdk.ts

@@ -1,8 +1,10 @@
 import { SdkBase, E_RESPONSE_STATUS, E_RESPONSE_NO_VALUE, E_INVALID_JSON, E_RESPONSE_UNKNOWN, ISdkRequestOptions } from './SdkBase.js';
 import { RouteBuilder } from './RouteBuilder.js';
-import { ContextChangeRecord, ContextListOptions, ContextListResult } from '../../events/BaseEvents.js';
+import { ContextChangeRecord, ContextListOptions, ContextListResult, IAccessPatchInfo } from '../../events/BaseEvents.js';
 import { ISpace, Kind as SpaceKind } from '../../models/Space.js';
+import { IAccessAddOperation, IAccessRemoveOperation, PermissionRole } from '../../models/store/Permission.js';
 import { SdkError } from './Errors.js';
+import uuid from '../../lib/uuid.js';
 
 export class SpacesSdk extends SdkBase {
   /**
@@ -14,7 +16,7 @@ export class SpacesSdk extends SdkBase {
     const url = this.sdk.getUrl(RouteBuilder.spaces());
     this.sdk.appendListOptions(url, options);
     const result = await this.sdk.http.get(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to list spaces. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -50,7 +52,7 @@ export class SpacesSdk extends SdkBase {
     const url = this.sdk.getUrl(RouteBuilder.spaces());
     const body = JSON.stringify(space);
     const result = await this.sdk.http.post(url.toString(), { token, body });
-    this.inspectCommonStatusCodes(result.status);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to create a space. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -84,7 +86,7 @@ export class SpacesSdk extends SdkBase {
     const token = request.token || this.sdk.token;
     const url = this.sdk.getUrl(RouteBuilder.space(key));
     const result = await this.sdk.http.get(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to read a space. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -121,7 +123,7 @@ export class SpacesSdk extends SdkBase {
     const token = request.token || this.sdk.token;
     const url = this.sdk.getUrl(RouteBuilder.space(key));
     const result = await this.sdk.http.delete(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status, result.body);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to delete the space. ';
     if (result.status !== 204) {
       this.logInvalidResponse(result);
@@ -133,4 +135,73 @@ export class SpacesSdk extends SdkBase {
       throw e;
     }
   }
+
+  /**
+   * Updates the sharing options of the space.
+   * 
+   * @param key The space key
+   * @param value The patch operation on the space's ACL
+   * @param request Optional request options.
+   */
+  async patchUsers(space: string, value: IAccessPatchInfo, request: ISdkRequestOptions = {}): Promise<void> {
+    const token = request.token || this.sdk.token;
+    const url = this.sdk.getUrl(RouteBuilder.spaceUsers(space));
+    const body = JSON.stringify(value);
+    const result = await this.sdk.http.patch(url.toString(), { token, body });
+    this.inspectCommonStatusCodes(result);
+    const E_PREFIX = 'Unable to patch the space. ';
+    if (result.status !== 204) {
+      this.logInvalidResponse(result);
+      let e = this.createGenericSdkError(result.body)
+      if (!e) {
+        e = new SdkError(`${E_PREFIX}${E_RESPONSE_STATUS}${result.status}`, result.status);
+        e.response = result.body;
+      }
+      throw e;
+    }
+  }
+
+  /**
+   * A shorthand method to add access to the space to a single user.
+   * 
+   * @param space The space key to share
+   * @param otherUserKey The key of the user that gets access to the space
+   * @param role The user role to grant
+   * @param expires Optionally, when the permission expires.
+   */
+  async addUser(space: string, otherUserKey: string, role: PermissionRole, expires?: number, request?: ISdkRequestOptions): Promise<void> {
+    const op: IAccessAddOperation = {
+      op: 'add',
+      type: 'user',
+      value: role,
+      id: otherUserKey,
+    };
+    if (typeof expires === 'number') {
+      op.expirationTime = expires;
+    }
+    const patch: IAccessPatchInfo = {
+      patch: [op],
+      id: uuid(),
+    };
+    return this.patchUsers(space, patch, request);
+  }
+
+  /**
+   * A shorthand method to remove access to the space to a single user.
+   * 
+   * @param space The space key to share
+   * @param otherUserKey The key of the user that gets access to the space
+   */
+  async removeUser(space: string, otherUserKey: string, request?: ISdkRequestOptions): Promise<void> {
+    const op: IAccessRemoveOperation = {
+      op: 'remove',
+      type: 'user',
+      id: otherUserKey,
+    };
+    const patch: IAccessPatchInfo = {
+      patch: [op],
+      id: uuid(),
+    };
+    return this.patchUsers(space, patch, request);
+  }
 }

package/src/runtime/store/TrashSdk.ts

@@ -18,7 +18,7 @@ export class TrashSdk extends SdkBase {
     url.searchParams.set('space', space);
     const body = JSON.stringify(entry);
     const result = await this.sdk.http.post(url.toString(), { token, body });
-    this.inspectCommonStatusCodes(result.status);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to create a trash. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -53,7 +53,7 @@ export class TrashSdk extends SdkBase {
     const url = this.sdk.getUrl(RouteBuilder.trash());
     this.sdk.appendListOptions(url, options);
     const result = await this.sdk.http.get(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to list trash. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -87,7 +87,7 @@ export class TrashSdk extends SdkBase {
     const token = request.token || this.sdk.token;
     const url = this.sdk.getUrl(RouteBuilder.trashItem(key));
     const result = await this.sdk.http.delete(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status, result.body);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to delete the trash entry. ';
     if (result.status !== 204) {
       this.logInvalidResponse(result);
@@ -110,7 +110,7 @@ export class TrashSdk extends SdkBase {
     const token = request.token || this.sdk.token;
     const url = this.sdk.getUrl(RouteBuilder.trashRestore(key));
     const result = await this.sdk.http.put(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status, result.body);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to restore from trash. ';
     if (result.status !== 204) {
       this.logInvalidResponse(result);
@@ -144,7 +144,7 @@ export class TrashSdk extends SdkBase {
     const token = request.token || this.sdk.token;
     const url = this.sdk.getUrl(RouteBuilder.trashEmpty(space));
     const result = await this.sdk.http.delete(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status, result.body);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to empty trash. ';
     if (result.status !== 204) {
       this.logInvalidResponse(result);

package/src/runtime/store/UsersSdk.ts

@@ -12,7 +12,7 @@ export class UsersSdk extends SdkBase {
     const token = request.token || this.sdk.token;
     const url = this.sdk.getUrl(RouteBuilder.usersMe());
     const result = await this.sdk.http.get(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to read a user. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -44,7 +44,7 @@ export class UsersSdk extends SdkBase {
     const url = this.sdk.getUrl(RouteBuilder.users());
     this.sdk.appendListOptions(url, options);
     const result = await this.sdk.http.get(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to list projects. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);
@@ -75,7 +75,7 @@ export class UsersSdk extends SdkBase {
     const token = request.token || this.sdk.token;
     const url = this.sdk.getUrl(RouteBuilder.user(key));
     const result = await this.sdk.http.get(url.toString(), { token });
-    this.inspectCommonStatusCodes(result.status);
+    this.inspectCommonStatusCodes(result);
     const E_PREFIX = 'Unable to read the user info. ';
     if (result.status !== 200) {
       this.logInvalidResponse(result);