@firsthandjs/data-urql 0.6.1 → 0.6.2

package/README.md

@@ -6,7 +6,7 @@ urql as a client for [`@firsthandjs/data`](https://www.npmjs.com/package/@firsth
 npm install @firsthandjs/data-urql
 ```
 
-0.53 kB gzip. It has **no dependency on urql** and no peer dependency either —
+0.58 kB gzip. It has **no dependency on urql** and no peer dependency either —
 the two methods it uses are declared structurally. It was checked against
 `@urql/core` 6, which has no React dependency of its own.
 
@@ -72,7 +72,12 @@ invalidation, so neither call site writes a tag at all.
   from a helper. `force` is passed on as `requestPolicy: 'network-only'`, so an
   invalidation reaches past it.
 
-What you should not have is both, because two caches over one piece of data
+If you do give this client a cache, its keys carry the operation, the variables
+(in any order they were written) and an identity — the `authorization` header
+by default, or a `scope` you give — so two accounts in one session cannot read
+each other's answers.
+
+What you should not have is two caches over one piece of data, because they
 disagree. If urql's cache should be the source of truth for an entity shown in
 many places, subscribe to it with `fromObservable` instead.
 

package/dist/index.d.ts

@@ -58,6 +58,13 @@ export interface UrqlClientOptions {
      * only, keyed by operation and variables.
      */
     readonly cache?: false | CacheOptions | CacheClient;
+    /**
+     * Who the cached answers belong to. Defaults to the `authorization` header
+     * this request would carry, so two accounts in one session cannot read each
+     * other's answers out of one operation-shaped key. Read per request,
+     * untracked.
+     */
+    readonly scope?: () => string;
     /** Merged into urql's operation context for every request. */
     readonly context?: Record<string, unknown>;
 }

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,YAAY,EAEjB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,MAAM,EACX,KAAK,SAAS,EACf,MAAM,mBAAmB,CAAC;AAG3B,iEAAiE;AACjE,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,kEAAkE;AAClE,MAAM,WAAW,QAAQ;IACvB,KAAK,CACH,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC;QAAE,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;KAAE,CAAC;IACjD,QAAQ,CACN,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC;QAAE,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;KAAE,CAAC;CAClD;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3E;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,YAAY,GAAG,WAAW,CAAC;IACpD,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,KAAK,CAAC,CAAC,EAAE,CAAC,SAAS,SAAS,EAC1B,QAAQ,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,EAC/B,GAAG,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC5B,MAAM,CAAC,CAAC,CAAC,CAAC;IACb;;;;OAIG;IACH,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,SAAS,EAC3B,QAAQ,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,EAC/B,GAAG,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC5B,MAAM,CAAC,CAAC,CAAC,CAAC;IACb,8EAA8E;IAC9E,IAAI,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,CAAC;CACzC;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAE,iBAAsB,GAAG,UAAU,CAsF9F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,YAAY,EAEjB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,MAAM,EACX,KAAK,SAAS,EACf,MAAM,mBAAmB,CAAC;AAG3B,iEAAiE;AACjE,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,kEAAkE;AAClE,MAAM,WAAW,QAAQ;IACvB,KAAK,CACH,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC;QAAE,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;KAAE,CAAC;IACjD,QAAQ,CACN,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC;QAAE,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;KAAE,CAAC;CAClD;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3E;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,YAAY,GAAG,WAAW,CAAC;IACpD;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;IAC9B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,KAAK,CAAC,CAAC,EAAE,CAAC,SAAS,SAAS,EAC1B,QAAQ,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,EAC/B,GAAG,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC5B,MAAM,CAAC,CAAC,CAAC,CAAC;IACb;;;;OAIG;IACH,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,SAAS,EAC3B,QAAQ,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,EAC/B,GAAG,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC5B,MAAM,CAAC,CAAC,CAAC,CAAC;IACb,8EAA8E;IAC9E,IAAI,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,CAAC;CACzC;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAE,iBAAsB,GAAG,UAAU,CAkG9F"}

package/dist/index.js

@@ -1 +1 @@
-import{createCacheClient as h,resolveTags as y}from"@firsthandjs/data";import{untrack as T}from"@firsthandjs/core";function V(c,n={}){let o=n.cache===void 0||n.cache===!1?void 0:"read"in n.cache?n.cache:h(n.cache),l=async(e,t,s,a)=>{let r=typeof n.headers=="function"?T(n.headers):n.headers,i={...n.context,fetchOptions:{signal:a.signal,...r===void 0?{}:{headers:r}},requestPolicy:a.force?"network-only":"cache-first"},u=await(e==="mutation"?c.mutation(t,s,i):c.query(t,s,i)).toPromise();if(u.error!==void 0)throw u.error;return u.data},d=(e,t,s)=>async a=>{let r=s[0]??{};if(a.tags?.(...y(e==="mutation"?t.invalidates:t.tags,r)),o===void 0||e==="mutation")return await l(e,t.source,r,a);let i=`${t.operation}(${JSON.stringify(r)})`;return await o.read(i,m=>l(e,t.source,r,m))(a)};return{cache:o,query:(e,...t)=>d("query",e,t),mutate:(e,...t)=>d("mutation",e,t),with:e=>V(c,{...n,...e,cache:e.cache??o??!1})}}export{V as createUrqlClient};
+import{createCacheClient as f,resolveTags as T,stableKey as V}from"@firsthandjs/data";import{untrack as l}from"@firsthandjs/core";function g(c,t={}){let s=t.cache===void 0||t.cache===!1?void 0:"read"in t.cache?t.cache:f(t.cache),y=()=>{if(t.scope!==void 0)return l(t.scope);let e=typeof t.headers=="function"?l(t.headers):t.headers??{};return e.authorization??e.Authorization??""},d=async(e,r,o,a)=>{let n=typeof t.headers=="function"?l(t.headers):t.headers,i={...t.context,fetchOptions:{signal:a.signal,...n===void 0?{}:{headers:n}},requestPolicy:a.force?"network-only":"cache-first"},u=await(e==="mutation"?c.mutation(r,o,i):c.query(r,o,i)).toPromise();if(u.error!==void 0)throw u.error;return u.data},m=(e,r,o)=>async a=>{let n=o[0]??{};if(a.tags?.(...T(e==="mutation"?r.invalidates:r.tags,n)),s===void 0||e==="mutation")return await d(e,r.source,n,a);let i=`${y()}\0${r.operation}(${V(n)})`;return await s.read(i,h=>d(e,r.source,n,h))(a)};return{cache:s,query:(e,...r)=>m("query",e,r),mutate:(e,...r)=>m("mutation",e,r),with:e=>g(c,{...t,...e,cache:e.cache??s??!1})}}export{g as createUrqlClient};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@firsthandjs/data-urql",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "Loaders for urql, for @firsthandjs/data. Takes your client; never configures it.",
   "license": "MIT",
   "type": "module",
@@ -19,7 +19,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@firsthandjs/data": "0.6.1"
+    "@firsthandjs/data": "0.6.2"
   },
   "engines": {
     "node": ">=20.11.0"