@marinoscar/platform-cli 0.1.0-next.16 → 0.1.0-next.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/CHANGELOG.md +15 -0
  2. package/README.md +31 -2
  3. package/dist/engine/create-cli.d.ts +10 -1
  4. package/dist/engine/create-cli.d.ts.map +1 -1
  5. package/dist/engine/create-cli.js +5 -1
  6. package/dist/engine/create-cli.js.map +1 -1
  7. package/dist/engine/github-raw-manifest.d.ts +59 -0
  8. package/dist/engine/github-raw-manifest.d.ts.map +1 -0
  9. package/dist/engine/github-raw-manifest.js +197 -0
  10. package/dist/engine/github-raw-manifest.js.map +1 -0
  11. package/dist/engine/index.d.ts +4 -0
  12. package/dist/engine/index.d.ts.map +1 -1
  13. package/dist/engine/index.js +3 -0
  14. package/dist/engine/index.js.map +1 -1
  15. package/dist/engine/program.d.ts +3 -0
  16. package/dist/engine/program.d.ts.map +1 -1
  17. package/dist/engine/program.js +16 -0
  18. package/dist/engine/program.js.map +1 -1
  19. package/dist/engine/registries.d.ts.map +1 -1
  20. package/dist/engine/registries.js +2 -0
  21. package/dist/engine/registries.js.map +1 -1
  22. package/dist/engine/semver.d.ts +31 -0
  23. package/dist/engine/semver.d.ts.map +1 -0
  24. package/dist/engine/semver.js +100 -0
  25. package/dist/engine/semver.js.map +1 -0
  26. package/dist/engine/update-notice-options.d.ts +70 -0
  27. package/dist/engine/update-notice-options.d.ts.map +1 -0
  28. package/dist/engine/update-notice-options.js +79 -0
  29. package/dist/engine/update-notice-options.js.map +1 -0
  30. package/dist/engine/update-notice.d.ts +69 -0
  31. package/dist/engine/update-notice.d.ts.map +1 -0
  32. package/dist/engine/update-notice.js +204 -0
  33. package/dist/engine/update-notice.js.map +1 -0
  34. package/dist/index.d.ts +2 -2
  35. package/dist/index.d.ts.map +1 -1
  36. package/dist/index.js +1 -1
  37. package/dist/index.js.map +1 -1
  38. package/package.json +3 -3
@@ -1 +1 @@
1
- {"version":3,"file":"program.js","sourceRoot":"","sources":["../../src/engine/program.ts"],"names":[],"mappings":"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"}
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":"AAkCA,6DAA6D;AAC7D,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAapD;AAED,4DAA4D;AAC5D,wBAAgB,0BAA0B,IAAI,IAAI,CAajD"}
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;AAEnG,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;AACpC,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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"}
@@ -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"}
@@ -0,0 +1,204 @@
1
+ import { randomBytes } from 'node:crypto';
2
+ import { mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs';
3
+ import { dirname, join } from 'node:path';
4
+ import { configDirPath } from './config.js';
5
+ import { cliName, cliVersion, envVar } from './identity.js';
6
+ import { isNewerVersion, parseSemver } from './semver.js';
7
+ import { NO_UPDATE_CHECK_ENV_SUFFIX, UPDATE_CHECK_CACHE_FILE, getUpdateNotice } from './update-notice-options.js';
8
+ /** The same reading of a flag-like variable as the TUI gate: unset, empty, `0`, `false`, `no` are off. */
9
+ function isEnvFlagSet(value) {
10
+ if (value === undefined)
11
+ return false;
12
+ const normalised = value.trim().toLowerCase();
13
+ return normalised.length > 0 && normalised !== '0' && normalised !== 'false' && normalised !== 'no';
14
+ }
15
+ /**
16
+ * Decides whether this invocation must not check for an update.
17
+ *
18
+ * Order: the operator's own opt-out first (the most actionable cause), then
19
+ * the environment, then what the command line asks for. Arguments after a
20
+ * lone `--` belong to the command and are not read.
21
+ *
22
+ * `node start` is the worker daemon (also what the systemd unit runs, and what
23
+ * `node start --daemon` re-spawns): long-running, unattended, and its stderr is
24
+ * a log. The rest of the `node` group is interactive and does check.
25
+ *
26
+ * @returns The reason to skip, or `undefined` to check.
27
+ * @internal
28
+ */
29
+ export function updateCheckSkipReason(argv, env, stderr) {
30
+ if (isEnvFlagSet(env[envVar(NO_UPDATE_CHECK_ENV_SUFFIX)]))
31
+ return 'opted-out';
32
+ if (isEnvFlagSet(env.CI) || isEnvFlagSet(env.CONTINUOUS_INTEGRATION))
33
+ return 'ci';
34
+ // `isTTY` is undefined, not false, on a pipe: compare with `!== true`.
35
+ if (stderr.isTTY !== true)
36
+ return 'stderr-not-a-tty';
37
+ const end = argv.indexOf('--');
38
+ const args = end === -1 ? argv : argv.slice(0, end);
39
+ if (args.includes('--json'))
40
+ return 'json';
41
+ if (args.includes('--version') || args.includes('-V') || args.includes('-v'))
42
+ return 'version';
43
+ if (args.includes('--help') || args.includes('-h'))
44
+ return 'help';
45
+ const positionals = args.filter((arg) => !arg.startsWith('-'));
46
+ if (positionals[0] === 'help')
47
+ return 'help';
48
+ if (positionals[0] === 'node' && positionals[1] === 'start')
49
+ return 'node-daemon';
50
+ return undefined;
51
+ }
52
+ /** The file is two short fields; anything larger is not ours. */
53
+ const MAX_CACHE_BYTES = 4096;
54
+ /** The cache file's path, `~/.<cli>/update-check.json`. */
55
+ export function updateCheckCachePath(ctx) {
56
+ return join(configDirPath(ctx), UPDATE_CHECK_CACHE_FILE);
57
+ }
58
+ /** Reads the cache; `undefined` when it is missing, unreadable, too large or not the expected shape. */
59
+ function readCache(path) {
60
+ try {
61
+ if (statSync(path).size > MAX_CACHE_BYTES)
62
+ return undefined;
63
+ const parsed = JSON.parse(readFileSync(path, 'utf8'));
64
+ if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
65
+ return undefined;
66
+ const { checkedAt, latest } = parsed;
67
+ if (typeof checkedAt !== 'string')
68
+ return undefined;
69
+ const time = Date.parse(checkedAt);
70
+ if (!Number.isFinite(time))
71
+ return undefined;
72
+ return { checkedAt: time, latest: parseSemver(latest) === undefined ? undefined : latest };
73
+ }
74
+ catch {
75
+ return undefined;
76
+ }
77
+ }
78
+ /**
79
+ * Writes the cache atomically, owner-only: a temp file created exclusively with
80
+ * mode 0600 and renamed over the target, so a reader never sees half a file and
81
+ * a concurrent run cannot corrupt it. Best effort; a failure is swallowed.
82
+ */
83
+ function writeCache(path, cache) {
84
+ const dir = dirname(path);
85
+ const tmp = `${path}.${String(process.pid)}.${randomBytes(6).toString('hex')}.tmp`;
86
+ try {
87
+ mkdirSync(dir, { recursive: true, mode: 0o700 });
88
+ const body = {
89
+ checkedAt: new Date(cache.checkedAt).toISOString(),
90
+ ...(cache.latest !== undefined ? { latest: cache.latest } : {}),
91
+ };
92
+ writeFileSync(tmp, `${JSON.stringify(body, null, 2)}\n`, { encoding: 'utf8', mode: 0o600, flag: 'wx' });
93
+ renameSync(tmp, path);
94
+ }
95
+ catch {
96
+ try {
97
+ rmSync(tmp, { force: true });
98
+ }
99
+ catch {
100
+ // Nothing useful to do.
101
+ }
102
+ }
103
+ }
104
+ const NOOP_HANDLE = Object.freeze({ finish: async () => undefined });
105
+ /** The one line. `latest` and `current` are proven semver by the caller. */
106
+ export function formatUpdateNotice(latest, current, upgradeHint) {
107
+ return `${cliName()} ${latest} is available (you have ${current}). Update: ${upgradeHint}\n`;
108
+ }
109
+ /**
110
+ * Starts the update check for one `run()`. Call it before the command runs and
111
+ * `finish()` after; in between nothing waits on the network.
112
+ *
113
+ * Returns a no-op handle (reading nothing, starting nothing) when the feature
114
+ * is off, when the invocation is one of the skipped kinds, or on any error.
115
+ *
116
+ * @param argv - The arguments of this run.
117
+ * @param ctx - Seams; defaults to the real process.
118
+ * @internal
119
+ */
120
+ export function beginUpdateCheck(argv, ctx) {
121
+ try {
122
+ const notice = getUpdateNotice();
123
+ if (notice === undefined)
124
+ return NOOP_HANDLE;
125
+ const env = ctx?.env ?? process.env;
126
+ const stderr = ctx?.stderr ?? process.stderr;
127
+ const now = ctx?.now ?? Date.now;
128
+ if (updateCheckSkipReason(argv, env, stderr) !== undefined)
129
+ return NOOP_HANDLE;
130
+ const current = cliVersion();
131
+ if (parseSemver(current) === undefined)
132
+ return NOOP_HANDLE;
133
+ const cachePath = updateCheckCachePath(ctx?.home !== undefined ? { home: ctx.home } : {});
134
+ const cache = readCache(cachePath);
135
+ const announce = (latest) => {
136
+ try {
137
+ if (latest !== undefined && isNewerVersion(latest, current)) {
138
+ stderr.write(formatUpdateNotice(latest, current, notice.upgradeHint));
139
+ }
140
+ }
141
+ catch {
142
+ // A closed or broken stderr must not fail a command that succeeded.
143
+ }
144
+ };
145
+ const started = now();
146
+ // A cache dated in the future (a clock set back, an edited file) is stale:
147
+ // trusting it would suppress the check until that date.
148
+ const fresh = cache !== undefined && cache.checkedAt <= started && started - cache.checkedAt < notice.intervalMs;
149
+ if (fresh) {
150
+ return { finish: async () => announce(cache.latest) };
151
+ }
152
+ // THE FETCH STARTS NOW, in parallel with the command, and is not awaited here.
153
+ const controller = new AbortController();
154
+ const work = (async () => {
155
+ try {
156
+ const value = await notice.latestVersion(controller.signal);
157
+ return parseSemver(value) === undefined ? undefined : value;
158
+ }
159
+ catch {
160
+ return undefined;
161
+ }
162
+ })();
163
+ // The deadline is counted from the start, so a command that ran longer than
164
+ // the timeout leaves nothing to wait for. The timer is NOT unref'd: while
165
+ // `finish` awaits a promise that no handle backs (a `latestVersion` that
166
+ // never settles), an unref'd timer would let Node exit mid-await and drop
167
+ // the exit code. It is cleared in `finish`.
168
+ let timer;
169
+ const TIMED_OUT = Symbol('timed out');
170
+ const deadline = new Promise((resolve) => {
171
+ timer = setTimeout(() => {
172
+ controller.abort();
173
+ resolve(TIMED_OUT);
174
+ }, notice.timeoutMs);
175
+ });
176
+ return {
177
+ finish: async () => {
178
+ try {
179
+ // `work` first: when both are settled, the answer wins over the deadline.
180
+ const outcome = await Promise.race([work, deadline]);
181
+ const fetched = outcome === TIMED_OUT ? undefined : outcome;
182
+ // A failed check keeps the last known version: it is stale, but still
183
+ // true, and recording the attempt is what stops an offline server from
184
+ // retrying on every command.
185
+ const latest = fetched ?? cache?.latest;
186
+ writeCache(cachePath, { checkedAt: started, latest });
187
+ announce(latest);
188
+ }
189
+ catch {
190
+ // Swallowed: see rule 3.
191
+ }
192
+ finally {
193
+ if (timer !== undefined)
194
+ clearTimeout(timer);
195
+ controller.abort();
196
+ }
197
+ },
198
+ };
199
+ }
200
+ catch {
201
+ return NOOP_HANDLE;
202
+ }
203
+ }
204
+ //# sourceMappingURL=update-notice.js.map