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

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @hypercerts-org/sdk-core@0.1.0 build /home/runner/work/hypercerts-sdk/hypercerts-sdk/packages/sdk-core
+> @hypercerts-org/sdk-core@0.3.0 build /home/runner/work/hypercerts-sdk/hypercerts-sdk/packages/sdk-core
 > rollup -c
 
 
@@ -154,7 +154,7 @@
                 ~~~~~
     '$link' is declared here.
 
-created dist/errors.mjs, dist/errors.cjs in 2.1s
+created dist/errors.mjs, dist/errors.cjs in 1.9s
 
 /home/runner/work/hypercerts-sdk/hypercerts-sdk/packages/sdk-core/src/lexicons.ts → dist/lexicons.mjs, dist/lexicons.cjs...
 (!) [plugin typescript] src/repository/BlobOperationsImpl.ts (125:9): @rollup/plugin-typescript TS2741: Property '$link' is missing in type 'CID<unknown, number, number, Version>' but required in type '{ $link: string; }'.
@@ -205,7 +205,7 @@
                 ~~~~~
     '$link' is declared here.
 
-created dist/lexicons.mjs, dist/lexicons.cjs in 1.8s
+created dist/lexicons.mjs, dist/lexicons.cjs in 1.9s
 
 /home/runner/work/hypercerts-sdk/hypercerts-sdk/packages/sdk-core/src/storage.ts → dist/storage.mjs, dist/storage.cjs...
 (!) [plugin typescript] src/repository/BlobOperationsImpl.ts (125:9): @rollup/plugin-typescript TS2741: Property '$link' is missing in type 'CID<unknown, number, number, Version>' but required in type '{ $link: string; }'.
@@ -256,7 +256,7 @@
                 ~~~~~
     '$link' is declared here.
 
-created dist/storage.mjs, dist/storage.cjs in 1.7s
+created dist/storage.mjs, dist/storage.cjs in 1.8s
 
 /home/runner/work/hypercerts-sdk/hypercerts-sdk/packages/sdk-core/src/testing.ts → dist/testing.mjs, dist/testing.cjs...
 (!) [plugin typescript] src/repository/BlobOperationsImpl.ts (125:9): @rollup/plugin-typescript TS2741: Property '$link' is missing in type 'CID<unknown, number, number, Version>' but required in type '{ $link: string; }'.
@@ -307,22 +307,22 @@
                 ~~~~~
     '$link' is declared here.
 
-created dist/testing.mjs, dist/testing.cjs in 1.8s
+created dist/testing.mjs, dist/testing.cjs in 2.3s
 
 /home/runner/work/hypercerts-sdk/hypercerts-sdk/packages/sdk-core/src/index.ts → dist/index.d.ts...
-created dist/index.d.ts in 1.5s
+created dist/index.d.ts in 1.3s
 
 /home/runner/work/hypercerts-sdk/hypercerts-sdk/packages/sdk-core/src/types.ts → dist/types.d.ts...
 created dist/types.d.ts in 1.2s
 
 /home/runner/work/hypercerts-sdk/hypercerts-sdk/packages/sdk-core/src/errors.ts → dist/errors.d.ts...
-created dist/errors.d.ts in 486ms
+created dist/errors.d.ts in 484ms
 
 /home/runner/work/hypercerts-sdk/hypercerts-sdk/packages/sdk-core/src/lexicons.ts → dist/lexicons.d.ts...
-created dist/lexicons.d.ts in 1s
+created dist/lexicons.d.ts in 1.1s
 
 /home/runner/work/hypercerts-sdk/hypercerts-sdk/packages/sdk-core/src/storage.ts → dist/storage.d.ts...
-created dist/storage.d.ts in 553ms
+created dist/storage.d.ts in 544ms
 
 /home/runner/work/hypercerts-sdk/hypercerts-sdk/packages/sdk-core/src/testing.ts → dist/testing.d.ts...
-created dist/testing.d.ts in 1s
+created dist/testing.d.ts in 723ms

package/.turbo/turbo-test.log

@@ -1,15 +1,15 @@
 
-> @hypercerts-org/sdk-core@0.1.0 test /home/runner/work/hypercerts-sdk/hypercerts-sdk/packages/sdk-core
+> @hypercerts-org/sdk-core@0.3.0 test /home/runner/work/hypercerts-sdk/hypercerts-sdk/packages/sdk-core
 > vitest
 
 
  RUN  v3.2.4 /home/runner/work/hypercerts-sdk/hypercerts-sdk/packages/sdk-core
 
- ✓ tests/repository/CollaboratorOperationsImpl.test.ts (18 tests) 28ms
- ✓ tests/repository/RecordOperationsImpl.test.ts (21 tests) 33ms
- ✓ tests/repository/HypercertOperationsImpl.test.ts (30 tests) 43ms
- ✓ tests/repository/ProfileOperationsImpl.test.ts (14 tests) 26ms
- ✓ tests/repository/OrganizationOperationsImpl.test.ts (12 tests) 19ms
+ ✓ tests/repository/CollaboratorOperationsImpl.test.ts (25 tests) 26ms
+ ✓ tests/repository/RecordOperationsImpl.test.ts (21 tests) 35ms
+ ✓ tests/repository/HypercertOperationsImpl.test.ts (30 tests) 49ms
+ ✓ tests/repository/ProfileOperationsImpl.test.ts (14 tests) 24ms
+ ✓ tests/repository/OrganizationOperationsImpl.test.ts (12 tests) 20ms
  ✓ tests/repository/LexiconRegistry.test.ts (16 tests) 18ms
 stderr | tests/auth/OAuthClient.test.ts > OAuthClient > constructor > should initialize with valid config
 No lock mechanism provided. Credentials might get revoked.
@@ -51,50 +51,49 @@ No lock mechanism provided. Credentials might get revoked.
 stderr | tests/core/SDK.test.ts > ATProtoSDK > authorize > should trim identifier
 No lock mechanism provided. Credentials might get revoked.
 
- ✓ tests/repository/Repository.test.ts (12 tests) 49ms
-stderr | tests/core/SDK.test.ts > ATProtoSDK > restoreSession > should throw ValidationError for empty DID
+stderr | tests/auth/OAuthClient.test.ts > OAuthClient > callback > should throw AuthenticationError for OAuth error params
 No lock mechanism provided. Credentials might get revoked.
 
-stderr | tests/core/SDK.test.ts > ATProtoSDK > restoreSession > should handle non-existent session
+stderr | tests/auth/OAuthClient.test.ts > OAuthClient > callback > should throw AuthenticationError for missing code
 No lock mechanism provided. Credentials might get revoked.
 
-stderr | tests/auth/OAuthClient.test.ts > OAuthClient > callback > should throw AuthenticationError for OAuth error params
+stderr | tests/auth/OAuthClient.test.ts > OAuthClient > restore > should return null for non-existent session
 No lock mechanism provided. Credentials might get revoked.
 
-stderr | tests/auth/OAuthClient.test.ts > OAuthClient > callback > should throw AuthenticationError for missing code
+stderr | tests/auth/OAuthClient.test.ts > OAuthClient > restore > should throw AuthenticationError for invalid DID
 No lock mechanism provided. Credentials might get revoked.
 
-stderr | tests/core/SDK.test.ts > ATProtoSDK > revokeSession > should throw ValidationError for empty DID
+stderr | tests/auth/OAuthClient.test.ts > OAuthClient > revoke > should not throw for non-existent session
 No lock mechanism provided. Credentials might get revoked.
 
-stderr | tests/auth/OAuthClient.test.ts > OAuthClient > restore > should return null for non-existent session
+stderr | tests/auth/OAuthClient.test.ts > OAuthClient > storage integration > should use provided session store
 No lock mechanism provided. Credentials might get revoked.
 
-stderr | tests/core/SDK.test.ts > ATProtoSDK > repository > should throw ValidationError when session is null
+stderr | tests/auth/OAuthClient.test.ts > OAuthClient > storage integration > should use provided state store
 No lock mechanism provided. Credentials might get revoked.
 
-stderr | tests/auth/OAuthClient.test.ts > OAuthClient > restore > should throw AuthenticationError for invalid DID
+stderr | tests/auth/OAuthClient.test.ts > OAuthClient > logger integration > should use provided logger
 No lock mechanism provided. Credentials might get revoked.
 
-stderr | tests/core/SDK.test.ts > ATProtoSDK > repository > should throw ValidationError when PDS not configured and no server specified
+ ✓ tests/auth/OAuthClient.test.ts (14 tests) 307ms
+stderr | tests/core/SDK.test.ts > ATProtoSDK > restoreSession > should throw ValidationError for empty DID
 No lock mechanism provided. Credentials might get revoked.
 
-stderr | tests/auth/OAuthClient.test.ts > OAuthClient > revoke > should not throw for non-existent session
+stderr | tests/core/SDK.test.ts > ATProtoSDK > restoreSession > should handle non-existent session
 No lock mechanism provided. Credentials might get revoked.
 
-stderr | tests/core/SDK.test.ts > ATProtoSDK > repository > should throw ValidationError when SDS not configured and server=sds
+stderr | tests/core/SDK.test.ts > ATProtoSDK > revokeSession > should throw ValidationError for empty DID
 No lock mechanism provided. Credentials might get revoked.
 
-stderr | tests/auth/OAuthClient.test.ts > OAuthClient > storage integration > should use provided session store
+stderr | tests/core/SDK.test.ts > ATProtoSDK > repository > should throw ValidationError when session is null
 No lock mechanism provided. Credentials might get revoked.
 
-stderr | tests/auth/OAuthClient.test.ts > OAuthClient > storage integration > should use provided state store
+stderr | tests/core/SDK.test.ts > ATProtoSDK > repository > should throw ValidationError when PDS not configured and no server specified
 No lock mechanism provided. Credentials might get revoked.
 
-stderr | tests/auth/OAuthClient.test.ts > OAuthClient > logger integration > should use provided logger
+stderr | tests/core/SDK.test.ts > ATProtoSDK > repository > should throw ValidationError when SDS not configured and server=sds
 No lock mechanism provided. Credentials might get revoked.
 
- ✓ tests/auth/OAuthClient.test.ts (14 tests) 356ms
 stderr | tests/core/SDK.test.ts > ATProtoSDK > repository > should create repository with custom serverUrl
 No lock mechanism provided. Credentials might get revoked.
 
@@ -107,12 +106,13 @@ No lock mechanism provided. Credentials might get revoked.
 stderr | tests/core/SDK.test.ts > ATProtoSDK > setup examples > should work with custom storage implementations
 No lock mechanism provided. Credentials might get revoked.
 
- ✓ tests/core/SDK.test.ts (19 tests) 234ms
- ✓ tests/repository/BlobOperationsImpl.test.ts (9 tests) 12ms
+ ✓ tests/core/SDK.test.ts (19 tests) 194ms
+ ✓ tests/repository/Repository.test.ts (12 tests) 85ms
+ ✓ tests/repository/BlobOperationsImpl.test.ts (9 tests) 14ms
  ✓ tests/core/errors.test.ts (9 tests) 5ms
 
  Test Files  11 passed (11)
-      Tests  174 passed (174)
-   Start at  19:15:42
-   Duration  2.20s (transform 569ms, setup 0ms, collect 2.69s, tests 824ms, environment 2ms, prepare 1.08s)
+      Tests  181 passed (181)
+   Start at  22:12:42
+   Duration  2.16s (transform 475ms, setup 0ms, collect 2.58s, tests 777ms, environment 3ms, prepare 1.11s)
 

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # @hypercerts-org/sdk-core
 
-## 0.2.0-beta.0
+## 0.4.0-beta.0
 
 ### Minor Changes
 
@@ -11,6 +11,12 @@
 
 ### Patch Changes
 
+- [#55](https://github.com/hypercerts-org/hypercerts-sdk/pull/55)
+  [`23c3d9a`](https://github.com/hypercerts-org/hypercerts-sdk/commit/23c3d9a3b71f326df68b65420c83f7ae42c2432d) Thanks
+  [@bitbeckers](https://github.com/bitbeckers)! - Fix endpoints and NSIDs for SDS operations in CollaboratorOperations
+  and OrganizationOperations
+
 - Updated dependencies
-  [[`eda4ac2`](https://github.com/hypercerts-org/hypercerts-sdk/commit/eda4ac233e09764d83f042ba7df94d4c9884cc01)]:
-  - @hypercerts-org/lexicon@0.2.0-beta.0
+  [[`23c3d9a`](https://github.com/hypercerts-org/hypercerts-sdk/commit/23c3d9a3b71f326df68b65420c83f7ae42c2432d),
+  [`eda4ac2`](https://github.com/hypercerts-org/hypercerts-sdk/commit/eda4ac233e09764d83f042ba7df94d4c9884cc01)]:
+  - @hypercerts-org/lexicon@0.4.0-beta.0

package/README.md

@@ -77,14 +77,57 @@ const existingSession = await sdk.restoreSession("did:plc:...");
 
 ```
 repo
-├── .records      → create, get, update, delete, list
-├── .blobs        → upload, get
-├── .profile      → get, update
-├── .hypercerts   → create, get, update, delete, list, addContribution, addMeasurement
-├── .collaborators → grant, revoke, list, hasAccess (SDS only)
+├── .records       → create, get, update, delete, list
+├── .blobs         → upload, get
+├── .profile       → get, update (PDS only)
+├── .hypercerts    → create, get, update, delete, list, addContribution, addMeasurement
+├── .collaborators → grant, revoke, list, hasAccess, getRole, getPermissions, transferOwnership (SDS only)
 └── .organizations → create, get, list (SDS only)
 ```
 
+### Collaborator Operations (SDS only)
+
+```typescript
+// Grant access to a user
+await repo.collaborators.grant({
+  userDid: "did:plc:user123",
+  role: "editor", // viewer | editor | admin | owner
+});
+
+// Revoke access
+await repo.collaborators.revoke({ userDid: "did:plc:user123" });
+
+// List all collaborators
+const collaborators = await repo.collaborators.list();
+
+// Check if user has access
+const hasAccess = await repo.collaborators.hasAccess("did:plc:user123");
+
+// Get user's role
+const role = await repo.collaborators.getRole("did:plc:user123");
+
+// Get current user's permissions
+const permissions = await repo.collaborators.getPermissions();
+if (permissions.admin) {
+  // Can manage collaborators
+}
+
+// Transfer ownership (irreversible!)
+await repo.collaborators.transferOwnership({
+  newOwnerDid: "did:plc:new-owner",
+});
+```
+
+### SDS vs PDS Operations
+
+| Operation | PDS | SDS | Namespace |
+|-----------|-----|-----|-----------|
+| Records (CRUD) | ✅ | ✅ | `com.atproto.repo.*` |
+| Blobs | ✅ | ✅ | `com.atproto.repo.uploadBlob`, `com.atproto.sync.getBlob` |
+| Profile | ✅ | ❌ | `app.bsky.actor.profile` |
+| Organizations | ❌ | ✅ | `com.sds.organization.*` |
+| Collaborators | ❌ | ✅ | `com.sds.repo.*` |
+
 ## Errors
 
 ```typescript

package/dist/index.cjs

@@ -3041,9 +3041,11 @@ class HypercertOperationsImpl extends eventemitter3.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
@@ -3145,7 +3147,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({
@@ -3177,7 +3179,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({
@@ -3216,7 +3218,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}`);
         }
@@ -3277,6 +3279,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}`);
+        }
+    }
 }
 
 /**
@@ -3303,8 +3403,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
@@ -3382,7 +3482,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),
@@ -3472,7 +3572,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}`);
         }