@simplysf/simply-apex 1.1.19 → 1.2.0

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,13 +92,29 @@ 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`
 
@@ -124,7 +143,7 @@ EXAMPLES
   $ sf simply apex trace setup --target-org myOrg
 ```
 
-_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 +187,5 @@ 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"]
-}
-```
-
-| Field     | Type       | Required | Description                                                                |
-| --------- | ---------- | -------- | -------------------------------------------------------------------------- |
-| `classes` | `string[]` | Yes      | One or more Apex class API names to silence. Must have at least one entry. |

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

@@ -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":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAChF,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAG9C,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,uBAAuB,EAAE,wBAAwB,CAAC,CAAC;AAS1F;;;GAGG;AACH,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,SAAgC;IAClE,MAAM,CAAU,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,CAAU,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,CAAU,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAE5D,MAAM,CAAU,KAAK,GAAG;QAC7B,GAAG,SAAS,CAAC,SAAS;QACtB,GAAG,cAAc;QACjB,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC;YAClB,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,qBAAqB,CAAC;YACnD,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,yBAAyB,CAAC;YAC3D,IAAI,EAAE,GAAG;SACV,CAAC;QACF,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC;YAC5B,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,4BAA4B,CAAC;YAC1D,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,gCAAgC,CAAC;YAClE,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,KAAK;SACf,CAAC;QACF,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC;YACnB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,oBAAoB,CAAC;YAClD,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,wBAAwB,CAAC;YAC1D,oFAAoF;YACpF,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;SAC9B,CAAC;KACH,CAAC;IAEF;;;OAGG;IACI,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAElD,MAAM,mBAAmB,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACrD,MAAM,UAAU,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC;QACzC,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC;QAE5C,IAAI,KAAK,GAAG,wBAAwB,CAAC;QACrC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,KAAK,IAAI,UAAU,KAAK,CAAC,KAAK,EAAE,CAAC;QACnC,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,UAAU;YACvB,CAAC,CAAC,MAAM,qBAAqB,CAAC,mBAAmB,EAAE,KAAK,EAAE,WAAW,CAAC;YACtE,CAAC,CAAC,MAAM,kBAAkB,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;QACzD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAEpB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC,CAAC;YACrD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAE7E,MAAM,OAAO,GAAG,UAAU;YACxB,CAAC,CAAC,MAAM,gBAAgB,CAAC,mBAAmB,EAAE,MAAM,EAAE,WAAW,CAAC;YAClE,CAAC,CAAC,MAAM,IAAI,CAAC,oBAAoB,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;QAEjE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAEpB,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QACvE,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,YAAY,CAAC;QAEnD,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;QACrF,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,CAAC,KAAK,CAAC;YACT,IAAI,EAAE,OAAO;YACb,OAAO,EAAE;gBACP,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;gBACzB,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;gBACnC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE;aAChC;SACF,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,oBAAoB,CAAC,UAAsB,EAAE,MAAgB;QACzE,MAAM,OAAO,GAA0B,EAAE,CAAC;QAC1C,IAAI,MAAM,GAAG,CAAC,CAAC;QAEf,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAEnD,0GAA0G;YAC1G,MAAM,aAAa,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAClE,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;YAE1F,kBAAkB,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,KAAK,EAAE,EAAE;gBACjD,OAAO,CAAC,IAAI,CAAC;oBACX,EAAE,EAAE,YAAY,CAAC,EAAE,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS;oBAClD,OAAO,EAAE,YAAY,CAAC,OAAO;oBAC7B,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;iBAC/F,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;;AAGH,kGAAkG;AAClG,KAAK,UAAU,kBAAkB,CAAC,UAAsB,EAAE,KAAa;IACrE,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,KAAK,CAAiB,KAAK,CAAC,CAAC;IAC1E,OAAO,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,qBAAqB,CAAC,UAAsB,EAAE,KAAa,EAAE,WAAmB;IAC7F,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;QACxC,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,MAAyB,CAAC;QAC7C,IAAI,EAAE,EAAE,CAAC;YACP,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,gBAAgB,CAC7B,UAAsB,EACtB,MAAgB,EAChB,WAAmB;IAEnB,MAAM,EAAE,iBAAiB,EAAE,aAAa,EAAE,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,qBAAqB,CAAC;QACxF,MAAM,EAAE,SAAS;QACjB,SAAS,EAAE,QAAQ;QACnB,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACnC,WAAW;KACZ,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5E,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YAC9B,2FAA2F;YAC3F,uFAAuF;YACvF,MAAM,WAAW,GAAI,MAA0B,CAAC,EAAE,CAAC;YACnD,OAAO;gBACL,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,SAAS,CAAC;gBACzE,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,MAAM,CAAC,SAAS;aACxB,CAAC;QACJ,CAAC,CAAC;KACH,CAAC;AACJ,CAAC"}

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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@simplysf/simply-apex",
   "description": "Utilities for working with Apex",
-  "version": "1.1.19",
+  "version": "1.2.0",
   "author": "@ClayChipps",
   "homepage": "https://github.com/SimplySF/simply-node",
   "bugs": "https://github.com/SimplySF/simply-node/issues",
@@ -217,5 +217,5 @@
       "output": []
     }
   },
-  "gitHead": "b6604fc398051fa2f92ad8223dd8e214ba9e4988"
+  "gitHead": "fb8e9c1bdde7948f51b8d46fd0727a140bcf5470"
 }