@calimero-network/mero-js 26.6.0 → 26.7.0

package/dist/index.cjs

@@ -2130,6 +2130,21 @@ var AdminApiClient = class {
     }
     return data;
   }
+  /**
+   * Bring back a namespace the user removed from this node while the account
+   * stayed a member (POST /admin-api/namespaces/:namespace_id/join, no
+   * invitation). Such namespaces are the `forgotten` ones in
+   * {@link listNamespacesForApplication}.
+   */
+  async restoreNamespace(namespaceId) {
+    return unwrap(
+      await this.httpClient.post(
+        `/admin-api/namespaces/${pathSegment(namespaceId)}/join`,
+        {},
+        { timeoutMs: 65e3 }
+      )
+    );
+  }
   /**
    * Join the namespace an invitation grants, and say what happened — including
    * when the request failed but the join landed anyway.
@@ -2818,9 +2833,15 @@ var AdminApiClient = class {
   async leaveContext(contextId) {
     await this.httpClient.post(`/admin-api/contexts/${pathSegment(contextId)}/leave`, {});
   }
-  /** Leave a namespace (POST /admin-api/namespaces/:namespace_id/leave). */
-  async leaveNamespace(namespaceId) {
-    await this.httpClient.post(`/admin-api/namespaces/${pathSegment(namespaceId)}/leave`, {});
+  /**
+   * Leave a namespace (POST /admin-api/namespaces/:namespace_id/leave).
+   *
+   * With `purge`, every device of the account also takes the namespace off its
+   * disk. Core reads `purge` from the query string, so it is not in the body.
+   */
+  async leaveNamespace(namespaceId, options = {}) {
+    const query = options.purge ? "?purge=true" : "";
+    await this.httpClient.post(`/admin-api/namespaces/${pathSegment(namespaceId)}/leave${query}`, {});
   }
   /** Issue a group ownership proof (POST /admin-api/groups/:group_id/issue-ownership-proof). */
   async issueOwnershipProof(groupId, request) {