envilder 0.14.0 → 0.15.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +55 -13
- package/ROADMAP.md +50 -23
- package/docs/SECURITY.md +35 -9
- package/docs/changelogs/cli.md +139 -3
- package/docs/changelogs/gha.md +45 -2
- package/docs/changelogs/sdk-dotnet.md +34 -2
- package/docs/changelogs/sdk-nodejs.md +22 -5
- package/docs/changelogs/sdk-python.md +19 -2
- package/docs/exec-command.md +492 -0
- package/lib/envilder/apps/cli/Startup.d.ts +9 -0
- package/lib/envilder/apps/cli/Startup.d.ts.map +1 -1
- package/lib/envilder/apps/cli/Startup.js +39 -0
- package/lib/envilder/apps/cli/Startup.js.map +1 -1
- package/lib/envilder/apps/cli/entry/Cli.d.ts.map +1 -1
- package/lib/envilder/apps/cli/entry/Cli.js +346 -13
- package/lib/envilder/apps/cli/entry/Cli.js.map +1 -1
- package/lib/envilder/apps/cli/errors/CliErrorPresenter.d.ts.map +1 -1
- package/lib/envilder/apps/cli/errors/CliErrorPresenter.js +4 -1
- package/lib/envilder/apps/cli/errors/CliErrorPresenter.js.map +1 -1
- package/lib/envilder/apps/cli/errors/ParseErrorRedactor.d.ts +33 -0
- package/lib/envilder/apps/cli/errors/ParseErrorRedactor.d.ts.map +1 -0
- package/lib/envilder/apps/cli/errors/ParseErrorRedactor.js +121 -0
- package/lib/envilder/apps/cli/errors/ParseErrorRedactor.js.map +1 -0
- package/lib/envilder/apps/cli/recovery/SsoLoginRecovery.d.ts +13 -0
- package/lib/envilder/apps/cli/recovery/SsoLoginRecovery.d.ts.map +1 -1
- package/lib/envilder/apps/cli/recovery/SsoLoginRecovery.js +29 -13
- package/lib/envilder/apps/cli/recovery/SsoLoginRecovery.js.map +1 -1
- package/lib/envilder/apps/shared/ContainerConfiguration.d.ts +2 -1
- package/lib/envilder/apps/shared/ContainerConfiguration.d.ts.map +1 -1
- package/lib/envilder/apps/shared/ContainerConfiguration.js +4 -2
- package/lib/envilder/apps/shared/ContainerConfiguration.js.map +1 -1
- package/lib/envilder/core/application/dispatch/DispatchActionCommand.d.ts +18 -1
- package/lib/envilder/core/application/dispatch/DispatchActionCommand.d.ts.map +1 -1
- package/lib/envilder/core/application/dispatch/DispatchActionCommand.js +17 -1
- package/lib/envilder/core/application/dispatch/DispatchActionCommand.js.map +1 -1
- package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.d.ts +9 -2
- package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.d.ts.map +1 -1
- package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.js +28 -3
- package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.js.map +1 -1
- package/lib/envilder/core/application/execWithSecrets/CommandLineFormatter.d.ts +13 -0
- package/lib/envilder/core/application/execWithSecrets/CommandLineFormatter.d.ts.map +1 -0
- package/lib/envilder/core/application/execWithSecrets/CommandLineFormatter.js +19 -0
- package/lib/envilder/core/application/execWithSecrets/CommandLineFormatter.js.map +1 -0
- package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommand.d.ts +20 -0
- package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommand.d.ts.map +1 -0
- package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommand.js +19 -0
- package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommand.js.map +1 -0
- package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommandHandler.d.ts +61 -0
- package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommandHandler.d.ts.map +1 -0
- package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommandHandler.js +159 -0
- package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommandHandler.js.map +1 -0
- package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.d.ts +1 -9
- package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.d.ts.map +1 -1
- package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.js +9 -79
- package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.js.map +1 -1
- package/lib/envilder/core/application/secretResolution/SecretResolver.d.ts +66 -0
- package/lib/envilder/core/application/secretResolution/SecretResolver.d.ts.map +1 -0
- package/lib/envilder/core/application/secretResolution/SecretResolver.js +132 -0
- package/lib/envilder/core/application/secretResolution/SecretResolver.js.map +1 -0
- package/lib/envilder/core/domain/ChildEnvironment.d.ts +22 -0
- package/lib/envilder/core/domain/ChildEnvironment.d.ts.map +1 -0
- package/lib/envilder/core/domain/ChildEnvironment.js +50 -0
- package/lib/envilder/core/domain/ChildEnvironment.js.map +1 -0
- package/lib/envilder/core/domain/ExecExitCode.d.ts +14 -0
- package/lib/envilder/core/domain/ExecExitCode.d.ts.map +1 -0
- package/lib/envilder/core/domain/ExecExitCode.js +23 -0
- package/lib/envilder/core/domain/ExecExitCode.js.map +1 -0
- package/lib/envilder/core/domain/OperationMode.d.ts +2 -1
- package/lib/envilder/core/domain/OperationMode.d.ts.map +1 -1
- package/lib/envilder/core/domain/OperationMode.js +1 -0
- package/lib/envilder/core/domain/OperationMode.js.map +1 -1
- package/lib/envilder/core/domain/errors/DomainErrors.d.ts +44 -0
- package/lib/envilder/core/domain/errors/DomainErrors.d.ts.map +1 -1
- package/lib/envilder/core/domain/errors/DomainErrors.js +57 -0
- package/lib/envilder/core/domain/errors/DomainErrors.js.map +1 -1
- package/lib/envilder/core/domain/ports/IProcessContext.d.ts +14 -0
- package/lib/envilder/core/domain/ports/IProcessContext.d.ts.map +1 -0
- package/lib/envilder/core/domain/ports/IProcessContext.js +2 -0
- package/lib/envilder/core/domain/ports/IProcessContext.js.map +1 -0
- package/lib/envilder/core/domain/ports/IProcessRunner.d.ts +27 -0
- package/lib/envilder/core/domain/ports/IProcessRunner.d.ts.map +1 -0
- package/lib/envilder/core/domain/ports/IProcessRunner.js +2 -0
- package/lib/envilder/core/domain/ports/IProcessRunner.js.map +1 -0
- package/lib/envilder/core/domain/ports/ISecretMasker.d.ts +7 -0
- package/lib/envilder/core/domain/ports/ISecretMasker.d.ts.map +1 -1
- package/lib/envilder/core/infrastructure/aws/AwsSecretProviderFactory.d.ts +5 -1
- package/lib/envilder/core/infrastructure/aws/AwsSecretProviderFactory.d.ts.map +1 -1
- package/lib/envilder/core/infrastructure/aws/AwsSecretProviderFactory.js +3 -2
- package/lib/envilder/core/infrastructure/aws/AwsSecretProviderFactory.js.map +1 -1
- package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.d.ts +6 -1
- package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.d.ts.map +1 -1
- package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.js +10 -3
- package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.js.map +1 -1
- package/lib/envilder/core/infrastructure/github/GitHubActionsSecretMasker.d.ts +22 -0
- package/lib/envilder/core/infrastructure/github/GitHubActionsSecretMasker.d.ts.map +1 -1
- package/lib/envilder/core/infrastructure/github/GitHubActionsSecretMasker.js +38 -1
- package/lib/envilder/core/infrastructure/github/GitHubActionsSecretMasker.js.map +1 -1
- package/lib/envilder/core/infrastructure/github/NoOpSecretMasker.d.ts +1 -0
- package/lib/envilder/core/infrastructure/github/NoOpSecretMasker.d.ts.map +1 -1
- package/lib/envilder/core/infrastructure/github/NoOpSecretMasker.js +3 -0
- package/lib/envilder/core/infrastructure/github/NoOpSecretMasker.js.map +1 -1
- package/lib/envilder/core/infrastructure/logger/StderrConsoleLogger.d.ts +11 -0
- package/lib/envilder/core/infrastructure/logger/StderrConsoleLogger.d.ts.map +1 -0
- package/lib/envilder/core/infrastructure/logger/StderrConsoleLogger.js +27 -0
- package/lib/envilder/core/infrastructure/logger/StderrConsoleLogger.js.map +1 -0
- package/lib/envilder/core/infrastructure/process/CrossSpawnProcessRunner.d.ts +15 -0
- package/lib/envilder/core/infrastructure/process/CrossSpawnProcessRunner.d.ts.map +1 -0
- package/lib/envilder/core/infrastructure/process/CrossSpawnProcessRunner.js +145 -0
- package/lib/envilder/core/infrastructure/process/CrossSpawnProcessRunner.js.map +1 -0
- package/lib/envilder/core/infrastructure/process/NodeProcessContext.d.ts +11 -0
- package/lib/envilder/core/infrastructure/process/NodeProcessContext.d.ts.map +1 -0
- package/lib/envilder/core/infrastructure/process/NodeProcessContext.js +18 -0
- package/lib/envilder/core/infrastructure/process/NodeProcessContext.js.map +1 -0
- package/lib/envilder/core/types.d.ts +6 -0
- package/lib/envilder/core/types.d.ts.map +1 -1
- package/lib/envilder/core/types.js +3 -0
- package/lib/envilder/core/types.js.map +1 -1
- package/package.json +15 -8
package/README.md
CHANGED
|
@@ -14,7 +14,11 @@
|
|
|
14
14
|
[](https://npmcharts.com/compare/envilder)
|
|
15
15
|
[](https://github.com/macalbert/envilder/actions/workflows/tests.yml)
|
|
16
16
|
[](https://macalbert.github.io/envilder/)
|
|
17
|
+
[](https://www.bestpractices.dev/projects/15703)
|
|
18
|
+
[](https://snyk.io/test/github/macalbert/envilder)
|
|
17
19
|
[](./LICENSE)
|
|
20
|
+
[](https://context7.com/macalbert/envilder)
|
|
21
|
+
[](https://coderabbit.ai)
|
|
18
22
|
|
|
19
23
|
## Why Envilder?
|
|
20
24
|
|
|
@@ -34,6 +38,9 @@ npx envilder
|
|
|
34
38
|
|
|
35
39
|
# Or with explicit paths
|
|
36
40
|
npx envilder --map=envilder.json --envfile=.env
|
|
41
|
+
|
|
42
|
+
# Or skip the file: run your app with the secrets in memory
|
|
43
|
+
npx envilder exec -- npm run dev
|
|
37
44
|
```
|
|
38
45
|
|
|
39
46
|
No SaaS middleman. One versioned mapping contract. Secrets stay in your cloud.
|
|
@@ -48,6 +55,9 @@ No SaaS middleman. One versioned mapping contract. Secrets stay in your cloud.
|
|
|
48
55
|
- **No single mapping contract.** Your cloud provider may be the source of truth for secret
|
|
49
56
|
values, but each environment still needs to know how application variables map to those
|
|
50
57
|
secrets. Without a versioned contract, dev, staging, and production configurations drift apart.
|
|
58
|
+
- **The `.env` file is readable by everything in your repo.** `.gitignore` keeps it out of commits,
|
|
59
|
+
not out of reach. Editors, indexers, install scripts, and AI coding agents can all read the
|
|
60
|
+
plaintext values sitting in your working tree.
|
|
51
61
|
|
|
52
62
|
## How Envilder solves it
|
|
53
63
|
|
|
@@ -55,6 +65,8 @@ No SaaS middleman. One versioned mapping contract. Secrets stay in your cloud.
|
|
|
55
65
|
needs and where they live. Git-versioned, PR-reviewable, and reused across environments.
|
|
56
66
|
- ⚡ **Works everywhere your code runs.** CLI for local dev, GitHub Action for CI/CD, runtime SDKs
|
|
57
67
|
for application startup. Same file, same result.
|
|
68
|
+
- 🚫 **No `.env` file when you don't want one.** `envilder exec` starts any command with the
|
|
69
|
+
secrets in its environment, in any language, without writing anything to disk.
|
|
58
70
|
- 🔄 **Rotate secrets without config drift.** Keep application-facing variable names stable while
|
|
59
71
|
rotating real secret values in AWS SSM or Azure Key Vault. Generated `.env` files update only
|
|
60
72
|
when Envilder runs again; runtime consumers must restart or resolve again.
|
|
@@ -68,6 +80,7 @@ No SaaS middleman. One versioned mapping contract. Secrets stay in your cloud.
|
|
|
68
80
|
|---------|-------------|
|
|
69
81
|
| 📋 **Declarative Mapping** | One JSON file defines how application variables map to cloud secrets. Git-versioned, PR-reviewable, and diff-able |
|
|
70
82
|
| ☁️ **Cloud-native Providers** | AWS SSM and Azure Key Vault today |
|
|
83
|
+
| ⚡ **Exec Mode** | `envilder exec -- <command>` runs any command with the secrets in its environment. Nothing written to disk, fail-closed, exit codes propagated. [Guide](docs/exec-command.md) |
|
|
71
84
|
| 🔌 **Runtime SDKs** | Load secrets into memory at app startup: [.NET](./src/sdks/dotnet/README.md), [Python](./src/sdks/python/README.md), [Node.js](./src/sdks/nodejs/README.md). No `.env` on disk |
|
|
72
85
|
| ⚙️ **GitHub Action** | Pull secrets in CI/CD. Same mapping, zero manual config |
|
|
73
86
|
| 🔄 **Pull & Controlled Push** | Pull secrets to `.env`, or intentionally push local values to your cloud provider when bootstrapping or rotating |
|
|
@@ -114,6 +127,22 @@ Add `.env` to `.gitignore`. The mapping file is versioned and reviewable in PRs.
|
|
|
114
127
|
> 💡 Using Azure Key Vault? Add a `$config` section to your mapping file.
|
|
115
128
|
> See [Mapping File Format](#️-mapping-file-format) below.
|
|
116
129
|
|
|
130
|
+
### 4. Or skip the `.env` file entirely
|
|
131
|
+
|
|
132
|
+
```bash
|
|
133
|
+
npx envilder exec -- npm run dev
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
`envilder exec` resolves the same mapping and starts your command with the secrets in its environment.
|
|
137
|
+
Nothing is written to disk. Envilder options go before the command (or before an optional `--`); everything
|
|
138
|
+
after belongs to your command. Exec mode is fail-closed: the command does not start if any secret is missing.
|
|
139
|
+
It is not a sandbox: your command and everything it starts can read the secrets.
|
|
140
|
+
|
|
141
|
+
📖 See the [Exec Command Guide](docs/exec-command.md) for exit codes, signals and GitHub Actions masking.
|
|
142
|
+
|
|
143
|
+
💡 Runnable examples: [envilder-examples](https://github.com/macalbert/envilder-examples) (Testcontainers and Aspire for
|
|
144
|
+
.NET, Python and TypeScript, AWS SSM and Azure Key Vault, plus `envilder exec`).
|
|
145
|
+
|
|
117
146
|
### 🎥 See it in action
|
|
118
147
|
|
|
119
148
|
Watch how easy it is to automate your `.env` management in less than 1 minute:
|
|
@@ -238,7 +267,7 @@ Env.Load("envilder.json");
|
|
|
238
267
|
var dbPassword = Environment.GetEnvironmentVariable("DB_PASSWORD");
|
|
239
268
|
```
|
|
240
269
|
|
|
241
|
-
📖 **[Full .NET SDK docs](./src/sdks/dotnet/README.md)** · 💡 **[
|
|
270
|
+
📖 **[Full .NET SDK docs](./src/sdks/dotnet/README.md)** · 💡 **Examples:** [Testcontainers](https://github.com/macalbert/envilder-examples/tree/main/dotnet-testcontainers) · [Aspire](https://github.com/macalbert/envilder-examples/tree/main/dotnet-aspire)
|
|
242
271
|
|
|
243
272
|
### Python SDK
|
|
244
273
|
|
|
@@ -271,7 +300,7 @@ Envilder.load('production', {
|
|
|
271
300
|
})
|
|
272
301
|
```
|
|
273
302
|
|
|
274
|
-
📖 **[Full Python SDK docs](./src/sdks/python/README.md)** · 💡 **[
|
|
303
|
+
📖 **[Full Python SDK docs](./src/sdks/python/README.md)** · 💡 **Examples:** [Testcontainers](https://github.com/macalbert/envilder-examples/tree/main/python-testcontainers)
|
|
275
304
|
|
|
276
305
|
### Node.js SDK
|
|
277
306
|
|
|
@@ -301,7 +330,7 @@ const secrets = await Envilder.fromMapFile('envilder.json')
|
|
|
301
330
|
.resolve();
|
|
302
331
|
```
|
|
303
332
|
|
|
304
|
-
📖 **[Full Node.js SDK docs](./src/sdks/nodejs/README.md)** · 💡 **[
|
|
333
|
+
📖 **[Full Node.js SDK docs](./src/sdks/nodejs/README.md)** · 💡 **Examples:** [Testcontainers](https://github.com/macalbert/envilder-examples/tree/main/typescript-testcontainers) · [Aspire](https://github.com/macalbert/envilder-examples/tree/main/typescript-aspire)
|
|
305
334
|
|
|
306
335
|
## 🤖 GitHub Action
|
|
307
336
|
|
|
@@ -350,6 +379,11 @@ prebuilt action, so consumers do not need an Envilder build step.
|
|
|
350
379
|
- [📖 Full Documentation](https://envilder.com/docs/getting-started/?utm_source=npm&utm_medium=readme&utm_campaign=root-docs): the complete guide at envilder.com
|
|
351
380
|
- [Push Command Guide](docs/push-command.md)
|
|
352
381
|
- [Pull Command Guide](docs/pull-command.md)
|
|
382
|
+
- [Exec Command Guide](docs/exec-command.md)
|
|
383
|
+
- [envilder-examples](https://github.com/macalbert/envilder-examples): runnable examples for the SDKs and `envilder exec`
|
|
384
|
+
(Testcontainers and Aspire, AWS SSM and Azure Key Vault)
|
|
385
|
+
- [🤖 Envilder on Context7](https://context7.com/macalbert/envilder): up-to-date docs for AI coding assistants
|
|
386
|
+
(Claude Code, Cursor, Copilot). Add `use context7` to your prompt, or reference the library ID `/macalbert/envilder`.
|
|
353
387
|
|
|
354
388
|
## 🛠️ How it works
|
|
355
389
|
|
|
@@ -357,6 +391,7 @@ prebuilt action, so consumers do not need an Envilder build step.
|
|
|
357
391
|
graph LR
|
|
358
392
|
A["Mapping Contract<br/>(envilder.json)"] --> B[Envilder]:::core
|
|
359
393
|
B --> C["CLI → .env file"]
|
|
394
|
+
B --> X["CLI exec → process env"]
|
|
360
395
|
B --> D["GitHub Action → CI/CD"]
|
|
361
396
|
B --> E["SDK → app memory"]
|
|
362
397
|
F["AWS SSM / Azure Key Vault"]:::cloud --> B
|
|
@@ -367,7 +402,8 @@ graph LR
|
|
|
367
402
|
|
|
368
403
|
1. **Define**: create an `envilder.json` mapping env var names to cloud secret paths
|
|
369
404
|
2. **Resolve**: Envilder fetches each secret from your cloud vault
|
|
370
|
-
3. **Deliver**: secrets arrive as a `.env` file (CLI/GHA)
|
|
405
|
+
3. **Deliver**: secrets arrive as a `.env` file (CLI/GHA), in the environment of a command you
|
|
406
|
+
start with `envilder exec` (CLI), or in-memory (SDKs)
|
|
371
407
|
4. **Rotate**: update secret values in your cloud provider while keeping the same
|
|
372
408
|
application-facing mapping. Rerun Envilder to refresh a generated `.env`, or restart/re-resolve
|
|
373
409
|
in runtime consumers
|
|
@@ -387,11 +423,15 @@ layer that makes those secrets usable consistently across local development, CI/
|
|
|
387
423
|
Use Envilder when your secrets already live in your cloud provider and you want one versioned
|
|
388
424
|
`envilder.json` mapping contract everywhere your code runs.
|
|
389
425
|
|
|
426
|
+
`envilder exec` is not a sandbox either. It keeps secrets off the disk, but it does not isolate
|
|
427
|
+
the process: your command and every process it starts can read them. It also leaves an existing
|
|
428
|
+
`.env` file untouched, so delete it yourself when you move from pull mode to exec mode.
|
|
429
|
+
|
|
390
430
|
## 🏁 What's Next
|
|
391
431
|
|
|
392
|
-
Envilder already covers CLI, GitHub Action, and runtime SDKs for .NET, Python, and Node.js.
|
|
432
|
+
Envilder already covers CLI (including `envilder exec`), GitHub Action, and runtime SDKs for .NET, Python, and Node.js.
|
|
393
433
|
|
|
394
|
-
Next priorities include Go and Java SDKs
|
|
434
|
+
Next priorities include Go and Java SDKs and GCP Secret Manager.
|
|
395
435
|
|
|
396
436
|
See the [full roadmap](./ROADMAP.md).
|
|
397
437
|
|
|
@@ -414,17 +454,19 @@ See [CONTRIBUTING.md](./CONTRIBUTING.md).
|
|
|
414
454
|
<img src="./src/website/public/localstack-logo-horizontal-Dark.svg" alt="LocalStack" height="40">
|
|
415
455
|
</picture>
|
|
416
456
|
</a>
|
|
417
|
-
|
|
418
|
-
|
|
419
|
-
<
|
|
420
|
-
|
|
457
|
+
|
|
458
|
+
<a href="https://snyk.io/open-source/" target="_blank" rel="noopener noreferrer">
|
|
459
|
+
<picture>
|
|
460
|
+
<source media="(prefers-color-scheme: dark)" srcset="./src/website/public/snyk-logo-Light.svg">
|
|
461
|
+
<source media="(prefers-color-scheme: light)" srcset="./src/website/public/snyk-logo-Dark.svg">
|
|
462
|
+
<img src="./src/website/public/snyk-logo-Dark.svg" alt="Snyk" height="40">
|
|
463
|
+
</picture>
|
|
464
|
+
</a>
|
|
421
465
|
</p>
|
|
422
466
|
|
|
423
467
|
<p align="center">
|
|
424
468
|
Envilder is also supported through the
|
|
425
|
-
<a href="https://aws.amazon.com/blogs/opensource/aws-cloud-credits-for-open-source-projects-affirming-our-commitment/">
|
|
426
|
-
AWS Open Source Credits Program
|
|
427
|
-
</a>.
|
|
469
|
+
<a href="https://aws.amazon.com/blogs/opensource/aws-cloud-credits-for-open-source-projects-affirming-our-commitment/">AWS Open Source Credits Program</a>.
|
|
428
470
|
</p>
|
|
429
471
|
|
|
430
472
|
## 📜 License
|
package/ROADMAP.md
CHANGED
|
@@ -11,6 +11,9 @@ or directly inside application code at runtime.
|
|
|
11
11
|
> **Note:** This roadmap contains ideas and potential features based on initial vision and community feedback.
|
|
12
12
|
> Not all features are guaranteed to be implemented. Priorities may change based on user needs, feedback,
|
|
13
13
|
> and real-world usage patterns. Your input matters. Feel free to share your thoughts and suggestions!
|
|
14
|
+
>
|
|
15
|
+
> **Horizon:** "Up Next" covers the coming months and "Planned" the rest of the next twelve months
|
|
16
|
+
> (through October 2027). The [Out of scope](#-out-of-scope) section lists what Envilder does not intend to do.
|
|
14
17
|
|
|
15
18
|
---
|
|
16
19
|
|
|
@@ -18,41 +21,65 @@ or directly inside application code at runtime.
|
|
|
18
21
|
|
|
19
22
|
### ✅ Shipped
|
|
20
23
|
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
|
24
|
-
|
|
25
|
-
| **
|
|
26
|
-
|
|
|
27
|
-
| **
|
|
28
|
-
| **
|
|
29
|
-
| **
|
|
30
|
-
| **
|
|
31
|
-
| **
|
|
32
|
-
|
|
|
33
|
-
|
|
|
34
|
-
| **
|
|
24
|
+
Versions refer to each component's own changelog: [CLI](./docs/changelogs/cli.md), [GitHub Action](./docs/changelogs/gha.md), [.NET SDK](./docs/changelogs/sdk-dotnet.md), [Python SDK](./docs/changelogs/sdk-python.md) and [Node.js SDK](./docs/changelogs/sdk-nodejs.md).
|
|
25
|
+
|
|
26
|
+
| Feature | Version | Notes |
|
|
27
|
+
|---------|---------|-------|
|
|
28
|
+
| **Mapping-based resolution** | CLI v0.1.4 | Core functionality: resolve every variable declared in a JSON map file |
|
|
29
|
+
| **`.env` file generation** | CLI v0.1.4 | Core functionality |
|
|
30
|
+
| **AWS SSM Parameter Store** | CLI v0.1.4 | Default provider |
|
|
31
|
+
| **AWS profile support** | CLI v0.3.0 | `--profile` flag |
|
|
32
|
+
| **Push mode** (`--push`) | CLI v0.6.0 | Upload a `.env` file or a single variable (`--key`, `--value`, `--secret-path`) to the provider. Throttling retry and duplicate path checks since v0.7.7. [Guide](./docs/push-command.md) |
|
|
33
|
+
| **GitHub Action** | Action v0.7.0 | Pull secrets into `.env` files during workflow runs. [Documentation](./github-action/README.md) |
|
|
34
|
+
| **Azure Key Vault** | CLI v0.8.0, Action v0.8.0 | `--provider`, `--vault-url` and the `$config` map-file section. Precedence: flags > `$config` > defaults ([#90](https://github.com/macalbert/envilder/pull/90)) |
|
|
35
|
+
| **Documentation website** | CLI v0.9.1 | [envilder.com](https://envilder.com), in English, Spanish and Catalan. [Setup guide](./docs/requirements-installation.md) |
|
|
36
|
+
| **.NET SDK** (`Envilder`) | .NET SDK v0.1.0 | Load secrets into `IConfiguration`, `IServiceCollection` or `EnvilderClient`. Static facade, fluent builder and environment routing since v0.2.0. Published to NuGet. [Documentation](./src/sdks/dotnet/README.md) |
|
|
37
|
+
| **Python SDK** (`envilder`) | Python SDK v0.1.0 | Runtime library for Django, FastAPI and data pipelines. Fluent facade since v0.2.0, environment routing since v0.3.0. Published to PyPI. [Documentation](./src/sdks/python/README.md) |
|
|
38
|
+
| **Node.js SDK** (`@envilder/sdk`) | Node.js SDK v0.1.0 | Load secrets into `process.env` from a map file, with fluent builder, secret validation and environment routing. Published to npm. [Documentation](./src/sdks/nodejs/README.md) |
|
|
39
|
+
| **Map-file JSON Schema** | CLI v0.10.0, .NET SDK v0.3.0, Node.js SDK v0.2.0, Python SDK v0.4.0 | Formal spec at [`spec/map-file.v1.json`](./spec/map-file.v1.json), published at `https://envilder.com/schema/map-file.v1.json`: the contract between all SDKs and tools |
|
|
40
|
+
| **AWS identity banner** | CLI v0.12.1, Action v0.12.1 | Logs the effective AWS identity before resolving secrets (colorized since v0.13.0) |
|
|
41
|
+
| **Actionable credential errors** | CLI v0.13.0, .NET SDK v0.5.0, Node.js SDK v0.4.0, Python SDK v0.5.0 | Typed expired-credentials and expired-SSO-session errors with the exact fix (ADR-0010) |
|
|
42
|
+
| **SSO login recovery** | CLI v0.13.0 | On an interactive terminal, offers to run `aws sso login` and retries |
|
|
43
|
+
| **Secret masking in GitHub Actions** | Action v0.13.2 | Every resolved value is registered with `::add-mask::` before the `.env` file is written |
|
|
44
|
+
| **Zero-config defaults** | CLI v0.14.0 | `envilder` with no flags reads `envilder.json` and writes `.env` |
|
|
45
|
+
| **Safe `.env` writing** | CLI v0.14.0, Action v0.14.0 | Values round-trip exactly, and mapping keys a `.env` file cannot represent are rejected |
|
|
46
|
+
| **Exec mode** (`envilder exec`) | CLI v0.15.0 | `envilder exec [options] [--] <command> [args...]` starts a command with the resolved secrets in its environment, without writing a `.env` file. [Guide](./docs/exec-command.md) |
|
|
35
47
|
|
|
36
48
|
### 🔥 Up Next
|
|
37
49
|
|
|
38
50
|
| Feature | Priority | Notes |
|
|
39
51
|
|---------|----------|-------|
|
|
40
|
-
| **Go SDK** (`envilder`) | 🔴 High | Runtime library for Go: cloud-native apps, Kubernetes tooling. Published as Go module |
|
|
41
|
-
| **Java SDK** (`envilder`) | 🔴 High | Runtime library for Java/Kotlin: Spring Boot, Android backends. Published to Maven Central |
|
|
42
|
-
| **Map-file JSON Schema** | 🔴 High | Formal spec for the map-file format at `spec/`: serves as the contract between all SDKs and tools |
|
|
52
|
+
| **Go SDK** (`envilder`) | 🔴 High | Runtime library for Go: cloud-native apps, Kubernetes tooling. Published as Go module ([#561](https://github.com/macalbert/envilder/issues/561) → [#562](https://github.com/macalbert/envilder/issues/562) → [#563](https://github.com/macalbert/envilder/issues/563)) |
|
|
53
|
+
| **Java SDK** (`envilder`) | 🔴 High | Runtime library for Java/Kotlin: Spring Boot, Android backends. Published to Maven Central ([#569](https://github.com/macalbert/envilder/issues/569)) |
|
|
43
54
|
| **SDK conformance tests** | 🔴 High | Language-agnostic test fixtures (JSON input → expected output) that all SDKs must pass |
|
|
44
|
-
| **
|
|
45
|
-
| **GCP Secret Manager** | 🟡 Medium | Third cloud provider: similar DX to AWS SSM. Completes the multi-cloud trident (AWS + Azure + GCP) |
|
|
55
|
+
| **Validate command** (`envilder validate`) | 🟡 Medium | Preflight check: map file, remote key existence and optional `.env` comparison, without printing values. CLI first, then the SDKs ([#532](https://github.com/macalbert/envilder/issues/532)) |
|
|
56
|
+
| **GCP Secret Manager** | 🟡 Medium | Third cloud provider: similar DX to AWS SSM. Completes the multi-cloud trident (AWS + Azure + GCP) ([#573](https://github.com/macalbert/envilder/issues/573)) |
|
|
46
57
|
| **AWS Secrets Manager** | 🟡 Medium | Support AWS Secrets Manager alongside SSM Parameter Store for teams using JSON-structured secrets |
|
|
47
|
-
| **Check/sync mode** (`--check`) | 🟡 Medium | Validate cloud secrets vs local `.env`, fail CI if out-of-sync |
|
|
48
58
|
|
|
49
59
|
### 💡 Planned
|
|
50
60
|
|
|
51
61
|
| Feature | Priority | Notes |
|
|
52
62
|
|---------|----------|-------|
|
|
53
63
|
| **Auto-discovery mode** (`--auto`) | Medium | Fetch all parameters matching a given prefix (e.g., `/my-app/prod/*`) |
|
|
54
|
-
| **
|
|
55
|
-
| **
|
|
64
|
+
| **Local override map file** (`envilder.local.json`) | Medium | Personal, gitignored layer on top of the committed map file, on every surface (ADR-0011, [#385](https://github.com/macalbert/envilder/issues/385)) |
|
|
65
|
+
| **Environment delivery in the GitHub Action** | Medium | Export resolved values to later job steps instead of writing a `.env` file ([#478](https://github.com/macalbert/envilder/issues/478)) |
|
|
66
|
+
| **Exec with refresh** (`--refresh-interval`) | Low | Kill & restart child process periodically with fresh secrets (builds on `envilder exec`, [#479](https://github.com/macalbert/envilder/issues/479)) |
|
|
67
|
+
| **Named providers and per-environment config** | Medium | Several providers in one map file, per-environment provider settings and optional secrets, through `$config.providers`. Additive to the current schema; the flat `$config` fields are deprecated, with `envilder migrate` ([#586](https://github.com/macalbert/envilder/issues/586)) |
|
|
68
|
+
| **Per-provider packages** | Medium | Split the SDK packages per provider, so an app installs only the cloud SDKs it uses. Prerequisite for adding more providers |
|
|
69
|
+
| **Kubernetes Secrets** | Low | Read secrets from a cluster: in-cluster service account in production, kubeconfig locally |
|
|
70
|
+
| **HashiCorp Vault / OpenBao** | Low | KV secrets engine, with GitHub OIDC (JWT auth) in the Action |
|
|
71
|
+
| **Infisical** | Low | Cloud or self-hosted Infisical, with machine identities and GitHub OIDC |
|
|
72
|
+
| **Azure App Configuration** | Low | Settings and Key Vault references from App Configuration, for .NET-centric teams on Azure |
|
|
73
|
+
|
|
74
|
+
### 🚫 Out of scope
|
|
75
|
+
|
|
76
|
+
Envilder resolves secrets from stores you already run. It does not intend to:
|
|
77
|
+
|
|
78
|
+
- **Be a secret store**: values stay in the cloud provider; Envilder never keeps its own copy outside the `.env` file or process environment you ask for
|
|
79
|
+
- **Run a hosted service or server**: everything runs locally, in CI or inside your application, with your own credentials
|
|
80
|
+
- **Manage secret lifecycle**: creating vaults, rotating values, setting expiry or access policies stays with the provider's own tooling
|
|
81
|
+
- **Encrypt `.env` files**: protecting the generated file on disk is the job of the environment that consumes it
|
|
82
|
+
- **Ship a graphical interface**: the CLI, GitHub Action and SDKs are the supported surfaces
|
|
56
83
|
|
|
57
84
|
---
|
|
58
85
|
|
|
@@ -89,7 +116,7 @@ All five SDKs are developed **in parallel**: same map-file contract, same confor
|
|
|
89
116
|
- **One map-file spec**: formal JSON Schema at `spec/` is the source of truth for all SDKs
|
|
90
117
|
- **Conformance tests**: language-agnostic fixtures that every SDK must pass
|
|
91
118
|
- **Independent versioning**: each SDK has its own semver (`sdk-node@1.2.0`, `sdk-py@0.3.0`)
|
|
92
|
-
- **Shared test infrastructure**: LocalStack
|
|
119
|
+
- **Shared test infrastructure**: LocalStack for AWS and Azure via Docker Compose serve all SDKs
|
|
93
120
|
|
|
94
121
|
---
|
|
95
122
|
|
package/docs/SECURITY.md
CHANGED
|
@@ -9,6 +9,12 @@ We release patches for security vulnerabilities only in the latest version:
|
|
|
9
9
|
| Latest | ✅ |
|
|
10
10
|
| Older | ❌ |
|
|
11
11
|
|
|
12
|
+
## 🎯 Security Requirements
|
|
13
|
+
|
|
14
|
+
Envilder reads secrets from AWS SSM Parameter Store or Azure Key Vault with your own credentials and writes them only to the `.env` file, process environment or application configuration you ask for. It never logs secret values, runs no server and implements no cryptography of its own.
|
|
15
|
+
|
|
16
|
+
It does not protect the generated `.env` file, the command started by `envilder exec`, or a map file that someone with write access to your repository has changed. The full list of what you can and cannot expect, together with the threat model, trust boundaries and the reasoning behind them, is in the [Security Requirements and Assurance Case](./security-assurance-case.md).
|
|
17
|
+
|
|
12
18
|
## 🚨 Reporting a Vulnerability
|
|
13
19
|
|
|
14
20
|
**Please do not report security vulnerabilities through public GitHub issues.**
|
|
@@ -17,18 +23,22 @@ If you discover a security vulnerability in Envilder, please report it privately
|
|
|
17
23
|
|
|
18
24
|
### How to Report
|
|
19
25
|
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
26
|
+
Use either channel:
|
|
27
|
+
|
|
28
|
+
- **GitHub (preferred)**: [open a private security advisory](https://github.com/macalbert/envilder/security/advisories/new)
|
|
29
|
+
- **Email**: send details to <mac.albert@gmail.com> with the subject `[SECURITY] Envilder - [Brief Description]`
|
|
30
|
+
|
|
31
|
+
Please include:
|
|
32
|
+
|
|
33
|
+
- Description of the vulnerability
|
|
34
|
+
- Steps to reproduce the issue
|
|
35
|
+
- Potential impact
|
|
36
|
+
- Suggested fix (if available)
|
|
37
|
+
- Your contact information for follow-up
|
|
28
38
|
|
|
29
39
|
### What to Expect
|
|
30
40
|
|
|
31
|
-
- **Acknowledgment**: I
|
|
41
|
+
- **Acknowledgment**: I aim to acknowledge every report within 14 days
|
|
32
42
|
- **Initial Assessment**: I'll provide an initial assessment and prioritize based on severity
|
|
33
43
|
- **Updates**: I'll keep you informed about the progress
|
|
34
44
|
- **Resolution**: I'll work to release a fix as soon as feasible (timeline depends on severity and complexity)
|
|
@@ -131,11 +141,27 @@ When using Envilder GitHub Action:
|
|
|
131
141
|
- ❌ Store AWS credentials in GitHub Secrets (use OIDC roles)
|
|
132
142
|
- ❌ Use overly permissive IAM policies
|
|
133
143
|
|
|
144
|
+
## 🔏 Verifying Releases
|
|
145
|
+
|
|
146
|
+
Packages are built and published only by GitHub Actions workflows in this repository, using OIDC instead of long-lived registry tokens.
|
|
147
|
+
|
|
148
|
+
- **npm** (`envilder`, `@envilder/sdk`): published with [npm provenance](https://docs.npmjs.com/generating-provenance-statements), signed through Sigstore. After installing, run `npm audit signatures` in your project to verify the registry signatures and provenance attestations. The npm package page also links each version to the commit and workflow run that built it.
|
|
149
|
+
- **PyPI** (`envilder`): published with [PEP 740 attestations](https://docs.pypi.org/attestations/) through trusted publishing. The "Provenance" section of each file on PyPI shows the source repository and workflow. To verify locally:
|
|
150
|
+
|
|
151
|
+
```bash
|
|
152
|
+
pip install pypi-attestations
|
|
153
|
+
pypi-attestations verify pypi --repository https://github.com/macalbert/envilder pypi:envilder-<version>-py3-none-any.whl
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
- **NuGet** (`Envilder`): every package carries the NuGet.org repository signature, which you can check with `dotnet nuget verify Envilder.<version>.nupkg`.
|
|
157
|
+
- **GitHub Action**: referenced directly from this repository. For an immutable reference, pin the action to a full commit SHA instead of a tag.
|
|
158
|
+
|
|
134
159
|
## 🔍 Security Audits
|
|
135
160
|
|
|
136
161
|
This project uses:
|
|
137
162
|
|
|
138
163
|
- **Snyk**: Vulnerability scanning for dependencies
|
|
164
|
+
- **CodeQL**: Static analysis for security issues in the TypeScript code
|
|
139
165
|
- **Secretlint**: Prevents accidental secret commits
|
|
140
166
|
- **Biome**: Code quality and security linting
|
|
141
167
|
- **Dependabot**: Automated dependency updates
|
package/docs/changelogs/cli.md
CHANGED
|
@@ -5,6 +5,71 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
|
|
|
5
5
|
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
+
## [0.15.1] - 2026-10-22
|
|
9
|
+
|
|
10
|
+
### Security
|
|
11
|
+
|
|
12
|
+
* Update development and build dependencies to resolve open advisories:
|
|
13
|
+
`undici` 8.10.2 → 8.12.3 (via `testcontainers`), `brace-expansion`,
|
|
14
|
+
`@grpc/grpc-js` and `@vitest/mocker`. The published `envilder` package and
|
|
15
|
+
its runtime dependencies are unchanged
|
|
16
|
+
([#609](https://github.com/macalbert/envilder/pull/609))
|
|
17
|
+
|
|
18
|
+
### Dependencies
|
|
19
|
+
|
|
20
|
+
* Bump `testcontainers` and `@testcontainers/localstack` from 12.2.0 to 12.2.1
|
|
21
|
+
* Bump `vitest` and `@vitest/coverage-v8` from 4.1.11 to 4.1.12
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## [0.15.0] - 2026-10-16
|
|
26
|
+
|
|
27
|
+
### Added
|
|
28
|
+
|
|
29
|
+
* **`envilder exec`: run a command with resolved secrets, without a `.env`
|
|
30
|
+
file**: `envilder exec [options] [--] <command> [args...]` resolves every
|
|
31
|
+
secret in the map file and starts the command with those values in its
|
|
32
|
+
environment. Nothing is written to disk. The command starts at the first
|
|
33
|
+
argument that is not an Envilder option (`--` is optional), arguments are
|
|
34
|
+
passed verbatim without a shell, and Windows `npm`/`npx` shims are supported.
|
|
35
|
+
Resolution is fail-closed: the command never starts when a secret is missing,
|
|
36
|
+
empty or unreadable. Mapped values override inherited variables, naming the
|
|
37
|
+
overridden variables on stderr. All Envilder output goes to stderr as a
|
|
38
|
+
single summary line that names the program but never its arguments, so
|
|
39
|
+
stdout carries only the command's output. Inside GitHub Actions every value
|
|
40
|
+
is registered for masking, and every registration is written to stderr
|
|
41
|
+
before the command starts. Exit codes follow GNU `env`: the command's own
|
|
42
|
+
code, `128+n` for signals, `125` for Envilder errors, `126` and `127` when
|
|
43
|
+
the command cannot be executed or found. `SIGTERM` and `SIGHUP` are
|
|
44
|
+
forwarded and the command is awaited without a timeout, even if a signal
|
|
45
|
+
cannot be delivered. An expired AWS SSO session is recovered interactively
|
|
46
|
+
before the command starts. Exec mode is not a sandbox: see
|
|
47
|
+
[docs/exec-command.md](../exec-command.md)
|
|
48
|
+
([#550](https://github.com/macalbert/envilder/issues/550))
|
|
49
|
+
|
|
50
|
+
### Security
|
|
51
|
+
|
|
52
|
+
* **Parse errors no longer echo option values or arguments**: parse errors
|
|
53
|
+
are rebuilt from safe forms, so option values and extra arguments are never
|
|
54
|
+
printed. An unknown long option is named only when it is a near-typo of a
|
|
55
|
+
real option, together with the suggestion (`--valeu=<value>` is shown as
|
|
56
|
+
`unknown option '--valeu' (Did you mean --value?)`); any other unknown long
|
|
57
|
+
option gets a generic message, so a mistyped secret is never echoed. An
|
|
58
|
+
unknown short option is named by its single character, "too many
|
|
59
|
+
arguments" shows only the counts, and any other parse error is replaced
|
|
60
|
+
with a generic message. Exit codes are unchanged
|
|
61
|
+
([#554](https://github.com/macalbert/envilder/issues/554))
|
|
62
|
+
|
|
63
|
+
* **Path and name options never swallow the next option**: `--map`,
|
|
64
|
+
`--envfile`, `--profile`, `--provider`, `--vault-url`, `--key`,
|
|
65
|
+
`--secret-path` and `--ssm-path` (and their `exec` counterparts) reject a
|
|
66
|
+
value that starts with `-` as a missing argument, before any map file is
|
|
67
|
+
read, instead of taking the following option as their value. `--value` is
|
|
68
|
+
exempt, so a secret may still start with `-`
|
|
69
|
+
([#554](https://github.com/macalbert/envilder/issues/554))
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
8
73
|
## [0.14.0] - 2026-09-26
|
|
9
74
|
|
|
10
75
|
### Added
|
|
@@ -80,7 +145,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
|
|
|
80
145
|
|
|
81
146
|
---
|
|
82
147
|
|
|
83
|
-
## [0.13.0] - 2026-
|
|
148
|
+
## [0.13.0] - 2026-07-11
|
|
84
149
|
|
|
85
150
|
### Added
|
|
86
151
|
|
|
@@ -171,6 +236,20 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
|
|
|
171
236
|
|
|
172
237
|
---
|
|
173
238
|
|
|
239
|
+
## [0.11.1] - 2026-06-25
|
|
240
|
+
|
|
241
|
+
### Fixed
|
|
242
|
+
|
|
243
|
+
* **AWS SSO / assumed-role profiles now resolve correctly**: Selecting an
|
|
244
|
+
SSO, IAM Identity Center, or assumed-role profile (via `--profile` or
|
|
245
|
+
`$config.profile`) now resolves credentials through the full AWS provider
|
|
246
|
+
chain instead of silently falling back to the default credentials.
|
|
247
|
+
Previously these profiles were ignored, reading and writing secrets against
|
|
248
|
+
the wrong AWS account
|
|
249
|
+
([#364](https://github.com/macalbert/envilder/issues/364))
|
|
250
|
+
|
|
251
|
+
---
|
|
252
|
+
|
|
174
253
|
## [0.11.0] - 2026-05-31
|
|
175
254
|
|
|
176
255
|
### Changed
|
|
@@ -197,7 +276,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
|
|
|
197
276
|
published at `https://envilder.com/schema/map-file.v1.json`. Add
|
|
198
277
|
`"$schema": "https://envilder.com/schema/map-file.v1.json"` to any map file
|
|
199
278
|
for IDE autocomplete, inline documentation, and validation
|
|
200
|
-
([#
|
|
279
|
+
([#217](https://github.com/macalbert/envilder/pull/217))
|
|
201
280
|
* **Schema contract tests**: 39 tests validating the JSON Schema across all
|
|
202
281
|
providers (AWS, Azure, GCP, HashiCorp Vault, file)
|
|
203
282
|
|
|
@@ -327,6 +406,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
|
|
|
327
406
|
### Fixed
|
|
328
407
|
|
|
329
408
|
* **deps:** Move `@types/node` from `dependencies` to `devDependencies` to prevent it from being bundled as a runtime dependency
|
|
409
|
+
([#135](https://github.com/macalbert/envilder/pull/135))
|
|
330
410
|
* **e2e:** Use unique SSM paths per CLI test run to prevent race conditions between parallel test executions
|
|
331
411
|
|
|
332
412
|
### Dependencies
|
|
@@ -336,7 +416,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
|
|
|
336
416
|
|
|
337
417
|
---
|
|
338
418
|
|
|
339
|
-
## [0.8.0] - 2026-03-
|
|
419
|
+
## [0.8.0] - 2026-03-26
|
|
340
420
|
|
|
341
421
|
### Added
|
|
342
422
|
|
|
@@ -350,6 +430,13 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
|
|
|
350
430
|
* New infrastructure adapter: `AzureKeyVaultSecretProvider` implementing `ISecretProvider`
|
|
351
431
|
* New CLI option `--provider <name>` to select cloud provider (`aws` or `azure`, default: `aws`)
|
|
352
432
|
* Azure authentication via `DefaultAzureCredential` (supports Azure CLI, managed identity, etc.)
|
|
433
|
+
* Automatic secret name normalization for Key Vault naming constraints (alphanumeric and hyphens,
|
|
434
|
+
1–127 characters)
|
|
435
|
+
|
|
436
|
+
### Security
|
|
437
|
+
|
|
438
|
+
* **Vault URL validation**: Azure Key Vault URLs must use HTTPS and match an Azure domain allowlist
|
|
439
|
+
(with dot-boundary checks), preventing SSRF through spoofed hostnames
|
|
353
440
|
|
|
354
441
|
### Changed
|
|
355
442
|
|
|
@@ -701,3 +788,52 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
|
|
|
701
788
|
|
|
702
789
|
* CLI command not recognized after global install (`npm install -g envilder`)
|
|
703
790
|
* Fixed missing compiled `lib/` files in published package
|
|
791
|
+
|
|
792
|
+
---
|
|
793
|
+
|
|
794
|
+
## [0.3.0] - 2025-05-09
|
|
795
|
+
|
|
796
|
+
### Added
|
|
797
|
+
|
|
798
|
+
* **`--profile` option**: Choose which AWS CLI profile to use for credentials,
|
|
799
|
+
so you can work with different AWS accounts or configurations
|
|
800
|
+
([#31](https://github.com/macalbert/envilder/pull/31))
|
|
801
|
+
|
|
802
|
+
### Dependencies
|
|
803
|
+
|
|
804
|
+
* Bumped commander from 12.1.0 to 13.1.0, @aws-sdk/client-ssm, @types/node,
|
|
805
|
+
vite and @secretlint/secretlint-rule-preset-recommend
|
|
806
|
+
|
|
807
|
+
---
|
|
808
|
+
|
|
809
|
+
## [0.2.3] - 2025-04-13
|
|
810
|
+
|
|
811
|
+
### Dependencies
|
|
812
|
+
|
|
813
|
+
* Bumped @aws-sdk/client-ssm from 3.670.0 to 3.716.0
|
|
814
|
+
* Bumped nanoid (security patch), @types/node, @biomejs/biome, secretlint and
|
|
815
|
+
@secretlint/secretlint-rule-preset-recommend
|
|
816
|
+
|
|
817
|
+
---
|
|
818
|
+
|
|
819
|
+
## [0.2.1] - 2024-10-16
|
|
820
|
+
|
|
821
|
+
### Added
|
|
822
|
+
|
|
823
|
+
* **Preserve existing `.env` variables**: When the target `.env` already
|
|
824
|
+
exists, its variables are kept and only the mapped ones are added or updated
|
|
825
|
+
([#5](https://github.com/macalbert/envilder/pull/5))
|
|
826
|
+
* Secret values are masked in console output
|
|
827
|
+
* Code coverage reporting published to GitHub Pages
|
|
828
|
+
([#2](https://github.com/macalbert/envilder/pull/2))
|
|
829
|
+
* CodeQL code scanning ([#4](https://github.com/macalbert/envilder/pull/4))
|
|
830
|
+
|
|
831
|
+
---
|
|
832
|
+
|
|
833
|
+
## [0.1.4] - 2024-10-01
|
|
834
|
+
|
|
835
|
+
### Added
|
|
836
|
+
|
|
837
|
+
* **Initial release**: Generate `.env` files from AWS SSM Parameter Store
|
|
838
|
+
using a JSON map of environment variable names to SSM parameter paths
|
|
839
|
+
* Supports both encrypted (`SecureString`) and plain SSM parameters
|
package/docs/changelogs/gha.md
CHANGED
|
@@ -1,3 +1,27 @@
|
|
|
1
|
+
## [0.15.1] - 2026-10-22
|
|
2
|
+
|
|
3
|
+
### Security
|
|
4
|
+
|
|
5
|
+
* Update development and build dependencies to resolve open advisories
|
|
6
|
+
(`undici`, `brace-expansion`, `@grpc/grpc-js`, `@vitest/mocker`). The
|
|
7
|
+
Action bundle and its runtime dependencies are unchanged
|
|
8
|
+
([#609](https://github.com/macalbert/envilder/pull/609))
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## [0.15.0] - 2026-10-16
|
|
13
|
+
|
|
14
|
+
### Changed
|
|
15
|
+
|
|
16
|
+
* **Shared secret masker can report when registrations are written**: The
|
|
17
|
+
masker the Action shares with the CLI gained an internal capability to
|
|
18
|
+
report when its `::add-mask::` writes have completed, used by the new
|
|
19
|
+
CLI-only `envilder exec` command. The Action's pull flow does not use it,
|
|
20
|
+
and the registrations it prints are unchanged
|
|
21
|
+
([#550](https://github.com/macalbert/envilder/issues/550))
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
1
25
|
## [0.14.0] - 2026-09-26
|
|
2
26
|
|
|
3
27
|
### Fixed
|
|
@@ -50,6 +74,13 @@
|
|
|
50
74
|
|
|
51
75
|
## [0.13.1] - 2026-07-31
|
|
52
76
|
|
|
77
|
+
### Added
|
|
78
|
+
|
|
79
|
+
* **GitHub Marketplace listing and root reference**: A root `action.yml`
|
|
80
|
+
publishes the Action to the GitHub Marketplace and lets workflows use it as
|
|
81
|
+
`macalbert/envilder@<version>`. The `macalbert/envilder/github-action@v0`
|
|
82
|
+
reference keeps working.
|
|
83
|
+
|
|
53
84
|
### Changed
|
|
54
85
|
|
|
55
86
|
* **Bundle the GitHub Action with esbuild**: Replace the ncc bundler so the
|
|
@@ -61,7 +92,7 @@
|
|
|
61
92
|
|
|
62
93
|
---
|
|
63
94
|
|
|
64
|
-
## [0.13.0] - 2026-
|
|
95
|
+
## [0.13.0] - 2026-07-11
|
|
65
96
|
|
|
66
97
|
### Added
|
|
67
98
|
|
|
@@ -141,6 +172,18 @@
|
|
|
141
172
|
|
|
142
173
|
---
|
|
143
174
|
|
|
175
|
+
## [0.11.1] - 2026-06-25
|
|
176
|
+
|
|
177
|
+
### Fixed
|
|
178
|
+
|
|
179
|
+
* **AWS SSO / assumed-role profiles now resolve correctly**: The bundled CLI
|
|
180
|
+
now resolves SSO, IAM Identity Center, and assumed-role profiles (via the
|
|
181
|
+
`profile` input or `$config.profile`) through the full AWS provider chain
|
|
182
|
+
instead of silently falling back to the default credentials
|
|
183
|
+
([#364](https://github.com/macalbert/envilder/issues/364))
|
|
184
|
+
|
|
185
|
+
---
|
|
186
|
+
|
|
144
187
|
## [0.11.0] - 2026-05-31
|
|
145
188
|
|
|
146
189
|
### Changed
|
|
@@ -203,7 +246,7 @@
|
|
|
203
246
|
|
|
204
247
|
---
|
|
205
248
|
|
|
206
|
-
## [0.8.0] - 2026-03-
|
|
249
|
+
## [0.8.0] - 2026-03-26
|
|
207
250
|
|
|
208
251
|
### Added
|
|
209
252
|
|