envilder 0.12.0 → 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 (115) 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 +95 -18
  5. package/docs/changelogs/gha.md +70 -8
  6. package/docs/changelogs/sdk-dotnet.md +51 -33
  7. package/docs/changelogs/sdk-nodejs.md +46 -12
  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/apps/shared/ContainerConfiguration.d.ts.map +1 -1
  38. package/lib/envilder/apps/shared/ContainerConfiguration.js +3 -3
  39. package/lib/envilder/apps/shared/ContainerConfiguration.js.map +1 -1
  40. package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.d.ts +5 -1
  41. package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.d.ts.map +1 -1
  42. package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.js +22 -7
  43. package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.js.map +1 -1
  44. package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.d.ts +7 -2
  45. package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.d.ts.map +1 -1
  46. package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.js +78 -36
  47. package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.js.map +1 -1
  48. package/lib/envilder/core/application/pushSingle/PushSingleCommandHandler.d.ts +1 -0
  49. package/lib/envilder/core/application/pushSingle/PushSingleCommandHandler.d.ts.map +1 -1
  50. package/lib/envilder/core/application/pushSingle/PushSingleCommandHandler.js +10 -4
  51. package/lib/envilder/core/application/pushSingle/PushSingleCommandHandler.js.map +1 -1
  52. package/lib/envilder/core/domain/errors/DomainErrors.d.ts +31 -0
  53. package/lib/envilder/core/domain/errors/DomainErrors.d.ts.map +1 -1
  54. package/lib/envilder/core/domain/errors/DomainErrors.js +39 -0
  55. package/lib/envilder/core/domain/errors/DomainErrors.js.map +1 -1
  56. package/lib/envilder/core/domain/ports/ISecretProvider.d.ts +1 -0
  57. package/lib/envilder/core/domain/ports/ISecretProvider.d.ts.map +1 -1
  58. package/lib/envilder/core/infrastructure/aws/AwsSecretProviderFactory.d.ts +3 -1
  59. package/lib/envilder/core/infrastructure/aws/AwsSecretProviderFactory.d.ts.map +1 -1
  60. package/lib/envilder/core/infrastructure/aws/AwsSecretProviderFactory.js +33 -6
  61. package/lib/envilder/core/infrastructure/aws/AwsSecretProviderFactory.js.map +1 -1
  62. package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.d.ts +13 -1
  63. package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.d.ts.map +1 -1
  64. package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.js +106 -6
  65. package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.js.map +1 -1
  66. package/lib/envilder/core/infrastructure/aws/isExpiredCredentialsError.d.ts +2 -0
  67. package/lib/envilder/core/infrastructure/aws/isExpiredCredentialsError.d.ts.map +1 -0
  68. package/lib/envilder/core/infrastructure/aws/isExpiredCredentialsError.js +12 -0
  69. package/lib/envilder/core/infrastructure/aws/isExpiredCredentialsError.js.map +1 -0
  70. package/lib/envilder/core/infrastructure/aws/isSsoSessionExpiredError.d.ts +2 -0
  71. package/lib/envilder/core/infrastructure/aws/isSsoSessionExpiredError.d.ts.map +1 -0
  72. package/lib/envilder/core/infrastructure/aws/isSsoSessionExpiredError.js +9 -0
  73. package/lib/envilder/core/infrastructure/aws/isSsoSessionExpiredError.js.map +1 -0
  74. package/lib/envilder/core/infrastructure/azure/AzureKeyVaultSecretProvider.d.ts.map +1 -1
  75. package/lib/envilder/core/infrastructure/azure/AzureKeyVaultSecretProvider.js +2 -2
  76. package/lib/envilder/core/infrastructure/azure/AzureKeyVaultSecretProvider.js.map +1 -1
  77. package/lib/envilder/core/infrastructure/describeError.d.ts +9 -0
  78. package/lib/envilder/core/infrastructure/describeError.d.ts.map +1 -0
  79. package/lib/envilder/core/infrastructure/describeError.js +28 -0
  80. package/lib/envilder/core/infrastructure/describeError.js.map +1 -0
  81. package/lib/sdks/nodejs/src/domain/expired-credentials-error.d.ts +14 -0
  82. package/lib/sdks/nodejs/src/domain/expired-credentials-error.d.ts.map +1 -0
  83. package/lib/sdks/nodejs/src/domain/expired-credentials-error.js +29 -0
  84. package/lib/sdks/nodejs/src/domain/expired-credentials-error.js.map +1 -0
  85. package/lib/sdks/nodejs/src/domain/sso-session-expired-error.d.ts +16 -0
  86. package/lib/sdks/nodejs/src/domain/sso-session-expired-error.d.ts.map +1 -0
  87. package/lib/sdks/nodejs/src/domain/sso-session-expired-error.js +34 -0
  88. package/lib/sdks/nodejs/src/domain/sso-session-expired-error.js.map +1 -0
  89. package/lib/sdks/nodejs/src/index.d.ts +2 -0
  90. package/lib/sdks/nodejs/src/index.d.ts.map +1 -1
  91. package/lib/sdks/nodejs/src/index.js +2 -0
  92. package/lib/sdks/nodejs/src/index.js.map +1 -1
  93. package/lib/sdks/nodejs/src/infrastructure/aws/aws-ssm-secret-provider.d.ts +2 -1
  94. package/lib/sdks/nodejs/src/infrastructure/aws/aws-ssm-secret-provider.d.ts.map +1 -1
  95. package/lib/sdks/nodejs/src/infrastructure/aws/aws-ssm-secret-provider.js +22 -8
  96. package/lib/sdks/nodejs/src/infrastructure/aws/aws-ssm-secret-provider.js.map +1 -1
  97. package/lib/sdks/nodejs/src/infrastructure/secret-provider-factory.d.ts +1 -0
  98. package/lib/sdks/nodejs/src/infrastructure/secret-provider-factory.d.ts.map +1 -1
  99. package/lib/sdks/nodejs/src/infrastructure/secret-provider-factory.js +28 -4
  100. package/lib/sdks/nodejs/src/infrastructure/secret-provider-factory.js.map +1 -1
  101. package/package.json +15 -14
  102. package/lib/envilder/apps/cli/Cli.d.ts.map +0 -1
  103. package/lib/envilder/apps/cli/Cli.js.map +0 -1
  104. package/lib/envilder/apps/cli/Index.d.ts.map +0 -1
  105. package/lib/envilder/apps/cli/Index.js +0 -12
  106. package/lib/envilder/apps/cli/Index.js.map +0 -1
  107. package/lib/envilder/apps/gha/Gha.d.ts.map +0 -1
  108. package/lib/envilder/apps/gha/Gha.js.map +0 -1
  109. package/lib/envilder/apps/gha/Index.d.ts.map +0 -1
  110. package/lib/envilder/apps/gha/Index.js +0 -12
  111. package/lib/envilder/apps/gha/Index.js.map +0 -1
  112. /package/lib/envilder/apps/cli/{Cli.d.ts → entry/Cli.d.ts} +0 -0
  113. /package/lib/envilder/apps/cli/{Index.d.ts → entry/Index.d.ts} +0 -0
  114. /package/lib/envilder/apps/gha/{Gha.d.ts → entry/Gha.d.ts} +0 -0
  115. /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,88 @@ 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
+
59
+ ## [0.12.1] - 2026-06-26
60
+
61
+ ### Fixed
62
+
63
+ * **Honor `$config.profile` for the AWS region, not just credentials**:
64
+ When a map file set an AWS profile via `$config.profile`, Envilder applied
65
+ it to credentials only; the AWS SDK fell back to the default profile's
66
+ region and silently read or wrote SSM parameters in the wrong
67
+ account-region. Envilder now sets `AWS_PROFILE` so the AWS SDK resolves
68
+ both the profile's region and its (SSO-capable) credentials natively.
69
+ Region resolution order is `AWS_REGION` > `AWS_DEFAULT_REGION` >
70
+ profile region > `us-east-1` fallback
71
+ ([#382](https://github.com/macalbert/envilder/issues/382))
72
+
73
+ ### Added
74
+
75
+ * **Log the effective AWS identity before resolving secrets**:
76
+ Before the first read or write, Envilder logs
77
+ `☁ AWS identity · account=… · region=… · profile=…` so a misrouted account
78
+ or region is immediately visible. The account is read from the active
79
+ credentials, falling back to an STS `GetCallerIdentity` call when not
80
+ present, then `unknown`
81
+ ([#382](https://github.com/macalbert/envilder/issues/382))
82
+
83
+ ---
84
+
8
85
  ## [0.12.0] - 2026-06-26
9
86
 
10
87
  ### Changed
11
88
 
12
- * **Preserve existing `.env` formatting on pull** — When the target `.env`
89
+ * **Preserve existing `.env` formatting on pull**: When the target `.env`
13
90
  file already exists, Envilder now updates values in place instead of
14
91
  rewriting the file from scratch. Full-line comments, blank lines, key
15
92
  ordering, `export` prefixes, and surrounding spacing are preserved; only
@@ -23,7 +100,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
23
100
 
24
101
  ### Changed
25
102
 
26
- * **BREAKING: Require Node.js >= 22.12** — pnpm 11, testcontainers v12,
103
+ * **BREAKING: Require Node.js >= 22.12**: pnpm 11, testcontainers v12,
27
104
  commander 15, and commitlint 21 require Node.js 22.12+. The `engines`
28
105
  field now enforces `>=22.12.0`
29
106
  ([#291](https://github.com/macalbert/envilder/pull/291))
@@ -32,7 +109,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
32
109
 
33
110
  * Update all devDependencies to latest (TypeScript 6.0.3, Biome 2.4.16,
34
111
  testcontainers 12.0.1, pnpm 11.5.0)
35
- * Remove `rimraf` — replaced with zero-dependency `fs.rmSync` in clean scripts
112
+ * Remove `rimraf`: replaced with zero-dependency `fs.rmSync` in clean scripts
36
113
  ([#291](https://github.com/macalbert/envilder/pull/291))
37
114
 
38
115
  ---
@@ -41,17 +118,17 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
41
118
 
42
119
  ### Added
43
120
 
44
- * **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,
45
122
  published at `https://envilder.com/schema/map-file.v1.json`. Add
46
123
  `"$schema": "https://envilder.com/schema/map-file.v1.json"` to any map file
47
124
  for IDE autocomplete, inline documentation, and validation
48
125
  ([#218](https://github.com/macalbert/envilder/pull/218))
49
- * **Schema contract tests** — 39 tests validating the JSON Schema across all
126
+ * **Schema contract tests**: 39 tests validating the JSON Schema across all
50
127
  providers (AWS, Azure, GCP, HashiCorp Vault, file)
51
128
 
52
129
  ### Fixed
53
130
 
54
- * **Reserved key filtering** — All `$`-prefixed keys (e.g. `$schema`) are now
131
+ * **Reserved key filtering**: All `$`-prefixed keys (e.g. `$schema`) are now
55
132
  excluded from variable mappings. Previously only `$config` was filtered,
56
133
  causing `$schema` to leak into environment variables
57
134
  ([#218](https://github.com/macalbert/envilder/pull/218))
@@ -70,7 +147,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
70
147
 
71
148
  ### Added
72
149
 
73
- * **Runtime SDKs now available** — Load secrets directly into your application
150
+ * **Runtime SDKs now available**: Load secrets directly into your application
74
151
  at startup, no `.env` file needed:
75
152
 
76
153
  **.NET** ([NuGet](https://www.nuget.org/packages/Envilder)):
@@ -103,7 +180,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
103
180
 
104
181
  ### Changed
105
182
 
106
- * **README rewritten** — Streamlined messaging, accurate comparison
183
+ * **README rewritten**: Streamlined messaging, accurate comparison
107
184
  tables, simplified quick start (2 steps), and reduced noise
108
185
 
109
186
  ### Fixed
@@ -127,11 +204,11 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
127
204
 
128
205
  ### Added
129
206
 
130
- * **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
131
208
  (dark, light, color variants) and a new `Sponsors.astro` component
132
209
  ([#136](https://github.com/macalbert/envilder/pull/136))
133
- * **Website test suite** — Added `tests/website/` with Vitest coverage for i18n utilities and Markdown helpers
134
- * **`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
135
212
 
136
213
  ### Changed
137
214
 
@@ -139,7 +216,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
139
216
  * Core domain layer moved from `src/envilder/` to `src/envilder/core/`
140
217
  * Website moved from `src/apps/website/` to `src/website/`
141
218
  * All imports, `tsconfig.json`, `package.json`, and workspace config updated accordingly
142
- * **Website UX improvements** — `DocsContent`, `HowItWorks`, `ThemeSwitcher`, `TerminalMockup`, and
219
+ * **Website UX improvements**: `DocsContent`, `HowItWorks`, `ThemeSwitcher`, `TerminalMockup`, and
143
220
  `BaseLayout` components updated; global CSS expanded; i18n keys added for new content
144
221
 
145
222
  ### Fixed
@@ -165,7 +242,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
165
242
 
166
243
  ### Added
167
244
 
168
- * **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),
169
246
  with multi-language support (EN, ES, CA), dark/retro and light themes, and a dedicated changelog page
170
247
 
171
248
  ### Changed
@@ -188,20 +265,20 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
188
265
 
189
266
  ### Added
190
267
 
191
- * **`$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
192
269
  and connection details inline (e.g., `"provider": "azure"`, `"vaultUrl": "https://..."`,
193
270
  `"profile": "dev-account"`)
194
- * 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
195
272
  * Precedence chain: CLI flags > `$config` in map file > defaults
196
273
  * Backward compatible: existing map files without `$config` continue to work (defaults to AWS provider)
197
- * **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))
198
275
  * New infrastructure adapter: `AzureKeyVaultSecretProvider` implementing `ISecretProvider`
199
276
  * New CLI option `--provider <name>` to select cloud provider (`aws` or `azure`, default: `aws`)
200
277
  * Azure authentication via `DefaultAzureCredential` (supports Azure CLI, managed identity, etc.)
201
278
 
202
279
  ### Changed
203
280
 
204
- * **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
205
282
  alias and prints a warning. It will be removed in a future release.
206
283
  * `configureInfrastructureServices()` now receives a single `MapFileConfig` object instead of separate parameters
207
284
  * CLI reads `$config` from the map file and merges with CLI flags
@@ -471,7 +548,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
471
548
 
472
549
  ### Added
473
550
 
474
- * **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))
475
552
 
476
553
  ---
477
554
 
@@ -1,8 +1,70 @@
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
+
37
+ ## [0.12.1] - 2026-06-26
38
+
39
+ ### Fixed
40
+
41
+ * **Honor `$config.profile` for the AWS region, not just credentials**:
42
+ When a map file set an AWS profile via `$config.profile`, the action
43
+ applied it to credentials only; the AWS SDK fell back to the default
44
+ profile's region and silently read SSM parameters from the wrong
45
+ account-region. The action now sets `AWS_PROFILE` so the AWS SDK resolves
46
+ both the profile's region and its (SSO-capable) credentials natively.
47
+ Region resolution order is `AWS_REGION` > `AWS_DEFAULT_REGION` >
48
+ profile region > `us-east-1` fallback
49
+ ([#382](https://github.com/macalbert/envilder/issues/382))
50
+
51
+ ### Added
52
+
53
+ * **Log the effective AWS identity before resolving secrets**:
54
+ Before the first read, the action logs
55
+ `☁ AWS identity · account=… · region=… · profile=…` so a misrouted account
56
+ or region is immediately visible. The account is read from the active
57
+ credentials, falling back to an STS `GetCallerIdentity` call when not
58
+ present, then `unknown`
59
+ ([#382](https://github.com/macalbert/envilder/issues/382))
60
+
61
+ ---
62
+
1
63
  ## [0.12.0] - 2026-06-26
2
64
 
3
65
  ### Changed
4
66
 
5
- * **Preserve existing `.env` formatting on pull** — When the target `.env`
67
+ * **Preserve existing `.env` formatting on pull**: When the target `.env`
6
68
  file already exists, the action now updates values in place instead of
7
69
  rewriting the file from scratch. Full-line comments, blank lines, key
8
70
  ordering, `export` prefixes, and surrounding spacing are preserved; only
@@ -20,7 +82,7 @@
20
82
 
21
83
  ### Changed
22
84
 
23
- * **BREAKING: Require Node.js >= 22.12** — GitHub Actions workflows updated
85
+ * **BREAKING: Require Node.js >= 22.12**: GitHub Actions workflows updated
24
86
  to use `node-version: "22.x"`. The bundled CLI now requires Node.js 22.12+
25
87
  ([#291](https://github.com/macalbert/envilder/pull/291))
26
88
 
@@ -34,7 +96,7 @@
34
96
 
35
97
  ### Fixed
36
98
 
37
- * **Reserved key filtering** — `$schema` and other `$`-prefixed keys no longer
99
+ * **Reserved key filtering**: `$schema` and other `$`-prefixed keys no longer
38
100
  leak into environment variable mappings
39
101
  ([#218](https://github.com/macalbert/envilder/pull/218))
40
102
 
@@ -82,10 +144,10 @@
82
144
 
83
145
  ### Added
84
146
 
85
- * **Azure Key Vault support** — Use `provider: azure` input to pull secrets from Azure Key Vault
86
- * New input `vault-url` — Azure Key Vault URL, overrides `$config.vaultUrl` in the map file
87
- * New input `provider` — Select cloud provider (`aws` or `azure`, default: `aws`)
88
- * `$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
89
151
 
90
152
  ### Changed
91
153
 
@@ -107,7 +169,7 @@
107
169
 
108
170
  ### Added
109
171
 
110
- * **Initial GitHub Action release** — Use Envilder in CI/CD workflows natively
172
+ * **Initial GitHub Action release**: Use Envilder in CI/CD workflows natively
111
173
  * Pull secrets from AWS SSM Parameter Store into `.env` files during workflow runs
112
174
  * End-to-end tests for GitHub Actions simulation
113
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