@salesforce/plugin-orchestrator 1.0.0

package/lib/commands/orchestrator/template/update.js

@@ -0,0 +1,107 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import { Flags, SfCommand } from '@salesforce/sf-plugins-core';
+import { Messages, SfError } from '@salesforce/core';
+import AppFrameworkTemplate from '../../../utils/template/appframeworktemplate.js';
+import { TemplateDisplayUtil } from '../../../utils/template/templateDisplayUtil.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-orchestrator', 'appframework.template.update');
+export default class Update extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static state = 'preview';
+    static flags = {
+        'target-org': Flags.requiredOrg({
+            summary: messages.getMessage('flags.target-org.summary'),
+            description: messages.getMessage('flags.target-org.description'),
+            required: true,
+        }),
+        'api-version': Flags.orgApiVersion({
+            summary: messages.getMessage('flags.api-version.summary'),
+            description: messages.getMessage('flags.api-version.description'),
+        }),
+        'template-id': Flags.string({
+            char: 'i',
+            summary: messages.getMessage('flags.template-id.summary'),
+            description: messages.getMessage('flags.template-id.description'),
+            exclusive: ['template-name'],
+        }),
+        'template-name': Flags.string({
+            char: 'n',
+            summary: messages.getMessage('flags.template-name.summary'),
+            description: messages.getMessage('flags.template-name.description'),
+            exclusive: ['template-id'],
+        }),
+        label: Flags.string({
+            char: 'l',
+            summary: messages.getMessage('flags.label.summary'),
+            description: messages.getMessage('flags.label.description'),
+        }),
+        description: Flags.string({
+            char: 'd',
+            summary: messages.getMessage('flags.description.summary'),
+            description: messages.getMessage('flags.description.description'),
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(Update);
+        if (!flags['template-id'] && !flags['template-name']) {
+            throw new SfError(messages.getMessage('missingRequiredField'), 'MissingRequiredFlag');
+        }
+        try {
+            this.spinner.start(messages.getMessage('fetchingTemplate'));
+            const connection = flags['target-org'].getConnection(flags['api-version']);
+            const appFrameworkTemplate = new AppFrameworkTemplate(connection);
+            const identifier = flags['template-id'] ?? flags['template-name'];
+            this.spinner.stop();
+            this.spinner.start(messages.getMessage('updatingTemplate'));
+            const updateOptions = {
+                label: flags.label,
+                description: flags.description,
+            };
+            const rawTemplate = await appFrameworkTemplate.update(identifier, updateOptions);
+            this.spinner.stop();
+            this.log(messages.getMessage('updateSuccess', [rawTemplate.name, rawTemplate.id]));
+            const updatedTemplate = {
+                id: rawTemplate.id,
+                name: rawTemplate.name,
+                label: rawTemplate.label,
+                description: rawTemplate.description,
+                templateType: rawTemplate.templateType,
+                templateSubtype: rawTemplate.templateSubtype,
+                templateId: rawTemplate.templateId,
+                folderId: rawTemplate.folderId,
+                namespace: rawTemplate.namespace,
+                templateVersion: rawTemplate.releaseInfo?.templateVersion,
+                assetVersion: rawTemplate.assetVersion,
+                maxAppCount: rawTemplate.maxAppCount,
+                variableDefinition: rawTemplate.variableDefinition,
+                layoutDefinition: rawTemplate.layoutDefinition,
+                rules: rawTemplate.rules,
+                created: rawTemplate.createdDate ? new Date(rawTemplate.createdDate).toLocaleDateString() : 'n/a',
+                modified: rawTemplate.lastModifiedDate ? new Date(rawTemplate.lastModifiedDate).toLocaleDateString() : 'n/a',
+                industries: rawTemplate.tags?.industries?.join(', ') ?? 'n/a',
+                audience: rawTemplate.tags?.targetAudience?.join(', ') ?? 'n/a',
+                icons: rawTemplate.icons,
+                chainDefinitions: rawTemplate.chainDefinitions,
+                applicationSourceId: rawTemplate.applicationSourceId,
+                url: rawTemplate.url,
+                configurationUrl: rawTemplate.configurationUrl,
+                readinessUrl: rawTemplate.readinessUrl,
+            };
+            TemplateDisplayUtil.displayTemplateDetail(this, updatedTemplate);
+            return updatedTemplate;
+        }
+        catch (error) {
+            this.spinner.stop();
+            const errorMsg = error.message;
+            throw new SfError(`Error updating template: ${errorMsg}`, 'TemplateUpdateError');
+        }
+    }
+}
+//# sourceMappingURL=update.js.map

package/lib/commands/orchestrator/template/update.js.map

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

package/lib/commands/orchestrator/update/app.d.ts

@@ -0,0 +1,20 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export default class UpdateApp extends SfCommand<string> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly state = "preview";
+    static readonly flags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'app-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'app-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'template-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'template-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        label: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'runtime-method': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'log-level': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<string>;
+}

package/lib/commands/orchestrator/update/app.js

@@ -0,0 +1,145 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import { Flags, SfCommand } from '@salesforce/sf-plugins-core';
+import { Messages, SfError } from '@salesforce/core';
+import AppFrameworkApp from '../../../utils/app/appframeworkapp.js';
+import { AppListUtil } from '../../../utils/app/appListUtils.js';
+import { AppDisplayUtil } from '../../../utils/app/appDisplayUtil.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-orchestrator', 'appframework.update.app');
+export default class UpdateApp extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static state = 'preview';
+    static flags = {
+        'target-org': Flags.requiredOrg({
+            summary: messages.getMessage('flags.target-org.summary'),
+            description: messages.getMessage('flags.target-org.description'),
+            required: true,
+        }),
+        'api-version': Flags.orgApiVersion({
+            summary: messages.getMessage('flags.api-version.summary'),
+            description: messages.getMessage('flags.api-version.description'),
+        }),
+        'app-id': Flags.string({
+            char: 'i',
+            summary: messages.getMessage('flags.app-id.summary'),
+            description: messages.getMessage('flags.app-id.description'),
+            exclusive: ['app-name'],
+        }),
+        'app-name': Flags.string({
+            char: 'n',
+            summary: messages.getMessage('flags.app-name.summary'),
+            description: messages.getMessage('flags.app-name.description'),
+            exclusive: ['app-id'],
+        }),
+        'template-id': Flags.string({
+            char: 't',
+            summary: messages.getMessage('flags.template-id.summary'),
+            description: messages.getMessage('flags.template-id.description'),
+            exclusive: ['template-name'],
+        }),
+        'template-name': Flags.string({
+            char: 'm',
+            summary: messages.getMessage('flags.template-name.summary'),
+            description: messages.getMessage('flags.template-name.description'),
+            exclusive: ['template-id'],
+        }),
+        label: Flags.string({
+            char: 'l',
+            summary: messages.getMessage('flags.label.summary'),
+            description: messages.getMessage('flags.label.description'),
+        }),
+        description: Flags.string({
+            char: 'd',
+            summary: messages.getMessage('flags.description.summary'),
+            description: messages.getMessage('flags.description.description'),
+        }),
+        'runtime-method': Flags.string({
+            char: 'r',
+            summary: messages.getMessage('flags.runtime-method.summary'),
+            description: messages.getMessage('flags.runtime-method.description'),
+            options: ['sync', 'async'],
+        }),
+        'log-level': Flags.string({
+            char: 'g',
+            summary: messages.getMessage('flags.log-level.summary'),
+            description: messages.getMessage('flags.log-level.description'),
+            options: ['debug', 'info', 'warn', 'error'],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(UpdateApp);
+        // Check that at least one of app-id or app-name is provided
+        if (!flags['app-id'] && !flags['app-name']) {
+            throw new SfError(messages.getMessage('noAppSpecified'), 'AppUpdateError', messages.getMessages('error.UpdateError.Actions'));
+        }
+        // Check that at least one of template-id or template-name is provided
+        if (!flags['template-id'] && !flags['template-name']) {
+            throw new SfError(messages.getMessage('noTemplateSpecified'), 'AppUpdateError', messages.getMessages('error.UpdateError.Actions'));
+        }
+        try {
+            const connection = flags['target-org'].getConnection(flags['api-version']);
+            const appFrameworkApp = new AppFrameworkApp(connection);
+            let appId = '';
+            // Get app ID if app name was provided
+            if (flags['app-name']) {
+                this.spinner.start(messages.getMessage('fetchingApp'));
+                const apps = await appFrameworkApp.list();
+                const app = apps.find((a) => a.name === flags['app-name']);
+                if (!app) {
+                    this.spinner.stop();
+                    throw new SfError(messages.getMessage('noAppFound'), 'AppUpdateError', messages.getMessages('error.UpdateError.Actions'));
+                }
+                appId = app.id ?? '';
+                this.spinner.stop();
+            }
+            else {
+                appId = flags['app-id'] ?? '';
+            }
+            let templateId = '';
+            // Get template ID if template name was provided
+            if (flags['template-name']) {
+                this.spinner.start(messages.getMessage('fetchingTemplate'));
+                // Since we don't have a direct way to list templates,
+                // we need to get the template by name from a different utility class
+                // For now, we'll throw an error and suggest using template-id instead
+                this.spinner.stop();
+                throw new SfError(messages.getMessage('noTemplateFound'), 'AppUpdateError', messages.getMessages('error.UpdateError.Actions'));
+            }
+            else {
+                templateId = flags['template-id'] ?? '';
+            }
+            // Update the app
+            this.spinner.start(messages.getMessage('updatingApp'));
+            const updatedAppId = await appFrameworkApp.updateApp(appId, {
+                templateSourceId: templateId,
+                label: flags.label,
+                description: flags.description,
+                runtimeMethod: flags['runtime-method'],
+                logLevel: flags['log-level'],
+            });
+            this.spinner.stop();
+            this.log(messages.getMessage('updateSuccess', [updatedAppId]));
+            // Fetch the updated app and display its details
+            const updatedApp = await appFrameworkApp.getApp(updatedAppId);
+            if (updatedApp) {
+                const processedApps = AppListUtil.processApps([updatedApp]);
+                if (processedApps.length > 0) {
+                    AppDisplayUtil.displayAppDetails(this, processedApps[0]);
+                }
+            }
+            return updatedAppId;
+        }
+        catch (error) {
+            this.spinner.stop();
+            throw new SfError(messages.getMessage('error.UpdateError', [error.message]), 'AppUpdateError', messages.getMessages('error.UpdateError.Actions'));
+        }
+    }
+}
+//# sourceMappingURL=app.js.map

package/lib/commands/orchestrator/update/app.js.map

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

package/lib/commands/orchestrator/update/template.d.ts

@@ -0,0 +1,17 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { TemplateData } from '../../../utils/template/templateTypes.js';
+export default class UpdateTemplate extends SfCommand<TemplateData> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly state = "preview";
+    static readonly flags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'template-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'template-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        label: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<TemplateData>;
+}

package/lib/commands/orchestrator/update/template.js

@@ -0,0 +1,107 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import { Flags, SfCommand } from '@salesforce/sf-plugins-core';
+import { Messages, SfError } from '@salesforce/core';
+import AppFrameworkTemplate from '../../../utils/template/appframeworktemplate.js';
+import { TemplateDisplayUtil } from '../../../utils/template/templateDisplayUtil.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-orchestrator', 'appframework.update.template');
+export default class UpdateTemplate extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static state = 'preview';
+    static flags = {
+        'target-org': Flags.requiredOrg({
+            summary: messages.getMessage('flags.target-org.summary'),
+            description: messages.getMessage('flags.target-org.description'),
+            required: true,
+        }),
+        'api-version': Flags.orgApiVersion({
+            summary: messages.getMessage('flags.api-version.summary'),
+            description: messages.getMessage('flags.api-version.description'),
+        }),
+        'template-id': Flags.string({
+            char: 'i',
+            summary: messages.getMessage('flags.template-id.summary'),
+            description: messages.getMessage('flags.template-id.description'),
+            exclusive: ['template-name'],
+        }),
+        'template-name': Flags.string({
+            char: 'n',
+            summary: messages.getMessage('flags.template-name.summary'),
+            description: messages.getMessage('flags.template-name.description'),
+            exclusive: ['template-id'],
+        }),
+        label: Flags.string({
+            char: 'l',
+            summary: messages.getMessage('flags.label.summary'),
+            description: messages.getMessage('flags.label.description'),
+        }),
+        description: Flags.string({
+            char: 'd',
+            summary: messages.getMessage('flags.description.summary'),
+            description: messages.getMessage('flags.description.description'),
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(UpdateTemplate);
+        if (!flags['template-id'] && !flags['template-name']) {
+            throw new SfError(messages.getMessage('missingRequiredField'), 'MissingRequiredFlag');
+        }
+        try {
+            this.spinner.start(messages.getMessage('fetchingTemplate'));
+            const connection = flags['target-org'].getConnection(flags['api-version']);
+            const appFrameworkTemplate = new AppFrameworkTemplate(connection);
+            const identifier = flags['template-id'] ?? flags['template-name'];
+            this.spinner.stop();
+            this.spinner.start(messages.getMessage('updatingTemplate'));
+            const updateOptions = {
+                label: flags.label,
+                description: flags.description,
+            };
+            const rawTemplate = await appFrameworkTemplate.update(identifier, updateOptions);
+            this.spinner.stop();
+            this.log(messages.getMessage('updateSuccess', [rawTemplate.name, rawTemplate.id]));
+            const updatedTemplate = {
+                id: rawTemplate.id,
+                name: rawTemplate.name,
+                label: rawTemplate.label,
+                description: rawTemplate.description,
+                templateType: rawTemplate.templateType,
+                templateSubtype: rawTemplate.templateSubtype,
+                templateId: rawTemplate.templateId,
+                folderId: rawTemplate.folderId,
+                namespace: rawTemplate.namespace,
+                templateVersion: rawTemplate.releaseInfo?.templateVersion,
+                assetVersion: rawTemplate.assetVersion,
+                maxAppCount: rawTemplate.maxAppCount,
+                variableDefinition: rawTemplate.variableDefinition,
+                layoutDefinition: rawTemplate.layoutDefinition,
+                rules: rawTemplate.rules,
+                created: rawTemplate.createdDate ? new Date(rawTemplate.createdDate).toLocaleDateString() : 'n/a',
+                modified: rawTemplate.lastModifiedDate ? new Date(rawTemplate.lastModifiedDate).toLocaleDateString() : 'n/a',
+                industries: rawTemplate.tags?.industries?.join(', ') ?? 'n/a',
+                audience: rawTemplate.tags?.targetAudience?.join(', ') ?? 'n/a',
+                icons: rawTemplate.icons,
+                chainDefinitions: rawTemplate.chainDefinitions,
+                applicationSourceId: rawTemplate.applicationSourceId,
+                url: rawTemplate.url,
+                configurationUrl: rawTemplate.configurationUrl,
+                readinessUrl: rawTemplate.readinessUrl,
+            };
+            TemplateDisplayUtil.displayTemplateDetail(this, updatedTemplate);
+            return updatedTemplate;
+        }
+        catch (error) {
+            this.spinner.stop();
+            const errorMsg = error.message;
+            throw new SfError(`Error updating template: ${errorMsg}`, 'TemplateUpdateError');
+        }
+    }
+}
+//# sourceMappingURL=template.js.map

package/lib/commands/orchestrator/update/template.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export default _default;

package/lib/index.js

@@ -0,0 +1,8 @@
+/*
+ * Copyright (c) 2021, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+export default {};
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAe,EAAE,CAAC"}

package/lib/utils/app/appDisplayUtil.d.ts

@@ -0,0 +1,26 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { AppData } from './appTypes.js';
+export declare class AppDisplayUtil {
+    /**
+     * Get color formatting function based on app template type
+     *
+     * @param templateType - The template type of the app
+     * @returns Function to format text with appropriate color
+     */
+    static getAppTypeColor(templateType: string): (text: string) => string;
+    /**
+     * Display a list of apps in a table format
+     *
+     * @param command - The SfCommand instance
+     * @param apps - The app data to display
+     * @param title - Optional title for the table
+     */
+    static displayAppList(command: SfCommand<unknown>, apps: AppData[], title?: string): void;
+    /**
+     * Display detailed information about an app in sections
+     *
+     * @param command - The SfCommand instance
+     * @param app - The app data to display
+     */
+    static displayAppDetails(command: SfCommand<unknown>, app: AppData): void;
+}

package/lib/utils/app/appDisplayUtil.js

@@ -0,0 +1,153 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import ansis from 'ansis';
+export class AppDisplayUtil {
+    /**
+     * Get color formatting function based on app template type
+     *
+     * @param templateType - The template type of the app
+     * @returns Function to format text with appropriate color
+     */
+    static getAppTypeColor(templateType) {
+        switch (templateType.toLowerCase()) {
+            case 'app':
+                return ansis.green;
+            case 'component':
+                return ansis.blue;
+            default:
+                return ansis.yellow;
+        }
+    }
+    /**
+     * Display a list of apps in a table format
+     *
+     * @param command - The SfCommand instance
+     * @param apps - The app data to display
+     * @param title - Optional title for the table
+     */
+    static displayAppList(command, apps, title = 'AppFramework Apps') {
+        if (apps.length === 0) {
+            command.log('No apps found.');
+            return;
+        }
+        command.styledHeader(`Found ${apps.length} app(s)`);
+        const tableData = apps.map((app) => {
+            const typeString = String(app.templateType ?? 'n/a');
+            const typeWithColor = this.getAppTypeColor(typeString)(typeString);
+            return {
+                Id: app.id ?? 'n/a',
+                Type: typeWithColor,
+                Version: app.templateVersion ?? 'n/a',
+                Subtype: app.templateSubtype ?? 'n/a',
+                Name: app.name ?? 'n/a',
+                Label: app.label ?? 'n/a',
+                Status: app.status ?? 'n/a',
+            };
+        });
+        command.table({
+            data: tableData,
+            title,
+            columns: [
+                { key: 'Id', width: '30%' },
+                { key: 'Name', width: '20%' },
+                { key: 'Label', width: '20%' },
+                { key: 'Type', width: '10%' },
+                { key: 'Subtype', width: '5%' },
+                { key: 'Status', width: '10%' },
+                { key: 'Version', width: '5%' },
+            ],
+            overflow: 'truncate-end',
+            sort: {
+                Label: 'asc',
+            },
+        });
+        command.log('');
+        command.log(`Legend: ${ansis.green('app')} - Application apps, ${ansis.blue('component')} - Component apps, ${ansis.yellow('other')} - Other app types`);
+        command.log('');
+    }
+    /**
+     * Display detailed information about an app in sections
+     *
+     * @param command - The SfCommand instance
+     * @param app - The app data to display
+     */
+    static displayAppDetails(command, app) {
+        if (!app) {
+            command.log('No app data to display.');
+            return;
+        }
+        command.styledHeader(`App Details: ${app.name ?? 'n/a'}`);
+        // Basic Information
+        command.styledHeader('Basic Information');
+        command.table({
+            data: [
+                { Property: 'ID', Value: app.id ?? 'n/a' },
+                { Property: 'Name', Value: app.name ?? 'n/a' },
+                { Property: 'Label', Value: app.label ?? 'n/a' },
+                { Property: 'Description', Value: app.description ?? 'n/a' },
+                { Property: 'Status', Value: app.status ?? 'n/a' },
+            ],
+            columns: [
+                { key: 'Property', width: '30%' },
+                { key: 'Value', width: '70%' },
+            ],
+        });
+        // Template Information
+        command.styledHeader('Template Information');
+        command.table({
+            data: [
+                { Property: 'Template ID', Value: app.templateSourceId ?? 'n/a' },
+                { Property: 'Template Type', Value: app.templateType ?? 'n/a' },
+                { Property: 'Template Subtype', Value: app.templateSubtype ?? 'n/a' },
+                { Property: 'Template Version', Value: app.templateVersion ?? 'n/a' },
+            ],
+            columns: [
+                { key: 'Property', width: '30%' },
+                { key: 'Value', width: '70%' },
+            ],
+        });
+        // Runtime Information
+        command.styledHeader('Runtime Information');
+        command.table({
+            data: [
+                { Property: 'Runtime Method', Value: app.runtimeMethod ?? 'n/a' },
+                { Property: 'Log Level', Value: app.logLevel ?? 'n/a' },
+                { Property: 'Namespace', Value: app.namespace ?? 'n/a' },
+            ],
+            columns: [
+                { key: 'Property', width: '30%' },
+                { key: 'Value', width: '70%' },
+            ],
+        });
+        // Date Information
+        command.styledHeader('Date Information');
+        command.table({
+            data: [
+                { Property: 'Created', Value: app.created ?? 'n/a' },
+                { Property: 'Modified', Value: app.modified ?? 'n/a' },
+            ],
+            columns: [
+                { key: 'Property', width: '30%' },
+                { key: 'Value', width: '70%' },
+            ],
+        });
+        // URLs
+        command.styledHeader('URLs');
+        command.table({
+            data: [
+                { Property: 'URL', Value: app.url ?? 'n/a' },
+                { Property: 'Configuration URL', Value: app.configurationUrl ?? 'n/a' },
+                { Property: 'Readiness URL', Value: app.readinessUrl ?? 'n/a' },
+            ],
+            columns: [
+                { key: 'Property', width: '30%' },
+                { key: 'Value', width: '70%' },
+            ],
+        });
+    }
+}
+//# sourceMappingURL=appDisplayUtil.js.map

package/lib/utils/app/appDisplayUtil.js.map

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