@acorex-platform/module-integration-management-client 0.0.37 → 0.0.46

package/fesm2022/acorex-platform-module-integration-management-client.mjs

@@ -1,12 +1,13 @@
 import { AXP_INTEGRATION_CONNECTION_STATUS, AXP_INTEGRATION_CONNECTION_SCOPE, AXP_INTEGRATION_CATEGORY, AXPIntegrationNotConnectedError, AXPIntegrationExpiredError, AXPIntegrationMissingScopeError } from '@acorex-platform/framework-shared/core';
 import { AXPSessionService, AXP_PERMISSION_DEFINITION_PROVIDER } from '@acorex-platform/framework-client/auth';
-import { AXPEntityService, AXP_ENTITY_MODIFIER } from '@acorex-platform/framework-client/layout/entity';
+import { AXPEntityService, configureEntityListColumnsSettingsMigrateDrop, configureEntityListColumnsSettingsVersion, AXP_ENTITY_ACTION_PLUGIN, AXP_ENTITY_MODIFIER } from '@acorex-platform/framework-client/layout/entity';
 import * as i0 from '@angular/core';
 import { inject, Injectable, NgModule } from '@angular/core';
 import { isEmpty, trim, defaultTo } from 'lodash';
 import { RootConfig, AXPAdministrationPermissionKeys, AXMIntegrationManagementMenuKeys, AXMIntegrationManagementCommandKeys, AXMIntegrationManagementQueryKeys } from '@acorex-platform/module-integration-management-client/contracts';
+export { IntegrationManagementManifest } from '@acorex-platform/module-integration-management-client/contracts';
 import { AXPIntegrationRuntimeService, AXPIntegrationProviderRegistryService, AXP_INTEGRATION_SECRET_STORE, AXP_INTEGRATION_RUNTIME_PROVIDER, AXP_PROTECTED_ROUTE_GUARDS, AXP_MENU_PROVIDER, AXP_SETTING_DEFINITION_PROVIDER, AXP_INTEGRATION_DOMAIN_PROVIDER } from '@acorex-platform/framework-client/common';
-import { AXP_MODULE_MANIFEST_PROVIDER, AXP_EXPRESSION_EVALUATOR_SCOPE_PROVIDER } from '@acorex-platform/framework-client/core';
+import { AXP_EXPRESSION_EVALUATOR_SCOPE_PROVIDER } from '@acorex-platform/framework-client/core';
 import { AXP_PAGE_COMPONENT_PROVIDER } from '@acorex-platform/framework-client/layout/components';
 import { AXP_WIDGET_DEFINITION_PROVIDER } from '@acorex-platform/framework-client/layout/widget-core';
 import { AXPRuntimeModule, provideCommandSetups, provideQuerySetups } from '@acorex-platform/framework-client/runtime';
@@ -308,17 +309,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
             args: [{ providedIn: 'root' }]
         }] });
 
-const IntegrationManagementManifest = {
-    name: RootConfig.module.name,
-    version: '1.0.0',
-    title: RootConfig.module.title,
-    icon: RootConfig.module.icon,
-    i18n: RootConfig.config.i18n,
-    type: 'platform',
-    domain: 'platform',
-    required: false,
-};
-
 //#region ----- Imports -----
 //#endregion
 //#region ----- Menu Provider -----
@@ -642,7 +632,7 @@ const AXMIntegrationRefWidget = {
     properties: [],
     components: {
         column: {
-            component: () => import('./acorex-platform-module-integration-management-client-integration-ref-widget-column.component-CPLhmHOe.mjs').then((c) => c.AXMIntegrationRefWidgetColumnComponent),
+            component: () => import('./acorex-platform-module-integration-management-client-integration-ref-widget-column.component-ClPcvcUW.mjs').then((c) => c.AXMIntegrationRefWidgetColumnComponent),
         },
         view: {
             component: () => import('./acorex-platform-module-integration-management-client-integration-ref-widget-view.component-BRpGpWHZ.mjs').then((c) => c.AXMIntegrationRefWidgetViewComponent),
@@ -654,100 +644,137 @@ const AXMIntegrationRefWidget = {
 //#region ----- Imports -----
 //#endregion
 //#region ----- Constants -----
-const COLUMN_TITLE = '@integration-management:widgets.integration-ref.column-title';
-const PAGE_TITLE = '@integration-management:widgets.integration-ref.page.title';
-/** Place near other related tabs (Members/Tasks/Documents), after Overview. */
-const PAGE_ORDER = 20;
+const AXM_INTEGRATION_REF_PLUGIN_NAME = 'integration-ref';
+const DEFAULT_FIELD = 'integrationRef';
+const DEFAULT_COLUMN_TITLE = '@integration-management:widgets.integration-ref.column-title';
+const DEFAULT_PAGE_TITLE = '@integration-management:widgets.integration-ref.page.title';
+const DEFAULT_PAGE_ORDER = 20;
+const DEFAULT_COLUMN_WIDTH = '140px';
+//#endregion
+//#region ----- Helpers -----
+/** List columns that represent entity status (`status`, `statusId`, `projectStatusId`, …). */
+function isStatusColumnName(name) {
+    const normalized = name.trim().toLowerCase();
+    return (normalized === 'status' ||
+        normalized === 'statusid' ||
+        normalized.endsWith('statusid') ||
+        (normalized.endsWith('status') && !normalized.includes('http')));
+}
 //#endregion
-//#region ----- Modifier -----
+//#region ----- Apply -----
 /**
- * For any entity that already declares `integrationRef`:
- * - wire the `integration-ref` list widget / column
- * - add a readonly Integration Info detail/edit tab (same tab strip as Overview/Profile)
+ * Ensures Source list column + Integration Info tab for an entity that carries `integrationRef`.
  */
-const AXMIntegrationRefEntityModifier = {
-    entityName: '*',
-    /** After default column ordering so we can pin the icon column first. */
-    order: 120,
-    modifier: (ctx) => {
-        const property = ctx.properties.find('integrationRef').get();
-        if (!property) {
-            return;
-        }
-        ctx.properties.find('integrationRef').update((prop) => ({
-            ...prop,
-            title: COLUMN_TITLE,
-            options: {
-                ...prop.options,
-                filter: {
-                    ...(prop.options?.filter ?? {}),
-                    advance: {
-                        ...(prop.options?.filter?.advance ?? {}),
-                        enabled: true,
-                        widgetType: AXM_INTEGRATION_REF_FILTER_WIDGET_NAME,
-                    },
-                    inline: {
-                        ...(prop.options?.filter?.inline ?? {}),
-                        enabled: true,
-                    },
+function applyIntegrationRefEnhancements(ctx, options = {}) {
+    const field = String(options.field ?? DEFAULT_FIELD).trim() || DEFAULT_FIELD;
+    const columnTitle = options.title ?? DEFAULT_COLUMN_TITLE;
+    const pageTitle = options.pageTitle ?? DEFAULT_PAGE_TITLE;
+    const pageIcon = options.pageIcon ?? 'fa-light fa-plug';
+    const pageOrder = options.pageOrder ?? DEFAULT_PAGE_ORDER;
+    const columnWidth = options.columnWidth ?? DEFAULT_COLUMN_WIDTH;
+    /** Default off; still choosable in the column picker. */
+    const columnVisible = options.columnVisible === true;
+    const showListColumn = options.showListColumn !== false;
+    const showPage = options.showPage !== false;
+    const groupId = options.groupId ?? 'basic-info';
+    if (!ctx.properties.find(field).get()) {
+        ctx.properties.add({
+            name: field,
+            title: columnTitle,
+            groupId,
+            schema: {
+                dataType: 'object',
+                visible: false,
+                nullable: true,
+                readonly: true,
+            },
+        });
+    }
+    ctx.properties.find(field).update((prop) => ({
+        ...prop,
+        title: prop.title ?? columnTitle,
+        options: {
+            ...prop.options,
+            filter: {
+                ...(prop.options?.filter ?? {}),
+                advance: {
+                    ...(prop.options?.filter?.advance ?? {}),
+                    enabled: true,
+                    widgetType: AXM_INTEGRATION_REF_FILTER_WIDGET_NAME,
+                },
+                inline: {
+                    ...(prop.options?.filter?.inline ?? {}),
+                    enabled: true,
                 },
             },
-            schema: {
-                ...prop.schema,
-                interface: {
-                    ...(prop.schema.interface ?? {}),
-                    type: AXM_INTEGRATION_REF_WIDGET_NAME,
-                    options: {
-                        ...(prop.schema.interface?.options ?? {}),
-                        /**
-                         * Drives list `inlineQueryField` → `integrationRef.source`
-                         * so Source filters query the nested provider id.
-                         */
-                        textField: 'source',
-                        expose: [
-                            {
-                                source: 'source',
-                                target: 'integrationRef.source',
-                            },
-                        ],
-                    },
+        },
+        schema: {
+            ...prop.schema,
+            dataType: prop.schema?.dataType ?? 'object',
+            // Keep off the overview form; Integration Info page owns the UI.
+            visible: false,
+            nullable: prop.schema?.nullable ?? true,
+            readonly: true,
+            interface: {
+                ...(prop.schema.interface ?? {}),
+                type: AXM_INTEGRATION_REF_WIDGET_NAME,
+                options: {
+                    ...(prop.schema.interface?.options ?? {}),
+                    textField: 'source',
+                    expose: [
+                        {
+                            source: 'source',
+                            target: `${field}.source`,
+                        },
+                    ],
                 },
             },
-        }));
-        if (!ctx.columns.find('integrationRef').get()) {
+        },
+    }));
+    if (showListColumn) {
+        if (!ctx.columns.find(field).get()) {
             ctx.columns.add({
-                name: 'integrationRef',
-                title: COLUMN_TITLE,
-                options: { width: '140px' },
+                name: field,
+                title: columnTitle,
+                options: { width: columnWidth, visible: columnVisible },
             });
         }
         else {
-            ctx.columns.find('integrationRef').update((col) => ({
+            ctx.columns.find(field).update((col) => ({
                 ...col,
-                title: col.title ?? COLUMN_TITLE,
+                title: col.title ?? columnTitle,
                 options: {
                     ...(col.options ?? {}),
-                    width: '140px',
+                    width: columnWidth,
+                    visible: columnVisible,
                 },
             }));
         }
         const columns = ctx.columns.list();
         if (columns?.length) {
-            const index = columns.findIndex((col) => col.name === 'integrationRef');
-            if (index > 0) {
+            const index = columns.findIndex((col) => col.name === field);
+            if (index >= 0) {
                 const [column] = columns.splice(index, 1);
-                columns.unshift(column);
+                const statusIndex = columns.findIndex((col) => isStatusColumnName(String(col.name ?? '')));
+                if (statusIndex >= 0) {
+                    columns.splice(statusIndex, 0, column);
+                }
+                else {
+                    columns.push(column);
+                }
             }
         }
+    }
+    if (showPage) {
         ctx.entity.pages ??= [];
         const page = {
             componentKey: AXM_INTEGRATION_REF_PAGE_COMPONENT_KEY,
-            title: PAGE_TITLE,
-            icon: 'fa-light fa-plug',
-            layout: { order: PAGE_ORDER, position: 'after' },
+            title: pageTitle,
+            icon: pageIcon,
+            layout: { order: pageOrder, position: 'after' },
             /**
-             * Required for update/edit form wizard steps.
-             * Details view always includes entity.pages; empty state handles unlinked records.
+             * Update/edit form wizard only. Details view always includes entity.pages.
+             * Do not set create — empty Integration Info as a create wizard step remounts the dialog.
              */
             appearOn: { update: true },
         };
@@ -758,10 +785,99 @@ const AXMIntegrationRefEntityModifier = {
         else {
             ctx.entity.pages.push(page);
         }
+    }
+}
+//#endregion
+
+//#region ----- Imports -----
+//#endregion
+//#region ----- Fallback modifier -----
+/**
+ * Applies Source column + Integration Info when the entity already declares `integrationRef`
+ * but the seeded layout has not yet listed the `integration-ref` plugin (stale definitions).
+ * Skips when the action plugin is declared so options (`groupId`, …) win.
+ */
+const AXMIntegrationRefFallbackModifier = {
+    entityName: '*',
+    /** Just after the action plugin (80) so declared plugins win when both could apply. */
+    order: 81,
+    modifier: (ctx) => {
+        const hasPlugin = (ctx.entity.plugins ?? []).some((entry) => entry.name === AXM_INTEGRATION_REF_PLUGIN_NAME);
+        if (hasPlugin) {
+            return;
+        }
+        if (!ctx.properties.find('integrationRef').get()) {
+            return;
+        }
+        applyIntegrationRefEnhancements(ctx, {});
+    },
+};
+//#endregion
+
+//#region ----- Imports -----
+//#endregion
+//#region ----- Plugin -----
+/**
+ * Opt-in plugin for entities linked from integration connections.
+ * - Ensures `integrationRef` property + Source list column (off by default, toggable)
+ * - Places Source last before Status when present
+ * - Adds readonly Integration Info tab on update/detail (not create)
+ */
+const integrationRefPlugin = {
+    name: AXM_INTEGRATION_REF_PLUGIN_NAME,
+    /** After status (70) / attachments (50) so Source can sit before Status. */
+    order: 80,
+    apply: (ctx, options = {}) => {
+        applyIntegrationRefEnhancements(ctx, options);
     },
 };
 //#endregion
 
+//#region ----- Imports -----
+//#endregion
+//#region ----- Boot configure (once) -----
+/**
+ * Clear stale Source column prefs from when the column was first-pinned.
+ * Framework migrate-drop registry stays empty until this module loads.
+ */
+configureEntityListColumnsSettingsMigrateDrop(['integrationRef']);
+configureEntityListColumnsSettingsVersion(3);
+//#endregion
+//#region ----- Module -----
+class AXMIntegrationRefPluginModule {
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXMIntegrationRefPluginModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
+    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "22.0.8", ngImport: i0, type: AXMIntegrationRefPluginModule }); }
+    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXMIntegrationRefPluginModule, providers: [
+            {
+                provide: AXP_ENTITY_ACTION_PLUGIN,
+                multi: true,
+                useValue: integrationRefPlugin,
+            },
+            {
+                provide: AXP_ENTITY_MODIFIER,
+                multi: true,
+                useValue: AXMIntegrationRefFallbackModifier,
+            },
+        ] }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXMIntegrationRefPluginModule, decorators: [{
+            type: NgModule,
+            args: [{
+                    providers: [
+                        {
+                            provide: AXP_ENTITY_ACTION_PLUGIN,
+                            multi: true,
+                            useValue: integrationRefPlugin,
+                        },
+                        {
+                            provide: AXP_ENTITY_MODIFIER,
+                            multi: true,
+                            useValue: AXMIntegrationRefFallbackModifier,
+                        },
+                    ],
+                }]
+        }] });
+
 //#endregion
 //#region ----- Provider -----
 class AXMIntegrationRefPageComponentProvider {
@@ -769,7 +885,7 @@ class AXMIntegrationRefPageComponentProvider {
         return [
             {
                 key: AXM_INTEGRATION_REF_PAGE_COMPONENT_KEY,
-                loader: () => import('./acorex-platform-module-integration-management-client-integration-ref-page.component-D9hdpnQq.mjs').then((m) => m.AXMIntegrationRefPageComponent),
+                loader: () => import('./acorex-platform-module-integration-management-client-integration-ref-page.component-C131H4e1.mjs').then((m) => m.AXMIntegrationRefPageComponent),
             },
         ];
     }
@@ -798,18 +914,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
 //#region ---- Module ----
 class AXMIntegrationManagementModule {
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXMIntegrationManagementModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
-    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "22.0.8", ngImport: i0, type: AXMIntegrationManagementModule, imports: [CommonModule, AXPRuntimeModule] }); }
+    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "22.0.8", ngImport: i0, type: AXMIntegrationManagementModule, imports: [CommonModule, AXPRuntimeModule, AXMIntegrationRefPluginModule] }); }
     static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXMIntegrationManagementModule, providers: [
             {
                 provide: ROUTES,
                 multi: true,
                 useFactory: () => [...integrationManagementRoutesFactory(), ...integrationOAuthCallbackRoutes],
             },
-            {
-                provide: AXP_MODULE_MANIFEST_PROVIDER,
-                useValue: IntegrationManagementManifest,
-                multi: true,
-            },
             {
                 provide: AXP_PERMISSION_DEFINITION_PROVIDER,
                 useClass: AXMIntegrationManagementPermissionDefinitionProvider,
@@ -849,11 +960,6 @@ class AXMIntegrationManagementModule {
                 useClass: AXMIntegrationRefPageComponentProvider,
                 multi: true,
             },
-            {
-                provide: AXP_ENTITY_MODIFIER,
-                useValue: AXMIntegrationRefEntityModifier,
-                multi: true,
-            },
             provideCommandSetups([
                 {
                     key: AXMIntegrationManagementCommandKeys.ConnectionConnectWithCredentials,
@@ -894,23 +1000,18 @@ class AXMIntegrationManagementModule {
                     loader: () => import('./acorex-platform-module-integration-management-client-list-my-connections.query-CmHu1qFm.mjs').then((c) => c.ListMyConnectionsQuery),
                 },
             ]),
-        ], imports: [CommonModule, AXPRuntimeModule] }); }
+        ], imports: [CommonModule, AXPRuntimeModule, AXMIntegrationRefPluginModule] }); }
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXMIntegrationManagementModule, decorators: [{
             type: NgModule,
             args: [{
-                    imports: [CommonModule, AXPRuntimeModule],
+                    imports: [CommonModule, AXPRuntimeModule, AXMIntegrationRefPluginModule],
                     providers: [
                         {
                             provide: ROUTES,
                             multi: true,
                             useFactory: () => [...integrationManagementRoutesFactory(), ...integrationOAuthCallbackRoutes],
                         },
-                        {
-                            provide: AXP_MODULE_MANIFEST_PROVIDER,
-                            useValue: IntegrationManagementManifest,
-                            multi: true,
-                        },
                         {
                             provide: AXP_PERMISSION_DEFINITION_PROVIDER,
                             useClass: AXMIntegrationManagementPermissionDefinitionProvider,
@@ -950,11 +1051,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
                             useClass: AXMIntegrationRefPageComponentProvider,
                             multi: true,
                         },
-                        {
-                            provide: AXP_ENTITY_MODIFIER,
-                            useValue: AXMIntegrationRefEntityModifier,
-                            multi: true,
-                        },
                         provideCommandSetups([
                             {
                                 key: AXMIntegrationManagementCommandKeys.ConnectionConnectWithCredentials,
@@ -1003,5 +1099,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { AXMIntegrationConnectionManager, AXMIntegrationManagementModule, AXP_INTEGRATION_CREDENTIAL_MASK, IntegrationManagementManifest, hasConfiguredIntegrationCredentials, isMaskedIntegrationCredential, scrubDisconnectedConnectionConfig, toSafeIntegrationConnectionDto };
+export { AXMIntegrationConnectionManager, AXMIntegrationManagementModule, AXP_INTEGRATION_CREDENTIAL_MASK, hasConfiguredIntegrationCredentials, isMaskedIntegrationCredential, scrubDisconnectedConnectionConfig, toSafeIntegrationConnectionDto };
 //# sourceMappingURL=acorex-platform-module-integration-management-client.mjs.map