vouchington-tooling 0.1.1 → 0.1.2

package/README.md

@@ -90,7 +90,11 @@ import {
 import { createArtifactClassifier, runCleanup } from 'vouchington-tooling/gha-artifacts-cleanup'
 import { validateOptionalHttpOrigin } from 'vouchington-tooling/http-origin'
 import { boundPendingLine, splitCompleteLines } from 'vouchington-tooling/process-line-buffer'
-import { runBrowserSession } from 'vouchington-tooling/browser-session-runner'
+import {
+  isProcessGroupAlive,
+  runBrowserSession,
+  waitForProcessGroupExit,
+} from 'vouchington-tooling/browser-session-runner'
 import {
   generateSchemaSnapshot,
   renderSchemaMarkdown,
@@ -144,3 +148,5 @@ are terminal. Output is decoded independently per stream; unfinished lines are c
 `diagnosticTailBytes` retains a UTF-8-safe tail no larger than its byte budget.
 The runner uses monotonic elapsed time, rejects timer budgets above Node's maximum delay, and waits for
 the dedicated process group to exit after the direct child closes so descendants cannot overlap a retry.
+`isProcessGroupAlive` and `waitForProcessGroupExit` are also available when callers need the same
+process-group probe and bounded-drain semantics outside a browser session.

package/dist/browser-session-runner/index.d.mts

@@ -1,4 +1,4 @@
 import type { BrowserSessionDeps, BrowserSessionOptions, BrowserSessionResult } from './types.mts';
 export type { BrowserSessionDeps, BrowserSessionEvent, BrowserSessionExit, BrowserSessionOptions, BrowserSessionOutput, BrowserSessionProcess, BrowserSessionResult, BrowserSessionTerminationReason, BrowserSessionWatchdog, BrowserSessionWatchdogCleanup, BrowserSessionWatchdogController, } from './types.mts';
-export { ProcessGroupDrainTimeoutError } from './process-group.mts';
+export { isProcessGroupAlive, ProcessGroupDrainTimeoutError, waitForProcessGroupExit, } from './process-group.mts';
 export declare function runBrowserSession(options: BrowserSessionOptions, deps?: BrowserSessionDeps): Promise<BrowserSessionResult>;

package/dist/browser-session-runner/index.mjs

@@ -1,7 +1,7 @@
 import { runAttempt } from './attempt.mjs';
 import { expiredResult } from './result.mjs';
 import { isProcessGroupAlive, waitForProcessGroupExit } from './process-group.mjs';
-export { ProcessGroupDrainTimeoutError } from './process-group.mjs';
+export { isProcessGroupAlive, ProcessGroupDrainTimeoutError, waitForProcessGroupExit, } from './process-group.mjs';
 const defaultDeps = {
     clearInterval,
     clearTimeout,
@@ -44,6 +44,7 @@ export async function runBrowserSession(options, deps = defaultDeps) {
 }
 function validateOptions(options) {
     const maxTimerDelay = 2_147_483_647;
+    const drainTimeoutMs = options.graceMs + (options.processGroupDrainMs ?? options.graceMs);
     for (const [name, value] of [
         ['attempts', options.attempts],
         ['deadlineMs', options.deadlineMs],
@@ -59,6 +60,8 @@ function validateOptions(options) {
     const tailBytes = options.diagnosticTailBytes ?? 4096;
     if (!Number.isSafeInteger(tailBytes) || tailBytes <= 0)
         throw new RangeError('diagnosticTailBytes must be positive');
+    if (!Number.isSafeInteger(drainTimeoutMs) || drainTimeoutMs > maxTimerDelay)
+        throw new RangeError('graceMs + processGroupDrainMs must be a positive Node timer delay');
 }
 function omitAttempts({ attempts: _attempts, ...result }) {
     return result;

package/dist/browser-session-runner/process-group.mjs

@@ -5,6 +5,8 @@ export class ProcessGroupDrainTimeoutError extends Error {
     }
 }
 export function isProcessGroupAlive(processGroupId) {
+    validateProcessGroupId(processGroupId);
+    assertSupportedPlatform();
     try {
         process.kill(-processGroupId, 0);
         return true;
@@ -14,6 +16,9 @@ export function isProcessGroupAlive(processGroupId) {
     }
 }
 export async function waitForProcessGroupExit(processGroupId, timeoutMs) {
+    validateProcessGroupId(processGroupId);
+    validateTimerDelay(timeoutMs);
+    assertSupportedPlatform();
     const deadline = performance.now() + timeoutMs;
     while (isProcessGroupAlive(processGroupId)) {
         if (performance.now() >= deadline)
@@ -21,3 +26,17 @@ export async function waitForProcessGroupExit(processGroupId, timeoutMs) {
         await new Promise((resolve) => setTimeout(resolve, Math.min(10, deadline - performance.now())));
     }
 }
+function assertSupportedPlatform() {
+    if (process.platform === 'win32')
+        throw new Error('process-group control is unsupported on Windows');
+}
+function validateProcessGroupId(processGroupId) {
+    if (!Number.isSafeInteger(processGroupId) ||
+        processGroupId <= 1 ||
+        processGroupId > 2_147_483_647)
+        throw new RangeError('processGroupId must be a positive supported PID');
+}
+function validateTimerDelay(timeoutMs) {
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs <= 0 || timeoutMs > 2_147_483_647)
+        throw new RangeError('timeoutMs must be a positive Node timer delay');
+}

package/dist/index.d.mts

@@ -22,7 +22,7 @@ export { createArtifactClassifier, parseArtifactPatternsJson, planRunDeletions,
 export type { ArtifactClassification, ArtifactClassifier, ArtifactPatterns, CleanupRequest, DeletionSummary, } from './gha-artifacts-cleanup/index.mts';
 export { validateOptionalHttpOrigin } from './http-origin/index.mts';
 export { boundPendingLine, DEFAULT_MAX_PENDING_LINE_LENGTH, DEFAULT_TRUNCATED_LINE_MARKER, splitCompleteLines, } from './process-line-buffer/index.mts';
-export { ProcessGroupDrainTimeoutError, runBrowserSession, } from './browser-session-runner/index.mts';
+export { isProcessGroupAlive, ProcessGroupDrainTimeoutError, runBrowserSession, waitForProcessGroupExit, } from './browser-session-runner/index.mts';
 export type { BrowserSessionDeps, BrowserSessionEvent, BrowserSessionExit, BrowserSessionOptions, BrowserSessionOutput, BrowserSessionProcess, BrowserSessionResult, BrowserSessionTerminationReason, BrowserSessionWatchdog, BrowserSessionWatchdogCleanup, BrowserSessionWatchdogController, } from './browser-session-runner/index.mts';
 export { buildSchemaSnapshot, detectRenamedIndexes, generateSchemaSnapshot, indexShapeKey, readSchemaCatalog, renderSchemaMarkdown, stableStringify, writeSchemaSnapshot, } from './pg-schema-snapshot/index.mts';
 export type { CatalogQuery, PartitionPolicy, SchemaCatalog, SchemaGrowthMaps, SchemaSnapshot, SchemaTableSnapshot, } from './pg-schema-snapshot/index.mts';

package/dist/index.mjs

@@ -13,7 +13,7 @@ export { decodeSelectedFiles, encodeSelectedFiles, formatMultilineOutput, SELECT
 export { createArtifactClassifier, parseArtifactPatternsJson, planRunDeletions, runCleanup, sweepCleanup, } from './gha-artifacts-cleanup/index.mjs';
 export { validateOptionalHttpOrigin } from './http-origin/index.mjs';
 export { boundPendingLine, DEFAULT_MAX_PENDING_LINE_LENGTH, DEFAULT_TRUNCATED_LINE_MARKER, splitCompleteLines, } from './process-line-buffer/index.mjs';
-export { ProcessGroupDrainTimeoutError, runBrowserSession, } from './browser-session-runner/index.mjs';
+export { isProcessGroupAlive, ProcessGroupDrainTimeoutError, runBrowserSession, waitForProcessGroupExit, } from './browser-session-runner/index.mjs';
 export { buildSchemaSnapshot, detectRenamedIndexes, generateSchemaSnapshot, indexShapeKey, readSchemaCatalog, renderSchemaMarkdown, stableStringify, writeSchemaSnapshot, } from './pg-schema-snapshot/index.mjs';
 export { buildOpenApiDocument, hashContractSchema, nodeToOpenApi, writeOpenApi, } from './openapi-document/index.mjs';
 export { decide, deriveRetryAttempt } from './transient-retry/index.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vouchington-tooling",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Vouchington CLI and extractable tooling libraries.",
   "homepage": "https://github.com/vouchington/vouchington-tooling/tree/main/packages/vouchington-tooling#readme",
   "bugs": {