envilder 0.14.0 → 0.15.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (118) hide show
  1. package/README.md +55 -13
  2. package/ROADMAP.md +50 -23
  3. package/docs/SECURITY.md +35 -9
  4. package/docs/changelogs/cli.md +139 -3
  5. package/docs/changelogs/gha.md +45 -2
  6. package/docs/changelogs/sdk-dotnet.md +34 -2
  7. package/docs/changelogs/sdk-nodejs.md +22 -5
  8. package/docs/changelogs/sdk-python.md +19 -2
  9. package/docs/exec-command.md +492 -0
  10. package/lib/envilder/apps/cli/Startup.d.ts +9 -0
  11. package/lib/envilder/apps/cli/Startup.d.ts.map +1 -1
  12. package/lib/envilder/apps/cli/Startup.js +39 -0
  13. package/lib/envilder/apps/cli/Startup.js.map +1 -1
  14. package/lib/envilder/apps/cli/entry/Cli.d.ts.map +1 -1
  15. package/lib/envilder/apps/cli/entry/Cli.js +346 -13
  16. package/lib/envilder/apps/cli/entry/Cli.js.map +1 -1
  17. package/lib/envilder/apps/cli/errors/CliErrorPresenter.d.ts.map +1 -1
  18. package/lib/envilder/apps/cli/errors/CliErrorPresenter.js +4 -1
  19. package/lib/envilder/apps/cli/errors/CliErrorPresenter.js.map +1 -1
  20. package/lib/envilder/apps/cli/errors/ParseErrorRedactor.d.ts +33 -0
  21. package/lib/envilder/apps/cli/errors/ParseErrorRedactor.d.ts.map +1 -0
  22. package/lib/envilder/apps/cli/errors/ParseErrorRedactor.js +121 -0
  23. package/lib/envilder/apps/cli/errors/ParseErrorRedactor.js.map +1 -0
  24. package/lib/envilder/apps/cli/recovery/SsoLoginRecovery.d.ts +13 -0
  25. package/lib/envilder/apps/cli/recovery/SsoLoginRecovery.d.ts.map +1 -1
  26. package/lib/envilder/apps/cli/recovery/SsoLoginRecovery.js +29 -13
  27. package/lib/envilder/apps/cli/recovery/SsoLoginRecovery.js.map +1 -1
  28. package/lib/envilder/apps/shared/ContainerConfiguration.d.ts +2 -1
  29. package/lib/envilder/apps/shared/ContainerConfiguration.d.ts.map +1 -1
  30. package/lib/envilder/apps/shared/ContainerConfiguration.js +4 -2
  31. package/lib/envilder/apps/shared/ContainerConfiguration.js.map +1 -1
  32. package/lib/envilder/core/application/dispatch/DispatchActionCommand.d.ts +18 -1
  33. package/lib/envilder/core/application/dispatch/DispatchActionCommand.d.ts.map +1 -1
  34. package/lib/envilder/core/application/dispatch/DispatchActionCommand.js +17 -1
  35. package/lib/envilder/core/application/dispatch/DispatchActionCommand.js.map +1 -1
  36. package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.d.ts +9 -2
  37. package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.d.ts.map +1 -1
  38. package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.js +28 -3
  39. package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.js.map +1 -1
  40. package/lib/envilder/core/application/execWithSecrets/CommandLineFormatter.d.ts +13 -0
  41. package/lib/envilder/core/application/execWithSecrets/CommandLineFormatter.d.ts.map +1 -0
  42. package/lib/envilder/core/application/execWithSecrets/CommandLineFormatter.js +19 -0
  43. package/lib/envilder/core/application/execWithSecrets/CommandLineFormatter.js.map +1 -0
  44. package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommand.d.ts +20 -0
  45. package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommand.d.ts.map +1 -0
  46. package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommand.js +19 -0
  47. package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommand.js.map +1 -0
  48. package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommandHandler.d.ts +61 -0
  49. package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommandHandler.d.ts.map +1 -0
  50. package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommandHandler.js +159 -0
  51. package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommandHandler.js.map +1 -0
  52. package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.d.ts +1 -9
  53. package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.d.ts.map +1 -1
  54. package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.js +9 -79
  55. package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.js.map +1 -1
  56. package/lib/envilder/core/application/secretResolution/SecretResolver.d.ts +66 -0
  57. package/lib/envilder/core/application/secretResolution/SecretResolver.d.ts.map +1 -0
  58. package/lib/envilder/core/application/secretResolution/SecretResolver.js +132 -0
  59. package/lib/envilder/core/application/secretResolution/SecretResolver.js.map +1 -0
  60. package/lib/envilder/core/domain/ChildEnvironment.d.ts +22 -0
  61. package/lib/envilder/core/domain/ChildEnvironment.d.ts.map +1 -0
  62. package/lib/envilder/core/domain/ChildEnvironment.js +50 -0
  63. package/lib/envilder/core/domain/ChildEnvironment.js.map +1 -0
  64. package/lib/envilder/core/domain/ExecExitCode.d.ts +14 -0
  65. package/lib/envilder/core/domain/ExecExitCode.d.ts.map +1 -0
  66. package/lib/envilder/core/domain/ExecExitCode.js +23 -0
  67. package/lib/envilder/core/domain/ExecExitCode.js.map +1 -0
  68. package/lib/envilder/core/domain/OperationMode.d.ts +2 -1
  69. package/lib/envilder/core/domain/OperationMode.d.ts.map +1 -1
  70. package/lib/envilder/core/domain/OperationMode.js +1 -0
  71. package/lib/envilder/core/domain/OperationMode.js.map +1 -1
  72. package/lib/envilder/core/domain/errors/DomainErrors.d.ts +44 -0
  73. package/lib/envilder/core/domain/errors/DomainErrors.d.ts.map +1 -1
  74. package/lib/envilder/core/domain/errors/DomainErrors.js +57 -0
  75. package/lib/envilder/core/domain/errors/DomainErrors.js.map +1 -1
  76. package/lib/envilder/core/domain/ports/IProcessContext.d.ts +14 -0
  77. package/lib/envilder/core/domain/ports/IProcessContext.d.ts.map +1 -0
  78. package/lib/envilder/core/domain/ports/IProcessContext.js +2 -0
  79. package/lib/envilder/core/domain/ports/IProcessContext.js.map +1 -0
  80. package/lib/envilder/core/domain/ports/IProcessRunner.d.ts +27 -0
  81. package/lib/envilder/core/domain/ports/IProcessRunner.d.ts.map +1 -0
  82. package/lib/envilder/core/domain/ports/IProcessRunner.js +2 -0
  83. package/lib/envilder/core/domain/ports/IProcessRunner.js.map +1 -0
  84. package/lib/envilder/core/domain/ports/ISecretMasker.d.ts +7 -0
  85. package/lib/envilder/core/domain/ports/ISecretMasker.d.ts.map +1 -1
  86. package/lib/envilder/core/infrastructure/aws/AwsSecretProviderFactory.d.ts +5 -1
  87. package/lib/envilder/core/infrastructure/aws/AwsSecretProviderFactory.d.ts.map +1 -1
  88. package/lib/envilder/core/infrastructure/aws/AwsSecretProviderFactory.js +3 -2
  89. package/lib/envilder/core/infrastructure/aws/AwsSecretProviderFactory.js.map +1 -1
  90. package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.d.ts +6 -1
  91. package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.d.ts.map +1 -1
  92. package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.js +10 -3
  93. package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.js.map +1 -1
  94. package/lib/envilder/core/infrastructure/github/GitHubActionsSecretMasker.d.ts +22 -0
  95. package/lib/envilder/core/infrastructure/github/GitHubActionsSecretMasker.d.ts.map +1 -1
  96. package/lib/envilder/core/infrastructure/github/GitHubActionsSecretMasker.js +38 -1
  97. package/lib/envilder/core/infrastructure/github/GitHubActionsSecretMasker.js.map +1 -1
  98. package/lib/envilder/core/infrastructure/github/NoOpSecretMasker.d.ts +1 -0
  99. package/lib/envilder/core/infrastructure/github/NoOpSecretMasker.d.ts.map +1 -1
  100. package/lib/envilder/core/infrastructure/github/NoOpSecretMasker.js +3 -0
  101. package/lib/envilder/core/infrastructure/github/NoOpSecretMasker.js.map +1 -1
  102. package/lib/envilder/core/infrastructure/logger/StderrConsoleLogger.d.ts +11 -0
  103. package/lib/envilder/core/infrastructure/logger/StderrConsoleLogger.d.ts.map +1 -0
  104. package/lib/envilder/core/infrastructure/logger/StderrConsoleLogger.js +27 -0
  105. package/lib/envilder/core/infrastructure/logger/StderrConsoleLogger.js.map +1 -0
  106. package/lib/envilder/core/infrastructure/process/CrossSpawnProcessRunner.d.ts +15 -0
  107. package/lib/envilder/core/infrastructure/process/CrossSpawnProcessRunner.d.ts.map +1 -0
  108. package/lib/envilder/core/infrastructure/process/CrossSpawnProcessRunner.js +145 -0
  109. package/lib/envilder/core/infrastructure/process/CrossSpawnProcessRunner.js.map +1 -0
  110. package/lib/envilder/core/infrastructure/process/NodeProcessContext.d.ts +11 -0
  111. package/lib/envilder/core/infrastructure/process/NodeProcessContext.d.ts.map +1 -0
  112. package/lib/envilder/core/infrastructure/process/NodeProcessContext.js +18 -0
  113. package/lib/envilder/core/infrastructure/process/NodeProcessContext.js.map +1 -0
  114. package/lib/envilder/core/types.d.ts +6 -0
  115. package/lib/envilder/core/types.d.ts.map +1 -1
  116. package/lib/envilder/core/types.js +3 -0
  117. package/lib/envilder/core/types.js.map +1 -1
  118. package/package.json +15 -8
@@ -1,4 +1,7 @@
1
1
  export class NoOpSecretMasker {
2
2
  mask(_value) { }
3
+ flush() {
4
+ return Promise.resolve();
5
+ }
3
6
  }
4
7
  //# sourceMappingURL=NoOpSecretMasker.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"NoOpSecretMasker.js","sourceRoot":"","sources":["../../../../../src/envilder/core/infrastructure/github/NoOpSecretMasker.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,gBAAgB;IAC3B,IAAI,CAAC,MAAc,IAAS,CAAC;CAC9B"}
1
+ {"version":3,"file":"NoOpSecretMasker.js","sourceRoot":"","sources":["../../../../../src/envilder/core/infrastructure/github/NoOpSecretMasker.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,gBAAgB;IAC3B,IAAI,CAAC,MAAc,IAAS,CAAC;IAE7B,KAAK;QACH,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;CACF"}
@@ -0,0 +1,11 @@
1
+ import type { ILogger } from '../../domain/ports/ILogger.js';
2
+ /**
3
+ * Logger that writes every level to stderr, so stdout stays reserved for a
4
+ * child process (exec mode).
5
+ */
6
+ export declare class StderrConsoleLogger implements ILogger {
7
+ info(message: string): void;
8
+ warn(message: string): void;
9
+ error(message: string): void;
10
+ }
11
+ //# sourceMappingURL=StderrConsoleLogger.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StderrConsoleLogger.d.ts","sourceRoot":"","sources":["../../../../../src/envilder/core/infrastructure/logger/StderrConsoleLogger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAE7D;;;GAGG;AACH,qBACa,mBAAoB,YAAW,OAAO;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1B;IAED,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1B;IAED,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3B;CACF"}
@@ -0,0 +1,27 @@
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ import { injectable } from 'inversify';
8
+ /**
9
+ * Logger that writes every level to stderr, so stdout stays reserved for a
10
+ * child process (exec mode).
11
+ */
12
+ let StderrConsoleLogger = class StderrConsoleLogger {
13
+ info(message) {
14
+ console.error(message);
15
+ }
16
+ warn(message) {
17
+ console.warn(message);
18
+ }
19
+ error(message) {
20
+ console.error(message);
21
+ }
22
+ };
23
+ StderrConsoleLogger = __decorate([
24
+ injectable()
25
+ ], StderrConsoleLogger);
26
+ export { StderrConsoleLogger };
27
+ //# sourceMappingURL=StderrConsoleLogger.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StderrConsoleLogger.js","sourceRoot":"","sources":["../../../../../src/envilder/core/infrastructure/logger/StderrConsoleLogger.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC;;;GAGG;AAEI,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAC9B,IAAI,CAAC,OAAe;QAClB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,CAAC,OAAe;QAClB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,OAAe;QACnB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;CACF,CAAA;AAZY,mBAAmB;IAD/B,UAAU,EAAE;GACA,mBAAmB,CAY/B"}
@@ -0,0 +1,15 @@
1
+ import type { IProcessRunner, ProcessExit, ProcessRequest } from '../../domain/ports/IProcessRunner.js';
2
+ /**
3
+ * Starts a child process with `cross-spawn`: argv-based, no shell, and with
4
+ * Windows `.cmd`/`.bat` shims (npm, npx) resolved safely.
5
+ *
6
+ * While the child runs, termination signals received by Envilder are
7
+ * forwarded to it and Envilder waits for it to exit, with no timeout of its
8
+ * own: escalation belongs to the process manager. `SIGINT` is not forwarded
9
+ * when attached to a terminal, because the terminal already delivers it to
10
+ * the whole process group; Envilder only stays alive until the child exits.
11
+ */
12
+ export declare class CrossSpawnProcessRunner implements IProcessRunner {
13
+ run(request: ProcessRequest): Promise<ProcessExit>;
14
+ }
15
+ //# sourceMappingURL=CrossSpawnProcessRunner.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CrossSpawnProcessRunner.d.ts","sourceRoot":"","sources":["../../../../../src/envilder/core/infrastructure/process/CrossSpawnProcessRunner.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,cAAc,EACf,MAAM,sCAAsC,CAAC;AAI9C;;;;;;;;;GASG;AACH,qBAAa,uBAAwB,YAAW,cAAc;IAC5D,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CA6CjD;CACF"}
@@ -0,0 +1,145 @@
1
+ import spawn from 'cross-spawn';
2
+ import { CommandNotExecutableError, CommandNotFoundError, CommandStartError, EnvironmentTooLargeError, } from '../../domain/errors/DomainErrors.js';
3
+ const FORWARDED_SIGNALS = ['SIGTERM', 'SIGHUP'];
4
+ /**
5
+ * Starts a child process with `cross-spawn`: argv-based, no shell, and with
6
+ * Windows `.cmd`/`.bat` shims (npm, npx) resolved safely.
7
+ *
8
+ * While the child runs, termination signals received by Envilder are
9
+ * forwarded to it and Envilder waits for it to exit, with no timeout of its
10
+ * own: escalation belongs to the process manager. `SIGINT` is not forwarded
11
+ * when attached to a terminal, because the terminal already delivers it to
12
+ * the whole process group; Envilder only stays alive until the child exits.
13
+ */
14
+ export class CrossSpawnProcessRunner {
15
+ run(request) {
16
+ return new Promise((resolve, reject) => {
17
+ let child;
18
+ try {
19
+ child = spawn(request.command, request.args, {
20
+ env: request.env,
21
+ stdio: 'inherit',
22
+ shell: false,
23
+ });
24
+ }
25
+ catch (error) {
26
+ reject(toSpawnError(error, request.command));
27
+ return;
28
+ }
29
+ const removeSignalForwarding = forwardSignals(child);
30
+ let settled = false;
31
+ const settle = (finish) => {
32
+ if (settled) {
33
+ return;
34
+ }
35
+ settled = true;
36
+ removeSignalForwarding();
37
+ finish();
38
+ };
39
+ let spawned = false;
40
+ child.once('spawn', () => {
41
+ spawned = true;
42
+ });
43
+ // Kept attached for the child's whole life: a later 'error' with no
44
+ // listener would crash Envilder while the child is still running.
45
+ child.on('error', (error) => {
46
+ if (spawned && !isSpawnFailure(error)) {
47
+ // For example a failed signal delivery (EPERM from kill): the child
48
+ // is still running, so keep forwarding signals and wait for it.
49
+ return;
50
+ }
51
+ settle(() => reject(toSpawnError(error, request.command)));
52
+ });
53
+ const onExit = (code, signal) => {
54
+ settle(() => resolve({ code, signal }));
55
+ };
56
+ child.once('exit', onExit);
57
+ child.once('close', onExit);
58
+ });
59
+ }
60
+ }
61
+ function forwardSignals(child) {
62
+ const listeners = new Map();
63
+ const forward = (signal) => () => {
64
+ if (child.exitCode === null && child.signalCode === null) {
65
+ child.kill(signal);
66
+ }
67
+ };
68
+ for (const signal of FORWARDED_SIGNALS) {
69
+ listeners.set(signal, forward(signal));
70
+ }
71
+ // Listening to SIGINT also keeps Envilder alive until the child exits.
72
+ const forwardInterrupt = forward('SIGINT');
73
+ listeners.set('SIGINT', () => {
74
+ if (!process.stdin.isTTY) {
75
+ forwardInterrupt();
76
+ }
77
+ });
78
+ for (const [signal, listener] of listeners) {
79
+ process.on(signal, listener);
80
+ }
81
+ return () => {
82
+ for (const [signal, listener] of listeners) {
83
+ process.removeListener(signal, listener);
84
+ }
85
+ };
86
+ }
87
+ /**
88
+ * Whether an error reports that the command could not be started. cross-spawn
89
+ * reports an unresolvable command on Windows after the `cmd.exe` wrapper has
90
+ * spawned, with a `spawn <command>` syscall, so the syscall is checked rather
91
+ * than only the moment the error arrives.
92
+ */
93
+ function isSpawnFailure(error) {
94
+ const syscall = error === null || error === void 0 ? void 0 : error.syscall;
95
+ return typeof syscall === 'string' && syscall.startsWith('spawn');
96
+ }
97
+ /**
98
+ * Known reasons a command exists but cannot be executed (exit code 126).
99
+ * Any other error code gets a generic reason with the code.
100
+ */
101
+ const NOT_EXECUTABLE_REASONS = {
102
+ ETXTBSY: 'text file busy',
103
+ ELOOP: 'too many levels of symbolic links',
104
+ ENOEXEC: 'exec format error',
105
+ EISDIR: 'is a directory',
106
+ ENOTDIR: 'a path component is not a directory',
107
+ ENAMETOOLONG: 'file name too long',
108
+ };
109
+ const GENERIC_NOT_EXECUTABLE_REASON = 'the operating system refused to run it';
110
+ /** The system could not provide what starting a process needs (exit 125). */
111
+ const RESOURCE_ERRORS = new Set(['EAGAIN', 'EMFILE', 'ENFILE', 'ENOMEM']);
112
+ /**
113
+ * Maps a spawn failure to a domain error. Node throws some failures
114
+ * synchronously and emits others on the child, so both paths use this.
115
+ *
116
+ * - ENOENT: the command was not found (127).
117
+ * - E2BIG, resource exhaustion and failures without a code: Envilder could
118
+ * not start the command (125).
119
+ * - EACCES and every other code: the command cannot be executed (126).
120
+ *
121
+ * Messages name the command only, never its arguments.
122
+ */
123
+ function toSpawnError(error, command) {
124
+ const code = error === null || error === void 0 ? void 0 : error.code;
125
+ if (typeof code !== 'string' || code === '') {
126
+ return new CommandStartError(command, 'the process could not be created');
127
+ }
128
+ if (code === 'ENOENT') {
129
+ return new CommandNotFoundError(command);
130
+ }
131
+ if (code === 'E2BIG') {
132
+ return new EnvironmentTooLargeError();
133
+ }
134
+ if (RESOURCE_ERRORS.has(code)) {
135
+ return new CommandStartError(command, `system resources unavailable (${code})`);
136
+ }
137
+ if (code === 'EACCES') {
138
+ return new CommandNotExecutableError(command);
139
+ }
140
+ const reason = Object.hasOwn(NOT_EXECUTABLE_REASONS, code)
141
+ ? NOT_EXECUTABLE_REASONS[code]
142
+ : GENERIC_NOT_EXECUTABLE_REASON;
143
+ return new CommandNotExecutableError(command, `${reason} (${code})`);
144
+ }
145
+ //# sourceMappingURL=CrossSpawnProcessRunner.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CrossSpawnProcessRunner.js","sourceRoot":"","sources":["../../../../../src/envilder/core/infrastructure/process/CrossSpawnProcessRunner.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ import type { IProcessContext } from '../../domain/ports/IProcessContext.js';
2
+ /**
3
+ * Reads the live Node.js process: its environment and platform at call time,
4
+ * and the platform's signal numbers.
5
+ */
6
+ export declare class NodeProcessContext implements IProcessContext {
7
+ environment(): Readonly<Record<string, string | undefined>>;
8
+ platform(): string;
9
+ signalNumber(signal: NodeJS.Signals): number;
10
+ }
11
+ //# sourceMappingURL=NodeProcessContext.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"NodeProcessContext.d.ts","sourceRoot":"","sources":["../../../../../src/envilder/core/infrastructure/process/NodeProcessContext.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAE7E;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACxD,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAE1D;IAED,QAAQ,IAAI,MAAM,CAEjB;IAED,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,CAE3C;CACF"}
@@ -0,0 +1,18 @@
1
+ import { constants } from 'node:os';
2
+ /**
3
+ * Reads the live Node.js process: its environment and platform at call time,
4
+ * and the platform's signal numbers.
5
+ */
6
+ export class NodeProcessContext {
7
+ environment() {
8
+ return process.env;
9
+ }
10
+ platform() {
11
+ return process.platform;
12
+ }
13
+ signalNumber(signal) {
14
+ var _a;
15
+ return (_a = constants.signals[signal]) !== null && _a !== void 0 ? _a : 0;
16
+ }
17
+ }
18
+ //# sourceMappingURL=NodeProcessContext.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"NodeProcessContext.js","sourceRoot":"","sources":["../../../../../src/envilder/core/infrastructure/process/NodeProcessContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpC;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAC7B,WAAW;QACT,OAAO,OAAO,CAAC,GAAG,CAAC;IACrB,CAAC;IAED,QAAQ;QACN,OAAO,OAAO,CAAC,QAAQ,CAAC;IAC1B,CAAC;IAED,YAAY,CAAC,MAAsB;;QACjC,aAAO,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,mCAAI,CAAC,CAAC;IACxC,CAAC;CACF"}
@@ -3,12 +3,15 @@ export declare const DOMAIN: {
3
3
  ISecretProvider: symbol;
4
4
  ISecretMasker: symbol;
5
5
  IVariableStore: symbol;
6
+ IProcessRunner: symbol;
7
+ IProcessContext: symbol;
6
8
  };
7
9
  export declare const APPLICATION: {
8
10
  PullSecretsToEnvCommandHandler: symbol;
9
11
  PushEnvToSecretsCommandHandler: symbol;
10
12
  PushSingleCommandHandler: symbol;
11
13
  DispatchActionCommandHandler: symbol;
14
+ ExecWithSecretsCommandHandler: symbol;
12
15
  };
13
16
  export declare const INFRASTRUCTURE: {};
14
17
  export declare const TYPES: {
@@ -16,9 +19,12 @@ export declare const TYPES: {
16
19
  ISecretProvider: symbol;
17
20
  ISecretMasker: symbol;
18
21
  IVariableStore: symbol;
22
+ IProcessRunner: symbol;
23
+ IProcessContext: symbol;
19
24
  PullSecretsToEnvCommandHandler: symbol;
20
25
  PushEnvToSecretsCommandHandler: symbol;
21
26
  PushSingleCommandHandler: symbol;
22
27
  DispatchActionCommandHandler: symbol;
28
+ ExecWithSecretsCommandHandler: symbol;
23
29
  };
24
30
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/envilder/core/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;IACjB,OAAO;IACP,eAAe;IACf,aAAa;IACb,cAAc;CACf,CAAC;AAEF,eAAO,MAAM,WAAW;IACtB,8BAA8B;IAC9B,8BAA8B;IAC9B,wBAAwB;IACxB,4BAA4B;CAC7B,CAAC;AAEF,eAAO,MAAM,cAAc,IAG1B,CAAC;AAGF,eAAO,MAAM,KAAK;;;;;;;;;CAIjB,CAAC"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/envilder/core/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;IACjB,OAAO;IACP,eAAe;IACf,aAAa;IACb,cAAc;IACd,cAAc;IACd,eAAe;CAChB,CAAC;AAEF,eAAO,MAAM,WAAW;IACtB,8BAA8B;IAC9B,8BAA8B;IAC9B,wBAAwB;IACxB,4BAA4B;IAC5B,6BAA6B;CAC9B,CAAC;AAEF,eAAO,MAAM,cAAc,IAG1B,CAAC;AAGF,eAAO,MAAM,KAAK;;;;;;;;;;;;CAIjB,CAAC"}
@@ -3,12 +3,15 @@ export const DOMAIN = {
3
3
  ISecretProvider: Symbol.for('ISecretProvider'),
4
4
  ISecretMasker: Symbol.for('ISecretMasker'),
5
5
  IVariableStore: Symbol.for('IVariableStore'),
6
+ IProcessRunner: Symbol.for('IProcessRunner'),
7
+ IProcessContext: Symbol.for('IProcessContext'),
6
8
  };
7
9
  export const APPLICATION = {
8
10
  PullSecretsToEnvCommandHandler: Symbol.for('PullSecretsToEnvCommandHandler'),
9
11
  PushEnvToSecretsCommandHandler: Symbol.for('PushEnvToSecretsCommandHandler'),
10
12
  PushSingleCommandHandler: Symbol.for('PushSingleCommandHandler'),
11
13
  DispatchActionCommandHandler: Symbol.for('DispatchActionCommandHandler'),
14
+ ExecWithSecretsCommandHandler: Symbol.for('ExecWithSecretsCommandHandler'),
12
15
  };
13
16
  export const INFRASTRUCTURE = {
14
17
  // Currently empty - Infrastructure implements domain ports
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/envilder/core/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC9C,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC;IAC1C,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC;CAC7C,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,8BAA8B,EAAE,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC;IAC5E,8BAA8B,EAAE,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC;IAC5E,wBAAwB,EAAE,MAAM,CAAC,GAAG,CAAC,0BAA0B,CAAC;IAChE,4BAA4B,EAAE,MAAM,CAAC,GAAG,CAAC,8BAA8B,CAAC;CACzE,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG;AAC5B,2DAA2D;AAC3D,sDAAsD;CACvD,CAAC;AAEF,+FAA+F;AAC/F,MAAM,CAAC,MAAM,KAAK,iDACb,MAAM,GACN,WAAW,GACX,cAAc,CAClB,CAAC"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/envilder/core/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC9C,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC;IAC1C,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC5C,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC5C,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC;CAC/C,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,8BAA8B,EAAE,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC;IAC5E,8BAA8B,EAAE,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC;IAC5E,wBAAwB,EAAE,MAAM,CAAC,GAAG,CAAC,0BAA0B,CAAC;IAChE,4BAA4B,EAAE,MAAM,CAAC,GAAG,CAAC,8BAA8B,CAAC;IACxE,6BAA6B,EAAE,MAAM,CAAC,GAAG,CAAC,+BAA+B,CAAC;CAC3E,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG;AAC5B,2DAA2D;AAC3D,sDAAsD;CACvD,CAAC;AAEF,+FAA+F;AAC/F,MAAM,CAAC,MAAM,KAAK,iDACb,MAAM,GACN,WAAW,GACX,cAAc,CAClB,CAAC"}
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "envilder",
3
- "version": "0.14.0",
3
+ "version": "0.15.1",
4
4
  "packageManager": "pnpm@12.3.4+sha512.961aa41fb077da3a04a441d9f8e15ebc0c96da8ef710b2eb67bf9ee7cb0610eabd48f1fd85f51cffe73846785fa0f87c56a3a872a1d893f8446741b5cce45457",
5
- "description": "Open-source TypeScript CLI, GitHub Action, and runtime SDKs for loading secrets from AWS SSM Parameter Store and Azure Key Vault.",
5
+ "description": "Open-source CLI, GitHub Action, and runtime SDKs for AWS SSM Parameter Store and Azure Key Vault secrets. Run any command with secrets injected (envilder exec), generate .env files, or load them in-process.",
6
6
  "homepage": "https://envilder.com",
7
7
  "author": {
8
8
  "name": "Marçal Albert Castellví",
@@ -33,6 +33,7 @@
33
33
  "test": "pnpm --filter @envilder/website build && vitest run --reporter=verbose --coverage",
34
34
  "test:ci": "pnpm --filter @envilder/website build && vitest run --reporter=verbose --reporter=junit --coverage --outputFile=coverage/junit/test-results.xml",
35
35
  "test:update": "vitest run --reporter=verbose --update",
36
+ "test:exec": "vitest run tests/envilder/core/infrastructure/process tests/envilder/apps/cli/entry/CliExec.test.ts tests/envilder/apps/cli/entry/CliExecSsoRecovery.test.ts tests/envilder/core/domain/ChildEnvironment.test.ts",
36
37
  "release:publish": "npm pack --dry-run && npm publish --provenance",
37
38
  "action-publish": "pnpm build:gha && pnpm verify:gha",
38
39
  "release-patch": "pnpm version patch",
@@ -52,6 +53,9 @@
52
53
  "ssm",
53
54
  "parameter-store",
54
55
  "cli",
56
+ "exec",
57
+ "secret-injection",
58
+ "run-with-secrets",
55
59
  "sdk",
56
60
  "environment",
57
61
  "environment-variables",
@@ -87,17 +91,19 @@
87
91
  "ROADMAP.md",
88
92
  "docs/CHANGELOG.md",
89
93
  "docs/changelogs/**",
94
+ "docs/exec-command.md",
90
95
  "docs/SECURITY.md"
91
96
  ],
92
97
  "type": "module",
93
98
  "dependencies": {
94
- "@aws-sdk/client-ssm": "^3.1101.0",
95
- "@aws-sdk/client-sts": "^3.1101.0",
96
- "@aws-sdk/credential-providers": "^3.1101.0",
99
+ "@aws-sdk/client-ssm": "^3.1149.0",
100
+ "@aws-sdk/client-sts": "^3.1149.0",
101
+ "@aws-sdk/credential-providers": "^3.1149.0",
97
102
  "@azure/core-rest-pipeline": "^1.23.0",
98
103
  "@azure/identity": "^4.13.1",
99
104
  "@azure/keyvault-secrets": "^4.11.2",
100
105
  "commander": "^15.0.0",
106
+ "cross-spawn": "^7.0.6",
101
107
  "dotenv": "^17.4.2",
102
108
  "inversify": "^8.2.3",
103
109
  "picocolors": "^1.1.1",
@@ -108,16 +114,17 @@
108
114
  "@commitlint/cli": "^21.2.0",
109
115
  "@commitlint/config-conventional": "^21.2.0",
110
116
  "@secretlint/secretlint-rule-preset-recommend": "^13.0.2",
111
- "@testcontainers/localstack": "^12.0.4",
117
+ "@testcontainers/localstack": "^12.2.1",
118
+ "@types/cross-spawn": "^6.0.6",
112
119
  "@types/node": "catalog:",
113
120
  "@vitest/coverage-v8": "catalog:",
114
121
  "ajv": "^8.20.0",
115
122
  "ajv-formats": "^3.0.1",
116
123
  "esbuild": "^0.28.1",
117
124
  "glob": "^13.0.6",
118
- "lefthook": "^2.1.9",
125
+ "lefthook": "^2.2.1",
119
126
  "secretlint": "^13.0.2",
120
- "testcontainers": "^12.0.4",
127
+ "testcontainers": "^12.2.1",
121
128
  "tsx": "catalog:",
122
129
  "typescript": "catalog:",
123
130
  "vitest": "catalog:"