@salesforce/b2c-tooling-sdk 1.9.0 → 1.11.0

package/dist/cjs/telemetry/telemetry.js

@@ -1,298 +0,0 @@
-/*
- * 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 { randomBytes } from 'node:crypto';
-import fs from 'node:fs';
-import path from 'node:path';
-import appInsights from 'applicationinsights';
-import { getLogger } from '../logging/index.js';
-const generateRandomId = () => randomBytes(20).toString('hex');
-/**
- * Sanitize attributes to only include string, number, boolean (App Insights–safe).
- * Aligns with sf CLI telemetry record() validation.
- */
-function sanitizeAttributes(attributes) {
-    const out = {};
-    for (const [key, value] of Object.entries(attributes)) {
-        if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
-            out[key] = value;
-        }
-    }
-    return out;
-}
-/**
- * Split attributes into string properties and numeric measurements
- * for Application Insights, matching the behavior of @salesforce/telemetry.
- * String values have $HOME replaced with ~ for GDPR safety.
- * Boolean values are converted to strings.
- */
-function buildPropertiesAndMeasurements(attributes) {
-    const properties = {};
-    const measurements = {};
-    const home = process.env.HOME ?? '';
-    for (const [key, value] of Object.entries(attributes)) {
-        if (typeof value === 'string') {
-            properties[key] = home ? value.replace(home, '~') : value;
-        }
-        else if (typeof value === 'number') {
-            measurements[key] = value;
-        }
-        else if (typeof value === 'boolean') {
-            properties[key] = String(value);
-        }
-    }
-    return { properties, measurements };
-}
-/**
- * Get the path to the persistent CLI ID file.
- * @param dataDir - oclif dataDir for persistent storage
- */
-const getCliIdPath = (dataDir) => {
-    if (!dataDir)
-        return null;
-    return path.join(dataDir, 'cliid');
-};
-/**
- * Read or create a persistent CLI ID.
- * @param dataDir - oclif dataDir for persistent storage
- */
-const readOrCreateCliId = (dataDir) => {
-    const filePath = getCliIdPath(dataDir);
-    if (!filePath)
-        return generateRandomId();
-    // Try to read existing ID
-    try {
-        if (fs.existsSync(filePath)) {
-            const value = fs.readFileSync(filePath, 'utf8');
-            const trimmed = value?.trim();
-            if (trimmed)
-                return trimmed;
-        }
-    }
-    catch {
-        // Fall through to create new
-    }
-    // Create new ID
-    const newId = generateRandomId();
-    try {
-        const dir = path.dirname(filePath);
-        if (!fs.existsSync(dir)) {
-            fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
-        }
-        fs.writeFileSync(filePath, newId, { encoding: 'utf8', mode: 0o600 });
-    }
-    catch {
-        // If we can't persist, still return the generated id
-    }
-    return newId;
-};
-/**
- * Telemetry client for sending events to Application Insights.
- *
- * @example
- * ```typescript
- * const telemetry = new Telemetry({
- *   project: 'my-app',
- *   appInsightsKey: 'InstrumentationKey=...',
- *   version: '1.0.0',
- *   dataDir: '/path/to/data',
- * });
- *
- * await telemetry.start();
- * telemetry.sendEvent('USER_ACTION', { action: 'click' });
- * telemetry.stop();
- * ```
- */
-export class Telemetry {
-    attributes;
-    cliId;
-    project;
-    client;
-    sessionId;
-    started;
-    version;
-    appInsightsKey;
-    traceLog;
-    /**
-     * Check if telemetry is disabled via environment variables.
-     * Supports both SF_DISABLE_TELEMETRY (sf CLI standard) and SFCC_DISABLE_TELEMETRY.
-     */
-    static isDisabled() {
-        return process.env.SF_DISABLE_TELEMETRY === 'true' || process.env.SFCC_DISABLE_TELEMETRY === 'true';
-    }
-    /**
-     * Get the connection string for telemetry, respecting disable flags and env overrides.
-     * @param projectDefault - Default connection string from project config (e.g., package.json)
-     * @returns Connection string to use, or undefined if telemetry should be disabled
-     */
-    static getConnectionString(projectDefault) {
-        if (Telemetry.isDisabled())
-            return undefined;
-        return process.env.SFCC_APP_INSIGHTS_KEY ?? projectDefault;
-    }
-    constructor(options) {
-        this.project = options.project;
-        this.appInsightsKey = options.appInsightsKey;
-        this.attributes = { ...(options.initialAttributes ?? {}) };
-        this.cliId = readOrCreateCliId(options.dataDir);
-        this.client = undefined;
-        this.sessionId = generateRandomId();
-        this.started = false;
-        this.version = options.version ?? '0.0.0';
-        if (process.env.SFCC_TELEMETRY_LOG === 'true') {
-            this.traceLog = getLogger().child({ component: 'telemetry' });
-        }
-    }
-    /**
-     * Add additional attributes to include with all future events.
-     */
-    addAttributes(attributes) {
-        this.traceLog?.debug({ attributes }, 'telemetry addAttributes');
-        this.attributes = { ...this.attributes, ...attributes };
-    }
-    /**
-     * Send a telemetry event. Events are buffered until you call {@link flush} or
-     * {@link stop}. Use this for batching; use {@link sendEventAndFlush} when you
-     * need one event sent before continuing.
-     *
-     * @param eventName - Name of the event (e.g., 'SERVER_STATUS', 'TOOL_CALLED')
-     * @param attributes - Event-specific attributes (only string/number/boolean are sent)
-     */
-    sendEvent(eventName, attributes = {}) {
-        try {
-            const name = eventName?.trim() || 'UNKNOWN';
-            this.traceLog?.debug({ event: name, attributes }, 'telemetry sendEvent');
-            const eventProperties = this.buildEventProperties(attributes);
-            const { properties, measurements } = buildPropertiesAndMeasurements(eventProperties);
-            this.client?.trackEvent({ name: `${this.project}/${name}`, properties, measurements });
-        }
-        catch {
-            // ignore send errors
-        }
-    }
-    /**
-     * Send a telemetry event and flush immediately. Use this when you need the event
-     * delivered before continuing (e.g. after a tool call or server lifecycle event),
-     * so you don't have to remember to call {@link flush}. For batching multiple
-     * events and flushing once, use {@link sendEvent} and then {@link flush}.
-     *
-     * @param eventName - Name of the event (e.g., 'SERVER_STATUS', 'TOOL_CALLED')
-     * @param attributes - Event-specific attributes (only string/number/boolean are sent)
-     */
-    async sendEventAndFlush(eventName, attributes = {}) {
-        this.sendEvent(eventName, attributes);
-        await this.flush();
-    }
-    /**
-     * Send an exception to telemetry.
-     *
-     * @param error - The error to report
-     * @param attributes - Additional attributes to include with the exception
-     */
-    sendException(error, attributes = {}) {
-        try {
-            this.traceLog?.debug({ error: error.name, message: error.message }, 'telemetry sendException');
-            const eventProperties = this.buildEventProperties(sanitizeAttributes(attributes));
-            const { properties, measurements } = buildPropertiesAndMeasurements(eventProperties);
-            this.client?.trackException({ exception: error, properties, measurements });
-        }
-        catch {
-            // ignore send errors
-        }
-    }
-    /**
-     * Start the telemetry reporter.
-     * Must be called before sending events.
-     */
-    async start() {
-        if (this.started)
-            return;
-        this.started = true;
-        // If no key provided, telemetry is disabled
-        if (!this.appInsightsKey)
-            return;
-        this.traceLog?.debug({ project: this.project, sessionId: this.sessionId, cliId: this.cliId.slice(0, 8) + '...' }, 'telemetry start');
-        try {
-            this.createClient();
-        }
-        catch {
-            // best-effort — telemetry failure never impacts the application
-        }
-    }
-    /**
-     * Flush pending telemetry events without stopping the client.
-     * Use this for long-running processes that need to ensure events are sent periodically.
-     */
-    async flush() {
-        if (!this.started || !this.client)
-            return;
-        await new Promise((resolve) => {
-            this.client.flush({ callback: () => resolve() });
-        });
-    }
-    /**
-     * Stop the telemetry client and flush any pending events.
-     * Includes a delay to allow async HTTP requests to complete.
-     */
-    async stop() {
-        if (!this.started)
-            return;
-        this.traceLog?.debug('telemetry stop');
-        this.started = false;
-        if (this.client) {
-            await new Promise((resolve) => {
-                this.client.flush({ callback: () => resolve() });
-            });
-            this.client = undefined;
-        }
-        // Allow pending HTTP requests to flush before process exits.
-        // Application Insights SDK sends events asynchronously, so we need
-        // a delay to ensure events reach the server on fast exits.
-        // 300ms gives enough time for the HTTP request to complete even on
-        // cold starts when establishing the initial connection.
-        await new Promise((resolve) => setTimeout(resolve, 300));
-    }
-    buildEventProperties(attributes = {}) {
-        const sanitized = sanitizeAttributes({ ...this.attributes, ...attributes });
-        return {
-            ...sanitized,
-            sessionId: this.sessionId,
-            cliId: this.cliId,
-            version: this.version,
-            platform: process.platform,
-            arch: process.arch,
-            nodeVersion: process.version,
-            nodeEnv: process.env.NODE_ENV,
-            origin: this.project,
-            date: new Date().toUTCString(),
-            timestamp: String(Date.now()),
-            processUptime: process.uptime() * 1000,
-        };
-    }
-    createClient() {
-        const client = new appInsights.TelemetryClient(this.appInsightsKey);
-        // Disable all auto-collection — we only do manual event tracking
-        client.config.enableAutoCollectConsole = false;
-        client.config.enableAutoCollectExceptions = false;
-        client.config.enableAutoCollectPerformance = false;
-        client.config.enableAutoCollectRequests = false;
-        client.config.enableAutoCollectDependencies = false;
-        client.config.enableAutoDependencyCorrelation = false;
-        client.config.enableAutoCollectHeartbeat = false;
-        client.config.enableAutoCollectPreAggregatedMetrics = false;
-        client.config.enableAutoCollectIncomingRequestAzureFunctions = false;
-        client.config.enableSendLiveMetrics = false;
-        client.config.enableUseDiskRetryCaching = false;
-        client.config.disableStatsbeat = true;
-        client.config.enableInternalDebugLogging = false;
-        client.config.enableInternalWarningLogging = false;
-        // Set user ID for session tracking
-        client.context.tags[client.context.keys.userId] = this.cliId;
-        // GDPR: hide machine-identifying cloud role instance
-        client.context.tags[client.context.keys.cloudRoleInstance] = '';
-        this.client = client;
-    }
-}
-//# sourceMappingURL=telemetry.js.map

package/dist/cjs/telemetry/telemetry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../../src/telemetry/telemetry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,WAAW,EAAC,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,WAAW,MAAM,qBAAqB,CAAC;AAE9C,OAAO,EAAC,SAAS,EAAc,MAAM,qBAAqB,CAAC;AAE3D,MAAM,gBAAgB,GAAG,GAAW,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAEvE;;;GAGG;AACH,SAAS,kBAAkB,CAAC,UAA+B;IACzD,MAAM,GAAG,GAAwB,EAAE,CAAC;IACpC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YACzF,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,SAAS,8BAA8B,CAAC,UAA+B;IAIrE,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,MAAM,YAAY,GAA2B,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;IACpC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC5D,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACrC,YAAY,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC5B,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YACtC,UAAU,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IACD,OAAO,EAAC,UAAU,EAAE,YAAY,EAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,YAAY,GAAG,CAAC,OAAgB,EAAiB,EAAE;IACvD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,iBAAiB,GAAG,CAAC,OAAgB,EAAU,EAAE;IACrD,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,QAAQ;QAAE,OAAO,gBAAgB,EAAE,CAAC;IAEzC,0BAA0B;IAC1B,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAChD,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;YAC9B,IAAI,OAAO;gBAAE,OAAO,OAAO,CAAC;QAC9B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;IAC/B,CAAC;IAED,gBAAgB;IAChB,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAC,CAAC,CAAC;QACpD,CAAC;QACD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAC,CAAC,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,qDAAqD;IACvD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,SAAS;IACZ,UAAU,CAAsB;IAChC,KAAK,CAAS;IACd,OAAO,CAAS;IAChB,MAAM,CAA0C;IAChD,SAAS,CAAS;IAClB,OAAO,CAAU;IACjB,OAAO,CAAS;IAChB,cAAc,CAAqB;IACnC,QAAQ,CAAqB;IAErC;;;OAGG;IACH,MAAM,CAAC,UAAU;QACf,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,MAAM,CAAC;IACtG,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,mBAAmB,CAAC,cAAuB;QAChD,IAAI,SAAS,CAAC,UAAU,EAAE;YAAE,OAAO,SAAS,CAAC;QAC7C,OAAO,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,cAAc,CAAC;IAC7D,CAAC;IAED,YAAY,OAAyB;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC7C,IAAI,CAAC,UAAU,GAAG,EAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,IAAI,EAAE,CAAC,EAAC,CAAC;QACzD,IAAI,CAAC,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,gBAAgB,EAAE,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC;QAE1C,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,MAAM,EAAE,CAAC;YAC9C,IAAI,CAAC,QAAQ,GAAG,SAAS,EAAE,CAAC,KAAK,CAAC,EAAC,SAAS,EAAE,WAAW,EAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,UAA+B;QAC3C,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAC,UAAU,EAAC,EAAE,yBAAyB,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,GAAG,EAAC,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,UAAU,EAAC,CAAC;IACxD,CAAC;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,SAAiB,EAAE,aAAkC,EAAE;QAC/D,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;YAC5C,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAC,KAAK,EAAE,IAAI,EAAE,UAAU,EAAC,EAAE,qBAAqB,CAAC,CAAC;YACvE,MAAM,eAAe,GAAG,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;YAC9D,MAAM,EAAC,UAAU,EAAE,YAAY,EAAC,GAAG,8BAA8B,CAAC,eAAe,CAAC,CAAC;YACnF,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,EAAC,IAAI,EAAE,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,EAAE,EAAE,UAAU,EAAE,YAAY,EAAC,CAAC,CAAC;QACvF,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,iBAAiB,CAAC,SAAiB,EAAE,aAAkC,EAAE;QAC7E,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACtC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,KAAY,EAAE,aAAkC,EAAE;QAC9D,IAAI,CAAC;YACH,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAC,EAAE,yBAAyB,CAAC,CAAC;YAC7F,MAAM,eAAe,GAAG,IAAI,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC;YAClF,MAAM,EAAC,UAAU,EAAE,YAAY,EAAC,GAAG,8BAA8B,CAAC,eAAe,CAAC,CAAC;YACnF,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,EAAC,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAC,CAAC,CAAC;QAC5E,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEpB,4CAA4C;QAC5C,IAAI,CAAC,IAAI,CAAC,cAAc;YAAE,OAAO;QAEjC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAClB,EAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,EAAC,EACzF,iBAAiB,CAClB,CAAC;QAEF,IAAI,CAAC;YACH,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,gEAAgE;QAClE,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QAE1C,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,IAAI,CAAC,MAAO,CAAC,KAAK,CAAC,EAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,EAAC,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QAErB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,IAAI,CAAC,MAAO,CAAC,KAAK,CAAC,EAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,EAAC,CAAC,CAAC;YAClD,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QAC1B,CAAC;QAED,6DAA6D;QAC7D,mEAAmE;QACnE,2DAA2D;QAC3D,mEAAmE;QACnE,wDAAwD;QACxD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3D,CAAC;IAEO,oBAAoB,CAAC,aAAkC,EAAE;QAC/D,MAAM,SAAS,GAAG,kBAAkB,CAAC,EAAC,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,UAAU,EAAC,CAAC,CAAC;QAC1E,OAAO;YACL,GAAG,SAAS;YACZ,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,WAAW,EAAE,OAAO,CAAC,OAAO;YAC5B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ;YAC7B,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC9B,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,aAAa,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI;SACvC,CAAC;IACJ,CAAC;IAEO,YAAY;QAClB,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAEpE,iEAAiE;QACjE,MAAM,CAAC,MAAM,CAAC,wBAAwB,GAAG,KAAK,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,2BAA2B,GAAG,KAAK,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,4BAA4B,GAAG,KAAK,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,yBAAyB,GAAG,KAAK,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,6BAA6B,GAAG,KAAK,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,+BAA+B,GAAG,KAAK,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,0BAA0B,GAAG,KAAK,CAAC;QACjD,MAAM,CAAC,MAAM,CAAC,qCAAqC,GAAG,KAAK,CAAC;QAC5D,MAAM,CAAC,MAAM,CAAC,8CAA8C,GAAG,KAAK,CAAC;QACrE,MAAM,CAAC,MAAM,CAAC,qBAAqB,GAAG,KAAK,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,yBAAyB,GAAG,KAAK,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,0BAA0B,GAAG,KAAK,CAAC;QACjD,MAAM,CAAC,MAAM,CAAC,4BAA4B,GAAG,KAAK,CAAC;QAEnD,mCAAmC;QACnC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QAC7D,qDAAqD;QACrD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,CAAC;QAEhE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF"}

package/dist/cjs/telemetry/types.d.ts

@@ -1,62 +0,0 @@
-/**
- * Telemetry event attributes - key-value pairs sent with each event.
- */
-export interface TelemetryAttributes {
-    [key: string]: boolean | number | string | undefined;
-}
-/**
- * Core properties automatically included with every telemetry event.
- */
-export interface TelemetryEventProperties extends TelemetryAttributes {
-    /** Unique session identifier (generated per Telemetry instance) */
-    sessionId: string;
-    /** Persistent CLI identifier (stored in {dataDir}/cliid) */
-    cliId: string;
-    /** Package version */
-    version: string;
-    /** Operating system platform (e.g., 'darwin', 'linux', 'win32') */
-    platform: string;
-    /** CPU architecture (e.g., 'x64', 'arm64') */
-    arch: string;
-    /** Node.js version */
-    nodeVersion: string;
-    /** NODE_ENV environment variable value */
-    nodeEnv: string | undefined;
-    /** Project name / origin of the event */
-    origin: string;
-    /** Human-readable UTC date string */
-    date: string;
-    /** Unix timestamp in milliseconds */
-    timestamp: string;
-    /** Process uptime in milliseconds */
-    processUptime: number;
-}
-/**
- * Options for creating a Telemetry instance.
- */
-export interface TelemetryOptions {
-    /**
-     * Project identifier used for telemetry reporting.
-     * This is used as the project name in Application Insights.
-     */
-    project: string;
-    /**
-     * Application Insights connection string or instrumentation key.
-     * If not provided, telemetry will be disabled.
-     */
-    appInsightsKey?: string;
-    /**
-     * Initial attributes to include with every telemetry event.
-     */
-    initialAttributes?: TelemetryAttributes;
-    /**
-     * Package version to include in telemetry events.
-     */
-    version?: string;
-    /**
-     * oclif dataDir for persistent CLI ID storage.
-     * If provided, CLI ID is stored in {dataDir}/cliid.
-     * If not provided or non-writable, falls back to random ID.
-     */
-    dataDir?: string;
-}

package/dist/cjs/telemetry/types.js

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

package/dist/cjs/telemetry/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/telemetry/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/cjs/test-utils/config-isolation.d.ts

@@ -1,2 +0,0 @@
-export declare function isolateConfig(): void;
-export declare function restoreConfig(): void;

package/dist/cjs/test-utils/config-isolation.js

@@ -1,48 +0,0 @@
-/*
- * 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 { resetLogger } from '../logging/index.js';
-const ADDITIONAL_ENV_VARS = ['LANGUAGE', 'NO_COLOR'];
-let state = null;
-export function isolateConfig() {
-    if (state)
-        throw new Error('isolateConfig() called without cleanup - call restoreConfig() first');
-    const savedEnvVars = {};
-    for (const key of Object.keys(process.env)) {
-        if (key.startsWith('SFCC_') || key.startsWith('MRT_')) {
-            savedEnvVars[key] = process.env[key];
-            delete process.env[key];
-        }
-    }
-    for (const key of ADDITIONAL_ENV_VARS) {
-        savedEnvVars[key] = process.env[key];
-        delete process.env[key];
-    }
-    process.env.SFCC_CONFIG = '/dev/null';
-    process.env.MRT_CREDENTIALS_FILE = '/dev/null';
-    process.env.SFCC_LOG_LEVEL = 'silent';
-    // Reset global logger so it picks up the new SFCC_LOG_LEVEL
-    resetLogger();
-    state = { savedEnvVars };
-}
-export function restoreConfig() {
-    if (!state)
-        return;
-    // Reset logger before restoring env vars
-    resetLogger();
-    delete process.env.SFCC_CONFIG;
-    delete process.env.MRT_CREDENTIALS_FILE;
-    delete process.env.SFCC_LOG_LEVEL;
-    for (const [key, value] of Object.entries(state.savedEnvVars)) {
-        if (value === undefined) {
-            delete process.env[key];
-        }
-        else {
-            process.env[key] = value;
-        }
-    }
-    state = null;
-}
-//# sourceMappingURL=config-isolation.js.map

package/dist/cjs/test-utils/config-isolation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config-isolation.js","sourceRoot":"","sources":["../../../src/test-utils/config-isolation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,WAAW,EAAC,MAAM,qBAAqB,CAAC;AAEhD,MAAM,mBAAmB,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AAMrD,IAAI,KAAK,GAA0B,IAAI,CAAC;AAExC,MAAM,UAAU,aAAa;IAC3B,IAAI,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IAElG,MAAM,YAAY,GAAuC,EAAE,CAAC;IAE5D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3C,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACtD,YAAY,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACrC,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;QACtC,YAAY,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,WAAW,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,WAAW,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,QAAQ,CAAC;IAEtC,4DAA4D;IAC5D,WAAW,EAAE,CAAC;IAEd,KAAK,GAAG,EAAC,YAAY,EAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,KAAK;QAAE,OAAO;IAEnB,yCAAyC;IACzC,WAAW,EAAE,CAAC;IAEd,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IACxC,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAElC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,KAAK,GAAG,IAAI,CAAC;AACf,CAAC"}

package/dist/cjs/test-utils/index.d.ts

@@ -1 +0,0 @@
-export { isolateConfig, restoreConfig } from './config-isolation.js';

package/dist/cjs/test-utils/index.js

@@ -1,7 +0,0 @@
-/*
- * 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
- */
-export { isolateConfig, restoreConfig } from './config-isolation.js';
-//# sourceMappingURL=index.js.map

package/dist/cjs/test-utils/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/test-utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,aAAa,EAAE,aAAa,EAAC,MAAM,uBAAuB,CAAC"}

package/dist/cjs/ux/confirm.d.ts

@@ -1,14 +0,0 @@
-export interface ConfirmOptions {
-    /** Default to yes when the user presses Enter without typing. Defaults to false (no). */
-    defaultYes?: boolean;
-}
-/**
- * Simple yes/no confirmation prompt.
- *
- * Output goes to stderr so it doesn't interfere with structured stdout output.
- *
- * @param message - Prompt message (the hint is appended automatically)
- * @param options - Options to control default behavior
- * @returns true if user confirmed, false otherwise
- */
-export declare function confirm(message: string, options?: ConfirmOptions): Promise<boolean>;

package/dist/cjs/ux/confirm.js

@@ -1,36 +0,0 @@
-/*
- * 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 * as readline from 'node:readline';
-/**
- * Simple yes/no confirmation prompt.
- *
- * Output goes to stderr so it doesn't interfere with structured stdout output.
- *
- * @param message - Prompt message (the hint is appended automatically)
- * @param options - Options to control default behavior
- * @returns true if user confirmed, false otherwise
- */
-export async function confirm(message, options) {
-    const defaultYes = options?.defaultYes ?? false;
-    const hint = defaultYes ? '(Y/n)' : '(y/N)';
-    const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stderr,
-    });
-    return new Promise((resolve) => {
-        rl.question(`${message} ${hint} `, (answer) => {
-            rl.close();
-            const normalized = answer.trim().toLowerCase();
-            if (normalized === '') {
-                resolve(defaultYes);
-            }
-            else {
-                resolve(normalized === 'y' || normalized === 'yes');
-            }
-        });
-    });
-}
-//# sourceMappingURL=confirm.js.map

package/dist/cjs/ux/confirm.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"confirm.js","sourceRoot":"","sources":["../../../src/ux/confirm.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAO1C;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAe,EAAE,OAAwB;IACrE,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,KAAK,CAAC;IAChD,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAE5C,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,EAAE,CAAC,QAAQ,CAAC,GAAG,OAAO,IAAI,IAAI,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE;YAC5C,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC/C,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;gBACtB,OAAO,CAAC,UAAU,CAAC,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,KAAK,CAAC,CAAC;YACtD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cjs/ux/index.d.ts

@@ -1 +0,0 @@
-export { confirm, type ConfirmOptions } from './confirm.js';

package/dist/cjs/ux/index.js

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

package/dist/cjs/ux/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ux/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,OAAO,EAAsB,MAAM,cAAc,CAAC"}

package/dist/cjs/version.d.ts

@@ -1,14 +0,0 @@
-/**
- * The SDK package name.
- */
-export declare const SDK_NAME: string;
-/**
- * The SDK package version.
- */
-export declare const SDK_VERSION: string;
-/**
- * Default User-Agent string for the SDK.
- *
- * Format: `b2c-tooling-sdk/0.1.0`
- */
-export declare const SDK_USER_AGENT: string;

package/dist/cjs/version.js

@@ -1,29 +0,0 @@
-/*
- * 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
- */
-/**
- * SDK version information and User-Agent string.
- *
- * @module version
- */
-import { createRequire } from 'node:module';
-const require = createRequire(import.meta.url);
-// Use the package.json exports path to resolve correctly from both src/ and dist/
-const pkg = require('@salesforce/b2c-tooling-sdk/package.json');
-/**
- * The SDK package name.
- */
-export const SDK_NAME = pkg.name;
-/**
- * The SDK package version.
- */
-export const SDK_VERSION = pkg.version;
-/**
- * Default User-Agent string for the SDK.
- *
- * Format: `b2c-tooling-sdk/0.1.0`
- */
-export const SDK_USER_AGENT = `${SDK_NAME.replace(/^@salesforce\//, '')}/${SDK_VERSION}`;
-//# sourceMappingURL=version.js.map

package/dist/cjs/version.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;GAIG;AACH,OAAO,EAAC,aAAa,EAAC,MAAM,aAAa,CAAC;AAE1C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,kFAAkF;AAClF,MAAM,GAAG,GAAG,OAAO,CAAC,0CAA0C,CAAoC,CAAC;AAEnG;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC;AAEjC;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC;AAEvC;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC"}