@hypercerts-org/sdk-core 0.2.0-beta.0 → 0.4.0-beta.0

package/dist/index.d.ts

@@ -1089,16 +1089,6 @@ interface HypercertWithMetadata {
     record: HypercertClaim;
 }
 
-/**
- * Repository interfaces - Operation contracts for repository functionality.
- *
- * This module defines the interfaces for all repository operations,
- * providing clear contracts for record management, blob handling,
- * profile management, and domain-specific operations.
- *
- * @packageDocumentation
- */
-
 /**
  * Parameters for creating a new hypercert.
  *
@@ -1845,6 +1835,17 @@ interface HypercertOperations extends EventEmitter<HypercertEvents> {
  * const hasAccess = await repo.collaborators.hasAccess("did:plc:someone");
  * const role = await repo.collaborators.getRole("did:plc:someone");
  *
+ * // Get current user permissions
+ * const permissions = await repo.collaborators.getPermissions();
+ * if (permissions.admin) {
+ *   // Can manage collaborators
+ * }
+ *
+ * // Transfer ownership
+ * await repo.collaborators.transferOwnership({
+ *   newOwnerDid: "did:plc:new-owner",
+ * });
+ *
  * // Revoke access
  * await repo.collaborators.revoke({ userDid: "did:plc:former-user" });
  * ```
@@ -1890,6 +1891,24 @@ interface CollaboratorOperations {
      * @returns Promise resolving to role, or `null` if no access
      */
     getRole(userDid: string): Promise<RepositoryRole | null>;
+    /**
+     * Gets the current user's permissions for this repository.
+     *
+     * @returns Promise resolving to permission flags
+     */
+    getPermissions(): Promise<CollaboratorPermissions>;
+    /**
+     * Transfers repository ownership to another user.
+     *
+     * **WARNING**: This action is irreversible. The new owner will have
+     * full control of the repository.
+     *
+     * @param params - Transfer parameters
+     * @param params.newOwnerDid - DID of the user to transfer ownership to
+     */
+    transferOwnership(params: {
+        newOwnerDid: string;
+    }): Promise<void>;
 }
 /**
  * Organization operations for SDS organization management.

package/dist/index.mjs

@@ -3040,9 +3040,11 @@ class HypercertOperationsImpl extends EventEmitter {
  * - `owner`: Full control including ownership management
  *
  * **SDS API Endpoints Used**:
- * - `com.atproto.sds.grantAccess`: Grant access to a user
- * - `com.atproto.sds.revokeAccess`: Revoke access from a user
- * - `com.atproto.sds.listCollaborators`: List all collaborators
+ * - `com.sds.repo.grantAccess`: Grant access to a user
+ * - `com.sds.repo.revokeAccess`: Revoke access from a user
+ * - `com.sds.repo.listCollaborators`: List all collaborators
+ * - `com.sds.repo.getPermissions`: Get current user's permissions
+ * - `com.sds.repo.transferOwnership`: Transfer repository ownership
  *
  * @example
  * ```typescript
@@ -3144,7 +3146,7 @@ class CollaboratorOperationsImpl {
      */
     async grant(params) {
         const permissions = this.roleToPermissions(params.role);
-        const response = await this.session.fetchHandler(`${this.serverUrl}/xrpc/com.atproto.sds.grantAccess`, {
+        const response = await this.session.fetchHandler(`${this.serverUrl}/xrpc/com.sds.repo.grantAccess`, {
             method: "POST",
             headers: { "Content-Type": "application/json" },
             body: JSON.stringify({
@@ -3176,7 +3178,7 @@ class CollaboratorOperationsImpl {
      * ```
      */
     async revoke(params) {
-        const response = await this.session.fetchHandler(`${this.serverUrl}/xrpc/com.atproto.sds.revokeAccess`, {
+        const response = await this.session.fetchHandler(`${this.serverUrl}/xrpc/com.sds.repo.revokeAccess`, {
             method: "POST",
             headers: { "Content-Type": "application/json" },
             body: JSON.stringify({
@@ -3215,7 +3217,7 @@ class CollaboratorOperationsImpl {
      * ```
      */
     async list() {
-        const response = await this.session.fetchHandler(`${this.serverUrl}/xrpc/com.atproto.sds.listCollaborators?repo=${encodeURIComponent(this.repoDid)}`, { method: "GET" });
+        const response = await this.session.fetchHandler(`${this.serverUrl}/xrpc/com.sds.repo.listCollaborators?repo=${encodeURIComponent(this.repoDid)}`, { method: "GET" });
         if (!response.ok) {
             throw new NetworkError(`Failed to list collaborators: ${response.statusText}`);
         }
@@ -3276,6 +3278,104 @@ class CollaboratorOperationsImpl {
         const collab = collaborators.find((c) => c.userDid === userDid && !c.revokedAt);
         return collab?.role ?? null;
     }
+    /**
+     * Gets the current user's permissions for this repository.
+     *
+     * @returns Promise resolving to the permission flags
+     * @throws {@link NetworkError} if the request fails
+     *
+     * @remarks
+     * This is useful for checking what actions the current user can perform
+     * before attempting operations that might fail due to insufficient permissions.
+     *
+     * @example
+     * ```typescript
+     * const permissions = await repo.collaborators.getPermissions();
+     *
+     * if (permissions.admin) {
+     *   // Show admin UI
+     *   console.log("You can manage collaborators");
+     * }
+     *
+     * if (permissions.create) {
+     *   console.log("You can create records");
+     * }
+     * ```
+     *
+     * @example Conditional UI rendering
+     * ```typescript
+     * const permissions = await repo.collaborators.getPermissions();
+     *
+     * // Show/hide UI elements based on permissions
+     * const canEdit = permissions.update;
+     * const canDelete = permissions.delete;
+     * const isAdmin = permissions.admin;
+     * const isOwner = permissions.owner;
+     * ```
+     */
+    async getPermissions() {
+        const response = await this.session.fetchHandler(`${this.serverUrl}/xrpc/com.sds.repo.getPermissions?repo=${encodeURIComponent(this.repoDid)}`, { method: "GET" });
+        if (!response.ok) {
+            throw new NetworkError(`Failed to get permissions: ${response.statusText}`);
+        }
+        const data = await response.json();
+        return data.permissions;
+    }
+    /**
+     * Transfers repository ownership to another user.
+     *
+     * @param params - Transfer parameters
+     * @param params.newOwnerDid - DID of the user to transfer ownership to
+     * @throws {@link NetworkError} if the transfer fails
+     *
+     * @remarks
+     * **IMPORTANT**: This action is irreversible. Once ownership is transferred:
+     * - The new owner gains full control of the repository
+     * - Your role will be changed to admin (or specified role)
+     * - You cannot transfer ownership back without the new owner's approval
+     *
+     * **Requirements**:
+     * - You must be the current owner
+     * - The new owner must have an existing account
+     * - The new owner will be notified of the ownership transfer
+     *
+     * @example
+     * ```typescript
+     * // Transfer ownership to another user
+     * await repo.collaborators.transferOwnership({
+     *   newOwnerDid: "did:plc:new-owner",
+     * });
+     *
+     * console.log("Ownership transferred successfully");
+     * // You are now an admin, not the owner
+     * ```
+     *
+     * @example With confirmation
+     * ```typescript
+     * const confirmTransfer = await askUser(
+     *   "Are you sure you want to transfer ownership? This cannot be undone."
+     * );
+     *
+     * if (confirmTransfer) {
+     *   await repo.collaborators.transferOwnership({
+     *     newOwnerDid: "did:plc:new-owner",
+     *   });
+     * }
+     * ```
+     */
+    async transferOwnership(params) {
+        const response = await this.session.fetchHandler(`${this.serverUrl}/xrpc/com.sds.repo.transferOwnership`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                repo: this.repoDid,
+                newOwner: params.newOwnerDid,
+            }),
+        });
+        if (!response.ok) {
+            throw new NetworkError(`Failed to transfer ownership: ${response.statusText}`);
+        }
+    }
 }
 
 /**
@@ -3302,8 +3402,8 @@ class CollaboratorOperationsImpl {
  * {@link Repository.organizations} on an SDS-connected repository.
  *
  * **SDS API Endpoints Used**:
- * - `com.atproto.sds.createRepository`: Create a new organization
- * - `com.atproto.sds.listRepositories`: List accessible organizations
+ * - `com.sds.organization.create`: Create a new organization
+ * - `com.sds.organization.list`: List accessible organizations
  *
  * **Access Types**:
  * - `"owner"`: User created or owns the organization
@@ -3381,7 +3481,7 @@ class OrganizationOperationsImpl {
      * ```
      */
     async create(params) {
-        const response = await this.session.fetchHandler(`${this.serverUrl}/xrpc/com.atproto.sds.createRepository`, {
+        const response = await this.session.fetchHandler(`${this.serverUrl}/xrpc/com.sds.organization.create`, {
             method: "POST",
             headers: { "Content-Type": "application/json" },
             body: JSON.stringify(params),
@@ -3471,7 +3571,7 @@ class OrganizationOperationsImpl {
      * ```
      */
     async list() {
-        const response = await this.session.fetchHandler(`${this.serverUrl}/xrpc/com.atproto.sds.listRepositories?userDid=${encodeURIComponent(this.session.did || this.session.sub)}`, { method: "GET" });
+        const response = await this.session.fetchHandler(`${this.serverUrl}/xrpc/com.sds.organization.list?userDid=${encodeURIComponent(this.session.did || this.session.sub)}`, { method: "GET" });
         if (!response.ok) {
             throw new NetworkError(`Failed to list organizations: ${response.statusText}`);
         }