@cpajs/cpa 0.1.0-rc.2 → 0.1.0-rc.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/README.md CHANGED
@@ -27,7 +27,6 @@ import { startServer } from '@cpajs/cpa/server';
27
27
 
28
28
  const server = await startServer({
29
29
  stateDir: './.cpa', // omit for a temporary directory that is removed on stop
30
- management: { key: process.env.CPA_MANAGEMENT_KEY! },
31
30
  config: { // native v8 config, typed as CpaConfig
32
31
  access: { 'api-keys': ['sk-my-model-key'] },
33
32
  routing: { strategy: 'fill-first' },
@@ -38,6 +37,10 @@ const server = await startServer({
38
37
  console.log(server.origin); // http://127.0.0.1:40123 (a free port is picked by default)
39
38
  console.log(server.baseUrl); // http://127.0.0.1:40123/v1 for OpenAI-compatible SDKs
40
39
 
40
+ // Management API client, already bound to this server and a key generated for this start.
41
+ const client = server.client();
42
+ await client.credentials.list();
43
+
41
44
  await server.stop();
42
45
  ```
43
46
 
@@ -45,7 +48,7 @@ await server.stop();
45
48
  - `config` is written as YAML to `<stateDir>/config.yaml` only when that file does not exist yet. On later
46
49
  starts the existing file is reused, so changes made through the management API (or by CPA itself) survive
47
50
  `stop()` and `startServer()`. Pass `overwriteConfig: true` to replace it; when a file is kept, `config`, `host`
48
- and `port` are not applied and a message is emitted through `onLog`. Credentials go to `<stateDir>/auths`
51
+ and `port` are not applied and a `configReused` warning is emitted. Credentials go to `<stateDir>/auths`
49
52
  unless `oauth.auth-dir` is set. The server binds `127.0.0.1` unless you pass `host` or set `server.host`.
50
53
  - `configPath` hands an existing file to CPA unchanged. CPA may rewrite it on startup: it hashes a plaintext
51
54
  `management.secret-key`, removes legacy keys that conflict with their v8 equivalents, and normalizes the
@@ -81,7 +84,7 @@ await server.stop();
81
84
  - Windows: no launcher is needed, because Node already kills child processes with their parent.
82
85
 
83
86
  Pass `launcher: false` to start CPA directly. With a custom `binaryPath`, the launcher is looked up next to
84
- that binary and then in the installed platform package; if none is found, a notice is logged. A graceful stop
87
+ that binary and then in the installed platform package; if none is found, CPA starts directly. A graceful stop
85
88
  is still nicer than a kill, and `stopAllServers()` stops every server this process started:
86
89
 
87
90
  ```ts
@@ -96,9 +99,17 @@ await server.stop();
96
99
  ```
97
100
 
98
101
  Lines longer than 64 KiB in CPA's output are truncated, with a marker saying how much was dropped.
99
- - `management: { key }` manages the management API key. The default mode writes a bcrypt hash into
100
- `management.secret-key` of the managed config and sets `management.allow-remote` from `allowRemote`
101
- (default `false`), so the plaintext never reaches disk and remote management stays off.
102
+ - Management key: you usually don't need one. Without `management`, cpajs generates a random key for each start,
103
+ writes only its bcrypt hash into the managed config (remote management off), keeps the plaintext in memory,
104
+ and gives you `server.client()`: a management client bound to this server. The key is never exposed, and
105
+ because nobody types it, it can never be wrong and trigger CPA's 30-minute IP ban. `restart()` keeps the key,
106
+ so existing clients keep working; a new `startServer()` generates a new one. `management: false` turns the
107
+ management API off.
108
+
109
+ Pass a key yourself only when something else needs it, for example a remote admin tool or another process:
110
+ `management: { key }`. The default mode writes a bcrypt hash into `management.secret-key` of the managed config
111
+ and sets `management.allow-remote` from `allowRemote` (default `false`), so the plaintext never reaches disk
112
+ and remote management stays off. `server.client()` works there too.
102
113
 
103
114
  Redaction: the key, secrets found in the config when the server starts, and `redact` values are replaced with
104
115
  `[REDACTED]` in `onLog`, `recentLogs` and startup errors. This is best-effort, with known limits:
@@ -109,14 +120,16 @@ await server.stop();
109
120
 
110
121
  Do not treat CPA's output as safe to publish.
111
122
 
112
- | Mode | How CPA compares the key | Remote access |
113
- | --- | --- | --- |
114
- | `management: { key }` (default) | bcrypt hash in `management.secret-key` | Written from `allowRemote`, default `false` |
115
- | `management: { key, allowRemote: true }` | bcrypt hash in `management.secret-key` | Non-loopback clients allowed |
116
- | `management: { key, viaEnvironment: true }` | Plaintext `MANAGEMENT_PASSWORD` | Always allowed: upstream treats the variable as `allow-remote: true` |
117
- | `config.management['secret-key']` | What you write; CPA hashes plaintext on startup | `config.management['allow-remote']` |
118
- | `configPath` | `secret-key` in the file | `allow-remote` in the file |
119
- | `managementKey` (deprecated) | bcrypt hash, same as the default | Same as the default; it no longer opens remote access |
123
+ | Mode | How CPA compares the key | Remote access | `server.client()` |
124
+ | --- | --- | --- | --- |
125
+ | omitted (default) | bcrypt hash of a key generated per start | Off | Yes |
126
+ | `management: false` | — (management API disabled) | — | No |
127
+ | `management: { key }` | bcrypt hash in `management.secret-key` | Written from `allowRemote`, default `false` | Yes |
128
+ | `management: { key, allowRemote: true }` | bcrypt hash in `management.secret-key` | Non-loopback clients allowed | Yes |
129
+ | `management: { key, viaEnvironment: true }` | Plaintext `MANAGEMENT_PASSWORD` | Always allowed: upstream treats the variable as `allow-remote: true` | Yes |
130
+ | `config.management['secret-key']` | What you write; CPA hashes plaintext on startup | `config.management['allow-remote']` | No: the key is yours |
131
+ | `configPath` | `secret-key` in the file | `allow-remote` in the file | Only with `management: { key, viaEnvironment: true }` |
132
+ | `managementKey` (deprecated) | bcrypt hash, same as `management: { key }` | Off unless the file allows it | Yes |
120
133
 
121
134
  `management.key` is rejected together with `config.management['secret-key']`, or with a `secret-key`
122
135
  already present in `configPath`. In `configPath` mode it also requires `viaEnvironment: true`, because
@@ -126,11 +139,29 @@ await server.stop();
126
139
  environment is always removed, and setting it in `env` is rejected. Otherwise it would quietly add a
127
140
  plaintext key and turn remote management on.
128
141
 
129
- `viaEnvironment: true` always emits a warning through `onLog`, because the key is compared in plaintext and
130
- remote management cannot be turned off. `allowRemote: true` emits one when the bind host is not loopback.
131
- These are warnings, not errors, because both are explicit choices.
142
+ `viaEnvironment: true` always emits the `managementViaEnvironment` warning, because the key is compared in
143
+ plaintext and remote management cannot be turned off. `allowRemote: true` emits `remoteManagementExposed` when
144
+ the bind host is not loopback. These are warnings, not errors, because both are explicit choices.
145
+
146
+ The server handle never exposes the key; `server.client()` exposes the capability instead. To connect from
147
+ elsewhere, pass your own key to `createClient`.
148
+ - Warnings: cpajs reports things worth knowing as coded warnings, separate from CPA's output (`onLog`). By
149
+ default they go through `process.emitWarning` as `CpaWarning`, so they appear on stderr and work with Node's
150
+ usual handling (`--no-warnings`, `process.on('warning')`). Pass `onWarning` to route them yourself. Pass
151
+ `suppressWarnings` to silence individual ones; every message names the field that silences it.
152
+
153
+ ```ts
154
+ await startServer({ config, suppressWarnings: { noManagementKey: true } });
155
+ ```
156
+
157
+ | Code | Emitted when |
158
+ | --- | --- |
159
+ | `noManagementKey` | No `management` was given, so a key was generated for this start (use `server.client()`) |
160
+ | `managementViaEnvironment` | `management.viaEnvironment` is used: plaintext comparison, remote management forced on |
161
+ | `remoteManagementExposed` | `allowRemote` is on and the server binds a non-loopback host |
162
+ | `configReused` | An existing managed config was kept; this start's `config`, `host` and `port` were not applied |
163
+ | `managementKeyUpdated` | A reused config's management key was replaced for a new `management.key` |
132
164
 
133
- The server handle does not expose the key. Keep it in your own code and pass it to `createClient`.
134
165
  - CLI flags are typed options:
135
166
  - `localModel: true` → `-local-model`, which uses the embedded model catalogs.
136
167
  - `home: { jwt, disableClusterDiscovery }` → Home mode. The JWT is passed through `HOME_JWT`, so it never appears in argv.
@@ -7,6 +7,7 @@ export { TARGETS, NPM_SCOPE, UNSUPPORTED_PLATFORMS, binaryName, packageName } fr
7
7
  export { CPA_RELEASE } from './cpa-version.ts';
8
8
  export type { Target, TargetBuild, TargetVerification } from './targets.ts';
9
9
  export type * from './types.ts';
10
+ export type { CpaWarning, CpaWarningCode, SuppressWarnings } from './warnings.ts';
10
11
  export type { CpaConfig } from '../client/types/config.ts';
11
12
  /**
12
13
  * Starts the official CLIProxyAPI binary and resolves once `/healthz` answers.
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAA2B,kBAAkB,EAA0B,WAAW,EAAE,MAAM,YAAY,CAAC;AAE1I,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3F,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAClG,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC5E,mBAAmB,YAAY,CAAC;AAChC,YAAY,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAgL3D;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,SAAS,CAAC,CAsLtF;AAyMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAErF"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAgD,kBAAkB,EAA0B,WAAW,EAAE,MAAM,YAAY,CAAC;AAG/J,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3F,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAClG,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC5E,mBAAmB,YAAY,CAAC;AAChC,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAClF,YAAY,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAqL3D;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,SAAS,CAAC,CAqLtF;AAiND;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAErF"}
@@ -11,6 +11,8 @@ import { ManagedProcess } from './process.js';
11
11
  import { connectHost, findFreePort, formatOrigin, isLoopbackHost, isPortFree, probeHealth } from './readiness.js';
12
12
  import { internalCommand } from './internal.js';
13
13
  import { createRedactor } from './redact.js';
14
+ import { createWarner } from './warnings.js';
15
+ import { createClient } from '../client/index.js';
14
16
  export { candidateTargets, currentPlatform, detectLibc, resolveBinary } from './binary.js';
15
17
  export { CpaBinaryError, CpaStartError } from './errors.js';
16
18
  export { TARGETS, NPM_SCOPE, UNSUPPORTED_PLATFORMS, binaryName, packageName } from './targets.js';
@@ -37,21 +39,26 @@ function validate(options) {
37
39
  if (options.management !== undefined && options.managementKey !== undefined) {
38
40
  throw new CpaStartError('invalid-options', 'management and managementKey are mutually exclusive; managementKey is the deprecated alias for management.key.');
39
41
  }
42
+ if (options.management === false && options.managementKey !== undefined) {
43
+ throw new CpaStartError('invalid-options', 'management: false disables the management API; do not also pass managementKey.');
44
+ }
40
45
  if (options.management !== undefined &&
46
+ options.management !== false &&
41
47
  (typeof options.management.key !== 'string' || options.management.key.trim() === '')) {
42
48
  throw new CpaStartError('invalid-options', 'management.key must not be empty.');
43
49
  }
44
50
  if (typeof options.managementKey === 'string' && options.managementKey.trim() === '') {
45
51
  throw new CpaStartError('invalid-options', 'managementKey must not be empty.');
46
52
  }
47
- if (options.management?.viaEnvironment !== true && options.env?.MANAGEMENT_PASSWORD !== undefined) {
53
+ const viaEnvironment = options.management !== false && options.management?.viaEnvironment === true;
54
+ if (!viaEnvironment && options.env?.MANAGEMENT_PASSWORD !== undefined) {
48
55
  throw new CpaStartError('invalid-options', 'Do not set MANAGEMENT_PASSWORD in env: cpajs only passes it to CPA for management: { key, viaEnvironment: true }, because upstream treats it as enabling remote management.');
49
56
  }
50
- const requestedKey = options.management?.key ?? options.managementKey;
57
+ const requestedKey = (options.management === false ? undefined : options.management?.key) ?? options.managementKey;
51
58
  if (requestedKey === undefined)
52
59
  return;
53
60
  if (options.configPath !== undefined) {
54
- if (options.management?.viaEnvironment !== true) {
61
+ if (!viaEnvironment) {
55
62
  throw new CpaStartError('invalid-options', 'management.key cannot be combined with configPath because cpajs must not edit your config file. Put management.secret-key in the file, or use management.viaEnvironment: true to pass the key through MANAGEMENT_PASSWORD (which also enables remote management).');
56
63
  }
57
64
  return;
@@ -178,11 +185,9 @@ export async function startServer(options = {}) {
178
185
  if (launcher?.mode === 'exec')
179
186
  env.CPAJS_PARENT_PID = String(process.pid);
180
187
  const extraArgs = buildArgs(options);
181
- if (launcher === undefined && options.launcher !== false && command === undefined && process.platform !== 'win32') {
182
- options.onLog?.({
183
- stream: 'stderr',
184
- line: `cpajs: notice: no cpa-launcher found for ${binary.path}; CPA will keep running if this process is killed. Pass launcher: false to silence this.`,
185
- });
188
+ const warn = createWarner(options);
189
+ if (management.generated) {
190
+ warn('noManagementKey', 'No management key given: generated one for this start (only its bcrypt hash is stored). Use server.client() for the management API, management: { key } to choose the key, or management: false to disable it.');
186
191
  }
187
192
  const ownsStateDir = options.stateDir === undefined;
188
193
  const stateDir = ownsStateDir ? await mkdtemp(join(tmpdir(), 'cpajs-')) : resolve(options.stateDir);
@@ -199,10 +204,8 @@ export async function startServer(options = {}) {
199
204
  const managedSecret = management.secretKeyHash === undefined
200
205
  ? undefined
201
206
  : { secretKeyHash: management.secretKeyHash, allowRemote: management.allowRemote };
202
- let warnedRemote = false;
203
207
  let reservation;
204
208
  let wroteConfig = false;
205
- let announcedReuse = false;
206
209
  try {
207
210
  for (let attempt = 1;; attempt++) {
208
211
  let prepared;
@@ -226,18 +229,12 @@ export async function startServer(options = {}) {
226
229
  !(await keyMatches(management.key, existing.management.secretKey)))) {
227
230
  await updateManagedSecret(existing.configPath, managedSecret);
228
231
  prepared = (await readManagedConfig(stateDir));
229
- options.onLog?.({
230
- stream: 'stdout',
231
- line: `Updated management.secret-key / allow-remote in ${existing.configPath} for the management key of this start.`,
232
- });
233
- }
234
- if (!announcedReuse) {
235
- announcedReuse = true;
236
- options.onLog?.({
237
- stream: 'stdout',
238
- line: `Keeping existing config at ${existing.configPath}; pass overwriteConfig: true to replace it.`,
239
- });
232
+ // A generated key changes on every start; only a caller's key change is news.
233
+ if (!management.generated) {
234
+ warn('managementKeyUpdated', `Replaced management.secret-key / allow-remote in ${existing.configPath} for the management key of this start.`);
235
+ }
240
236
  }
237
+ warn('configReused', `Kept the existing config at ${existing.configPath}; this start's config, host and port were not applied. Pass overwriteConfig: true to replace it.`);
241
238
  }
242
239
  else {
243
240
  const listen = configListen(options);
@@ -251,23 +248,14 @@ export async function startServer(options = {}) {
251
248
  }
252
249
  }
253
250
  const { host, port, tls } = prepared.listen;
254
- if (!warnedRemote) {
255
- warnedRemote = true;
256
- const target = host === '' ? 'all interfaces' : host;
257
- const exposed = !isLoopbackHost(host);
258
- if (management.viaEnvironment) {
259
- options.onLog?.({
260
- stream: 'stderr',
261
- line: 'cpajs: warning: management.viaEnvironment passes the key through MANAGEMENT_PASSWORD, which upstream compares in plaintext and which always enables remote management' +
262
- (exposed ? `; the server binds ${target}, so the management API is reachable from non-loopback clients.` : '.'),
263
- });
264
- }
265
- else if (prepared.management.allowRemote && exposed) {
266
- options.onLog?.({
267
- stream: 'stderr',
268
- line: `cpajs: warning: management.allow-remote is true and the server binds ${target}, so the management API is reachable from non-loopback clients.`,
269
- });
270
- }
251
+ const target = host === '' ? 'all interfaces' : host;
252
+ const exposed = !isLoopbackHost(host);
253
+ if (management.viaEnvironment) {
254
+ warn('managementViaEnvironment', 'management.viaEnvironment passes the key through MANAGEMENT_PASSWORD, which upstream compares in plaintext and which always enables remote management' +
255
+ (exposed ? `; the server binds ${target}, so the management API is reachable from non-loopback clients.` : '.'));
256
+ }
257
+ else if (prepared.management.allowRemote && exposed) {
258
+ warn('remoteManagementExposed', `management.allow-remote is true and the server binds ${target}, so the management API is reachable from non-loopback clients.`);
271
259
  }
272
260
  const redact = createRedactor([management.key, options.home?.jwt, ...prepared.secrets, ...(options.redact ?? [])]);
273
261
  if (!dynamicPort && !(await isPortFree(host, port))) {
@@ -300,6 +288,12 @@ export async function startServer(options = {}) {
300
288
  if (result.kind === 'ready') {
301
289
  return createHandle(result.proc, {
302
290
  binaryPath: binary.path,
291
+ managementKey: management.key,
292
+ noClientReason: options.management === false
293
+ ? 'the management API is disabled (management: false)'
294
+ : options.configPath !== undefined
295
+ ? 'with configPath, cpajs does not know the key; pass management: { key, viaEnvironment: true } or create a client with your own key'
296
+ : "config.management['secret-key'] is set, so the key is yours; create a client with it",
303
297
  spawnPath,
304
298
  supervised,
305
299
  prefixArgs,
@@ -491,6 +485,11 @@ function createHandle(initialProc, info) {
491
485
  exited,
492
486
  stop,
493
487
  restart,
488
+ client(clientOptions = {}) {
489
+ if (info.managementKey === undefined)
490
+ throw new Error(`server.client() is unavailable: ${info.noClientReason}.`);
491
+ return createClient({ ...clientOptions, baseUrl: info.origin, managementKey: info.managementKey });
492
+ },
494
493
  };
495
494
  liveServers.add(handle);
496
495
  return handle;
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"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"}
@@ -2,8 +2,10 @@ import type { ManagementOptions } from './types.ts';
2
2
  /** bcrypt cost; matches upstream's `bcrypt.DefaultCost` (about 50-100 ms per hash). */
3
3
  export declare const BCRYPT_COST = 10;
4
4
  export interface ResolvedManagement {
5
- /** The plaintext key, when the caller supplied one. */
5
+ /** The plaintext key: supplied by the caller or generated for this start. */
6
6
  key: string | undefined;
7
+ /** True when cpajs generated the key because none was given. */
8
+ generated: boolean;
7
9
  /** True when the key travels through `MANAGEMENT_PASSWORD`. */
8
10
  viaEnvironment: boolean;
9
11
  /** Value for `management.allow-remote` in a managed config. */
@@ -17,8 +19,14 @@ export interface ResolvedManagement {
17
19
  * the old `MANAGEMENT_PASSWORD` behaviour.
18
20
  */
19
21
  export declare function resolveManagement(options: {
20
- management?: ManagementOptions;
22
+ management?: ManagementOptions | false;
21
23
  managementKey?: string;
24
+ configPath?: string;
25
+ config?: {
26
+ management?: {
27
+ 'secret-key'?: unknown;
28
+ };
29
+ };
22
30
  }): Promise<ResolvedManagement>;
23
31
  /**
24
32
  * True when `stored` (a `management.secret-key` value) authenticates `key` the
@@ -1 +1 @@
1
- {"version":3,"file":"management.d.ts","sourceRoot":"","sources":["../../src/server/management.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,uFAAuF;AACvF,eAAO,MAAM,WAAW,KAAK,CAAC;AAM9B,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,+DAA+D;IAC/D,cAAc,EAAE,OAAO,CAAC;IACxB,+DAA+D;IAC/D,WAAW,EAAE,OAAO,CAAC;IACrB,mEAAmE;IACnE,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8C9B;AAID;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAG1F"}
1
+ {"version":3,"file":"management.d.ts","sourceRoot":"","sources":["../../src/server/management.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,uFAAuF;AACvF,eAAO,MAAM,WAAW,KAAK,CAAC;AAM9B,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,gEAAgE;IAChE,SAAS,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,cAAc,EAAE,OAAO,CAAC;IACxB,+DAA+D;IAC/D,WAAW,EAAE,OAAO,CAAC;IACrB,mEAAmE;IACnE,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,UAAU,CAAC,EAAE,iBAAiB,GAAG,KAAK,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE;YAAE,YAAY,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,CAAC;CACtD,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAmD9B;AAID;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAG1F"}
@@ -1,3 +1,4 @@
1
+ import { randomBytes } from 'node:crypto';
1
2
  import { compare, hash } from 'bcryptjs';
2
3
  import { CpaStartError } from './errors.js';
3
4
  /** bcrypt cost; matches upstream's `bcrypt.DefaultCost` (about 50-100 ms per hash). */
@@ -11,17 +12,22 @@ const MAX_BCRYPT_BYTES = 72;
11
12
  * the old `MANAGEMENT_PASSWORD` behaviour.
12
13
  */
13
14
  export async function resolveManagement(options) {
15
+ const none = { key: undefined, generated: false, viaEnvironment: false, allowRemote: false, secretKeyHash: undefined };
16
+ if (options.management === false)
17
+ return none;
14
18
  if (options.management !== undefined && options.managementKey !== undefined) {
15
19
  throw new CpaStartError('invalid-options', 'management and managementKey are mutually exclusive; managementKey is the deprecated alias for management.key.');
16
20
  }
17
21
  const management = options.management ?? (options.managementKey === undefined ? undefined : { key: options.managementKey });
18
22
  if (management === undefined) {
19
- return {
20
- key: undefined,
21
- viaEnvironment: false,
22
- allowRemote: false,
23
- secretKeyHash: undefined,
24
- };
23
+ // No key given: generate one for this start so server.client() works, unless the
24
+ // caller manages the secret itself (configPath, or secret-key in config), where
25
+ // cpajs cannot know or must not write the key.
26
+ const ownSecret = options.config?.management?.['secret-key'];
27
+ if (options.configPath !== undefined || (typeof ownSecret === 'string' && ownSecret.trim() !== ''))
28
+ return none;
29
+ const key = randomBytes(32).toString('base64url');
30
+ return { key, generated: true, viaEnvironment: false, allowRemote: false, secretKeyHash: await hash(key, BCRYPT_COST) };
25
31
  }
26
32
  const key = management.key;
27
33
  if (typeof key !== 'string' || key.trim() === '') {
@@ -35,6 +41,7 @@ export async function resolveManagement(options) {
35
41
  }
36
42
  return {
37
43
  key,
44
+ generated: false,
38
45
  viaEnvironment: true,
39
46
  allowRemote: management.allowRemote === true,
40
47
  secretKeyHash: undefined,
@@ -45,6 +52,7 @@ export async function resolveManagement(options) {
45
52
  }
46
53
  return {
47
54
  key,
55
+ generated: false,
48
56
  viaEnvironment: false,
49
57
  allowRemote: management.allowRemote === true,
50
58
  secretKeyHash: await hash(key, BCRYPT_COST),
@@ -1 +1 @@
1
- {"version":3,"file":"management.js","sourceRoot":"","sources":["../../src/server/management.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,uFAAuF;AACvF,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAE9B,+EAA+E;AAC/E,wEAAwE;AACxE,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAa5B;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAGvC;IACC,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QAC5E,MAAM,IAAI,aAAa,CACrB,iBAAiB,EACjB,gHAAgH,CACjH,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GACd,OAAO,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC3G,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO;YACL,GAAG,EAAE,SAAS;YACd,cAAc,EAAE,KAAK;YACrB,WAAW,EAAE,KAAK;YAClB,aAAa,EAAE,SAAS;SACzB,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC;IAC3B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACjD,MAAM,IAAI,aAAa,CAAC,iBAAiB,EAAE,mCAAmC,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,UAAU,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;QACvC,2EAA2E;QAC3E,6DAA6D;QAC7D,IAAI,GAAG,KAAK,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;YACvB,MAAM,IAAI,aAAa,CAAC,iBAAiB,EAAE,mFAAmF,CAAC,CAAC;QAClI,CAAC;QACD,OAAO;YACL,GAAG;YACH,cAAc,EAAE,IAAI;YACpB,WAAW,EAAE,UAAU,CAAC,WAAW,KAAK,IAAI;YAC5C,aAAa,EAAE,SAAS;SACzB,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,gBAAgB,EAAE,CAAC;QACtD,MAAM,IAAI,aAAa,CACrB,iBAAiB,EACjB,iCAAiC,gBAAgB,8FAA8F,CAChJ,CAAC;IACJ,CAAC;IACD,OAAO;QACL,GAAG;QACH,cAAc,EAAE,KAAK;QACrB,WAAW,EAAE,UAAU,CAAC,WAAW,KAAK,IAAI;QAC5C,aAAa,EAAE,MAAM,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,WAAW,GAAG,aAAa,CAAC;AAElC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW,EAAE,MAA0B;IACtE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC;AAC1E,CAAC"}
1
+ {"version":3,"file":"management.js","sourceRoot":"","sources":["../../src/server/management.ts"],"names":[],"mappings":"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"}
@@ -1,10 +1,14 @@
1
1
  import type { ChildProcess } from 'node:child_process';
2
+ import type { CpaClient, ClientOptions } from '../client/index.ts';
2
3
  import type { CpaConfig } from '../client/types/config.ts';
4
+ import type { CpaWarning, SuppressWarnings } from './warnings.ts';
3
5
  export interface LogLine {
4
6
  stream: 'stdout' | 'stderr';
5
7
  /** One line of output with secrets redacted and the trailing newline removed. */
6
8
  line: string;
7
9
  }
10
+ /** Options for `server.client()`: everything except the origin and the key. */
11
+ export type ServerClientOptions = Omit<ClientOptions, 'baseUrl' | 'managementKey'>;
8
12
  export interface HomeOptions {
9
13
  /**
10
14
  * Home control plane JWT (`-home-jwt`). It is passed through the `HOME_JWT`
@@ -39,8 +43,16 @@ interface CommonServerOptions {
39
43
  * directory. When omitted, a temporary directory is created and removed on stop.
40
44
  */
41
45
  stateDir?: string;
42
- /** Management API key and how it reaches CPA. */
43
- management?: ManagementOptions;
46
+ /**
47
+ * Management API key and how it reaches CPA.
48
+ *
49
+ * Omitted: cpajs generates a random key for this start, writes only its bcrypt
50
+ * hash into the managed config (remote management off) and keeps the plaintext
51
+ * in memory; use `server.client()` to talk to the management API. Not done in
52
+ * `configPath` mode or when `config.management['secret-key']` is set, because
53
+ * then the secret is yours. `false`: the management API stays disabled.
54
+ */
55
+ management?: ManagementOptions | false;
44
56
  /**
45
57
  * Deprecated alias for `management: { key }`. It uses the safe default
46
58
  * (bcrypt hash in the config, remote management disabled) and will be removed
@@ -85,7 +97,17 @@ interface CommonServerOptions {
85
97
  startupTimeoutMs?: number;
86
98
  /** Cancels startup. After startup it has no effect; call `stop()` instead. */
87
99
  signal?: AbortSignal;
88
- /** Receives every output line, redacted. */
100
+ /**
101
+ * Silences individual cpajs warnings, e.g. `{ noManagementKey: true }`. Every
102
+ * warning message names the field that silences it.
103
+ */
104
+ suppressWarnings?: SuppressWarnings;
105
+ /**
106
+ * Receives cpajs warnings instead of `process.emitWarning` (which prints them
107
+ * to stderr as `CpaWarning`). CPA's own output goes to `onLog`.
108
+ */
109
+ onWarning?: (warning: CpaWarning) => void;
110
+ /** Receives every line CPA prints, redacted. */
89
111
  onLog?: (log: LogLine) => void;
90
112
  /** Additional strings to redact from logs and errors. */
91
113
  redact?: readonly string[];
@@ -170,6 +192,13 @@ export interface CpaServer {
170
192
  * terminated forcefully (there is no grace period and CPA is not asked to
171
193
  * flush state or update auth files). Idempotent.
172
194
  */
195
+ /**
196
+ * A management API client already bound to this server's origin and key. The
197
+ * key itself is not exposed. Works when cpajs knows the plaintext key (generated,
198
+ * or passed as `management.key`); throws otherwise, e.g. with `configPath` or a
199
+ * `secret-key` you put in `config` yourself.
200
+ */
201
+ client(options?: ServerClientOptions): CpaClient;
173
202
  stop(options?: StopOptions): Promise<ExitResult>;
174
203
  /**
175
204
  * Restarts CPA with the original options, reusing `origin`, `baseUrl`, `host`,
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,32 @@
1
+ /**
2
+ * Warnings emitted by cpajs itself (not CPA's output, which goes to `onLog`).
3
+ * Each has a stable code that can be suppressed individually.
4
+ */
5
+ export type CpaWarningCode =
6
+ /** No management key was given, so one was generated for this start. */
7
+ 'noManagementKey'
8
+ /** `management.viaEnvironment`: plaintext comparison, and remote management is forced on. */
9
+ | 'managementViaEnvironment'
10
+ /** `management.allow-remote` is on and the server binds a non-loopback host. */
11
+ | 'remoteManagementExposed'
12
+ /** No cpa-launcher was found, so CPA can outlive this process. */
13
+ /** An existing managed config was kept; this start's `config`, `host` and `port` were not applied. */
14
+ | 'configReused'
15
+ /** The management key in a reused config was replaced with the hash of a new key. */
16
+ | 'managementKeyUpdated';
17
+ export interface CpaWarning {
18
+ code: CpaWarningCode;
19
+ message: string;
20
+ }
21
+ /** `{ noManagementKey: true }` silences that warning. */
22
+ export type SuppressWarnings = Partial<Record<CpaWarningCode, boolean>>;
23
+ /**
24
+ * Returns a function that emits each warning code at most once: to `onWarning`
25
+ * when given, otherwise through `process.emitWarning` (type `CpaWarning`), so it
26
+ * shows up on stderr by default and works with Node's usual warning handling.
27
+ */
28
+ export declare function createWarner(options: {
29
+ suppressWarnings?: SuppressWarnings | undefined;
30
+ onWarning?: ((warning: CpaWarning) => void) | undefined;
31
+ }): (code: CpaWarningCode, message: string) => void;
32
+ //# sourceMappingURL=warnings.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"warnings.d.ts","sourceRoot":"","sources":["../../src/server/warnings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,cAAc;AACxB,wEAAwE;AACtE,iBAAiB;AACnB,6FAA6F;GAC3F,0BAA0B;AAC5B,gFAAgF;GAC9E,yBAAyB;AAC3B,kEAAkE;AAClE,sGAAsG;GACpG,cAAc;AAChB,qFAAqF;GACnF,sBAAsB,CAAC;AAE3B,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,yDAAyD;AACzD,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;AAExE;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAChD,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACzD,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CASlD"}
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Returns a function that emits each warning code at most once: to `onWarning`
3
+ * when given, otherwise through `process.emitWarning` (type `CpaWarning`), so it
4
+ * shows up on stderr by default and works with Node's usual warning handling.
5
+ */
6
+ export function createWarner(options) {
7
+ const emitted = new Set();
8
+ return (code, message) => {
9
+ if (options.suppressWarnings?.[code] === true || emitted.has(code))
10
+ return;
11
+ emitted.add(code);
12
+ const warning = { code, message: `${message} (suppress with suppressWarnings.${code})` };
13
+ if (options.onWarning)
14
+ options.onWarning(warning);
15
+ else
16
+ process.emitWarning(warning.message, { type: 'CpaWarning', code });
17
+ };
18
+ }
19
+ //# sourceMappingURL=warnings.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"warnings.js","sourceRoot":"","sources":["../../src/server/warnings.ts"],"names":[],"mappings":"AAyBA;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,OAG5B;IACC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;QACvB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QAC3E,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,MAAM,OAAO,GAAe,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,oCAAoC,IAAI,GAAG,EAAE,CAAC;QACrG,IAAI,OAAO,CAAC,SAAS;YAAE,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;;YAC7C,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1E,CAAC,CAAC;AACJ,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cpajs/cpa",
3
- "version": "0.1.0-rc.2",
3
+ "version": "0.1.0-rc.3",
4
4
  "description": "Run the official CLIProxyAPI from JavaScript and talk to its v8 management API with a typed client",
5
5
  "license": "MIT",
6
6
  "author": "akarachen",
@@ -65,28 +65,28 @@
65
65
  "access": "public"
66
66
  },
67
67
  "optionalDependencies": {
68
- "@cpajs/darwin-x64": "0.1.0-rc.2",
69
- "@cpajs/darwin-arm64": "0.1.0-rc.2",
70
- "@cpajs/win32-x64": "0.1.0-rc.2",
71
- "@cpajs/win32-arm64": "0.1.0-rc.2",
72
- "@cpajs/win32-ia32": "0.1.0-rc.2",
73
- "@cpajs/linux-x64-gnu": "0.1.0-rc.2",
74
- "@cpajs/linux-arm64-gnu": "0.1.0-rc.2",
75
- "@cpajs/linux-x64-musl": "0.1.0-rc.2",
76
- "@cpajs/linux-arm64-musl": "0.1.0-rc.2",
77
- "@cpajs/linux-arm": "0.1.0-rc.2",
78
- "@cpajs/linux-ia32": "0.1.0-rc.2",
79
- "@cpajs/linux-riscv64": "0.1.0-rc.2",
80
- "@cpajs/linux-ppc64": "0.1.0-rc.2",
81
- "@cpajs/linux-s390x": "0.1.0-rc.2",
82
- "@cpajs/linux-loong64": "0.1.0-rc.2",
83
- "@cpajs/linux-mips": "0.1.0-rc.2",
84
- "@cpajs/linux-mipsel": "0.1.0-rc.2",
85
- "@cpajs/freebsd-x64": "0.1.0-rc.2",
86
- "@cpajs/freebsd-arm64": "0.1.0-rc.2",
87
- "@cpajs/freebsd-ia32": "0.1.0-rc.2",
88
- "@cpajs/openbsd-x64": "0.1.0-rc.2",
89
- "@cpajs/openbsd-arm64": "0.1.0-rc.2",
90
- "@cpajs/netbsd-x64": "0.1.0-rc.2"
68
+ "@cpajs/darwin-x64": "0.1.0-rc.3",
69
+ "@cpajs/darwin-arm64": "0.1.0-rc.3",
70
+ "@cpajs/win32-x64": "0.1.0-rc.3",
71
+ "@cpajs/win32-arm64": "0.1.0-rc.3",
72
+ "@cpajs/win32-ia32": "0.1.0-rc.3",
73
+ "@cpajs/linux-x64-gnu": "0.1.0-rc.3",
74
+ "@cpajs/linux-arm64-gnu": "0.1.0-rc.3",
75
+ "@cpajs/linux-x64-musl": "0.1.0-rc.3",
76
+ "@cpajs/linux-arm64-musl": "0.1.0-rc.3",
77
+ "@cpajs/linux-arm": "0.1.0-rc.3",
78
+ "@cpajs/linux-ia32": "0.1.0-rc.3",
79
+ "@cpajs/linux-riscv64": "0.1.0-rc.3",
80
+ "@cpajs/linux-ppc64": "0.1.0-rc.3",
81
+ "@cpajs/linux-s390x": "0.1.0-rc.3",
82
+ "@cpajs/linux-loong64": "0.1.0-rc.3",
83
+ "@cpajs/linux-mips": "0.1.0-rc.3",
84
+ "@cpajs/linux-mipsel": "0.1.0-rc.3",
85
+ "@cpajs/freebsd-x64": "0.1.0-rc.3",
86
+ "@cpajs/freebsd-arm64": "0.1.0-rc.3",
87
+ "@cpajs/freebsd-ia32": "0.1.0-rc.3",
88
+ "@cpajs/openbsd-x64": "0.1.0-rc.3",
89
+ "@cpajs/openbsd-arm64": "0.1.0-rc.3",
90
+ "@cpajs/netbsd-x64": "0.1.0-rc.3"
91
91
  }
92
92
  }
@@ -11,7 +11,9 @@ import { ManagedProcess } from './process.ts';
11
11
  import { connectHost, findFreePort, formatOrigin, isLoopbackHost, isPortFree, probeHealth, type PortReservation } from './readiness.ts';
12
12
  import { internalCommand, type InternalCommand } from './internal.ts';
13
13
  import { createRedactor } from './redact.ts';
14
- import type { CpaServer, ExitResult, LogLine, RestartOptions, StartServerOptions, StartWithConfigOptions, StopOptions } from './types.ts';
14
+ import { createWarner } from './warnings.ts';
15
+ import type { CpaServer, ExitResult, LogLine, RestartOptions, ServerClientOptions, StartServerOptions, StartWithConfigOptions, StopOptions } from './types.ts';
16
+ import { createClient } from '../client/index.ts';
15
17
 
16
18
  export { candidateTargets, currentPlatform, detectLibc, resolveBinary } from './binary.ts';
17
19
  export type { HostPlatform, Libc, ResolvedBinary } from './binary.ts';
@@ -21,6 +23,7 @@ export { TARGETS, NPM_SCOPE, UNSUPPORTED_PLATFORMS, binaryName, packageName } fr
21
23
  export { CPA_RELEASE } from './cpa-version.ts';
22
24
  export type { Target, TargetBuild, TargetVerification } from './targets.ts';
23
25
  export type * from './types.ts';
26
+ export type { CpaWarning, CpaWarningCode, SuppressWarnings } from './warnings.ts';
24
27
  export type { CpaConfig } from '../client/types/config.ts';
25
28
 
26
29
  const DEFAULT_STARTUP_TIMEOUT_MS = 30_000;
@@ -49,8 +52,12 @@ function validate(options: StartServerOptions): void {
49
52
  'management and managementKey are mutually exclusive; managementKey is the deprecated alias for management.key.',
50
53
  );
51
54
  }
55
+ if (options.management === false && options.managementKey !== undefined) {
56
+ throw new CpaStartError('invalid-options', 'management: false disables the management API; do not also pass managementKey.');
57
+ }
52
58
  if (
53
59
  options.management !== undefined &&
60
+ options.management !== false &&
54
61
  (typeof options.management.key !== 'string' || options.management.key.trim() === '')
55
62
  ) {
56
63
  throw new CpaStartError('invalid-options', 'management.key must not be empty.');
@@ -58,16 +65,17 @@ function validate(options: StartServerOptions): void {
58
65
  if (typeof options.managementKey === 'string' && options.managementKey.trim() === '') {
59
66
  throw new CpaStartError('invalid-options', 'managementKey must not be empty.');
60
67
  }
61
- if (options.management?.viaEnvironment !== true && options.env?.MANAGEMENT_PASSWORD !== undefined) {
68
+ const viaEnvironment = options.management !== false && options.management?.viaEnvironment === true;
69
+ if (!viaEnvironment && options.env?.MANAGEMENT_PASSWORD !== undefined) {
62
70
  throw new CpaStartError(
63
71
  'invalid-options',
64
72
  'Do not set MANAGEMENT_PASSWORD in env: cpajs only passes it to CPA for management: { key, viaEnvironment: true }, because upstream treats it as enabling remote management.',
65
73
  );
66
74
  }
67
- const requestedKey = options.management?.key ?? options.managementKey;
75
+ const requestedKey = (options.management === false ? undefined : options.management?.key) ?? options.managementKey;
68
76
  if (requestedKey === undefined) return;
69
77
  if (options.configPath !== undefined) {
70
- if (options.management?.viaEnvironment !== true) {
78
+ if (!viaEnvironment) {
71
79
  throw new CpaStartError(
72
80
  'invalid-options',
73
81
  'management.key cannot be combined with configPath because cpajs must not edit your config file. Put management.secret-key in the file, or use management.viaEnvironment: true to pass the key through MANAGEMENT_PASSWORD (which also enables remote management).',
@@ -231,11 +239,12 @@ export async function startServer(options: StartServerOptions = {}): Promise<Cpa
231
239
  // Exec mode checks this after PR_SET_PDEATHSIG to catch a parent that died first.
232
240
  if (launcher?.mode === 'exec') env.CPAJS_PARENT_PID = String(process.pid);
233
241
  const extraArgs = buildArgs(options);
234
- if (launcher === undefined && options.launcher !== false && command === undefined && process.platform !== 'win32') {
235
- options.onLog?.({
236
- stream: 'stderr',
237
- line: `cpajs: notice: no cpa-launcher found for ${binary.path}; CPA will keep running if this process is killed. Pass launcher: false to silence this.`,
238
- });
242
+ const warn = createWarner(options);
243
+ if (management.generated) {
244
+ warn(
245
+ 'noManagementKey',
246
+ 'No management key given: generated one for this start (only its bcrypt hash is stored). Use server.client() for the management API, management: { key } to choose the key, or management: false to disable it.',
247
+ );
239
248
  }
240
249
  const ownsStateDir = options.stateDir === undefined;
241
250
  const stateDir = ownsStateDir ? await mkdtemp(join(tmpdir(), 'cpajs-')) : resolve(options.stateDir!);
@@ -252,11 +261,9 @@ export async function startServer(options: StartServerOptions = {}): Promise<Cpa
252
261
  management.secretKeyHash === undefined
253
262
  ? undefined
254
263
  : { secretKeyHash: management.secretKeyHash, allowRemote: management.allowRemote };
255
- let warnedRemote = false;
256
264
 
257
265
  let reservation: PortReservation | undefined;
258
266
  let wroteConfig = false;
259
- let announcedReuse = false;
260
267
  try {
261
268
  for (let attempt = 1; ; attempt++) {
262
269
  let prepared: PreparedConfig;
@@ -284,18 +291,15 @@ export async function startServer(options: StartServerOptions = {}): Promise<Cpa
284
291
  ) {
285
292
  await updateManagedSecret(existing.configPath, managedSecret);
286
293
  prepared = (await readManagedConfig(stateDir))!;
287
- options.onLog?.({
288
- stream: 'stdout',
289
- line: `Updated management.secret-key / allow-remote in ${existing.configPath} for the management key of this start.`,
290
- });
291
- }
292
- if (!announcedReuse) {
293
- announcedReuse = true;
294
- options.onLog?.({
295
- stream: 'stdout',
296
- line: `Keeping existing config at ${existing.configPath}; pass overwriteConfig: true to replace it.`,
297
- });
294
+ // A generated key changes on every start; only a caller's key change is news.
295
+ if (!management.generated) {
296
+ warn('managementKeyUpdated', `Replaced management.secret-key / allow-remote in ${existing.configPath} for the management key of this start.`);
297
+ }
298
298
  }
299
+ warn(
300
+ 'configReused',
301
+ `Kept the existing config at ${existing.configPath}; this start's config, host and port were not applied. Pass overwriteConfig: true to replace it.`,
302
+ );
299
303
  } else {
300
304
  const listen = configListen(options);
301
305
  if (listen.port === 0) {
@@ -309,23 +313,19 @@ export async function startServer(options: StartServerOptions = {}): Promise<Cpa
309
313
  }
310
314
 
311
315
  const { host, port, tls } = prepared.listen;
312
- if (!warnedRemote) {
313
- warnedRemote = true;
314
- const target = host === '' ? 'all interfaces' : host;
315
- const exposed = !isLoopbackHost(host);
316
- if (management.viaEnvironment) {
317
- options.onLog?.({
318
- stream: 'stderr',
319
- line:
320
- 'cpajs: warning: management.viaEnvironment passes the key through MANAGEMENT_PASSWORD, which upstream compares in plaintext and which always enables remote management' +
321
- (exposed ? `; the server binds ${target}, so the management API is reachable from non-loopback clients.` : '.'),
322
- });
323
- } else if (prepared.management.allowRemote && exposed) {
324
- options.onLog?.({
325
- stream: 'stderr',
326
- line: `cpajs: warning: management.allow-remote is true and the server binds ${target}, so the management API is reachable from non-loopback clients.`,
327
- });
328
- }
316
+ const target = host === '' ? 'all interfaces' : host;
317
+ const exposed = !isLoopbackHost(host);
318
+ if (management.viaEnvironment) {
319
+ warn(
320
+ 'managementViaEnvironment',
321
+ 'management.viaEnvironment passes the key through MANAGEMENT_PASSWORD, which upstream compares in plaintext and which always enables remote management' +
322
+ (exposed ? `; the server binds ${target}, so the management API is reachable from non-loopback clients.` : '.'),
323
+ );
324
+ } else if (prepared.management.allowRemote && exposed) {
325
+ warn(
326
+ 'remoteManagementExposed',
327
+ `management.allow-remote is true and the server binds ${target}, so the management API is reachable from non-loopback clients.`,
328
+ );
329
329
  }
330
330
 
331
331
  const redact = createRedactor([management.key, options.home?.jwt, ...prepared.secrets, ...(options.redact ?? [])]);
@@ -361,6 +361,13 @@ export async function startServer(options: StartServerOptions = {}): Promise<Cpa
361
361
  if (result.kind === 'ready') {
362
362
  return createHandle(result.proc, {
363
363
  binaryPath: binary.path,
364
+ managementKey: management.key,
365
+ noClientReason:
366
+ options.management === false
367
+ ? 'the management API is disabled (management: false)'
368
+ : options.configPath !== undefined
369
+ ? 'with configPath, cpajs does not know the key; pass management: { key, viaEnvironment: true } or create a client with your own key'
370
+ : "config.management['secret-key'] is set, so the key is yours; create a client with it",
364
371
  spawnPath,
365
372
  supervised,
366
373
  prefixArgs,
@@ -417,6 +424,10 @@ async function waitUntilReady(
417
424
  interface HandleInfo {
418
425
  /** The CPA binary (exposed on the handle). */
419
426
  binaryPath: string;
427
+ /** Plaintext management key, kept private to back server.client(). */
428
+ managementKey: string | undefined;
429
+ /** Why server.client() is unavailable when there is no key. */
430
+ noClientReason: string;
420
431
  /** What is spawned: cpa-launcher or CPA itself. */
421
432
  spawnPath: string;
422
433
  supervised: boolean;
@@ -578,6 +589,10 @@ function createHandle(initialProc: ManagedProcess, info: HandleInfo): CpaServer
578
589
  exited,
579
590
  stop,
580
591
  restart,
592
+ client(clientOptions: ServerClientOptions = {}) {
593
+ if (info.managementKey === undefined) throw new Error(`server.client() is unavailable: ${info.noClientReason}.`);
594
+ return createClient({ ...clientOptions, baseUrl: info.origin, managementKey: info.managementKey });
595
+ },
581
596
  };
582
597
  liveServers.add(handle);
583
598
  return handle;
@@ -1,3 +1,4 @@
1
+ import { randomBytes } from 'node:crypto';
1
2
  import { compare, hash } from 'bcryptjs';
2
3
  import { CpaStartError } from './errors.ts';
3
4
  import type { ManagementOptions } from './types.ts';
@@ -10,8 +11,10 @@ export const BCRYPT_COST = 10;
10
11
  const MAX_BCRYPT_BYTES = 72;
11
12
 
12
13
  export interface ResolvedManagement {
13
- /** The plaintext key, when the caller supplied one. */
14
+ /** The plaintext key: supplied by the caller or generated for this start. */
14
15
  key: string | undefined;
16
+ /** True when cpajs generated the key because none was given. */
17
+ generated: boolean;
15
18
  /** True when the key travels through `MANAGEMENT_PASSWORD`. */
16
19
  viaEnvironment: boolean;
17
20
  /** Value for `management.allow-remote` in a managed config. */
@@ -26,9 +29,13 @@ export interface ResolvedManagement {
26
29
  * the old `MANAGEMENT_PASSWORD` behaviour.
27
30
  */
28
31
  export async function resolveManagement(options: {
29
- management?: ManagementOptions;
32
+ management?: ManagementOptions | false;
30
33
  managementKey?: string;
34
+ configPath?: string;
35
+ config?: { management?: { 'secret-key'?: unknown } };
31
36
  }): Promise<ResolvedManagement> {
37
+ const none: ResolvedManagement = { key: undefined, generated: false, viaEnvironment: false, allowRemote: false, secretKeyHash: undefined };
38
+ if (options.management === false) return none;
32
39
  if (options.management !== undefined && options.managementKey !== undefined) {
33
40
  throw new CpaStartError(
34
41
  'invalid-options',
@@ -38,12 +45,13 @@ export async function resolveManagement(options: {
38
45
  const management =
39
46
  options.management ?? (options.managementKey === undefined ? undefined : { key: options.managementKey });
40
47
  if (management === undefined) {
41
- return {
42
- key: undefined,
43
- viaEnvironment: false,
44
- allowRemote: false,
45
- secretKeyHash: undefined,
46
- };
48
+ // No key given: generate one for this start so server.client() works, unless the
49
+ // caller manages the secret itself (configPath, or secret-key in config), where
50
+ // cpajs cannot know or must not write the key.
51
+ const ownSecret = options.config?.management?.['secret-key'];
52
+ if (options.configPath !== undefined || (typeof ownSecret === 'string' && ownSecret.trim() !== '')) return none;
53
+ const key = randomBytes(32).toString('base64url');
54
+ return { key, generated: true, viaEnvironment: false, allowRemote: false, secretKeyHash: await hash(key, BCRYPT_COST) };
47
55
  }
48
56
  const key = management.key;
49
57
  if (typeof key !== 'string' || key.trim() === '') {
@@ -57,6 +65,7 @@ export async function resolveManagement(options: {
57
65
  }
58
66
  return {
59
67
  key,
68
+ generated: false,
60
69
  viaEnvironment: true,
61
70
  allowRemote: management.allowRemote === true,
62
71
  secretKeyHash: undefined,
@@ -70,6 +79,7 @@ export async function resolveManagement(options: {
70
79
  }
71
80
  return {
72
81
  key,
82
+ generated: false,
73
83
  viaEnvironment: false,
74
84
  allowRemote: management.allowRemote === true,
75
85
  secretKeyHash: await hash(key, BCRYPT_COST),
@@ -1,5 +1,7 @@
1
1
  import type { ChildProcess } from 'node:child_process';
2
+ import type { CpaClient, ClientOptions } from '../client/index.ts';
2
3
  import type { CpaConfig } from '../client/types/config.ts';
4
+ import type { CpaWarning, SuppressWarnings } from './warnings.ts';
3
5
 
4
6
  export interface LogLine {
5
7
  stream: 'stdout' | 'stderr';
@@ -7,6 +9,9 @@ export interface LogLine {
7
9
  line: string;
8
10
  }
9
11
 
12
+ /** Options for `server.client()`: everything except the origin and the key. */
13
+ export type ServerClientOptions = Omit<ClientOptions, 'baseUrl' | 'managementKey'>;
14
+
10
15
  export interface HomeOptions {
11
16
  /**
12
17
  * Home control plane JWT (`-home-jwt`). It is passed through the `HOME_JWT`
@@ -43,8 +48,16 @@ interface CommonServerOptions {
43
48
  * directory. When omitted, a temporary directory is created and removed on stop.
44
49
  */
45
50
  stateDir?: string;
46
- /** Management API key and how it reaches CPA. */
47
- management?: ManagementOptions;
51
+ /**
52
+ * Management API key and how it reaches CPA.
53
+ *
54
+ * Omitted: cpajs generates a random key for this start, writes only its bcrypt
55
+ * hash into the managed config (remote management off) and keeps the plaintext
56
+ * in memory; use `server.client()` to talk to the management API. Not done in
57
+ * `configPath` mode or when `config.management['secret-key']` is set, because
58
+ * then the secret is yours. `false`: the management API stays disabled.
59
+ */
60
+ management?: ManagementOptions | false;
48
61
  /**
49
62
  * Deprecated alias for `management: { key }`. It uses the safe default
50
63
  * (bcrypt hash in the config, remote management disabled) and will be removed
@@ -89,7 +102,17 @@ interface CommonServerOptions {
89
102
  startupTimeoutMs?: number;
90
103
  /** Cancels startup. After startup it has no effect; call `stop()` instead. */
91
104
  signal?: AbortSignal;
92
- /** Receives every output line, redacted. */
105
+ /**
106
+ * Silences individual cpajs warnings, e.g. `{ noManagementKey: true }`. Every
107
+ * warning message names the field that silences it.
108
+ */
109
+ suppressWarnings?: SuppressWarnings;
110
+ /**
111
+ * Receives cpajs warnings instead of `process.emitWarning` (which prints them
112
+ * to stderr as `CpaWarning`). CPA's own output goes to `onLog`.
113
+ */
114
+ onWarning?: (warning: CpaWarning) => void;
115
+ /** Receives every line CPA prints, redacted. */
93
116
  onLog?: (log: LogLine) => void;
94
117
  /** Additional strings to redact from logs and errors. */
95
118
  redact?: readonly string[];
@@ -181,6 +204,13 @@ export interface CpaServer {
181
204
  * terminated forcefully (there is no grace period and CPA is not asked to
182
205
  * flush state or update auth files). Idempotent.
183
206
  */
207
+ /**
208
+ * A management API client already bound to this server's origin and key. The
209
+ * key itself is not exposed. Works when cpajs knows the plaintext key (generated,
210
+ * or passed as `management.key`); throws otherwise, e.g. with `configPath` or a
211
+ * `secret-key` you put in `config` yourself.
212
+ */
213
+ client(options?: ServerClientOptions): CpaClient;
184
214
  stop(options?: StopOptions): Promise<ExitResult>;
185
215
  /**
186
216
  * Restarts CPA with the original options, reusing `origin`, `baseUrl`, `host`,
@@ -0,0 +1,43 @@
1
+ /**
2
+ * Warnings emitted by cpajs itself (not CPA's output, which goes to `onLog`).
3
+ * Each has a stable code that can be suppressed individually.
4
+ */
5
+ export type CpaWarningCode =
6
+ /** No management key was given, so one was generated for this start. */
7
+ | 'noManagementKey'
8
+ /** `management.viaEnvironment`: plaintext comparison, and remote management is forced on. */
9
+ | 'managementViaEnvironment'
10
+ /** `management.allow-remote` is on and the server binds a non-loopback host. */
11
+ | 'remoteManagementExposed'
12
+ /** No cpa-launcher was found, so CPA can outlive this process. */
13
+ /** An existing managed config was kept; this start's `config`, `host` and `port` were not applied. */
14
+ | 'configReused'
15
+ /** The management key in a reused config was replaced with the hash of a new key. */
16
+ | 'managementKeyUpdated';
17
+
18
+ export interface CpaWarning {
19
+ code: CpaWarningCode;
20
+ message: string;
21
+ }
22
+
23
+ /** `{ noManagementKey: true }` silences that warning. */
24
+ export type SuppressWarnings = Partial<Record<CpaWarningCode, boolean>>;
25
+
26
+ /**
27
+ * Returns a function that emits each warning code at most once: to `onWarning`
28
+ * when given, otherwise through `process.emitWarning` (type `CpaWarning`), so it
29
+ * shows up on stderr by default and works with Node's usual warning handling.
30
+ */
31
+ export function createWarner(options: {
32
+ suppressWarnings?: SuppressWarnings | undefined;
33
+ onWarning?: ((warning: CpaWarning) => void) | undefined;
34
+ }): (code: CpaWarningCode, message: string) => void {
35
+ const emitted = new Set<CpaWarningCode>();
36
+ return (code, message) => {
37
+ if (options.suppressWarnings?.[code] === true || emitted.has(code)) return;
38
+ emitted.add(code);
39
+ const warning: CpaWarning = { code, message: `${message} (suppress with suppressWarnings.${code})` };
40
+ if (options.onWarning) options.onWarning(warning);
41
+ else process.emitWarning(warning.message, { type: 'CpaWarning', code });
42
+ };
43
+ }