@w6w/react 0.6.0 → 0.9.12

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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,OAAO,EAAE,MAAgB,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,OAAO,EAAE,MAAiB,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.12";
 //# sourceMappingURL=version.js.map

package/dist/src/version.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@w6w/react",
-  "version": "0.6.0",
+  "version": "0.9.12",
   "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.12"
   },
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
     "@types/react": "^18.3.17",
+    "@w6w/ui": "0.1.0",
     "jsdom": "^30.0.1",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",