@w6w/react 0.6.0 → 0.9.9

package/dist/src/hooks.d.ts

@@ -1,21 +1,37 @@
 /**
- * The hook set — one small primitive underneath (`useAsync` / a private
- * mutation primitive), every read/mutation hook a thin wrapper over
- * `useW6WClient()`. No react-query or any other data-fetching dependency
- * anywhere (`package.json` carries none — see README).
+ * The hook set — one small primitive underneath (`useAsync` for reads, a
+ * private mutation primitive for writes), every hook a thin wrapper over the
+ * provider's `W6WClient`. No react-query or any other data-fetching
+ * dependency anywhere (`package.json` carries none — see README).
  *
  * Built only over the PUBLIC, non-`console` surface (`me`, `documents`,
- * `vars`, `connections`, `workflows`, `run`) — `console.*` is studio-internal
- * and unstable (see README), so no hook here reaches for it.
+ * `vars`, `connections`, `workflows`, `functions`, `run`) — `console.*` is
+ * studio-internal and unstable (see README), so no hook here reaches for it.
+ * The workflow and Function definition lifecycles moved onto that public
+ * surface at contract `0.5.0`, which is why hooks for them live here now
+ * rather than being unreachable without `console.*`.
  *
- * Cancellation: `@w6w/sdk`'s transport has no `AbortSignal` to hook into
- * (`node/src/http.ts`), so a read hook can only IGNORE a result that resolves
- * after unmount (the `mountedRef` guard below), never truly abort the
- * in-flight request. See README.
+ * Cancellation and sharing: every read method a hook here calls takes an
+ * optional `signal` (`@w6w/sdk`'s `CallOptions`, threaded to the injected
+ * `fetch`'s own `RequestInit.signal`, `node/src/http.ts`). Reads are
+ * single-flighted per client (`single-flight.ts`): hooks asking for the same
+ * thing (same hook, same arguments) while a request is in flight share ONE
+ * request and one `AbortController`, and nothing is kept once it settles. The
+ * controller is refcounted — it aborts only when the LAST subscriber has gone
+ * (unmount, `identityKey`/client switch, `ready: false`) and stayed gone past
+ * a microtask, so React StrictMode's synchronous cleanup -> remount (or a
+ * second consumer) re-attaches to the flight instead of aborting and
+ * re-firing it. A stale request's resolution or rejection can never commit
+ * into a hook that has moved on, and a genuinely abandoned request is told to
+ * stop rather than merely ignored.
+ *
+ * Every read hook also gates on `ready` (`<W6WProvider ready={...}>`,
+ * default `true`): while `false`, `useAsync` never calls the fetcher at all
+ * and reports `loading: true`.
  *
  * @module
  */
-import type { ConnectionSummary, Doc, DocumentCreateInput, DocumentOptions, DocumentPatch, Me, RunEnvelope, RunInput, Var, VarCreateInput, VarPatch, WorkflowListOptions, WorkflowRunOptions, WorkflowRunResult, WorkflowSummary } from "@w6w/sdk";
+import type { ConnectionSummary, Doc, DocumentCreateInput, DocumentOptions, DocumentPatch, FunctionDefinition, FunctionDetail, FunctionSummary, Me, RunEnvelope, RunInput, Var, VarCreateInput, VarPatch, WorkflowDefinition, WorkflowDetail, WorkflowListOptions, WorkflowRunOptions, WorkflowRunResult, WorkflowSaveResult, WorkflowSummary, WorkflowWriteOptions } from "@w6w/sdk";
 /** What every read hook returns. */
 export interface ReadResult<T> {
     /** The last successfully fetched value, or `undefined` before the first resolves. */
@@ -46,6 +62,19 @@ export declare function useVars(): ReadResult<Var[]>;
 export declare function useVar(id: string): ReadResult<Var>;
 export declare function useConnections(): ReadResult<ConnectionSummary[]>;
 export declare function useWorkflows(options?: WorkflowListOptions): ReadResult<WorkflowSummary[]>;
+/**
+ * One workflow's stored definition, plus the two things that are not in it.
+ *
+ * `data.updatedAt` is the optimistic-concurrency token: hand it to
+ * {@linkcode useUpdateWorkflow}'s `ifUnmodifiedSince` and a save that would
+ * clobber someone else's edit is refused instead of winning silently. That is
+ * the whole reason this is a read hook and not just a fetch — the token has to
+ * survive from the read to the write, and a component that re-reads on every
+ * render would keep handing itself a fresh one.
+ */
+export declare function useWorkflow(id: string): ReadResult<WorkflowDetail>;
+export declare function useFunctions(): ReadResult<FunctionSummary[]>;
+export declare function useFunction(id: string): ReadResult<FunctionDetail>;
 export declare function useCreateDocument(): MutationResult<[DocumentCreateInput, DocumentOptions?], Doc>;
 export declare function useUpdateDocument(): MutationResult<[
     string,
@@ -67,4 +96,54 @@ export declare function useDeleteVar(): MutationResult<[string], void>;
  */
 export declare function useRunWorkflow(): MutationResult<[string, WorkflowRunOptions?], WorkflowRunResult>;
 export declare function useRun(): MutationResult<[RunInput], RunEnvelope>;
+/**
+ * ── The definition lifecycle ──
+ *
+ * Ten hooks over the same ten SDK methods, and three properties they inherit
+ * from it rather than invent:
+ *
+ * 1. **`create` mints the id.** The server requires one in the body and never
+ *    generates it, so `create({name, steps})` works and the `wf_…`/`fn_…` id
+ *    comes back in the result.
+ * 2. **`update` is a full replacement, not a patch.** This is the one place
+ *    these differ from `useUpdateDocument`/`useUpdateVar`, whose second
+ *    argument is a `Patch` of the fields to change. Here it is the whole
+ *    definition: read with {@linkcode useWorkflow} / {@linkcode useFunction},
+ *    spread, change, send. A component that passed only the changed fields
+ *    would delete the rest.
+ * 3. **Deleting a workflow is two calls**, `archive` then `delete`. No hook
+ *    here chains them — a UI that offers "delete" should offer the archive
+ *    step too, because that is the step a user can still change their mind
+ *    after.
+ *
+ * None of them refetch a list on success, matching every other mutation hook
+ * in this file: this lane carries no cache to invalidate (no react-query, by
+ * design — see README), so a component pairs the mutation with the read hook's
+ * own `refetch`.
+ */
+export declare function useCreateWorkflow(): MutationResult<[
+    WorkflowDefinition,
+    WorkflowWriteOptions?
+], WorkflowSaveResult>;
+export declare function useUpdateWorkflow(): MutationResult<[
+    string,
+    WorkflowDefinition,
+    WorkflowWriteOptions?
+], WorkflowSaveResult>;
+export declare function useArchiveWorkflow(): MutationResult<[string], WorkflowDefinition>;
+export declare function useDeleteWorkflow(): MutationResult<[string], void>;
+export declare function useCreateFunction(): MutationResult<[
+    FunctionDefinition
+], {
+    id: string;
+    key: string;
+}>;
+export declare function useUpdateFunction(): MutationResult<[
+    string,
+    FunctionDefinition
+], {
+    id: string;
+    key: string;
+}>;
+export declare function useDeleteFunction(): MutationResult<[string], void>;
 //# sourceMappingURL=hooks.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EACV,iBAAiB,EACjB,GAAG,EACH,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,EAAE,EACF,WAAW,EACX,QAAQ,EACR,GAAG,EACH,cAAc,EACd,QAAQ,EACR,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EAChB,MAAM,UAAU,CAAC;AAIlB,oCAAoC;AACpC,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,qFAAqF;IACrF,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IACpB,8DAA8D;IAC9D,KAAK,EAAE,OAAO,CAAC;IACf,gFAAgF;IAChF,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wCAAwC;AACxC,MAAM,WAAW,cAAc,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,CAAC;IACvD,+FAA+F;IAC/F,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACpC,kDAAkD;IAClD,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IACpB,6DAA6D;IAC7D,KAAK,EAAE,OAAO,CAAC;IACf,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;CAClB;AAmFD,wBAAgB,KAAK,IAAI,UAAU,CAAC,EAAE,CAAC,CAItC;AAED,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,CAQzE;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,UAAU,CAAC,GAAG,CAAC,CAQlF;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,UAAU,CAAC,GAAG,CAAC,CAQxF;AAED,wBAAgB,OAAO,IAAI,UAAU,CAAC,GAAG,EAAE,CAAC,CAI3C;AAED,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAIlD;AAED,wBAAgB,cAAc,IAAI,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAIhE;AAED,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,UAAU,CAAC,eAAe,EAAE,CAAC,CAQzF;AAID,wBAAgB,iBAAiB,IAAI,cAAc,CAAC,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC,EAAE,GAAG,CAAC,CAKhG;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CACjD;IAAC,MAAM;IAAE,aAAa;IAAE,eAAe,CAAC;CAAC,EACzC,GAAG,CACJ,CAKA;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,EAAE,IAAI,CAAC,CAKpF;AAED,wBAAgB,YAAY,IAAI,cAAc,CAAC,CAAC,cAAc,CAAC,EAAE,GAAG,CAAC,CAGpE;AAED,wBAAgB,YAAY,IAAI,cAAc,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,CAGtE;AAED,wBAAgB,YAAY,IAAI,cAAc,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAG7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,cAAc,CAAC,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAKjG;AAED,wBAAgB,MAAM,IAAI,cAAc,CAAC,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,CAGhE"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/hooks.ts"],"names":[],"mappings":"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"}

package/dist/src/hooks.js

@@ -1,39 +1,100 @@
 import { useCallback, useEffect, useRef, useState } from "react";
-import { useW6WClient } from "./W6WProvider.js";
+import { useW6WClient, useW6WProviderContext } from "./W6WProvider.js";
+import { subscribe } from "./single-flight.js";
 /**
- * Shared plumbing behind every read hook: fetch once on mount, expose
- * `refetch` for an imperative re-fetch, and drop a result that resolves after
- * unmount. `fetcher` must be a `useCallback`-stabilized function — each hook
- * below owns that decision by listing exactly the values its own fetch
- * depends on, so this primitive's own dependency array (`[fetcher]`) stays
- * exhaustive and needs no lint override.
+ * Shared plumbing behind every read hook: fetch on mount, on every
+ * `fetcher`/`client`/`ready` change, and on an imperative `refetch()`; drop
+ * any result that is no longer current.
+ *
+ * `fetcher` must be a `useCallback`-stabilized function taking the call's
+ * `AbortSignal` — each hook below owns that decision by listing exactly the
+ * values its own fetch depends on (including `client`), so this primitive's
+ * own dependency array stays exhaustive and needs no lint override. `client`
+ * is passed SEPARATELY (not inferred from `fetcher`'s identity) because it is
+ * the one thing that decides whether a reset is a "client change" (blank the
+ * stale data before refetching — R-7) or an ordinary same-client refetch
+ * (keep today's behaviour: loading flips true, previous data stays visible
+ * until the new result lands).
+ *
+ * Sequencing: a monotonic per-call generation number, bumped on every real
+ * fetch. Only the call whose generation is still the LATEST when it settles
+ * is allowed to commit — a superseded call (a newer one started, whether by
+ * `client` changing or by `refetch()`) can never write `state`, on resolution
+ * OR rejection. The previous call's `AbortController` is also aborted before
+ * the new one starts, and on unmount, so a genuinely abandoned request is
+ * told to stop rather than merely ignored.
+ *
+ * `ready === false` short-circuits before any of that: the fetcher is never
+ * called, any in-flight call is aborted, and state reports
+ * `{data: undefined, error: undefined, loading: true}`.
+ *
+ * A rejection named `ConfigError` (`@w6w/sdk`'s `requireToken` — no token yet,
+ * P-6) is reported as `loading: true`, not `error` — the same floor as
+ * `ready: false`, since from a caller's point of view "no credential yet" and
+ * "not ready yet" are the same state.
+ *
+ * `key` identifies the read for sharing: `JSON.stringify([method, ...args])`
+ * over the SDK method and EVERY argument `fetcher` closes over. `refetch()`
+ * starts a fresh flight (replacing the key's slot) and never aborts a flight
+ * another subscriber still holds.
  */
-function useAsync(fetcher) {
+function useAsync(key, fetcher, client, ready) {
     const [state, setState] = useState({
         data: undefined,
         error: undefined,
         loading: true,
     });
     const mountedRef = useRef(true);
+    const generationRef = useRef(0);
+    const subRef = useRef(null);
+    const clientRef = useRef(client);
     useEffect(() => {
         mountedRef.current = true;
         return () => {
             mountedRef.current = false;
+            subRef.current?.detach();
+            subRef.current = null;
         };
     }, []);
-    const refetch = useCallback(() => {
-        setState((s) => ({ ...s, loading: true }));
-        fetcher().then((data) => {
-            if (mountedRef.current)
-                setState({ data, error: undefined, loading: false });
+    const run = useCallback((fresh = false) => {
+        const clientChanged = clientRef.current !== client;
+        clientRef.current = client;
+        // Abort whatever this hook had in flight — superseded by this call,
+        // whether it is a real fetch or a `ready: false` short-circuit.
+        subRef.current?.detach();
+        subRef.current = null;
+        if (!ready) {
+            // Bump the generation too, not just abort the controller — a rejection
+            // from the just-aborted call must never land after this point and flip
+            // `loading` back to `false` out from under the `ready: false` floor.
+            ++generationRef.current;
+            setState({ data: undefined, error: undefined, loading: true });
+            return;
+        }
+        const generation = ++generationRef.current;
+        const sub = subscribe(client, key, fetcher, fresh);
+        subRef.current = sub;
+        setState((s) => clientChanged
+            ? { data: undefined, error: undefined, loading: true }
+            : { ...s, loading: true });
+        sub.promise.then((data) => {
+            if (!mountedRef.current || generation !== generationRef.current)
+                return;
+            setState({ data, error: undefined, loading: false });
         }, (error) => {
-            if (mountedRef.current)
-                setState({ data: undefined, error, loading: false });
+            if (!mountedRef.current || generation !== generationRef.current)
+                return;
+            if (error instanceof Error && error.name === "ConfigError") {
+                setState({ data: undefined, error: undefined, loading: true });
+                return;
+            }
+            setState({ data: undefined, error, loading: false });
         });
-    }, [fetcher]);
+    }, [key, fetcher, client, ready]);
     useEffect(() => {
-        refetch();
-    }, [refetch]);
+        run();
+    }, [run]);
+    const refetch = useCallback(() => run(true), [run]);
     return { data: state.data, error: state.error, loading: state.loading, refetch };
 }
 /**
@@ -66,48 +127,73 @@ function useMutationResource(mutator) {
 }
 // ── reads ────────────────────────────────────────────────────────────────
 export function useMe() {
-    const client = useW6WClient();
-    const fetcher = useCallback(() => client.me(), [client]);
-    return useAsync(fetcher);
+    const { client, ready } = useW6WProviderContext();
+    const fetcher = useCallback((signal) => client.me({ signal }), [client]);
+    return useAsync(JSON.stringify(["me"]), fetcher, client, ready);
 }
 export function useDocuments(options) {
-    const client = useW6WClient();
+    const { client, ready } = useW6WProviderContext();
     const project = options?.project;
-    const fetcher = useCallback(() => client.documents.list(project === undefined ? undefined : { project }), [client, project]);
-    return useAsync(fetcher);
+    const fetcher = useCallback((signal) => client.documents.list({ project, signal }), [client, project]);
+    return useAsync(JSON.stringify(["documents.list", project ?? null]), fetcher, client, ready);
 }
 export function useDocument(id, options) {
-    const client = useW6WClient();
+    const { client, ready } = useW6WProviderContext();
     const project = options?.project;
-    const fetcher = useCallback(() => client.documents.get(id, project === undefined ? undefined : { project }), [client, id, project]);
-    return useAsync(fetcher);
+    const fetcher = useCallback((signal) => client.documents.get(id, { project, signal }), [client, id, project]);
+    return useAsync(JSON.stringify(["documents.get", id, project ?? null]), fetcher, client, ready);
 }
 export function useDocumentByKey(key, options) {
-    const client = useW6WClient();
+    const { client, ready } = useW6WProviderContext();
     const project = options?.project;
-    const fetcher = useCallback(() => client.documents.getByKey(key, project === undefined ? undefined : { project }), [client, key, project]);
-    return useAsync(fetcher);
+    const fetcher = useCallback((signal) => client.documents.getByKey(key, { project, signal }), [client, key, project]);
+    return useAsync(JSON.stringify(["documents.getByKey", key, project ?? null]), fetcher, client, ready);
 }
 export function useVars() {
-    const client = useW6WClient();
-    const fetcher = useCallback(() => client.vars.list(), [client]);
-    return useAsync(fetcher);
+    const { client, ready } = useW6WProviderContext();
+    const fetcher = useCallback((signal) => client.vars.list({ signal }), [client]);
+    return useAsync(JSON.stringify(["vars.list"]), fetcher, client, ready);
 }
 export function useVar(id) {
-    const client = useW6WClient();
-    const fetcher = useCallback(() => client.vars.get(id), [client, id]);
-    return useAsync(fetcher);
+    const { client, ready } = useW6WProviderContext();
+    const fetcher = useCallback((signal) => client.vars.get(id, { signal }), [client, id]);
+    return useAsync(JSON.stringify(["vars.get", id]), fetcher, client, ready);
 }
 export function useConnections() {
-    const client = useW6WClient();
-    const fetcher = useCallback(() => client.connections.list(), [client]);
-    return useAsync(fetcher);
+    const { client, ready } = useW6WProviderContext();
+    const fetcher = useCallback((signal) => client.connections.list({ signal }), [client]);
+    return useAsync(JSON.stringify(["connections.list"]), fetcher, client, ready);
 }
 export function useWorkflows(options) {
-    const client = useW6WClient();
+    const { client, ready } = useW6WProviderContext();
     const project = options?.project;
-    const fetcher = useCallback(() => client.workflows.list(project === undefined ? undefined : { project }), [client, project]);
-    return useAsync(fetcher);
+    const fetcher = useCallback((signal) => client.workflows.list({ project, signal }), [client, project]);
+    return useAsync(JSON.stringify(["workflows.list", project ?? null]), fetcher, client, ready);
+}
+/**
+ * One workflow's stored definition, plus the two things that are not in it.
+ *
+ * `data.updatedAt` is the optimistic-concurrency token: hand it to
+ * {@linkcode useUpdateWorkflow}'s `ifUnmodifiedSince` and a save that would
+ * clobber someone else's edit is refused instead of winning silently. That is
+ * the whole reason this is a read hook and not just a fetch — the token has to
+ * survive from the read to the write, and a component that re-reads on every
+ * render would keep handing itself a fresh one.
+ */
+export function useWorkflow(id) {
+    const { client, ready } = useW6WProviderContext();
+    const fetcher = useCallback((signal) => client.workflows.get(id, { signal }), [client, id]);
+    return useAsync(JSON.stringify(["workflows.get", id]), fetcher, client, ready);
+}
+export function useFunctions() {
+    const { client, ready } = useW6WProviderContext();
+    const fetcher = useCallback((signal) => client.functions.list({ signal }), [client]);
+    return useAsync(JSON.stringify(["functions.list"]), fetcher, client, ready);
+}
+export function useFunction(id) {
+    const { client, ready } = useW6WProviderContext();
+    const fetcher = useCallback((signal) => client.functions.get(id, { signal }), [client, id]);
+    return useAsync(JSON.stringify(["functions.get", id]), fetcher, client, ready);
 }
 // ── mutations ────────────────────────────────────────────────────────────
 export function useCreateDocument() {
@@ -151,4 +237,57 @@ export function useRun() {
     const client = useW6WClient();
     return useMutationResource((input) => client.run(input));
 }
+/**
+ * ── The definition lifecycle ──
+ *
+ * Ten hooks over the same ten SDK methods, and three properties they inherit
+ * from it rather than invent:
+ *
+ * 1. **`create` mints the id.** The server requires one in the body and never
+ *    generates it, so `create({name, steps})` works and the `wf_…`/`fn_…` id
+ *    comes back in the result.
+ * 2. **`update` is a full replacement, not a patch.** This is the one place
+ *    these differ from `useUpdateDocument`/`useUpdateVar`, whose second
+ *    argument is a `Patch` of the fields to change. Here it is the whole
+ *    definition: read with {@linkcode useWorkflow} / {@linkcode useFunction},
+ *    spread, change, send. A component that passed only the changed fields
+ *    would delete the rest.
+ * 3. **Deleting a workflow is two calls**, `archive` then `delete`. No hook
+ *    here chains them — a UI that offers "delete" should offer the archive
+ *    step too, because that is the step a user can still change their mind
+ *    after.
+ *
+ * None of them refetch a list on success, matching every other mutation hook
+ * in this file: this lane carries no cache to invalidate (no react-query, by
+ * design — see README), so a component pairs the mutation with the read hook's
+ * own `refetch`.
+ */
+export function useCreateWorkflow() {
+    const client = useW6WClient();
+    return useMutationResource((definition, options) => client.workflows.create(definition, options));
+}
+export function useUpdateWorkflow() {
+    const client = useW6WClient();
+    return useMutationResource((id, definition, options) => client.workflows.update(id, definition, options));
+}
+export function useArchiveWorkflow() {
+    const client = useW6WClient();
+    return useMutationResource((id) => client.workflows.archive(id));
+}
+export function useDeleteWorkflow() {
+    const client = useW6WClient();
+    return useMutationResource((id) => client.workflows.delete(id));
+}
+export function useCreateFunction() {
+    const client = useW6WClient();
+    return useMutationResource((definition) => client.functions.create(definition));
+}
+export function useUpdateFunction() {
+    const client = useW6WClient();
+    return useMutationResource((id, definition) => client.functions.update(id, definition));
+}
+export function useDeleteFunction() {
+    const client = useW6WClient();
+    return useMutationResource((id) => client.functions.delete(id));
+}
 //# sourceMappingURL=hooks.js.map

package/dist/src/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/hooks.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAmB,CAAC;AAgCjD;;;;;;;GAOG;AACH,SAAS,QAAQ,CAAI,OAAyB;IAC5C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB;QAChD,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAChC,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,OAAO,GAAG,EAAE;YACV,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;QAC7B,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;QAC/B,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3C,OAAO,EAAE,CAAC,IAAI,CACZ,CAAC,IAAI,EAAE,EAAE;YACP,IAAI,UAAU,CAAC,OAAO;gBAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/E,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,IAAI,UAAU,CAAC,OAAO;gBAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/E,CAAC,CACF,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,EAAE,CAAC;IACZ,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;AACnF,CAAC;AAED;;;;;GAKG;AACH,SAAS,mBAAmB,CAC1B,OAAsC;IAEtC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB;QAChD,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,KAAK;KACf,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,GAAG,IAAU,EAAc,EAAE;QAC3D,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;YAC/C,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACrD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACrD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;AAChF,CAAC;AAED,4EAA4E;AAE5E,MAAM,UAAU,KAAK;IACnB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IACzD,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAyB;IACpD,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;IACjC,MAAM,OAAO,GAAG,WAAW,CACzB,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAC5E,CAAC,MAAM,EAAE,OAAO,CAAC,CAClB,CAAC;IACF,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAU,EAAE,OAAyB;IAC/D,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;IACjC,MAAM,OAAO,GAAG,WAAW,CACzB,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAC/E,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,CACtB,CAAC;IACF,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,OAAyB;IACrE,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;IACjC,MAAM,OAAO,GAAG,WAAW,CACzB,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EACrF,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CACvB,CAAC;IACF,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAChE,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,EAAU;IAC/B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;IACrE,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IACvE,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAA6B;IACxD,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;IACjC,MAAM,OAAO,GAAG,WAAW,CACzB,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAC5E,CAAC,MAAM,EAAE,OAAO,CAAC,CAClB,CAAC;IACF,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED,4EAA4E;AAE5E,MAAM,UAAU,iBAAiB;IAC/B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,OAAO,mBAAmB,CAAC,CAAC,KAA0B,EAAE,OAAyB,EAAE,EAAE,CACnF,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CACxC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB;IAI/B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,OAAO,mBAAmB,CAAC,CAAC,EAAU,EAAE,KAAoB,EAAE,OAAyB,EAAE,EAAE,CACzF,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,OAAO,mBAAmB,CAAC,CAAC,EAAU,EAAE,OAAyB,EAAE,EAAE,CACnE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CACrC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,OAAO,mBAAmB,CAAC,CAAC,KAAqB,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,OAAO,mBAAmB,CAAC,CAAC,EAAU,EAAE,KAAe,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,OAAO,mBAAmB,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AACrE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,OAAO,mBAAmB,CAAC,CAAC,EAAU,EAAE,OAA4B,EAAE,EAAE,CACtE,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,CACtE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,MAAM;IACpB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,OAAO,mBAAmB,CAAC,CAAC,KAAe,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AACrE,CAAC"}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/hooks.ts"],"names":[],"mappings":"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"}

package/dist/src/single-flight.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Single-flight store behind the read hooks: identical in-flight reads (same
+ * client, same key) share ONE request, and nothing outlives it.
+ *
+ * Scoping: one `Map` per `W6WClient` object, held in a `WeakMap` — never a
+ * bare module-level map and never keyed by `baseUrl`/token, so two providers
+ * with identical props (different tenants) cannot see each other's data.
+ *
+ * Lifetime: an entry exists only while its request is pending. It is deleted
+ * on resolve OR reject (only if it is still the mapped entry), so a consumer
+ * that mounts after the flight settled sends a fresh request — no staleness.
+ *
+ * Abort: refcounted. The shared `AbortController` aborts only when the last
+ * subscriber has detached AND stayed detached past a microtask grace. React
+ * StrictMode's synchronous cleanup -> remount re-attaches inside that grace,
+ * so it re-joins the flight instead of abort + refire.
+ *
+ * @module
+ */
+/** One subscriber's hold on a shared flight. */
+export interface Subscription<T> {
+    /** The shared request's result — the same promise for every subscriber. */
+    readonly promise: Promise<T>;
+    /** Release this subscriber's hold. Idempotent. */
+    detach(): void;
+}
+/**
+ * Join the pending flight for `(client, key)`, or start one with `start`.
+ * `fresh` always starts a new flight and takes over the key's slot; the entry
+ * it replaces keeps running for whoever still holds it.
+ */
+export declare function subscribe<T>(client: object, key: string, start: (signal: AbortSignal) => Promise<T>, fresh?: boolean): Subscription<T>;
+//# sourceMappingURL=single-flight.d.ts.map

package/dist/src/single-flight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-flight.d.ts","sourceRoot":"","sources":["../../src/single-flight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,gDAAgD;AAChD,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7B,kDAAkD;IAClD,MAAM,IAAI,IAAI,CAAC;CAChB;AAID;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,KAAK,UAAQ,GACZ,YAAY,CAAC,CAAC,CAAC,CAyCjB"}

package/dist/src/single-flight.js

@@ -0,0 +1,71 @@
+/**
+ * Single-flight store behind the read hooks: identical in-flight reads (same
+ * client, same key) share ONE request, and nothing outlives it.
+ *
+ * Scoping: one `Map` per `W6WClient` object, held in a `WeakMap` — never a
+ * bare module-level map and never keyed by `baseUrl`/token, so two providers
+ * with identical props (different tenants) cannot see each other's data.
+ *
+ * Lifetime: an entry exists only while its request is pending. It is deleted
+ * on resolve OR reject (only if it is still the mapped entry), so a consumer
+ * that mounts after the flight settled sends a fresh request — no staleness.
+ *
+ * Abort: refcounted. The shared `AbortController` aborts only when the last
+ * subscriber has detached AND stayed detached past a microtask grace. React
+ * StrictMode's synchronous cleanup -> remount re-attaches inside that grace,
+ * so it re-joins the flight instead of abort + refire.
+ *
+ * @module
+ */
+const stores = new WeakMap();
+/**
+ * Join the pending flight for `(client, key)`, or start one with `start`.
+ * `fresh` always starts a new flight and takes over the key's slot; the entry
+ * it replaces keeps running for whoever still holds it.
+ */
+export function subscribe(client, key, start, fresh = false) {
+    let map = stores.get(client);
+    if (!map) {
+        map = new Map();
+        stores.set(client, map);
+    }
+    const slots = map;
+    let entry = fresh ? undefined : slots.get(key);
+    if (!entry) {
+        const controller = new AbortController();
+        const created = {
+            promise: start(controller.signal),
+            controller,
+            refs: 0,
+        };
+        const settle = () => {
+            if (slots.get(key) === created)
+                slots.delete(key);
+        };
+        created.promise.then(settle, settle);
+        slots.set(key, created);
+        entry = created;
+    }
+    const held = entry;
+    held.refs++;
+    let detached = false;
+    return {
+        promise: held.promise,
+        detach() {
+            if (detached)
+                return;
+            detached = true;
+            held.refs--;
+            if (held.refs > 0)
+                return;
+            queueMicrotask(() => {
+                if (held.refs > 0)
+                    return;
+                if (slots.get(key) === held)
+                    slots.delete(key);
+                held.controller.abort();
+            });
+        },
+    };
+}
+//# sourceMappingURL=single-flight.js.map

package/dist/src/single-flight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-flight.js","sourceRoot":"","sources":["../../src/single-flight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAgBH,MAAM,MAAM,GAAG,IAAI,OAAO,EAAuC,CAAC;AAElE;;;;GAIG;AACH,MAAM,UAAU,SAAS,CACvB,MAAc,EACd,GAAW,EACX,KAA0C,EAC1C,KAAK,GAAG,KAAK;IAEb,IAAI,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;QAChB,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC;IAElB,IAAI,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAA0B,CAAC;IACzE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAa;YACxB,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC;YACjC,UAAU;YACV,IAAI,EAAE,CAAC;SACR,CAAC;QACF,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,OAAO;gBAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpD,CAAC,CAAC;QACF,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,OAAyB,CAAC,CAAC;QAC1C,KAAK,GAAG,OAAO,CAAC;IAClB,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC;IACnB,IAAI,CAAC,IAAI,EAAE,CAAC;IAEZ,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM;YACJ,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC;gBAAE,OAAO;YAC1B,cAAc,CAAC,GAAG,EAAE;gBAClB,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC;oBAAE,OAAO;gBAC1B,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI;oBAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC/C,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YAC1B,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

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.6.0";
+export const VERSION = "0.9.9";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@w6w/react",
-  "version": "0.6.0",
+  "version": "0.9.9",
   "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": {
@@ -10,7 +10,13 @@
   },
   "homepage": "https://github.com/w6w-io/w6w-wrappers/tree/main/react#readme",
   "bugs": "https://github.com/w6w-io/w6w-wrappers/issues",
-  "keywords": ["w6w", "workflow", "react", "sdk", "hooks"],
+  "keywords": [
+    "w6w",
+    "workflow",
+    "react",
+    "sdk",
+    "hooks"
+  ],
   "type": "module",
   "types": "./dist/mod.d.ts",
   "main": "./dist/mod.js",
@@ -20,7 +26,9 @@
       "import": "./dist/mod.js"
     }
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "sideEffects": false,
   "engines": {
     "node": ">=18"
@@ -36,11 +44,12 @@
     "react": ">=18"
   },
   "dependencies": {
-    "@w6w/sdk": "^0.6.0"
+    "@w6w/sdk": "^0.9.9"
   },
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
     "@types/react": "^18.3.17",
+    "@w6w/ui": "github:w6w-io/w6w-ui#76c11dfbd750fe8227ccdef6600726e26ea0e268",
     "jsdom": "^30.0.1",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",