ssm-to-env-cli 1.0.0

package/README.md

@@ -0,0 +1,48 @@
+# config-loader-demo
+
+A CLI tool that loads AWS SSM Parameter Store values and outputs them as JSON, `.env` format, or shell exports. Built on top of [`aws-parameters-store`](https://www.npmjs.com/package/aws-parameters-store).
+
+## Usage
+
+```bash
+# Output as JSON (default)
+npx ts-node src/index.ts /myapp/production/
+
+# Output as .env key=value pairs
+npx ts-node src/index.ts /myapp/staging/ --format env
+
+# Output as shell exports (useful for sourcing)
+npx ts-node src/index.ts /myapp/dev/ --format export >> .env
+
+# Specify region
+npx ts-node src/index.ts /myapp/production/ --region eu-west-1
+```
+
+## How it works
+
+1. Calls `getParams(namespace, { region })` from `aws-parameters-store`
+2. Gets back a nested object based on the SSM parameter path hierarchy
+3. Flattens + formats into the desired output (JSON, env, or export)
+
+## Example
+
+Given these SSM parameters:
+```
+/myapp/prod/database/host = "db.example.com"
+/myapp/prod/database/port = "5432"
+/myapp/prod/redis/url = "redis://cache:6379"
+/myapp/prod/features/dark_mode = true
+```
+
+Running:
+```bash
+npx ts-node src/index.ts /myapp/prod/ --format env
+```
+
+Outputs:
+```
+DATABASE_HOST=db.example.com
+DATABASE_PORT=5432
+REDIS_URL=redis://cache:6379
+FEATURES_DARK_MODE=true
+```

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const aws_parameters_store_1 = __importDefault(require("aws-parameters-store"));
+function flattenObject(obj, prefix = '') {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        const envKey = prefix ? `${prefix}_${key}`.toUpperCase() : key.toUpperCase();
+        if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+            Object.assign(result, flattenObject(value, envKey));
+        }
+        else {
+            result[envKey] = String(value);
+        }
+    }
+    return result;
+}
+function formatOutput(config, format) {
+    switch (format) {
+        case 'json':
+            return JSON.stringify(config, null, 2);
+        case 'env': {
+            const flat = flattenObject(config);
+            return Object.entries(flat)
+                .map(([key, value]) => `${key}=${value}`)
+                .join('\n');
+        }
+        case 'export': {
+            const flat = flattenObject(config);
+            return Object.entries(flat)
+                .map(([key, value]) => `export ${key}="${value}"`)
+                .join('\n');
+        }
+    }
+}
+async function loadConfig(namespace, region, format) {
+    console.error(`Loading parameters from: ${namespace} (region: ${region})`);
+    const config = await (0, aws_parameters_store_1.default)(namespace, { region });
+    const output = formatOutput(config, format);
+    console.log(output);
+}
+// --- CLI ---
+function printUsage() {
+    console.log(`
+Usage: npx ts-node src/index.ts <namespace> [options]
+
+Options:
+  --region <region>    AWS region (default: us-east-1)
+  --format <format>    Output format: json | env | export (default: json)
+  --help               Show this help
+
+Examples:
+  npx ts-node src/index.ts /myapp/production/
+  npx ts-node src/index.ts /myapp/staging/ --region eu-west-1 --format env
+  npx ts-node src/index.ts /myapp/dev/ --format export >> .env
+`);
+}
+function parseArgs(args) {
+    if (args.length === 0 || args.includes('--help')) {
+        printUsage();
+        process.exit(0);
+    }
+    const namespace = args[0];
+    let region = 'us-east-1';
+    let format = 'json';
+    for (let i = 1; i < args.length; i++) {
+        if (args[i] === '--region' && args[i + 1]) {
+            region = args[++i];
+        }
+        else if (args[i] === '--format' && args[i + 1]) {
+            const f = args[++i];
+            if (f === 'json' || f === 'env' || f === 'export') {
+                format = f;
+            }
+            else {
+                console.error(`Invalid format: ${f}. Use json, env, or export.`);
+                process.exit(1);
+            }
+        }
+    }
+    return { namespace, region, format };
+}
+const { namespace, region, format } = parseArgs(process.argv.slice(2));
+loadConfig(namespace, region, format).catch((err) => {
+    console.error('Failed to load config:', err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "ssm-to-env-cli",
+  "version": "1.0.0",
+  "description": "CLI tool that loads AWS SSM Parameter Store values and outputs them as JSON, .env, or shell exports",
+  "main": "dist/index.js",
+  "bin": {
+    "ssm-to-env": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["aws", "ssm", "parameter-store", "config", "env", "cli"],
+  "author": "amit.zigelman",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "aws-parameters-store": "^1.0.11"
+  },
+  "devDependencies": {
+    "@types/node": "^26.0.1",
+    "typescript": "^6.0.3"
+  }
+}