@toolproof-core/schema 1.0.7 → 1.0.9

package/src/scripts/generateConstants.ts

@@ -1,217 +1,217 @@
-import fs from 'fs';
-import path from 'path';
-import { getConfig } from './_lib/config.js';
-
-type JSONValue = null | boolean | number | string | JSONValue[] | { [k: string]: JSONValue };
-
-export type GeneratedConstants = {
-    IDENTIFIABLES: {
-        PREFIXES: Record<string, string>;
-        NAMES: Record<string, string>;
-    };
-    ENUMS: Record<string, Record<string, string>>;
-};
-
-// PURE: Attempt to derive a canonical identity prefix from a canonical identity regex pattern.
-function deriveIdentityPrefixFromPattern(pattern: string): string | undefined {
-    // Canonical (currently used across schemas): ^PREFIX-.+$
-    const match = /^\^([^$]+)\.\+\$$/.exec(pattern);
-    if (!match) return undefined;
-
-    const prefix = match[1];
-    if (!prefix || /[`\n\r]/.test(prefix)) return undefined;
-
-    return prefix;
-}
-
-// PURE: Extract all identity prefixes from `$defs/*Identity` string-pattern definitions.
-export function extractIdentityPrefixes(schema: unknown): Record<string, string> {
-    if (!schema || typeof schema !== 'object') return {};
-
-    const defs = (schema as any).$defs;
-    if (!defs || typeof defs !== 'object') return {};
-
-    const defEntries = Object.entries(defs as Record<string, unknown>);
-    defEntries.sort(([a], [b]) => a.localeCompare(b));
-
-    const out: Record<string, string> = {};
-
-    for (const [defName, defVal] of defEntries) {
-        if (!/Identity$/.test(defName)) continue;
-        if (!defVal || typeof defVal !== 'object' || Array.isArray(defVal)) continue;
-
-        const v: any = defVal;
-        if (v.type !== 'string') continue;
-        if (typeof v.pattern !== 'string') continue;
-
-        const prefix = deriveIdentityPrefixFromPattern(v.pattern);
-        if (!prefix) continue;
-
-        out[defName] = prefix;
-    }
-
-    return out;
-}
-
-// PURE: Derive identifiables from extracted Identity def names.
-// Example: { BranchStepIdentity: 'BRANCH_STEP-' } => { BranchStep: 'BranchStep' }
-export function deriveIdentifiablesFromIdentityPrefixes(identityPrefixes: Record<string, string>): Record<string, string> {
-    const keys = Object.keys(identityPrefixes).sort((a, b) => a.localeCompare(b));
-    const out: Record<string, string> = {};
-
-    for (const key of keys) {
-        if (!key.endsWith('Identity')) continue;
-        const name = key.slice(0, -'Identity'.length);
-        if (!name) continue;
-        out[name] = name;
-    }
-
-    return out;
-}
-
-// PURE: Extract all string enums from `$defs/*Kind|*Status` definitions.
-// Shape: { StepKind: { job: 'job', ... }, ResourceKind: { 'input-potential': 'input-potential', ... } }
-export function extractEnums(schema: unknown): Record<string, Record<string, string>> {
-    if (!schema || typeof schema !== 'object') return {};
-
-    const defs = (schema as any).$defs;
-    if (!defs || typeof defs !== 'object') return {};
-
-    const defEntries = Object.entries(defs as Record<string, unknown>);
-    defEntries.sort(([a], [b]) => a.localeCompare(b));
-
-    const out: Record<string, Record<string, string>> = {};
-
-    for (const [defName, defVal] of defEntries) {
-        if (!/(Kind|Status)$/.test(defName)) continue;
-        if (!defVal || typeof defVal !== 'object' || Array.isArray(defVal)) continue;
-
-        const v: any = defVal;
-        if (v.type !== 'string') continue;
-        if (!Array.isArray(v.enum) || v.enum.length === 0) continue;
-        if (v.enum.some((x: unknown) => typeof x !== 'string')) continue;
-
-        const members: Record<string, string> = {};
-        for (const member of v.enum as readonly string[]) {
-            members[member] = member;
-        }
-
-        out[defName] = members;
-    }
-
-    return out;
-}
-
-// PURE: Extract all generated constants from a parsed schema.
-export function extractConstants(schema: unknown): GeneratedConstants {
-    const identityPrefixes = extractIdentityPrefixes(schema);
-    const identifiables = deriveIdentifiablesFromIdentityPrefixes(identityPrefixes);
-    const enums = extractEnums(schema);
-    return {
-        IDENTIFIABLES: {
-            PREFIXES: identityPrefixes,
-            NAMES: identifiables,
-        },
-        ENUMS: enums,
-    };
-}
-
-// PURE: Render helpers for TS keys/strings.
-function escapeTsString(value: string): string {
-    return value
-        .replace(/\\/g, '\\\\')
-        .replace(/\r/g, '\\r')
-        .replace(/\n/g, '\\n')
-        .replace(/\t/g, '\\t')
-        .replace(/'/g, "\\'");
-}
-
-function renderTsStringLiteral(value: string): string {
-    return `'${escapeTsString(value)}'`;
-}
-
-function isValidTsIdentifier(key: string): boolean {
-    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key);
-}
-
-function renderTsKey(key: string): string {
-    return isValidTsIdentifier(key) ? key : renderTsStringLiteral(key);
-}
-
-// PURE: Render constants TypeScript source.
-export function renderConstantsTs(constants: GeneratedConstants): string {
-    const prefixKeys = Object.keys(constants.IDENTIFIABLES.PREFIXES).sort((a, b) => a.localeCompare(b));
-    const nameKeys = Object.keys(constants.IDENTIFIABLES.NAMES).sort((a, b) => a.localeCompare(b));
-    const enumKeys = Object.keys(constants.ENUMS).sort((a, b) => a.localeCompare(b));
-
-    const lines: string[] = [];
-    lines.push('const CONSTANTS = {');
-    lines.push('    IDENTIFIABLES: {');
-    lines.push('        PREFIXES: {');
-
-    for (const key of prefixKeys) {
-        const value = constants.IDENTIFIABLES.PREFIXES[key] ?? '';
-        lines.push(`            ${renderTsKey(key)}: ${renderTsStringLiteral(value)},`);
-    }
-
-    lines.push('        },');
-    lines.push('        NAMES: {');
-
-    for (const key of nameKeys) {
-        const value = constants.IDENTIFIABLES.NAMES[key] ?? '';
-        lines.push(`            ${renderTsKey(key)}: ${renderTsStringLiteral(value)},`);
-    }
-
-    lines.push('        },');
-    lines.push('    },');
-    lines.push('    ENUMS: {');
-
-    for (const key of enumKeys) {
-        const members = constants.ENUMS[key] ?? {};
-        lines.push(`        ${renderTsKey(key)}: {`);
-
-        for (const memberKey of Object.keys(members)) {
-            const value = members[memberKey] ?? '';
-            lines.push(`            ${renderTsKey(memberKey)}: ${renderTsStringLiteral(value)},`);
-        }
-
-        lines.push('        },');
-    }
-
-    lines.push('    }');
-    lines.push('} as const;');
-    lines.push('');
-    lines.push('export default CONSTANTS;');
-    lines.push('');
-
-    return lines.join('\n');
-}
-
-// 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.getConstantsPath('constants.ts');
-
-        if (!fs.existsSync(inPath)) {
-            throw new Error(`Genesis schema not found at ${inPath}. Run extractSchemasFromResourceTypeShells first.`);
-        }
-
-        const raw = fs.readFileSync(inPath, 'utf8');
-        const doc: JSONValue = JSON.parse(raw);
-
-        const constants = extractConstants(doc);
-        const ts = renderConstantsTs(constants);
-
-        fs.mkdirSync(path.dirname(outPath), { recursive: true });
-        fs.writeFileSync(outPath, ts, 'utf8');
-        console.log(`Wrote constants to ${outPath}`);
-    } catch (error: any) {
-        console.error(`Error generating constants: ${error?.message ?? error}`);
-        process.exitCode = 1;
-    }
-}
-
-main();
+import fs from 'fs';
+import path from 'path';
+import { getConfig } from './_lib/config.js';
+
+type JSONValue = null | boolean | number | string | JSONValue[] | { [k: string]: JSONValue };
+
+export type GeneratedConstants = {
+    IDENTIFIABLES: {
+        PREFIXES: Record<string, string>;
+        NAMES: Record<string, string>;
+    };
+    ENUMS: Record<string, Record<string, string>>;
+};
+
+// PURE: Attempt to derive a canonical identity prefix from a canonical identity regex pattern.
+function deriveIdentityPrefixFromPattern(pattern: string): string | undefined {
+    // Canonical (currently used across schemas): ^PREFIX-.+$
+    const match = /^\^([^$]+)\.\+\$$/.exec(pattern);
+    if (!match) return undefined;
+
+    const prefix = match[1];
+    if (!prefix || /[`\n\r]/.test(prefix)) return undefined;
+
+    return prefix;
+}
+
+// PURE: Extract all identity prefixes from `$defs/*Identity` string-pattern definitions.
+export function extractIdentityPrefixes(schema: unknown): Record<string, string> {
+    if (!schema || typeof schema !== 'object') return {};
+
+    const defs = (schema as any).$defs;
+    if (!defs || typeof defs !== 'object') return {};
+
+    const defEntries = Object.entries(defs as Record<string, unknown>);
+    defEntries.sort(([a], [b]) => a.localeCompare(b));
+
+    const out: Record<string, string> = {};
+
+    for (const [defName, defVal] of defEntries) {
+        if (!/Identity$/.test(defName)) continue;
+        if (!defVal || typeof defVal !== 'object' || Array.isArray(defVal)) continue;
+
+        const v: any = defVal;
+        if (v.type !== 'string') continue;
+        if (typeof v.pattern !== 'string') continue;
+
+        const prefix = deriveIdentityPrefixFromPattern(v.pattern);
+        if (!prefix) continue;
+
+        out[defName] = prefix;
+    }
+
+    return out;
+}
+
+// PURE: Derive identifiables from extracted Identity def names.
+// Example: { BranchStepIdentity: 'BRANCH_STEP-' } => { BranchStep: 'BranchStep' }
+export function deriveIdentifiablesFromIdentityPrefixes(identityPrefixes: Record<string, string>): Record<string, string> {
+    const keys = Object.keys(identityPrefixes).sort((a, b) => a.localeCompare(b));
+    const out: Record<string, string> = {};
+
+    for (const key of keys) {
+        if (!key.endsWith('Identity')) continue;
+        const name = key.slice(0, -'Identity'.length);
+        if (!name) continue;
+        out[name] = name;
+    }
+
+    return out;
+}
+
+// PURE: Extract all string enums from `$defs/*Kind|*Status` definitions.
+// Shape: { StepKind: { job: 'job', ... }, ResourceKind: { inputPotential': 'inputPotential', ... } }
+export function extractEnums(schema: unknown): Record<string, Record<string, string>> {
+    if (!schema || typeof schema !== 'object') return {};
+
+    const defs = (schema as any).$defs;
+    if (!defs || typeof defs !== 'object') return {};
+
+    const defEntries = Object.entries(defs as Record<string, unknown>);
+    defEntries.sort(([a], [b]) => a.localeCompare(b));
+
+    const out: Record<string, Record<string, string>> = {};
+
+    for (const [defName, defVal] of defEntries) {
+        if (!/(Kind|Status)$/.test(defName)) continue;
+        if (!defVal || typeof defVal !== 'object' || Array.isArray(defVal)) continue;
+
+        const v: any = defVal;
+        if (v.type !== 'string') continue;
+        if (!Array.isArray(v.enum) || v.enum.length === 0) continue;
+        if (v.enum.some((x: unknown) => typeof x !== 'string')) continue;
+
+        const members: Record<string, string> = {};
+        for (const member of v.enum as readonly string[]) {
+            members[member] = member;
+        }
+
+        out[defName] = members;
+    }
+
+    return out;
+}
+
+// PURE: Extract all generated constants from a parsed schema.
+export function extractConstants(schema: unknown): GeneratedConstants {
+    const identityPrefixes = extractIdentityPrefixes(schema);
+    const identifiables = deriveIdentifiablesFromIdentityPrefixes(identityPrefixes);
+    const enums = extractEnums(schema);
+    return {
+        IDENTIFIABLES: {
+            PREFIXES: identityPrefixes,
+            NAMES: identifiables,
+        },
+        ENUMS: enums,
+    };
+}
+
+// PURE: Render helpers for TS keys/strings.
+function escapeTsString(value: string): string {
+    return value
+        .replace(/\\/g, '\\\\')
+        .replace(/\r/g, '\\r')
+        .replace(/\n/g, '\\n')
+        .replace(/\t/g, '\\t')
+        .replace(/'/g, "\\'");
+}
+
+function renderTsStringLiteral(value: string): string {
+    return `'${escapeTsString(value)}'`;
+}
+
+function isValidTsIdentifier(key: string): boolean {
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key);
+}
+
+function renderTsKey(key: string): string {
+    return isValidTsIdentifier(key) ? key : renderTsStringLiteral(key);
+}
+
+// PURE: Render constants TypeScript source.
+export function renderConstantsTs(constants: GeneratedConstants): string {
+    const prefixKeys = Object.keys(constants.IDENTIFIABLES.PREFIXES).sort((a, b) => a.localeCompare(b));
+    const nameKeys = Object.keys(constants.IDENTIFIABLES.NAMES).sort((a, b) => a.localeCompare(b));
+    const enumKeys = Object.keys(constants.ENUMS).sort((a, b) => a.localeCompare(b));
+
+    const lines: string[] = [];
+    lines.push('const CONSTANTS = {');
+    lines.push('    IDENTIFIABLES: {');
+    lines.push('        PREFIXES: {');
+
+    for (const key of prefixKeys) {
+        const value = constants.IDENTIFIABLES.PREFIXES[key] ?? '';
+        lines.push(`            ${renderTsKey(key)}: ${renderTsStringLiteral(value)},`);
+    }
+
+    lines.push('        },');
+    lines.push('        NAMES: {');
+
+    for (const key of nameKeys) {
+        const value = constants.IDENTIFIABLES.NAMES[key] ?? '';
+        lines.push(`            ${renderTsKey(key)}: ${renderTsStringLiteral(value)},`);
+    }
+
+    lines.push('        },');
+    lines.push('    },');
+    lines.push('    ENUMS: {');
+
+    for (const key of enumKeys) {
+        const members = constants.ENUMS[key] ?? {};
+        lines.push(`        ${renderTsKey(key)}: {`);
+
+        for (const memberKey of Object.keys(members)) {
+            const value = members[memberKey] ?? '';
+            lines.push(`            ${renderTsKey(memberKey)}: ${renderTsStringLiteral(value)},`);
+        }
+
+        lines.push('        },');
+    }
+
+    lines.push('    }');
+    lines.push('} as const;');
+    lines.push('');
+    lines.push('export default CONSTANTS;');
+    lines.push('');
+
+    return lines.join('\n');
+}
+
+// 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.getConstantsPath('constants.ts');
+
+        if (!fs.existsSync(inPath)) {
+            throw new Error(`Genesis schema not found at ${inPath}. Run extractSchemasFromResourceTypeShells first.`);
+        }
+
+        const raw = fs.readFileSync(inPath, 'utf8');
+        const doc: JSONValue = JSON.parse(raw);
+
+        const constants = extractConstants(doc);
+        const ts = renderConstantsTs(constants);
+
+        fs.mkdirSync(path.dirname(outPath), { recursive: true });
+        fs.writeFileSync(outPath, ts, 'utf8');
+        console.log(`Wrote constants to ${outPath}`);
+    } catch (error: any) {
+        console.error(`Error generating constants: ${error?.message ?? error}`);
+        process.exitCode = 1;
+    }
+}
+
+main();