@marinoscar/platform-cli 0.1.0-next.16 → 0.1.0-next.18
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 +25 -0
- package/README.md +32 -3
- package/dist/engine/create-cli.d.ts +10 -1
- package/dist/engine/create-cli.d.ts.map +1 -1
- package/dist/engine/create-cli.js +5 -1
- package/dist/engine/create-cli.js.map +1 -1
- package/dist/engine/github-raw-manifest.d.ts +59 -0
- package/dist/engine/github-raw-manifest.d.ts.map +1 -0
- package/dist/engine/github-raw-manifest.js +197 -0
- package/dist/engine/github-raw-manifest.js.map +1 -0
- package/dist/engine/identity.d.ts +5 -5
- package/dist/engine/identity.d.ts.map +1 -1
- package/dist/engine/identity.js +4 -4
- package/dist/engine/identity.js.map +1 -1
- package/dist/engine/index.d.ts +4 -0
- package/dist/engine/index.d.ts.map +1 -1
- package/dist/engine/index.js +3 -0
- package/dist/engine/index.js.map +1 -1
- package/dist/engine/program.d.ts +3 -0
- package/dist/engine/program.d.ts.map +1 -1
- package/dist/engine/program.js +16 -0
- package/dist/engine/program.js.map +1 -1
- package/dist/engine/registries.d.ts.map +1 -1
- package/dist/engine/registries.js +2 -0
- package/dist/engine/registries.js.map +1 -1
- package/dist/engine/semver.d.ts +31 -0
- package/dist/engine/semver.d.ts.map +1 -0
- package/dist/engine/semver.js +100 -0
- package/dist/engine/semver.js.map +1 -0
- package/dist/engine/test-support.d.ts +1 -1
- package/dist/engine/test-support.js +1 -1
- package/dist/engine/update-notice-options.d.ts +70 -0
- package/dist/engine/update-notice-options.d.ts.map +1 -0
- package/dist/engine/update-notice-options.js +79 -0
- package/dist/engine/update-notice-options.js.map +1 -0
- package/dist/engine/update-notice.d.ts +69 -0
- package/dist/engine/update-notice.d.ts.map +1 -0
- package/dist/engine/update-notice.js +204 -0
- package/dist/engine/update-notice.js.map +1 -0
- package/dist/index.d.ts +2 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/package.json +3 -3
package/dist/engine/index.js
CHANGED
|
@@ -11,6 +11,9 @@
|
|
|
11
11
|
export { API_PATH_PREFIX, cliDisplayName, cliIdentity, cliName, cliVersion, configDirName, configFileName, envPrefix, envVar, hasCliIdentity, replaceCliIdentityForTests, resolveCliIdentity, setCliIdentity, toEnvPrefix, } from './identity.js';
|
|
12
12
|
export { PLATFORM_CLI_VERSION } from './package-info.js';
|
|
13
13
|
export { createCli } from './create-cli.js';
|
|
14
|
+
// The start-up update notice (#1033): the option type, the GitHub manifest
|
|
15
|
+
// helper, and the context `run` takes as a test seam.
|
|
16
|
+
export { githubRawManifest } from './github-raw-manifest.js';
|
|
14
17
|
export { PLATFORM_ENV_FRAGMENT_ID, ensurePlatformRegistrations, resetPlatformRegistrationsForTests, } from './builtin-registrations.js';
|
|
15
18
|
export { ApiClient, DEFAULT_TIMEOUT_MS, buildUrl, resolveApiBaseUrl, unwrapEnvelope, } from './api-client.js';
|
|
16
19
|
export { BUILTIN_COMMAND_NAMES, buildProgram, run, versionText } from './program.js';
|
package/dist/engine/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"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"}
|
package/dist/engine/program.d.ts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { Command } from 'commander';
|
|
2
2
|
import { type TtyContext } from './tui/tty.js';
|
|
3
|
+
import { type UpdateCheckContext } from './update-notice.js';
|
|
3
4
|
/**
|
|
4
5
|
* The built-in commands, in the order `--help` lists them. An app command
|
|
5
6
|
* may not take one of these names.
|
|
@@ -39,6 +40,8 @@ export interface RunOptions {
|
|
|
39
40
|
tty?: TtyContext | undefined;
|
|
40
41
|
/** Replaces the dynamic import of the ink app. */
|
|
41
42
|
startTui?: (() => Promise<number>) | undefined;
|
|
43
|
+
/** Environment, home directory, stderr and clock the start-up update notice reads (a test seam). */
|
|
44
|
+
updateCheck?: UpdateCheckContext | undefined;
|
|
42
45
|
}
|
|
43
46
|
/**
|
|
44
47
|
* Parse `argv` (arguments only — no node binary, no script path) and return
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../src/engine/program.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAC;AAYpD,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;
|
|
1
|
+
{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../src/engine/program.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAC;AAYpD,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AA6B/E;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,+DAA+E,CAAC;AAElH;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAsDtC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,kDAAkD;IAClD,GAAG,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAC/C,oGAAoG;IACpG,WAAW,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;CAC9C;AAED;;;;;GAKG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB/E"}
|
package/dist/engine/program.js
CHANGED
|
@@ -11,6 +11,7 @@ import { EXIT, exitCodeFor, formatError } from './errors.js';
|
|
|
11
11
|
import { PLATFORM_CLI_VERSION } from './package-info.js';
|
|
12
12
|
import { ensurePlatformRegistrations } from './builtin-registrations.js';
|
|
13
13
|
import { evaluateTuiGate } from './tui/tty.js';
|
|
14
|
+
import { beginUpdateCheck } from './update-notice.js';
|
|
14
15
|
// =============================================================================
|
|
15
16
|
// Command wiring (issue #140, epic #110)
|
|
16
17
|
// =============================================================================
|
|
@@ -131,6 +132,21 @@ export async function run(argv, options) {
|
|
|
131
132
|
process.stderr.write(`${formatError(error)}\n`);
|
|
132
133
|
return exitCodeFor(error);
|
|
133
134
|
}
|
|
135
|
+
// The start-up update notice (#1033). `begin` starts the check in parallel
|
|
136
|
+
// with whatever runs below and awaits nothing; `finish` runs AFTER it, and is
|
|
137
|
+
// the only place anything is written, so the notice follows the command's
|
|
138
|
+
// output (and, for the TUI, comes after ink has unmounted and restored the
|
|
139
|
+
// terminal). Both are inert when the app did not pass `updateNotice`, and
|
|
140
|
+
// neither can throw or change `code`.
|
|
141
|
+
const updateCheck = beginUpdateCheck(argv, options?.updateCheck);
|
|
142
|
+
try {
|
|
143
|
+
return await runProgram(program, argv, options);
|
|
144
|
+
}
|
|
145
|
+
finally {
|
|
146
|
+
await updateCheck.finish();
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
async function runProgram(program, argv, options) {
|
|
134
150
|
// ---------------------------------------------------------------------------
|
|
135
151
|
// NO ARGUMENTS: the ONLY invocation that can open the ink TUI (#145).
|
|
136
152
|
// ---------------------------------------------------------------------------
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"program.js","sourceRoot":"","sources":["../../src/engine/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,eAAe,EAAmB,MAAM,cAAc,CAAC;
|
|
1
|
+
{"version":3,"file":"program.js","sourceRoot":"","sources":["../../src/engine/program.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"registries.d.ts","sourceRoot":"","sources":["../../src/engine/registries.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"registries.d.ts","sourceRoot":"","sources":["../../src/engine/registries.ts"],"names":[],"mappings":"AAmCA,6DAA6D;AAC7D,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAapD;AAED,4DAA4D;AAC5D,wBAAgB,0BAA0B,IAAI,IAAI,CAcjD"}
|
|
@@ -9,6 +9,7 @@ import { resetCapabilityRegistriesForTests } from './node/capabilities.js';
|
|
|
9
9
|
import { freezeNodeExecutorRegistry, resetNodeExecutorRegistryForTests } from './node/executors/registry.js';
|
|
10
10
|
import { freezeTuiSectionRegistry, resetTuiSectionRegistryForTests } from './tui/section-registry.js';
|
|
11
11
|
import { freezeTuiScreenRegistry, resetTuiScreenRegistryForTests } from './tui/screen-registry.js';
|
|
12
|
+
import { resetUpdateNoticeForTests } from './update-notice-options.js';
|
|
12
13
|
// =============================================================================
|
|
13
14
|
// The CLI's registries, together (PP-8.9, #715)
|
|
14
15
|
// =============================================================================
|
|
@@ -50,5 +51,6 @@ export function resetCliRegistriesForTests() {
|
|
|
50
51
|
resetDeployCheckRegistryForTests();
|
|
51
52
|
resetEdgeConfigRegistryForTests();
|
|
52
53
|
resetVersionedManifestsForTests();
|
|
54
|
+
resetUpdateNoticeForTests();
|
|
53
55
|
}
|
|
54
56
|
//# sourceMappingURL=registries.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"registries.js","sourceRoot":"","sources":["../../src/engine/registries.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,EACrB,kCAAkC,EAClC,iCAAiC,GAClC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,kCAAkC,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,yBAAyB,EAAE,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AAC1G,OAAO,EAAE,wBAAwB,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AACpG,OAAO,EAAE,yBAAyB,EAAE,gCAAgC,EAAE,MAAM,2BAA2B,CAAC;AACxG,OAAO,EAAE,wBAAwB,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AACvG,OAAO,EAAE,iCAAiC,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,iCAAiC,EAAE,MAAM,8BAA8B,CAAC;AAC7G,OAAO,EAAE,wBAAwB,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAC;AACtG,OAAO,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;
|
|
1
|
+
{"version":3,"file":"registries.js","sourceRoot":"","sources":["../../src/engine/registries.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,EACrB,kCAAkC,EAClC,iCAAiC,GAClC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,kCAAkC,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,yBAAyB,EAAE,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AAC1G,OAAO,EAAE,wBAAwB,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AACpG,OAAO,EAAE,yBAAyB,EAAE,gCAAgC,EAAE,MAAM,2BAA2B,CAAC;AACxG,OAAO,EAAE,wBAAwB,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AACvG,OAAO,EAAE,iCAAiC,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,iCAAiC,EAAE,MAAM,8BAA8B,CAAC;AAC7G,OAAO,EAAE,wBAAwB,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAC;AACtG,OAAO,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AACnG,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAEvE,gFAAgF;AAChF,iDAAiD;AACjD,gFAAgF;AAChF,EAAE;AACF,sEAAsE;AACtE,4EAA4E;AAC5E,qEAAqE;AACrE,wEAAwE;AACxE,6EAA6E;AAC7E,4EAA4E;AAC5E,2EAA2E;AAC3E,gFAAgF;AAEhF,6DAA6D;AAC7D,MAAM,UAAU,mBAAmB,CAAC,EAAU;IAC5C,qBAAqB,CAAC,EAAE,CAAC,CAAC;IAC1B,qBAAqB,CAAC,EAAE,CAAC,CAAC;IAC1B,sBAAsB,CAAC,EAAE,CAAC,CAAC;IAC3B,0BAA0B,CAAC,EAAE,CAAC,CAAC;IAC/B,2BAA2B,CAAC,EAAE,CAAC,CAAC;IAChC,uBAAuB,CAAC,EAAE,CAAC,CAAC;IAC5B,wBAAwB,CAAC,EAAE,CAAC,CAAC;IAC7B,0BAA0B,CAAC,EAAE,CAAC,CAAC;IAC/B,wBAAwB,CAAC,EAAE,CAAC,CAAC;IAC7B,yBAAyB,CAAC,EAAE,CAAC,CAAC;IAC9B,yBAAyB,CAAC,EAAE,CAAC,CAAC;IAC9B,wBAAwB,CAAC,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,0BAA0B;IACxC,kCAAkC,EAAE,CAAC;IACrC,8BAA8B,EAAE,CAAC;IACjC,+BAA+B,EAAE,CAAC;IAClC,+BAA+B,EAAE,CAAC;IAClC,iCAAiC,EAAE,CAAC;IACpC,iCAAiC,EAAE,CAAC;IACpC,gCAAgC,EAAE,CAAC;IACnC,iCAAiC,EAAE,CAAC;IACpC,kCAAkC,EAAE,CAAC;IACrC,gCAAgC,EAAE,CAAC;IACnC,+BAA+B,EAAE,CAAC;IAClC,+BAA+B,EAAE,CAAC;IAClC,yBAAyB,EAAE,CAAC;AAC9B,CAAC"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/** A parsed semantic version. */
|
|
2
|
+
export interface ParsedSemver {
|
|
3
|
+
readonly major: string;
|
|
4
|
+
readonly minor: string;
|
|
5
|
+
readonly patch: string;
|
|
6
|
+
/** Dot-separated prerelease identifiers; empty for a release. */
|
|
7
|
+
readonly prerelease: readonly string[];
|
|
8
|
+
}
|
|
9
|
+
/**
|
|
10
|
+
* Parses a semantic version strictly: no leading `v`, no surrounding space.
|
|
11
|
+
*
|
|
12
|
+
* @param value - The candidate.
|
|
13
|
+
* @returns The parsed version, or `undefined` when `value` is not a valid
|
|
14
|
+
* semver 2.0.0 string.
|
|
15
|
+
*/
|
|
16
|
+
export declare function parseSemver(value: unknown): ParsedSemver | undefined;
|
|
17
|
+
/**
|
|
18
|
+
* Orders two parsed versions by semver precedence.
|
|
19
|
+
*
|
|
20
|
+
* @returns Negative when `a` is older than `b`, positive when newer, 0 when equal.
|
|
21
|
+
*/
|
|
22
|
+
export declare function compareSemver(a: ParsedSemver, b: ParsedSemver): number;
|
|
23
|
+
/**
|
|
24
|
+
* Whether `candidate` is strictly newer than `current`. `false` when either is
|
|
25
|
+
* not a valid semver string, so a malformed value can never produce a notice.
|
|
26
|
+
*
|
|
27
|
+
* @param candidate - The version offered.
|
|
28
|
+
* @param current - The version running.
|
|
29
|
+
*/
|
|
30
|
+
export declare function isNewerVersion(candidate: unknown, current: unknown): boolean;
|
|
31
|
+
//# sourceMappingURL=semver.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"semver.d.ts","sourceRoot":"","sources":["../../src/engine/semver.ts"],"names":[],"mappings":"AAiBA,iCAAiC;AACjC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AASD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAUpE;AAiCD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CAOtE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAK5E"}
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// Strict semver 2.0.0 parsing and precedence (issue #1033)
|
|
3
|
+
// =============================================================================
|
|
4
|
+
//
|
|
5
|
+
// The update notice compares the running version with a version read from the
|
|
6
|
+
// network or from a cache file, so BOTH sides must be proven well formed before
|
|
7
|
+
// they are compared or printed: the value ends up on a terminal, and a string
|
|
8
|
+
// that merely looks like a version could carry an escape sequence. A strict
|
|
9
|
+
// parse is the filter.
|
|
10
|
+
//
|
|
11
|
+
// This is not `deploy/app-version.ts`'s `parseSemVer`, which accepts only
|
|
12
|
+
// `x.y.z` because the deploy's version step writes plain release numbers. The
|
|
13
|
+
// notice has to order prereleases (`1.2.3-rc.1` < `1.2.3`), so it follows the
|
|
14
|
+
// precedence rules of semver.org §11 in full. Build metadata (`+build`) is
|
|
15
|
+
// accepted and ignored by precedence, as the spec says.
|
|
16
|
+
// =============================================================================
|
|
17
|
+
/** The reference expression of semver.org (numbers without leading zeros). */
|
|
18
|
+
const SEMVER = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+[0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*)?$/;
|
|
19
|
+
/** No real version is longer; bounds the work done on an untrusted string. */
|
|
20
|
+
const MAX_VERSION_LENGTH = 128;
|
|
21
|
+
/**
|
|
22
|
+
* Parses a semantic version strictly: no leading `v`, no surrounding space.
|
|
23
|
+
*
|
|
24
|
+
* @param value - The candidate.
|
|
25
|
+
* @returns The parsed version, or `undefined` when `value` is not a valid
|
|
26
|
+
* semver 2.0.0 string.
|
|
27
|
+
*/
|
|
28
|
+
export function parseSemver(value) {
|
|
29
|
+
if (typeof value !== 'string' || value.length === 0 || value.length > MAX_VERSION_LENGTH)
|
|
30
|
+
return undefined;
|
|
31
|
+
const match = SEMVER.exec(value);
|
|
32
|
+
if (match === null)
|
|
33
|
+
return undefined;
|
|
34
|
+
return {
|
|
35
|
+
major: match[1],
|
|
36
|
+
minor: match[2],
|
|
37
|
+
patch: match[3],
|
|
38
|
+
prerelease: match[4] === undefined ? [] : match[4].split('.'),
|
|
39
|
+
};
|
|
40
|
+
}
|
|
41
|
+
/** Compares two digit strings without leading zeros, with no overflow. */
|
|
42
|
+
function compareNumeric(a, b) {
|
|
43
|
+
if (a.length !== b.length)
|
|
44
|
+
return a.length < b.length ? -1 : 1;
|
|
45
|
+
return a === b ? 0 : a < b ? -1 : 1;
|
|
46
|
+
}
|
|
47
|
+
const NUMERIC = /^\d+$/;
|
|
48
|
+
function comparePrerelease(a, b) {
|
|
49
|
+
// A release outranks any prerelease of the same x.y.z.
|
|
50
|
+
if (a.length === 0 || b.length === 0) {
|
|
51
|
+
if (a.length === b.length)
|
|
52
|
+
return 0;
|
|
53
|
+
return a.length === 0 ? 1 : -1;
|
|
54
|
+
}
|
|
55
|
+
const shared = Math.min(a.length, b.length);
|
|
56
|
+
for (let i = 0; i < shared; i += 1) {
|
|
57
|
+
const left = a[i];
|
|
58
|
+
const right = b[i];
|
|
59
|
+
if (left === right)
|
|
60
|
+
continue;
|
|
61
|
+
const leftNumeric = NUMERIC.test(left);
|
|
62
|
+
const rightNumeric = NUMERIC.test(right);
|
|
63
|
+
if (leftNumeric && rightNumeric)
|
|
64
|
+
return compareNumeric(left, right);
|
|
65
|
+
// Numeric identifiers always have lower precedence than alphanumeric ones.
|
|
66
|
+
if (leftNumeric)
|
|
67
|
+
return -1;
|
|
68
|
+
if (rightNumeric)
|
|
69
|
+
return 1;
|
|
70
|
+
return left < right ? -1 : 1;
|
|
71
|
+
}
|
|
72
|
+
// All shared identifiers equal: the longer set has the higher precedence.
|
|
73
|
+
return a.length === b.length ? 0 : a.length < b.length ? -1 : 1;
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
* Orders two parsed versions by semver precedence.
|
|
77
|
+
*
|
|
78
|
+
* @returns Negative when `a` is older than `b`, positive when newer, 0 when equal.
|
|
79
|
+
*/
|
|
80
|
+
export function compareSemver(a, b) {
|
|
81
|
+
return (compareNumeric(a.major, b.major) ||
|
|
82
|
+
compareNumeric(a.minor, b.minor) ||
|
|
83
|
+
compareNumeric(a.patch, b.patch) ||
|
|
84
|
+
comparePrerelease(a.prerelease, b.prerelease));
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* Whether `candidate` is strictly newer than `current`. `false` when either is
|
|
88
|
+
* not a valid semver string, so a malformed value can never produce a notice.
|
|
89
|
+
*
|
|
90
|
+
* @param candidate - The version offered.
|
|
91
|
+
* @param current - The version running.
|
|
92
|
+
*/
|
|
93
|
+
export function isNewerVersion(candidate, current) {
|
|
94
|
+
const left = parseSemver(candidate);
|
|
95
|
+
const right = parseSemver(current);
|
|
96
|
+
if (left === undefined || right === undefined)
|
|
97
|
+
return false;
|
|
98
|
+
return compareSemver(left, right) > 0;
|
|
99
|
+
}
|
|
100
|
+
//# sourceMappingURL=semver.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"semver.js","sourceRoot":"","sources":["../../src/engine/semver.ts"],"names":[],"mappings":"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"}
|
|
@@ -16,7 +16,7 @@ export declare const TEST_CLI_IDENTITY: Readonly<CliIdentity>;
|
|
|
16
16
|
* @stability experimental
|
|
17
17
|
* @example
|
|
18
18
|
* ```ts
|
|
19
|
-
* const restore = useTestCliIdentity({ name: '
|
|
19
|
+
* const restore = useTestCliIdentity({ name: 'kappactl', displayName: 'Kappa CLI', repoSlug: 'kappa/kappa' });
|
|
20
20
|
* afterEach(restore);
|
|
21
21
|
* ```
|
|
22
22
|
*/
|
|
@@ -32,7 +32,7 @@ export const TEST_CLI_IDENTITY = Object.freeze({
|
|
|
32
32
|
* @stability experimental
|
|
33
33
|
* @example
|
|
34
34
|
* ```ts
|
|
35
|
-
* const restore = useTestCliIdentity({ name: '
|
|
35
|
+
* const restore = useTestCliIdentity({ name: 'kappactl', displayName: 'Kappa CLI', repoSlug: 'kappa/kappa' });
|
|
36
36
|
* afterEach(restore);
|
|
37
37
|
* ```
|
|
38
38
|
*/
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
/** One check per day. */
|
|
2
|
+
export declare const DEFAULT_UPDATE_CHECK_INTERVAL_MS: number;
|
|
3
|
+
/** How long a command may be held back at its end waiting for the answer. */
|
|
4
|
+
export declare const DEFAULT_UPDATE_CHECK_TIMEOUT_MS = 1500;
|
|
5
|
+
/** Basename of the cache file in the CLI's state directory (`~/.<cli>/`). */
|
|
6
|
+
export declare const UPDATE_CHECK_CACHE_FILE = "update-check.json";
|
|
7
|
+
/** The environment variable (suffix) that turns the check off: `<PREFIX>_NO_UPDATE_CHECK=1`. */
|
|
8
|
+
export declare const NO_UPDATE_CHECK_ENV_SUFFIX = "NO_UPDATE_CHECK";
|
|
9
|
+
/**
|
|
10
|
+
* What an app decides about the start-up update notice, for
|
|
11
|
+
* {@link CreateCliOptions}: where the newest version comes from and how the
|
|
12
|
+
* operator updates. Unset means no check at all.
|
|
13
|
+
*
|
|
14
|
+
* @stability experimental
|
|
15
|
+
* @extensionPoint option
|
|
16
|
+
*/
|
|
17
|
+
export interface UpdateNoticeOptions {
|
|
18
|
+
/**
|
|
19
|
+
* Resolves the newest available version of this CLI, or `undefined` when it
|
|
20
|
+
* is not known. Use {@link githubRawManifest} to read a `package.json` on
|
|
21
|
+
* GitHub.
|
|
22
|
+
*
|
|
23
|
+
* It runs in parallel with the command and is bounded by `timeoutMs`; it
|
|
24
|
+
* receives an `AbortSignal` that is aborted at that deadline, and a
|
|
25
|
+
* function that ignores the signal is simply abandoned. A rejection, a throw
|
|
26
|
+
* and a value that is not a valid semver string are all treated as "unknown".
|
|
27
|
+
*/
|
|
28
|
+
latestVersion: (signal?: AbortSignal) => Promise<string | undefined>;
|
|
29
|
+
/**
|
|
30
|
+
* The text after `Update:` in the notice: how the operator updates this CLI
|
|
31
|
+
* (`git pull && npm ci && npm run build`). One line, non-empty. Validated at
|
|
32
|
+
* `createCli`.
|
|
33
|
+
*/
|
|
34
|
+
upgradeHint: string;
|
|
35
|
+
/** The least time between two network checks, in milliseconds. Default 24 hours. `0` checks on every run. */
|
|
36
|
+
intervalMs?: number | undefined;
|
|
37
|
+
/** The longest the end of a command waits for the answer, counted from when the CLI started, in milliseconds. Default 1500. */
|
|
38
|
+
timeoutMs?: number | undefined;
|
|
39
|
+
}
|
|
40
|
+
/** {@link UpdateNoticeOptions} with the defaults applied. */
|
|
41
|
+
export interface ResolvedUpdateNotice {
|
|
42
|
+
readonly latestVersion: UpdateNoticeOptions['latestVersion'];
|
|
43
|
+
readonly upgradeHint: string;
|
|
44
|
+
readonly intervalMs: number;
|
|
45
|
+
readonly timeoutMs: number;
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* Validates `updateNotice` and applies the defaults.
|
|
49
|
+
*
|
|
50
|
+
* @throws UsageError when `latestVersion` is not a function, `upgradeHint` is
|
|
51
|
+
* empty or has a line break or control character, `intervalMs` is not a
|
|
52
|
+
* non-negative number, or `timeoutMs` is not a positive number.
|
|
53
|
+
* @internal
|
|
54
|
+
*/
|
|
55
|
+
export declare function resolveUpdateNotice(options: UpdateNoticeOptions): ResolvedUpdateNotice;
|
|
56
|
+
/**
|
|
57
|
+
* Sets the notice for this process; `createCli` calls it with
|
|
58
|
+
* `options.updateNotice`. `undefined` turns the feature off.
|
|
59
|
+
*
|
|
60
|
+
* @throws UsageError on invalid options; nothing is changed then.
|
|
61
|
+
* @internal
|
|
62
|
+
*/
|
|
63
|
+
export declare function setUpdateNotice(options: UpdateNoticeOptions | undefined): void;
|
|
64
|
+
/** Turns the feature off. Tests only (`resetCliForTests` calls it). */
|
|
65
|
+
export declare function resetUpdateNoticeForTests(): void;
|
|
66
|
+
/** The notice in force, or `undefined` when the app did not turn it on. @internal */
|
|
67
|
+
export declare function getUpdateNotice(): ResolvedUpdateNotice | undefined;
|
|
68
|
+
/** Whether `createCli` turned the notice on. @internal */
|
|
69
|
+
export declare function hasUpdateNotice(): boolean;
|
|
70
|
+
//# sourceMappingURL=update-notice-options.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"update-notice-options.d.ts","sourceRoot":"","sources":["../../src/engine/update-notice-options.ts"],"names":[],"mappings":"AAeA,yBAAyB;AACzB,eAAO,MAAM,gCAAgC,QAAsB,CAAC;AAEpE,6EAA6E;AAC7E,eAAO,MAAM,+BAA+B,OAAO,CAAC;AAEpD,6EAA6E;AAC7E,eAAO,MAAM,uBAAuB,sBAAsB,CAAC;AAE3D,gGAAgG;AAChG,eAAO,MAAM,0BAA0B,oBAAoB,CAAC;AAE5D;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;OASG;IACH,aAAa,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACrE;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,6GAA6G;IAC7G,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,+HAA+H;IAC/H,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED,6DAA6D;AAC7D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC,eAAe,CAAC,CAAC;IAC7D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAID;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,oBAAoB,CAwBtF;AAID;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,GAAG,IAAI,CAE9E;AAED,uEAAuE;AACvE,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED,qFAAqF;AACrF,wBAAgB,eAAe,IAAI,oBAAoB,GAAG,SAAS,CAElE;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,IAAI,OAAO,CAEzC"}
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
import { UsageError } from './errors.js';
|
|
2
|
+
// =============================================================================
|
|
3
|
+
// The update notice's options: validation and the one setting (issue #1033)
|
|
4
|
+
// =============================================================================
|
|
5
|
+
//
|
|
6
|
+
// Kept apart from `update-notice.ts` (the runtime: cache file, fetch, notice)
|
|
7
|
+
// ON PURPOSE. `registries.ts` must reach `resetUpdateNoticeForTests`, and
|
|
8
|
+
// `test-support.ts` (loaded by every test file's setup) imports `registries.ts`.
|
|
9
|
+
// Anything on that import chain is evaluated in the setup file, before a test
|
|
10
|
+
// file's `vi.mock`, so it can no longer be mocked there: when the runtime
|
|
11
|
+
// imported `config.js`, `config.test.ts`'s `vi.mock('node:fs')` silently stopped
|
|
12
|
+
// applying to it. This module imports nothing but `errors.js`.
|
|
13
|
+
// =============================================================================
|
|
14
|
+
/** One check per day. */
|
|
15
|
+
export const DEFAULT_UPDATE_CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
|
|
16
|
+
/** How long a command may be held back at its end waiting for the answer. */
|
|
17
|
+
export const DEFAULT_UPDATE_CHECK_TIMEOUT_MS = 1500;
|
|
18
|
+
/** Basename of the cache file in the CLI's state directory (`~/.<cli>/`). */
|
|
19
|
+
export const UPDATE_CHECK_CACHE_FILE = 'update-check.json';
|
|
20
|
+
/** The environment variable (suffix) that turns the check off: `<PREFIX>_NO_UPDATE_CHECK=1`. */
|
|
21
|
+
export const NO_UPDATE_CHECK_ENV_SUFFIX = 'NO_UPDATE_CHECK';
|
|
22
|
+
const CONTROL_CHARACTERS = /[\u0000-\u001f\u007f-\u009f\u2028\u2029]/;
|
|
23
|
+
/**
|
|
24
|
+
* Validates `updateNotice` and applies the defaults.
|
|
25
|
+
*
|
|
26
|
+
* @throws UsageError when `latestVersion` is not a function, `upgradeHint` is
|
|
27
|
+
* empty or has a line break or control character, `intervalMs` is not a
|
|
28
|
+
* non-negative number, or `timeoutMs` is not a positive number.
|
|
29
|
+
* @internal
|
|
30
|
+
*/
|
|
31
|
+
export function resolveUpdateNotice(options) {
|
|
32
|
+
if (typeof options !== 'object' || options === null || typeof options.latestVersion !== 'function') {
|
|
33
|
+
throw new UsageError('updateNotice.latestVersion must be a function returning the newest version (see githubRawManifest).');
|
|
34
|
+
}
|
|
35
|
+
if (typeof options.upgradeHint !== 'string' || options.upgradeHint.trim() === '') {
|
|
36
|
+
throw new UsageError('updateNotice.upgradeHint must be a non-empty string telling the operator how to update.');
|
|
37
|
+
}
|
|
38
|
+
if (CONTROL_CHARACTERS.test(options.upgradeHint)) {
|
|
39
|
+
throw new UsageError('updateNotice.upgradeHint must be a single line without control characters.');
|
|
40
|
+
}
|
|
41
|
+
const intervalMs = options.intervalMs ?? DEFAULT_UPDATE_CHECK_INTERVAL_MS;
|
|
42
|
+
if (typeof intervalMs !== 'number' || !Number.isFinite(intervalMs) || intervalMs < 0) {
|
|
43
|
+
throw new UsageError('updateNotice.intervalMs must be a non-negative number of milliseconds.');
|
|
44
|
+
}
|
|
45
|
+
const timeoutMs = options.timeoutMs ?? DEFAULT_UPDATE_CHECK_TIMEOUT_MS;
|
|
46
|
+
if (typeof timeoutMs !== 'number' || !Number.isFinite(timeoutMs) || timeoutMs <= 0) {
|
|
47
|
+
throw new UsageError('updateNotice.timeoutMs must be a positive number of milliseconds.');
|
|
48
|
+
}
|
|
49
|
+
return Object.freeze({
|
|
50
|
+
latestVersion: options.latestVersion,
|
|
51
|
+
upgradeHint: options.upgradeHint.trim(),
|
|
52
|
+
intervalMs,
|
|
53
|
+
timeoutMs,
|
|
54
|
+
});
|
|
55
|
+
}
|
|
56
|
+
let configured;
|
|
57
|
+
/**
|
|
58
|
+
* Sets the notice for this process; `createCli` calls it with
|
|
59
|
+
* `options.updateNotice`. `undefined` turns the feature off.
|
|
60
|
+
*
|
|
61
|
+
* @throws UsageError on invalid options; nothing is changed then.
|
|
62
|
+
* @internal
|
|
63
|
+
*/
|
|
64
|
+
export function setUpdateNotice(options) {
|
|
65
|
+
configured = options === undefined ? undefined : resolveUpdateNotice(options);
|
|
66
|
+
}
|
|
67
|
+
/** Turns the feature off. Tests only (`resetCliForTests` calls it). */
|
|
68
|
+
export function resetUpdateNoticeForTests() {
|
|
69
|
+
configured = undefined;
|
|
70
|
+
}
|
|
71
|
+
/** The notice in force, or `undefined` when the app did not turn it on. @internal */
|
|
72
|
+
export function getUpdateNotice() {
|
|
73
|
+
return configured;
|
|
74
|
+
}
|
|
75
|
+
/** Whether `createCli` turned the notice on. @internal */
|
|
76
|
+
export function hasUpdateNotice() {
|
|
77
|
+
return configured !== undefined;
|
|
78
|
+
}
|
|
79
|
+
//# sourceMappingURL=update-notice-options.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"update-notice-options.js","sourceRoot":"","sources":["../../src/engine/update-notice-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,gFAAgF;AAChF,6EAA6E;AAC7E,gFAAgF;AAChF,EAAE;AACF,8EAA8E;AAC9E,0EAA0E;AAC1E,iFAAiF;AACjF,8EAA8E;AAC9E,0EAA0E;AAC1E,iFAAiF;AACjF,+DAA+D;AAC/D,gFAAgF;AAEhF,yBAAyB;AACzB,MAAM,CAAC,MAAM,gCAAgC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEpE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAI,CAAC;AAEpD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;AAE3D,gGAAgG;AAChG,MAAM,CAAC,MAAM,0BAA0B,GAAG,iBAAiB,CAAC;AA0C5D,MAAM,kBAAkB,GAAG,0CAA0C,CAAC;AAEtE;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA4B;IAC9D,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;QACnG,MAAM,IAAI,UAAU,CAAC,qGAAqG,CAAC,CAAC;IAC9H,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACjF,MAAM,IAAI,UAAU,CAAC,yFAAyF,CAAC,CAAC;IAClH,CAAC;IACD,IAAI,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,UAAU,CAAC,4EAA4E,CAAC,CAAC;IACrG,CAAC;IACD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,gCAAgC,CAAC;IAC1E,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACrF,MAAM,IAAI,UAAU,CAAC,wEAAwE,CAAC,CAAC;IACjG,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,+BAA+B,CAAC;IACvE,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACnF,MAAM,IAAI,UAAU,CAAC,mEAAmE,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE;QACvC,UAAU;QACV,SAAS;KACV,CAAC,CAAC;AACL,CAAC;AAED,IAAI,UAA4C,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,OAAwC;IACtE,UAAU,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAChF,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,yBAAyB;IACvC,UAAU,GAAG,SAAS,CAAC;AACzB,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,KAAK,SAAS,CAAC;AAClC,CAAC"}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import { type ConfigContext } from './config.js';
|
|
2
|
+
import type { TtyLike } from './tui/tty.js';
|
|
3
|
+
/** Why a run does not check. Distinct values so a test asserts the cause. */
|
|
4
|
+
export type UpdateCheckSkipReason = 'opted-out' | 'ci' | 'stderr-not-a-tty' | 'json' | 'version' | 'help' | 'node-daemon';
|
|
5
|
+
/**
|
|
6
|
+
* Decides whether this invocation must not check for an update.
|
|
7
|
+
*
|
|
8
|
+
* Order: the operator's own opt-out first (the most actionable cause), then
|
|
9
|
+
* the environment, then what the command line asks for. Arguments after a
|
|
10
|
+
* lone `--` belong to the command and are not read.
|
|
11
|
+
*
|
|
12
|
+
* `node start` is the worker daemon (also what the systemd unit runs, and what
|
|
13
|
+
* `node start --daemon` re-spawns): long-running, unattended, and its stderr is
|
|
14
|
+
* a log. The rest of the `node` group is interactive and does check.
|
|
15
|
+
*
|
|
16
|
+
* @returns The reason to skip, or `undefined` to check.
|
|
17
|
+
* @internal
|
|
18
|
+
*/
|
|
19
|
+
export declare function updateCheckSkipReason(argv: readonly string[], env: NodeJS.ProcessEnv, stderr: TtyLike): UpdateCheckSkipReason | undefined;
|
|
20
|
+
/** The cache file's path, `~/.<cli>/update-check.json`. */
|
|
21
|
+
export declare function updateCheckCachePath(ctx?: ConfigContext): string;
|
|
22
|
+
/**
|
|
23
|
+
* Seams for the update check that `run` starts; every field defaults to the real
|
|
24
|
+
* process. A test passes these instead of mutating `process.env`, `HOME` or
|
|
25
|
+
* the clock.
|
|
26
|
+
*
|
|
27
|
+
* @stability experimental
|
|
28
|
+
*/
|
|
29
|
+
export interface UpdateCheckContext {
|
|
30
|
+
/** Defaults to `process.env` (`CI`, `<PREFIX>_NO_UPDATE_CHECK`). */
|
|
31
|
+
env?: NodeJS.ProcessEnv | undefined;
|
|
32
|
+
/** The home directory the cache lives under. Defaults to `os.homedir()`. */
|
|
33
|
+
home?: string | undefined;
|
|
34
|
+
/** Where the notice is written, and whose `isTTY` is read. Defaults to `process.stderr`. */
|
|
35
|
+
stderr?: (TtyLike & {
|
|
36
|
+
/** Writes the one-line notice. */
|
|
37
|
+
write(chunk: string): unknown;
|
|
38
|
+
}) | undefined;
|
|
39
|
+
/** The clock, in epoch milliseconds. Defaults to `Date.now`. */
|
|
40
|
+
now?: (() => number) | undefined;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* What {@link beginUpdateCheck} returns.
|
|
44
|
+
*
|
|
45
|
+
* @internal
|
|
46
|
+
*/
|
|
47
|
+
export interface UpdateCheckHandle {
|
|
48
|
+
/**
|
|
49
|
+
* Call once, after the command has finished. Waits at most what is left of
|
|
50
|
+
* the timeout for the fetch, stores the answer and writes the notice when a
|
|
51
|
+
* newer version exists. Resolves always; never throws.
|
|
52
|
+
*/
|
|
53
|
+
finish(): Promise<void>;
|
|
54
|
+
}
|
|
55
|
+
/** The one line. `latest` and `current` are proven semver by the caller. */
|
|
56
|
+
export declare function formatUpdateNotice(latest: string, current: string, upgradeHint: string): string;
|
|
57
|
+
/**
|
|
58
|
+
* Starts the update check for one `run()`. Call it before the command runs and
|
|
59
|
+
* `finish()` after; in between nothing waits on the network.
|
|
60
|
+
*
|
|
61
|
+
* Returns a no-op handle (reading nothing, starting nothing) when the feature
|
|
62
|
+
* is off, when the invocation is one of the skipped kinds, or on any error.
|
|
63
|
+
*
|
|
64
|
+
* @param argv - The arguments of this run.
|
|
65
|
+
* @param ctx - Seams; defaults to the real process.
|
|
66
|
+
* @internal
|
|
67
|
+
*/
|
|
68
|
+
export declare function beginUpdateCheck(argv: readonly string[], ctx?: UpdateCheckContext): UpdateCheckHandle;
|
|
69
|
+
//# sourceMappingURL=update-notice.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"update-notice.d.ts","sourceRoot":"","sources":["../../src/engine/update-notice.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAIhE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AA4C5C,6EAA6E;AAC7E,MAAM,MAAM,qBAAqB,GAC7B,WAAW,GACX,IAAI,GACJ,kBAAkB,GAClB,MAAM,GACN,SAAS,GACT,MAAM,GACN,aAAa,CAAC;AASlB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,MAAM,EAAE,OAAO,GACd,qBAAqB,GAAG,SAAS,CAgBnC;AAgBD,2DAA2D;AAC3D,wBAAgB,oBAAoB,CAAC,GAAG,CAAC,EAAE,aAAa,GAAG,MAAM,CAEhE;AA+CD;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;IACpC,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,4FAA4F;IAC5F,MAAM,CAAC,EACH,CAAC,OAAO,GAAG;QACT,kCAAkC;QAClC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;KAC/B,CAAC,GACF,SAAS,CAAC;IACd,gEAAgE;IAChE,GAAG,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAID,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAE/F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,kBAAkB,GAAG,iBAAiB,CAkFrG"}
|