@memberjunction/integration-schema-builder 0.0.1 → 5.8.0

package/dist/AccessControl.d.ts

@@ -0,0 +1,26 @@
+/**
+ * AccessControl — enforces which MJ entities can be targeted by integrations.
+ * Two layers: hardcoded blocklist + EntitySetting check for __mj entities.
+ */
+import type { AccessControlResult } from './interfaces.js';
+/**
+ * Check if an entity is on the hardcoded blocklist.
+ */
+export declare function IsEntityBlocked(entityName: string): boolean;
+/**
+ * Check if an integration is allowed to write to a given entity.
+ *
+ * Rules:
+ * 1. Blocked entities → always denied
+ * 2. Non-__mj schema entities → always allowed (custom schemas are user-controlled)
+ * 3. __mj entities → allowed only if IntegrationWriteAllowed = 'true' in EntitySettings
+ */
+export declare function IsIntegrationWriteAllowed(entityName: string, schemaName: string, entitySettings: Array<{
+    Name: string;
+    Value: string;
+}>): AccessControlResult;
+/**
+ * Get the list of blocked entity names.
+ */
+export declare function GetBlockedEntities(): ReadonlyArray<string>;
+//# sourceMappingURL=AccessControl.d.ts.map

package/dist/AccessControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccessControl.d.ts","sourceRoot":"","sources":["../src/AccessControl.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAuB3D;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACrC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GACvD,mBAAmB,CA6BrB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,aAAa,CAAC,MAAM,CAAC,CAE1D"}

package/dist/AccessControl.js

@@ -0,0 +1,68 @@
+/**
+ * System entities that can NEVER be integration targets, regardless of settings.
+ */
+const BLOCKED_ENTITIES = [
+    'MJ: Entities',
+    'MJ: Entity Fields',
+    'MJ: Entity Relationships',
+    'MJ: Entity Permissions',
+    'Users',
+    'Roles',
+    'User Roles',
+    'Role Permissions',
+    'Applications',
+    'Application Entities',
+    'MJ: Entity Settings',
+    'MJ: Encryption Keys',
+    'MJ: Encryption Algorithms',
+    'MJ: Audit Log Types',
+    'MJ: Audit Logs',
+];
+/**
+ * Check if an entity is on the hardcoded blocklist.
+ */
+export function IsEntityBlocked(entityName) {
+    return BLOCKED_ENTITIES.includes(entityName);
+}
+/**
+ * Check if an integration is allowed to write to a given entity.
+ *
+ * Rules:
+ * 1. Blocked entities → always denied
+ * 2. Non-__mj schema entities → always allowed (custom schemas are user-controlled)
+ * 3. __mj entities → allowed only if IntegrationWriteAllowed = 'true' in EntitySettings
+ */
+export function IsIntegrationWriteAllowed(entityName, schemaName, entitySettings) {
+    if (IsEntityBlocked(entityName)) {
+        return {
+            Allowed: false,
+            Reason: `Entity "${entityName}" is on the system blocklist and cannot be an integration target.`,
+        };
+    }
+    // Non-__mj schemas are always allowed
+    if (schemaName !== '__mj') {
+        return {
+            Allowed: true,
+            Reason: `Entity "${entityName}" is in custom schema "${schemaName}" — integration writes allowed.`,
+        };
+    }
+    // __mj entity — check for IntegrationWriteAllowed setting
+    const setting = entitySettings.find(s => s.Name === 'IntegrationWriteAllowed');
+    if (setting && setting.Value === 'true') {
+        return {
+            Allowed: true,
+            Reason: `Entity "${entityName}" has IntegrationWriteAllowed=true.`,
+        };
+    }
+    return {
+        Allowed: false,
+        Reason: `Entity "${entityName}" is in __mj schema and does not have IntegrationWriteAllowed=true.`,
+    };
+}
+/**
+ * Get the list of blocked entity names.
+ */
+export function GetBlockedEntities() {
+    return BLOCKED_ENTITIES;
+}
+//# sourceMappingURL=AccessControl.js.map

package/dist/AccessControl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccessControl.js","sourceRoot":"","sources":["../src/AccessControl.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,gBAAgB,GAA0B;IAC5C,cAAc;IACd,mBAAmB;IACnB,0BAA0B;IAC1B,wBAAwB;IACxB,OAAO;IACP,OAAO;IACP,YAAY;IACZ,kBAAkB;IAClB,cAAc;IACd,sBAAsB;IACtB,qBAAqB;IACrB,qBAAqB;IACrB,2BAA2B;IAC3B,qBAAqB;IACrB,gBAAgB;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB;IAC9C,OAAO,gBAAgB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CACrC,UAAkB,EAClB,UAAkB,EAClB,cAAsD;IAEtD,IAAI,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,OAAO;YACH,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,WAAW,UAAU,mEAAmE;SACnG,CAAC;IACN,CAAC;IAED,sCAAsC;IACtC,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QACxB,OAAO;YACH,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,WAAW,UAAU,0BAA0B,UAAU,iCAAiC;SACrG,CAAC;IACN,CAAC;IAED,0DAA0D;IAC1D,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,yBAAyB,CAAC,CAAC;IAC/E,IAAI,OAAO,IAAI,OAAO,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QACtC,OAAO;YACH,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,WAAW,UAAU,qCAAqC;SACrE,CAAC;IACN,CAAC;IAED,OAAO;QACH,OAAO,EAAE,KAAK;QACd,MAAM,EAAE,WAAW,UAAU,qEAAqE;KACrG,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAC9B,OAAO,gBAAgB,CAAC;AAC5B,CAAC"}

package/dist/DDLGenerator.d.ts

@@ -0,0 +1,30 @@
+/**
+ * DDLGenerator — produces CREATE TABLE / ALTER TABLE SQL strings.
+ * File-emission only — never executes SQL.
+ */
+import type { DatabasePlatform, TargetColumnConfig, TargetTableConfig, ColumnModification } from './interfaces.js';
+/**
+ * Generates DDL SQL for creating and altering integration tables.
+ */
+export declare class DDLGenerator {
+    /**
+     * Generate CREATE SCHEMA IF NOT EXISTS statement.
+     */
+    GenerateCreateSchema(schemaName: string, platform: DatabasePlatform): string;
+    /**
+     * Generate a full CREATE TABLE statement with standard integration columns.
+     */
+    GenerateCreateTable(config: TargetTableConfig, platform: DatabasePlatform): string;
+    /**
+     * Generate ALTER TABLE ADD COLUMN statement.
+     */
+    GenerateAlterTableAddColumn(schemaName: string, tableName: string, column: TargetColumnConfig, platform: DatabasePlatform): string;
+    /**
+     * Generate ALTER TABLE ALTER COLUMN statement for type/nullability changes.
+     */
+    GenerateAlterTableAlterColumn(schemaName: string, tableName: string, mod: ColumnModification, platform: DatabasePlatform): string;
+    private StandardColumns;
+}
+/** Validates that an identifier contains only safe characters. */
+export declare function ValidateIdentifier(name: string, kind: string): void;
+//# sourceMappingURL=DDLGenerator.d.ts.map

package/dist/DDLGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DDLGenerator.d.ts","sourceRoot":"","sources":["../src/DDLGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAKnH;;GAEG;AACH,qBAAa,YAAY;IACrB;;OAEG;IACH,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM;IAQ5E;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM;IA8BlF;;OAEG;IACH,2BAA2B,CACvB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,gBAAgB,GAC3B,MAAM;IAgBT;;OAEG;IACH,6BAA6B,CACzB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,kBAAkB,EACvB,QAAQ,EAAE,gBAAgB,GAC3B,MAAM;IAeT,OAAO,CAAC,eAAe;CAmB1B;AAYD,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAInE"}

package/dist/DDLGenerator.js

@@ -0,0 +1,107 @@
+/** Characters allowed in identifiers (schema, table, column names). */
+const IDENTIFIER_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/**
+ * Generates DDL SQL for creating and altering integration tables.
+ */
+export class DDLGenerator {
+    /**
+     * Generate CREATE SCHEMA IF NOT EXISTS statement.
+     */
+    GenerateCreateSchema(schemaName, platform) {
+        ValidateIdentifier(schemaName, 'schema');
+        if (platform === 'sqlserver') {
+            return `IF NOT EXISTS (SELECT 1 FROM sys.schemas WHERE name = '${schemaName}')\n    EXEC('CREATE SCHEMA [${schemaName}]');\nGO`;
+        }
+        return `CREATE SCHEMA IF NOT EXISTS "${schemaName}";`;
+    }
+    /**
+     * Generate a full CREATE TABLE statement with standard integration columns.
+     */
+    GenerateCreateTable(config, platform) {
+        ValidateIdentifier(config.SchemaName, 'schema');
+        ValidateIdentifier(config.TableName, 'table');
+        const q = platform === 'sqlserver' ? QuoteSqlServer : QuotePostgres;
+        const fullTable = `${q(config.SchemaName)}.${q(config.TableName)}`;
+        const lines = [];
+        // Standard columns
+        lines.push(...this.StandardColumns(platform));
+        // User-configured columns
+        for (const col of config.Columns) {
+            ValidateIdentifier(col.TargetColumnName, 'column');
+            const nullable = col.IsNullable ? 'NULL' : 'NOT NULL';
+            const defaultExpr = col.DefaultValue != null ? ` DEFAULT ${col.DefaultValue}` : '';
+            lines.push(`    ${q(col.TargetColumnName)} ${col.TargetSqlType} ${nullable}${defaultExpr}`);
+        }
+        // Constraints
+        const pkName = `PK_${config.SchemaName}_${config.TableName}`;
+        const uqName = `UQ_${config.SchemaName}_${config.TableName}_SourceRecordID`;
+        lines.push(`    CONSTRAINT ${q(pkName)} PRIMARY KEY (${q('ID')})`);
+        lines.push(`    CONSTRAINT ${q(uqName)} UNIQUE (${q('SourceRecordID')})`);
+        const body = lines.join(',\n');
+        return `CREATE TABLE ${fullTable} (\n${body}\n);`;
+    }
+    /**
+     * Generate ALTER TABLE ADD COLUMN statement.
+     */
+    GenerateAlterTableAddColumn(schemaName, tableName, column, platform) {
+        ValidateIdentifier(schemaName, 'schema');
+        ValidateIdentifier(tableName, 'table');
+        ValidateIdentifier(column.TargetColumnName, 'column');
+        const q = platform === 'sqlserver' ? QuoteSqlServer : QuotePostgres;
+        const fullTable = `${q(schemaName)}.${q(tableName)}`;
+        const nullable = column.IsNullable ? 'NULL' : 'NOT NULL';
+        const defaultExpr = column.DefaultValue != null ? ` DEFAULT ${column.DefaultValue}` : '';
+        if (platform === 'sqlserver') {
+            return `ALTER TABLE ${fullTable}\n    ADD ${q(column.TargetColumnName)} ${column.TargetSqlType} ${nullable}${defaultExpr};`;
+        }
+        return `ALTER TABLE ${fullTable}\n    ADD COLUMN ${q(column.TargetColumnName)} ${column.TargetSqlType} ${nullable}${defaultExpr};`;
+    }
+    /**
+     * Generate ALTER TABLE ALTER COLUMN statement for type/nullability changes.
+     */
+    GenerateAlterTableAlterColumn(schemaName, tableName, mod, platform) {
+        ValidateIdentifier(schemaName, 'schema');
+        ValidateIdentifier(tableName, 'table');
+        ValidateIdentifier(mod.ColumnName, 'column');
+        const q = platform === 'sqlserver' ? QuoteSqlServer : QuotePostgres;
+        const fullTable = `${q(schemaName)}.${q(tableName)}`;
+        const nullable = mod.NewNullable ? 'NULL' : 'NOT NULL';
+        if (platform === 'sqlserver') {
+            return `ALTER TABLE ${fullTable}\n    ALTER COLUMN ${q(mod.ColumnName)} ${mod.NewType} ${nullable};`;
+        }
+        return `ALTER TABLE ${fullTable}\n    ALTER COLUMN ${q(mod.ColumnName)} TYPE ${mod.NewType},\n    ALTER COLUMN ${q(mod.ColumnName)} ${mod.NewNullable ? 'DROP NOT NULL' : 'SET NOT NULL'};`;
+    }
+    StandardColumns(platform) {
+        const q = platform === 'sqlserver' ? QuoteSqlServer : QuotePostgres;
+        if (platform === 'sqlserver') {
+            return [
+                `    ${q('ID')} UNIQUEIDENTIFIER NOT NULL DEFAULT NEWSEQUENTIALID()`,
+                `    ${q('SourceRecordID')} NVARCHAR(255) NOT NULL`,
+                `    ${q('SourceJSON')} NVARCHAR(MAX) NULL`,
+                `    ${q('SyncStatus')} NVARCHAR(50) NOT NULL DEFAULT 'Active'`,
+                `    ${q('LastSyncedAt')} DATETIMEOFFSET NULL`,
+            ];
+        }
+        return [
+            `    ${q('ID')} UUID NOT NULL DEFAULT gen_random_uuid()`,
+            `    ${q('SourceRecordID')} VARCHAR(255) NOT NULL`,
+            `    ${q('SourceJSON')} TEXT NULL`,
+            `    ${q('SyncStatus')} VARCHAR(50) NOT NULL DEFAULT 'Active'`,
+            `    ${q('LastSyncedAt')} TIMESTAMPTZ NULL`,
+        ];
+    }
+}
+// ─── Helpers ────────────────────────────────────────────────────────
+function QuoteSqlServer(name) {
+    return `[${name}]`;
+}
+function QuotePostgres(name) {
+    return `"${name}"`;
+}
+/** Validates that an identifier contains only safe characters. */
+export function ValidateIdentifier(name, kind) {
+    if (!IDENTIFIER_RE.test(name)) {
+        throw new Error(`Invalid ${kind} name "${name}": must match ${IDENTIFIER_RE.source}`);
+    }
+}
+//# sourceMappingURL=DDLGenerator.js.map

package/dist/DDLGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DDLGenerator.js","sourceRoot":"","sources":["../src/DDLGenerator.ts"],"names":[],"mappings":"AAMA,uEAAuE;AACvE,MAAM,aAAa,GAAG,0BAA0B,CAAC;AAEjD;;GAEG;AACH,MAAM,OAAO,YAAY;IACrB;;OAEG;IACH,oBAAoB,CAAC,UAAkB,EAAE,QAA0B;QAC/D,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACzC,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC3B,OAAO,0DAA0D,UAAU,gCAAgC,UAAU,UAAU,CAAC;QACpI,CAAC;QACD,OAAO,gCAAgC,UAAU,IAAI,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,MAAyB,EAAE,QAA0B;QACrE,kBAAkB,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAChD,kBAAkB,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAE9C,MAAM,CAAC,GAAG,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC;QACpE,MAAM,SAAS,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAEnE,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,mBAAmB;QACnB,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;QAE9C,0BAA0B;QAC1B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/B,kBAAkB,CAAC,GAAG,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;YACnD,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;YACtD,MAAM,WAAW,GAAG,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnF,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,aAAa,IAAI,QAAQ,GAAG,WAAW,EAAE,CAAC,CAAC;QAChG,CAAC;QAED,cAAc;QACd,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QAC7D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,SAAS,iBAAiB,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAE1E,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/B,OAAO,gBAAgB,SAAS,OAAO,IAAI,MAAM,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,2BAA2B,CACvB,UAAkB,EAClB,SAAiB,EACjB,MAA0B,EAC1B,QAA0B;QAE1B,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACzC,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACvC,kBAAkB,CAAC,MAAM,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QAEtD,MAAM,CAAC,GAAG,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC;QACpE,MAAM,SAAS,GAAG,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;QACzD,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAEzF,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC3B,OAAO,eAAe,SAAS,aAAa,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,MAAM,CAAC,aAAa,IAAI,QAAQ,GAAG,WAAW,GAAG,CAAC;QAChI,CAAC;QACD,OAAO,eAAe,SAAS,oBAAoB,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,MAAM,CAAC,aAAa,IAAI,QAAQ,GAAG,WAAW,GAAG,CAAC;IACvI,CAAC;IAED;;OAEG;IACH,6BAA6B,CACzB,UAAkB,EAClB,SAAiB,EACjB,GAAuB,EACvB,QAA0B;QAE1B,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACzC,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACvC,kBAAkB,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAE7C,MAAM,CAAC,GAAG,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC;QACpE,MAAM,SAAS,GAAG,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;QAEvD,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC3B,OAAO,eAAe,SAAS,sBAAsB,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,OAAO,IAAI,QAAQ,GAAG,CAAC;QACzG,CAAC;QACD,OAAO,eAAe,SAAS,sBAAsB,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC;IAChM,CAAC;IAEO,eAAe,CAAC,QAA0B;QAC9C,MAAM,CAAC,GAAG,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC;QACpE,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC3B,OAAO;gBACH,OAAO,CAAC,CAAC,IAAI,CAAC,sDAAsD;gBACpE,OAAO,CAAC,CAAC,gBAAgB,CAAC,yBAAyB;gBACnD,OAAO,CAAC,CAAC,YAAY,CAAC,qBAAqB;gBAC3C,OAAO,CAAC,CAAC,YAAY,CAAC,yCAAyC;gBAC/D,OAAO,CAAC,CAAC,cAAc,CAAC,sBAAsB;aACjD,CAAC;QACN,CAAC;QACD,OAAO;YACH,OAAO,CAAC,CAAC,IAAI,CAAC,0CAA0C;YACxD,OAAO,CAAC,CAAC,gBAAgB,CAAC,wBAAwB;YAClD,OAAO,CAAC,CAAC,YAAY,CAAC,YAAY;YAClC,OAAO,CAAC,CAAC,YAAY,CAAC,wCAAwC;YAC9D,OAAO,CAAC,CAAC,cAAc,CAAC,mBAAmB;SAC9C,CAAC;IACN,CAAC;CACJ;AAED,uEAAuE;AAEvE,SAAS,cAAc,CAAC,IAAY;IAChC,OAAO,IAAI,IAAI,GAAG,CAAC;AACvB,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IAC/B,OAAO,IAAI,IAAI,GAAG,CAAC;AACvB,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,IAAY;IACzD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,UAAU,IAAI,iBAAiB,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1F,CAAC;AACL,CAAC"}

package/dist/MetadataEmitter.d.ts

@@ -0,0 +1,23 @@
+/**
+ * MetadataEmitter — produces /metadata/ JSON files for mj-sync.
+ * Generates EntitySettings (e.g., IntegrationWriteAllowed) and mj-sync config.
+ */
+import type { EmittedFile } from './interfaces.js';
+/**
+ * Produces metadata JSON files for the mj-sync push pipeline.
+ */
+export declare class MetadataEmitter {
+    /**
+     * Generate a single EntitySettings JSON object for an entity.
+     */
+    GenerateEntitySettingsRecord(entityName: string, settings: Record<string, string>): Record<string, unknown>;
+    /**
+     * Emit the IntegrationWriteAllowed EntitySettings file for a set of entities.
+     */
+    EmitEntitySettingsFile(entityNames: string[], metadataDir: string): EmittedFile;
+    /**
+     * Emit the .mj-sync.json config for the entity-settings directory.
+     */
+    EmitMjSyncConfig(metadataDir: string): EmittedFile;
+}
+//# sourceMappingURL=MetadataEmitter.d.ts.map

package/dist/MetadataEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetadataEmitter.d.ts","sourceRoot":"","sources":["../src/MetadataEmitter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;GAEG;AACH,qBAAa,eAAe;IACxB;;OAEG;IACH,4BAA4B,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAoB3G;;OAEG;IACH,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,WAAW;IAY/E;;OAEG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW;CAYrD"}

package/dist/MetadataEmitter.js

@@ -0,0 +1,52 @@
+/**
+ * Produces metadata JSON files for the mj-sync push pipeline.
+ */
+export class MetadataEmitter {
+    /**
+     * Generate a single EntitySettings JSON object for an entity.
+     */
+    GenerateEntitySettingsRecord(entityName, settings) {
+        const settingsRecords = Object.entries(settings).map(([name, value]) => ({
+            fields: {
+                Name: name,
+                Value: value,
+                Comments: `Managed by Integration Schema Builder`,
+            },
+        }));
+        return {
+            fields: { Name: entityName },
+            relatedEntities: {
+                'MJ: Entity Settings': settingsRecords,
+            },
+            primaryKey: {
+                ID: `@lookup:MJ: Entities.Name=${entityName}`,
+            },
+        };
+    }
+    /**
+     * Emit the IntegrationWriteAllowed EntitySettings file for a set of entities.
+     */
+    EmitEntitySettingsFile(entityNames, metadataDir) {
+        const records = entityNames.map(name => this.GenerateEntitySettingsRecord(name, { IntegrationWriteAllowed: 'true' }));
+        return {
+            FilePath: `${metadataDir}/entity-settings/.integration-write-allowed.json`,
+            Content: JSON.stringify(records, null, 2) + '\n',
+            Description: `EntitySettings: IntegrationWriteAllowed=true for ${entityNames.join(', ')}`,
+        };
+    }
+    /**
+     * Emit the .mj-sync.json config for the entity-settings directory.
+     */
+    EmitMjSyncConfig(metadataDir) {
+        const config = {
+            entity: 'MJ: Entities',
+            filePattern: '**/.*.json',
+        };
+        return {
+            FilePath: `${metadataDir}/entity-settings/.mj-sync.json`,
+            Content: JSON.stringify(config, null, 2) + '\n',
+            Description: 'mj-sync configuration for entity-settings directory',
+        };
+    }
+}
+//# sourceMappingURL=MetadataEmitter.js.map

package/dist/MetadataEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetadataEmitter.js","sourceRoot":"","sources":["../src/MetadataEmitter.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,OAAO,eAAe;IACxB;;OAEG;IACH,4BAA4B,CAAC,UAAkB,EAAE,QAAgC;QAC7E,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACrE,MAAM,EAAE;gBACJ,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,KAAK;gBACZ,QAAQ,EAAE,uCAAuC;aACpD;SACJ,CAAC,CAAC,CAAC;QAEJ,OAAO;YACH,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;YAC5B,eAAe,EAAE;gBACb,qBAAqB,EAAE,eAAe;aACzC;YACD,UAAU,EAAE;gBACR,EAAE,EAAE,6BAA6B,UAAU,EAAE;aAChD;SACJ,CAAC;IACN,CAAC;IAED;;OAEG;IACH,sBAAsB,CAAC,WAAqB,EAAE,WAAmB;QAC7D,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CACnC,IAAI,CAAC,4BAA4B,CAAC,IAAI,EAAE,EAAE,uBAAuB,EAAE,MAAM,EAAE,CAAC,CAC/E,CAAC;QAEF,OAAO;YACH,QAAQ,EAAE,GAAG,WAAW,kDAAkD;YAC1E,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI;YAChD,WAAW,EAAE,oDAAoD,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SAC5F,CAAC;IACN,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,WAAmB;QAChC,MAAM,MAAM,GAAG;YACX,MAAM,EAAE,cAAc;YACtB,WAAW,EAAE,YAAY;SAC5B,CAAC;QAEF,OAAO;YACH,QAAQ,EAAE,GAAG,WAAW,gCAAgC;YACxD,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI;YAC/C,WAAW,EAAE,qDAAqD;SACrE,CAAC;IACN,CAAC;CACJ"}

package/dist/MigrationFileWriter.d.ts

@@ -0,0 +1,25 @@
+/**
+ * MigrationFileWriter — wraps DDL in properly-named Flyway migration files.
+ * File-emission only — produces EmittedFile objects, never writes to disk.
+ */
+import type { EmittedFile, MigrationMetadata } from './interfaces.js';
+/**
+ * Produces Flyway-compatible migration file names and content.
+ */
+export declare class MigrationFileWriter {
+    /**
+     * Generate a Flyway-compatible migration file name.
+     * Format: V{YYYYMMDDHHMM}__v{VERSION}.x_Integration_{Source}_{Action}.sql
+     */
+    GenerateMigrationFileName(sourceType: string, action: string, mjVersion: string, migrationsDir: string, timestamp: Date): string;
+    /**
+     * Wrap DDL content in a migration file with a header comment.
+     */
+    WrapInMigrationFile(ddl: string, metadata: MigrationMetadata, filePath: string): EmittedFile;
+    /**
+     * Generate a sequence of timestamps, each 1 minute apart,
+     * for ordering multiple migrations correctly.
+     */
+    GenerateTimestampSequence(count: number, startTime?: Date): Date[];
+}
+//# sourceMappingURL=MigrationFileWriter.d.ts.map

package/dist/MigrationFileWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrationFileWriter.d.ts","sourceRoot":"","sources":["../src/MigrationFileWriter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEtE;;GAEG;AACH,qBAAa,mBAAmB;IAC5B;;;OAGG;IACH,yBAAyB,CACrB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,IAAI,GAChB,MAAM;IAOT;;OAEG;IACH,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW;IAwB5F;;;OAGG;IACH,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,IAAiB,GAAG,IAAI,EAAE;CAQjF"}

package/dist/MigrationFileWriter.js

@@ -0,0 +1,67 @@
+/**
+ * Produces Flyway-compatible migration file names and content.
+ */
+export class MigrationFileWriter {
+    /**
+     * Generate a Flyway-compatible migration file name.
+     * Format: V{YYYYMMDDHHMM}__v{VERSION}.x_Integration_{Source}_{Action}.sql
+     */
+    GenerateMigrationFileName(sourceType, action, mjVersion, migrationsDir, timestamp) {
+        const ts = FormatTimestamp(timestamp);
+        const safeSrc = SanitizeForFileName(sourceType);
+        const safeAction = SanitizeForFileName(action);
+        return `${migrationsDir}/V${ts}__v${mjVersion}.x_Integration_${safeSrc}_${safeAction}.sql`;
+    }
+    /**
+     * Wrap DDL content in a migration file with a header comment.
+     */
+    WrapInMigrationFile(ddl, metadata, filePath) {
+        const header = [
+            `-- ============================================================`,
+            `-- Auto-generated by MJ Integration Schema Builder`,
+            `-- Source: ${metadata.SourceType} | Object: ${metadata.ObjectName}`,
+            `-- Action: ${metadata.Action}`,
+            `-- Generated: ${metadata.Timestamp}`,
+            `-- Generated By: ${metadata.GeneratedBy}`,
+            `-- ============================================================`,
+            `-- NOTE: __mj_CreatedAt, __mj_UpdatedAt, FK indexes, views, and SPs`,
+            `--       are created by CodeGen — do NOT add them here.`,
+            `-- NOTE: Foreign keys are soft FKs defined in additionalSchemaInfo,`,
+            `--       applied by CodeGen — no FK constraints in this migration.`,
+            `-- ============================================================`,
+            ``,
+        ].join('\n');
+        return {
+            FilePath: filePath,
+            Content: header + ddl + '\n',
+            Description: `Migration: ${metadata.Action} for ${metadata.SourceType}.${metadata.ObjectName}`,
+        };
+    }
+    /**
+     * Generate a sequence of timestamps, each 1 minute apart,
+     * for ordering multiple migrations correctly.
+     */
+    GenerateTimestampSequence(count, startTime = new Date()) {
+        const result = [];
+        for (let i = 0; i < count; i++) {
+            const ts = new Date(startTime.getTime() + i * 60_000);
+            result.push(ts);
+        }
+        return result;
+    }
+}
+// ─── Helpers ────────────────────────────────────────────────────────
+/** Format a Date as YYYYMMDDHHMM for Flyway versioning. */
+function FormatTimestamp(date) {
+    const y = date.getUTCFullYear();
+    const mo = String(date.getUTCMonth() + 1).padStart(2, '0');
+    const d = String(date.getUTCDate()).padStart(2, '0');
+    const h = String(date.getUTCHours()).padStart(2, '0');
+    const mi = String(date.getUTCMinutes()).padStart(2, '0');
+    return `${y}${mo}${d}${h}${mi}`;
+}
+/** Remove characters unsafe for file names. */
+function SanitizeForFileName(input) {
+    return input.replace(/[^A-Za-z0-9_]/g, '');
+}
+//# sourceMappingURL=MigrationFileWriter.js.map

package/dist/MigrationFileWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrationFileWriter.js","sourceRoot":"","sources":["../src/MigrationFileWriter.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,OAAO,mBAAmB;IAC5B;;;OAGG;IACH,yBAAyB,CACrB,UAAkB,EAClB,MAAc,EACd,SAAiB,EACjB,aAAqB,EACrB,SAAe;QAEf,MAAM,EAAE,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC/C,OAAO,GAAG,aAAa,KAAK,EAAE,MAAM,SAAS,kBAAkB,OAAO,IAAI,UAAU,MAAM,CAAC;IAC/F,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,GAAW,EAAE,QAA2B,EAAE,QAAgB;QAC1E,MAAM,MAAM,GAAG;YACX,iEAAiE;YACjE,oDAAoD;YACpD,cAAc,QAAQ,CAAC,UAAU,cAAc,QAAQ,CAAC,UAAU,EAAE;YACpE,cAAc,QAAQ,CAAC,MAAM,EAAE;YAC/B,iBAAiB,QAAQ,CAAC,SAAS,EAAE;YACrC,oBAAoB,QAAQ,CAAC,WAAW,EAAE;YAC1C,iEAAiE;YACjE,qEAAqE;YACrE,yDAAyD;YACzD,qEAAqE;YACrE,oEAAoE;YACpE,iEAAiE;YACjE,EAAE;SACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,OAAO;YACH,QAAQ,EAAE,QAAQ;YAClB,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI;YAC5B,WAAW,EAAE,cAAc,QAAQ,CAAC,MAAM,QAAQ,QAAQ,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAU,EAAE;SACjG,CAAC;IACN,CAAC;IAED;;;OAGG;IACH,yBAAyB,CAAC,KAAa,EAAE,YAAkB,IAAI,IAAI,EAAE;QACjE,MAAM,MAAM,GAAW,EAAE,CAAC;QAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7B,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;YACtD,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpB,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ;AAED,uEAAuE;AAEvE,2DAA2D;AAC3D,SAAS,eAAe,CAAC,IAAU;IAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;IAChC,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACrD,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACzD,OAAO,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC;AACpC,CAAC;AAED,+CAA+C;AAC/C,SAAS,mBAAmB,CAAC,KAAa;IACtC,OAAO,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;AAC/C,CAAC"}

package/dist/SchemaBuilder.d.ts

@@ -0,0 +1,27 @@
+/**
+ * SchemaBuilder — orchestrates the full schema generation pipeline.
+ * Pure function: takes input → produces output files. Never touches the database.
+ */
+import type { SchemaBuilderInput, SchemaBuilderOutput } from './interfaces.js';
+/**
+ * Main entry point for the Integration Schema Builder.
+ * Coordinates DDL generation, soft FK emission, metadata emission, and evolution diffs.
+ */
+export declare class SchemaBuilder {
+    private readonly DDL;
+    private readonly MigrationWriter;
+    private readonly SoftFKEmitter;
+    private readonly MetaEmitter;
+    private readonly Evolution;
+    /**
+     * Build all artifacts for a set of integration target tables.
+     */
+    BuildSchema(input: SchemaBuilderInput): SchemaBuilderOutput;
+    private ValidateAccessControl;
+    private CheckCollisions;
+    private ClassifyConfigs;
+    private GetUniqueSchemas;
+    private CollectSoftFKs;
+    private MakeMigrationMeta;
+}
+//# sourceMappingURL=SchemaBuilder.d.ts.map

package/dist/SchemaBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaBuilder.d.ts","sourceRoot":"","sources":["../src/SchemaBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAKR,kBAAkB,EAClB,mBAAmB,EAGtB,MAAM,iBAAiB,CAAC;AAQzB;;;GAGG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAsB;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6B;IAC7D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAC3D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IAEnD;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB;IAmG3D,OAAO,CAAC,qBAAqB;IAc7B,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,eAAe;IAyBvB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,cAAc;IAmBtB,OAAO,CAAC,iBAAiB;CAS5B"}

package/dist/SchemaBuilder.js

@@ -0,0 +1,167 @@
+import { DDLGenerator } from './DDLGenerator.js';
+import { MigrationFileWriter } from './MigrationFileWriter.js';
+import { SoftFKConfigEmitter } from './SoftFKConfigEmitter.js';
+import { MetadataEmitter } from './MetadataEmitter.js';
+import { SchemaEvolution } from './SchemaEvolution.js';
+import { IsIntegrationWriteAllowed } from './AccessControl.js';
+/**
+ * Main entry point for the Integration Schema Builder.
+ * Coordinates DDL generation, soft FK emission, metadata emission, and evolution diffs.
+ */
+export class SchemaBuilder {
+    constructor() {
+        this.DDL = new DDLGenerator();
+        this.MigrationWriter = new MigrationFileWriter();
+        this.SoftFKEmitter = new SoftFKConfigEmitter();
+        this.MetaEmitter = new MetadataEmitter();
+        this.Evolution = new SchemaEvolution();
+    }
+    /**
+     * Build all artifacts for a set of integration target tables.
+     */
+    BuildSchema(input) {
+        const output = {
+            MigrationFiles: [],
+            AdditionalSchemaInfoUpdate: null,
+            MetadataFiles: [],
+            Warnings: [],
+            Errors: [],
+        };
+        // Step 1: Validate access control
+        const accessErrors = this.ValidateAccessControl(input);
+        if (accessErrors.length > 0) {
+            output.Errors.push(...accessErrors);
+            return output;
+        }
+        // Step 2: Pre-flight collision checks
+        const collisionWarnings = this.CheckCollisions(input);
+        output.Warnings.push(...collisionWarnings);
+        // Step 3: Separate new tables vs evolution
+        const { newConfigs, evolutionConfigs } = this.ClassifyConfigs(input);
+        // Step 4: Generate DDL migrations
+        const now = new Date();
+        const allMigrations = [];
+        // Schema creation migrations (deduplicate by schema name)
+        const schemasToCreate = this.GetUniqueSchemas(newConfigs);
+        const timestamps = this.MigrationWriter.GenerateTimestampSequence(schemasToCreate.length + newConfigs.length + evolutionConfigs.length, now);
+        let tsIdx = 0;
+        for (const schemaName of schemasToCreate) {
+            const ddl = this.DDL.GenerateCreateSchema(schemaName, input.Platform);
+            const meta = this.MakeMigrationMeta(input, 'CreateSchema', schemaName);
+            const filePath = this.MigrationWriter.GenerateMigrationFileName(input.SourceType, `CreateSchema_${schemaName}`, input.MJVersion, input.MigrationsDir, timestamps[tsIdx++]);
+            allMigrations.push(this.MigrationWriter.WrapInMigrationFile(ddl, meta, filePath));
+        }
+        // Table creation migrations
+        for (const config of newConfigs) {
+            const ddl = this.DDL.GenerateCreateTable(config, input.Platform);
+            const meta = this.MakeMigrationMeta(input, `Create${config.TableName}Table`, config.TableName);
+            const filePath = this.MigrationWriter.GenerateMigrationFileName(input.SourceType, `Create${config.TableName}Table`, input.MJVersion, input.MigrationsDir, timestamps[tsIdx++]);
+            allMigrations.push(this.MigrationWriter.WrapInMigrationFile(ddl, meta, filePath));
+        }
+        // Evolution migrations (ALTER TABLE)
+        for (const { config, existing } of evolutionConfigs) {
+            const sourceObj = input.SourceSchema.Objects.find(o => o.ExternalName === config.SourceObjectName);
+            if (!sourceObj)
+                continue;
+            const diff = this.Evolution.DiffSchema(sourceObj, config, existing, input.Platform);
+            if (diff.AddedColumns.length === 0 && diff.ModifiedColumns.length === 0 && diff.RemovedColumns.length === 0) {
+                continue; // No changes
+            }
+            const ddl = this.Evolution.GenerateEvolutionMigration(diff, config.SchemaName, config.TableName, input.Platform);
+            const meta = this.MakeMigrationMeta(input, `Alter${config.TableName}`, config.TableName);
+            const filePath = this.MigrationWriter.GenerateMigrationFileName(input.SourceType, `Alter${config.TableName}`, input.MJVersion, input.MigrationsDir, timestamps[tsIdx++]);
+            allMigrations.push(this.MigrationWriter.WrapInMigrationFile(ddl, meta, filePath));
+        }
+        output.MigrationFiles = allMigrations;
+        // Step 5: Generate soft FK config
+        const allSoftFKs = this.CollectSoftFKs(input, evolutionConfigs);
+        if (allSoftFKs.length > 0) {
+            const existingConfig = this.SoftFKEmitter.ParseExistingConfig(null); // Caller provides existing content via input
+            const merged = this.SoftFKEmitter.MergeSchemaConfig(existingConfig, allSoftFKs);
+            output.AdditionalSchemaInfoUpdate = this.SoftFKEmitter.EmitConfigFile(input.AdditionalSchemaInfoPath, merged);
+        }
+        // Step 6: Generate metadata files for __mj entity targets
+        const mjTargets = input.TargetConfigs.filter(c => c.SchemaName === '__mj');
+        if (mjTargets.length > 0) {
+            const entityNames = mjTargets.map(c => c.EntityName);
+            output.MetadataFiles.push(this.MetaEmitter.EmitEntitySettingsFile(entityNames, input.MetadataDir));
+            output.MetadataFiles.push(this.MetaEmitter.EmitMjSyncConfig(input.MetadataDir));
+        }
+        return output;
+    }
+    ValidateAccessControl(input) {
+        const errors = [];
+        for (const config of input.TargetConfigs) {
+            if (config.SchemaName === '__mj') {
+                const settings = input.EntitySettingsForTargets[config.EntityName] ?? [];
+                const result = IsIntegrationWriteAllowed(config.EntityName, config.SchemaName, settings);
+                if (!result.Allowed) {
+                    errors.push(result.Reason);
+                }
+            }
+        }
+        return errors;
+    }
+    CheckCollisions(input) {
+        const warnings = [];
+        const existingNames = new Set(input.ExistingTables.map(t => `${t.SchemaName}.${t.TableName}`.toLowerCase()));
+        for (const config of input.TargetConfigs) {
+            const key = `${config.SchemaName}.${config.TableName}`.toLowerCase();
+            if (existingNames.has(key)) {
+                // Not necessarily an error — could be an evolution scenario
+                warnings.push(`Table ${config.SchemaName}.${config.TableName} already exists — will generate ALTER TABLE if fields differ.`);
+            }
+        }
+        return warnings;
+    }
+    ClassifyConfigs(input) {
+        const existingMap = new Map();
+        for (const t of input.ExistingTables) {
+            existingMap.set(`${t.SchemaName}.${t.TableName}`.toLowerCase(), t);
+        }
+        const newConfigs = [];
+        const evolutionConfigs = [];
+        for (const config of input.TargetConfigs) {
+            const key = `${config.SchemaName}.${config.TableName}`.toLowerCase();
+            const existing = existingMap.get(key);
+            if (existing) {
+                evolutionConfigs.push({ config, existing });
+            }
+            else {
+                newConfigs.push(config);
+            }
+        }
+        return { newConfigs, evolutionConfigs };
+    }
+    GetUniqueSchemas(configs) {
+        const schemas = new Set();
+        for (const config of configs) {
+            schemas.add(config.SchemaName);
+        }
+        return Array.from(schemas);
+    }
+    CollectSoftFKs(input, evolutionConfigs) {
+        // From source relationships
+        const fromSource = this.SoftFKEmitter.GenerateConfigEntries(input.SourceSchema, input.TargetConfigs);
+        // From evolution (new FK columns)
+        for (const { config, existing } of evolutionConfigs) {
+            const sourceObj = input.SourceSchema.Objects.find(o => o.ExternalName === config.SourceObjectName);
+            if (!sourceObj)
+                continue;
+            const diff = this.Evolution.DiffSchema(sourceObj, config, existing, input.Platform);
+            const newFKs = this.Evolution.GenerateEvolutionSoftFKUpdates(diff, config);
+            fromSource.push(...newFKs);
+        }
+        return fromSource;
+    }
+    MakeMigrationMeta(input, action, objectName) {
+        return {
+            SourceType: input.SourceType,
+            ObjectName: objectName,
+            Action: action,
+            GeneratedBy: 'MJ Integration Schema Builder',
+            Timestamp: new Date().toISOString(),
+        };
+    }
+}
+//# sourceMappingURL=SchemaBuilder.js.map