@loadstrike/loadstrike-sdk 1.0.10101 → 1.0.15201

package/README.md

@@ -1,6 +1,6 @@
 # LoadStrike for TypeScript and JavaScript
 
-LoadStrike is a TypeScript and JavaScript SDK for defining and running load, traffic-correlation, and reporting scenarios directly inside your application or test process.
+LoadStrike for TypeScript and JavaScript lets you define, run, and report load scenarios directly from your application or test suite.
 
 ## Requirements
 
@@ -12,12 +12,12 @@ LoadStrike is a TypeScript and JavaScript SDK for defining and running load, tra
 npm install @loadstrike/loadstrike-sdk
 ```
 
-## What It Provides
+## What You Can Do
 
-- Scenario, step, load-simulation, threshold, and metric primitives
-- Native in-process execution with structured run results
-- Local and distributed cluster execution helpers
-- HTML, TXT, CSV, and Markdown report generation
+- Define scenarios, steps, load simulations, thresholds, and metrics in code
+- Run workloads in-process and collect structured results
+- Generate HTML, Markdown, TXT, and CSV reports
+- Extend runs with correlation, distributed execution, and reporting sinks when needed
 
 ## Supported Transports
 
@@ -66,8 +66,8 @@ const result = await LoadStrikeRunner
   .run();
 ```
 
-A valid `RunnerKey` is required to execute live workloads.
+Use a runner key from your LoadStrike portal account when executing live workloads.
 
-## Documentation
+## Documentation And Examples
 
 https://loadstrike.com/documentation

package/dist/cjs/cluster.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DistributedClusterAgent = exports.DistributedClusterCoordinator = exports.LocalClusterCoordinator = void 0;
+exports.__loadstrikeTestExports = exports.DistributedClusterAgent = exports.DistributedClusterCoordinator = exports.LocalClusterCoordinator = void 0;
 exports.planAgentScenarioAssignments = planAgentScenarioAssignments;
 const node_crypto_1 = require("node:crypto");
 const transports_js_1 = require("./transports.js");
@@ -408,3 +408,20 @@ function booleanOrDefault(value, fallback) {
 async function sleep(ms) {
     await new Promise((resolve) => setTimeout(resolve, ms));
 }
+exports.__loadstrikeTestExports = {
+    DistributedClusterAgent,
+    DistributedClusterCoordinator,
+    LocalClusterCoordinator,
+    arrayOrUndefined,
+    booleanOrDefault,
+    buildWeightedCycle,
+    convertRunResult,
+    numberOrDefault,
+    parseRunCommand,
+    parseRunResult,
+    planAgentScenarioAssignments,
+    recordOrUndefined,
+    sanitizeToken,
+    sleep,
+    stringOrDefault
+};

package/dist/cjs/correlation.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CrossPlatformTrackingRuntime = exports.TrackingFieldSelector = exports.RedisCorrelationStore = exports.InMemoryCorrelationStore = exports.CorrelationStoreConfiguration = exports.RedisCorrelationStoreOptions = exports.TrackingPayloadBuilder = void 0;
+exports.__loadstrikeTestExports = exports.CrossPlatformTrackingRuntime = exports.TrackingFieldSelector = exports.RedisCorrelationStore = exports.InMemoryCorrelationStore = exports.CorrelationStoreConfiguration = exports.RedisCorrelationStoreOptions = exports.TrackingPayloadBuilder = void 0;
 const node_crypto_1 = require("node:crypto");
 const redis_1 = require("redis");
 class TrackingPayloadBuilder {
@@ -559,11 +559,10 @@ class TrackingFieldSelector {
     }
     extract(payload) {
         if (this.kind === "header") {
-            const headerName = this.path.toLowerCase();
             const headers = payload.headers ?? {};
             for (const [key, value] of Object.entries(headers)) {
                 const parsed = String(value ?? "").trim();
-                if (key.toLowerCase() === headerName && parsed) {
+                if (key === this.path && parsed) {
                     return parsed;
                 }
             }
@@ -604,6 +603,8 @@ function normalizeTrackingFieldLocation(location) {
 }
 class CrossPlatformTrackingRuntime {
     constructor(options) {
+        this.trackingIdDisplayByEventId = new Map();
+        this.gatherByDisplayByComparisonKey = new Map();
         this.producedCount = 0;
         this.consumedCount = 0;
         this.matchedCount = 0;
@@ -617,6 +618,8 @@ class CrossPlatformTrackingRuntime {
         this.gatherSelector = options.destinationGatherByField
             ? TrackingFieldSelector.parse(options.destinationGatherByField)
             : null;
+        this.trackingFieldValueCaseSensitive = options.trackingFieldValueCaseSensitive ?? true;
+        this.gatherByFieldValueCaseSensitive = options.gatherByFieldValueCaseSensitive ?? true;
         this.timeoutMs = Math.max(options.correlationTimeoutMs ?? 30000, 1);
         this.timeoutCountsAsFailure = options.timeoutCountsAsFailure ?? true;
         this.store = options.store ?? new InMemoryCorrelationStore();
@@ -639,13 +642,17 @@ class CrossPlatformTrackingRuntime {
             return result;
         }
         result.trackingId = trackingId;
-        const sourceOccurrences = await this.store.incrementSourceOccurrences(trackingId);
+        const comparisonTrackingId = normalizeComparisonValue(trackingId, this.trackingFieldValueCaseSensitive);
+        const sourceOccurrences = await this.store.incrementSourceOccurrences(comparisonTrackingId);
         if (sourceOccurrences > 1) {
             this.duplicateSourceCount += 1;
             result.duplicateSource = true;
         }
-        const registration = await this.store.registerSource(trackingId, nowMs);
+        const registration = await this.store.registerSource(comparisonTrackingId, nowMs);
         result.eventId = registration.eventId ?? "";
+        if (registration.eventId) {
+            this.trackingIdDisplayByEventId.set(registration.eventId, trackingId);
+        }
         if (registration.eventId) {
             await this.store.tryExpire(registration.eventId);
         }
@@ -686,12 +693,13 @@ class CrossPlatformTrackingRuntime {
             return result;
         }
         result.trackingId = trackingId;
-        const destinationOccurrences = await this.store.incrementDestinationOccurrences(trackingId);
+        const comparisonTrackingId = normalizeComparisonValue(trackingId, this.trackingFieldValueCaseSensitive);
+        const destinationOccurrences = await this.store.incrementDestinationOccurrences(comparisonTrackingId);
         if (destinationOccurrences > 1) {
             this.duplicateDestinationCount += 1;
             result.duplicateDestination = true;
         }
-        const source = await this.store.tryMatchDestination(trackingId, nowMs);
+        const source = await this.store.tryMatchDestination(comparisonTrackingId, nowMs);
         if (!source) {
             result.message = "Destination tracking id had no source match.";
             return result;
@@ -699,10 +707,12 @@ class CrossPlatformTrackingRuntime {
         this.matchedCount += 1;
         const latencyMs = Math.max(nowMs - (source.producedUtc ?? source.sourceTimestampUtc ?? nowMs), 0);
         this.totalLatencyMs += latencyMs;
+        const displayTrackingId = this.resolveTrackingIdDisplay(source.eventId, source.trackingId, true);
         const gatherKey = this.resolveGatherKey(payload);
         result.eventId = source.eventId ?? "";
         result.sourceTimestampUtc = source.sourceTimestampUtc ?? source.producedUtc ?? 0;
         result.destinationTimestampUtc = nowMs;
+        result.trackingId = displayTrackingId;
         result.gatherKey = gatherKey;
         result.matched = true;
         result.latencyMs = latencyMs;
@@ -712,7 +722,7 @@ class CrossPlatformTrackingRuntime {
         this.gathered.set(gatherKey, row);
         for (const plugin of this.plugins) {
             if (plugin.onMatched) {
-                await plugin.onMatched(trackingId, source.payload, payload, latencyMs);
+                await plugin.onMatched(displayTrackingId, source.payload, payload, latencyMs, gatherKey);
             }
         }
         return result;
@@ -760,7 +770,9 @@ class CrossPlatformTrackingRuntime {
             expiredEntries.push(entry);
         }
         for (const entry of expiredEntries) {
+            const displayTrackingId = this.resolveTrackingIdDisplay(entry.eventId, entry.trackingId, true);
             this.timeoutCount += 1;
+            entry.trackingId = displayTrackingId;
             const gatherKey = this.resolveGatherKey(entry.payload);
             const row = this.gathered.get(gatherKey) ?? { total: 0, matched: 0, timedOut: 0 };
             row.total += 1;
@@ -768,7 +780,7 @@ class CrossPlatformTrackingRuntime {
             this.gathered.set(gatherKey, row);
             for (const plugin of this.plugins) {
                 if (plugin.onTimeout) {
-                    await plugin.onTimeout(entry.trackingId, entry.payload);
+                    await plugin.onTimeout(displayTrackingId, entry.payload);
                 }
             }
         }
@@ -792,13 +804,42 @@ class CrossPlatformTrackingRuntime {
         if (!this.gatherSelector) {
             return "__ungrouped__";
         }
-        return this.gatherSelector.extract(payload) || "__unknown__";
+        const gatherKey = this.gatherSelector.extract(payload);
+        if (!gatherKey) {
+            return "__unknown__";
+        }
+        if (this.gatherByFieldValueCaseSensitive) {
+            return gatherKey;
+        }
+        const comparisonKey = normalizeComparisonValue(gatherKey, false);
+        const existing = this.gatherByDisplayByComparisonKey.get(comparisonKey);
+        if (existing) {
+            return existing;
+        }
+        this.gatherByDisplayByComparisonKey.set(comparisonKey, gatherKey);
+        return gatherKey;
     }
     isTimeoutCountedAsFailure() {
         return this.timeoutCountsAsFailure;
     }
+    resolveTrackingIdDisplay(eventId, fallbackTrackingId, remove) {
+        if (!eventId?.trim()) {
+            return fallbackTrackingId;
+        }
+        if (remove) {
+            const displayTrackingId = this.trackingIdDisplayByEventId.get(eventId);
+            this.trackingIdDisplayByEventId.delete(eventId);
+            return displayTrackingId ?? fallbackTrackingId;
+        }
+        return this.trackingIdDisplayByEventId.get(eventId) ?? fallbackTrackingId;
+    }
 }
 exports.CrossPlatformTrackingRuntime = CrossPlatformTrackingRuntime;
+function normalizeComparisonValue(value, caseSensitive) {
+    return caseSensitive
+        ? value
+        : value.toUpperCase();
+}
 function normalizeJsonBody(body) {
     if (body instanceof Uint8Array) {
         return normalizeJsonBody(trackingBodyToUtf8(body));
@@ -917,7 +958,9 @@ function uniqueStringList(values) {
     return [...new Set(values.filter((value) => value.trim().length > 0))];
 }
 function createRedisStoreClient(connectionString, database) {
-    const client = (0, redis_1.createClient)({
+    const createClientOverride = globalThis
+        .__wave15CreateRedisClient;
+    const client = (typeof createClientOverride === "function" ? createClientOverride : redis_1.createClient)({
         url: connectionString,
         database: database >= 0 ? database : undefined
     });
@@ -1007,3 +1050,18 @@ function readJsonPathSegment(current, segment) {
     }
     return undefined;
 }
+exports.__loadstrikeTestExports = {
+    CorrelationStoreConfiguration,
+    InMemoryCorrelationStore,
+    RedisCorrelationStore,
+    RedisCorrelationStoreOptions,
+    TrackingFieldSelector,
+    createRedisStoreClient,
+    hydrateCorrelationEntry,
+    normalizeCorrelationEntry,
+    parseStringList,
+    readJsonPathSegment,
+    sanitizeLooseJson,
+    tryParseObject,
+    uniqueStringList
+};

package/dist/cjs/index.js

@@ -1,17 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DatadogReportingSinkOptions = exports.DatadogReportingSink = exports.ConsoleReportingSink = exports.CompositeReportingSink = exports.planAgentScenarioAssignments = exports.LocalClusterCoordinator = exports.DistributedClusterCoordinator = exports.DistributedClusterAgent = exports.HttpAuthOptions = exports.HttpOAuth2ClientCredentialsOptions = exports.PushDiffusionEndpointDefinition = exports.DelegateStreamEndpointDefinition = exports.AzureEventHubsEndpointDefinition = exports.RedisStreamsEndpointDefinition = exports.NatsEndpointDefinition = exports.RabbitMqEndpointDefinition = exports.KafkaSaslOptions = exports.KafkaEndpointDefinition = exports.HttpEndpointDefinition = exports.TrafficEndpointDefinition = exports.EndpointAdapterFactory = 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.LoadStrikeSimulation = exports.LoadStrikeScenario = exports.LoadStrikeRunner = exports.LoadStrikeOperationType = exports.LoadStrikeScenarioOperation = exports.LoadStrikeLogLevel = exports.LoadStrikeResponse = exports.LoadStrikeReportFormat = exports.LoadStrikeNodeType = exports.LoadStrikeReportData = exports.LoadStrikePluginDataTable = exports.LoadStrikePluginData = exports.LoadStrikeContext = exports.ScenarioTrackingExtensions = exports.CrossPlatformScenarioConfigurator = exports.LoadStrikeLocalClient = exports.DEFAULT_LICENSING_API_BASE_URL = void 0;
-exports.TimescaleDbReportingSinkOptions = exports.TimescaleDbReportingSink = exports.SplunkReportingSinkOptions = exports.SplunkReportingSink = exports.OtelCollectorReportingSinkOptions = exports.OtelCollectorReportingSink = exports.MemoryReportingSink = exports.InfluxDbReportingSinkOptions = exports.InfluxDbReportingSink = exports.GrafanaLokiReportingSinkOptions = exports.GrafanaLokiReportingSink = void 0;
-var local_js_1 = require("./local.js");
-Object.defineProperty(exports, "DEFAULT_LICENSING_API_BASE_URL", { enumerable: true, get: function () { return local_js_1.DEFAULT_LICENSING_API_BASE_URL; } });
-Object.defineProperty(exports, "LoadStrikeLocalClient", { enumerable: true, get: function () { return local_js_1.LoadStrikeLocalClient; } });
+exports.TimescaleDbReportingSink = exports.SplunkReportingSinkOptions = exports.SplunkReportingSink = exports.OtelCollectorReportingSinkOptions = exports.OtelCollectorReportingSink = exports.InfluxDbReportingSinkOptions = exports.InfluxDbReportingSink = exports.GrafanaLokiReportingSinkOptions = exports.GrafanaLokiReportingSink = exports.DatadogReportingSinkOptions = exports.DatadogReportingSink = exports.HttpAuthOptions = exports.HttpOAuth2ClientCredentialsOptions = exports.PushDiffusionEndpointDefinition = exports.DelegateStreamEndpointDefinition = exports.AzureEventHubsEndpointDefinition = exports.RedisStreamsEndpointDefinition = exports.NatsEndpointDefinition = exports.RabbitMqEndpointDefinition = exports.KafkaSaslOptions = exports.KafkaEndpointDefinition = exports.HttpEndpointDefinition = exports.TrafficEndpointDefinition = exports.EndpointAdapterFactory = 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.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 = void 0;
+exports.TimescaleDbReportingSinkOptions = void 0;
 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, "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, "LoadStrikeReportData", { enumerable: true, get: function () { return runtime_js_1.LoadStrikeReportData; } });
 Object.defineProperty(exports, "LoadStrikeNodeType", { enumerable: true, get: function () { return runtime_js_1.LoadStrikeNodeType; } });
 Object.defineProperty(exports, "LoadStrikeReportFormat", { enumerable: true, get: function () { return runtime_js_1.LoadStrikeReportFormat; } });
 Object.defineProperty(exports, "LoadStrikeResponse", { enumerable: true, get: function () { return runtime_js_1.LoadStrikeResponse; } });
@@ -48,21 +44,13 @@ Object.defineProperty(exports, "DelegateStreamEndpointDefinition", { enumerable:
 Object.defineProperty(exports, "PushDiffusionEndpointDefinition", { enumerable: true, get: function () { return transports_js_1.PushDiffusionEndpointDefinition; } });
 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 cluster_js_1 = require("./cluster.js");
-Object.defineProperty(exports, "DistributedClusterAgent", { enumerable: true, get: function () { return cluster_js_1.DistributedClusterAgent; } });
-Object.defineProperty(exports, "DistributedClusterCoordinator", { enumerable: true, get: function () { return cluster_js_1.DistributedClusterCoordinator; } });
-Object.defineProperty(exports, "LocalClusterCoordinator", { enumerable: true, get: function () { return cluster_js_1.LocalClusterCoordinator; } });
-Object.defineProperty(exports, "planAgentScenarioAssignments", { enumerable: true, get: function () { return cluster_js_1.planAgentScenarioAssignments; } });
 var sinks_js_1 = require("./sinks.js");
-Object.defineProperty(exports, "CompositeReportingSink", { enumerable: true, get: function () { return sinks_js_1.CompositeReportingSink; } });
-Object.defineProperty(exports, "ConsoleReportingSink", { enumerable: true, get: function () { return sinks_js_1.ConsoleReportingSink; } });
 Object.defineProperty(exports, "DatadogReportingSink", { enumerable: true, get: function () { return sinks_js_1.DatadogReportingSink; } });
 Object.defineProperty(exports, "DatadogReportingSinkOptions", { enumerable: true, get: function () { return sinks_js_1.DatadogReportingSinkOptions; } });
 Object.defineProperty(exports, "GrafanaLokiReportingSink", { enumerable: true, get: function () { return sinks_js_1.GrafanaLokiReportingSink; } });
 Object.defineProperty(exports, "GrafanaLokiReportingSinkOptions", { enumerable: true, get: function () { return sinks_js_1.GrafanaLokiReportingSinkOptions; } });
 Object.defineProperty(exports, "InfluxDbReportingSink", { enumerable: true, get: function () { return sinks_js_1.InfluxDbReportingSink; } });
 Object.defineProperty(exports, "InfluxDbReportingSinkOptions", { enumerable: true, get: function () { return sinks_js_1.InfluxDbReportingSinkOptions; } });
-Object.defineProperty(exports, "MemoryReportingSink", { enumerable: true, get: function () { return sinks_js_1.MemoryReportingSink; } });
 Object.defineProperty(exports, "OtelCollectorReportingSink", { enumerable: true, get: function () { return sinks_js_1.OtelCollectorReportingSink; } });
 Object.defineProperty(exports, "OtelCollectorReportingSinkOptions", { enumerable: true, get: function () { return sinks_js_1.OtelCollectorReportingSinkOptions; } });
 Object.defineProperty(exports, "SplunkReportingSink", { enumerable: true, get: function () { return sinks_js_1.SplunkReportingSink; } });

package/dist/cjs/local.js

@@ -36,14 +36,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LoadStrikeLocalClient = exports.DEFAULT_LICENSING_API_BASE_URL = void 0;
+exports.__loadstrikeTestExports = exports.LoadStrikeLocalClient = void 0;
 const node_os_1 = __importDefault(require("node:os"));
 const fs = __importStar(require("node:fs"));
 const childProcess = __importStar(require("node:child_process"));
 const node_crypto_1 = require("node:crypto");
 const correlation_js_1 = require("./correlation.js");
 const transports_js_1 = require("./transports.js");
-exports.DEFAULT_LICENSING_API_BASE_URL = "https://licensing.loadstrike.com";
+const DEFAULT_LICENSING_API_BASE_URL = "https://licensing.loadstrike.com";
+let developmentLicensingApiBaseUrlOverride;
 const BUILT_IN_WORKER_PLUGIN_NAMES = new Set([
     "loadstrike failed responses",
     "loadstrike correlation"
@@ -87,7 +88,7 @@ class LoadStrikeLocalClient {
     constructor(options = {}) {
         this.signingKeyCache = new Map();
         assertNoDisableLicenseEnforcementOption(options, "LoadStrikeLocalClient");
-        this.licensingApiBaseUrl = normalizeLicensingApiBaseUrl(options.licensingApiBaseUrl);
+        this.licensingApiBaseUrl = resolveLicensingApiBaseUrl();
         this.licenseValidationTimeoutMs = normalizeTimeoutMs(options.licenseValidationTimeoutMs);
     }
     async run(request) {
@@ -177,9 +178,10 @@ class LoadStrikeLocalClient {
         const timer = setTimeout(() => controller.abort(), this.licenseValidationTimeoutMs);
         try {
             const { response, json } = await this.postLicensingRequest("/api/v1/licenses/validate", payload, controller.signal);
-            if (!response.ok || json.IsValid !== true) {
-                const denialCode = stringOrDefault(json.DenialCode, "unknown_denial");
-                const details = stringOrDefault(json.Message, "No additional details provided.");
+            const isValid = pickValue(json, "IsValid", "isValid");
+            if (!response.ok || isValid !== true) {
+                const denialCode = stringOrDefault(pickValue(json, "DenialCode", "denialCode"), "unknown_denial");
+                const details = stringOrDefault(pickValue(json, "Message", "message"), "No additional details provided.");
                 throw new Error(`Runner key validation denied for '${runnerKey}'. Reason: ${denialCode}. ${details}`);
             }
             const runToken = stringOrDefault(pickValue(json, "RunToken", "SignedRunToken", "Token", "runToken"), "").trim();
@@ -257,7 +259,9 @@ class LoadStrikeLocalClient {
     }
     async getSigningKey(keyId, algorithm) {
         const nowMs = Date.now();
-        const cacheKey = this.licensingApiBaseUrl.toLowerCase();
+        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);
         if (cached && cached.expiresAtUtc > nowMs) {
             return cached;
@@ -265,17 +269,21 @@ class LoadStrikeLocalClient {
         const controller = new AbortController();
         const timer = setTimeout(() => controller.abort(), this.licenseValidationTimeoutMs);
         try {
-            const { response, json } = await this.getLicensingRequest("/api/v1/licenses/signing-public-key", controller.signal);
+            const { response, json } = await this.getLicensingRequest(`/api/v1/licenses/signing-public-key?kid=${encodeURIComponent(normalizedKeyId)}`, controller.signal);
             if (!response.ok) {
                 throw new Error(`Failed to resolve licensing signing key. status=${response.status}`);
             }
-            const resolvedAlgorithm = stringOrDefault(pickValue(json, "Algorithm", "alg"), algorithm).toUpperCase();
-            const publicKeyPem = stringOrDefault(pickValue(json, "PublicKeyPem", "PublicKey", "Pem"), "");
+            const resolvedAlgorithm = stringOrDefault(pickValue(json, "Algorithm", "algorithm", "alg"), normalizedAlgorithm).toUpperCase();
+            const publicKeyPem = normalizePemText(pickValue(json, "PublicKeyPem", "publicKeyPem", "PublicKey", "publicKey", "Pem", "pem"));
             if (!publicKeyPem.trim()) {
                 throw new Error("Runner key validation failed: signing key response is empty.");
             }
+            const resolvedKeyId = stringOrDefault(pickValue(json, "KeyId", "keyId", "Kid", "kid"), normalizedKeyId).trim() || normalizedKeyId;
+            if (resolvedKeyId !== normalizedKeyId) {
+                throw new Error("Runner key validation failed: signing key response key id does not match requested key id.");
+            }
             const keyRecord = {
-                keyId: stringOrDefault(pickValue(json, "KeyId", "Kid", "kid"), keyId),
+                keyId: resolvedKeyId,
                 algorithm: resolvedAlgorithm,
                 issuer: stringOrDefault(pickValue(json, "Issuer", "issuer"), ""),
                 audience: stringOrDefault(pickValue(json, "Audience", "audience"), ""),
@@ -394,7 +402,13 @@ function sanitizeRequest(request) {
 }
 function normalizeLicensingApiBaseUrl(value) {
     const normalized = (value ?? "").trim();
-    return normalized || exports.DEFAULT_LICENSING_API_BASE_URL;
+    return normalized || DEFAULT_LICENSING_API_BASE_URL;
+}
+function resolveLicensingApiBaseUrl() {
+    return normalizeLicensingApiBaseUrl(process.env.LOADSTRIKE_LICENSING_API_BASE_URL ?? developmentLicensingApiBaseUrlOverride);
+}
+function setDevelopmentLicensingApiBaseUrlOverride(value) {
+    developmentLicensingApiBaseUrlOverride = value;
 }
 function normalizeTimeoutMs(value) {
     if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
@@ -451,14 +465,8 @@ function collectRequestedFeatures(request) {
     if (hasCustomSink) {
         features.add("extensions.reporting_sinks.custom");
     }
-    if (pickValue(context, "ReportFinalizer", "reportFinalizer") != null) {
-        features.add("policy.report_finalizer_and_threshold_controls");
-    }
     for (const scenarioValue of scenarios) {
         const scenario = asRecord(scenarioValue);
-        for (const feature of normalizeStringArray(pickValue(scenario, "LicenseFeatures", "licenseFeatures"))) {
-            features.add(feature);
-        }
         if (asList(scenario.Thresholds).length > 0) {
             features.add("policy.report_finalizer_and_threshold_controls");
         }
@@ -748,6 +756,8 @@ async function evaluateScenarioOutcome(scenario, requestCount, context) {
         sourceTrackingField: sourceEndpoint.trackingField,
         destinationTrackingField: destinationEndpoint?.trackingField,
         destinationGatherByField: destinationEndpoint?.gatherByField,
+        trackingFieldValueCaseSensitive: toBoolean(pickValue(tracking, "TrackingFieldValueCaseSensitive", "trackingFieldValueCaseSensitive"), true),
+        gatherByFieldValueCaseSensitive: toBoolean(pickValue(tracking, "GatherByFieldValueCaseSensitive", "gatherByFieldValueCaseSensitive"), true),
         correlationTimeoutMs: timeoutMs,
         timeoutCountsAsFailure,
         store: correlationStore ?? undefined
@@ -1128,11 +1138,11 @@ function normalizePayload(payload, endpoint, index) {
 function readTrackingId(payload, selector) {
     const normalized = selector.trim().toLowerCase();
     if (normalized.startsWith("header:")) {
-        const expected = selector.slice("header:".length).trim().toLowerCase();
+        const expected = selector.slice("header:".length).trim();
         const headers = payload.headers ?? {};
         for (const [key, value] of Object.entries(headers)) {
             const normalizedValue = String(value ?? "").trim();
-            if (key.toLowerCase() === expected && normalizedValue) {
+            if (key === expected && normalizedValue) {
                 return normalizedValue;
             }
         }
@@ -1573,8 +1583,8 @@ function isRuntimeReportingSink(value) {
         "SaveRealtimeStats",
         "saveRealtimeMetrics",
         "SaveRealtimeMetrics",
-        "saveFinalStats",
-        "SaveFinalStats",
+        "saveRunResult",
+        "SaveRunResult",
         "stop",
         "Stop"
     ].some((name) => typeof record[name] === "function");
@@ -1600,6 +1610,20 @@ function stringOrDefault(value, fallback) {
     }
     return String(value);
 }
+function normalizePemText(value) {
+    let text = stringOrDefault(value, "").trim();
+    if (!text) {
+        return "";
+    }
+    if (text.length >= 2 && text.startsWith("\"") && text.endsWith("\"")) {
+        text = text.slice(1, -1).trim();
+    }
+    text = text.replace(/\\r\\n/g, "\n").replace(/\\n/g, "\n").replace(/\\r/g, "\r").trim();
+    if (text.length >= 2 && text.startsWith("\"") && text.endsWith("\"")) {
+        text = text.slice(1, -1).trim();
+    }
+    return text;
+}
 function asInt(value) {
     if (typeof value === "number" && Number.isFinite(value)) {
         return Math.trunc(value);
@@ -1882,3 +1906,64 @@ function resolveTimeoutSeconds(context, secondsKey, secondsAlias, millisecondsKe
 function asList(value) {
     return Array.isArray(value) ? value : [];
 }
+exports.__loadstrikeTestExports = {
+    addIfNotBlank,
+    asNullableInt,
+    asNumber,
+    buildThresholdExpression,
+    collectClaimStrings,
+    collectRequestedFeatures,
+    computeScenarioRequestCount,
+    countCustomWorkerPlugins,
+    countTargetedScenarios,
+    decodeBase64Url,
+    decodeJwtJsonSegment,
+    deviceHash,
+    enforceEntitlementClaims,
+    enforceJwtLifetime,
+    enforceRuntimePolicyClaims,
+    evaluateScenarioOutcome,
+    evaluateScenarioThresholds,
+    fileContains,
+    hasLinuxDesktopSession,
+    hasTruthyEnv,
+    inferLegacyHttpResponseSourceValue,
+    isContainerHost,
+    isLinuxLocalHost,
+    isLocalHost,
+    isRuntimeReportingSink,
+    mapCorrelationStore,
+    mapEnvironmentClassification,
+    mapEndpointSpec,
+    normalizeEndpointPayloadValue,
+    normalizeLicensingApiBaseUrl,
+    resolveLicensingApiBaseUrl,
+    normalizeNodeType,
+    normalizePayload,
+    normalizeStringArray,
+    normalizeTimeoutMs,
+    parseBodyAsObject,
+    parseJwt,
+    readEpochClaim,
+    readLinuxMachineId,
+    readMacPlatformUuid,
+    readOptionalTrackingSelectorValue,
+    readRedisCorrelationStoreOptions,
+    readTrackingId,
+    readWindowsMachineGuid,
+    resolveRuntimePolicy,
+    resolveTimeoutSeconds,
+    sanitizeLooseJson,
+    sanitizeRequest,
+    setJsonPathValue,
+    setDevelopmentLicensingApiBaseUrlOverride,
+    sleep,
+    stringOrDefault,
+    toBoolean,
+    toContractNodeType,
+    toStringMap,
+    tryParseJson,
+    validateRedisCorrelationStoreConfiguration,
+    validateTrackingConfiguration,
+    verifyJwtSignature
+};

package/dist/cjs/reporting.js

@@ -1,17 +1,14 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.__loadstrikeTestExports = void 0;
 exports.buildDotnetTxtReport = buildDotnetTxtReport;
 exports.buildDotnetCsvReport = buildDotnetCsvReport;
 exports.buildDotnetMarkdownReport = buildDotnetMarkdownReport;
 exports.buildDotnetHtmlReport = buildDotnetHtmlReport;
 const node_fs_1 = require("node:fs");
-const node_os_1 = __importDefault(require("node:os"));
 const node_path_1 = require("node:path");
 const node_url_1 = require("node:url");
-const REPORT_EOL = node_os_1.default.EOL;
+const REPORT_EOL = "\n";
 const REPORT_FALLBACK_SVG = "<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 128 128'><defs><linearGradient id='g' x1='0' y1='0' x2='1' y2='1'><stop offset='0' stop-color='#64b5ff'/><stop offset='1' stop-color='#2f66db'/></linearGradient></defs><rect width='128' height='128' rx='24' fill='#081325'/><path d='M24 94L56 24l16 34 14-22 18 58h-16l-7-23-9 13-10-21-14 31H24z' fill='url(#g)'/></svg>";
 const REPORT_LOGO_CACHE = new Map();
 function resolveReportModuleDir() {
@@ -1265,3 +1262,20 @@ if(btns.length>0){show(btns[0].dataset.tab);}renderAllCharts();initPanePan();win
         .split("__CHART_DATA__").join(chartDataJson)
         .concat(REPORT_EOL);
 }
+exports.__loadstrikeTestExports = {
+    buildDotnetFailedResponseContent,
+    buildDotnetFailedResponseHtml,
+    buildDotnetGroupedCorrelationSummaryHtml,
+    buildDotnetHtmlTabs,
+    buildDotnetMetricHtml,
+    buildDotnetPluginHints,
+    buildDotnetScenarioHtml,
+    buildDotnetScenarioMeasurementHtml,
+    buildDotnetStatusCodeHtml,
+    buildDotnetStepHtml,
+    buildDotnetStepMeasurementHtml,
+    buildDotnetThresholdHtml,
+    buildDotnetUngroupedCorrelationSummaryHtml,
+    buildUngroupedCorrelationChartPayload,
+    classifyStatusCodeBucket
+};