graphql-data-generator 0.4.5 → 0.4.6-alpha.1

package/README.md

@@ -13,6 +13,7 @@ tests.
 - [Transforms](#transforms)
 - [Testing](#testing)
 - [Extra properties](#extra)
+- [Browser usage](#browser-usage)
 
 ### Key Concepts
 
@@ -341,3 +342,56 @@ const build = init<
 
 build.CreatePost({ internal: true }).internal; // true
 ```
+
+## Browser usage
+
+`graphql-data-generator` can be used in browser environments by providing a
+custom `loadDocument` option to `init`. The default file-system-based loader is
+skipped automatically when Node.js or Deno APIs are not detected.
+
+Since browsers don't have file system access, you provide operation documents
+directly — either as strings or pre-parsed `DocumentNode` objects:
+
+```ts
+import { init } from "graphql-data-generator";
+
+const schema = `
+  type Query {
+    getUser(id: ID): User
+  }
+  type User {
+    id: ID!
+    name: String!
+  }
+`;
+
+const operations = {
+  GetUser: `
+    query GetUser($id: ID) {
+      getUser(id: $id) {
+        id
+        name
+      }
+    }
+  `,
+};
+
+const build = init(
+  schema,
+  { GetUser: "GetUser" },
+  {},
+  {},
+  { User: ["id", "name"] },
+  [],
+  { ID: (t) => `${t}-id`, String: (t) => `${t}-string` },
+  { loadDocument: (key) => operations[key] },
+)(() => ({}));
+
+build.User(); // { __typename: "User", id: "User-id", name: "User-string" }
+build.GetUser(); // { request: { query: ..., variables: ... }, result: { data: { getUser: ... } } }
+```
+
+The `loadDocument` function receives the path string from the generated types
+file and should return either a GraphQL string or a `DocumentNode`. This allows
+you to load operations from any source — bundled strings, a network request, or
+an in-memory map.

package/esm/browser.js

@@ -0,0 +1,3 @@
+export { init } from "./init.js";
+export { clear, operation, proxy } from "./proxy.js";
+export { toObject } from "./util.js";

package/esm/codegen.js

@@ -244,7 +244,8 @@ const serializeType = (type, variables = false, depth = 0) => {
         case "List":
             if (type.value.optional ||
                 (type.value.kind === "Object" &&
-                    ((type.value.conditionals?.length ?? 0) -
+                    ((type.value.conditionals?.length ?? 0) +
+                        (type.value.nonExhaustive?.length ? 1 : 0) -
                         (Object.keys(type.value.value).length ? 0 : 1)))) {
                 return `(${serializeType(type.value, variables, depth)})[]${type.optional ? " | null" : ""}`;
             }

package/esm/defaultLoader.js

@@ -0,0 +1,92 @@
+/**
+ * Default document loader for Node.js and Deno environments.
+ * In browser environments, this module loads successfully but the exported
+ * function throws a helpful error if called without Node/Deno APIs available.
+ */
+import * as dntShim from "./_dnt.shims.js";
+import { createRequire } from "node:module";
+import { readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import nodeProcess from "node:process";
+import { Kind, parse } from "graphql";
+import { gqlPluckFromCodeStringSync } from "@graphql-tools/graphql-tag-pluck";
+/** Check if input is already a DocumentNode. */
+const isDocumentNode = (input) => typeof input === "object" && input !== null && "kind" in input &&
+    input.kind === Kind.DOCUMENT;
+// deno-lint-ignore no-explicit-any
+const isDeno = typeof dntShim.dntGlobalThis.Deno?.version?.deno === "string";
+const isNode = typeof globalThis.process?.versions?.node === "string";
+let _impl;
+if (isDeno || isNode) {
+    // deno-lint-ignore no-explicit-any
+    const cwd = dntShim.dntGlobalThis.Deno?.cwd?.() ?? nodeProcess.cwd();
+    globalThis.require ??= createRequire(cwd);
+    const files = {};
+    const loadFile = (path) => {
+        if (files[path])
+            return files[path];
+        const raw = readFileSync(path, "utf-8");
+        const imports = Array.from(raw.matchAll(/#import "(.*)"/gm), ([, importPath]) => loadFile(require.resolve(importPath.startsWith(".")
+            ? resolve(cwd, dirname(path), importPath)
+            : importPath, { paths: [cwd] })));
+        if (!imports.length)
+            return files[path] = raw;
+        return files[path] = [raw, ...imports].join("\n\n");
+    };
+    const cache = {};
+    _impl = (path) => {
+        const existing = cache[path];
+        if (existing) {
+            if (isDocumentNode(existing))
+                return existing;
+            return loadFile(path);
+        }
+        try {
+            const doc = require(require.resolve(path, { paths: [cwd] }));
+            if (isDocumentNode(doc)) {
+                cache[path] = doc;
+                return doc;
+            }
+        }
+        catch {
+            // Otherwise load it manually
+        }
+        const fileContent = loadFile(path);
+        try {
+            const sources = gqlPluckFromCodeStringSync(path, fileContent);
+            cache[path] = Object.fromEntries(sources.map((s) => {
+                const document = parse(s);
+                const firstOp = document.definitions.find((d) => d.kind === Kind.OPERATION_DEFINITION);
+                if (!firstOp) {
+                    throw new Error(`Could not find an operation in ${path}`);
+                }
+                return [firstOp.name?.value, document];
+            }));
+        }
+        catch {
+            cache[path] = parse(fileContent);
+        }
+        return loadFile(path);
+    };
+}
+/**
+ * Default document loader for Node.js and Deno environments.
+ * Loads GraphQL documents from the filesystem with support for:
+ * - Direct .gql/.graphql files
+ * - #import directives
+ * - GraphQL tag plucking from JS/TS files
+ * - require() with GraphQL loaders
+ *
+ * In browser environments, throws an error directing users to pass
+ * a custom `loadDocument` option to `init`.
+ *
+ * @param path - Path to the GraphQL operation file
+ * @returns The document content as a string or pre-parsed DocumentNode
+ */
+export const defaultLoader = (path) => {
+    if (!_impl) {
+        throw new Error("defaultLoader requires Node.js or Deno file system APIs. " +
+            "In browser environments, pass a custom `loadDocument` option to `init`.");
+    }
+    return _impl(path);
+};

package/esm/index.js

@@ -1,4 +1,9 @@
-export { init } from "./init.js";
+import { init as _init } from "./init.js";
+import { defaultLoader } from "./defaultLoader.js";
+export const init = (schema, queries, mutations, subscriptions, types, inputs, scalars, options) => _init(schema, queries, mutations, subscriptions, types, inputs, scalars, {
+    loadDocument: defaultLoader,
+    ...options,
+});
 export { codegen } from "./codegen.js";
 export { clear, operation, proxy } from "./proxy.js";
 export { toObject } from "./util.js";

package/esm/init.js

@@ -1,88 +1,44 @@
-import * as dntShim from "./_dnt.shims.js";
-import { createRequire } from "node:module";
-import { readFileSync } from "node:fs";
 import { Kind, parse, } from "graphql";
-import { gqlPluckFromCodeStringSync } from "@graphql-tools/graphql-tag-pluck";
 import { _proxy, operation, withGetDefaultPatch, } from "./proxy.js";
-import { toObject } from "./util.js";
-import { dirname, resolve } from "node:path";
-globalThis.require ??= createRequire(dntShim.Deno.cwd());
-const files = {};
-const loadFile = (path) => {
-    if (files[path])
-        return files[path];
-    const raw = readFileSync(path, "utf-8");
-    const imports = Array.from(raw.matchAll(/#import "(.*)"/gm), ([, importPath]) => loadFile(require.resolve(importPath.startsWith(".")
-        ? resolve(dntShim.Deno.cwd(), dirname(path), importPath)
-        : importPath, { paths: [dntShim.Deno.cwd()] })));
-    if (!imports.length)
-        return files[path] = raw;
-    return files[path] = [raw, ...imports].join("\n\n");
-};
-const getOperationContentMap = {};
-const getOperationContent = (path, operationName) => {
-    const existing = getOperationContentMap[path];
-    if (existing) {
-        if (existing.kind === Kind.DOCUMENT)
-            return existing;
-        return getOperationContentMap[path][operationName];
-    }
-    try {
-        // First try loading via require, depending on GQL loaders
-        const doc = require(require.resolve(path, { paths: [dntShim.Deno.cwd()] }));
-        if (doc && typeof doc === "object" && "kind" in doc && doc.kind === "Document") {
-            getOperationContentMap[path] = doc;
-        }
-    }
-    catch {
-        // Otherwise load it manually
-        const fileContent = loadFile(path);
-        try {
-            const sources = gqlPluckFromCodeStringSync(path, fileContent);
-            getOperationContentMap[path] = Object.fromEntries(sources.map((s) => {
-                const document = parse(s);
-                const firstOp = document.definitions.find((d) => d.kind === Kind.OPERATION_DEFINITION);
-                if (!firstOp)
-                    throw new Error(`Could not find an operation in ${path}`);
-                return [firstOp.name?.value, document];
-            }));
-        }
-        catch {
-            getOperationContentMap[path] = parse(fileContent);
-        }
-    }
-    return getOperationContent(path, operationName);
-};
+import { raise, toObject } from "./util.js";
+/** Converts a string or DocumentNode to a DocumentNode. */
+const ensureDocument = (input) => typeof input === "string" ? parse(input) : input;
 // Helper: Unwraps non-null and list wrappers to get the named type.
 const getNamedType = (type) => type.kind === Kind.NAMED_TYPE ? type.name.value : getNamedType(type.type);
 // Helper: Find a type definition in the document by name.
 const getTypeDef = (definitions, typeName) => definitions.find((def) => "name" in def && def.name?.value === typeName);
 /**
  * Initialize the data builder.
- * @param schema The plain text of your schema.
+ * @param schema The schema as a string or pre-parsed DocumentNode.
  * @param queries List of queries exported from generated types.
  * @param mutations List of mutations exported from generated types.
  * @param subscriptions List of subscriptions exported from generated types.
  * @param types List of types exported from generated types.
  * @param inputs List of types exported from generated types.
  * @param scalars A mapping to generate scalar values. Function values will be invoked with their `__typename`.
+ * @param options.loadDocument Function to load operation documents. Defaults to the Node/Deno file loader.
+ * @param options.finalizeOperation Optional function to finalize operation mocks.
  */
 export const init = (schema, queries, mutations, subscriptions, types, inputs, scalars, options) => (fn) => {
-    const doc = parse(schema);
+    const doc = ensureDocument(schema);
+    // Memoize document loading so each path is only loaded once
+    const documentCache = new Map();
+    const loadDocument = (path) => {
+        const cached = documentCache.get(path);
+        if (cached)
+            return cached;
+        const result = (options?.loadDocument ?? (() => raise("No loadDocument option provided. " +
+            "Use the default import from 'graphql-data-generator' for Node/Deno, " +
+            "or pass a custom loadDocument option for browser environments.")))(path);
+        const document = ensureDocument(result);
+        documentCache.set(path, document);
+        return document;
+    };
     // Collect all fragment definitions from operation files, deduplicating by name
     const fragmentDefinitionsMap = new Map();
-    const collectFragments = (filePath, operationName) => {
+    const collectFragments = (filePath) => {
         try {
-            // If we have an operation name, use it; otherwise try to parse the file directly
-            let document;
-            if (operationName) {
-                document = getOperationContent(filePath, operationName);
-            }
-            else {
-                // Parse the file directly to get all definitions including fragments
-                const fileContent = loadFile(filePath);
-                document = parse(fileContent);
-            }
+            const document = loadDocument(filePath);
             for (const def of document.definitions) {
                 if (def.kind === Kind.FRAGMENT_DEFINITION) {
                     // Only add if not already seen (dedup by fragment name)
@@ -305,7 +261,7 @@ export const init = (schema, queries, mutations, subscriptions, types, inputs, s
     };
     const operationBuilder = (name, path) => {
         const builder = (...patches) => {
-            const query = getOperationContent(path, name);
+            const query = loadDocument(path);
             if (transforms[name] && "default" in transforms[name]) {
                 patches = [transforms[name].default, ...patches];
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "graphql-data-generator",
-  "version": "0.4.5",
+  "version": "0.4.6-alpha.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/voces/graphql-data-generator.git"
@@ -19,6 +19,12 @@
       "types": "./types/index.d.ts",
       "default": "./esm/index.js"
     },
+    "./browser": {
+      "import": "./esm/browser.js",
+      "require": "./script/browser.js",
+      "types": "./types/browser.d.ts",
+      "default": "./esm/browser.js"
+    },
     "./plugin": {
       "import": "./esm/plugin.cjs",
       "require": "./script/plugin.cjs",

package/script/browser.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toObject = exports.proxy = exports.operation = exports.clear = exports.init = void 0;
+var init_js_1 = require("./init.js");
+Object.defineProperty(exports, "init", { enumerable: true, get: function () { return init_js_1.init; } });
+var proxy_js_1 = require("./proxy.js");
+Object.defineProperty(exports, "clear", { enumerable: true, get: function () { return proxy_js_1.clear; } });
+Object.defineProperty(exports, "operation", { enumerable: true, get: function () { return proxy_js_1.operation; } });
+Object.defineProperty(exports, "proxy", { enumerable: true, get: function () { return proxy_js_1.proxy; } });
+var util_js_1 = require("./util.js");
+Object.defineProperty(exports, "toObject", { enumerable: true, get: function () { return util_js_1.toObject; } });

package/script/codegen.js

@@ -250,7 +250,8 @@ const serializeType = (type, variables = false, depth = 0) => {
         case "List":
             if (type.value.optional ||
                 (type.value.kind === "Object" &&
-                    ((type.value.conditionals?.length ?? 0) -
+                    ((type.value.conditionals?.length ?? 0) +
+                        (type.value.nonExhaustive?.length ? 1 : 0) -
                         (Object.keys(type.value.value).length ? 0 : 1)))) {
                 return `(${serializeType(type.value, variables, depth)})[]${type.optional ? " | null" : ""}`;
             }

package/script/defaultLoader.js

@@ -0,0 +1,122 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultLoader = void 0;
+/**
+ * Default document loader for Node.js and Deno environments.
+ * In browser environments, this module loads successfully but the exported
+ * function throws a helpful error if called without Node/Deno APIs available.
+ */
+const dntShim = __importStar(require("./_dnt.shims.js"));
+const node_module_1 = require("node:module");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_process_1 = __importDefault(require("node:process"));
+const graphql_1 = require("graphql");
+const graphql_tag_pluck_1 = require("@graphql-tools/graphql-tag-pluck");
+/** Check if input is already a DocumentNode. */
+const isDocumentNode = (input) => typeof input === "object" && input !== null && "kind" in input &&
+    input.kind === graphql_1.Kind.DOCUMENT;
+// deno-lint-ignore no-explicit-any
+const isDeno = typeof dntShim.dntGlobalThis.Deno?.version?.deno === "string";
+const isNode = typeof globalThis.process?.versions?.node === "string";
+let _impl;
+if (isDeno || isNode) {
+    // deno-lint-ignore no-explicit-any
+    const cwd = dntShim.dntGlobalThis.Deno?.cwd?.() ?? node_process_1.default.cwd();
+    globalThis.require ??= (0, node_module_1.createRequire)(cwd);
+    const files = {};
+    const loadFile = (path) => {
+        if (files[path])
+            return files[path];
+        const raw = (0, node_fs_1.readFileSync)(path, "utf-8");
+        const imports = Array.from(raw.matchAll(/#import "(.*)"/gm), ([, importPath]) => loadFile(require.resolve(importPath.startsWith(".")
+            ? (0, node_path_1.resolve)(cwd, (0, node_path_1.dirname)(path), importPath)
+            : importPath, { paths: [cwd] })));
+        if (!imports.length)
+            return files[path] = raw;
+        return files[path] = [raw, ...imports].join("\n\n");
+    };
+    const cache = {};
+    _impl = (path) => {
+        const existing = cache[path];
+        if (existing) {
+            if (isDocumentNode(existing))
+                return existing;
+            return loadFile(path);
+        }
+        try {
+            const doc = require(require.resolve(path, { paths: [cwd] }));
+            if (isDocumentNode(doc)) {
+                cache[path] = doc;
+                return doc;
+            }
+        }
+        catch {
+            // Otherwise load it manually
+        }
+        const fileContent = loadFile(path);
+        try {
+            const sources = (0, graphql_tag_pluck_1.gqlPluckFromCodeStringSync)(path, fileContent);
+            cache[path] = Object.fromEntries(sources.map((s) => {
+                const document = (0, graphql_1.parse)(s);
+                const firstOp = document.definitions.find((d) => d.kind === graphql_1.Kind.OPERATION_DEFINITION);
+                if (!firstOp) {
+                    throw new Error(`Could not find an operation in ${path}`);
+                }
+                return [firstOp.name?.value, document];
+            }));
+        }
+        catch {
+            cache[path] = (0, graphql_1.parse)(fileContent);
+        }
+        return loadFile(path);
+    };
+}
+/**
+ * Default document loader for Node.js and Deno environments.
+ * Loads GraphQL documents from the filesystem with support for:
+ * - Direct .gql/.graphql files
+ * - #import directives
+ * - GraphQL tag plucking from JS/TS files
+ * - require() with GraphQL loaders
+ *
+ * In browser environments, throws an error directing users to pass
+ * a custom `loadDocument` option to `init`.
+ *
+ * @param path - Path to the GraphQL operation file
+ * @returns The document content as a string or pre-parsed DocumentNode
+ */
+const defaultLoader = (path) => {
+    if (!_impl) {
+        throw new Error("defaultLoader requires Node.js or Deno file system APIs. " +
+            "In browser environments, pass a custom `loadDocument` option to `init`.");
+    }
+    return _impl(path);
+};
+exports.defaultLoader = defaultLoader;

package/script/index.js

@@ -1,8 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toObject = exports.proxy = exports.operation = exports.clear = exports.codegen = exports.init = void 0;
-var init_js_1 = require("./init.js");
-Object.defineProperty(exports, "init", { enumerable: true, get: function () { return init_js_1.init; } });
+const init_js_1 = require("./init.js");
+const defaultLoader_js_1 = require("./defaultLoader.js");
+const init = (schema, queries, mutations, subscriptions, types, inputs, scalars, options) => (0, init_js_1.init)(schema, queries, mutations, subscriptions, types, inputs, scalars, {
+    loadDocument: defaultLoader_js_1.defaultLoader,
+    ...options,
+});
+exports.init = init;
 var codegen_js_1 = require("./codegen.js");
 Object.defineProperty(exports, "codegen", { enumerable: true, get: function () { return codegen_js_1.codegen; } });
 var proxy_js_1 = require("./proxy.js");

package/script/init.js

@@ -1,114 +1,47 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.init = void 0;
-const dntShim = __importStar(require("./_dnt.shims.js"));
-const node_module_1 = require("node:module");
-const node_fs_1 = require("node:fs");
 const graphql_1 = require("graphql");
-const graphql_tag_pluck_1 = require("@graphql-tools/graphql-tag-pluck");
 const proxy_js_1 = require("./proxy.js");
 const util_js_1 = require("./util.js");
-const node_path_1 = require("node:path");
-globalThis.require ??= (0, node_module_1.createRequire)(dntShim.Deno.cwd());
-const files = {};
-const loadFile = (path) => {
-    if (files[path])
-        return files[path];
-    const raw = (0, node_fs_1.readFileSync)(path, "utf-8");
-    const imports = Array.from(raw.matchAll(/#import "(.*)"/gm), ([, importPath]) => loadFile(require.resolve(importPath.startsWith(".")
-        ? (0, node_path_1.resolve)(dntShim.Deno.cwd(), (0, node_path_1.dirname)(path), importPath)
-        : importPath, { paths: [dntShim.Deno.cwd()] })));
-    if (!imports.length)
-        return files[path] = raw;
-    return files[path] = [raw, ...imports].join("\n\n");
-};
-const getOperationContentMap = {};
-const getOperationContent = (path, operationName) => {
-    const existing = getOperationContentMap[path];
-    if (existing) {
-        if (existing.kind === graphql_1.Kind.DOCUMENT)
-            return existing;
-        return getOperationContentMap[path][operationName];
-    }
-    try {
-        // First try loading via require, depending on GQL loaders
-        const doc = require(require.resolve(path, { paths: [dntShim.Deno.cwd()] }));
-        if (doc && typeof doc === "object" && "kind" in doc && doc.kind === "Document") {
-            getOperationContentMap[path] = doc;
-        }
-    }
-    catch {
-        // Otherwise load it manually
-        const fileContent = loadFile(path);
-        try {
-            const sources = (0, graphql_tag_pluck_1.gqlPluckFromCodeStringSync)(path, fileContent);
-            getOperationContentMap[path] = Object.fromEntries(sources.map((s) => {
-                const document = (0, graphql_1.parse)(s);
-                const firstOp = document.definitions.find((d) => d.kind === graphql_1.Kind.OPERATION_DEFINITION);
-                if (!firstOp)
-                    throw new Error(`Could not find an operation in ${path}`);
-                return [firstOp.name?.value, document];
-            }));
-        }
-        catch {
-            getOperationContentMap[path] = (0, graphql_1.parse)(fileContent);
-        }
-    }
-    return getOperationContent(path, operationName);
-};
+/** Converts a string or DocumentNode to a DocumentNode. */
+const ensureDocument = (input) => typeof input === "string" ? (0, graphql_1.parse)(input) : input;
 // Helper: Unwraps non-null and list wrappers to get the named type.
 const getNamedType = (type) => type.kind === graphql_1.Kind.NAMED_TYPE ? type.name.value : getNamedType(type.type);
 // Helper: Find a type definition in the document by name.
 const getTypeDef = (definitions, typeName) => definitions.find((def) => "name" in def && def.name?.value === typeName);
 /**
  * Initialize the data builder.
- * @param schema The plain text of your schema.
+ * @param schema The schema as a string or pre-parsed DocumentNode.
  * @param queries List of queries exported from generated types.
  * @param mutations List of mutations exported from generated types.
  * @param subscriptions List of subscriptions exported from generated types.
  * @param types List of types exported from generated types.
  * @param inputs List of types exported from generated types.
  * @param scalars A mapping to generate scalar values. Function values will be invoked with their `__typename`.
+ * @param options.loadDocument Function to load operation documents. Defaults to the Node/Deno file loader.
+ * @param options.finalizeOperation Optional function to finalize operation mocks.
  */
 const init = (schema, queries, mutations, subscriptions, types, inputs, scalars, options) => (fn) => {
-    const doc = (0, graphql_1.parse)(schema);
+    const doc = ensureDocument(schema);
+    // Memoize document loading so each path is only loaded once
+    const documentCache = new Map();
+    const loadDocument = (path) => {
+        const cached = documentCache.get(path);
+        if (cached)
+            return cached;
+        const result = (options?.loadDocument ?? (() => (0, util_js_1.raise)("No loadDocument option provided. " +
+            "Use the default import from 'graphql-data-generator' for Node/Deno, " +
+            "or pass a custom loadDocument option for browser environments.")))(path);
+        const document = ensureDocument(result);
+        documentCache.set(path, document);
+        return document;
+    };
     // Collect all fragment definitions from operation files, deduplicating by name
     const fragmentDefinitionsMap = new Map();
-    const collectFragments = (filePath, operationName) => {
+    const collectFragments = (filePath) => {
         try {
-            // If we have an operation name, use it; otherwise try to parse the file directly
-            let document;
-            if (operationName) {
-                document = getOperationContent(filePath, operationName);
-            }
-            else {
-                // Parse the file directly to get all definitions including fragments
-                const fileContent = loadFile(filePath);
-                document = (0, graphql_1.parse)(fileContent);
-            }
+            const document = loadDocument(filePath);
             for (const def of document.definitions) {
                 if (def.kind === graphql_1.Kind.FRAGMENT_DEFINITION) {
                     // Only add if not already seen (dedup by fragment name)
@@ -331,7 +264,7 @@ const init = (schema, queries, mutations, subscriptions, types, inputs, scalars,
     };
     const operationBuilder = (name, path) => {
         const builder = (...patches) => {
-            const query = getOperationContent(path, name);
+            const query = loadDocument(path);
             if (transforms[name] && "default" in transforms[name]) {
                 patches = [transforms[name].default, ...patches];
             }

package/types/browser.d.ts

@@ -0,0 +1,4 @@
+export { init } from "./init.js";
+export type { DeepPartial, OperationMock, Patch } from "./types.js";
+export { clear, operation, proxy } from "./proxy.js";
+export { toObject } from "./util.js";

package/types/defaultLoader.d.ts

@@ -0,0 +1,16 @@
+import type { DocumentInput } from "./init.js";
+/**
+ * Default document loader for Node.js and Deno environments.
+ * Loads GraphQL documents from the filesystem with support for:
+ * - Direct .gql/.graphql files
+ * - #import directives
+ * - GraphQL tag plucking from JS/TS files
+ * - require() with GraphQL loaders
+ *
+ * In browser environments, throws an error directing users to pass
+ * a custom `loadDocument` option to `init`.
+ *
+ * @param path - Path to the GraphQL operation file
+ * @returns The document content as a string or pre-parsed DocumentNode
+ */
+export declare const defaultLoader: (path: string) => DocumentInput;

package/types/extendedTypes.d.ts

@@ -25,13 +25,6 @@ type PrefixKeys<T, Prefix extends string> = {
 type MapObjectsToBuilders<T, Transforms> = {
     [K in keyof T]: ObjectBuilder<T[K], K extends keyof Transforms ? Transforms[K] : ContravariantEmpty>;
 };
-export type MapObjectsToTransforms<Objects extends Record<string, Record<string, unknown>>> = {
-    [Object in keyof Objects]?: Record<string, DefaultObjectTransform<Objects[Object], Objects[Object]> | ((prev: Objects[Object], ...args: any[]) => Patch<Objects[Object]>)>;
-};
-type InnerMapOperationsToTransforms<Operations> = {
-    [Operation in keyof Operations]?: Record<string, InferOperationTransforms<Operations[Operation]>>;
-};
-export type MapOperationsToTransforms<Queries, Mutations, Subscriptions, Types, Inputs> = InnerMapOperationsToTransforms<ResolveConflicts<Queries, Mutations, Subscriptions, Types, Inputs>>;
 type MapOperationsToBuilders<T, Transforms, Extra> = {
     [K in keyof T]: OperationBuilder<T[K] extends {
         data: infer U;
@@ -49,14 +42,31 @@ type DefaultOperationTransform<T> = {
         variables: infer V;
     } ? Patch<V> : never;
 };
-type OperationTransform<T> = (b: {
-    data: T extends {
+type AllKeysOf<T> = T extends any ? keyof T : never;
+type ValueOf<T, K extends PropertyKey> = T extends any ? K extends keyof T ? T[K] : never : never;
+type ExcessCheck<R, T> = Record<Exclude<keyof R, AllKeysOf<T>>, never> & {
+    [K in keyof R & AllKeysOf<T>]: R[K] extends (...args: any[]) => any ? unknown : NonNullable<ValueOf<T, K>> extends any[] ? unknown : NonNullable<R[K]> extends object ? NonNullable<ValueOf<T, K>> extends object ? ExcessCheck<NonNullable<R[K]>, NonNullable<ValueOf<T, K>>> : unknown : unknown;
+};
+type ObjectTransformValue<Value, Obj> = Value extends (...args: any[]) => infer R ? (prev: Obj, ...args: any[]) => Patch<Obj extends Record<string, unknown> ? Obj : never> & ExcessCheck<R, Obj> : DefaultObjectTransform<Obj extends Record<string, unknown> ? Obj : never, Obj extends Record<string, unknown> ? Obj : never> & Record<Exclude<keyof Value, AllKeysOf<Obj>>, never>;
+type OperationTransformValue<Value, Op> = Value extends (...args: any[]) => infer R ? (b: {
+    data: Op extends {
         data: infer U;
     } ? U : never;
-    variables: T extends {
+    variables: Op extends {
         variables: infer U;
     } ? U : never;
-}, ...args: any[]) => Patch<T>;
-type InferOperationTransforms<T> = DefaultOperationTransform<T> | OperationTransform<T>;
+}, ...args: any[]) => Patch<Op> & ExcessCheck<R, Op> : DefaultOperationTransform<Op> & Record<Exclude<keyof Value, "data" | "variables">, never>;
+/**
+ * Self-referential constraint that ensures:
+ * 1. Top-level keys are known type/input/operation names (unknown → never)
+ * 2. Transform values don't have excess properties
+ */
+export type Transforms<T, Objects extends Record<string, Record<string, unknown>>, Queries, Mutations, Subscriptions, Types extends Record<string, Record<string, unknown>>, Inputs extends Record<string, Record<string, unknown>>> = {
+    [K in keyof T]: K extends keyof Objects ? {
+        [TK in keyof T[K]]: ObjectTransformValue<T[K][TK], Objects[K]>;
+    } : K extends keyof ResolveConflicts<Queries, Mutations, Subscriptions, Types, Inputs> ? {
+        [TK in keyof T[K]]: OperationTransformValue<T[K][TK], ResolveConflicts<Queries, Mutations, Subscriptions, Types, Inputs>[K]>;
+    } : never;
+};
 export type Build<Queries, Mutations, Subscriptions, Types, Inputs, Transforms, Extra> = MapObjectsToBuilders<Types & Inputs, Transforms> & MapOperationsToBuilders<ResolveConflicts<Queries, Mutations, Subscriptions, Types, Inputs>, Transforms, Extra>;
 export {};

package/types/index.d.ts

@@ -1,4 +1,5 @@
-export { init } from "./init.js";
+import { init as _init } from "./init.js";
+export declare const init: typeof _init;
 export type { DeepPartial, OperationMock, Patch } from "./types.js";
 export { codegen } from "./codegen.js";
 export { clear, operation, proxy } from "./proxy.js";

package/types/init.d.ts

@@ -1,14 +1,19 @@
-import type { Build, MapObjectsToTransforms, MapOperationsToTransforms } from "./extendedTypes.js";
+import { DocumentNode } from "graphql";
+import type { Build, Transforms } from "./extendedTypes.js";
 import type { ContravariantEmpty, OperationMock } from "./types.js";
+/** A GraphQL document can be provided as a string or a pre-parsed DocumentNode. */
+export type DocumentInput = string | DocumentNode;
 /**
  * Initialize the data builder.
- * @param schema The plain text of your schema.
+ * @param schema The schema as a string or pre-parsed DocumentNode.
  * @param queries List of queries exported from generated types.
  * @param mutations List of mutations exported from generated types.
  * @param subscriptions List of subscriptions exported from generated types.
  * @param types List of types exported from generated types.
  * @param inputs List of types exported from generated types.
  * @param scalars A mapping to generate scalar values. Function values will be invoked with their `__typename`.
+ * @param options.loadDocument Function to load operation documents. Defaults to the Node/Deno file loader.
+ * @param options.finalizeOperation Optional function to finalize operation mocks.
  */
 export declare const init: <Query extends Record<string, {
     data: Record<string, unknown>;
@@ -19,8 +24,10 @@ export declare const init: <Query extends Record<string, {
 }>, Subscription extends Record<string, {
     data: Record<string, unknown>;
     variables?: Record<string, unknown>;
-}>, Types extends Record<string, Record<string, unknown>>, Inputs extends Record<string, Record<string, unknown>>, Extra = object>(schema: string, queries: { [operation in keyof Query]: string; }, mutations: { [operation in keyof Mutation]: string; }, subscriptions: { [operation in keyof Subscription]: string; }, types: { readonly [type in keyof Types]: readonly string[]; }, inputs: readonly (keyof Inputs & string)[], scalars: {
+}>, Types extends Record<string, Record<string, unknown>>, Inputs extends Record<string, Record<string, unknown>>, Extra = object>(schema: DocumentInput, queries: { [operation in keyof Query]: string; }, mutations: { [operation in keyof Mutation]: string; }, subscriptions: { [operation in keyof Subscription]: string; }, types: { readonly [type in keyof Types]: readonly string[]; }, inputs: readonly (keyof Inputs & string)[], scalars: {
     [name: string]: ((typeName: string, fieldName: string) => unknown) | string | number | boolean | null;
 }, options?: {
+    /** Load an operation document from a path. Returns string or DocumentNode. */
+    loadDocument?: (path: string) => DocumentInput;
     finalizeOperation?: <T extends OperationMock & Partial<Extra>>(operation: T) => T;
-}) => <Transforms extends MapObjectsToTransforms<Types & Inputs> & MapOperationsToTransforms<Query, Mutation, Subscription, Types, Inputs>>(fn: (b: Build<Query, Mutation, Subscription, Types, Inputs, ContravariantEmpty, Extra>) => Transforms) => Build<Query, Mutation, Subscription, Types, Inputs, Transforms, Extra>;
+}) => <T extends Transforms<T, Types & Inputs, Query, Mutation, Subscription, Types, Inputs>>(fn: (b: Build<Query, Mutation, Subscription, Types, Inputs, ContravariantEmpty, Extra>) => T) => Build<Query, Mutation, Subscription, Types, Inputs, T, Extra>;