@salesforce/b2c-cli 0.3.0 → 0.4.1

package/dist/lib/scaffold/generate-helper.js

@@ -0,0 +1,271 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { input, confirm, select, checkbox, search } from '@inquirer/prompts';
+import { createScaffoldRegistry, generateFromScaffold, evaluateCondition, resolveScaffoldParameters, parseParameterOptions, resolveOutputDirectory, } from '@salesforce/b2c-tooling-sdk/scaffold';
+import { resolveLocalSource, resolveRemoteSource, isRemoteSource } from './source-resolver.js';
+/**
+ * Execute scaffold generation with the given options.
+ */
+export async function executeScaffoldGenerate(options, ctx) {
+    const { scaffoldId, dryRun = false, force = false, projectRoot = process.cwd() } = options;
+    const registry = createScaffoldRegistry();
+    // Find the scaffold
+    const scaffold = await registry.getScaffold(scaffoldId, {
+        projectRoot,
+    });
+    if (!scaffold) {
+        ctx.error(`Scaffold not found: ${scaffoldId}`);
+    }
+    // Parse option flags into variables
+    const providedVariables = parseParameterOptions(options.options || [], scaffold);
+    // Handle --name shorthand for the first string parameter
+    if (options.name) {
+        const firstStringParam = scaffold.manifest.parameters.find((p) => p.type === 'string');
+        if (firstStringParam) {
+            providedVariables[firstStringParam.name] = options.name;
+        }
+    }
+    // Resolve parameters using SDK, then prompt for any missing
+    const isTTY = process.stdin.isTTY && process.stdout.isTTY;
+    const interactive = !force && isTTY;
+    const resolved = await resolveScaffoldParameters(scaffold, {
+        providedVariables,
+        projectRoot,
+        useDefaults: !interactive,
+    });
+    // Report any validation errors
+    for (const error of resolved.errors) {
+        ctx.error(error.message);
+    }
+    // Check for missing required parameters in non-interactive mode
+    if (!interactive) {
+        const missingRequired = resolved.missingParameters.filter((p) => p.required);
+        if (missingRequired.length > 0) {
+            ctx.error(`Missing required parameter: ${missingRequired[0].name}`);
+        }
+    }
+    // Prompt for any missing parameters in interactive mode
+    const resolvedVariables = { ...resolved.variables };
+    if (interactive && resolved.missingParameters.length > 0) {
+        for (const param of resolved.missingParameters) {
+            // Re-check condition since earlier params may have been filled in
+            if (param.when && !evaluateCondition(param.when, resolvedVariables)) {
+                continue;
+            }
+            // eslint-disable-next-line no-await-in-loop
+            const value = await promptForParameter(param, projectRoot, ctx);
+            if (value !== undefined) {
+                resolvedVariables[param.name] = value;
+                // Set companion path variable for cartridges source
+                if (param.source === 'cartridges' && typeof value === 'string') {
+                    const result = resolveLocalSource('cartridges', projectRoot);
+                    const cartridgePath = result.pathMap?.get(value);
+                    if (cartridgePath) {
+                        resolvedVariables[`${param.name}Path`] = cartridgePath;
+                    }
+                }
+            }
+        }
+    }
+    // Resolve output directory using SDK function
+    ctx.logger.trace({ flagOutput: options.output, defaultOutputDir: scaffold.manifest.defaultOutputDir }, 'Resolving output directory');
+    const outputDir = resolveOutputDirectory({
+        outputDir: options.output,
+        scaffold,
+        projectRoot,
+    });
+    ctx.logger.debug({ outputDir }, 'Resolved output directory');
+    if (dryRun) {
+        ctx.log('Dry run - no files will be written');
+    }
+    ctx.log(`Generating ${scaffold.manifest.displayName} scaffold...`);
+    // Generate the scaffold
+    let result;
+    try {
+        result = await generateFromScaffold(scaffold, {
+            outputDir,
+            variables: resolvedVariables,
+            dryRun,
+            force,
+        });
+    }
+    catch (error) {
+        ctx.error(`Failed to generate scaffold: ${error.message}`);
+    }
+    const response = {
+        scaffold: scaffoldId,
+        outputDir,
+        dryRun,
+        files: result.files.map((f) => ({
+            path: f.path,
+            action: f.action,
+            skipReason: f.skipReason,
+        })),
+        postInstructions: result.postInstructions,
+    };
+    // Display results
+    const created = result.files.filter((f) => f.action === 'created' || f.action === 'overwritten');
+    const skipped = result.files.filter((f) => f.action === 'skipped');
+    if (created.length > 0) {
+        ctx.log('');
+        ctx.log(`Successfully generated ${created.length} file(s):`);
+        for (const file of created) {
+            // file.path is already relative to cwd from the executor
+            ctx.log(`  ${file.action === 'overwritten' ? '(overwritten)' : '+'} ${file.path}`);
+        }
+    }
+    if (skipped.length > 0) {
+        ctx.log('');
+        ctx.log(`Skipped ${skipped.length} file(s):`);
+        for (const file of skipped) {
+            ctx.log(`  - ${file.path}${file.skipReason ? ` (${file.skipReason})` : ''}`);
+        }
+    }
+    // Show post-instructions
+    if (result.postInstructions) {
+        ctx.log('');
+        ctx.log(result.postInstructions);
+    }
+    return response;
+}
+/**
+ * Prompt for a single parameter value.
+ */
+async function promptForParameter(param, projectRoot, ctx) {
+    switch (param.type) {
+        case 'boolean': {
+            return confirm({
+                message: param.prompt,
+                default: param.default,
+            });
+        }
+        case 'choice': {
+            const { choices, warning } = await resolveSourceChoices(param, projectRoot);
+            if (warning)
+                ctx.warn(warning);
+            if (choices.length === 0) {
+                if (param.source)
+                    ctx.warn(`No ${param.source} found. Please enter a value manually.`);
+                return promptTextInput(param);
+            }
+            if (choices.length > 10) {
+                return search({
+                    message: param.prompt,
+                    source: createSearchSource(choices),
+                });
+            }
+            return select({
+                message: param.prompt,
+                choices: choices.map((c) => ({ name: c.label, value: c.value })),
+                default: param.default,
+            });
+        }
+        case 'multi-choice': {
+            const { choices, warning } = await resolveSourceChoices(param, projectRoot);
+            if (warning)
+                ctx.warn(warning);
+            if (choices.length === 0)
+                return [];
+            // Pre-select default values if specified
+            const defaults = Array.isArray(param.default) ? param.default : [];
+            return checkbox({
+                message: param.prompt,
+                choices: choices.map((c) => ({
+                    name: c.label,
+                    value: c.value,
+                    checked: defaults.includes(c.value),
+                })),
+            });
+        }
+        case 'string': {
+            if (param.source) {
+                const { choices, warning } = await resolveSourceChoices(param, projectRoot);
+                if (warning)
+                    ctx.warn(warning);
+                if (choices.length > 0) {
+                    if (choices.length > 10) {
+                        return search({
+                            message: param.prompt,
+                            source: createSearchSource(choices),
+                        });
+                    }
+                    return select({
+                        message: param.prompt,
+                        choices: choices.map((c) => ({ name: c.label, value: c.value })),
+                        default: param.default,
+                    });
+                }
+                ctx.warn(`No ${param.source} found. Please enter a value manually.`);
+            }
+            return promptTextInput(param);
+        }
+        default: {
+            return undefined;
+        }
+    }
+}
+/**
+ * Prompt for text input with validation.
+ */
+async function promptTextInput(param) {
+    const value = await input({
+        message: param.prompt,
+        default: param.default,
+        required: param.required,
+        validate(val) {
+            if (param.required && !val)
+                return 'This field is required';
+            if (param.pattern && val) {
+                const regex = new RegExp(param.pattern);
+                if (!regex.test(val)) {
+                    return param.validationMessage || `Value does not match pattern: ${param.pattern}`;
+                }
+            }
+            return true;
+        },
+    });
+    return value || undefined;
+}
+/**
+ * Create a search source function for inquirer search prompt.
+ */
+function createSearchSource(choices) {
+    return async (term) => {
+        if (!term) {
+            return choices.map((c) => ({ name: c.label, value: c.value }));
+        }
+        const lowerTerm = term.toLowerCase();
+        return choices
+            .filter((c) => c.label.toLowerCase().includes(lowerTerm) || c.value.toLowerCase().includes(lowerTerm))
+            .map((c) => ({ name: c.label, value: c.value }));
+    };
+}
+/**
+ * Resolve choices for a parameter with dynamic source.
+ */
+async function resolveSourceChoices(param, projectRoot) {
+    if (!param.source) {
+        return { choices: param.choices || [] };
+    }
+    if (isRemoteSource(param.source)) {
+        try {
+            const choices = await resolveRemoteSource(param.source);
+            return { choices };
+        }
+        catch (error) {
+            return {
+                choices: [],
+                warning: `Could not fetch ${param.source}: ${error.message}`,
+            };
+        }
+    }
+    const result = resolveLocalSource(param.source, projectRoot);
+    return {
+        choices: result.choices,
+        pathMap: result.pathMap,
+    };
+}
+//# sourceMappingURL=generate-helper.js.map

package/dist/lib/scaffold/generate-helper.js.map

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

package/dist/lib/scaffold/source-resolver.d.ts

@@ -0,0 +1,25 @@
+import { type DynamicParameterSource, type ScaffoldChoice, type SourceResult } from '@salesforce/b2c-tooling-sdk/scaffold';
+export { isRemoteSource, validateAgainstSource, type SourceResult } from '@salesforce/b2c-tooling-sdk/scaffold';
+/**
+ * @deprecated Use SourceResult from '@salesforce/b2c-tooling-sdk/scaffold' instead.
+ * This type alias is kept for backwards compatibility.
+ */
+export type LocalSourceResult = SourceResult;
+/**
+ * Resolves a local (non-remote) parameter source.
+ * Delegates to SDK function.
+ *
+ * @param source - The source type to resolve
+ * @param projectRoot - Project root directory for cartridge discovery
+ * @returns Resolved choices and optional path mapping
+ */
+export declare function resolveLocalSource(source: DynamicParameterSource, projectRoot: string): SourceResult;
+/**
+ * CLI wrapper for remote source resolution.
+ * Handles auth orchestration using CLI config loading.
+ *
+ * @param source - The source type to resolve
+ * @returns Promise resolving to choices array
+ * @throws Error if authentication fails or API call fails
+ */
+export declare function resolveRemoteSource(source: DynamicParameterSource): Promise<ScaffoldChoice[]>;

package/dist/lib/scaffold/source-resolver.js

@@ -0,0 +1,37 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { resolveLocalSource as sdkResolveLocalSource, resolveRemoteSource as sdkResolveRemoteSource, } from '@salesforce/b2c-tooling-sdk/scaffold';
+import { loadConfig } from '@salesforce/b2c-tooling-sdk/cli';
+// Re-export SDK functions and types
+export { isRemoteSource, validateAgainstSource } from '@salesforce/b2c-tooling-sdk/scaffold';
+/**
+ * Resolves a local (non-remote) parameter source.
+ * Delegates to SDK function.
+ *
+ * @param source - The source type to resolve
+ * @param projectRoot - Project root directory for cartridge discovery
+ * @returns Resolved choices and optional path mapping
+ */
+export function resolveLocalSource(source, projectRoot) {
+    return sdkResolveLocalSource(source, projectRoot);
+}
+/**
+ * CLI wrapper for remote source resolution.
+ * Handles auth orchestration using CLI config loading.
+ *
+ * @param source - The source type to resolve
+ * @returns Promise resolving to choices array
+ * @throws Error if authentication fails or API call fails
+ */
+export async function resolveRemoteSource(source) {
+    const config = loadConfig({}, { configPath: undefined });
+    if (!config.hasB2CInstanceConfig() || !config.hasOAuthConfig()) {
+        throw new Error('B2C instance configuration with OAuth required for sites source');
+    }
+    const instance = config.createB2CInstance();
+    return sdkResolveRemoteSource(source, instance);
+}
+//# sourceMappingURL=source-resolver.js.map

package/dist/lib/scaffold/source-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-resolver.js","sourceRoot":"","sources":["../../../src/lib/scaffold/source-resolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,IAAI,qBAAqB,EAC3C,mBAAmB,IAAI,sBAAsB,GAI9C,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAC,UAAU,EAAC,MAAM,iCAAiC,CAAC;AAE3D,oCAAoC;AACpC,OAAO,EAAC,cAAc,EAAE,qBAAqB,EAAoB,MAAM,sCAAsC,CAAC;AAQ9G;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA8B,EAAE,WAAmB;IACpF,OAAO,qBAAqB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAA8B;IACtE,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,EAAE,EAAC,UAAU,EAAE,SAAS,EAAC,CAAC,CAAC;IAEvD,IAAI,CAAC,MAAM,CAAC,oBAAoB,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC;IAC5C,OAAO,sBAAsB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAClD,CAAC"}

package/dist/utils/am/resolve-org.d.ts

@@ -0,0 +1,11 @@
+import type { AccountManagerOrganization } from '@salesforce/b2c-tooling-sdk';
+interface OrgResolver {
+    getOrg(orgId: string): Promise<AccountManagerOrganization>;
+    getOrgByName(name: string): Promise<AccountManagerOrganization>;
+}
+/**
+ * Resolves an organization identifier (ID or friendly name) to an org ID.
+ * Tries by ID first, then falls back to name lookup.
+ */
+export declare function resolveOrgId(client: OrgResolver, orgIdOrName: string): Promise<string>;
+export {};

package/dist/utils/am/resolve-org.js

@@ -0,0 +1,15 @@
+/**
+ * Resolves an organization identifier (ID or friendly name) to an org ID.
+ * Tries by ID first, then falls back to name lookup.
+ */
+export async function resolveOrgId(client, orgIdOrName) {
+    try {
+        const org = await client.getOrg(orgIdOrName);
+        return org.id;
+    }
+    catch {
+        const org = await client.getOrgByName(orgIdOrName);
+        return org.id;
+    }
+}
+//# sourceMappingURL=resolve-org.js.map

package/dist/utils/am/resolve-org.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-org.js","sourceRoot":"","sources":["../../../src/utils/am/resolve-org.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAmB,EAAE,WAAmB;IACzE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC7C,OAAO,GAAG,CAAC,EAAG,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;QACnD,OAAO,GAAG,CAAC,EAAG,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/utils/am/user-display.d.ts

@@ -0,0 +1,5 @@
+import type { AccountManagerUser, RoleMapping, OrgMapping } from '@salesforce/b2c-tooling-sdk';
+/**
+ * Prints user details to stdout using cliui formatting.
+ */
+export declare function printUserDetails(user: AccountManagerUser, roleMapping: RoleMapping, orgMapping: OrgMapping): void;

package/dist/utils/am/user-display.js

@@ -0,0 +1,100 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { ux } from '@oclif/core';
+import cliui from 'cliui';
+import { resolveToInternalRole } from '@salesforce/b2c-tooling-sdk';
+/**
+ * Formats a role for display as "Description (ENUM_NAME)" or just "ENUM_NAME".
+ */
+function formatRoleDisplay(roleName, roleMapping) {
+    const enumName = resolveToInternalRole(roleName, roleMapping);
+    const description = roleMapping.descriptions.get(enumName);
+    return description ? `${description} (${enumName})` : enumName;
+}
+function formatOrgDisplay(orgId, orgMapping) {
+    const name = orgMapping.byId.get(orgId);
+    return name ? `${name} (${orgId})` : orgId;
+}
+function printBasicFields(ui, user, orgMapping) {
+    const isPasswordExpired = user.passwordExpirationTimestamp
+        ? user.passwordExpirationTimestamp < Date.now()
+        : undefined;
+    const twoFAEnabled = user.verifiers && user.verifiers.length > 0 ? 'Yes' : 'No';
+    const primaryOrg = user.primaryOrganization ? formatOrgDisplay(user.primaryOrganization, orgMapping) : undefined;
+    const fields = [
+        ['ID', user.id],
+        ['Email', user.mail],
+        ['First Name', user.firstName],
+        ['Last Name', user.lastName],
+        ['Display Name', user.displayName],
+        ['State', user.userState],
+        ['Primary Organization', primaryOrg],
+        ['Preferred Locale', user.preferredLocale || undefined],
+        ['Business Phone', user.businessPhone || undefined],
+        ['Home Phone', user.homePhone || undefined],
+        ['Mobile Phone', user.mobilePhone || undefined],
+        ['Linked to SF Identity', user.linkedToSfIdentity?.toString()],
+        ['2FA Enabled', twoFAEnabled],
+        ['Password Expired', isPasswordExpired === undefined ? undefined : isPasswordExpired ? 'Yes' : 'No'],
+        ['Last Login', user.lastLoginDate || undefined],
+        ['Created At', user.createdAt ? new Date(user.createdAt).toLocaleString() : undefined],
+        ['Last Modified', user.lastModified ? new Date(user.lastModified).toLocaleString() : undefined],
+    ];
+    for (const [label, value] of fields) {
+        if (value !== undefined) {
+            ui.div({ text: `${label}:`, width: 25, padding: [0, 2, 0, 0] }, { text: value, padding: [0, 0, 0, 0] });
+        }
+    }
+}
+function printOrganizations(ui, user, orgMapping) {
+    if (!user.organizations || user.organizations.length === 0) {
+        return;
+    }
+    ui.div({ text: 'Organizations', padding: [2, 0, 0, 0] });
+    ui.div({ text: '─'.repeat(50), padding: [0, 0, 0, 0] });
+    for (const o of user.organizations) {
+        const orgId = typeof o === 'string' ? o : o.id || 'Unknown';
+        const name = formatOrgDisplay(orgId, orgMapping);
+        ui.div({ text: `- ${name}`, padding: [0, 0, 0, 2] });
+    }
+}
+function printRoles(ui, user, roleMapping) {
+    if (!user.roles || user.roles.length === 0) {
+        return;
+    }
+    ui.div({ text: 'Roles', padding: [2, 0, 0, 0] });
+    ui.div({ text: '─'.repeat(50), padding: [0, 0, 0, 0] });
+    for (const r of user.roles) {
+        const name = typeof r === 'string' ? r : r.roleEnumName || r.id || 'Unknown';
+        const display = formatRoleDisplay(name, roleMapping);
+        ui.div({ text: `- ${display}`, padding: [0, 0, 0, 2] });
+    }
+}
+function printRoleScopes(ui, user) {
+    if (!user.roleTenantFilterMap || Object.keys(user.roleTenantFilterMap).length === 0) {
+        return;
+    }
+    ui.div({ text: 'Role Scopes', padding: [2, 0, 0, 0] });
+    ui.div({ text: '─'.repeat(50), padding: [0, 0, 0, 0] });
+    for (const [roleEnumName, filter] of Object.entries(user.roleTenantFilterMap)) {
+        const filterValue = typeof filter === 'string' ? filter : Array.isArray(filter) ? filter.join(', ') : String(filter);
+        ui.div({ text: `${roleEnumName}:`, width: 30, padding: [0, 2, 0, 0] }, { text: filterValue, padding: [0, 0, 0, 0] });
+    }
+}
+/**
+ * Prints user details to stdout using cliui formatting.
+ */
+export function printUserDetails(user, roleMapping, orgMapping) {
+    const ui = cliui({ width: process.stdout.columns || 80 });
+    ui.div({ text: 'User Details', padding: [1, 0, 0, 0] });
+    ui.div({ text: '─'.repeat(50), padding: [0, 0, 0, 0] });
+    printBasicFields(ui, user, orgMapping);
+    printOrganizations(ui, user, orgMapping);
+    printRoles(ui, user, roleMapping);
+    printRoleScopes(ui, user);
+    ux.stdout(ui.toString());
+}
+//# sourceMappingURL=user-display.js.map

package/dist/utils/am/user-display.js.map

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

package/dist/utils/ecdn/zone-command.d.ts

@@ -10,10 +10,11 @@ export declare abstract class EcdnZoneCommand<T extends typeof Command> extends
         zone: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         'client-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'client-secret': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        scope: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'auth-scope': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'short-code': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'tenant-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'auth-methods': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'user-auth': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'account-manager-host': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'log-level': import("@oclif/core/interfaces").OptionFlag<"trace" | "debug" | "info" | "warn" | "error" | "silent" | undefined, import("@oclif/core/interfaces").CustomOptions>;
         debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;

package/dist/utils/mrt-logs/format.d.ts

@@ -0,0 +1,28 @@
+import type { MrtLogEntry } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+/**
+ * Options for formatting an MRT log entry.
+ */
+export interface FormatMrtEntryOptions {
+    /** Whether to use ANSI color codes. */
+    useColor: boolean;
+    /** Regex to highlight matches in the message. */
+    searchHighlight?: RegExp;
+}
+/**
+ * Colorizes a log level name using its level color + bold.
+ */
+export declare function colorLevel(level: string): string;
+/**
+ * Colorizes text with the search highlight style (bold yellow).
+ */
+export declare function colorHighlight(text: string): string;
+/**
+ * Formats an MRT log entry for terminal display.
+ *
+ * Output format:
+ * ```
+ * LEVEL [timestamp] [shortRequestId]
+ * message
+ * ```
+ */
+export declare function formatMrtEntry(entry: MrtLogEntry, options: FormatMrtEntryOptions): string;

package/dist/utils/mrt-logs/format.js

@@ -0,0 +1,90 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * ANSI color codes for log levels.
+ * Matches the color scheme from logs/format.ts for consistency.
+ */
+const LEVEL_COLORS = {
+    ERROR: '\u001B[31m', // Red
+    FATAL: '\u001B[35m', // Magenta
+    WARN: '\u001B[33m', // Yellow
+    WARNING: '\u001B[33m', // Yellow
+    INFO: '\u001B[36m', // Cyan
+    DEBUG: '\u001B[90m', // Gray
+    TRACE: '\u001B[90m', // Gray
+};
+const RESET = '\u001B[0m';
+const DIM = '\u001B[2m';
+const BOLD = '\u001B[1m';
+const HIGHLIGHT = '\u001B[1;33m'; // Bold yellow for search matches
+/**
+ * Highlights regex matches in text with ANSI color codes.
+ */
+function highlightMatches(text, pattern) {
+    return text.replace(pattern, (match) => `${HIGHLIGHT}${match}${RESET}`);
+}
+/**
+ * Colorizes a log level name using its level color + bold.
+ */
+export function colorLevel(level) {
+    const color = LEVEL_COLORS[level] || '';
+    return `${color}${BOLD}${level}${RESET}`;
+}
+/**
+ * Colorizes text with the search highlight style (bold yellow).
+ */
+export function colorHighlight(text) {
+    return `${HIGHLIGHT}${text}${RESET}`;
+}
+/**
+ * Formats an MRT log entry for terminal display.
+ *
+ * Output format:
+ * ```
+ * LEVEL [timestamp] [shortRequestId]
+ * message
+ * ```
+ */
+export function formatMrtEntry(entry, options) {
+    const { useColor, searchHighlight } = options;
+    const headerParts = [];
+    // Level first (most important for scanning)
+    if (entry.level) {
+        if (useColor) {
+            const color = LEVEL_COLORS[entry.level] || '';
+            headerParts.push(`${color}${BOLD}${entry.level}${RESET}`);
+        }
+        else {
+            headerParts.push(entry.level);
+        }
+    }
+    // Timestamp
+    if (entry.timestamp) {
+        if (useColor) {
+            headerParts.push(`${DIM}[${entry.timestamp}]${RESET}`);
+        }
+        else {
+            headerParts.push(`[${entry.timestamp}]`);
+        }
+    }
+    // Short request ID
+    if (entry.shortRequestId) {
+        if (useColor) {
+            headerParts.push(`${DIM}[${entry.shortRequestId}]${RESET}`);
+        }
+        else {
+            headerParts.push(`[${entry.shortRequestId}]`);
+        }
+    }
+    const header = headerParts.join(' ');
+    let message = entry.message.trimEnd();
+    // Highlight search matches in message
+    if (useColor && searchHighlight) {
+        message = highlightMatches(message, searchHighlight);
+    }
+    return `${header}\n${message}\n`;
+}
+//# sourceMappingURL=format.js.map

package/dist/utils/mrt-logs/format.js.map

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

package/dist/utils/mrt-logs/index.d.ts

@@ -0,0 +1 @@
+export * from './format.js';