@tinycloud/web-sdk 3.11.0 → 3.12.0-beta.1

package/dist/modules/tcw.d.ts

@@ -17,7 +17,7 @@ import { type BrowserProvider, type BrowserWalletProvider } from "../adapters/br
 import { type TinyCloudUI, type UiConfig } from "../ui";
 import { RPCProviders, ClientConfig } from "../providers";
 import type { NotificationConfig } from "../notifications/types";
-import type { PortableDelegation, DelegatedAccess } from "@tinycloud/node-sdk/core";
+import type { PortableDelegation, DelegatedAccess, SpaceHosting } from "@tinycloud/node-sdk/core";
 import { CredentialsService } from "../credentials";
 import { ShareReceiverService, type ShareReceiverServiceOptions } from "../share";
 declare global {
@@ -181,6 +181,11 @@ export interface SessionRestoreResult {
     session?: ClientSession;
     error?: Error;
 }
+/** A session storage that can fence a signed-out session (BrowserSessionStorage); others rely on the in-memory block. */
+export type FenceCapableStorage = ISessionStorage & {
+    markSignedOut?: (address: string, signature: string) => void;
+    isSignedOut?: (address: string, signature: string) => boolean;
+};
 /**
  * Result of receiving a share link.
  */
@@ -195,6 +200,8 @@ export interface ShareReceiveResult<T = unknown> {
 export declare class TinyCloudWeb {
     private openkeySignInInFlight;
     private prepareSignInToken;
+    /** How long a restore waits for the node's hosting answer. */
+    private spaceHostingCapMs;
     private preparedSignIn?;
     private invalidatePreparedSignIn;
     /** The connected wallet's raw EIP-1193 provider. */
@@ -231,6 +238,7 @@ export declare class TinyCloudWeb {
     private signOutInFlight;
     private persistedRestoreBlocked;
     private signOutCleanupFailed;
+    private remoteSignOutTimeoutMs;
     private readonly pendingRestoreAddresses;
     private _secrets;
     private _credentialsService?;
@@ -329,6 +337,8 @@ export declare class TinyCloudWeb {
     get delegations(): DelegationManager;
     get capabilityRegistry(): ICapabilityKeyRegistry;
     get spaceId(): string | undefined;
+    /** The node's last answer for whether the primary space is hosted (`"unknown"` until it has answered). */
+    get spaceHosting(): SpaceHosting;
     get accountSpaceId(): string | undefined;
     get account(): AccountService;
     get hosts(): string[];
@@ -377,6 +387,9 @@ export declare class TinyCloudWeb {
     private trackRestoreAddress;
     private untrackRestoreAddress;
     restoreSession(address?: string): Promise<SessionRestoreResult>;
+    /** One node read for the restored session, held to {@link spaceHostingCapMs}; past it, or on any failure, the answer stays unknown. */
+    private probeSpaceHosting;
+    private restoredSessionNotHosted;
     clearPersistedSession(address?: string): Promise<void>;
     private configuredManifestPermissions;
     /**
@@ -399,6 +412,12 @@ export declare class TinyCloudWeb {
      * unavailable until a fresh sign-in; prior persisted sessions cannot restore.
      */
     signOut: () => Promise<void>;
+    /**
+     * Clears the stored session for `address` only while it is the signing-out session (`ownSignature`); a newer
+     * session saved for the same address is left alone. The session is fenced first, so that a clear that fails
+     * cannot let a reload restore it.
+     */
+    private clearOwnPersistedSession;
     session: () => ClientSession | undefined;
     address: () => string | undefined;
     chainId: () => number | undefined;

package/dist/space-hosting-entry.d.ts

@@ -0,0 +1,3 @@
+/** Space hosting probe and space creation, loaded when the first hosting check or creation runs. */
+export { askSpaceHosting, createPrimarySpace } from "@tinycloud/node-sdk/space-hosting";
+//# sourceMappingURL=space-hosting-entry.d.ts.map

package/dist/space-hosting.cjs

@@ -0,0 +1 @@
+(()=>{"use strict";var e={d:(t,a)=>{for(var n in a)e.o(a,n)&&!e.o(t,n)&&Object.defineProperty(t,n,{enumerable:!0,get:a[n]})},o:(e,t)=>Object.prototype.hasOwnProperty.call(e,t),r:e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})}},t={};e.r(t),e.d(t,{askSpaceHosting:()=>h,createPrimarySpace:()=>f});var a=new WeakMap,n=5e3,o="tinycloud.kv/list",c="tinycloud.kv/metadata",s="tinycloud.kv/get",i="tinycloud.space/info",r=e=>""===e||e.endsWith("/")||e.endsWith("/*")||e.endsWith("/**"),d=e=>e.endsWith("/**")?e.slice(0,-2):e.endsWith("/*")?e.slice(0,-1):"/"===e?"":e,p=e=>r(e)?`${d(e)}.tinycloud-space-probe`:e;async function u(e,t){try{const{spaceId:a}=e,o=await e.fetch(`${e.host}/invoke`,{method:"POST",headers:{...e.sign([{spaceId:a,service:t.service,path:t.path,action:t.action}]),...t.headers},body:t.body,signal:AbortSignal.timeout(n)});return o.ok?(o.body instanceof ReadableStream&&await o.body.cancel().catch(()=>{}),"hosted"):401===o.status||403===o.status?"refused":404===o.status?/space not found/i.test(await o.text())?"not-hosted":"hosted":"unknown"}catch{return"unknown"}}async function h(e){const t=function({spaceId:e,operations:t,covers:a}){const n=t.filter(t=>!t.caveats?.length&&a(t,{spaceId:e,service:t.service,path:t.path,action:t.action})),u=(t,o)=>n.filter(n=>a(n,{spaceId:e,service:t,path:n.path,action:o}));return[...u("kv",o).map(e=>({service:"kv",path:r(e.path)?d(e.path):e.path,action:o,headers:{"x-tinycloud-limit":"1"}})),...u("kv",c).map(e=>({service:"kv",path:p(e.path),action:c})),...u("space",i).map(()=>({service:"space",path:"",action:i,body:"{}"})),...u("kv",s).map(e=>({service:"kv",path:p(e.path),action:s}))].find(t=>n.some(n=>a(n,{spaceId:e,service:t.service,path:t.path,action:t.action})))}(e);if(!t)return"unknown";const h=`${e.host} ${e.spaceId.replace(/^(tinycloud:pkh:eip155:\d+:)(0x[0-9a-fA-F]{40})/,(e,t,a)=>t+a.toLowerCase())}`;if(a.get(e.scope)?.has(h))return"hosted";let l=await u(e,t);if("refused"===l){try{await e.activate(AbortSignal.timeout(n))}catch{return"unknown"}l=await u(e,t)}return"hosted"===l&&a.set(e.scope,(a.get(e.scope)??new Set).add(h)),"refused"===l?"unknown":l}function l(e){const t=e.error?.trim();return t?`${e.status} - ${t}`:`${e.status}`}async function f({handler:e,context:t,guard:a,host:n,onHosted:o,activate:c}){if(await a(),!await e.confirmSpaceCreation(t))return;try{const e=await n();if(!e.success)throw Object.assign(new Error(`Failed to create space ${t.spaceId}: ${l(e)}`),{cause:e})}catch(a){throw e.onSpaceCreationFailed?.(t,a instanceof Error?a:new Error(String(a))),a}o(),await new Promise(e=>setTimeout(e,100));const s=await c();if(!s.success){const a=Object.assign(new Error(`Failed to activate session after creating space: ${l(s)}`),{cause:s});throw e.onSpaceCreationFailed?.(t,a),a}e.onSpaceCreated?.(t)}module.exports=t})();

package/dist/space-hosting.mjs

@@ -0,0 +1 @@
+var t=new WeakMap,e="tinycloud.kv/list",a="tinycloud.kv/metadata",n="tinycloud.kv/get",s="tinycloud.space/info",c=t=>""===t||t.endsWith("/")||t.endsWith("/*")||t.endsWith("/**"),i=t=>t.endsWith("/**")?t.slice(0,-2):t.endsWith("/*")?t.slice(0,-1):"/"===t?"":t,o=t=>c(t)?`${i(t)}.tinycloud-space-probe`:t;async function r(t,e){try{const{spaceId:a}=t,n=await t.fetch(`${t.host}/invoke`,{method:"POST",headers:{...t.sign([{spaceId:a,service:e.service,path:e.path,action:e.action}]),...e.headers},body:e.body,signal:AbortSignal.timeout(5e3)});return n.ok?(n.body instanceof ReadableStream&&await n.body.cancel().catch(()=>{}),"hosted"):401===n.status||403===n.status?"refused":404===n.status?/space not found/i.test(await n.text())?"not-hosted":"hosted":"unknown"}catch{return"unknown"}}async function d(d){const p=function({spaceId:t,operations:r,covers:d}){const p=r.filter(e=>!e.caveats?.length&&d(e,{spaceId:t,service:e.service,path:e.path,action:e.action})),h=(e,a)=>p.filter(n=>d(n,{spaceId:t,service:e,path:n.path,action:a}));return[...h("kv",e).map(t=>({service:"kv",path:c(t.path)?i(t.path):t.path,action:e,headers:{"x-tinycloud-limit":"1"}})),...h("kv",a).map(t=>({service:"kv",path:o(t.path),action:a})),...h("space",s).map(()=>({service:"space",path:"",action:s,body:"{}"})),...h("kv",n).map(t=>({service:"kv",path:o(t.path),action:n}))].find(e=>p.some(a=>d(a,{spaceId:t,service:e.service,path:e.path,action:e.action})))}(d);if(!p)return"unknown";const h=`${d.host} ${d.spaceId.replace(/^(tinycloud:pkh:eip155:\d+:)(0x[0-9a-fA-F]{40})/,(t,e,a)=>e+a.toLowerCase())}`;if(t.get(d.scope)?.has(h))return"hosted";let u=await r(d,p);if("refused"===u){try{await d.activate(AbortSignal.timeout(5e3))}catch{return"unknown"}u=await r(d,p)}return"hosted"===u&&t.set(d.scope,(t.get(d.scope)??new Set).add(h)),"refused"===u?"unknown":u}function p(t){const e=t.error?.trim();return e?`${t.status} - ${e}`:`${t.status}`}async function h({handler:t,context:e,guard:a,host:n,onHosted:s,activate:c}){if(await a(),!await t.confirmSpaceCreation(e))return;try{const t=await n();if(!t.success)throw Object.assign(new Error(`Failed to create space ${e.spaceId}: ${p(t)}`),{cause:t})}catch(a){throw t.onSpaceCreationFailed?.(e,a instanceof Error?a:new Error(String(a))),a}s(),await new Promise(t=>setTimeout(t,100));const i=await c();if(!i.success){const a=Object.assign(new Error(`Failed to activate session after creating space: ${p(i)}`),{cause:i});throw t.onSpaceCreationFailed?.(e,a),a}t.onSpaceCreated?.(e)}export{d as askSpaceHosting,h as createPrimarySpace};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tinycloud/web-sdk",
-  "version": "3.11.0",
+  "version": "3.12.0-beta.1",
   "description": "A set of tools and utilities to help you build your app with TinyCloud.",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -66,7 +66,7 @@
     "@multiformats/multiaddr": "^13.0.1",
     "@multiformats/multiaddr-to-uri": "^12.0.0",
     "@noble/curves": "^1.9.7",
-    "@tinycloud/node-sdk": "3.11.0",
+    "@tinycloud/node-sdk": "3.12.0-beta.1",
     "@tinycloud/replica": "0.4.4",
     "@tinycloud/sdk-core": "3.11.0",
     "@tinycloud/share-envelope": "1.5.0",