@memberjunction/ng-dashboards 5.30.0 → 5.31.0

package/dist/DatabaseDesigner/services/database-designer.engine.js

@@ -0,0 +1,392 @@
+/**
+ * @module database-designer.engine
+ * @description Read-only data access engine for the Database Designer Angular UI.
+ *
+ * `DatabaseDesignerEngine` is a `BaseSingleton` (NOT an Angular service) that:
+ *  - Loads the list of entities accessible to the current user
+ *  - Loads full entity detail for the modify wizard
+ *  - Loads available schemas from `MJ: Schema Info` (async, cached per-user)
+ *  - Checks whether a proposed entity name / table name is available
+ *
+ * ### Why BaseSingleton, not @Injectable?
+ * Engine classes hold a cross-request cache that must survive Angular's DI
+ * lifecycle boundaries (the same instance is reused across multiple wizard
+ * openings in the same session).  `BaseSingleton` uses the MJ Global Object
+ * Store which guarantees exactly one instance per process, even across ESBuild
+ * code-split chunks.
+ *
+ * ### Usage
+ * ```typescript
+ * const engine = DatabaseDesignerEngine.Instance;
+ * const entities = await engine.loadAccessibleEntities();
+ * ```
+ *
+ * @see DatabaseDesignerService — for action invocation (create, modify, validate)
+ */
+import { Metadata, RunView, AuthorizationEvaluator } from '@memberjunction/core';
+import { BaseSingleton, UUIDsEqual } from '@memberjunction/global';
+// ─── Constants (mirror database-designer-core/src/interfaces.ts) ───────────────
+// These string values MUST stay in sync with the server-side constants.
+// If the server-side values change, update here in parallel.
+const UDT_SCHEMA_NAME = '__mj_UDT';
+const UDT_SETTINGS = {
+    OWNER_KEY: 'MJ:UDT:Owner',
+    SOURCE_KEY: 'MJ:UDT:Source',
+    SOURCE_DATABASE_DESIGNER: 'DatabaseDesigner',
+    SOURCE_AGENT_MANAGER: 'AgentManager',
+};
+const ENTITY_DESIGNER_AUTH = {
+    CREATE_IN_UDT_SCHEMA: 'Create in UDT Schema',
+    CREATE_IN_CUSTOM_SCHEMA: 'Create in Custom Schema',
+    MODIFY_OWN_ENTITIES: 'Modify Own Entities',
+    MODIFY_ANY_UDT_ENTITIES: 'Modify Any UDT Entities',
+};
+/** Cache TTL in milliseconds (5 minutes). */
+const CACHE_TTL_MS = 5 * 60 * 1_000;
+// ─── Columns managed automatically by CodeGen (never shown as user-editable) ─
+/**
+ * Normalised lower-case set of column names that CodeGen injects on every entity.
+ * These are filtered out of the modify wizard so users cannot inadvertently remove or
+ * rename them.  The set is compared after calling `.toLowerCase()` on each column name
+ * so it is case-insensitive regardless of DB platform.
+ */
+const AUTO_MANAGED_COLUMNS = new Set(['id', '__mj_createdat', '__mj_updatedat']);
+// ─── Frontend-only schema blocklist ──────────────────────────────────────────
+// `MJ: Schema Info` only surfaces MJ-registered schemas, so system schemas
+// (sys, dbo, information_schema) never appear.  Only __mj must be blocked here.
+// Server-side RSM.GetAllProtectedSchemas() remains the authoritative gate.
+const FRONTEND_BLOCKED_SCHEMAS = new Set(['__mj']);
+// ─── Engine ──────────────────────────────────────────────────────────────────
+/**
+ * Singleton data access engine for Database Designer.
+ * All methods read data; none modifies state (mutations go through `DatabaseDesignerService`).
+ */
+export class DatabaseDesignerEngine extends BaseSingleton {
+    static get Instance() {
+        return super.getInstance();
+    }
+    constructor() { super(); }
+    // ─── Cache ────────────────────────────────────────────────────────────
+    /** Per-user entity list cache. Key = userID. */
+    _cache = new Map();
+    /** Per-user schema list cache. Key = userID. Invalidated alongside entity cache. */
+    _schemaCache = new Map();
+    /** Invalidate all per-user caches for the current user (call after create/modify). */
+    invalidateCache() {
+        const userId = new Metadata().CurrentUser?.ID; // global-provider-ok: client-side Angular engine, single provider
+        if (userId) {
+            this._cache.delete(userId);
+            this._schemaCache.delete(userId);
+        }
+    }
+    // ─── Entity list ──────────────────────────────────────────────────────
+    /**
+     * Load all entities accessible to the current user.
+     *
+     * - **Admin** (holds `Modify Any UDT Entities`): sees all entities created by
+     *   Database Designer or Agent Manager, with ownership annotations.
+     * - **Regular user**: sees only entities they own (`MJ:UDT:Owner = userId`).
+     *
+     * Results are cached per-user with a 5-minute TTL.
+     */
+    async loadAccessibleEntities() {
+        const md = new Metadata(); // global-provider-ok: client-side Angular engine, single provider
+        const userId = md.CurrentUser?.ID;
+        if (!userId)
+            return [];
+        const cached = this._cache.get(userId);
+        if (cached && Date.now() - cached.timestamp < CACHE_TTL_MS) {
+            return cached.entities;
+        }
+        const isAdmin = this.currentUserCanModifyAny();
+        const entities = isAdmin
+            ? await this.loadAllEntities(userId)
+            : await this.loadOwnedEntities(userId);
+        this._cache.set(userId, { entities, timestamp: Date.now() });
+        return entities;
+    }
+    /**
+     * Load full entity detail (columns, foreign keys, description) for the modify wizard.
+     * Not cached — always fetches fresh data so the wizard reflects current DB state.
+     */
+    async loadEntityDetail(entityId) {
+        const rv = new RunView();
+        // BypassCache: true on both queries because CodeGen writes Entity Fields via direct
+        // SQL (outside BaseEntity.Save()), so the server-side RunView cache never receives
+        // an invalidation event after a pipeline run.  Without this, the detail view would
+        // show stale field data (e.g. old AllowsNull value) until MJAPI restarts.
+        const [entityResult, fieldsResult] = await rv.RunViews([
+            {
+                EntityName: 'MJ: Entities',
+                ExtraFilter: `ID = '${escapeSqlId(entityId)}'`,
+                Fields: ['ID', 'Name', 'BaseTable', 'SchemaName', 'Description', '__mj_CreatedAt'],
+                ResultType: 'simple',
+                BypassCache: true,
+            },
+            {
+                EntityName: 'MJ: Entity Fields',
+                ExtraFilter: `EntityID = '${escapeSqlId(entityId)}' AND IsVirtual = 0`,
+                Fields: ['ID', 'EntityID', 'Name', 'Type', 'AllowsNull', 'Description', 'DefaultValue', 'MaxLength', 'Precision', 'Scale'],
+                OrderBy: 'Sequence ASC, Name ASC',
+                ResultType: 'simple',
+                BypassCache: true,
+            },
+        ]);
+        if (!entityResult.Success || entityResult.Results.length === 0)
+            return null;
+        const entity = entityResult.Results[0];
+        const fieldRows = (fieldsResult.Results ?? []);
+        const isOwner = await this.isCurrentUserOwner(entityId);
+        // Exclude auto-managed columns (ID, __mj_CreatedAt, __mj_UpdatedAt) from the editable
+        // column list.  CodeGen injects these automatically — they must not be user-modified.
+        const editableFields = fieldRows.filter(f => !AUTO_MANAGED_COLUMNS.has(f.Name.toLowerCase()));
+        return {
+            entityId: entity.ID,
+            entityName: entity.Name,
+            tableName: entity.BaseTable,
+            schemaName: entity.SchemaName,
+            description: entity.Description ?? '',
+            fieldCount: editableFields.length,
+            createdAt: new Date(entity.__mj_CreatedAt),
+            isOwner,
+            columns: editableFields.map(f => this.mapFieldToColumnSpec(f)),
+            foreignKeys: [], // FK detail loaded on demand — Phase 5e
+        };
+    }
+    // ─── Schema options ───────────────────────────────────────────────────
+    /**
+     * Return the list of schemas the current user is authorized to create tables in.
+     *
+     * Async — queries `MJ: Schema Info` to surface real DB schemas for users
+     * with `Create in Custom Schema` authorization.  Results are cached per-user
+     * with the same 5-minute TTL as the entity list.
+     *
+     * Order:
+     *   1. `__mj_UDT`  (if user holds `Create in UDT Schema`)
+     *   2. Real DB schemas from `MJ: Schema Info`, excluding blocked schemas
+     *      and `__mj_UDT` (already listed first)
+     *   3. "Other (enter schema name)" free-text option, at the end
+     *
+     * All items beyond #1 require `Create in Custom Schema` authorization.
+     */
+    async loadAvailableSchemas() {
+        const userId = new Metadata().CurrentUser?.ID; // global-provider-ok: client-side Angular engine, single provider
+        if (!userId)
+            return [];
+        const cached = this._schemaCache.get(userId);
+        if (cached && Date.now() - cached.timestamp < CACHE_TTL_MS) {
+            return cached.schemas;
+        }
+        const schemas = await this.fetchAvailableSchemas();
+        this._schemaCache.set(userId, { schemas, timestamp: Date.now() });
+        return schemas;
+    }
+    /** Build the schema option list: UDT first, then real DB schemas, then Other. */
+    async fetchAvailableSchemas() {
+        const md = new Metadata(); // global-provider-ok: client-side Angular engine, single provider
+        const evaluator = new AuthorizationEvaluator();
+        const udtAuth = md.Authorizations.find(a => a.Name === ENTITY_DESIGNER_AUTH.CREATE_IN_UDT_SCHEMA);
+        const customAuth = md.Authorizations.find(a => a.Name === ENTITY_DESIGNER_AUTH.CREATE_IN_CUSTOM_SCHEMA);
+        const canUseUdt = !!(udtAuth && evaluator.CurrentUserCanExecuteWithAncestors(udtAuth));
+        const canUseCustom = !!(customAuth && evaluator.CurrentUserCanExecuteWithAncestors(customAuth));
+        const schemas = [];
+        if (canUseUdt) {
+            schemas.push({
+                value: UDT_SCHEMA_NAME,
+                label: `${UDT_SCHEMA_NAME} — User-Defined Tables (default)`,
+                isDefault: true,
+                requiresElevatedAuth: false,
+            });
+        }
+        if (canUseCustom) {
+            const dbSchemas = await this.loadDbSchemaNames();
+            for (const schemaName of dbSchemas) {
+                // Skip the UDT schema (already first) and any server-blocked schemas
+                if (schemaName === UDT_SCHEMA_NAME)
+                    continue;
+                if (FRONTEND_BLOCKED_SCHEMAS.has(schemaName))
+                    continue;
+                schemas.push({
+                    value: schemaName,
+                    label: schemaName,
+                    isDefault: false,
+                    requiresElevatedAuth: true,
+                });
+            }
+            // Free-text escape hatch for schemas not yet registered with MJ
+            schemas.push({
+                value: '',
+                label: 'Other (enter schema name)',
+                isDefault: false,
+                requiresElevatedAuth: true,
+            });
+        }
+        return schemas;
+    }
+    /** Query `MJ: Schema Info` for distinct schema names registered with this MJ instance. */
+    async loadDbSchemaNames() {
+        const rv = new RunView();
+        const result = await rv.RunView({
+            EntityName: 'MJ: Schema Info',
+            Fields: ['SchemaName'],
+            OrderBy: 'SchemaName ASC',
+            ResultType: 'simple',
+        });
+        if (!result.Success)
+            return [];
+        return result.Results.map(r => r.SchemaName).filter(Boolean);
+    }
+    // ─── Name availability ────────────────────────────────────────────────
+    /**
+     * Check whether the proposed entity name and table name are available
+     * (no existing MJ entity in the same schema shares either).
+     *
+     * Returns true when the proposed names are safe to use.
+     */
+    async isNameAvailable(entityName, tableName, schemaName) {
+        const rv = new RunView();
+        const result = await rv.RunView({
+            EntityName: 'MJ: Entities',
+            ExtraFilter: `(Name = '${escapeSqlLiteral(entityName)}' OR BaseTable = '${escapeSqlLiteral(tableName)}') ` +
+                `AND SchemaName = '${escapeSqlLiteral(schemaName)}'`,
+            Fields: ['ID'],
+            ResultType: 'simple',
+        });
+        return result.Success && result.Results.length === 0;
+    }
+    // ─── Private helpers ──────────────────────────────────────────────────
+    /** Admin path: load all database-Designer-managed entities + ownership annotations. */
+    async loadAllEntities(currentUserId) {
+        const rv = new RunView();
+        // Round 1: get entity IDs from provenance settings and owner map
+        const [sourceResult, ownerResult] = await rv.RunViews([
+            {
+                EntityName: 'MJ: Entity Settings',
+                ExtraFilter: (`Name = '${UDT_SETTINGS.SOURCE_KEY}' ` +
+                    `AND Value IN ('${UDT_SETTINGS.SOURCE_DATABASE_DESIGNER}', '${UDT_SETTINGS.SOURCE_AGENT_MANAGER}')`),
+                Fields: ['EntityID', 'Value'],
+                ResultType: 'simple',
+            },
+            {
+                EntityName: 'MJ: Entity Settings',
+                ExtraFilter: `Name = '${UDT_SETTINGS.OWNER_KEY}'`,
+                Fields: ['EntityID', 'Value'],
+                ResultType: 'simple',
+            },
+        ]);
+        const sourceRows = (sourceResult.Results ?? []);
+        const ownerRows = (ownerResult.Results ?? []);
+        const entityIds = Array.from(new Set(sourceRows.map(r => r.EntityID)));
+        if (entityIds.length === 0)
+            return [];
+        const ownerMap = new Map(ownerRows.map(r => [r.EntityID, r.Value]));
+        // Round 2: entity details
+        const entityResult = await rv.RunView({
+            EntityName: 'MJ: Entities',
+            ExtraFilter: buildInFilter('ID', entityIds),
+            Fields: ['ID', 'Name', 'BaseTable', 'SchemaName', '__mj_CreatedAt'],
+            OrderBy: 'Name ASC',
+            ResultType: 'simple',
+        });
+        return (entityResult.Results ?? []).map(row => {
+            const ownerUserId = ownerMap.get(row.ID);
+            return {
+                entityId: row.ID,
+                entityName: row.Name,
+                tableName: row.BaseTable,
+                schemaName: row.SchemaName,
+                fieldCount: 0, // loaded on demand in detail view
+                createdAt: new Date(row.__mj_CreatedAt),
+                // UUIDsEqual handles SQL Server uppercase vs PostgreSQL lowercase UUIDs
+                isOwner: ownerUserId != null && UUIDsEqual(ownerUserId, currentUserId),
+            };
+        });
+    }
+    /** Non-admin path: load only entities owned by the current user. */
+    async loadOwnedEntities(userId) {
+        const rv = new RunView();
+        // Find entities owned by this user
+        const ownerResult = await rv.RunView({
+            EntityName: 'MJ: Entity Settings',
+            ExtraFilter: `Name = '${UDT_SETTINGS.OWNER_KEY}' AND Value = '${escapeSqlLiteral(userId)}'`,
+            Fields: ['EntityID', 'Value'],
+            ResultType: 'simple',
+        });
+        const entityIds = (ownerResult.Results ?? []).map(r => r.EntityID);
+        if (entityIds.length === 0)
+            return [];
+        // Fetch entity details
+        const entityResult = await rv.RunView({
+            EntityName: 'MJ: Entities',
+            ExtraFilter: buildInFilter('ID', entityIds),
+            Fields: ['ID', 'Name', 'BaseTable', 'SchemaName', '__mj_CreatedAt'],
+            OrderBy: 'Name ASC',
+            ResultType: 'simple',
+        });
+        return (entityResult.Results ?? []).map(row => ({
+            entityId: row.ID,
+            entityName: row.Name,
+            tableName: row.BaseTable,
+            schemaName: row.SchemaName,
+            fieldCount: 0,
+            createdAt: new Date(row.__mj_CreatedAt),
+            isOwner: true, // user can only see their own entities in this path
+        }));
+    }
+    /** Check if the current user owns the given entity (via MJ:UDT:Owner setting). */
+    async isCurrentUserOwner(entityId) {
+        const userId = new Metadata().CurrentUser?.ID; // global-provider-ok: client-side Angular engine, single provider
+        if (!userId)
+            return false;
+        const rv = new RunView();
+        const result = await rv.RunView({
+            EntityName: 'MJ: Entity Settings',
+            ExtraFilter: (`EntityID = '${escapeSqlId(entityId)}' ` +
+                `AND Name = '${UDT_SETTINGS.OWNER_KEY}' ` +
+                `AND Value = '${escapeSqlLiteral(userId)}'`),
+            Fields: ['EntityID', 'Value'],
+            ResultType: 'simple',
+        });
+        return result.Success && result.Results.length > 0;
+    }
+    /** True when the current user holds the `Modify Any UDT Entities` authorization. */
+    currentUserCanModifyAny() {
+        const md = new Metadata(); // global-provider-ok: client-side Angular engine, single provider
+        const auth = md.Authorizations.find(a => a.Name === ENTITY_DESIGNER_AUTH.MODIFY_ANY_UDT_ENTITIES);
+        if (!auth)
+            return false;
+        const evaluator = new AuthorizationEvaluator();
+        return evaluator.CurrentUserCanExecuteWithAncestors(auth);
+    }
+    /** Map a `MJ: Entity Fields` row to a `ColumnSpec` for the detail view. */
+    mapFieldToColumnSpec(field) {
+        return {
+            Name: field.Name,
+            Type: 'string', // detail view uses RawSqlType for display; Type is semantic
+            RawSqlType: field.Type,
+            IsNullable: field.AllowsNull,
+            // Preserve precision/scale metadata so the modify wizard renders the correct
+            // field type controls (e.g. DECIMAL(18,2) vs DECIMAL with no constraints)
+            MaxLength: field.MaxLength ?? undefined,
+            Precision: field.Precision ?? undefined,
+            Scale: field.Scale ?? undefined,
+            DefaultValue: field.DefaultValue ?? undefined,
+            Description: field.Description ?? undefined,
+        };
+    }
+}
+// ─── Private module-level utilities ──────────────────────────────────────────
+/** Build a SQL `column IN ('id1', 'id2', ...)` filter for a UUID list. */
+function buildInFilter(column, ids) {
+    const quoted = ids.map(id => `'${escapeSqlId(id)}'`).join(', ');
+    return `${column} IN (${quoted})`;
+}
+/** Escape a UUID for safe embedding in a SQL filter (UUIDs are alphanumeric + dashes, but be explicit). */
+function escapeSqlId(id) {
+    return id.replace(/[^a-zA-Z0-9-]/g, '');
+}
+/** Escape a string value for safe embedding in a SQL single-quoted literal. */
+function escapeSqlLiteral(value) {
+    return value.replace(/'/g, "''");
+}
+//# sourceMappingURL=database-designer.engine.js.map

package/dist/DatabaseDesigner/services/database-designer.engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-designer.engine.js","sourceRoot":"","sources":["../../../src/DatabaseDesigner/services/database-designer.engine.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @module database-designer.engine\n * @description Read-only data access engine for the Database Designer Angular UI.\n *\n * `DatabaseDesignerEngine` is a `BaseSingleton` (NOT an Angular service) that:\n *  - Loads the list of entities accessible to the current user\n *  - Loads full entity detail for the modify wizard\n *  - Loads available schemas from `MJ: Schema Info` (async, cached per-user)\n *  - Checks whether a proposed entity name / table name is available\n *\n * ### Why BaseSingleton, not @Injectable?\n * Engine classes hold a cross-request cache that must survive Angular's DI\n * lifecycle boundaries (the same instance is reused across multiple wizard\n * openings in the same session).  `BaseSingleton` uses the MJ Global Object\n * Store which guarantees exactly one instance per process, even across ESBuild\n * code-split chunks.\n *\n * ### Usage\n * ```typescript\n * const engine = DatabaseDesignerEngine.Instance;\n * const entities = await engine.loadAccessibleEntities();\n * ```\n *\n * @see DatabaseDesignerService — for action invocation (create, modify, validate)\n */\n\nimport { Metadata, RunView, AuthorizationEvaluator } from '@memberjunction/core';\nimport { BaseSingleton, UUIDsEqual } from '@memberjunction/global';\n\nimport type {\n    AccessibleEntity,\n    AccessibleEntityDetail,\n    ColumnSpec,\n    ForeignKeySpec,\n    SchemaOption,\n} from '../database-designer.types.js';\n\n// ─── Constants (mirror database-designer-core/src/interfaces.ts) ───────────────\n// These string values MUST stay in sync with the server-side constants.\n// If the server-side values change, update here in parallel.\n\nconst UDT_SCHEMA_NAME = '__mj_UDT';\n\nconst UDT_SETTINGS = {\n    OWNER_KEY: 'MJ:UDT:Owner',\n    SOURCE_KEY: 'MJ:UDT:Source',\n    SOURCE_DATABASE_DESIGNER: 'DatabaseDesigner',\n    SOURCE_AGENT_MANAGER: 'AgentManager',\n} as const;\n\nconst ENTITY_DESIGNER_AUTH = {\n    CREATE_IN_UDT_SCHEMA: 'Create in UDT Schema',\n    CREATE_IN_CUSTOM_SCHEMA: 'Create in Custom Schema',\n    MODIFY_OWN_ENTITIES: 'Modify Own Entities',\n    MODIFY_ANY_UDT_ENTITIES: 'Modify Any UDT Entities',\n} as const;\n\n/** Cache TTL in milliseconds (5 minutes). */\nconst CACHE_TTL_MS = 5 * 60 * 1_000;\n\n// ─── Columns managed automatically by CodeGen (never shown as user-editable) ─\n\n/**\n * Normalised lower-case set of column names that CodeGen injects on every entity.\n * These are filtered out of the modify wizard so users cannot inadvertently remove or\n * rename them.  The set is compared after calling `.toLowerCase()` on each column name\n * so it is case-insensitive regardless of DB platform.\n */\nconst AUTO_MANAGED_COLUMNS = new Set(['id', '__mj_createdat', '__mj_updatedat']);\n\n// ─── Internal row types for RunView results ───────────────────────────────────\n\ninterface SettingsRow { EntityID: string; Value: string }\ninterface EntityRow { ID: string; Name: string; BaseTable: string; SchemaName: string; __mj_CreatedAt: string }\ninterface FieldRow {\n    ID: string;\n    EntityID: string;\n    Name: string;\n    Type: string;\n    AllowsNull: boolean;\n    Description: string;\n    DefaultValue: string | null;\n    MaxLength: number | null;\n    Precision: number | null;\n    Scale: number | null;\n}\n\n// ─── Cache entry ─────────────────────────────────────────────────────────────\n\ninterface EntityListCacheEntry {\n    entities: AccessibleEntity[];\n    timestamp: number;\n}\n\ninterface SchemaCacheEntry {\n    schemas: SchemaOption[];\n    timestamp: number;\n}\n\n// ─── Frontend-only schema blocklist ──────────────────────────────────────────\n// `MJ: Schema Info` only surfaces MJ-registered schemas, so system schemas\n// (sys, dbo, information_schema) never appear.  Only __mj must be blocked here.\n// Server-side RSM.GetAllProtectedSchemas() remains the authoritative gate.\nconst FRONTEND_BLOCKED_SCHEMAS = new Set(['__mj']);\n\n// ─── Engine ──────────────────────────────────────────────────────────────────\n\n/**\n * Singleton data access engine for Database Designer.\n * All methods read data; none modifies state (mutations go through `DatabaseDesignerService`).\n */\nexport class DatabaseDesignerEngine extends BaseSingleton<DatabaseDesignerEngine> {\n\n    public static get Instance(): DatabaseDesignerEngine {\n        return super.getInstance<DatabaseDesignerEngine>();\n    }\n\n    protected constructor() { super(); }\n\n    // ─── Cache ────────────────────────────────────────────────────────────\n\n    /** Per-user entity list cache. Key = userID. */\n    private readonly _cache = new Map<string, EntityListCacheEntry>();\n\n    /** Per-user schema list cache. Key = userID. Invalidated alongside entity cache. */\n    private readonly _schemaCache = new Map<string, SchemaCacheEntry>();\n\n    /** Invalidate all per-user caches for the current user (call after create/modify). */\n    public invalidateCache(): void {\n        const userId = new Metadata().CurrentUser?.ID; // global-provider-ok: client-side Angular engine, single provider\n        if (userId) {\n            this._cache.delete(userId);\n            this._schemaCache.delete(userId);\n        }\n    }\n\n    // ─── Entity list ──────────────────────────────────────────────────────\n\n    /**\n     * Load all entities accessible to the current user.\n     *\n     * - **Admin** (holds `Modify Any UDT Entities`): sees all entities created by\n     *   Database Designer or Agent Manager, with ownership annotations.\n     * - **Regular user**: sees only entities they own (`MJ:UDT:Owner = userId`).\n     *\n     * Results are cached per-user with a 5-minute TTL.\n     */\n    public async loadAccessibleEntities(): Promise<AccessibleEntity[]> {\n        const md = new Metadata(); // global-provider-ok: client-side Angular engine, single provider\n        const userId = md.CurrentUser?.ID;\n        if (!userId) return [];\n\n        const cached = this._cache.get(userId);\n        if (cached && Date.now() - cached.timestamp < CACHE_TTL_MS) {\n            return cached.entities;\n        }\n\n        const isAdmin = this.currentUserCanModifyAny();\n        const entities = isAdmin\n            ? await this.loadAllEntities(userId)\n            : await this.loadOwnedEntities(userId);\n\n        this._cache.set(userId, { entities, timestamp: Date.now() });\n        return entities;\n    }\n\n    /**\n     * Load full entity detail (columns, foreign keys, description) for the modify wizard.\n     * Not cached — always fetches fresh data so the wizard reflects current DB state.\n     */\n    public async loadEntityDetail(entityId: string): Promise<AccessibleEntityDetail | null> {\n        const rv = new RunView();\n        // BypassCache: true on both queries because CodeGen writes Entity Fields via direct\n        // SQL (outside BaseEntity.Save()), so the server-side RunView cache never receives\n        // an invalidation event after a pipeline run.  Without this, the detail view would\n        // show stale field data (e.g. old AllowsNull value) until MJAPI restarts.\n        const [entityResult, fieldsResult] = await rv.RunViews([\n            {\n                EntityName: 'MJ: Entities',\n                ExtraFilter: `ID = '${escapeSqlId(entityId)}'`,\n                Fields: ['ID', 'Name', 'BaseTable', 'SchemaName', 'Description', '__mj_CreatedAt'],\n                ResultType: 'simple',\n                BypassCache: true,\n            },\n            {\n                EntityName: 'MJ: Entity Fields',\n                ExtraFilter: `EntityID = '${escapeSqlId(entityId)}' AND IsVirtual = 0`,\n                Fields: ['ID', 'EntityID', 'Name', 'Type', 'AllowsNull', 'Description', 'DefaultValue', 'MaxLength', 'Precision', 'Scale'],\n                OrderBy: 'Sequence ASC, Name ASC',\n                ResultType: 'simple',\n                BypassCache: true,\n            },\n        ]);\n\n        if (!entityResult.Success || entityResult.Results.length === 0) return null;\n\n        const entity = entityResult.Results[0] as EntityRow & { Description: string };\n        const fieldRows = (fieldsResult.Results ?? []) as FieldRow[];\n\n        const isOwner = await this.isCurrentUserOwner(entityId);\n\n        // Exclude auto-managed columns (ID, __mj_CreatedAt, __mj_UpdatedAt) from the editable\n        // column list.  CodeGen injects these automatically — they must not be user-modified.\n        const editableFields = fieldRows.filter(\n            f => !AUTO_MANAGED_COLUMNS.has(f.Name.toLowerCase())\n        );\n\n        return {\n            entityId: entity.ID,\n            entityName: entity.Name,\n            tableName: entity.BaseTable,\n            schemaName: entity.SchemaName,\n            description: entity.Description ?? '',\n            fieldCount: editableFields.length,\n            createdAt: new Date(entity.__mj_CreatedAt),\n            isOwner,\n            columns: editableFields.map(f => this.mapFieldToColumnSpec(f)),\n            foreignKeys: [],  // FK detail loaded on demand — Phase 5e\n        };\n    }\n\n    // ─── Schema options ───────────────────────────────────────────────────\n\n    /**\n     * Return the list of schemas the current user is authorized to create tables in.\n     *\n     * Async — queries `MJ: Schema Info` to surface real DB schemas for users\n     * with `Create in Custom Schema` authorization.  Results are cached per-user\n     * with the same 5-minute TTL as the entity list.\n     *\n     * Order:\n     *   1. `__mj_UDT`  (if user holds `Create in UDT Schema`)\n     *   2. Real DB schemas from `MJ: Schema Info`, excluding blocked schemas\n     *      and `__mj_UDT` (already listed first)\n     *   3. \"Other (enter schema name)\" free-text option, at the end\n     *\n     * All items beyond #1 require `Create in Custom Schema` authorization.\n     */\n    public async loadAvailableSchemas(): Promise<SchemaOption[]> {\n        const userId = new Metadata().CurrentUser?.ID; // global-provider-ok: client-side Angular engine, single provider\n        if (!userId) return [];\n\n        const cached = this._schemaCache.get(userId);\n        if (cached && Date.now() - cached.timestamp < CACHE_TTL_MS) {\n            return cached.schemas;\n        }\n\n        const schemas = await this.fetchAvailableSchemas();\n        this._schemaCache.set(userId, { schemas, timestamp: Date.now() });\n        return schemas;\n    }\n\n    /** Build the schema option list: UDT first, then real DB schemas, then Other. */\n    private async fetchAvailableSchemas(): Promise<SchemaOption[]> {\n        const md = new Metadata(); // global-provider-ok: client-side Angular engine, single provider\n        const evaluator = new AuthorizationEvaluator();\n\n        const udtAuth    = md.Authorizations.find(a => a.Name === ENTITY_DESIGNER_AUTH.CREATE_IN_UDT_SCHEMA);\n        const customAuth = md.Authorizations.find(a => a.Name === ENTITY_DESIGNER_AUTH.CREATE_IN_CUSTOM_SCHEMA);\n\n        const canUseUdt    = !!(udtAuth    && evaluator.CurrentUserCanExecuteWithAncestors(udtAuth));\n        const canUseCustom = !!(customAuth && evaluator.CurrentUserCanExecuteWithAncestors(customAuth));\n\n        const schemas: SchemaOption[] = [];\n\n        if (canUseUdt) {\n            schemas.push({\n                value: UDT_SCHEMA_NAME,\n                label: `${UDT_SCHEMA_NAME} — User-Defined Tables (default)`,\n                isDefault: true,\n                requiresElevatedAuth: false,\n            });\n        }\n\n        if (canUseCustom) {\n            const dbSchemas = await this.loadDbSchemaNames();\n            for (const schemaName of dbSchemas) {\n                // Skip the UDT schema (already first) and any server-blocked schemas\n                if (schemaName === UDT_SCHEMA_NAME) continue;\n                if (FRONTEND_BLOCKED_SCHEMAS.has(schemaName)) continue;\n                schemas.push({\n                    value: schemaName,\n                    label: schemaName,\n                    isDefault: false,\n                    requiresElevatedAuth: true,\n                });\n            }\n\n            // Free-text escape hatch for schemas not yet registered with MJ\n            schemas.push({\n                value: '',\n                label: 'Other (enter schema name)',\n                isDefault: false,\n                requiresElevatedAuth: true,\n            });\n        }\n\n        return schemas;\n    }\n\n    /** Query `MJ: Schema Info` for distinct schema names registered with this MJ instance. */\n    private async loadDbSchemaNames(): Promise<string[]> {\n        const rv = new RunView();\n        const result = await rv.RunView<{ SchemaName: string }>({\n            EntityName: 'MJ: Schema Info',\n            Fields: ['SchemaName'],\n            OrderBy: 'SchemaName ASC',\n            ResultType: 'simple',\n        });\n\n        if (!result.Success) return [];\n        return result.Results.map(r => r.SchemaName).filter(Boolean);\n    }\n\n    // ─── Name availability ────────────────────────────────────────────────\n\n    /**\n     * Check whether the proposed entity name and table name are available\n     * (no existing MJ entity in the same schema shares either).\n     *\n     * Returns true when the proposed names are safe to use.\n     */\n    public async isNameAvailable(entityName: string, tableName: string, schemaName: string): Promise<boolean> {\n        const rv = new RunView();\n        const result = await rv.RunView<{ ID: string }>({\n            EntityName: 'MJ: Entities',\n            ExtraFilter:\n                `(Name = '${escapeSqlLiteral(entityName)}' OR BaseTable = '${escapeSqlLiteral(tableName)}') ` +\n                `AND SchemaName = '${escapeSqlLiteral(schemaName)}'`,\n            Fields: ['ID'],\n            ResultType: 'simple',\n        });\n\n        return result.Success && result.Results.length === 0;\n    }\n\n    // ─── Private helpers ──────────────────────────────────────────────────\n\n    /** Admin path: load all database-Designer-managed entities + ownership annotations. */\n    private async loadAllEntities(currentUserId: string): Promise<AccessibleEntity[]> {\n        const rv = new RunView();\n\n        // Round 1: get entity IDs from provenance settings and owner map\n        const [sourceResult, ownerResult] = await rv.RunViews([\n            {\n                EntityName: 'MJ: Entity Settings',\n                ExtraFilter: (\n                    `Name = '${UDT_SETTINGS.SOURCE_KEY}' ` +\n                    `AND Value IN ('${UDT_SETTINGS.SOURCE_DATABASE_DESIGNER}', '${UDT_SETTINGS.SOURCE_AGENT_MANAGER}')`\n                ),\n                Fields: ['EntityID', 'Value'],\n                ResultType: 'simple',\n            },\n            {\n                EntityName: 'MJ: Entity Settings',\n                ExtraFilter: `Name = '${UDT_SETTINGS.OWNER_KEY}'`,\n                Fields: ['EntityID', 'Value'],\n                ResultType: 'simple',\n            },\n        ]);\n\n        const sourceRows = (sourceResult.Results ?? []) as SettingsRow[];\n        const ownerRows = (ownerResult.Results ?? []) as SettingsRow[];\n\n        const entityIds = Array.from(new Set(sourceRows.map(r => r.EntityID)));\n        if (entityIds.length === 0) return [];\n\n        const ownerMap = new Map(ownerRows.map(r => [r.EntityID, r.Value]));\n\n        // Round 2: entity details\n        const entityResult = await rv.RunView<EntityRow>({\n            EntityName: 'MJ: Entities',\n            ExtraFilter: buildInFilter('ID', entityIds),\n            Fields: ['ID', 'Name', 'BaseTable', 'SchemaName', '__mj_CreatedAt'],\n            OrderBy: 'Name ASC',\n            ResultType: 'simple',\n        });\n\n        return (entityResult.Results ?? []).map(row => {\n            const ownerUserId = ownerMap.get(row.ID);\n            return {\n                entityId: row.ID,\n                entityName: row.Name,\n                tableName: row.BaseTable,\n                schemaName: row.SchemaName,\n                fieldCount: 0,  // loaded on demand in detail view\n                createdAt: new Date(row.__mj_CreatedAt),\n                // UUIDsEqual handles SQL Server uppercase vs PostgreSQL lowercase UUIDs\n                isOwner: ownerUserId != null && UUIDsEqual(ownerUserId, currentUserId),\n            } satisfies AccessibleEntity;\n        });\n    }\n\n    /** Non-admin path: load only entities owned by the current user. */\n    private async loadOwnedEntities(userId: string): Promise<AccessibleEntity[]> {\n        const rv = new RunView();\n\n        // Find entities owned by this user\n        const ownerResult = await rv.RunView<SettingsRow>({\n            EntityName: 'MJ: Entity Settings',\n            ExtraFilter: `Name = '${UDT_SETTINGS.OWNER_KEY}' AND Value = '${escapeSqlLiteral(userId)}'`,\n            Fields: ['EntityID', 'Value'],\n            ResultType: 'simple',\n        });\n\n        const entityIds = (ownerResult.Results ?? []).map(r => r.EntityID);\n        if (entityIds.length === 0) return [];\n\n        // Fetch entity details\n        const entityResult = await rv.RunView<EntityRow>({\n            EntityName: 'MJ: Entities',\n            ExtraFilter: buildInFilter('ID', entityIds),\n            Fields: ['ID', 'Name', 'BaseTable', 'SchemaName', '__mj_CreatedAt'],\n            OrderBy: 'Name ASC',\n            ResultType: 'simple',\n        });\n\n        return (entityResult.Results ?? []).map(row => ({\n            entityId: row.ID,\n            entityName: row.Name,\n            tableName: row.BaseTable,\n            schemaName: row.SchemaName,\n            fieldCount: 0,\n            createdAt: new Date(row.__mj_CreatedAt),\n            isOwner: true,  // user can only see their own entities in this path\n        } satisfies AccessibleEntity));\n    }\n\n    /** Check if the current user owns the given entity (via MJ:UDT:Owner setting). */\n    private async isCurrentUserOwner(entityId: string): Promise<boolean> {\n        const userId = new Metadata().CurrentUser?.ID; // global-provider-ok: client-side Angular engine, single provider\n        if (!userId) return false;\n\n        const rv = new RunView();\n        const result = await rv.RunView<SettingsRow>({\n            EntityName: 'MJ: Entity Settings',\n            ExtraFilter: (\n                `EntityID = '${escapeSqlId(entityId)}' ` +\n                `AND Name = '${UDT_SETTINGS.OWNER_KEY}' ` +\n                `AND Value = '${escapeSqlLiteral(userId)}'`\n            ),\n            Fields: ['EntityID', 'Value'],\n            ResultType: 'simple',\n        });\n\n        return result.Success && result.Results.length > 0;\n    }\n\n    /** True when the current user holds the `Modify Any UDT Entities` authorization. */\n    private currentUserCanModifyAny(): boolean {\n        const md = new Metadata(); // global-provider-ok: client-side Angular engine, single provider\n        const auth = md.Authorizations.find(a => a.Name === ENTITY_DESIGNER_AUTH.MODIFY_ANY_UDT_ENTITIES);\n        if (!auth) return false;\n        const evaluator = new AuthorizationEvaluator();\n        return evaluator.CurrentUserCanExecuteWithAncestors(auth);\n    }\n\n    /** Map a `MJ: Entity Fields` row to a `ColumnSpec` for the detail view. */\n    private mapFieldToColumnSpec(field: FieldRow): ColumnSpec {\n        return {\n            Name: field.Name,\n            Type: 'string',  // detail view uses RawSqlType for display; Type is semantic\n            RawSqlType: field.Type,\n            IsNullable: field.AllowsNull,\n            // Preserve precision/scale metadata so the modify wizard renders the correct\n            // field type controls (e.g. DECIMAL(18,2) vs DECIMAL with no constraints)\n            MaxLength: field.MaxLength ?? undefined,\n            Precision: field.Precision ?? undefined,\n            Scale: field.Scale ?? undefined,\n            DefaultValue: field.DefaultValue ?? undefined,\n            Description: field.Description ?? undefined,\n        };\n    }\n}\n\n// ─── Private module-level utilities ──────────────────────────────────────────\n\n/** Build a SQL `column IN ('id1', 'id2', ...)` filter for a UUID list. */\nfunction buildInFilter(column: string, ids: string[]): string {\n    const quoted = ids.map(id => `'${escapeSqlId(id)}'`).join(', ');\n    return `${column} IN (${quoted})`;\n}\n\n/** Escape a UUID for safe embedding in a SQL filter (UUIDs are alphanumeric + dashes, but be explicit). */\nfunction escapeSqlId(id: string): string {\n    return id.replace(/[^a-zA-Z0-9-]/g, '');\n}\n\n/** Escape a string value for safe embedding in a SQL single-quoted literal. */\nfunction escapeSqlLiteral(value: string): string {\n    return value.replace(/'/g, \"''\");\n}\n"]}

package/dist/DatabaseDesigner/services/database-designer.service.d.ts

@@ -0,0 +1,78 @@
+import type { EntityTableSpec, ClientValidationResult, EntityPipelineResult, EntityDescribeResult } from '../database-designer.types.js';
+import * as i0 from "@angular/core";
+export interface CreateEntityOptions {
+    skipGitCommit?: boolean;
+    skipRestart?: boolean;
+}
+export interface ModifyEntityOptions extends CreateEntityOptions {
+    /** ID of the existing entity being modified. */
+    existingEntityId: string;
+}
+export declare class DatabaseDesignerService {
+    /**
+     * Lazily-created action client.  Re-uses `GraphQLDataProvider.Instance` so the
+     * singleton provider (and its auth headers) are shared across all invocations.
+     */
+    private _actionClient;
+    private getActionClient;
+    /**
+     * Cache maps action name → Promise<ID>.  Storing a Promise (not a resolved ID)
+     * prevents duplicate in-flight lookups when two callers await the same name
+     * before the first resolves.
+     */
+    private readonly _actionIdCache;
+    private resolveActionId;
+    private fetchActionId;
+    /**
+     * Create a new MemberJunction entity from a `EntityTableSpec`.
+     * Calls the `Create Entity` action on the server which runs the full RSU pipeline.
+     */
+    createEntity(tableSpec: EntityTableSpec, options?: CreateEntityOptions): Promise<EntityPipelineResult>;
+    /**
+     * Modify an existing MemberJunction entity.
+     * Calls the `Modify Entity` action on the server.
+     */
+    modifyEntity(tableSpec: EntityTableSpec, options: ModifyEntityOptions): Promise<EntityPipelineResult>;
+    /**
+     * Validate a `EntityTableSpec` without executing the pipeline.
+     * Used by Step 4 (Review) of the wizard to surface errors before the user submits.
+     *
+     * Note: `ActionResult.Success` is `true` even when `ValidationResult.Valid` is `false`
+     * because the action itself succeeded — validation failure is a business outcome, not
+     * an infrastructure error.
+     */
+    validateEntitySchema(tableSpec: EntityTableSpec, modificationType?: 'create' | 'alter'): Promise<ClientValidationResult>;
+    /**
+     * Load detailed metadata for an existing entity.
+     * Used by the entity list slide panel and the modify wizard entry point.
+     */
+    describeEntity(entityId: string): Promise<EntityDescribeResult>;
+    private buildPipelineParams;
+    /**
+     * Extract server output params from a `RunAction` result.
+     *
+     * ### Why `result.Result`, not `result.Params`?
+     * `ActionResolver.createActionResult` on the server serializes all Output/Both typed
+     * params into a JSON string stored in `ResultData`.  `GraphQLActionClient` parses that
+     * JSON and stores the resulting array in `result.Result`.  The `result.Params` field
+     * contains only the *input* params passed by the caller — the server's output params
+     * are never included there.
+     *
+     * This helper centralizes the cast so no caller ever needs to understand this transport
+     * contract directly.
+     */
+    private extractOutputParams;
+    /**
+     * Map a completed `ActionResult` to an `EntityPipelineResult`.
+     *
+     * Two failure modes are distinguished:
+     *  - `result.Success === false`: infrastructure failure (auth, pipeline exception) → hard error
+     *  - `result.Success === true` but `EntityID` missing: pipeline ran but ID unconfirmed →
+     *    soft warning so the UI can surface guidance without blocking the user
+     */
+    private extractPipelineResult;
+    private errorMessage;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DatabaseDesignerService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DatabaseDesignerService>;
+}
+//# sourceMappingURL=database-designer.service.d.ts.map

package/dist/DatabaseDesigner/services/database-designer.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-designer.service.d.ts","sourceRoot":"","sources":["../../../src/DatabaseDesigner/services/database-designer.service.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EACR,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EAEvB,MAAM,+BAA+B,CAAC;;AAevC,MAAM,WAAW,mBAAmB;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC5D,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,CAAC;CAC5B;AAID,qBACa,uBAAuB;IAIhC;;;OAGG;IACH,OAAO,CAAC,aAAa,CAAoC;IAEzD,OAAO,CAAC,eAAe;IASvB;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsC;IAErE,OAAO,CAAC,eAAe;YAST,aAAa;IAoB3B;;;OAGG;IACU,YAAY,CACrB,SAAS,EAAE,eAAe,EAC1B,OAAO,GAAE,mBAAwB,GAClC,OAAO,CAAC,oBAAoB,CAAC;IAWhC;;;OAGG;IACU,YAAY,CACrB,SAAS,EAAE,eAAe,EAC1B,OAAO,EAAE,mBAAmB,GAC7B,OAAO,CAAC,oBAAoB,CAAC;IAchC;;;;;;;OAOG;IACU,oBAAoB,CAC7B,SAAS,EAAE,eAAe,EAC1B,gBAAgB,GAAE,QAAQ,GAAG,OAAkB,GAChD,OAAO,CAAC,sBAAsB,CAAC;IAuBlC;;;OAGG;IACU,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAgC5E,OAAO,CAAC,mBAAmB;IAa3B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IAyC7B,OAAO,CAAC,YAAY;yCAnQX,uBAAuB;6CAAvB,uBAAuB;CAsQnC"}