@simplysf/simply-apex 1.1.19 → 1.4.0

package/LICENSE.txt

@@ -1,6 +1,6 @@
 Apache License Version 2.0
 
-Copyright (c) 2026, Clay Chipps; Copyright (c) 2026 Salesforce, Inc.
+Copyright (c) 2026, Clay Chipps.
 All rights reserved.
 
                                  Apache License

package/README.md

@@ -31,7 +31,7 @@ Execute anonymous Apex code.
 
 ```
 USAGE
-  $ sf simply apex execute -f <value> -o <value> [--json] [--flags-dir <value>] [--api-version <value>]
+  $ sf simply apex execute -o <value> -f <value> [--json] [--flags-dir <value>] [--api-version <value>]
 
 FLAGS
   -f, --file=<value>         (required) Path to Apex file
@@ -58,7 +58,7 @@ FLAG DESCRIPTIONS
     The path to the local .apex file containing the anonymous Apex code to execute.
 ```
 
-_See code: [lib/commands/simply/apex/execute.js](https://github.com/SimplySF/simply-node/blob/@simplysf/simply-apex@1.1.10/packages/simply-apex/lib/commands/simply/apex/execute.js)_
+_See code: [lib/commands/simply/apex/execute.js](https://github.com/SimplySF/simply-node/blob/@simplysf/simply-apex@1.1.18/packages/simply-apex/lib/commands/simply/apex/execute.js)_
 
 ## `sf simply apex logs purge`
 
@@ -66,13 +66,16 @@ Purge Apex debug logs.
 
 ```
 USAGE
-  $ sf simply apex logs purge -o <value> [--json] [--flags-dir <value>] [--api-version <value>] [-w <value>]
+  $ sf simply apex logs purge -o <value> [--json] [--flags-dir <value>] [--api-version <value>] [-w <value>] [-b] [--wait
+    <value>]
 
 FLAGS
+  -b, --use-bulk-api         Use Bulk API v2 to query and delete the logs.
   -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
                              configuration variable is already set.
   -w, --where=<value>        SOQL WHERE clause
       --api-version=<value>  Override the api version used for api requests made by this command
+      --wait=<value>         Number of minutes to wait for the Bulk API jobs to finish.
 
 GLOBAL FLAGS
   --flags-dir=<value>  Import flag values from a directory.
@@ -89,42 +92,70 @@ EXAMPLES
 
   $ sf simply apex logs purge --target-org myOrg --where "Status = 'Success'"
 
+  $ sf simply apex logs purge --target-org myOrg --use-bulk-api
+
+  $ sf simply apex logs purge --target-org myOrg --use-bulk-api --wait 60
+
 FLAG DESCRIPTIONS
+  -b, --use-bulk-api  Use Bulk API v2 to query and delete the logs.
+
+    Runs the whole purge as two Bulk API v2 jobs instead of a Tooling API query followed by chunked REST deletes. Bulk
+    API processes the deletion asynchronously and does not consume the org's REST API request limit, which suits purges
+    of tens of thousands of logs. For small purges the default REST path is faster, since it avoids the overhead of
+    creating, uploading, and polling a job.
+
   -w, --where=<value>  SOQL WHERE clause
 
     A WHERE clause used to filter which ApexLog records are purged (e.g. "Status = 'Success'").
+
+  --wait=<value>  Number of minutes to wait for the Bulk API jobs to finish.
+
+    Only applies with --use-bulk-api. The command polls the query and delete jobs until they complete or this timeout
+    elapses, then throws.
 ```
 
-_See code: [lib/commands/simply/apex/logs/purge.js](https://github.com/SimplySF/simply-node/blob/@simplysf/simply-apex@1.1.10/packages/simply-apex/lib/commands/simply/apex/logs/purge.js)_
+_See code: [lib/commands/simply/apex/logs/purge.js](https://github.com/SimplySF/simply-node/blob/@simplysf/simply-apex@1.1.18/packages/simply-apex/lib/commands/simply/apex/logs/purge.js)_
 
 ## `sf simply apex trace setup`
 
-Configure a debug log trace flag for the current user.
+Configure a debug log trace flag for the current user, or another user.
 
 ```
 USAGE
-  $ sf simply apex trace setup -o <value> [--json] [--flags-dir <value>] [--api-version <value>]
+  $ sf simply apex trace setup -o <value> [--json] [--flags-dir <value>] [--api-version <value>] [--on-behalf-of
+    <value>]
 
 FLAGS
-  -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
-                             configuration variable is already set.
-      --api-version=<value>  Override the api version used for api requests made by this command
+  -o, --target-org=<value>    (required) Username or alias of the target org. Not required if the `target-org`
+                              configuration variable is already set.
+      --api-version=<value>   Override the api version used for api requests made by this command
+      --on-behalf-of=<value>  Configure the trace flag for another user, identified by a "Field:Value" pair.
 
 GLOBAL FLAGS
   --flags-dir=<value>  Import flag values from a directory.
   --json               Format output as json.
 
 DESCRIPTION
-  Configure a debug log trace flag for the current user.
+  Configure a debug log trace flag for the current user, or another user.
 
   Creates or updates a 24-hour DEVELOPER_LOG trace flag for the user running the command, using a FINEST/FINER debug
-  level suitable for the Apex Replay Debugger.
+  level suitable for the Apex Replay Debugger. Use --on-behalf-of to configure the trace flag for a different user
+  instead.
 
 EXAMPLES
   $ sf simply apex trace setup --target-org myOrg
+
+  $ sf simply apex trace setup --target-org myOrg --on-behalf-of Username:someuser@example.com
+
+  $ sf simply apex trace setup --target-org myOrg --on-behalf-of FederationIdentifier:123456
+
+FLAG DESCRIPTIONS
+  --on-behalf-of=<value>  Configure the trace flag for another user, identified by a "Field:Value" pair.
+
+    Any unique User field can be used, for example "Username:someuser@example.com" or "FederationIdentifier:123456".
 ```
 
-_See code: [lib/commands/simply/apex/trace/setup.js](https://github.com/SimplySF/simply-node/blob/@simplysf/simply-apex@1.1.10/packages/simply-apex/lib/commands/simply/apex/trace/setup.js)_
+_See code: [lib/commands/simply/apex/trace/setup.js](https://github.com/SimplySF/simply-node/blob/@simplysf/simply-apex@1.1.18/packages/simply-apex/lib/commands/simply/apex/trace/setup.js)_
 
 ## `sf simply apex trace silence`
 
@@ -168,21 +199,9 @@ FLAG DESCRIPTIONS
     silence.
 ```
 
-_See code: [lib/commands/simply/apex/trace/silence.js](https://github.com/SimplySF/simply-node/blob/@simplysf/simply-apex@1.1.10/packages/simply-apex/lib/commands/simply/apex/trace/silence.js)_
+_See code: [lib/commands/simply/apex/trace/silence.js](https://github.com/SimplySF/simply-node/blob/@simplysf/simply-apex@1.1.18/packages/simply-apex/lib/commands/simply/apex/trace/silence.js)_
 <!-- commandsstop -->
 
-## Configuration Files
-
-### `sf simply apex trace silence --classes-file`
-
-The `--classes-file` flag on `sf simply apex trace silence` takes the path to a JSON file listing which Apex classes to silence:
-
-```json
-{
-  "classes": ["AccountTriggerHandler", "NoisyBatchClass"]
-}
-```
+## License
 
-| Field     | Type       | Required | Description                                                                |
-| --------- | ---------- | -------- | -------------------------------------------------------------------------- |
-| `classes` | `string[]` | Yes      | One or more Apex class API names to silence. Must have at least one entry. |
+Licensed under the [Apache-2.0](https://raw.githubusercontent.com/SimplySF/simply-node/main/LICENSE.txt) license.

package/lib/commands/simply/apex/execute.js

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2026, Clay Chipps; Copyright (c) 2026 Salesforce, Inc.
+ * 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.

package/lib/commands/simply/apex/logs/purge.d.ts

@@ -1,3 +1,4 @@
+import { Duration } from '@salesforce/kit';
 import { SfCommand } from '@salesforce/sf-plugins-core';
 /** Outcome of deleting a single `ApexLog` record. */
 export type ApexLogsPurgeResult = {
@@ -15,6 +16,8 @@ export default class ApexLogsPurge extends SfCommand<ApexLogsPurgeResult[]> {
     static readonly examples: string[];
     static readonly flags: {
         where: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'use-bulk-api': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        wait: import("@oclif/core/interfaces").OptionFlag<Duration, import("@oclif/core/interfaces").CustomOptions>;
         'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined>;
         'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org>;
         'flags-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
@@ -24,4 +27,12 @@ export default class ApexLogsPurge extends SfCommand<ApexLogsPurgeResult[]> {
      * filter.
      */
     run(): Promise<ApexLogsPurgeResult[]>;
+    /**
+     * Deletes 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".
+     */
+    private deleteViaCollections;
 }

package/lib/commands/simply/apex/logs/purge.js

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2026, Clay Chipps; Copyright (c) 2026 Salesforce, Inc.
+ * 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.
@@ -14,6 +14,7 @@
  * limitations under the License.
  */
 import { Messages } from '@salesforce/core';
+import { Duration } from '@salesforce/kit';
 import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
 import { requireConnection, targetOrgFlags } from '@simplysf/simply-plugin-kit';
 import { chunk } from '@simplysf/simply-core';
@@ -40,6 +41,19 @@ export default class ApexLogsPurge extends SfCommand {
             description: messages.getMessage('flags.where.description'),
             char: 'w',
         }),
+        'use-bulk-api': Flags.boolean({
+            summary: messages.getMessage('flags.use-bulk-api.summary'),
+            description: messages.getMessage('flags.use-bulk-api.description'),
+            char: 'b',
+            default: false,
+        }),
+        wait: Flags.duration({
+            unit: 'minutes',
+            summary: messages.getMessage('flags.wait.summary'),
+            description: messages.getMessage('flags.wait.description'),
+            // jsforce defaults bulk polling to 30 seconds, which no real purge finishes within.
+            default: Duration.minutes(30),
+        }),
     };
     /**
      * @returns The delete outcome for every `ApexLog` record matched by the (optional) `--where`
@@ -48,39 +62,25 @@ export default class ApexLogsPurge extends SfCommand {
     async run() {
         const { flags } = await this.parse(ApexLogsPurge);
         const targetOrgConnection = requireConnection(flags);
+        const useBulkApi = flags['use-bulk-api'];
+        const pollTimeout = flags.wait.milliseconds;
         let query = 'SELECT Id FROM ApexLog';
         if (flags.where) {
             query += ` WHERE ${flags.where}`;
         }
         this.spinner.start(messages.getMessage('info.queryingLogs'));
-        const queryResult = await targetOrgConnection.tooling.query(query);
+        const logIds = useBulkApi
+            ? await queryLogIdsViaBulkApi(targetOrgConnection, query, pollTimeout)
+            : await queryLogIdsViaRest(targetOrgConnection, query);
         this.spinner.stop();
-        if (queryResult.records.length === 0) {
+        if (logIds.length === 0) {
             this.info(messages.getMessage('info.noLogsToPurge'));
             return [];
         }
-        const logIds = queryResult.records.map((record) => record.Id);
-        const results = [];
         this.spinner.start(messages.getMessage('info.purgingLogs', [logIds.length]));
-        let purged = 0;
-        for (const idChunk of chunk(logIds, CHUNK_SIZE)) {
-            purged += idChunk.length;
-            this.spinner.status = `${purged}/${logIds.length}`;
-            // Deleted through the core connection, not `.tooling`. ApexLog is exposed on both APIs, but
-            // only core REST implements the SObject Collections resource that a bulk delete needs;
-            // `/tooling/composite/sobjects` does not exist and answers 404 "The requested resource does
-            // not exist". The records were queried via the Tooling API, which returns the same IDs.
-            // eslint-disable-next-line no-await-in-loop -- batches are sequential so the spinner tracks real progress
-            const deleteResults = await targetOrgConnection.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(', '),
-                });
-            });
-        }
+        const results = useBulkApi
+            ? await deleteViaBulkApi(targetOrgConnection, logIds, pollTimeout)
+            : await this.deleteViaCollections(targetOrgConnection, logIds);
         this.spinner.stop();
         const successCount = results.filter((result) => result.Success).length;
         const failureCount = results.length - successCount;
@@ -100,5 +100,76 @@ export default class ApexLogsPurge extends SfCommand {
         });
         return results;
     }
+    /**
+     * Deletes 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".
+     */
+    async deleteViaCollections(connection, logIds) {
+        const results = [];
+        let purged = 0;
+        for (const idChunk of chunk(logIds, CHUNK_SIZE)) {
+            purged += idChunk.length;
+            this.spinner.status = `${purged}/${logIds.length}`;
+            // eslint-disable-next-line no-await-in-loop -- batches are sequential so the spinner 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(', '),
+                });
+            });
+        }
+        return results;
+    }
+}
+/** Collects matching log IDs through the Tooling API, which returns them in a single response. */
+async function queryLogIdsViaRest(connection, query) {
+    const queryResult = await connection.tooling.query(query);
+    return queryResult.records.map((record) => record.Id);
+}
+/**
+ * Collects matching log IDs through 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.
+ */
+async function queryLogIdsViaBulkApi(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 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.
+ */
+async function deleteViaBulkApi(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=purge.js.map

package/lib/commands/simply/apex/logs/purge.js.map

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

package/lib/commands/simply/apex/trace/setup.d.ts

@@ -1,5 +1,10 @@
 import { SfCommand } from '@salesforce/sf-plugins-core';
-/** IDs of the debug level and trace flag configured for the running user, and when it expires. */
+/** A `Field:Value` pair identifying the user to configure the trace flag for. */
+type OnBehalfOf = {
+    field: string;
+    value: 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;
@@ -7,14 +12,21 @@ export type ApexTraceSetupResult = {
     expirationDate: string;
 };
 /**
- * Creates or updates a 24-hour DEVELOPER_LOG trace flag for the user running the command, using
- * a FINEST/FINER debug level suitable for the Apex Replay Debugger.
+ * Creates or updates a DEVELOPER_LOG trace flag for the target user. The target user is the one
+ * running the command by default, or the user identified by `--on-behalf-of` if provided. 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; `--log-level`, `--start-date`, and
+ * `--end-date` override those defaults.
  */
 export default class ApexTraceSetup extends SfCommand<ApexTraceSetupResult> {
     static readonly summary: string;
     static readonly description: string;
     static readonly examples: string[];
     static readonly flags: {
+        'on-behalf-of': import("@oclif/core/interfaces").OptionFlag<OnBehalfOf | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'log-level': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'start-date': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'end-date': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined>;
         'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org>;
         'flags-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
@@ -25,3 +37,4 @@ export default class ApexTraceSetup extends SfCommand<ApexTraceSetupResult> {
      */
     run(): Promise<ApexTraceSetupResult>;
 }
+export {};

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

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2026, Clay Chipps; Copyright (c) 2026 Salesforce, Inc.
+ * 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.
@@ -14,17 +14,28 @@
  * limitations under the License.
  */
 import { Messages } from '@salesforce/core';
-import { SfCommand } from '@salesforce/sf-plugins-core';
+import { Flags, SfCommand } from '@salesforce/sf-plugins-core';
 import { requireConnection, targetOrgFlags } from '@simplysf/simply-plugin-kit';
+import { escapeSoqlLiteral } from '@simplysf/simply-core';
 Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@simplysf/simply-apex', 'simply.apex.trace.setup');
 /** DeveloperName used for the FINEST/FINER debug level created for the Apex Replay Debugger. */
 const DEBUG_LEVEL_NAME = 'ReplayDebuggerLevels';
 /** How long a configured trace flag stays active before expiring, in milliseconds (24 hours). */
 const TRACE_DURATION_MS = 24 * 60 * 60 * 1000;
+/** Matches the ISO 8601 date-time format required by the `--start-date`/`--end-date` flags. */
+const DATE_TIME_PATTERN = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?Z$/;
 /**
- * Creates or updates a 24-hour DEVELOPER_LOG trace flag for the user running the command, using
- * a FINEST/FINER debug level suitable for the Apex Replay Debugger.
+ * 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.
+ */
+const ON_BEHALF_OF_PATTERN = /^([A-Za-z_][A-Za-z0-9_]*):(.+)$/;
+/**
+ * Creates or updates a DEVELOPER_LOG trace flag for the target user. The target user is the one
+ * running the command by default, or the user identified by `--on-behalf-of` if provided. 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; `--log-level`, `--start-date`, and
+ * `--end-date` override those defaults.
  */
 export default class ApexTraceSetup extends SfCommand {
     static summary = messages.getMessage('summary');
@@ -33,6 +44,46 @@ export default class ApexTraceSetup extends SfCommand {
     static flags = {
         ...SfCommand.baseFlags,
         ...targetOrgFlags,
+        'on-behalf-of': Flags.custom({
+            // eslint-disable-next-line @typescript-eslint/require-await
+            parse: async (input) => {
+                const match = ON_BEHALF_OF_PATTERN.exec(input);
+                if (!match) {
+                    throw messages.createError('error.invalidOnBehalfOf', [input]);
+                }
+                const [, field, value] = match;
+                return { field, value };
+            },
+        })({
+            summary: messages.getMessage('flags.on-behalf-of.summary'),
+            description: messages.getMessage('flags.on-behalf-of.description'),
+        }),
+        'log-level': Flags.string({
+            summary: messages.getMessage('flags.log-level.summary'),
+            description: messages.getMessage('flags.log-level.description'),
+        }),
+        'start-date': Flags.string({
+            summary: messages.getMessage('flags.start-date.summary'),
+            description: messages.getMessage('flags.start-date.description'),
+            // eslint-disable-next-line @typescript-eslint/require-await
+            parse: async (input) => {
+                if (!DATE_TIME_PATTERN.test(input)) {
+                    throw messages.createError('error.invalidDateTime', ['start-date', input]);
+                }
+                return input;
+            },
+        }),
+        'end-date': Flags.string({
+            summary: messages.getMessage('flags.end-date.summary'),
+            description: messages.getMessage('flags.end-date.description'),
+            // eslint-disable-next-line @typescript-eslint/require-await
+            parse: async (input) => {
+                if (!DATE_TIME_PATTERN.test(input)) {
+                    throw messages.createError('error.invalidDateTime', ['end-date', input]);
+                }
+                return input;
+            },
+        }),
     };
     /**
      * @returns The IDs of the debug level and trace flag that were created or updated, and the
@@ -41,20 +92,31 @@ export default class ApexTraceSetup extends SfCommand {
     async run() {
         const { flags } = await this.parse(ApexTraceSetup);
         const targetOrgConnection = requireConnection(flags);
+        const onBehalfOf = flags['on-behalf-of'];
+        const userFilterField = onBehalfOf?.field ?? 'Username';
+        const userFilterValue = onBehalfOf?.value ?? targetOrgConnection.getUsername() ?? '';
+        const userIdentifier = onBehalfOf ? `${onBehalfOf.field}:${onBehalfOf.value}` : userFilterValue;
         this.spinner.start(messages.getMessage('info.findingUser'));
-        const username = targetOrgConnection.getUsername() ?? '';
-        const userQueryResult = await targetOrgConnection.query(`SELECT Id FROM User WHERE Username = '${username}'`);
+        const userQueryResult = await targetOrgConnection.query(`SELECT Id FROM User WHERE ${userFilterField} = '${escapeSoqlLiteral(userFilterValue)}' LIMIT 2`);
         if (userQueryResult.records.length === 0) {
-            throw messages.createError('error.userNotFound', [username]);
+            throw messages.createError('error.userNotFound', [userIdentifier]);
+        }
+        if (userQueryResult.records.length > 1) {
+            throw messages.createError('error.ambiguousOnBehalfOf', [userIdentifier]);
         }
         const userId = userQueryResult.records[0].Id;
         this.spinner.stop();
+        const requestedLogLevel = flags['log-level'];
+        const debugLevelName = requestedLogLevel ?? DEBUG_LEVEL_NAME;
         this.spinner.start(messages.getMessage('info.checkingDebugLevel'));
-        const debugLevelResult = await targetOrgConnection.tooling.query(`SELECT Id FROM DebugLevel WHERE DeveloperName = '${DEBUG_LEVEL_NAME}'`);
+        const debugLevelResult = await targetOrgConnection.tooling.query(`SELECT Id FROM DebugLevel WHERE DeveloperName = '${debugLevelName}'`);
         let debugLevelId;
         if (debugLevelResult.records.length > 0) {
             debugLevelId = debugLevelResult.records[0].Id;
         }
+        else if (requestedLogLevel) {
+            throw messages.createError('error.debugLevelNotFound', [debugLevelName]);
+        }
         else {
             const createResult = await targetOrgConnection.tooling.sobject('DebugLevel').create({
                 DeveloperName: DEBUG_LEVEL_NAME,
@@ -72,10 +134,11 @@ export default class ApexTraceSetup extends SfCommand {
         this.spinner.stop();
         this.spinner.start(messages.getMessage('info.configuringTraceFlag'));
         const traceFlagResult = await targetOrgConnection.tooling.query(`SELECT Id FROM TraceFlag WHERE LogType = 'DEVELOPER_LOG' AND TracedEntityId = '${userId}'`);
-        const now = new Date();
-        const expiration = new Date(now.getTime() + TRACE_DURATION_MS);
-        const startDate = now.toISOString();
-        const expirationDate = expiration.toISOString();
+        const startDate = flags['start-date'] ?? new Date().toISOString();
+        const expirationDate = flags['end-date'] ?? new Date(new Date(startDate).getTime() + TRACE_DURATION_MS).toISOString();
+        if (new Date(expirationDate).getTime() <= new Date(startDate).getTime()) {
+            throw messages.createError('error.invalidDateRange', [expirationDate, startDate]);
+        }
         let traceFlagId;
         if (traceFlagResult.records.length > 0) {
             traceFlagId = traceFlagResult.records[0].Id;

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

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

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

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2026, Clay Chipps; Copyright (c) 2026 Salesforce, Inc.
+ * 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.

package/lib/index.js

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2026, Clay Chipps; Copyright (c) 2026 Salesforce, Inc.
+ * 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.

package/lib/schemas/silence/classesToSilence.js

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2026, Clay Chipps; Copyright (c) 2026 Salesforce, Inc.
+ * 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.

package/messages/simply.apex.logs.purge.md

@@ -14,12 +14,32 @@ SOQL WHERE clause
 
 A WHERE clause used to filter which ApexLog records are purged (e.g. "Status = 'Success'").
 
+# flags.use-bulk-api.summary
+
+Use Bulk API v2 to query and delete the logs.
+
+# flags.use-bulk-api.description
+
+Runs the whole purge as two Bulk API v2 jobs instead of a Tooling API query followed by chunked REST deletes. Bulk API processes the deletion asynchronously and does not consume the org's REST API request limit, which suits purges of tens of thousands of logs. For small purges the default REST path is faster, since it avoids the overhead of creating, uploading, and polling a job.
+
+# flags.wait.summary
+
+Number of minutes to wait for the Bulk API jobs to finish.
+
+# flags.wait.description
+
+Only applies with --use-bulk-api. The command polls the query and delete jobs until they complete or this timeout elapses, then throws.
+
 # examples
 
 - <%= config.bin %> <%= command.id %> --target-org myOrg
 
 - <%= config.bin %> <%= command.id %> --target-org myOrg --where "Status = 'Success'"
 
+- <%= config.bin %> <%= command.id %> --target-org myOrg --use-bulk-api
+
+- <%= config.bin %> <%= command.id %> --target-org myOrg --use-bulk-api --wait 60
+
 # info.queryingLogs
 
 Querying Apex logs...

package/messages/simply.apex.trace.setup.md

@@ -1,18 +1,76 @@
 # summary
 
-Configure a debug log trace flag for the current user.
+Configure a debug log trace flag for the current user, or another user.
 
 # description
 
-Creates or updates a 24-hour DEVELOPER_LOG trace flag for the user running the command, using a FINEST/FINER debug level suitable for the Apex Replay Debugger.
+Creates or updates a DEVELOPER_LOG trace flag for the target user, using the FINEST/FINER "ReplayDebuggerLevels" debug level suitable for the Apex Replay Debugger and running for 24 hours starting now, by default. Use --on-behalf-of to configure the trace flag for a different user instead; --log-level, --start-date, and --end-date override the other defaults.
+
+# flags.on-behalf-of.summary
+
+Configure the trace flag for another user, identified by a "Field:Value" pair.
+
+# flags.on-behalf-of.description
+
+Any unique User field can be used, for example "Username:someuser@example.com" or "FederationIdentifier:123456".
+
+# flags.log-level.summary
+
+Developer name of an existing debug level to use for the trace flag.
+
+# flags.log-level.description
+
+Must already exist in the org; it's looked up but never created or modified. Defaults to the "ReplayDebuggerLevels" debug level, which is created automatically if it doesn't exist.
+
+# flags.start-date.summary
+
+Start date/time of the trace flag, as an ISO 8601 date-time.
+
+# flags.start-date.description
+
+Defaults to the current date/time.
+
+# flags.end-date.summary
+
+Expiration date/time of the trace flag, as an ISO 8601 date-time.
+
+# flags.end-date.description
+
+Defaults to 24 hours after the start date/time.
 
 # examples
 
 - <%= config.bin %> <%= command.id %> --target-org myOrg
 
+- <%= config.bin %> <%= command.id %> --target-org myOrg --on-behalf-of Username:someuser@example.com
+
+- <%= config.bin %> <%= command.id %> --target-org myOrg --on-behalf-of FederationIdentifier:123456
+
+- <%= config.bin %> <%= command.id %> --target-org myOrg --log-level MyCustomDebugLevel --start-date 2026-08-18T09:00:00Z --end-date 2026-08-19T09:00:00Z
+
+# error.invalidOnBehalfOf
+
+Invalid --on-behalf-of value: %s. Expected a "Field:Value" pair, for example "Username:someuser@example.com".
+
 # error.userNotFound
 
-User not found for username: %s
+User not found for %s
+
+# error.ambiguousOnBehalfOf
+
+Multiple users found for %s. Use a field/value pair that uniquely identifies one user.
+
+# error.debugLevelNotFound
+
+No debug level found with developer name: %s
+
+# error.invalidDateTime
+
+Invalid value for --%s: "%s". Expected an ISO 8601 date-time (e.g., 2026-08-18T14:30:00Z).
+
+# error.invalidDateRange
+
+--end-date (%s) must be after --start-date (%s).
 
 # error.debugLevelCreateFailed
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@simplysf/simply-apex",
   "description": "Utilities for working with Apex",
-  "version": "1.1.19",
+  "version": "1.4.0",
   "author": "@ClayChipps",
   "homepage": "https://github.com/SimplySF/simply-node",
   "bugs": "https://github.com/SimplySF/simply-node/issues",
@@ -69,8 +69,8 @@
     "@salesforce/core": "^8.30.0",
     "@salesforce/kit": "^3.2.6",
     "@salesforce/sf-plugins-core": "^12.2.16",
-    "@simplysf/simply-core": "^1.1.13",
-    "@simplysf/simply-plugin-kit": "^1.0.1",
+    "@simplysf/simply-core": "^1.1.17",
+    "@simplysf/simply-plugin-kit": "^1.0.4",
     "zod": "^4.1.12"
   },
   "devDependencies": {
@@ -92,7 +92,7 @@
     "readme": "oclif readme --no-aliases",
     "test": "wireit",
     "test:coverage": "vitest run --coverage --project simply-apex",
-    "test:nuts": "vitest run --config vitest.nuts.config.ts --project simply-apex",
+    "test:nuts": "vitest run --config ../../vitest.nuts.config.ts --project simply-apex",
     "test:only": "wireit",
     "test:watch": "vitest watch --project simply-apex"
   },
@@ -217,5 +217,5 @@
       "output": []
     }
   },
-  "gitHead": "b6604fc398051fa2f92ad8223dd8e214ba9e4988"
+  "gitHead": "c1134ddedb7cd88cfdd28e5e9596c2d28028b2f3"
 }