@salesforce/plugin-orchestrator 1.0.0

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

@@ -0,0 +1,34 @@
+import { AppData, RawApp } from './appTypes.js';
+/**
+ * Utility class for processing app list data
+ */
+export declare class AppListUtil {
+    /**
+     * Process raw apps from the API into a structured format
+     *
+     * @param rawApps - Raw app data from the API
+     * @returns Processed app data
+     */
+    static processApps(rawApps: RawApp[]): AppData[];
+    /**
+     * Process apps for display
+     *
+     * @param apps - App data array
+     * @returns Processed app data for display
+     */
+    static processOutput(apps: AppData[]): Array<Record<string, string | undefined>>;
+    /**
+     * Process apps for simple display
+     *
+     * @param apps - App data array
+     * @returns Processed app data for simple display
+     */
+    static processSimpleOutput(apps: AppData[]): Array<Record<string, string | undefined>>;
+    /**
+     * Process a single raw app into a structured format
+     *
+     * @param rawApp - Raw app data from the API
+     * @returns Processed app data
+     */
+    private static processApp;
+}

package/lib/utils/app/appListUtils.js

@@ -0,0 +1,81 @@
+/**
+ * Utility class for processing app list data
+ */
+export class AppListUtil {
+    /**
+     * Process raw apps from the API into a structured format
+     *
+     * @param rawApps - Raw app data from the API
+     * @returns Processed app data
+     */
+    static processApps(rawApps) {
+        if (!rawApps || !Array.isArray(rawApps)) {
+            return [];
+        }
+        return rawApps.map((app) => this.processApp(app));
+    }
+    /**
+     * Process apps for display
+     *
+     * @param apps - App data array
+     * @returns Processed app data for display
+     */
+    static processOutput(apps) {
+        return apps.map((app) => ({
+            Name: app.name,
+            Label: app.label,
+            ID: app.id,
+            Type: app.templateType,
+            'Template ID': app.templateSourceId,
+            Status: app.status,
+            Created: app.created,
+            Modified: app.modified,
+            Description: app.description ?? 'n/a',
+        }));
+    }
+    /**
+     * Process apps for simple display
+     *
+     * @param apps - App data array
+     * @returns Processed app data for simple display
+     */
+    static processSimpleOutput(apps) {
+        return apps.map((app) => ({
+            ID: app.id,
+            Name: app.name,
+            Label: app.label,
+            Type: app.templateType,
+            SubType: app.templateSubtype ?? 'n/a',
+            'Template ID': app.templateSourceId ?? 'n/a',
+            Status: app.status ?? 'n/a',
+        }));
+    }
+    /**
+     * Process a single raw app into a structured format
+     *
+     * @param rawApp - Raw app data from the API
+     * @returns Processed app data
+     */
+    static processApp(rawApp) {
+        return {
+            id: rawApp.id,
+            name: rawApp.name,
+            label: rawApp.label,
+            description: rawApp.description,
+            templateSourceId: rawApp.templateSourceId,
+            templateType: rawApp.templateType,
+            templateSubtype: rawApp.templateSubtype,
+            templateVersion: rawApp.templateVersion,
+            namespace: rawApp.namespace,
+            created: rawApp.createdDate ? new Date(rawApp.createdDate).toLocaleDateString() : 'n/a',
+            modified: rawApp.lastModifiedDate ? new Date(rawApp.lastModifiedDate).toLocaleDateString() : 'n/a',
+            runtimeMethod: rawApp.runtimeMethod,
+            logLevel: rawApp.logLevel,
+            status: rawApp.status,
+            url: rawApp.url,
+            configurationUrl: rawApp.configurationUrl,
+            readinessUrl: rawApp.readinessUrl,
+        };
+    }
+}
+//# sourceMappingURL=appListUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"appListUtils.js","sourceRoot":"","sources":["../../../src/utils/app/appListUtils.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,OAAO,WAAW;IACtB;;;;;OAKG;IACI,MAAM,CAAC,WAAW,CAAC,OAAiB;QACzC,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACxC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,aAAa,CAAC,IAAe;QACzC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACxB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,IAAI,EAAE,GAAG,CAAC,YAAY;YACtB,aAAa,EAAE,GAAG,CAAC,gBAAgB;YACnC,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,KAAK;SACtC,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,mBAAmB,CAAC,IAAe;QAC/C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACxB,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,IAAI,EAAE,GAAG,CAAC,YAAY;YACtB,OAAO,EAAE,GAAG,CAAC,eAAe,IAAI,KAAK;YACrC,aAAa,EAAE,GAAG,CAAC,gBAAgB,IAAI,KAAK;YAC5C,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,KAAK;SAC5B,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;;;;OAKG;IACK,MAAM,CAAC,UAAU,CAAC,MAAc;QACtC,OAAO;YACL,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,KAAK;YACvF,QAAQ,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,KAAK;YAClG,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,44 @@
+/**
+ * Raw app data as returned from the API
+ */
+export type RawApp = {
+    id: string;
+    name: string;
+    label?: string;
+    description?: string;
+    templateSourceId?: string;
+    templateType?: string;
+    templateSubtype?: string;
+    templateVersion?: string;
+    namespace?: string;
+    createdDate?: string;
+    lastModifiedDate?: string;
+    runtimeMethod?: string;
+    logLevel?: string;
+    status?: string;
+    url?: string;
+    configurationUrl?: string;
+    readinessUrl?: string;
+};
+/**
+ * Processed app data for display and usage in commands
+ */
+export type AppData = {
+    id: string;
+    name: string;
+    label?: string;
+    description?: string;
+    templateSourceId?: string;
+    templateType?: string;
+    templateSubtype?: string;
+    templateVersion?: string;
+    namespace?: string;
+    created?: string;
+    modified?: string;
+    runtimeMethod?: string;
+    logLevel?: string;
+    status?: string;
+    url?: string;
+    configurationUrl?: string;
+    readinessUrl?: string;
+};

package/lib/utils/app/appTypes.js

@@ -0,0 +1,8 @@
+/*
+ * 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
+ */
+export {};
+//# sourceMappingURL=appTypes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"appTypes.js","sourceRoot":"","sources":["../../../src/utils/app/appTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

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

@@ -0,0 +1,64 @@
+import { Connection } from '@salesforce/core';
+import { RawApp } from './appTypes.js';
+export default class AppFrameworkApp {
+    private readonly connection;
+    constructor(connection: Connection);
+    /**
+     * List apps in the org
+     *
+     * @returns Array of app objects
+     */
+    list(): Promise<RawApp[]>;
+    /**
+     * Get a specific app by ID or name
+     *
+     * @param idOrName - ID or name of the app to retrieve
+     * @returns App object or null if not found
+     */
+    getApp(idOrName: string): Promise<RawApp | null>;
+    /**
+     * Create a new app from a template
+     *
+     * @param options - App creation options
+     * @returns The ID of the newly created app
+     */
+    create(options: {
+        name: string;
+        label?: string;
+        description?: string;
+        templateSourceId: string;
+        templateValues?: Record<string, unknown>;
+        namespace?: string;
+        runtimeMethod?: string;
+        logLevel?: string;
+    }): Promise<string>;
+    /**
+     * Decouple an app from its template
+     *
+     * @param appId - ID of the app to decouple
+     * @param templateId - ID of the template to decouple from
+     * @returns The ID of the decoupled app
+     */
+    decoupleApp(appId: string, templateId: string): Promise<string>;
+    /**
+     * Delete an app
+     *
+     * @param appId - ID of the app to delete
+     */
+    deleteApp(appId: string): Promise<void>;
+    /**
+     * Update an existing app with a new template
+     *
+     * @param appId - ID of the app to update
+     * @param options - Update options
+     * @returns The ID of the updated app
+     */
+    updateApp(appId: string, options: {
+        templateSourceId: string;
+        label?: string;
+        description?: string;
+        templateValues?: Record<string, unknown>;
+        runtimeMethod?: string;
+        logLevel?: string;
+    }): Promise<string>;
+}

package/lib/utils/app/appframeworkapp.js

@@ -0,0 +1,175 @@
+import { request } from '../request.js';
+export default class AppFrameworkApp {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    /**
+     * List apps in the org
+     *
+     * @returns Array of app objects
+     */
+    async list() {
+        const url = '/apps';
+        const response = await request(this.connection, {
+            method: 'GET',
+            url,
+        });
+        return response?.apps ?? [];
+    }
+    /**
+     * Get a specific app by ID or name
+     *
+     * @param idOrName - ID or name of the app to retrieve
+     * @returns App object or null if not found
+     */
+    async getApp(idOrName) {
+        if (!idOrName) {
+            throw new Error('App ID or name must be provided');
+        }
+        try {
+            const url = `/apps/${idOrName}`;
+            const app = await request(this.connection, {
+                method: 'GET',
+                url,
+            });
+            return app;
+        }
+        catch (error) {
+            if (error.statusCode !== 404) {
+                throw error;
+            }
+        }
+        const apps = await this.list();
+        const app = apps.find((a) => a.name === idOrName);
+        return app ?? null;
+    }
+    /**
+     * Create a new app from a template
+     *
+     * @param options - App creation options
+     * @returns The ID of the newly created app
+     */
+    async create(options) {
+        const url = '/apps';
+        const body = Object.fromEntries(Object.entries({
+            name: options.name,
+            label: options.label,
+            description: options.description,
+            templateSourceId: options.templateSourceId,
+            templateValues: options.templateValues ?? {},
+            namespace: options.namespace,
+            runtimeMethod: options.runtimeMethod,
+            logLevel: options.logLevel,
+        }).filter((entries) => entries[1] !== undefined));
+        const response = await request(this.connection, {
+            method: 'POST',
+            url,
+            body,
+        });
+        if (response && typeof response === 'object') {
+            if ('id' in response && typeof response.id === 'string') {
+                return response.id;
+            }
+            else if ('app' in response && response.app && typeof response.app === 'object' && 'id' in response.app) {
+                return response.app.id;
+            }
+            else if ('apps' in response &&
+                Array.isArray(response.apps) &&
+                response.apps.length > 0 &&
+                response.apps[0]?.id) {
+                return response.apps[0].id;
+            }
+        }
+        // Default return if no ID is found
+        return 'App created successfully, but ID could not be determined';
+    }
+    /**
+     * Decouple an app from its template
+     *
+     * @param appId - ID of the app to decouple
+     * @param templateId - ID of the template to decouple from
+     * @returns The ID of the decoupled app
+     */
+    async decoupleApp(appId, templateId) {
+        if (!appId) {
+            throw new Error('App ID must be provided');
+        }
+        if (!templateId) {
+            throw new Error('Template ID must be provided for decoupling');
+        }
+        const url = `/apps/${appId}`;
+        const body = {
+            templateSourceId: templateId,
+            templateOptions: { appAction: 'DecoupleApp' },
+        };
+        const response = await request(this.connection, {
+            method: 'PUT',
+            url,
+            body,
+        });
+        if (response && typeof response === 'object') {
+            if ('id' in response && typeof response.id === 'string') {
+                return response.id;
+            }
+            else if ('app' in response && response.app && typeof response.app === 'object' && 'id' in response.app) {
+                return response.app.id;
+            }
+        }
+        return appId; // Return the original app ID if no specific ID was found in the response
+    }
+    /**
+     * Delete an app
+     *
+     * @param appId - ID of the app to delete
+     */
+    async deleteApp(appId) {
+        if (!appId) {
+            throw new Error('App ID must be provided');
+        }
+        const url = `/apps/${appId}`;
+        await request(this.connection, {
+            method: 'DELETE',
+            url,
+        });
+    }
+    /**
+     * Update an existing app with a new template
+     *
+     * @param appId - ID of the app to update
+     * @param options - Update options
+     * @returns The ID of the updated app
+     */
+    async updateApp(appId, options) {
+        if (!appId) {
+            throw new Error('App ID must be provided');
+        }
+        if (!options.templateSourceId) {
+            throw new Error('Template ID must be provided for update');
+        }
+        const url = `/apps/${appId}`;
+        const body = Object.fromEntries(Object.entries({
+            templateSourceId: options.templateSourceId,
+            label: options.label,
+            description: options.description,
+            templateValues: options.templateValues ?? {},
+            runtimeMethod: options.runtimeMethod,
+            logLevel: options.logLevel,
+        }).filter((entries) => entries[1] !== undefined));
+        const response = await request(this.connection, {
+            method: 'POST',
+            url,
+            body,
+        });
+        if (response && typeof response === 'object') {
+            if ('id' in response && typeof response.id === 'string') {
+                return response.id;
+            }
+            else if ('app' in response && response.app && typeof response.app === 'object' && 'id' in response.app) {
+                return response.app.id;
+            }
+        }
+        return appId; // Return the original app ID if no specific ID was found in the response
+    }
+}
+//# sourceMappingURL=appframeworkapp.js.map

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

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

package/lib/utils/display/displayUtil.d.ts

@@ -0,0 +1,27 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { TemplateData } from '../template/templateTypes.js';
+export declare class TemplateDisplayUtil {
+    /**
+     * 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;
+    /**
+     * 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;
+    /**
+     * 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[];
+}

package/lib/utils/display/displayUtil.js

@@ -0,0 +1,80 @@
+/*
+ * 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
+ */
+export class TemplateDisplayUtil {
+    /**
+     * 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.log('');
+        command.styledHeader(`Found ${templates.length} template(s)`);
+        const tableData = templates.map((template) => ({
+            ...template,
+        }));
+        command.table({
+            data: tableData,
+            title,
+            columns: ['id', 'name', 'label', 'namespace', 'templateSubtype', 'applicationSourceId'],
+            sort: {
+                label: 'asc',
+            },
+        });
+        command.log('');
+    }
+    /**
+     * Display detailed information about a single template
+     *
+     * @param command - The SfCommand instance
+     * @param template - The template data to display
+     */
+    static displayTemplateDetail(command, template) {
+        command.log('');
+        command.styledHeader(`Template Details: ${String(template.label ?? template.name ?? template.id)}`);
+        command.log('=== Basic Information');
+        command.log(`ID:             ${template.id ?? 'n/a'}`);
+        command.log(`Name:           ${template.name ?? 'n/a'}`);
+        command.log(`Label:          ${template.label ?? 'n/a'}`);
+        command.log(`Description:    ${template.description ?? 'n/a'}`);
+        command.log(`Type:           ${template.templateType ?? 'n/a'}`);
+        command.log(`Subtype:        ${template.templateSubtype ?? 'n/a'}`);
+        command.log(`Namespace:      ${template.namespace ?? 'n/a'}`);
+        command.log(`Origin App ID:  ${template.applicationSourceId ?? 'n/a'}`);
+        command.log('');
+        command.log('=== Version Information');
+        command.log(`Template Version: ${template.templateVersion ?? 'n/a'}`);
+        command.log(`Asset Version:    ${template.assetVersion ?? 'n/a'}`);
+        command.log(`Created:          ${template.created ?? 'n/a'}`);
+        command.log(`Last Modified:    ${template.modified ?? 'n/a'}`);
+        command.log('');
+        command.log('=== References');
+        command.log(`Template ID:      ${template.templateId ?? 'n/a'}`);
+        command.log(`Folder ID:        ${template.folderId ?? 'n/a'}`);
+        command.log('');
+        command.log('=== Content Details');
+        command.log(`Industries:       ${template.industries ?? 'n/a'}`);
+        command.log(`Target Audience:  ${template.audience ?? 'n/a'}`);
+        command.log('');
+    }
+    /**
+     * 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;
+    }
+}
+//# sourceMappingURL=displayUtil.js.map

package/lib/utils/display/displayUtil.js.map

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

package/lib/utils/request.d.ts

@@ -0,0 +1,15 @@
+import { Connection } from '@salesforce/core';
+type RequestOptions = {
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    url: string;
+    body?: unknown;
+};
+/**
+ * Make a request to the Salesforce REST API
+ *
+ * @param connection - Salesforce connection
+ * @param options - Request options
+ * @returns Response data
+ */
+export declare function request<T>(connection: Connection, options: RequestOptions): Promise<T>;
+export {};

package/lib/utils/request.js

@@ -0,0 +1,18 @@
+/**
+ * Make a request to the Salesforce REST API
+ *
+ * @param connection - Salesforce connection
+ * @param options - Request options
+ * @returns Response data
+ */
+export async function request(connection, options) {
+    const { method, url, body } = options;
+    const apiPath = `/services/data/v${connection.getApiVersion()}/app-framework${url}`;
+    const response = await connection.request({
+        method,
+        url: apiPath,
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    return response;
+}
+//# sourceMappingURL=request.js.map

package/lib/utils/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/utils/request.ts"],"names":[],"mappings":"AAcA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAI,UAAsB,EAAE,OAAuB;IAC9E,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAEtC,MAAM,OAAO,GAAG,mBAAmB,UAAU,CAAC,aAAa,EAAE,iBAAiB,GAAG,EAAE,CAAC;IAEpF,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,OAAO,CAAI;QAC3C,MAAM;QACN,GAAG,EAAE,OAAO;QACZ,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;KAC9C,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,67 @@
+import { Connection } from '@salesforce/core';
+import { RawTemplate } from './templateTypes.js';
+export default class AppFrameworkTemplate {
+    private readonly connection;
+    constructor(connection: Connection);
+    /**
+     * List templates in the org
+     *
+     * @returns Array of template objects
+     */
+    list(): Promise<RawTemplate[]>;
+    /**
+     * 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
+     */
+    getTemplate(idOrName: string): Promise<RawTemplate | null>;
+    /**
+     * Create a new template
+     *
+     * @param options - Template creation options
+     * @returns The ID of the newly created template
+     */
+    create(options: {
+        name: string;
+        templateType?: string;
+        templateSubtype?: string;
+        label?: string;
+        description?: string;
+        maxAppCount?: number;
+        tags?: {
+            industries?: string[];
+            targetAudience?: string[];
+            highlights?: string[];
+            requirements?: string[];
+            includes?: string[];
+            categories?: string[];
+        };
+        releaseInfo?: {
+            templateVersion?: string;
+            notesFile?: string | null;
+        };
+    }): Promise<string>;
+    /**
+     * 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
+     */
+    update(templateIdOrName: string, options?: {
+        label?: string;
+        description?: string;
+    }): Promise<RawTemplate>;
+    /**
+     * Delete a template
+     *
+     * @param templateId - ID of the template to delete
+     */
+    deleteTemplate(templateId: string): Promise<void>;
+}