sf-debug-log 0.2.5 → 0.3.0

package/README.md

@@ -19,6 +19,181 @@ sf plugins install sf-debug-log
 
 ## Commands
 <!-- commands -->
+* [`sf debug delete`](#sf-debug-delete)
+* [`sf debug retrieve`](#sf-debug-retrieve)
+* [`sf debuglevel list`](#sf-debuglevel-list)
+* [`sf debuglevel new`](#sf-debuglevel-new)
+* [`sf trace new`](#sf-trace-new)
+
+## `sf debug delete`
+
+Delete Apex log files from a Salesforce org.
+
+```
+USAGE
+  $ sf debug delete -o <value> [--json] [--flags-dir <value>] [--api-version <value>] [-u <value>] [-t <value>]
+    [-a]
+
+FLAGS
+  -a, --all-users               Retrieve logs for all users in the org.
+  -o, --targetusername=<value>  (required) Username or alias of the target Salesforce org.
+  -t, --time=<value>            Delete logs older than the specified number of minutes.
+  -u, --user=<value>            [default: targetusername] Username, Name, or ID of the user for whom you want to delete
+                                the logs.
+      --api-version=<value>     [default: 65.0] API version to use.
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Delete Apex log files from a Salesforce org.
+
+  Deletes Apex log files from a Salesforce org.
+
+EXAMPLES
+  $ sf debug delete -u "Raffaele Preziosi" -t 60
+
+FLAG DESCRIPTIONS
+  --api-version=<value>  API version to use.
+
+    Override the api version used for api requests made by this command
+```
+
+## `sf debug retrieve`
+
+Retrieve Apex log files from the Salesforce platform.
+
+```
+USAGE
+  $ sf debug retrieve -o <value> [--json] [--flags-dir <value>] [--api-version <value>] [-q <value> | [-u <value> |
+    -a] | -t <value> | -l <value> | ] [-d <value>]
+
+FLAGS
+  -a, --all-users               Retrieve logs for all users in the org.
+  -d, --folder=<value>          The folder where the retrieved log files will be stored. If omitted, the selected logs
+                                are streamed to stdout.
+  -l, --limit=<value>           [default: 100] The max number of log files to retrieve.
+  -o, --targetusername=<value>  (required) Username or alias of the target Salesforce org.
+  -q, --query=<value>           SOQL query used to select `ApexLog` records to retrieve. This flag can't be used with
+                                `--user`, `--time`, `--limit`, or `--all-users`.
+  -t, --time=<value>            Retrieve logs created in the last specified number of minutes.
+  -u, --user=<value>            [default: targetusername] Username, Name, or ID of the user for whom you want to
+                                retrieve the logs.
+      --api-version=<value>     [default: 65.0] API version to use.
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Retrieve Apex log files from the Salesforce platform.
+
+  This command allows you to retrieve Apex log files from a Salesforce org. If you don't specify `--folder`, the log
+  contents are streamed to stdout.
+
+EXAMPLES
+  $ sf debug retrieve -o MyDeveloperEdition -u "Raffaele Preziosi" -t 10
+  $ sf debug retrieve -o MyDeveloperEdition -q "SELECT Id FROM ApexLog ORDER BY SystemModstamp DESC LIMIT 1" | rg "EXCEPTION"
+
+FLAG DESCRIPTIONS
+  --api-version=<value>  API version to use.
+
+    Override the api version used for api requests made by this command
+```
+
+## `sf debuglevel list`
+
+List the debug levels in your org.
+
+```
+USAGE
+  $ sf debuglevel list -o <value> [--json] [--flags-dir <value>] [--api-version <value>]
+
+FLAGS
+  -o, --targetusername=<value>  (required) Username or alias of the target Salesforce org.
+      --api-version=<value>     [default: 65.0] API version to use.
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  List the debug levels in your org.
+
+  List the debug levels in your org.
+
+EXAMPLES
+  $ sf debuglevel list -o MyDeveloperEdition
+
+FLAG DESCRIPTIONS
+  --api-version=<value>  API version to use.
+
+    Override the api version used for api requests made by this command
+```
+
+## `sf debuglevel new`
+
+Create a new DebugLevel.
+
+```
+USAGE
+  $ sf debuglevel new -o <value> -n <value> [--json] [--flags-dir <value>] [--api-version <value>]
+
+FLAGS
+  -n, --developername=<value>   (required) The developer name of the new DebugLevel.
+  -o, --targetusername=<value>  (required) Username or alias of the target Salesforce org.
+      --api-version=<value>     [default: 65.0] API version to use.
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Create a new DebugLevel.
+
+  Create a new DebugLevel assigning level for each category.
+
+EXAMPLES
+  $ sf debuglevel new
+
+FLAG DESCRIPTIONS
+  --api-version=<value>  API version to use.
+
+    Override the api version used for api requests made by this command
+```
+
+## `sf trace new`
+
+Create a trace flag for a user.
+
+```
+USAGE
+  $ sf trace new -o <value> [--json] [--flags-dir <value>] [--api-version <value>] [-u <value>] [-t <value>]
+    [-f] [-d <value>]
+
+FLAGS
+  -d, --debuglevel=<value>      [default: SFDC_DevConsole] The debug level for the trace flag.
+  -f, --force                   Force the creation of the trace flag.
+  -o, --targetusername=<value>  (required) Username or alias of the target Salesforce org.
+  -t, --time=<value>            [default: 60] The time for the trace flag.
+  -u, --user=<value>            [default: targetusername] Username, Name, or ID of the user for whom you want to
+                                retrieve the logs.
+      --api-version=<value>     [default: 65.0] API version to use.
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+EXAMPLES
+  $ sf trace new -o MyDeveloperEdition -u "Raffaele Preziosi" -t 10
+
+FLAG DESCRIPTIONS
+  --api-version=<value>  API version to use.
+
+    Override the api version used for api requests made by this command
+```
+<!-- commandsstop -->
 - [`sf trace new`](#sf-trace-new)
 - [`sf debug retrieve`](#sf-debug-retrieve)
 - [`sf debug delete`](#sf-debug-delete)
@@ -52,17 +227,20 @@ EXAMPLES
 
 ## `sf debug retrieve`
 
-Retrieve Apex log files from the Salesforce platform.
+Retrieve Apex log files from the Salesforce platform. If `--folder` is omitted, the selected log contents are streamed to stdout.
 
 ```
 USAGE
-  $ sf debug retrieve -o <value> [-u <value>] [-t <value>] [-d <value>] [-a]
+  $ sf debug retrieve -o <value> [-u <value>] [-t <value>] [-l <value>] [-q <value>] [-d <value>] [-a]
 
 FLAGS
   -a, --all-users               Retrieve log files for all users.
-  -d, --folder=<value>          [default: .sfdx/tools/debug/logs] The folder where the retrieved log files will be stored.
+  -d, --folder=<value>          The folder where the retrieved log files will be stored. If omitted, the selected logs
+                                are streamed to stdout.
   -o, --targetusername=<value>  (required) Username or alias of the target Salesforce org.
   -l, --limit=<value>           [default: 100] The max number of log files to retrieve.
+  -q, --query=<value>           SOQL query used to select ApexLog records to retrieve. This flag can't be used with
+                                --user, --time, --limit, or --all-users.
   -t, --time=<value>            The number of minutes to retrieve log files for.
   -u, --user=<value>            [default: current user] Username, Name, or ID of the user for whom you want to retrieve the logs.
 
@@ -71,6 +249,8 @@ GLOBAL FLAGS
 
 EXAMPLES
   sf debug retrieve -o DeveloperEdition -u "Raffaele Preziosi" -t 10
+
+  sf debug retrieve -o DeveloperEdition -q "SELECT Id FROM ApexLog ORDER BY SystemModstamp DESC LIMIT 1" | rg "EXCEPTION"
 ```
 
 ## `sf debug delete`
@@ -133,5 +313,3 @@ DESCRIPTION
 EXAMPLES
   sf debuglevel new -o DeveloperEdition -n "DebugLevel"
 ```
-
-

package/lib/commands/debug/retrieve.d.ts

@@ -1,17 +1,25 @@
+import type { Interfaces } from '@oclif/core';
 import { SfCommand } from '@salesforce/sf-plugins-core';
 export default class Retrieve extends SfCommand<void> {
     static readonly summary: string;
     static readonly description: string;
     static readonly examples: string[];
     static readonly flags: {
-        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        targetusername: import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
-        user: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        time: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
-        folder: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        'all-users': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'api-version': Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        targetusername: Interfaces.OptionFlag<import("@salesforce/core").Org, Interfaces.CustomOptions>;
+        user: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        time: Interfaces.OptionFlag<number | undefined, Interfaces.CustomOptions>;
+        limit: Interfaces.OptionFlag<number, Interfaces.CustomOptions>;
+        query: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        folder: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        'all-users': Interfaces.BooleanFlag<boolean>;
     };
+    private static pipeLog;
+    private static getDownloadUrl;
+    private static createStdoutWriter;
     run(): Promise<void>;
+    private getLogsFromFlags;
     private saveLogs;
+    private streamLogsToStdout;
+    private warnDownloadError;
 }

package/lib/commands/debug/retrieve.js

@@ -1,9 +1,16 @@
-import path from 'path';
+import { createWriteStream } from 'node:fs';
+import { mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { pipeline as nodePipeline, Writable } from 'node:stream';
+import { promisify } from 'node:util';
 import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
 import { Messages } from '@salesforce/core';
-import { getUserId, createFile, getLogs } from '../../utils.js';
+import { getUserId, getLogs, getLogsByQuery } from '../../utils.js';
 Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('sf-debug-log', 'debug.retrieve');
+const pipeline = promisify(nodePipeline);
+const QUERY_EXCLUSIVE_FLAGS = ['user', 'time', 'limit', 'all-users'];
+const EMPTY_DOWNLOAD_SUMMARY = { failedCount: 0, savedCount: 0 };
 export default class Retrieve extends SfCommand {
     static summary = messages.getMessage('summary');
     static description = messages.getMessage('description');
@@ -20,6 +27,7 @@ export default class Retrieve extends SfCommand {
         user: Flags.string({
             summary: messages.getMessage('flags.user.summary'),
             char: 'u',
+            exclusive: ['all-users'],
         }),
         time: Flags.integer({
             summary: messages.getMessage('flags.time.summary'),
@@ -28,60 +36,117 @@ export default class Retrieve extends SfCommand {
         limit: Flags.integer({
             summary: messages.getMessage('flags.limit.summary'),
             char: 'l',
-            default: 100
+            default: 100,
+        }),
+        query: Flags.string({
+            summary: messages.getMessage('flags.query.summary'),
+            char: 'q',
+            exclusive: QUERY_EXCLUSIVE_FLAGS,
         }),
         folder: Flags.directory({
             summary: messages.getMessage('flags.folder.summary'),
             char: 'd',
-            default: '.sfdx/tools/debug/logs',
         }),
         'all-users': Flags.boolean({
             summary: messages.getMessage('flags.all-users.summary'),
             char: 'a',
             default: false,
+            exclusive: ['user'],
         }),
     };
+    static async pipeLog(conn, log, destination) {
+        const request = conn.request(Retrieve.getDownloadUrl(conn, log));
+        await Promise.all([pipeline(request.stream(), destination), request.then(() => undefined)]);
+    }
+    static getDownloadUrl(conn, log) {
+        return `${conn.instanceUrl}/apexdebug/traceDownload.apexp?id=${log.Id}`;
+    }
+    static createStdoutWriter() {
+        return new Writable({
+            write(chunk, encoding, callback) {
+                if (typeof chunk === 'string') {
+                    process.stdout.write(chunk, encoding, callback);
+                }
+                else {
+                    process.stdout.write(chunk, callback);
+                }
+            },
+        });
+    }
     async run() {
-        const { flags } = await this.parse(Retrieve);
-        if (flags['all-users'] && flags.user) {
-            this.error('Cannot use --all-users and --user flags together');
-        }
+        const { flags: parsedFlags } = await this.parse(Retrieve);
+        const flags = parsedFlags;
         const conn = flags.targetusername.getConnection(flags['api-version']);
+        const logs = flags.query ? await getLogsByQuery(conn, flags.query) : await this.getLogsFromFlags(conn, flags);
+        const downloadSummary = flags.folder
+            ? await this.saveLogs(conn, logs, flags.folder)
+            : await this.streamLogsToStdout(conn, logs);
+        if (downloadSummary.failedCount > 0) {
+            const label = downloadSummary.failedCount === 1 ? 'log' : 'logs';
+            this.error(`Failed to retrieve ${downloadSummary.failedCount} ${label}.`);
+        }
+        if (flags.folder) {
+            this.log(`saved\t${downloadSummary.savedCount}`);
+        }
+    }
+    async getLogsFromFlags(conn, flags) {
         const getLogsOptions = {};
         if (!flags['all-users']) {
-            // Default to the current user if no user is specified
-            const user = flags.user ? flags.user : conn.getUsername();
+            const user = flags.user ?? conn.getUsername();
             const userId = await getUserId(conn, user);
             if (!userId) {
                 this.error(`User ${user} not found`);
             }
             getLogsOptions.userId = userId;
         }
-        if (flags.time) {
+        if (flags.time !== undefined) {
             getLogsOptions.timeLimit = flags.time;
         }
-        if (flags.limit) {
+        if (flags.limit !== undefined) {
             getLogsOptions.limit = flags.limit;
         }
-        const logs = await getLogs(conn, getLogsOptions);
-        await this.saveLogs(conn, logs, flags.folder);
-        this.log(`saved\t${logs.length}`);
+        return getLogs(conn, getLogsOptions);
     }
     async saveLogs(conn, logs, directory) {
-        // Use Promise.all to parallelize the download and save operations
-        await Promise.all(logs.map(async (log) => {
-            const url = `${conn.instanceUrl}/apexdebug/traceDownload.apexp?id=${log.Id}`;
-            const fileName = `${log.Id}.log`;
-            const filePath = path.join(directory, fileName);
+        const results = await Promise.all(logs.map(async (log) => {
+            const filePath = path.join(directory, `${log.Id}.log`);
             try {
-                const body = await conn.request(url);
-                await createFile(filePath, body);
+                await mkdir(path.dirname(filePath), { recursive: true });
+                await Retrieve.pipeLog(conn, log, createWriteStream(filePath));
+                return { failedCount: 0, savedCount: 1 };
             }
             catch (err) {
-                const errorMessage = err instanceof Error ? err.message : '';
-                this.warn(`Error downloading log for ${log.Id}: ${errorMessage}`);
+                this.warnDownloadError(log, err);
+                return { failedCount: 1, savedCount: 0 };
             }
         }));
+        return results.reduce((summary, result) => ({
+            failedCount: summary.failedCount + result.failedCount,
+            savedCount: summary.savedCount + result.savedCount,
+        }), EMPTY_DOWNLOAD_SUMMARY);
+    }
+    async streamLogsToStdout(conn, logs) {
+        return logs.reduce(async (summaryPromise, log) => {
+            const summary = await summaryPromise;
+            try {
+                await Retrieve.pipeLog(conn, log, Retrieve.createStdoutWriter());
+                return {
+                    failedCount: summary.failedCount,
+                    savedCount: summary.savedCount + 1,
+                };
+            }
+            catch (err) {
+                this.warnDownloadError(log, err);
+                return {
+                    failedCount: summary.failedCount + 1,
+                    savedCount: summary.savedCount,
+                };
+            }
+        }, Promise.resolve(EMPTY_DOWNLOAD_SUMMARY));
+    }
+    warnDownloadError(log, err) {
+        const errorMessage = err instanceof Error ? err.message : '';
+        this.warn(`Error downloading log for ${log.Id}: ${errorMessage}`);
     }
 }
 //# sourceMappingURL=retrieve.js.map

package/lib/commands/debug/retrieve.js.map

@@ -1 +1 @@
-{"version":3,"file":"retrieve.js","sourceRoot":"","sources":["../../../src/commands/debug/retrieve.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAc,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEhE,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;AAIzE,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,SAAe;IAC5C,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,aAAa,EAAE,KAAK,CAAC,aAAa,CAAC;YACjC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,2BAA2B,CAAC;SAC1D,CAAC;QACF,cAAc,EAAE,KAAK,CAAC,WAAW,CAAC;YAChC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,8BAA8B,CAAC;YAC5D,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACjB,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,oBAAoB,CAAC;YAClD,IAAI,EAAE,GAAG;SACV,CAAC;QACF,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC;YAClB,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,oBAAoB,CAAC;YAClD,IAAI,EAAE,GAAG;SACV,CAAC;QACF,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;YACnB,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,qBAAqB,CAAC;YACnD,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,GAAG;SACb,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC;YACtB,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,sBAAsB,CAAC;YACpD,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,wBAAwB;SAClC,CAAC;QACF,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC;YACzB,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,yBAAyB,CAAC;YACvD,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,KAAK;SACf,CAAC;KACH,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACrC,IAAI,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,IAAI,GAAe,KAAK,CAAC,cAAc,CAAC,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QAClF,MAAM,cAAc,GAAmB,EAAE,CAAC;QAE1C,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;YACxB,sDAAsD;YACtD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,WAAW,EAAa,CAAC;YACtE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC3C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,YAAY,CAAC,CAAC;YACvC,CAAC;YACD,cAAc,CAAC,MAAM,GAAG,MAAM,CAAC;QACjC,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,cAAc,CAAC,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;QACxC,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,cAAc,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QACrC,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QACjD,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACpC,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,IAAgB,EAAE,IAAe,EAAE,SAAiB;QACzE,kEAAkE;QAClE,MAAM,OAAO,CAAC,GAAG,CACf,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACrB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,WAAW,qCAAqC,GAAG,CAAC,EAAE,EAAE,CAAC;YAC7E,MAAM,QAAQ,GAAG,GAAG,GAAG,CAAC,EAAE,MAAM,CAAC;YACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAChD,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBACrC,MAAM,UAAU,CAAC,QAAQ,EAAE,IAAc,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,YAAY,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7D,IAAI,CAAC,IAAI,CAAC,6BAA6B,GAAG,CAAC,EAAE,KAAK,YAAY,EAAE,CAAC,CAAC;YACpE,CAAC;QACH,CAAC,CAAC,CACH,CAAC;IACJ,CAAC"}
+{"version":3,"file":"retrieve.js","sourceRoot":"","sources":["../../../src/commands/debug/retrieve.ts"],"names":[],"mappings":"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"}

package/lib/types.d.ts

@@ -10,8 +10,8 @@ export interface GetLogsOptions {
 }
 export type ApexLog = {
     Id: string;
-    LogUser: {
-        Username: string;
+    LogUser?: {
+        Username?: string;
     };
 };
 export type TraceFlag = {

package/lib/utils.d.ts

@@ -7,4 +7,5 @@ export declare function getDebugLevels(conn: Connection): Promise<DebugLevel[]>;
 export declare function createTraceFlag(conn: Connection, userId: string, debugLevelId: string, time: number): Promise<SaveResult>;
 export declare function createDebugLevel(conn: Connection, debugLevel: DebugLevelCreate): Promise<SaveResult>;
 export declare function getLogs(conn: Connection, options: GetLogsOptions): Promise<ApexLog[]>;
+export declare function getLogsByQuery(conn: Connection, query: string): Promise<ApexLog[]>;
 export declare function deleteLogs(conn: Connection, logs: ApexLog[]): Promise<void>;

package/lib/utils.js

@@ -112,6 +112,17 @@ export async function getLogs(conn, options) {
     const queryResult = await conn.query(queryString);
     return queryResult.records;
 }
+export async function getLogsByQuery(conn, query) {
+    if (!/\bfrom\s+apexlog\b/i.test(query)) {
+        throw new Error('The --query SOQL must query ApexLog records.');
+    }
+    const queryResult = await conn.query(query);
+    const logs = queryResult.records;
+    if (logs.some((log) => !log.Id)) {
+        throw new Error('The --query SOQL must select the ApexLog Id field.');
+    }
+    return logs;
+}
 export async function deleteLogs(conn, logs) {
     if (logs && logs.length > 0) {
         const ids = logs.map((log) => log.Id).filter((id) => id !== undefined);

package/lib/utils.js.map

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

package/messages/debug.retrieve.md

@@ -4,7 +4,7 @@ Retrieve Apex log files from the Salesforce platform.
 
 # description
 
-This command allows you to retrieve Apex log files from a Salesforce org.
+This command allows you to retrieve Apex log files from a Salesforce org. If you don't specify `--folder`, the log contents are streamed to stdout.
 
 # flags.user.summary
 
@@ -22,9 +22,13 @@ Retrieve logs created in the last specified number of minutes.
 
 The max number of log files to retrieve.
 
+# flags.query.summary
+
+SOQL query used to select `ApexLog` records to retrieve. This flag can't be used with `--user`, `--time`, `--limit`, or `--all-users`.
+
 # flags.folder.summary
 
-The folder where the retrieved log files will be stored.
+The folder where the retrieved log files will be stored. If omitted, the selected logs are streamed to stdout.
 
 # flags.all-users.summary
 
@@ -41,3 +45,4 @@ Failed to save logs: %s.
 # examples
 
 sf debug retrieve -o MyDeveloperEdition -u "Raffaele Preziosi" -t 10
+sf debug retrieve -o MyDeveloperEdition -q "SELECT Id FROM ApexLog ORDER BY SystemModstamp DESC LIMIT 1" | rg "EXCEPTION"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sf-debug-log",
   "description": "Manage Salesforce Debug Logs",
-  "version": "0.2.5",
+  "version": "0.3.0",
   "type": "module",
   "exports": "./lib/index.js",
   "dependencies": {