vouchington-tooling 0.62.0 → 0.64.0

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 (113) hide show
  1. package/README.md +147 -0
  2. package/dist/cli/commands/cloc.d.mts +7 -0
  3. package/dist/cli/commands/cloc.mjs +47 -0
  4. package/dist/cli/commands/storybook-browser-runner.d.mts +7 -0
  5. package/dist/cli/commands/storybook-browser-runner.mjs +29 -0
  6. package/dist/cli/index.mjs +4 -0
  7. package/dist/cli/parse-forwarded-commands.d.mts +6 -0
  8. package/dist/cli/parse-forwarded-commands.mjs +4 -0
  9. package/dist/cli/parse.d.mts +6 -0
  10. package/dist/cli/usage-text.d.mts +1 -1
  11. package/dist/cli/usage-text.mjs +18 -0
  12. package/dist/cloc/child-process.d.mts +3 -0
  13. package/dist/cloc/child-process.mjs +14 -0
  14. package/dist/cloc/classify.d.mts +8 -0
  15. package/dist/cloc/classify.mjs +20 -0
  16. package/dist/cloc/config-load.d.mts +7 -0
  17. package/dist/cloc/config-load.mjs +26 -0
  18. package/dist/cloc/config.d.mts +55 -0
  19. package/dist/cloc/config.mjs +109 -0
  20. package/dist/cloc/count.d.mts +9 -0
  21. package/dist/cloc/count.mjs +33 -0
  22. package/dist/cloc/index.d.mts +12 -0
  23. package/dist/cloc/index.mjs +7 -0
  24. package/dist/cloc/layout.test-helpers.d.mts +8 -0
  25. package/dist/cloc/layout.test-helpers.mjs +42 -0
  26. package/dist/cloc/paths.d.mts +7 -0
  27. package/dist/cloc/paths.mjs +29 -0
  28. package/dist/cloc/patterns.d.mts +10 -0
  29. package/dist/cloc/patterns.mjs +25 -0
  30. package/dist/cloc/rows.d.mts +13 -0
  31. package/dist/cloc/rows.mjs +42 -0
  32. package/dist/cloc/scc.d.mts +10 -0
  33. package/dist/cloc/scc.mjs +55 -0
  34. package/dist/cloc/tracked.d.mts +4 -0
  35. package/dist/cloc/tracked.mjs +40 -0
  36. package/dist/postgres-test-faults/fault-support.d.mts +11 -0
  37. package/dist/postgres-test-faults/fault-support.mjs +61 -0
  38. package/dist/postgres-test-faults/fault-types.d.mts +43 -0
  39. package/dist/postgres-test-faults/fault-types.mjs +1 -0
  40. package/dist/postgres-test-faults/index.d.mts +5 -0
  41. package/dist/postgres-test-faults/index.mjs +4 -0
  42. package/dist/postgres-test-faults/lock-observers.d.mts +20 -0
  43. package/dist/postgres-test-faults/lock-observers.mjs +14 -0
  44. package/dist/postgres-test-faults/lock-wait.d.mts +13 -0
  45. package/dist/postgres-test-faults/lock-wait.mjs +62 -0
  46. package/dist/postgres-test-faults/lock-waiter.d.mts +19 -0
  47. package/dist/postgres-test-faults/lock-waiter.mjs +95 -0
  48. package/dist/postgres-test-faults/observation-queue.d.mts +2 -0
  49. package/dist/postgres-test-faults/observation-queue.mjs +22 -0
  50. package/dist/postgres-test-faults/polling.d.mts +6 -0
  51. package/dist/postgres-test-faults/polling.mjs +33 -0
  52. package/dist/postgres-test-faults/pool-query-failure.d.mts +8 -0
  53. package/dist/postgres-test-faults/pool-query-failure.mjs +136 -0
  54. package/dist/postgres-test-faults/query-failure.d.mts +8 -0
  55. package/dist/postgres-test-faults/query-failure.mjs +108 -0
  56. package/dist/postgres-test-faults/test-cluster.test-helpers.d.mts +13 -0
  57. package/dist/postgres-test-faults/test-cluster.test-helpers.mjs +84 -0
  58. package/dist/provider-replay/abort-listeners.d.mts +4 -0
  59. package/dist/provider-replay/abort-listeners.mjs +19 -0
  60. package/dist/provider-replay/aws-replay-abort-signal.d.mts +5 -0
  61. package/dist/provider-replay/aws-replay-abort-signal.mjs +63 -0
  62. package/dist/provider-replay/aws-replay-request-handler.d.mts +38 -0
  63. package/dist/provider-replay/aws-replay-request-handler.mjs +66 -0
  64. package/dist/provider-replay/force-client-option.d.mts +6 -0
  65. package/dist/provider-replay/force-client-option.mjs +13 -0
  66. package/dist/provider-replay/index.d.mts +6 -0
  67. package/dist/provider-replay/index.mjs +6 -0
  68. package/dist/provider-replay/provider-replay.d.mts +32 -0
  69. package/dist/provider-replay/provider-replay.mjs +54 -0
  70. package/dist/provider-replay/recorded-response.d.mts +17 -0
  71. package/dist/provider-replay/recorded-response.mjs +42 -0
  72. package/dist/provider-replay/replay-response.d.mts +8 -0
  73. package/dist/provider-replay/replay-response.mjs +38 -0
  74. package/dist/storybook-browser-runner/args.d.mts +8 -0
  75. package/dist/storybook-browser-runner/args.mjs +52 -0
  76. package/dist/storybook-browser-runner/attempt-result.d.mts +41 -0
  77. package/dist/storybook-browser-runner/attempt-result.mjs +108 -0
  78. package/dist/storybook-browser-runner/bootstrap-telemetry.d.mts +35 -0
  79. package/dist/storybook-browser-runner/bootstrap-telemetry.mjs +138 -0
  80. package/dist/storybook-browser-runner/cache-plan.d.mts +22 -0
  81. package/dist/storybook-browser-runner/cache-plan.mjs +53 -0
  82. package/dist/storybook-browser-runner/diagnostics.d.mts +8 -0
  83. package/dist/storybook-browser-runner/diagnostics.mjs +29 -0
  84. package/dist/storybook-browser-runner/env.d.mts +2 -0
  85. package/dist/storybook-browser-runner/env.mjs +59 -0
  86. package/dist/storybook-browser-runner/fixtures.test-helpers.d.mts +49 -0
  87. package/dist/storybook-browser-runner/fixtures.test-helpers.mjs +95 -0
  88. package/dist/storybook-browser-runner/index.d.mts +15 -0
  89. package/dist/storybook-browser-runner/index.mjs +70 -0
  90. package/dist/storybook-browser-runner/observer-state.d.mts +22 -0
  91. package/dist/storybook-browser-runner/observer-state.mjs +21 -0
  92. package/dist/storybook-browser-runner/options.d.mts +18 -0
  93. package/dist/storybook-browser-runner/options.mjs +49 -0
  94. package/dist/storybook-browser-runner/output-observer.d.mts +37 -0
  95. package/dist/storybook-browser-runner/output-observer.mjs +130 -0
  96. package/dist/storybook-browser-runner/output-patterns.d.mts +14 -0
  97. package/dist/storybook-browser-runner/output-patterns.mjs +26 -0
  98. package/dist/storybook-browser-runner/quiet-output.d.mts +16 -0
  99. package/dist/storybook-browser-runner/quiet-output.mjs +79 -0
  100. package/dist/storybook-browser-runner/run-attempt.d.mts +14 -0
  101. package/dist/storybook-browser-runner/run-attempt.mjs +111 -0
  102. package/dist/storybook-browser-runner/runtime-metadata.d.mts +12 -0
  103. package/dist/storybook-browser-runner/runtime-metadata.mjs +50 -0
  104. package/dist/storybook-browser-runner/session-deps.d.mts +11 -0
  105. package/dist/storybook-browser-runner/session-deps.mjs +70 -0
  106. package/dist/storybook-browser-runner/types.d.mts +49 -0
  107. package/dist/storybook-browser-runner/types.mjs +1 -0
  108. package/dist/storybook-browser-runner/vite-detectors.d.mts +6 -0
  109. package/dist/storybook-browser-runner/vite-detectors.mjs +20 -0
  110. package/dist/storybook-browser-runner/watchdog.d.mts +23 -0
  111. package/dist/storybook-browser-runner/watchdog.mjs +55 -0
  112. package/package.json +27 -1
  113. package/scripts/__pycache__/run_bounded_process.cpython-312.pyc +0 -0
@@ -0,0 +1,23 @@
1
+ import type { BrowserSessionWatchdog } from '../browser-session-runner/index.mts';
2
+ import type { OutputObserver } from './output-observer.mts';
3
+ import type { StorybookBrowserRunnerDeps } from './types.mts';
4
+ /** What the watchdog decided, read by the attempt result once the session ends. */
5
+ export type WatchdogOutcome = {
6
+ hung: boolean;
7
+ resultFileDetectedAt: number | null;
8
+ semanticStall: boolean;
9
+ stalled: boolean;
10
+ };
11
+ export type StorybookWatchdogOptions = {
12
+ completionFile: string | undefined;
13
+ deps: Pick<StorybookBrowserRunnerDeps, 'clearInterval' | 'cwd' | 'existsSync' | 'now' | 'setInterval' | 'stderr'>;
14
+ hangMs: number;
15
+ observer: OutputObserver;
16
+ outcome: WatchdogOutcome;
17
+ stallMs: number;
18
+ };
19
+ /** Terminates the attempt on an optimizer stall, a mid-suite stall, or a tester-connection hang. */
20
+ export declare function createStorybookWatchdog(options: StorybookWatchdogOptions): BrowserSessionWatchdog;
21
+ /** Records when the completion file first appears; also sampled once more as an attempt ends. */
22
+ export declare function sampleCompletionFile(options: Pick<StorybookWatchdogOptions, 'completionFile' | 'deps' | 'outcome'>): void;
23
+ export declare function isSpawnedProcessGroupId(processGroupId: number | undefined): processGroupId is number;
@@ -0,0 +1,55 @@
1
+ import { resolve } from 'node:path';
2
+ const MAX_WATCHDOG_INTERVAL_MS = 5000;
3
+ /** Terminates the attempt on an optimizer stall, a mid-suite stall, or a tester-connection hang. */
4
+ export function createStorybookWatchdog(options) {
5
+ const { deps, hangMs, observer, outcome, stallMs } = options;
6
+ return (controller) => {
7
+ // The first decision is final: later ticks during the termination grace must not repeat it.
8
+ let decided = false;
9
+ const check = () => {
10
+ const now = deps.now();
11
+ sampleCompletionFile(options);
12
+ if (decided)
13
+ return;
14
+ const seen = observer.snapshot();
15
+ if (!seen.semanticProgressSeen &&
16
+ seen.optimizerLastProgressAt != null &&
17
+ now - seen.optimizerLastProgressAt >= stallMs) {
18
+ outcome.stalled = true;
19
+ deps.stderr.write(`[storybook-browser] Vite optimizer made no startup progress for ${stallMs}ms; terminating attempt\n`);
20
+ decided = true;
21
+ controller.terminate();
22
+ }
23
+ else if (seen.semanticProgressSeen && now - seen.lastSemanticProgressAt >= hangMs) {
24
+ outcome.semanticStall = true;
25
+ deps.stderr.write(`[storybook-browser] no semantic test progress for ${hangMs}ms; terminating terminal mid-suite stall\n`);
26
+ decided = true;
27
+ controller.terminate();
28
+ }
29
+ else if (seen.anyOutputSeen &&
30
+ !seen.semanticProgressSeen &&
31
+ now - seen.lastHangProgressAt >= hangMs) {
32
+ outcome.hung = true;
33
+ deps.stderr.write(`[storybook-browser] no test output for ${hangMs}ms after Vite startup — suspected Vitest/Chromium tester-connection hang; last output:\n${seen.outputBuffer}\n`);
34
+ decided = true;
35
+ controller.terminate();
36
+ }
37
+ };
38
+ const interval = deps.setInterval(check, Math.min(MAX_WATCHDOG_INTERVAL_MS, stallMs, hangMs));
39
+ return () => deps.clearInterval(interval);
40
+ };
41
+ }
42
+ /** Records when the completion file first appears; also sampled once more as an attempt ends. */
43
+ export function sampleCompletionFile(options) {
44
+ const { completionFile, deps, outcome } = options;
45
+ if (!completionFile || outcome.resultFileDetectedAt != null)
46
+ return;
47
+ if (deps.existsSync(resolve(deps.cwd, completionFile)))
48
+ outcome.resultFileDetectedAt = deps.now();
49
+ }
50
+ export function isSpawnedProcessGroupId(processGroupId) {
51
+ return (processGroupId != null &&
52
+ Number.isSafeInteger(processGroupId) &&
53
+ processGroupId > 1 &&
54
+ processGroupId <= 2_147_483_647);
55
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "vouchington-tooling",
3
- "version": "0.62.0",
3
+ "version": "0.64.0",
4
4
  "description": "Vouchington CLI and extractable tooling libraries.",
5
5
  "homepage": "https://github.com/vouchington/vouchington-tooling/tree/main/packages/vouchington-tooling#readme",
6
6
  "bugs": {
@@ -261,6 +261,11 @@
261
261
  "import": "./dist/gha-check-run/index.mjs",
262
262
  "default": "./dist/gha-check-run/index.mjs"
263
263
  },
264
+ "./provider-replay": {
265
+ "types": "./dist/provider-replay/index.d.mts",
266
+ "import": "./dist/provider-replay/index.mjs",
267
+ "default": "./dist/provider-replay/index.mjs"
268
+ },
264
269
  "./http-link-pagination": {
265
270
  "types": "./dist/http-link-pagination/index.d.mts",
266
271
  "import": "./dist/http-link-pagination/index.mjs",
@@ -316,6 +321,16 @@
316
321
  "import": "./dist/dead-code/index.mjs",
317
322
  "default": "./dist/dead-code/index.mjs"
318
323
  },
324
+ "./cloc": {
325
+ "types": "./dist/cloc/index.d.mts",
326
+ "import": "./dist/cloc/index.mjs",
327
+ "default": "./dist/cloc/index.mjs"
328
+ },
329
+ "./storybook-browser-runner": {
330
+ "types": "./dist/storybook-browser-runner/index.d.mts",
331
+ "import": "./dist/storybook-browser-runner/index.mjs",
332
+ "default": "./dist/storybook-browser-runner/index.mjs"
333
+ },
319
334
  "./sandbox-command-audit": {
320
335
  "types": "./dist/sandbox-command-audit/index.d.mts",
321
336
  "import": "./dist/sandbox-command-audit/index.mjs",
@@ -401,6 +416,11 @@
401
416
  "import": "./dist/gh-api-shell-quoting/index.mjs",
402
417
  "default": "./dist/gh-api-shell-quoting/index.mjs"
403
418
  },
419
+ "./postgres-test-faults": {
420
+ "types": "./dist/postgres-test-faults/index.d.mts",
421
+ "import": "./dist/postgres-test-faults/index.mjs",
422
+ "default": "./dist/postgres-test-faults/index.mjs"
423
+ },
404
424
  "./package.json": "./package.json",
405
425
  "./basic-auth-doc-sync": {
406
426
  "types": "./dist/basic-auth-doc-sync/index.d.mts",
@@ -465,12 +485,14 @@
465
485
  "@ast-grep/cli": "0.50.0",
466
486
  "@modelcontextprotocol/sdk": "1.32.1",
467
487
  "@playwright/test": "1.64.1",
488
+ "@types/pg": "8.23.1",
468
489
  "@types/picomatch": "^4.0.3",
469
490
  "@types/react": "19.3.0",
470
491
  "@types/react-dom": "19.3.0",
471
492
  "@types/spdx-expression-parse": "4.0.0",
472
493
  "next": "16.4.2",
473
494
  "no-mistakes": "0.83.0",
495
+ "pg": "8.23.1",
474
496
  "react": "19.3.1",
475
497
  "react-dom": "19.3.1",
476
498
  "smol-toml": "1.9.1",
@@ -481,6 +503,7 @@
481
503
  "@playwright/test": ">=1.64.1",
482
504
  "next": ">=15",
483
505
  "no-mistakes": "*",
506
+ "pg": ">=8",
484
507
  "react": ">=18",
485
508
  "typescript": ">=5",
486
509
  "vitest": ">=5"
@@ -498,6 +521,9 @@
498
521
  "no-mistakes": {
499
522
  "optional": true
500
523
  },
524
+ "pg": {
525
+ "optional": true
526
+ },
501
527
  "react": {
502
528
  "optional": true
503
529
  },