envilder 0.12.1 → 0.13.2

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 (166) hide show
  1. package/README.md +16 -10
  2. package/ROADMAP.md +14 -18
  3. package/docs/CHANGELOG.md +1 -1
  4. package/docs/SECURITY.md +1 -1
  5. package/docs/changelogs/cli.md +84 -21
  6. package/docs/changelogs/gha.md +77 -11
  7. package/docs/changelogs/sdk-dotnet.md +51 -33
  8. package/docs/changelogs/sdk-nodejs.md +31 -13
  9. package/docs/changelogs/sdk-python.md +38 -20
  10. package/lib/envilder/apps/cli/Startup.d.ts.map +1 -1
  11. package/lib/envilder/apps/cli/entry/Cli.d.ts.map +1 -0
  12. package/lib/envilder/apps/cli/{Cli.js → entry/Cli.js} +8 -7
  13. package/lib/envilder/apps/cli/entry/Cli.js.map +1 -0
  14. package/lib/envilder/apps/cli/entry/Index.d.ts.map +1 -0
  15. package/lib/envilder/apps/cli/entry/Index.js +16 -0
  16. package/lib/envilder/apps/cli/entry/Index.js.map +1 -0
  17. package/lib/envilder/apps/cli/errors/CliErrorPresenter.d.ts +2 -0
  18. package/lib/envilder/apps/cli/errors/CliErrorPresenter.d.ts.map +1 -0
  19. package/lib/envilder/apps/cli/errors/CliErrorPresenter.js +78 -0
  20. package/lib/envilder/apps/cli/errors/CliErrorPresenter.js.map +1 -0
  21. package/lib/envilder/apps/cli/errors/SilentExitError.d.ts +5 -0
  22. package/lib/envilder/apps/cli/errors/SilentExitError.d.ts.map +1 -0
  23. package/lib/envilder/apps/cli/errors/SilentExitError.js +7 -0
  24. package/lib/envilder/apps/cli/errors/SilentExitError.js.map +1 -0
  25. package/lib/envilder/apps/cli/recovery/SsoLoginRecovery.d.ts +9 -0
  26. package/lib/envilder/apps/cli/recovery/SsoLoginRecovery.d.ts.map +1 -0
  27. package/lib/envilder/apps/cli/recovery/SsoLoginRecovery.js +120 -0
  28. package/lib/envilder/apps/cli/recovery/SsoLoginRecovery.js.map +1 -0
  29. package/lib/envilder/apps/gha/Startup.d.ts.map +1 -1
  30. package/lib/envilder/apps/gha/Startup.js +8 -0
  31. package/lib/envilder/apps/gha/Startup.js.map +1 -1
  32. package/lib/envilder/apps/gha/entry/Gha.d.ts.map +1 -0
  33. package/lib/envilder/apps/gha/{Gha.js → entry/Gha.js} +9 -7
  34. package/lib/envilder/apps/gha/entry/Gha.js.map +1 -0
  35. package/lib/envilder/apps/gha/entry/Index.d.ts.map +1 -0
  36. package/lib/envilder/apps/gha/entry/Index.js +12 -0
  37. package/lib/envilder/apps/gha/entry/Index.js.map +1 -0
  38. package/lib/envilder/apps/gha/errors/GhaErrorPresenter.d.ts +7 -0
  39. package/lib/envilder/apps/gha/errors/GhaErrorPresenter.d.ts.map +1 -0
  40. package/lib/envilder/apps/gha/errors/GhaErrorPresenter.js +32 -0
  41. package/lib/envilder/apps/gha/errors/GhaErrorPresenter.js.map +1 -0
  42. package/lib/envilder/apps/shared/ContainerConfiguration.d.ts.map +1 -1
  43. package/lib/envilder/apps/shared/ContainerConfiguration.js +7 -0
  44. package/lib/envilder/apps/shared/ContainerConfiguration.js.map +1 -1
  45. package/lib/envilder/core/application/dispatch/DispatchActionCommand.d.ts.map +1 -1
  46. package/lib/envilder/core/application/dispatch/DispatchActionCommand.js.map +1 -1
  47. package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.d.ts +5 -1
  48. package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.d.ts.map +1 -1
  49. package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.js +22 -7
  50. package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.js.map +1 -1
  51. package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommand.d.ts.map +1 -1
  52. package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommand.js.map +1 -1
  53. package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.d.ts +10 -3
  54. package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.d.ts.map +1 -1
  55. package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.js +83 -38
  56. package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.js.map +1 -1
  57. package/lib/envilder/core/application/pushEnvToSecrets/PushEnvToSecretsCommand.d.ts.map +1 -1
  58. package/lib/envilder/core/application/pushEnvToSecrets/PushEnvToSecretsCommand.js.map +1 -1
  59. package/lib/envilder/core/application/pushEnvToSecrets/PushEnvToSecretsCommandHandler.d.ts.map +1 -1
  60. package/lib/envilder/core/application/pushEnvToSecrets/PushEnvToSecretsCommandHandler.js.map +1 -1
  61. package/lib/envilder/core/application/pushSingle/PushSingleCommand.d.ts.map +1 -1
  62. package/lib/envilder/core/application/pushSingle/PushSingleCommand.js.map +1 -1
  63. package/lib/envilder/core/application/pushSingle/PushSingleCommandHandler.d.ts +1 -0
  64. package/lib/envilder/core/application/pushSingle/PushSingleCommandHandler.d.ts.map +1 -1
  65. package/lib/envilder/core/application/pushSingle/PushSingleCommandHandler.js +10 -4
  66. package/lib/envilder/core/application/pushSingle/PushSingleCommandHandler.js.map +1 -1
  67. package/lib/envilder/core/domain/EnvironmentVariable.d.ts.map +1 -1
  68. package/lib/envilder/core/domain/EnvironmentVariable.js.map +1 -1
  69. package/lib/envilder/core/domain/errors/DomainErrors.d.ts +31 -0
  70. package/lib/envilder/core/domain/errors/DomainErrors.d.ts.map +1 -1
  71. package/lib/envilder/core/domain/errors/DomainErrors.js +39 -0
  72. package/lib/envilder/core/domain/errors/DomainErrors.js.map +1 -1
  73. package/lib/envilder/core/domain/ports/ISecretMasker.d.ts +4 -0
  74. package/lib/envilder/core/domain/ports/ISecretMasker.d.ts.map +1 -0
  75. package/lib/envilder/core/domain/ports/ISecretMasker.js +2 -0
  76. package/lib/envilder/core/domain/ports/ISecretMasker.js.map +1 -0
  77. package/lib/envilder/core/domain/ports/ISecretProvider.d.ts +1 -0
  78. package/lib/envilder/core/domain/ports/ISecretProvider.d.ts.map +1 -1
  79. package/lib/envilder/core/infrastructure/aws/AwsSecretProviderFactory.js.map +1 -1
  80. package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.d.ts +2 -1
  81. package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.d.ts.map +1 -1
  82. package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.js +44 -8
  83. package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.js.map +1 -1
  84. package/lib/envilder/core/infrastructure/aws/isExpiredCredentialsError.d.ts +2 -0
  85. package/lib/envilder/core/infrastructure/aws/isExpiredCredentialsError.d.ts.map +1 -0
  86. package/lib/envilder/core/infrastructure/aws/isExpiredCredentialsError.js +12 -0
  87. package/lib/envilder/core/infrastructure/aws/isExpiredCredentialsError.js.map +1 -0
  88. package/lib/envilder/core/infrastructure/aws/isSsoSessionExpiredError.d.ts +2 -0
  89. package/lib/envilder/core/infrastructure/aws/isSsoSessionExpiredError.d.ts.map +1 -0
  90. package/lib/envilder/core/infrastructure/aws/isSsoSessionExpiredError.js +9 -0
  91. package/lib/envilder/core/infrastructure/aws/isSsoSessionExpiredError.js.map +1 -0
  92. package/lib/envilder/core/infrastructure/azure/AzureKeyVaultSecretProvider.d.ts.map +1 -1
  93. package/lib/envilder/core/infrastructure/azure/AzureKeyVaultSecretProvider.js +2 -2
  94. package/lib/envilder/core/infrastructure/azure/AzureKeyVaultSecretProvider.js.map +1 -1
  95. package/lib/envilder/core/infrastructure/azure/AzureSecretProviderFactory.js.map +1 -1
  96. package/lib/envilder/core/infrastructure/azure/AzureVaultUrlValidator.js.map +1 -1
  97. package/lib/envilder/core/infrastructure/describeError.d.ts +9 -0
  98. package/lib/envilder/core/infrastructure/describeError.d.ts.map +1 -0
  99. package/lib/envilder/core/infrastructure/describeError.js +28 -0
  100. package/lib/envilder/core/infrastructure/describeError.js.map +1 -0
  101. package/lib/envilder/core/infrastructure/github/GitHubActionsSecretMasker.d.ts +5 -0
  102. package/lib/envilder/core/infrastructure/github/GitHubActionsSecretMasker.d.ts.map +1 -0
  103. package/lib/envilder/core/infrastructure/github/GitHubActionsSecretMasker.js +10 -0
  104. package/lib/envilder/core/infrastructure/github/GitHubActionsSecretMasker.js.map +1 -0
  105. package/lib/envilder/core/infrastructure/github/NoOpSecretMasker.d.ts +5 -0
  106. package/lib/envilder/core/infrastructure/github/NoOpSecretMasker.d.ts.map +1 -0
  107. package/lib/envilder/core/infrastructure/github/NoOpSecretMasker.js +4 -0
  108. package/lib/envilder/core/infrastructure/github/NoOpSecretMasker.js.map +1 -0
  109. package/lib/envilder/core/infrastructure/logger/ConsoleLogger.d.ts.map +1 -1
  110. package/lib/envilder/core/infrastructure/package/PackageVersionReader.d.ts.map +1 -1
  111. package/lib/envilder/core/infrastructure/variableStore/FileVariableStore.d.ts.map +1 -1
  112. package/lib/envilder/core/infrastructure/variableStore/FileVariableStore.js.map +1 -1
  113. package/lib/envilder/core/types.d.ts +5 -3
  114. package/lib/envilder/core/types.d.ts.map +1 -1
  115. package/lib/envilder/core/types.js +1 -0
  116. package/lib/envilder/core/types.js.map +1 -1
  117. package/lib/iac/bin/main.js.map +1 -1
  118. package/lib/iac/lib/core/types.js.map +1 -1
  119. package/lib/iac/lib/stacks/customStack.d.ts.map +1 -1
  120. package/lib/iac/lib/stacks/customStack.js.map +1 -1
  121. package/lib/iac/lib/stacks/staticWebsiteStack.d.ts.map +1 -1
  122. package/lib/iac/lib/stacks/staticWebsiteStack.js +61 -9
  123. package/lib/iac/lib/stacks/staticWebsiteStack.js.map +1 -1
  124. package/lib/iac/lib/stacks/utils.js.map +1 -1
  125. package/lib/sdks/nodejs/src/application/envilder-client.d.ts.map +1 -1
  126. package/lib/sdks/nodejs/src/application/envilder.d.ts.map +1 -1
  127. package/lib/sdks/nodejs/src/application/envilder.js.map +1 -1
  128. package/lib/sdks/nodejs/src/application/map-file-parser.d.ts.map +1 -1
  129. package/lib/sdks/nodejs/src/application/map-file-parser.js.map +1 -1
  130. package/lib/sdks/nodejs/src/application/secret-validation.d.ts.map +1 -1
  131. package/lib/sdks/nodejs/src/application/secret-validation.js.map +1 -1
  132. package/lib/sdks/nodejs/src/domain/expired-credentials-error.d.ts +14 -0
  133. package/lib/sdks/nodejs/src/domain/expired-credentials-error.d.ts.map +1 -0
  134. package/lib/sdks/nodejs/src/domain/expired-credentials-error.js +29 -0
  135. package/lib/sdks/nodejs/src/domain/expired-credentials-error.js.map +1 -0
  136. package/lib/sdks/nodejs/src/domain/sso-session-expired-error.d.ts +16 -0
  137. package/lib/sdks/nodejs/src/domain/sso-session-expired-error.d.ts.map +1 -0
  138. package/lib/sdks/nodejs/src/domain/sso-session-expired-error.js +34 -0
  139. package/lib/sdks/nodejs/src/domain/sso-session-expired-error.js.map +1 -0
  140. package/lib/sdks/nodejs/src/index.d.ts +2 -0
  141. package/lib/sdks/nodejs/src/index.d.ts.map +1 -1
  142. package/lib/sdks/nodejs/src/index.js +2 -0
  143. package/lib/sdks/nodejs/src/index.js.map +1 -1
  144. package/lib/sdks/nodejs/src/infrastructure/aws/aws-ssm-secret-provider.d.ts +2 -1
  145. package/lib/sdks/nodejs/src/infrastructure/aws/aws-ssm-secret-provider.d.ts.map +1 -1
  146. package/lib/sdks/nodejs/src/infrastructure/aws/aws-ssm-secret-provider.js +22 -8
  147. package/lib/sdks/nodejs/src/infrastructure/aws/aws-ssm-secret-provider.js.map +1 -1
  148. package/lib/sdks/nodejs/src/infrastructure/azure/azure-key-vault-secret-provider.d.ts.map +1 -1
  149. package/lib/sdks/nodejs/src/infrastructure/azure/azure-key-vault-secret-provider.js.map +1 -1
  150. package/lib/sdks/nodejs/src/infrastructure/secret-provider-factory.js +1 -1
  151. package/lib/sdks/nodejs/src/infrastructure/secret-provider-factory.js.map +1 -1
  152. package/package.json +22 -23
  153. package/lib/envilder/apps/cli/Cli.d.ts.map +0 -1
  154. package/lib/envilder/apps/cli/Cli.js.map +0 -1
  155. package/lib/envilder/apps/cli/Index.d.ts.map +0 -1
  156. package/lib/envilder/apps/cli/Index.js +0 -12
  157. package/lib/envilder/apps/cli/Index.js.map +0 -1
  158. package/lib/envilder/apps/gha/Gha.d.ts.map +0 -1
  159. package/lib/envilder/apps/gha/Gha.js.map +0 -1
  160. package/lib/envilder/apps/gha/Index.d.ts.map +0 -1
  161. package/lib/envilder/apps/gha/Index.js +0 -12
  162. package/lib/envilder/apps/gha/Index.js.map +0 -1
  163. /package/lib/envilder/apps/cli/{Cli.d.ts → entry/Cli.d.ts} +0 -0
  164. /package/lib/envilder/apps/cli/{Index.d.ts → entry/Index.d.ts} +0 -0
  165. /package/lib/envilder/apps/gha/{Gha.d.ts → entry/Gha.d.ts} +0 -0
  166. /package/lib/envilder/apps/gha/{Index.d.ts → entry/Index.d.ts} +0 -0
@@ -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
 
@@ -1,8 +1,26 @@
1
+ ## [0.4.0] - 2026-06-26
2
+
3
+ ### Added
4
+
5
+ * **New exported `ExpiredCredentialsError`**: Thrown by the AWS SSM
6
+ provider when credentials or the security token are expired or
7
+ invalid (e.g. an expired session token), with an actionable message
8
+ guiding you to refresh credentials (e.g. run `aws sso login`)
9
+
10
+ * **New exported `SsoSessionExpiredError`**: Thrown by the AWS SSM
11
+ provider when an AWS SSO session can no longer be resolved, with an
12
+ actionable message that names the AWS profile and the
13
+ `aws sso login --profile <name>` command to run. A plain expired
14
+ session token still throws `ExpiredCredentialsError`
15
+ ([#379](https://github.com/macalbert/envilder/issues/379))
16
+
17
+ ---
18
+
1
19
  ## [0.3.1] - 2026-06-26
2
20
 
3
21
  ### Fixed
4
22
 
5
- * **Honor the `profile` option for the AWS region, not just credentials** —
23
+ * **Honor the `profile` option for the AWS region, not just credentials**:
6
24
  When a profile was set via the `profile` option or `$config.profile`, the
7
25
  SDK applied it to credentials only; the AWS SDK fell back to the default
8
26
  profile's region and silently read SSM parameters from the wrong
@@ -18,18 +36,18 @@
18
36
 
19
37
  ### Changed
20
38
 
21
- * **BREAKING: Require Node.js >= 22.12** — Aligns with the rest of the
39
+ * **BREAKING: Require Node.js >= 22.12**: Aligns with the rest of the
22
40
  monorepo. Node 18 and 20 are EOL; Node 22 is the only active LTS
23
41
  ([#291](https://github.com/macalbert/envilder/pull/291))
24
42
 
25
- * **Pin dependencies to minimum viable versions** — AWS SDK `^3.700.0`, Azure
26
- Identity `^4.5.0`, Azure Key Vault Secrets `^4.9.0` — avoids forcing
43
+ * **Pin dependencies to minimum viable versions**: AWS SDK `^3.700.0`, Azure
44
+ Identity `^4.5.0`, Azure Key Vault Secrets `^4.9.0`: avoids forcing
27
45
  consumers to upgrade their cloud SDKs (ADR-0009)
28
46
  ([#291](https://github.com/macalbert/envilder/pull/291))
29
47
 
30
48
  ### Dependencies
31
49
 
32
- * Remove `rimraf` — replaced with zero-dependency `fs.rmSync` in clean script
50
+ * Remove `rimraf`: replaced with zero-dependency `fs.rmSync` in clean script
33
51
  ([#291](https://github.com/macalbert/envilder/pull/291))
34
52
 
35
53
  ---
@@ -38,13 +56,13 @@
38
56
 
39
57
  ### Added
40
58
 
41
- * **Map-file JSON Schema support** — Map files can now include
59
+ * **Map-file JSON Schema support**: Map files can now include
42
60
  `"$schema": "https://envilder.com/schema/map-file.v1.json"` for IDE
43
61
  autocomplete and validation without affecting secret resolution
44
62
 
45
63
  ### Fixed
46
64
 
47
- * **Reserved key filtering** — All `$`-prefixed keys are now excluded from
65
+ * **Reserved key filtering**: All `$`-prefixed keys are now excluded from
48
66
  variable mappings. Previously only `$config` was filtered
49
67
  ([#218](https://github.com/macalbert/envilder/pull/218))
50
68
 
@@ -60,15 +78,15 @@
60
78
 
61
79
  ### Added
62
80
 
63
- * **Initial release** — Node.js runtime SDK for loading secrets directly
81
+ * **Initial release**: Node.js runtime SDK for loading secrets directly
64
82
  into `process.env` from a map file. Supports AWS SSM Parameter Store and
65
83
  Azure Key Vault
66
- * **Envilder facade** — `load()`, `resolveFile()`, `fromMapFile()` fluent
84
+ * **Envilder facade**: `load()`, `resolveFile()`, `fromMapFile()` fluent
67
85
  builder for one-liner or fine-grained secret loading
68
- * **EnvilderClient** — Core resolver with `resolveSecrets()` and
86
+ * **EnvilderClient**: Core resolver with `resolveSecrets()` and
69
87
  `injectIntoEnvironment()` for custom provider usage
70
- * **MapFileParser** — Parse `$config` section and variable mappings from JSON
71
- * **Secret validation** — Opt-in `validateSecrets()` throws
88
+ * **MapFileParser**: Parse `$config` section and variable mappings from JSON
89
+ * **Secret validation**: Opt-in `validateSecrets()` throws
72
90
  `SecretValidationError` for empty or missing values
73
- * **Environment-based routing** — Load different secret files per environment
91
+ * **Environment-based routing**: Load different secret files per environment
74
92
  (production, development, test)
@@ -1,14 +1,32 @@
1
+ ## [0.5.0] - 2026-06-26
2
+
3
+ ### Added
4
+
5
+ * **New `ExpiredCredentialsError`**: Exported from `envilder` and
6
+ raised by the AWS SSM provider on expired or invalid credentials
7
+ (e.g. an expired session token), with an actionable message guiding you
8
+ to refresh credentials (e.g. run `aws sso login`)
9
+
10
+ * **New `SsoSessionExpiredError`**: Exported from `envilder` and raised
11
+ by the AWS SSM provider when an AWS SSO session can no longer be
12
+ resolved, with an actionable message that names the AWS profile and the
13
+ `aws sso login --profile <name>` command to run. A plain expired
14
+ session token still raises `ExpiredCredentialsError`
15
+ ([#378](https://github.com/macalbert/envilder/issues/378))
16
+
17
+ ---
18
+
1
19
  ## [0.4.0] - 2026-05-03
2
20
 
3
21
  ### Added
4
22
 
5
- * **Map-file JSON Schema support** — Map files can now include
23
+ * **Map-file JSON Schema support**: Map files can now include
6
24
  `"$schema": "https://envilder.com/schema/map-file.v1.json"` for IDE
7
25
  autocomplete and validation without affecting secret resolution
8
26
 
9
27
  ### Fixed
10
28
 
11
- * **Reserved key filtering** — All `$`-prefixed keys are now excluded from
29
+ * **Reserved key filtering**: All `$`-prefixed keys are now excluded from
12
30
  variable mappings. Previously only `$config` was filtered
13
31
  ([#218](https://github.com/macalbert/envilder/pull/218))
14
32
 
@@ -18,17 +36,17 @@
18
36
 
19
37
  ### Changed
20
38
 
21
- * **Encapsulate `SecretProviderFactory`** — Renamed to `_SecretProviderFactory` and removed
39
+ * **Encapsulate `SecretProviderFactory`**: Renamed to `_SecretProviderFactory` and removed
22
40
  from public re-exports; consumers should use the `Envilder` facade instead of creating
23
41
  providers manually
24
42
  ([#167](https://github.com/macalbert/envilder/pull/167))
25
- * **Cross-provider validation** — `_SecretProviderFactory.create()` now rejects invalid
43
+ * **Cross-provider validation**: `_SecretProviderFactory.create()` now rejects invalid
26
44
  combinations: AWS profile with Azure provider, or vault URL with AWS provider
27
45
  ([#167](https://github.com/macalbert/envilder/pull/167))
28
46
 
29
47
  ### Fixed
30
48
 
31
- * **Delegate default AWS region resolution to boto3** — When no profile is set, the factory
49
+ * **Delegate default AWS region resolution to boto3**: When no profile is set, the factory
32
50
  no longer manually resolves the region from environment variables. Instead it creates a plain
33
51
  `boto3.Session()` which uses the full AWS SDK resolution chain (env vars → `~/.aws/config` →
34
52
  instance metadata), correctly picking up the default config file settings
@@ -40,7 +58,7 @@
40
58
 
41
59
  ### Fixed
42
60
 
43
- * **Remove `mypy-boto3-ssm` runtime dependency** — `AwsSsmSecretProvider` imported
61
+ * **Remove `mypy-boto3-ssm` runtime dependency**: `AwsSsmSecretProvider` imported
44
62
  `mypy_boto3_ssm.SSMClient` at runtime, but the package is a dev-only type stub.
45
63
  Consumers installing `envilder` from PyPI got `ModuleNotFoundError`. Replaced with
46
64
  `botocore.client.BaseClient` which is already bundled with `boto3`
@@ -52,11 +70,11 @@
52
70
 
53
71
  ### Added
54
72
 
55
- * **Environment-based loading** — `Envilder.load(env, env_mapping)` and
73
+ * **Environment-based loading**: `Envilder.load(env, env_mapping)` and
56
74
  `Envilder.resolve_file(env, env_mapping)` accept a dictionary mapping environment names to
57
75
  map file paths (or `None` to skip). Enables environment-aware secret loading without
58
76
  external branching logic ([#163](https://github.com/macalbert/envilder/pull/163))
59
- * **Source validation** — Empty or whitespace-only file paths in `env_mapping` now raise
77
+ * **Source validation**: Empty or whitespace-only file paths in `env_mapping` now raise
60
78
  `ValueError` with a descriptive message including the environment key
61
79
 
62
80
  ---
@@ -65,10 +83,10 @@
65
83
 
66
84
  ### Added
67
85
 
68
- * **Fluent API facade** — `Envilder` high-level entry point with `load()`, `resolve_file()`,
86
+ * **Fluent API facade**: `Envilder` high-level entry point with `load()`, `resolve_file()`,
69
87
  and `from_map_file()` methods, plus fluent override methods (`with_provider()`, `with_vault_url()`,
70
88
  `with_profile()`) ([#161](https://github.com/macalbert/envilder/pull/161))
71
- * **Facade docstrings** — All public methods on the `Envilder` facade now have docstrings with
89
+ * **Facade docstrings**: All public methods on the `Envilder` facade now have docstrings with
72
90
  usage examples, improving IDE tooltips and `help()` output for external consumers
73
91
 
74
92
  ---
@@ -77,18 +95,18 @@
77
95
 
78
96
  ### Added
79
97
 
80
- * **Initial release** — Runtime library for loading secrets from AWS SSM Parameter Store or
98
+ * **Initial release**: Runtime library for loading secrets from AWS SSM Parameter Store or
81
99
  Azure Key Vault directly into Python applications
82
100
  ([#157](https://github.com/macalbert/envilder/pull/157))
83
- * `Envilder` facade — High-level entry point with `load()`, `resolve_file()`, and `from_map_file()` methods
84
- * `EnvilderClient` — Resolves secrets from a map-file and injects them into `os.environ`
85
- * `MapFileParser` — Parses `envilder.json` files with `$config` section and variable mappings
86
- * `SecretProviderFactory` — Creates the appropriate secret provider based on configuration
87
- * `AwsSsmSecretProvider` — Fetches secrets from AWS SSM Parameter Store via boto3
88
- * `AzureKeyVaultSecretProvider` — Fetches secrets from Azure Key Vault
89
- * `EnvilderOptions` — Runtime overrides for provider, vault URL, and AWS profile
90
- * Synchronous API — no async/await, uses boto3 natively
91
- * Protocol-based ports — Python `Protocol` instead of ABC
101
+ * `Envilder` facade: High-level entry point with `load()`, `resolve_file()`, and `from_map_file()` methods
102
+ * `EnvilderClient`: Resolves secrets from a map-file and injects them into `os.environ`
103
+ * `MapFileParser`: Parses `envilder.json` files with `$config` section and variable mappings
104
+ * `SecretProviderFactory`: Creates the appropriate secret provider based on configuration
105
+ * `AwsSsmSecretProvider`: Fetches secrets from AWS SSM Parameter Store via boto3
106
+ * `AzureKeyVaultSecretProvider`: Fetches secrets from Azure Key Vault
107
+ * `EnvilderOptions`: Runtime overrides for provider, vault URL, and AWS profile
108
+ * Synchronous API: no async/await, uses boto3 natively
109
+ * Protocol-based ports: Python `Protocol` instead of ABC
92
110
  * Python 3.10+ with full type annotations (`py.typed`)
93
111
  * Published to PyPI as `envilder`
94
112
 
@@ -1 +1 @@
1
- {"version":3,"file":"Startup.d.ts","sourceRoot":"","sources":["../../../../src/envilder/apps/cli/Startup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,qCAAqC,CAAC;AAE7C,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;;IAMtC,MAAM,CAAC,KAAK,IAAI,OAAO;IAIvB,iBAAiB,IAAI,IAAI;IAKzB,uBAAuB,CACrB,MAAM,CAAC,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI;IAKP,MAAM,IAAI,SAAS;IAInB,kBAAkB,IAAI,SAAS;CAGhC"}
1
+ {"version":3,"file":"Startup.d.ts","sourceRoot":"","sources":["../../../../src/envilder/apps/cli/Startup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,qCAAqC,CAAC;AAE7C,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IAEtC,cAEC;IAED,MAAM,CAAC,KAAK,IAAI,OAAO,CAEtB;IAED,iBAAiB,IAAI,IAAI,CAGxB;IAED,uBAAuB,CACrB,MAAM,CAAC,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CAGN;IAED,MAAM,IAAI,SAAS,CAElB;IAED,kBAAkB,IAAI,SAAS,CAE9B;CACF"}
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Cli.d.ts","sourceRoot":"","sources":["../../../../../src/envilder/apps/cli/entry/Cli.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AA2B1B,wBAAsB,IAAI,kBAqHzB"}
@@ -23,11 +23,12 @@ import { dirname, join } from 'node:path';
23
23
  import { fileURLToPath } from 'node:url';
24
24
  import { Command } from 'commander';
25
25
  import pc from 'picocolors';
26
- import { DispatchActionCommand } from '../../core/application/dispatch/DispatchActionCommand.js';
27
- import { PackageVersionReader } from '../../core/infrastructure/package/PackageVersionReader.js';
28
- import { readMapFileConfig } from '../../core/infrastructure/variableStore/FileVariableStore.js';
29
- import { TYPES } from '../../core/types.js';
30
- import { Startup } from './Startup.js';
26
+ import { DispatchActionCommand } from '../../../core/application/dispatch/DispatchActionCommand.js';
27
+ import { PackageVersionReader } from '../../../core/infrastructure/package/PackageVersionReader.js';
28
+ import { readMapFileConfig } from '../../../core/infrastructure/variableStore/FileVariableStore.js';
29
+ import { TYPES } from '../../../core/types.js';
30
+ import { executeWithSsoRecovery } from '../recovery/SsoLoginRecovery.js';
31
+ import { Startup } from '../Startup.js';
31
32
  let serviceProvider;
32
33
  function executeCommand(options) {
33
34
  return __awaiter(this, void 0, void 0, function* () {
@@ -106,7 +107,7 @@ export function main() {
106
107
  .configureServices()
107
108
  .configureInfrastructure(config, infraOptions)
108
109
  .create();
109
- yield executeCommand(options);
110
+ yield executeWithSsoRecovery(() => executeCommand(options));
110
111
  }));
111
112
  yield program.parseAsync(process.argv);
112
113
  });
@@ -114,7 +115,7 @@ export function main() {
114
115
  function readPackageVersion() {
115
116
  const __filename = fileURLToPath(import.meta.url);
116
117
  const __dirname = dirname(__filename);
117
- const packageJsonPath = join(__dirname, '../../../../package.json');
118
+ const packageJsonPath = join(__dirname, '../../../../../package.json');
118
119
  return new PackageVersionReader().getVersion(packageJsonPath);
119
120
  }
120
121
  //# sourceMappingURL=Cli.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Cli.js","sourceRoot":"","sources":["../../../../../src/envilder/apps/cli/entry/Cli.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Index.d.ts","sourceRoot":"","sources":["../../../../../src/envilder/apps/cli/entry/Index.ts"],"names":[],"mappings":";AAEA;;;GAGG"}
@@ -0,0 +1,16 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Entry point for the CLI application
4
+ * This file is executed when the CLI runs
5
+ */
6
+ import { presentError } from '../errors/CliErrorPresenter.js';
7
+ import { SilentExitError } from '../errors/SilentExitError.js';
8
+ import { main } from './Cli.js';
9
+ main().catch((error) => {
10
+ if (error instanceof SilentExitError) {
11
+ process.exit(error.code);
12
+ }
13
+ console.error(presentError(error));
14
+ process.exit(1);
15
+ });
16
+ //# sourceMappingURL=Index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Index.js","sourceRoot":"","sources":["../../../../../src/envilder/apps/cli/entry/Index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export declare function presentError(error: unknown): string;
2
+ //# sourceMappingURL=CliErrorPresenter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CliErrorPresenter.d.ts","sourceRoot":"","sources":["../../../../../src/envilder/apps/cli/errors/CliErrorPresenter.ts"],"names":[],"mappings":"AAQA,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAWnD"}
@@ -0,0 +1,78 @@
1
+ import pc from 'picocolors';
2
+ import { ExpiredCredentialsError, SecretsFetchError, SsoSessionExpiredError, } from '../../../core/domain/errors/DomainErrors.js';
3
+ import { describeError } from '../../../core/infrastructure/describeError.js';
4
+ export function presentError(error) {
5
+ if (error instanceof SsoSessionExpiredError) {
6
+ return renderSsoSessionExpired(error);
7
+ }
8
+ if (error instanceof ExpiredCredentialsError) {
9
+ return renderExpiredCredentials();
10
+ }
11
+ if (error instanceof SecretsFetchError) {
12
+ return renderSecretsFetchError(error);
13
+ }
14
+ return renderFallback(error);
15
+ }
16
+ function gameOver(title) {
17
+ return `\n${pc.bold(pc.red(`\u{1F4A5} GAME OVER \u2014 ${title}`))}`;
18
+ }
19
+ function renderSsoSessionExpired(error) {
20
+ const body = error.profileName
21
+ ? ` ${pc.dim('Your AWS SSO session for profile ')}${pc.magenta(`"${error.profileName}"`)}${pc.dim(' ran out of lives.')}`
22
+ : ` ${pc.dim('Your AWS SSO session ran out of lives.')}`;
23
+ const command = error.profileName
24
+ ? `aws sso login --profile ${error.profileName}`
25
+ : 'aws sso login';
26
+ return [
27
+ gameOver('SSO session expired'),
28
+ '',
29
+ body,
30
+ '',
31
+ ` ${pc.bold(pc.yellow('\u2B95 CONTINUE?'))}`,
32
+ ` ${pc.dim(' Run: ')}${pc.cyan(command)}`,
33
+ ` ${pc.dim(' then re-run your envilder command.')}`,
34
+ '',
35
+ ].join('\n');
36
+ }
37
+ function renderExpiredCredentials() {
38
+ return [
39
+ gameOver('AWS credentials expired'),
40
+ '',
41
+ ` ${pc.dim('Your security token ran out of time.')}`,
42
+ '',
43
+ ` ${pc.bold(pc.yellow('\u2B95 CONTINUE?'))}`,
44
+ ` ${pc.dim(' Refresh your credentials and retry ')}${pc.dim('(for SSO: ')}${pc.cyan('aws sso login')}${pc.dim(').')}`,
45
+ '',
46
+ ].join('\n');
47
+ }
48
+ function renderFallback(error) {
49
+ const message = describeError(error);
50
+ return [
51
+ gameOver('you fell down the wrong pipe!'),
52
+ '',
53
+ ` ${pc.dim(message)}`,
54
+ '',
55
+ ].join('\n');
56
+ }
57
+ const ACCESS_DENIED_PATTERN = /access.?denied|not authorized|forbidden/i;
58
+ function isAccessDeniedReason(reason) {
59
+ return ACCESS_DENIED_PATTERN.test(reason);
60
+ }
61
+ function renderSecretsFetchError(error) {
62
+ const rule = pc.red('\u2501'.repeat(60));
63
+ const failureLines = error.failures.map((failure) => ` ${pc.red('\u2717 ')}${pc.bold(failure.envVar.padEnd(20))}${pc.dim('\u2192 ')}${pc.dim(failure.path)}`);
64
+ const reasons = [...new Set(error.failures.map((failure) => failure.reason))];
65
+ const reasonLines = reasons.map((reason) => isAccessDeniedReason(reason)
66
+ ? ` ${pc.bold(pc.red(reason))}`
67
+ : ` ${pc.dim(reason)}`);
68
+ return [
69
+ gameOver('some secrets could not be fetched'),
70
+ rule,
71
+ ...failureLines,
72
+ '',
73
+ ` ${pc.bold(pc.yellow('\u2B95 WHY?'))}`,
74
+ ...reasonLines,
75
+ '',
76
+ ].join('\n');
77
+ }
78
+ //# sourceMappingURL=CliErrorPresenter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CliErrorPresenter.js","sourceRoot":"","sources":["../../../../../src/envilder/apps/cli/errors/CliErrorPresenter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ export declare class SilentExitError extends Error {
2
+ readonly code: number;
3
+ constructor(code: number);
4
+ }
5
+ //# sourceMappingURL=SilentExitError.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SilentExitError.d.ts","sourceRoot":"","sources":["../../../../../src/envilder/apps/cli/errors/SilentExitError.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM;IAAjC,YAAqB,IAAI,EAAE,MAAM,EAEhC;CACF"}
@@ -0,0 +1,7 @@
1
+ export class SilentExitError extends Error {
2
+ constructor(code) {
3
+ super('silent exit');
4
+ this.code = code;
5
+ }
6
+ }
7
+ //# sourceMappingURL=SilentExitError.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SilentExitError.js","sourceRoot":"","sources":["../../../../../src/envilder/apps/cli/errors/SilentExitError.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAqB,IAAY;QAC/B,KAAK,CAAC,aAAa,CAAC,CAAC;oBADF,IAAI;IAEzB,CAAC;CACF"}
@@ -0,0 +1,9 @@
1
+ export type RecoveryDeps = {
2
+ isInteractive(): boolean;
3
+ confirm(question: string): Promise<boolean>;
4
+ runLogin(profileName?: string): Promise<number>;
5
+ write(message: string): void;
6
+ };
7
+ export declare function buildLoginArgs(profileName?: string): string[];
8
+ export declare function executeWithSsoRecovery(run: () => Promise<void>, deps?: Partial<RecoveryDeps>): Promise<void>;
9
+ //# sourceMappingURL=SsoLoginRecovery.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SsoLoginRecovery.d.ts","sourceRoot":"","sources":["../../../../../src/envilder/apps/cli/recovery/SsoLoginRecovery.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,YAAY,GAAG;IACzB,aAAa,IAAI,OAAO,CAAC;IACzB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,wBAAgB,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAK7D;AA4CD,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACxB,IAAI,GAAE,OAAO,CAAC,YAAY,CAAM,GAC/B,OAAO,CAAC,IAAI,CAAC,CAaf"}