@rulvar/testing 1.15.0 → 1.16.1

package/dist/index.d.ts

@@ -43,6 +43,14 @@ declare const DEFAULT_LIVE_SMOKE_ATTEMPTS = 3;
 * is a bounded spend, so it refuses configurations that are not.
 */
 declare const MAX_LIVE_SMOKE_ATTEMPTS = 10;
+/**
+* Hard ceiling on every scheduled backoff: Node's maximum timer delay
+* (2^31 - 1 ms). Anything above it would not sleep longer, it would be
+* clamped to 1 ms with a TimeoutOverflowWarning, so both `baseDelayMs`
+* and the largest scheduled delay, `baseDelayMs * (attempts - 1)`, are
+* validated against this bound before any stream opens.
+*/
+declare const MAX_LIVE_SMOKE_DELAY_MS = 2147483647;
 interface RunLiveSmokeOptions {
   /**
   * Total attempts including the first: an integer from 1 to
@@ -53,8 +61,11 @@ interface RunLiveSmokeOptions {
   /**
   * Backoff before retry n (1-based) is `baseDelayMs * n`: a
   * non-negative integer (default 2000). Pass 0 to retry without
-  * sleeping (unit tests). Anything else rejects with ConfigError
-  * before any stream opens.
+  * sleeping (unit tests). The value AND the largest scheduled delay,
+  * `baseDelayMs * (attempts - 1)`, must not exceed
+  * {@link MAX_LIVE_SMOKE_DELAY_MS} (Node's timer maximum, which would
+  * otherwise clamp the sleep to 1 ms). Anything else rejects with
+  * ConfigError before any stream opens.
   */
   baseDelayMs?: number;
 }
@@ -239,4 +250,4 @@ declare function replay(options: {
   adapters?: ProviderAdapter[];
 }): ProviderAdapter[];
 //#endregion
-export { type CassetteFixture, type CreateTestEngineOptions, DEFAULT_LIVE_SMOKE_ATTEMPTS, FAKE_MODEL, FAKE_MODEL_REF, FakeAdapter, type FakeAdapterOptions, type FakeCall, type FakeResponder, type FakeToolCallsValue, type FakeWireErrorValue, type LiveSmokeOutcome, M6_ORCH_GOAL, M6_ORCH_PROFILES, M6_ORCH_RUN_ID, MAX_LIVE_SMOKE_ATTEMPTS, RedactFn, type ReplayRunOptions, type RunLiveSmokeOptions, type TestEngine, type TestRunHandle, VcrCassette, VcrMissError, VcrRow, buildFrozenV1JournalRaw, buildM2CassetteFixtures, buildV2GoldenIdentity, createTestEngine, defaultRedact, fakeToolCalls, fakeWireError, handlesInRequest, liveTestEnabled, normalizeM6Entries, readCassette, record, recordLiveCassettes, recordOrchestratorCrash, replay, replayRun, requestHash, runLiveSmoke };
+export { type CassetteFixture, type CreateTestEngineOptions, DEFAULT_LIVE_SMOKE_ATTEMPTS, FAKE_MODEL, FAKE_MODEL_REF, FakeAdapter, type FakeAdapterOptions, type FakeCall, type FakeResponder, type FakeToolCallsValue, type FakeWireErrorValue, type LiveSmokeOutcome, M6_ORCH_GOAL, M6_ORCH_PROFILES, M6_ORCH_RUN_ID, MAX_LIVE_SMOKE_ATTEMPTS, MAX_LIVE_SMOKE_DELAY_MS, RedactFn, type ReplayRunOptions, type RunLiveSmokeOptions, type TestEngine, type TestRunHandle, VcrCassette, VcrMissError, VcrRow, buildFrozenV1JournalRaw, buildM2CassetteFixtures, buildV2GoldenIdentity, createTestEngine, defaultRedact, fakeToolCalls, fakeWireError, handlesInRequest, liveTestEnabled, normalizeM6Entries, readCassette, record, recordLiveCassettes, recordOrchestratorCrash, replay, replayRun, requestHash, runLiveSmoke };

package/dist/index.js

@@ -397,6 +397,14 @@ const DEFAULT_LIVE_SMOKE_ATTEMPTS = 3;
 */
 const MAX_LIVE_SMOKE_ATTEMPTS = 10;
 /**
+* Hard ceiling on every scheduled backoff: Node's maximum timer delay
+* (2^31 - 1 ms). Anything above it would not sleep longer, it would be
+* clamped to 1 ms with a TimeoutOverflowWarning, so both `baseDelayMs`
+* and the largest scheduled delay, `baseDelayMs * (attempts - 1)`, are
+* validated against this bound before any stream opens.
+*/
+const MAX_LIVE_SMOKE_DELAY_MS = 2147483647;
+/**
 * Drains `adapter.stream(req)` with a bounded retry policy and classifies
 * the outcome instead of throwing:
 *
@@ -424,7 +432,7 @@ const MAX_LIVE_SMOKE_ATTEMPTS = 10;
 */
 async function runLiveSmoke(adapter, req, options) {
 	const attempts = validatedAttempts(options?.attempts);
-	const baseDelayMs = validatedBaseDelayMs(options?.baseDelayMs);
+	const baseDelayMs = validatedBaseDelayMs(options?.baseDelayMs, attempts);
 	const retryableErrors = [];
 	for (let attempt = 1; attempt <= attempts; attempt += 1) {
 		const events = [];
@@ -470,12 +478,26 @@ async function runLiveSmoke(adapter, req, options) {
 }
 function validatedAttempts(value) {
 	if (value === void 0) return 3;
-	if (!Number.isSafeInteger(value) || value < 1 || value > 10) throw new ConfigError(`runLiveSmoke attempts must be an integer from 1 to 10, got ${String(value)}`);
+	if (!Number.isSafeInteger(value) || value < 1 || value > 10) throw new ConfigError(`runLiveSmoke attempts must be an integer from 1 to 10, got ${String(value)}`, { data: {
+		field: "attempts",
+		value: String(value),
+		max: 10
+	} });
 	return value;
 }
-function validatedBaseDelayMs(value) {
+function validatedBaseDelayMs(value, attempts) {
 	if (value === void 0) return 2e3;
-	if (!Number.isSafeInteger(value) || value < 0) throw new ConfigError(`runLiveSmoke baseDelayMs must be a non-negative integer, got ${String(value)}`);
+	if (!Number.isSafeInteger(value) || value < 0 || value > 2147483647) throw new ConfigError(`runLiveSmoke baseDelayMs must be an integer from 0 to ${MAX_LIVE_SMOKE_DELAY_MS} (Node's timer maximum), got ${String(value)}`, { data: {
+		field: "baseDelayMs",
+		value: String(value),
+		max: MAX_LIVE_SMOKE_DELAY_MS
+	} });
+	const largestDelayMs = value * (attempts - 1);
+	if (largestDelayMs > 2147483647) throw new ConfigError(`runLiveSmoke largest scheduled backoff baseDelayMs * (attempts - 1) = ${String(largestDelayMs)} exceeds ${MAX_LIVE_SMOKE_DELAY_MS} (Node's timer maximum); lower baseDelayMs or attempts`, { data: {
+		field: "baseDelayMs * (attempts - 1)",
+		value: String(largestDelayMs),
+		max: MAX_LIVE_SMOKE_DELAY_MS
+	} });
 	return value;
 }
 function delay(ms) {
@@ -2148,4 +2170,4 @@ function replay(options) {
 	});
 }
 //#endregion
-export { DEFAULT_LIVE_SMOKE_ATTEMPTS, FAKE_MODEL, FAKE_MODEL_REF, FakeAdapter, M6_ORCH_GOAL, M6_ORCH_PROFILES, M6_ORCH_RUN_ID, MAX_LIVE_SMOKE_ATTEMPTS, VcrMissError, buildFrozenV1JournalRaw, buildM2CassetteFixtures, buildV2GoldenIdentity, createTestEngine, defaultRedact, fakeToolCalls, fakeWireError, handlesInRequest, liveTestEnabled, normalizeM6Entries, readCassette, record, recordLiveCassettes, recordOrchestratorCrash, replay, replayRun, requestHash, runLiveSmoke };
+export { DEFAULT_LIVE_SMOKE_ATTEMPTS, FAKE_MODEL, FAKE_MODEL_REF, FakeAdapter, M6_ORCH_GOAL, M6_ORCH_PROFILES, M6_ORCH_RUN_ID, MAX_LIVE_SMOKE_ATTEMPTS, MAX_LIVE_SMOKE_DELAY_MS, VcrMissError, buildFrozenV1JournalRaw, buildM2CassetteFixtures, buildV2GoldenIdentity, createTestEngine, defaultRedact, fakeToolCalls, fakeWireError, handlesInRequest, liveTestEnabled, normalizeM6Entries, readCassette, record, recordLiveCassettes, recordOrchestratorCrash, replay, replayRun, requestHash, runLiveSmoke };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rulvar/testing",
-  "version": "1.15.0",
+  "version": "1.16.1",
   "description": "Rulvar test harness: createTestEngine, FakeAdapter, VCR cassettes, replay-strict runs, matchers.",
   "type": "module",
   "license": "Apache-2.0",
@@ -26,7 +26,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@rulvar/core": "1.15.0"
+    "@rulvar/core": "1.16.1"
   },
   "devDependencies": {
     "@types/node": "^22.20.0",