@toolproof-core/schema 1.0.2 → 1.0.4

package/src/scripts/generateDependencies.ts

@@ -1,120 +1,121 @@
-import fs from "fs";
-import path from "path";
-import { getConfig } from "./_lib/config.js";
-
-type JSONValue = null | boolean | number | string | JSONValue[] | { [k: string]: JSONValue };
-
-function decodeJsonPointerSegment(segment: string): string {
-  // JSON Pointer decoding: ~1 => / and ~0 => ~
-  return segment.replace(/~1/g, "/").replace(/~0/g, "~");
-}
-
-function collectRefs(node: unknown, out: Set<string>): void {
-  if (Array.isArray(node)) {
-    for (const item of node) collectRefs(item, out);
-    return;
-  }
-  if (!node || typeof node !== "object") return;
-
-  const obj = node as Record<string, unknown>;
-  const ref = obj["$ref"];
-  if (typeof ref === "string") out.add(ref);
-
-  for (const value of Object.values(obj)) {
-    collectRefs(value, out);
-  }
-}
-
-function resolveInternalRefToDefKey(ref: string, defKeys: Set<string>, anchorToDef: Record<string, string>): string | null {
-  if (!ref.startsWith("#")) return null;
-
-  // JSON Pointer: #/$defs/<Name>(/...)
-  const defsPrefix = "#/$defs/";
-  if (ref.startsWith(defsPrefix)) {
-    const rest = ref.slice(defsPrefix.length);
-    const firstSegment = rest.split("/")[0] ?? "";
-    const defKey = decodeJsonPointerSegment(firstSegment);
-    return defKeys.has(defKey) ? defKey : null;
-  }
-
-  // Anchor ref: #AnchorName
-  if (!ref.startsWith("#/")) {
-    const anchor = ref.slice(1);
-    const mapped = anchorToDef[anchor];
-    if (mapped && defKeys.has(mapped)) return mapped;
-    if (defKeys.has(anchor)) return anchor;
-  }
-
-  return null;
-}
-
-/**
- * Pure function that generates a dependency map from a JSON Schema document.
- * 
- * @param doc The source JSON Schema document
- * @returns A record mapping definition names to their dependency lists
- */
-function generateDependencyMapLogic(doc: any): Record<string, string[]> {
-  const defs: Record<string, JSONValue> = doc?.$defs && typeof doc.$defs === "object" ? doc.$defs : {};
-  const defKeys = new Set(Object.keys(defs));
-
-  // Map anchors to $defs keys (useful if any anchor-style refs remain)
-  const anchorToDef: Record<string, string> = {};
-  for (const [defKey, defSchema] of Object.entries(defs)) {
-    if (!defSchema || typeof defSchema !== "object" || Array.isArray(defSchema)) continue;
-    const anchor = (defSchema as any).$anchor;
-    if (typeof anchor === "string" && !(anchor in anchorToDef)) {
-      anchorToDef[anchor] = defKey;
-    }
-  }
-
-  const dependencyMap: Record<string, string[]> = {};
-
-  for (const [defKey, defSchema] of Object.entries(defs)) {
-    const refs = new Set<string>();
-    collectRefs(defSchema, refs);
-
-    const deps = new Set<string>();
-    for (const ref of refs) {
-      const depKey = resolveInternalRefToDefKey(ref, defKeys, anchorToDef);
-      if (!depKey) continue;
-      if (depKey === defKey) continue;
-      deps.add(depKey);
-    }
-
-    dependencyMap[defKey] = Array.from(deps);
-  }
-
-  return dependencyMap;
-}
-
-async function main() {
-  const config = getConfig();
-
-  const inPath = config.getSchemaPath("Genesis.json");
-  const outPath = config.getDependencyMapPath();
-
-  if (!fs.existsSync(inPath)) {
-    console.error(`Genesis schema not found at ${inPath}. Run extractSchemasFromResourceTypeShells first.`);
-    process.exit(1);
-  }
-
-  try {
-    const raw = fs.readFileSync(inPath, "utf8");
-    const doc = JSON.parse(raw);
-
-    const dependencyMap = generateDependencyMapLogic(doc);
-
-    fs.mkdirSync(path.dirname(outPath), { recursive: true });
-    fs.writeFileSync(outPath, JSON.stringify(dependencyMap, null, 4), "utf8");
-    console.log(`Wrote dependency map to ${outPath}`);
-  } catch (error: any) {
-    console.error(`Error generating dependency map: ${error.message}`);
-    process.exit(1);
-  }
-}
-
-main().catch((e) => {
-  console.error(e);
-  process.exit(1);
-});
+import fs from "fs";
+import path from "path";
+import { getConfig } from "./_lib/config.js";
+
+type JSONValue = null | boolean | number | string | JSONValue[] | { [k: string]: JSONValue };
+
+// PURE: Decode a single JSON Pointer segment.
+function decodeJsonPointerSegment(segment: string): string {
+  // JSON Pointer decoding: ~1 => / and ~0 => ~
+  return segment.replace(/~1/g, "/").replace(/~0/g, "~");
+}
+
+// PURE: Collect all `$ref` strings from a JSON-ish tree.
+function collectRefs(node: unknown, out: Set<string>): void {
+  if (Array.isArray(node)) {
+    for (const item of node) collectRefs(item, out);
+    return;
+  }
+  if (!node || typeof node !== "object") return;
+
+  const obj = node as Record<string, unknown>;
+  const ref = obj["$ref"];
+  if (typeof ref === "string") out.add(ref);
+
+  for (const value of Object.values(obj)) {
+    collectRefs(value, out);
+  }
+}
+
+// PURE: Resolve an internal ref (pointer or anchor) to a root $defs key, if possible.
+function resolveInternalRefToDefKey(ref: string, defKeys: Set<string>, anchorToDef: Record<string, string>): string | null {
+  if (!ref.startsWith("#")) return null;
+
+  // JSON Pointer: #/$defs/<Name>(/...)
+  const defsPrefix = "#/$defs/";
+  if (ref.startsWith(defsPrefix)) {
+    const rest = ref.slice(defsPrefix.length);
+    const firstSegment = rest.split("/")[0] ?? "";
+    const defKey = decodeJsonPointerSegment(firstSegment);
+    return defKeys.has(defKey) ? defKey : null;
+  }
+
+  // Anchor ref: #AnchorName
+  if (!ref.startsWith("#/")) {
+    const anchor = ref.slice(1);
+    const mapped = anchorToDef[anchor];
+    if (mapped && defKeys.has(mapped)) return mapped;
+    if (defKeys.has(anchor)) return anchor;
+  }
+
+  return null;
+}
+
+/**
+ * Pure function that generates a dependency map from a JSON Schema document.
+ * 
+ * @param doc The source JSON Schema document
+ * @returns A record mapping definition names to their dependency lists
+ */
+// PURE: Generate a $defs dependency map from a JSON Schema document (no I/O).
+function generateDependencyMapLogic(doc: any): Record<string, string[]> {
+  const defs: Record<string, JSONValue> = doc?.$defs && typeof doc.$defs === "object" ? doc.$defs : {};
+  const defKeys = new Set(Object.keys(defs));
+
+  // Map anchors to $defs keys (useful if any anchor-style refs remain)
+  const anchorToDef: Record<string, string> = {};
+  for (const [defKey, defSchema] of Object.entries(defs)) {
+    if (!defSchema || typeof defSchema !== "object" || Array.isArray(defSchema)) continue;
+    const anchor = (defSchema as any).$anchor;
+    if (typeof anchor === "string" && !(anchor in anchorToDef)) {
+      anchorToDef[anchor] = defKey;
+    }
+  }
+
+  const dependencyMap: Record<string, string[]> = {};
+
+  for (const [defKey, defSchema] of Object.entries(defs)) {
+    const refs = new Set<string>();
+    collectRefs(defSchema, refs);
+
+    const deps = new Set<string>();
+    for (const ref of refs) {
+      const depKey = resolveInternalRefToDefKey(ref, defKeys, anchorToDef);
+      if (!depKey) continue;
+      if (depKey === defKey) continue;
+      deps.add(depKey);
+    }
+
+    dependencyMap[defKey] = Array.from(deps);
+  }
+
+  return dependencyMap;
+}
+
+// IMPURE: Script entrypoint (config + filesystem I/O + console + process exit code).
+function main() {
+  try {
+    const config = getConfig();
+
+    const inPath = config.getSchemaPath("Genesis.json");
+    const outPath = config.getDependencyMapPath();
+
+    if (!fs.existsSync(inPath)) {
+      throw new Error(`Genesis schema not found at ${inPath}. Run extractSchemasFromResourceTypeShells first.`);
+    }
+
+    const raw = fs.readFileSync(inPath, "utf8");
+    const doc = JSON.parse(raw);
+
+    const dependencyMap = generateDependencyMapLogic(doc);
+
+    fs.mkdirSync(path.dirname(outPath), { recursive: true });
+    fs.writeFileSync(outPath, JSON.stringify(dependencyMap, null, 4), "utf8");
+    console.log(`Wrote dependency map to ${outPath}`);
+  } catch (error: any) {
+    console.error(`Error generating dependency map: ${error?.message ?? error}`);
+    process.exitCode = 1;
+  }
+}
+
+main();

package/src/scripts/generateSchemaShims.ts

@@ -1,135 +1,127 @@
-import fs from 'fs';
-import path from 'path';
-import { getConfig } from './_lib/config.js';
-
-/**
- * Generate TypeScript shim files for all JSON schemas and resources
- * 
- * Creates .ts files that import and re-export .json files using
- * the JSON import assertion syntax. This enables proper dependency resolution
- * and type inference when importing schemas in TypeScript.
- * 
- * Generates shims for:
- * - schemas dir: config.getSchemasDir() (schema files)
- * - standalone schemas dir: config.getSchemasStandaloneDir() (standalone schema files)
- * - resources dir: config.getResourcesDir() (resource envelope files)
- * 
- * Usage: node ./dist/scripts/generateSchemaShims.js
- */
-/**
- * Pure function to generate the content of a TypeScript shim file.
- * 
- * @param jsonFile The name of the JSON file to import
- * @param variableName The name of the variable to use for the import
- * @returns The TypeScript file content
- */
-function generateShimContent(jsonFile: string, variableName: string): string {
-    return `import ${variableName} from './${jsonFile}' with { type: 'json' };\nexport default ${variableName};\n`;
-}
-
-/**
- * Pure function to map a list of JSON files to their corresponding TypeScript shim files and contents.
- * 
- * @param jsonFiles List of JSON filenames
- * @param variableName The variable name to use in the shim
- * @returns A record mapping TS filenames to their contents
- */
-function getShimsForFiles(jsonFiles: string[], variableName: string): Record<string, string> {
-    const shims: Record<string, string> = {};
-    for (const jsonFile of jsonFiles) {
-        const baseName = path.basename(jsonFile, '.json');
-        const tsFile = `${baseName}.ts`;
-        shims[tsFile] = generateShimContent(jsonFile, variableName);
-    }
-    return shims;
-}
-
-async function main() {
-    const config = getConfig();
-    const schemasDir = config.getSchemasDir();
-    const standaloneSchemasDir = config.getSchemasStandaloneDir();
-    const resourcesDir = config.getResourcesDir();
-    const generatedResourceTypesDir = config.getNormalizedDir();
-
-    let totalCount = 0;
-
-    // Process schemas directory
-    if (fs.existsSync(schemasDir)) {
-        const files = fs.readdirSync(schemasDir);
-        const jsonFiles = files.filter(f => f.endsWith('.json') && !f.startsWith('.'));
-
-        const shims = getShimsForFiles(jsonFiles, 'schema');
-
-        for (const [tsFile, content] of Object.entries(shims)) {
-            const tsPath = path.join(schemasDir, tsFile);
-            fs.writeFileSync(tsPath, content, 'utf-8');
-            console.log(`Generated ${tsFile} in ${schemasDir}`);
-            totalCount++;
-        }
-        console.log(`Generated ${jsonFiles.length} TypeScript schema shims in ${schemasDir}`);
-    } else {
-        console.warn(`Schemas directory not found at ${schemasDir}`);
-    }
-
-    // Process standalone schemas directory
-    if (fs.existsSync(standaloneSchemasDir)) {
-        const files = fs.readdirSync(standaloneSchemasDir);
-        const jsonFiles = files.filter(f => f.endsWith('.json') && !f.startsWith('.'));
-
-        const shims = getShimsForFiles(jsonFiles, 'schema');
-
-        for (const [tsFile, content] of Object.entries(shims)) {
-            const tsPath = path.join(standaloneSchemasDir, tsFile);
-            fs.writeFileSync(tsPath, content, 'utf-8');
-            console.log(`Generated ${tsFile} in ${standaloneSchemasDir}`);
-            totalCount++;
-        }
-        console.log(`Generated ${jsonFiles.length} TypeScript standalone schema shims in ${standaloneSchemasDir}`);
-    } else {
-        // Standalone schemas are optional
-    }
-
-    // Process resources directory
-    if (fs.existsSync(resourcesDir)) {
-        const files = fs.readdirSync(resourcesDir);
-        const jsonFiles = files.filter(f => f.endsWith('.json') && !f.startsWith('.'));
-
-        const shims = getShimsForFiles(jsonFiles, 'resources');
-
-        for (const [tsFile, content] of Object.entries(shims)) {
-            const tsPath = path.join(resourcesDir, tsFile);
-            fs.writeFileSync(tsPath, content, 'utf-8');
-            console.log(`Generated ${tsFile} in ${resourcesDir}`);
-            totalCount++;
-        }
-        console.log(`Generated ${jsonFiles.length} TypeScript resource shims in ${resourcesDir}`);
-    } else {
-        console.warn(`Resources directory not found at ${resourcesDir}`);
-    }
-
-    // Genesis (normalized) shim
-    try {
-        const genesisJsonPath = config.getNormalizedSourcePath();
-        if (fs.existsSync(genesisJsonPath)) {
-            fs.mkdirSync(generatedResourceTypesDir, { recursive: true });
-            const tsFile = 'Genesis.ts';
-            const content = generateShimContent('Genesis.json', 'schema');
-            const tsPath = path.join(generatedResourceTypesDir, tsFile);
-
-            fs.writeFileSync(tsPath, content, 'utf-8');
-            console.log(`Generated ${tsFile} in ${generatedResourceTypesDir}`);
-            totalCount++;
-        } else {
-            console.warn(`Genesis source JSON not found at ${genesisJsonPath}; skipping Genesis.ts shim`);
-        }
-    } catch (e) {
-        console.warn('Failed to generate Genesis.ts shim:', e);
-    }
-
-    console.log(`Generated ${totalCount} total TypeScript shims`);
-}
-
-main().catch((e) => {
-    console.error(e);
-    process.exit(1);
-});
+import fs from 'fs';
+import path from 'path';
+import { getConfig } from './_lib/config.js';
+
+/**
+ * Generate TypeScript shim files for all JSON schemas and resources
+ * 
+ * Creates .ts files that import and re-export .json files using
+ * the JSON import assertion syntax. This enables proper dependency resolution
+ * and type inference when importing schemas in TypeScript.
+ * 
+ * Generates shims for:
+ * - schemas dir: config.getSchemasDir() (schema files)
+ * - standalone schemas dir: config.getSchemasStandaloneDir() (standalone schema files)
+ * - resources dir: config.getResourcesDir() (resource envelope files)
+ * 
+ * Usage: node ./dist/scripts/generateSchemaShims.js
+ */
+
+// PURE: Generate the .ts shim module content for a given .json filename.
+function generateShimContent(jsonFile: string, variableName: string): string {
+    return `import ${variableName} from './${jsonFile}' with { type: 'json' };\nexport default ${variableName};\n`;
+}
+
+// PURE: Map JSON filenames to deterministic shim file contents.
+function getShimsForFiles(jsonFiles: string[], variableName: string): Record<string, string> {
+    const shims: Record<string, string> = {};
+    for (const jsonFile of jsonFiles) {
+        const baseName = path.basename(jsonFile, '.json');
+        const tsFile = `${baseName}.ts`;
+        shims[tsFile] = generateShimContent(jsonFile, variableName);
+    }
+    return shims;
+}
+
+// IMPURE: Script entrypoint (config + filesystem I/O + console + process exit code).
+function main() {
+    try {
+        const config = getConfig();
+        const schemasDir = config.getSchemasDir();
+        const standaloneSchemasDir = config.getSchemasStandaloneDir();
+        const resourcesDir = config.getResourcesDir();
+        const generatedResourceTypesDir = config.getNormalizedDir();
+
+        let totalCount = 0;
+
+        // Process schemas directory
+        if (fs.existsSync(schemasDir)) {
+            const files = fs.readdirSync(schemasDir);
+            const jsonFiles = files.filter((f) => f.endsWith('.json') && !f.startsWith('.'));
+
+            const shims = getShimsForFiles(jsonFiles, 'schema');
+
+            for (const [tsFile, content] of Object.entries(shims)) {
+                const tsPath = path.join(schemasDir, tsFile);
+                fs.writeFileSync(tsPath, content, 'utf-8');
+                console.log('Generated ' + tsFile + ' in ' + schemasDir);
+                totalCount++;
+            }
+            console.log('Generated ' + jsonFiles.length + ' TypeScript schema shims in ' + schemasDir);
+        } else {
+            console.warn('Schemas directory not found at ' + schemasDir);
+        }
+
+        // Process standalone schemas directory
+        if (fs.existsSync(standaloneSchemasDir)) {
+            const files = fs.readdirSync(standaloneSchemasDir);
+            const jsonFiles = files.filter((f) => f.endsWith('.json') && !f.startsWith('.'));
+
+            const shims = getShimsForFiles(jsonFiles, 'schema');
+
+            for (const [tsFile, content] of Object.entries(shims)) {
+                const tsPath = path.join(standaloneSchemasDir, tsFile);
+                fs.writeFileSync(tsPath, content, 'utf-8');
+                console.log('Generated ' + tsFile + ' in ' + standaloneSchemasDir);
+                totalCount++;
+            }
+            console.log('Generated ' + jsonFiles.length + ' TypeScript standalone schema shims in ' + standaloneSchemasDir);
+        } else {
+            // Standalone schemas are optional
+        }
+
+        // Process resources directory
+        if (fs.existsSync(resourcesDir)) {
+            const files = fs.readdirSync(resourcesDir);
+            const jsonFiles = files.filter((f) => f.endsWith('.json') && !f.startsWith('.'));
+
+            const shims = getShimsForFiles(jsonFiles, 'resources');
+
+            for (const [tsFile, content] of Object.entries(shims)) {
+                const tsPath = path.join(resourcesDir, tsFile);
+                fs.writeFileSync(tsPath, content, 'utf-8');
+                console.log('Generated ' + tsFile + ' in ' + resourcesDir);
+                totalCount++;
+            }
+            console.log('Generated ' + jsonFiles.length + ' TypeScript resource shims in ' + resourcesDir);
+        } else {
+            console.warn('Resources directory not found at ' + resourcesDir);
+        }
+
+        // Genesis (normalized) shim
+        try {
+            const genesisJsonPath = config.getNormalizedSourcePath();
+            if (fs.existsSync(genesisJsonPath)) {
+                fs.mkdirSync(generatedResourceTypesDir, { recursive: true });
+                const tsFile = 'Genesis.ts';
+                const content = generateShimContent('Genesis.json', 'schema');
+                const tsPath = path.join(generatedResourceTypesDir, tsFile);
+
+                fs.writeFileSync(tsPath, content, 'utf-8');
+                console.log('Generated ' + tsFile + ' in ' + generatedResourceTypesDir);
+                totalCount++;
+            } else {
+                console.warn('Genesis source JSON not found at ' + genesisJsonPath + '; skipping Genesis.ts shim');
+            }
+        } catch (e) {
+            console.warn('Failed to generate Genesis.ts shim:', e);
+        }
+
+        console.log('Generated ' + totalCount + ' total TypeScript shims');
+    } catch (e) {
+        console.error(e);
+        process.exitCode = 1;
+    }
+}
+
+main();