@loadstrike/loadstrike-sdk 1.0.10101 → 1.0.15201

package/dist/esm/correlation.js

@@ -551,11 +551,10 @@ export 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;
                 }
             }
@@ -595,6 +594,8 @@ function normalizeTrackingFieldLocation(location) {
 }
 export class CrossPlatformTrackingRuntime {
     constructor(options) {
+        this.trackingIdDisplayByEventId = new Map();
+        this.gatherByDisplayByComparisonKey = new Map();
         this.producedCount = 0;
         this.consumedCount = 0;
         this.matchedCount = 0;
@@ -608,6 +609,8 @@ export 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();
@@ -630,13 +633,17 @@ export 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);
         }
@@ -677,12 +684,13 @@ export 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;
@@ -690,10 +698,12 @@ export 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;
@@ -703,7 +713,7 @@ export 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;
@@ -751,7 +761,9 @@ export 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;
@@ -759,7 +771,7 @@ export 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);
                 }
             }
         }
@@ -783,11 +795,40 @@ export 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;
+    }
+}
+function normalizeComparisonValue(value, caseSensitive) {
+    return caseSensitive
+        ? value
+        : value.toUpperCase();
 }
 function normalizeJsonBody(body) {
     if (body instanceof Uint8Array) {
@@ -907,7 +948,9 @@ function uniqueStringList(values) {
     return [...new Set(values.filter((value) => value.trim().length > 0))];
 }
 function createRedisStoreClient(connectionString, database) {
-    const client = createClient({
+    const createClientOverride = globalThis
+        .__wave15CreateRedisClient;
+    const client = (typeof createClientOverride === "function" ? createClientOverride : createClient)({
         url: connectionString,
         database: database >= 0 ? database : undefined
     });
@@ -997,3 +1040,18 @@ function readJsonPathSegment(current, segment) {
     }
     return undefined;
 }
+export const __loadstrikeTestExports = {
+    CorrelationStoreConfiguration,
+    InMemoryCorrelationStore,
+    RedisCorrelationStore,
+    RedisCorrelationStoreOptions,
+    TrackingFieldSelector,
+    createRedisStoreClient,
+    hydrateCorrelationEntry,
+    normalizeCorrelationEntry,
+    parseStringList,
+    readJsonPathSegment,
+    sanitizeLooseJson,
+    tryParseObject,
+    uniqueStringList
+};

package/dist/esm/index.js

@@ -1,6 +1,4 @@
-export { DEFAULT_LICENSING_API_BASE_URL, LoadStrikeLocalClient } from "./local.js";
-export { CrossPlatformScenarioConfigurator, ScenarioTrackingExtensions, LoadStrikeContext, LoadStrikePluginData, LoadStrikePluginDataTable, LoadStrikeReportData, LoadStrikeNodeType, LoadStrikeReportFormat, LoadStrikeResponse, LoadStrikeLogLevel, LoadStrikeScenarioOperation, LoadStrikeOperationType, LoadStrikeRunner, LoadStrikeScenario, LoadStrikeSimulation, LoadStrikeMetric, LoadStrikeCounter, LoadStrikeGauge, LoadStrikeStep, LoadStrikeThreshold } from "./runtime.js";
+export { CrossPlatformScenarioConfigurator, ScenarioTrackingExtensions, LoadStrikeContext, LoadStrikePluginData, LoadStrikePluginDataTable, LoadStrikeNodeType, LoadStrikeReportFormat, LoadStrikeResponse, LoadStrikeLogLevel, LoadStrikeScenarioOperation, LoadStrikeOperationType, LoadStrikeRunner, LoadStrikeScenario, LoadStrikeSimulation, LoadStrikeMetric, LoadStrikeCounter, LoadStrikeGauge, LoadStrikeStep, LoadStrikeThreshold } from "./runtime.js";
 export { CorrelationStoreConfiguration, CrossPlatformTrackingRuntime, InMemoryCorrelationStore, RedisCorrelationStoreOptions, RedisCorrelationStore, TrackingPayloadBuilder, TrackingFieldSelector } from "./correlation.js";
 export { EndpointAdapterFactory, TrafficEndpointDefinition, HttpEndpointDefinition, KafkaEndpointDefinition, KafkaSaslOptions, RabbitMqEndpointDefinition, NatsEndpointDefinition, RedisStreamsEndpointDefinition, AzureEventHubsEndpointDefinition, DelegateStreamEndpointDefinition, PushDiffusionEndpointDefinition, HttpOAuth2ClientCredentialsOptions, HttpAuthOptions } from "./transports.js";
-export { DistributedClusterAgent, DistributedClusterCoordinator, LocalClusterCoordinator, planAgentScenarioAssignments } from "./cluster.js";
-export { CompositeReportingSink, ConsoleReportingSink, DatadogReportingSink, DatadogReportingSinkOptions, GrafanaLokiReportingSink, GrafanaLokiReportingSinkOptions, InfluxDbReportingSink, InfluxDbReportingSinkOptions, MemoryReportingSink, OtelCollectorReportingSink, OtelCollectorReportingSinkOptions, SplunkReportingSink, SplunkReportingSinkOptions, TimescaleDbReportingSink, TimescaleDbReportingSinkOptions } from "./sinks.js";
+export { DatadogReportingSink, DatadogReportingSinkOptions, GrafanaLokiReportingSink, GrafanaLokiReportingSinkOptions, InfluxDbReportingSink, InfluxDbReportingSinkOptions, OtelCollectorReportingSink, OtelCollectorReportingSinkOptions, SplunkReportingSink, SplunkReportingSinkOptions, TimescaleDbReportingSink, TimescaleDbReportingSinkOptions } from "./sinks.js";

package/dist/esm/local.js

@@ -4,7 +4,8 @@ import * as childProcess from "node:child_process";
 import { createHash, createVerify, randomUUID } from "node:crypto";
 import { CorrelationStoreConfiguration, CrossPlatformTrackingRuntime, RedisCorrelationStoreOptions, RedisCorrelationStore, TrackingFieldSelector } from "./correlation.js";
 import { EndpointAdapterFactory } from "./transports.js";
-export const 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"
@@ -48,7 +49,7 @@ export 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) {
@@ -138,9 +139,10 @@ export 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();
@@ -218,7 +220,9 @@ export 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;
@@ -226,17 +230,21 @@ export 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"), ""),
@@ -356,6 +364,12 @@ function normalizeLicensingApiBaseUrl(value) {
     const normalized = (value ?? "").trim();
     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) {
         return 10000;
@@ -411,14 +425,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");
         }
@@ -708,6 +716,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
@@ -1088,11 +1098,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;
             }
         }
@@ -1533,8 +1543,8 @@ function isRuntimeReportingSink(value) {
         "SaveRealtimeStats",
         "saveRealtimeMetrics",
         "SaveRealtimeMetrics",
-        "saveFinalStats",
-        "SaveFinalStats",
+        "saveRunResult",
+        "SaveRunResult",
         "stop",
         "Stop"
     ].some((name) => typeof record[name] === "function");
@@ -1560,6 +1570,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);
@@ -1842,3 +1866,64 @@ function resolveTimeoutSeconds(context, secondsKey, secondsAlias, millisecondsKe
 function asList(value) {
     return Array.isArray(value) ? value : [];
 }
+export const __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/esm/reporting.js

@@ -1,8 +1,7 @@
 import { existsSync, readFileSync } from "node:fs";
-import os from "node:os";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-const REPORT_EOL = os.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() {
@@ -1256,3 +1255,20 @@ if(btns.length>0){show(btns[0].dataset.tab);}renderAllCharts();initPanePan();win
         .split("__CHART_DATA__").join(chartDataJson)
         .concat(REPORT_EOL);
 }
+export const __loadstrikeTestExports = {
+    buildDotnetFailedResponseContent,
+    buildDotnetFailedResponseHtml,
+    buildDotnetGroupedCorrelationSummaryHtml,
+    buildDotnetHtmlTabs,
+    buildDotnetMetricHtml,
+    buildDotnetPluginHints,
+    buildDotnetScenarioHtml,
+    buildDotnetScenarioMeasurementHtml,
+    buildDotnetStatusCodeHtml,
+    buildDotnetStepHtml,
+    buildDotnetStepMeasurementHtml,
+    buildDotnetThresholdHtml,
+    buildDotnetUngroupedCorrelationSummaryHtml,
+    buildUngroupedCorrelationChartPayload,
+    classifyStatusCodeBucket
+};