@synonymdev/pubky 0.10.0 → 0.12.0

package/README.md

@@ -1,6 +1,6 @@
 # Pubky
 
-JS/WASM SDK for [Pubky](https://github.com/pubky/pubky-core).
+JS/WASM SDK for [Pubky](https://github.com/pubky/pubky-homeserver).
 
 Works in browsers and Node 20+.
 
@@ -56,7 +56,7 @@ const addr = `${userPk}/pub/my-cool-app/hello.json`;
 const json = await pubky.publicStorage.getJson(addr); // -> { hello: "world" }
 ```
 
-Find here [**ready-to-run examples**](https://github.com/pubky/pubky-core/tree/main/examples).
+Find here [**ready-to-run examples**](https://github.com/pubky/pubky-homeserver/tree/main/examples).
 
 ### Key formats (display vs transport)
 
@@ -417,7 +417,7 @@ Path rules:
 
 **Convention:** put your app’s public data under a domain-like folder in `/pub`, e.g. `/pub/my-new-app/`.
 
-See [Private Storage](https://github.com/pubky/pubky-core/blob/main/docs/PRIVATE_STORAGE.md) for `/priv/` access and events.
+See [Private Storage](https://github.com/pubky/pubky-homeserver/blob/main/docs/PRIVATE_STORAGE.md) for `/priv/` access and events.
 
 ---
 
@@ -467,7 +467,7 @@ import { resolvePubky } from "@synonymdev/pubky";
 const identifier =
   "pubkyoperrr8wsbpr3ue9d4qj41ge1kcc6r7fdiy6o3ugjrrhi4y77rdo/pub/pubky.app/posts/0033X02JAN0SG";
 const url = resolvePubky(identifier);
-// -> "https://_pubky.operrr8wsbpr3ue9d4qj41ge1kcc6r7fdiy6o3ugjrrhi4y77rdo/pub/pubky.app/posts/0033X02JAN0SG"
+// -> "https://_pubky.operrr8wsbpr3ue9d4qj41ge1kcc6r7fdiy6o3ugjrrhi4y77rdo/storage/operrr8wsbpr3ue9d4qj41ge1kcc6r7fdiy6o3ugjrrhi4y77rdo/pub/pubky.app/posts/0033X02JAN0SG"
 ```
 
 Both `pubky<pk>/…` (preferred) and `pubky://<pk>/…` resolve to the same HTTPS endpoint.

package/index.cjs

@@ -559,6 +559,8 @@ class AuthFlow {
      * @returns {AuthFlow} A flow reconnected to the original relay channel.
      * @throws {PubkyError}
      * - `{ name: "AuthenticationError" }` if the URL is invalid or not a signin/signup link
+     *
+     * @deprecated Use `GrantAuthFlow.resume(...)` instead.
      * @param {string} authorization_url
      * @returns {AuthFlow}
      */
@@ -978,7 +980,7 @@ class Client {
      *
      * @example
      * const client = pubky.client;
-     * const res = await client.fetch(`https://_pubky.${user}/pub/app/file.txt`, { method: "PUT", body: "hi", credentials: "include" });
+     * const res = await client.fetch(`https://_pubky.${user}/storage/${user}/pub/app/file.txt`, { method: "PUT", body: "hi", credentials: "include" });
      * @param {string} url
      * @param {RequestInit | null} [init]
      * @returns {Promise<Response>}
@@ -1055,8 +1057,9 @@ exports.Client = Client;
 /**
  * Cookie-only view over a cookie-backed `Session`.
  *
- * Grant-backed sessions do not expose this view; use `session.cookie` and
- * check for `undefined` before calling cookie-specific methods.
+ * New applications should use `session.grant` and `GrantSession`.
+ *
+ * @deprecated Use `GrantSession` instead.
  */
 class CookieSession {
     static __wrap(ptr) {
@@ -1083,6 +1086,7 @@ class CookieSession {
      * still hold the HTTP-only cookie.
      *
      * @returns {string}
+     * @deprecated Use `GrantSession.exportLocalSecret()` instead.
      * @returns {string}
      */
     export() {
@@ -1110,6 +1114,7 @@ class CookieSession {
      * Node.js. Browser sessions cannot read HTTP-only Set-Cookie values.
      *
      * @returns {Promise<string>}
+     * @deprecated Use `GrantSession.exportLocalSecret()` instead.
      * @returns {Promise<string>}
      */
     exportSecret() {
@@ -1197,7 +1202,10 @@ class DirectSignupDeepLink {
      */
     get xCallback() {
         const ret = wasm.directsignupdeeplink_xCallback(this.__wbg_ptr);
-        return ret;
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
     }
 }
 if (Symbol.dispose) DirectSignupDeepLink.prototype[Symbol.dispose] = DirectSignupDeepLink.prototype.free;
@@ -2617,6 +2625,8 @@ class Pubky {
      *     sessionStorage.removeItem("pubky-auth-url");
      *   }
      * }
+     *
+     * @deprecated Use `resumeGrantAuthFlow(...)` instead.
      * @param {string} authorization_url
      * @returns {AuthFlow}
      */
@@ -2715,6 +2725,8 @@ class Pubky {
      * const flow = pubky.startCookieAuthFlow("/pub/my-cool-app/:rw");
      * renderQr(flow.authorizationUrl);
      * const session = await flow.awaitApproval();
+     *
+     * @deprecated Use `startGrantAuthFlow(...)` instead.
      * @param {Capabilities} capabilities
      * @param {AuthFlowKind} kind
      * @param {string | null} [relay]
@@ -3208,7 +3220,10 @@ class SeedExportDeepLink {
      */
     get xCallback() {
         const ret = wasm.seedexportdeeplink_xCallback(this.__wbg_ptr);
-        return ret;
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
     }
 }
 if (Symbol.dispose) SeedExportDeepLink.prototype[Symbol.dispose] = SeedExportDeepLink.prototype.free;
@@ -3243,6 +3258,7 @@ class Session {
      * Grant-backed sessions return `undefined`.
      *
      * @returns {CookieSession|undefined}
+     * @deprecated Use `session.grant` and `GrantSession` instead.
      * @returns {CookieSession | undefined}
      */
     get cookie() {
@@ -3258,7 +3274,7 @@ class Session {
      * @returns {string}
      * A base64 string to store (e.g. in `localStorage`).
      *
-     * @deprecated Prefer `exportLocalSecret()` for grant sessions.
+     * @deprecated Use `GrantSession.exportLocalSecret()` instead.
      * @returns {string}
      */
     export() {
@@ -3326,7 +3342,7 @@ class Session {
      * Optional client to reuse transport configuration.
      * @returns {Promise<Session>}
      *
-     * @deprecated Prefer `Pubky.restoreSession(...)`.
+     * @deprecated Use `Pubky.restoreSession(...)` with a grant secret.
      * @param {string} exported
      * @param {Client | null} [client]
      * @returns {Promise<Session>}
@@ -3896,7 +3912,10 @@ class SigninDeepLink {
      */
     get xCallback() {
         const ret = wasm.signindeeplink_xCallback(this.__wbg_ptr);
-        return ret;
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
     }
 }
 if (Symbol.dispose) SigninDeepLink.prototype[Symbol.dispose] = SigninDeepLink.prototype.free;
@@ -4044,7 +4063,10 @@ class SigninGrantDeepLink {
      */
     get xCallback() {
         const ret = wasm.signingrantdeeplink_xCallback(this.__wbg_ptr);
-        return ret;
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
     }
 }
 if (Symbol.dispose) SigninGrantDeepLink.prototype[Symbol.dispose] = SigninGrantDeepLink.prototype.free;
@@ -4158,7 +4180,10 @@ class SignupDeepLink {
      */
     get xCallback() {
         const ret = wasm.signupdeeplink_xCallback(this.__wbg_ptr);
-        return ret;
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
     }
 }
 if (Symbol.dispose) SignupDeepLink.prototype[Symbol.dispose] = SignupDeepLink.prototype.free;
@@ -4331,7 +4356,10 @@ class SignupGrantDeepLink {
      */
     get xCallback() {
         const ret = wasm.signupgrantdeeplink_xCallback(this.__wbg_ptr);
-        return ret;
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
     }
 }
 if (Symbol.dispose) SignupGrantDeepLink.prototype[Symbol.dispose] = SignupGrantDeepLink.prototype.free;
@@ -4488,7 +4516,7 @@ exports.StoredSessionInfo = StoredSessionInfo;
  * Resolve a `pubky://` or `pubky<pk>/…` identifier into the homeserver transport URL.
  *
  * @param {string} identifier Either `pubky<pk>/...` (preferred) or `pubky://<pk>/...`.
- * @returns {string} HTTPS URL in the form `https://_pubky.<pk>/...`.
+ * @returns {string} HTTPS URL in the form `https://_pubky.<pk>/storage/<pk>/...`.
  * @param {string} identifier
  * @returns {string}
  */
@@ -4654,7 +4682,7 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___pubkyGrantDelegatedSign_baf43129fcab486a: function(arg0, arg1, arg2, arg3) {
+        __wbg___pubkyGrantDelegatedSign_87e16b32eae17a22: function(arg0, arg1, arg2, arg3) {
             let deferred0_0;
             let deferred0_1;
             let deferred1_0;
@@ -4671,7 +4699,7 @@ function __wbg_get_imports() {
                 wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
             }
         },
-        __wbg___pubkyGrantDeleteDelegatedKey_b804f38c7d1c9f02: function(arg0, arg1) {
+        __wbg___pubkyGrantDeleteDelegatedKey_7d7da7cd71dce615: function(arg0, arg1) {
             let deferred0_0;
             let deferred0_1;
             try {
@@ -4683,7 +4711,7 @@ function __wbg_get_imports() {
                 wasm.__wbindgen_free(deferred0_0, deferred0_1, 1);
             }
         },
-        __wbg___pubkyGrantEnsureDelegatedKey_fac9f866c1535b2b: function(arg0, arg1) {
+        __wbg___pubkyGrantEnsureDelegatedKey_34881f231299cc4a: function(arg0, arg1) {
             let v0;
             if (arg0 !== 0) {
                 v0 = getStringFromWasm0(arg0, arg1).slice();
@@ -4692,7 +4720,7 @@ function __wbg_get_imports() {
             const ret = __pubkyGrantEnsureDelegatedKey(v0);
             return ret;
         },
-        __wbg___pubkyGrantLoadDelegatedPublicKey_9ca30750499f5f94: function(arg0, arg1) {
+        __wbg___pubkyGrantLoadDelegatedPublicKey_16f016956b406b8c: function(arg0, arg1) {
             let deferred0_0;
             let deferred0_1;
             try {
@@ -4704,7 +4732,7 @@ function __wbg_get_imports() {
                 wasm.__wbindgen_free(deferred0_0, deferred0_1, 1);
             }
         },
-        __wbg___pubkySessionStoreDelete_7cb295a5954a418e: function(arg0, arg1) {
+        __wbg___pubkySessionStoreDelete_2e61bae48f1d8ad3: function(arg0, arg1) {
             let deferred0_0;
             let deferred0_1;
             try {
@@ -4716,7 +4744,7 @@ function __wbg_get_imports() {
                 wasm.__wbindgen_free(deferred0_0, deferred0_1, 1);
             }
         },
-        __wbg___pubkySessionStoreGet_da62f0ae45d9c363: function(arg0, arg1) {
+        __wbg___pubkySessionStoreGet_407c7588524a0336: function(arg0, arg1) {
             let deferred0_0;
             let deferred0_1;
             try {
@@ -4903,7 +4931,7 @@ function __wbg_get_imports() {
             const ret = arg0.fetch(arg1);
             return ret;
         },
-        __wbg_fetch_33145dbeacf93251: function(arg0) {
+        __wbg_fetch_95c377e5d416f01c: function(arg0) {
             const ret = fetch(arg0);
             return ret;
         },
@@ -4911,12 +4939,12 @@ function __wbg_get_imports() {
             const ret = Array.from(arg0);
             return ret;
         },
-        __wbg_getRandomValues_76dfc69825c9c552: function() { return handleError(function (arg0, arg1) {
-            globalThis.crypto.getRandomValues(getArrayU8FromWasm0(arg0, arg1));
-        }, arguments); },
         __wbg_getRandomValues_c44a50d8cfdaebeb: function() { return handleError(function (arg0, arg1) {
             arg0.getRandomValues(arg1);
         }, arguments); },
+        __wbg_getRandomValues_cc7f052a444bb2ce: function() { return handleError(function (arg0, arg1) {
+            globalThis.crypto.getRandomValues(getArrayU8FromWasm0(arg0, arg1));
+        }, arguments); },
         __wbg_getReader_9facd4f899beac89: function() { return handleError(function (arg0) {
             const ret = arg0.getReader();
             return ret;
@@ -5098,7 +5126,7 @@ function __wbg_get_imports() {
                     const a = state0.a;
                     state0.a = 0;
                     try {
-                        return wasm_bindgen_77cee878d4ea2fd9___convert__closures_____invoke___js_sys_4b0493a0be09c0f___Function_fn_wasm_bindgen_77cee878d4ea2fd9___JsValue_____wasm_bindgen_77cee878d4ea2fd9___sys__Undefined___js_sys_4b0493a0be09c0f___Function_fn_wasm_bindgen_77cee878d4ea2fd9___JsValue_____wasm_bindgen_77cee878d4ea2fd9___sys__Undefined_______true_(a, state0.b, arg0, arg1);
+                        return wasm_bindgen_48024d4b44a05752___convert__closures_____invoke___js_sys_c85ed8012f263b9d___Function_fn_wasm_bindgen_48024d4b44a05752___JsValue_____wasm_bindgen_48024d4b44a05752___sys__Undefined___js_sys_c85ed8012f263b9d___Function_fn_wasm_bindgen_48024d4b44a05752___JsValue_____wasm_bindgen_48024d4b44a05752___sys__Undefined_______true_(a, state0.b, arg0, arg1);
                     } finally {
                         state0.a = a;
                     }
@@ -5335,18 +5363,18 @@ function __wbg_get_imports() {
             console.warn(arg0, arg1, arg2, arg3);
         },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 129, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm_bindgen_77cee878d4ea2fd9___convert__closures_____invoke___wasm_bindgen_77cee878d4ea2fd9___JsValue__core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_77cee878d4ea2fd9___JsError___true_);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 132, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm_bindgen_48024d4b44a05752___convert__closures_____invoke___wasm_bindgen_48024d4b44a05752___JsValue__core_ed718c3d60ebd546___result__Result_____wasm_bindgen_48024d4b44a05752___JsError___true_);
             return ret;
         },
         __wbindgen_cast_0000000000000002: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 265, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm_bindgen_77cee878d4ea2fd9___convert__closures_____invoke___wasm_bindgen_77cee878d4ea2fd9___JsValue______true_);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 272, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm_bindgen_48024d4b44a05752___convert__closures_____invoke___wasm_bindgen_48024d4b44a05752___JsValue______true_);
             return ret;
         },
         __wbindgen_cast_0000000000000003: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 263, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm_bindgen_77cee878d4ea2fd9___convert__closures_____invoke_______true_);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 270, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm_bindgen_48024d4b44a05752___convert__closures_____invoke_______true_);
             return ret;
         },
         __wbindgen_cast_0000000000000004: function(arg0) {
@@ -5408,33 +5436,33 @@ function __wbg_get_imports() {
     return {
         __proto__: null,
         "./pubky_bg.js": import0,
-        "./snippets/pubky-wasm-7b1db7d819d81131/inline1.js": import1,
-        "./snippets/pubky-wasm-7b1db7d819d81131/inline0.js": import2,
-        "./snippets/pubky-wasm-7b1db7d819d81131/inline0.js": import3,
-        "./snippets/pubky-wasm-7b1db7d819d81131/inline0.js": import4,
-        "./snippets/pubky-wasm-7b1db7d819d81131/inline0.js": import5,
-        "./snippets/pubky-wasm-7b1db7d819d81131/inline0.js": import6,
-        "./snippets/pubky-wasm-7b1db7d819d81131/inline1.js": import7,
+        "./snippets/pubky-wasm-25477c7ca91d0b66/inline1.js": import1,
+        "./snippets/pubky-wasm-25477c7ca91d0b66/inline0.js": import2,
+        "./snippets/pubky-wasm-25477c7ca91d0b66/inline0.js": import3,
+        "./snippets/pubky-wasm-25477c7ca91d0b66/inline0.js": import4,
+        "./snippets/pubky-wasm-25477c7ca91d0b66/inline0.js": import5,
+        "./snippets/pubky-wasm-25477c7ca91d0b66/inline0.js": import6,
+        "./snippets/pubky-wasm-25477c7ca91d0b66/inline1.js": import7,
     };
 }
 
-function wasm_bindgen_77cee878d4ea2fd9___convert__closures_____invoke_______true_(arg0, arg1) {
-    wasm.wasm_bindgen_77cee878d4ea2fd9___convert__closures_____invoke_______true_(arg0, arg1);
+function wasm_bindgen_48024d4b44a05752___convert__closures_____invoke_______true_(arg0, arg1) {
+    wasm.wasm_bindgen_48024d4b44a05752___convert__closures_____invoke_______true_(arg0, arg1);
 }
 
-function wasm_bindgen_77cee878d4ea2fd9___convert__closures_____invoke___wasm_bindgen_77cee878d4ea2fd9___JsValue______true_(arg0, arg1, arg2) {
-    wasm.wasm_bindgen_77cee878d4ea2fd9___convert__closures_____invoke___wasm_bindgen_77cee878d4ea2fd9___JsValue______true_(arg0, arg1, arg2);
+function wasm_bindgen_48024d4b44a05752___convert__closures_____invoke___wasm_bindgen_48024d4b44a05752___JsValue______true_(arg0, arg1, arg2) {
+    wasm.wasm_bindgen_48024d4b44a05752___convert__closures_____invoke___wasm_bindgen_48024d4b44a05752___JsValue______true_(arg0, arg1, arg2);
 }
 
-function wasm_bindgen_77cee878d4ea2fd9___convert__closures_____invoke___wasm_bindgen_77cee878d4ea2fd9___JsValue__core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_77cee878d4ea2fd9___JsError___true_(arg0, arg1, arg2) {
-    const ret = wasm.wasm_bindgen_77cee878d4ea2fd9___convert__closures_____invoke___wasm_bindgen_77cee878d4ea2fd9___JsValue__core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_77cee878d4ea2fd9___JsError___true_(arg0, arg1, arg2);
+function wasm_bindgen_48024d4b44a05752___convert__closures_____invoke___wasm_bindgen_48024d4b44a05752___JsValue__core_ed718c3d60ebd546___result__Result_____wasm_bindgen_48024d4b44a05752___JsError___true_(arg0, arg1, arg2) {
+    const ret = wasm.wasm_bindgen_48024d4b44a05752___convert__closures_____invoke___wasm_bindgen_48024d4b44a05752___JsValue__core_ed718c3d60ebd546___result__Result_____wasm_bindgen_48024d4b44a05752___JsError___true_(arg0, arg1, arg2);
     if (ret[1]) {
         throw takeFromExternrefTable0(ret[0]);
     }
 }
 
-function wasm_bindgen_77cee878d4ea2fd9___convert__closures_____invoke___js_sys_4b0493a0be09c0f___Function_fn_wasm_bindgen_77cee878d4ea2fd9___JsValue_____wasm_bindgen_77cee878d4ea2fd9___sys__Undefined___js_sys_4b0493a0be09c0f___Function_fn_wasm_bindgen_77cee878d4ea2fd9___JsValue_____wasm_bindgen_77cee878d4ea2fd9___sys__Undefined_______true_(arg0, arg1, arg2, arg3) {
-    wasm.wasm_bindgen_77cee878d4ea2fd9___convert__closures_____invoke___js_sys_4b0493a0be09c0f___Function_fn_wasm_bindgen_77cee878d4ea2fd9___JsValue_____wasm_bindgen_77cee878d4ea2fd9___sys__Undefined___js_sys_4b0493a0be09c0f___Function_fn_wasm_bindgen_77cee878d4ea2fd9___JsValue_____wasm_bindgen_77cee878d4ea2fd9___sys__Undefined_______true_(arg0, arg1, arg2, arg3);
+function wasm_bindgen_48024d4b44a05752___convert__closures_____invoke___js_sys_c85ed8012f263b9d___Function_fn_wasm_bindgen_48024d4b44a05752___JsValue_____wasm_bindgen_48024d4b44a05752___sys__Undefined___js_sys_c85ed8012f263b9d___Function_fn_wasm_bindgen_48024d4b44a05752___JsValue_____wasm_bindgen_48024d4b44a05752___sys__Undefined_______true_(arg0, arg1, arg2, arg3) {
+    wasm.wasm_bindgen_48024d4b44a05752___convert__closures_____invoke___js_sys_c85ed8012f263b9d___Function_fn_wasm_bindgen_48024d4b44a05752___JsValue_____wasm_bindgen_48024d4b44a05752___sys__Undefined___js_sys_c85ed8012f263b9d___Function_fn_wasm_bindgen_48024d4b44a05752___JsValue_____wasm_bindgen_48024d4b44a05752___sys__Undefined_______true_(arg0, arg1, arg2, arg3);
 }