@laguzjs/client 0.0.0-stage → 0.1.0

package/dist/react.js

@@ -0,0 +1,127 @@
+import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
+import { ready } from "./pool.js";
+import { toTree, view } from "./selection.js";
+const IDLE = Object.freeze({ has: {} });
+const unsubscribed = () => () => { };
+// React runs the subscribe step of every useSyncExternalStore in a commit in
+// one synchronous pass, so everything a commit renders lands in one batch.
+// Subscribing happens after paint. Registering during render would start the
+// request a little earlier, but leaks when React discards a concurrent render.
+function useEntry(pool, root, args, fields, minStaleTime = 0) {
+    const key = JSON.stringify([root, args, fields]);
+    const tree = useMemo(() => toTree(fields), [key]);
+    const subscribe = useCallback((cb) => (args ? pool.watch(root, args, tree, cb, minStaleTime) : unsubscribed()), [pool, key]);
+    const snap = useSyncExternalStore(subscribe, () => (args ? pool.read(root, args) : IDLE));
+    const data = useMemo(() => view(snap.data, fields), [snap.data, key]);
+    return { snap, tree, data };
+}
+/**
+ * Read `fields` of `root(args)`. Pass `args: null` to skip the query, for
+ * example until the value it depends on has loaded.
+ */
+export function useData(pool, root, args, fields) {
+    const { snap, tree, data } = useEntry(pool, root, args, fields);
+    return {
+        data: data,
+        error: snap.error,
+        loading: !!args && !snap.error && !ready(snap, tree),
+    };
+}
+/**
+ * Like {@link useData}, but suspends until the data is ready and throws errors
+ * to the nearest error boundary. Call `pool.invalidate(root)` when the boundary
+ * resets to retry.
+ *
+ * Give each component its own `<Suspense>` boundary. React stops rendering the
+ * siblings of a component that suspends, so components sharing a boundary are
+ * fetched in two requests instead of one.
+ */
+export function useSuspenseData(pool, root, args, fields) {
+    // Data that just resolved shouldn't be refetched when the component commits.
+    const { snap, tree, data } = useEntry(pool, root, args, fields, 1000);
+    if (snap.error)
+        throw snap.error;
+    if (!ready(snap, tree))
+        throw pool.load(root, args, tree);
+    return data;
+}
+/**
+ * An infinite list. `page(prev, index)` describes page `index` from the data of
+ * the previous page (its cursor), or returns null after the last page.
+ *
+ * Every page is a regular cache entry: refreshing refetches all loaded pages in
+ * one request, and pages whose cursor moved are fetched right after.
+ * `prefetch` keeps that many pages loaded ahead, so `loadMore` shows them at once.
+ */
+export function useInfiniteData(pool, page, { prefetch = 0 } = {}) {
+    const [shown, setShown] = useState(1);
+    // Page n needs page n-1's data for its cursor, so walk the cache in order.
+    const pages = [];
+    const views = [];
+    let end = false;
+    for (let i = 0; i < shown + prefetch; i++) {
+        const p = page(views[i - 1], i);
+        if (!p) {
+            end = true;
+            break;
+        }
+        pages.push(p);
+        const snap = pool.read(p.root, p.args);
+        if (!ready(snap, toTree(p.fields)))
+            break;
+        views.push(view(snap.data, p.fields));
+    }
+    // Re-render when any page changes; the walk above then reads the new data.
+    const notify = useRef(() => { });
+    const subscribe = useCallback((cb) => {
+        notify.current = cb;
+        return () => {
+            notify.current = () => { };
+        };
+    }, []);
+    const lastSnaps = useRef([]);
+    useSyncExternalStore(subscribe, () => {
+        const snaps = pages.map((p) => pool.read(p.root, p.args));
+        const prev = lastSnaps.current;
+        if (snaps.length === prev.length && snaps.every((s, i) => s === prev[i]))
+            return prev;
+        lastSnaps.current = snaps;
+        return snaps;
+    });
+    // Keep one subscription per page for as long as the page is in the list.
+    // Resubscribing every page when the list grows would count as a new mount
+    // for each of them and refetch them all.
+    const watches = useRef(new Map());
+    const key = JSON.stringify(pages);
+    useEffect(() => {
+        const next = new Map();
+        for (const p of pages) {
+            const k = JSON.stringify(p);
+            next.set(k, watches.current.get(k) ?? pool.watch(p.root, p.args, p.fields, () => notify.current()));
+            watches.current.delete(k);
+        }
+        // Whatever is left belongs to pages that dropped out, e.g. after a cursor moved.
+        watches.current.forEach((unwatch) => unwatch());
+        watches.current = next;
+    }, [pool, key]);
+    useEffect(() => () => {
+        watches.current.forEach((unwatch) => unwatch());
+        watches.current = new Map();
+    }, [pool]);
+    const loaded = Math.min(views.length, shown);
+    const hasMore = loaded === shown &&
+        (views.length > shown || (!end && page(views[loaded - 1], loaded) !== null));
+    const error = pages.map((p) => pool.read(p.root, p.args).error).find(Boolean);
+    return {
+        pages: views.slice(0, shown),
+        hasMore,
+        loading: views.length === 0 && !error,
+        loadingMore: views.length > 0 && views.length < shown && !error,
+        error,
+        loadMore: () => {
+            if (hasMore)
+                setShown(loaded + 1);
+        },
+    };
+}
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

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

package/dist/selection.d.ts

@@ -0,0 +1,68 @@
+/**
+ * What a consumer selects on a root field.
+ *
+ * - `"name"`: a scalar field
+ * - `{ projects: ["id"] }`: a nested selection
+ * - `{ projects: { args: { first: 3 }, fields: ["id"] } }`: a field with arguments
+ * - `{ recent: { field: "projects", args: { first: 3 }, fields: ["id"] } }`: the same field under another name
+ */
+export type Fields = (string | {
+    [out: string]: Fields | FieldArg;
+})[];
+export type FieldArg = {
+    field?: string;
+    args?: Record<string, unknown>;
+    fields?: Fields;
+};
+/** A merged selection. Keys are `field` or `field(args)`; a leaf is `{}`. */
+export type Tree = {
+    [key: string]: Tree;
+};
+/**
+ * An argument value read from another root field's result, for queries that
+ * depend on each other. See {@link ref}.
+ */
+export type Ref = {
+    $ref: [root: string, args: object, path: string];
+};
+export declare function name(s: string): string;
+/**
+ * Use the value at `path` in `root(args)` as an argument:
+ * `ref("user", { id: 1 }, "teamId")`. Refs can be nested.
+ */
+export declare function ref(root: string, args: object, path: string): Ref;
+export declare const isRef: (v: unknown) => v is Ref;
+export declare function collectRefs(v: unknown): Ref[];
+export declare const pathTree: (path: string) => Tree;
+export declare const getPath: (data: any, path: string) => unknown;
+export declare function toTree(fields: Fields): Tree;
+export declare function merge(a: Tree, b: Tree): Tree;
+/** The part of `want` that `have` doesn't cover, or null. */
+export declare function diff(want: Tree, have: Tree): Tree | null;
+/**
+ * True when fetching `tree` would add fields inside a list we already hold.
+ * Merging two fetches of a list by index is wrong if the list changed in
+ * between, so the caller refetches the whole selection instead.
+ */
+export declare function touchesList(tree: Tree, data: any): boolean;
+/** The key under which `field(args)` is stored in raw entry data. */
+export declare const fieldKey: (field: string, args?: object) => string;
+/** Project raw entry data onto one consumer's selection, with its own output names. */
+export declare function view(data: any, fields: Fields): any;
+export declare function printTree(tree: Tree): string;
+/**
+ * Print a JS value as a GraphQL literal. JSON string escaping is valid GraphQL
+ * string escaping. Object keys are sorted so equal arguments print the same.
+ * Refs print through `onRef`, or as a readable key when it is absent.
+ * Enum values are not supported yet: strings always print quoted.
+ */
+export declare function printValue(v: any, onRef?: (r: Ref) => string): string;
+export declare function printArgs(args: object, onRef?: (r: Ref) => string): string;
+/** `root(args) { fields }`: the text the pool sends for a single consumer. */
+export declare const printField: (root: string, args: object, fields: Fields) => string;
+/**
+ * Merge a partial result into cached data. Two arrays only meet here when they
+ * come from the same fetch shape, because `touchesList` forces whole refetches.
+ */
+export declare function mergeData(a: any, b: any): any;
+//# sourceMappingURL=selection.d.ts.map

package/dist/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../src/selection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAA;CAAE,CAAC,EAAE,CAAC;AACvE,MAAM,MAAM,QAAQ,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3F,6EAA6E;AAC7E,MAAM,MAAM,IAAI,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAE3C;;;GAGG;AACH,MAAM,MAAM,GAAG,GAAG;IAAE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAIvE,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGtC;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,CAMjE;AAED,eAAO,MAAM,KAAK,MAAO,OAAO,KAAG,CAAC,IAAI,GAAyD,CAAC;AAElG,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,GAAG,EAAE,CAI7C;AAED,eAAO,MAAM,QAAQ,SAAU,MAAM,KAAG,IACiC,CAAC;AAE1E,eAAO,MAAM,OAAO,SAAU,GAAG,QAAQ,MAAM,KAAG,OACU,CAAC;AAE7D,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAe3C;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,IAAI,CAI5C;AAED,6DAA6D;AAC7D,wBAAgB,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAOxD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAI1D;AAkBD,qEAAqE;AACrE,eAAO,MAAM,QAAQ,UAAW,MAAM,SAAQ,MAAM,KAAQ,MACvB,CAAC;AAEtC,uFAAuF;AACvF,wBAAgB,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,CAmBnD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAK5C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,MAAM,GAAG,MAAM,CAWrE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,MAAM,GAAG,MAAM,CAG1E;AAED,8EAA8E;AAC9E,eAAO,MAAM,UAAU,SAAU,MAAM,QAAQ,MAAM,UAAU,MAAM,KAAG,MACd,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,GAAG,CAQ7C"}

package/dist/selection.js

@@ -0,0 +1,161 @@
+const NAME = /^[_A-Za-z][_0-9A-Za-z]*$/;
+export function name(s) {
+    if (!NAME.test(s))
+        throw new Error(`invalid GraphQL name: ${s}`);
+    return s;
+}
+/**
+ * Use the value at `path` in `root(args)` as an argument:
+ * `ref("user", { id: 1 }, "teamId")`. Refs can be nested.
+ */
+export function ref(root, args, path) {
+    for (const segment of path.split(".")) {
+        if (name(segment).includes("__"))
+            throw new Error(`ref path segments can't contain "__": ${segment}`);
+    }
+    return { $ref: [name(root), args, path] };
+}
+export const isRef = (v) => v !== null && typeof v === "object" && "$ref" in v;
+export function collectRefs(v) {
+    if (isRef(v))
+        return [v];
+    if (v && typeof v === "object")
+        return Object.values(v).flatMap(collectRefs);
+    return [];
+}
+export const pathTree = (path) => path.split(".").reduceRight((tree, key) => ({ [key]: tree }), {});
+export const getPath = (data, path) => path.split(".").reduce((value, key) => value?.[key], data);
+export function toTree(fields) {
+    const tree = {};
+    for (const f of fields) {
+        if (typeof f === "string") {
+            tree[name(f)] ??= {};
+            continue;
+        }
+        for (const [out, v] of Object.entries(f)) {
+            name(out);
+            const key = Array.isArray(v) ? out : canonical(v.field ?? out, v.args ?? {});
+            const sub = Array.isArray(v) ? v : (v.fields ?? []);
+            tree[key] = merge(tree[key] ?? {}, toTree(sub));
+        }
+    }
+    return tree;
+}
+export function merge(a, b) {
+    const tree = { ...a };
+    for (const key in b)
+        tree[key] = merge(tree[key] ?? {}, b[key]);
+    return tree;
+}
+/** The part of `want` that `have` doesn't cover, or null. */
+export function diff(want, have) {
+    let missing = null;
+    for (const key in want) {
+        const sub = have[key] ? diff(want[key], have[key]) : want[key];
+        if (sub)
+            (missing ??= {})[key] = sub;
+    }
+    return missing;
+}
+/**
+ * True when fetching `tree` would add fields inside a list we already hold.
+ * Merging two fetches of a list by index is wrong if the list changed in
+ * between, so the caller refetches the whole selection instead.
+ */
+export function touchesList(tree, data) {
+    if (!data || typeof data !== "object")
+        return false;
+    if (Array.isArray(data))
+        return true;
+    return Object.keys(tree).some((key) => touchesList(tree[key], data[responseKey(key)]));
+}
+const canonical = (field, args) => name(field) + printArgs(args);
+// FNV-1a in base 36: a short, stable alias suffix.
+function hash(s) {
+    let h = 2166136261;
+    for (let i = 0; i < s.length; i++)
+        h = Math.imul(h ^ s.charCodeAt(i), 16777619);
+    return (h >>> 0).toString(36);
+}
+// Fields with arguments are aliased: two consumers may select the same field
+// with different arguments, and both results have to coexist in one entry.
+function responseKey(key) {
+    const paren = key.indexOf("(");
+    return paren < 0 ? key : `${key.slice(0, paren)}_${hash(key)}`;
+}
+/** The key under which `field(args)` is stored in raw entry data. */
+export const fieldKey = (field, args = {}) => responseKey(canonical(field, args));
+/** Project raw entry data onto one consumer's selection, with its own output names. */
+export function view(data, fields) {
+    if (data == null || typeof data !== "object")
+        return data;
+    if (Array.isArray(data))
+        return data.map((item) => view(item, fields));
+    const out = {};
+    for (const f of fields) {
+        if (typeof f === "string") {
+            out[f] = data[f];
+            continue;
+        }
+        for (const [key, v] of Object.entries(f)) {
+            if (Array.isArray(v)) {
+                out[key] = view(data[key], v);
+            }
+            else {
+                const raw = data[fieldKey(v.field ?? key, v.args)];
+                out[key] = v.fields ? view(raw, v.fields) : raw;
+            }
+        }
+    }
+    return out;
+}
+export function printTree(tree) {
+    const keys = Object.keys(tree);
+    if (!keys.length)
+        return "";
+    const field = (key) => (responseKey(key) === key ? key : `${responseKey(key)}: ${key}`);
+    return ` { ${keys.map((key) => field(key) + printTree(tree[key])).join(" ")} }`;
+}
+/**
+ * Print a JS value as a GraphQL literal. JSON string escaping is valid GraphQL
+ * string escaping. Object keys are sorted so equal arguments print the same.
+ * Refs print through `onRef`, or as a readable key when it is absent.
+ * Enum values are not supported yet: strings always print quoted.
+ */
+export function printValue(v, onRef) {
+    if (isRef(v))
+        return onRef ? onRef(v) : `@${v.$ref[0]}${printArgs(v.$ref[1])}.${v.$ref[2]}`;
+    if (typeof v?.toJSON === "function")
+        v = v.toJSON();
+    if (Array.isArray(v))
+        return `[${v.map((x) => printValue(x, onRef)).join(", ")}]`;
+    if (v && typeof v === "object") {
+        const keys = Object.keys(v)
+            .filter((key) => v[key] !== undefined)
+            .sort();
+        return `{${keys.map((key) => `${name(key)}: ${printValue(v[key], onRef)}`).join(", ")}}`;
+    }
+    return JSON.stringify(v ?? null);
+}
+export function printArgs(args, onRef) {
+    const inner = printValue(args, onRef).slice(1, -1);
+    return inner ? `(${inner})` : "";
+}
+/** `root(args) { fields }`: the text the pool sends for a single consumer. */
+export const printField = (root, args, fields) => name(root) + printArgs(args) + printTree(toTree(fields));
+/**
+ * Merge a partial result into cached data. Two arrays only meet here when they
+ * come from the same fetch shape, because `touchesList` forces whole refetches.
+ */
+export function mergeData(a, b) {
+    if (Array.isArray(a) && Array.isArray(b))
+        return b.map((item, i) => mergeData(a[i], item));
+    if (a && b && typeof a === "object" && typeof b === "object" && !Array.isArray(b)) {
+        const out = { ...a };
+        for (const key in b)
+            out[key] = mergeData(a[key], b[key]);
+        return out;
+    }
+    return b;
+}
+//# sourceMappingURL=selection.js.map

package/dist/selection.js.map

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

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "@laguzjs/client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Batch the GraphQL data needs of a React commit into one request, streamed back field by field.",
+  "keywords": [
+    "batching",
+    "data-fetching",
+    "graphql",
+    "hooks",
+    "react",
+    "streaming"
+  ],
+  "homepage": "https://laguz.maxenceleguery.net",
+  "bugs": {
+    "url": "https://github.com/maxenceleguery/laguz/issues"
+  },
+  "license": "MIT",
+  "author": "Maxence Leguery",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/maxenceleguery/laguz.git",
+    "directory": "packages/client"
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
+      "default": "./dist/index.js"
+    },
+    "./react": {
+      "source": "./src/react.ts",
+      "types": "./dist/react.d.ts",
+      "bun": "./src/react.ts",
+      "default": "./dist/react.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  }
+}

package/src/http.ts

@@ -0,0 +1,42 @@
+import type { Fetcher, Response as GqlResponse } from "./pool.ts";
+
+export type HttpOptions = {
+  /** Ask for one NDJSON line per root field. Falls back to JSON if the server doesn't stream. */
+  stream?: boolean;
+  headers?: Record<string, string>;
+};
+
+/** A fetcher that POSTs `{ query }` to `url`. */
+export function httpFetcher(url: string, options: HttpOptions = {}): Fetcher {
+  return (query) => {
+    const res = fetch(url, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        accept: options.stream ? "application/x-ndjson, application/json" : "application/json",
+        ...options.headers,
+      },
+      body: JSON.stringify({ query }),
+    });
+    return options.stream ? lines(res) : res.then((r) => r.json());
+  };
+}
+
+async function* lines(pending: Promise<Response>): AsyncGenerator<GqlResponse> {
+  const res = await pending;
+  if (!res.headers.get("content-type")?.includes("ndjson")) {
+    yield await res.json();
+    return;
+  }
+  let buffer = "";
+  for await (const text of res.body!.pipeThrough(new TextDecoderStream())) {
+    buffer += text;
+    let newline;
+    while ((newline = buffer.indexOf("\n")) >= 0) {
+      const line = buffer.slice(0, newline);
+      buffer = buffer.slice(newline + 1);
+      if (line.trim()) yield JSON.parse(line);
+    }
+  }
+  if (buffer.trim()) yield JSON.parse(buffer);
+}

package/src/index.ts

@@ -0,0 +1,6 @@
+export { createPool, ready } from "./pool.ts";
+export type { Fetcher, GqlError, Match, Options, Pool, Response, Snapshot } from "./pool.ts";
+export { fieldKey, printField, ref, toTree, view } from "./selection.ts";
+export type { FieldArg, Fields, Ref, Tree } from "./selection.ts";
+export { httpFetcher } from "./http.ts";
+export type { HttpOptions } from "./http.ts";