@toolproof-core/schema 1.0.9 → 1.0.11

package/src/scripts/generateStandaloneType.ts

@@ -1,127 +1,129 @@
-import fs from "fs";
-import { getConfig } from "./_lib/config.js";
-
-/**
- * Generate a typed Resource variant where `nucleus` is typed to a specific schema
- * extracted under the configured output directory.
- *
- * Usage: node ./dist/scripts/generateStandaloneTypes.js --name Job
- */
-
-// PURE: Generate the content of a standalone Resource type definition file for a given schema name.
-function generateStandaloneTypeLogic(name: string): string {
-    const header = "// Auto-generated strict composite type. Do not edit.\n";
-    const ts =
-        `import type { ShellMaterializedBase, ${name} as NucleusSchema } from "../types.js";\n` +
-        `export type Resource_${name} = ShellMaterializedBase & { nucleus: NucleusSchema };\n`;
-    return header + ts;
-}
-
-// PURE: Strip accidental surrounding quotes from CLI values (PowerShell/cmd).
-function stripSurroundingQuotes(value: string): string {
-    if ((value.startsWith("\"") && value.endsWith("\"")) || (value.startsWith("'") && value.endsWith("'"))) {
-        return value.slice(1, -1);
-    }
-    return value;
-}
-
-// PURE: Validate a standalone schema and return warnings (no logging).
-function validateStandaloneSchemaForWarnings(schema: any): string[] {
-    const warnings: string[] = [];
-    if (schema?.$schema && schema.$schema !== "https://json-schema.org/draft/2020-12/schema") {
-        warnings.push(
-            `Warning: schema $schema is '${String(schema.$schema)}', expected draft 2020-12. Proceeding anyway.`
-        );
-    }
-    if (schema?.type && schema.type !== "object") {
-        warnings.push(
-            `Warning: nucleusSchema usually has type: 'object' but this schema has type: '${String(schema.type)}'. Proceeding.`
-        );
-    }
-    return warnings;
-}
-
-// PURE: Parse CLI args (no defaults, no filesystem probing).
-function parseArgs(args: string[]): { name?: string } {
-    let name: string | undefined;
-    for (let i = 0; i < args.length; i++) {
-        const a = args[i];
-        if (a === "--name") {
-            name = args[i + 1];
-            i++;
-        } else if (a.startsWith("--name=")) {
-            name = a.split("=")[1];
-        }
-    }
-    const normalized = typeof name === "string" ? stripSurroundingQuotes(name) : undefined;
-    return { name: normalized?.trim() ? normalized : undefined };
-}
-
-// IMPURE: Script entrypoint (config + filesystem I/O + console + process exit).
-function main() {
-    try {
-        const config = getConfig();
-        const { name } = parseArgs(process.argv.slice(2));
-
-        if (!name) {
-            throw new Error("Missing --name <SchemaBasename> argument");
-        }
-
-        const inPath =
-            name === "Genesis"
-                ? config.getSchemaPath("Genesis.json")
-                : config.getStandaloneSchemaPath(`${name}.json`);
-
-        if (!fs.existsSync(inPath)) {
-            if (name === "Genesis") {
-                console.error(`Schema file not found: ${inPath}`);
-                console.error("Run extractSchemasFromResourceTypeShells first.");
-            } else {
-                console.error(`Standalone schema file not found: ${inPath}`);
-                console.error(`Run generateStandaloneSchema -- --name ${name} first.`);
-            }
-            throw new Error("Input schema file not found");
-        }
-
-        // Basic validation against the expected shape of nucleusSchema.
-        const raw = fs.readFileSync(inPath, "utf8");
-        const parsed: any = JSON.parse(raw);
-
-        for (const warning of validateStandaloneSchemaForWarnings(parsed)) console.warn(warning);
-
-        const tsContent = generateStandaloneTypeLogic(name);
-        const jsContent = "export {}\n";
-
-        // Output setup
-        const outName = `Resource_${name}.d.ts`;
-        const outJsName = `Resource_${name}.js`;
-        const outDir = config.getStandaloneTypeSrcDir();
-        const distLibDir = config.getStandaloneTypeDistDir();
-
-        // Process src output
-        fs.mkdirSync(outDir, { recursive: true });
-        const outPath = config.getStandaloneTypeSrcPath(outName);
-        const outJsPath = config.getStandaloneTypeSrcPath(outJsName);
-        fs.writeFileSync(outPath, tsContent, "utf8");
-        console.log(`Wrote ${outPath}`);
-
-        if (!fs.existsSync(outJsPath)) {
-            fs.writeFileSync(outJsPath, jsContent, "utf8");
-            console.log(`Wrote ${outJsPath}`);
-        }
-
-        // Process dist output
-        fs.mkdirSync(distLibDir, { recursive: true });
-        const distDtsPath = config.getStandaloneTypeDistPath(outName);
-        const distJsPath = config.getStandaloneTypeDistPath(outJsName);
-        fs.writeFileSync(distDtsPath, tsContent, "utf8");
-        fs.writeFileSync(distJsPath, jsContent, "utf8");
-        console.log(`Wrote ${distDtsPath}`);
-        console.log(`Wrote ${distJsPath}`);
-    } catch (e) {
-        console.error(e);
-        process.exitCode = 1;
-    }
-}
-
-main();
+import fs from "fs";
+import { getConfig } from "./_lib/config.js";
+
+/**
+ * Generate a typed Resource variant where `nucleus` is typed to a specific schema
+ * extracted under the configured output directory.
+ *
+ * Usage: node ./dist/scripts/generateStandaloneTypes.js --name Job
+ */
+
+// PURE: Generate the content of a standalone Resource type definition file for a given schema name.
+function generateStandaloneTypeLogic(name: string): string {
+    const header = "// Auto-generated strict composite type. Do not edit.\n";
+
+    const nucleusTypeName = name.endsWith("Json") ? name : `${name}Json`;
+    const ts =
+        `import type { ShellMaterializedBaseJson as ShellMaterializedBase, ${nucleusTypeName} as NucleusSchema } from "../types.js";\n` +
+        `export type Resource_${name} = ShellMaterializedBase & { nucleus: NucleusSchema };\n`;
+    return header + ts;
+}
+
+// PURE: Strip accidental surrounding quotes from CLI values (PowerShell/cmd).
+function stripSurroundingQuotes(value: string): string {
+    if ((value.startsWith("\"") && value.endsWith("\"")) || (value.startsWith("'") && value.endsWith("'"))) {
+        return value.slice(1, -1);
+    }
+    return value;
+}
+
+// PURE: Validate a standalone schema and return warnings (no logging).
+function validateStandaloneSchemaForWarnings(schema: any): string[] {
+    const warnings: string[] = [];
+    if (schema?.$schema && schema.$schema !== "https://json-schema.org/draft/2020-12/schema") {
+        warnings.push(
+            `Warning: schema $schema is '${String(schema.$schema)}', expected draft 2020-12. Proceeding anyway.`
+        );
+    }
+    if (schema?.type && schema.type !== "object") {
+        warnings.push(
+            `Warning: nucleusSchema usually has type: 'object' but this schema has type: '${String(schema.type)}'. Proceeding.`
+        );
+    }
+    return warnings;
+}
+
+// PURE: Parse CLI args (no defaults, no filesystem probing).
+function parseArgs(args: string[]): { name?: string } {
+    let name: string | undefined;
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === "--name") {
+            name = args[i + 1];
+            i++;
+        } else if (a.startsWith("--name=")) {
+            name = a.split("=")[1];
+        }
+    }
+    const normalized = typeof name === "string" ? stripSurroundingQuotes(name) : undefined;
+    return { name: normalized?.trim() ? normalized : undefined };
+}
+
+// IMPURE: Script entrypoint (config + filesystem I/O + console + process exit).
+function main() {
+    try {
+        const config = getConfig();
+        const { name } = parseArgs(process.argv.slice(2));
+
+        if (!name) {
+            throw new Error("Missing --name <SchemaBasename> argument");
+        }
+
+        const inPath =
+            name === "Genesis"
+                ? config.getSchemaPath("Genesis.json")
+                : config.getStandaloneSchemaPath(`${name}.json`);
+
+        if (!fs.existsSync(inPath)) {
+            if (name === "Genesis") {
+                console.error(`Schema file not found: ${inPath}`);
+                console.error("Run extractSchemasFromResourceTypeShells first.");
+            } else {
+                console.error(`Standalone schema file not found: ${inPath}`);
+                console.error(`Run generateStandaloneSchema -- --name ${name} first.`);
+            }
+            throw new Error("Input schema file not found");
+        }
+
+        // Basic validation against the expected shape of nucleusSchema.
+        const raw = fs.readFileSync(inPath, "utf8");
+        const parsed: any = JSON.parse(raw);
+
+        for (const warning of validateStandaloneSchemaForWarnings(parsed)) console.warn(warning);
+
+        const tsContent = generateStandaloneTypeLogic(name);
+        const jsContent = "export {}\n";
+
+        // Output setup
+        const outName = `Resource_${name}.d.ts`;
+        const outJsName = `Resource_${name}.js`;
+        const outDir = config.getStandaloneTypeSrcDir();
+        const distLibDir = config.getStandaloneTypeDistDir();
+
+        // Process src output
+        fs.mkdirSync(outDir, { recursive: true });
+        const outPath = config.getStandaloneTypeSrcPath(outName);
+        const outJsPath = config.getStandaloneTypeSrcPath(outJsName);
+        fs.writeFileSync(outPath, tsContent, "utf8");
+        console.log(`Wrote ${outPath}`);
+
+        if (!fs.existsSync(outJsPath)) {
+            fs.writeFileSync(outJsPath, jsContent, "utf8");
+            console.log(`Wrote ${outJsPath}`);
+        }
+
+        // Process dist output
+        fs.mkdirSync(distLibDir, { recursive: true });
+        const distDtsPath = config.getStandaloneTypeDistPath(outName);
+        const distJsPath = config.getStandaloneTypeDistPath(outJsName);
+        fs.writeFileSync(distDtsPath, tsContent, "utf8");
+        fs.writeFileSync(distJsPath, jsContent, "utf8");
+        console.log(`Wrote ${distDtsPath}`);
+        console.log(`Wrote ${distJsPath}`);
+    } catch (e) {
+        console.error(e);
+        process.exitCode = 1;
+    }
+}
+
+main();

package/src/scripts/generateTerminals.ts

@@ -1,73 +1,73 @@
-import fs from "fs";
-import path from "path";
-import { getConfig } from "./_lib/config.js";
-
-type DependencyMap = Record<string, string[]>;
-
-// PURE: Validate + normalize a dependency map loaded from JSON.
-function normalizeDependencyMap(value: unknown): DependencyMap {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    throw new Error("Invalid dependencyMap.json: expected an object");
-  }
-
-  const input = value as Record<string, unknown>;
-  const out: DependencyMap = {};
-
-  // Preserve insertion order from the parsed JSON object.
-  for (const [key, rawDeps] of Object.entries(input)) {
-    if (rawDeps == null) {
-      out[key] = [];
-      continue;
-    }
-    if (!Array.isArray(rawDeps)) {
-      throw new Error(`Invalid dependencyMap.json: value for ${key} must be an array`);
-    }
-    out[key] = rawDeps.filter((d): d is string => typeof d === "string");
-  }
-
-  return out;
-}
-
-// PURE: Compute terminals (defs that are not depended-upon by any other def).
-function computeTerminalsInKeyOrder(dependencyMap: DependencyMap): string[] {
-  const keys = Object.keys(dependencyMap);
-  const dependedUpon = new Set<string>();
-
-  for (const key of keys) {
-    for (const dep of dependencyMap[key] ?? []) {
-      dependedUpon.add(dep);
-    }
-  }
-
-  // Preserve key order from dependencyMap.json.
-  return keys.filter((k) => !dependedUpon.has(k));
-}
-
-// IMPURE: Script entrypoint (config + filesystem I/O + console + process exit code).
-function main() {
-  try {
-    const config = getConfig();
-
-    const inPath = config.getDependencyMapPath();
-    const outPath = path.join(path.dirname(inPath), "terminals.json");
-
-    if (!fs.existsSync(inPath)) {
-      throw new Error(`Dependency map not found at ${inPath}. Run generateDependencies first.`);
-    }
-
-    const raw = fs.readFileSync(inPath, "utf8");
-    const parsed = JSON.parse(raw) as unknown;
-
-    const dependencyMap = normalizeDependencyMap(parsed);
-    const terminals = computeTerminalsInKeyOrder(dependencyMap);
-
-    fs.mkdirSync(path.dirname(outPath), { recursive: true });
-    fs.writeFileSync(outPath, JSON.stringify(terminals, null, 4), "utf8");
-    console.log(`Wrote terminals to ${outPath}`);
-  } catch (error: any) {
-    console.error(`Error generating terminals: ${error?.message ?? error}`);
-    process.exitCode = 1;
-  }
-}
-
-main();
+import fs from "fs";
+import path from "path";
+import { getConfig } from "./_lib/config.js";
+
+type DependencyMap = Record<string, string[]>;
+
+// PURE: Validate + normalize a dependency map loaded from JSON.
+function normalizeDependencyMap(value: unknown): DependencyMap {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error("Invalid dependencyMap.json: expected an object");
+  }
+
+  const input = value as Record<string, unknown>;
+  const out: DependencyMap = {};
+
+  // Preserve insertion order from the parsed JSON object.
+  for (const [key, rawDeps] of Object.entries(input)) {
+    if (rawDeps == null) {
+      out[key] = [];
+      continue;
+    }
+    if (!Array.isArray(rawDeps)) {
+      throw new Error(`Invalid dependencyMap.json: value for ${key} must be an array`);
+    }
+    out[key] = rawDeps.filter((d): d is string => typeof d === "string");
+  }
+
+  return out;
+}
+
+// PURE: Compute terminals (defs that are not depended-upon by any other def).
+function computeTerminalsInKeyOrder(dependencyMap: DependencyMap): string[] {
+  const keys = Object.keys(dependencyMap);
+  const dependedUpon = new Set<string>();
+
+  for (const key of keys) {
+    for (const dep of dependencyMap[key] ?? []) {
+      dependedUpon.add(dep);
+    }
+  }
+
+  // Preserve key order from dependencyMap.json.
+  return keys.filter((k) => !dependedUpon.has(k));
+}
+
+// IMPURE: Script entrypoint (config + filesystem I/O + console + process exit code).
+function main() {
+  try {
+    const config = getConfig();
+
+    const inPath = config.getArtifactsPath("dependencyMap.json");
+    const outPath = config.getArtifactsPath("terminals.json");
+
+    if (!fs.existsSync(inPath)) {
+      throw new Error(`Dependency map not found at ${inPath}. Run generateDependencies first.`);
+    }
+
+    const raw = fs.readFileSync(inPath, "utf8");
+    const parsed = JSON.parse(raw) as unknown;
+
+    const dependencyMap = normalizeDependencyMap(parsed);
+    const terminals = computeTerminalsInKeyOrder(dependencyMap);
+
+    fs.mkdirSync(path.dirname(outPath), { recursive: true });
+    fs.writeFileSync(outPath, JSON.stringify(terminals, null, 4), "utf8");
+    console.log(`Wrote terminals to ${outPath}`);
+  } catch (error: any) {
+    console.error(`Error generating terminals: ${error?.message ?? error}`);
+    process.exitCode = 1;
+  }
+}
+
+main();