@loadstrike/loadstrike-sdk 1.0.26701 → 1.0.27101

package/README.md

@@ -8,6 +8,7 @@ LoadStrike is a developer-first load testing SDK for Node.js applications, servi
 - Generate safe starter scenarios from captured HAR, OpenTelemetry trace JSON, browser recordings, or message pairs with Trace-to-test Autopilot.
 - Exercise HTTP and event-driven workflows across multiple steps.
 - Apply load simulations, thresholds, and custom metrics to real transactions.
+- Split a single load profile across weighted scenario mixes.
 - Generate local reports and, on Business and Enterprise, publish observability data to supported sinks.
 
 Built-in transport coverage includes HTTP, Kafka, RabbitMQ, NATS, Redis Streams, Azure Event Hubs, Push Diffusion, and delegate-based custom streams. Local report output supports HTML, Markdown, TXT, and CSV, and Business and Enterprise can publish to InfluxDB, TimescaleDB, Grafana Loki, Datadog, Splunk HEC, and OpenTelemetry Collector.
@@ -53,6 +54,12 @@ const result = await LoadStrikeRunner
 
 `run()` returns the detailed run result, including generated report files, scenario statistics, metrics, and sink status.
 
+## Traffic Mixes
+
+Use `LoadStrikeTrafficMix` on Business and Enterprise plans when one total load profile should be distributed across multiple scenario lanes. For example, a 1000 requests-per-second profile with scenario weights of 60, 30, and 10 sends roughly 600 requests per second to the first scenario, 300 to the second, and 100 to the third.
+
+Each lane is still a normal scenario with its own named steps, thresholds, reports, and portal results. Register the mix with `LoadStrikeRunner.registerTrafficMix(...)` or add it to a runner with `.addTrafficMix(...)`.
+
 ## Trace-To-Test Autopilot
 
 Use `await LoadStrikeAutopilot.generate(...)` to infer a starter plan from a captured artifact. Set `Options.RunnerKey` so generation can validate the Trace-To-Test Autopilot entitlement. Check `result.Readiness` and `result.ReadinessFailures` first; call `result.buildScenario()` only when it is `LoadStrikeAutopilotReadiness.Ready`, then execute the scenario through the normal runner with a valid `RunnerKey`.

package/dist/cjs/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InfluxDbReportingSink = exports.GrafanaLokiReportingSinkOptions = exports.GrafanaLokiReportingSink = exports.DatadogReportingSinkOptions = exports.DatadogReportingSink = exports.HttpAuthOptions = exports.HttpOAuth2ClientCredentialsOptions = exports.PushDiffusionEndpointDefinition = exports.DelegateStreamEndpointDefinition = exports.SqsEndpointDefinition = exports.AzureEventHubsEndpointDefinition = exports.RedisStreamsEndpointDefinition = exports.NatsEndpointDefinition = exports.RabbitMqEndpointDefinition = exports.KafkaSaslOptions = exports.KafkaEndpointDefinition = exports.HttpEndpointDefinition = exports.TrafficEndpointDefinition = exports.LOADSTRIKE_TRACE_ID_TRACKING_FIELD = exports.LOADSTRIKE_TRACE_ID_HEADER = exports.TrackingFieldSelector = exports.TrackingPayloadBuilder = exports.RedisCorrelationStore = exports.RedisCorrelationStoreOptions = exports.InMemoryCorrelationStore = exports.CrossPlatformTrackingRuntime = exports.CorrelationStoreConfiguration = exports.LoadStrikeThreshold = exports.LoadStrikeStep = exports.LoadStrikeGauge = exports.LoadStrikeCounter = exports.LoadStrikeMetric = exports.CrossPlatformTrackingConfiguration = exports.LoadStrikeSimulation = exports.LoadStrikeScenario = exports.LoadStrikeRunner = exports.LoadStrikeOperationType = exports.LoadStrikeScenarioOperation = exports.LoadStrikeLogLevel = exports.LoadStrikeResponse = exports.LoadStrikeReportFormat = exports.LoadStrikeNodeType = exports.LoadStrikePluginDataTable = exports.LoadStrikePluginData = exports.LoadStrikeContext = exports.ScenarioTrackingExtensions = exports.CrossPlatformScenarioConfigurator = exports.LoadStrikeAutopilotReadiness = exports.LoadStrikeAutopilotResult = exports.LoadStrikeAutopilot = void 0;
-exports.TimescaleDbReportingSinkOptions = exports.TimescaleDbReportingSink = exports.SplunkReportingSinkOptions = exports.SplunkReportingSink = exports.PortalReportingSink = exports.OtelCollectorReportingSinkOptions = exports.OtelCollectorReportingSink = exports.InfluxDbReportingSinkOptions = void 0;
+exports.HttpOAuth2ClientCredentialsOptions = exports.WebSocketEndpointDefinition = exports.GrpcEndpointDefinition = exports.PushDiffusionEndpointDefinition = exports.DelegateStreamEndpointDefinition = exports.SqsEndpointDefinition = exports.AzureEventHubsEndpointDefinition = exports.RedisStreamsEndpointDefinition = exports.NatsEndpointDefinition = exports.RabbitMqEndpointDefinition = exports.KafkaSaslOptions = exports.KafkaEndpointDefinition = exports.HttpEndpointDefinition = exports.TrafficEndpointDefinition = exports.LOADSTRIKE_TRACE_ID_TRACKING_FIELD = exports.LOADSTRIKE_TRACE_ID_HEADER = exports.TrackingFieldSelector = exports.TrackingPayloadBuilder = exports.RedisCorrelationStore = exports.RedisCorrelationStoreOptions = exports.InMemoryCorrelationStore = exports.CrossPlatformTrackingRuntime = exports.CorrelationStoreConfiguration = exports.LoadStrikeThreshold = exports.LoadStrikeStep = exports.LoadStrikeGauge = exports.LoadStrikeCounter = exports.LoadStrikeMetric = exports.CrossPlatformTrackingConfiguration = exports.LoadStrikeTrafficMix = exports.LoadStrikeSimulation = exports.LoadStrikeScenarioShare = exports.LoadStrikeScenario = exports.LoadStrikeRunner = exports.LoadStrikeOperationType = exports.LoadStrikeScenarioOperation = exports.LoadStrikeLogLevel = exports.LoadStrikeResponse = exports.LoadStrikeReportFormat = exports.LoadStrikeNodeType = exports.LoadStrikePluginDataTable = exports.LoadStrikePluginData = exports.LoadStrikeBrowserWebVitals = exports.LoadStrikeAccessibility = exports.LoadStrikeContext = exports.ScenarioTrackingExtensions = exports.CrossPlatformScenarioConfigurator = exports.LoadStrikeAutopilotReadiness = exports.LoadStrikeAutopilotResult = exports.LoadStrikeAutopilot = void 0;
+exports.TimescaleDbReportingSinkOptions = exports.TimescaleDbReportingSink = exports.SplunkReportingSinkOptions = exports.SplunkReportingSink = exports.PortalReportingSink = exports.OtelCollectorReportingSinkOptions = exports.OtelCollectorReportingSink = exports.InfluxDbReportingSinkOptions = exports.InfluxDbReportingSink = exports.GrafanaLokiReportingSinkOptions = exports.GrafanaLokiReportingSink = exports.DatadogReportingSinkOptions = exports.DatadogReportingSink = exports.HttpAuthOptions = void 0;
 var autopilot_js_1 = require("./autopilot.js");
 Object.defineProperty(exports, "LoadStrikeAutopilot", { enumerable: true, get: function () { return autopilot_js_1.LoadStrikeAutopilot; } });
 Object.defineProperty(exports, "LoadStrikeAutopilotResult", { enumerable: true, get: function () { return autopilot_js_1.LoadStrikeAutopilotResult; } });
@@ -11,6 +11,8 @@ var runtime_js_1 = require("./runtime.js");
 Object.defineProperty(exports, "CrossPlatformScenarioConfigurator", { enumerable: true, get: function () { return runtime_js_1.CrossPlatformScenarioConfigurator; } });
 Object.defineProperty(exports, "ScenarioTrackingExtensions", { enumerable: true, get: function () { return runtime_js_1.ScenarioTrackingExtensions; } });
 Object.defineProperty(exports, "LoadStrikeContext", { enumerable: true, get: function () { return runtime_js_1.LoadStrikeContext; } });
+Object.defineProperty(exports, "LoadStrikeAccessibility", { enumerable: true, get: function () { return runtime_js_1.LoadStrikeAccessibility; } });
+Object.defineProperty(exports, "LoadStrikeBrowserWebVitals", { enumerable: true, get: function () { return runtime_js_1.LoadStrikeBrowserWebVitals; } });
 Object.defineProperty(exports, "LoadStrikePluginData", { enumerable: true, get: function () { return runtime_js_1.LoadStrikePluginData; } });
 Object.defineProperty(exports, "LoadStrikePluginDataTable", { enumerable: true, get: function () { return runtime_js_1.LoadStrikePluginDataTable; } });
 Object.defineProperty(exports, "LoadStrikeNodeType", { enumerable: true, get: function () { return runtime_js_1.LoadStrikeNodeType; } });
@@ -21,7 +23,9 @@ Object.defineProperty(exports, "LoadStrikeScenarioOperation", { enumerable: true
 Object.defineProperty(exports, "LoadStrikeOperationType", { enumerable: true, get: function () { return runtime_js_1.LoadStrikeOperationType; } });
 Object.defineProperty(exports, "LoadStrikeRunner", { enumerable: true, get: function () { return runtime_js_1.LoadStrikeRunner; } });
 Object.defineProperty(exports, "LoadStrikeScenario", { enumerable: true, get: function () { return runtime_js_1.LoadStrikeScenario; } });
+Object.defineProperty(exports, "LoadStrikeScenarioShare", { enumerable: true, get: function () { return runtime_js_1.LoadStrikeScenarioShare; } });
 Object.defineProperty(exports, "LoadStrikeSimulation", { enumerable: true, get: function () { return runtime_js_1.LoadStrikeSimulation; } });
+Object.defineProperty(exports, "LoadStrikeTrafficMix", { enumerable: true, get: function () { return runtime_js_1.LoadStrikeTrafficMix; } });
 Object.defineProperty(exports, "CrossPlatformTrackingConfiguration", { enumerable: true, get: function () { return runtime_js_1.CrossPlatformTrackingConfiguration; } });
 Object.defineProperty(exports, "LoadStrikeMetric", { enumerable: true, get: function () { return runtime_js_1.LoadStrikeMetric; } });
 Object.defineProperty(exports, "LoadStrikeCounter", { enumerable: true, get: function () { return runtime_js_1.LoadStrikeCounter; } });
@@ -50,6 +54,8 @@ Object.defineProperty(exports, "AzureEventHubsEndpointDefinition", { enumerable:
 Object.defineProperty(exports, "SqsEndpointDefinition", { enumerable: true, get: function () { return transports_js_1.SqsEndpointDefinition; } });
 Object.defineProperty(exports, "DelegateStreamEndpointDefinition", { enumerable: true, get: function () { return transports_js_1.DelegateStreamEndpointDefinition; } });
 Object.defineProperty(exports, "PushDiffusionEndpointDefinition", { enumerable: true, get: function () { return transports_js_1.PushDiffusionEndpointDefinition; } });
+Object.defineProperty(exports, "GrpcEndpointDefinition", { enumerable: true, get: function () { return transports_js_1.GrpcEndpointDefinition; } });
+Object.defineProperty(exports, "WebSocketEndpointDefinition", { enumerable: true, get: function () { return transports_js_1.WebSocketEndpointDefinition; } });
 Object.defineProperty(exports, "HttpOAuth2ClientCredentialsOptions", { enumerable: true, get: function () { return transports_js_1.HttpOAuth2ClientCredentialsOptions; } });
 Object.defineProperty(exports, "HttpAuthOptions", { enumerable: true, get: function () { return transports_js_1.HttpAuthOptions; } });
 var sinks_js_1 = require("./sinks.js");

package/dist/cjs/local.js

@@ -32,9 +32,21 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
+var _LoadStrikeLocalClient_licensingApiBaseUrl, _LoadStrikeLocalClient_signingKeyCache;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.__loadstrikeTestExports = exports.LoadStrikeLocalClient = void 0;
 const node_os_1 = __importDefault(require("node:os"));
@@ -67,7 +79,9 @@ const TRACKING_FEATURE_BY_KIND = {
     delegatestream: "endpoint.delegate_stream",
     nats: "endpoint.nats",
     redisstreams: "endpoint.redis_streams",
-    sqs: "endpoint.sqs"
+    sqs: "endpoint.sqs",
+    grpc: "endpoint.grpc",
+    websocket: "endpoint.websocket"
 };
 const CI_ENVIRONMENT_VARIABLES = [
     "GITHUB_ACTIONS",
@@ -92,13 +106,14 @@ class LoadStrikeLocalClient {
      * Use this when the surrounding wrapper type makes this operation the clearest way to express your intent.
      */
     constructor(options = {}) {
-        this.signingKeyCache = new Map();
+        _LoadStrikeLocalClient_licensingApiBaseUrl.set(this, void 0);
+        _LoadStrikeLocalClient_signingKeyCache.set(this, new Map());
         assertNoDisableLicenseEnforcementOption(options, "LoadStrikeLocalClient");
-        this.licensingApiBaseUrl = resolveLicensingApiBaseUrl();
+        __classPrivateFieldSet(this, _LoadStrikeLocalClient_licensingApiBaseUrl, resolveLicensingApiBaseUrl(), "f");
         this.licenseValidationTimeoutMs = normalizeTimeoutMs(options.licenseValidationTimeoutMs);
     }
     portalReportingIngestUrl() {
-        return `${this.licensingApiBaseUrl.replace(/\/+$/, "")}/api/v1/reporting/ingest`;
+        return `${__classPrivateFieldGet(this, _LoadStrikeLocalClient_licensingApiBaseUrl, "f").replace(/\/+$/, "")}/api/v1/reporting/ingest`;
     }
     async run(request) {
         const sanitized = sanitizeRequest(request);
@@ -367,8 +382,8 @@ class LoadStrikeLocalClient {
         const nowMs = Date.now();
         const normalizedKeyId = stringOrDefault(keyId, "default").trim() || "default";
         const normalizedAlgorithm = stringOrDefault(algorithm, "RS256").toUpperCase();
-        const cacheKey = `${this.licensingApiBaseUrl.toLowerCase()}|${normalizedAlgorithm}:${normalizedKeyId}`;
-        const cached = this.signingKeyCache.get(cacheKey);
+        const cacheKey = `${__classPrivateFieldGet(this, _LoadStrikeLocalClient_licensingApiBaseUrl, "f").toLowerCase()}|${normalizedAlgorithm}:${normalizedKeyId}`;
+        const cached = __classPrivateFieldGet(this, _LoadStrikeLocalClient_signingKeyCache, "f").get(cacheKey);
         if (cached && cached.expiresAtUtc > nowMs) {
             return cached;
         }
@@ -396,7 +411,7 @@ class LoadStrikeLocalClient {
                 publicKeyPem,
                 expiresAtUtc: nowMs + (15 * 60 * 1000)
             };
-            this.signingKeyCache.set(cacheKey, keyRecord);
+            __classPrivateFieldGet(this, _LoadStrikeLocalClient_signingKeyCache, "f").set(cacheKey, keyRecord);
             return keyRecord;
         }
         finally {
@@ -448,7 +463,7 @@ class LoadStrikeLocalClient {
         }
     }
     async postLicensingRequest(path, payload, signal) {
-        const response = await fetch(`${this.licensingApiBaseUrl.replace(/\/+$/, "")}${path}`, {
+        const response = await fetch(`${__classPrivateFieldGet(this, _LoadStrikeLocalClient_licensingApiBaseUrl, "f").replace(/\/+$/, "")}${path}`, {
             method: "POST",
             headers: {
                 "Content-Type": "application/json",
@@ -467,7 +482,7 @@ class LoadStrikeLocalClient {
         return { response, json };
     }
     async getLicensingRequest(path, signal) {
-        const response = await fetch(`${this.licensingApiBaseUrl.replace(/\/+$/, "")}${path}`, {
+        const response = await fetch(`${__classPrivateFieldGet(this, _LoadStrikeLocalClient_licensingApiBaseUrl, "f").replace(/\/+$/, "")}${path}`, {
             method: "GET",
             headers: {
                 Accept: "application/json"
@@ -485,6 +500,7 @@ class LoadStrikeLocalClient {
     }
 }
 exports.LoadStrikeLocalClient = LoadStrikeLocalClient;
+_LoadStrikeLocalClient_licensingApiBaseUrl = new WeakMap(), _LoadStrikeLocalClient_signingKeyCache = new WeakMap();
 function assertNoDisableLicenseEnforcementOption(value, source) {
     if (value == null || typeof value !== "object" || Array.isArray(value)) {
         return;
@@ -514,7 +530,43 @@ function resolveLicensingApiBaseUrl() {
     return normalizeLicensingApiBaseUrl(developmentLicensingApiBaseUrlOverride);
 }
 function setDevelopmentLicensingApiBaseUrlOverride(value) {
-    developmentLicensingApiBaseUrlOverride = value;
+    if (value != null && value.trim()) {
+        assertInternalTestHarnessLicensingOverride();
+        const normalized = normalizeLicensingApiBaseUrl(value);
+        if (!isLoopbackHttpBaseUrl(normalized)) {
+            throw new TypeError("Internal development licensing API overrides must use a loopback http URL.");
+        }
+        developmentLicensingApiBaseUrlOverride = normalized;
+        return;
+    }
+    if (value != null) {
+        assertInternalTestHarnessLicensingOverride();
+    }
+    developmentLicensingApiBaseUrlOverride = undefined;
+}
+function assertInternalTestHarnessLicensingOverride() {
+    if (isInternalTestHarnessCall()) {
+        return;
+    }
+    throw new TypeError("Internal development licensing API override is available only to LoadStrike SDK tests.");
+}
+function isInternalTestHarnessCall() {
+    const stack = String(new Error().stack ?? "").replace(/\\/g, "/").toLowerCase();
+    return stack.includes("/sdk/ts/tests/");
+}
+function isLoopbackHttpBaseUrl(value) {
+    let parsed;
+    try {
+        parsed = new URL(value);
+    }
+    catch {
+        return false;
+    }
+    if (parsed.protocol !== "http:") {
+        return false;
+    }
+    const host = parsed.hostname.trim().toLowerCase();
+    return host === "localhost" || host === "127.0.0.1" || host === "[::1]" || host === "::1" || host.endsWith(".localhost");
 }
 function normalizeTimeoutMs(value) {
     if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {

package/dist/cjs/runtime.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.__loadstrikeTestExports = exports.LoadStrikeRunner = exports.LoadStrikeScenario = exports.LoadStrikeContext = exports.ScenarioTrackingExtensions = exports.CrossPlatformScenarioConfigurator = exports.LoadStrikeThreshold = exports.LoadStrikeMetric = exports.LoadStrikeGauge = exports.LoadStrikeCounter = exports.LoadStrikeSimulation = exports.LoadStrikeStep = exports.LoadStrikeResponse = exports.LoadStrikePluginData = exports.LoadStrikePluginDataTable = exports.CrossPlatformTrackingConfiguration = exports.LoadStrikeOperationType = exports.LoadStrikeScenarioOperation = exports.LoadStrikeLogLevel = exports.LoadStrikeReportFormat = exports.LoadStrikeNodeType = void 0;
+exports.__loadstrikeTestExports = exports.LoadStrikeRunner = exports.LoadStrikeTrafficMix = exports.LoadStrikeScenarioShare = exports.LoadStrikeScenario = exports.LoadStrikeBrowserWebVitals = exports.LoadStrikeAccessibility = exports.LoadStrikeContext = exports.ScenarioTrackingExtensions = exports.CrossPlatformScenarioConfigurator = exports.LoadStrikeThreshold = exports.LoadStrikeMetric = exports.LoadStrikeGauge = exports.LoadStrikeCounter = exports.LoadStrikeSimulation = exports.LoadStrikeStep = exports.LoadStrikeResponse = exports.LoadStrikePluginData = exports.LoadStrikePluginDataTable = exports.CrossPlatformTrackingConfiguration = exports.LoadStrikeOperationType = exports.LoadStrikeScenarioOperation = exports.LoadStrikeLogLevel = exports.LoadStrikeReportFormat = exports.LoadStrikeNodeType = void 0;
 const node_fs_1 = require("node:fs");
 const node_crypto_1 = require("node:crypto");
 const node_os_1 = __importDefault(require("node:os"));
@@ -75,6 +75,7 @@ exports.CrossPlatformTrackingConfiguration = {
         return this.forDuration(configuration, durationSeconds, cancellationSignal);
     }
 };
+const TRAFFIC_MIX_FEATURE = "workload.traffic_mix";
 class LoadStrikePluginDataTable {
     /**
      * Exposes the public constructor operation.
@@ -1621,6 +1622,114 @@ class LoadStrikeContext {
     }
 }
 exports.LoadStrikeContext = LoadStrikeContext;
+const ACCESSIBILITY_TESTING_FEATURE = "testing.accessibility";
+const BROWSER_WEB_VITALS_FEATURE = "testing.browser_web_vitals";
+class LoadStrikeAccessibility {
+    static createScenario(name, options, check) {
+        if (typeof name !== "string" || !name.trim()) {
+            throw new Error("Scenario name must be provided.");
+        }
+        validateAbsoluteUrl(options?.url, "Accessibility check URL");
+        if (typeof check !== "function") {
+            throw new TypeError("Accessibility check callback must be provided.");
+        }
+        return LoadStrikeScenario
+            .create(name, async (scenarioContext) => {
+            const result = await check({ options, scenarioContext });
+            const failure = evaluateAccessibilityResult(options, result);
+            return failure
+                ? LoadStrikeResponse.fail("accessibility", failure)
+                : LoadStrikeResponse.ok("200", 0, `Accessibility check passed with ${(result.violations ?? []).length} violation(s).`);
+        })
+            .withoutWarmUp()
+            .__loadStrikeWithInternalLicenseFeatures(ACCESSIBILITY_TESTING_FEATURE);
+    }
+    static CreateScenario(name, options, check) {
+        return LoadStrikeAccessibility.createScenario(name, options, check);
+    }
+}
+exports.LoadStrikeAccessibility = LoadStrikeAccessibility;
+class LoadStrikeBrowserWebVitals {
+    static createScenario(name, options, measure) {
+        if (typeof name !== "string" || !name.trim()) {
+            throw new Error("Scenario name must be provided.");
+        }
+        validateAbsoluteUrl(options?.url, "Browser Web Vitals URL");
+        if (typeof measure !== "function") {
+            throw new TypeError("Browser Web Vitals measurement callback must be provided.");
+        }
+        return LoadStrikeScenario
+            .create(name, async (scenarioContext) => {
+            const result = await measure({ options, scenarioContext });
+            const failure = evaluateWebVitalsResult(options, result);
+            return failure
+                ? LoadStrikeResponse.fail("web_vitals", failure)
+                : LoadStrikeResponse.ok("200", 0, "Browser Web Vitals check passed.");
+        })
+            .withoutWarmUp()
+            .__loadStrikeWithInternalLicenseFeatures(BROWSER_WEB_VITALS_FEATURE);
+    }
+    static CreateScenario(name, options, measure) {
+        return LoadStrikeBrowserWebVitals.createScenario(name, options, measure);
+    }
+}
+exports.LoadStrikeBrowserWebVitals = LoadStrikeBrowserWebVitals;
+function validateAbsoluteUrl(value, label) {
+    if (typeof value !== "string" || !value.trim()) {
+        throw new Error(`${label} must be provided.`);
+    }
+    try {
+        const parsed = new URL(value);
+        if (!parsed.protocol || !parsed.host) {
+            throw new Error("invalid");
+        }
+    }
+    catch {
+        throw new Error(`${label} must be an absolute URL.`);
+    }
+}
+function evaluateAccessibilityResult(options, result) {
+    if (!result) {
+        return "Accessibility check did not return a result.";
+    }
+    const violations = Array.isArray(result.violations) ? result.violations : [];
+    const maxViolations = Math.max(0, Number(options.maxViolations ?? 0));
+    const critical = countAccessibilityImpact(violations, "critical");
+    const serious = countAccessibilityImpact(violations, "serious");
+    const maxCritical = Math.max(0, Number(options.maxCriticalViolations ?? 0));
+    const maxSerious = Math.max(0, Number(options.maxSeriousViolations ?? 0));
+    if (violations.length > maxViolations) {
+        return `Accessibility violations ${violations.length} exceeded limit ${maxViolations}.`;
+    }
+    if (critical > maxCritical) {
+        return `Critical accessibility violations ${critical} exceeded limit ${maxCritical}.`;
+    }
+    if (serious > maxSerious) {
+        return `Serious accessibility violations ${serious} exceeded limit ${maxSerious}.`;
+    }
+    return "";
+}
+function countAccessibilityImpact(violations, impact) {
+    return violations.filter((violation) => String(violation.impact ?? "").toLowerCase() === impact).length;
+}
+function evaluateWebVitalsResult(options, result) {
+    if (!result) {
+        return "Browser Web Vitals check did not return a result.";
+    }
+    return firstWebVitalViolation(["LCP", result.largestContentfulPaintMs, options.maxLargestContentfulPaintMs, "ms"], ["INP", result.interactionToNextPaintMs, options.maxInteractionToNextPaintMs, "ms"], ["CLS", result.cumulativeLayoutShift, options.maxCumulativeLayoutShift, ""], ["FCP", result.firstContentfulPaintMs, options.maxFirstContentfulPaintMs, "ms"], ["TTFB", result.timeToFirstByteMs, options.maxTimeToFirstByteMs, "ms"]);
+}
+function firstWebVitalViolation(...values) {
+    for (const [name, actualRaw, limitRaw, unit] of values) {
+        const actual = Number(actualRaw);
+        const limit = Number(limitRaw);
+        if (!Number.isFinite(actual) || !Number.isFinite(limit) || actual <= limit) {
+            continue;
+        }
+        const suffix = unit ? ` ${unit}` : "";
+        return `${name} ${actual}${suffix} exceeded limit ${limit}${suffix}.`;
+    }
+    return "";
+}
 class LoadStrikeScenario {
     constructor(name, runHandler, initHandler, cleanHandler, loadSimulations, thresholds, trackingConfiguration, maxFailCount, withoutWarmUpValue, warmUpDurationSeconds, weight, restartIterationOnFail, internalLicenseFeatures = []) {
         this.name = name;
@@ -1967,6 +2076,105 @@ class LoadStrikeScenario {
     }
 }
 exports.LoadStrikeScenario = LoadStrikeScenario;
+class LoadStrikeScenarioShare {
+    constructor(scenario, weight) {
+        this.scenario = scenario;
+        this.weight = weight;
+    }
+    /**
+     * Creates a weighted scenario lane for a traffic mix.
+     * Use this when a total workload should be distributed across several scenarios.
+     */
+    static create(scenario, weight) {
+        if (!(scenario instanceof LoadStrikeScenario)) {
+            throw new TypeError("Scenario must be provided.");
+        }
+        const normalizedWeight = Math.trunc(weight);
+        if (!Number.isFinite(weight) || normalizedWeight <= 0) {
+            throw new RangeError("Scenario share weight should be greater than zero.");
+        }
+        return new LoadStrikeScenarioShare(scenario, normalizedWeight);
+    }
+    /**
+     * Creates a weighted scenario lane for a traffic mix.
+     * Use this when a total workload should be distributed across several scenarios.
+     */
+    static Create(scenario, weight) {
+        return LoadStrikeScenarioShare.create(scenario, weight);
+    }
+}
+exports.LoadStrikeScenarioShare = LoadStrikeScenarioShare;
+class LoadStrikeTrafficMix {
+    constructor(name, totalLoad = [], scenarioMix = []) {
+        this.name = name;
+        this.totalLoad = totalLoad.map((simulation) => attachLoadSimulationProjection({ ...simulation }));
+        this.scenarioMix = [...scenarioMix];
+    }
+    /**
+     * Creates a traffic mix definition.
+     * Use this when one total load profile should be split across multiple scenario lanes.
+     */
+    static create(name) {
+        return new LoadStrikeTrafficMix(requireNonEmpty(name, "Traffic mix name must be provided."));
+    }
+    /**
+     * Creates a traffic mix definition.
+     * Use this when one total load profile should be split across multiple scenario lanes.
+     */
+    static Create(name) {
+        return LoadStrikeTrafficMix.create(name);
+    }
+    /**
+     * Sets the total workload shape for the mix.
+     * Use this when the same high-level load profile should be distributed by scenario weights.
+     */
+    withTotalLoad(...totalLoad) {
+        if (!totalLoad.length) {
+            throw new Error("At least one total load simulation should be provided.");
+        }
+        return new LoadStrikeTrafficMix(this.name, totalLoad, this.scenarioMix);
+    }
+    /**
+     * Sets the total workload shape for the mix.
+     * Use this when the same high-level load profile should be distributed by scenario weights.
+     */
+    WithTotalLoad(...totalLoad) {
+        return this.withTotalLoad(...totalLoad);
+    }
+    /**
+     * Sets the weighted scenario lanes for the mix.
+     * Use this when each operation should receive a fixed proportion of the total workload.
+     */
+    withScenarioMix(...scenarioMix) {
+        if (!scenarioMix.length) {
+            throw new Error("At least one scenario share should be provided.");
+        }
+        if (scenarioMix.some((share) => !(share instanceof LoadStrikeScenarioShare))) {
+            throw new TypeError("Scenario share collection cannot contain null values.");
+        }
+        return new LoadStrikeTrafficMix(this.name, this.totalLoad, scenarioMix);
+    }
+    /**
+     * Sets the weighted scenario lanes for the mix.
+     * Use this when each operation should receive a fixed proportion of the total workload.
+     */
+    WithScenarioMix(...scenarioMix) {
+        return this.withScenarioMix(...scenarioMix);
+    }
+    expandScenarios() {
+        return expandTrafficMixScenarios(this);
+    }
+    ExpandScenarios() {
+        return this.expandScenarios();
+    }
+    __loadStrikeTotalLoad() {
+        return this.totalLoad.map((simulation) => attachLoadSimulationProjection({ ...simulation }));
+    }
+    __loadStrikeScenarioMix() {
+        return [...this.scenarioMix];
+    }
+}
+exports.LoadStrikeTrafficMix = LoadStrikeTrafficMix;
 class LoadStrikeRunner {
     constructor(scenarios, options, contextConfigurators = []) {
         this.scenarios = scenarios;
@@ -2002,6 +2210,20 @@ class LoadStrikeRunner {
     static RegisterScenarios(...scenarios) {
         return LoadStrikeRunner.registerScenarios(...scenarios);
     }
+    /**
+     * Registers a traffic mix on a fresh runnable context.
+     * Use this when one total load profile should be split across weighted scenario lanes.
+     */
+    static registerTrafficMix(trafficMix) {
+        return LoadStrikeRunner.registerScenarios(...expandTrafficMixScenarios(trafficMix));
+    }
+    /**
+     * Registers a traffic mix on a fresh runnable context.
+     * Use this when one total load profile should be split across weighted scenario lanes.
+     */
+    static RegisterTrafficMix(trafficMix) {
+        return LoadStrikeRunner.registerTrafficMix(trafficMix);
+    }
     /**
      * Toggles realtime console metric output.
      * Use this when a local run or CI log should stream live throughput and latency updates.
@@ -2256,6 +2478,21 @@ class LoadStrikeRunner {
     AddScenarios(...scenarios) {
         return this.addScenarios(...scenarios);
     }
+    /**
+     * Adds a traffic mix to the current runner.
+     * Use this when one total load profile should be split across weighted scenario lanes.
+     */
+    addTrafficMix(trafficMix) {
+        this.scenarios = [...this.scenarios, ...expandTrafficMixScenarios(trafficMix)];
+        return this;
+    }
+    /**
+     * Adds a traffic mix to the current runner.
+     * Use this when one total load profile should be split across weighted scenario lanes.
+     */
+    AddTrafficMix(trafficMix) {
+        return this.addTrafficMix(trafficMix);
+    }
     /**
      * Applies a grouped configuration change to the current builder or context.
      * Use this when several related settings should be supplied in one step.
@@ -4408,6 +4645,111 @@ function attachLoadSimulationProjection(simulation) {
     });
     return simulation;
 }
+function expandTrafficMixScenarios(trafficMix) {
+    if (!(trafficMix instanceof LoadStrikeTrafficMix)) {
+        throw new TypeError("Traffic mix must be provided.");
+    }
+    const totalLoad = trafficMix.__loadStrikeTotalLoad();
+    if (!totalLoad.length) {
+        throw new Error("Traffic mix total load must be configured before registration.");
+    }
+    const scenarioMix = trafficMix.__loadStrikeScenarioMix();
+    if (!scenarioMix.length) {
+        throw new Error("Traffic mix scenario shares must be configured before registration.");
+    }
+    const weights = scenarioMix.map((share) => share.weight);
+    return scenarioMix.map((share, index) => {
+        const splitSimulations = totalLoad
+            .map((simulation) => splitTrafficSimulation(simulation, weights, index))
+            .filter((simulation) => simulation != null);
+        const scenario = !splitSimulations.length
+            ? share.scenario.withLoadSimulations(LoadStrikeSimulation.pause(0))
+            : share.scenario.withLoadSimulations(...splitSimulations);
+        return scenario.__loadStrikeWithInternalLicenseFeatures(TRAFFIC_MIX_FEATURE);
+    });
+}
+function splitTrafficSimulation(simulation, weights, index) {
+    const kind = String(simulation.Kind ?? "");
+    const duringSeconds = readFiniteSimulationNumber(simulation, "DuringSeconds");
+    const intervalSeconds = readFiniteSimulationNumber(simulation, "IntervalSeconds");
+    if (kind === "Inject") {
+        const rate = splitTrafficValue(readFiniteSimulationNumber(simulation, "Rate"), weights)[index];
+        return rate > 0 ? LoadStrikeSimulation.inject(rate, intervalSeconds, duringSeconds) : null;
+    }
+    if (kind === "RampingInject") {
+        const rate = splitTrafficValue(readFiniteSimulationNumber(simulation, "Rate"), weights)[index];
+        return rate > 0 ? LoadStrikeSimulation.rampingInject(rate, intervalSeconds, duringSeconds) : null;
+    }
+    if (kind === "InjectRandom") {
+        const minRate = splitTrafficValue(readFiniteSimulationNumber(simulation, "MinRate"), weights)[index];
+        const maxRate = splitTrafficValue(readFiniteSimulationNumber(simulation, "MaxRate"), weights)[index];
+        if (maxRate <= 0) {
+            return null;
+        }
+        return LoadStrikeSimulation.injectRandom(Math.min(minRate, maxRate), maxRate, intervalSeconds, duringSeconds);
+    }
+    if (kind === "IterationsForInject") {
+        const rate = splitTrafficValue(readFiniteSimulationNumber(simulation, "Rate"), weights)[index];
+        const iterations = splitTrafficValue(readFiniteSimulationNumber(simulation, "Iterations"), weights)[index];
+        return rate > 0 && iterations > 0
+            ? LoadStrikeSimulation.iterationsForInject(rate, intervalSeconds, iterations)
+            : null;
+    }
+    if (kind === "IterationsForConstant") {
+        const copies = splitTrafficValue(readFiniteSimulationNumber(simulation, "Copies"), weights)[index];
+        const iterations = splitTrafficValue(readFiniteSimulationNumber(simulation, "Iterations"), weights)[index];
+        return copies > 0 && iterations > 0
+            ? LoadStrikeSimulation.iterationsForConstant(copies, iterations)
+            : null;
+    }
+    if (kind === "KeepConstant") {
+        const copies = splitTrafficValue(readFiniteSimulationNumber(simulation, "Copies"), weights)[index];
+        return copies > 0 ? LoadStrikeSimulation.keepConstant(copies, duringSeconds) : null;
+    }
+    if (kind === "RampingConstant") {
+        const copies = splitTrafficValue(readFiniteSimulationNumber(simulation, "Copies"), weights)[index];
+        return copies > 0 ? LoadStrikeSimulation.rampingConstant(copies, duringSeconds) : null;
+    }
+    if (kind === "Pause") {
+        return LoadStrikeSimulation.pause(duringSeconds);
+    }
+    return attachLoadSimulationProjection({ ...simulation });
+}
+function splitTrafficValue(totalValue, weights) {
+    const normalizedTotal = Math.trunc(Number.isFinite(totalValue) ? totalValue : 0);
+    if (normalizedTotal <= 0) {
+        return weights.map(() => 0);
+    }
+    const totalWeight = weights.reduce((sum, weight) => sum + weight, 0);
+    if (totalWeight <= 0) {
+        throw new Error("Traffic mix scenario weights must add up to more than zero.");
+    }
+    const exactShares = weights.map((weight, index) => {
+        const exact = (normalizedTotal * weight) / totalWeight;
+        return {
+            index,
+            value: Math.floor(exact),
+            remainder: exact - Math.floor(exact)
+        };
+    });
+    const split = exactShares.map((share) => share.value);
+    let remaining = normalizedTotal - split.reduce((sum, value) => sum + value, 0);
+    for (const share of [...exactShares].sort((left, right) => {
+        const remainderDelta = right.remainder - left.remainder;
+        return remainderDelta !== 0 ? remainderDelta : left.index - right.index;
+    })) {
+        if (remaining <= 0) {
+            break;
+        }
+        split[share.index] += 1;
+        remaining -= 1;
+    }
+    return split;
+}
+function readFiniteSimulationNumber(simulation, key) {
+    const value = Number(simulation[key]);
+    return Number.isFinite(value) ? value : 0;
+}
 function attachScenarioStatsAliases(scenario) {
     const normalized = normalizeScenarioStatsValue(scenario);
     normalized.ok = attachMeasurementStatsAliases(normalized.ok);
@@ -8366,6 +8708,7 @@ exports.__loadstrikeTestExports = {
     detailedToNodeStats,
     evaluateThresholdsForScenarios,
     executeTrackedScenarioInvocation,
+    expandTrafficMixScenarios,
     extractContextOverridesFromArgs,
     extractContextOverridesFromConfig,
     findCaseInsensitiveKey,