sf-debug-log 0.0.20 → 0.0.22

package/README.md

@@ -2,6 +2,9 @@
 
 Commands to manage Salesforce debug logs.
 
+Create trace flags for any user in the org selecting the debug level and time.
+Retrive Apex logs related to a specific user to analyze them locally.
+
 ## Install
 
 ```bash
@@ -17,16 +20,14 @@ sf plugins install sf-debug-log
 
 ## `sf trace new`
 
-Create a new trace flag.
-
 ```
 USAGE
-  $ sf trace new
+  $ sf trace new -o <value> [-u <value>] [-t <value>]
 
 FLAGS
-  -o, --targetusername=<value>  [required] A username or alias for the target org.
-  -u, --name=<value> The name of the user to trace.
+  -o, --targetusername=<value>  [required] Username or alias of the target Salesforce org.
   -t, --time=<value> [default: 60] The number of minutes to trace.
+  -u, --name=<value> [default: targetusername] Username, Name, or ID of the user for whom you want to retrieve the logs.
 
 GLOBAL FLAGS
   --json  Format output as json.
@@ -34,28 +35,31 @@ GLOBAL FLAGS
 DESCRIPTION
   Create a new trace flag.
 
+  This command is used to create a trace flag for a specific user in the Salesforce org.
+
 EXAMPLES
   sf trace new -o DeveloperEdition -u "Raffaele Preziosi" -t 10
 ```
 
 ## `sf debug retrieve`
 
-Retrieve apex log files.
-
 ```
 USAGE
-  $ sf debug retrieve
+  $  sf debug retrieve -o <value> [-u <value>] [-t <value>] [-d <value>]
 
 FLAGS
-  -o, --targetusername=<value>  [required] A username or alias for the target org.
-  -u, --name=<value> The name of the user to trace.
-  -t, --time=<value> [default: 60] Minutes to retrieve logs for.
+  -d, --folder=<value>          [default: .sfdx/tools/debug/logs] The folder where the retrieved log files will be stored.
+  -o, --targetusername=<value>  (required) Username or alias of the target Salesforce org.
+  -t, --time=<value>            [default: 60] The number of minutes to retrieve log files for.
+  -u, --user=<value>            [default: targetusername] Username, Name, or ID of the user for whom you want to retrieve the logs.
 
 GLOBAL FLAGS
   --json  Format output as json.
 
 DESCRIPTION
-  Retrieves apex log files from the Salesforce platform.
+  Retrieve Apex log files from the Salesforce platform.
+
+  This command allows you to retrieve Apex log files from a Salesforce org.
 
 EXAMPLES
   sf debug retrieve -o DeveloperEdition -u "Raffaele Preziosi" -t 10

package/lib/commands/debuglevel/new.d.ts

@@ -0,0 +1,17 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export type DebuglevelNewResult = {
+    isSuccess: boolean;
+    error?: string;
+};
+export default class DebuglevelNew extends SfCommand<DebuglevelNewResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        targetusername: import("@oclif/core/lib/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        developername: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    run(): Promise<DebuglevelNewResult>;
+    private createDebugLevelRecord;
+    private selectDebugLevel;
+}

package/lib/commands/debuglevel/new.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable class-methods-use-this */
+const sf_plugins_core_1 = require("@salesforce/sf-plugins-core");
+const core_1 = require("@salesforce/core");
+const utils_1 = require("../../utils");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('sf-debug-log', 'debuglevel.new');
+const DEBUG_CATEGORIES = [
+    'Database',
+    'Workflow',
+    'Validation',
+    'Callout',
+    'ApexCode',
+    'ApexProfiling',
+    'Visualforce',
+    'System',
+    'Wave',
+    'Nba',
+];
+const DEBUG_LEVELS = ['NONE', 'INTERNAL', 'FINEST', 'FINER', 'FINE', 'DEBUG', 'INFO', 'WARN', 'ERROR'];
+class DebuglevelNew extends sf_plugins_core_1.SfCommand {
+    async run() {
+        const { flags } = await this.parse(DebuglevelNew);
+        const conn = flags.targetusername.getConnection();
+        try {
+            const debugLevel = this.createDebugLevelRecord(flags.developername);
+            for (const category of DEBUG_CATEGORIES) {
+                // eslint-disable-next-line no-await-in-loop
+                const level = await this.selectDebugLevel(category);
+                debugLevel[category] = level;
+            }
+            const result = await (0, utils_1.createDebugLevel)(conn, debugLevel);
+            if (!result.isSuccess) {
+                this.error(`Error to create Debug Level: ${result.error}`);
+            }
+            else {
+                this.log(`Debug Level ${flags.developername} created successfully.`);
+            }
+            return result;
+        }
+        catch (exception) {
+            const err = exception instanceof Error ? exception.message : String(exception);
+            this.log(`Error to create Debug Level: ${err}`);
+            return {
+                isSuccess: false,
+                error: err,
+            };
+        }
+    }
+    createDebugLevelRecord(developerName) {
+        return {
+            DeveloperName: developerName,
+            MasterLabel: developerName,
+        };
+    }
+    async selectDebugLevel(category) {
+        const levels = DEBUG_LEVELS;
+        const level = await this.prompt({
+            type: 'list',
+            name: 'level',
+            message: `Select ${category} debug level`,
+            loop: false,
+            choices: levels,
+        });
+        return level.level;
+    }
+}
+DebuglevelNew.summary = messages.getMessage('summary');
+DebuglevelNew.description = messages.getMessage('description');
+DebuglevelNew.examples = messages.getMessages('examples');
+DebuglevelNew.flags = {
+    targetusername: sf_plugins_core_1.Flags.requiredOrg({
+        summary: messages.getMessage('flags.targetusername.summary'),
+        char: 'o',
+        required: true,
+    }),
+    developername: sf_plugins_core_1.Flags.string({
+        summary: messages.getMessage('flags.developerName.summary'),
+        char: 'n',
+        required: true,
+    }),
+};
+exports.default = DebuglevelNew;
+//# sourceMappingURL=new.js.map

package/lib/commands/debuglevel/new.js.map

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

package/lib/commands/trace/new.d.ts

@@ -12,5 +12,6 @@ export default class TraceNew extends SfCommand<TraceNewResult> {
         time: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
     };
     run(): Promise<TraceNewResult>;
+    private selectToProceed;
     private selectDebugLevel;
 }

package/lib/commands/trace/new.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const sf_plugins_core_1 = require("@salesforce/sf-plugins-core");
 const core_1 = require("@salesforce/core");
 const utils_1 = require("../../utils");
-const MILLISECONDS_PER_MINUTE = 60000;
 core_1.Messages.importMessagesDirectory(__dirname);
 const messages = core_1.Messages.loadMessages('sf-debug-log', 'trace.new');
 class TraceNew extends sf_plugins_core_1.SfCommand {
@@ -15,26 +14,46 @@ class TraceNew extends sf_plugins_core_1.SfCommand {
         try {
             this.spinner.start('Retriving debug levels...');
             user = flags.user ? flags.user : conn.getUsername();
-            const [userId, debugLevels] = await Promise.all([(0, utils_1.getUserId)(conn, user), getDebugLevels(conn)]);
+            const userId = await (0, utils_1.getUserId)(conn, user);
+            const [activeFlag, debugLevels] = await Promise.all([(0, utils_1.getActiveTraceFlag)(conn, userId), (0, utils_1.getDebugLevels)(conn)]);
             this.spinner.stop();
+            if (activeFlag?.Id) {
+                const shouldProceed = await this.selectToProceed();
+                if (!shouldProceed) {
+                    return { isSuccess: false, error: 'Trace Flag already exists for this user.' };
+                }
+                else {
+                    this.spinner.start('Deleting existing Trace Flag...');
+                    await conn.tooling.sobject('TraceFlag').delete(activeFlag.Id);
+                    this.spinner.stop();
+                }
+            }
             const debuglevel = await this.selectDebugLevel(debugLevels);
             this.spinner.start('Creating Trace Flag...');
-            result = await createTraceFlag(conn, userId, debuglevel, flags.time);
+            result = await (0, utils_1.createTraceFlag)(conn, userId, debuglevel, flags.time);
+            this.spinner.stop();
+            if (!result.isSuccess) {
+                this.error(`Error to create Trace Flag: ${result.error}`);
+            }
+            else {
+                this.log(`User Trace Flag successfully created for ${user}`);
+            }
+            return result;
         }
         catch (err) {
-            result = {
+            return {
                 isSuccess: false,
                 error: err instanceof Error ? err.message : String(err),
             };
         }
-        this.spinner.stop();
-        if (!result.isSuccess) {
-            this.error(`Error to create Trace Flag: ${result.error}`);
-        }
-        else {
-            this.log(`User Trace Flag successfully created for ${user}`);
-        }
-        return result;
+    }
+    async selectToProceed() {
+        const proceed = await this.prompt({
+            type: 'confirm',
+            name: 'proceed',
+            message: 'Trace Flag already exists for this user. Do you want to proceed?',
+        });
+        return proceed.proceed;
     }
     async selectDebugLevel(debugLevels) {
         const debuglevel = await this.prompt({
@@ -67,30 +86,9 @@ TraceNew.flags = {
     }),
     time: sf_plugins_core_1.Flags.integer({
         summary: messages.getMessage('flags.time.summary'),
+        char: 't',
         default: 60,
     }),
 };
 exports.default = TraceNew;
-async function getDebugLevels(conn) {
-    const results = await conn.tooling.query('SELECT Id, DeveloperName, Workflow, Validation, Callout, ApexCode, ApexProfiling, Visualforce, System, Database, Wave, Nba FROM DebugLevel');
-    if (results?.records) {
-        return results.records;
-    }
-    else {
-        throw new Error('Error to retrieve Debug Levels');
-    }
-}
-async function createTraceFlag(conn, userId, debugLevelId, time) {
-    const result = await conn.tooling.sobject('TraceFlag').create({
-        TracedEntityId: userId,
-        DebugLevelId: debugLevelId,
-        StartDate: new Date(Date.now()).toISOString(),
-        logtype: 'USER_DEBUG',
-        ExpirationDate: new Date(Date.now() + time * MILLISECONDS_PER_MINUTE).toISOString(),
-    });
-    return {
-        isSuccess: result.success,
-        error: result.success ? undefined : result.errors[0].message,
-    };
-}
 //# sourceMappingURL=new.js.map

package/lib/commands/trace/new.js.map

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

package/lib/utils.d.ts

@@ -1,3 +1,10 @@
 import { Connection } from '@salesforce/core';
+import { Record } from 'jsforce';
+import { TraceNewResult } from './commands/trace/new';
+import { DebuglevelNewResult } from './commands/debuglevel/new';
 export declare function createFile(path: string, contents: string): Promise<void>;
 export declare function getUserId(connection: Connection, inputUser: string): Promise<string>;
+export declare function getActiveTraceFlag(conn: Connection, userId: string): Promise<Record | undefined>;
+export declare function getDebugLevels(conn: Connection): Promise<Record[]>;
+export declare function createTraceFlag(conn: Connection, userId: string, debugLevelId: string, time: number): Promise<TraceNewResult>;
+export declare function createDebugLevel(conn: Connection, debugLevel: Record): Promise<DebuglevelNewResult>;

package/lib/utils.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getUserId = exports.createFile = void 0;
+exports.createDebugLevel = exports.createTraceFlag = exports.getDebugLevels = exports.getActiveTraceFlag = exports.getUserId = exports.createFile = void 0;
 const path_1 = require("path");
 const util_1 = require("util");
 const fs_1 = require("fs");
 const mkdirPromise = (0, util_1.promisify)(fs_1.mkdir);
 const writeFilePromise = (0, util_1.promisify)(fs_1.writeFile);
+const MILLISECONDS_PER_MINUTE = 60000;
 async function createFile(path, contents) {
     await mkdirPromise((0, path_1.dirname)(path), { recursive: true });
     await writeFilePromise(path, contents);
@@ -38,4 +39,46 @@ function isId(input) {
     const idRegex = /[a-zA-Z0-9]{15}|[a-zA-Z0-9]{18}/;
     return idRegex.test(input);
 }
+async function getActiveTraceFlag(conn, userId) {
+    const results = await conn.tooling.query(`SELECT Id, TracedEntityId, DebugLevelId, StartDate, ExpirationDate FROM TraceFlag WHERE TracedEntityId = '${userId}' AND ExpirationDate > ${new Date(Date.now()).toISOString()}`);
+    if (results?.records?.length > 0) {
+        return results.records[0];
+    }
+    else {
+        return undefined;
+    }
+}
+exports.getActiveTraceFlag = getActiveTraceFlag;
+async function getDebugLevels(conn) {
+    const results = await conn.tooling.query('SELECT Id, DeveloperName, Workflow, Validation, Callout, ApexCode, ApexProfiling, Visualforce, System, Database, Wave, Nba FROM DebugLevel');
+    if (results?.records) {
+        return results.records;
+    }
+    else {
+        throw new Error('Error to retrieve Debug Levels');
+    }
+}
+exports.getDebugLevels = getDebugLevels;
+async function createTraceFlag(conn, userId, debugLevelId, time) {
+    const result = await conn.tooling.sobject('TraceFlag').create({
+        TracedEntityId: userId,
+        DebugLevelId: debugLevelId,
+        StartDate: new Date(Date.now()).toISOString(),
+        logtype: 'USER_DEBUG',
+        ExpirationDate: new Date(Date.now() + time * MILLISECONDS_PER_MINUTE).toISOString(),
+    });
+    return {
+        isSuccess: result.success,
+        error: result.success ? undefined : result.errors[0].message,
+    };
+}
+exports.createTraceFlag = createTraceFlag;
+async function createDebugLevel(conn, debugLevel) {
+    const result = await conn.tooling.sobject('DebugLevel').create(debugLevel);
+    return {
+        isSuccess: result.success,
+        error: result.success ? undefined : result.errors[0].message,
+    };
+}
+exports.createDebugLevel = createDebugLevel;
 //# sourceMappingURL=utils.js.map

package/lib/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;;AAAA,+BAA+B;AAC/B,+BAAiC;AACjC,2BAAsC;AAGtC,MAAM,YAAY,GAAG,IAAA,gBAAS,EAAC,UAAK,CAAC,CAAC;AACtC,MAAM,gBAAgB,GAAG,IAAA,gBAAS,EAAC,cAAS,CAAC,CAAC;AAEvC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,QAAgB;IAC7D,MAAM,YAAY,CAAC,IAAA,cAAO,EAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,MAAM,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACzC,CAAC;AAHD,gCAGC;AAEM,KAAK,UAAU,SAAS,CAAC,UAAsB,EAAE,SAAiB;IACvE,IAAI,MAAM,CAAC;IACX,IAAI,YAAY,CAAC,SAAS,CAAC,EAAE;QAC3B,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;KACpF;SAAM,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE;QAC1B,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;KAC9E;SAAM;QACL,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;KAChF;IACD,IAAI,MAAM,EAAE,EAAE,EAAE;QACd,OAAO,MAAM,CAAC,EAAE,CAAC;KAClB;SAAM;QACL,MAAM,IAAI,KAAK,CAAC,QAAQ,SAAS,YAAY,CAAC,CAAC;KAChD;AACH,CAAC;AAdD,8BAcC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,MAAM,UAAU,GAAG,4BAA4B,CAAC;IAChD,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,IAAI,CAAC,KAAa;IACzB,MAAM,OAAO,GAAG,iCAAiC,CAAC;IAClD,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/messages/debug.retrieve.md

@@ -1,26 +1,26 @@
 # summary
 
-Retrieve apex log files.
+Retrieve Apex log files from the Salesforce platform.
 
 # description
 
-Retrieves apex log files from the Salesforce platform.
+This command allows you to retrieve Apex log files from a Salesforce org.
 
 # flags.user.summary
 
-Username or alias to retrieve logs for.
+[default: targetusername] Username, Name, or ID of the user for whom you want to retrieve the logs.
 
 # flags.targetusername.summary
 
-Username or alias to retrieve logs for.
+Username or alias of the target Salesforce org.
 
 # flags.time.summary
 
-Minutes to retrieve logs for.
+The number of minutes to retrieve log files for.
 
 # flags.folder.summary
 
-Folder where the logs are stored.
+The folder where the retrieved log files will be stored.
 
 # error.saveLogs
 
@@ -28,4 +28,4 @@ Failed to save logs: %s.
 
 # examples
 
-- <%= config.bin %> <%= command.id %>
+sf debug retrieve -o MyDeveloperEdition -u "Raffaele Preziosi" -t 10

package/messages/debuglevel.new.md

@@ -0,0 +1,19 @@
+# summary
+
+Create a new DebugLevel.
+
+# description
+
+More information about a command. Don't repeat the summary.
+
+# flags.targetusername.summary
+
+Username or alias of the target Salesforce org.
+
+# flags.developerName.summary
+
+The developer name of the new DebugLevel.
+
+# examples
+
+- <%= config.bin %> <%= command.id %>

package/messages/trace.new.md

@@ -2,13 +2,17 @@
 
 Create a trace flag for a user.
 
+# description
+
+This command is used to create a trace flag for a specific user in the Salesforce org.
+
 # flags.targetusername.summary
 
-A username or alias for the target org.
+Username or alias of the target Salesforce org.
 
 # flags.user.summary
 
-The username of the user to create the trace flag for.
+[default: targetusername] Username, Name, or ID of the user for whom you want to retrieve the logs.
 
 # flags.time.summary
 
@@ -20,4 +24,4 @@ Create User Trace Flag failed: %s.
 
 # examples
 
-example
+sf trace new -o MyDeveloperEdition -u "Raffaele Preziosi" -t 10

package/oclif.manifest.json

@@ -1,17 +1,17 @@
 {
-  "version": "0.0.20",
+  "version": "0.0.22",
   "commands": {
     "debug:retrieve": {
       "id": "debug:retrieve",
-      "summary": "Retrieve apex log files.",
-      "description": "Retrieves apex log files from the Salesforce platform.",
+      "summary": "Retrieve Apex log files from the Salesforce platform.",
+      "description": "This command allows you to retrieve Apex log files from a Salesforce org.",
       "strict": true,
       "pluginName": "sf-debug-log",
       "pluginAlias": "sf-debug-log",
       "pluginType": "core",
       "aliases": [],
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "sf debug retrieve -o MyDeveloperEdition -u \"Raffaele Preziosi\" -t 10"
       ],
       "flags": {
         "json": {
@@ -25,7 +25,7 @@
           "name": "targetusername",
           "type": "option",
           "char": "o",
-          "summary": "Username or alias to retrieve logs for.",
+          "summary": "Username or alias of the target Salesforce org.",
           "required": true,
           "multiple": false
         },
@@ -33,14 +33,14 @@
           "name": "user",
           "type": "option",
           "char": "u",
-          "summary": "Username or alias to retrieve logs for.",
+          "summary": "[default: targetusername] Username, Name, or ID of the user for whom you want to retrieve the logs.",
           "multiple": false
         },
         "time": {
           "name": "time",
           "type": "option",
           "char": "t",
-          "summary": "Minutes to retrieve logs for.",
+          "summary": "The number of minutes to retrieve log files for.",
           "multiple": false,
           "default": 60
         },
@@ -48,7 +48,7 @@
           "name": "folder",
           "type": "option",
           "char": "d",
-          "summary": "Folder where the logs are stored.",
+          "summary": "The folder where the retrieved log files will be stored.",
           "multiple": false,
           "default": ".sfdx/tools/debug/logs"
         }
@@ -56,6 +56,46 @@
       "args": {},
       "hasDynamicHelp": true
     },
+    "debuglevel:new": {
+      "id": "debuglevel:new",
+      "summary": "Create a new DebugLevel.",
+      "description": "More information about a command. Don't repeat the summary.",
+      "strict": true,
+      "pluginName": "sf-debug-log",
+      "pluginAlias": "sf-debug-log",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "allowNo": false
+        },
+        "targetusername": {
+          "name": "targetusername",
+          "type": "option",
+          "char": "o",
+          "summary": "Username or alias of the target Salesforce org.",
+          "required": true,
+          "multiple": false
+        },
+        "developername": {
+          "name": "developername",
+          "type": "option",
+          "char": "n",
+          "summary": "The developer name of the new DebugLevel.",
+          "required": true,
+          "multiple": false
+        }
+      },
+      "args": {},
+      "hasDynamicHelp": true
+    },
     "trace:new": {
       "id": "trace:new",
       "summary": "Create a trace flag for a user.",
@@ -65,7 +105,7 @@
       "pluginType": "core",
       "aliases": [],
       "examples": [
-        "example"
+        "sf trace new -o MyDeveloperEdition -u \"Raffaele Preziosi\" -t 10"
       ],
       "flags": {
         "json": {
@@ -79,7 +119,7 @@
           "name": "targetusername",
           "type": "option",
           "char": "o",
-          "summary": "A username or alias for the target org.",
+          "summary": "Username or alias of the target Salesforce org.",
           "required": true,
           "multiple": false
         },
@@ -87,12 +127,13 @@
           "name": "user",
           "type": "option",
           "char": "u",
-          "summary": "The username of the user to create the trace flag for.",
+          "summary": "[default: targetusername] Username, Name, or ID of the user for whom you want to retrieve the logs.",
           "multiple": false
         },
         "time": {
           "name": "time",
           "type": "option",
+          "char": "t",
           "summary": "The time for the trace flag.",
           "multiple": false,
           "default": 60

package/package.json

@@ -1,199 +1,202 @@
-{
-  "name": "sf-debug-log",
-  "description": "Manage Salesforce Debug Logs",
-  "version": "0.0.20",
-  "dependencies": {
-    "@oclif/core": "^2.11.8",
-    "@salesforce/core": "^5.2.0",
-    "@salesforce/kit": "^3.0.8",
-    "@salesforce/sf-plugins-core": "^3.1.14",
-    "sanitize-filename": "^1.6.3",
-    "tslib": "^2"
-  },
-  "devDependencies": {
-    "@salesforce/cli-plugins-testkit": "^4.3.0",
-    "@salesforce/dev-config": "^4.0.1",
-    "@salesforce/dev-scripts": "^5.7.0",
-    "@salesforce/prettier-config": "^0.0.3",
-    "@salesforce/ts-sinon": "^1.4.14",
-    "@swc/core": "^1.3.19",
-    "@types/inquirer": "^9.0.3",
-    "@typescript-eslint/eslint-plugin": "^5.59.8",
-    "@typescript-eslint/parser": "^5.62.0",
-    "chai": "^4.3.6",
-    "eslint": "^8.47.0",
-    "eslint-config-prettier": "^8.5.0",
-    "eslint-config-salesforce": "^2.0.2",
-    "eslint-config-salesforce-typescript": "^1.1.2",
-    "eslint-plugin-import": "2.28.1",
-    "eslint-plugin-jsdoc": "^46.4.6",
-    "eslint-plugin-sf-plugin": "^1.16.2",
-    "husky": "^8.0.0",
-    "mocha": "^9.2.2",
-    "nyc": "^15.1.0",
-    "oclif": "^3.9.1",
-    "prettier": "^2.8.8",
-    "pretty-quick": "^3.1.3",
-    "shx": "0.3.4",
-    "sinon": "10.0.0",
-    "ts-node": "^10.9.1",
-    "typescript": "^5.1.6",
-    "wireit": "^0.10.0"
-  },
-  "engines": {
-    "node": ">=16.0.0"
-  },
-  "files": [
-    "/lib",
-    "/messages",
-    "/oclif.manifest.json"
-  ],
-  "keywords": [
-    "force",
-    "salesforce",
-    "sfdx",
-    "salesforcedx",
-    "sfdx-plugin",
-    "sf-plugin",
-    "sf"
-  ],
-  "license": "BSD-3-Clause",
-  "main": "lib/index.js",
-  "oclif": {
-    "commands": "./lib/commands",
-    "bin": "sf",
-    "topicSeparator": " ",
-    "devPlugins": [
-      "@oclif/plugin-help"
-    ],
-    "topics": {
-      "trace": {
-        "description": "Manage Salesforce Trace Flags"
-      },
-      "debug": {
-        "description": "Manage Salesforce Debug Logs"
-      }
-    }
-  },
-  "scripts": {
-    "build": "wireit",
-    "clean": "sf-clean",
-    "clean-all": "sf-clean all",
-    "clean:lib": "shx rm -rf lib && shx rm -rf coverage && shx rm -rf .nyc_output && shx rm -f oclif.manifest.json",
-    "compile": "wireit",
-    "docs": "sf-docs",
-    "format": "wireit",
-    "lint": "wireit",
-    "postpack": "shx rm -f oclif.manifest.json",
-    "prepack": "sf-prepack",
-    "test": "wireit",
-    "test:only": "wireit",
-    "version": "oclif readme"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "wireit": {
-    "build": {
-      "dependencies": [
-        "compile",
-        "lint"
-      ]
-    },
-    "compile": {
-      "command": "tsc -p . --pretty --incremental",
-      "files": [
-        "src/**/*.ts",
-        "**/tsconfig.json",
-        "messages/**"
-      ],
-      "output": [
-        "lib/**",
-        "*.tsbuildinfo"
-      ],
-      "clean": "if-file-deleted"
-    },
-    "format": {
-      "command": "prettier --write \"+(src|test|schemas)/**/*.+(ts|js|json)|command-snapshot.json\"",
-      "files": [
-        "src/**/*.ts",
-        "test/**/*.ts",
-        "schemas/**/*.json",
-        "command-snapshot.json",
-        ".prettier*"
-      ],
-      "output": []
-    },
-    "lint": {
-      "command": "eslint src test --color --cache --cache-location .eslintcache",
-      "files": [
-        "src/**/*.ts",
-        "test/**/*.ts",
-        "messages/**",
-        "**/.eslint*",
-        "**/tsconfig.json"
-      ],
-      "output": []
-    },
-    "test:compile": {
-      "command": "tsc -p \"./test\" --pretty",
-      "files": [
-        "test/**/*.ts",
-        "**/tsconfig.json"
-      ],
-      "output": []
-    },
-    "test": {
-      "dependencies": [
-        "test:compile",
-        "test:only",
-        "lint"
-      ]
-    },
-    "test:only": {
-      "command": "nyc mocha \"test/**/*.test.ts\"",
-      "env": {
-        "FORCE_COLOR": "2"
-      },
-      "files": [
-        "test/**/*.ts",
-        "src/**/*.ts",
-        "**/tsconfig.json",
-        ".mocha*",
-        "!*.nut.ts",
-        ".nycrc"
-      ],
-      "output": []
-    },
-    "test:command-reference": {
-      "command": "\"./bin/dev\" commandreference:generate --erroronwarnings",
-      "files": [
-        "src/**/*.ts",
-        "messages/**",
-        "package.json"
-      ],
-      "output": [
-        "tmp/root"
-      ]
-    },
-    "test:deprecation-policy": {
-      "command": "\"./bin/dev\" snapshot:compare",
-      "files": [
-        "src/**/*.ts"
-      ],
-      "output": [],
-      "dependencies": [
-        "compile"
-      ]
-    },
-    "test:json-schema": {
-      "command": "\"./bin/dev\" schema:compare",
-      "files": [
-        "src/**/*.ts",
-        "schemas"
-      ],
-      "output": []
-    }
-  },
-  "author": "Raffaele Preziosi"
-}
+{
+  "name": "sf-debug-log",
+  "description": "Manage Salesforce Debug Logs",
+  "version": "0.0.22",
+  "dependencies": {
+    "@oclif/core": "^2.11.8",
+    "@salesforce/core": "^5.2.0",
+    "@salesforce/kit": "^3.0.8",
+    "@salesforce/sf-plugins-core": "^3.1.14",
+    "sanitize-filename": "^1.6.3",
+    "tslib": "^2"
+  },
+  "devDependencies": {
+    "@salesforce/cli-plugins-testkit": "^4.3.0",
+    "@salesforce/dev-config": "^4.0.1",
+    "@salesforce/dev-scripts": "^5.7.0",
+    "@salesforce/prettier-config": "^0.0.3",
+    "@salesforce/ts-sinon": "^1.4.14",
+    "@swc/core": "^1.3.19",
+    "@types/inquirer": "^9.0.3",
+    "@typescript-eslint/eslint-plugin": "^5.59.8",
+    "@typescript-eslint/parser": "^5.62.0",
+    "chai": "^4.3.6",
+    "eslint": "^8.47.0",
+    "eslint-config-prettier": "^8.5.0",
+    "eslint-config-salesforce": "^2.0.2",
+    "eslint-config-salesforce-typescript": "^1.1.2",
+    "eslint-plugin-import": "2.28.1",
+    "eslint-plugin-jsdoc": "^46.4.6",
+    "eslint-plugin-sf-plugin": "^1.16.2",
+    "husky": "^8.0.0",
+    "mocha": "^9.2.2",
+    "nyc": "^15.1.0",
+    "oclif": "^3.9.1",
+    "prettier": "^2.8.8",
+    "pretty-quick": "^3.1.3",
+    "shx": "0.3.4",
+    "sinon": "10.0.0",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.1.6",
+    "wireit": "^0.10.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "files": [
+    "/lib",
+    "/messages",
+    "/oclif.manifest.json"
+  ],
+  "keywords": [
+    "force",
+    "salesforce",
+    "sfdx",
+    "salesforcedx",
+    "sfdx-plugin",
+    "sf-plugin",
+    "sf"
+  ],
+  "license": "BSD-3-Clause",
+  "main": "lib/index.js",
+  "oclif": {
+    "commands": "./lib/commands",
+    "bin": "sf",
+    "topicSeparator": " ",
+    "devPlugins": [
+      "@oclif/plugin-help"
+    ],
+    "topics": {
+      "trace": {
+        "description": "Manage Salesforce Trace Flags"
+      },
+      "debug": {
+        "description": "Manage Salesforce Debug Logs"
+      },
+      "debuglevel": {
+        "description": "Manage Salesforce Debug Levels"
+      }
+    }
+  },
+  "scripts": {
+    "build": "wireit",
+    "clean": "sf-clean",
+    "clean-all": "sf-clean all",
+    "clean:lib": "shx rm -rf lib && shx rm -rf coverage && shx rm -rf .nyc_output && shx rm -f oclif.manifest.json",
+    "compile": "wireit",
+    "docs": "sf-docs",
+    "format": "wireit",
+    "lint": "wireit",
+    "postpack": "shx rm -f oclif.manifest.json",
+    "prepack": "sf-prepack",
+    "test": "wireit",
+    "test:only": "wireit",
+    "version": "oclif readme"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "wireit": {
+    "build": {
+      "dependencies": [
+        "compile",
+        "lint"
+      ]
+    },
+    "compile": {
+      "command": "tsc -p . --pretty --incremental",
+      "files": [
+        "src/**/*.ts",
+        "**/tsconfig.json",
+        "messages/**"
+      ],
+      "output": [
+        "lib/**",
+        "*.tsbuildinfo"
+      ],
+      "clean": "if-file-deleted"
+    },
+    "format": {
+      "command": "prettier --write \"+(src|test|schemas)/**/*.+(ts|js|json)|command-snapshot.json\"",
+      "files": [
+        "src/**/*.ts",
+        "test/**/*.ts",
+        "schemas/**/*.json",
+        "command-snapshot.json",
+        ".prettier*"
+      ],
+      "output": []
+    },
+    "lint": {
+      "command": "eslint src test --color --cache --cache-location .eslintcache",
+      "files": [
+        "src/**/*.ts",
+        "test/**/*.ts",
+        "messages/**",
+        "**/.eslint*",
+        "**/tsconfig.json"
+      ],
+      "output": []
+    },
+    "test:compile": {
+      "command": "tsc -p \"./test\" --pretty",
+      "files": [
+        "test/**/*.ts",
+        "**/tsconfig.json"
+      ],
+      "output": []
+    },
+    "test": {
+      "dependencies": [
+        "test:compile",
+        "test:only",
+        "lint"
+      ]
+    },
+    "test:only": {
+      "command": "nyc mocha \"test/**/*.test.ts\"",
+      "env": {
+        "FORCE_COLOR": "2"
+      },
+      "files": [
+        "test/**/*.ts",
+        "src/**/*.ts",
+        "**/tsconfig.json",
+        ".mocha*",
+        "!*.nut.ts",
+        ".nycrc"
+      ],
+      "output": []
+    },
+    "test:command-reference": {
+      "command": "\"./bin/dev\" commandreference:generate --erroronwarnings",
+      "files": [
+        "src/**/*.ts",
+        "messages/**",
+        "package.json"
+      ],
+      "output": [
+        "tmp/root"
+      ]
+    },
+    "test:deprecation-policy": {
+      "command": "\"./bin/dev\" snapshot:compare",
+      "files": [
+        "src/**/*.ts"
+      ],
+      "output": [],
+      "dependencies": [
+        "compile"
+      ]
+    },
+    "test:json-schema": {
+      "command": "\"./bin/dev\" schema:compare",
+      "files": [
+        "src/**/*.ts",
+        "schemas"
+      ],
+      "output": []
+    }
+  },
+  "author": "Raffaele Preziosi"
+}