@simplysf/simply-apex 1.6.9 → 1.6.10

package/lib/commands/simply/apex/trace/silence.js

@@ -16,58 +16,9 @@
 import { Messages } from '@salesforce/core';
 import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
 import { requireConnection, targetOrgFlags } from '@simplysf/simply-plugin-kit';
-import { loadJsonConfigSync } from '@simplysf/simply-core';
-import { ClassesToSilenceSchema } from '../../../../schemas/silence/classesToSilence.js';
+import { ApexTraceSilenceError, resolveClasses, silenceApexClasses, } from '../../../../common/apexTraceSilence.js';
 Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@simplysf/simply-apex', 'simply.apex.trace.silence');
-/** DeveloperName used for the fully-suppressed (NONE) debug level created for class silencing. */
-const DEBUG_LEVEL_NAME = 'Silence';
-/** How long a configured trace flag stays active before expiring, in milliseconds (24 hours). */
-const TRACE_DURATION_MS = 24 * 60 * 60 * 1000;
-/** Classes silenced by the `--fflib` flag. */
-const FFLIB_CLASSES = ['fflib_SObjectDescribe', 'fflib_SObjectDomain'];
-/** Classes silenced by the `--at4dx` flag. */
-const AT4DX_CLASSES = ['ApplicationSObjectDomain'];
-/** Classes silenced by the `--force-di` flag. */
-const FORCE_DI_CLASSES = ['di_Binding', 'di_Module', 'di_PlatformCache', 'di_Injector'];
-/**
- * Resolve the list of Apex class names to silence from the `--classes` flag (a comma-separated
- * list), the `--classes-file` flag (a JSON config file matching {@link ClassesToSilenceSchema}),
- * and the `--fflib`, `--at4dx`, and `--force-di` preset flags. All sources are combined and
- * deduplicated.
- *
- * @param classesFlag - The raw `--classes` flag value, if provided.
- * @param classesFileFlag - The raw `--classes-file` flag value, if provided.
- * @param presetFlags - Which of the built-in class presets were requested.
- * @returns The resolved, trimmed, deduplicated list of Apex class names.
- * @throws {SfError} If `--classes-file` was provided but fails schema validation.
- */
-function resolveClasses(classesFlag, classesFileFlag, presetFlags) {
-    const classes = [];
-    if (classesFlag) {
-        classes.push(...classesFlag
-            .split(',')
-            .map((className) => className.trim())
-            .filter(Boolean));
-    }
-    if (classesFileFlag) {
-        const parsed = loadJsonConfigSync(classesFileFlag, ClassesToSilenceSchema);
-        if (!parsed.success) {
-            throw messages.createError('error.invalidClassesFile', [parsed.message]);
-        }
-        classes.push(...parsed.data.classes);
-    }
-    if (presetFlags.fflib) {
-        classes.push(...FFLIB_CLASSES);
-    }
-    if (presetFlags.at4dx) {
-        classes.push(...AT4DX_CLASSES);
-    }
-    if (presetFlags.forceDi) {
-        classes.push(...FORCE_DI_CLASSES);
-    }
-    return [...new Set(classes)];
-}
 /**
  * Creates or updates a 24-hour CLASS_TRACING trace flag with a fully suppressed (NONE) debug
  * level for each specified Apex class, preventing those classes from generating debug log
@@ -117,118 +68,75 @@ export default class ApexTraceSilence extends SfCommand {
     async run() {
         const { flags } = await this.parse(ApexTraceSilence);
         const targetOrgConnection = requireConnection(flags);
-        const classes = resolveClasses(flags.classes, flags['classes-file'], {
-            fflib: flags.fflib,
-            at4dx: flags.at4dx,
-            forceDi: flags['force-di'],
-        });
+        const classNames = flags.classes
+            ? flags.classes
+                .split(',')
+                .map((className) => className.trim())
+                .filter(Boolean)
+            : [];
+        let classes;
+        try {
+            classes = resolveClasses(classNames, flags['classes-file'], {
+                fflib: flags.fflib,
+                at4dx: flags.at4dx,
+                forceDi: flags['force-di'],
+            });
+        }
+        catch (error) {
+            if (error instanceof ApexTraceSilenceError && error.code === 'invalid-classes-file') {
+                throw messages.createError('error.invalidClassesFile', [error.message]);
+            }
+            throw error;
+        }
         if (classes.length === 0) {
             throw messages.createError('error.noClassesSpecified');
         }
-        this.spinner.start(messages.getMessage('info.checkingDebugLevel'));
-        const debugLevelResult = await targetOrgConnection.tooling.query(`SELECT Id FROM DebugLevel WHERE DeveloperName = '${DEBUG_LEVEL_NAME}'`);
-        let debugLevelId;
-        if (debugLevelResult.records.length > 0) {
-            debugLevelId = debugLevelResult.records[0].Id;
-        }
-        else {
-            const createResult = await targetOrgConnection.tooling.sobject('DebugLevel').create({
-                DeveloperName: DEBUG_LEVEL_NAME,
-                MasterLabel: DEBUG_LEVEL_NAME,
-                ApexCode: 'NONE',
-                ApexProfiling: 'NONE',
-                Callout: 'NONE',
-                Database: 'NONE',
-                System: 'NONE',
-                Validation: 'NONE',
-                Visualforce: 'NONE',
-                Workflow: 'NONE',
+        let outcome;
+        try {
+            outcome = await silenceApexClasses(targetOrgConnection, classes, (phase) => {
+                switch (phase) {
+                    case 'checking-debug-level':
+                        this.spinner.start(messages.getMessage('info.checkingDebugLevel'));
+                        break;
+                    case 'finding-classes':
+                        this.spinner.stop();
+                        this.spinner.start(messages.getMessage('info.findingClasses'));
+                        break;
+                    case 'creating-trace-flags':
+                        this.spinner.stop();
+                        this.spinner.start(messages.getMessage('info.creatingTraceFlags'));
+                        break;
+                }
             });
-            if (!createResult.success) {
-                throw messages.createError('error.debugLevelCreateFailed', [
-                    createResult.errors.map((e) => e.message).join(', '),
-                ]);
+        }
+        catch (error) {
+            this.spinner.stop();
+            if (error instanceof ApexTraceSilenceError && error.code === 'debug-level-create-failed') {
+                throw messages.createError('error.debugLevelCreateFailed', [error.message]);
             }
-            debugLevelId = createResult.id;
+            throw error;
         }
         this.spinner.stop();
-        this.spinner.start(messages.getMessage('info.findingClasses'));
-        const classesClause = classes.map((className) => `'${className}'`).join(',');
-        const classResult = await targetOrgConnection.tooling.query(`SELECT Id, Name FROM ApexClass WHERE Name IN (${classesClause})`);
-        this.spinner.stop();
-        if (classResult.records.length === 0) {
+        if (outcome.results.length === 0 && outcome.missingClassNames.length === classes.length) {
             this.warn(messages.getMessage('warning.noClassesFound'));
             return [];
         }
-        const foundNames = new Set(classResult.records.map((record) => record.Name));
-        const missingNames = classes.filter((className) => !foundNames.has(className));
-        if (missingNames.length > 0) {
-            this.warn(messages.getMessage('warning.someClassesNotFound', [missingNames.join(', ')]));
+        if (outcome.missingClassNames.length > 0) {
+            this.warn(messages.getMessage('warning.someClassesNotFound', [outcome.missingClassNames.join(', ')]));
         }
-        const now = new Date();
-        const expiration = new Date(now.getTime() + TRACE_DURATION_MS);
-        const startDate = now.toISOString();
-        const expirationDate = expiration.toISOString();
-        const classIdsClause = classResult.records.map((record) => `'${record.Id}'`).join(',');
-        const existingTraceFlagResult = await targetOrgConnection.tooling.query(`SELECT Id, TracedEntityId FROM TraceFlag WHERE LogType = 'CLASS_TRACING' AND TracedEntityId IN (${classIdsClause})`);
-        const existingTraceFlagIdByClassId = new Map(existingTraceFlagResult.records.map((record) => [record.TracedEntityId, record.Id]));
-        const results = [];
-        this.spinner.start(messages.getMessage('info.creatingTraceFlags'));
-        for (const classRecord of classResult.records) {
-            const existingTraceFlagId = existingTraceFlagIdByClassId.get(classRecord.Id);
-            if (existingTraceFlagId) {
-                // eslint-disable-next-line no-await-in-loop
-                const updateResult = await targetOrgConnection.tooling.sobject('TraceFlag').update({
-                    Id: existingTraceFlagId,
-                    DebugLevelId: debugLevelId,
-                    StartDate: startDate,
-                    ExpirationDate: expirationDate,
-                });
-                if (!updateResult.success) {
-                    this.warn(messages.getMessage('warning.traceFlagUpdateFailed', [
-                        classRecord.Name,
-                        updateResult.errors.map((e) => e.message).join(', '),
-                    ]));
-                    continue;
-                }
-                results.push({
-                    class: classRecord.Name,
-                    classId: classRecord.Id,
-                    traceFlagId: existingTraceFlagId,
-                });
-                continue;
-            }
-            // eslint-disable-next-line no-await-in-loop
-            const createResult = await targetOrgConnection.tooling.sobject('TraceFlag').create({
-                StartDate: startDate,
-                ExpirationDate: expirationDate,
-                DebugLevelId: debugLevelId,
-                TracedEntityId: classRecord.Id,
-                LogType: 'CLASS_TRACING',
-            });
-            if (!createResult.success) {
-                this.warn(messages.getMessage('warning.traceFlagCreateFailed', [
-                    classRecord.Name,
-                    createResult.errors.map((e) => e.message).join(', '),
-                ]));
-                continue;
-            }
-            results.push({
-                class: classRecord.Name,
-                classId: classRecord.Id,
-                traceFlagId: createResult.id,
-            });
+        for (const failure of outcome.failures) {
+            const key = failure.action === 'update' ? 'warning.traceFlagUpdateFailed' : 'warning.traceFlagCreateFailed';
+            this.warn(messages.getMessage(key, [failure.class, failure.error]));
         }
-        this.spinner.stop();
         this.table({
-            data: results,
+            data: outcome.results,
             columns: [
                 { key: 'class', name: 'CLASS' },
                 { key: 'classId', name: 'CLASS ID' },
                 { key: 'traceFlagId', name: 'TRACE FLAG ID' },
             ],
         });
-        return results;
+        return outcome.results;
     }
 }
 //# sourceMappingURL=silence.js.map

package/lib/commands/simply/apex/trace/silence.js.map

@@ -1 +1 @@
-{"version":3,"file":"silence.js","sourceRoot":"","sources":["../../../../../src/commands/simply/apex/trace/silence.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"silence.js","sourceRoot":"","sources":["../../../../../src/commands/simply/apex/trace/silence.ts"],"names":[],"mappings":"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"}

package/lib/common/apexExecute.d.ts

@@ -0,0 +1,31 @@
+import type { Connection } from '@salesforce/core';
+/** Compile/execution outcome for an anonymous Apex execution, including any debug logs produced. */
+export type ApexExecuteResult = {
+    success: boolean;
+    compiled: boolean;
+    compileProblem: string;
+    exceptionMessage: string;
+    exceptionStackTrace: string;
+    line: number;
+    column: number;
+    logs?: string;
+};
+/** The error conditions `executeApex` signals structurally (via `code`) rather than by message text, so a `Messages`-based caller (the CLI) can map each one to its own error key without string-matching. */
+export type ApexExecuteErrorCode = 'compile-failed' | 'execute-failed';
+export declare class ApexExecuteError extends Error {
+    readonly code: ApexExecuteErrorCode;
+    readonly result: ApexExecuteResult;
+    constructor(code: ApexExecuteErrorCode, message: string, result: ApexExecuteResult);
+}
+/**
+ * Executes an anonymous block of Apex code from a local file against `connection` and returns the
+ * compile/execution result, including any debug logs produced.
+ *
+ * @param connection - The org connection to execute against.
+ * @param apexFilePath - Path to the local `.apex` file to execute.
+ * @returns The compile/execution result.
+ * @throws {ApexExecuteError} `compile-failed` if the Apex didn't compile, `execute-failed` if it
+ * compiled but threw during execution. Either way, `error.result` carries the full result so a
+ * caller can still inspect line/column/logs.
+ */
+export declare function executeApex(connection: Connection, apexFilePath: string): Promise<ApexExecuteResult>;

package/lib/common/apexExecute.js

@@ -0,0 +1,60 @@
+/*
+ * Copyright (c) 2026, Clay Chipps.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { ExecuteService } from '@salesforce/apex-node';
+export class ApexExecuteError extends Error {
+    code;
+    result;
+    constructor(code, message, result) {
+        super(message);
+        this.name = 'ApexExecuteError';
+        this.code = code;
+        this.result = result;
+    }
+}
+/**
+ * Executes an anonymous block of Apex code from a local file against `connection` and returns the
+ * compile/execution result, including any debug logs produced.
+ *
+ * @param connection - The org connection to execute against.
+ * @param apexFilePath - Path to the local `.apex` file to execute.
+ * @returns The compile/execution result.
+ * @throws {ApexExecuteError} `compile-failed` if the Apex didn't compile, `execute-failed` if it
+ * compiled but threw during execution. Either way, `error.result` carries the full result so a
+ * caller can still inspect line/column/logs.
+ */
+export async function executeApex(connection, apexFilePath) {
+    const executeService = new ExecuteService(connection);
+    const response = await executeService.executeAnonymous({ apexFilePath });
+    const diagnostic = response.diagnostic?.[0];
+    const result = {
+        success: response.success,
+        compiled: response.compiled,
+        compileProblem: diagnostic?.compileProblem ?? '',
+        exceptionMessage: diagnostic?.exceptionMessage ?? '',
+        exceptionStackTrace: diagnostic?.exceptionStackTrace ?? '',
+        line: diagnostic?.lineNumber ?? -1,
+        column: diagnostic?.columnNumber ?? -1,
+        logs: response.logs,
+    };
+    if (!response.compiled) {
+        throw new ApexExecuteError('compile-failed', `Compile failed at line ${result.line}, column ${result.column}: ${result.compileProblem}`, result);
+    }
+    if (!response.success) {
+        throw new ApexExecuteError('execute-failed', `Execution failed: ${result.exceptionMessage}`, result);
+    }
+    return result;
+}
+//# sourceMappingURL=apexExecute.js.map

package/lib/common/apexExecute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apexExecute.js","sourceRoot":"","sources":["../../src/common/apexExecute.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAiBvD,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzB,IAAI,CAAuB;IAC3B,MAAM,CAAoB;IAE1C,YAAmB,IAA0B,EAAE,OAAe,EAAE,MAAyB;QACvF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,UAAsB,EAAE,YAAoB;IAC5E,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,UAAU,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,gBAAgB,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;IAEzE,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;IAE5C,MAAM,MAAM,GAAsB;QAChC,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,cAAc,EAAE,UAAU,EAAE,cAAc,IAAI,EAAE;QAChD,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,IAAI,EAAE;QACpD,mBAAmB,EAAE,UAAU,EAAE,mBAAmB,IAAI,EAAE;QAC1D,IAAI,EAAE,UAAU,EAAE,UAAU,IAAI,CAAC,CAAC;QAClC,MAAM,EAAE,UAAU,EAAE,YAAY,IAAI,CAAC,CAAC;QACtC,IAAI,EAAE,QAAQ,CAAC,IAAI;KACpB,CAAC;IAEF,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACvB,MAAM,IAAI,gBAAgB,CACxB,gBAAgB,EAChB,0BAA0B,MAAM,CAAC,IAAI,YAAY,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,cAAc,EAAE,EAC1F,MAAM,CACP,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,IAAI,gBAAgB,CAAC,gBAAgB,EAAE,qBAAqB,MAAM,CAAC,gBAAgB,EAAE,EAAE,MAAM,CAAC,CAAC;IACvG,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/common/apexLogsPurge.d.ts

@@ -0,0 +1,34 @@
+import type { Connection } from '@salesforce/core';
+/** Outcome of deleting a single `ApexLog` record. */
+export type ApexLogsPurgeResult = {
+    Id: string;
+    Success: boolean;
+    Error?: string;
+};
+/** @returns Every `ApexLog` Id matched by `query` (a full SOQL statement), via the Tooling API, which returns them in a single response. */
+export declare function queryApexLogIdsViaRest(connection: Connection, query: string): Promise<string[]>;
+/**
+ * @returns Every `ApexLog` Id matched by `query` (a full SOQL statement), via a Bulk API v2 query
+ * job. The job streams CSV back, so the IDs are gathered from the record stream rather than a
+ * single response body.
+ */
+export declare function queryApexLogIdsViaBulkApi(connection: Connection, query: string, pollTimeout: number): Promise<string[]>;
+/**
+ * Deletes `ApexLog` records through the core connection's SObject Collections resource, 200
+ * records per call.
+ *
+ * Deliberately not `.tooling`: `ApexLog` is exposed on both APIs, but only core REST implements
+ * the Collections resource a bulk delete needs. `/tooling/composite/sobjects` does not exist and
+ * answers 404 "The requested resource does not exist".
+ *
+ * @param onChunkComplete - Called after each 200-record chunk is deleted, with the running total —
+ * a caller (the CLI) can use this to update a progress indicator. Optional; has no effect on the
+ * delete itself.
+ */
+export declare function deleteApexLogsViaCollections(connection: Connection, logIds: string[], onChunkComplete?: (purged: number, total: number) => void): Promise<ApexLogsPurgeResult[]>;
+/**
+ * Deletes `ApexLog` records through a Bulk API v2 ingest job. The whole set goes up as one job
+ * rather than in 200-record chunks, and the org processes it asynchronously without spending REST
+ * request limit.
+ */
+export declare function deleteApexLogsViaBulkApi(connection: Connection, logIds: string[], pollTimeout: number): Promise<ApexLogsPurgeResult[]>;

package/lib/common/apexLogsPurge.js

@@ -0,0 +1,100 @@
+/*
+ * Copyright (c) 2026, Clay Chipps.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { chunk } from '@simplysf/simply-core';
+/**
+ * Maximum number of `ApexLog` records to delete per SObject Collections call, which is the API's
+ * own ceiling and matches jsforce's `MAX_DML_COUNT`.
+ */
+const CHUNK_SIZE = 200;
+/** @returns Every `ApexLog` Id matched by `query` (a full SOQL statement), via the Tooling API, which returns them in a single response. */
+export async function queryApexLogIdsViaRest(connection, query) {
+    const queryResult = await connection.tooling.query(query);
+    return queryResult.records.map((record) => record.Id);
+}
+/**
+ * @returns Every `ApexLog` Id matched by `query` (a full SOQL statement), via a Bulk API v2 query
+ * job. The job streams CSV back, so the IDs are gathered from the record stream rather than a
+ * single response body.
+ */
+export async function queryApexLogIdsViaBulkApi(connection, query, pollTimeout) {
+    const recordStream = await connection.bulk2.query(query, { pollTimeout });
+    const logIds = [];
+    for await (const record of recordStream) {
+        const { Id: id } = record;
+        if (id) {
+            logIds.push(id);
+        }
+    }
+    return logIds;
+}
+/**
+ * Deletes `ApexLog` records through the core connection's SObject Collections resource, 200
+ * records per call.
+ *
+ * Deliberately not `.tooling`: `ApexLog` is exposed on both APIs, but only core REST implements
+ * the Collections resource a bulk delete needs. `/tooling/composite/sobjects` does not exist and
+ * answers 404 "The requested resource does not exist".
+ *
+ * @param onChunkComplete - Called after each 200-record chunk is deleted, with the running total —
+ * a caller (the CLI) can use this to update a progress indicator. Optional; has no effect on the
+ * delete itself.
+ */
+export async function deleteApexLogsViaCollections(connection, logIds, onChunkComplete) {
+    const results = [];
+    let purged = 0;
+    for (const idChunk of chunk(logIds, CHUNK_SIZE)) {
+        // eslint-disable-next-line no-await-in-loop -- batches are sequential so progress reporting tracks real progress
+        const deleteResults = await connection.delete('ApexLog', idChunk);
+        const deleteResultsArray = Array.isArray(deleteResults) ? deleteResults : [deleteResults];
+        deleteResultsArray.forEach((deleteResult, index) => {
+            results.push({
+                Id: deleteResult.id ?? idChunk[index] ?? 'unknown',
+                Success: deleteResult.success,
+                Error: deleteResult.success ? undefined : deleteResult.errors.map((e) => e.message).join(', '),
+            });
+        });
+        purged += idChunk.length;
+        onChunkComplete?.(purged, logIds.length);
+    }
+    return results;
+}
+/**
+ * Deletes `ApexLog` records through a Bulk API v2 ingest job. The whole set goes up as one job
+ * rather than in 200-record chunks, and the org processes it asynchronously without spending REST
+ * request limit.
+ */
+export async function deleteApexLogsViaBulkApi(connection, logIds, pollTimeout) {
+    const { successfulResults, failedResults } = await connection.bulk2.loadAndWaitForResults({
+        object: 'ApexLog',
+        operation: 'delete',
+        input: logIds.map((Id) => ({ Id })),
+        pollTimeout,
+    });
+    return [
+        ...successfulResults.map((result) => ({ Id: result.sf__Id, Success: true })),
+        ...failedResults.map((result) => {
+            // A failed row reports an empty (not absent) `sf__Id`; the submitted `Id` column is echoed
+            // back alongside it, so prefer that to keep every failure traceable to a specific log.
+            const submittedId = result.Id;
+            return {
+                Id: result.sf__Id.length > 0 ? result.sf__Id : (submittedId ?? 'unknown'),
+                Success: false,
+                Error: result.sf__Error,
+            };
+        }),
+    ];
+}
+//# sourceMappingURL=apexLogsPurge.js.map

package/lib/common/apexLogsPurge.js.map

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

package/lib/common/apexTraceSetup.d.ts

@@ -0,0 +1,57 @@
+import type { Connection } from '@salesforce/core';
+/** Matches the ISO 8601 date-time format `--start-date`/`--end-date` require. */
+export declare const DATE_TIME_PATTERN: RegExp;
+/**
+ * Matches `Field:Value` for `--on-behalf-of`. The field name is restricted to safe SOQL identifier
+ * characters since, unlike the value, it can't be quoted/escaped in the query.
+ */
+export declare const ON_BEHALF_OF_PATTERN: RegExp;
+/** A `Field:Value` pair identifying the user to configure the trace flag for. */
+export type OnBehalfOf = {
+    field: string;
+    value: string;
+};
+/** @returns `input` parsed as a `Field:Value` pair, or `undefined` if it doesn't match `ON_BEHALF_OF_PATTERN`. */
+export declare function parseOnBehalfOf(input: string): OnBehalfOf | undefined;
+export type ApexTraceSetupOptions = {
+    /** Field:Value pair identifying the target user. Defaults to the connection's own username. */
+    onBehalfOf?: OnBehalfOf;
+    /** DebugLevel DeveloperName to use. Defaults to (and, if absent, creates) `ReplayDebuggerLevels`. */
+    logLevel?: string;
+    /** ISO 8601 date-time. Defaults to now. */
+    startDate?: string;
+    /** ISO 8601 date-time. Defaults to 24 hours after `startDate`. */
+    endDate?: string;
+};
+/** IDs of the debug level and trace flag configured for the target user, and when it expires. */
+export type ApexTraceSetupResult = {
+    userId: string;
+    debugLevelId: string;
+    traceFlagId: string;
+    expirationDate: string;
+};
+/** The error conditions `setupApexTrace` signals structurally (via `code`) rather than by message text, so a `Messages`-based caller (the CLI) can map each one to its own error key without string-matching. */
+export type ApexTraceSetupErrorCode = 'user-not-found' | 'ambiguous-on-behalf-of' | 'debug-level-not-found' | 'debug-level-create-failed' | 'trace-flag-create-failed' | 'invalid-date-range';
+export declare class ApexTraceSetupError extends Error {
+    readonly code: ApexTraceSetupErrorCode;
+    /** The raw values a `Messages`-based caller needs to reproduce its own error text (e.g. `[userIdentifier]`, `[expirationDate, startDate]`) — not necessarily the same as `message`, which is this error's own human-readable text. */
+    readonly args: string[];
+    constructor(code: ApexTraceSetupErrorCode, message: string, args?: string[]);
+}
+/**
+ * Creates or updates a DEVELOPER_LOG trace flag for a target user. The target user is the one
+ * `connection` authenticates as by default, or the user identified by `options.onBehalfOf` if
+ * given. By default the trace flag uses the FINEST/FINER `ReplayDebuggerLevels` debug level
+ * suitable for the Apex Replay Debugger and runs for 24 hours starting now;
+ * `options.logLevel`/`startDate`/`endDate` override those defaults.
+ *
+ * @param connection - The org connection to configure the trace flag in.
+ * @param options - See `ApexTraceSetupOptions`.
+ * @param onPhase - Called as each of the three phases (finding the user, checking the debug
+ * level, configuring the trace flag) starts — a caller (the CLI) can use this to update a
+ * spinner. Optional; has no effect on the operation itself.
+ * @returns The IDs of the debug level and trace flag that were created or updated, and the trace
+ * flag's new expiration date.
+ * @throws {ApexTraceSetupError} See `ApexTraceSetupErrorCode`.
+ */
+export declare function setupApexTrace(connection: Connection, options?: ApexTraceSetupOptions, onPhase?: (phase: 'finding-user' | 'checking-debug-level' | 'configuring-trace-flag') => void): Promise<ApexTraceSetupResult>;