sf-debug-log 0.0.21 → 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/utils.d.ts

@@ -1,8 +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,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createTraceFlag = exports.getDebugLevels = exports.getActiveTraceFlag = 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");
@@ -73,4 +73,12 @@ async function createTraceFlag(conn, userId, debugLevelId, time) {
     };
 }
 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":"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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

@@ -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.21",
+  "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,7 +127,7 @@
           "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": {

package/package.json

@@ -1,199 +1,202 @@
-{
-  "name": "sf-debug-log",
-  "description": "Manage Salesforce Debug Logs",
-  "version": "0.0.21",
-  "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"
+}