@memberjunction/ng-dashboards 5.30.1 → 5.32.0

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

@@ -0,0 +1,273 @@
+/**
+ * @module database-designer.service
+ * @description Angular service that wraps `GraphQLActionClient.RunAction()` for all
+ * five Database Designer server-side actions.
+ *
+ * ### Responsibilities
+ * - Lazy-resolve action UUIDs by name on first use and cache them
+ * - Build strongly-typed `ActionParam[]` arrays from typed Angular inputs
+ * - Parse output params and map them to typed Angular response objects
+ * - Surface error messages in a consistent format
+ *
+ * ### Why @Injectable({ providedIn: 'root' })?
+ * The action ID cache (`_actionIdCache`) must outlive individual component
+ * lifecycles.  A root-level singleton ensures the first action lookup per
+ * action name is shared across the entire session.
+ *
+ * ### Action ID caching
+ * Action IDs are cached as `Promise<string>` (not `string`) so that concurrent
+ * callers waiting on the same lookup share a single in-flight request rather
+ * than triggering N parallel `MJ: Actions` queries.
+ *
+ * @see DatabaseDesignerEngine — for read-only data access (no action invocations)
+ */
+import { Injectable } from '@angular/core';
+import { RunView } from '@memberjunction/core';
+import { GraphQLDataProvider, GraphQLActionClient } from '@memberjunction/graphql-dataprovider';
+import * as i0 from "@angular/core";
+// ─── Action name constants ────────────────────────────────────────────────────
+// Must stay in sync with @RegisterClass registrations in database-designer-actions package.
+const ACTION_NAMES = {
+    CREATE_ENTITY: 'Create Entity',
+    MODIFY_ENTITY: 'Modify Entity',
+    VALIDATE_ENTITY_SCHEMA: 'Validate Entity Schema',
+    DESCRIBE_ENTITY: 'Describe Entity',
+    LIST_MY_ENTITIES: 'List My Entities',
+};
+// ─── Service ─────────────────────────────────────────────────────────────────
+export class DatabaseDesignerService {
+    // ─── Action client ────────────────────────────────────────────────────
+    /**
+     * Lazily-created action client.  Re-uses `GraphQLDataProvider.Instance` so the
+     * singleton provider (and its auth headers) are shared across all invocations.
+     */
+    _actionClient = null;
+    getActionClient() {
+        if (!this._actionClient) {
+            this._actionClient = new GraphQLActionClient(GraphQLDataProvider.Instance);
+        }
+        return this._actionClient;
+    }
+    // ─── Action ID resolution ─────────────────────────────────────────────
+    /**
+     * 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.
+     */
+    _actionIdCache = new Map();
+    resolveActionId(actionName) {
+        let pending = this._actionIdCache.get(actionName);
+        if (!pending) {
+            pending = this.fetchActionId(actionName);
+            this._actionIdCache.set(actionName, pending);
+        }
+        return pending;
+    }
+    async fetchActionId(actionName) {
+        const rv = new RunView();
+        const result = await rv.RunView({
+            EntityName: 'MJ: Actions',
+            ExtraFilter: `Name = '${actionName.replace(/'/g, "''")}'`,
+            Fields: ['ID'],
+            ResultType: 'simple',
+        });
+        if (!result.Success || result.Results.length === 0) {
+            throw new Error(`Database Designer action '${actionName}' not found in MJ. ` +
+                `Ensure database-designer-actions metadata has been pushed via mj sync push.`);
+        }
+        return result.Results[0].ID;
+    }
+    // ─── Public action methods ────────────────────────────────────────────
+    /**
+     * Create a new MemberJunction entity from a `EntityTableSpec`.
+     * Calls the `Create Entity` action on the server which runs the full RSU pipeline.
+     */
+    async createEntity(tableSpec, options = {}) {
+        try {
+            const actionId = await this.resolveActionId(ACTION_NAMES.CREATE_ENTITY);
+            const params = this.buildPipelineParams(tableSpec, options);
+            const result = await this.getActionClient().RunAction(actionId, params);
+            return this.extractPipelineResult(result);
+        }
+        catch (err) {
+            return { Success: false, ErrorMessage: this.errorMessage(err) };
+        }
+    }
+    /**
+     * Modify an existing MemberJunction entity.
+     * Calls the `Modify Entity` action on the server.
+     */
+    async modifyEntity(tableSpec, options) {
+        try {
+            const actionId = await this.resolveActionId(ACTION_NAMES.MODIFY_ENTITY);
+            const params = [
+                ...this.buildPipelineParams(tableSpec, options),
+                { Name: 'ExistingEntityID', Type: 'Input', Value: options.existingEntityId },
+            ];
+            const result = await this.getActionClient().RunAction(actionId, params);
+            return this.extractPipelineResult(result);
+        }
+        catch (err) {
+            return { Success: false, ErrorMessage: this.errorMessage(err) };
+        }
+    }
+    /**
+     * 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.
+     */
+    async validateEntitySchema(tableSpec, modificationType = 'create') {
+        try {
+            const actionId = await this.resolveActionId(ACTION_NAMES.VALIDATE_ENTITY_SCHEMA);
+            const params = [
+                { Name: 'TableDefinition', Type: 'Input', Value: tableSpec },
+                { Name: 'ModificationType', Type: 'Input', Value: modificationType },
+            ];
+            const result = await this.getActionClient().RunAction(actionId, params);
+            const outputParams = this.extractOutputParams(result);
+            const outputParam = outputParams.find(p => p.Name === 'ValidationResult');
+            if (outputParam?.Value) {
+                const raw = typeof outputParam.Value === 'string'
+                    ? JSON.parse(outputParam.Value)
+                    : outputParam.Value;
+                return { Valid: !!raw.Valid, Errors: raw.Errors ?? [], Warnings: raw.Warnings ?? [] };
+            }
+            // Fallback: treat action-level failure as a validation failure
+            return { Valid: false, Errors: [result.Message ?? 'Validation failed'], Warnings: [] };
+        }
+        catch (err) {
+            return { Valid: false, Errors: [this.errorMessage(err)], Warnings: [] };
+        }
+    }
+    /**
+     * Load detailed metadata for an existing entity.
+     * Used by the entity list slide panel and the modify wizard entry point.
+     */
+    async describeEntity(entityId) {
+        try {
+            const actionId = await this.resolveActionId(ACTION_NAMES.DESCRIBE_ENTITY);
+            const params = [
+                { Name: 'EntityID', Type: 'Input', Value: entityId },
+            ];
+            const result = await this.getActionClient().RunAction(actionId, params);
+            if (!result.Success) {
+                return { Success: false, ErrorMessage: result.Message };
+            }
+            const outputParams = this.extractOutputParams(result);
+            const outputParam = outputParams.find(p => p.Name === 'EntityDetails');
+            const raw = outputParam?.Value
+                ? (typeof outputParam.Value === 'string' ? JSON.parse(outputParam.Value) : outputParam.Value)
+                : {};
+            return {
+                Success: true,
+                EntityName: raw.EntityName,
+                SchemaName: raw.SchemaName,
+                TableName: raw.TableName,
+                Description: raw.Description,
+                Fields: raw.Fields ?? [],
+            };
+        }
+        catch (err) {
+            return { Success: false, ErrorMessage: this.errorMessage(err) };
+        }
+    }
+    // ─── Private helpers ──────────────────────────────────────────────────
+    buildPipelineParams(tableSpec, options) {
+        const params = [
+            { Name: 'TableDefinition', Type: 'Input', Value: tableSpec },
+        ];
+        if (options.skipGitCommit) {
+            params.push({ Name: 'SkipGitCommit', Type: 'Input', Value: 'true' });
+        }
+        if (options.skipRestart) {
+            params.push({ Name: 'SkipRestart', Type: 'Input', Value: 'true' });
+        }
+        return params;
+    }
+    /**
+     * 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.
+     */
+    extractOutputParams(result) {
+        // result.Result is typed as MJActionResultCodeEntity | undefined in the ActionResult
+        // class, but GraphQLActionClient repurposes it to carry the parsed ResultData payload
+        // (an ActionParam[]).  We cast through unknown to acknowledge this intentional mismatch.
+        const raw = result.Result;
+        if (Array.isArray(raw))
+            return raw;
+        // CopyScalarsAndArrays (used server-side to serialize ResultData) converts arrays to
+        // numeric-keyed plain objects — e.g. [p0, p1] → {"0": p0, "1": p1}.
+        // Detect and restore that pattern so callers can find their output params.
+        if (raw && typeof raw === 'object') {
+            const keys = Object.keys(raw);
+            if (keys.length > 0 && keys.every(k => /^\d+$/.test(k))) {
+                const obj = raw;
+                return keys.sort((a, b) => +a - +b).map(k => obj[k]);
+            }
+        }
+        return [];
+    }
+    /**
+     * 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
+     */
+    extractPipelineResult(result) {
+        const outputParams = this.extractOutputParams(result);
+        const find = (name) => outputParams.find(p => p.Name === name)?.Value;
+        const stepsRaw = find('PipelineSteps');
+        const steps = stepsRaw
+            ? (typeof stepsRaw === 'string' ? JSON.parse(stepsRaw) : stepsRaw)
+            : [];
+        if (!result.Success) {
+            return {
+                Success: false,
+                PipelineSteps: steps,
+                ErrorMessage: result.Message ?? 'Action execution failed.',
+            };
+        }
+        const entityId = find('EntityID');
+        const warnings = [];
+        if (entityId == null) {
+            // Pipeline ran but EntityID was not echoed back — this can happen when the server
+            // completes the RSU pipeline but the metadata refresh hasn't propagated the new
+            // entity ID yet.  Treat as a soft warning, not a hard failure.
+            warnings.push('Entity was saved successfully but the EntityID could not be confirmed. ' +
+                'Refresh the list to verify.');
+        }
+        return {
+            Success: true,
+            EntityID: entityId != null ? String(entityId) : undefined,
+            EntityName: String(find('EntityName') ?? ''),
+            SchemaName: String(find('SchemaName') ?? ''),
+            TableName: String(find('TableName') ?? ''),
+            PipelineSteps: steps,
+            Warnings: warnings.length > 0 ? warnings : undefined,
+        };
+    }
+    errorMessage(err) {
+        return err instanceof Error ? err.message : String(err);
+    }
+    static ɵfac = function DatabaseDesignerService_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || DatabaseDesignerService)(); };
+    static ɵprov = /*@__PURE__*/ i0.ɵɵdefineInjectable({ token: DatabaseDesignerService, factory: DatabaseDesignerService.ɵfac, providedIn: 'root' });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(DatabaseDesignerService, [{
+        type: Injectable,
+        args: [{ providedIn: 'root' }]
+    }], null, null); })();
+//# sourceMappingURL=database-designer.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"database-designer.service.js","sourceRoot":"","sources":["../../../src/DatabaseDesigner/services/database-designer.service.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @module database-designer.service\n * @description Angular service that wraps `GraphQLActionClient.RunAction()` for all\n * five Database Designer server-side actions.\n *\n * ### Responsibilities\n * - Lazy-resolve action UUIDs by name on first use and cache them\n * - Build strongly-typed `ActionParam[]` arrays from typed Angular inputs\n * - Parse output params and map them to typed Angular response objects\n * - Surface error messages in a consistent format\n *\n * ### Why @Injectable({ providedIn: 'root' })?\n * The action ID cache (`_actionIdCache`) must outlive individual component\n * lifecycles.  A root-level singleton ensures the first action lookup per\n * action name is shared across the entire session.\n *\n * ### Action ID caching\n * Action IDs are cached as `Promise<string>` (not `string`) so that concurrent\n * callers waiting on the same lookup share a single in-flight request rather\n * than triggering N parallel `MJ: Actions` queries.\n *\n * @see DatabaseDesignerEngine — for read-only data access (no action invocations)\n */\n\nimport { Injectable } from '@angular/core';\nimport { RunView } from '@memberjunction/core';\nimport { GraphQLDataProvider, GraphQLActionClient } from '@memberjunction/graphql-dataprovider';\nimport type { ActionParam, ActionResult } from '@memberjunction/actions-base';\n\nimport type {\n    EntityTableSpec,\n    ClientValidationResult,\n    EntityPipelineResult,\n    EntityDescribeResult,\n    PipelineStepSummary,\n} from '../database-designer.types.js';\n\n// ─── Action name constants ────────────────────────────────────────────────────\n// Must stay in sync with @RegisterClass registrations in database-designer-actions package.\n\nconst ACTION_NAMES = {\n    CREATE_ENTITY: 'Create Entity',\n    MODIFY_ENTITY: 'Modify Entity',\n    VALIDATE_ENTITY_SCHEMA: 'Validate Entity Schema',\n    DESCRIBE_ENTITY: 'Describe Entity',\n    LIST_MY_ENTITIES: 'List My Entities',\n} as const;\n\n// ─── Options ──────────────────────────────────────────────────────────────────\n\nexport interface CreateEntityOptions {\n    skipGitCommit?: boolean;\n    skipRestart?: boolean;\n}\n\nexport interface ModifyEntityOptions extends CreateEntityOptions {\n    /** ID of the existing entity being modified. */\n    existingEntityId: string;\n}\n\n// ─── Service ─────────────────────────────────────────────────────────────────\n\n@Injectable({ providedIn: 'root' })\nexport class DatabaseDesignerService {\n\n    // ─── Action client ────────────────────────────────────────────────────\n\n    /**\n     * Lazily-created action client.  Re-uses `GraphQLDataProvider.Instance` so the\n     * singleton provider (and its auth headers) are shared across all invocations.\n     */\n    private _actionClient: GraphQLActionClient | null = null;\n\n    private getActionClient(): GraphQLActionClient {\n        if (!this._actionClient) {\n            this._actionClient = new GraphQLActionClient(GraphQLDataProvider.Instance);\n        }\n        return this._actionClient;\n    }\n\n    // ─── Action ID resolution ─────────────────────────────────────────────\n\n    /**\n     * Cache maps action name → Promise<ID>.  Storing a Promise (not a resolved ID)\n     * prevents duplicate in-flight lookups when two callers await the same name\n     * before the first resolves.\n     */\n    private readonly _actionIdCache = new Map<string, Promise<string>>();\n\n    private resolveActionId(actionName: string): Promise<string> {\n        let pending = this._actionIdCache.get(actionName);\n        if (!pending) {\n            pending = this.fetchActionId(actionName);\n            this._actionIdCache.set(actionName, pending);\n        }\n        return pending;\n    }\n\n    private async fetchActionId(actionName: string): Promise<string> {\n        const rv = new RunView();\n        const result = await rv.RunView<{ ID: string }>({\n            EntityName: 'MJ: Actions',\n            ExtraFilter: `Name = '${actionName.replace(/'/g, \"''\")}'`,\n            Fields: ['ID'],\n            ResultType: 'simple',\n        });\n\n        if (!result.Success || result.Results.length === 0) {\n            throw new Error(\n                `Database Designer action '${actionName}' not found in MJ. ` +\n                `Ensure database-designer-actions metadata has been pushed via mj sync push.`\n            );\n        }\n        return result.Results[0].ID;\n    }\n\n    // ─── Public action methods ────────────────────────────────────────────\n\n    /**\n     * Create a new MemberJunction entity from a `EntityTableSpec`.\n     * Calls the `Create Entity` action on the server which runs the full RSU pipeline.\n     */\n    public async createEntity(\n        tableSpec: EntityTableSpec,\n        options: CreateEntityOptions = {}\n    ): Promise<EntityPipelineResult> {\n        try {\n            const actionId = await this.resolveActionId(ACTION_NAMES.CREATE_ENTITY);\n            const params = this.buildPipelineParams(tableSpec, options);\n            const result = await this.getActionClient().RunAction(actionId, params);\n            return this.extractPipelineResult(result);\n        } catch (err) {\n            return { Success: false, ErrorMessage: this.errorMessage(err) };\n        }\n    }\n\n    /**\n     * Modify an existing MemberJunction entity.\n     * Calls the `Modify Entity` action on the server.\n     */\n    public async modifyEntity(\n        tableSpec: EntityTableSpec,\n        options: ModifyEntityOptions\n    ): Promise<EntityPipelineResult> {\n        try {\n            const actionId = await this.resolveActionId(ACTION_NAMES.MODIFY_ENTITY);\n            const params: ActionParam[] = [\n                ...this.buildPipelineParams(tableSpec, options),\n                { Name: 'ExistingEntityID', Type: 'Input', Value: options.existingEntityId },\n            ];\n            const result = await this.getActionClient().RunAction(actionId, params);\n            return this.extractPipelineResult(result);\n        } catch (err) {\n            return { Success: false, ErrorMessage: this.errorMessage(err) };\n        }\n    }\n\n    /**\n     * Validate a `EntityTableSpec` without executing the pipeline.\n     * Used by Step 4 (Review) of the wizard to surface errors before the user submits.\n     *\n     * Note: `ActionResult.Success` is `true` even when `ValidationResult.Valid` is `false`\n     * because the action itself succeeded — validation failure is a business outcome, not\n     * an infrastructure error.\n     */\n    public async validateEntitySchema(\n        tableSpec: EntityTableSpec,\n        modificationType: 'create' | 'alter' = 'create'\n    ): Promise<ClientValidationResult> {\n        try {\n            const actionId = await this.resolveActionId(ACTION_NAMES.VALIDATE_ENTITY_SCHEMA);\n            const params: ActionParam[] = [\n                { Name: 'TableDefinition', Type: 'Input', Value: tableSpec },\n                { Name: 'ModificationType', Type: 'Input', Value: modificationType },\n            ];\n            const result = await this.getActionClient().RunAction(actionId, params);\n            const outputParams = this.extractOutputParams(result);\n            const outputParam = outputParams.find(p => p.Name === 'ValidationResult');\n            if (outputParam?.Value) {\n                const raw = typeof outputParam.Value === 'string'\n                    ? JSON.parse(outputParam.Value)\n                    : outputParam.Value;\n                return { Valid: !!raw.Valid, Errors: raw.Errors ?? [], Warnings: raw.Warnings ?? [] };\n            }\n            // Fallback: treat action-level failure as a validation failure\n            return { Valid: false, Errors: [result.Message ?? 'Validation failed'], Warnings: [] };\n        } catch (err) {\n            return { Valid: false, Errors: [this.errorMessage(err)], Warnings: [] };\n        }\n    }\n\n    /**\n     * Load detailed metadata for an existing entity.\n     * Used by the entity list slide panel and the modify wizard entry point.\n     */\n    public async describeEntity(entityId: string): Promise<EntityDescribeResult> {\n        try {\n            const actionId = await this.resolveActionId(ACTION_NAMES.DESCRIBE_ENTITY);\n            const params: ActionParam[] = [\n                { Name: 'EntityID', Type: 'Input', Value: entityId },\n            ];\n            const result = await this.getActionClient().RunAction(actionId, params);\n            if (!result.Success) {\n                return { Success: false, ErrorMessage: result.Message };\n            }\n\n            const outputParams = this.extractOutputParams(result);\n            const outputParam = outputParams.find(p => p.Name === 'EntityDetails');\n            const raw = outputParam?.Value\n                ? (typeof outputParam.Value === 'string' ? JSON.parse(outputParam.Value) : outputParam.Value)\n                : {};\n\n            return {\n                Success: true,\n                EntityName: raw.EntityName,\n                SchemaName: raw.SchemaName,\n                TableName: raw.TableName,\n                Description: raw.Description,\n                Fields: raw.Fields ?? [],\n            };\n        } catch (err) {\n            return { Success: false, ErrorMessage: this.errorMessage(err) };\n        }\n    }\n\n    // ─── Private helpers ──────────────────────────────────────────────────\n\n    private buildPipelineParams(tableSpec: EntityTableSpec, options: CreateEntityOptions): ActionParam[] {\n        const params: ActionParam[] = [\n            { Name: 'TableDefinition', Type: 'Input', Value: tableSpec },\n        ];\n        if (options.skipGitCommit) {\n            params.push({ Name: 'SkipGitCommit', Type: 'Input', Value: 'true' });\n        }\n        if (options.skipRestart) {\n            params.push({ Name: 'SkipRestart', Type: 'Input', Value: 'true' });\n        }\n        return params;\n    }\n\n    /**\n     * Extract server output params from a `RunAction` result.\n     *\n     * ### Why `result.Result`, not `result.Params`?\n     * `ActionResolver.createActionResult` on the server serializes all Output/Both typed\n     * params into a JSON string stored in `ResultData`.  `GraphQLActionClient` parses that\n     * JSON and stores the resulting array in `result.Result`.  The `result.Params` field\n     * contains only the *input* params passed by the caller — the server's output params\n     * are never included there.\n     *\n     * This helper centralizes the cast so no caller ever needs to understand this transport\n     * contract directly.\n     */\n    private extractOutputParams(result: ActionResult): ActionParam[] {\n        // result.Result is typed as MJActionResultCodeEntity | undefined in the ActionResult\n        // class, but GraphQLActionClient repurposes it to carry the parsed ResultData payload\n        // (an ActionParam[]).  We cast through unknown to acknowledge this intentional mismatch.\n        const raw: unknown = result.Result;\n        if (Array.isArray(raw)) return raw as ActionParam[];\n\n        // CopyScalarsAndArrays (used server-side to serialize ResultData) converts arrays to\n        // numeric-keyed plain objects — e.g. [p0, p1] → {\"0\": p0, \"1\": p1}.\n        // Detect and restore that pattern so callers can find their output params.\n        if (raw && typeof raw === 'object') {\n            const keys = Object.keys(raw as object);\n            if (keys.length > 0 && keys.every(k => /^\\d+$/.test(k))) {\n                const obj = raw as Record<string, ActionParam>;\n                return keys.sort((a, b) => +a - +b).map(k => obj[k]);\n            }\n        }\n        return [];\n    }\n\n    /**\n     * Map a completed `ActionResult` to an `EntityPipelineResult`.\n     *\n     * Two failure modes are distinguished:\n     *  - `result.Success === false`: infrastructure failure (auth, pipeline exception) → hard error\n     *  - `result.Success === true` but `EntityID` missing: pipeline ran but ID unconfirmed →\n     *    soft warning so the UI can surface guidance without blocking the user\n     */\n    private extractPipelineResult(result: ActionResult): EntityPipelineResult {\n        const outputParams = this.extractOutputParams(result);\n        const find = (name: string) => outputParams.find(p => p.Name === name)?.Value;\n\n        const stepsRaw = find('PipelineSteps');\n        const steps: PipelineStepSummary[] = stepsRaw\n            ? (typeof stepsRaw === 'string' ? JSON.parse(stepsRaw) : stepsRaw)\n            : [];\n\n        if (!result.Success) {\n            return {\n                Success: false,\n                PipelineSteps: steps,\n                ErrorMessage: result.Message ?? 'Action execution failed.',\n            };\n        }\n\n        const entityId = find('EntityID');\n        const warnings: string[] = [];\n\n        if (entityId == null) {\n            // Pipeline ran but EntityID was not echoed back — this can happen when the server\n            // completes the RSU pipeline but the metadata refresh hasn't propagated the new\n            // entity ID yet.  Treat as a soft warning, not a hard failure.\n            warnings.push(\n                'Entity was saved successfully but the EntityID could not be confirmed. ' +\n                'Refresh the list to verify.'\n            );\n        }\n\n        return {\n            Success: true,\n            EntityID: entityId != null ? String(entityId) : undefined,\n            EntityName: String(find('EntityName') ?? ''),\n            SchemaName: String(find('SchemaName') ?? ''),\n            TableName: String(find('TableName') ?? ''),\n            PipelineSteps: steps,\n            Warnings: warnings.length > 0 ? warnings : undefined,\n        };\n    }\n\n    private errorMessage(err: unknown): string {\n        return err instanceof Error ? err.message : String(err);\n    }\n}\n"]}

package/dist/DatabaseDesigner/services/entity-wizard-state.service.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @module entity-wizard-state.service
+ * @description Per-wizard state management for the Database Designer create/modify flow.
+ *
+ * ### Lifecycle
+ * NOT an Angular injectable — manually instantiated by the wizard host component so
+ * each open panel has its own isolated state.  The host must call `destroy()` from
+ * `ngOnDestroy()` to complete all observables and prevent leaks.
+ *
+ * ```typescript
+ * // In the wizard component:
+ * private readonly designerService = inject(DatabaseDesignerService);
+ * private readonly wizardState = new EntityWizardStateService(this.designerService);
+ *
+ * ngOnDestroy(): void { this.wizardState.destroy(); }
+ * ```
+ *
+ * ### Responsibility boundary
+ * - Step navigation (currentStep$ BehaviorSubject)
+ * - Draft TableDefinition assembly from step values
+ * - Synchronous step validation (empty required fields, reserved column names)
+ * - Server round-trips (validateSchema, submit) delegated to DatabaseDesignerService
+ *
+ * No component layout, no templates, no Angular DI lifecycle.
+ */
+import { Observable } from 'rxjs';
+import { DatabaseDesignerService } from './database-designer.service.js';
+import type { EntityTableSpec, BasicsStepValue, ColumnSpec, ForeignKeySpec, ClientValidationResult, EntityPipelineResult, WizardStep } from '../database-designer.types.js';
+export declare class EntityWizardStateService {
+    private readonly designerService;
+    constructor(designerService: DatabaseDesignerService);
+    private readonly _currentStep;
+    private readonly _tableDefinition;
+    private readonly _stepErrors;
+    private readonly _validationResult;
+    private readonly _pipelineResult;
+    private readonly _isValidating;
+    private readonly _isSubmitting;
+    readonly currentStep$: Observable<WizardStep>;
+    readonly tableDefinition$: Observable<Partial<EntityTableSpec>>;
+    readonly stepErrors$: Observable<Record<string, string>>;
+    readonly validationResult$: Observable<ClientValidationResult | null>;
+    readonly pipelineResult$: Observable<EntityPipelineResult | null>;
+    readonly isValidating$: Observable<boolean>;
+    readonly isSubmitting$: Observable<boolean>;
+    get CurrentStep(): WizardStep;
+    get TableDefinition(): Partial<EntityTableSpec>;
+    GoToStep(step: WizardStep): void;
+    /** Returns true if the current step passes synchronous validation. */
+    ValidateStep(step: WizardStep): boolean;
+    UpdateBasics(basics: BasicsStepValue): void;
+    UpdateFields(columns: ColumnSpec[]): void;
+    UpdateRelationships(fks: ForeignKeySpec[]): void;
+    /**
+     * Update relationships and auto-create UUID source columns for any FK whose
+     * `ColumnName` does not yet exist in `Columns`.  Fixes the "Step 3 dead-end"
+     * where a user can add a relationship but has no valid UUID column to back it.
+     *
+     * An auto-created column is marked with `Description: 'Auto-generated FK to {Table}'`
+     * so the user can tell what the wizard added for them.  The column can still
+     * be renamed or deleted from Step 2.
+     */
+    UpdateRelationshipsAndAutoColumns(fks: ForeignKeySpec[]): void;
+    /**
+     * Validate the current TableDefinition via `Validate Entity Schema` action.
+     * Updates `validationResult$` and `stepErrors$`.
+     */
+    ValidateSchema(): Promise<ClientValidationResult>;
+    /**
+     * Run the entity creation or modification pipeline via the appropriate action.
+     * Updates `pipelineResult$` on completion.
+     */
+    Submit(modificationType: 'create' | 'alter', existingEntityId?: string): Promise<EntityPipelineResult>;
+    /** Complete all subjects — call from the host component's ngOnDestroy. */
+    Destroy(): void;
+    /** Build a complete EntityTableSpec from the draft, or null if required fields missing. */
+    private buildCompleteSpec;
+}
+//# sourceMappingURL=entity-wizard-state.service.d.ts.map

package/dist/DatabaseDesigner/services/entity-wizard-state.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-wizard-state.service.d.ts","sourceRoot":"","sources":["../../../src/DatabaseDesigner/services/entity-wizard-state.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAmB,UAAU,EAAE,MAAM,MAAM,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,KAAK,EACR,eAAe,EACf,eAAe,EACf,UAAU,EACV,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,UAAU,EACb,MAAM,+BAA+B,CAAC;AAEvC,qBAAa,wBAAwB;IAErB,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAAf,eAAe,EAAE,uBAAuB;IAIrE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6C;IAC1E,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqD;IACtF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmD;IAC/E,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA4D;IAC9F,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA0D;IAC1F,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuC;IACrE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuC;IAErE,SAAgB,YAAY,EAAE,UAAU,CAAC,UAAU,CAAC,CAAgD;IACpG,SAAgB,gBAAgB,EAAE,UAAU,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAwC;IAC9G,SAAgB,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAoC;IACnG,SAAgB,iBAAiB,EAAE,UAAU,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAyC;IACrH,SAAgB,eAAe,EAAE,UAAU,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAwC;IAChH,SAAgB,aAAa,EAAE,UAAU,CAAC,OAAO,CAAC,CAAmD;IACrG,SAAgB,aAAa,EAAE,UAAU,CAAC,OAAO,CAAC,CAAmD;IAIrG,IAAW,WAAW,IAAI,UAAU,CAAoC;IACxE,IAAW,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC,CAAwC;IAIvF,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAIvC,sEAAsE;IAC/D,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;IAyBvC,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAU3C,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI;IAIzC,mBAAmB,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,IAAI;IAIvD;;;;;;;;OAQG;IACI,iCAAiC,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,IAAI;IA0BrE;;;OAGG;IACU,cAAc,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAuB9D;;;OAGG;IACU,MAAM,CACf,gBAAgB,EAAE,QAAQ,GAAG,OAAO,EACpC,gBAAgB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,oBAAoB,CAAC;IAsBhC,0EAA0E;IACnE,OAAO,IAAI,IAAI;IAYtB,2FAA2F;IAC3F,OAAO,CAAC,iBAAiB;CAY5B"}

package/dist/DatabaseDesigner/services/entity-wizard-state.service.js

@@ -0,0 +1,204 @@
+/**
+ * @module entity-wizard-state.service
+ * @description Per-wizard state management for the Database Designer create/modify flow.
+ *
+ * ### Lifecycle
+ * NOT an Angular injectable — manually instantiated by the wizard host component so
+ * each open panel has its own isolated state.  The host must call `destroy()` from
+ * `ngOnDestroy()` to complete all observables and prevent leaks.
+ *
+ * ```typescript
+ * // In the wizard component:
+ * private readonly designerService = inject(DatabaseDesignerService);
+ * private readonly wizardState = new EntityWizardStateService(this.designerService);
+ *
+ * ngOnDestroy(): void { this.wizardState.destroy(); }
+ * ```
+ *
+ * ### Responsibility boundary
+ * - Step navigation (currentStep$ BehaviorSubject)
+ * - Draft TableDefinition assembly from step values
+ * - Synchronous step validation (empty required fields, reserved column names)
+ * - Server round-trips (validateSchema, submit) delegated to DatabaseDesignerService
+ *
+ * No component layout, no templates, no Angular DI lifecycle.
+ */
+import { BehaviorSubject } from 'rxjs';
+export class EntityWizardStateService {
+    designerService;
+    constructor(designerService) {
+        this.designerService = designerService;
+    }
+    // ─── Observables ───────────────────────────────────────────────────────
+    _currentStep = new BehaviorSubject('basics');
+    _tableDefinition = new BehaviorSubject({});
+    _stepErrors = new BehaviorSubject({});
+    _validationResult = new BehaviorSubject(null);
+    _pipelineResult = new BehaviorSubject(null);
+    _isValidating = new BehaviorSubject(false);
+    _isSubmitting = new BehaviorSubject(false);
+    currentStep$ = this._currentStep.asObservable();
+    tableDefinition$ = this._tableDefinition.asObservable();
+    stepErrors$ = this._stepErrors.asObservable();
+    validationResult$ = this._validationResult.asObservable();
+    pipelineResult$ = this._pipelineResult.asObservable();
+    isValidating$ = this._isValidating.asObservable();
+    isSubmitting$ = this._isSubmitting.asObservable();
+    // ─── Convenience snapshot getters ─────────────────────────────────────
+    get CurrentStep() { return this._currentStep.value; }
+    get TableDefinition() { return this._tableDefinition.value; }
+    // ─── Step navigation ───────────────────────────────────────────────────
+    GoToStep(step) {
+        this._currentStep.next(step);
+    }
+    /** Returns true if the current step passes synchronous validation. */
+    ValidateStep(step) {
+        const errors = {};
+        if (step === 'basics') {
+            const td = this._tableDefinition.value;
+            if (!td.EntityName?.trim())
+                errors['entityName'] = 'Entity name is required.';
+            if (!td.TableName?.trim())
+                errors['tableName'] = 'Table name is required.';
+            if (!td.SchemaName?.trim())
+                errors['schemaName'] = 'Schema is required.';
+        }
+        if (step === 'fields') {
+            const reserved = (this._tableDefinition.value.Columns ?? [])
+                .filter(c => /^(id|__mj_createdat|__mj_updatedat)$/i.test(c.Name));
+            if (reserved.length > 0) {
+                errors['reservedNames'] =
+                    `Remove reserved column names: ${reserved.map(c => c.Name).join(', ')}.`;
+            }
+        }
+        this._stepErrors.next(errors);
+        return Object.keys(errors).length === 0;
+    }
+    // ─── Mutation helpers ──────────────────────────────────────────────────
+    UpdateBasics(basics) {
+        this._tableDefinition.next({
+            ...this._tableDefinition.value,
+            EntityName: basics.entityName,
+            TableName: basics.tableName,
+            SchemaName: basics.schemaName,
+            Description: basics.description || undefined,
+        });
+    }
+    UpdateFields(columns) {
+        this._tableDefinition.next({ ...this._tableDefinition.value, Columns: columns });
+    }
+    UpdateRelationships(fks) {
+        this._tableDefinition.next({ ...this._tableDefinition.value, ForeignKeys: fks });
+    }
+    /**
+     * Update relationships and auto-create UUID source columns for any FK whose
+     * `ColumnName` does not yet exist in `Columns`.  Fixes the "Step 3 dead-end"
+     * where a user can add a relationship but has no valid UUID column to back it.
+     *
+     * An auto-created column is marked with `Description: 'Auto-generated FK to {Table}'`
+     * so the user can tell what the wizard added for them.  The column can still
+     * be renamed or deleted from Step 2.
+     */
+    UpdateRelationshipsAndAutoColumns(fks) {
+        const existing = this._tableDefinition.value.Columns ?? [];
+        const existingNames = new Set(existing.map(c => c.Name.toLowerCase()));
+        const newColumns = [];
+        for (const fk of fks) {
+            if (!fk.ColumnName)
+                continue;
+            if (existingNames.has(fk.ColumnName.toLowerCase()))
+                continue;
+            existingNames.add(fk.ColumnName.toLowerCase());
+            newColumns.push({
+                Name: fk.ColumnName,
+                Type: 'uuid',
+                IsNullable: true,
+                Description: `Auto-generated FK to ${fk.ReferencedSchema}.${fk.ReferencedTable}`,
+            });
+        }
+        this._tableDefinition.next({
+            ...this._tableDefinition.value,
+            Columns: newColumns.length ? [...existing, ...newColumns] : existing,
+            ForeignKeys: fks,
+        });
+    }
+    // ─── Server round-trips ────────────────────────────────────────────────
+    /**
+     * Validate the current TableDefinition via `Validate Entity Schema` action.
+     * Updates `validationResult$` and `stepErrors$`.
+     */
+    async ValidateSchema() {
+        const td = this.buildCompleteSpec();
+        if (!td) {
+            const err = { Valid: false, Errors: ['Schema is incomplete.'], Warnings: [] };
+            this._validationResult.next(err);
+            return err;
+        }
+        this._isValidating.next(true);
+        try {
+            const result = await this.designerService.validateEntitySchema(td);
+            this._validationResult.next(result);
+            if (!result.Valid) {
+                this._stepErrors.next({ serverValidation: result.Errors.join('; ') });
+            }
+            else {
+                this._stepErrors.next({});
+            }
+            return result;
+        }
+        finally {
+            this._isValidating.next(false);
+        }
+    }
+    /**
+     * Run the entity creation or modification pipeline via the appropriate action.
+     * Updates `pipelineResult$` on completion.
+     */
+    async Submit(modificationType, existingEntityId) {
+        const td = this.buildCompleteSpec();
+        if (!td) {
+            const err = { Success: false, ErrorMessage: 'Schema is incomplete.' };
+            this._pipelineResult.next(err);
+            return err;
+        }
+        this._isSubmitting.next(true);
+        try {
+            const result = modificationType === 'create'
+                ? await this.designerService.createEntity(td)
+                : await this.designerService.modifyEntity(td, {
+                    existingEntityId: existingEntityId ?? '',
+                });
+            this._pipelineResult.next(result);
+            return result;
+        }
+        finally {
+            this._isSubmitting.next(false);
+        }
+    }
+    /** Complete all subjects — call from the host component's ngOnDestroy. */
+    Destroy() {
+        this._currentStep.complete();
+        this._tableDefinition.complete();
+        this._stepErrors.complete();
+        this._validationResult.complete();
+        this._pipelineResult.complete();
+        this._isValidating.complete();
+        this._isSubmitting.complete();
+    }
+    // ─── Private helpers ───────────────────────────────────────────────────
+    /** Build a complete EntityTableSpec from the draft, or null if required fields missing. */
+    buildCompleteSpec() {
+        const draft = this._tableDefinition.value;
+        if (!draft.EntityName || !draft.TableName || !draft.SchemaName)
+            return null;
+        return {
+            EntityName: draft.EntityName,
+            TableName: draft.TableName,
+            SchemaName: draft.SchemaName,
+            Description: draft.Description,
+            Columns: draft.Columns ?? [],
+            ForeignKeys: draft.ForeignKeys ?? [],
+        };
+    }
+}
+//# sourceMappingURL=entity-wizard-state.service.js.map

package/dist/DatabaseDesigner/services/entity-wizard-state.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-wizard-state.service.js","sourceRoot":"","sources":["../../../src/DatabaseDesigner/services/entity-wizard-state.service.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @module entity-wizard-state.service\n * @description Per-wizard state management for the Database Designer create/modify flow.\n *\n * ### Lifecycle\n * NOT an Angular injectable — manually instantiated by the wizard host component so\n * each open panel has its own isolated state.  The host must call `destroy()` from\n * `ngOnDestroy()` to complete all observables and prevent leaks.\n *\n * ```typescript\n * // In the wizard component:\n * private readonly designerService = inject(DatabaseDesignerService);\n * private readonly wizardState = new EntityWizardStateService(this.designerService);\n *\n * ngOnDestroy(): void { this.wizardState.destroy(); }\n * ```\n *\n * ### Responsibility boundary\n * - Step navigation (currentStep$ BehaviorSubject)\n * - Draft TableDefinition assembly from step values\n * - Synchronous step validation (empty required fields, reserved column names)\n * - Server round-trips (validateSchema, submit) delegated to DatabaseDesignerService\n *\n * No component layout, no templates, no Angular DI lifecycle.\n */\n\nimport { BehaviorSubject, Observable } from 'rxjs';\nimport { DatabaseDesignerService } from './database-designer.service.js';\nimport type {\n    EntityTableSpec,\n    BasicsStepValue,\n    ColumnSpec,\n    ForeignKeySpec,\n    ClientValidationResult,\n    EntityPipelineResult,\n    WizardStep,\n} from '../database-designer.types.js';\n\nexport class EntityWizardStateService {\n\n    constructor(private readonly designerService: DatabaseDesignerService) {}\n\n    // ─── Observables ───────────────────────────────────────────────────────\n\n    private readonly _currentStep = new BehaviorSubject<WizardStep>('basics');\n    private readonly _tableDefinition = new BehaviorSubject<Partial<EntityTableSpec>>({});\n    private readonly _stepErrors = new BehaviorSubject<Record<string, string>>({});\n    private readonly _validationResult = new BehaviorSubject<ClientValidationResult | null>(null);\n    private readonly _pipelineResult = new BehaviorSubject<EntityPipelineResult | null>(null);\n    private readonly _isValidating = new BehaviorSubject<boolean>(false);\n    private readonly _isSubmitting = new BehaviorSubject<boolean>(false);\n\n    public readonly currentStep$: Observable<WizardStep>             = this._currentStep.asObservable();\n    public readonly tableDefinition$: Observable<Partial<EntityTableSpec>> = this._tableDefinition.asObservable();\n    public readonly stepErrors$: Observable<Record<string, string>>  = this._stepErrors.asObservable();\n    public readonly validationResult$: Observable<ClientValidationResult | null> = this._validationResult.asObservable();\n    public readonly pipelineResult$: Observable<EntityPipelineResult | null>  = this._pipelineResult.asObservable();\n    public readonly isValidating$: Observable<boolean>               = this._isValidating.asObservable();\n    public readonly isSubmitting$: Observable<boolean>               = this._isSubmitting.asObservable();\n\n    // ─── Convenience snapshot getters ─────────────────────────────────────\n\n    public get CurrentStep(): WizardStep { return this._currentStep.value; }\n    public get TableDefinition(): Partial<EntityTableSpec> { return this._tableDefinition.value; }\n\n    // ─── Step navigation ───────────────────────────────────────────────────\n\n    public GoToStep(step: WizardStep): void {\n        this._currentStep.next(step);\n    }\n\n    /** Returns true if the current step passes synchronous validation. */\n    public ValidateStep(step: WizardStep): boolean {\n        const errors: Record<string, string> = {};\n\n        if (step === 'basics') {\n            const td = this._tableDefinition.value;\n            if (!td.EntityName?.trim()) errors['entityName'] = 'Entity name is required.';\n            if (!td.TableName?.trim())  errors['tableName']  = 'Table name is required.';\n            if (!td.SchemaName?.trim()) errors['schemaName'] = 'Schema is required.';\n        }\n\n        if (step === 'fields') {\n            const reserved = (this._tableDefinition.value.Columns ?? [])\n                .filter(c => /^(id|__mj_createdat|__mj_updatedat)$/i.test(c.Name));\n            if (reserved.length > 0) {\n                errors['reservedNames'] =\n                    `Remove reserved column names: ${reserved.map(c => c.Name).join(', ')}.`;\n            }\n        }\n\n        this._stepErrors.next(errors);\n        return Object.keys(errors).length === 0;\n    }\n\n    // ─── Mutation helpers ──────────────────────────────────────────────────\n\n    public UpdateBasics(basics: BasicsStepValue): void {\n        this._tableDefinition.next({\n            ...this._tableDefinition.value,\n            EntityName: basics.entityName,\n            TableName:  basics.tableName,\n            SchemaName: basics.schemaName,\n            Description: basics.description || undefined,\n        });\n    }\n\n    public UpdateFields(columns: ColumnSpec[]): void {\n        this._tableDefinition.next({ ...this._tableDefinition.value, Columns: columns });\n    }\n\n    public UpdateRelationships(fks: ForeignKeySpec[]): void {\n        this._tableDefinition.next({ ...this._tableDefinition.value, ForeignKeys: fks });\n    }\n\n    /**\n     * Update relationships and auto-create UUID source columns for any FK whose\n     * `ColumnName` does not yet exist in `Columns`.  Fixes the \"Step 3 dead-end\"\n     * where a user can add a relationship but has no valid UUID column to back it.\n     *\n     * An auto-created column is marked with `Description: 'Auto-generated FK to {Table}'`\n     * so the user can tell what the wizard added for them.  The column can still\n     * be renamed or deleted from Step 2.\n     */\n    public UpdateRelationshipsAndAutoColumns(fks: ForeignKeySpec[]): void {\n        const existing = this._tableDefinition.value.Columns ?? [];\n        const existingNames = new Set(existing.map(c => c.Name.toLowerCase()));\n\n        const newColumns: ColumnSpec[] = [];\n        for (const fk of fks) {\n            if (!fk.ColumnName) continue;\n            if (existingNames.has(fk.ColumnName.toLowerCase())) continue;\n            existingNames.add(fk.ColumnName.toLowerCase());\n            newColumns.push({\n                Name: fk.ColumnName,\n                Type: 'uuid',\n                IsNullable: true,\n                Description: `Auto-generated FK to ${fk.ReferencedSchema}.${fk.ReferencedTable}`,\n            });\n        }\n\n        this._tableDefinition.next({\n            ...this._tableDefinition.value,\n            Columns: newColumns.length ? [...existing, ...newColumns] : existing,\n            ForeignKeys: fks,\n        });\n    }\n\n    // ─── Server round-trips ────────────────────────────────────────────────\n\n    /**\n     * Validate the current TableDefinition via `Validate Entity Schema` action.\n     * Updates `validationResult$` and `stepErrors$`.\n     */\n    public async ValidateSchema(): Promise<ClientValidationResult> {\n        const td = this.buildCompleteSpec();\n        if (!td) {\n            const err: ClientValidationResult = { Valid: false, Errors: ['Schema is incomplete.'], Warnings: [] };\n            this._validationResult.next(err);\n            return err;\n        }\n\n        this._isValidating.next(true);\n        try {\n            const result = await this.designerService.validateEntitySchema(td);\n            this._validationResult.next(result);\n            if (!result.Valid) {\n                this._stepErrors.next({ serverValidation: result.Errors.join('; ') });\n            } else {\n                this._stepErrors.next({});\n            }\n            return result;\n        } finally {\n            this._isValidating.next(false);\n        }\n    }\n\n    /**\n     * Run the entity creation or modification pipeline via the appropriate action.\n     * Updates `pipelineResult$` on completion.\n     */\n    public async Submit(\n        modificationType: 'create' | 'alter',\n        existingEntityId?: string,\n    ): Promise<EntityPipelineResult> {\n        const td = this.buildCompleteSpec();\n        if (!td) {\n            const err: EntityPipelineResult = { Success: false, ErrorMessage: 'Schema is incomplete.' };\n            this._pipelineResult.next(err);\n            return err;\n        }\n\n        this._isSubmitting.next(true);\n        try {\n            const result = modificationType === 'create'\n                ? await this.designerService.createEntity(td)\n                : await this.designerService.modifyEntity(td, {\n                    existingEntityId: existingEntityId ?? '',\n                });\n            this._pipelineResult.next(result);\n            return result;\n        } finally {\n            this._isSubmitting.next(false);\n        }\n    }\n\n    /** Complete all subjects — call from the host component's ngOnDestroy. */\n    public Destroy(): void {\n        this._currentStep.complete();\n        this._tableDefinition.complete();\n        this._stepErrors.complete();\n        this._validationResult.complete();\n        this._pipelineResult.complete();\n        this._isValidating.complete();\n        this._isSubmitting.complete();\n    }\n\n    // ─── Private helpers ───────────────────────────────────────────────────\n\n    /** Build a complete EntityTableSpec from the draft, or null if required fields missing. */\n    private buildCompleteSpec(): EntityTableSpec | null {\n        const draft = this._tableDefinition.value;\n        if (!draft.EntityName || !draft.TableName || !draft.SchemaName) return null;\n        return {\n            EntityName: draft.EntityName,\n            TableName:  draft.TableName,\n            SchemaName: draft.SchemaName,\n            Description: draft.Description,\n            Columns:     draft.Columns ?? [],\n            ForeignKeys: draft.ForeignKeys ?? [],\n        };\n    }\n}\n"]}