@firsthandjs/data 0.5.0

package/dist/store.d.ts

@@ -0,0 +1,121 @@
+/**
+ * The store: what is loaded, and when it has to be loaded again.
+ *
+ * It holds resources, it matches invalidation patterns against their tags, and
+ * it knows nothing else. No URL, no method, no body, no client — a loader is
+ * an arbitrary function returning a promise, and it may be a `fetch`, an
+ * Apollo call, a worker or an algorithm that never leaves the browser
+ * (ADR-0022).
+ *
+ * What it deliberately is not is a cache. A cache is defined by a second
+ * lookup for the same thing finding the first one's result, and that requires
+ * identity — a key, a name, something two callers agree on. Every form of that
+ * is a thing to forget or to collide on, and deriving it implicitly from tags
+ * is worse: it silently serves one resource's data to another, which is the
+ * measured bug this design exists to remove. A resource belongs to its call
+ * site. Deduplication, response caching and normalisation belong to the
+ * transport, where the knowledge of what is *the same thing* actually lives.
+ */
+import { type ReadonlyCell, type Signal } from '@firsthandjs/core';
+import { type Tag } from './tags.js';
+export type Status = 'idle' | 'loading' | 'success' | 'error';
+/** What a loader is given. */
+export interface LoadContext {
+    /** Aborted when this run is superseded, or the resource goes away. */
+    readonly signal: AbortSignal;
+    /**
+     * Declares what this resource is about. **Replaces**: call it before the
+     * first `await` when you know, again after it when only the server does, and
+     * the last call of a run wins. Name both if you want both.
+     */
+    readonly tags: (...tags: Tag[]) => void;
+    /**
+     * True when this run was caused by an invalidation or by `reload()`.
+     *
+     * It is the one place the layers touch. A transport cache would otherwise
+     * hand back the answer that was just invalidated, and the invalidation would
+     * be silently pointless — so pass it on: `cache: force ? 'reload' : 'default'`
+     * for `fetch`, `fetchPolicy: force ? 'network-only' : 'cache-first'` for
+     * Apollo, `requestPolicy` for urql.
+     */
+    readonly force: boolean;
+}
+/** What an action is given. */
+export interface ActionContext {
+    readonly signal: AbortSignal;
+    /**
+     * Declares what this action changed, so resources carrying a matching tag
+     * reload. Replaces, like `tags`, and may be called after the answer — which
+     * is the case where only the server knows what was touched.
+     */
+    readonly invalidates: (...tags: Tag[]) => void;
+}
+export interface Resource<T> {
+    readonly data: ReadonlyCell<T | undefined>;
+    readonly error: ReadonlyCell<unknown>;
+    readonly status: ReadonlyCell<Status>;
+    /** True while a run is in flight, including one behind a visible value. */
+    readonly loading: ReadonlyCell<boolean>;
+    /** Runs again, with `force`. Never rejects. */
+    reload(): Promise<T | undefined>;
+    /** Stops this resource and aborts anything in flight. */
+    dispose(): void;
+}
+/** Somewhere to keep results between visits. See {@link DataOptions}. */
+export interface Storage {
+    /**
+     * What was kept under this name, if anything. May return a promise; a value
+     * that arrives after the loader has answered is dropped.
+     */
+    read?(name: string): unknown;
+    /** Called after each successful run of a named resource. */
+    write?(name: string, data: unknown): void;
+    /** Called by `store.clear()`, which is what a sign-out calls. */
+    clear?(): void;
+}
+export interface DataOptions {
+    /** Where named resources are kept between visits. */
+    readonly storage?: Storage;
+}
+interface Held<T = unknown> {
+    data: Signal<T | undefined>;
+    error: Signal<unknown>;
+    status: Signal<Status>;
+    loading: Signal<boolean>;
+    /** What this resource is currently about. Replaced by every run. */
+    tags: Tag[];
+    controller: AbortController | null;
+    /** Patterns seen while the current run is in flight, for the late-tag race. */
+    pending: Tag[];
+    /** Set when an invalidation matched a run that had not finished. */
+    superseded: boolean;
+    disposed: boolean;
+    name: string | undefined;
+    run: (force: boolean) => Promise<T | undefined>;
+}
+export interface DataStore {
+    /** Everything carrying a matching tag runs again, with `force`. */
+    invalidate(...patterns: Tag[]): Promise<void>;
+    /** Forgets every resource and empties the storage. */
+    clear(): void;
+    /** How many resources are alive. For tests and devtools. */
+    readonly size: number;
+    /** Internal: a resource registers itself here. */
+    hold(held: Held): () => void;
+    /** Internal: the storage this store was given. */
+    readonly storage: Storage | undefined;
+}
+export declare function createData(options?: DataOptions): DataStore;
+/**
+ * Runs one resource. Shared by `useResource` and the observable bridges, so
+ * that a resource behaves the same however its values arrive.
+ */
+export declare function createHeld<T>(store: DataStore, name: string | undefined): Held<T>;
+/** Settles a successful run. Exported for the bridges, which have no loader. */
+export declare function succeed<T>(entry: Held<T>, value: T): void;
+/** Settles a failed run. */
+export declare function fail(entry: Held, error: unknown): void;
+/** The public face of a held resource. */
+export declare function expose<T>(entry: Held<T>, release: () => void): Resource<T>;
+export type { Held };
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

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

package/dist/tags.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Tags.
+ *
+ * A cache key answers "is this the same request?". A tag answers "what is this
+ * request *about*?", which is the question invalidation actually asks. React
+ * Query conflates the two: the key is both the identity and the invalidation
+ * handle, so invalidating everything about user 7 means knowing every key
+ * prefix anyone wrote for user 7.
+ *
+ * Here a query carries as many tags as it likes — `user(id: 7)`, `users`,
+ * `permissions(org: 3)` — and a mutation invalidates tags, not queries. A tag
+ * with fewer variables matches more: `user` invalidates every user, `user(id:
+ * 7)` invalidates exactly that one.
+ */
+/** Variables a tag may carry. Values are compared with `Object.is`. */
+export type TagVars = Readonly<Record<string, string | number | boolean | null>>;
+/**
+ * The arguments an operation was called with.
+ *
+ * Deliberately `unknown` rather than something serialisable: what a loader
+ * does with them is the transport's business, and narrowing the type here
+ * would constrain that for no gain — nothing in this package uses them as an
+ * identity.
+ */
+export type Variables = Readonly<Record<string, unknown>>;
+export interface Tag {
+    readonly name: string;
+    readonly vars: TagVars;
+}
+/** Builds a tag. `tag('user', { id })` is the usual shape. */
+export declare function tag(name: string, vars?: TagVars): Tag;
+/**
+ * Whether `pattern` covers `candidate`.
+ *
+ * Same name, and every variable the pattern names has the same value on the
+ * candidate. Variables the pattern leaves out are wildcards — which is what
+ * makes `tag('user')` mean "every user".
+ */
+export declare function tagMatches(pattern: Tag, candidate: Tag): boolean;
+/** Whether any of `patterns` covers any of `tags`. */
+export declare function anyTagMatches(patterns: readonly Tag[], tags: readonly Tag[]): boolean;
+//# sourceMappingURL=tags.d.ts.map

package/dist/tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../src/tags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,uEAAuE;AACvE,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;AAEjF;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE1D,MAAM,WAAW,GAAG;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAID,8DAA8D;AAC9D,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,OAAiB,GAAG,GAAG,CAE9D;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,GAAG,OAAO,CAUhE;AAED,sDAAsD;AACtD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,SAAS,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,GAAG,EAAE,GAAG,OAAO,CASrF"}

package/dist/vite.d.ts

@@ -0,0 +1,25 @@
+interface TransformResult {
+    code: string;
+    map: null;
+}
+export interface GraphQLPlugin {
+    name: string;
+    enforce: 'pre';
+    transform(this: unknown, code: string, id: string): TransformResult | null;
+}
+/**
+ * Inlines `#import "./fragments.gql"`, the convention every GraphQL loader
+ * uses.
+ *
+ * A fragment lives in one file and is used by several operations, and the
+ * server has to be sent the fragment along with the operation that spreads it
+ * — so the import is resolved here rather than at runtime, where the file
+ * system is not available and the cost would be per page load.
+ *
+ * Each file is included once however many times it is imported, and a cycle
+ * terminates for the same reason.
+ */
+export declare function inlineImports(source: string, file: string, seen?: Set<string>, read?: (path: string) => string): string;
+export declare function graphql(): GraphQLPlugin;
+export {};
+//# sourceMappingURL=vite.d.ts.map

package/dist/vite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAgCA,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,IAAI,CAAC;CACX;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,KAAK,CAAC;IACf,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAAC;CAC5E;AAKD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,GAAG,CAAC,MAAM,CAAmB,EACnC,IAAI,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAA6C,GACpE,MAAM,CAWR;AAED,wBAAgB,OAAO,IAAI,aAAa,CAgBvC"}

package/dist/vite.dev.js

@@ -0,0 +1,223 @@
+// packages/data/src/vite.ts
+import { readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+
+// packages/data/src/document.ts
+var DIRECTIVE = /^@(tag|invalidates)\b/;
+var OPERATION = /\b(query|mutation|subscription)\b[^\S\n]*([A-Za-z_]\w*)?/;
+var NAME = /^[_A-Za-z][_0-9A-Za-z]*/;
+var FirsthandDirectiveError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "FirsthandDirectiveError";
+  }
+};
+function endOfString(source, start) {
+  if (source.startsWith('"""', start)) {
+    const close = source.indexOf('"""', start + 3);
+    return close === -1 ? source.length : close + 3;
+  }
+  let at = start + 1;
+  while (at < source.length && source[at] !== '"') {
+    at += source[at] === "\\" ? 2 : 1;
+  }
+  return at + 1;
+}
+function endOfArguments(source, start) {
+  let depth = 0;
+  let at = start;
+  while (at < source.length) {
+    const character = source[at];
+    if (character === '"') {
+      at = endOfString(source, at);
+      continue;
+    }
+    if (character === "(" || character === "[" || character === "{") {
+      depth++;
+    } else if (character === ")" || character === "]" || character === "}") {
+      depth--;
+      if (depth === 0) {
+        return at + 1;
+      }
+    }
+    at++;
+  }
+  throw new FirsthandDirectiveError(`unclosed arguments in ${source.slice(start, start + 40)}`);
+}
+function unquote(quoted, directive) {
+  try {
+    return JSON.parse(quoted);
+  } catch {
+    throw new FirsthandDirectiveError(`@${directive}: ${quoted} is not a valid string`);
+  }
+}
+function parseArguments(raw, directive) {
+  const vars = {};
+  let at = 0;
+  const skipIgnored = () => {
+    while (at < raw.length && /[\s,]/.test(raw[at])) {
+      at++;
+    }
+  };
+  skipIgnored();
+  while (at < raw.length) {
+    const name = NAME.exec(raw.slice(at));
+    if (name === null) {
+      throw new FirsthandDirectiveError(
+        `@${directive}: expected an argument name at "${raw.slice(at)}"`
+      );
+    }
+    at += name[0].length;
+    skipIgnored();
+    if (raw[at] !== ":") {
+      throw new FirsthandDirectiveError(`@${directive}: argument ${name[0]} has no value`);
+    }
+    at++;
+    skipIgnored();
+    const read = readValue(raw, directive, at);
+    vars[name[0]] = read.value;
+    at = read.next;
+    skipIgnored();
+  }
+  return vars;
+}
+function readValue(raw, directive, at) {
+  const character = raw[at];
+  if (character === "$") {
+    const name = NAME.exec(raw.slice(at + 1));
+    if (name === null) {
+      throw new FirsthandDirectiveError(`@${directive}: expected a variable name after $`);
+    }
+    return { value: { variable: name[0] }, next: at + 1 + name[0].length };
+  }
+  if (character === '"') {
+    const end = endOfString(raw, at);
+    const quoted = raw.slice(at, end);
+    const literal = quoted.startsWith('"""') ? quoted.slice(3, -3).trim() : unquote(quoted, directive);
+    return { value: { literal }, next: end };
+  }
+  if (character === "[" || character === "{") {
+    throw new FirsthandDirectiveError(
+      `@${directive}: a tag variable must be a scalar, not a list or object`
+    );
+  }
+  const word = /^[^\s,)]+/.exec(raw.slice(at));
+  if (word === null) {
+    throw new FirsthandDirectiveError(`@${directive}: expected a value`);
+  }
+  const text = word[0];
+  const next = at + text.length;
+  if (text === "true" || text === "false") {
+    return { value: { literal: text === "true" }, next };
+  }
+  if (text === "null") {
+    return { value: { literal: null }, next };
+  }
+  const asNumber = Number(text);
+  return { value: { literal: Number.isNaN(asNumber) ? text : asNumber }, next };
+}
+function scan(source) {
+  const tags = [];
+  const invalidates = [];
+  let stripped = "";
+  let at = 0;
+  let kept = 0;
+  while (at < source.length) {
+    const character = source[at];
+    if (character === '"') {
+      at = endOfString(source, at);
+      continue;
+    }
+    if (character === "#") {
+      const newline = source.indexOf("\n", at);
+      at = newline === -1 ? source.length : newline;
+      continue;
+    }
+    if (character !== "@") {
+      at++;
+      continue;
+    }
+    const directive = DIRECTIVE.exec(source.slice(at));
+    if (directive === null) {
+      at++;
+      continue;
+    }
+    let end = at + directive[0].length;
+    let args = "";
+    let probe = end;
+    while (probe < source.length && /\s/.test(source[probe])) {
+      probe++;
+    }
+    if (source[probe] === "(") {
+      const close = endOfArguments(source, probe);
+      args = source.slice(probe + 1, close - 1);
+      end = close;
+    }
+    const vars = parseArguments(args, directive[1]);
+    const named = vars["name"];
+    if (named === void 0 || !("literal" in named) || typeof named.literal !== "string") {
+      throw new FirsthandDirectiveError(
+        `@${directive[1]} needs a literal name, as in @${directive[1]}(name: "user", id: $id)`
+      );
+    }
+    delete vars["name"];
+    (directive[1] === "tag" ? tags : invalidates).push({ name: named.literal, vars });
+    let from = at;
+    while (from > kept && /\s/.test(source[from - 1])) {
+      from--;
+    }
+    stripped += source.slice(kept, from);
+    kept = end;
+    at = end;
+  }
+  return { tags, invalidates, stripped: stripped + source.slice(kept) };
+}
+function parseGraphQL(source) {
+  const { tags, invalidates, stripped } = scan(source);
+  const operation = OPERATION.exec(stripped.replace(/#[^\n]*/g, ""));
+  return {
+    source: stripped,
+    operation: operation?.[2] ?? "",
+    kind: operation?.[1] ?? "query",
+    tags,
+    invalidates
+  };
+}
+
+// packages/data/src/vite.ts
+var IMPORT = /^#\s*import\s+(['"])(.+?)\1/gm;
+var DOCUMENT = /\.(graphql|gql)(\?.*)?$/;
+function inlineImports(source, file, seen = /* @__PURE__ */ new Set([file]), read = (path) => readFileSync(path, "utf8")) {
+  const imported = [];
+  const body = source.replace(IMPORT, (_whole, _quote, specifier) => {
+    const path = resolve(dirname(file), specifier);
+    if (!seen.has(path)) {
+      seen.add(path);
+      imported.push(inlineImports(read(path), path, seen, read));
+    }
+    return "";
+  });
+  return imported.length === 0 ? body : `${imported.join("\n")}
+${body}`;
+}
+function graphql() {
+  return {
+    name: "firsthand-graphql",
+    enforce: "pre",
+    transform(code, id) {
+      const file = id.split("?")[0];
+      if (!DOCUMENT.test(id)) {
+        return null;
+      }
+      const document = parseGraphQL(inlineImports(code, file));
+      return {
+        code: `export default ${JSON.stringify(document)};`,
+        map: null
+      };
+    }
+  };
+}
+export {
+  graphql,
+  inlineImports
+};

package/dist/vite.js

@@ -0,0 +1,223 @@
+// packages/data/src/vite.ts
+import { readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+
+// packages/data/src/document.ts
+var DIRECTIVE = /^@(tag|invalidates)\b/;
+var OPERATION = /\b(query|mutation|subscription)\b[^\S\n]*([A-Za-z_]\w*)?/;
+var NAME = /^[_A-Za-z][_0-9A-Za-z]*/;
+var FirsthandDirectiveError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "FirsthandDirectiveError";
+  }
+};
+function endOfString(source, start) {
+  if (source.startsWith('"""', start)) {
+    const close = source.indexOf('"""', start + 3);
+    return close === -1 ? source.length : close + 3;
+  }
+  let at = start + 1;
+  while (at < source.length && source[at] !== '"') {
+    at += source[at] === "\\" ? 2 : 1;
+  }
+  return at + 1;
+}
+function endOfArguments(source, start) {
+  let depth = 0;
+  let at = start;
+  while (at < source.length) {
+    const character = source[at];
+    if (character === '"') {
+      at = endOfString(source, at);
+      continue;
+    }
+    if (character === "(" || character === "[" || character === "{") {
+      depth++;
+    } else if (character === ")" || character === "]" || character === "}") {
+      depth--;
+      if (depth === 0) {
+        return at + 1;
+      }
+    }
+    at++;
+  }
+  throw new FirsthandDirectiveError(`unclosed arguments in ${source.slice(start, start + 40)}`);
+}
+function unquote(quoted, directive) {
+  try {
+    return JSON.parse(quoted);
+  } catch {
+    throw new FirsthandDirectiveError(`@${directive}: ${quoted} is not a valid string`);
+  }
+}
+function parseArguments(raw, directive) {
+  const vars = {};
+  let at = 0;
+  const skipIgnored = () => {
+    while (at < raw.length && /[\s,]/.test(raw[at])) {
+      at++;
+    }
+  };
+  skipIgnored();
+  while (at < raw.length) {
+    const name = NAME.exec(raw.slice(at));
+    if (name === null) {
+      throw new FirsthandDirectiveError(
+        `@${directive}: expected an argument name at "${raw.slice(at)}"`
+      );
+    }
+    at += name[0].length;
+    skipIgnored();
+    if (raw[at] !== ":") {
+      throw new FirsthandDirectiveError(`@${directive}: argument ${name[0]} has no value`);
+    }
+    at++;
+    skipIgnored();
+    const read = readValue(raw, directive, at);
+    vars[name[0]] = read.value;
+    at = read.next;
+    skipIgnored();
+  }
+  return vars;
+}
+function readValue(raw, directive, at) {
+  const character = raw[at];
+  if (character === "$") {
+    const name = NAME.exec(raw.slice(at + 1));
+    if (name === null) {
+      throw new FirsthandDirectiveError(`@${directive}: expected a variable name after $`);
+    }
+    return { value: { variable: name[0] }, next: at + 1 + name[0].length };
+  }
+  if (character === '"') {
+    const end = endOfString(raw, at);
+    const quoted = raw.slice(at, end);
+    const literal = quoted.startsWith('"""') ? quoted.slice(3, -3).trim() : unquote(quoted, directive);
+    return { value: { literal }, next: end };
+  }
+  if (character === "[" || character === "{") {
+    throw new FirsthandDirectiveError(
+      `@${directive}: a tag variable must be a scalar, not a list or object`
+    );
+  }
+  const word = /^[^\s,)]+/.exec(raw.slice(at));
+  if (word === null) {
+    throw new FirsthandDirectiveError(`@${directive}: expected a value`);
+  }
+  const text = word[0];
+  const next = at + text.length;
+  if (text === "true" || text === "false") {
+    return { value: { literal: text === "true" }, next };
+  }
+  if (text === "null") {
+    return { value: { literal: null }, next };
+  }
+  const asNumber = Number(text);
+  return { value: { literal: Number.isNaN(asNumber) ? text : asNumber }, next };
+}
+function scan(source) {
+  const tags = [];
+  const invalidates = [];
+  let stripped = "";
+  let at = 0;
+  let kept = 0;
+  while (at < source.length) {
+    const character = source[at];
+    if (character === '"') {
+      at = endOfString(source, at);
+      continue;
+    }
+    if (character === "#") {
+      const newline = source.indexOf("\n", at);
+      at = newline === -1 ? source.length : newline;
+      continue;
+    }
+    if (character !== "@") {
+      at++;
+      continue;
+    }
+    const directive = DIRECTIVE.exec(source.slice(at));
+    if (directive === null) {
+      at++;
+      continue;
+    }
+    let end = at + directive[0].length;
+    let args = "";
+    let probe = end;
+    while (probe < source.length && /\s/.test(source[probe])) {
+      probe++;
+    }
+    if (source[probe] === "(") {
+      const close = endOfArguments(source, probe);
+      args = source.slice(probe + 1, close - 1);
+      end = close;
+    }
+    const vars = parseArguments(args, directive[1]);
+    const named = vars["name"];
+    if (named === void 0 || !("literal" in named) || typeof named.literal !== "string") {
+      throw new FirsthandDirectiveError(
+        `@${directive[1]} needs a literal name, as in @${directive[1]}(name: "user", id: $id)`
+      );
+    }
+    delete vars["name"];
+    (directive[1] === "tag" ? tags : invalidates).push({ name: named.literal, vars });
+    let from = at;
+    while (from > kept && /\s/.test(source[from - 1])) {
+      from--;
+    }
+    stripped += source.slice(kept, from);
+    kept = end;
+    at = end;
+  }
+  return { tags, invalidates, stripped: stripped + source.slice(kept) };
+}
+function parseGraphQL(source) {
+  const { tags, invalidates, stripped } = scan(source);
+  const operation = OPERATION.exec(stripped.replace(/#[^\n]*/g, ""));
+  return {
+    source: stripped,
+    operation: operation?.[2] ?? "",
+    kind: operation?.[1] ?? "query",
+    tags,
+    invalidates
+  };
+}
+
+// packages/data/src/vite.ts
+var IMPORT = /^#\s*import\s+(['"])(.+?)\1/gm;
+var DOCUMENT = /\.(graphql|gql)(\?.*)?$/;
+function inlineImports(source, file, seen = /* @__PURE__ */ new Set([file]), read = (path) => readFileSync(path, "utf8")) {
+  const imported = [];
+  const body = source.replace(IMPORT, (_whole, _quote, specifier) => {
+    const path = resolve(dirname(file), specifier);
+    if (!seen.has(path)) {
+      seen.add(path);
+      imported.push(inlineImports(read(path), path, seen, read));
+    }
+    return "";
+  });
+  return imported.length === 0 ? body : `${imported.join("\n")}
+${body}`;
+}
+function graphql() {
+  return {
+    name: "firsthand-graphql",
+    enforce: "pre",
+    transform(code, id) {
+      const file = id.split("?")[0];
+      if (!DOCUMENT.test(id)) {
+        return null;
+      }
+      const document = parseGraphQL(inlineImports(code, file));
+      return {
+        code: `export default ${JSON.stringify(document)};`,
+        map: null
+      };
+    }
+  };
+}
+export {
+  graphql,
+  inlineImports
+};