envilder 0.4.1 → 0.5.1

package/lib/cli/cli.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * Parses CLI arguments and runs the environment file generator.
+ *
+ * Expects `--map` and `--envfile` options to be provided, with an optional `--profile` for AWS CLI profile selection. Invokes the main process to generate a `.env` file from AWS SSM parameters based on the provided mapping.
+ *
+ * @throws {Error} If either `--map` or `--envfile` arguments are missing.
+ */
+export declare function main(): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/lib/cli/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":";AA4CA;;;;;;GAMG;AACH,wBAAsB,IAAI,kBAkBzB"}

package/lib/cli/cli.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Command } from 'commander';
+import { run } from '../index.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Find the package.json file by traversing up directories
+ * @param startDir The directory to start searching from
+ * @param maxDepth Maximum number of parent directories to check
+ * @returns Path to package.json if found, or null if not found
+ */
+function findPackageJson(startDir, maxDepth = 5) {
+    let currentDir = startDir;
+    let depth = 0;
+    while (depth < maxDepth) {
+        const packagePath = join(currentDir, 'package.json');
+        if (existsSync(packagePath)) {
+            return packagePath;
+        }
+        // Go up one directory
+        const parentDir = dirname(currentDir);
+        if (parentDir === currentDir) {
+            // We've reached the root
+            break;
+        }
+        currentDir = parentDir;
+        depth++;
+    }
+    return null;
+}
+// Get package.json path by searching up from current file
+const packageJsonPath = findPackageJson(__dirname) || join(__dirname, '..', '..', 'package.json');
+const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+/**
+ * Parses CLI arguments and runs the environment file generator.
+ *
+ * Expects `--map` and `--envfile` options to be provided, with an optional `--profile` for AWS CLI profile selection. Invokes the main process to generate a `.env` file from AWS SSM parameters based on the provided mapping.
+ *
+ * @throws {Error} If either `--map` or `--envfile` arguments are missing.
+ */
+export function main() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const program = new Command();
+        program
+            .name('envilder')
+            .description('A CLI tool to generate .env files from AWS SSM parameters')
+            .version(packageJson.version)
+            .requiredOption('--map <path>', 'Path to the JSON file with environment variable mapping')
+            .requiredOption('--envfile <path>', 'Path to the .env file to be generated')
+            .option('--profile <name>', 'AWS CLI profile to use');
+        yield program.parseAsync(process.argv);
+        const options = program.opts();
+        if (!options.map || !options.envfile) {
+            throw new Error('Missing required arguments: --map and --envfile');
+        }
+        yield run(options.map, options.envfile, options.profile);
+    });
+}
+// Execute the CLI
+main().catch((error) => {
+    console.error('🚨 Uh-oh! Looks like Mario fell into the wrong pipe! 🍄💥');
+    console.error(error);
+});
+//# sourceMappingURL=cli.js.map

package/lib/cli/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":";;;;;;;;;;AACA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC;;;;;GAKG;AACH,SAAS,eAAe,CAAC,QAAgB,EAAE,QAAQ,GAAG,CAAC;IACrD,IAAI,UAAU,GAAG,QAAQ,CAAC;IAC1B,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,OAAO,KAAK,GAAG,QAAQ,EAAE,CAAC;QACxB,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;QACrD,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,sBAAsB;QACtB,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,yBAAyB;YACzB,MAAM;QACR,CAAC;QAED,UAAU,GAAG,SAAS,CAAC;QACvB,KAAK,EAAE,CAAC;IACV,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,0DAA0D;AAC1D,MAAM,eAAe,GAAG,eAAe,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;AAClG,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,UAAgB,IAAI;;QACxB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;QAC9B,OAAO;aACJ,IAAI,CAAC,UAAU,CAAC;aAChB,WAAW,CAAC,2DAA2D,CAAC;aACxE,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;aAC5B,cAAc,CAAC,cAAc,EAAE,yDAAyD,CAAC;aACzF,cAAc,CAAC,kBAAkB,EAAE,uCAAuC,CAAC;aAC3E,MAAM,CAAC,kBAAkB,EAAE,wBAAwB,CAAC,CAAC;QAExD,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAE/B,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC;CAAA;AAED,kBAAkB;AAClB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC3E,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Orchestrates the process of fetching environment variable values from AWS SSM Parameter Store and writing them to a local environment file.
+ *
+ * Loads a parameter mapping from a JSON file, retrieves existing environment variables, fetches updated values from SSM (optionally using a specified AWS profile), merges them, and writes the result to the specified environment file.
+ *
+ * @param mapPath - Path to the JSON file mapping environment variable names to SSM parameter names.
+ * @param envFilePath - Path to the local environment file to read and update.
+ * @param profile - Optional AWS profile name to use for credentials.
+ */
+export declare function run(mapPath: string, envFilePath: string, profile?: string): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,wBAAsB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,iBAY/E"}

package/lib/index.js

@@ -0,0 +1,116 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import * as fs from 'node:fs';
+import { GetParameterCommand, SSM } from '@aws-sdk/client-ssm';
+import { fromIni } from '@aws-sdk/credential-providers';
+import * as dotenv from 'dotenv';
+/**
+ * Orchestrates the process of fetching environment variable values from AWS SSM Parameter Store and writing them to a local environment file.
+ *
+ * Loads a parameter mapping from a JSON file, retrieves existing environment variables, fetches updated values from SSM (optionally using a specified AWS profile), merges them, and writes the result to the specified environment file.
+ *
+ * @param mapPath - Path to the JSON file mapping environment variable names to SSM parameter names.
+ * @param envFilePath - Path to the local environment file to read and update.
+ * @param profile - Optional AWS profile name to use for credentials.
+ */
+export function run(mapPath, envFilePath, profile) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const defaultAwsConfig = {};
+        const ssmClientConfig = profile ? { credentials: fromIni({ profile }) } : defaultAwsConfig;
+        const ssm = new SSM(ssmClientConfig);
+        const paramMap = loadParamMap(mapPath);
+        const existingEnvVariables = loadExistingEnvVariables(envFilePath);
+        const updatedEnvVariables = yield fetchAndUpdateEnvVariables(paramMap, existingEnvVariables, ssm);
+        writeEnvFile(envFilePath, updatedEnvVariables);
+        console.log(`Environment File generated at '${envFilePath}'`);
+    });
+}
+function loadParamMap(mapPath) {
+    const content = fs.readFileSync(mapPath, 'utf-8');
+    try {
+        return JSON.parse(content);
+    }
+    catch (error) {
+        console.error(`Error parsing JSON from ${mapPath}`);
+        throw new Error(`Invalid JSON in parameter map file: ${mapPath}`);
+    }
+}
+function loadExistingEnvVariables(envFilePath) {
+    const envVariables = {};
+    if (!fs.existsSync(envFilePath))
+        return envVariables;
+    const existingEnvContent = fs.readFileSync(envFilePath, 'utf-8');
+    const parsedEnv = dotenv.parse(existingEnvContent);
+    Object.assign(envVariables, parsedEnv);
+    return envVariables;
+}
+/**
+ * Fetches parameter values from AWS SSM for each environment variable in the map and updates the existing environment variables record.
+ *
+ * For each mapping, retrieves the corresponding SSM parameter value and updates the environment variable if found. Logs masked values and warnings for missing parameters. Throws an error if any parameters fail to fetch.
+ *
+ * @param paramMap - Mapping of environment variable names to SSM parameter names.
+ * @param existingEnvVariables - Current environment variables to be updated.
+ * @param ssm - AWS SSM client instance used for fetching parameters.
+ * @returns The updated environment variables record.
+ *
+ * @throws {Error} If any SSM parameters cannot be fetched.
+ */
+function fetchAndUpdateEnvVariables(paramMap, existingEnvVariables, ssm) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const errors = [];
+        for (const [envVar, ssmName] of Object.entries(paramMap)) {
+            try {
+                const value = yield fetchSSMParameter(ssmName, ssm);
+                if (value) {
+                    existingEnvVariables[envVar] = value;
+                    console.log(`${envVar}=${value.length > 3 ? '*'.repeat(value.length - 3) + value.slice(-3) : '*'.repeat(value.length)}`);
+                }
+                else {
+                    console.error(`Warning: No value found for: '${ssmName}'`);
+                }
+            }
+            catch (error) {
+                console.error(`Error fetching parameter: '${ssmName}'`);
+                errors.push(`ParameterNotFound: ${ssmName}`);
+            }
+        }
+        if (errors.length > 0) {
+            throw new Error(`Some parameters could not be fetched:\n${errors.join('\n')}`);
+        }
+        return existingEnvVariables;
+    });
+}
+/**
+ * Retrieves the value of a parameter from AWS SSM Parameter Store with decryption enabled.
+ *
+ * @param ssmName - The name of the SSM parameter to retrieve.
+ * @returns The decrypted parameter value if found, or undefined if the parameter does not exist.
+ */
+function fetchSSMParameter(ssmName, ssm) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const command = new GetParameterCommand({
+            Name: ssmName,
+            WithDecryption: true,
+        });
+        const { Parameter } = yield ssm.send(command);
+        return Parameter === null || Parameter === void 0 ? void 0 : Parameter.Value;
+    });
+}
+function writeEnvFile(envFilePath, envVariables) {
+    const envContent = Object.entries(envVariables)
+        .map(([key, value]) => {
+        const escapedValue = value.replace(/(\n|\r|\n\r)/g, '\\n').replace(/"/g, '\\"');
+        return `${key}=${escapedValue}`;
+    })
+        .join('\n');
+    fs.writeFileSync(envFilePath, envContent);
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/package.json

@@ -1,26 +1,29 @@
 {
   "name": "envilder",
-  "version": "0.4.1",
+  "version": "0.5.1",
   "description": "A CLI tool to generate .env files from AWS SSM parameters",
   "exports": {
     ".": {
+      "import": "./lib/index.js",
       "types": "./lib/index.d.ts"
     }
   },
+  "main": "./lib/index.js",
   "bin": {
-    "envilder": "lib/cli/cliRunner.js"
+    "envilder": "lib/cli/cli.js"
   },
   "scripts": {
     "clean": "npx jest --clearCache && yarn cache clean --force && npx rimraf lib && npx rimraf node_modules && npx rimraf coverage && npx rimraf yarn.lock",
-    "test-run": "yarn build && node lib/cli/cliRunner.js --map=tests/sample/param-map.json --envfile=tests/sample/autogenerated.env",
-    "build": "tsc -p tsconfig.build.json --sourceMap --declaration",
+    "test-run": "yarn build && node lib/cli/cli.js --map=tests/sample/param-map.json --envfile=tests/sample/autogenerated.env",
+    "build": "tsc -p tsconfig.build.json --sourceMap --declaration && node --no-warnings scripts/chmod-cli.js",
+    "validate-cli": "node --no-warnings --loader ts-node/esm scripts/validate-cli.ts",
     "format": "npx biome format",
     "format:write": "npx biome format --write",
     "lint": "npx secretlint \"**/*\" && biome lint --write && biome format --write && biome check --write && tsc --noEmit",
     "lint:fix": "npx biome lint --fix",
     "test": "vitest run --reporter verbose --coverage",
     "cli-run": "yarn build && node --trace-warnings lib",
-    "npm-publish": "yarn lint && yarn build && yarn publish",
+    "npm-publish": "yarn lint && yarn build && yarn test && npm pack --dry-run && yarn publish",
     "npm-release-patch": "yarn version --new-version patch",
     "npm-release-minor": "yarn version --new-version minor",
     "npm-release-prerelease": "yarn version --new-version prerelease"
@@ -38,30 +41,31 @@
   "publishConfig": {
     "access": "public"
   },
+  "files": [
+    "lib/**/*",
+    "README.md",
+    "LICENSE",
+    "ROADMAP.md"
+  ],
   "type": "module",
   "dependencies": {
     "@aws-sdk/client-ssm": "^3.806.0",
     "@aws-sdk/credential-providers": "^3.806.0",
-    "@secretlint/core": "^9.2.1",
-    "@secretlint/secretlint-rule-preset-recommend": "^9.0.0",
     "@types/node": "^22.5.5",
-    "commander": "^12.1.0",
+    "commander": "^13.1.0",
     "dotenv": "^16.4.5",
     "picocolors": "^1.1.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^1.9.1",
+    "@secretlint/secretlint-rule-preset-recommend": "^9.3.2",
     "@vitest/coverage-v8": "^3.1.1",
     "rimraf": "^6.0.1",
-    "secretlint": "^9.0.0",
+    "secretlint": "^9.3.2",
     "ts-node": "^10.9.2",
     "typescript": "^5.6.2",
     "vitest": "^3.1.1"
   },
-  "resolutions": {
-    "string-width": "4.2.3",
-    "strip-ansi": "6.0.1"
-  },
   "engines": {
     "node": ">=20.0.0",
     "yarn": ">=1.22"

package/.gitattributes

@@ -1,67 +0,0 @@
-###############################################################################
-# Set default behavior to automatically normalize line endings.
-###############################################################################
-* text=auto
-
-# Explicitly declare text files you want to always be normalized and converted
-# to native line endings on checkout.
-*.sh text eol=lf
-
-###############################################################################
-# Set default behavior for command prompt diff.
-#
-# This is need for earlier builds of msysgit that does not have it on by
-# default for csharp files.
-# Note: This is only used by command line
-###############################################################################
-#*.cs     diff=csharp
-
-###############################################################################
-# Set the merge driver for project and solution files
-#
-# Merging from the command prompt will add diff markers to the files if there
-# are conflicts (Merging from VS is not affected by the settings below, in VS
-# the diff markers are never inserted). Diff markers may cause the following 
-# file extensions to fail to load in VS. An alternative would be to treat
-# these files as binary and thus will always conflict and require user
-# intervention with every merge. To do so, just uncomment the entries below
-###############################################################################
-#*.sln       merge=binary
-#*.csproj    merge=binary
-#*.vbproj    merge=binary
-#*.vcxproj   merge=binary
-#*.vcproj    merge=binary
-#*.dbproj    merge=binary
-#*.fsproj    merge=binary
-#*.lsproj    merge=binary
-#*.wixproj   merge=binary
-#*.modelproj merge=binary
-#*.sqlproj   merge=binary
-#*.wwaproj   merge=binary
-
-###############################################################################
-# behavior for image files
-#
-# image files are treated as binary by default.
-###############################################################################
-#*.jpg   binary
-#*.png   binary
-#*.gif   binary
-
-###############################################################################
-# diff behavior for common document formats
-# 
-# Convert binary document formats to text before diffing them. This feature
-# is only available from the command line. Turn it on by uncommenting the 
-# entries below.
-###############################################################################
-#*.doc   diff=astextplain
-#*.DOC   diff=astextplain
-#*.docx  diff=astextplain
-#*.DOCX  diff=astextplain
-#*.dot   diff=astextplain
-#*.DOT   diff=astextplain
-#*.pdf   diff=astextplain
-#*.PDF   diff=astextplain
-#*.rtf   diff=astextplain
-#*.RTF   diff=astextplain

package/.gitconfig

@@ -1,2 +0,0 @@
-[core]
-    longpaths = true

package/.github/dependabot.yml

@@ -1,40 +0,0 @@
-# To get started with Dependabot version updates, you'll need to specify which
-# package ecosystems to update and where the package manifests are located.
-# Please see the documentation for all configuration options:
-# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
-
-version: 2
-updates: 
-- package-ecosystem: npm
-  directory: "/"
-  pull-request-branch-name:
-    separator: "/"
-  schedule:
-    interval: monthly
-    day: monday
-    time: "10:00"
-    timezone: Europe/Madrid
-  labels:
-  - "npm"
-  - "dependencies"
-  reviewers:
-  - macalbert
-  assignees:
-  - macalbert
-    
-- package-ecosystem: github-actions
-  directory: "/"
-  pull-request-branch-name:
-      separator: "/"
-  schedule:
-    interval: monthly
-    day: monday
-    time: "10:00"
-    timezone: Europe/Madrid
-  labels:
-  - "github-actions"
-  - "dependencies"
-  reviewers:
-  - macalbert
-  assignees:
-  - macalbert

package/.github/pull_request_template.md

@@ -1,20 +0,0 @@
-# Description
-
-_Describe the problem or feature in addition to a link to the issues._
-
-## Approach
-
-_How does this change address the problem?_
-
-## Open Questions and Pre-Merge TODOs
-
-- [ ] Use github checklists. When solved, check the box and explain the answer.
-
-## Learning
-
-_Describe the research stage_
-_Links to blog posts, patterns, libraries or addons used to solve this problem_
-
-## Blog Posts
-
-- [How to Pull Request](https://github.com/flexyford/pull-request) Github Repo with Learning focused Pull Request Template.

package/.github/workflows/codeql-analysis.yml

@@ -1,49 +0,0 @@
-name: CodeQL
-
-on:
-  workflow_dispatch:
-
-  pull_request:
-    branches: [main]
-    paths:
-      - ".github/workflows/codeql-analysis.yml"
-
-  push:
-    branches: [main]
-    paths:
-      - ".github/workflows/codeql-analysis.yml"
-      - "src/**"
-      - "test/**"
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.head_ref || github.sha }}
-  cancel-in-progress: true
-
-jobs:
-  analyze:
-    strategy:
-      fail-fast: false
-      matrix:
-        language: ["javascript"]
-
-    permissions:
-      security-events: write
-
-    runs-on: ubuntu-22.04
-
-    steps:
-      - name: Checkout Repository
-        uses: actions/checkout@v4
-        with:
-          lfs: true
-
-      - name: Initialize CodeQL
-        uses: github/codeql-action/init@v3
-        with:
-          languages: ${{ matrix.language }}
-
-      - name: Autobuild
-        uses: github/codeql-action/autobuild@v3
-
-      - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@v3

package/.github/workflows/coverage-report.yml

@@ -1,73 +0,0 @@
-name: 🔦 code-coverage
-
-on:
-  workflow_dispatch:
-
-  pull_request:
-    paths:
-      - ".github/workflows/coverage-report.yml"
-
-  push:
-    branches:
-      - "main"
-    paths:
-      - ".github/workflows/coverage-report.yml"
-      - "src/**"
-      - "test/**"
-
-concurrency:
-  group: "pages"
-  cancel-in-progress: false
-
-permissions:
-  contents: read
-  pages: write
-  id-token: write
-
-jobs:
-  build-coverage:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    if: ${{ !github.event.pull_request.draft }}
-    steps:
-      - name: Check if PR is created by Dependabot
-        id: dependabot-check
-        run: |
-          if [[ "${{ github.actor }}" == *dependabot* ]]; then
-            echo "is_dependabot=true" >> "$GITHUB_OUTPUT"
-          else
-            echo "is_dependabot=false" >> "$GITHUB_OUTPUT"
-          fi
-
-      - name: Check if the workflow should run
-        if: ${{ steps.dependabot-check.outputs.is_dependabot == 'false' }}
-        run: echo "The workflow is allowed to run for this PR"
-
-      - name: 🧲 Checkout
-        uses: actions/checkout@v4
-
-      - name: 🛠️ Setup Node.js with Cache
-        uses: actions/setup-node@v4
-        with:
-          node-version: "20.x"
-          cache: "yarn"
-
-      - name: 📦 Install dependencies
-        run: yarn install
-
-      - name: 🔥 Run tests and collect coverage
-        run: yarn test
-
-      - name: Setup Pages
-        uses: actions/configure-pages@v5
-
-      - name: Upload artifact
-        uses: actions/upload-pages-artifact@v3
-        with:
-          path: "./coverage"
-
-      - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v4

package/.github/workflows/publish.yml

@@ -1,80 +0,0 @@
-name: 🍄 Power-Up Publisher
-
-on:
-  push:
-    branches:
-      - main
-    paths:
-      - 'src/**'
-      - 'package.json'
-      - '.github/workflows/publish.yml'
-
-# Add explicit permissions for the GITHUB_TOKEN
-permissions:
-  contents: write
-  packages: write
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    steps:
-      - name: 🧱 Checkout repository
-        uses: actions/checkout@v3
-        with:
-          fetch-depth: 0
-
-      - name: 🔧 Setup Node.js
-        uses: actions/setup-node@v3
-        with:
-          node-version: '20'
-          registry-url: 'https://registry.npmjs.org'
-          cache: 'yarn'
-
-      - name: 🌟 Install dependencies
-        run: yarn install --frozen-lockfile
-
-      - name: 🔥 Lint
-        run: yarn lint        
-          
-      - name: 🍄 Run tests
-        run: yarn test
-
-      - name: 👑 Detect version bump
-        id: version-check
-        run: |
-          CURRENT_VERSION=$(node -p "require('./package.json').version")
-          LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "v0.0.0")
-          LAST_TAG_VERSION=${LAST_TAG#v}
-          
-          echo "Current version: $CURRENT_VERSION, Last tag version: $LAST_TAG_VERSION"
-          
-          # Check if the current version is greater than the last tagged version
-          if [ "$CURRENT_VERSION" != "$LAST_TAG_VERSION" ]; then
-            echo "Version has been bumped from $LAST_TAG_VERSION to $CURRENT_VERSION"
-            echo "version_changed=true" >> $GITHUB_OUTPUT
-            echo "current_version=$CURRENT_VERSION" >> $GITHUB_OUTPUT
-          else
-            echo "Version not changed. Will not publish."
-            echo "version_changed=false" >> $GITHUB_OUTPUT
-          fi
-
-      - name: 🔨 Build package
-        if: steps.version-check.outputs.version_changed == 'true'
-        run: yarn build
-
-      - name: 🚩 Publish to npm
-        if: steps.version-check.outputs.version_changed == 'true'
-        run: yarn publish --non-interactive
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      - name: 🏰 Create GitHub Release
-        if: steps.version-check.outputs.version_changed == 'true'
-        uses: ncipollo/release-action@v1
-        with:
-          tag: "v${{ steps.version-check.outputs.current_version }}"
-          name: "🍄 Level Up Release v${{ steps.version-check.outputs.current_version }}"
-          generateReleaseNotes: true
-          token: ${{ secrets.GITHUB_TOKEN }}
-          makeLatest: legacy
-          replacesArtifacts: true

package/.github/workflows/unit-tests.yml

@@ -1,51 +0,0 @@
-name: 🌱 unit-tests
-
-on:
-  workflow_dispatch: {}
-
-  pull_request:
-    branches:
-      - "*"
-    types:
-      - opened
-      - reopened
-      - synchronize
-      - ready_for_review
-    paths:
-      - ".github/workflows/unit-tests.yml"
-      - "src/**"
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.head_ref || github.sha }}
-  cancel-in-progress: true
-
-jobs:
-  envilder-test:
-    runs-on: ubuntu-24.04
-    if: ${{ !github.event.pull_request.draft }}
-    timeout-minutes: 30
-
-    steps:
-      - name: 🚀 ♂️ Checkout
-        uses: actions/checkout@v4
-
-      - name: 🛠️ Setup Node.js with Cache
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20.x'
-          cache: 'yarn'
-
-      - name: 📦 Install packages
-        run: yarn install --frozen-lockfile
-
-      - name: 🔍 Run formatting checker
-        run: yarn format
-
-      - name: 🔍 Run code quality checker
-        run: yarn lint
-
-      - name: 🚧 Build
-        run: yarn build
-
-      - name: 🚴‍♀️ Run unit tests
-        run: yarn test

package/.secretlintrc.json

@@ -1,7 +0,0 @@
-{
-  "rules": [
-    {
-      "id": "@secretlint/secretlint-rule-preset-recommend"
-    }
-  ]
-}

package/biome.json

@@ -1,30 +0,0 @@
-{
-  "$schema": "https://biomejs.dev/schemas/1.8.3/schema.json",
-  "files": {
-    "include": ["./src/**", "./tests/**"],
-    "ignore": ["**/node_modules/**", "**/lib/**", "**/dist/**", "**/coverage/**", "**/.lock", "**/.md"]
-  },
-  "organizeImports": {
-    "enabled": true
-  },
-  "linter": {
-    "enabled": true,
-    "rules": {
-      "recommended": true
-    }
-  },
-  "formatter": {
-    "enabled": true,
-    "formatWithErrors": false,
-    "indentStyle": "space",
-    "indentWidth": 2,
-    "lineWidth": 120
-  },
-  "javascript": {
-    "formatter": {
-      "quoteStyle": "single",
-      "trailingCommas": "all",
-      "semicolons": "always"
-    }
-  }
-}

package/src/cli/cliRunner.ts

@@ -1,35 +0,0 @@
-#!/usr/bin/env node
-import { Command } from 'commander';
-import { run } from '../index.js';
-
-/**
- * Parses CLI arguments and runs the environment file generator.
- *
- * Expects `--map` and `--envfile` options to be provided, with an optional `--profile` for AWS CLI profile selection. Invokes the main process to generate a `.env` file from AWS SSM parameters based on the provided mapping.
- *
- * @throws {Error} If either `--map` or `--envfile` arguments are missing.
- */
-export async function cliRunner() {
-  const program = new Command();
-
-  program
-    .name('envilder')
-    .description('A CLI tool to generate .env files from AWS SSM parameters')
-    .version('0.1.0')
-    .requiredOption('--map <path>', 'Path to the JSON file with environment variable mapping')
-    .requiredOption('--envfile <path>', 'Path to the .env file to be generated')
-    .option('--profile <name>', 'AWS CLI profile to use');
-
-  await program.parseAsync(process.argv);
-  const options = program.opts();
-
-  if (!options.map || !options.envfile) {
-    throw new Error('Missing required arguments: --map and --envfile');
-  }
-
-  await run(options.map, options.envfile, options.profile);
-}
-
-cliRunner().catch((error) => {
-  console.error('🚨 Uh-oh! Looks like Mario fell into the wrong pipe! 🍄💥');
-});

package/src/index.ts

@@ -1,119 +0,0 @@
-import * as fs from 'node:fs';
-import { GetParameterCommand, SSM } from '@aws-sdk/client-ssm';
-import { fromIni } from '@aws-sdk/credential-providers';
-import * as dotenv from 'dotenv';
-
-/**
- * Orchestrates the process of fetching environment variable values from AWS SSM Parameter Store and writing them to a local environment file.
- *
- * Loads a parameter mapping from a JSON file, retrieves existing environment variables, fetches updated values from SSM (optionally using a specified AWS profile), merges them, and writes the result to the specified environment file.
- *
- * @param mapPath - Path to the JSON file mapping environment variable names to SSM parameter names.
- * @param envFilePath - Path to the local environment file to read and update.
- * @param profile - Optional AWS profile name to use for credentials.
- */
-export async function run(mapPath: string, envFilePath: string, profile?: string) {
-  const defaultAwsConfig = {};
-  const ssmClientConfig = profile ? { credentials: fromIni({ profile }) } : defaultAwsConfig;
-  const ssm = new SSM(ssmClientConfig);
-
-  const paramMap = loadParamMap(mapPath);
-  const existingEnvVariables = loadExistingEnvVariables(envFilePath);
-
-  const updatedEnvVariables = await fetchAndUpdateEnvVariables(paramMap, existingEnvVariables, ssm);
-
-  writeEnvFile(envFilePath, updatedEnvVariables);
-  console.log(`Environment File generated at '${envFilePath}'`);
-}
-
-function loadParamMap(mapPath: string): Record<string, string> {
-  const content = fs.readFileSync(mapPath, 'utf-8');
-  try {
-    return JSON.parse(content);
-  } catch (error) {
-    console.error(`Error parsing JSON from ${mapPath}`);
-    throw new Error(`Invalid JSON in parameter map file: ${mapPath}`);
-  }
-}
-
-function loadExistingEnvVariables(envFilePath: string): Record<string, string> {
-  const envVariables: Record<string, string> = {};
-
-  if (!fs.existsSync(envFilePath)) return envVariables;
-
-  const existingEnvContent = fs.readFileSync(envFilePath, 'utf-8');
-  const parsedEnv = dotenv.parse(existingEnvContent);
-  Object.assign(envVariables, parsedEnv);
-
-  return envVariables;
-}
-
-/**
- * Fetches parameter values from AWS SSM for each environment variable in the map and updates the existing environment variables record.
- *
- * For each mapping, retrieves the corresponding SSM parameter value and updates the environment variable if found. Logs masked values and warnings for missing parameters. Throws an error if any parameters fail to fetch.
- *
- * @param paramMap - Mapping of environment variable names to SSM parameter names.
- * @param existingEnvVariables - Current environment variables to be updated.
- * @param ssm - AWS SSM client instance used for fetching parameters.
- * @returns The updated environment variables record.
- *
- * @throws {Error} If any SSM parameters cannot be fetched.
- */
-async function fetchAndUpdateEnvVariables(
-  paramMap: Record<string, string>,
-  existingEnvVariables: Record<string, string>,
-  ssm: SSM,
-): Promise<Record<string, string>> {
-  const errors: string[] = [];
-
-  for (const [envVar, ssmName] of Object.entries(paramMap)) {
-    try {
-      const value = await fetchSSMParameter(ssmName, ssm);
-      if (value) {
-        existingEnvVariables[envVar] = value;
-        console.log(
-          `${envVar}=${value.length > 3 ? '*'.repeat(value.length - 3) + value.slice(-3) : '*'.repeat(value.length)}`,
-        );
-      } else {
-        console.error(`Warning: No value found for: '${ssmName}'`);
-      }
-    } catch (error) {
-      console.error(`Error fetching parameter: '${ssmName}'`);
-      errors.push(`ParameterNotFound: ${ssmName}`);
-    }
-  }
-
-  if (errors.length > 0) {
-    throw new Error(`Some parameters could not be fetched:\n${errors.join('\n')}`);
-  }
-
-  return existingEnvVariables;
-}
-
-/**
- * Retrieves the value of a parameter from AWS SSM Parameter Store with decryption enabled.
- *
- * @param ssmName - The name of the SSM parameter to retrieve.
- * @returns The decrypted parameter value if found, or undefined if the parameter does not exist.
- */
-async function fetchSSMParameter(ssmName: string, ssm: SSM): Promise<string | undefined> {
-  const command = new GetParameterCommand({
-    Name: ssmName,
-    WithDecryption: true,
-  });
-
-  const { Parameter } = await ssm.send(command);
-  return Parameter?.Value;
-}
-
-function writeEnvFile(envFilePath: string, envVariables: Record<string, string>): void {
-  const envContent = Object.entries(envVariables)
-    .map(([key, value]) => {
-      const escapedValue = value.replace(/(\n|\r|\n\r)/g, '\\n').replace(/"/g, '\\"');
-      return `${key}=${escapedValue}`;
-    })
-    .join('\n');
-
-  fs.writeFileSync(envFilePath, envContent);
-}

package/tests/cli/cliRunner.test.ts

@@ -1,59 +0,0 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { cliRunner } from '../../src/cli/cliRunner';
-import { run } from '../../src/index';
-
-vi.mock('../../src/index', () => ({
-  run: vi.fn(),
-}));
-
-describe('cliRunner', () => {
-  const originalArgv = process.argv;
-
-  beforeEach(() => {
-    process.argv = [...originalArgv.slice(0, 2)];
-  });
-  afterEach(() => {
-    vi.clearAllMocks();
-    process.argv = originalArgv;
-  });
-
-  it('Should_CallRunWithCorrectArguments_When_ValidArgumentsAreProvided', async () => {
-    // Arrange
-    const mockMapPath = 'path/to/mockMap.json';
-    const mockEnvFilePath = 'path/to/.env';
-    process.argv.push('--map', mockMapPath, '--envfile', mockEnvFilePath);
-
-    // Act
-    await cliRunner();
-
-    // Assert
-    expect(run).toHaveBeenCalledWith(mockMapPath, mockEnvFilePath, undefined);
-  });
-
-  it('Should_ThrowError_When_RequiredArgumentsAreMissing', async () => {
-    // Arrange
-    vi.spyOn(process, 'exit').mockImplementation(() => {
-      throw new Error('process.exit called');
-    });
-
-    // Act
-    const action = cliRunner();
-
-    // Assert
-    await expect(action).rejects.toThrow('process.exit called');
-  });
-
-  it('Should_CallRunWithCorrectArgumentsIncludingProfile_When_ProfileIsProvided', async () => {
-    // Arrange
-    const mockMapPath = 'path/to/mockMap.json';
-    const mockEnvFilePath = 'path/to/.env';
-    const mockProfile = 'test-profile';
-    process.argv.push('--map', mockMapPath, '--envfile', mockEnvFilePath, '--profile', mockProfile);
-
-    // Act
-    await cliRunner();
-
-    // Assert
-    expect(run).toHaveBeenCalledWith(mockMapPath, mockEnvFilePath, mockProfile);
-  });
-});

package/tests/index.test.ts

@@ -1,150 +0,0 @@
-import * as fs from 'node:fs';
-import { SSM } from '@aws-sdk/client-ssm';
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import { run } from '../src/index';
-
-vi.mock('@aws-sdk/client-ssm', () => {
-  return {
-    SSM: vi.fn().mockImplementation(() => ({
-      send: vi.fn((command) => {
-        if (command.input.Name === '/path/to/ssm/email') {
-          return Promise.resolve({
-            Parameter: { Value: 'mockedEmail@example.com' },
-          });
-        }
-
-        if (command.input.Name === '/path/to/ssm/password') {
-          return Promise.resolve({
-            Parameter: { Value: 'mockedPassword' },
-          });
-        }
-
-        if (command.input.Name === '/path/to/ssm/password_no_value') {
-          return Promise.resolve({ Parameter: { Value: '' } });
-        }
-
-        return Promise.reject(new Error(`ParameterNotFound: ${command.input.Name}`));
-      }),
-    })),
-    GetParameterCommand: vi.fn().mockImplementation((input) => ({
-      input,
-    })),
-  };
-});
-
-describe('Envilder CLI', () => {
-  const mockMapPath = './tests/param-map.json';
-  const mockEnvFilePath = './tests/.env.test';
-
-  afterEach(() => {
-    vi.clearAllMocks();
-
-    if (fs.existsSync(mockEnvFilePath)) {
-      fs.unlinkSync(mockEnvFilePath);
-    }
-
-    if (fs.existsSync(mockMapPath)) {
-      fs.unlinkSync(mockMapPath);
-    }
-  });
-
-  it('Should_GenerateEnvFileFromSSMParameters_When_ValidSSMParametersAreProvided', async () => {
-    // Arrange
-    const paramMapContent = {
-      NEXT_PUBLIC_CREDENTIAL_EMAIL: '/path/to/ssm/email',
-      NEXT_PUBLIC_CREDENTIAL_PASSWORD: '/path/to/ssm/password',
-    };
-    fs.writeFileSync(mockMapPath, JSON.stringify(paramMapContent));
-
-    // Act
-    await run(mockMapPath, mockEnvFilePath);
-
-    // Assert
-    const envFileContent = fs.readFileSync(mockEnvFilePath, 'utf-8');
-    expect(envFileContent).toContain('NEXT_PUBLIC_CREDENTIAL_EMAIL=mockedEmail@example.com');
-    expect(envFileContent).toContain('NEXT_PUBLIC_CREDENTIAL_PASSWORD=mockedPassword');
-  });
-
-  it('Should_ThrowError_When_SSMParameterIsNotFound', async () => {
-    // Arrange
-    const paramMapContent = {
-      NEXT_PUBLIC_CREDENTIAL_EMAIL: 'non-existent parameter',
-    };
-    fs.writeFileSync(mockMapPath, JSON.stringify(paramMapContent));
-
-    // Act
-    const action = run(mockMapPath, mockEnvFilePath);
-
-    // Assert
-    await expect(action).rejects.toThrow('ParameterNotFound: non-existent parameter');
-  });
-
-  it('Should_AppendNewSSMParameters_When_EnvFileContainsExistingVariables', async () => {
-    // Arrange
-    const existingEnvContent = 'EXISTING_VAR=existingValue';
-    fs.writeFileSync(mockEnvFilePath, existingEnvContent);
-    const paramMapContent = {
-      NEXT_PUBLIC_CREDENTIAL_EMAIL: '/path/to/ssm/email',
-      NEXT_PUBLIC_CREDENTIAL_PASSWORD: '/path/to/ssm/password',
-    };
-    fs.writeFileSync(mockMapPath, JSON.stringify(paramMapContent));
-
-    // Act
-    await run(mockMapPath, mockEnvFilePath);
-
-    // Assert
-    const updatedEnvFileContent = fs.readFileSync(mockEnvFilePath, 'utf-8');
-    expect(updatedEnvFileContent).toContain('EXISTING_VAR=existingValue');
-    expect(updatedEnvFileContent).toContain('NEXT_PUBLIC_CREDENTIAL_EMAIL=mockedEmail@example.com');
-    expect(updatedEnvFileContent).toContain('NEXT_PUBLIC_CREDENTIAL_PASSWORD=mockedPassword');
-  });
-
-  it('Should_OverwriteSSMParameters_When_EnvFileContainsSameVariables', async () => {
-    // Arrange
-    const existingEnvContent = 'NEXT_PUBLIC_CREDENTIAL_EMAIL=oldEmail@example.com';
-    fs.writeFileSync(mockEnvFilePath, existingEnvContent);
-    const paramMapContent = {
-      NEXT_PUBLIC_CREDENTIAL_EMAIL: '/path/to/ssm/email',
-      NEXT_PUBLIC_CREDENTIAL_PASSWORD: '/path/to/ssm/password',
-    };
-    fs.writeFileSync(mockMapPath, JSON.stringify(paramMapContent));
-
-    // Act
-    await run(mockMapPath, mockEnvFilePath);
-
-    // Assert
-    const updatedEnvFileContent = fs.readFileSync(mockEnvFilePath, 'utf-8');
-    expect(updatedEnvFileContent).toContain('NEXT_PUBLIC_CREDENTIAL_EMAIL=mockedEmail@example.com');
-    expect(updatedEnvFileContent).toContain('NEXT_PUBLIC_CREDENTIAL_PASSWORD=mockedPassword');
-  });
-
-  it('Should_LogWarning_When_SSMParameterHasNoValue', async () => {
-    // Arrange
-    const paramMapContent = {
-      NEXT_PUBLIC_CREDENTIAL_PASSWORD: '/path/to/ssm/password_no_value',
-    };
-    fs.writeFileSync(mockMapPath, JSON.stringify(paramMapContent));
-    const consoleSpy = vi.spyOn(console, 'error');
-
-    // Act
-    await run(mockMapPath, mockEnvFilePath);
-
-    // Assert
-    expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('Warning: No value found for'));
-  });
-
-  it('Should_ConfigureSSMClientWithProfile_When_ProfileIsProvided', async () => {
-    // Arrange
-    const mockProfile = 'test-profile';
-    const paramMapContent = {
-      NEXT_PUBLIC_CREDENTIAL_EMAIL: '/path/to/ssm/email',
-    };
-    fs.writeFileSync(mockMapPath, JSON.stringify(paramMapContent));
-
-    // Act
-    await run(mockMapPath, mockEnvFilePath, mockProfile);
-
-    // Assert
-    expect(vi.mocked(SSM).mock.calls[0][0]).toEqual(expect.objectContaining({ credentials: expect.anything() }));
-  });
-});

package/tests/sample/autogenerated.env

@@ -1 +0,0 @@
-TOKEN_SECRET=this_is_for_test

package/tests/sample/param-map.json

@@ -1,3 +0,0 @@
-{
-  "TOKEN_SECRET": "/Test/Token"
-}

package/tsconfig.build.json

@@ -1,7 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "rootDir": "./src"
-  },
-  "include": ["./src/**/*"]
-}

package/tsconfig.json

@@ -1,22 +0,0 @@
-{
-  "compileOnSave": false,
-  "compilerOptions": {
-    "module": "ESNext",
-    "moduleResolution": "Node",
-    "target": "es2016",
-    "outDir": "./lib",
-    "rootDir": ".",
-    "strict": true,
-    "esModuleInterop": true,
-    "noImplicitAny": true,
-    "skipLibCheck": true,
-    "lib": ["es2022"],
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "types": ["node", "picocolors"]
-  },
-  "include": ["src/**/*"]
-}

package/vite.config.ts

@@ -1,17 +0,0 @@
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node',
-    include: ['tests/**/*.test.ts'],
-    coverage: {
-      provider: 'v8',
-      reporter: ['text', 'html', 'json'],
-      reportsDirectory: './coverage',
-      all: true,
-      include: ['src/**/*.ts'],
-      exclude: ['node_modules', 'test', 'coverage', 'dist'],
-    },
-  },
-});

package/vitest.config.js

@@ -1,12 +0,0 @@
-// vitest.config.js
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    coverage: {
-      provider: 'v8',
-      reporter: ['text', 'html'],
-      reportsDirectory: './coverage',
-    },
-  },
-});