@dsmrt/axiom-cli 0.3.1 → 1.1.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @dsmrt/axiom-cli
 
+## 1.1.0
+
+### Minor Changes
+
+- b1a56bc: adding debug logging to the cli and config packages
+
+### Patch Changes
+
+- Updated dependencies [b1a56bc]
+  - @dsmrt/axiom-config@1.1.0
+
+## 1.0.0
+
+### Major Changes
+
+- d767a0e: Making loadConfig return a promise; adding typescript config support and better esm/mjs/mts support; better docs
+
+### Patch Changes
+
+- Updated dependencies [d767a0e]
+  - @dsmrt/axiom-aws-sdk@1.0.0
+  - @dsmrt/axiom-config@1.0.0
+
 ## 0.3.1
 
 ### Patch Changes

package/dist/bin/axiom.js

@@ -28,6 +28,16 @@ var import_yargs = __toESM(require("yargs"));
 
 // src/commands/config.ts
 var import_axiom_config = require("@dsmrt/axiom-config");
+
+// src/debug.ts
+var isDebugEnabled = () => process.env.AXIOM_DEBUG === "true" || process.env.AXIOM_DEBUG === "1";
+var debug = (message, ...args) => {
+  if (isDebugEnabled()) {
+    console.error(`[axiom:cli] ${message}`, ...args);
+  }
+};
+
+// src/commands/config.ts
 var Config = class {
   command = "config";
   describe = "print the config";
@@ -38,9 +48,13 @@ var Config = class {
     return args;
   };
   handler = async (args) => {
-    console.log(JSON.stringify(await this.loadConfig(args)));
+    debug(`Config command handler called with env: ${args.env}`);
+    const config = await this.loadConfig(args);
+    debug(`Config loaded successfully, outputting as JSON`);
+    console.log(JSON.stringify(config));
   };
   loadConfig = async (args) => {
+    debug(`Loading config with env: ${args.env}`);
     return (0, import_axiom_config.loadConfig)(args);
   };
 };
@@ -59,9 +73,10 @@ var ParamsCommand = class {
 };
 
 // src/commands/params/get.ts
-var import_axiom_config2 = require("@dsmrt/axiom-config");
-var import_axiom_aws_sdk = require("@dsmrt/axiom-aws-sdk");
 var import_client_ssm = require("@aws-sdk/client-ssm");
+var import_axiom_aws_sdk = require("@dsmrt/axiom-aws-sdk");
+var import_axiom_config2 = require("@dsmrt/axiom-config");
+var import_chalk = __toESM(require("chalk"));
 
 // src/aws/credentials-provider.ts
 var import_credential_providers = require("@aws-sdk/credential-providers");
@@ -69,19 +84,19 @@ var import_client_sts = require("@aws-sdk/client-sts");
 var import_inquirer = __toESM(require("inquirer"));
 
 // src/cache.ts
-var import_os = __toESM(require("os"));
-var import_fs = __toESM(require("fs"));
-var DEFAULT_DIRECTORY = `${import_os.default.homedir()}/.axiom/cache`;
+var import_node_fs = __toESM(require("fs"));
+var import_node_os = __toESM(require("os"));
+var DEFAULT_DIRECTORY = `${import_node_os.default.homedir()}/.axiom/cache`;
 var cache_default = class {
   constructor(cacheDir = DEFAULT_DIRECTORY) {
     this.cacheDir = cacheDir;
   }
   get(name) {
     const file = `${this.cacheDir}/${name}`;
-    if (!import_fs.default.existsSync(file)) {
+    if (!import_node_fs.default.existsSync(file)) {
       return;
     }
-    const buffer = import_fs.default.readFileSync(file);
+    const buffer = import_node_fs.default.readFileSync(file);
     const item = JSON.parse(buffer.toString());
     if (item.expires === void 0) {
       return item.data;
@@ -94,16 +109,16 @@ var cache_default = class {
     return item.data;
   }
   delete(name) {
-    import_fs.default.unlinkSync(`${this.cacheDir}/${name}`);
+    import_node_fs.default.unlinkSync(`${this.cacheDir}/${name}`);
   }
   set(name, value, expires) {
-    if (!import_fs.default.existsSync(this.cacheDir)) {
-      import_fs.default.mkdirSync(this.cacheDir, {
+    if (!import_node_fs.default.existsSync(this.cacheDir)) {
+      import_node_fs.default.mkdirSync(this.cacheDir, {
         recursive: true,
         mode: 448
       });
     }
-    import_fs.default.writeFileSync(
+    import_node_fs.default.writeFileSync(
       `${this.cacheDir}/${name}`,
       JSON.stringify({
         expires,
@@ -199,38 +214,31 @@ var awsOptions = () => {
   };
 };
 
-// src/commands/params/utils.ts
-var buildPath = (config, path) => {
-  if (path === void 0) {
-    return config.aws?.baseParameterPath;
-  }
-  if (/^\//.test(path)) {
-    return path;
-  }
-  return `${config.aws?.baseParameterPath.replace(/\/$/, "")}/${path}`;
-};
-
 // src/commands/params/get.ts
-var import_chalk = __toESM(require("chalk"));
 var GetCommand = class {
   command = "get [path]";
   describe = "Get all parameters under the base path";
   builder = (args) => {
-    const config = (0, import_axiom_config2.loadConfig)();
     args.options({ ...commonOptions(), ...awsOptions() });
     args.positional("path", {
       type: "string",
       describe: `OPTIONAL path to parameter. Supports absolute and relative paths.
 Example:
-	"/root/myParam" or "service/secret" (which translates to, "${buildPath(
-        config,
-        "service/secret"
-      )})`
+	"/root/myParam" or "service/secret"`
     });
     return args;
   };
   handler = async (args) => {
-    const config = (0, import_axiom_config2.loadConfig)({ env: args.env });
+    debug(
+      `Get command handler called with env: ${args.env}, path: ${args.path}`
+    );
+    const config = await (0, import_axiom_config2.loadConfig)({ env: args.env });
+    debug(
+      `Config loaded successfully, base parameter path: ${config.aws?.baseParameterPath}`
+    );
+    debug(
+      `Creating SSM client with region: ${config.aws.region}, profile: ${config.aws.profile}`
+    );
     const collection = new import_axiom_aws_sdk.ParameterCollection(
       config.aws?.baseParameterPath,
       new import_client_ssm.SSMClient({
@@ -243,11 +251,13 @@ Example:
         })
       })
     );
+    debug(`Fetching parameters from SSM...`);
     const params = await collection.get();
+    debug(`Retrieved ${params.size} parameters`);
     params.forEach((parameter) => {
       console.log(
         import_chalk.default.gray(
-          parameter.Name?.replace(/\/([^/]+)$/, "/" + import_chalk.default.bold.green("$1"))
+          parameter.Name?.replace(/\/([^/]+)$/, `/${import_chalk.default.bold.green("$1")}`)
         ),
         import_chalk.default.bold.white(parameter.Value)
       );
@@ -256,22 +266,31 @@ Example:
 };
 
 // src/commands/params/set.ts
-var import_axiom_config3 = require("@dsmrt/axiom-config");
-var import_inquirer2 = __toESM(require("inquirer"));
 var import_client_ssm2 = require("@aws-sdk/client-ssm");
+var import_axiom_config3 = require("@dsmrt/axiom-config");
 var import_chalk2 = __toESM(require("chalk"));
+var import_inquirer2 = __toESM(require("inquirer"));
+
+// src/commands/params/utils.ts
+var buildPath = (config, path) => {
+  if (path === void 0) {
+    return config.aws?.baseParameterPath;
+  }
+  if (/^\//.test(path)) {
+    return path;
+  }
+  return `${config.aws?.baseParameterPath.replace(/\/$/, "")}/${path}`;
+};
+
+// src/commands/params/set.ts
 var SetCommand = class {
   command = "set <path> <value>";
   describe = "Set all parameters under the base path";
   builder = (args) => {
-    const config = (0, import_axiom_config3.loadConfig)();
     args.positional("path", {
       type: "string",
       describe: `Path to parameter. Supports absolute and relative paths.
-Example: "/root/myParam" or "service/secret" (which translates to, "${buildPath(
-        config,
-        "service/secret"
-      )})`
+Example: "/root/myParam" or "service/secret"`
     });
     args.demandOption("path", "Path is required");
     args.positional("value", {
@@ -300,53 +319,68 @@ Example: "/root/myParam" or "service/secret" (which translates to, "${buildPath(
     });
   };
   handler = async (args) => {
-    const config = (0, import_axiom_config3.loadConfig)({ env: args.env });
+    debug(
+      `Set command handler called with path: ${args.path}, secure: ${args.secure}, overwrite: ${args.overwrite}, force: ${args.force}`
+    );
+    const config = await (0, import_axiom_config3.loadConfig)({ env: args.env });
+    debug(
+      `Config loaded successfully, base parameter path: ${config.aws?.baseParameterPath}`
+    );
+    const fullPath = buildPath(config, args.path);
+    debug(`Full parameter path: ${fullPath}`);
     if (args.force !== true) {
+      debug(`Prompting user for confirmation...`);
       const res = await import_inquirer2.default.prompt({
         type: "confirm",
         name: "setParam",
         message: `Are you sure you want to set '${args.path}'?`
       });
       if (!res.setParam) {
+        debug(`User declined, aborting`);
         console.log("Doing nothing.");
         return;
       }
+      debug(`User confirmed`);
+    } else {
+      debug(`Force flag set, skipping confirmation`);
     }
+    debug(
+      `Creating SSM client with region: ${config.aws.region}, profile: ${config.aws.profile}`
+    );
     const client = new import_client_ssm2.SSMClient({
       region: config.aws.region,
       credentials: await CachedCredentialProvider(config.aws)
     });
+    debug(
+      `Sending parameter to SSM with type: ${args.secure ? "SecureString" : "String"}`
+    );
     const params = await client.send(
       new import_client_ssm2.PutParameterCommand({
-        Name: buildPath(config, args.path),
+        Name: fullPath,
         Value: args.value,
         Type: args.secure ? import_client_ssm2.ParameterType.SECURE_STRING : import_client_ssm2.ParameterType.STRING,
         Overwrite: args.overwrite
       })
     );
+    debug(`Parameter set successfully, version: ${params.Version}`);
     console.log(import_chalk2.default.green("Version: "), import_chalk2.default.white.bold(params.Version));
   };
 };
 
 // src/commands/params/delete.ts
+var import_client_ssm3 = require("@aws-sdk/client-ssm");
 var import_axiom_config4 = require("@dsmrt/axiom-config");
 var import_inquirer3 = __toESM(require("inquirer"));
-var import_client_ssm3 = require("@aws-sdk/client-ssm");
 var log = console.log;
 var DeleteCommand = class {
   command = "delete <path>";
   describe = "Delete SSM parameters";
   client;
   builder = (args) => {
-    const config = (0, import_axiom_config4.loadConfig)();
     args.positional("path", {
       type: "string",
       describe: `Path to parameter. Supports absolute and relative paths.
-Example: "/root/myParam" or "service/secret" (which translates to, "${buildPath(
-        config,
-        "service/secret"
-      )})`,
-      default: config.aws?.baseParameterPath,
+Example: "/root/myParam" or "service/secret"`,
       demandOption: true
     }).demandOption("path", "Path is required");
     args.option("force", {
@@ -358,33 +392,51 @@ Example: "/root/myParam" or "service/secret" (which translates to, "${buildPath(
     return args;
   };
   handler = async (args) => {
-    const config = (0, import_axiom_config4.loadConfig)({ env: args.env });
+    debug(
+      `Delete command handler called with path: ${args.path}, force: ${args.force}`
+    );
+    const config = await (0, import_axiom_config4.loadConfig)({ env: args.env });
+    debug(
+      `Config loaded successfully, base parameter path: ${config.aws?.baseParameterPath}`
+    );
     const path = buildPath(args, args.path);
+    debug(`Full parameter path: ${path}`);
+    debug(
+      `Creating SSM client with region: ${config.aws?.region}, profile: ${config.aws?.profile}`
+    );
     const client = new import_client_ssm3.SSMClient({
       region: config.aws?.region,
       credentials: await CachedCredentialProvider(config.aws)
     });
     if (path === args.aws.baseParameterPath) {
+      debug(`Delete blocked: path matches base parameter path`);
       throw new Error(
         `Deleting the path (path: ${path}) that matches the base path (awsSsmParameterPath: ${args.awsSsmParameterPath}) is prohibited.`
       );
     }
     if (args.force !== true) {
+      debug(`Prompting user for confirmation...`);
       const res = await import_inquirer3.default.prompt({
         type: "confirm",
         name: "delete",
         message: `Are you sure you want to delete '${path}'?`
       });
       if (!res.delete) {
+        debug(`User declined, aborting`);
         log("Doing nothing.");
         return;
       }
+      debug(`User confirmed`);
+    } else {
+      debug(`Force flag set, skipping confirmation`);
     }
+    debug(`Sending delete command to SSM for: ${path}`);
     await client.send(
       new import_client_ssm3.DeleteParameterCommand({
         Name: path
       })
     );
+    debug(`Parameter deleted successfully`);
     log("\u{1F44D}");
   };
 };
@@ -393,6 +445,16 @@ Example: "/root/myParam" or "service/secret" (which translates to, "${buildPath(
 (0, import_yargs.default)(process.argv.slice(2)).env("AXIOM").scriptName("axiom").option("config", {
   alias: "c",
   string: true
+}).option("debug", {
+  alias: "d",
+  type: "boolean",
+  description: "Enable debug output",
+  default: false,
+  global: true
+}).middleware((argv) => {
+  if (argv.debug) {
+    process.env.AXIOM_DEBUG = "true";
+  }
 }).command(new Config()).command(new ParamsCommand()).strict().usage(
   `
 Axiom - an AWS focused config cli

package/dist/bin/axiom.mjs

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import "../chunk-QT654PKF.mjs";
+import "../chunk-CORLQJO7.mjs";

package/dist/{chunk-QT654PKF.mjs → chunk-CORLQJO7.mjs}

@@ -3,6 +3,16 @@ import yargs from "yargs";
 
 // src/commands/config.ts
 import { loadConfig } from "@dsmrt/axiom-config";
+
+// src/debug.ts
+var isDebugEnabled = () => process.env.AXIOM_DEBUG === "true" || process.env.AXIOM_DEBUG === "1";
+var debug = (message, ...args) => {
+  if (isDebugEnabled()) {
+    console.error(`[axiom:cli] ${message}`, ...args);
+  }
+};
+
+// src/commands/config.ts
 var Config = class {
   command = "config";
   describe = "print the config";
@@ -13,9 +23,13 @@ var Config = class {
     return args;
   };
   handler = async (args) => {
-    console.log(JSON.stringify(await this.loadConfig(args)));
+    debug(`Config command handler called with env: ${args.env}`);
+    const config = await this.loadConfig(args);
+    debug(`Config loaded successfully, outputting as JSON`);
+    console.log(JSON.stringify(config));
   };
   loadConfig = async (args) => {
+    debug(`Loading config with env: ${args.env}`);
     return loadConfig(args);
   };
 };
@@ -34,9 +48,10 @@ var ParamsCommand = class {
 };
 
 // src/commands/params/get.ts
-import { loadConfig as loadConfig2 } from "@dsmrt/axiom-config";
-import { ParameterCollection } from "@dsmrt/axiom-aws-sdk";
 import { SSMClient } from "@aws-sdk/client-ssm";
+import { ParameterCollection } from "@dsmrt/axiom-aws-sdk";
+import { loadConfig as loadConfig2 } from "@dsmrt/axiom-config";
+import chalk from "chalk";
 
 // src/aws/credentials-provider.ts
 import { fromNodeProviderChain } from "@aws-sdk/credential-providers";
@@ -47,8 +62,8 @@ import {
 import inquirer from "inquirer";
 
 // src/cache.ts
-import os from "os";
 import fs from "fs";
+import os from "os";
 var DEFAULT_DIRECTORY = `${os.homedir()}/.axiom/cache`;
 var cache_default = class {
   constructor(cacheDir = DEFAULT_DIRECTORY) {
@@ -177,38 +192,31 @@ var awsOptions = () => {
   };
 };
 
-// src/commands/params/utils.ts
-var buildPath = (config, path) => {
-  if (path === void 0) {
-    return config.aws?.baseParameterPath;
-  }
-  if (/^\//.test(path)) {
-    return path;
-  }
-  return `${config.aws?.baseParameterPath.replace(/\/$/, "")}/${path}`;
-};
-
 // src/commands/params/get.ts
-import chalk from "chalk";
 var GetCommand = class {
   command = "get [path]";
   describe = "Get all parameters under the base path";
   builder = (args) => {
-    const config = loadConfig2();
     args.options({ ...commonOptions(), ...awsOptions() });
     args.positional("path", {
       type: "string",
       describe: `OPTIONAL path to parameter. Supports absolute and relative paths.
 Example:
-	"/root/myParam" or "service/secret" (which translates to, "${buildPath(
-        config,
-        "service/secret"
-      )})`
+	"/root/myParam" or "service/secret"`
     });
     return args;
   };
   handler = async (args) => {
-    const config = loadConfig2({ env: args.env });
+    debug(
+      `Get command handler called with env: ${args.env}, path: ${args.path}`
+    );
+    const config = await loadConfig2({ env: args.env });
+    debug(
+      `Config loaded successfully, base parameter path: ${config.aws?.baseParameterPath}`
+    );
+    debug(
+      `Creating SSM client with region: ${config.aws.region}, profile: ${config.aws.profile}`
+    );
     const collection = new ParameterCollection(
       config.aws?.baseParameterPath,
       new SSMClient({
@@ -221,11 +229,13 @@ Example:
         })
       })
     );
+    debug(`Fetching parameters from SSM...`);
     const params = await collection.get();
+    debug(`Retrieved ${params.size} parameters`);
     params.forEach((parameter) => {
       console.log(
         chalk.gray(
-          parameter.Name?.replace(/\/([^/]+)$/, "/" + chalk.bold.green("$1"))
+          parameter.Name?.replace(/\/([^/]+)$/, `/${chalk.bold.green("$1")}`)
         ),
         chalk.bold.white(parameter.Value)
       );
@@ -234,26 +244,35 @@ Example:
 };
 
 // src/commands/params/set.ts
-import { loadConfig as loadConfig3 } from "@dsmrt/axiom-config";
-import inquirer2 from "inquirer";
 import {
-  SSMClient as SSMClient2,
+  ParameterType,
   PutParameterCommand,
-  ParameterType
+  SSMClient as SSMClient2
 } from "@aws-sdk/client-ssm";
+import { loadConfig as loadConfig3 } from "@dsmrt/axiom-config";
 import chalk2 from "chalk";
+import inquirer2 from "inquirer";
+
+// src/commands/params/utils.ts
+var buildPath = (config, path) => {
+  if (path === void 0) {
+    return config.aws?.baseParameterPath;
+  }
+  if (/^\//.test(path)) {
+    return path;
+  }
+  return `${config.aws?.baseParameterPath.replace(/\/$/, "")}/${path}`;
+};
+
+// src/commands/params/set.ts
 var SetCommand = class {
   command = "set <path> <value>";
   describe = "Set all parameters under the base path";
   builder = (args) => {
-    const config = loadConfig3();
     args.positional("path", {
       type: "string",
       describe: `Path to parameter. Supports absolute and relative paths.
-Example: "/root/myParam" or "service/secret" (which translates to, "${buildPath(
-        config,
-        "service/secret"
-      )})`
+Example: "/root/myParam" or "service/secret"`
     });
     args.demandOption("path", "Path is required");
     args.positional("value", {
@@ -282,53 +301,68 @@ Example: "/root/myParam" or "service/secret" (which translates to, "${buildPath(
     });
   };
   handler = async (args) => {
-    const config = loadConfig3({ env: args.env });
+    debug(
+      `Set command handler called with path: ${args.path}, secure: ${args.secure}, overwrite: ${args.overwrite}, force: ${args.force}`
+    );
+    const config = await loadConfig3({ env: args.env });
+    debug(
+      `Config loaded successfully, base parameter path: ${config.aws?.baseParameterPath}`
+    );
+    const fullPath = buildPath(config, args.path);
+    debug(`Full parameter path: ${fullPath}`);
     if (args.force !== true) {
+      debug(`Prompting user for confirmation...`);
       const res = await inquirer2.prompt({
         type: "confirm",
         name: "setParam",
         message: `Are you sure you want to set '${args.path}'?`
       });
       if (!res.setParam) {
+        debug(`User declined, aborting`);
         console.log("Doing nothing.");
         return;
       }
+      debug(`User confirmed`);
+    } else {
+      debug(`Force flag set, skipping confirmation`);
     }
+    debug(
+      `Creating SSM client with region: ${config.aws.region}, profile: ${config.aws.profile}`
+    );
     const client = new SSMClient2({
       region: config.aws.region,
       credentials: await CachedCredentialProvider(config.aws)
     });
+    debug(
+      `Sending parameter to SSM with type: ${args.secure ? "SecureString" : "String"}`
+    );
     const params = await client.send(
       new PutParameterCommand({
-        Name: buildPath(config, args.path),
+        Name: fullPath,
         Value: args.value,
         Type: args.secure ? ParameterType.SECURE_STRING : ParameterType.STRING,
         Overwrite: args.overwrite
       })
     );
+    debug(`Parameter set successfully, version: ${params.Version}`);
     console.log(chalk2.green("Version: "), chalk2.white.bold(params.Version));
   };
 };
 
 // src/commands/params/delete.ts
+import { DeleteParameterCommand, SSMClient as SSMClient3 } from "@aws-sdk/client-ssm";
 import { loadConfig as loadConfig4 } from "@dsmrt/axiom-config";
 import inquirer3 from "inquirer";
-import { SSMClient as SSMClient3, DeleteParameterCommand } from "@aws-sdk/client-ssm";
 var log = console.log;
 var DeleteCommand = class {
   command = "delete <path>";
   describe = "Delete SSM parameters";
   client;
   builder = (args) => {
-    const config = loadConfig4();
     args.positional("path", {
       type: "string",
       describe: `Path to parameter. Supports absolute and relative paths.
-Example: "/root/myParam" or "service/secret" (which translates to, "${buildPath(
-        config,
-        "service/secret"
-      )})`,
-      default: config.aws?.baseParameterPath,
+Example: "/root/myParam" or "service/secret"`,
       demandOption: true
     }).demandOption("path", "Path is required");
     args.option("force", {
@@ -340,33 +374,51 @@ Example: "/root/myParam" or "service/secret" (which translates to, "${buildPath(
     return args;
   };
   handler = async (args) => {
-    const config = loadConfig4({ env: args.env });
+    debug(
+      `Delete command handler called with path: ${args.path}, force: ${args.force}`
+    );
+    const config = await loadConfig4({ env: args.env });
+    debug(
+      `Config loaded successfully, base parameter path: ${config.aws?.baseParameterPath}`
+    );
     const path = buildPath(args, args.path);
+    debug(`Full parameter path: ${path}`);
+    debug(
+      `Creating SSM client with region: ${config.aws?.region}, profile: ${config.aws?.profile}`
+    );
     const client = new SSMClient3({
       region: config.aws?.region,
       credentials: await CachedCredentialProvider(config.aws)
     });
     if (path === args.aws.baseParameterPath) {
+      debug(`Delete blocked: path matches base parameter path`);
       throw new Error(
         `Deleting the path (path: ${path}) that matches the base path (awsSsmParameterPath: ${args.awsSsmParameterPath}) is prohibited.`
       );
     }
     if (args.force !== true) {
+      debug(`Prompting user for confirmation...`);
       const res = await inquirer3.prompt({
         type: "confirm",
         name: "delete",
         message: `Are you sure you want to delete '${path}'?`
       });
       if (!res.delete) {
+        debug(`User declined, aborting`);
         log("Doing nothing.");
         return;
       }
+      debug(`User confirmed`);
+    } else {
+      debug(`Force flag set, skipping confirmation`);
     }
+    debug(`Sending delete command to SSM for: ${path}`);
     await client.send(
       new DeleteParameterCommand({
         Name: path
       })
     );
+    debug(`Parameter deleted successfully`);
     log("\u{1F44D}");
   };
 };
@@ -375,6 +427,16 @@ Example: "/root/myParam" or "service/secret" (which translates to, "${buildPath(
 yargs(process.argv.slice(2)).env("AXIOM").scriptName("axiom").option("config", {
   alias: "c",
   string: true
+}).option("debug", {
+  alias: "d",
+  type: "boolean",
+  description: "Enable debug output",
+  default: false,
+  global: true
+}).middleware((argv) => {
+  if (argv.debug) {
+    process.env.AXIOM_DEBUG = "true";
+  }
 }).command(new Config()).command(new ParamsCommand()).strict().usage(
   `
 Axiom - an AWS focused config cli
@@ -385,10 +447,10 @@ USAGE:
 ).demandCommand(1, "").alias("h", "help").argv;
 
 export {
-  commonOptions,
-  awsOptions,
   Config,
   ParamsCommand,
+  commonOptions,
+  awsOptions,
   GetCommand,
   SetCommand,
   DeleteCommand

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { Options as Options$1, CommandModule, CommandBuilder, ArgumentsCamelCase, Argv } from 'yargs';
 import * as _dsmrt_axiom_config from '@dsmrt/axiom-config';
 import { AwsConfigs, Config as Config$1 } from '@dsmrt/axiom-config';
+import { CommandModule, CommandBuilder, ArgumentsCamelCase, Argv, Options as Options$1 } from 'yargs';
 import { SSMClient } from '@aws-sdk/client-ssm';
 
 interface Item {
@@ -8,13 +8,6 @@ interface Item {
     data: unknown;
 }
 
-declare const commonOptions: () => {
-    [key: string]: Options$1;
-};
-declare const awsOptions: () => {
-    [key: string]: Options$1;
-};
-
 interface ConfigOptions {
     env: string;
 }
@@ -26,8 +19,7 @@ declare class Config<U extends ConfigOptions> implements CommandModule<object, U
     loadConfig: (args: ConfigOptions) => Promise<_dsmrt_axiom_config.ConfigContainer & object>;
 }
 
-interface Options {
-}
+type Options = object;
 declare class ParamsCommand<U extends Options> implements CommandModule<object, U> {
     command: string;
     describe: string;
@@ -75,4 +67,11 @@ declare class DeleteCommand<U extends config> implements CommandModule<object, U
     handler: (args: ArgumentsCamelCase<U>) => Promise<void>;
 }
 
+declare const commonOptions: () => {
+    [key: string]: Options$1;
+};
+declare const awsOptions: () => {
+    [key: string]: Options$1;
+};
+
 export { Config, DeleteCommand, type DeleteOptions, GetCommand, type GetOptions, type Item, ParamsCommand, SetCommand, type SetOptions, awsOptions, commonOptions };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { Options as Options$1, CommandModule, CommandBuilder, ArgumentsCamelCase, Argv } from 'yargs';
 import * as _dsmrt_axiom_config from '@dsmrt/axiom-config';
 import { AwsConfigs, Config as Config$1 } from '@dsmrt/axiom-config';
+import { CommandModule, CommandBuilder, ArgumentsCamelCase, Argv, Options as Options$1 } from 'yargs';
 import { SSMClient } from '@aws-sdk/client-ssm';
 
 interface Item {
@@ -8,13 +8,6 @@ interface Item {
     data: unknown;
 }
 
-declare const commonOptions: () => {
-    [key: string]: Options$1;
-};
-declare const awsOptions: () => {
-    [key: string]: Options$1;
-};
-
 interface ConfigOptions {
     env: string;
 }
@@ -26,8 +19,7 @@ declare class Config<U extends ConfigOptions> implements CommandModule<object, U
     loadConfig: (args: ConfigOptions) => Promise<_dsmrt_axiom_config.ConfigContainer & object>;
 }
 
-interface Options {
-}
+type Options = object;
 declare class ParamsCommand<U extends Options> implements CommandModule<object, U> {
     command: string;
     describe: string;
@@ -75,4 +67,11 @@ declare class DeleteCommand<U extends config> implements CommandModule<object, U
     handler: (args: ArgumentsCamelCase<U>) => Promise<void>;
 }
 
+declare const commonOptions: () => {
+    [key: string]: Options$1;
+};
+declare const awsOptions: () => {
+    [key: string]: Options$1;
+};
+
 export { Config, DeleteCommand, type DeleteOptions, GetCommand, type GetOptions, type Item, ParamsCommand, SetCommand, type SetOptions, awsOptions, commonOptions };

package/dist/index.js

@@ -40,86 +40,21 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/cache.ts
-var import_os = __toESM(require("os"));
-var import_fs = __toESM(require("fs"));
-var DEFAULT_DIRECTORY = `${import_os.default.homedir()}/.axiom/cache`;
-var cache_default = class {
-  constructor(cacheDir = DEFAULT_DIRECTORY) {
-    this.cacheDir = cacheDir;
-  }
-  get(name) {
-    const file = `${this.cacheDir}/${name}`;
-    if (!import_fs.default.existsSync(file)) {
-      return;
-    }
-    const buffer = import_fs.default.readFileSync(file);
-    const item = JSON.parse(buffer.toString());
-    if (item.expires === void 0) {
-      return item.data;
-    }
-    item.expires = new Date(item.expires);
-    if (item.expires < /* @__PURE__ */ new Date()) {
-      this.delete(name);
-      return;
-    }
-    return item.data;
-  }
-  delete(name) {
-    import_fs.default.unlinkSync(`${this.cacheDir}/${name}`);
-  }
-  set(name, value, expires) {
-    if (!import_fs.default.existsSync(this.cacheDir)) {
-      import_fs.default.mkdirSync(this.cacheDir, {
-        recursive: true,
-        mode: 448
-      });
-    }
-    import_fs.default.writeFileSync(
-      `${this.cacheDir}/${name}`,
-      JSON.stringify({
-        expires,
-        data: value
-      }),
-      {
-        mode: 384
-      }
-    );
-  }
-};
+// src/bin/axiom.ts
+var import_yargs = __toESM(require("yargs"));
 
-// src/options.ts
-var commonOptions = () => {
-  return {
-    env: {
-      string: true,
-      desc: "Environment name like, prod, staging, dev, etc."
-    }
-  };
-};
-var awsOptions = () => {
-  return {
-    account: {
-      string: true,
-      desc: "AWS Account number like, 1243944546"
-    },
-    region: {
-      string: true,
-      desc: "AWS region like, us-east-1"
-    },
-    profile: {
-      string: true,
-      desc: "AWS configured profile"
-    },
-    baseParameterPath: {
-      string: true,
-      desc: "SSM parameter path base where configs like secrets and infrastucture managed items are set"
-    }
-  };
+// src/commands/config.ts
+var import_axiom_config = require("@dsmrt/axiom-config");
+
+// src/debug.ts
+var isDebugEnabled = () => process.env.AXIOM_DEBUG === "true" || process.env.AXIOM_DEBUG === "1";
+var debug = (message, ...args) => {
+  if (isDebugEnabled()) {
+    console.error(`[axiom:cli] ${message}`, ...args);
+  }
 };
 
 // src/commands/config.ts
-var import_axiom_config = require("@dsmrt/axiom-config");
 var Config = class {
   command = "config";
   describe = "print the config";
@@ -130,9 +65,13 @@ var Config = class {
     return args;
   };
   handler = async (args) => {
-    console.log(JSON.stringify(await this.loadConfig(args)));
+    debug(`Config command handler called with env: ${args.env}`);
+    const config = await this.loadConfig(args);
+    debug(`Config loaded successfully, outputting as JSON`);
+    console.log(JSON.stringify(config));
   };
   loadConfig = async (args) => {
+    debug(`Loading config with env: ${args.env}`);
     return (0, import_axiom_config.loadConfig)(args);
   };
 };
@@ -151,14 +90,65 @@ var ParamsCommand = class {
 };
 
 // src/commands/params/get.ts
-var import_axiom_config2 = require("@dsmrt/axiom-config");
-var import_axiom_aws_sdk = require("@dsmrt/axiom-aws-sdk");
 var import_client_ssm = require("@aws-sdk/client-ssm");
+var import_axiom_aws_sdk = require("@dsmrt/axiom-aws-sdk");
+var import_axiom_config2 = require("@dsmrt/axiom-config");
+var import_chalk = __toESM(require("chalk"));
 
 // src/aws/credentials-provider.ts
 var import_credential_providers = require("@aws-sdk/credential-providers");
 var import_client_sts = require("@aws-sdk/client-sts");
 var import_inquirer = __toESM(require("inquirer"));
+
+// src/cache.ts
+var import_node_fs = __toESM(require("fs"));
+var import_node_os = __toESM(require("os"));
+var DEFAULT_DIRECTORY = `${import_node_os.default.homedir()}/.axiom/cache`;
+var cache_default = class {
+  constructor(cacheDir = DEFAULT_DIRECTORY) {
+    this.cacheDir = cacheDir;
+  }
+  get(name) {
+    const file = `${this.cacheDir}/${name}`;
+    if (!import_node_fs.default.existsSync(file)) {
+      return;
+    }
+    const buffer = import_node_fs.default.readFileSync(file);
+    const item = JSON.parse(buffer.toString());
+    if (item.expires === void 0) {
+      return item.data;
+    }
+    item.expires = new Date(item.expires);
+    if (item.expires < /* @__PURE__ */ new Date()) {
+      this.delete(name);
+      return;
+    }
+    return item.data;
+  }
+  delete(name) {
+    import_node_fs.default.unlinkSync(`${this.cacheDir}/${name}`);
+  }
+  set(name, value, expires) {
+    if (!import_node_fs.default.existsSync(this.cacheDir)) {
+      import_node_fs.default.mkdirSync(this.cacheDir, {
+        recursive: true,
+        mode: 448
+      });
+    }
+    import_node_fs.default.writeFileSync(
+      `${this.cacheDir}/${name}`,
+      JSON.stringify({
+        expires,
+        data: value
+      }),
+      {
+        mode: 384
+      }
+    );
+  }
+};
+
+// src/aws/credentials-provider.ts
 var CACHE_KEY_PREFIX = "axiom#aws-credentials";
 var cache = new cache_default();
 var returnCredentialsFromAssumerole = (creds) => {
@@ -211,38 +201,61 @@ var CachedCredentialProvider = (config) => {
   return CachedCredentialViaProfileAndRegion(config.profile, config.region);
 };
 
-// src/commands/params/utils.ts
-var buildPath = (config, path) => {
-  if (path === void 0) {
-    return config.aws?.baseParameterPath;
-  }
-  if (/^\//.test(path)) {
-    return path;
-  }
-  return `${config.aws?.baseParameterPath.replace(/\/$/, "")}/${path}`;
+// src/options.ts
+var commonOptions = () => {
+  return {
+    env: {
+      string: true,
+      desc: "Environment name like, prod, staging, dev, etc."
+    }
+  };
+};
+var awsOptions = () => {
+  return {
+    account: {
+      string: true,
+      desc: "AWS Account number like, 1243944546"
+    },
+    region: {
+      string: true,
+      desc: "AWS region like, us-east-1"
+    },
+    profile: {
+      string: true,
+      desc: "AWS configured profile"
+    },
+    baseParameterPath: {
+      string: true,
+      desc: "SSM parameter path base where configs like secrets and infrastucture managed items are set"
+    }
+  };
 };
 
 // src/commands/params/get.ts
-var import_chalk = __toESM(require("chalk"));
 var GetCommand = class {
   command = "get [path]";
   describe = "Get all parameters under the base path";
   builder = (args) => {
-    const config = (0, import_axiom_config2.loadConfig)();
     args.options({ ...commonOptions(), ...awsOptions() });
     args.positional("path", {
       type: "string",
       describe: `OPTIONAL path to parameter. Supports absolute and relative paths.
 Example:
-	"/root/myParam" or "service/secret" (which translates to, "${buildPath(
-        config,
-        "service/secret"
-      )})`
+	"/root/myParam" or "service/secret"`
     });
     return args;
   };
   handler = async (args) => {
-    const config = (0, import_axiom_config2.loadConfig)({ env: args.env });
+    debug(
+      `Get command handler called with env: ${args.env}, path: ${args.path}`
+    );
+    const config = await (0, import_axiom_config2.loadConfig)({ env: args.env });
+    debug(
+      `Config loaded successfully, base parameter path: ${config.aws?.baseParameterPath}`
+    );
+    debug(
+      `Creating SSM client with region: ${config.aws.region}, profile: ${config.aws.profile}`
+    );
     const collection = new import_axiom_aws_sdk.ParameterCollection(
       config.aws?.baseParameterPath,
       new import_client_ssm.SSMClient({
@@ -255,11 +268,13 @@ Example:
         })
       })
     );
+    debug(`Fetching parameters from SSM...`);
     const params = await collection.get();
+    debug(`Retrieved ${params.size} parameters`);
     params.forEach((parameter) => {
       console.log(
         import_chalk.default.gray(
-          parameter.Name?.replace(/\/([^/]+)$/, "/" + import_chalk.default.bold.green("$1"))
+          parameter.Name?.replace(/\/([^/]+)$/, `/${import_chalk.default.bold.green("$1")}`)
         ),
         import_chalk.default.bold.white(parameter.Value)
       );
@@ -268,22 +283,31 @@ Example:
 };
 
 // src/commands/params/set.ts
-var import_axiom_config3 = require("@dsmrt/axiom-config");
-var import_inquirer2 = __toESM(require("inquirer"));
 var import_client_ssm2 = require("@aws-sdk/client-ssm");
+var import_axiom_config3 = require("@dsmrt/axiom-config");
 var import_chalk2 = __toESM(require("chalk"));
+var import_inquirer2 = __toESM(require("inquirer"));
+
+// src/commands/params/utils.ts
+var buildPath = (config, path) => {
+  if (path === void 0) {
+    return config.aws?.baseParameterPath;
+  }
+  if (/^\//.test(path)) {
+    return path;
+  }
+  return `${config.aws?.baseParameterPath.replace(/\/$/, "")}/${path}`;
+};
+
+// src/commands/params/set.ts
 var SetCommand = class {
   command = "set <path> <value>";
   describe = "Set all parameters under the base path";
   builder = (args) => {
-    const config = (0, import_axiom_config3.loadConfig)();
     args.positional("path", {
       type: "string",
       describe: `Path to parameter. Supports absolute and relative paths.
-Example: "/root/myParam" or "service/secret" (which translates to, "${buildPath(
-        config,
-        "service/secret"
-      )})`
+Example: "/root/myParam" or "service/secret"`
     });
     args.demandOption("path", "Path is required");
     args.positional("value", {
@@ -312,53 +336,68 @@ Example: "/root/myParam" or "service/secret" (which translates to, "${buildPath(
     });
   };
   handler = async (args) => {
-    const config = (0, import_axiom_config3.loadConfig)({ env: args.env });
+    debug(
+      `Set command handler called with path: ${args.path}, secure: ${args.secure}, overwrite: ${args.overwrite}, force: ${args.force}`
+    );
+    const config = await (0, import_axiom_config3.loadConfig)({ env: args.env });
+    debug(
+      `Config loaded successfully, base parameter path: ${config.aws?.baseParameterPath}`
+    );
+    const fullPath = buildPath(config, args.path);
+    debug(`Full parameter path: ${fullPath}`);
     if (args.force !== true) {
+      debug(`Prompting user for confirmation...`);
       const res = await import_inquirer2.default.prompt({
         type: "confirm",
         name: "setParam",
         message: `Are you sure you want to set '${args.path}'?`
       });
       if (!res.setParam) {
+        debug(`User declined, aborting`);
         console.log("Doing nothing.");
         return;
       }
+      debug(`User confirmed`);
+    } else {
+      debug(`Force flag set, skipping confirmation`);
     }
+    debug(
+      `Creating SSM client with region: ${config.aws.region}, profile: ${config.aws.profile}`
+    );
     const client = new import_client_ssm2.SSMClient({
       region: config.aws.region,
       credentials: await CachedCredentialProvider(config.aws)
     });
+    debug(
+      `Sending parameter to SSM with type: ${args.secure ? "SecureString" : "String"}`
+    );
     const params = await client.send(
       new import_client_ssm2.PutParameterCommand({
-        Name: buildPath(config, args.path),
+        Name: fullPath,
         Value: args.value,
         Type: args.secure ? import_client_ssm2.ParameterType.SECURE_STRING : import_client_ssm2.ParameterType.STRING,
         Overwrite: args.overwrite
       })
     );
+    debug(`Parameter set successfully, version: ${params.Version}`);
     console.log(import_chalk2.default.green("Version: "), import_chalk2.default.white.bold(params.Version));
   };
 };
 
 // src/commands/params/delete.ts
+var import_client_ssm3 = require("@aws-sdk/client-ssm");
 var import_axiom_config4 = require("@dsmrt/axiom-config");
 var import_inquirer3 = __toESM(require("inquirer"));
-var import_client_ssm3 = require("@aws-sdk/client-ssm");
 var log = console.log;
 var DeleteCommand = class {
   command = "delete <path>";
   describe = "Delete SSM parameters";
   client;
   builder = (args) => {
-    const config = (0, import_axiom_config4.loadConfig)();
     args.positional("path", {
       type: "string",
       describe: `Path to parameter. Supports absolute and relative paths.
-Example: "/root/myParam" or "service/secret" (which translates to, "${buildPath(
-        config,
-        "service/secret"
-      )})`,
-      default: config.aws?.baseParameterPath,
+Example: "/root/myParam" or "service/secret"`,
       demandOption: true
     }).demandOption("path", "Path is required");
     args.option("force", {
@@ -370,42 +409,69 @@ Example: "/root/myParam" or "service/secret" (which translates to, "${buildPath(
     return args;
   };
   handler = async (args) => {
-    const config = (0, import_axiom_config4.loadConfig)({ env: args.env });
+    debug(
+      `Delete command handler called with path: ${args.path}, force: ${args.force}`
+    );
+    const config = await (0, import_axiom_config4.loadConfig)({ env: args.env });
+    debug(
+      `Config loaded successfully, base parameter path: ${config.aws?.baseParameterPath}`
+    );
     const path = buildPath(args, args.path);
+    debug(`Full parameter path: ${path}`);
+    debug(
+      `Creating SSM client with region: ${config.aws?.region}, profile: ${config.aws?.profile}`
+    );
     const client = new import_client_ssm3.SSMClient({
       region: config.aws?.region,
       credentials: await CachedCredentialProvider(config.aws)
     });
     if (path === args.aws.baseParameterPath) {
+      debug(`Delete blocked: path matches base parameter path`);
       throw new Error(
         `Deleting the path (path: ${path}) that matches the base path (awsSsmParameterPath: ${args.awsSsmParameterPath}) is prohibited.`
       );
     }
     if (args.force !== true) {
+      debug(`Prompting user for confirmation...`);
       const res = await import_inquirer3.default.prompt({
         type: "confirm",
         name: "delete",
         message: `Are you sure you want to delete '${path}'?`
       });
       if (!res.delete) {
+        debug(`User declined, aborting`);
         log("Doing nothing.");
         return;
       }
+      debug(`User confirmed`);
+    } else {
+      debug(`Force flag set, skipping confirmation`);
     }
+    debug(`Sending delete command to SSM for: ${path}`);
     await client.send(
       new import_client_ssm3.DeleteParameterCommand({
         Name: path
       })
     );
+    debug(`Parameter deleted successfully`);
     log("\u{1F44D}");
   };
 };
 
 // src/bin/axiom.ts
-var import_yargs = __toESM(require("yargs"));
 (0, import_yargs.default)(process.argv.slice(2)).env("AXIOM").scriptName("axiom").option("config", {
   alias: "c",
   string: true
+}).option("debug", {
+  alias: "d",
+  type: "boolean",
+  description: "Enable debug output",
+  default: false,
+  global: true
+}).middleware((argv) => {
+  if (argv.debug) {
+    process.env.AXIOM_DEBUG = "true";
+  }
 }).command(new Config()).command(new ParamsCommand()).strict().usage(
   `
 Axiom - an AWS focused config cli

package/dist/index.mjs

@@ -6,7 +6,7 @@ import {
   SetCommand,
   awsOptions,
   commonOptions
-} from "./chunk-QT654PKF.mjs";
+} from "./chunk-CORLQJO7.mjs";
 export {
   Config,
   DeleteCommand,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsmrt/axiom-cli",
-  "version": "0.3.1",
+  "version": "1.1.0",
   "description": "axiom cli for managing configs including secrets",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -28,20 +28,17 @@
   },
   "license": "MIT",
   "devDependencies": {
+    "@biomejs/biome": "^2.3.8",
     "@changesets/cli": "^2.27.11",
     "@types/inquirer": "^8.2.10",
-    "@types/node": "^20.17.10",
+    "@types/node": "^22.12.0",
     "@types/yargs": "^17.0.33",
-    "@typescript-eslint/eslint-plugin": "^6.21.0",
-    "@typescript-eslint/parser": "^6.21.0",
-    "@vitest/coverage-v8": "^1.6.0",
+    "@vitest/coverage-v8": "^4.0.0",
     "aws-sdk-client-mock": "^3.1.0",
-    "eslint": "^8.57.1",
-    "prettier": "^3.4.2",
     "ts-node": "^10.9.2",
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
-    "vitest": "^1.6.0"
+    "vitest": "^4.0.0"
   },
   "dependencies": {
     "@aws-sdk/client-ssm": "^3.716.0",
@@ -51,12 +48,12 @@
     "chalk": "^4.1.2",
     "inquirer": "^8.2.6",
     "yargs": "^17.7.2",
-    "@dsmrt/axiom-aws-sdk": "^0.2.2",
-    "@dsmrt/axiom-config": "^0.2.3"
+    "@dsmrt/axiom-aws-sdk": "^1.0.0",
+    "@dsmrt/axiom-config": "^1.1.0"
   },
   "scripts": {
-    "lint": "eslint ./src/ ./src/aws ./src/bin --ext .ts",
-    "lint:fix": "eslint ./src/ ./src/aws ./src/bin --ext .ts --fix",
+    "lint": "biome lint",
+    "lint:fix": "biome lint --fix",
     "test": "vitest run --coverage",
     "watch": "vitest watch --coverage",
     "build": "tsup --entry ./src/bin/axiom.ts --entry ./src/index.ts --format cjs,esm --dts --clean",

package/tsconfig.json

@@ -1,12 +1,12 @@
 {
-  "compilerOptions": {
-    "target": "es2022",
-    "module": "commonjs",
-    "esModuleInterop": true,
-    "forceConsistentCasingInFileNames": true,
-    "strict": true,
-    "skipLibCheck": true,
-    "noEmit": true
-  },
-  "include": ["src/index.ts"]
+	"compilerOptions": {
+		"target": "es2022",
+		"module": "commonjs",
+		"esModuleInterop": true,
+		"forceConsistentCasingInFileNames": true,
+		"strict": true,
+		"skipLibCheck": true,
+		"noEmit": true
+	},
+	"include": ["src/index.ts"]
 }

package/vitest.config.mts

@@ -2,13 +2,13 @@
 import { defineConfig } from "vitest/config";
 
 export default defineConfig({
-  test: {
-    include: ["src/**/*.test.ts"],
-    coverage: {
-      provider: "v8",
-      all: true,
-      exclude: ["lib/**/*", "src/__mocks__/**/*"],
-      reporter: ["text-summary", "json-summary"],
-    },
-  },
+	test: {
+		include: ["src/**/*.test.ts"],
+		coverage: {
+			provider: "v8",
+			all: true,
+			exclude: ["lib/**/*", "src/__mocks__/**/*"],
+			reporter: ["text-summary", "json-summary"],
+		},
+	},
 });