@w6w/react 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 w6w-io
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,172 @@
+# @w6w/react
+
+React bindings for [`@w6w/sdk`](../node) — a `<W6wProvider>` that holds one memoized
+`W6wClient` with per-request token freshness, a small hook set over the SDK's public
+surface (`me`, `documents`, `vars`, `connections`, `workflows`, `run`), and
+`createW6wUiAdapter`, a structural bridge from a `W6wClient` to
+[`@w6w/ui`](https://github.com/w6w-io/w6w-ui)'s `W6wApi` contract.
+
+License: MIT · Version: 0.3.0
+
+This lane implements no endpoint — it composes `@w6w/sdk`, which is already
+conformant against [`endpoints.json`](../endpoints.json). There is nothing here to
+re-verify against the wire contract; verify `@w6w/sdk` instead.
+
+## Install
+
+```bash
+npm install @w6w/react react
+```
+
+`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
+depends on `react-dom` to mount itself; nothing extra is needed here.
+
+## Quick start
+
+Wrap your app root once:
+
+```tsx
+import { W6wProvider } from "@w6w/react";
+
+function App() {
+  return (
+    <W6wProvider baseUrl="https://api.example.com" token={() => getCurrentJwt()}>
+      <YourApp />
+    </W6wProvider>
+  );
+}
+```
+
+`token` accepts a literal string, or a supplier function called fresh on every
+request — pass a supplier when your token rotates (e.g. a short-lived JWT read from
+an auth SDK) and the client will pick up the new value on the very next call, with no
+teardown/rebuild of the underlying `W6wClient`. See `src/W6wProvider.tsx`'s module
+header for the exact mechanism (the C-4 shim).
+
+Then, anywhere under the provider:
+
+```tsx
+import { useDocuments, useW6wClient } from "@w6w/react";
+
+function DocList() {
+  const { data, loading, error, refetch } = useDocuments();
+  if (loading) return <p>Loading…</p>;
+  if (error) return <p>Failed: {String(error)}</p>;
+  return (
+    <ul>
+      {data?.map((doc) => <li key={doc.id}>{doc.key}</li>)}
+    </ul>
+  );
+}
+```
+
+## Using this package with `@w6w/ui`
+
+`@w6w/ui`'s components (e.g. `AppPicker`, `ActionTestForm`, the flow editor) take a
+`W6wApi` object through their own `<W6wUIProvider api={...}>`. Build one from your
+`@w6w/react` client with `createW6wUiAdapter`:
+
+```tsx
+import { createW6wUiAdapter, useW6wClient, W6wProvider } from "@w6w/react";
+import { W6wUIProvider, AppPicker } from "@w6w/ui";
+
+function UiBridge({ children }: { children: React.ReactNode }) {
+  const client = useW6wClient();
+  const api = useMemo(() => createW6wUiAdapter(client), [client]);
+  return <W6wUIProvider api={api}>{children}</W6wUIProvider>;
+}
+
+function App() {
+  return (
+    <W6wProvider baseUrl="https://api.example.com" token={jwtSupplier}>
+      <UiBridge>
+        <AppPicker onPick={(appId) => console.log(appId)} />
+      </UiBridge>
+    </W6wProvider>
+  );
+}
+```
+
+**`@w6w/ui` is not on npm today.** The `@w6w` scope holds only `@w6w/sdk` and
+`@w6w/cli` at the time of writing (`npm view @w6w/ui` → 404); the source itself IS a
+public GitHub repository (`w6w-io/w6w-ui`). `createW6wUiAdapter`'s `W6wApi` return
+type targets that contract *structurally* — this package names `@w6w/ui` nowhere in
+its own manifest and needs no change whenever `@w6w/ui` becomes reachable another
+way (this monorepo, a `git+https://` dependency on the public repo, or a private
+registry). This is an honest statement of today's install story, not a promise that
+`npm i @w6w/ui` resolves.
+
+`createW6wUiAdapter` is built entirely on `@w6w/sdk/console` — the SAME namespace
+`packages/studio`'s own facade uses for these routes (`packages/ui/src/createW6wApi.ts`
+is the *other* hand-rolled client for them; this package is not a third one).
+**`client.console.*` is documented "Studio-internal… unstable" and is deliberately
+excluded from `endpoints.json`'s conformance runner** (`node/src/client.ts:114-116`).
+That means a `console.*` signature change ships with no lockstep protection for this
+bridge beyond `@w6w/sdk`'s own version — pin your `@w6w/sdk` version alongside
+`@w6w/react`'s, and re-test the bridge on an upgrade rather than assuming it.
+
+## Hooks catalog
+
+Every read hook returns `{data, error, loading, refetch}`; every mutation hook
+returns `{call, data, error, loading}`. None depends on react-query or any other
+data-fetching library.
+
+| Hook | Wraps |
+|---|---|
+| `useMe()` | `client.me()` |
+| `useDocuments(options?)` | `client.documents.list()` |
+| `useDocument(id, options?)` | `client.documents.get()` |
+| `useDocumentByKey(key, options?)` | `client.documents.getByKey()` |
+| `useCreateDocument()` | `client.documents.create()` |
+| `useUpdateDocument()` | `client.documents.update()` |
+| `useDeleteDocument()` | `client.documents.delete()` |
+| `useVars()` | `client.vars.list()` |
+| `useVar(id)` | `client.vars.get()` |
+| `useCreateVar()` | `client.vars.create()` |
+| `useUpdateVar()` | `client.vars.update()` |
+| `useDeleteVar()` | `client.vars.delete()` |
+| `useConnections()` | `client.connections.list()` |
+| `useWorkflows(options?)` | `client.workflows.list()` |
+| `useRunWorkflow()` | `client.workflows.run()`, defaults `wait: true` |
+| `useRun()` | `client.run()` (the generic URN dispatch) |
+
+`useRunWorkflow()`'s `call` defaults `wait: true` when the caller's options omit
+`wait`: `workflows.run` without `wait` (`node/src/workflows.ts`) leaves the caller
+with only a `runId` and no public polling operation to follow it with —
+`console.workflows.getRun` exists, but it is the same studio-internal, unstable
+surface described above, so this hook does not reach for it. Pass `wait: false`
+explicitly if you genuinely want the queued-and-walk-away behaviour.
+
+`useW6wClient()` returns the underlying `W6wClient` for anything not covered by a
+hook (e.g. `client.console.*` directly, at your own risk per the caveat above).
+
+## Known limitations
+
+- **`getAppActions`'s declared `ActionDef.params` type is a strict field subset of
+  `@w6w/ui`'s richer `ActionParam`.** `@w6w/sdk/console`'s `ActionParam` carries 6
+  fields (`key, label, type, required, default, hint`); `@w6w/ui`'s carries 14 more,
+  presentation-only fields (`placeholder, advanced, row, item, showIf, options,
+  config, children, section, title, subtitle, layout, collapsed`). This typechecks
+  fine — every extra field is optional — and there is no runtime data loss (the JSON
+  payload is unfiltered); a caller typing a variable through this adapter's declared
+  return type just gets no autocomplete for those extra fields.
+- **`ActionTestForm.tsx:149,176`'s error handling cannot be satisfied from this
+  package.** `@w6w/ui`'s `ActionTestForm` does a NOMINAL `instanceof ApiError` check
+  against its OWN `ApiError` class (`packages/ui/src/createW6wApi.ts`), not a
+  duck-typed one. No error object this adapter throws can ever satisfy that check
+  without importing `@w6w/ui`'s class directly, which this package's MIT/C-1
+  boundary forbids. Concretely: on a failed `invokeAction` used together with
+  `@w6w/ui`'s `ActionTestForm`, the 401/403 permission-hint messaging falls back to a
+  generic message, and the `ApiCallsPanel` egress log renders empty instead of
+  showing the outbound calls the action made — even though this adapter's thrown
+  error genuinely carries that data on `.body`/`.raw`. This adapter still aliases
+  `@w6w/sdk`'s `ApiError.raw` onto `.body` (`err.body === err.raw`) and sets
+  `err.name = "ApiError"`, so it is already correct for any DUCK-TYPING consumer, and
+  needs no further change the moment `@w6w/ui` switches its own check to one. The fix
+  belongs to `@w6w/ui`, not this package, and is filed there:
+  `.ai/projects/backlog/26-08-13-01-ui-error-nominal-check.md`.
+- **No `AbortSignal`/cancellation support in the hook set.** `@w6w/sdk`'s transport
+  (`node/src/http.ts`) has nothing to hook an abort into. A read hook only IGNORES a
+  result that resolves after its component unmounts (a mounted-ref guard); it cannot
+  cancel the in-flight request itself.

package/dist/mod.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `@w6w/react` — the package barrel.
+ *
+ * A thin React binding over `@w6w/sdk`: `<W6wProvider>` (the C-4
+ * token-supplier shim), a small hook set, and `createW6wUiAdapter` (the
+ * `@w6w/ui` `W6wApi` structural bridge, C-1/C-2). See `README.md` for the
+ * install + wrap-your-root example, the hooks catalog, and this lane's
+ * documented limitations.
+ *
+ * Every public export lives here — a symbol this file does not re-export is
+ * not part of the published surface.
+ *
+ * @module
+ */
+export { VERSION } from "./src/version.ts";
+export { type TokenSource, useW6wClient, W6wProvider, type W6wProviderProps, } from "./src/W6wProvider.tsx";
+export { type MutationResult, type ReadResult, useConnections, useCreateDocument, useCreateVar, useDeleteDocument, useDeleteVar, useDocument, useDocumentByKey, useDocuments, useMe, useRun, useRunWorkflow, useUpdateDocument, useUpdateVar, useVar, useVars, useWorkflows, } from "./src/hooks.ts";
+export { createW6wUiAdapter, type W6wApi } from "./src/adapter.ts";
+//# sourceMappingURL=mod.d.ts.map

package/dist/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;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,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,KAAK,EACL,MAAM,EACN,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,MAAM,EACN,OAAO,EACP,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/mod.js

@@ -0,0 +1,19 @@
+/**
+ * `@w6w/react` — the package barrel.
+ *
+ * A thin React binding over `@w6w/sdk`: `<W6wProvider>` (the C-4
+ * token-supplier shim), a small hook set, and `createW6wUiAdapter` (the
+ * `@w6w/ui` `W6wApi` structural bridge, C-1/C-2). See `README.md` for the
+ * install + wrap-your-root example, the hooks catalog, and this lane's
+ * documented limitations.
+ *
+ * Every public export lives here — a symbol this file does not re-export is
+ * not part of the published surface.
+ *
+ * @module
+ */
+export { VERSION } from "./src/version.js";
+export { useW6wClient, W6wProvider, } from "./src/W6wProvider.js";
+export { useConnections, useCreateDocument, useCreateVar, useDeleteDocument, useDeleteVar, useDocument, useDocumentByKey, useDocuments, useMe, useRun, useRunWorkflow, useUpdateDocument, useUpdateVar, useVar, useVars, useWorkflows, } from "./src/hooks.js";
+export { createW6wUiAdapter } from "./src/adapter.js";
+//# sourceMappingURL=mod.js.map

package/dist/mod.js.map

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

package/dist/src/W6wProvider.d.ts

@@ -0,0 +1,68 @@
+/**
+ * `<W6wProvider>` — one `W6wClient` per `baseUrl`, with per-request token
+ * freshness (C-4).
+ *
+ * `@w6w/sdk`'s `W6wClientOptions.token` (`node/src/config.ts:41-63`) is
+ * resolved ONCE, at construction, into `readonly` instance state
+ * (`node/src/client.ts:59`) — there is no supplier form. A naive
+ * `new W6wClient({ token })` therefore captures whatever `token` was at mount
+ * time and never sees a later rotation.
+ *
+ * The fix lives at the `fetch`-injection seam, not the `token` seam.
+ * `node/src/http.ts`'s `request()` builds `headers = new Headers(options.headers)`
+ * and then unconditionally `headers.set("authorization", ...)` BEFORE calling
+ * the injected `fetchImpl(url, {method, headers, body})` — `Headers.set`
+ * REPLACES, so a custom `fetch` passed to `new W6wClient({ fetch })` can read
+ * the CURRENT token and overwrite `authorization` on the `Headers` object it
+ * receives, immediately before delegating to the real transport. This
+ * provider therefore constructs its `W6wClient` ONCE, with a non-blank
+ * placeholder token (any non-blank string satisfies `requireToken`,
+ * `config.ts:229-237` — it is never actually sent, since the injected `fetch`
+ * always overwrites it first) and an injected `fetch` that resolves the
+ * current `token` prop (calling it, if it is a supplier) on every call.
+ *
+ * **Do not key the outer `useMemo` on `token`.** `packages/studio/src/api/apiClient.tsx`
+ * rebuilds its client whenever the token STRING changes — the right policy for
+ * studio's own state-variable token, and the wrong one here: a supplier
+ * function has a stable identity across renders, so keying on the supplier
+ * would never rebuild AND never read a fresh value, while keying on the
+ * token's resolved value would tear the client down and rebuild it on every
+ * rotation — exactly what C-4 says not to do ("without tearing down"). The
+ * memo below depends on `[baseUrl, project]` only; `token` and `fetch` are
+ * read through "latest" refs, updated every render but never a dependency, so
+ * a rotating token is read fresh per request without ever rebuilding the
+ * client.
+ *
+ * @module
+ */
+import { type FetchLike, W6wClient } from "@w6w/sdk";
+import { type ReactNode } from "react";
+/** A static bearer token, or a supplier read fresh on every request. */
+export type TokenSource = string | (() => string | null | undefined);
+export interface W6wProviderProps {
+    /** The w6w server's origin, e.g. `"https://api.example.com"`. */
+    baseUrl: string;
+    /** A literal bearer token, or a supplier called fresh on every request. */
+    token: TokenSource;
+    /**
+     * The real transport this provider's injected `fetch` delegates to, after
+     * overwriting the `authorization` header. Defaults to `globalThis.fetch`.
+     * Mainly for tests — a caller wanting to record or stub outbound requests.
+     */
+    fetch?: FetchLike;
+    /** Default project id for the project-scoped operations (`documents.*`, `workflows.list`). */
+    project?: string;
+    children: ReactNode;
+}
+/**
+ * Provides one memoized `W6wClient` to every component under it. See this
+ * module's header for the C-4 token-freshness mechanism.
+ */
+export declare function W6wProvider(props: W6wProviderProps): ReactNode;
+/**
+ * Access the memoized `W6wClient`. Throws a helpful error if used outside a
+ * `<W6wProvider>` (mirrors `packages/ui/src/provider.tsx:249-258`'s
+ * `useW6wApi` shape — read-only reference, transcribed here, never imported).
+ */
+export declare function useW6wClient(): W6wClient;
+//# sourceMappingURL=W6wProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"W6wProvider.d.ts","sourceRoot":"","sources":["../../src/W6wProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,OAAO,EAAE,KAAK,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,KAAK,SAAS,EAA8C,MAAM,OAAO,CAAC;AAEnF,wEAAwE;AACxE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAUrE,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,KAAK,EAAE,WAAW,CAAC;IACnB;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAID;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,CA8B9D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,SAAS,CASxC"}

package/dist/src/W6wProvider.js

@@ -0,0 +1,92 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * `<W6wProvider>` — one `W6wClient` per `baseUrl`, with per-request token
+ * freshness (C-4).
+ *
+ * `@w6w/sdk`'s `W6wClientOptions.token` (`node/src/config.ts:41-63`) is
+ * resolved ONCE, at construction, into `readonly` instance state
+ * (`node/src/client.ts:59`) — there is no supplier form. A naive
+ * `new W6wClient({ token })` therefore captures whatever `token` was at mount
+ * time and never sees a later rotation.
+ *
+ * The fix lives at the `fetch`-injection seam, not the `token` seam.
+ * `node/src/http.ts`'s `request()` builds `headers = new Headers(options.headers)`
+ * and then unconditionally `headers.set("authorization", ...)` BEFORE calling
+ * the injected `fetchImpl(url, {method, headers, body})` — `Headers.set`
+ * REPLACES, so a custom `fetch` passed to `new W6wClient({ fetch })` can read
+ * the CURRENT token and overwrite `authorization` on the `Headers` object it
+ * receives, immediately before delegating to the real transport. This
+ * provider therefore constructs its `W6wClient` ONCE, with a non-blank
+ * placeholder token (any non-blank string satisfies `requireToken`,
+ * `config.ts:229-237` — it is never actually sent, since the injected `fetch`
+ * always overwrites it first) and an injected `fetch` that resolves the
+ * current `token` prop (calling it, if it is a supplier) on every call.
+ *
+ * **Do not key the outer `useMemo` on `token`.** `packages/studio/src/api/apiClient.tsx`
+ * rebuilds its client whenever the token STRING changes — the right policy for
+ * studio's own state-variable token, and the wrong one here: a supplier
+ * function has a stable identity across renders, so keying on the supplier
+ * would never rebuild AND never read a fresh value, while keying on the
+ * token's resolved value would tear the client down and rebuild it on every
+ * rotation — exactly what C-4 says not to do ("without tearing down"). The
+ * memo below depends on `[baseUrl, project]` only; `token` and `fetch` are
+ * read through "latest" refs, updated every render but never a dependency, so
+ * a rotating token is read fresh per request without ever rebuilding the
+ * client.
+ *
+ * @module
+ */
+import { W6wClient } from "@w6w/sdk";
+import { createContext, useContext, useMemo, useRef } from "react";
+/**
+ * Satisfies `requireToken` at construction so the client never throws a
+ * `ConfigError` for "no token" — this value is never actually sent on the
+ * wire, since the injected `fetch` below always overwrites it first. See
+ * this module's header.
+ */
+const PLACEHOLDER_TOKEN = "w6w-react-unused-placeholder-token";
+const Ctx = createContext(null);
+/**
+ * Provides one memoized `W6wClient` to every component under it. See this
+ * module's header for the C-4 token-freshness mechanism.
+ */
+export function W6wProvider(props) {
+    const { baseUrl, token, fetch: fetchOverride, project, children } = props;
+    // "Latest ref" pattern: kept in sync on every render, but never a `useMemo`
+    // dependency below — the injected `fetch` always reads the CURRENT prop
+    // value through these, so a token rotation or a new `fetch` prop identity
+    // never forces a client rebuild. Refs are stable across renders and are not
+    // "reactive" values, so `useExhaustiveDependencies` correctly does not
+    // require them in the memo's dependency array.
+    const tokenRef = useRef(token);
+    tokenRef.current = token;
+    const fetchRef = useRef(fetchOverride);
+    fetchRef.current = fetchOverride;
+    const client = useMemo(() => {
+        const injectedFetch = (input, init) => {
+            const current = typeof tokenRef.current === "function" ? tokenRef.current() : tokenRef.current;
+            const headers = new Headers(init?.headers);
+            if (current) {
+                headers.set("authorization", `Bearer ${current}`);
+            }
+            const transport = fetchRef.current ?? ((i, ii) => globalThis.fetch(i, ii));
+            return transport(input, { ...init, headers });
+        };
+        return new W6wClient({ baseUrl, token: PLACEHOLDER_TOKEN, project, fetch: injectedFetch });
+    }, [baseUrl, project]);
+    return _jsx(Ctx.Provider, { value: client, children: children });
+}
+/**
+ * Access the memoized `W6wClient`. Throws a helpful error if used outside a
+ * `<W6wProvider>` (mirrors `packages/ui/src/provider.tsx:249-258`'s
+ * `useW6wApi` shape — read-only reference, transcribed here, never imported).
+ */
+export function useW6wClient() {
+    const client = useContext(Ctx);
+    if (!client) {
+        throw new Error("useW6wClient must be used inside <W6wProvider>. " +
+            'Wrap your app root with <W6wProvider baseUrl="..." token="...">...</W6wProvider>.');
+    }
+    return client;
+}
+//# sourceMappingURL=W6wProvider.js.map

package/dist/src/W6wProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"W6wProvider.js","sourceRoot":"","sources":["../../src/W6wProvider.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,OAAO,EAAkB,SAAS,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAkB,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAKnF;;;;;GAKG;AACH,MAAM,iBAAiB,GAAG,oCAAoC,CAAC;AAkB/D,MAAM,GAAG,GAAG,aAAa,CAAmB,IAAI,CAAC,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAE1E,4EAA4E;IAC5E,wEAAwE;IACxE,0EAA0E;IAC1E,4EAA4E;IAC5E,uEAAuE;IACvE,+CAA+C;IAC/C,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;IACzB,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;IACvC,QAAQ,CAAC,OAAO,GAAG,aAAa,CAAC;IAEjC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE;QAC1B,MAAM,aAAa,GAAc,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YAC/C,MAAM,OAAO,GACX,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YACjF,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC3C,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,OAAO,EAAE,CAAC,CAAC;YACpD,CAAC;YACD,MAAM,SAAS,GACb,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC,CAAS,EAAE,EAAgB,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACjF,OAAO,SAAS,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAChD,CAAC,CAAC;QACF,OAAO,IAAI,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;IAC7F,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAEvB,OAAO,KAAC,GAAG,CAAC,QAAQ,IAAC,KAAK,EAAE,MAAM,YAAG,QAAQ,GAAgB,CAAC;AAChE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,kDAAkD;YAChD,mFAAmF,CACtF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/adapter.d.ts

@@ -0,0 +1,144 @@
+/**
+ * `createW6wUiAdapter` — a structurally-typed bridge from a `W6wClient` to
+ * `@w6w/ui`'s `W6wApi` contract (C-1, C-2).
+ *
+ * `W6wApi` below is a HAND-DUPLICATE of `packages/ui/src/provider.tsx:87-231` —
+ * transcribed by hand, never imported. `@w6w/ui` is `SEE LICENSE IN LICENSE`
+ * and unpublished; this lane is MIT, so no dependency edge to it may exist
+ * anywhere, not even a type-only one (C-1). The VALUE types the interface
+ * needs (`AppSummary`, `ActionDef`, `AuthDef`, `ApiCallRecord`, `SavedTest`,
+ * `TestRunSummary`, `StepTest`, `InvokeOptions`, `ConnectionSummary`) are NOT
+ * hand-duplicated — they are already exported from `@w6w/sdk`/`@w6w/sdk/console`
+ * and structurally compatible (`building-blocks.md` §3's "Type duplication"
+ * analysis). Two documented, harmless narrowings from that analysis:
+ * - `getAppActions`'s `ActionDef.params` (`ActionParam`, `@w6w/sdk/console`)
+ *   carries 6 fields vs `@w6w/ui`'s 14 richer, presentation-only ones —
+ *   typechecks fine, no runtime loss, no autocomplete for the extra optional
+ *   fields. See README "Known limitations".
+ * - `listTestRuns` is REQUIRED here; `@w6w/ui`'s declaration marks it optional
+ *   (`?`) only so a consumer that hasn't wired history yet still typechecks.
+ *   Every consumer of THIS adapter gets a real implementation, so there is no
+ *   reason to decline it — a required member still satisfies an interface
+ *   that declares it optional.
+ *
+ * Every member here is a thin call into `client.console.*`, with two
+ * exceptions the SDK's own module headers document:
+ * - `listConnections` — see the comment at its call site below.
+ * - `recordTestRun` / `recordStepTestRun` — the SDK returns the real created
+ *   row; `W6wApi` is pinned `Promise<void>`. Discarded with
+ *   `.then(() => undefined)`, mirroring
+ *   `packages/studio/src/repos/saved-tests.ts:97-109` and
+ *   `step-tests.ts:46-59` (read-only reference, transcribed, never imported).
+ *
+ * `listApps` is a direct, one-line pass-through to `client.console.apps.list()`
+ * — that method already pages internally (`node/src/console/apps.ts:469-496`),
+ * so writing a second pagination loop here would be exactly the "third client
+ * for these routes" C-2 exists to prevent.
+ *
+ * @module
+ */
+import { type ConnectionSummary, type W6wClient } from "@w6w/sdk";
+import type { ActionDef, ApiCallRecord, AppSummary, AuthDef, InvokeOptions, SavedTest, StepTest, TestRunSummary } from "@w6w/sdk/console";
+/**
+ * The `@w6w/ui` `W6wApi` contract, hand-duplicated — see this module's
+ * header. Every member's signature mirrors `provider.tsx:87-231`'s member of
+ * the same name.
+ */
+export interface W6wApi {
+    /** List registered apps to pick from in the connection modal. */
+    listApps(): Promise<AppSummary[]>;
+    /** Load auth methods declared by an app's manifest, with availability flags. */
+    getAppAuth(appId: string): Promise<AuthDef[]>;
+    /** Create a non-OAuth connection with a user-supplied credential. */
+    createConnection(appId: string, body: {
+        authKey: string;
+        credential: Record<string, unknown>;
+        displayName?: string;
+        profile?: Record<string, unknown>;
+    }): Promise<ConnectionSummary>;
+    /**
+     * Start an OAuth 2.0 flow. Server builds the provider's authorize URL and
+     * returns it; the caller opens it in a popup and awaits the server's
+     * callback message — that popup/message flow is `@w6w/ui`'s concern
+     * (`oauth-popup.ts`), unchanged by this bridge.
+     */
+    startAppOAuthFlow(appId: string, authKey: string, body: {
+        displayName?: string;
+    }): Promise<{
+        authorizationUrl: string;
+    }>;
+    /** List the actions an app exposes, to pick from in the step builder. */
+    getAppActions(appId: string): Promise<ActionDef[]>;
+    /** List the connections that already exist for a given app. */
+    listConnectionsForApp(appId: string): Promise<ConnectionSummary[]>;
+    /** List every connection across apps — drives the "Connected apps" tab. */
+    listConnections(): Promise<ConnectionSummary[]>;
+    /**
+     * Invoke a single action — used to test-run one step from the visual
+     * editor. `opts.connectionId` runs with a stored connection's credential;
+     * `opts.project` scopes document/var expressions; `opts.state` seeds
+     * `steps.<id>.output` / `trigger.event` so upstream references resolve
+     * instead of the empty string. `apiCalls` carries the outbound HTTP calls
+     * the action made (redacted); a failed invoke rejects with an error whose
+     * `.body` holds the same field (see `withApiErrorBody` below).
+     */
+    invokeAction(appId: string, actionKey: string, params: Record<string, unknown>, opts?: InvokeOptions): Promise<{
+        value: unknown;
+        logs?: string[];
+        apiCalls?: ApiCallRecord[];
+    }>;
+    /** List the saved action-test inputs stored against a connection. */
+    listSavedTests(connectionId: string): Promise<SavedTest[]>;
+    /** Save a new set of action-test inputs against a connection. */
+    createSavedTest(connectionId: string, body: {
+        actionKey: string;
+        name: string;
+        values: Record<string, unknown>;
+    }): Promise<SavedTest>;
+    /** Rename a saved test or replace its stored input values. */
+    updateSavedTest(connectionId: string, id: string, patch: {
+        name?: string;
+        values?: Record<string, unknown>;
+    }): Promise<SavedTest>;
+    /** Delete a saved test by id. */
+    deleteSavedTest(connectionId: string, id: string): Promise<void>;
+    /**
+     * Record the outcome of an action-test run against a connection. Appends a
+     * run-log row server-side; when `savedTestId` is present the saved test's
+     * `lastRun*` fields are updated too.
+     */
+    recordTestRun(connId: string, body: {
+        savedTestId?: string | null;
+        actionKey: string;
+        ok: boolean;
+        summary?: string;
+        result?: unknown;
+    }): Promise<void>;
+    /** List a connection's recent tester-run history from the unified run ledger. */
+    listTestRuns(connectionId: string): Promise<TestRunSummary[]>;
+    /**
+     * Save a reusable per-step test fixture against a workflow step. Captures
+     * the resolved incoming state (`input`) and the step's params (`with`).
+     */
+    saveStepTest(workflowId: string, stepId: string, body: {
+        name?: string;
+        input: Record<string, unknown>;
+        with: Record<string, unknown>;
+    }): Promise<StepTest>;
+    /**
+     * Record the outcome of a step-test run. When `stepTestId` is present, the
+     * fixture's `lastRun*` fields are updated too.
+     */
+    recordStepTestRun(workflowId: string, stepId: string, body: {
+        stepTestId?: string | null;
+        status: string;
+        input?: unknown;
+        output?: unknown;
+        error?: unknown;
+    }): Promise<void>;
+    /** List the saved test fixtures for a workflow step. */
+    listStepTests(workflowId: string, stepId: string): Promise<StepTest[]>;
+}
+/** Build a `W6wApi` implementation over an existing `W6wClient`. See this module's header. */
+export declare function createW6wUiAdapter(client: W6wClient): W6wApi;
+//# sourceMappingURL=adapter.d.ts.map

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

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

package/dist/src/adapter.js

@@ -0,0 +1,100 @@
+/**
+ * `createW6wUiAdapter` — a structurally-typed bridge from a `W6wClient` to
+ * `@w6w/ui`'s `W6wApi` contract (C-1, C-2).
+ *
+ * `W6wApi` below is a HAND-DUPLICATE of `packages/ui/src/provider.tsx:87-231` —
+ * transcribed by hand, never imported. `@w6w/ui` is `SEE LICENSE IN LICENSE`
+ * and unpublished; this lane is MIT, so no dependency edge to it may exist
+ * anywhere, not even a type-only one (C-1). The VALUE types the interface
+ * needs (`AppSummary`, `ActionDef`, `AuthDef`, `ApiCallRecord`, `SavedTest`,
+ * `TestRunSummary`, `StepTest`, `InvokeOptions`, `ConnectionSummary`) are NOT
+ * hand-duplicated — they are already exported from `@w6w/sdk`/`@w6w/sdk/console`
+ * and structurally compatible (`building-blocks.md` §3's "Type duplication"
+ * analysis). Two documented, harmless narrowings from that analysis:
+ * - `getAppActions`'s `ActionDef.params` (`ActionParam`, `@w6w/sdk/console`)
+ *   carries 6 fields vs `@w6w/ui`'s 14 richer, presentation-only ones —
+ *   typechecks fine, no runtime loss, no autocomplete for the extra optional
+ *   fields. See README "Known limitations".
+ * - `listTestRuns` is REQUIRED here; `@w6w/ui`'s declaration marks it optional
+ *   (`?`) only so a consumer that hasn't wired history yet still typechecks.
+ *   Every consumer of THIS adapter gets a real implementation, so there is no
+ *   reason to decline it — a required member still satisfies an interface
+ *   that declares it optional.
+ *
+ * Every member here is a thin call into `client.console.*`, with two
+ * exceptions the SDK's own module headers document:
+ * - `listConnections` — see the comment at its call site below.
+ * - `recordTestRun` / `recordStepTestRun` — the SDK returns the real created
+ *   row; `W6wApi` is pinned `Promise<void>`. Discarded with
+ *   `.then(() => undefined)`, mirroring
+ *   `packages/studio/src/repos/saved-tests.ts:97-109` and
+ *   `step-tests.ts:46-59` (read-only reference, transcribed, never imported).
+ *
+ * `listApps` is a direct, one-line pass-through to `client.console.apps.list()`
+ * — that method already pages internally (`node/src/console/apps.ts:469-496`),
+ * so writing a second pagination loop here would be exactly the "third client
+ * for these routes" C-2 exists to prevent.
+ *
+ * @module
+ */
+import { ApiError } from "@w6w/sdk";
+/**
+ * Alias `@w6w/sdk`'s `ApiError.raw` onto `.body` (`err.body === err.raw`, not
+ * a copy) before an error reaches the caller — the field name every
+ * duck-typing consumer of `@w6w/ui`'s own `ApiError` shape expects
+ * (`packages/ui/src/createW6wApi.ts:29-44`). `ApiError.name` is already
+ * `"ApiError"` on `@w6w/sdk`'s own class (`node/src/errors.ts`); nothing to
+ * add there.
+ *
+ * Does **not**, and cannot, fix `ActionTestForm.tsx:149,176`'s NOMINAL
+ * `instanceof ApiError` check against `@w6w/ui`'s own class — no object built
+ * here can ever satisfy a check against a different class without importing
+ * `@w6w/ui`, which C-1 forbids. Filed as a `packages/ui` follow-up
+ * (`.ai/projects/backlog/26-08-13-01-ui-error-nominal-check.md`); see README
+ * "Known limitations".
+ *
+ * ONE shared helper, not reimplemented per member — every adapter call below
+ * routes through this.
+ */
+async function withApiErrorBody(fn) {
+    try {
+        return await fn();
+    }
+    catch (err) {
+        if (err instanceof ApiError) {
+            err.body = err.raw;
+        }
+        throw err;
+    }
+}
+/** Build a `W6wApi` implementation over an existing `W6wClient`. See this module's header. */
+export function createW6wUiAdapter(client) {
+    return {
+        listApps: () => withApiErrorBody(() => client.console.apps.list()),
+        getAppAuth: (appId) => withApiErrorBody(() => client.console.apps.getAuth(appId)),
+        createConnection: (appId, body) => withApiErrorBody(() => client.console.connections.create(appId, body)),
+        startAppOAuthFlow: (appId, authKey, body) => withApiErrorBody(() => client.console.apps.startOAuthFlow(appId, authKey, body)),
+        getAppActions: (appId) => withApiErrorBody(() => client.console.apps.getActions(appId)),
+        listConnectionsForApp: (appId) => withApiErrorBody(() => client.console.connections.listForApp(appId)),
+        // Deliberately the BASE `client.connections.list()`, never
+        // `console.connections` — there is no `console.connections.list()` at all
+        // (only `listForApp`, which is scoped to one app). Do not "fix" this into
+        // console-namespace consistency; that would silently narrow "every
+        // connection across every app" down to one app's connections.
+        listConnections: () => withApiErrorBody(() => client.connections.list()),
+        invokeAction: (appId, actionKey, params, opts) => withApiErrorBody(() => client.console.apps.invoke(appId, actionKey, params, opts)),
+        listSavedTests: (connectionId) => withApiErrorBody(() => client.console.savedTests.list(connectionId)),
+        createSavedTest: (connectionId, body) => withApiErrorBody(() => client.console.savedTests.create(connectionId, body)),
+        updateSavedTest: (connectionId, id, patch) => withApiErrorBody(() => client.console.savedTests.update(connectionId, id, patch)),
+        deleteSavedTest: (connectionId, id) => withApiErrorBody(() => client.console.savedTests.delete(connectionId, id)),
+        // The SDK returns the real created `SavedTestRun`; `W6wApi.recordTestRun`
+        // is pinned `Promise<void>` — discard, don't drop the call.
+        recordTestRun: (connId, body) => withApiErrorBody(() => client.console.savedTests.recordTestRun(connId, body).then(() => undefined)),
+        listTestRuns: (connectionId) => withApiErrorBody(() => client.console.savedTests.listTestRuns(connectionId)),
+        saveStepTest: (workflowId, stepId, body) => withApiErrorBody(() => client.console.stepTests.save(workflowId, stepId, body)),
+        // Same discard as `recordTestRun` above.
+        recordStepTestRun: (workflowId, stepId, body) => withApiErrorBody(() => client.console.stepTests.recordRun(workflowId, stepId, body).then(() => undefined)),
+        listStepTests: (workflowId, stepId) => withApiErrorBody(() => client.console.stepTests.list(workflowId, stepId)),
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/src/adapter.js.map

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

package/dist/src/hooks.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 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).
+ *
+ * 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.
+ *
+ * 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.
+ *
+ * @module
+ */
+import type { ConnectionSummary, Doc, DocumentCreateInput, DocumentOptions, DocumentPatch, Me, RunEnvelope, RunInput, Var, VarCreateInput, VarPatch, WorkflowListOptions, WorkflowRunOptions, WorkflowRunResult, WorkflowSummary } from "@w6w/sdk";
+/** What every read hook returns. */
+export interface ReadResult<T> {
+    /** The last successfully fetched value, or `undefined` before the first resolves. */
+    data: T | undefined;
+    /** The error the last fetch rejected with, or `undefined`. */
+    error: unknown;
+    /** `true` while a fetch is in flight (including one triggered by `refetch`). */
+    loading: boolean;
+    /** Re-run the fetch imperatively. */
+    refetch: () => void;
+}
+/** What every mutation hook returns. */
+export interface MutationResult<Args extends unknown[], T> {
+    /** Perform the mutation. Resolves with the result; rejects rather than swallowing an error. */
+    call: (...args: Args) => Promise<T>;
+    /** The last successful result, or `undefined`. */
+    data: T | undefined;
+    /** The error the last call rejected with, or `undefined`. */
+    error: unknown;
+    /** `true` while a call is in flight. */
+    loading: boolean;
+}
+export declare function useMe(): ReadResult<Me>;
+export declare function useDocuments(options?: DocumentOptions): ReadResult<Doc[]>;
+export declare function useDocument(id: string, options?: DocumentOptions): ReadResult<Doc>;
+export declare function useDocumentByKey(key: string, options?: DocumentOptions): ReadResult<Doc>;
+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[]>;
+export declare function useCreateDocument(): MutationResult<[DocumentCreateInput, DocumentOptions?], Doc>;
+export declare function useUpdateDocument(): MutationResult<[
+    string,
+    DocumentPatch,
+    DocumentOptions?
+], Doc>;
+export declare function useDeleteDocument(): MutationResult<[string, DocumentOptions?], void>;
+export declare function useCreateVar(): MutationResult<[VarCreateInput], Var>;
+export declare function useUpdateVar(): MutationResult<[string, VarPatch], Var>;
+export declare function useDeleteVar(): MutationResult<[string], void>;
+/**
+ * `wait` defaults to `true` when the caller's options omit it. `workflows.run`
+ * without `wait` (`node/src/workflows.ts`) leaves the caller with only a
+ * `runId` and no public polling operation to follow it with —
+ * `console.workflows.getRun` exists, but it is studio-internal and unstable
+ * (see README), so this hook does not reach for it. A caller that genuinely
+ * wants the queued-and-walk-away behaviour can still pass `wait: false`
+ * explicitly; the default only fills in what the caller left unstated.
+ */
+export declare function useRunWorkflow(): MutationResult<[string, WorkflowRunOptions?], WorkflowRunResult>;
+export declare function useRun(): MutationResult<[RunInput], RunEnvelope>;
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +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"}

package/dist/src/hooks.js

@@ -0,0 +1,154 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+import { useW6wClient } from "./W6wProvider.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.
+ */
+function useAsync(fetcher) {
+    const [state, setState] = useState({
+        data: undefined,
+        error: undefined,
+        loading: true,
+    });
+    const mountedRef = useRef(true);
+    useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+        };
+    }, []);
+    const refetch = useCallback(() => {
+        setState((s) => ({ ...s, loading: true }));
+        fetcher().then((data) => {
+            if (mountedRef.current)
+                setState({ data, error: undefined, loading: false });
+        }, (error) => {
+            if (mountedRef.current)
+                setState({ data: undefined, error, loading: false });
+        });
+    }, [fetcher]);
+    useEffect(() => {
+        refetch();
+    }, [refetch]);
+    return { data: state.data, error: state.error, loading: state.loading, refetch };
+}
+/**
+ * Shared plumbing behind every mutation hook: imperative only, no auto-fetch.
+ * `mutator` is read through a "latest" ref (updated every render, never a
+ * `useCallback` dependency) so `call`'s own identity stays stable across
+ * renders without ever invoking a stale closure.
+ */
+function useMutationResource(mutator) {
+    const [state, setState] = useState({
+        data: undefined,
+        error: undefined,
+        loading: false,
+    });
+    const mutatorRef = useRef(mutator);
+    mutatorRef.current = mutator;
+    const call = useCallback(async (...args) => {
+        setState({ data: undefined, error: undefined, loading: true });
+        try {
+            const data = await mutatorRef.current(...args);
+            setState({ data, error: undefined, loading: false });
+            return data;
+        }
+        catch (error) {
+            setState({ data: undefined, error, loading: false });
+            throw error;
+        }
+    }, []);
+    return { call, data: state.data, error: state.error, loading: state.loading };
+}
+// ── reads ────────────────────────────────────────────────────────────────
+export function useMe() {
+    const client = useW6wClient();
+    const fetcher = useCallback(() => client.me(), [client]);
+    return useAsync(fetcher);
+}
+export function useDocuments(options) {
+    const client = useW6wClient();
+    const project = options?.project;
+    const fetcher = useCallback(() => client.documents.list(project === undefined ? undefined : { project }), [client, project]);
+    return useAsync(fetcher);
+}
+export function useDocument(id, options) {
+    const client = useW6wClient();
+    const project = options?.project;
+    const fetcher = useCallback(() => client.documents.get(id, project === undefined ? undefined : { project }), [client, id, project]);
+    return useAsync(fetcher);
+}
+export function useDocumentByKey(key, options) {
+    const client = useW6wClient();
+    const project = options?.project;
+    const fetcher = useCallback(() => client.documents.getByKey(key, project === undefined ? undefined : { project }), [client, key, project]);
+    return useAsync(fetcher);
+}
+export function useVars() {
+    const client = useW6wClient();
+    const fetcher = useCallback(() => client.vars.list(), [client]);
+    return useAsync(fetcher);
+}
+export function useVar(id) {
+    const client = useW6wClient();
+    const fetcher = useCallback(() => client.vars.get(id), [client, id]);
+    return useAsync(fetcher);
+}
+export function useConnections() {
+    const client = useW6wClient();
+    const fetcher = useCallback(() => client.connections.list(), [client]);
+    return useAsync(fetcher);
+}
+export function useWorkflows(options) {
+    const client = useW6wClient();
+    const project = options?.project;
+    const fetcher = useCallback(() => client.workflows.list(project === undefined ? undefined : { project }), [client, project]);
+    return useAsync(fetcher);
+}
+// ── mutations ────────────────────────────────────────────────────────────
+export function useCreateDocument() {
+    const client = useW6wClient();
+    return useMutationResource((input, options) => client.documents.create(input, options));
+}
+export function useUpdateDocument() {
+    const client = useW6wClient();
+    return useMutationResource((id, patch, options) => client.documents.update(id, patch, options));
+}
+export function useDeleteDocument() {
+    const client = useW6wClient();
+    return useMutationResource((id, options) => client.documents.delete(id, options));
+}
+export function useCreateVar() {
+    const client = useW6wClient();
+    return useMutationResource((input) => client.vars.create(input));
+}
+export function useUpdateVar() {
+    const client = useW6wClient();
+    return useMutationResource((id, patch) => client.vars.update(id, patch));
+}
+export function useDeleteVar() {
+    const client = useW6wClient();
+    return useMutationResource((id) => client.vars.delete(id));
+}
+/**
+ * `wait` defaults to `true` when the caller's options omit it. `workflows.run`
+ * without `wait` (`node/src/workflows.ts`) leaves the caller with only a
+ * `runId` and no public polling operation to follow it with —
+ * `console.workflows.getRun` exists, but it is studio-internal and unstable
+ * (see README), so this hook does not reach for it. A caller that genuinely
+ * wants the queued-and-walk-away behaviour can still pass `wait: false`
+ * explicitly; the default only fills in what the caller left unstated.
+ */
+export function useRunWorkflow() {
+    const client = useW6wClient();
+    return useMutationResource((id, options) => client.workflows.run(id, { ...options, wait: options?.wait ?? true }));
+}
+export function useRun() {
+    const client = useW6wClient();
+    return useMutationResource((input) => client.run(input));
+}
+//# sourceMappingURL=hooks.js.map

package/dist/src/hooks.js.map

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

package/dist/src/version.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The published version of this package.
+ *
+ * It is the same string as `package.json`'s `version` and the monorepo's
+ * `packages/wrappers/VERSION` — the single source of truth all three w6w
+ * wrappers publish under (see `docs/parity.md`); this lane joins the same
+ * lockstep. `src/__tests__/version.test.ts` fails if any of those disagree,
+ * so this constant cannot drift silently. (Only `package.json` and the shared
+ * `VERSION` file, not `deno.json` — this lane has none.)
+ *
+ * The explicit `: string` annotation is required, not decorative: it is not
+ * about JSR here (this lane never publishes there, see README) — the
+ * monorepo's `release.yml` `verify` step reads this exact file with a
+ * `from_regex` pattern (`VERSION:\s*string\s*=\s*"([^"]+)"`) to cross-check
+ * every wrapper's version in lockstep, and that pattern depends on the literal
+ * `: string` shape being present.
+ */
+export declare const VERSION: string;
+//# sourceMappingURL=version.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,OAAO,EAAE,MAAgB,CAAC"}

package/dist/src/version.js

@@ -0,0 +1,19 @@
+/**
+ * The published version of this package.
+ *
+ * It is the same string as `package.json`'s `version` and the monorepo's
+ * `packages/wrappers/VERSION` — the single source of truth all three w6w
+ * wrappers publish under (see `docs/parity.md`); this lane joins the same
+ * lockstep. `src/__tests__/version.test.ts` fails if any of those disagree,
+ * so this constant cannot drift silently. (Only `package.json` and the shared
+ * `VERSION` file, not `deno.json` — this lane has none.)
+ *
+ * The explicit `: string` annotation is required, not decorative: it is not
+ * about JSR here (this lane never publishes there, see README) — the
+ * monorepo's `release.yml` `verify` step reads this exact file with a
+ * `from_regex` pattern (`VERSION:\s*string\s*=\s*"([^"]+)"`) to cross-check
+ * every wrapper's version in lockstep, and that pattern depends on the literal
+ * `: string` shape being present.
+ */
+export const VERSION = "0.4.0";
+//# sourceMappingURL=version.js.map

package/dist/src/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,OAAO,GAAW,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@w6w/react",
+  "version": "0.4.0",
+  "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": {
+    "type": "git",
+    "url": "git+https://github.com/w6w-io/w6w-wrappers.git",
+    "directory": "react"
+  },
+  "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"],
+  "type": "module",
+  "types": "./dist/mod.d.ts",
+  "main": "./dist/mod.js",
+  "exports": {
+    ".": {
+      "types": "./dist/mod.d.ts",
+      "import": "./dist/mod.js"
+    }
+  },
+  "files": ["dist"],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --import ./src/test-jsx-loader.mjs --test src/__tests__/*.test.ts",
+    "lint": "biome check .",
+    "format": "biome format --write ."
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "dependencies": {
+    "@w6w/sdk": "^0.4.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@types/react": "^18.3.17",
+    "jsdom": "^30.0.1",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "typescript": "^5.7.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}