@salesforce/plugin-orchestrator 1.0.0

package/lib/utils/template/appframeworktemplate.js

@@ -0,0 +1,114 @@
+import { request } from '../request.js';
+export default class AppFrameworkTemplate {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    /**
+     * List templates in the org
+     *
+     * @returns Array of template objects
+     */
+    async list() {
+        const url = '/templates';
+        const response = await request(this.connection, {
+            method: 'GET',
+            url,
+        });
+        return response?.templates ?? [];
+    }
+    /**
+     * Get a specific template by ID or name
+     *
+     * @param idOrName - ID or name of the template to retrieve
+     * @returns Template object or null if not found
+     */
+    async getTemplate(idOrName) {
+        if (!idOrName) {
+            throw new Error('Template ID or name must be provided');
+        }
+        try {
+            const url = `/templates/${idOrName}`;
+            const template = await request(this.connection, {
+                method: 'GET',
+                url,
+            });
+            return template;
+        }
+        catch (error) {
+            if (error.statusCode !== 404) {
+                throw error;
+            }
+        }
+        const templates = await this.list();
+        const template = templates.find((t) => t.name === idOrName);
+        return template ?? null;
+    }
+    /**
+     * Create a new template
+     *
+     * @param options - Template creation options
+     * @returns The ID of the newly created template
+     */
+    async create(options) {
+        const url = '/templates';
+        const body = Object.fromEntries(Object.entries({
+            name: options.name,
+            templateType: options.templateType ?? 'app',
+            templateSubtype: options.templateSubtype,
+            label: options.label,
+            description: options.description,
+            maxAppCount: options.maxAppCount,
+            tags: options.tags,
+            releaseInfo: options.releaseInfo,
+        }).filter((entries) => entries[1] !== undefined));
+        const response = await request(this.connection, {
+            method: 'POST',
+            url,
+            body,
+        });
+        return response.id;
+    }
+    /**
+     * Update an existing template
+     *
+     * Note: Only label and description fields can be updated directly.
+     * The template's name cannot be updated as it's a unique identifier.
+     *
+     * @param templateIdOrName - ID or name of the template to update
+     * @param options - Optional update options
+     * @param options.label - Optional new label for the template
+     * @param options.description - Optional new description for the template
+     * @returns The updated template data
+     */
+    async update(templateIdOrName, options) {
+        const template = await this.getTemplate(templateIdOrName);
+        if (!template) {
+            throw new Error(`Template "${templateIdOrName}" not found`);
+        }
+        const url = `/templates/${template.id}`;
+        const body = Object.fromEntries(Object.entries({
+            label: options?.label,
+            description: options?.description,
+        }).filter((entries) => entries[1] !== undefined));
+        const response = await request(this.connection, {
+            method: 'PATCH',
+            url,
+            body,
+        });
+        return response;
+    }
+    /**
+     * Delete a template
+     *
+     * @param templateId - ID of the template to delete
+     */
+    async deleteTemplate(templateId) {
+        const url = `/templates/${templateId}`;
+        await request(this.connection, {
+            method: 'DELETE',
+            url,
+        });
+    }
+}
+//# sourceMappingURL=appframeworktemplate.js.map

package/lib/utils/template/appframeworktemplate.js.map

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

package/lib/utils/template/templateDisplayUtil.d.ts

@@ -0,0 +1,42 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { TemplateData } from './templateTypes.js';
+export declare class TemplateDisplayUtil {
+    /**
+     * Process templates data for table display
+     * This can be expanded with any additional processing needs
+     *
+     * @param templates - Raw template data
+     * @returns Processed template data ready for display
+     */
+    static processTemplatesForDisplay(templates: TemplateData[]): TemplateData[];
+    /**
+     * Display detailed information about a single template
+     *
+     * @param command - The SfCommand instance
+     * @param template - The template data to display
+     */
+    static displayTemplateDetail(command: SfCommand<unknown>, template: TemplateData): void;
+    /**
+     * Display a list of templates in a table format
+     *
+     * @param command - The SfCommand instance
+     * @param templates - The template data to display
+     * @param title - Optional title for the table
+     */
+    static displayTemplateList(command: SfCommand<unknown>, templates: TemplateData[], title?: string): void;
+    /**
+     * Get color function based on template type
+     *
+     * @param templateType - The template type string
+     * @returns A color function to apply to text
+     */
+    private static getTemplateTypeColor;
+    /**
+     * Display a section of template details
+     *
+     * @param command - The command instance
+     * @param title - Section title
+     * @param details - Key-value pairs to display
+     */
+    private static displaySection;
+}

package/lib/utils/template/templateDisplayUtil.js

@@ -0,0 +1,142 @@
+/*
+ * 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 TemplateDisplayUtil {
+    /**
+     * Process templates data for table display
+     * This can be expanded with any additional processing needs
+     *
+     * @param templates - Raw template data
+     * @returns Processed template data ready for display
+     */
+    static processTemplatesForDisplay(templates) {
+        return templates;
+    }
+    /**
+     * Display detailed information about a single template
+     *
+     * @param command - The SfCommand instance
+     * @param template - The template data to display
+     */
+    static displayTemplateDetail(command, template) {
+        const templateTypeString = String(template.templateType ?? 'unknown');
+        const typeColor = this.getTemplateTypeColor(templateTypeString);
+        const templateLabel = String(template.label ?? template.name ?? template.id);
+        command.log('');
+        command.styledHeader(`Template Details: ${typeColor(templateLabel)}`);
+        this.displaySection(command, 'Basic Information', {
+            ID: template.id,
+            Name: template.name,
+            Label: template.label,
+            Description: template.description,
+            Type: typeColor(templateTypeString),
+            Subtype: template.templateSubtype,
+            Namespace: template.namespace,
+            'Origin App ID': template.applicationSourceId,
+            'Max App Count': template.maxAppCount,
+        });
+        this.displaySection(command, 'Version Information', {
+            'Template Version': template.templateVersion,
+            'Asset Version': template.assetVersion,
+            Created: ansis.dim(template.created ?? 'n/a'),
+            'Last Modified': ansis.dim(template.modified ?? 'n/a'),
+        });
+        this.displaySection(command, 'References', {
+            'Template ID': template.templateId,
+            'Folder ID': template.folderId,
+            'API URL': template.url,
+            'Configuration URL': template.configurationUrl,
+            'Readiness URL': template.readinessUrl,
+        });
+        this.displaySection(command, 'Content Details', {
+            Industries: template.industries,
+            'Target Audience': template.audience,
+            'Rules Count': template.rules?.length ?? 0,
+            'Chain Definitions Count': template.chainDefinitions?.length ?? 0,
+            'Has Icons': template.icons ? 'Yes' : 'No',
+            'Has Variable Definition': template.variableDefinition ? 'Yes' : 'No',
+            'Has Layout Definition': template.layoutDefinition ? 'Yes' : 'No',
+        });
+    }
+    /**
+     * Display a list of templates in a table format
+     *
+     * @param command - The SfCommand instance
+     * @param templates - The template data to display
+     * @param title - Optional title for the table
+     */
+    static displayTemplateList(command, templates, title = 'AppFramework Templates') {
+        if (templates.length === 0) {
+            command.log('No templates found.');
+            return;
+        }
+        command.styledHeader(`Found ${templates.length} template(s)`);
+        const tableData = templates.map((template) => {
+            const typeString = String(template.templateType ?? 'n/a');
+            const typeWithColor = this.getTemplateTypeColor(typeString)(typeString);
+            return {
+                Id: template.id ?? 'n/a',
+                Type: typeWithColor,
+                Version: template.templateVersion ?? 'n/a',
+                Subtype: template.templateSubtype ?? 'n/a',
+                Name: template.name ?? 'n/a',
+                Label: template.label ?? 'n/a',
+            };
+        });
+        command.table({
+            data: tableData,
+            title,
+            columns: [
+                { key: 'Id', width: '30%' },
+                { key: 'Name', width: '25%' },
+                { key: 'Label', width: '25%' },
+                { key: 'Type', width: '10%' },
+                { key: 'Subtype', width: '5%' },
+                { key: 'Version', width: '5%' },
+            ],
+            overflow: 'truncate-end',
+            sort: {
+                Label: 'asc',
+            },
+        });
+        command.log('');
+        command.log(`Legend: ${ansis.green('app')} - Application templates, ${ansis.blue('component')} - Component templates, ${ansis.yellow('other')} - Other template types`);
+        command.log('');
+    }
+    /**
+     * Get color function based on template type
+     *
+     * @param templateType - The template type string
+     * @returns A color function to apply to text
+     */
+    static getTemplateTypeColor(templateType) {
+        const typeString = templateType.toLowerCase();
+        if (typeString === 'app') {
+            return ansis.green;
+        }
+        else if (typeString === 'component') {
+            return ansis.blue;
+        }
+        return ansis.yellow;
+    }
+    /**
+     * Display a section of template details
+     *
+     * @param command - The command instance
+     * @param title - Section title
+     * @param details - Key-value pairs to display
+     */
+    static displaySection(command, title, details) {
+        command.log(ansis.bold(`=== ${title}`));
+        for (const [key, value] of Object.entries(details)) {
+            const formattedValue = value === null || value === undefined ? 'n/a' : String(value);
+            command.log(`${ansis.bold(`${key}:`)} ${formattedValue}`);
+        }
+        command.log('');
+    }
+}
+//# sourceMappingURL=templateDisplayUtil.js.map

package/lib/utils/template/templateDisplayUtil.js.map

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

package/lib/utils/template/templateHighlighter.d.ts

@@ -0,0 +1,23 @@
+import { TemplateData } from './templateTypes.js';
+/**
+ * Style a value based on predefined styling rules
+ *
+ * @param key - The field name to style
+ * @param value - The value to style
+ * @returns The styled value
+ */
+export declare const getStyledValue: (key: string, value: string | null | undefined) => string;
+/**
+ * Apply styling to all fields in a template object based on predefined rules
+ *
+ * @param objectToStyle - The template object to style
+ * @returns A new object with styled field values
+ */
+export declare const getStyledObject: (objectToStyle: TemplateData) => TemplateData;
+/**
+ * Group templates by type for better organization
+ *
+ * @param templates - Array of template data
+ * @returns Object with templates grouped by type
+ */
+export declare const groupTemplatesByType: (templates: TemplateData[]) => Record<string, TemplateData[]>;

package/lib/utils/template/templateHighlighter.js

@@ -0,0 +1,68 @@
+/*
+ * 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';
+const styledProperties = new Map([
+    [
+        'templateType',
+        new Map([
+            ['app', ansis.greenBright],
+            ['component', ansis.cyanBright],
+            ['else', ansis.yellowBright],
+        ]),
+    ],
+    ['templateVersion', new Map([['else', ansis.blue]])],
+]);
+/**
+ * Style a value based on predefined styling rules
+ *
+ * @param key - The field name to style
+ * @param value - The value to style
+ * @returns The styled value
+ */
+export const getStyledValue = (key, value) => {
+    if (value === null || value === undefined)
+        return '';
+    const prop = styledProperties.get(key);
+    if (!prop)
+        return value;
+    const colorMethod = prop.get(value) ?? prop.get('else');
+    return colorMethod(value);
+};
+/**
+ * Apply styling to all fields in a template object based on predefined rules
+ *
+ * @param objectToStyle - The template object to style
+ * @returns A new object with styled field values
+ */
+export const getStyledObject = (objectToStyle) => Object.fromEntries(Object.entries(objectToStyle).map(([key, value]) => [
+    key,
+    typeof value === 'string' ? getStyledValue(key, value) : value,
+]));
+/**
+ * Group templates by type for better organization
+ *
+ * @param templates - Array of template data
+ * @returns Object with templates grouped by type
+ */
+export const groupTemplatesByType = (templates) => {
+    const groups = {
+        app: [],
+        component: [],
+        other: [],
+    };
+    templates.forEach((template) => {
+        const type = template.templateType?.toLowerCase() ?? 'other';
+        if (type === 'app' || type === 'component') {
+            groups[type].push(template);
+        }
+        else {
+            groups.other.push(template);
+        }
+    });
+    return groups;
+};
+//# sourceMappingURL=templateHighlighter.js.map

package/lib/utils/template/templateHighlighter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateHighlighter.js","sourceRoot":"","sources":["../../../src/utils/template/templateHighlighter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAqB,MAAM,OAAO,CAAC;AAG1C,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAA6B;IAC3D;QACE,cAAc;QACd,IAAI,GAAG,CAAC;YACN,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC;YAC1B,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC;YAC/B,CAAC,MAAM,EAAE,KAAK,CAAC,YAAY,CAAC;SAC7B,CAAC;KACH;IACD,CAAC,iBAAiB,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;CACrD,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAW,EAAE,KAAgC,EAAU,EAAE;IACtF,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAErD,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAExB,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAK,IAAI,CAAC,GAAG,CAAC,MAAM,CAAW,CAAC;IACnE,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,aAA2B,EAAgB,EAAE,CAC3E,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;IAClD,GAAG;IACH,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK;CAC/D,CAAC,CACa,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,SAAyB,EAAkC,EAAE;IAChG,MAAM,MAAM,GAAmC;QAC7C,GAAG,EAAE,EAAE;QACP,SAAS,EAAE,EAAE;QACb,KAAK,EAAE,EAAE;KACV,CAAC;IAEF,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,EAAE,WAAW,EAAE,IAAI,OAAO,CAAC;QAC7D,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YAC3C,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/lib/utils/template/templateListUtils.d.ts

@@ -0,0 +1,40 @@
+import { TemplateData, RawTemplate, Icon, Rule } from './templateTypes.js';
+export type TemplateOutputField = keyof TemplateData;
+export type TemplateOutput = Record<string, string | number | Icon | Rule[] | undefined>;
+export declare const DETAILED_FIELDS: TemplateOutputField[];
+export declare const SIMPLE_FIELDS: TemplateOutputField[];
+/**
+ * Process raw templates from the API into a structured format
+ *
+ * @param rawTemplates - Raw template data from the API
+ * @returns Processed template data
+ */
+export declare const processTemplates: (rawTemplates: RawTemplate[]) => TemplateData[];
+/**
+ * Process templates for display with customizable field selection
+ *
+ * @param templates - Template data array
+ * @param fields - Fields to include in the output
+ * @returns Processed template data for display
+ */
+export declare const processTemplateOutput: (templates: TemplateData[], fields?: TemplateOutputField[]) => TemplateOutput[];
+/**
+ * Process templates for detailed display
+ *
+ * @param templates - Template data array
+ * @returns Processed template data for detailed display
+ */
+export declare const processOutput: (templates: TemplateData[]) => TemplateOutput[];
+/**
+ * Process templates for simple display
+ *
+ * @param templates - Template data array
+ * @returns Processed template data for simple display
+ */
+export declare const processSimpleOutput: (templates: TemplateData[]) => TemplateOutput[];
+export declare class TemplateListUtil {
+    static processTemplates: (rawTemplates: RawTemplate[]) => TemplateData[];
+    static processOutput: (templates: TemplateData[]) => TemplateOutput[];
+    static processSimpleOutput: (templates: TemplateData[]) => TemplateOutput[];
+    static processTemplate: (rawTemplate: RawTemplate) => TemplateData;
+}

package/lib/utils/template/templateListUtils.js

@@ -0,0 +1,126 @@
+// Define standard field sets
+export const DETAILED_FIELDS = [
+    'name',
+    'label',
+    'templateId',
+    'templateType',
+    'namespace',
+    'templateVersion',
+    'created',
+    'modified',
+    'description',
+    'industries',
+    'audience',
+];
+export const SIMPLE_FIELDS = [
+    'label',
+    'templateId',
+    'name',
+    'templateType',
+    'templateSubtype',
+    'templateVersion',
+    'applicationSourceId',
+];
+/**
+ * Helper for date formatting
+ */
+const formatDate = (dateString) => (dateString ? new Date(dateString).toLocaleDateString() : 'n/a');
+/**
+ * Helper for default values
+ */
+const defaultIfEmpty = (value, defaultValue = 'n/a') => value ? (Array.isArray(value) ? value.join(', ') : value) : defaultValue;
+/**
+ * Capitalize the first letter of a string
+ */
+const capitalizeFirstLetter = (str) => str.charAt(0).toUpperCase() + str.slice(1);
+/**
+ * Process a single raw template into a structured format
+ *
+ * @param rawTemplate - Raw template data from the API
+ * @returns Processed template data
+ */
+const processTemplate = (rawTemplate) => ({
+    id: rawTemplate.id,
+    name: rawTemplate.name,
+    label: rawTemplate.label,
+    description: rawTemplate.description,
+    templateType: rawTemplate.templateType,
+    templateId: rawTemplate.templateId,
+    folderId: rawTemplate.folderId,
+    namespace: rawTemplate.namespace,
+    templateVersion: rawTemplate.releaseInfo?.templateVersion,
+    assetVersion: rawTemplate.assetVersion,
+    created: formatDate(rawTemplate.createdDate),
+    modified: formatDate(rawTemplate.lastModifiedDate),
+    industries: defaultIfEmpty(rawTemplate.tags?.industries),
+    audience: defaultIfEmpty(rawTemplate.tags?.targetAudience),
+    templateSubtype: rawTemplate.templateSubtype,
+    applicationSourceId: rawTemplate.applicationSourceId,
+});
+/**
+ * Process raw templates from the API into a structured format
+ *
+ * @param rawTemplates - Raw template data from the API
+ * @returns Processed template data
+ */
+export const processTemplates = (rawTemplates) => {
+    if (!rawTemplates?.length) {
+        return [];
+    }
+    return rawTemplates.map(processTemplate);
+};
+/**
+ * Process templates for display with customizable field selection
+ *
+ * @param templates - Template data array
+ * @param fields - Fields to include in the output
+ * @returns Processed template data for display
+ */
+export const processTemplateOutput = (templates, fields = DETAILED_FIELDS) => templates.map((template) => {
+    const output = {};
+    fields.forEach((field) => {
+        const value = template[field];
+        // Special case for applicationSourceId to match the expected "SourceID" in tests
+        if (field === 'applicationSourceId') {
+            output['SourceID'] = value ?? 'n/a';
+        }
+        // Special case for templateType to match the expected "Type" in tests
+        else if (field === 'templateType') {
+            output['Type'] = value ?? 'n/a';
+        }
+        // Special case for templateSubtype to match the expected "SubType" in tests
+        else if (field === 'templateSubtype') {
+            output['SubType'] = value ?? 'n/a';
+        }
+        // Special case for templateVersion to match the expected "Version" in tests
+        else if (field === 'templateVersion') {
+            output['Version'] = value ?? 'n/a';
+        }
+        else {
+            output[capitalizeFirstLetter(field.toString())] = value ?? 'n/a';
+        }
+    });
+    return output;
+});
+/**
+ * Process templates for detailed display
+ *
+ * @param templates - Template data array
+ * @returns Processed template data for detailed display
+ */
+export const processOutput = (templates) => processTemplateOutput(templates, DETAILED_FIELDS);
+/**
+ * Process templates for simple display
+ *
+ * @param templates - Template data array
+ * @returns Processed template data for simple display
+ */
+export const processSimpleOutput = (templates) => processTemplateOutput(templates, SIMPLE_FIELDS);
+// For backward compatibility with code that uses the class-based approach
+export class TemplateListUtil {
+    static processTemplates = processTemplates;
+    static processOutput = processOutput;
+    static processSimpleOutput = processSimpleOutput;
+    static processTemplate = processTemplate;
+}
+//# sourceMappingURL=templateListUtils.js.map

package/lib/utils/template/templateListUtils.js.map

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