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

package/dist/index.cjs

@@ -1670,7 +1670,7 @@ class BlobOperationsImpl {
                 throw new NetworkError("Failed to upload blob");
             }
             return {
-                ref: result.data.blob.ref,
+                ref: { $link: result.data.blob.ref.toString() },
                 mimeType: result.data.blob.mimeType,
                 size: result.data.blob.size,
             };
@@ -2177,7 +2177,7 @@ class HypercertOperationsImpl extends eventemitter3.EventEmitter {
                     if (uploadResult.success) {
                         imageBlobRef = {
                             $type: "blob",
-                            ref: uploadResult.data.blob.ref,
+                            ref: { $link: uploadResult.data.blob.ref.toString() },
                             mimeType: uploadResult.data.blob.mimeType,
                             size: uploadResult.data.blob.size,
                         };
@@ -2602,7 +2602,7 @@ class HypercertOperationsImpl extends eventemitter3.EventEmitter {
                 if (uploadResult.success) {
                     locationValue = {
                         $type: "blob",
-                        ref: uploadResult.data.blob.ref,
+                        ref: { $link: uploadResult.data.blob.ref.toString() },
                         mimeType: uploadResult.data.blob.mimeType,
                         size: uploadResult.data.blob.size,
                     };
@@ -2887,7 +2887,7 @@ class HypercertOperationsImpl extends eventemitter3.EventEmitter {
                 if (uploadResult.success) {
                     coverPhotoRef = {
                         $type: "blob",
-                        ref: uploadResult.data.blob.ref,
+                        ref: { $link: uploadResult.data.blob.ref.toString() },
                         mimeType: uploadResult.data.blob.mimeType,
                         size: uploadResult.data.blob.size,
                     };
@@ -3118,6 +3118,26 @@ class CollaboratorOperationsImpl {
             return "editor";
         return "viewer";
     }
+    /**
+     * Converts a permission string array to a permissions object.
+     *
+     * The SDS API returns permissions as an array of strings (e.g., ["read", "create"]).
+     * This method converts them to the boolean flag format used by the SDK.
+     *
+     * @param permissionArray - Array of permission strings from SDS API
+     * @returns Permission flags object
+     * @internal
+     */
+    parsePermissions(permissionArray) {
+        return {
+            read: permissionArray.includes("read"),
+            create: permissionArray.includes("create"),
+            update: permissionArray.includes("update"),
+            delete: permissionArray.includes("delete"),
+            admin: permissionArray.includes("admin"),
+            owner: permissionArray.includes("owner"),
+        };
+    }
     /**
      * Grants repository access to a user.
      *
@@ -3194,7 +3214,10 @@ class CollaboratorOperationsImpl {
     /**
      * Lists all collaborators on the repository.
      *
-     * @returns Promise resolving to array of access grants
+     * @param params - Optional pagination parameters
+     * @param params.limit - Maximum number of results (1-100, default 50)
+     * @param params.cursor - Pagination cursor from previous response
+     * @returns Promise resolving to collaborators and optional cursor
      * @throws {@link NetworkError} if the list operation fails
      *
      * @remarks
@@ -3203,34 +3226,49 @@ class CollaboratorOperationsImpl {
      *
      * @example
      * ```typescript
-     * const collaborators = await repo.collaborators.list();
+     * // Get first page
+     * const page1 = await repo.collaborators.list({ limit: 10 });
+     * console.log(`Found ${page1.collaborators.length} collaborators`);
+     *
+     * // Get next page if available
+     * if (page1.cursor) {
+     *   const page2 = await repo.collaborators.list({ limit: 10, cursor: page1.cursor });
+     * }
      *
      * // Filter active collaborators
-     * const active = collaborators.filter(c => !c.revokedAt);
-     *
-     * // Group by role
-     * const byRole = {
-     *   owners: active.filter(c => c.role === "owner"),
-     *   admins: active.filter(c => c.role === "admin"),
-     *   editors: active.filter(c => c.role === "editor"),
-     *   viewers: active.filter(c => c.role === "viewer"),
-     * };
+     * const active = page1.collaborators.filter(c => !c.revokedAt);
      * ```
      */
-    async list() {
-        const response = await this.session.fetchHandler(`${this.serverUrl}/xrpc/com.sds.repo.listCollaborators?repo=${encodeURIComponent(this.repoDid)}`, { method: "GET" });
+    async list(params) {
+        const queryParams = new URLSearchParams({
+            repo: this.repoDid,
+        });
+        if (params?.limit !== undefined) {
+            queryParams.set("limit", params.limit.toString());
+        }
+        if (params?.cursor) {
+            queryParams.set("cursor", params.cursor);
+        }
+        const response = await this.session.fetchHandler(`${this.serverUrl}/xrpc/com.sds.repo.listCollaborators?${queryParams.toString()}`, { method: "GET" });
         if (!response.ok) {
             throw new NetworkError(`Failed to list collaborators: ${response.statusText}`);
         }
         const data = await response.json();
-        return (data.collaborators || []).map((c) => ({
-            userDid: c.userDid,
-            role: this.permissionsToRole(c.permissions),
-            permissions: c.permissions,
-            grantedBy: c.grantedBy,
-            grantedAt: c.grantedAt,
-            revokedAt: c.revokedAt,
-        }));
+        const collaborators = (data.collaborators || []).map((c) => {
+            const permissions = this.parsePermissions(c.permissions);
+            return {
+                userDid: c.userDid,
+                role: this.permissionsToRole(permissions),
+                permissions: permissions,
+                grantedBy: c.grantedBy,
+                grantedAt: c.grantedAt,
+                revokedAt: c.revokedAt,
+            };
+        });
+        return {
+            collaborators,
+            cursor: data.cursor,
+        };
     }
     /**
      * Checks if a user has any access to the repository.
@@ -3253,7 +3291,7 @@ class CollaboratorOperationsImpl {
      */
     async hasAccess(userDid) {
         try {
-            const collaborators = await this.list();
+            const { collaborators } = await this.list();
             return collaborators.some((c) => c.userDid === userDid && !c.revokedAt);
         }
         catch {
@@ -3275,7 +3313,7 @@ class CollaboratorOperationsImpl {
      * ```
      */
     async getRole(userDid) {
-        const collaborators = await this.list();
+        const { collaborators } = await this.list();
         const collab = collaborators.find((c) => c.userDid === userDid && !c.revokedAt);
         return collab?.role ?? null;
     }
@@ -3482,10 +3520,17 @@ class OrganizationOperationsImpl {
      * ```
      */
     async create(params) {
+        const userDid = this.session.did || this.session.sub;
+        if (!userDid) {
+            throw new NetworkError("No authenticated user found");
+        }
         const response = await this.session.fetchHandler(`${this.serverUrl}/xrpc/com.sds.organization.create`, {
             method: "POST",
             headers: { "Content-Type": "application/json" },
-            body: JSON.stringify(params),
+            body: JSON.stringify({
+                ...params,
+                creatorDid: userDid,
+            }),
         });
         if (!response.ok) {
             throw new NetworkError(`Failed to create organization: ${response.statusText}`);
@@ -3497,8 +3542,15 @@ class OrganizationOperationsImpl {
             name: data.name,
             description: data.description,
             createdAt: data.createdAt || new Date().toISOString(),
-            accessType: "owner",
-            permissions: { read: true, create: true, update: true, delete: true, admin: true, owner: true },
+            accessType: data.accessType || "owner",
+            permissions: data.permissions || {
+                read: true,
+                create: true,
+                update: true,
+                delete: true,
+                admin: true,
+                owner: true,
+            },
         };
     }
     /**
@@ -3525,8 +3577,8 @@ class OrganizationOperationsImpl {
      */
     async get(did) {
         try {
-            const orgs = await this.list();
-            return orgs.find((o) => o.did === did) ?? null;
+            const { organizations } = await this.list();
+            return organizations.find((o) => o.did === did) ?? null;
         }
         catch {
             return null;
@@ -3535,7 +3587,10 @@ class OrganizationOperationsImpl {
     /**
      * Lists organizations the current user has access to.
      *
-     * @returns Promise resolving to array of organization info
+     * @param params - Optional pagination parameters
+     * @param params.limit - Maximum number of results (1-100, default 50)
+     * @param params.cursor - Pagination cursor from previous response
+     * @returns Promise resolving to organizations and optional cursor
      * @throws {@link NetworkError} if the list operation fails
      *
      * @remarks
@@ -3547,21 +3602,25 @@ class OrganizationOperationsImpl {
      *
      * @example
      * ```typescript
-     * const orgs = await repo.organizations.list();
+     * // Get first page
+     * const page1 = await repo.organizations.list({ limit: 20 });
+     * console.log(`Found ${page1.organizations.length} organizations`);
      *
-     * // Filter by access type
-     * const owned = orgs.filter(o => o.accessType === "owner");
-     * const collaborated = orgs.filter(o => o.accessType === "collaborator");
+     * // Get next page if available
+     * if (page1.cursor) {
+     *   const page2 = await repo.organizations.list({ limit: 20, cursor: page1.cursor });
+     * }
      *
-     * console.log(`You own ${owned.length} organizations`);
-     * console.log(`You collaborate on ${collaborated.length} organizations`);
+     * // Filter by access type
+     * const owned = page1.organizations.filter(o => o.accessType === "owner");
+     * const shared = page1.organizations.filter(o => o.accessType === "shared");
      * ```
      *
      * @example Display organization details
      * ```typescript
-     * const orgs = await repo.organizations.list();
+     * const { organizations } = await repo.organizations.list();
      *
-     * for (const org of orgs) {
+     * for (const org of organizations) {
      *   console.log(`${org.name} (@${org.handle})`);
      *   console.log(`  DID: ${org.did}`);
      *   console.log(`  Access: ${org.accessType}`);
@@ -3571,21 +3630,38 @@ class OrganizationOperationsImpl {
      * }
      * ```
      */
-    async list() {
-        const response = await this.session.fetchHandler(`${this.serverUrl}/xrpc/com.sds.organization.list?userDid=${encodeURIComponent(this.session.did || this.session.sub)}`, { method: "GET" });
+    async list(params) {
+        const userDid = this.session.did || this.session.sub;
+        if (!userDid) {
+            throw new NetworkError("No authenticated user found");
+        }
+        const queryParams = new URLSearchParams({
+            userDid,
+        });
+        if (params?.limit !== undefined) {
+            queryParams.set("limit", params.limit.toString());
+        }
+        if (params?.cursor) {
+            queryParams.set("cursor", params.cursor);
+        }
+        const response = await this.session.fetchHandler(`${this.serverUrl}/xrpc/com.sds.organization.list?${queryParams.toString()}`, { method: "GET" });
         if (!response.ok) {
             throw new NetworkError(`Failed to list organizations: ${response.statusText}`);
         }
         const data = await response.json();
-        return (data.repositories || []).map((r) => ({
+        const organizations = (data.organizations || []).map((r) => ({
             did: r.did,
             handle: r.handle,
             name: r.name,
             description: r.description,
-            createdAt: new Date().toISOString(), // SDS may not return this
+            createdAt: r.createdAt || new Date().toISOString(),
             accessType: r.accessType,
             permissions: r.permissions,
         }));
+        return {
+            organizations,
+            cursor: data.cursor,
+        };
     }
 }
 
@@ -4508,9 +4584,10 @@ const OrganizationSchema = zod.z.object({
     /**
      * How the current user relates to this organization.
      * - `"owner"`: User created or owns the organization
-     * - `"collaborator"`: User was invited to collaborate
+     * - `"shared"`: User was invited to collaborate (has permissions)
+     * - `"none"`: User has no access to this organization
      */
-    accessType: zod.z.enum(["owner", "collaborator"]),
+    accessType: zod.z.enum(["owner", "shared", "none"]),
 });
 /**
  * Zod schema for collaborator data.