@marinoscar/platform-cli 0.0.0-stage → 0.1.0-next.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +20 -0
- package/LICENSE +21 -0
- package/README.md +87 -2
- package/dist/core/command-registry.d.ts +50 -0
- package/dist/core/command-registry.d.ts.map +1 -0
- package/dist/core/command-registry.js +97 -0
- package/dist/core/command-registry.js.map +1 -0
- package/dist/core/env-spec-registry.d.ts +119 -0
- package/dist/core/env-spec-registry.d.ts.map +1 -0
- package/dist/core/env-spec-registry.js +88 -0
- package/dist/core/env-spec-registry.js.map +1 -0
- package/dist/core/env-values.d.ts +75 -0
- package/dist/core/env-values.d.ts.map +1 -0
- package/dist/core/env-values.js +123 -0
- package/dist/core/env-values.js.map +1 -0
- package/dist/core/index.d.ts +6 -0
- package/dist/core/index.d.ts.map +1 -0
- package/dist/core/index.js +6 -0
- package/dist/core/index.js.map +1 -0
- package/dist/index.d.ts +11 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +11 -0
- package/dist/index.js.map +1 -0
- package/dist/telemetry/env-fragment.d.ts +47 -0
- package/dist/telemetry/env-fragment.d.ts.map +1 -0
- package/dist/telemetry/env-fragment.js +73 -0
- package/dist/telemetry/env-fragment.js.map +1 -0
- package/dist/telemetry/index.d.ts +6 -0
- package/dist/telemetry/index.d.ts.map +1 -0
- package/dist/telemetry/index.js +6 -0
- package/dist/telemetry/index.js.map +1 -0
- package/dist/telemetry/node-span-relay.d.ts +107 -0
- package/dist/telemetry/node-span-relay.d.ts.map +1 -0
- package/dist/telemetry/node-span-relay.js +281 -0
- package/dist/telemetry/node-span-relay.js.map +1 -0
- package/dist/telemetry/node-span.d.ts +60 -0
- package/dist/telemetry/node-span.d.ts.map +1 -0
- package/dist/telemetry/node-span.js +10 -0
- package/dist/telemetry/node-span.js.map +1 -0
- package/package.json +64 -4
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# @marinoscar/platform-cli
|
|
2
|
+
|
|
3
|
+
## 0.1.0-next.3
|
|
4
|
+
|
|
5
|
+
## 0.1.0-next.2
|
|
6
|
+
|
|
7
|
+
## 0.1.0-next.1
|
|
8
|
+
|
|
9
|
+
## 0.1.0-next.0
|
|
10
|
+
|
|
11
|
+
### Minor Changes
|
|
12
|
+
|
|
13
|
+
- a66fef1: First pre-release of the platform packages: the six-package scaffold (build formats, boundary lint, pack check, TSDoc and generated API reference, single-instance peer dependencies) plus the first slices.
|
|
14
|
+
|
|
15
|
+
- `@marinoscar/platform-api/core`: the typed registry primitive (`defineRegistry`, `Registry`, `RegistryError`, `RegistryFreezeService`, `withTemporaryEntries`).
|
|
16
|
+
- `@marinoscar/platform-api/testing`: the conformance harness (`runPlatformConformance`, `conformanceSuites`) with the `cron-enqueue-only` suite.
|
|
17
|
+
- `@marinoscar/platform-cli/core`: the CLI command and env-spec fragment registries.
|
|
18
|
+
- `@marinoscar/platform-cli/telemetry`: the node span relay and the telemetry env-spec fragment.
|
|
19
|
+
- `@marinoscar/platform-infra`: `infraFile()`, the `platform-infra` command (`sync` materialises fragments into an app) and the `telemetry` slice (collector and GreptimeDB compose fragments, collector config and overlay, typed manifest).
|
|
20
|
+
- `@marinoscar/platform-contract`, `@marinoscar/platform-web` and `@marinoscar/platform-db` ship their package scaffold only; their slices follow in later releases.
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 marinoscar
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,88 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @marinoscar/platform-cli
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Command and TUI building blocks for an app's own command-line client: Commander commands and ink components an app registers in its CLI. ESM with `sideEffects: false`; runs on Node 20 or later.
|
|
4
|
+
|
|
5
|
+
## Purpose and scope
|
|
6
|
+
|
|
7
|
+
Commander commands and ink components of the platform's CLI slices. It does not own the app's binary name, its program definition or its configuration file location.
|
|
8
|
+
|
|
9
|
+
Status: version `0.0.0`, unpublished. Slices are subpath exports (`@marinoscar/platform-cli/<slice>`), each with its own README: `core` (the CLI's command and env-spec fragment registries) and `telemetry` (the node span relay and the telemetry env-spec fragment). The root export is still only the package name (`PLATFORM_PACKAGE`).
|
|
10
|
+
|
|
11
|
+
## Install and peer dependencies
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
npm install @marinoscar/platform-cli
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
Install these in the app; the package never bundles its own copy (a second copy breaks dependency injection, hooks or theme context).
|
|
18
|
+
|
|
19
|
+
| Package | Range |
|
|
20
|
+
|---|---|
|
|
21
|
+
| `commander` | `^14.0.2` |
|
|
22
|
+
| `ink` | `^7.1.1` |
|
|
23
|
+
| `react` | `^19.2.8` |
|
|
24
|
+
|
|
25
|
+
## Quick start
|
|
26
|
+
|
|
27
|
+
Pick the slice you need and follow its README:
|
|
28
|
+
|
|
29
|
+
| Subpath | Contents | README |
|
|
30
|
+
|---|---|---|
|
|
31
|
+
| `@marinoscar/platform-cli/core` | `registerCliCommand`, `registerEnvSpecFragment` and the env-key metadata helpers | [core](src/core/README.md) |
|
|
32
|
+
| `@marinoscar/platform-cli/telemetry` | The worker node's span relay and `telemetryEnvSpecFragment` | [telemetry](src/telemetry/README.md) |
|
|
33
|
+
|
|
34
|
+
```ts
|
|
35
|
+
import { registerCliCommand } from '@marinoscar/platform-cli/core';
|
|
36
|
+
|
|
37
|
+
registerCliCommand((program) => program.command('hello').action(() => console.log('hello')));
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## Configuration
|
|
41
|
+
|
|
42
|
+
None at package level. The registries take no options; `NodeSpanRelayOptions` is in the [telemetry README](src/telemetry/README.md#configuration).
|
|
43
|
+
|
|
44
|
+
## Extension-point catalog
|
|
45
|
+
|
|
46
|
+
None. The root entry point exports only `PLATFORM_PACKAGE`; the extension points are catalogued per slice, in the [core README](src/core/README.md#extension-point-catalog).
|
|
47
|
+
|
|
48
|
+
## Data
|
|
49
|
+
|
|
50
|
+
None. The CLI holds no data model; it calls the API.
|
|
51
|
+
|
|
52
|
+
## Permissions and settings
|
|
53
|
+
|
|
54
|
+
None yet. Commands document the API permissions they need as they are extracted.
|
|
55
|
+
|
|
56
|
+
## UI
|
|
57
|
+
|
|
58
|
+
None. Terminal output only; the ink components are listed in each slice's README.
|
|
59
|
+
|
|
60
|
+
## Infra
|
|
61
|
+
|
|
62
|
+
None. The package ships no deployment configuration and reads no environment variable; `telemetryEnvSpecFragment` annotates keys of the app's `.env.example` (see the [telemetry README](src/telemetry/README.md#infra)).
|
|
63
|
+
|
|
64
|
+
## Observability
|
|
65
|
+
|
|
66
|
+
The telemetry slice's node span relay is a worker's only span source; see the [telemetry README](src/telemetry/README.md#observability).
|
|
67
|
+
|
|
68
|
+
## Security notes
|
|
69
|
+
|
|
70
|
+
Nothing is exported yet. Commands never print or persist a credential beyond the app's own configuration file.
|
|
71
|
+
|
|
72
|
+
## Conformance suite
|
|
73
|
+
|
|
74
|
+
None yet. The package ships no conformance suite; `runPlatformConformance()` and the suites arrive with the platform's conformance harness.
|
|
75
|
+
|
|
76
|
+
## Upgrade notes
|
|
77
|
+
|
|
78
|
+
None. No version has been published yet, so there is nothing to migrate from.
|
|
79
|
+
|
|
80
|
+
## Troubleshooting
|
|
81
|
+
|
|
82
|
+
None yet. Build and import problems common to every platform package are in [DEVELOPMENT.md § Platform packages](../../docs/DEVELOPMENT.md#platform-packages).
|
|
83
|
+
|
|
84
|
+
## Links
|
|
85
|
+
|
|
86
|
+
- [Platform packages spec](../../docs/specs/platform-packages.md): the extension contract and the package documentation standard
|
|
87
|
+
- [Package documentation standard and checks](../../docs/PACKAGES.md): how this README, the TSDoc and the catalog are checked
|
|
88
|
+
- [DEVELOPMENT.md § Platform packages](../../docs/DEVELOPMENT.md#platform-packages): build, test and lint commands
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import type { Command } from 'commander';
|
|
2
|
+
/**
|
|
3
|
+
* Adds one or more commands to the host program. Receives the program itself,
|
|
4
|
+
* so it calls `program.command(...)` exactly as a built-in command would.
|
|
5
|
+
*
|
|
6
|
+
* @stability experimental
|
|
7
|
+
*/
|
|
8
|
+
export type CliCommandRegistration = (program: Command) => void;
|
|
9
|
+
/**
|
|
10
|
+
* Registers a function that adds commands to the host CLI.
|
|
11
|
+
*
|
|
12
|
+
* Nothing runs until the host calls {@link applyRegisteredCommands}; functions
|
|
13
|
+
* run in registration order.
|
|
14
|
+
*
|
|
15
|
+
* @param register - Called with the host's `program` once it has its built-ins.
|
|
16
|
+
* @stability experimental
|
|
17
|
+
* @extensionPoint registry
|
|
18
|
+
* @example
|
|
19
|
+
* ```ts
|
|
20
|
+
* registerCliCommand((program) => program.command('coach-seed').action(seedCoachData));
|
|
21
|
+
* ```
|
|
22
|
+
*/
|
|
23
|
+
export declare function registerCliCommand(register: CliCommandRegistration): void;
|
|
24
|
+
/**
|
|
25
|
+
* Runs every registered function against `program`, after its built-in
|
|
26
|
+
* commands, and returns the program.
|
|
27
|
+
*
|
|
28
|
+
* Throws when an app command's name or alias is already taken by a built-in,
|
|
29
|
+
* by an earlier app command or by commander's own `help`.
|
|
30
|
+
*
|
|
31
|
+
* @param program - The host program, with its built-in commands registered.
|
|
32
|
+
* @returns The same program.
|
|
33
|
+
* @stability experimental
|
|
34
|
+
*/
|
|
35
|
+
export declare function applyRegisteredCommands(program: Command): Command;
|
|
36
|
+
/**
|
|
37
|
+
* Every registered function, in registration order.
|
|
38
|
+
*
|
|
39
|
+
* @returns A frozen copy of the list.
|
|
40
|
+
* @stability experimental
|
|
41
|
+
*/
|
|
42
|
+
export declare function listRegisteredCommands(): readonly CliCommandRegistration[];
|
|
43
|
+
/**
|
|
44
|
+
* Empties the registry. For tests only: production code never unregisters.
|
|
45
|
+
*
|
|
46
|
+
* @internal
|
|
47
|
+
* @stability experimental
|
|
48
|
+
*/
|
|
49
|
+
export declare function resetCommandRegistryForTests(): void;
|
|
50
|
+
//# sourceMappingURL=command-registry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../../src/core/command-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBzC;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;AAOhE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAKzE;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAgCjE;AAUD;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,SAAS,sBAAsB,EAAE,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD"}
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
/** Commander's implicit help command; an app must never shadow it. */
|
|
2
|
+
const RESERVED_NAMES = ['help'];
|
|
3
|
+
const registrations = [];
|
|
4
|
+
/**
|
|
5
|
+
* Registers a function that adds commands to the host CLI.
|
|
6
|
+
*
|
|
7
|
+
* Nothing runs until the host calls {@link applyRegisteredCommands}; functions
|
|
8
|
+
* run in registration order.
|
|
9
|
+
*
|
|
10
|
+
* @param register - Called with the host's `program` once it has its built-ins.
|
|
11
|
+
* @stability experimental
|
|
12
|
+
* @extensionPoint registry
|
|
13
|
+
* @example
|
|
14
|
+
* ```ts
|
|
15
|
+
* registerCliCommand((program) => program.command('coach-seed').action(seedCoachData));
|
|
16
|
+
* ```
|
|
17
|
+
*/
|
|
18
|
+
export function registerCliCommand(register) {
|
|
19
|
+
if (typeof register !== 'function') {
|
|
20
|
+
throw new TypeError('registerCliCommand expects a function (program) => void.');
|
|
21
|
+
}
|
|
22
|
+
registrations.push(register);
|
|
23
|
+
}
|
|
24
|
+
function namesOf(command) {
|
|
25
|
+
return [command.name(), ...command.aliases()];
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Runs every registered function against `program`, after its built-in
|
|
29
|
+
* commands, and returns the program.
|
|
30
|
+
*
|
|
31
|
+
* Throws when an app command's name or alias is already taken by a built-in,
|
|
32
|
+
* by an earlier app command or by commander's own `help`.
|
|
33
|
+
*
|
|
34
|
+
* @param program - The host program, with its built-in commands registered.
|
|
35
|
+
* @returns The same program.
|
|
36
|
+
* @stability experimental
|
|
37
|
+
*/
|
|
38
|
+
export function applyRegisteredCommands(program) {
|
|
39
|
+
const taken = new Map();
|
|
40
|
+
for (const name of RESERVED_NAMES)
|
|
41
|
+
taken.set(name, 'reserved by commander');
|
|
42
|
+
for (const command of program.commands) {
|
|
43
|
+
for (const name of namesOf(command))
|
|
44
|
+
taken.set(name, 'a built-in command');
|
|
45
|
+
}
|
|
46
|
+
for (const register of registrations) {
|
|
47
|
+
const before = new Set(program.commands);
|
|
48
|
+
try {
|
|
49
|
+
register(program);
|
|
50
|
+
}
|
|
51
|
+
catch (error) {
|
|
52
|
+
// Commander 14 refuses a duplicate name or alias itself, with a message
|
|
53
|
+
// that does not say an app registration caused it. Re-word that one
|
|
54
|
+
// case; anything else the registration threw is passed through as is.
|
|
55
|
+
const message = error instanceof Error ? error.message : '';
|
|
56
|
+
const duplicate = /cannot add (?:command|alias) '([^']+)'/.exec(message);
|
|
57
|
+
if (duplicate?.[1] !== undefined) {
|
|
58
|
+
throw collision(duplicate[1], taken.get(duplicate[1]) ?? 'taken', error);
|
|
59
|
+
}
|
|
60
|
+
throw error;
|
|
61
|
+
}
|
|
62
|
+
for (const command of program.commands) {
|
|
63
|
+
if (before.has(command))
|
|
64
|
+
continue;
|
|
65
|
+
for (const name of namesOf(command)) {
|
|
66
|
+
const holder = taken.get(name);
|
|
67
|
+
if (holder !== undefined)
|
|
68
|
+
throw collision(name, holder);
|
|
69
|
+
taken.set(name, 'an app command registered earlier');
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
return program;
|
|
74
|
+
}
|
|
75
|
+
function collision(name, holder, cause) {
|
|
76
|
+
return new Error(`An app command cannot be named "${name}": that name is already ${holder}. ` +
|
|
77
|
+
'Choose another name for the command registered with registerCliCommand.', cause === undefined ? undefined : { cause });
|
|
78
|
+
}
|
|
79
|
+
/**
|
|
80
|
+
* Every registered function, in registration order.
|
|
81
|
+
*
|
|
82
|
+
* @returns A frozen copy of the list.
|
|
83
|
+
* @stability experimental
|
|
84
|
+
*/
|
|
85
|
+
export function listRegisteredCommands() {
|
|
86
|
+
return Object.freeze([...registrations]);
|
|
87
|
+
}
|
|
88
|
+
/**
|
|
89
|
+
* Empties the registry. For tests only: production code never unregisters.
|
|
90
|
+
*
|
|
91
|
+
* @internal
|
|
92
|
+
* @stability experimental
|
|
93
|
+
*/
|
|
94
|
+
export function resetCommandRegistryForTests() {
|
|
95
|
+
registrations.length = 0;
|
|
96
|
+
}
|
|
97
|
+
//# sourceMappingURL=command-registry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"command-registry.js","sourceRoot":"","sources":["../../src/core/command-registry.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* How a generated value is made.
|
|
3
|
+
*
|
|
4
|
+
* - `base64-32`: 32 random bytes, standard base64 (AES-256 keys, JWT secrets).
|
|
5
|
+
* - `hex-32`: 32 random bytes, lowercase hex. For values embedded in a syntax
|
|
6
|
+
* that reserves base64's own characters: GreptimeDB's
|
|
7
|
+
* `static_user_provider:cmd:user=password,user2=password2` splits on `,`,
|
|
8
|
+
* `=` and `:`, and base64 carries `=` padding (and `+`, `/`).
|
|
9
|
+
*
|
|
10
|
+
* @stability experimental
|
|
11
|
+
*/
|
|
12
|
+
export type GenerateKind = 'base64-32' | 'hex-32';
|
|
13
|
+
/**
|
|
14
|
+
* What a `derive` function may read.
|
|
15
|
+
*
|
|
16
|
+
* @stability experimental
|
|
17
|
+
*/
|
|
18
|
+
export interface DeriveContext {
|
|
19
|
+
/** The public hostname the deployment is being published under. */
|
|
20
|
+
domain: string;
|
|
21
|
+
/** Answers collected so far, in prompt order. */
|
|
22
|
+
answers: ReadonlyMap<string, string>;
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* The annotation for one environment key. Every field is optional: a key with
|
|
26
|
+
* no entry at all is not secret, not essential, takes the template default and
|
|
27
|
+
* gets its help text from the template's comments.
|
|
28
|
+
*
|
|
29
|
+
* @stability experimental
|
|
30
|
+
*/
|
|
31
|
+
export interface EnvVarMetadata {
|
|
32
|
+
/** Never echoed, never logged, never rendered into a frame. */
|
|
33
|
+
secret?: boolean;
|
|
34
|
+
/** Asked even when the template supplies a default. */
|
|
35
|
+
essential?: boolean;
|
|
36
|
+
/** Offer to generate a value rather than make someone invent one. */
|
|
37
|
+
generate?: GenerateKind;
|
|
38
|
+
/**
|
|
39
|
+
* Generate the value WITHOUT ASKING, interactive or not, whenever it is
|
|
40
|
+
* blank or still a template placeholder (`isPlaceholderValue`). A real value
|
|
41
|
+
* is never replaced. Requires `generate`.
|
|
42
|
+
*
|
|
43
|
+
* For credentials nobody needs to know, only the stack itself: the
|
|
44
|
+
* GreptimeDB passwords are read back by the API from the same `.env`, so
|
|
45
|
+
* asking an operator to invent them is friction and a reused password.
|
|
46
|
+
*/
|
|
47
|
+
autoGenerate?: boolean;
|
|
48
|
+
/** Returns a message when the value is unusable, undefined when it is fine. */
|
|
49
|
+
validate?: (value: string) => string | undefined;
|
|
50
|
+
/** Computed from the domain and earlier answers; never prompted for. */
|
|
51
|
+
derive?: (context: DeriveContext) => string | undefined;
|
|
52
|
+
/** Forced for a VPS deployment. Not offered, not overridable by a prompt. */
|
|
53
|
+
fixed?: string;
|
|
54
|
+
/**
|
|
55
|
+
* Only asked when the operator opted into this feature group. A plain
|
|
56
|
+
* string here; the host application narrows it to the groups it knows
|
|
57
|
+
* (the reference CLI's `EnvGroup`) and refuses a fragment naming another.
|
|
58
|
+
*/
|
|
59
|
+
group?: string;
|
|
60
|
+
/** Never written at all, whatever the template says. */
|
|
61
|
+
never?: boolean;
|
|
62
|
+
/**
|
|
63
|
+
* An EMPTY value is an acceptable answer for this key. Blank SKIPS
|
|
64
|
+
* validation; a value that is present must still validate. "Not configured
|
|
65
|
+
* yet" and "configured wrong" are different states, and only the first one
|
|
66
|
+
* is allowed through.
|
|
67
|
+
*/
|
|
68
|
+
allowBlank?: boolean;
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* A named set of key annotations, contributed by a slice or by an app.
|
|
72
|
+
*
|
|
73
|
+
* @stability experimental
|
|
74
|
+
*/
|
|
75
|
+
export interface EnvSpecFragment {
|
|
76
|
+
/** Unique across the process, e.g. `telemetry`. Named in every collision error. */
|
|
77
|
+
id: string;
|
|
78
|
+
/** Annotations by environment key. Keys must be unique across all fragments. */
|
|
79
|
+
metadata: Readonly<Record<string, EnvVarMetadata>>;
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* Registers a fragment of env-key metadata.
|
|
83
|
+
*
|
|
84
|
+
* Throws when a fragment with the same `id` is already registered, or when
|
|
85
|
+
* any of its keys is already owned by another fragment; the message names
|
|
86
|
+
* both owners. Nothing is registered when it throws.
|
|
87
|
+
*
|
|
88
|
+
* @param fragment - The fragment; its `id` and every key must be unique.
|
|
89
|
+
* @stability experimental
|
|
90
|
+
* @extensionPoint registry
|
|
91
|
+
* @example
|
|
92
|
+
* ```ts
|
|
93
|
+
* registerEnvSpecFragment({ id: 'coach', metadata: { COACH_API_TOKEN: { secret: true } } });
|
|
94
|
+
* ```
|
|
95
|
+
*/
|
|
96
|
+
export declare function registerEnvSpecFragment(fragment: EnvSpecFragment): void;
|
|
97
|
+
/**
|
|
98
|
+
* The registered annotation for `key`, or `undefined` when no fragment owns it.
|
|
99
|
+
*
|
|
100
|
+
* @param key - An environment variable name.
|
|
101
|
+
* @returns The owning fragment's metadata for the key.
|
|
102
|
+
* @stability experimental
|
|
103
|
+
*/
|
|
104
|
+
export declare function resolveEnvMetadata(key: string): EnvVarMetadata | undefined;
|
|
105
|
+
/**
|
|
106
|
+
* Every registered fragment, in registration order.
|
|
107
|
+
*
|
|
108
|
+
* @returns A frozen copy of the list.
|
|
109
|
+
* @stability experimental
|
|
110
|
+
*/
|
|
111
|
+
export declare function listEnvSpecFragments(): readonly EnvSpecFragment[];
|
|
112
|
+
/**
|
|
113
|
+
* Empties the registry. For tests only: production code never unregisters.
|
|
114
|
+
*
|
|
115
|
+
* @internal
|
|
116
|
+
* @stability experimental
|
|
117
|
+
*/
|
|
118
|
+
export declare function resetEnvSpecRegistryForTests(): void;
|
|
119
|
+
//# sourceMappingURL=env-spec-registry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"env-spec-registry.d.ts","sourceRoot":"","sources":["../../src/core/env-spec-registry.ts"],"names":[],"mappings":"AAoBA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACjD,wEAAwE;IACxE,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,MAAM,GAAG,SAAS,CAAC;IACxD,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,EAAE,EAAE,MAAM,CAAC;IACX,gFAAgF;IAChF,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;CACpD;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAkBvE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAI1E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,SAAS,eAAe,EAAE,CAEjE;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAGnD"}
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// Env-spec fragment registry (PP-4.5, #706)
|
|
3
|
+
// =============================================================================
|
|
4
|
+
//
|
|
5
|
+
// The deploy wizard gets its QUESTIONS from `.env.example` (the app's
|
|
6
|
+
// `parseEnvExample`). This registry supplies the GOOD question for the keys
|
|
7
|
+
// where it matters: mask it, generate it, validate it, compute it, gate it
|
|
8
|
+
// behind a feature group, or never ask at all. A fragment contributes
|
|
9
|
+
// METADATA for keys the template already declares; it never adds a key.
|
|
10
|
+
//
|
|
11
|
+
// One owner per key. A key claimed by two fragments throws at registration,
|
|
12
|
+
// naming both owners, because a silent "last one wins" would turn a fork's
|
|
13
|
+
// stray entry into a password that is suddenly prompted for, or a secret that
|
|
14
|
+
// is suddenly echoed. A host application that keeps a map of its own
|
|
15
|
+
// registers it as a fragment too, so the same rule covers it.
|
|
16
|
+
//
|
|
17
|
+
// Registration is explicit and grep-able, like the doctor and job registries:
|
|
18
|
+
// nothing here scans the filesystem or runs on import.
|
|
19
|
+
// =============================================================================
|
|
20
|
+
const fragments = [];
|
|
21
|
+
/** Maps each key to the id of the fragment that owns it. */
|
|
22
|
+
const owners = new Map();
|
|
23
|
+
/**
|
|
24
|
+
* Registers a fragment of env-key metadata.
|
|
25
|
+
*
|
|
26
|
+
* Throws when a fragment with the same `id` is already registered, or when
|
|
27
|
+
* any of its keys is already owned by another fragment; the message names
|
|
28
|
+
* both owners. Nothing is registered when it throws.
|
|
29
|
+
*
|
|
30
|
+
* @param fragment - The fragment; its `id` and every key must be unique.
|
|
31
|
+
* @stability experimental
|
|
32
|
+
* @extensionPoint registry
|
|
33
|
+
* @example
|
|
34
|
+
* ```ts
|
|
35
|
+
* registerEnvSpecFragment({ id: 'coach', metadata: { COACH_API_TOKEN: { secret: true } } });
|
|
36
|
+
* ```
|
|
37
|
+
*/
|
|
38
|
+
export function registerEnvSpecFragment(fragment) {
|
|
39
|
+
if (typeof fragment.id !== 'string' || fragment.id.trim() === '') {
|
|
40
|
+
throw new Error('An env-spec fragment needs a non-empty id.');
|
|
41
|
+
}
|
|
42
|
+
if (fragments.some((existing) => existing.id === fragment.id)) {
|
|
43
|
+
throw new Error(`Env-spec fragment "${fragment.id}" is already registered.`);
|
|
44
|
+
}
|
|
45
|
+
for (const key of Object.keys(fragment.metadata)) {
|
|
46
|
+
const owner = owners.get(key);
|
|
47
|
+
if (owner !== undefined) {
|
|
48
|
+
throw new Error(`Env key "${key}" is defined by env-spec fragment "${owner}" and again by "${fragment.id}". ` +
|
|
49
|
+
'A key has exactly one owner: remove it from one of the two.');
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
fragments.push(fragment);
|
|
53
|
+
for (const key of Object.keys(fragment.metadata))
|
|
54
|
+
owners.set(key, fragment.id);
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* The registered annotation for `key`, or `undefined` when no fragment owns it.
|
|
58
|
+
*
|
|
59
|
+
* @param key - An environment variable name.
|
|
60
|
+
* @returns The owning fragment's metadata for the key.
|
|
61
|
+
* @stability experimental
|
|
62
|
+
*/
|
|
63
|
+
export function resolveEnvMetadata(key) {
|
|
64
|
+
const owner = owners.get(key);
|
|
65
|
+
if (owner === undefined)
|
|
66
|
+
return undefined;
|
|
67
|
+
return fragments.find((fragment) => fragment.id === owner)?.metadata[key];
|
|
68
|
+
}
|
|
69
|
+
/**
|
|
70
|
+
* Every registered fragment, in registration order.
|
|
71
|
+
*
|
|
72
|
+
* @returns A frozen copy of the list.
|
|
73
|
+
* @stability experimental
|
|
74
|
+
*/
|
|
75
|
+
export function listEnvSpecFragments() {
|
|
76
|
+
return Object.freeze([...fragments]);
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
* Empties the registry. For tests only: production code never unregisters.
|
|
80
|
+
*
|
|
81
|
+
* @internal
|
|
82
|
+
* @stability experimental
|
|
83
|
+
*/
|
|
84
|
+
export function resetEnvSpecRegistryForTests() {
|
|
85
|
+
fragments.length = 0;
|
|
86
|
+
owners.clear();
|
|
87
|
+
}
|
|
88
|
+
//# sourceMappingURL=env-spec-registry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"env-spec-registry.js","sourceRoot":"","sources":["../../src/core/env-spec-registry.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,6CAA6C;AAC7C,gFAAgF;AAChF,EAAE;AACF,sEAAsE;AACtE,4EAA4E;AAC5E,2EAA2E;AAC3E,sEAAsE;AACtE,wEAAwE;AACxE,EAAE;AACF,4EAA4E;AAC5E,2EAA2E;AAC3E,8EAA8E;AAC9E,qEAAqE;AACrE,8DAA8D;AAC9D,EAAE;AACF,8EAA8E;AAC9E,uDAAuD;AACvD,gFAAgF;AAsFhF,MAAM,SAAS,GAAsB,EAAE,CAAC;AACxC,4DAA4D;AAC5D,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEzC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAyB;IAC/D,IAAI,OAAO,QAAQ,CAAC,EAAE,KAAK,QAAQ,IAAI,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,CAAC,EAAE,0BAA0B,CAAC,CAAC;IAC/E,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,YAAY,GAAG,sCAAsC,KAAK,mBAAmB,QAAQ,CAAC,EAAE,KAAK;gBAC3F,6DAA6D,CAChE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;AACjF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B;IAC1C,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IACrB,MAAM,CAAC,KAAK,EAAE,CAAC;AACjB,CAAC"}
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
import type { GenerateKind } from './env-spec-registry.js';
|
|
2
|
+
/**
|
|
3
|
+
* 32 bytes from the CSPRNG, standard base64 (AES-256 keys, JWT secrets).
|
|
4
|
+
*
|
|
5
|
+
* Never `Math.random`, and never a shelled-out `openssl`: a CLI cannot assume
|
|
6
|
+
* what is installed, and this must behave identically on a minimal container.
|
|
7
|
+
*
|
|
8
|
+
* @returns 44 base64 characters.
|
|
9
|
+
* @stability experimental
|
|
10
|
+
*/
|
|
11
|
+
export declare function generateBase64Key(): string;
|
|
12
|
+
/**
|
|
13
|
+
* 32 bytes from the CSPRNG as 64 lowercase hex characters: `[0-9a-f]` only.
|
|
14
|
+
*
|
|
15
|
+
* @returns 64 hex characters.
|
|
16
|
+
* @stability experimental
|
|
17
|
+
*/
|
|
18
|
+
export declare function generateHexKey(): string;
|
|
19
|
+
/**
|
|
20
|
+
* Generates a value of the given kind.
|
|
21
|
+
*
|
|
22
|
+
* @param kind - `hex-32` or `base64-32`.
|
|
23
|
+
* @returns A fresh random value.
|
|
24
|
+
* @stability experimental
|
|
25
|
+
*/
|
|
26
|
+
export declare function generateValue(kind: GenerateKind): string;
|
|
27
|
+
/**
|
|
28
|
+
* True when a value is still a template placeholder rather than something
|
|
29
|
+
* anybody chose: the template's own default for the key, or the `change-me` /
|
|
30
|
+
* `your-` spellings `.env.example` uses for credentials.
|
|
31
|
+
*
|
|
32
|
+
* @param value - The current value.
|
|
33
|
+
* @param templateDefault - The template's default for the key, if any.
|
|
34
|
+
* @returns Whether the value is a placeholder.
|
|
35
|
+
* @stability experimental
|
|
36
|
+
*/
|
|
37
|
+
export declare function isPlaceholderValue(value: string, templateDefault?: string): boolean;
|
|
38
|
+
/**
|
|
39
|
+
* Whether an `autoGenerate` key's current value must be replaced: it is
|
|
40
|
+
* missing, blank or still a placeholder. A real value is never replaced.
|
|
41
|
+
*
|
|
42
|
+
* @param current - The current value, `undefined` when the key is absent.
|
|
43
|
+
* @param templateDefault - The template's default for the key, if any.
|
|
44
|
+
* @returns Whether to generate a new value.
|
|
45
|
+
* @stability experimental
|
|
46
|
+
*/
|
|
47
|
+
export declare function needsAutoGenerate(current: string | undefined, templateDefault?: string): boolean;
|
|
48
|
+
/**
|
|
49
|
+
* AES-256 needs exactly 32 bytes. A key that merely LOOKS like base64 passes
|
|
50
|
+
* startup and then fails the first time a credential is saved, which is a long
|
|
51
|
+
* way from where the mistake was made. Empty is allowed: the API boots without
|
|
52
|
+
* the key and only refuses to SAVE a credential.
|
|
53
|
+
*
|
|
54
|
+
* @param value - The candidate key.
|
|
55
|
+
* @returns A message when the value is unusable, `undefined` when it is fine.
|
|
56
|
+
* @stability experimental
|
|
57
|
+
*/
|
|
58
|
+
export declare function validateBase64Key32(value: string): string | undefined;
|
|
59
|
+
/**
|
|
60
|
+
* Accepts an email address.
|
|
61
|
+
*
|
|
62
|
+
* @param value - The candidate address.
|
|
63
|
+
* @returns A message when the value is not an address, `undefined` when it is.
|
|
64
|
+
* @stability experimental
|
|
65
|
+
*/
|
|
66
|
+
export declare function validateEmail(value: string): string | undefined;
|
|
67
|
+
/**
|
|
68
|
+
* Accepts a TCP port number, 1 to 65535.
|
|
69
|
+
*
|
|
70
|
+
* @param value - The candidate port.
|
|
71
|
+
* @returns A message when the value is not a port, `undefined` when it is.
|
|
72
|
+
* @stability experimental
|
|
73
|
+
*/
|
|
74
|
+
export declare function validatePort(value: string): string | undefined;
|
|
75
|
+
//# sourceMappingURL=env-values.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"env-values.d.ts","sourceRoot":"","sources":["../../src/core/env-values.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAY3D;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAExD;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAKnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAEhG;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAkBrE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK9D"}
|