@w6w/react 0.9.12 → 0.9.13

package/README.md

@@ -6,7 +6,7 @@ surface (`me`, `documents`, `vars`, `connections`, `workflows`, `functions`, `ru
 `createW6WUiAdapter`, a structural bridge from a `W6WClient` to
 [`@w6w/ui`](https://github.com/w6w-io/w6w-ui)'s `W6WApi` contract.
 
-License: MIT · Version: 0.9.12 · Guides: [docs.w6w.io/clients/react](https://docs.w6w.io/clients/react/)
+License: MIT · Version: 0.9.13 · Guides: [docs.w6w.io/clients/react](https://docs.w6w.io/clients/react/)
 (with a [hooks reference](https://docs.w6w.io/clients/react/hooks/) and a
 [Next.js walkthrough](https://docs.w6w.io/clients/react/nextjs/))
 
@@ -22,7 +22,7 @@ npm install @w6w/react react
 
 `@w6w/sdk` comes in as a dependency. Add it to your own `package.json` too
 (`npm install @w6w/sdk`) if you import from it directly — `ApiError` for an
-`instanceof` check, or `exchangeToken` from `@w6w/sdk/server` on your backend.
+`instanceof` check, or `createEmbedSessionClient` from `@w6w/sdk/server` on your backend.
 
 `react-dom` is not a dependency of this package — `<W6WProvider>`'s only JSX is a
 context wrapper (`<Ctx.Provider>`), never a DOM element of its own. Your app already
@@ -76,7 +76,23 @@ function DocList() {
 
 A host juggling more than one signed-in identity — or one that does not have a
 token/identity yet at mount time — needs more than the Quick start's one-shot
-`token` prop. `<W6WProvider>` takes five more props for exactly this:
+`token` prop. `<W6WProvider>` takes more props for exactly this:
+
+- **`getSession`** (with **`renewBeforeMs`**, default `30000`) — instead of `token`,
+  one `() => Promise<{token, expiresAt, expiresIn?}>` callback that calls your
+  backend's session endpoint. The provider calls it lazily and one call at a time,
+  caches the session, renews it before expiry (never later than half the
+  session's lifetime) and re-checks when a hidden tab becomes visible; you write
+  no cache or timer. Pass exactly one of `token` or `getSession` (both, or
+  neither, throws). Needs 0.9.13 or later. `useW6WSession()` returns
+  `{status, expiresAt, error, refresh}`, where `status` is `"loading"`, `"ready"`,
+  `"renewing"`, `"expired"` or `"error"`. Keep the identity switch in
+  `identityKey` (it must change when the user or account behind `getSession`
+  does). Place the provider above any `<Suspense>` boundary that can re-suspend: one
+  above or around it detaches the store, and reads error with "disposed" until it
+  re-shows. A mutation in flight at an identity switch is not cancelled, keeps the
+  old client's request and token, still lands its result in the hook's state, and
+  that state is not reset (unchanged).
 
 - **`ready`** (default `true`) — set it `false` until you actually have a
   token/identity to embed with. While `false`, every read hook reports
@@ -105,26 +121,24 @@ token/identity yet at mount time — needs more than the Quick start's one-shot
 
 import { W6WProvider } from "@w6w/react";
 
+// Your own backend route: it holds the tenant credentials and answers with a
+// session ({ token, expiresAt, ... }) for this signed-in user, built with
+// `createEmbedSessionClient` from `@w6w/sdk/server`.
+async function getSession() {
+  const res = await fetch("/api/w6w-session", { method: "POST" });
+  if (!res.ok) throw new Error(`session route answered ${res.status}`);
+  return res.json();
+}
+
 export default function W6WLayout({ children }: { children: React.ReactNode }) {
   return (
     <W6WProvider
       baseUrl="https://api.example.com"
-      ready={true}
+      getSession={getSession}
       identityKey={`${session.subject}:${session.account}`}
       headers={{ "X-W6W-Tenant": session.tenantId }}
       refreshOnUnauthorized
       onUnauthorized={() => redirectToLogin()}
-      token={async () => {
-        // Your own backend route, not w6w's — it holds whatever credential
-        // mints a w6w token for this signed-in user (a tenant exchange, a
-        // cached short-lived token, …). This is a Next.js App Router layout,
-        // so it is a Client Component ("use client" above) even though the
-        // token-minting route itself runs on your server.
-        const res = await fetch("/api/w6w-token");
-        if (!res.ok) return null;
-        const { token } = await res.json();
-        return token;
-      }}
     >
       {children}
     </W6WProvider>
@@ -133,8 +147,7 @@ export default function W6WLayout({ children }: { children: React.ReactNode }) {
 ```
 
 The [Next.js walkthrough](https://docs.w6w.io/clients/react/nextjs/) builds the
-`/api/w6w-token` route this example fetches from, with `exchangeToken` and a
-cached, refreshable token supplier.
+`/api/w6w-session` route this example fetches from, with `createEmbedSessionClient`.
 
 ## Using this package with `@w6w/ui`
 
@@ -199,6 +212,10 @@ To update the pin, change the npm version in `package.json`, refresh
 `package-lock.json`, and run `npm test` and `npm run build`. These checks report
 any incompatible UI contract changes.
 
+On Node older than 22.18, run the local gate as
+`NODE_OPTIONS=--experimental-strip-types npm test` (the tests load `.ts` files directly;
+CI uses Node 24).
+
 **Runtime conformance.** Assignability is checked at compile time only, so it cannot
 see a member that is typed but missing or mis-wired at run time.
 `src/__tests__/adapter-conformance.test.ts` closes that gap. It reads the member names

package/dist/mod.d.ts

@@ -14,6 +14,7 @@
  */
 export { VERSION } from "./src/version.ts";
 export { type TokenSource, useW6WClient, W6WProvider, type W6WProviderProps, } from "./src/W6WProvider.tsx";
+export { useW6WSession, type W6WSession, type W6WSessionState, type W6WSessionStatus, } from "./src/session.ts";
 export { type MutationResult, type ReadResult, useArchiveWorkflow, useConnections, useCreateDocument, useCreateFunction, useCreateVar, useCreateWorkflow, useDeleteDocument, useDeleteFunction, useDeleteVar, useDeleteWorkflow, useDocument, useDocumentByKey, useDocuments, useFunction, useFunctions, useMe, useRun, useRunWorkflow, useUpdateDocument, useUpdateFunction, useUpdateVar, useUpdateWorkflow, useVar, useVars, useWorkflow, useWorkflows, } from "./src/hooks.ts";
 export { createW6WUiAdapter, type W6WApi } from "./src/adapter.ts";
 export { type FlowEdgeShape, type FlowStepShape, type FlowWorkflowShape, fromFlowWorkflow, toFlowWorkflow, WorkflowShapeError, type WorkflowShapeIssue, } from "./src/flow-workflow.ts";

package/dist/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../mod.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,OAAO,EACL,KAAK,WAAW,EAChB,YAAY,EACZ,WAAW,EACX,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,KAAK,EACL,MAAM,EACN,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,MAAM,EACN,OAAO,EACP,WAAW,EACX,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAEnE,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../mod.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,OAAO,EACL,KAAK,WAAW,EAChB,YAAY,EACZ,WAAW,EACX,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,aAAa,EACb,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,KAAK,EACL,MAAM,EACN,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,MAAM,EACN,OAAO,EACP,WAAW,EACX,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAEnE,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAC"}

package/dist/mod.js

@@ -15,6 +15,7 @@
  */
 export { VERSION } from "./src/version.js";
 export { useW6WClient, W6WProvider, } from "./src/W6WProvider.js";
+export { useW6WSession, } from "./src/session.js";
 export { useArchiveWorkflow, useConnections, useCreateDocument, useCreateFunction, useCreateVar, useCreateWorkflow, useDeleteDocument, useDeleteFunction, useDeleteVar, useDeleteWorkflow, useDocument, useDocumentByKey, useDocuments, useFunction, useFunctions, useMe, useRun, useRunWorkflow, useUpdateDocument, useUpdateFunction, useUpdateVar, useUpdateWorkflow, useVar, useVars, useWorkflow, useWorkflows, } from "./src/hooks.js";
 export { createW6WUiAdapter } from "./src/adapter.js";
 export { fromFlowWorkflow, toFlowWorkflow, WorkflowShapeError, } from "./src/flow-workflow.js";

package/dist/mod.js.map

@@ -1 +1 @@
-{"version":3,"file":"mod.js","sourceRoot":"","sources":["../mod.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,OAAO,EAEL,YAAY,EACZ,WAAW,GAEZ,MAAM,sBAAuB,CAAC;AAE/B,OAAO,EAGL,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,KAAK,EACL,MAAM,EACN,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,MAAM,EACN,OAAO,EACP,WAAW,EACX,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAe,MAAM,kBAAkB,CAAC;AAEnE,OAAO,EAIL,gBAAgB,EAChB,cAAc,EACd,kBAAkB,GAEnB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../mod.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,OAAO,EAEL,YAAY,EACZ,WAAW,GAEZ,MAAM,sBAAuB,CAAC;AAE/B,OAAO,EACL,aAAa,GAId,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAGL,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,KAAK,EACL,MAAM,EACN,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,MAAM,EACN,OAAO,EACP,WAAW,EACX,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAe,MAAM,kBAAkB,CAAC;AAEnE,OAAO,EAIL,gBAAgB,EAChB,cAAc,EACd,kBAAkB,GAEnB,MAAM,wBAAwB,CAAC"}

package/dist/src/W6WProvider.d.ts

@@ -39,13 +39,34 @@
  */
 import { type ApiError, type FetchLike, type TokenProvider, W6WClient } from "@w6w/sdk";
 import { type ReactNode } from "react";
+import { SessionStore, type W6WSession } from "./session.ts";
 /** A static bearer token, or a supplier called per request (concurrent requests share one call). */
 export type TokenSource = string | TokenProvider;
-export interface W6WProviderProps {
-    /** The w6w server's origin, e.g. `"https://api.example.com"`. */
-    baseUrl: string;
+/**
+ * Exactly one credential source: a `token` (string, or a supplier called per
+ * request) OR a `getSession` callback whose session the provider caches,
+ * renews before expiry and re-checks on tab resume (see `useW6WSession`).
+ */
+export type W6WCredentialProps = {
     /** A literal bearer token, or a supplier called per request (concurrent requests share one call). */
     token: TokenSource;
+    getSession?: never;
+    renewBeforeMs?: never;
+} | {
+    token?: never;
+    /**
+     * Mints a session (`{token, expiresAt, expiresIn?}`). Called lazily, at
+     * most once at a time; the result is cached until `renewBeforeMs` (capped
+     * at half the session's lifetime) before it expires. Always the LATEST
+     * callback, read through a ref.
+     */
+    getSession: () => Promise<W6WSession>;
+    /** Renew this long before expiry. Default `30_000`. */
+    renewBeforeMs?: number;
+};
+export type W6WProviderProps = {
+    /** The w6w server's origin, e.g. `"https://api.example.com"`. */
+    baseUrl: string;
     /**
      * The real transport this provider's stable `fetch` wrapper delegates to.
      * Defaults to `globalThis.fetch`. Mainly for tests — a caller wanting to
@@ -89,9 +110,11 @@ export interface W6WProviderProps {
      */
     onUnauthorized?: (error: ApiError) => void;
     children: ReactNode;
-}
+} & W6WCredentialProps;
 interface W6WContextValue {
     client: W6WClient;
+    /** The `getSession` store, or `null` for a `token` provider. Read by `useW6WSession`. */
+    session: SessionStore | null;
     /** Mirrors the `ready` prop. Read by `hooks.ts`'s `useAsync`, never by `useW6WClient`. */
     ready: boolean;
 }

package/dist/src/W6WProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"W6WProvider.d.ts","sourceRoot":"","sources":["../../src/W6WProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACxF,OAAO,EAAE,KAAK,SAAS,EAA8C,MAAM,OAAO,CAAC;AAEnF,oGAAoG;AACpG,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,aAAa,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,qGAAqG;IACrG,KAAK,EAAE,WAAW,CAAC;IACnB;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC3C,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,UAAU,eAAe;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,0FAA0F;IAC1F,KAAK,EAAE,OAAO,CAAC;CAChB;AAeD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,CAqE9D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,SAAS,CASxC;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CASvD"}
+{"version":3,"file":"W6WProvider.d.ts","sourceRoot":"","sources":["../../src/W6WProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACxF,OAAO,EACL,KAAK,SAAS,EAOf,MAAM,OAAO,CAAC;AACf,OAAO,EAA2B,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAEtF,oGAAoG;AACpG,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,aAAa,CAAC;AAEjD;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IACE,qGAAqG;IACrG,KAAK,EAAE,WAAW,CAAC;IACnB,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,aAAa,CAAC,EAAE,KAAK,CAAC;CACvB,GACD;IACE,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;;;OAKG;IACH,UAAU,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IACtC,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEN,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC3C,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,kBAAkB,CAAC;AAEvB,UAAU,eAAe;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,yFAAyF;IACzF,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,0FAA0F;IAC1F,KAAK,EAAE,OAAO,CAAC;CAChB;AAeD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,CAiH9D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,SAAS,CASxC;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CASvD"}

package/dist/src/W6WProvider.js

@@ -39,7 +39,8 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * @module
  */
 import { W6WClient } from "@w6w/sdk";
-import { createContext, useContext, useMemo, useRef } from "react";
+import { createContext, useContext, useEffect, useLayoutEffect, useMemo, useRef, } from "react";
+import { DEFAULT_RENEW_BEFORE_MS, SessionStore } from "./session.js";
 const Ctx = createContext(null);
 /**
  * Canonical encoding of a headers object for the `useMemo` dependency array —
@@ -57,7 +58,19 @@ function headersKey(headers) {
  * memoization policy.
  */
 export function W6WProvider(props) {
-    const { baseUrl, token, fetch: fetchOverride, project, headers, ready = true, identityKey, refreshOnUnauthorized, onUnauthorized, children, } = props;
+    const { baseUrl, token, getSession, renewBeforeMs, fetch: fetchOverride, project, headers, ready = true, identityKey, refreshOnUnauthorized, onUnauthorized, children, } = props;
+    const hasToken = token !== undefined && token !== null;
+    const hasSession = getSession !== undefined && getSession !== null;
+    // An explicit-but-undefined `token` (`token={maybeToken}` while signed out)
+    // behaves exactly as before this prop pair existed: legacy token mode, the
+    // SDK rejects the blank value per request. Only a provider with NEITHER key
+    // present is real misuse.
+    const legacyUndefinedToken = !hasToken && !hasSession && "token" in props && !("getSession" in props);
+    if (hasToken === hasSession && !legacyUndefinedToken) {
+        throw new Error(hasToken
+            ? "<W6WProvider> takes exactly one of `token` or `getSession`, not both."
+            : "<W6WProvider> needs exactly one of `token` or `getSession`.");
+    }
     // "Latest ref" pattern: kept in sync on every render, but never a `useMemo`
     // dependency below — the stable wrappers constructed inside always read the
     // CURRENT prop value through these, so a token rotation, a new `fetch`
@@ -70,6 +83,10 @@ export function W6WProvider(props) {
     // the moment the memo recomputes.
     const tokenRef = useRef(token);
     tokenRef.current = token;
+    const getSessionRef = useRef(getSession);
+    getSessionRef.current = getSession;
+    const renewBeforeMsRef = useRef(renewBeforeMs);
+    renewBeforeMsRef.current = renewBeforeMs;
     const fetchRef = useRef(fetchOverride);
     fetchRef.current = fetchOverride;
     const onUnauthorizedRef = useRef(onUnauthorized);
@@ -77,7 +94,7 @@ export function W6WProvider(props) {
     const headersRef = useRef(headers);
     headersRef.current = headers;
     const headersSnapshot = headersKey(headers);
-    const client = useMemo(() => {
+    const { client, store } = useMemo(() => {
         // `identityKey` and `headersSnapshot` are not otherwise read in this body
         // — they exist purely so this memo depends on them (identity switch;
         // headers content change, per this module's header). Referencing them
@@ -85,7 +102,17 @@ export function W6WProvider(props) {
         // `useExhaustiveDependencies` from treating them as superfluous.
         void identityKey;
         void headersSnapshot;
+        // Born and killed with this memo (i.e. with `identityKey`); disposed by the
+        // effect below, never here (StrictMode double-invokes memo bodies).
+        const store = hasSession
+            ? new SessionStore(() => {
+                const fn = getSessionRef.current;
+                return fn ? fn() : Promise.reject(new Error("getSession was removed"));
+            }, () => renewBeforeMsRef.current ?? DEFAULT_RENEW_BEFORE_MS)
+            : null;
         const stableToken = (ctx) => {
+            if (store)
+                return store.supplier(ctx);
             const current = tokenRef.current;
             return typeof current === "function" ? current(ctx) : current;
         };
@@ -96,7 +123,7 @@ export function W6WProvider(props) {
         const stableOnUnauthorized = (error) => {
             onUnauthorizedRef.current?.(error);
         };
-        return new W6WClient({
+        const client = new W6WClient({
             baseUrl,
             project,
             token: stableToken,
@@ -105,8 +132,14 @@ export function W6WProvider(props) {
             refreshOnUnauthorized,
             onUnauthorized: stableOnUnauthorized,
         });
-    }, [baseUrl, project, identityKey, refreshOnUnauthorized, headersSnapshot]);
-    const value = useMemo(() => ({ client, ready }), [client, ready]);
+        return { client, store };
+    }, [baseUrl, project, identityKey, refreshOnUnauthorized, headersSnapshot, hasSession]);
+    // Listener/timer lifecycle + late-discard of the OLD store on identity change.
+    (typeof document === "undefined" ? useEffect : useLayoutEffect)(() => {
+        store?.attach();
+        return () => store?.detach();
+    }, [store]);
+    const value = useMemo(() => ({ client, ready, session: store }), [client, ready, store]);
     return _jsx(Ctx.Provider, { value: value, children: children });
 }
 /**

package/dist/src/W6WProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"W6WProvider.js","sourceRoot":"","sources":["../../src/W6WProvider.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"W6WProvider.js","sourceRoot":"","sources":["../../src/W6WProvider.tsx"],"names":[],"mappings":"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"}

package/dist/src/session.d.ts

@@ -0,0 +1,51 @@
+/** What `getSession` resolves to. A structural supertype of `@w6w/sdk/server`'s `EmbedSession`. */
+export interface W6WSession {
+    token: string;
+    /** ISO-8601 instant the token stops being valid. */
+    expiresAt: string;
+    /** Seconds the token lives from receipt; bounds a far-future `expiresAt` (clock skew). */
+    expiresIn?: number;
+}
+export type W6WSessionStatus = "loading" | "ready" | "renewing" | "expired" | "error";
+export interface W6WSessionState {
+    status: W6WSessionStatus;
+    /** The cached session's `expiresAt`, or `null` (no session yet, or a `token`-mode provider). */
+    expiresAt: string | null;
+    /** The last acquisition failure, until the next acquisition starts. */
+    error: unknown;
+    /** Starts (or joins) an acquisition. Resolves when it settles; never rejects — read `error`. */
+    refresh(): Promise<void>;
+}
+/** Default `renewBeforeMs`. */
+export declare const DEFAULT_RENEW_BEFORE_MS = 30000;
+export declare class SessionStore {
+    #private;
+    constructor(getSession: () => Promise<W6WSession>, renewBeforeMs: () => number);
+    subscribe: (listener: () => void) => (() => void);
+    getSnapshot: () => W6WSessionState;
+    refresh: () => Promise<void>;
+    /** `forceRefresh` JOINS an acquisition already in flight, else starts exactly one. */
+    supplier: (ctx?: {
+        forceRefresh?: boolean;
+    }) => Promise<string>;
+    /**
+     * Called from the provider's effect. Disposal is DEFERRED one microtask (the
+     * same refcount idiom `hooks.ts` uses for its abort controller): React
+     * StrictMode runs mount -> cleanup -> mount synchronously, and descendants'
+     * passive effects (a read hook's first request) have already entered the
+     * supplier by the time the cleanup runs, so tearing the flight down at
+     * cleanup would reject that request ("stale acquisition"). A re-attach in
+     * the same task simply cancels the pending disposal; a real unmount or
+     * identity change disposes one microtask later.
+     */
+    attach(): void;
+    detach(): void;
+}
+/**
+ * The provider's session state. With a `getSession` provider it mirrors the
+ * store; with a `token` provider `status` is `"ready"` when the provider's
+ * `ready` is true (else `"loading"`), `expiresAt` is `null` and `refresh()`
+ * resolves without calling anything.
+ */
+export declare function useW6WSession(): W6WSessionState;
+//# sourceMappingURL=session.d.ts.map

package/dist/src/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"AAqBA,mGAAmG;AACnG,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AAEtF,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,gBAAgB,CAAC;IACzB,gGAAgG;IAChG,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uEAAuE;IACvE,KAAK,EAAE,OAAO,CAAC;IACf,gGAAgG;IAChG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,+BAA+B;AAC/B,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAiB9C,qBAAa,YAAY;;gBAeX,UAAU,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,EAAE,aAAa,EAAE,MAAM,MAAM;IAQ9E,SAAS,GAAI,UAAU,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAK9C;IAEF,WAAW,QAAO,eAAe,CAAmB;IAEpD,OAAO,QAAa,OAAO,CAAC,IAAI,CAAC,CAG/B;IAIF,sFAAsF;IACtF,QAAQ,GAAU,MAAM;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,KAAG,OAAO,CAAC,MAAM,CAAC,CAelE;IAIF;;;;;;;;;OASG;IACH,MAAM,IAAI,IAAI;IASd,MAAM,IAAI,IAAI;CAiIf;AAKD;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,eAAe,CAgB/C"}

package/dist/src/session.js

@@ -0,0 +1,249 @@
+/**
+ * The session store behind `<W6WProvider getSession>` and `useW6WSession()`.
+ *
+ * A host hands the provider ONE callback that mints a short-lived session
+ * (`{token, expiresAt, expiresIn?}`). The store caches the session until
+ * shortly before it expires, shares one acquisition between every caller,
+ * re-checks when a hidden tab becomes visible again, and is born and killed
+ * with the provider's `identityKey` (it is created inside the client
+ * `useMemo`), so an identity switch can never send the previous identity's
+ * token: a disposed store commits nothing and its supplier throws.
+ *
+ * Layering: `@w6w/sdk` already calls the token supplier per request, dedups
+ * CONCURRENT ordinary supplier calls and owns the one-shot 401 retry
+ * (`refreshOnUnauthorized`, `forceRefresh: true`). This store adds only the
+ * cache + single-flight acquisition + resume/expiry handling on top.
+ *
+ * @module
+ */
+import { useMemo, useSyncExternalStore } from "react";
+import { useW6WProviderContext } from "./W6WProvider.js";
+/** Default `renewBeforeMs`. */
+export const DEFAULT_RENEW_BEFORE_MS = 30_000;
+const MAX_TIMER_MS = 2_147_483_647;
+export class SessionStore {
+    #getSession;
+    #renewBeforeMs;
+    #held = null;
+    #flight = null;
+    #error = null;
+    #hasError = false;
+    /** Bumped on disposal: an acquisition from an older epoch never commits. */
+    #epoch = 0;
+    #dead = false;
+    #attached = false;
+    #timer;
+    #listeners = new Set();
+    #snapshot;
+    constructor(getSession, renewBeforeMs) {
+        this.#getSession = getSession;
+        this.#renewBeforeMs = renewBeforeMs;
+        this.#snapshot = this.#compute();
+    }
+    // ── external-store surface ─────────────────────────────────────────────
+    subscribe = (listener) => {
+        this.#listeners.add(listener);
+        return () => {
+            this.#listeners.delete(listener);
+        };
+    };
+    getSnapshot = () => this.#snapshot;
+    refresh = async () => {
+        if (this.#dead)
+            return;
+        await (this.#flight ? this.#flight.promise : this.#start());
+    };
+    // ── the stable supplier handed to the SDK ──────────────────────────────
+    /** `forceRefresh` JOINS an acquisition already in flight, else starts exactly one. */
+    supplier = async (ctx) => {
+        if (this.#dead)
+            throw new Error("w6w session store was disposed (identity changed or unmounted)");
+        const held = this.#held;
+        if (ctx?.forceRefresh !== true && held && Date.now() < held.expiry - held.window) {
+            return held.token;
+        }
+        const outcome = await (this.#flight ? this.#flight.promise : this.#start());
+        if (this.#dead || !outcome) {
+            throw new Error("w6w session store was disposed (identity changed or unmounted)");
+        }
+        if (outcome.ok)
+            return outcome.token;
+        const still = this.#held;
+        if (still && Date.now() < still.expiry)
+            return still.token;
+        throw outcome.error;
+    };
+    // ── lifecycle (effect-driven; disposal deferred so StrictMode's remount works) ─
+    /**
+     * Called from the provider's effect. Disposal is DEFERRED one microtask (the
+     * same refcount idiom `hooks.ts` uses for its abort controller): React
+     * StrictMode runs mount -> cleanup -> mount synchronously, and descendants'
+     * passive effects (a read hook's first request) have already entered the
+     * supplier by the time the cleanup runs, so tearing the flight down at
+     * cleanup would reject that request ("stale acquisition"). A re-attach in
+     * the same task simply cancels the pending disposal; a real unmount or
+     * identity change disposes one microtask later.
+     */
+    attach() {
+        this.#dead = false;
+        this.#attached = true;
+        if (typeof document !== "undefined") {
+            document.addEventListener("visibilitychange", this.#onVisibility);
+        }
+        this.#schedule();
+    }
+    detach() {
+        this.#attached = false;
+        if (this.#timer !== undefined)
+            clearTimeout(this.#timer);
+        this.#timer = undefined;
+        if (typeof document !== "undefined") {
+            document.removeEventListener("visibilitychange", this.#onVisibility);
+        }
+        queueMicrotask(() => {
+            if (this.#attached || this.#dead)
+                return;
+            this.#dead = true;
+            this.#epoch += 1;
+            this.#flight = null;
+        });
+    }
+    // ── internals ──────────────────────────────────────────────────────────
+    #visible() {
+        return typeof document !== "undefined" && document.visibilityState === "visible";
+    }
+    #onVisibility = () => {
+        if (this.#dead || !this.#visible() || this.#flight || this.#hasError)
+            return;
+        const held = this.#held;
+        if (!held || Date.now() >= held.expiry - held.window)
+            void this.#start();
+        else
+            this.#update();
+    };
+    #start() {
+        const epoch = this.#epoch;
+        const flight = {};
+        this.#flight = flight;
+        this.#hasError = false;
+        this.#error = null;
+        this.#update();
+        const run = async () => {
+            let outcome;
+            try {
+                const session = await this.#getSession();
+                const held = this.#toHeld(session);
+                if (epoch !== this.#epoch)
+                    return { ok: false, error: new Error("stale acquisition") };
+                this.#held = held;
+                outcome = { ok: true, token: held.token };
+            }
+            catch (error) {
+                if (epoch !== this.#epoch)
+                    return { ok: false, error };
+                this.#hasError = true;
+                this.#error = error;
+                outcome = { ok: false, error };
+            }
+            if (this.#flight === flight)
+                this.#flight = null;
+            this.#update();
+            this.#schedule();
+            return outcome;
+        };
+        flight.promise = run();
+        return flight.promise;
+    }
+    #toHeld(session) {
+        const receivedAt = Date.now();
+        if (!session || typeof session.token !== "string" || session.token.trim().length === 0) {
+            throw new Error("getSession returned a blank token");
+        }
+        let expiry = Date.parse(session.expiresAt);
+        if (Number.isNaN(expiry))
+            throw new Error("getSession returned an invalid expiresAt");
+        if (typeof session.expiresIn === "number" && Number.isFinite(session.expiresIn)) {
+            expiry = Math.min(expiry, receivedAt + session.expiresIn * 1000);
+        }
+        const window = Math.max(0, Math.min(this.#renewBeforeMs(), (expiry - receivedAt) / 2));
+        return { token: session.token, expiresAt: session.expiresAt, expiry, window };
+    }
+    #schedule() {
+        if (this.#timer !== undefined)
+            clearTimeout(this.#timer);
+        this.#timer = undefined;
+        const held = this.#held;
+        if (!this.#attached || !held)
+            return;
+        const now = Date.now();
+        const renewAt = held.expiry - held.window;
+        const target = now < renewAt ? renewAt : now < held.expiry ? held.expiry : null;
+        if (target === null)
+            return;
+        this.#timer = setTimeout(this.#tick, Math.min(Math.max(0, target - now), MAX_TIMER_MS));
+    }
+    #tick = () => {
+        this.#timer = undefined;
+        if (this.#dead)
+            return;
+        const held = this.#held;
+        if (held &&
+            !this.#flight &&
+            !this.#hasError &&
+            this.#visible() &&
+            Date.now() >= held.expiry - held.window) {
+            void this.#start(); // updates + reschedules itself on settle
+        }
+        this.#update();
+        this.#schedule();
+    };
+    #compute() {
+        const held = this.#held;
+        let status;
+        if (this.#flight)
+            status = held ? "renewing" : "loading";
+        else if (this.#hasError)
+            status = "error";
+        else if (!held)
+            status = "loading";
+        else
+            status = Date.now() >= held.expiry ? "expired" : "ready";
+        return {
+            status,
+            expiresAt: held ? held.expiresAt : null,
+            error: this.#error,
+            refresh: this.refresh,
+        };
+    }
+    #update() {
+        const next = this.#compute();
+        const prev = this.#snapshot;
+        if (next.status === prev.status &&
+            next.expiresAt === prev.expiresAt &&
+            next.error === prev.error) {
+            return;
+        }
+        this.#snapshot = next;
+        for (const listener of [...this.#listeners])
+            listener();
+    }
+}
+const noopSubscribe = () => () => { };
+const noopRefresh = () => Promise.resolve();
+/**
+ * The provider's session state. With a `getSession` provider it mirrors the
+ * store; with a `token` provider `status` is `"ready"` when the provider's
+ * `ready` is true (else `"loading"`), `expiresAt` is `null` and `refresh()`
+ * resolves without calling anything.
+ */
+export function useW6WSession() {
+    const { session, ready } = useW6WProviderContext();
+    const tokenState = useMemo(() => ({
+        status: ready ? "ready" : "loading",
+        expiresAt: null,
+        error: null,
+        refresh: noopRefresh,
+    }), [ready]);
+    return useSyncExternalStore(session ? session.subscribe : noopSubscribe, session ? session.getSnapshot : () => tokenState, session ? session.getSnapshot : () => tokenState);
+}
+//# sourceMappingURL=session.js.map

package/dist/src/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"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"}

package/dist/src/version.js

@@ -15,5 +15,5 @@
  * every wrapper's version in lockstep, and that pattern depends on the literal
  * `: string` shape being present.
  */
-export const VERSION = "0.9.12";
+export const VERSION = "0.9.13";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@w6w/react",
-  "version": "0.9.12",
+  "version": "0.9.13",
   "description": "React bindings for @w6w/sdk — a <W6WProvider>, a small hook set, and a structural adapter for @w6w/ui's W6WApi contract.",
   "license": "MIT",
   "repository": {
@@ -44,7 +44,7 @@
     "react": ">=18"
   },
   "dependencies": {
-    "@w6w/sdk": "^0.9.12"
+    "@w6w/sdk": "^0.9.13"
   },
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",