pocketbomb-dynamite 0.0.0-stage → 0.3.0

package/LICENSE.md

@@ -0,0 +1,17 @@
+The MIT License (MIT)
+Copyright (c) 2026 - present, the PocketBomb contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software
+and associated documentation files (the "Software"), to deal in the Software without restriction,
+including without limitation the rights to use, copy, modify, merge, publish, distribute,
+sublicense, and/or sell copies of the Software, and to permit persons to whom the Software
+is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
+BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,62 @@
-# Temporary Holding Version
+# pocketbomb-dynamite
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The PocketBomb storefront framework (similar to Hydrogen).
+
+```ts
+import { createRequestContext, createStorefrontClient, gql, MemoryCache } from "pocketbomb-dynamite";
+import { createCustomerAccountClient } from "pocketbomb-dynamite/customer-account";
+
+const cache = new MemoryCache();
+
+export async function handle(request: Request) {
+  const context = createRequestContext({ request, cache }); // buyer IP, cookie session, cache
+  const storefront = createStorefrontClient({ url, privateKey, requestContext: context });
+  const customer = createCustomerAccountClient({
+    url, collection: "users", clientId, redirectUri, requestContext: context,
+  });
+
+  const path = new URL(request.url).pathname;
+  if (path === "/account/login") return customer.loginRedirect({ returnTo: "/account" });
+  if (path === "/account/callback") return customer.callbackRedirect();
+  if (path === "/account/logout") return customer.logoutRedirect();
+
+  const { products } = await storefront.query(PRODUCTS, { variables: { first: 10 } });
+  const response = new Response(render(products, customer.isLoggedIn()));
+  context.applyResponseHeaders(response.headers); // Set-Cookie + private caching
+  return response;
+}
+
+const PRODUCTS = gql<{ products: { nodes: Array<{ id: string; title: string }> } }, { first: number }>(
+  `query Products($first: Int) { products(first: $first) { nodes { id title } } }`,
+);
+```
+
+Entries: `pocketbomb-dynamite` (core + storefront client + GraphQL), `pocketbomb-dynamite/customer-account`,
+`pocketbomb-dynamite/graphql` (gql.tada `graphql()` typed by `dynamite codegen`), `pocketbomb-dynamite/react`
+(DynamiteProvider, useStorefront, useCustomer, useStorefrontQuery, Pagination, FileImage), `pocketbomb-dynamite/vite`
+(env + private key guard, dev proxy, codegen, fuse) and `pocketbomb-dynamite/ts-plugin` (graphqlsp for the editor).
+
+CLI: `dynamite codegen [--watch] [--fuse --seed <module>]`, `dynamite dev [--seed] [--entry server.ts]`,
+`dynamite check [--schema <file>]`, `dynamite info`.
+
+## Global ids
+
+GraphQL is read-only and its `id` fields are Relay global ids: base64url of `{collectionName}:{recordId}`. The REST
+API takes record ids, so convert them when a GraphQL result drives a write:
+
+```ts
+import { fromGlobalId, toGlobalId } from "pocketbomb-dynamite/graphql";
+
+const { todos } = await customer.query(TODOS);                       // todos.nodes[0].id = "dG9kb3M6NDFoa2s..."
+const { collectionName, id } = fromGlobalId(todos.nodes[0].id);      // "todos", "41hkk..." (throws if it is invalid)
+await customer.client.collection(collectionName).update(id, { done: true });
+
+await storefront.query(TODO, { variables: { id: toGlobalId("todos", id) } }); // the other way around
+```
+
+## Checking the documents
+
+`tsc` types the results of the `graphql()` documents but doesn't validate the documents themselves (an unknown field
+is flagged only by the editor plugin). `dynamite check` validates every `graphql()` document of the project
+against `.dynamite/schema.graphql` and fails with `file:line:column`; add it to your typecheck script.
+It needs `typescript` installed in the project.

package/bin/dynamite.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { run } from "../dist/cli/index.js";
+
+run(process.argv.slice(2)).then(
+  (code) => process.exit(code),
+  (err) => {
+    console.error(err);
+    process.exit(1);
+  },
+);

package/dist/_virtual/_rolldown/runtime.cjs

@@ -0,0 +1,22 @@
+// \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+exports.__toESM = __toESM;

package/dist/cli/check.cjs

@@ -0,0 +1,160 @@
+const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
+require("../shared/constants.cjs");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let graphql = require("graphql");
+// src/cli/check.ts
+const IGNORED_DIRS = /* @__PURE__ */ new Set([
+	"node_modules",
+	"build",
+	"dist",
+	".git",
+	".react-router",
+	".turbo",
+	".next",
+	".dynamite"
+]);
+function sourceFiles(dir, result = []) {
+	for (const entry of node_fs.default.readdirSync(dir, { withFileTypes: true })) if (entry.isDirectory()) {
+		if (!IGNORED_DIRS.has(entry.name)) sourceFiles(node_path.default.join(dir, entry.name), result);
+	} else if (/\.(ts|tsx|mts|cts)$/.test(entry.name) && !entry.name.endsWith(".d.ts")) result.push(node_path.default.join(dir, entry.name));
+	return result;
+}
+async function loadTypeScript() {
+	try {
+		const ts = await import("typescript");
+		return ts.default || ts;
+	} catch {
+		throw new Error("dynamite check needs the typescript package installed in the project.");
+	}
+}
+function findDocuments(ts, file) {
+	const source = ts.createSourceFile(file, node_fs.default.readFileSync(file, "utf8"), ts.ScriptTarget.Latest, true);
+	const result = [];
+	const visitNode = (node) => {
+		if (ts.isCallExpression(node) && ts.isIdentifier(node.expression) && node.expression.text === "graphql") {
+			const arg = node.arguments[0];
+			if (arg && (ts.isNoSubstitutionTemplateLiteral(arg) || ts.isStringLiteral(arg))) {
+				const start = source.getLineAndCharacterOfPosition(arg.getStart(source) + 1);
+				result.push({
+					file,
+					line: start.line,
+					column: start.character,
+					text: arg.text
+				});
+			} else if (arg) {
+				const start = source.getLineAndCharacterOfPosition(arg.getStart(source));
+				result.push({
+					file,
+					line: start.line,
+					column: start.character,
+					text: ""
+				});
+			}
+		}
+		ts.forEachChild(node, visitNode);
+	};
+	visitNode(source);
+	return result;
+}
+function usedFragments(root, all) {
+	const used = /* @__PURE__ */ new Map();
+	const collect = (node) => {
+		(0, graphql.visit)(node, { FragmentSpread(spread) {
+			const fragment = all.get(spread.name.value);
+			if (fragment && !used.has(spread.name.value)) {
+				used.set(spread.name.value, fragment);
+				collect(fragment);
+			}
+		} });
+	};
+	collect(root);
+	return used;
+}
+function problemOf(doc, error) {
+	const location = error.locations?.[0];
+	return {
+		file: doc.file,
+		line: doc.line + (location?.line ?? 1),
+		column: location?.line === 1 ? doc.column + location.column : location?.column ?? 1,
+		message: error.message
+	};
+}
+/**
+* Validates every `graphql()` document of a project (fragments are resolved by name across
+* the project; a document that isn't a plain string can't be checked and is reported).
+*/
+async function check(options = {}) {
+	const cwd = node_path.default.resolve(options.cwd || process.cwd());
+	const schemaFile = node_path.default.resolve(cwd, options.schemaFile || ".dynamite/schema.graphql");
+	const ts = await loadTypeScript();
+	const documents = sourceFiles(cwd).flatMap((file) => findDocuments(ts, file));
+	if (!documents.length) return {
+		documents: 0,
+		problems: []
+	};
+	if (!options.schema && !node_fs.default.existsSync(schemaFile)) throw new Error("Missing " + node_path.default.relative(cwd, schemaFile) + ": run `dynamite codegen` first.");
+	const schema = options.schema || (0, graphql.buildSchema)(node_fs.default.readFileSync(schemaFile, "utf8"));
+	const problems = [];
+	const parsed = [];
+	const fragments = /* @__PURE__ */ new Map();
+	const fragmentOwners = /* @__PURE__ */ new Map();
+	for (const doc of documents) {
+		if (!doc.text) {
+			problems.push({
+				file: doc.file,
+				line: doc.line + 1,
+				column: doc.column + 1,
+				message: "graphql() needs a plain string document to be checked (no ${} interpolation)."
+			});
+			continue;
+		}
+		try {
+			const ast = (0, graphql.parse)(doc.text);
+			parsed.push({
+				doc,
+				ast
+			});
+			for (const definition of ast.definitions) {
+				if (definition.kind !== graphql.Kind.FRAGMENT_DEFINITION) continue;
+				const name = definition.name.value;
+				if (fragmentOwners.has(name)) problems.push({
+					file: doc.file,
+					line: doc.line + (definition.loc?.startToken.line ?? 1),
+					column: 1,
+					message: `Duplicated fragment "${name}" (also in ${node_path.default.relative(cwd, fragmentOwners.get(name).file)}).`
+				});
+				fragments.set(name, definition);
+				fragmentOwners.set(name, doc);
+			}
+		} catch (err) {
+			problems.push(problemOf(doc, err));
+		}
+	}
+	const rules = graphql.specifiedRules.filter((rule) => rule !== graphql.NoUnusedFragmentsRule);
+	for (const { doc, ast } of parsed) {
+		const own = new Set(ast.definitions.flatMap((d) => d.kind === graphql.Kind.FRAGMENT_DEFINITION ? [d.name.value] : []));
+		const imported = [...usedFragments(ast, fragments).entries()].filter(([name]) => !own.has(name)).map(([, fragment]) => fragment);
+		const errors = (0, graphql.validate)(schema, {
+			...ast,
+			definitions: [...ast.definitions, ...imported]
+		}, rules);
+		for (const error of errors) {
+			if (imported.some((f) => error.nodes?.some((n) => isInside(n, f)))) continue;
+			problems.push(problemOf(doc, error));
+		}
+	}
+	problems.sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line || a.column - b.column);
+	return {
+		documents: documents.length,
+		problems
+	};
+}
+function isInside(node, fragment) {
+	return !!node.loc && node.loc.source === fragment.loc?.source;
+}
+exports.check = check;
+
+//# sourceMappingURL=check.cjs.map

package/dist/cli/check.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.cjs","names":["fs","path","buildSchema","parse","Kind","specifiedRules","NoUnusedFragmentsRule","validate"],"sources":["../../src/cli/check.ts"],"sourcesContent":["// `dynamite check`: validates the graphql() documents of a project against the codegen schema.\n//\n// Why not gql.tada's `gql-tada check`: it isn't a dependency (@gql.tada/cli-utils), and it finds the schema in a\n// tsconfig plugin entry named after gql.tada/graphqlsp, while the projects here use pocketbomb-dynamite/ts-plugin.\n// The check itself is small: the TypeScript parser finds the documents and graphql-js validates them.\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport {\n  buildSchema,\n  GraphQLError,\n  Kind,\n  NoUnusedFragmentsRule,\n  parse,\n  specifiedRules,\n  validate,\n  visit,\n  type DocumentNode,\n  type FragmentDefinitionNode,\n  type GraphQLSchema,\n} from \"graphql\";\nimport { DEFAULT_SCHEMA_FILE } from \"./codegen\";\n\nconst IGNORED_DIRS = new Set([\n  \"node_modules\",\n  \"build\",\n  \"dist\",\n  \".git\",\n  \".react-router\",\n  \".turbo\",\n  \".next\",\n  \".dynamite\",\n]);\n\nexport interface CheckProblem {\n  file: string;\n  line: number;\n  column: number;\n  message: string;\n}\n\nexport interface CheckResult {\n  documents: number;\n  problems: Array<CheckProblem>;\n}\n\ninterface FoundDocument {\n  file: string;\n  /** The zero based position of the document text start in its file. */\n  line: number;\n  column: number;\n  text: string;\n}\n\nfunction sourceFiles(dir: string, result: Array<string> = []): Array<string> {\n  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {\n    if (entry.isDirectory()) {\n      if (!IGNORED_DIRS.has(entry.name)) sourceFiles(path.join(dir, entry.name), result);\n    } else if (/\\.(ts|tsx|mts|cts)$/.test(entry.name) && !entry.name.endsWith(\".d.ts\")) {\n      result.push(path.join(dir, entry.name));\n    }\n  }\n  return result;\n}\n\nasync function loadTypeScript(): Promise<typeof import(\"typescript\")> {\n  try {\n    const ts: any = await import(\"typescript\");\n    return ts.default || ts;\n  } catch {\n    throw new Error(\"dynamite check needs the typescript package installed in the project.\");\n  }\n}\n\nfunction findDocuments(ts: typeof import(\"typescript\"), file: string): Array<FoundDocument> {\n  const source = ts.createSourceFile(\n    file,\n    fs.readFileSync(file, \"utf8\"),\n    ts.ScriptTarget.Latest,\n    true,\n  );\n  const result: Array<FoundDocument> = [];\n\n  const visitNode = (node: import(\"typescript\").Node) => {\n    if (\n      ts.isCallExpression(node) &&\n      ts.isIdentifier(node.expression) &&\n      node.expression.text === \"graphql\"\n    ) {\n      const arg = node.arguments[0];\n      if (arg && (ts.isNoSubstitutionTemplateLiteral(arg) || ts.isStringLiteral(arg))) {\n        // +1: the opening quote\n        const start = source.getLineAndCharacterOfPosition(arg.getStart(source) + 1);\n        result.push({ file, line: start.line, column: start.character, text: arg.text });\n      } else if (arg) {\n        const start = source.getLineAndCharacterOfPosition(arg.getStart(source));\n        result.push({ file, line: start.line, column: start.character, text: \"\" });\n      }\n    }\n    ts.forEachChild(node, visitNode);\n  };\n  visitNode(source);\n\n  return result;\n}\n\nfunction usedFragments(root: DocumentNode, all: Map<string, FragmentDefinitionNode>) {\n  const used = new Map<string, FragmentDefinitionNode>();\n  const collect = (node: DocumentNode | FragmentDefinitionNode) => {\n    visit(node, {\n      FragmentSpread(spread) {\n        const fragment = all.get(spread.name.value);\n        if (fragment && !used.has(spread.name.value)) {\n          used.set(spread.name.value, fragment);\n          collect(fragment);\n        }\n      },\n    });\n  };\n  collect(root);\n  return used;\n}\n\nfunction problemOf(doc: FoundDocument, error: GraphQLError): CheckProblem {\n  const location = error.locations?.[0];\n  return {\n    file: doc.file,\n    // the first line of the text continues the source line of the opening quote\n    line: doc.line + (location?.line ?? 1),\n    column: location?.line === 1 ? doc.column + location.column : (location?.column ?? 1),\n    message: error.message,\n  };\n}\n\n/**\n * Validates every `graphql()` document of a project (fragments are resolved by name across\n * the project; a document that isn't a plain string can't be checked and is reported).\n */\nexport async function check(\n  options: { cwd?: string; schemaFile?: string; schema?: GraphQLSchema } = {},\n): Promise<CheckResult> {\n  const cwd = path.resolve(options.cwd || process.cwd());\n  const schemaFile = path.resolve(cwd, options.schemaFile || DEFAULT_SCHEMA_FILE);\n  const ts = await loadTypeScript();\n\n  const documents = sourceFiles(cwd).flatMap((file) => findDocuments(ts, file));\n  if (!documents.length) {\n    return { documents: 0, problems: [] };\n  }\n\n  if (!options.schema && !fs.existsSync(schemaFile)) {\n    throw new Error(\n      \"Missing \" + path.relative(cwd, schemaFile) + \": run `dynamite codegen` first.\",\n    );\n  }\n  const schema = options.schema || buildSchema(fs.readFileSync(schemaFile, \"utf8\"));\n  const problems: Array<CheckProblem> = [];\n  const parsed: Array<{ doc: FoundDocument; ast: DocumentNode }> = [];\n  const fragments = new Map<string, FragmentDefinitionNode>();\n  const fragmentOwners = new Map<string, FoundDocument>();\n\n  for (const doc of documents) {\n    if (!doc.text) {\n      problems.push({\n        file: doc.file,\n        line: doc.line + 1,\n        column: doc.column + 1,\n        message: \"graphql() needs a plain string document to be checked (no ${} interpolation).\",\n      });\n      continue;\n    }\n    try {\n      const ast = parse(doc.text);\n      parsed.push({ doc, ast });\n      for (const definition of ast.definitions) {\n        if (definition.kind !== Kind.FRAGMENT_DEFINITION) continue;\n        const name = definition.name.value;\n        if (fragmentOwners.has(name)) {\n          problems.push({\n            file: doc.file,\n            line: doc.line + (definition.loc?.startToken.line ?? 1),\n            column: 1,\n            message: `Duplicated fragment \"${name}\" (also in ${path.relative(cwd, fragmentOwners.get(name)!.file)}).`,\n          });\n        }\n        fragments.set(name, definition);\n        fragmentOwners.set(name, doc);\n      }\n    } catch (err) {\n      problems.push(problemOf(doc, err as GraphQLError));\n    }\n  }\n\n  // a document only holding fragments is valid on its own\n  const rules = specifiedRules.filter((rule) => rule !== NoUnusedFragmentsRule);\n\n  for (const { doc, ast } of parsed) {\n    const own = new Set(\n      ast.definitions.flatMap((d) => (d.kind === Kind.FRAGMENT_DEFINITION ? [d.name.value] : [])),\n    );\n    const imported = [...usedFragments(ast, fragments).entries()]\n      .filter(([name]) => !own.has(name))\n      .map(([, fragment]) => fragment);\n\n    const errors = validate(\n      schema,\n      { ...ast, definitions: [...ast.definitions, ...imported] },\n      rules,\n    );\n    for (const error of errors) {\n      // an error inside an imported fragment is reported once, by the document that owns it\n      if (imported.some((f) => error.nodes?.some((n) => isInside(n, f)))) continue;\n      problems.push(problemOf(doc, error));\n    }\n  }\n\n  problems.sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line || a.column - b.column);\n\n  return { documents: documents.length, problems };\n}\n\nfunction isInside(node: { loc?: { source: unknown } }, fragment: FragmentDefinitionNode): boolean {\n  return !!node.loc && node.loc.source === fragment.loc?.source;\n}\n"],"mappings":"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"}

package/dist/cli/check.d.cts

@@ -0,0 +1,21 @@
+import { GraphQLSchema } from "graphql";
+export interface CheckProblem {
+  file: string;
+  line: number;
+  column: number;
+  message: string;
+}
+export interface CheckResult {
+  documents: number;
+  problems: Array<CheckProblem>;
+}
+/**
+ * Validates every `graphql()` document of a project (fragments are resolved by name across
+ * the project; a document that isn't a plain string can't be checked and is reported).
+ */
+export declare function check(options?: {
+  cwd?: string;
+  schemaFile?: string;
+  schema?: GraphQLSchema;
+}): Promise<CheckResult>;
+//# sourceMappingURL=check.d.cts.map

package/dist/cli/check.d.ts

@@ -0,0 +1,21 @@
+import { GraphQLSchema } from "graphql";
+export interface CheckProblem {
+  file: string;
+  line: number;
+  column: number;
+  message: string;
+}
+export interface CheckResult {
+  documents: number;
+  problems: Array<CheckProblem>;
+}
+/**
+ * Validates every `graphql()` document of a project (fragments are resolved by name across
+ * the project; a document that isn't a plain string can't be checked and is reported).
+ */
+export declare function check(options?: {
+  cwd?: string;
+  schemaFile?: string;
+  schema?: GraphQLSchema;
+}): Promise<CheckResult>;
+//# sourceMappingURL=check.d.ts.map

package/dist/cli/check.js

@@ -0,0 +1,157 @@
+import "../shared/constants.js";
+import fs from "node:fs";
+import path from "node:path";
+import { Kind, NoUnusedFragmentsRule, buildSchema, parse, specifiedRules, validate, visit } from "graphql";
+// src/cli/check.ts
+const IGNORED_DIRS = /* @__PURE__ */ new Set([
+	"node_modules",
+	"build",
+	"dist",
+	".git",
+	".react-router",
+	".turbo",
+	".next",
+	".dynamite"
+]);
+function sourceFiles(dir, result = []) {
+	for (const entry of fs.readdirSync(dir, { withFileTypes: true })) if (entry.isDirectory()) {
+		if (!IGNORED_DIRS.has(entry.name)) sourceFiles(path.join(dir, entry.name), result);
+	} else if (/\.(ts|tsx|mts|cts)$/.test(entry.name) && !entry.name.endsWith(".d.ts")) result.push(path.join(dir, entry.name));
+	return result;
+}
+async function loadTypeScript() {
+	try {
+		const ts = await import("typescript");
+		return ts.default || ts;
+	} catch {
+		throw new Error("dynamite check needs the typescript package installed in the project.");
+	}
+}
+function findDocuments(ts, file) {
+	const source = ts.createSourceFile(file, fs.readFileSync(file, "utf8"), ts.ScriptTarget.Latest, true);
+	const result = [];
+	const visitNode = (node) => {
+		if (ts.isCallExpression(node) && ts.isIdentifier(node.expression) && node.expression.text === "graphql") {
+			const arg = node.arguments[0];
+			if (arg && (ts.isNoSubstitutionTemplateLiteral(arg) || ts.isStringLiteral(arg))) {
+				const start = source.getLineAndCharacterOfPosition(arg.getStart(source) + 1);
+				result.push({
+					file,
+					line: start.line,
+					column: start.character,
+					text: arg.text
+				});
+			} else if (arg) {
+				const start = source.getLineAndCharacterOfPosition(arg.getStart(source));
+				result.push({
+					file,
+					line: start.line,
+					column: start.character,
+					text: ""
+				});
+			}
+		}
+		ts.forEachChild(node, visitNode);
+	};
+	visitNode(source);
+	return result;
+}
+function usedFragments(root, all) {
+	const used = /* @__PURE__ */ new Map();
+	const collect = (node) => {
+		visit(node, { FragmentSpread(spread) {
+			const fragment = all.get(spread.name.value);
+			if (fragment && !used.has(spread.name.value)) {
+				used.set(spread.name.value, fragment);
+				collect(fragment);
+			}
+		} });
+	};
+	collect(root);
+	return used;
+}
+function problemOf(doc, error) {
+	const location = error.locations?.[0];
+	return {
+		file: doc.file,
+		line: doc.line + (location?.line ?? 1),
+		column: location?.line === 1 ? doc.column + location.column : location?.column ?? 1,
+		message: error.message
+	};
+}
+/**
+* Validates every `graphql()` document of a project (fragments are resolved by name across
+* the project; a document that isn't a plain string can't be checked and is reported).
+*/
+async function check(options = {}) {
+	const cwd = path.resolve(options.cwd || process.cwd());
+	const schemaFile = path.resolve(cwd, options.schemaFile || ".dynamite/schema.graphql");
+	const ts = await loadTypeScript();
+	const documents = sourceFiles(cwd).flatMap((file) => findDocuments(ts, file));
+	if (!documents.length) return {
+		documents: 0,
+		problems: []
+	};
+	if (!options.schema && !fs.existsSync(schemaFile)) throw new Error("Missing " + path.relative(cwd, schemaFile) + ": run `dynamite codegen` first.");
+	const schema = options.schema || buildSchema(fs.readFileSync(schemaFile, "utf8"));
+	const problems = [];
+	const parsed = [];
+	const fragments = /* @__PURE__ */ new Map();
+	const fragmentOwners = /* @__PURE__ */ new Map();
+	for (const doc of documents) {
+		if (!doc.text) {
+			problems.push({
+				file: doc.file,
+				line: doc.line + 1,
+				column: doc.column + 1,
+				message: "graphql() needs a plain string document to be checked (no ${} interpolation)."
+			});
+			continue;
+		}
+		try {
+			const ast = parse(doc.text);
+			parsed.push({
+				doc,
+				ast
+			});
+			for (const definition of ast.definitions) {
+				if (definition.kind !== Kind.FRAGMENT_DEFINITION) continue;
+				const name = definition.name.value;
+				if (fragmentOwners.has(name)) problems.push({
+					file: doc.file,
+					line: doc.line + (definition.loc?.startToken.line ?? 1),
+					column: 1,
+					message: `Duplicated fragment "${name}" (also in ${path.relative(cwd, fragmentOwners.get(name).file)}).`
+				});
+				fragments.set(name, definition);
+				fragmentOwners.set(name, doc);
+			}
+		} catch (err) {
+			problems.push(problemOf(doc, err));
+		}
+	}
+	const rules = specifiedRules.filter((rule) => rule !== NoUnusedFragmentsRule);
+	for (const { doc, ast } of parsed) {
+		const own = new Set(ast.definitions.flatMap((d) => d.kind === Kind.FRAGMENT_DEFINITION ? [d.name.value] : []));
+		const imported = [...usedFragments(ast, fragments).entries()].filter(([name]) => !own.has(name)).map(([, fragment]) => fragment);
+		const errors = validate(schema, {
+			...ast,
+			definitions: [...ast.definitions, ...imported]
+		}, rules);
+		for (const error of errors) {
+			if (imported.some((f) => error.nodes?.some((n) => isInside(n, f)))) continue;
+			problems.push(problemOf(doc, error));
+		}
+	}
+	problems.sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line || a.column - b.column);
+	return {
+		documents: documents.length,
+		problems
+	};
+}
+function isInside(node, fragment) {
+	return !!node.loc && node.loc.source === fragment.loc?.source;
+}
+export { check };
+
+//# sourceMappingURL=check.js.map

package/dist/cli/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","names":[],"sources":["../../src/cli/check.ts"],"sourcesContent":["// `dynamite check`: validates the graphql() documents of a project against the codegen schema.\n//\n// Why not gql.tada's `gql-tada check`: it isn't a dependency (@gql.tada/cli-utils), and it finds the schema in a\n// tsconfig plugin entry named after gql.tada/graphqlsp, while the projects here use pocketbomb-dynamite/ts-plugin.\n// The check itself is small: the TypeScript parser finds the documents and graphql-js validates them.\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport {\n  buildSchema,\n  GraphQLError,\n  Kind,\n  NoUnusedFragmentsRule,\n  parse,\n  specifiedRules,\n  validate,\n  visit,\n  type DocumentNode,\n  type FragmentDefinitionNode,\n  type GraphQLSchema,\n} from \"graphql\";\nimport { DEFAULT_SCHEMA_FILE } from \"./codegen\";\n\nconst IGNORED_DIRS = new Set([\n  \"node_modules\",\n  \"build\",\n  \"dist\",\n  \".git\",\n  \".react-router\",\n  \".turbo\",\n  \".next\",\n  \".dynamite\",\n]);\n\nexport interface CheckProblem {\n  file: string;\n  line: number;\n  column: number;\n  message: string;\n}\n\nexport interface CheckResult {\n  documents: number;\n  problems: Array<CheckProblem>;\n}\n\ninterface FoundDocument {\n  file: string;\n  /** The zero based position of the document text start in its file. */\n  line: number;\n  column: number;\n  text: string;\n}\n\nfunction sourceFiles(dir: string, result: Array<string> = []): Array<string> {\n  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {\n    if (entry.isDirectory()) {\n      if (!IGNORED_DIRS.has(entry.name)) sourceFiles(path.join(dir, entry.name), result);\n    } else if (/\\.(ts|tsx|mts|cts)$/.test(entry.name) && !entry.name.endsWith(\".d.ts\")) {\n      result.push(path.join(dir, entry.name));\n    }\n  }\n  return result;\n}\n\nasync function loadTypeScript(): Promise<typeof import(\"typescript\")> {\n  try {\n    const ts: any = await import(\"typescript\");\n    return ts.default || ts;\n  } catch {\n    throw new Error(\"dynamite check needs the typescript package installed in the project.\");\n  }\n}\n\nfunction findDocuments(ts: typeof import(\"typescript\"), file: string): Array<FoundDocument> {\n  const source = ts.createSourceFile(\n    file,\n    fs.readFileSync(file, \"utf8\"),\n    ts.ScriptTarget.Latest,\n    true,\n  );\n  const result: Array<FoundDocument> = [];\n\n  const visitNode = (node: import(\"typescript\").Node) => {\n    if (\n      ts.isCallExpression(node) &&\n      ts.isIdentifier(node.expression) &&\n      node.expression.text === \"graphql\"\n    ) {\n      const arg = node.arguments[0];\n      if (arg && (ts.isNoSubstitutionTemplateLiteral(arg) || ts.isStringLiteral(arg))) {\n        // +1: the opening quote\n        const start = source.getLineAndCharacterOfPosition(arg.getStart(source) + 1);\n        result.push({ file, line: start.line, column: start.character, text: arg.text });\n      } else if (arg) {\n        const start = source.getLineAndCharacterOfPosition(arg.getStart(source));\n        result.push({ file, line: start.line, column: start.character, text: \"\" });\n      }\n    }\n    ts.forEachChild(node, visitNode);\n  };\n  visitNode(source);\n\n  return result;\n}\n\nfunction usedFragments(root: DocumentNode, all: Map<string, FragmentDefinitionNode>) {\n  const used = new Map<string, FragmentDefinitionNode>();\n  const collect = (node: DocumentNode | FragmentDefinitionNode) => {\n    visit(node, {\n      FragmentSpread(spread) {\n        const fragment = all.get(spread.name.value);\n        if (fragment && !used.has(spread.name.value)) {\n          used.set(spread.name.value, fragment);\n          collect(fragment);\n        }\n      },\n    });\n  };\n  collect(root);\n  return used;\n}\n\nfunction problemOf(doc: FoundDocument, error: GraphQLError): CheckProblem {\n  const location = error.locations?.[0];\n  return {\n    file: doc.file,\n    // the first line of the text continues the source line of the opening quote\n    line: doc.line + (location?.line ?? 1),\n    column: location?.line === 1 ? doc.column + location.column : (location?.column ?? 1),\n    message: error.message,\n  };\n}\n\n/**\n * Validates every `graphql()` document of a project (fragments are resolved by name across\n * the project; a document that isn't a plain string can't be checked and is reported).\n */\nexport async function check(\n  options: { cwd?: string; schemaFile?: string; schema?: GraphQLSchema } = {},\n): Promise<CheckResult> {\n  const cwd = path.resolve(options.cwd || process.cwd());\n  const schemaFile = path.resolve(cwd, options.schemaFile || DEFAULT_SCHEMA_FILE);\n  const ts = await loadTypeScript();\n\n  const documents = sourceFiles(cwd).flatMap((file) => findDocuments(ts, file));\n  if (!documents.length) {\n    return { documents: 0, problems: [] };\n  }\n\n  if (!options.schema && !fs.existsSync(schemaFile)) {\n    throw new Error(\n      \"Missing \" + path.relative(cwd, schemaFile) + \": run `dynamite codegen` first.\",\n    );\n  }\n  const schema = options.schema || buildSchema(fs.readFileSync(schemaFile, \"utf8\"));\n  const problems: Array<CheckProblem> = [];\n  const parsed: Array<{ doc: FoundDocument; ast: DocumentNode }> = [];\n  const fragments = new Map<string, FragmentDefinitionNode>();\n  const fragmentOwners = new Map<string, FoundDocument>();\n\n  for (const doc of documents) {\n    if (!doc.text) {\n      problems.push({\n        file: doc.file,\n        line: doc.line + 1,\n        column: doc.column + 1,\n        message: \"graphql() needs a plain string document to be checked (no ${} interpolation).\",\n      });\n      continue;\n    }\n    try {\n      const ast = parse(doc.text);\n      parsed.push({ doc, ast });\n      for (const definition of ast.definitions) {\n        if (definition.kind !== Kind.FRAGMENT_DEFINITION) continue;\n        const name = definition.name.value;\n        if (fragmentOwners.has(name)) {\n          problems.push({\n            file: doc.file,\n            line: doc.line + (definition.loc?.startToken.line ?? 1),\n            column: 1,\n            message: `Duplicated fragment \"${name}\" (also in ${path.relative(cwd, fragmentOwners.get(name)!.file)}).`,\n          });\n        }\n        fragments.set(name, definition);\n        fragmentOwners.set(name, doc);\n      }\n    } catch (err) {\n      problems.push(problemOf(doc, err as GraphQLError));\n    }\n  }\n\n  // a document only holding fragments is valid on its own\n  const rules = specifiedRules.filter((rule) => rule !== NoUnusedFragmentsRule);\n\n  for (const { doc, ast } of parsed) {\n    const own = new Set(\n      ast.definitions.flatMap((d) => (d.kind === Kind.FRAGMENT_DEFINITION ? [d.name.value] : [])),\n    );\n    const imported = [...usedFragments(ast, fragments).entries()]\n      .filter(([name]) => !own.has(name))\n      .map(([, fragment]) => fragment);\n\n    const errors = validate(\n      schema,\n      { ...ast, definitions: [...ast.definitions, ...imported] },\n      rules,\n    );\n    for (const error of errors) {\n      // an error inside an imported fragment is reported once, by the document that owns it\n      if (imported.some((f) => error.nodes?.some((n) => isInside(n, f)))) continue;\n      problems.push(problemOf(doc, error));\n    }\n  }\n\n  problems.sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line || a.column - b.column);\n\n  return { documents: documents.length, problems };\n}\n\nfunction isInside(node: { loc?: { source: unknown } }, fragment: FragmentDefinitionNode): boolean {\n  return !!node.loc && node.loc.source === fragment.loc?.source;\n}\n"],"mappings":"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"}

package/dist/cli/codegen.cjs

@@ -0,0 +1,121 @@
+const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
+const require_constants = require("../shared/constants.cjs");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let _gql_tada_internal = require("@gql.tada/internal");
+let graphql = require("graphql");
+// src/cli/codegen.ts
+/**
+* Introspects the PocketBomb GraphQL API (`POST /api/graphql`; the introspection
+* fields are not counted in the query limits).
+*
+* @throws {Error} for the HTTP and GraphQL errors.
+*/
+async function introspect(options) {
+	const headers = { "content-type": "application/json" };
+	if (options.publicKey) headers["X-PB-Public-Key"] = options.publicKey;
+	const endpoint = options.url.replace(/\/+$/, "") + "/api/graphql";
+	const response = await (options.fetch || fetch)(endpoint, {
+		method: "POST",
+		headers,
+		body: JSON.stringify({ query: (0, graphql.getIntrospectionQuery)({ descriptions: true }) })
+	});
+	let body = null;
+	try {
+		body = await response.json();
+	} catch {
+		body = null;
+	}
+	if (!response.ok) throw new Error(`The GraphQL introspection failed (${response.status}): ${body?.message || JSON.stringify(body)}`);
+	if (body?.errors?.length || !body?.data?.__schema) throw new Error("The GraphQL introspection failed: " + (body?.errors?.map((e) => e.message).join("; ") || "no schema"));
+	return body.data;
+}
+/**
+* Returns a copy of the introspection without the empty descriptions
+* (the server reports "" for the undocumented fields).
+*/
+function withoutEmptyDescriptions(value) {
+	if (Array.isArray(value)) return value.map(withoutEmptyDescriptions);
+	if (value && typeof value === "object") {
+		const result = {};
+		for (const [key, item] of Object.entries(value)) result[key] = key === "description" && item === "" ? null : withoutEmptyDescriptions(item);
+		return result;
+	}
+	return value;
+}
+/**
+* Returns the GraphQL SDL of an introspection.
+*/
+function introspectionToSDL(introspection) {
+	const schema = (0, graphql.buildClientSchema)(withoutEmptyDescriptions(introspection));
+	return (0, graphql.printSchema)((0, graphql.lexicographicSortSchema)(schema)) + "\n";
+}
+/**
+* Returns the `pocketbomb-env.d.ts` of an introspection: the gql.tada introspection type
+* and the `pocketbomb-dynamite/graphql` schema augmentation used by `graphql()`.
+*/
+function introspectionToEnv(introspection) {
+	return "/* eslint-disable */\n/* prettier-ignore */\n// Generated by `dynamite codegen` from the PocketBomb GraphQL API. Do not edit.\n\n/** The gql.tada introspection of the PocketBomb GraphQL schema. */\nexport type introspection = " + (0, _gql_tada_internal.preprocessIntrospection)((0, _gql_tada_internal.minifyIntrospection)(introspection)) + ";\n\ndeclare module \"pocketbomb-dynamite/graphql\" {\n  interface PocketBombSchema {\n    introspection: introspection;\n  }\n}\n";
+}
+function writeIfChanged(file, content) {
+	if (node_fs.default.existsSync(file) && node_fs.default.readFileSync(file, "utf8") === content) return false;
+	node_fs.default.mkdirSync(node_path.default.dirname(file), { recursive: true });
+	node_fs.default.writeFileSync(file, content);
+	return true;
+}
+/**
+* Writes the schema SDL and the gql.tada env of an introspection (only if they changed).
+*/
+function generate(introspection, options = {}) {
+	const cwd = options.cwd || process.cwd();
+	const schemaFile = node_path.default.resolve(cwd, options.schemaFile || ".dynamite/schema.graphql");
+	const envFile = node_path.default.resolve(cwd, options.envFile || "pocketbomb-env.d.ts");
+	const schemaChanged = writeIfChanged(schemaFile, introspectionToSDL(introspection));
+	const envChanged = writeIfChanged(envFile, introspectionToEnv(introspection));
+	return {
+		schemaFile,
+		envFile,
+		changed: schemaChanged || envChanged
+	};
+}
+/**
+* Introspects the API and writes the schema and the env (see {@link generate}).
+*/
+async function codegen(options) {
+	return generate(await introspect(options), options);
+}
+/**
+* Regenerates the schema and the env when the API schema changes (polling).
+* Returns a function that stops the watcher.
+*/
+function watchCodegen(options) {
+	let stopped = false;
+	let timer;
+	const tick = async () => {
+		try {
+			const result = await codegen(options);
+			if (result.changed) options.onChange?.(result);
+		} catch (err) {
+			options.onError?.(err);
+		}
+		if (!stopped) timer = setTimeout(tick, options.interval ?? 2e3);
+	};
+	tick();
+	return () => {
+		stopped = true;
+		clearTimeout(timer);
+	};
+}
+exports.DEFAULT_ENV_FILE = require_constants.DEFAULT_ENV_FILE;
+exports.DEFAULT_SCHEMA_FILE = require_constants.DEFAULT_SCHEMA_FILE;
+exports.codegen = codegen;
+exports.generate = generate;
+exports.introspect = introspect;
+exports.introspectionToEnv = introspectionToEnv;
+exports.introspectionToSDL = introspectionToSDL;
+exports.watchCodegen = watchCodegen;
+exports.withoutEmptyDescriptions = withoutEmptyDescriptions;
+
+//# sourceMappingURL=codegen.cjs.map