@hypercerts-org/sdk-core 0.4.0-beta.0 → 0.6.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,27 @@ class CollaboratorOperationsImpl {
             return "editor";
         return "viewer";
     }
+    /**
+     * Normalizes permissions from SDS API format to SDK format.
+     *
+     * The SDS API returns permissions as an object with boolean flags
+     * (e.g., `{ read: true, create: true, update: false, ... }`).
+     * This method ensures all expected fields are present with default values.
+     *
+     * @param permissions - Permissions object from SDS API
+     * @returns Normalized permission flags object
+     * @internal
+     */
+    parsePermissions(permissions) {
+        return {
+            read: permissions.read ?? false,
+            create: permissions.create ?? false,
+            update: permissions.update ?? false,
+            delete: permissions.delete ?? false,
+            admin: permissions.admin ?? false,
+            owner: permissions.owner ?? false,
+        };
+    }
     /**
      * Grants repository access to a user.
      *
@@ -3194,7 +3215,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 +3227,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 +3292,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 +3314,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 +3521,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 +3543,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 +3578,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 +3588,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 +3603,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 +3631,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,
+        };
     }
 }
 
@@ -3697,6 +3774,9 @@ class Repository {
         this.logger = logger;
         // Create Agent with OAuth session
         this.agent = new api.Agent(session);
+        // Configure Agent to use the specified server URL (PDS or SDS)
+        // This ensures queries are routed to the correct server
+        this.agent.api.xrpc.uri = new URL(serverUrl);
         this.lexiconRegistry.addToAgent(this.agent);
         // Register hypercert lexicons
         this.lexiconRegistry.registerMany(lexicon.HYPERCERT_LEXICONS);
@@ -4508,9 +4588,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.