@loadstrike/loadstrike-sdk 1.0.23601 → 1.0.26901

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.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.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.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 = 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; } });
@@ -21,7 +21,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; } });

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"));
@@ -92,13 +104,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 +380,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 +409,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 +461,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 +480,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 +498,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 +528,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.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.
@@ -1967,6 +1968,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 +2102,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 +2370,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.
@@ -3680,7 +3809,7 @@ function normalizeReply(value) {
         statusCode: normalizeStatusCode(value?.statusCode, Boolean(value?.isSuccess)),
         message: value?.message ? String(value.message) : "",
         sizeBytes: Number.isFinite(value?.sizeBytes) ? Number(value.sizeBytes) : 0,
-        customLatencyMs: Number.isFinite(value?.customLatencyMs) ? Number(value.customLatencyMs) : 0,
+        customLatencyMs: Number.isFinite(value?.customLatencyMs) ? Number(value.customLatencyMs) : -1,
         payload: value?.payload
     };
 }
@@ -3692,7 +3821,7 @@ function attachReplyProjection(reply) {
         SizeBytes: "sizeBytes",
         Payload: "payload"
     });
-    defineAliasProperty(reply, "CustomLatencyMs", () => Number.isFinite(reply.customLatencyMs) ? Number(reply.customLatencyMs) : 0);
+    defineAliasProperty(reply, "CustomLatencyMs", () => Number.isFinite(reply.customLatencyMs) ? Number(reply.customLatencyMs) : -1);
     const asReply = () => attachReplyProjection({
         isSuccess: reply.isSuccess,
         statusCode: reply.statusCode,
@@ -4408,6 +4537,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);
@@ -4590,15 +4824,15 @@ function attachRunResultAliases(result) {
     defineAliasProperty(projected, "Duration", () => projected.durationMs);
     return projected;
 }
-function resolveResponseCustomLatency(customLatencyMs, usesOverloadDefaults) {
+function resolveResponseCustomLatency(customLatencyMs, _usesOverloadDefaults) {
     if (!Number.isFinite(customLatencyMs)) {
-        return usesOverloadDefaults ? -1 : 0;
+        return -1;
     }
     return Number(customLatencyMs);
 }
 function resolveRecordedLatency(customLatencyMs, observedLatencyMs) {
     if (!Number.isFinite(customLatencyMs)) {
-        return 0;
+        return Math.max(observedLatencyMs, 0);
     }
     const resolved = Number(customLatencyMs);
     if (resolved >= 0) {
@@ -8366,6 +8600,7 @@ exports.__loadstrikeTestExports = {
     detailedToNodeStats,
     evaluateThresholdsForScenarios,
     executeTrackedScenarioInvocation,
+    expandTrafficMixScenarios,
     extractContextOverridesFromArgs,
     extractContextOverridesFromConfig,
     findCaseInsensitiveKey,

package/dist/esm/index.js

@@ -1,6 +1,6 @@
 export { LoadStrikeAutopilot, LoadStrikeAutopilotResult } from "./autopilot.js";
 export { LoadStrikeAutopilotReadiness } from "./autopilot-contracts.js";
-export { CrossPlatformScenarioConfigurator, ScenarioTrackingExtensions, LoadStrikeContext, LoadStrikePluginData, LoadStrikePluginDataTable, LoadStrikeNodeType, LoadStrikeReportFormat, LoadStrikeResponse, LoadStrikeLogLevel, LoadStrikeScenarioOperation, LoadStrikeOperationType, LoadStrikeRunner, LoadStrikeScenario, LoadStrikeSimulation, CrossPlatformTrackingConfiguration, LoadStrikeMetric, LoadStrikeCounter, LoadStrikeGauge, LoadStrikeStep, LoadStrikeThreshold } from "./runtime.js";
+export { CrossPlatformScenarioConfigurator, ScenarioTrackingExtensions, LoadStrikeContext, LoadStrikePluginData, LoadStrikePluginDataTable, LoadStrikeNodeType, LoadStrikeReportFormat, LoadStrikeResponse, LoadStrikeLogLevel, LoadStrikeScenarioOperation, LoadStrikeOperationType, LoadStrikeRunner, LoadStrikeScenario, LoadStrikeScenarioShare, LoadStrikeSimulation, LoadStrikeTrafficMix, CrossPlatformTrackingConfiguration, LoadStrikeMetric, LoadStrikeCounter, LoadStrikeGauge, LoadStrikeStep, LoadStrikeThreshold } from "./runtime.js";
 export { CorrelationStoreConfiguration, CrossPlatformTrackingRuntime, InMemoryCorrelationStore, RedisCorrelationStoreOptions, RedisCorrelationStore, TrackingPayloadBuilder, TrackingFieldSelector } from "./correlation.js";
 export { LOADSTRIKE_TRACE_ID_HEADER, LOADSTRIKE_TRACE_ID_TRACKING_FIELD, TrafficEndpointDefinition, HttpEndpointDefinition, KafkaEndpointDefinition, KafkaSaslOptions, RabbitMqEndpointDefinition, NatsEndpointDefinition, RedisStreamsEndpointDefinition, AzureEventHubsEndpointDefinition, SqsEndpointDefinition, DelegateStreamEndpointDefinition, PushDiffusionEndpointDefinition, HttpOAuth2ClientCredentialsOptions, HttpAuthOptions } from "./transports.js";
 export { DatadogReportingSink, DatadogReportingSinkOptions, GrafanaLokiReportingSink, GrafanaLokiReportingSinkOptions, InfluxDbReportingSink, InfluxDbReportingSinkOptions, OtelCollectorReportingSink, OtelCollectorReportingSinkOptions, PortalReportingSink, SplunkReportingSink, SplunkReportingSinkOptions, TimescaleDbReportingSink, TimescaleDbReportingSinkOptions } from "./sinks.js";

package/dist/esm/local.js

@@ -1,3 +1,15 @@
+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 _LoadStrikeLocalClient_licensingApiBaseUrl, _LoadStrikeLocalClient_signingKeyCache;
 import os from "node:os";
 import * as fs from "node:fs";
 import * as childProcess from "node:child_process";
@@ -53,13 +65,14 @@ export 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);
@@ -328,8 +341,8 @@ export 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;
         }
@@ -357,7 +370,7 @@ export class LoadStrikeLocalClient {
                 publicKeyPem,
                 expiresAtUtc: nowMs + (15 * 60 * 1000)
             };
-            this.signingKeyCache.set(cacheKey, keyRecord);
+            __classPrivateFieldGet(this, _LoadStrikeLocalClient_signingKeyCache, "f").set(cacheKey, keyRecord);
             return keyRecord;
         }
         finally {
@@ -409,7 +422,7 @@ export 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",
@@ -428,7 +441,7 @@ export 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"
@@ -445,6 +458,7 @@ export class LoadStrikeLocalClient {
         return { response, json };
     }
 }
+_LoadStrikeLocalClient_licensingApiBaseUrl = new WeakMap(), _LoadStrikeLocalClient_signingKeyCache = new WeakMap();
 function assertNoDisableLicenseEnforcementOption(value, source) {
     if (value == null || typeof value !== "object" || Array.isArray(value)) {
         return;
@@ -474,7 +488,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/esm/runtime.js

@@ -69,6 +69,7 @@ export const CrossPlatformTrackingConfiguration = {
         return this.forDuration(configuration, durationSeconds, cancellationSignal);
     }
 };
+const TRAFFIC_MIX_FEATURE = "workload.traffic_mix";
 export class LoadStrikePluginDataTable {
     /**
      * Exposes the public constructor operation.
@@ -1948,6 +1949,103 @@ export class LoadStrikeScenario {
         return this.withWeight(weight);
     }
 }
+export 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);
+    }
+}
+export 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];
+    }
+}
 export class LoadStrikeRunner {
     constructor(scenarios, options, contextConfigurators = []) {
         this.scenarios = scenarios;
@@ -1983,6 +2081,20 @@ export 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.
@@ -2237,6 +2349,21 @@ export 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.
@@ -3660,7 +3787,7 @@ function normalizeReply(value) {
         statusCode: normalizeStatusCode(value?.statusCode, Boolean(value?.isSuccess)),
         message: value?.message ? String(value.message) : "",
         sizeBytes: Number.isFinite(value?.sizeBytes) ? Number(value.sizeBytes) : 0,
-        customLatencyMs: Number.isFinite(value?.customLatencyMs) ? Number(value.customLatencyMs) : 0,
+        customLatencyMs: Number.isFinite(value?.customLatencyMs) ? Number(value.customLatencyMs) : -1,
         payload: value?.payload
     };
 }
@@ -3672,7 +3799,7 @@ function attachReplyProjection(reply) {
         SizeBytes: "sizeBytes",
         Payload: "payload"
     });
-    defineAliasProperty(reply, "CustomLatencyMs", () => Number.isFinite(reply.customLatencyMs) ? Number(reply.customLatencyMs) : 0);
+    defineAliasProperty(reply, "CustomLatencyMs", () => Number.isFinite(reply.customLatencyMs) ? Number(reply.customLatencyMs) : -1);
     const asReply = () => attachReplyProjection({
         isSuccess: reply.isSuccess,
         statusCode: reply.statusCode,
@@ -4388,6 +4515,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);
@@ -4570,15 +4802,15 @@ function attachRunResultAliases(result) {
     defineAliasProperty(projected, "Duration", () => projected.durationMs);
     return projected;
 }
-function resolveResponseCustomLatency(customLatencyMs, usesOverloadDefaults) {
+function resolveResponseCustomLatency(customLatencyMs, _usesOverloadDefaults) {
     if (!Number.isFinite(customLatencyMs)) {
-        return usesOverloadDefaults ? -1 : 0;
+        return -1;
     }
     return Number(customLatencyMs);
 }
 function resolveRecordedLatency(customLatencyMs, observedLatencyMs) {
     if (!Number.isFinite(customLatencyMs)) {
-        return 0;
+        return Math.max(observedLatencyMs, 0);
     }
     const resolved = Number(customLatencyMs);
     if (resolved >= 0) {
@@ -8346,6 +8578,7 @@ export const __loadstrikeTestExports = {
     detailedToNodeStats,
     evaluateThresholdsForScenarios,
     executeTrackedScenarioInvocation,
+    expandTrafficMixScenarios,
     extractContextOverridesFromArgs,
     extractContextOverridesFromConfig,
     findCaseInsensitiveKey,

package/dist/types/index.d.ts

@@ -2,7 +2,7 @@ export type { LoadStrikeDateValue, LoadStrikeObject, LoadStrikeRunContext as Loa
 export { LoadStrikeAutopilot, LoadStrikeAutopilotResult } from "./autopilot.js";
 export type { LoadStrikeAutopilotEndpoint, LoadStrikeAutopilotEndpointBinding, LoadStrikeAutopilotLoadSimulationSuggestion, LoadStrikeAutopilotMessageSample, LoadStrikeAutopilotOptions, LoadStrikeAutopilotPlan, LoadStrikeAutopilotPreviewReport, LoadStrikeAutopilotReadinessFailure, LoadStrikeAutopilotRedaction, LoadStrikeAutopilotRequest, LoadStrikeAutopilotResultShape, LoadStrikeAutopilotScenarioPlan, LoadStrikeAutopilotSecretBinding, LoadStrikeAutopilotThresholdSuggestion, LoadStrikeAutopilotTrackingSelectorSuggestion } from "./autopilot-contracts.js";
 export { LoadStrikeAutopilotReadiness } from "./autopilot-contracts.js";
-export { CrossPlatformScenarioConfigurator, ScenarioTrackingExtensions, LoadStrikeContext, LoadStrikePluginData, LoadStrikePluginDataTable, LoadStrikeNodeType, LoadStrikeReportFormat, LoadStrikeResponse, LoadStrikeLogLevel, LoadStrikeScenarioOperation, LoadStrikeOperationType, LoadStrikeRunner, LoadStrikeScenario, LoadStrikeSimulation, CrossPlatformTrackingConfiguration, LoadStrikeMetric, LoadStrikeCounter, LoadStrikeGauge, LoadStrikeStep, LoadStrikeThreshold } from "./runtime.js";
+export { CrossPlatformScenarioConfigurator, ScenarioTrackingExtensions, LoadStrikeContext, LoadStrikePluginData, LoadStrikePluginDataTable, LoadStrikeNodeType, LoadStrikeReportFormat, LoadStrikeResponse, LoadStrikeLogLevel, LoadStrikeScenarioOperation, LoadStrikeOperationType, LoadStrikeRunner, LoadStrikeScenario, LoadStrikeScenarioShare, LoadStrikeSimulation, LoadStrikeTrafficMix, CrossPlatformTrackingConfiguration, LoadStrikeMetric, LoadStrikeCounter, LoadStrikeGauge, LoadStrikeStep, LoadStrikeThreshold } from "./runtime.js";
 export type { ILoadStrikeReportingSink, ILoadStrikeWorkerPlugin, LoadStrikeRunResult, LoadStrikeReportingSink, LoadStrikeRuntimePolicy, LoadStrikeRunnerOptions, LoadStrikeRunContext as LoadStrikeRuntimeContext, LoadStrikeRunContext, LoadStrikeBaseContext, LoadStrikeCounterStats, LoadStrikeDataTransferStats, LoadStrikeGaugeStats, LoadStrikeLogger, LoadStrikeLoadSimulationStats, LoadStrikeMeasurementStats, LoadStrikeMetricStats, LoadStrikeNodeInfo, LoadStrikeMetricValue, LoadStrikeRandom, LoadStrikeReply, LoadStrikeLatencyCount, LoadStrikeLatencyStats, LoadStrikeLoadSimulation, LoadStrikeScenarioInfo, LoadStrikeScenarioInitContext, LoadStrikeScenarioPartition, LoadStrikeScenarioStartInfo, LoadStrikeScenarioContext, LoadStrikeScenarioStats, LoadStrikeTestInfo, LoadStrikeScenarioRuntime, LoadStrikeSessionStartInfo, LoadStrikeSinkSession, LoadStrikeSinkError, LoadStrikeStatusCodeStats, LoadStrikeThresholdResult, LoadStrikeThresholdPredicateContext, LoadStrikeStepReply, LoadStrikeStepStats, LoadStrikeStepRuntime, LoadStrikeThresholdOptions, LoadStrikeRequestStats, LoadStrikeWorkerPlugin } from "./runtime.js";
 export { CorrelationStoreConfiguration, CrossPlatformTrackingRuntime, InMemoryCorrelationStore, RedisCorrelationStoreOptions, RedisCorrelationStore, TrackingPayloadBuilder, TrackingFieldSelector } from "./correlation.js";
 export type { CorrelationEntry, DestinationConsumeResult, GatheredRow, CorrelationStoreKind, CorrelationRuntimeOptions, CorrelationRuntimePlugin, CorrelationRuntimeStats, CorrelationStore, SourceProduceResult, TrackingFieldLocation, TrackingPayload } from "./correlation.js";

package/dist/types/local.d.ts

@@ -21,9 +21,8 @@ export interface LicenseValidationSession {
     heartbeatTimer?: ReturnType<typeof setInterval>;
 }
 export declare class LoadStrikeLocalClient {
-    private readonly licensingApiBaseUrl;
+    #private;
     private readonly licenseValidationTimeoutMs;
-    private readonly signingKeyCache;
     /**
      * Exposes the public constructor operation.
      * Use this when the surrounding wrapper type makes this operation the clearest way to express your intent.

package/dist/types/runtime.d.ts

@@ -1674,6 +1674,61 @@ export declare class LoadStrikeScenario {
      */
     WithWeight(weight: number): LoadStrikeScenario;
 }
+export declare class LoadStrikeScenarioShare {
+    readonly scenario: LoadStrikeScenario;
+    readonly weight: number;
+    private constructor();
+    /**
+     * Creates a weighted scenario lane for a traffic mix.
+     * Use this when a total workload should be distributed across several scenarios.
+     */
+    static create(scenario: LoadStrikeScenario, weight: number): LoadStrikeScenarioShare;
+    /**
+     * Creates a weighted scenario lane for a traffic mix.
+     * Use this when a total workload should be distributed across several scenarios.
+     */
+    static Create(scenario: LoadStrikeScenario, weight: number): LoadStrikeScenarioShare;
+}
+export declare class LoadStrikeTrafficMix {
+    readonly name: string;
+    private readonly totalLoad;
+    private readonly scenarioMix;
+    private constructor();
+    /**
+     * Creates a traffic mix definition.
+     * Use this when one total load profile should be split across multiple scenario lanes.
+     */
+    static create(name: string): LoadStrikeTrafficMix;
+    /**
+     * Creates a traffic mix definition.
+     * Use this when one total load profile should be split across multiple scenario lanes.
+     */
+    static Create(name: string): LoadStrikeTrafficMix;
+    /**
+     * 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: Array<Record<string, unknown>>): LoadStrikeTrafficMix;
+    /**
+     * 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: Array<Record<string, unknown>>): LoadStrikeTrafficMix;
+    /**
+     * Sets the weighted scenario lanes for the mix.
+     * Use this when each operation should receive a fixed proportion of the total workload.
+     */
+    withScenarioMix(...scenarioMix: LoadStrikeScenarioShare[]): LoadStrikeTrafficMix;
+    /**
+     * Sets the weighted scenario lanes for the mix.
+     * Use this when each operation should receive a fixed proportion of the total workload.
+     */
+    WithScenarioMix(...scenarioMix: LoadStrikeScenarioShare[]): LoadStrikeTrafficMix;
+    expandScenarios(): LoadStrikeScenario[];
+    ExpandScenarios(): LoadStrikeScenario[];
+    __loadStrikeTotalLoad(): Array<Record<string, unknown>>;
+    __loadStrikeScenarioMix(): LoadStrikeScenarioShare[];
+}
 export declare class LoadStrikeRunner {
     private scenarios;
     private options;
@@ -1699,6 +1754,16 @@ export declare class LoadStrikeRunner {
      * Use this when you want a context immediately without composing a runner first.
      */
     static RegisterScenarios(...scenarios: LoadStrikeScenario[]): LoadStrikeContext;
+    /**
+     * 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: LoadStrikeTrafficMix): LoadStrikeContext;
+    /**
+     * 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: LoadStrikeTrafficMix): LoadStrikeContext;
     /**
      * Toggles realtime console metric output.
      * Use this when a local run or CI log should stream live throughput and latency updates.
@@ -1868,6 +1933,16 @@ export declare class LoadStrikeRunner {
      * Use this when the run should execute a batch of scenario definitions together.
      */
     AddScenarios(...scenarios: LoadStrikeScenario[]): LoadStrikeRunner;
+    /**
+     * Adds a traffic mix to the current runner.
+     * Use this when one total load profile should be split across weighted scenario lanes.
+     */
+    addTrafficMix(trafficMix: LoadStrikeTrafficMix): LoadStrikeRunner;
+    /**
+     * Adds a traffic mix to the current runner.
+     * Use this when one total load profile should be split across weighted scenario lanes.
+     */
+    AddTrafficMix(trafficMix: LoadStrikeTrafficMix): LoadStrikeRunner;
     /**
      * Applies a grouped configuration change to the current builder or context.
      * Use this when several related settings should be supplied in one step.
@@ -2010,6 +2085,7 @@ declare function combineAbortSignals(...signals: AbortSignal[]): AbortSignal;
 declare function delayWithAbort(durationMs: number, signal: AbortSignal): Promise<void>;
 declare function createRuntimeRandom(): LoadStrikeRandom;
 declare function parseAliasDate(value: string | Date | null | undefined): Date | undefined;
+declare function expandTrafficMixScenarios(trafficMix: LoadStrikeTrafficMix): LoadStrikeScenario[];
 declare function attachScenarioStatsAliases(scenario: Omit<LoadStrikeScenarioStats, "FindStepStats" | "GetStepStats"> & Partial<Pick<LoadStrikeScenarioStats, "FindStepStats" | "GetStepStats">>): LoadStrikeScenarioStats;
 declare function attachNodeStatsAliases(stats: Omit<LoadStrikeNodeStats, "FindScenarioStats" | "GetScenarioStats"> & Partial<Pick<LoadStrikeNodeStats, "FindScenarioStats" | "GetScenarioStats">>): LoadStrikeNodeStats;
 declare function attachRunResultAliases(result: LoadStrikeRunResult): LoadStrikeRunResult;
@@ -2255,6 +2331,7 @@ export declare const __loadstrikeTestExports: {
     detailedToNodeStats: typeof detailedToNodeStats;
     evaluateThresholdsForScenarios: typeof evaluateThresholdsForScenarios;
     executeTrackedScenarioInvocation: typeof executeTrackedScenarioInvocation;
+    expandTrafficMixScenarios: typeof expandTrafficMixScenarios;
     extractContextOverridesFromArgs: typeof extractContextOverridesFromArgs;
     extractContextOverridesFromConfig: typeof extractContextOverridesFromConfig;
     findCaseInsensitiveKey: typeof findCaseInsensitiveKey;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loadstrike/loadstrike-sdk",
-  "version": "1.0.23601",
+  "version": "1.0.26901",
   "description": "TypeScript and JavaScript SDK for in-process load execution, traffic correlation, and reporting.",
   "keywords": [
     "load-testing",
@@ -82,6 +82,7 @@
     "typescript": "^5.9.2"
   },
   "overrides": {
-    "brace-expansion": "5.0.5"
+    "brace-expansion": "5.0.6",
+    "tar": "7.5.16"
   }
 }