@memberjunction/codegen-lib 6.1.0-edge.4 → 6.1.0-edge.5

package/dist/Misc/schema-emit.js

@@ -0,0 +1,220 @@
+/**
+ * Schema is the incremental unit for CodeGen file emit.
+ *
+ * A 2,000-entity database is almost never one schema with 2,000 tables. It is
+ * two-to-three dozen schemas of 100–150 tables each. Entity identity stays the
+ * entity (names, FKs, metadata rows). Everything that can be incremental —
+ * emit, dirty regen, parallelism, output-directory routing, agent context —
+ * keys off the schema.
+ */
+import fs from 'fs';
+import path from 'path';
+import { writeFileIfChanged } from './file-write.js';
+/**
+ * Case-insensitive schema match. `%` is the only wildcard (SQL `_` is a
+ * literal — schema names like `bsd_crm` are common and must not glob).
+ */
+/** Case-insensitive schema/entity key. Null/undefined become ''. */
+export function schemaKey(name) {
+    return (name ?? '').trim().toLowerCase();
+}
+export function schemaNameMatches(pattern, schemaName) {
+    const p = schemaKey(pattern);
+    const s = schemaKey(schemaName);
+    if (!p.includes('%')) {
+        return p === s;
+    }
+    const escaped = p.replace(/[.+^${}()|[\]\\]/g, '\\$&').replace(/%/g, '.*');
+    return new RegExp(`^${escaped}$`).test(s);
+}
+/**
+ * Turn a SQL schema name into a safe TypeScript file stem.
+ * `__mj` stays `__mj`; `bsd_crm` stays `bsd_crm`; `Sales.Analytics` becomes `Sales_Analytics`.
+ */
+export function sanitizeSchemaFileName(schemaName) {
+    // Keep leading underscores — `__mj` is a real schema name and a valid file stem.
+    const cleaned = (schemaName ?? '').trim().replace(/[^A-Za-z0-9_]+/g, '_').replace(/_+$/g, '');
+    return cleaned.length > 0 ? cleaned : 'schema';
+}
+/**
+ * Group entities by their raw `SchemaName` (trimmed, original casing of the
+ * first occurrence). Order inside each group is the input order.
+ */
+export function groupEntitiesBySchema(entities) {
+    const map = new Map();
+    for (const entity of entities) {
+        const key = (entity.SchemaName ?? '').trim() || 'unknown';
+        const list = map.get(key);
+        if (list) {
+            list.push(entity);
+        }
+        else {
+            map.set(key, [entity]);
+        }
+    }
+    return map;
+}
+/**
+ * Map dirty entity names (from `newEntityList` ∪ `modifiedEntityList`) back to
+ * the schemas those entities live in. Comparison is case-insensitive.
+ */
+/**
+ * Resolve which schemas a file-emit pass should rebuild.
+ * `--skipdb` and `dirtySchemaOnly === false` rebuild every schema (write-if-changed
+ * still keeps mtimes stable). Otherwise only schemas that contain a new/modified
+ * entity are dirty — missing files are added later by {@link schemasToEmit}.
+ */
+export function resolveDirtySchemasForEmit(entities, dirtyEntityNames, skipDB, dirtySchemaOnly, deletedEntitySchemas = []) {
+    if (skipDB || !dirtySchemaOnly) {
+        return 'all';
+    }
+    const schemas = collectDirtySchemas(entities, dirtyEntityNames);
+    // Deletion arrives as a schema, not an entity name: by the time this runs the entity is gone
+    // from `entities`, so `collectDirtySchemas` could never resolve it. Union it in directly, or
+    // the schema is not rebuilt and the dead class survives on disk.
+    for (const schema of deletedEntitySchemas) {
+        const trimmed = (schema ?? '').trim();
+        if (trimmed.length > 0) {
+            schemas.add(trimmed);
+        }
+    }
+    return schemas;
+}
+export function collectDirtySchemas(entities, dirtyEntityNames) {
+    const dirty = new Set();
+    for (const name of dirtyEntityNames) {
+        const key = schemaKey(name);
+        if (key.length > 0) {
+            dirty.add(key);
+        }
+    }
+    const schemas = new Set();
+    if (dirty.size === 0) {
+        return schemas;
+    }
+    for (const entity of entities) {
+        if (dirty.has(schemaKey(entity.Name))) {
+            const schema = (entity.SchemaName ?? '').trim();
+            if (schema.length > 0) {
+                schemas.add(schema);
+            }
+        }
+    }
+    return schemas;
+}
+/**
+ * Decide which schema files to rebuild. Missing files are always rebuilt so a
+ * fresh clone / first run is complete. When `dirty` is `'all'` every schema is
+ * rebuilt (callers still use write-if-changed to keep mtimes stable).
+ */
+export function schemasToEmit(allSchemas, dirty, fileExists) {
+    if (dirty === 'all' || dirty == null) {
+        return [...allSchemas];
+    }
+    const dirtyLower = new Set([...dirty].map((s) => s.trim().toLowerCase()));
+    return allSchemas.filter((schema) => {
+        if (!fileExists(schema)) {
+            return true;
+        }
+        return dirtyLower.has(schema.trim().toLowerCase());
+    });
+}
+/**
+ * Bounded parallel map. Order of results matches `items`. A limit of 1 is serial.
+ */
+export async function mapLimit(items, limit, mapper) {
+    const concurrency = Math.max(1, Math.floor(limit));
+    const results = new Array(items.length);
+    let next = 0;
+    const workers = Array.from({ length: Math.min(concurrency, items.length) }, async () => {
+        while (next < items.length) {
+            const index = next;
+            next += 1;
+            results[index] = await mapper(items[index], index);
+        }
+    });
+    await Promise.all(workers);
+    return results;
+}
+/**
+ * Barrel that re-exports every per-schema file. Uses `.js` specifiers so the
+ * file is valid in `"type": "module"` packages (MJCoreEntities, MJServer).
+ */
+export function buildSchemaBarrel(schemas, relativeDir, extraHeader) {
+    const dir = relativeDir.replace(/\\/g, '/').replace(/\/+$/, '');
+    const exports = [...schemas]
+        .sort((a, b) => a.localeCompare(b))
+        .map((schema) => `export * from './${dir}/${sanitizeSchemaFileName(schema)}.js';`)
+        .join('\n');
+    return `${extraHeader}${exports}\n`;
+}
+/**
+ * Names of files in a per-schema emit directory that no live schema claims.
+ *
+ * Kept pure and separate from the deletion so the decision is testable without a
+ * filesystem. `fileNames` is a plain directory listing; `schemas` is every schema in the
+ * run, not just the dirty subset.
+ */
+export function selectOrphanedSchemaFiles(fileNames, schemas) {
+    const live = new Set(schemas.map((schema) => `${sanitizeSchemaFileName(schema)}.ts`));
+    return fileNames.filter((name) => name.endsWith('.ts') && !live.has(name)).sort();
+}
+/**
+ * Delete per-schema files that no live schema claims, returning what was removed.
+ *
+ * A schema that empties out — its last table dropped — leaves its file on disk. The barrel
+ * stops exporting it, which is not enough: `tsc` still compiles it through `include`, the
+ * class-registration manifest still globs it into the registry, and the CodeGen-tail guard
+ * reads every `.ts` in the directory regardless of what the barrel names. So a deleted
+ * entity keeps a live `@RegisterClass` registration and inflates the roster the guard
+ * compares. The old monolith could not drift this way; it was rewritten in full every run.
+ *
+ * Safe under dirty-schema regen: `schemas` is the full set for the run, so a schema that
+ * simply was not dirty this time is still live and is never pruned.
+ */
+export function pruneOrphanedSchemaFiles(directory, schemas) {
+    if (!fs.existsSync(directory)) {
+        return [];
+    }
+    const orphans = selectOrphanedSchemaFiles(fs.readdirSync(directory), schemas);
+    for (const name of orphans) {
+        fs.unlinkSync(path.join(directory, name));
+    }
+    return orphans;
+}
+/**
+ * Fill in a partial {@link SchemaEmitOptions} from config defaults.
+ *
+ * Shared by both generators so the defaults cannot drift between entity subclasses and
+ * GraphQL resolvers — they must agree, or one emits per-schema while the other emits a
+ * monolith and the two rosters stop lining up.
+ *
+ * `parallel` / `concurrency` are resolved for every caller even though only the entity
+ * generator uses them: its per-schema assembly is async (each file awaits its entities),
+ * while GraphQL assembly is synchronous, so there is nothing to overlap there.
+ */
+export function resolveSchemaEmitOptions(options, defaults) {
+    return {
+        perSchema: options?.perSchema ?? defaults?.perSchema ?? true,
+        dirtySchemas: options?.dirtySchemas ?? 'all',
+        parallel: options?.parallel ?? defaults?.parallel ?? true,
+        concurrency: options?.concurrency ?? defaults?.concurrency ?? 8,
+        writeIfChanged: options?.writeIfChanged ?? defaults?.writeIfChanged ?? true,
+    };
+}
+/**
+ * Write one emitted file, honouring the write-if-changed setting.
+ *
+ * Shared for the same reason as {@link resolveSchemaEmitOptions}: both generators must treat
+ * an unchanged file identically, or one leaves mtimes alone while the other churns them and
+ * downstream incremental builds see phantom work.
+ */
+export function emitSchemaFile(filePath, content, useWriteIfChanged) {
+    if (useWriteIfChanged) {
+        writeFileIfChanged(filePath, content);
+        return;
+    }
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, content);
+}
+//# sourceMappingURL=schema-emit.js.map

package/dist/Misc/schema-emit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-emit.js","sourceRoot":"","sources":["../../src/Misc/schema-emit.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -48,6 +48,12 @@ export * from './Database/dbSchema.js';
 export * from './Database/manage-metadata.js';
 export * from './Database/sql_codegen.js';
 export * from './Database/sql.js';
+export * from './Database/schema-scope.js';
+export * from './Database/exclude-tables.js';
+export * from './Config/schema-output.js';
+export * from './Misc/file-write.js';
+export * from './Misc/emit-stats.js';
+export * from './Misc/schema-emit.js';
 export * from './Misc/entity_subclasses_codegen.js';
 export * from './Misc/action_subclasses_codegen.js';
 export * from './Misc/remote_operations_codegen.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AAGtC,cAAc,oCAAoC,CAAA;AAClD,cAAc,yDAAyD,CAAA;AACvE,cAAc,2DAA2D,CAAA;AACzE,cAAc,2DAA2D,CAAA;AACzE,cAAc,6DAA6D,CAAA;AAC3E,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,wBAAwB,CAAA;AACtC,cAAc,gBAAgB,CAAA;AAG9B,cAAc,kCAAkC,CAAA;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAA;AAG7C,cAAc,2BAA2B,CAAA;AACzC,cAAc,qCAAqC,CAAC;AACpD,cAAc,qDAAqD,CAAC;AACpE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAG5D,cAAc,uBAAuB,CAAA;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,yBAAyB,CAAA;AAGvC,cAAc,+CAA+C,CAAA;AAG7D,cAAc,uCAAuC,CAAA;AACrD,cAAc,yCAAyC,CAAA;AACvD,cAAc,2CAA2C,CAAA;AAGzD,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AAGtC,cAAc,oCAAoC,CAAA;AAClD,cAAc,yDAAyD,CAAA;AACvE,cAAc,2DAA2D,CAAA;AACzE,cAAc,2DAA2D,CAAA;AACzE,cAAc,6DAA6D,CAAA;AAC3E,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,wBAAwB,CAAA;AACtC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,yBAAyB,CAAA;AACvC,cAAc,2BAA2B,CAAA;AACzC,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAGlC,cAAc,kCAAkC,CAAA;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAA;AAG7C,cAAc,2BAA2B,CAAA;AACzC,cAAc,qCAAqC,CAAC;AACpD,cAAc,qDAAqD,CAAC;AACpE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAG5D,cAAc,uBAAuB,CAAA;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,yBAAyB,CAAA;AAGvC,cAAc,+CAA+C,CAAA;AAG7D,cAAc,uCAAuC,CAAA;AACrD,cAAc,yCAAyC,CAAA;AACvD,cAAc,2CAA2C,CAAA;AAGzD,cAAc,cAAc,CAAA"}

package/dist/index.js

@@ -50,6 +50,12 @@ export * from './Database/dbSchema.js';
 export * from './Database/manage-metadata.js';
 export * from './Database/sql_codegen.js';
 export * from './Database/sql.js';
+export * from './Database/schema-scope.js';
+export * from './Database/exclude-tables.js';
+export * from './Config/schema-output.js';
+export * from './Misc/file-write.js';
+export * from './Misc/emit-stats.js';
+export * from './Misc/schema-emit.js';
 // Code generation exports
 export * from './Misc/entity_subclasses_codegen.js';
 export * from './Misc/action_subclasses_codegen.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,wBAAwB;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AAEtC,mBAAmB;AACnB,cAAc,oCAAoC,CAAA;AAClD,cAAc,yDAAyD,CAAA;AACvE,cAAc,2DAA2D,CAAA;AACzE,cAAc,2DAA2D,CAAA;AACzE,cAAc,6DAA6D,CAAA;AAC3E,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,wBAAwB,CAAA;AACtC,cAAc,gBAAgB,CAAA;AAE9B,0BAA0B;AAC1B,cAAc,kCAAkC,CAAA;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAA;AAE7C,kBAAkB;AAClB,cAAc,2BAA2B,CAAA;AACzC,cAAc,qCAAqC,CAAC;AACpD,cAAc,qDAAqD,CAAC;AACpE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAE5D,kBAAkB;AAClB,cAAc,uBAAuB,CAAA;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,yBAAyB,CAAA;AAEvC,sBAAsB;AACtB,cAAc,+CAA+C,CAAA;AAE7D,uBAAuB;AACvB,cAAc,uCAAuC,CAAA;AACrD,cAAc,yCAAyC,CAAA;AACvD,cAAc,2CAA2C,CAAA;AAEzD,cAAc;AACd,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,wBAAwB;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AAEtC,mBAAmB;AACnB,cAAc,oCAAoC,CAAA;AAClD,cAAc,yDAAyD,CAAA;AACvE,cAAc,2DAA2D,CAAA;AACzE,cAAc,2DAA2D,CAAA;AACzE,cAAc,6DAA6D,CAAA;AAC3E,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,wBAAwB,CAAA;AACtC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,yBAAyB,CAAA;AACvC,cAAc,2BAA2B,CAAA;AACzC,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAElC,0BAA0B;AAC1B,cAAc,kCAAkC,CAAA;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAA;AAE7C,kBAAkB;AAClB,cAAc,2BAA2B,CAAA;AACzC,cAAc,qCAAqC,CAAC;AACpD,cAAc,qDAAqD,CAAC;AACpE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAE5D,kBAAkB;AAClB,cAAc,uBAAuB,CAAA;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,yBAAyB,CAAA;AAEvC,sBAAsB;AACtB,cAAc,+CAA+C,CAAA;AAE7D,uBAAuB;AACvB,cAAc,uCAAuC,CAAA;AACrD,cAAc,yCAAyC,CAAA;AACvD,cAAc,2CAA2C,CAAA;AAEzD,cAAc;AACd,cAAc,cAAc,CAAA"}

package/dist/runCodeGen.d.ts

@@ -7,6 +7,7 @@
  * Supports both SQL Server and PostgreSQL database platforms via the dbPlatform configuration.
  */
 import { CommandInfo } from './Config/config.js';
+import { SchemaEmitOptions } from './Misc/schema-emit.js';
 import * as MJ from '@memberjunction/core';
 import { CommandExecutionResult } from './Misc/runCommand.js';
 import { CodeGenConnection, DataSourceResult as ProviderDataSourceResult } from './Database/codeGenDatabaseProvider.js';
@@ -27,8 +28,17 @@ export declare class RunCodeGenBase {
         context: string;
         message: string;
     }>;
-    /** Record any failed entries from a BEFORE/AFTER command batch, paired by index. */
-    protected recordCommandFailures(phase: string, cmds: CommandInfo[], results: CommandExecutionResult[]): void;
+    /**
+     * Record any failed entries from a BEFORE/AFTER command batch, paired by index.
+     *
+     * Returns just this batch's failures. Callers log what they get back rather than walking
+     * `commandFailures`, which accumulates across phases — iterating the whole array in the
+     * AFTER handler re-logged every BEFORE failure a second time.
+     */
+    protected recordCommandFailures(phase: string, cmds: CommandInfo[], results: CommandExecutionResult[]): Array<{
+        context: string;
+        message: string;
+    }>;
     /**
      * Acquire the per-platform data source for a CodeGen run.
      *
@@ -65,6 +75,14 @@ export declare class RunCodeGenBase {
      * Accepts an existing data source — does NOT create connections or call process.exit().
      */
     protected executeCodeGenPipeline(dataSource: DataSourceResult, skipDatabaseGeneration?: boolean, skipFileGeneration?: boolean): Promise<boolean>;
+    /**
+     * Resolve dirty-schema emit options for one generator call.
+     * `--skipdb` (files only) and `fileEmit.dirtySchemaOnly === false` rebuild
+     * every schema; write-if-changed still keeps mtimes stable. A full run with
+     * no new/modified entities yields an empty Set — the generator then only
+     * writes schema files that are missing.
+     */
+    protected buildSchemaEmitOptions(entities: MJ.EntityInfo[], skipDB: boolean): SchemaEmitOptions;
     /**
      * Runs the file-generation phase of CodeGen: GraphQL resolvers, entity
      * subclasses (core + non-core), Angular components, DB schema JSON, and

package/dist/runCodeGen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runCodeGen.d.ts","sourceRoot":"","sources":["../src/runCodeGen.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,EAA4G,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGxJ,OAAO,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC3C,OAAO,EAAmB,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAS5E,OAAO,EAAE,iBAAiB,EAA2B,gBAAgB,IAAI,wBAAwB,EAAkC,MAAM,oCAAoC,CAAC;AAI9K,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D,OAAO,8DAA8D,CAAC;AAStE,KAAK,gBAAgB,GAAG,wBAAwB,CAAC;AAEjD;;GAEG;AACH,qBAAa,cAAc;IACzB;;;;OAIG;IACH,SAAS,CAAC,eAAe,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAM;IAE5E,oFAAoF;IACpF,SAAS,CAAC,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,GAAG,IAAI;IAc5G;;;;;;;;;;;;;OAaG;IACU,eAAe,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAIzD;;OAEG;IACH;;;;OAIG;IACU,YAAY,CAAC,UAAU,EAAE,gBAAgB,EAAE,sBAAsB,GAAE,OAAe,EAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,kBAAkB,GAAE,OAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBrK,GAAG,CAAC,sBAAsB,GAAE,OAAe,EAAE,kBAAkB,GAAE,OAAe;IAQ7F;;;;OAIG;IACU,aAAa,CAAC,sBAAsB,GAAE,OAAe,EAAE,kBAAkB,GAAE,OAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAgD9H;;;OAGG;cACa,sBAAsB,CAAC,UAAU,EAAE,gBAAgB,EAAE,sBAAsB,GAAE,OAAe,EAAE,kBAAkB,GAAE,OAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IA2RpK;;;;;;;;OAQG;cACa,sBAAsB,CACpC,IAAI,EAAE,iBAAiB,EACvB,WAAW,EAAE,QAAQ,EACrB,EAAE,EAAE,EAAE,CAAC,QAAQ,EACf,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,OAAO,CAAC;CAsMpB;AAED;;GAEG;AACH,wBAAsB,+BAA+B,CAAC,sBAAsB,GAAE,OAAe,EAAE,kBAAkB,GAAE,OAAe,iBAGjI;AAED;;;;;GAKG;AACH,wBAAsB,yCAAyC,CAC7D,sBAAsB,GAAE,OAAe,EACvC,kBAAkB,GAAE,OAAe,GAClC,OAAO,CAAC,WAAW,CAAC,CAGtB"}
+{"version":3,"file":"runCodeGen.d.ts","sourceRoot":"","sources":["../src/runCodeGen.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,EAA4G,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACxJ,OAAO,EAAyC,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAI9F,OAAO,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC3C,OAAO,EAAmB,sBAAsB,EAA8B,MAAM,mBAAmB,CAAC;AASxG,OAAO,EAAE,iBAAiB,EAA2B,gBAAgB,IAAI,wBAAwB,EAAkC,MAAM,oCAAoC,CAAC;AAI9K,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D,OAAO,8DAA8D,CAAC;AAStE,KAAK,gBAAgB,GAAG,wBAAwB,CAAC;AAEjD;;GAEG;AACH,qBAAa,cAAc;IACzB;;;;OAIG;IACH,SAAS,CAAC,eAAe,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAM;IAE5E;;;;;;OAMG;IACH,SAAS,CAAC,qBAAqB,CAC7B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,WAAW,EAAE,EACnB,OAAO,EAAE,sBAAsB,EAAE,GAChC,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAkB9C;;;;;;;;;;;;;OAaG;IACU,eAAe,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAIzD;;OAEG;IACH;;;;OAIG;IACU,YAAY,CAAC,UAAU,EAAE,gBAAgB,EAAE,sBAAsB,GAAE,OAAe,EAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,kBAAkB,GAAE,OAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBrK,GAAG,CAAC,sBAAsB,GAAE,OAAe,EAAE,kBAAkB,GAAE,OAAe;IAQ7F;;;;OAIG;IACU,aAAa,CAAC,sBAAsB,GAAE,OAAe,EAAE,kBAAkB,GAAE,OAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAiD9H;;;OAGG;cACa,sBAAsB,CAAC,UAAU,EAAE,gBAAgB,EAAE,sBAAsB,GAAE,OAAe,EAAE,kBAAkB,GAAE,OAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAyVpK;;;;;;OAMG;IACH,SAAS,CAAC,sBAAsB,CAAC,QAAQ,EAAE,EAAE,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,OAAO,GAAG,iBAAiB;IAa/F;;;;;;;;OAQG;cACa,sBAAsB,CACpC,IAAI,EAAE,iBAAiB,EACvB,WAAW,EAAE,QAAQ,EACrB,EAAE,EAAE,EAAE,CAAC,QAAQ,EACf,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,OAAO,CAAC;CA+QpB;AAED;;GAEG;AACH,wBAAsB,+BAA+B,CAAC,sBAAsB,GAAE,OAAe,EAAE,kBAAkB,GAAE,OAAe,iBAGjI;AAED;;;;;GAKG;AACH,wBAAsB,yCAAyC,CAC7D,sBAAsB,GAAE,OAAe,EACvC,kBAAkB,GAAE,OAAe,GAClC,OAAO,CAAC,WAAW,CAAC,CAGtB"}

package/dist/runCodeGen.js

@@ -11,11 +11,14 @@ import { SQLCodeGenBase } from './Database/sql_codegen.js';
 import { EntitySubClassGeneratorBase } from './Misc/entity_subclasses_codegen.js';
 import { ManageMetadataBase } from './Database/manage-metadata.js';
 import { applyIncludeSchemaScope } from './Database/schema-scope.js';
+import { partitionEntitiesByOutputDirectory } from './Config/schema-output.js';
 import { outputDir, commands, configInfo, getSettingValue, dbPlatform, getExternalEntitySchemas, initializeConfig } from './Config/config.js';
+import { resolveDirtySchemasForEmit, schemaKey } from './Misc/schema-emit.js';
+import { EmitStats } from './Misc/emit-stats.js';
 import { logError, logStatus, logWarning, startSpinner, updateSpinner, succeedSpinner, failSpinner, warnSpinner } from './Misc/status_logging.js';
 import { CodeGenReporter } from './Misc/codegen-reporter.js';
 import * as MJ from '@memberjunction/core';
-import { RunCommandsBase } from './Misc/runCommand.js';
+import { RunCommandsBase, formatCommandFailureDetail } from './Misc/runCommand.js';
 import { DBSchemaGeneratorBase } from './Database/dbSchema.js';
 import { AngularClientGeneratorBase } from './Angular/angular-codegen.js';
 import { CreateNewUserBase } from './Misc/createNewUser.js';
@@ -43,19 +46,29 @@ export class RunCodeGenBase {
          */
         this.commandFailures = [];
     }
-    /** Record any failed entries from a BEFORE/AFTER command batch, paired by index. */
+    /**
+     * Record any failed entries from a BEFORE/AFTER command batch, paired by index.
+     *
+     * Returns just this batch's failures. Callers log what they get back rather than walking
+     * `commandFailures`, which accumulates across phases — iterating the whole array in the
+     * AFTER handler re-logged every BEFORE failure a second time.
+     */
     recordCommandFailures(phase, cmds, results) {
+        const recorded = [];
         results.forEach((r, i) => {
             if (!r.success) {
                 const cmd = cmds[i];
                 const cmdText = cmd ? [cmd.command, ...(cmd.args ?? [])].join(' ').trim() : `command #${i + 1}`;
-                const detail = (r.error || r.output || '').trim();
-                this.commandFailures.push({
+                const detail = formatCommandFailureDetail(r);
+                const failure = {
                     context: `${phase} command`,
                     message: detail ? `\`${cmdText}\` failed: ${detail}` : `\`${cmdText}\` failed`,
-                });
+                };
+                this.commandFailures.push(failure);
+                recorded.push(failure);
             }
         });
+        return recorded;
     }
     /**
      * Acquire the per-platform data source for a CodeGen run.
@@ -149,8 +162,9 @@ export class RunCodeGenBase {
             };
         }
         catch (e) {
+            const message = e instanceof Error ? (e.stack ?? e.message) : String(e);
             failSpinner('CodeGen failed: ' + e);
-            logError(e);
+            logError(message);
             return {
                 success: false,
                 command: 'codegen',
@@ -205,7 +219,12 @@ export class RunCodeGenBase {
                     const results = await runCommandsObject.runCommands(beforeCommands);
                     if (results.some((r) => !r.success)) {
                         logError('ERROR running one or more BEFORE commands');
-                        this.recordCommandFailures('BEFORE', beforeCommands, results);
+                        const recorded = this.recordCommandFailures('BEFORE', beforeCommands, results);
+                        pipelineSuccess = false;
+                        for (const failure of recorded) {
+                            logError(failure.message);
+                            reporter.note(failure.message);
+                        }
                     }
                 }
                 updateSpinner('Executing before-all SQL Scripts...');
@@ -355,6 +374,57 @@ export class RunCodeGenBase {
                         return false;
                     }
                 }
+                // Metadata/view coherence. The CRUD validator asks "can the runtime WRITE this
+                // entity"; this asks the prior question — "can it READ it at all".
+                //
+                // A field the metadata declares but the base view does not produce makes every
+                // read of that entity fail with `column "X" does not exist`. Grids render that
+                // as an empty result rather than an error, so the entity looks like it holds no
+                // data. Nothing else in the pipeline notices, and the condition is permanent for
+                // any schema in `excludeSchemas` (CodeGen emits permissions only for those, so
+                // there is no regeneration pass to repair the view) — which by convention
+                // includes `__mj` on essentially every install.
+                //
+                // Reported, not fatal, by default: existing installs may already carry this drift
+                // and failing their next codegen run would be worse than telling them about it.
+                // Set MJ_CODEGEN_STRICT_FIELD_RESOLUTION=true to make it a hard gate; that is the
+                // intended default once fleets are clean.
+                try {
+                    startSpinner('Validating entity fields resolve against their base views...');
+                    const baseline = md.Entities.filter(e => e.IncludeInAPI);
+                    const gaps = await sqlCodeGenObject.DBProvider.validateEntityFieldsResolve(conn, baseline);
+                    if (gaps.length > 0) {
+                        const affected = new Set(gaps.map(g => `${g.schema}.${g.entity}`));
+                        const list = gaps
+                            .map(g => `  - [${g.schema}] ${g.entity} → ${g.baseView} does not produce "${g.field}"${g.isVirtual ? ' (virtual)' : ''}`)
+                            .join('\n');
+                        const strict = process.env.MJ_CODEGEN_STRICT_FIELD_RESOLUTION === 'true';
+                        const summary = `${gaps.length} declared field(s) across ${affected.size} entity(ies) are not produced by their base view.\n` +
+                            `Every read of these entities fails with 'column ... does not exist'. A grid shows that as\n` +
+                            `"no data" rather than an error, so the entity appears empty while its table is full.\n` +
+                            `${list}\n\n` +
+                            `Cause: a migration added the column to the base TABLE and registered the EntityField, but did\n` +
+                            `not rebuild the base VIEW. For schemas listed in excludeSchemas (typically __mj) CodeGen never\n` +
+                            `regenerates the view, so this does not self-heal.\n` +
+                            `Fix: rebuild the affected base view(s). PostgreSQL permits appending columns in place via\n` +
+                            `CREATE OR REPLACE VIEW, so no DROP/CASCADE is required.`;
+                        if (strict) {
+                            failSpinner(`Field-resolution validation FAILED: ${gaps.length} unreadable field(s)`);
+                            logError(summary);
+                            return false;
+                        }
+                        warnSpinner(`Field-resolution validation found ${gaps.length} unreadable field(s)`);
+                        logWarning(summary);
+                    }
+                    else {
+                        succeedSpinner('Entity fields all resolve against their base views');
+                    }
+                }
+                catch (e) {
+                    // Never fail the run on the validator's own error — it is a reporter.
+                    warnSpinner('Field-resolution validation could not run');
+                    logWarning(`Field-resolution validator threw: ${e instanceof Error ? e.message : String(e)}`);
+                }
                 // Surface upstream SQL-pipeline failure even if validator passed: a
                 // green validator just means whatever DID get generated is consistent;
                 // it doesn't whitewash an upstream batch error.
@@ -394,7 +464,12 @@ export class RunCodeGenBase {
                 const results = await runCommandsObject.runCommands(afterCommands);
                 if (results.some((r) => !r.success)) {
                     failSpinner('ERROR running one or more AFTER commands');
-                    this.recordCommandFailures('AFTER', afterCommands, results);
+                    const recorded = this.recordCommandFailures('AFTER', afterCommands, results);
+                    pipelineSuccess = false;
+                    for (const failure of recorded) {
+                        logError(failure.message);
+                        reporter.note(failure.message);
+                    }
                 }
                 else
                     succeedSpinner('AFTER commands completed');
@@ -415,7 +490,8 @@ export class RunCodeGenBase {
             logStatus('MJ CodeGen Complete! ' + md.Entities.length + ' entities processed in ' + totalSeconds + 's @ ' + endTime.toLocaleString());
             // A BEFORE/AFTER command failure fails the run (success=false, exit 1) so it
             // isn't silently swallowed — details flow into the structured result below.
-            return this.commandFailures.length === 0;
+            pipelineSuccess = pipelineSuccess && this.commandFailures.length === 0;
+            return pipelineSuccess;
         }
         catch (err) {
             pipelineSuccess = false;
@@ -439,6 +515,19 @@ export class RunCodeGenBase {
                 logStatus('CodeGen report written: ' + filePath);
         }
     }
+    /**
+     * Resolve dirty-schema emit options for one generator call.
+     * `--skipdb` (files only) and `fileEmit.dirtySchemaOnly === false` rebuild
+     * every schema; write-if-changed still keeps mtimes stable. A full run with
+     * no new/modified entities yields an empty Set — the generator then only
+     * writes schema files that are missing.
+     */
+    buildSchemaEmitOptions(entities, skipDB) {
+        const fileEmit = configInfo.fileEmit;
+        return {
+            dirtySchemas: resolveDirtySchemasForEmit(entities, [...ManageMetadataBase.newEntityList, ...ManageMetadataBase.modifiedEntityList], skipDB, fileEmit?.dirtySchemaOnly !== false, ManageMetadataBase.deletedEntitySchemaList),
+        };
+    }
     /**
      * Runs the file-generation phase of CodeGen: GraphQL resolvers, entity
      * subclasses (core + non-core), Angular components, DB schema JSON, and
@@ -450,15 +539,16 @@ export class RunCodeGenBase {
      */
     async runFileGenerationPhase(conn, currentUser, md, skipDB) {
         const reporter = CodeGenReporter.Instance;
+        EmitStats.Reset();
         const apiEntities = md.Entities.filter((e) => e.IncludeInAPI);
-        const excludedSchemaNames = configInfo.excludeSchemas.map(s => s.toLowerCase());
-        const includedEntities = apiEntities.filter((e) => !excludedSchemaNames.includes(e.SchemaName.trim().toLowerCase()));
+        const excludedSchemaNames = configInfo.excludeSchemas.map(s => schemaKey(s));
+        const includedEntities = apiEntities.filter((e) => !excludedSchemaNames.includes(schemaKey(e.SchemaName)));
         const excludedCount = apiEntities.length - includedEntities.length;
         if (excludedCount > 0) {
             const excludedBySchema = apiEntities
-                .filter((e) => excludedSchemaNames.includes(e.SchemaName.trim().toLowerCase()))
+                .filter((e) => excludedSchemaNames.includes(schemaKey(e.SchemaName)))
                 .reduce((acc, e) => {
-                const schema = e.SchemaName.trim();
+                const schema = (e.SchemaName ?? '').trim() || '(none)';
                 acc[schema] = (acc[schema] || 0) + 1;
                 return acc;
             }, {});
@@ -467,8 +557,8 @@ export class RunCodeGenBase {
                 .join(', ');
             logStatus('Excluded ' + excludedCount + ' entities from code generation by schema: ' + schemaDetails);
         }
-        const coreEntities = includedEntities.filter((e) => e.SchemaName.trim().toLowerCase() === mjCoreSchema.trim().toLowerCase());
-        const nonCoreEntities = includedEntities.filter((e) => e.SchemaName.trim().toLowerCase() !== mjCoreSchema.trim().toLowerCase());
+        const coreEntities = includedEntities.filter((e) => schemaKey(e.SchemaName) === schemaKey(mjCoreSchema));
+        const nonCoreEntities = includedEntities.filter((e) => schemaKey(e.SchemaName) !== schemaKey(mjCoreSchema));
         // Entities whose schemas are owned by OTHER packages (see entityPackageName map). They must be
         // excluded from every artifact this package emits — GraphQL ObjectTypes included. If two packages
         // both emit an ObjectType for the same entity, graphql-js rejects the unified schema at boot with
@@ -476,7 +566,7 @@ export class RunCodeGenBase {
         // crash-loops.
         const externalSchemas = getExternalEntitySchemas().map(s => s.toLowerCase());
         const localNonCoreEntities = externalSchemas.length > 0
-            ? nonCoreEntities.filter(e => !externalSchemas.includes(e.SchemaName.toLowerCase()))
+            ? nonCoreEntities.filter(e => !externalSchemas.includes(schemaKey(e.SchemaName)))
             : nonCoreEntities;
         const isVerbose = configInfo?.verboseOutput ?? false;
         if (!isVerbose)
@@ -486,7 +576,7 @@ export class RunCodeGenBase {
             if (isVerbose)
                 startSpinner('Generating CORE Entity GraphQL Resolver Code...');
             const graphQLGenerator = MJGlobal.Instance.ClassFactory.CreateInstance(GraphQLServerGeneratorBase);
-            const ok = await reporter.phase('generateGraphQLCore', async () => graphQLGenerator.generateGraphQLServerCode(coreEntities, graphQLCoreResolversOutputDir, '@memberjunction/core-entities', true));
+            const ok = await reporter.phase('generateGraphQLCore', async () => graphQLGenerator.generateGraphQLServerCode(coreEntities, graphQLCoreResolversOutputDir, '@memberjunction/core-entities', true, this.buildSchemaEmitOptions(coreEntities, skipDB)));
             if (!ok) {
                 failSpinner('Error generating GraphQL server code');
                 return false;
@@ -502,7 +592,16 @@ export class RunCodeGenBase {
             const entityPackageName = typeof configInfo.entityPackageName === 'string'
                 ? (configInfo.entityPackageName || 'mj_generatedentities')
                 : 'mj_generatedentities';
-            const ok = await reporter.phase('generateGraphQL', async () => graphQLGenerator.generateGraphQLServerCode(localNonCoreEntities, graphqlOutputDir, entityPackageName, false));
+            const graphqlGroups = partitionEntitiesByOutputDirectory(localNonCoreEntities, 'GraphQLServer', graphqlOutputDir, configInfo.schemaOutput);
+            const ok = await reporter.phase('generateGraphQL', async () => {
+                for (const [dir, group] of graphqlGroups) {
+                    const groupOk = graphQLGenerator.generateGraphQLServerCode(group, dir, entityPackageName, false, this.buildSchemaEmitOptions(group, skipDB));
+                    if (!groupOk) {
+                        return false;
+                    }
+                }
+                return true;
+            });
             if (!ok) {
                 failSpinner('Error generating GraphQL Resolver code');
                 return false;
@@ -517,7 +616,7 @@ export class RunCodeGenBase {
             if (isVerbose)
                 startSpinner('Generating CORE Entity Subclass Code...');
             const entitySubClassGeneratorObject = MJGlobal.Instance.ClassFactory.CreateInstance(EntitySubClassGeneratorBase);
-            const ok = await reporter.phase('generateEntitySubclassesCore', () => entitySubClassGeneratorObject.generateAllEntitySubClasses(conn, coreEntities, coreEntitySubClassOutputDir, skipDB));
+            const ok = await reporter.phase('generateEntitySubclassesCore', () => entitySubClassGeneratorObject.generateAllEntitySubClasses(conn, coreEntities, coreEntitySubClassOutputDir, skipDB, this.buildSchemaEmitOptions(coreEntities, skipDB)));
             if (!ok) {
                 failSpinner('Error generating entity subclass code');
                 return false;
@@ -530,7 +629,16 @@ export class RunCodeGenBase {
             if (isVerbose)
                 startSpinner('Generating Entity Subclass Code...');
             const entitySubClassGeneratorObject = MJGlobal.Instance.ClassFactory.CreateInstance(EntitySubClassGeneratorBase);
-            const ok = await reporter.phase('generateEntitySubclasses', () => entitySubClassGeneratorObject.generateAllEntitySubClasses(conn, localNonCoreEntities, entitySubClassOutputDir, skipDB));
+            const entityGroups = partitionEntitiesByOutputDirectory(localNonCoreEntities, 'EntitySubClasses', entitySubClassOutputDir, configInfo.schemaOutput);
+            const ok = await reporter.phase('generateEntitySubclasses', async () => {
+                for (const [dir, group] of entityGroups) {
+                    const groupOk = await entitySubClassGeneratorObject.generateAllEntitySubClasses(conn, group, dir, skipDB, this.buildSchemaEmitOptions(group, skipDB));
+                    if (!groupOk) {
+                        return false;
+                    }
+                }
+                return true;
+            });
             if (!ok) {
                 failSpinner('Error generating entity subclass code');
                 return false;
@@ -558,7 +666,16 @@ export class RunCodeGenBase {
             if (isVerbose)
                 startSpinner('Generating Angular Code...');
             const angularGenerator = MJGlobal.Instance.ClassFactory.CreateInstance(AngularClientGeneratorBase);
-            const ok = await reporter.phase('generateAngular', () => angularGenerator.generateAngularCode(localNonCoreEntities, angularOutputDir, '', currentUser));
+            const angularGroups = partitionEntitiesByOutputDirectory(localNonCoreEntities, 'Angular', angularOutputDir, configInfo.schemaOutput);
+            const ok = await reporter.phase('generateAngular', async () => {
+                for (const [dir, group] of angularGroups) {
+                    const groupOk = angularGenerator.generateAngularCode(group, dir, '', currentUser);
+                    if (!groupOk) {
+                        return false;
+                    }
+                }
+                return true;
+            });
             if (!ok) {
                 failSpinner('Error generating Angular code');
                 return false;
@@ -644,6 +761,15 @@ export class RunCodeGenBase {
         }
         else if (isVerbose)
             warnSpinner('Remote Operations output directory NOT found in config file, skipping...');
+        const emit = EmitStats.Snapshot();
+        reporter.counter('filesWritten', emit.filesWritten);
+        reporter.counter('filesSkipped', emit.filesSkipped);
+        reporter.counter('schemasEmitted', emit.schemasEmitted);
+        reporter.counter('schemasSkipped', emit.schemasSkipped);
+        reporter.mark('emitStats', emit);
+        logStatus(`File emit: wrote ${emit.filesWritten}, skipped ${emit.filesSkipped}, ` +
+            `schemas emitted ${emit.schemasEmitted} / skipped ${emit.schemasSkipped} ` +
+            `(assemble ${emit.assembleMs}ms)`);
         SQLLogging.finishSQLLogging();
         if (!isVerbose)
             succeedSpinner('TypeScript code generation completed');