@synonymdev/pubky 0.16.0 → 0.16.2

package/package.json

@@ -2,7 +2,7 @@
   "name": "@synonymdev/pubky",
   "type": "module",
   "description": "Decentralized identity, auth flows, and user-owned storage",
-  "version": "0.16.0",
+  "version": "0.16.2",
   "license": "MIT",
   "repository": {
     "type": "git",

package/pubky.d.ts

@@ -2051,8 +2051,10 @@ export class SessionStorage {
      * @param {Uint8Array} body
      * @returns {Promise<void>}
      * @throws {PubkyError} A lock that has expired or was unlocked rejects with
-     * `RequestError` and status `412`; take a new one and read the file again.
-     * Otherwise as {@link SessionStorage.putBytes}.
+     * `RequestError` and status `412`; take a new one and read the file again. A file
+     * that changed since the write was prepared rejects with status `409`, which can
+     * happen when an earlier change the storage backend ran late lands first; read it
+     * again and retry. Otherwise as {@link SessionStorage.putBytes}.
      */
     putBytesLocked(lock: StorageLock, body: Uint8Array): Promise<void>;
     /**
@@ -2081,8 +2083,10 @@ export class SessionStorage {
      * @param {string} body
      * @returns {Promise<void>}
      * @throws {PubkyError} A lock that has expired or was unlocked rejects with
-     * `RequestError` and status `412`; take a new one and read the file again.
-     * Otherwise as {@link SessionStorage.putText}.
+     * `RequestError` and status `412`; take a new one and read the file again. A file
+     * that changed since the write was prepared rejects with status `409`, which can
+     * happen when an earlier change the storage backend ran late lands first; read it
+     * again and retry. Otherwise as {@link SessionStorage.putText}.
      */
     putTextLocked(lock: StorageLock, body: string): Promise<void>;
     /**
@@ -2143,9 +2147,21 @@ export class Signer {
     free(): void;
     [Symbol.dispose](): void;
     /**
-     * Approve a `pubkyauth://` request URL (encrypts & POSTs the signed AuthToken).
+     * Approve all capabilities in a `pubkyauth://` auth request URL.
      */
     approveAuthRequest(pubkyauth_url: string): Promise<void>;
+    /**
+     * Approve selected capabilities in a `pubkyauth://` auth request URL.
+     *
+     * Scopes and actions must be covered by the request. An empty string
+     * approves no capabilities. V1 grants deliver keys only for approved `e`
+     * scopes. Supports grant and legacy signin/signup requests.
+     * Invalid capabilities or approvals exceeding the request fail before POST.
+     *
+     * @example
+     * await signer.approveAuthWithCapabilities(authUrl, "/pub/example.app/:r");
+     */
+    approveAuthWithCapabilities(pubkyauth_url: string, approved_capabilities: string): Promise<void>;
     /**
      * Create a signer from a `Keypair` (prefer `pubky.signer(kp)`).
      *