@gql.tada/cli-utils 1.8.2 → 1.9.0

package/dist/chunks/thread-chunk3.mjs

@@ -1,91 +1,155 @@
 import e from "typescript";
 
-import * as i from "node:path";
+import i from "node:v8";
 
-import { loadRef as a } from "@gql.tada/internal";
+import r from "node:vm";
 
-import { getGraphQLDiagnostics as r } from "@0no-co/graphqlsp/api";
+import { getSchemaNamesFromConfig as n } from "@gql.tada/internal";
 
-import { e as n } from "./index-chunk2.mjs";
+import { findAllCallExpressions as o } from "@0no-co/graphqlsp/api";
 
-import { p as o } from "./index-chunk.mjs";
+import { e as t } from "./index-chunk2.mjs";
 
-var t = n((async function* _runDiagnostics(n) {
-  var t = i.dirname(n.configPath);
-  var l = o(n);
-  var s = l.createExternalFiles();
-  if (s.length) {
+import { h as a } from "./scan-chunk.mjs";
+
+import { p as s } from "./index-chunk.mjs";
+
+var l = 262144e4;
+
+function shouldScanFile(e) {
+  if (e.endsWith(".d.ts") || e.endsWith(".d.mts") || e.endsWith(".d.cts")) {
+    return !1;
+  }
+  return !/(^|[/\\])node_modules([/\\]|$)/.test(e);
+}
+
+var c;
+
+function forceGc() {
+  if (void 0 === c) {
+    var e = globalThis.gc;
+    if ("function" == typeof e) {
+      c = e;
+    } else {
+      try {
+        i.setFlagsFromString("--expose-gc");
+        c = r.runInNewContext("gc");
+        i.setFlagsFromString("--no-expose-gc");
+      } catch {
+        c = null;
+      }
+    }
+  }
+  if (c) {
+    c();
+  }
+}
+
+var f = t((async function* _runScan(i) {
+  var r = n(i.pluginConfig);
+  var t = s(i);
+  var c = t.createExternalFiles();
+  if (c.length) {
     yield {
       kind: "EXTERNAL_WARNING"
     };
-    await l.addVirtualFiles(s);
+    await t.addVirtualFiles(c);
   }
-  var g = await a(n.pluginConfig).load({
-    rootPath: t
-  });
-  var f = {
-    current: g.current,
-    multi: g.multi,
-    version: g.version,
-    errors: {
-      config: null,
-      load: new Map,
-      write: new Map
-    },
-    outputLocations: new Map,
-    checkStale() {}
-  };
-  var c = l.build();
-  var m = c.buildPluginInfo(n.pluginConfig);
-  var d = c.getSourceFiles();
+  var f = t.build();
+  var m = f.buildPluginInfo(i.pluginConfig);
+  var u = t.rootFileNames.filter(shouldScanFile);
   yield {
     kind: "FILE_COUNT",
-    fileCount: d.length
+    fileCount: u.length
   };
-  for (var u of d) {
-    var p = u.fileName.endsWith(".vue.ts") || u.fileName.endsWith(".svelte.ts");
-    var v = u.fileName;
-    m.config = {
-      ...m.config,
-      shouldCheckForColocatedFragments: p ? !1 : m.config.shouldCheckForColocatedFragments ?? !1,
-      trackFieldUsage: p ? !1 : m.config.trackFieldUsage ?? !1
-    };
-    var h = r(v, f, m);
-    var C = [];
-    if (h && h.length) {
-      for (var y of h) {
-        if (!("messageText" in y) || "string" != typeof y.messageText || !y.file) {
-          continue;
-        }
-        var F = "info";
-        if (y.category === e.DiagnosticCategory.Error) {
-          F = "error";
-        } else if (y.category === e.DiagnosticCategory.Warning) {
-          F = "warn";
+  var processSourceFile = (i, n, s) => {
+    var l = i.fileName;
+    var c = [];
+    var f = [];
+    var m = function collectModuleImports(i, r) {
+      var n = [];
+      for (var o of i.statements) {
+        if (e.isImportDeclaration(o) && e.isStringLiteral(o.moduleSpecifier)) {
+          var t = r(o.moduleSpecifier.text, i.fileName);
+          if (t && shouldScanFile(t)) {
+            n.push(t);
+          }
         }
-        var k = c.getSourcePosition(u, {
-          start: y.start || 1,
-          length: y.length || 1
-        });
-        v = k.fileName;
-        C.push({
-          severity: F,
-          message: y.messageText,
-          file: k.fileName,
-          line: k.line,
-          col: k.col,
-          endLine: k.endLine,
-          endColumn: k.endColumn
+      }
+      return n;
+    }(i, t.resolveModulePath.bind(t));
+    if (!a(i)) {
+      return {
+        filePath: l,
+        documents: c,
+        imports: m,
+        warnings: f
+      };
+    }
+    var u = o(i, s, {
+      searchExternal: !1,
+      collectFragments: !1
+    }).nodes;
+    for (var d of u) {
+      var h = d.node.parent;
+      if (!e.isCallExpression(h)) {
+        continue;
+      }
+      var p = n.getSourcePosition(i, h.getStart());
+      l = p.fileName;
+      if (!r.has(d.schema)) {
+        f.push({
+          message: d.schema ? `The '${d.schema}' schema is not in the configuration but was referenced by a document.` : r.size > 1 ? "The document is not for a known schema. Have you re-generated the output file?" : "Multiple schemas are configured, but the document is not for a specific schema.",
+          file: p.fileName,
+          line: p.line,
+          col: p.col
         });
+        continue;
       }
+      c.push({
+        schemaName: d.schema,
+        document: d.node.text,
+        filePath: p.fileName,
+        line: p.line,
+        col: p.col
+      });
+    }
+    return {
+      filePath: l,
+      documents: c,
+      imports: m,
+      warnings: f
+    };
+  };
+  var isHeapOverSoftLimit = () => {
+    if (process.memoryUsage().heapUsed < l) {
+      return !1;
+    }
+    forceGc();
+    return process.memoryUsage().heapUsed >= l;
+  };
+  var d = 0;
+  for (var h of u) {
+    if (d > 0 && (d >= 1e3 || isHeapOverSoftLimit())) {
+      m = (f = t.build()).buildPluginInfo(i.pluginConfig);
+      forceGc();
+      d = 0;
+    }
+    var p = f.getSourceFile(h);
+    if (!p) {
+      continue;
     }
+    var {filePath: g, documents: v, imports: F, warnings: N} = processSourceFile(p, f, m);
+    d++;
     yield {
-      kind: "FILE_DIAGNOSTICS",
-      filePath: v,
-      messages: C
+      kind: "FILE_SCAN",
+      filePath: g,
+      documents: v,
+      imports: F,
+      warnings: N
     };
   }
 }));
 
-export { t as runDiagnostics };
+export { f as runScan };
 //# sourceMappingURL=thread-chunk3.mjs.map

package/dist/chunks/thread-chunk3.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"thread-chunk3.mjs","sources":["../../src/commands/check/thread.ts"],"sourcesContent":["import ts from 'typescript';\nimport * as path from 'node:path';\n\nimport type { GraphQLSPConfig } from '@gql.tada/internal';\nimport { loadRef } from '@gql.tada/internal';\nimport { getGraphQLDiagnostics } from '@0no-co/graphqlsp/api';\n\nimport { programFactory } from '../../ts';\nimport { expose } from '../../threads';\n\nimport type { Severity, DiagnosticMessage, DiagnosticSignal } from './types';\n\nexport interface DiagnosticsParams {\n  rootPath: string;\n  tsconfigPath?: string;\n  configPath: string;\n  pluginConfig: GraphQLSPConfig;\n}\n\nasync function* _runDiagnostics(\n  params: DiagnosticsParams\n): AsyncIterableIterator<DiagnosticSignal> {\n  const projectPath = path.dirname(params.configPath);\n  const factory = programFactory(params);\n\n  const externalFiles = factory.createExternalFiles();\n  if (externalFiles.length) {\n    yield { kind: 'EXTERNAL_WARNING' };\n    await factory.addVirtualFiles(externalFiles);\n  }\n\n  const loadedRef = await loadRef(params.pluginConfig).load({ rootPath: projectPath });\n\n  // TODO(@kitten): Align `SchemaRef` in `@0no-co/graphqlsp` back with `@gql.tada/internal`\n  const schemaRef = {\n    current: loadedRef.current,\n    multi: loadedRef.multi,\n    version: loadedRef.version,\n    errors: {\n      config: null,\n      load: new Map<string | null, string>(),\n      write: new Map<string, string>(),\n    },\n    outputLocations: new Map<string, number>(),\n    checkStale() {},\n  };\n\n  const container = factory.build();\n  const pluginInfo = container.buildPluginInfo(params.pluginConfig);\n  const sourceFiles = container.getSourceFiles();\n\n  yield {\n    kind: 'FILE_COUNT',\n    fileCount: sourceFiles.length,\n  };\n\n  for (const sourceFile of sourceFiles) {\n    const isVueOrSvelte =\n      sourceFile.fileName.endsWith('.vue.ts') || sourceFile.fileName.endsWith('.svelte.ts');\n    let filePath = sourceFile.fileName;\n    pluginInfo.config = {\n      ...pluginInfo.config,\n      shouldCheckForColocatedFragments: isVueOrSvelte\n        ? false\n        : (pluginInfo.config.shouldCheckForColocatedFragments ?? false),\n      trackFieldUsage: isVueOrSvelte ? false : (pluginInfo.config.trackFieldUsage ?? false),\n    };\n    const diagnostics = getGraphQLDiagnostics(filePath, schemaRef, pluginInfo);\n    const messages: DiagnosticMessage[] = [];\n\n    if (diagnostics && diagnostics.length) {\n      for (const diagnostic of diagnostics) {\n        if (\n          !('messageText' in diagnostic) ||\n          typeof diagnostic.messageText !== 'string' ||\n          !diagnostic.file\n        ) {\n          continue;\n        }\n        let severity: Severity = 'info';\n        if (diagnostic.category === ts.DiagnosticCategory.Error) {\n          severity = 'error';\n        } else if (diagnostic.category === ts.DiagnosticCategory.Warning) {\n          severity = 'warn';\n        }\n        const span = { start: diagnostic.start || 1, length: diagnostic.length || 1 };\n        const position = container.getSourcePosition(sourceFile, span);\n        filePath = position.fileName;\n        messages.push({\n          severity,\n          message: diagnostic.messageText,\n          file: position.fileName,\n          line: position.line,\n          col: position.col,\n          endLine: position.endLine,\n          endColumn: position.endColumn,\n        });\n      }\n    }\n\n    yield {\n      kind: 'FILE_DIAGNOSTICS',\n      filePath,\n      messages,\n    };\n  }\n}\n\nexport const runDiagnostics = expose(_runDiagnostics);\n"],"names":["runDiagnostics","expose","async","_runDiagnostics","params","projectPath","path","dirname","configPath","factory","programFactory","externalFiles","createExternalFiles","length","kind","addVirtualFiles","loadedRef","loadRef","pluginConfig","load","rootPath","schemaRef","current","multi","version","errors","config","Map","write","outputLocations","checkStale","container","build","pluginInfo","buildPluginInfo","sourceFiles","getSourceFiles","fileCount","sourceFile","isVueOrSvelte","fileName","endsWith","filePath","shouldCheckForColocatedFragments","trackFieldUsage","diagnostics","getGraphQLDiagnostics","messages","diagnostic","messageText","file","severity","category","ts","DiagnosticCategory","Error","Warning","position","getSourcePosition","start","push","message","line","col","endLine","endColumn"],"mappings":";;;;;;;;;;;;IA4GaA,IAAiBC,GAzF9BC,gBAAgBC,gBACdC;EAEA,IAAMC,IAAcC,EAAKC,QAAQH,EAAOI;EACxC,IAAMC,IAAUC,EAAeN;EAE/B,IAAMO,IAAgBF,EAAQG;EAC9B,IAAID,EAAcE,QAAQ;UAClB;MAAEC,MAAM;;UACRL,EAAQM,gBAAgBJ;AAChC;EAEA,IAAMK,UAAkBC,EAAQb,EAAOc,cAAcC,KAAK;IAAEC,UAAUf;;EAGtE,IAAMgB,IAAY;IAChBC,SAASN,EAAUM;IACnBC,OAAOP,EAAUO;IACjBC,SAASR,EAAUQ;IACnBC,QAAQ;MACNC,QAAQ;MACRP,MAAM,IAAIQ;MACVC,OAAO,IAAID;;IAEbE,iBAAiB,IAAIF;IACrBG,UAAAA,IAAc;;EAGhB,IAAMC,IAAYtB,EAAQuB;EAC1B,IAAMC,IAAaF,EAAUG,gBAAgB9B,EAAOc;EACpD,IAAMiB,IAAcJ,EAAUK;QAExB;IACJtB,MAAM;IACNuB,WAAWF,EAAYtB;;EAGzB,KAAK,IAAMyB,KAAcH,GAAa;IACpC,IAAMI,IACJD,EAAWE,SAASC,SAAS,cAAcH,EAAWE,SAASC,SAAS;IAC1E,IAAIC,IAAWJ,EAAWE;IAC1BP,EAAWP,SAAS;SACfO,EAAWP;MACdiB,kCAAkCJ,KAC9B,IACCN,EAAWP,OAAOiB,qCAAoC;MAC3DC,iBAAiBL,KAAgB,IAASN,EAAWP,OAAOkB,oBAAmB;;IAEjF,IAAMC,IAAcC,EAAsBJ,GAAUrB,GAAWY;IAC/D,IAAMc,IAAgC;IAEtC,IAAIF,KAAeA,EAAYhC;MAC7B,KAAK,IAAMmC,KAAcH,GAAa;QACpC,MACI,iBAAiBG,MACe,mBAA3BA,EAAWC,gBACjBD,EAAWE;UAEZ;;QAEF,IAAIC,IAAqB;QACzB,IAAIH,EAAWI,aAAaC,EAAGC,mBAAmBC;UAChDJ,IAAW;eACN,IAAIH,EAAWI,aAAaC,EAAGC,mBAAmBE;UACvDL,IAAW;;QAGb,IAAMM,IAAW1B,EAAU2B,kBAAkBpB,GADhC;UAAEqB,OAAOX,EAAWW,SAAS;UAAG9C,QAAQmC,EAAWnC,UAAU;;QAE1E6B,IAAWe,EAASjB;QACpBO,EAASa,KAAK;UACZT;UACAU,SAASb,EAAWC;UACpBC,MAAMO,EAASjB;UACfsB,MAAML,EAASK;UACfC,KAAKN,EAASM;UACdC,SAASP,EAASO;UAClBC,WAAWR,EAASQ;;AAExB;;UAGI;MACJnD,MAAM;MACN4B;MACAK;;AAEJ;AACF;;"}
+{"version":3,"file":"thread-chunk3.mjs","sources":["../../src/commands/scan/thread.ts"],"sourcesContent":["import ts from 'typescript';\nimport v8 from 'node:v8';\nimport vm from 'node:vm';\nimport { getSchemaNamesFromConfig } from '@gql.tada/internal';\nimport { findAllCallExpressions } from '@0no-co/graphqlsp/api';\n\nimport type { ProgramContainer, PluginCreateInfo } from '../../ts';\nimport { programFactory } from '../../ts';\nimport { expose } from '../../threads';\nimport { hasGraphQLDocumentCandidate } from '../turbo/scan';\n\nimport type { ScanParams, ScanSignal, RawScanDocument, ScanWarning } from './types';\n\nconst HEAP_SOFT_LIMIT_BYTES = 2_500 * 1_024 * 1_024;\nconst SCAN_MAX_BATCH = 1_000;\n\nfunction shouldScanFile(fileName: string): boolean {\n  if (fileName.endsWith('.d.ts') || fileName.endsWith('.d.mts') || fileName.endsWith('.d.cts')) {\n    return false;\n  }\n  return !/(^|[/\\\\])node_modules([/\\\\]|$)/.test(fileName);\n}\n\nfunction collectModuleImports(\n  sourceFile: ts.SourceFile,\n  resolveModulePath: (importSpecifier: string, fromPath: string) => string | undefined\n): string[] {\n  const imports: string[] = [];\n  for (const node of sourceFile.statements) {\n    if (ts.isImportDeclaration(node) && ts.isStringLiteral(node.moduleSpecifier)) {\n      const resolved = resolveModulePath(node.moduleSpecifier.text, sourceFile.fileName);\n      if (resolved && shouldScanFile(resolved)) imports.push(resolved);\n    }\n  }\n  return imports;\n}\n\nasync function* _runScan(params: ScanParams): AsyncIterableIterator<ScanSignal> {\n  const schemaNames = getSchemaNamesFromConfig(params.pluginConfig);\n  const factory = programFactory(params);\n\n  const externalFiles = factory.createExternalFiles();\n  if (externalFiles.length) {\n    yield { kind: 'EXTERNAL_WARNING' };\n    await factory.addVirtualFiles(externalFiles);\n  }\n\n  let container = factory.build();\n  let pluginInfo = container.buildPluginInfo(params.pluginConfig);\n  const fileNames = factory.rootFileNames.filter(shouldScanFile);\n\n  yield { kind: 'FILE_COUNT', fileCount: fileNames.length };\n\n  const processSourceFile = (\n    sourceFile: ts.SourceFile,\n    container: ProgramContainer,\n    pluginInfo: PluginCreateInfo\n  ): {\n    filePath: string;\n    documents: RawScanDocument[];\n    imports: string[];\n    warnings: ScanWarning[];\n  } => {\n    let filePath = sourceFile.fileName;\n    const documents: RawScanDocument[] = [];\n    const warnings: ScanWarning[] = [];\n\n    // The full import graph is emitted for every project file (not just those\n    // with documents), so the analysis layer can compute reachability.\n    const imports = collectModuleImports(sourceFile, factory.resolveModulePath.bind(factory));\n\n    if (!hasGraphQLDocumentCandidate(sourceFile)) {\n      return { filePath, documents, imports, warnings };\n    }\n\n    const calls = findAllCallExpressions(sourceFile, pluginInfo, {\n      searchExternal: false,\n      collectFragments: false,\n    }).nodes;\n\n    for (const call of calls) {\n      const callExpression = call.node.parent;\n      if (!ts.isCallExpression(callExpression)) continue;\n\n      const position = container.getSourcePosition(sourceFile, callExpression.getStart());\n      filePath = position.fileName;\n\n      if (!schemaNames.has(call.schema)) {\n        warnings.push({\n          message: call.schema\n            ? `The '${call.schema}' schema is not in the configuration but was referenced by a document.`\n            : schemaNames.size > 1\n              ? 'The document is not for a known schema. Have you re-generated the output file?'\n              : 'Multiple schemas are configured, but the document is not for a specific schema.',\n          file: position.fileName,\n          line: position.line,\n          col: position.col,\n        });\n        continue;\n      }\n\n      documents.push({\n        schemaName: call.schema,\n        document: call.node.text,\n        filePath: position.fileName,\n        line: position.line,\n        col: position.col,\n      });\n    }\n\n    return { filePath, documents, imports, warnings };\n  };\n\n  const isHeapOverSoftLimit = (): boolean => {\n    if (process.memoryUsage().heapUsed < HEAP_SOFT_LIMIT_BYTES) return false;\n    forceGc();\n    return process.memoryUsage().heapUsed >= HEAP_SOFT_LIMIT_BYTES;\n  };\n\n  let filesInBatch = 0;\n\n  for (const fileName of fileNames) {\n    // When heap or batch limit is reached, rotate the program to free source files.\n    if (filesInBatch > 0 && (filesInBatch >= SCAN_MAX_BATCH || isHeapOverSoftLimit())) {\n      container = factory.build();\n      pluginInfo = container.buildPluginInfo(params.pluginConfig);\n      forceGc();\n      filesInBatch = 0;\n    }\n\n    const sourceFile = container.getSourceFile(fileName);\n    if (!sourceFile) continue;\n\n    const { filePath, documents, imports, warnings } = processSourceFile(\n      sourceFile,\n      container,\n      pluginInfo\n    );\n    filesInBatch++;\n\n    yield { kind: 'FILE_SCAN', filePath, documents, imports, warnings };\n  }\n}\n\nlet cachedGc: (() => void) | null | undefined;\n\nfunction forceGc(): void {\n  if (cachedGc === undefined) {\n    const existing = (globalThis as { gc?: () => void }).gc;\n    if (typeof existing === 'function') {\n      cachedGc = existing;\n    } else {\n      try {\n        v8.setFlagsFromString('--expose-gc');\n        cachedGc = vm.runInNewContext('gc') as () => void;\n        v8.setFlagsFromString('--no-expose-gc');\n      } catch {\n        cachedGc = null;\n      }\n    }\n  }\n  if (cachedGc) cachedGc();\n}\n\nexport const runScan = expose(_runScan);\n"],"names":["HEAP_SOFT_LIMIT_BYTES","shouldScanFile","fileName","endsWith","test","cachedGc","forceGc","undefined","existing","globalThis","gc","v8","setFlagsFromString","vm","runInNewContext","runScan","expose","async","_runScan","params","schemaNames","getSchemaNamesFromConfig","pluginConfig","factory","programFactory","externalFiles","createExternalFiles","length","kind","addVirtualFiles","container","build","pluginInfo","buildPluginInfo","fileNames","rootFileNames","filter","fileCount","processSourceFile","sourceFile","filePath","documents","warnings","imports","collectModuleImports","resolveModulePath","node","statements","ts","isImportDeclaration","isStringLiteral","moduleSpecifier","resolved","text","push","bind","hasGraphQLDocumentCandidate","calls","findAllCallExpressions","searchExternal","collectFragments","nodes","call","callExpression","parent","isCallExpression","position","getSourcePosition","getStart","has","schema","message","size","file","line","col","schemaName","document","isHeapOverSoftLimit","process","memoryUsage","heapUsed","filesInBatch","getSourceFile"],"mappings":"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"}

package/dist/chunks/thread-chunk4.js

@@ -0,0 +1,112 @@
+var e = require("typescript");
+
+var r = require("node:path");
+
+var a = require("@gql.tada/internal");
+
+var i = require("@0no-co/graphqlsp/api");
+
+var t = require("./index-chunk2.js");
+
+var n = require("./index-chunk.js");
+
+function _interopNamespaceDefault(e) {
+  var r = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach((function(a) {
+      if ("default" !== a) {
+        var i = Object.getOwnPropertyDescriptor(e, a);
+        Object.defineProperty(r, a, i.get ? i : {
+          enumerable: !0,
+          get: function() {
+            return e[a];
+          }
+        });
+      }
+    }));
+  }
+  r.default = e;
+  return r;
+}
+
+var o = _interopNamespaceDefault(r);
+
+var l = t.expose((async function* _runDiagnostics(r) {
+  var t = o.dirname(r.configPath);
+  var l = n.programFactory(r);
+  var s = l.createExternalFiles();
+  if (s.length) {
+    yield {
+      kind: "EXTERNAL_WARNING"
+    };
+    await l.addVirtualFiles(s);
+  }
+  var c = await a.loadRef(r.pluginConfig).load({
+    rootPath: t
+  });
+  var g = {
+    current: c.current,
+    multi: c.multi,
+    version: c.version,
+    errors: {
+      config: null,
+      load: new Map,
+      write: new Map
+    },
+    outputLocations: new Map,
+    checkStale() {}
+  };
+  var u = l.build();
+  var f = u.buildPluginInfo(r.pluginConfig);
+  var d = u.getSourceFiles();
+  yield {
+    kind: "FILE_COUNT",
+    fileCount: d.length
+  };
+  for (var v of d) {
+    var p = v.fileName.endsWith(".vue.ts") || v.fileName.endsWith(".svelte.ts");
+    var h = v.fileName;
+    f.config = {
+      ...f.config,
+      shouldCheckForColocatedFragments: p ? !1 : f.config.shouldCheckForColocatedFragments ?? !1,
+      trackFieldUsage: p ? !1 : f.config.trackFieldUsage ?? !1
+    };
+    var m = i.getGraphQLDiagnostics(h, g, f);
+    var y = [];
+    if (m && m.length) {
+      for (var C of m) {
+        if (!("messageText" in C) || "string" != typeof C.messageText || !C.file) {
+          continue;
+        }
+        var F = "info";
+        if (C.category === e.DiagnosticCategory.Error) {
+          F = "error";
+        } else if (C.category === e.DiagnosticCategory.Warning) {
+          F = "warn";
+        }
+        var N = u.getSourcePosition(v, {
+          start: C.start || 1,
+          length: C.length || 1
+        });
+        h = N.fileName;
+        y.push({
+          severity: F,
+          message: C.messageText,
+          file: N.fileName,
+          line: N.line,
+          col: N.col,
+          endLine: N.endLine,
+          endColumn: N.endColumn
+        });
+      }
+    }
+    yield {
+      kind: "FILE_DIAGNOSTICS",
+      filePath: h,
+      messages: y
+    };
+  }
+}));
+
+exports.runDiagnostics = l;
+//# sourceMappingURL=thread-chunk4.js.map

package/dist/chunks/thread-chunk4.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-chunk4.js","sources":["../../src/commands/check/thread.ts"],"sourcesContent":["import ts from 'typescript';\nimport * as path from 'node:path';\n\nimport type { GraphQLSPConfig } from '@gql.tada/internal';\nimport { loadRef } from '@gql.tada/internal';\nimport { getGraphQLDiagnostics } from '@0no-co/graphqlsp/api';\n\nimport { programFactory } from '../../ts';\nimport { expose } from '../../threads';\n\nimport type { Severity, DiagnosticMessage, DiagnosticSignal } from './types';\n\nexport interface DiagnosticsParams {\n  rootPath: string;\n  tsconfigPath?: string;\n  configPath: string;\n  pluginConfig: GraphQLSPConfig;\n}\n\nasync function* _runDiagnostics(\n  params: DiagnosticsParams\n): AsyncIterableIterator<DiagnosticSignal> {\n  const projectPath = path.dirname(params.configPath);\n  const factory = programFactory(params);\n\n  const externalFiles = factory.createExternalFiles();\n  if (externalFiles.length) {\n    yield { kind: 'EXTERNAL_WARNING' };\n    await factory.addVirtualFiles(externalFiles);\n  }\n\n  const loadedRef = await loadRef(params.pluginConfig).load({ rootPath: projectPath });\n\n  // TODO(@kitten): Align `SchemaRef` in `@0no-co/graphqlsp` back with `@gql.tada/internal`\n  const schemaRef = {\n    current: loadedRef.current,\n    multi: loadedRef.multi,\n    version: loadedRef.version,\n    errors: {\n      config: null,\n      load: new Map<string | null, string>(),\n      write: new Map<string, string>(),\n    },\n    outputLocations: new Map<string, number>(),\n    checkStale() {},\n  };\n\n  const container = factory.build();\n  const pluginInfo = container.buildPluginInfo(params.pluginConfig);\n  const sourceFiles = container.getSourceFiles();\n\n  yield {\n    kind: 'FILE_COUNT',\n    fileCount: sourceFiles.length,\n  };\n\n  for (const sourceFile of sourceFiles) {\n    const isVueOrSvelte =\n      sourceFile.fileName.endsWith('.vue.ts') || sourceFile.fileName.endsWith('.svelte.ts');\n    let filePath = sourceFile.fileName;\n    pluginInfo.config = {\n      ...pluginInfo.config,\n      shouldCheckForColocatedFragments: isVueOrSvelte\n        ? false\n        : (pluginInfo.config.shouldCheckForColocatedFragments ?? false),\n      trackFieldUsage: isVueOrSvelte ? false : (pluginInfo.config.trackFieldUsage ?? false),\n    };\n    const diagnostics = getGraphQLDiagnostics(filePath, schemaRef, pluginInfo);\n    const messages: DiagnosticMessage[] = [];\n\n    if (diagnostics && diagnostics.length) {\n      for (const diagnostic of diagnostics) {\n        if (\n          !('messageText' in diagnostic) ||\n          typeof diagnostic.messageText !== 'string' ||\n          !diagnostic.file\n        ) {\n          continue;\n        }\n        let severity: Severity = 'info';\n        if (diagnostic.category === ts.DiagnosticCategory.Error) {\n          severity = 'error';\n        } else if (diagnostic.category === ts.DiagnosticCategory.Warning) {\n          severity = 'warn';\n        }\n        const span = { start: diagnostic.start || 1, length: diagnostic.length || 1 };\n        const position = container.getSourcePosition(sourceFile, span);\n        filePath = position.fileName;\n        messages.push({\n          severity,\n          message: diagnostic.messageText,\n          file: position.fileName,\n          line: position.line,\n          col: position.col,\n          endLine: position.endLine,\n          endColumn: position.endColumn,\n        });\n      }\n    }\n\n    yield {\n      kind: 'FILE_DIAGNOSTICS',\n      filePath,\n      messages,\n    };\n  }\n}\n\nexport const runDiagnostics = expose(_runDiagnostics);\n"],"names":["runDiagnostics","expose","async","_runDiagnostics","params","projectPath","path","dirname","configPath","factory","programFactory","externalFiles","createExternalFiles","length","kind","addVirtualFiles","loadedRef","loadRef","pluginConfig","load","rootPath","schemaRef","current","multi","version","errors","config","Map","write","outputLocations","checkStale","container","build","pluginInfo","buildPluginInfo","sourceFiles","getSourceFiles","fileCount","sourceFile","isVueOrSvelte","fileName","endsWith","filePath","shouldCheckForColocatedFragments","trackFieldUsage","diagnostics","getGraphQLDiagnostics","messages","diagnostic","messageText","file","severity","category","ts","DiagnosticCategory","Error","Warning","position","getSourcePosition","start","push","message","line","col","endLine","endColumn"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4GaA,IAAiBC,EAAMA,QAzFpCC,gBAAgBC,gBACdC;EAEA,IAAMC,IAAcC,EAAKC,QAAQH,EAAOI;EACxC,IAAMC,IAAUC,iBAAeN;EAE/B,IAAMO,IAAgBF,EAAQG;EAC9B,IAAID,EAAcE,QAAQ;UAClB;MAAEC,MAAM;;UACRL,EAAQM,gBAAgBJ;AAChC;EAEA,IAAMK,UAAkBC,EAAOA,QAACb,EAAOc,cAAcC,KAAK;IAAEC,UAAUf;;EAGtE,IAAMgB,IAAY;IAChBC,SAASN,EAAUM;IACnBC,OAAOP,EAAUO;IACjBC,SAASR,EAAUQ;IACnBC,QAAQ;MACNC,QAAQ;MACRP,MAAM,IAAIQ;MACVC,OAAO,IAAID;;IAEbE,iBAAiB,IAAIF;IACrBG,UAAAA,IAAc;;EAGhB,IAAMC,IAAYtB,EAAQuB;EAC1B,IAAMC,IAAaF,EAAUG,gBAAgB9B,EAAOc;EACpD,IAAMiB,IAAcJ,EAAUK;QAExB;IACJtB,MAAM;IACNuB,WAAWF,EAAYtB;;EAGzB,KAAK,IAAMyB,KAAcH,GAAa;IACpC,IAAMI,IACJD,EAAWE,SAASC,SAAS,cAAcH,EAAWE,SAASC,SAAS;IAC1E,IAAIC,IAAWJ,EAAWE;IAC1BP,EAAWP,SAAS;SACfO,EAAWP;MACdiB,kCAAkCJ,KAC9B,IACCN,EAAWP,OAAOiB,qCAAoC;MAC3DC,iBAAiBL,KAAgB,IAASN,EAAWP,OAAOkB,oBAAmB;;IAEjF,IAAMC,IAAcC,EAAqBA,sBAACJ,GAAUrB,GAAWY;IAC/D,IAAMc,IAAgC;IAEtC,IAAIF,KAAeA,EAAYhC;MAC7B,KAAK,IAAMmC,KAAcH,GAAa;QACpC,MACI,iBAAiBG,MACe,mBAA3BA,EAAWC,gBACjBD,EAAWE;UAEZ;;QAEF,IAAIC,IAAqB;QACzB,IAAIH,EAAWI,aAAaC,EAAGC,mBAAmBC;UAChDJ,IAAW;eACN,IAAIH,EAAWI,aAAaC,EAAGC,mBAAmBE;UACvDL,IAAW;;QAGb,IAAMM,IAAW1B,EAAU2B,kBAAkBpB,GADhC;UAAEqB,OAAOX,EAAWW,SAAS;UAAG9C,QAAQmC,EAAWnC,UAAU;;QAE1E6B,IAAWe,EAASjB;QACpBO,EAASa,KAAK;UACZT;UACAU,SAASb,EAAWC;UACpBC,MAAMO,EAASjB;UACfsB,MAAML,EAASK;UACfC,KAAKN,EAASM;UACdC,SAASP,EAASO;UAClBC,WAAWR,EAASQ;;AAExB;;UAGI;MACJnD,MAAM;MACN4B;MACAK;;AAEJ;AACF;;"}

package/dist/chunks/thread-chunk4.mjs

@@ -0,0 +1,91 @@
+import e from "typescript";
+
+import * as i from "node:path";
+
+import { loadRef as a } from "@gql.tada/internal";
+
+import { getGraphQLDiagnostics as r } from "@0no-co/graphqlsp/api";
+
+import { e as n } from "./index-chunk2.mjs";
+
+import { p as o } from "./index-chunk.mjs";
+
+var t = n((async function* _runDiagnostics(n) {
+  var t = i.dirname(n.configPath);
+  var l = o(n);
+  var s = l.createExternalFiles();
+  if (s.length) {
+    yield {
+      kind: "EXTERNAL_WARNING"
+    };
+    await l.addVirtualFiles(s);
+  }
+  var g = await a(n.pluginConfig).load({
+    rootPath: t
+  });
+  var f = {
+    current: g.current,
+    multi: g.multi,
+    version: g.version,
+    errors: {
+      config: null,
+      load: new Map,
+      write: new Map
+    },
+    outputLocations: new Map,
+    checkStale() {}
+  };
+  var c = l.build();
+  var m = c.buildPluginInfo(n.pluginConfig);
+  var d = c.getSourceFiles();
+  yield {
+    kind: "FILE_COUNT",
+    fileCount: d.length
+  };
+  for (var u of d) {
+    var p = u.fileName.endsWith(".vue.ts") || u.fileName.endsWith(".svelte.ts");
+    var v = u.fileName;
+    m.config = {
+      ...m.config,
+      shouldCheckForColocatedFragments: p ? !1 : m.config.shouldCheckForColocatedFragments ?? !1,
+      trackFieldUsage: p ? !1 : m.config.trackFieldUsage ?? !1
+    };
+    var h = r(v, f, m);
+    var C = [];
+    if (h && h.length) {
+      for (var y of h) {
+        if (!("messageText" in y) || "string" != typeof y.messageText || !y.file) {
+          continue;
+        }
+        var F = "info";
+        if (y.category === e.DiagnosticCategory.Error) {
+          F = "error";
+        } else if (y.category === e.DiagnosticCategory.Warning) {
+          F = "warn";
+        }
+        var k = c.getSourcePosition(u, {
+          start: y.start || 1,
+          length: y.length || 1
+        });
+        v = k.fileName;
+        C.push({
+          severity: F,
+          message: y.messageText,
+          file: k.fileName,
+          line: k.line,
+          col: k.col,
+          endLine: k.endLine,
+          endColumn: k.endColumn
+        });
+      }
+    }
+    yield {
+      kind: "FILE_DIAGNOSTICS",
+      filePath: v,
+      messages: C
+    };
+  }
+}));
+
+export { t as runDiagnostics };
+//# sourceMappingURL=thread-chunk4.mjs.map

package/dist/chunks/thread-chunk4.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-chunk4.mjs","sources":["../../src/commands/check/thread.ts"],"sourcesContent":["import ts from 'typescript';\nimport * as path from 'node:path';\n\nimport type { GraphQLSPConfig } from '@gql.tada/internal';\nimport { loadRef } from '@gql.tada/internal';\nimport { getGraphQLDiagnostics } from '@0no-co/graphqlsp/api';\n\nimport { programFactory } from '../../ts';\nimport { expose } from '../../threads';\n\nimport type { Severity, DiagnosticMessage, DiagnosticSignal } from './types';\n\nexport interface DiagnosticsParams {\n  rootPath: string;\n  tsconfigPath?: string;\n  configPath: string;\n  pluginConfig: GraphQLSPConfig;\n}\n\nasync function* _runDiagnostics(\n  params: DiagnosticsParams\n): AsyncIterableIterator<DiagnosticSignal> {\n  const projectPath = path.dirname(params.configPath);\n  const factory = programFactory(params);\n\n  const externalFiles = factory.createExternalFiles();\n  if (externalFiles.length) {\n    yield { kind: 'EXTERNAL_WARNING' };\n    await factory.addVirtualFiles(externalFiles);\n  }\n\n  const loadedRef = await loadRef(params.pluginConfig).load({ rootPath: projectPath });\n\n  // TODO(@kitten): Align `SchemaRef` in `@0no-co/graphqlsp` back with `@gql.tada/internal`\n  const schemaRef = {\n    current: loadedRef.current,\n    multi: loadedRef.multi,\n    version: loadedRef.version,\n    errors: {\n      config: null,\n      load: new Map<string | null, string>(),\n      write: new Map<string, string>(),\n    },\n    outputLocations: new Map<string, number>(),\n    checkStale() {},\n  };\n\n  const container = factory.build();\n  const pluginInfo = container.buildPluginInfo(params.pluginConfig);\n  const sourceFiles = container.getSourceFiles();\n\n  yield {\n    kind: 'FILE_COUNT',\n    fileCount: sourceFiles.length,\n  };\n\n  for (const sourceFile of sourceFiles) {\n    const isVueOrSvelte =\n      sourceFile.fileName.endsWith('.vue.ts') || sourceFile.fileName.endsWith('.svelte.ts');\n    let filePath = sourceFile.fileName;\n    pluginInfo.config = {\n      ...pluginInfo.config,\n      shouldCheckForColocatedFragments: isVueOrSvelte\n        ? false\n        : (pluginInfo.config.shouldCheckForColocatedFragments ?? false),\n      trackFieldUsage: isVueOrSvelte ? false : (pluginInfo.config.trackFieldUsage ?? false),\n    };\n    const diagnostics = getGraphQLDiagnostics(filePath, schemaRef, pluginInfo);\n    const messages: DiagnosticMessage[] = [];\n\n    if (diagnostics && diagnostics.length) {\n      for (const diagnostic of diagnostics) {\n        if (\n          !('messageText' in diagnostic) ||\n          typeof diagnostic.messageText !== 'string' ||\n          !diagnostic.file\n        ) {\n          continue;\n        }\n        let severity: Severity = 'info';\n        if (diagnostic.category === ts.DiagnosticCategory.Error) {\n          severity = 'error';\n        } else if (diagnostic.category === ts.DiagnosticCategory.Warning) {\n          severity = 'warn';\n        }\n        const span = { start: diagnostic.start || 1, length: diagnostic.length || 1 };\n        const position = container.getSourcePosition(sourceFile, span);\n        filePath = position.fileName;\n        messages.push({\n          severity,\n          message: diagnostic.messageText,\n          file: position.fileName,\n          line: position.line,\n          col: position.col,\n          endLine: position.endLine,\n          endColumn: position.endColumn,\n        });\n      }\n    }\n\n    yield {\n      kind: 'FILE_DIAGNOSTICS',\n      filePath,\n      messages,\n    };\n  }\n}\n\nexport const runDiagnostics = expose(_runDiagnostics);\n"],"names":["runDiagnostics","expose","async","_runDiagnostics","params","projectPath","path","dirname","configPath","factory","programFactory","externalFiles","createExternalFiles","length","kind","addVirtualFiles","loadedRef","loadRef","pluginConfig","load","rootPath","schemaRef","current","multi","version","errors","config","Map","write","outputLocations","checkStale","container","build","pluginInfo","buildPluginInfo","sourceFiles","getSourceFiles","fileCount","sourceFile","isVueOrSvelte","fileName","endsWith","filePath","shouldCheckForColocatedFragments","trackFieldUsage","diagnostics","getGraphQLDiagnostics","messages","diagnostic","messageText","file","severity","category","ts","DiagnosticCategory","Error","Warning","position","getSourcePosition","start","push","message","line","col","endLine","endColumn"],"mappings":";;;;;;;;;;;;IA4GaA,IAAiBC,GAzF9BC,gBAAgBC,gBACdC;EAEA,IAAMC,IAAcC,EAAKC,QAAQH,EAAOI;EACxC,IAAMC,IAAUC,EAAeN;EAE/B,IAAMO,IAAgBF,EAAQG;EAC9B,IAAID,EAAcE,QAAQ;UAClB;MAAEC,MAAM;;UACRL,EAAQM,gBAAgBJ;AAChC;EAEA,IAAMK,UAAkBC,EAAQb,EAAOc,cAAcC,KAAK;IAAEC,UAAUf;;EAGtE,IAAMgB,IAAY;IAChBC,SAASN,EAAUM;IACnBC,OAAOP,EAAUO;IACjBC,SAASR,EAAUQ;IACnBC,QAAQ;MACNC,QAAQ;MACRP,MAAM,IAAIQ;MACVC,OAAO,IAAID;;IAEbE,iBAAiB,IAAIF;IACrBG,UAAAA,IAAc;;EAGhB,IAAMC,IAAYtB,EAAQuB;EAC1B,IAAMC,IAAaF,EAAUG,gBAAgB9B,EAAOc;EACpD,IAAMiB,IAAcJ,EAAUK;QAExB;IACJtB,MAAM;IACNuB,WAAWF,EAAYtB;;EAGzB,KAAK,IAAMyB,KAAcH,GAAa;IACpC,IAAMI,IACJD,EAAWE,SAASC,SAAS,cAAcH,EAAWE,SAASC,SAAS;IAC1E,IAAIC,IAAWJ,EAAWE;IAC1BP,EAAWP,SAAS;SACfO,EAAWP;MACdiB,kCAAkCJ,KAC9B,IACCN,EAAWP,OAAOiB,qCAAoC;MAC3DC,iBAAiBL,KAAgB,IAASN,EAAWP,OAAOkB,oBAAmB;;IAEjF,IAAMC,IAAcC,EAAsBJ,GAAUrB,GAAWY;IAC/D,IAAMc,IAAgC;IAEtC,IAAIF,KAAeA,EAAYhC;MAC7B,KAAK,IAAMmC,KAAcH,GAAa;QACpC,MACI,iBAAiBG,MACe,mBAA3BA,EAAWC,gBACjBD,EAAWE;UAEZ;;QAEF,IAAIC,IAAqB;QACzB,IAAIH,EAAWI,aAAaC,EAAGC,mBAAmBC;UAChDJ,IAAW;eACN,IAAIH,EAAWI,aAAaC,EAAGC,mBAAmBE;UACvDL,IAAW;;QAGb,IAAMM,IAAW1B,EAAU2B,kBAAkBpB,GADhC;UAAEqB,OAAOX,EAAWW,SAAS;UAAG9C,QAAQmC,EAAWnC,UAAU;;QAE1E6B,IAAWe,EAASjB;QACpBO,EAASa,KAAK;UACZT;UACAU,SAASb,EAAWC;UACpBC,MAAMO,EAASjB;UACfsB,MAAML,EAASK;UACfC,KAAKN,EAASM;UACdC,SAASP,EAASO;UAClBC,WAAWR,EAASQ;;AAExB;;UAGI;MACJnD,MAAM;MACN4B;MACAK;;AAEJ;AACF;;"}

package/dist/gql-tada-cli.d.ts

@@ -103,16 +103,40 @@ interface TurboOptions {
  */
 declare function generateTurbo(opts: TurboOptions): Promise<void>;
 
+type ScanFormat = 'json';
+interface ScanOptions {
+  /** The `tsconfig.json` to use for configurations and the TypeScript program. */
+  tsconfig: string | undefined;
+  /** When `json`, write the JSON report; otherwise show the terminal report. */
+  format: ScanFormat | undefined;
+  /** When set, output the pure relationship graph (implies machine output). */
+  graph: boolean;
+  /** Where to write machine output to. Defaults to standard output. */
+  output: string | undefined;
+  /** Whether to fail with a non-zero exit code if any warnings are reported. */
+  failOnWarn: boolean;
+}
+
+/** Scans a project for all GraphQL documents and fragments, keys them to the
+ * schema, and emits a JSON report (when piped or given `--output`) or a
+ * human-readable terminal report.
+ *
+ * @see {@link https://gql-tada.0no.co/reference/gql-tada-cli#scan}
+ */
+declare function scan(opts: ScanOptions): Promise<void>;
+
 declare const api_generateOutput: typeof generateOutput;
 declare const api_generatePersisted: typeof generatePersisted;
 declare const api_generateSchema: typeof generateSchema;
 declare const api_generateTurbo: typeof generateTurbo;
+declare const api_scan: typeof scan;
 declare namespace api {
   export {
     api_generateOutput as generateOutput,
     api_generatePersisted as generatePersisted,
     api_generateSchema as generateSchema,
     api_generateTurbo as generateTurbo,
+    api_scan as scan,
   };
 }
 
@@ -120,4 +144,4 @@ declare function _main(): Promise<void>;
 type MainFn = typeof _main & typeof api;
 declare const main: MainFn;
 
-export { main as default, generateOutput, generatePersisted, generateSchema, generateTurbo };
+export { main as default, generateOutput, generatePersisted, generateSchema, generateTurbo, scan };

package/dist/gql-tada-cli.js

@@ -13,4 +13,6 @@ exports.generatePersisted = e.generatePersisted;
 exports.generateSchema = e.generateSchema;
 
 exports.generateTurbo = e.generateTurbo;
+
+exports.scan = e.scan;
 //# sourceMappingURL=gql-tada-cli.js.map

package/dist/gql-tada-cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"gql-tada-cli.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;"}
+{"version":3,"file":"gql-tada-cli.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;"}

package/dist/gql-tada-cli.mjs

@@ -1,2 +1,2 @@
-export { m as default, g as generateOutput, a as generatePersisted, b as generateSchema, c as generateTurbo } from "./chunks/index-chunk.mjs";
+export { m as default, g as generateOutput, a as generatePersisted, b as generateSchema, c as generateTurbo, d as scan } from "./chunks/index-chunk.mjs";
 //# sourceMappingURL=gql-tada-cli.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gql.tada/cli-utils",
-  "version": "1.8.2",
+  "version": "1.9.0",
   "public": true,
   "description": "Main logic for gql.tada’s CLI tool.",
   "author": "0no.co <hi@0no.co>",
@@ -51,7 +51,7 @@
   "dependencies": {
     "@0no-co/graphqlsp": "^1.17.1",
     "graphql": "^15.5.0 || ^16.0.0 || ^17.0.0",
-    "@gql.tada/internal": "1.1.0"
+    "@gql.tada/internal": "1.2.0"
   },
   "peerDependenciesMeta": {
     "@gql.tada/svelte-support": {