envilder 0.12.1 → 0.13.0

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.
Files changed (106) hide show
  1. package/README.md +1 -1
  2. package/ROADMAP.md +14 -18
  3. package/docs/SECURITY.md +1 -1
  4. package/docs/changelogs/cli.md +72 -21
  5. package/docs/changelogs/gha.md +47 -11
  6. package/docs/changelogs/sdk-dotnet.md +51 -33
  7. package/docs/changelogs/sdk-nodejs.md +31 -13
  8. package/docs/changelogs/sdk-python.md +38 -20
  9. package/lib/envilder/apps/cli/entry/Cli.d.ts.map +1 -0
  10. package/lib/envilder/apps/cli/{Cli.js → entry/Cli.js} +8 -7
  11. package/lib/envilder/apps/cli/entry/Cli.js.map +1 -0
  12. package/lib/envilder/apps/cli/entry/Index.d.ts.map +1 -0
  13. package/lib/envilder/apps/cli/entry/Index.js +16 -0
  14. package/lib/envilder/apps/cli/entry/Index.js.map +1 -0
  15. package/lib/envilder/apps/cli/errors/CliErrorPresenter.d.ts +2 -0
  16. package/lib/envilder/apps/cli/errors/CliErrorPresenter.d.ts.map +1 -0
  17. package/lib/envilder/apps/cli/errors/CliErrorPresenter.js +78 -0
  18. package/lib/envilder/apps/cli/errors/CliErrorPresenter.js.map +1 -0
  19. package/lib/envilder/apps/cli/errors/SilentExitError.d.ts +5 -0
  20. package/lib/envilder/apps/cli/errors/SilentExitError.d.ts.map +1 -0
  21. package/lib/envilder/apps/cli/errors/SilentExitError.js +7 -0
  22. package/lib/envilder/apps/cli/errors/SilentExitError.js.map +1 -0
  23. package/lib/envilder/apps/cli/recovery/SsoLoginRecovery.d.ts +9 -0
  24. package/lib/envilder/apps/cli/recovery/SsoLoginRecovery.d.ts.map +1 -0
  25. package/lib/envilder/apps/cli/recovery/SsoLoginRecovery.js +120 -0
  26. package/lib/envilder/apps/cli/recovery/SsoLoginRecovery.js.map +1 -0
  27. package/lib/envilder/apps/gha/entry/Gha.d.ts.map +1 -0
  28. package/lib/envilder/apps/gha/{Gha.js → entry/Gha.js} +9 -7
  29. package/lib/envilder/apps/gha/entry/Gha.js.map +1 -0
  30. package/lib/envilder/apps/gha/entry/Index.d.ts.map +1 -0
  31. package/lib/envilder/apps/gha/entry/Index.js +12 -0
  32. package/lib/envilder/apps/gha/entry/Index.js.map +1 -0
  33. package/lib/envilder/apps/gha/errors/GhaErrorPresenter.d.ts +7 -0
  34. package/lib/envilder/apps/gha/errors/GhaErrorPresenter.d.ts.map +1 -0
  35. package/lib/envilder/apps/gha/errors/GhaErrorPresenter.js +32 -0
  36. package/lib/envilder/apps/gha/errors/GhaErrorPresenter.js.map +1 -0
  37. package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.d.ts +5 -1
  38. package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.d.ts.map +1 -1
  39. package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.js +22 -7
  40. package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.js.map +1 -1
  41. package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.d.ts +7 -2
  42. package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.d.ts.map +1 -1
  43. package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.js +78 -36
  44. package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.js.map +1 -1
  45. package/lib/envilder/core/application/pushSingle/PushSingleCommandHandler.d.ts +1 -0
  46. package/lib/envilder/core/application/pushSingle/PushSingleCommandHandler.d.ts.map +1 -1
  47. package/lib/envilder/core/application/pushSingle/PushSingleCommandHandler.js +10 -4
  48. package/lib/envilder/core/application/pushSingle/PushSingleCommandHandler.js.map +1 -1
  49. package/lib/envilder/core/domain/errors/DomainErrors.d.ts +31 -0
  50. package/lib/envilder/core/domain/errors/DomainErrors.d.ts.map +1 -1
  51. package/lib/envilder/core/domain/errors/DomainErrors.js +39 -0
  52. package/lib/envilder/core/domain/errors/DomainErrors.js.map +1 -1
  53. package/lib/envilder/core/domain/ports/ISecretProvider.d.ts +1 -0
  54. package/lib/envilder/core/domain/ports/ISecretProvider.d.ts.map +1 -1
  55. package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.d.ts +2 -1
  56. package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.d.ts.map +1 -1
  57. package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.js +44 -8
  58. package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.js.map +1 -1
  59. package/lib/envilder/core/infrastructure/aws/isExpiredCredentialsError.d.ts +2 -0
  60. package/lib/envilder/core/infrastructure/aws/isExpiredCredentialsError.d.ts.map +1 -0
  61. package/lib/envilder/core/infrastructure/aws/isExpiredCredentialsError.js +12 -0
  62. package/lib/envilder/core/infrastructure/aws/isExpiredCredentialsError.js.map +1 -0
  63. package/lib/envilder/core/infrastructure/aws/isSsoSessionExpiredError.d.ts +2 -0
  64. package/lib/envilder/core/infrastructure/aws/isSsoSessionExpiredError.d.ts.map +1 -0
  65. package/lib/envilder/core/infrastructure/aws/isSsoSessionExpiredError.js +9 -0
  66. package/lib/envilder/core/infrastructure/aws/isSsoSessionExpiredError.js.map +1 -0
  67. package/lib/envilder/core/infrastructure/azure/AzureKeyVaultSecretProvider.d.ts.map +1 -1
  68. package/lib/envilder/core/infrastructure/azure/AzureKeyVaultSecretProvider.js +2 -2
  69. package/lib/envilder/core/infrastructure/azure/AzureKeyVaultSecretProvider.js.map +1 -1
  70. package/lib/envilder/core/infrastructure/describeError.d.ts +9 -0
  71. package/lib/envilder/core/infrastructure/describeError.d.ts.map +1 -0
  72. package/lib/envilder/core/infrastructure/describeError.js +28 -0
  73. package/lib/envilder/core/infrastructure/describeError.js.map +1 -0
  74. package/lib/sdks/nodejs/src/domain/expired-credentials-error.d.ts +14 -0
  75. package/lib/sdks/nodejs/src/domain/expired-credentials-error.d.ts.map +1 -0
  76. package/lib/sdks/nodejs/src/domain/expired-credentials-error.js +29 -0
  77. package/lib/sdks/nodejs/src/domain/expired-credentials-error.js.map +1 -0
  78. package/lib/sdks/nodejs/src/domain/sso-session-expired-error.d.ts +16 -0
  79. package/lib/sdks/nodejs/src/domain/sso-session-expired-error.d.ts.map +1 -0
  80. package/lib/sdks/nodejs/src/domain/sso-session-expired-error.js +34 -0
  81. package/lib/sdks/nodejs/src/domain/sso-session-expired-error.js.map +1 -0
  82. package/lib/sdks/nodejs/src/index.d.ts +2 -0
  83. package/lib/sdks/nodejs/src/index.d.ts.map +1 -1
  84. package/lib/sdks/nodejs/src/index.js +2 -0
  85. package/lib/sdks/nodejs/src/index.js.map +1 -1
  86. package/lib/sdks/nodejs/src/infrastructure/aws/aws-ssm-secret-provider.d.ts +2 -1
  87. package/lib/sdks/nodejs/src/infrastructure/aws/aws-ssm-secret-provider.d.ts.map +1 -1
  88. package/lib/sdks/nodejs/src/infrastructure/aws/aws-ssm-secret-provider.js +22 -8
  89. package/lib/sdks/nodejs/src/infrastructure/aws/aws-ssm-secret-provider.js.map +1 -1
  90. package/lib/sdks/nodejs/src/infrastructure/secret-provider-factory.js +1 -1
  91. package/lib/sdks/nodejs/src/infrastructure/secret-provider-factory.js.map +1 -1
  92. package/package.json +15 -15
  93. package/lib/envilder/apps/cli/Cli.d.ts.map +0 -1
  94. package/lib/envilder/apps/cli/Cli.js.map +0 -1
  95. package/lib/envilder/apps/cli/Index.d.ts.map +0 -1
  96. package/lib/envilder/apps/cli/Index.js +0 -12
  97. package/lib/envilder/apps/cli/Index.js.map +0 -1
  98. package/lib/envilder/apps/gha/Gha.d.ts.map +0 -1
  99. package/lib/envilder/apps/gha/Gha.js.map +0 -1
  100. package/lib/envilder/apps/gha/Index.d.ts.map +0 -1
  101. package/lib/envilder/apps/gha/Index.js +0 -12
  102. package/lib/envilder/apps/gha/Index.js.map +0 -1
  103. /package/lib/envilder/apps/cli/{Cli.d.ts → entry/Cli.d.ts} +0 -0
  104. /package/lib/envilder/apps/cli/{Index.d.ts → entry/Index.d.ts} +0 -0
  105. /package/lib/envilder/apps/gha/{Gha.d.ts → entry/Gha.d.ts} +0 -0
  106. /package/lib/envilder/apps/gha/{Index.d.ts → entry/Index.d.ts} +0 -0
package/README.md CHANGED
@@ -367,7 +367,7 @@ graph LR
367
367
 
368
368
  Envilder is not a secrets manager. It does not replace Vault, Infisical, or Doppler.
369
369
 
370
- It also does not replace AWS SSM or Azure Key Vault — it works on top of them. Envilder does not
370
+ It also does not replace AWS SSM or Azure Key Vault: it works on top of them. Envilder does not
371
371
  store secrets, proxy requests, or introduce a SaaS control plane.
372
372
 
373
373
  Your cloud provider remains the source of truth. Envilder provides the mapping and resolution
package/ROADMAP.md CHANGED
@@ -3,21 +3,19 @@
3
3
  Envilder is evolving from a CLI tool into a **multi-runtime secret management platform**.
4
4
  The goal: one declarative map-file format becomes the universal standard for resolving
5
5
  environment variables from cloud secret stores (AWS SSM Parameter Store, AWS Secrets Manager,
6
- Azure Key Vault, GCP Secret Manager) — whether in local development, CI/CD pipelines,
6
+ Azure Key Vault, GCP Secret Manager): whether in local development, CI/CD pipelines,
7
7
  or directly inside application code at runtime.
8
8
 
9
9
  > **Vision:** One map-file. Every cloud. Every language. Every runtime.
10
10
  >
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
- > and real-world usage patterns. Your input matters—feel free to share your thoughts and suggestions!
13
+ > and real-world usage patterns. Your input matters. Feel free to share your thoughts and suggestions!
14
14
 
15
15
  ---
16
16
 
17
17
  ## Feature Status & Roadmap
18
18
 
19
- <!-- markdownlint-disable MD013 -->
20
-
21
19
  ### ✅ Shipped
22
20
 
23
21
  | Feature | Notes |
@@ -31,20 +29,20 @@ or directly inside application code at runtime.
31
29
  | **Azure Key Vault** | Multi-backend via `$config` map-file section ([#90](https://github.com/macalbert/envilder/pull/90)) |
32
30
  | **Documentation website** | [envilder.com](https://envilder.com) |
33
31
  | **Onboarding documentation** | [Setup guide](./docs/requirements-installation.md) |
34
- | **.NET SDK** (`Envilder`) | First runtime SDK — load secrets into `IConfiguration` or `EnvilderClient`. AWS SSM + Azure Key Vault. [Documentation](./src/sdks/dotnet/README.md) |
35
- | **Python SDK** (`envilder`) | Runtime library for Python — Django, FastAPI, data pipelines. Sync API with `EnvilderClient`, `MapFileParser`, `SecretProviderFactory`. AWS SSM + Azure Key Vault. Published to PyPI. [Documentation](./src/sdks/python/README.md) |
36
- | **Node.js SDK** (`@envilder/sdk`) | Runtime library for Node.js — load secrets directly into `process.env` from a map-file. AWS SSM + Azure Key Vault. Published to npm. [Documentation](./src/sdks/nodejs/README.md) |
32
+ | **.NET SDK** (`Envilder`) | First runtime SDK: load secrets into `IConfiguration` or `EnvilderClient`. AWS SSM + Azure Key Vault. [Documentation](./src/sdks/dotnet/README.md) |
33
+ | **Python SDK** (`envilder`) | Runtime library for Python: Django, FastAPI, data pipelines. Sync API with `EnvilderClient`, `MapFileParser`, `SecretProviderFactory`. AWS SSM + Azure Key Vault. Published to PyPI. [Documentation](./src/sdks/python/README.md) |
34
+ | **Node.js SDK** (`@envilder/sdk`) | Runtime library for Node.js: load secrets directly into `process.env` from a map-file. AWS SSM + Azure Key Vault. Published to npm. [Documentation](./src/sdks/nodejs/README.md) |
37
35
 
38
36
  ### 🔥 Up Next
39
37
 
40
38
  | Feature | Priority | Notes |
41
39
  |---------|----------|-------|
42
- | **Go SDK** (`envilder`) | 🔴 High | Runtime library for Go — cloud-native apps, Kubernetes tooling. Published as Go module |
43
- | **Java SDK** (`envilder`) | 🔴 High | Runtime library for Java/Kotlin — Spring Boot, Android backends. Published to Maven Central |
44
- | **Map-file JSON Schema** | 🔴 High | Formal spec for the map-file format at `spec/` — serves as the contract between all SDKs and tools |
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 |
45
43
  | **SDK conformance tests** | 🔴 High | Language-agnostic test fixtures (JSON input → expected output) that all SDKs must pass |
46
44
  | **Exec mode** (`--exec`) | 🟡 Medium | Inject secrets into a child process env without writing to disk (`envilder exec -- node server.js`) |
47
- | **GCP Secret Manager** | 🟡 Medium | Third cloud provider — similar DX to AWS SSM. Completes the multi-cloud trident (AWS + Azure + GCP) |
45
+ | **GCP Secret Manager** | 🟡 Medium | Third cloud provider: similar DX to AWS SSM. Completes the multi-cloud trident (AWS + Azure + GCP) |
48
46
  | **AWS Secrets Manager** | 🟡 Medium | Support AWS Secrets Manager alongside SSM Parameter Store for teams using JSON-structured secrets |
49
47
  | **Check/sync mode** (`--check`) | 🟡 Medium | Validate cloud secrets vs local `.env`, fail CI if out-of-sync |
50
48
 
@@ -56,8 +54,6 @@ or directly inside application code at runtime.
56
54
  | **Exec with refresh** (`--refresh-interval`) | Low | Kill & restart child process periodically with fresh secrets (requires `--exec`) |
57
55
  | **Hierarchical mapping** | Low | Per-environment `envilder.json` with inheritance/overrides |
58
56
 
59
- <!-- markdownlint-enable MD013 -->
60
-
61
57
  ---
62
58
 
63
59
  ## 🏗️ Platform Architecture
@@ -78,7 +74,7 @@ envilder.json (universal contract)
78
74
 
79
75
  ### SDK Rollout
80
76
 
81
- All five SDKs are developed **in parallel** — same map-file contract, same conformance tests, shipped simultaneously:
77
+ All five SDKs are developed **in parallel**: same map-file contract, same conformance tests, shipped simultaneously:
82
78
 
83
79
  | SDK | Package | Registry |
84
80
  |-----|---------|----------|
@@ -90,10 +86,10 @@ All five SDKs are developed **in parallel** — same map-file contract, same con
90
86
 
91
87
  ### Monorepo Principles
92
88
 
93
- - **One map-file spec** — formal JSON Schema at `spec/` is the source of truth for all SDKs
94
- - **Conformance tests** — language-agnostic fixtures that every SDK must pass
95
- - **Independent versioning** — each SDK has its own semver (`sdk-node@1.2.0`, `sdk-py@0.3.0`)
96
- - **Shared test infrastructure** — LocalStack (AWS) and Lowkey Vault (Azure) via Docker Compose serve all SDKs
89
+ - **One map-file spec**: formal JSON Schema at `spec/` is the source of truth for all SDKs
90
+ - **Conformance tests**: language-agnostic fixtures that every SDK must pass
91
+ - **Independent versioning**: each SDK has its own semver (`sdk-node@1.2.0`, `sdk-py@0.3.0`)
92
+ - **Shared test infrastructure**: LocalStack (AWS) and Lowkey Vault (Azure) via Docker Compose serve all SDKs
97
93
 
98
94
  ---
99
95
 
package/docs/SECURITY.md CHANGED
@@ -61,7 +61,7 @@ When using Envilder, follow these security guidelines:
61
61
  - ✅ Use workload identity federation (OIDC) for GitHub Actions ([setup guide](https://learn.microsoft.com/en-us/entra/workload-id/workload-identity-federation-create-trust-github))
62
62
  - ✅ Use managed identities in Azure-hosted environments
63
63
  - ✅ Scope Key Vault access to specific secrets and operations
64
- - ✅ Set vault URL via `$config.vaultUrl` in your map file or `--vault-url` flag—never hardcode secrets in code
64
+ - ✅ Set vault URL via `$config.vaultUrl` in your map file or `--vault-url` flag; never hardcode secrets in code
65
65
 
66
66
  **DON'T**:
67
67
 
@@ -5,11 +5,62 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
5
5
 
6
6
  ---
7
7
 
8
+ ## [0.13.0] - 2026-06-26
9
+
10
+ ### Added
11
+
12
+ * **Colorized `AWS identity` banner**: The
13
+ `☁ AWS identity · account=… · region=… · profile=…` line is now colorized.
14
+ `account` and `region` render in red when they resolve to `unknown`,
15
+ signalling that authentication failed
16
+ ([#382](https://github.com/macalbert/envilder/issues/382))
17
+
18
+ * **Dedicated `SsoSessionExpiredError` for expired SSO sessions**:
19
+ Failures to resolve or load an AWS SSO session now surface as a
20
+ dedicated `SsoSessionExpiredError` (a sibling of
21
+ `ExpiredCredentialsError`) carrying the AWS profile from
22
+ `$config.profile`. The message is calm and actionable, telling you to
23
+ run `aws sso login --profile <name>`. A plain expired session token
24
+ still surfaces as `ExpiredCredentialsError`
25
+ ([#374](https://github.com/macalbert/envilder/issues/374))
26
+
27
+ * **Calm, actionable error blocks via `CliErrorPresenter`**: Credential
28
+ errors now render through a single `CliErrorPresenter` that prints a
29
+ calm, colorized, actionable error block instead of a raw stack trace
30
+ ([#374](https://github.com/macalbert/envilder/issues/374))
31
+
32
+ * **TTY-gated `aws sso login` redirect with auto-retry**: On an
33
+ `SsoSessionExpiredError` in an interactive terminal, the CLI offers to
34
+ run `aws sso login` for you (spawned safely with array arguments,
35
+ never through a shell) and retries the pull once after a successful
36
+ login. Non-interactive runs (CI, pipes) never prompt and just present
37
+ the actionable message
38
+ ([#375](https://github.com/macalbert/envilder/issues/375))
39
+
40
+ ### Changed
41
+
42
+ * **Print the `AWS identity` banner before resolving secrets**: The
43
+ banner is now printed before secrets are resolved, so it always
44
+ appears first. Previously it could surface mid-output because secrets
45
+ resolve in parallel
46
+ ([#382](https://github.com/macalbert/envilder/issues/382))
47
+
48
+ ### Fixed
49
+
50
+ * **Clear error for expired or invalid AWS credentials**: Expired or
51
+ invalid AWS credentials (e.g. an expired session token) now produce a
52
+ clear, actionable `ExpiredCredentialsError` telling you to refresh
53
+ credentials (e.g. run `aws sso login`), instead of being masked as a
54
+ misleading `ParameterNotFound`. The pull command now fails fast in
55
+ this case
56
+
57
+ ---
58
+
8
59
  ## [0.12.1] - 2026-06-26
9
60
 
10
61
  ### Fixed
11
62
 
12
- * **Honor `$config.profile` for the AWS region, not just credentials** —
63
+ * **Honor `$config.profile` for the AWS region, not just credentials**:
13
64
  When a map file set an AWS profile via `$config.profile`, Envilder applied
14
65
  it to credentials only; the AWS SDK fell back to the default profile's
15
66
  region and silently read or wrote SSM parameters in the wrong
@@ -21,9 +72,9 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
21
72
 
22
73
  ### Added
23
74
 
24
- * **Log the effective AWS identity before resolving secrets** —
75
+ * **Log the effective AWS identity before resolving secrets**:
25
76
  Before the first read or write, Envilder logs
26
- `AWS identity → account=… region=… profile=…` so a misrouted account
77
+ `☁ AWS identity · account=… · region=… · profile=…` so a misrouted account
27
78
  or region is immediately visible. The account is read from the active
28
79
  credentials, falling back to an STS `GetCallerIdentity` call when not
29
80
  present, then `unknown`
@@ -35,7 +86,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
35
86
 
36
87
  ### Changed
37
88
 
38
- * **Preserve existing `.env` formatting on pull** — When the target `.env`
89
+ * **Preserve existing `.env` formatting on pull**: When the target `.env`
39
90
  file already exists, Envilder now updates values in place instead of
40
91
  rewriting the file from scratch. Full-line comments, blank lines, key
41
92
  ordering, `export` prefixes, and surrounding spacing are preserved; only
@@ -49,7 +100,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
49
100
 
50
101
  ### Changed
51
102
 
52
- * **BREAKING: Require Node.js >= 22.12** — pnpm 11, testcontainers v12,
103
+ * **BREAKING: Require Node.js >= 22.12**: pnpm 11, testcontainers v12,
53
104
  commander 15, and commitlint 21 require Node.js 22.12+. The `engines`
54
105
  field now enforces `>=22.12.0`
55
106
  ([#291](https://github.com/macalbert/envilder/pull/291))
@@ -58,7 +109,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
58
109
 
59
110
  * Update all devDependencies to latest (TypeScript 6.0.3, Biome 2.4.16,
60
111
  testcontainers 12.0.1, pnpm 11.5.0)
61
- * Remove `rimraf` — replaced with zero-dependency `fs.rmSync` in clean scripts
112
+ * Remove `rimraf`: replaced with zero-dependency `fs.rmSync` in clean scripts
62
113
  ([#291](https://github.com/macalbert/envilder/pull/291))
63
114
 
64
115
  ---
@@ -67,17 +118,17 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
67
118
 
68
119
  ### Added
69
120
 
70
- * **Map-file JSON Schema** — A formal JSON Schema specification for map files,
121
+ * **Map-file JSON Schema**: A formal JSON Schema specification for map files,
71
122
  published at `https://envilder.com/schema/map-file.v1.json`. Add
72
123
  `"$schema": "https://envilder.com/schema/map-file.v1.json"` to any map file
73
124
  for IDE autocomplete, inline documentation, and validation
74
125
  ([#218](https://github.com/macalbert/envilder/pull/218))
75
- * **Schema contract tests** — 39 tests validating the JSON Schema across all
126
+ * **Schema contract tests**: 39 tests validating the JSON Schema across all
76
127
  providers (AWS, Azure, GCP, HashiCorp Vault, file)
77
128
 
78
129
  ### Fixed
79
130
 
80
- * **Reserved key filtering** — All `$`-prefixed keys (e.g. `$schema`) are now
131
+ * **Reserved key filtering**: All `$`-prefixed keys (e.g. `$schema`) are now
81
132
  excluded from variable mappings. Previously only `$config` was filtered,
82
133
  causing `$schema` to leak into environment variables
83
134
  ([#218](https://github.com/macalbert/envilder/pull/218))
@@ -96,7 +147,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
96
147
 
97
148
  ### Added
98
149
 
99
- * **Runtime SDKs now available** — Load secrets directly into your application
150
+ * **Runtime SDKs now available**: Load secrets directly into your application
100
151
  at startup, no `.env` file needed:
101
152
 
102
153
  **.NET** ([NuGet](https://www.nuget.org/packages/Envilder)):
@@ -129,7 +180,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
129
180
 
130
181
  ### Changed
131
182
 
132
- * **README rewritten** — Streamlined messaging, accurate comparison
183
+ * **README rewritten**: Streamlined messaging, accurate comparison
133
184
  tables, simplified quick start (2 steps), and reduced noise
134
185
 
135
186
  ### Fixed
@@ -153,11 +204,11 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
153
204
 
154
205
  ### Added
155
206
 
156
- * **LocalStack sponsor section** — Added sponsor section to website homepage and README with LocalStack logos
207
+ * **LocalStack sponsor section**: Added sponsor section to website homepage and README with LocalStack logos
157
208
  (dark, light, color variants) and a new `Sponsors.astro` component
158
209
  ([#136](https://github.com/macalbert/envilder/pull/136))
159
- * **Website test suite** — Added `tests/website/` with Vitest coverage for i18n utilities and Markdown helpers
160
- * **`BackToTop` component** — New scroll-to-top button component for the documentation website
210
+ * **Website test suite**: Added `tests/website/` with Vitest coverage for i18n utilities and Markdown helpers
211
+ * **`BackToTop` component**: New scroll-to-top button component for the documentation website
161
212
 
162
213
  ### Changed
163
214
 
@@ -165,7 +216,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
165
216
  * Core domain layer moved from `src/envilder/` to `src/envilder/core/`
166
217
  * Website moved from `src/apps/website/` to `src/website/`
167
218
  * All imports, `tsconfig.json`, `package.json`, and workspace config updated accordingly
168
- * **Website UX improvements** — `DocsContent`, `HowItWorks`, `ThemeSwitcher`, `TerminalMockup`, and
219
+ * **Website UX improvements**: `DocsContent`, `HowItWorks`, `ThemeSwitcher`, `TerminalMockup`, and
169
220
  `BaseLayout` components updated; global CSS expanded; i18n keys added for new content
170
221
 
171
222
  ### Fixed
@@ -191,7 +242,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
191
242
 
192
243
  ### Added
193
244
 
194
- * **Documentation website** — Full Astro-based docs site deployed at [envilder.com](https://envilder.com),
245
+ * **Documentation website**: Full Astro-based docs site deployed at [envilder.com](https://envilder.com),
195
246
  with multi-language support (EN, ES, CA), dark/retro and light themes, and a dedicated changelog page
196
247
 
197
248
  ### Changed
@@ -214,20 +265,20 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
214
265
 
215
266
  ### Added
216
267
 
217
- * **`$config` section in map files** — Map files now support an optional `$config` key to declare provider
268
+ * **`$config` section in map files**: Map files now support an optional `$config` key to declare provider
218
269
  and connection details inline (e.g., `"provider": "azure"`, `"vaultUrl": "https://..."`,
219
270
  `"profile": "dev-account"`)
220
- * New CLI flag `--vault-url <url>` — Azure Key Vault URL, overrides `$config.vaultUrl` in the map file
271
+ * New CLI flag `--vault-url <url>`: Azure Key Vault URL, overrides `$config.vaultUrl` in the map file
221
272
  * Precedence chain: CLI flags > `$config` in map file > defaults
222
273
  * Backward compatible: existing map files without `$config` continue to work (defaults to AWS provider)
223
- * **Azure Key Vault support** — Use `--provider=azure` to pull/push secrets from Azure Key Vault ([#90](https://github.com/macalbert/envilder/pull/90))
274
+ * **Azure Key Vault support**: Use `--provider=azure` to pull/push secrets from Azure Key Vault ([#90](https://github.com/macalbert/envilder/pull/90))
224
275
  * New infrastructure adapter: `AzureKeyVaultSecretProvider` implementing `ISecretProvider`
225
276
  * New CLI option `--provider <name>` to select cloud provider (`aws` or `azure`, default: `aws`)
226
277
  * Azure authentication via `DefaultAzureCredential` (supports Azure CLI, managed identity, etc.)
227
278
 
228
279
  ### Changed
229
280
 
230
- * **CLI flag `--ssm-path` renamed to `--secret-path`** — The old flag is still accepted as a deprecated
281
+ * **CLI flag `--ssm-path` renamed to `--secret-path`**: The old flag is still accepted as a deprecated
231
282
  alias and prints a warning. It will be removed in a future release.
232
283
  * `configureInfrastructureServices()` now receives a single `MapFileConfig` object instead of separate parameters
233
284
  * CLI reads `$config` from the map file and merges with CLI flags
@@ -497,7 +548,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
497
548
 
498
549
  ### Added
499
550
 
500
- * **push:** Introduced Push Mode — sync local `.env` variables to AWS SSM Parameter Store ([#57](https://github.com/macalbert/envilder/pull/57))
551
+ * **push:** Introduced Push Mode: sync local `.env` variables to AWS SSM Parameter Store ([#57](https://github.com/macalbert/envilder/pull/57))
501
552
 
502
553
  ---
503
554
 
@@ -1,8 +1,44 @@
1
+ ## [0.13.0] - 2026-06-26
2
+
3
+ ### Added
4
+
5
+ * **Colorized `AWS identity` banner**: The
6
+ `☁ AWS identity · account=… · region=… · profile=…` line is now colorized.
7
+ `account` and `region` render in red when they resolve to `unknown`,
8
+ signalling that authentication failed
9
+ ([#382](https://github.com/macalbert/envilder/issues/382))
10
+
11
+ ### Changed
12
+
13
+ * **Print the `AWS identity` banner before resolving secrets**: The
14
+ banner is now printed before secrets are resolved, so it always
15
+ appears first. Previously it could surface mid-output because secrets
16
+ resolve in parallel
17
+ ([#382](https://github.com/macalbert/envilder/issues/382))
18
+
19
+ ### Fixed
20
+
21
+ * **Clear error for expired or invalid AWS credentials**: Expired or
22
+ invalid AWS credentials (e.g. an expired session token) now produce a
23
+ clear, actionable `ExpiredCredentialsError` during the pull, telling
24
+ you to refresh credentials (e.g. run `aws sso login`), instead of
25
+ being masked as a misleading `ParameterNotFound`
26
+
27
+ * **Expired SSO sessions surface as `SsoSessionExpiredError`**: When an
28
+ AWS SSO session can no longer be resolved, the action now fails with a
29
+ clear, actionable `SsoSessionExpiredError` that names the AWS profile
30
+ and the `aws sso login` command to run, instead of being lumped in
31
+ with a generic `ExpiredCredentialsError`. The action runs
32
+ non-interactively, so it presents the message only; it never prompts
33
+ or redirects
34
+
35
+ ---
36
+
1
37
  ## [0.12.1] - 2026-06-26
2
38
 
3
39
  ### Fixed
4
40
 
5
- * **Honor `$config.profile` for the AWS region, not just credentials** —
41
+ * **Honor `$config.profile` for the AWS region, not just credentials**:
6
42
  When a map file set an AWS profile via `$config.profile`, the action
7
43
  applied it to credentials only; the AWS SDK fell back to the default
8
44
  profile's region and silently read SSM parameters from the wrong
@@ -14,9 +50,9 @@
14
50
 
15
51
  ### Added
16
52
 
17
- * **Log the effective AWS identity before resolving secrets** —
53
+ * **Log the effective AWS identity before resolving secrets**:
18
54
  Before the first read, the action logs
19
- `AWS identity → account=… region=… profile=…` so a misrouted account
55
+ `☁ AWS identity · account=… · region=… · profile=…` so a misrouted account
20
56
  or region is immediately visible. The account is read from the active
21
57
  credentials, falling back to an STS `GetCallerIdentity` call when not
22
58
  present, then `unknown`
@@ -28,7 +64,7 @@
28
64
 
29
65
  ### Changed
30
66
 
31
- * **Preserve existing `.env` formatting on pull** — When the target `.env`
67
+ * **Preserve existing `.env` formatting on pull**: When the target `.env`
32
68
  file already exists, the action now updates values in place instead of
33
69
  rewriting the file from scratch. Full-line comments, blank lines, key
34
70
  ordering, `export` prefixes, and surrounding spacing are preserved; only
@@ -46,7 +82,7 @@
46
82
 
47
83
  ### Changed
48
84
 
49
- * **BREAKING: Require Node.js >= 22.12** — GitHub Actions workflows updated
85
+ * **BREAKING: Require Node.js >= 22.12**: GitHub Actions workflows updated
50
86
  to use `node-version: "22.x"`. The bundled CLI now requires Node.js 22.12+
51
87
  ([#291](https://github.com/macalbert/envilder/pull/291))
52
88
 
@@ -60,7 +96,7 @@
60
96
 
61
97
  ### Fixed
62
98
 
63
- * **Reserved key filtering** — `$schema` and other `$`-prefixed keys no longer
99
+ * **Reserved key filtering**: `$schema` and other `$`-prefixed keys no longer
64
100
  leak into environment variable mappings
65
101
  ([#218](https://github.com/macalbert/envilder/pull/218))
66
102
 
@@ -108,10 +144,10 @@
108
144
 
109
145
  ### Added
110
146
 
111
- * **Azure Key Vault support** — Use `provider: azure` input to pull secrets from Azure Key Vault
112
- * New input `vault-url` — Azure Key Vault URL, overrides `$config.vaultUrl` in the map file
113
- * New input `provider` — Select cloud provider (`aws` or `azure`, default: `aws`)
114
- * `$config` section support in map files — declare provider and connection details inline
147
+ * **Azure Key Vault support**: Use `provider: azure` input to pull secrets from Azure Key Vault
148
+ * New input `vault-url`: Azure Key Vault URL, overrides `$config.vaultUrl` in the map file
149
+ * New input `provider`: Select cloud provider (`aws` or `azure`, default: `aws`)
150
+ * `$config` section support in map files: declare provider and connection details inline
115
151
 
116
152
  ### Changed
117
153
 
@@ -133,7 +169,7 @@
133
169
 
134
170
  ### Added
135
171
 
136
- * **Initial GitHub Action release** — Use Envilder in CI/CD workflows natively
172
+ * **Initial GitHub Action release**: Use Envilder in CI/CD workflows natively
137
173
  * Pull secrets from AWS SSM Parameter Store into `.env` files during workflow runs
138
174
  * End-to-end tests for GitHub Actions simulation
139
175
 
@@ -1,14 +1,32 @@
1
+ ## [0.5.0] - 2026-06-26
2
+
3
+ ### Added
4
+
5
+ * **New `ExpiredCredentialsException`**: Thrown by the AWS SSM provider
6
+ on expired or invalid credentials (e.g. an expired session token), with
7
+ an actionable message guiding you to refresh credentials (e.g. run
8
+ `aws sso login`)
9
+
10
+ * **New `SsoSessionExpiredException`**: Thrown by the AWS SSM provider
11
+ when an AWS SSO session can no longer be resolved, exposing the AWS
12
+ profile via `ProfileName` and an actionable message that names the
13
+ `aws sso login --profile <name>` command to run. A plain expired
14
+ session token still throws `ExpiredCredentialsException`
15
+ ([#377](https://github.com/macalbert/envilder/issues/377))
16
+
17
+ ---
18
+
1
19
  ## [0.4.0] - 2026-05-18
2
20
 
3
21
  ### Changed
4
22
 
5
- * **BREAKING: Root namespace for public API** — All consumer-facing types
23
+ * **BREAKING: Root namespace for public API**: All consumer-facing types
6
24
  moved from `Envilder.Application` / `Envilder.Domain` to the root
7
25
  `Envilder` namespace. Consumers now only need `using Envilder;`
8
- * **BREAKING: Facade class renamed to `Env`** — The static facade class
26
+ * **BREAKING: Facade class renamed to `Env`**: The static facade class
9
27
  is now `Env` instead of `Envilder` to avoid namespace/class name collision.
10
28
  Use `Env.Load(...)`, `Env.ResolveFile(...)`, `Env.FromMapFile(...)` etc.
11
- * **Extension methods follow .NET conventions** —
29
+ * **Extension methods follow .NET conventions**:
12
30
  `AddEnvilder()` for `IConfigurationBuilder` moved to
13
31
  `Microsoft.Extensions.Configuration` namespace;
14
32
  `AddEnvilder()` for `IServiceCollection` moved to
@@ -45,7 +63,7 @@ Env.FromMapFile("envilder.json").Inject();
45
63
  ```
46
64
 
47
65
  `AddEnvilder()` extension methods now live in `Microsoft.Extensions.Configuration`
48
- and `Microsoft.Extensions.DependencyInjection` — no Envilder-specific import needed.
66
+ and `Microsoft.Extensions.DependencyInjection`: no Envilder-specific import needed.
49
67
  ASP.NET projects already include these namespaces via global usings; console apps
50
68
  may need to add them explicitly.
51
69
 
@@ -55,13 +73,13 @@ may need to add them explicitly.
55
73
 
56
74
  ### Added
57
75
 
58
- * **Map-file JSON Schema support** — Map files can now include
76
+ * **Map-file JSON Schema support**: Map files can now include
59
77
  `"$schema": "https://envilder.com/schema/map-file.v1.json"` for IDE
60
78
  autocomplete and validation without affecting secret resolution
61
79
 
62
80
  ### Fixed
63
81
 
64
- * **Reserved key filtering** — All `$`-prefixed keys are now excluded from
82
+ * **Reserved key filtering**: All `$`-prefixed keys are now excluded from
65
83
  variable mappings. Previously only `$config` was filtered
66
84
  ([#218](https://github.com/macalbert/envilder/pull/218))
67
85
 
@@ -71,50 +89,50 @@ may need to add them explicitly.
71
89
 
72
90
  ### Added
73
91
 
74
- * **Static facade** — `Envilder` class with one-liner API for resolving and injecting secrets
75
- * `ResolveFile(path)` / `ResolveFileAsync(path)` — Resolve secrets from a map file
76
- * `Load(path)` / `LoadAsync(path)` — Resolve and inject secrets into `Environment`
77
- * `ResolveFile(env, mapping)` / `Load(env, mapping)` — Environment-routed overloads
78
- * `FromMapFile(path)` — Fluent builder with `.WithProvider()`, `.WithProfile()`, `.WithVaultUrl()`
79
- * `EnvilderBuilder.Resolve()` / `ResolveAsync()` / `Inject()` / `InjectAsync()` — Fluent terminal methods
80
- * `ISecretProvider.GetSecret(name)` — Synchronous secret retrieval (new interface method)
81
- * `AwsSsmSecretProvider.GetSecret(name)` — Sync AWS SSM implementation
82
- * `AzureKeyVaultSecretProvider.GetSecret(name)` — Sync Azure Key Vault implementation
83
- * `EnvilderClient.ResolveSecrets(mapFile)` — Sync secret resolution
92
+ * **Static facade**: `Envilder` class with one-liner API for resolving and injecting secrets
93
+ * `ResolveFile(path)` / `ResolveFileAsync(path)`: Resolve secrets from a map file
94
+ * `Load(path)` / `LoadAsync(path)`: Resolve and inject secrets into `Environment`
95
+ * `ResolveFile(env, mapping)` / `Load(env, mapping)`: Environment-routed overloads
96
+ * `FromMapFile(path)`: Fluent builder with `.WithProvider()`, `.WithProfile()`, `.WithVaultUrl()`
97
+ * `EnvilderBuilder.Resolve()` / `ResolveAsync()` / `Inject()` / `InjectAsync()`: Fluent terminal methods
98
+ * `ISecretProvider.GetSecret(name)`: Synchronous secret retrieval (new interface method)
99
+ * `AwsSsmSecretProvider.GetSecret(name)`: Sync AWS SSM implementation
100
+ * `AzureKeyVaultSecretProvider.GetSecret(name)`: Sync Azure Key Vault implementation
101
+ * `EnvilderClient.ResolveSecrets(mapFile)`: Sync secret resolution
84
102
 
85
103
  ### Changed
86
104
 
87
- * **Simplify `AddEnvilder` extensions** — `IConfigurationBuilder.AddEnvilder()` and
105
+ * **Simplify `AddEnvilder` extensions**: `IConfigurationBuilder.AddEnvilder()` and
88
106
  `IServiceCollection.AddEnvilder()` now accept `(string mapFilePath, EnvilderOptions? options)`
89
107
  instead of requiring a manually-created `ISecretProvider`
90
108
  ([#167](https://github.com/macalbert/envilder/pull/167))
91
- * **Cross-provider validation** — `SecretProviderFactory` now rejects invalid combinations:
109
+ * **Cross-provider validation**: `SecretProviderFactory` now rejects invalid combinations:
92
110
  AWS profile with Azure provider, or Vault URL with AWS provider
93
111
  ([#167](https://github.com/macalbert/envilder/pull/167))
94
112
 
95
113
  ### Breaking
96
114
 
97
- * `SecretProviderFactory` is now `internal` — External code that referenced this type
115
+ * `SecretProviderFactory` is now `internal`: External code that referenced this type
98
116
  directly will no longer compile. Use the `Envilder` facade, `EnvilderBuilder`
99
117
  (`Envilder.FromMapFile(...)`), or the `AddEnvilder(string, EnvilderOptions?)` extensions instead
100
118
  ([#167](https://github.com/macalbert/envilder/pull/167))
101
- * `ISecretProvider.GetSecret(string name)` — New required interface method. External
119
+ * `ISecretProvider.GetSecret(string name)`: New required interface method. External
102
120
  implementations of `ISecretProvider` must add a synchronous `GetSecret` method
103
121
  (return `null` for missing secrets, matching the `GetSecretAsync` contract)
104
- * `ServiceCollectionExtensions.AddEnvilder(string, ISecretProvider)` signature removed — Use
122
+ * `ServiceCollectionExtensions.AddEnvilder(string, ISecretProvider)` signature removed. Use
105
123
  `AddEnvilder(string, EnvilderOptions?)` instead
106
- * `ConfigurationBuilderExtensions.AddEnvilder(string, ISecretProvider)` signature removed — Use
124
+ * `ConfigurationBuilderExtensions.AddEnvilder(string, ISecretProvider)` signature removed. Use
107
125
  `AddEnvilder(string, EnvilderOptions?)` instead
108
126
 
109
127
  ### Fixed
110
128
 
111
- * **Delegate default AWS region resolution to the AWS SDK** — When no profile is set, the
129
+ * **Delegate default AWS region resolution to the AWS SDK**: When no profile is set, the
112
130
  factory no longer manually resolves the region via `ResolveRegion()`. Instead it creates a
113
131
  plain `AmazonSimpleSystemsManagementClient()` which uses the full AWS SDK resolution chain
114
132
  (env vars → `~/.aws/config` → instance metadata), correctly picking up the default config
115
133
  file settings
116
134
  ([#166](https://github.com/macalbert/envilder/pull/166))
117
- * **Respect `AWS_SHARED_CREDENTIALS_FILE` for profile resolution** — `CredentialProfileStoreChain`
135
+ * **Respect `AWS_SHARED_CREDENTIALS_FILE` for profile resolution**: `CredentialProfileStoreChain`
118
136
  now receives the credentials file path from the `AWS_SHARED_CREDENTIALS_FILE` environment
119
137
  variable, fixing profile discovery when credentials are stored at non-default locations
120
138
  ([#166](https://github.com/macalbert/envilder/pull/166))
@@ -130,16 +148,16 @@ may need to add them explicitly.
130
148
 
131
149
  ### Added
132
150
 
133
- * **Initial release** — Runtime library for loading secrets from AWS SSM Parameter Store or Azure Key Vault
151
+ * **Initial release**: Runtime library for loading secrets from AWS SSM Parameter Store or Azure Key Vault
134
152
  directly into .NET applications ([#147](https://github.com/macalbert/envilder/pull/147))
135
- * `EnvilderClient` — Resolves secrets from a map-file and returns them as a dictionary
136
- * `MapFileParser` — Parses `envilder.json` files with `$config` section and variable mappings
137
- * `SecretProviderFactory` — Creates the appropriate secret provider based on configuration
138
- * `AwsSsmSecretProvider` — Fetches secrets from AWS SSM Parameter Store
139
- * `AzureKeyVaultSecretProvider` — Fetches secrets from Azure Key Vault
140
- * `IConfiguration` extensions — Load secrets directly into .NET configuration
141
- * `IServiceCollection` extensions — Register Envilder in the DI container
142
- * `EnvilderOptions` — Runtime overrides for provider, vault URL, and AWS profile
153
+ * `EnvilderClient`: Resolves secrets from a map-file and returns them as a dictionary
154
+ * `MapFileParser`: Parses `envilder.json` files with `$config` section and variable mappings
155
+ * `SecretProviderFactory`: Creates the appropriate secret provider based on configuration
156
+ * `AwsSsmSecretProvider`: Fetches secrets from AWS SSM Parameter Store
157
+ * `AzureKeyVaultSecretProvider`: Fetches secrets from Azure Key Vault
158
+ * `IConfiguration` extensions: Load secrets directly into .NET configuration
159
+ * `IServiceCollection` extensions: Register Envilder in the DI container
160
+ * `EnvilderOptions`: Runtime overrides for provider, vault URL, and AWS profile
143
161
  * Targets .NET Standard 2.0 (compatible with .NET 6+, .NET Framework 4.6.1+)
144
162
  * Published to NuGet as `Envilder`
145
163