@loadstrike/loadstrike-sdk 1.0.23001 → 1.0.23401

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.OtelCollectorReportingSinkOptions = exports.OtelCollectorReportingSink = exports.InfluxDbReportingSinkOptions = void 0;
+exports.TimescaleDbReportingSinkOptions = exports.TimescaleDbReportingSink = exports.SplunkReportingSinkOptions = exports.SplunkReportingSink = exports.PortalReportingSink = exports.OtelCollectorReportingSinkOptions = exports.OtelCollectorReportingSink = exports.InfluxDbReportingSinkOptions = 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; } });
@@ -61,6 +61,7 @@ Object.defineProperty(exports, "InfluxDbReportingSink", { enumerable: true, get:
 Object.defineProperty(exports, "InfluxDbReportingSinkOptions", { enumerable: true, get: function () { return sinks_js_1.InfluxDbReportingSinkOptions; } });
 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, "PortalReportingSink", { enumerable: true, get: function () { return sinks_js_1.PortalReportingSink; } });
 Object.defineProperty(exports, "SplunkReportingSink", { enumerable: true, get: function () { return sinks_js_1.SplunkReportingSink; } });
 Object.defineProperty(exports, "SplunkReportingSinkOptions", { enumerable: true, get: function () { return sinks_js_1.SplunkReportingSinkOptions; } });
 Object.defineProperty(exports, "TimescaleDbReportingSink", { enumerable: true, get: function () { return sinks_js_1.TimescaleDbReportingSink; } });

package/dist/cjs/local.js

@@ -55,7 +55,8 @@ const SINK_FEATURE_BY_KIND = {
     grafanaloki: "extensions.reporting_sinks.grafana_loki",
     datadog: "extensions.reporting_sinks.datadog",
     splunk: "extensions.reporting_sinks.splunk",
-    otelcollector: "extensions.reporting_sinks.otel_collector"
+    otelcollector: "extensions.reporting_sinks.otel_collector",
+    portal: "extensions.reporting_sinks.portal"
 };
 const TRACKING_FEATURE_BY_KIND = {
     http: "endpoint.http",
@@ -96,6 +97,9 @@ class LoadStrikeLocalClient {
         this.licensingApiBaseUrl = resolveLicensingApiBaseUrl();
         this.licenseValidationTimeoutMs = normalizeTimeoutMs(options.licenseValidationTimeoutMs);
     }
+    portalReportingIngestUrl() {
+        return `${this.licensingApiBaseUrl.replace(/\/+$/, "")}/api/v1/reporting/ingest`;
+    }
     async run(request) {
         const sanitized = sanitizeRequest(request);
         const licenseSession = await this.acquireLicenseLease(sanitized);

package/dist/cjs/runtime.js

@@ -13,6 +13,7 @@ const cluster_js_1 = require("./cluster.js");
 const correlation_js_1 = require("./correlation.js");
 const transports_js_1 = require("./transports.js");
 const reporting_js_1 = require("./reporting.js");
+const sinks_js_1 = require("./sinks.js");
 exports.LoadStrikeNodeType = {
     SingleNode: "SingleNode",
     Coordinator: "Coordinator",
@@ -1395,6 +1396,16 @@ class LoadStrikeContext {
         validateNamedReportingSinks(sinks);
         return this.mergeValues({ ReportingSinks: sinks });
     }
+    withPortalReporting() {
+        return this.WithPortalReporting();
+    }
+    WithPortalReporting() {
+        const sinks = [...(this.values.ReportingSinks ?? [])];
+        if (!sinks.some((sink, index) => resolveSinkName(sink, index).trim().toLowerCase() === "portal")) {
+            sinks.push(new sinks_js_1.PortalReportingSink());
+        }
+        return this.mergeValues({ ReportingSinks: sinks });
+    }
     /**
      * Registers runtime policies for the run.
      * Use this when scenario selection or step execution should obey policy callbacks.
@@ -2137,6 +2148,9 @@ class LoadStrikeRunner {
     static WithReportingSinks(context, ...sinks) {
         return context.WithReportingSinks(...sinks);
     }
+    static WithPortalReporting(context) {
+        return context.WithPortalReporting();
+    }
     /**
      * Registers runtime policies for the run.
      * Use this when scenario selection or step execution should obey policy callbacks.
@@ -2365,6 +2379,29 @@ class LoadStrikeRunner {
     WithReportingInterval(intervalSeconds) {
         return this.withReportingInterval(intervalSeconds);
     }
+    withReportingSinks(...sinks) {
+        if (!sinks.length) {
+            throw new Error("At least one reporting sink should be provided.");
+        }
+        if (sinks.some((sink) => sink == null)) {
+            throw new Error("Reporting sink collection cannot contain null values.");
+        }
+        validateNamedReportingSinks(sinks);
+        return this.configure({ reportingSinks: sinks });
+    }
+    WithReportingSinks(...sinks) {
+        return this.withReportingSinks(...sinks);
+    }
+    withPortalReporting() {
+        const sinks = [...(this.options.reportingSinks ?? [])];
+        if (!sinks.some((sink, index) => resolveSinkName(sink, index).trim().toLowerCase() === "portal")) {
+            sinks.push(new sinks_js_1.PortalReportingSink());
+        }
+        return this.configure({ reportingSinks: sinks });
+    }
+    WithPortalReporting() {
+        return this.withPortalReporting();
+    }
     /**
      * Sets the timeout for cluster command round-trips.
      * Use this when distributed control messages need a tighter or looser deadline.
@@ -2538,6 +2575,7 @@ class LoadStrikeRunner {
             testInfo,
             getNodeInfo: () => attachNodeInfoAliases({ ...nodeInfo })
         };
+        attachPortalReportingSession(sinkSession, sessionInfo, licenseClient, licenseSession);
         attachSessionStartInfoAliases(sessionInfo);
         nodeInfo.currentOperation = "Init";
         for (const plugin of plugins) {
@@ -4072,10 +4110,35 @@ function attachSessionStartInfoAliases(session) {
     attachAliasMap(session, {
         StartedUtc: "startedUtc",
         ScenarioNames: "scenarioNames",
-        Scenarios: "scenarios"
+        Scenarios: "scenarios",
+        RunToken: "runToken",
+        PortalReportingIngestUrl: "portalReportingIngestUrl",
+        PortalReportingRunId: "portalReportingRunId"
     });
     return session;
 }
+function attachPortalReportingSession(sinkSession, sessionInfo, licenseClient, licenseSession) {
+    const runToken = stringValueOrDefault(licenseSession?.runToken, "").trim();
+    if (!runToken || !licenseClient) {
+        return;
+    }
+    const ingestUrl = licenseClient.portalReportingIngestUrl();
+    const runId = buildPortalReportingRunId(sessionInfo.testInfo.sessionId);
+    sinkSession.runToken = runToken;
+    sinkSession.portalReportingIngestUrl = ingestUrl;
+    sinkSession.portalReportingRunId = runId;
+    sessionInfo.runToken = runToken;
+    sessionInfo.portalReportingIngestUrl = ingestUrl;
+    sessionInfo.portalReportingRunId = runId;
+}
+function buildPortalReportingRunId(sessionId) {
+    const sessionPart = String(sessionId ?? "")
+        .replace(/[^A-Za-z0-9._-]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 80);
+    const uniquePart = generateRuntimeSessionId().slice(0, 16);
+    return sessionPart ? `${sessionPart}-${uniquePart}` : uniquePart;
+}
 function attachScenarioInitContextAliases(context) {
     context.nodeInfo = attachNodeInfoAliases(context.nodeInfo);
     context.testInfo = attachTestInfoAliases(context.testInfo);

package/dist/cjs/sinks.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.__loadstrikeTestExports = exports.OtelCollectorReportingSink = exports.SplunkReportingSink = exports.DatadogReportingSink = exports.TimescaleDbReportingSink = exports.GrafanaLokiReportingSink = exports.InfluxDbReportingSink = exports.CompositeReportingSink = exports.ConsoleReportingSink = exports.MemoryReportingSink = exports.OtelCollectorReportingSinkOptions = exports.SplunkReportingSinkOptions = exports.DatadogReportingSinkOptions = exports.TimescaleDbReportingSinkOptions = exports.GrafanaLokiReportingSinkOptions = exports.InfluxDbReportingSinkOptions = void 0;
+exports.__loadstrikeTestExports = exports.OtelCollectorReportingSink = exports.SplunkReportingSink = exports.DatadogReportingSink = exports.TimescaleDbReportingSink = exports.GrafanaLokiReportingSink = exports.InfluxDbReportingSink = exports.PortalReportingSink = exports.CompositeReportingSink = exports.ConsoleReportingSink = exports.MemoryReportingSink = exports.OtelCollectorReportingSinkOptions = exports.SplunkReportingSinkOptions = exports.DatadogReportingSinkOptions = exports.TimescaleDbReportingSinkOptions = exports.GrafanaLokiReportingSinkOptions = exports.InfluxDbReportingSinkOptions = void 0;
 const runtime_js_1 = require("./runtime.js");
+const node_crypto_1 = require("node:crypto");
 const pg_1 = require("pg");
 const DEFAULT_INFLUX_CONFIGURATION_SECTION_PATH = "LoadStrike:ReportingSinks:InfluxDb";
 const DEFAULT_GRAFANA_LOKI_CONFIGURATION_SECTION_PATH = "LoadStrike:ReportingSinks:GrafanaLoki";
@@ -384,6 +385,92 @@ class CompositeReportingSink {
     }
 }
 exports.CompositeReportingSink = CompositeReportingSink;
+class PortalReportingSink {
+    constructor(options = {}) {
+        this.sinkName = "portal";
+        this.SinkName = "portal";
+        this.licenseFeature = "extensions.reporting_sinks.portal";
+        this.LicenseFeature = "extensions.reporting_sinks.portal";
+        this.baseContext = null;
+        this.session = null;
+        this.runToken = "";
+        this.ingestUrl = "";
+        const source = asRecord(options);
+        this.timeoutMs = resolveTimeoutMs(optionNumber(source, "timeoutSeconds", "TimeoutSeconds"), optionNumber(source, "timeoutMs", "TimeoutMs"));
+        this.fetchImpl = pickRecordValue(source, "fetchImpl", "FetchImpl") ?? fetch;
+    }
+    init(context, _infraConfig) {
+        this.baseContext = cloneBaseContext(context);
+    }
+    Init(context, infraConfig) {
+        this.init(context, infraConfig);
+    }
+    start(session) {
+        this.runToken = String(session.runToken ?? session.RunToken ?? "").trim();
+        this.ingestUrl = String(session.portalReportingIngestUrl ?? session.PortalReportingIngestUrl ?? "").trim();
+        if (!this.runToken || !this.ingestUrl) {
+            throw new Error("PortalReportingSink requires a managed portal reporting session.");
+        }
+        this.session = sinkSessionMetadataFromContext(this.getBaseContext(), session);
+    }
+    Start(session) {
+        this.start(session);
+    }
+    async saveRealtimeStats(scenarioStats) {
+        await this.persistEvents(createRealtimeStatsEvents(this.getSession(), scenarioStats));
+    }
+    async SaveRealtimeStats(scenarioStats) {
+        await this.saveRealtimeStats(scenarioStats);
+    }
+    async saveRealtimeMetrics(metrics) {
+        await this.persistEvents(createRealtimeMetricEvents(this.getSession(), metrics));
+    }
+    async SaveRealtimeMetrics(metrics) {
+        await this.saveRealtimeMetrics(metrics);
+    }
+    async saveRunResult(result) {
+        await this.persistEvents(createRunResultEvents(this.getSession(), result));
+    }
+    async SaveRunResult(result) {
+        await this.saveRunResult(result);
+    }
+    stop() {
+        this.session = null;
+    }
+    Stop() {
+        this.stop();
+    }
+    Dispose() {
+        this.baseContext = null;
+        this.stop();
+    }
+    getBaseContext() {
+        if (!this.baseContext) {
+            throw new Error(`${this.sinkName} has not been initialized.`);
+        }
+        return this.baseContext;
+    }
+    getSession() {
+        if (!this.session) {
+            throw new Error(`${this.sinkName} has not been started.`);
+        }
+        return this.session;
+    }
+    async persistEvents(events) {
+        if (!events.length) {
+            return;
+        }
+        await postWithTimeout(this.fetchImpl, this.ingestUrl, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                runToken: this.runToken,
+                events: events.map((event, index) => portalEventPayload(event, index))
+            })
+        }, this.timeoutMs, "PortalReportingSink");
+    }
+}
+exports.PortalReportingSink = PortalReportingSink;
 class InfluxDbReportingSink {
     constructor(options = {}) {
         this.sinkName = "influxdb";
@@ -1532,6 +1619,7 @@ function createReportingEvent(session, occurredUtc, eventType, scenarioName, ste
         eventFields.completed_utc = occurredUtc.toISOString();
     }
     return {
+        runId: session.runId,
         eventType,
         occurredUtc,
         sessionId: session.sessionId,
@@ -1546,6 +1634,38 @@ function createReportingEvent(session, occurredUtc, eventType, scenarioName, ste
         fields: eventFields
     };
 }
+function portalEventPayload(event, index) {
+    return {
+        eventId: portalEventId(event, index),
+        runId: event.runId,
+        eventType: event.eventType,
+        occurredUtc: event.occurredUtc.toISOString(),
+        sessionId: event.sessionId,
+        testSuite: event.testSuite,
+        testName: event.testName,
+        clusterId: event.clusterId,
+        nodeType: event.nodeType,
+        machineName: event.machineName,
+        scenarioName: event.scenarioName,
+        stepName: event.stepName,
+        tags: { ...event.tags },
+        fields: deepCloneRecord(event.fields)
+    };
+}
+function portalEventId(event, index) {
+    const material = JSON.stringify({
+        sessionId: event.sessionId,
+        runId: event.runId,
+        eventType: event.eventType,
+        occurredUtc: event.occurredUtc.toISOString(),
+        scenarioName: event.scenarioName ?? "",
+        stepName: event.stepName ?? "",
+        index,
+        tags: event.tags,
+        fields: event.fields
+    });
+    return `lsr_${(0, node_crypto_1.createHash)("sha256").update(material).digest("hex").slice(0, 40)}`;
+}
 function addMeasurementFields(fields, prefix, measurement) {
     const request = measurement?.request ?? { count: 0, percent: 0, rps: 0 };
     const latency = measurement?.latency ?? {
@@ -2093,7 +2213,9 @@ function sinkSessionMetadataFromContext(context, session) {
     const testInfo = context.testInfo;
     const sessionStartedUtc = String(session?.startedUtc ?? session?.StartedUtc ?? "");
     const contextStartedUtc = String(testInfo.createdUtc ?? testInfo.CreatedUtc ?? "");
+    const runId = String(session?.portalReportingRunId ?? session?.PortalReportingRunId ?? testInfo.sessionId ?? "").trim();
     return {
+        runId: runId || String(testInfo.sessionId ?? ""),
         sessionId: String(testInfo.sessionId ?? ""),
         testSuite: String(testInfo.testSuite ?? ""),
         testName: String(testInfo.testName ?? ""),
@@ -2571,7 +2693,10 @@ function cloneSessionStartInfo(session) {
         ...cloneBaseContext(session),
         startedUtc: session.startedUtc,
         scenarioNames: [...session.scenarioNames],
-        scenarios: session.scenarios.map((value) => ({ ...value }))
+        scenarios: session.scenarios.map((value) => ({ ...value })),
+        runToken: session.runToken,
+        portalReportingIngestUrl: session.portalReportingIngestUrl,
+        portalReportingRunId: session.portalReportingRunId
     };
 }
 function cloneNodeInfo(nodeInfo) {
@@ -2673,23 +2798,7 @@ function runResultToNodeStats(result) {
         disabledSinks: [...(result.disabledSinks ?? [])],
         sinkErrors: (result.sinkErrors ?? []).map((value) => ({ ...value })),
         reportFiles: [...(result.reportFiles ?? [])],
-        logFiles: [...(result.logFiles ?? [])],
-        findScenarioStats: (scenarioName) => result.scenarioStats.find((value) => value.scenarioName === scenarioName),
-        getScenarioStats: (scenarioName) => {
-            const scenario = result.scenarioStats.find((value) => value.scenarioName === scenarioName);
-            if (!scenario) {
-                throw new Error(`Scenario stats not found: ${scenarioName}`);
-            }
-            return scenario;
-        },
-        FindScenarioStats: (scenarioName) => result.scenarioStats.find((value) => value.scenarioName === scenarioName),
-        GetScenarioStats: (scenarioName) => {
-            const scenario = result.scenarioStats.find((value) => value.scenarioName === scenarioName);
-            if (!scenario) {
-                throw new Error(`Scenario stats not found: ${scenarioName}`);
-            }
-            return scenario;
-        }
+        logFiles: [...(result.logFiles ?? [])]
     };
 }
 function deepCloneRecord(value) {

package/dist/esm/index.js

@@ -3,4 +3,4 @@ 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 { 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, SplunkReportingSink, SplunkReportingSinkOptions, TimescaleDbReportingSink, TimescaleDbReportingSinkOptions } from "./sinks.js";
+export { DatadogReportingSink, DatadogReportingSinkOptions, GrafanaLokiReportingSink, GrafanaLokiReportingSinkOptions, InfluxDbReportingSink, InfluxDbReportingSinkOptions, OtelCollectorReportingSink, OtelCollectorReportingSinkOptions, PortalReportingSink, SplunkReportingSink, SplunkReportingSinkOptions, TimescaleDbReportingSink, TimescaleDbReportingSinkOptions } from "./sinks.js";

package/dist/esm/local.js

@@ -16,7 +16,8 @@ const SINK_FEATURE_BY_KIND = {
     grafanaloki: "extensions.reporting_sinks.grafana_loki",
     datadog: "extensions.reporting_sinks.datadog",
     splunk: "extensions.reporting_sinks.splunk",
-    otelcollector: "extensions.reporting_sinks.otel_collector"
+    otelcollector: "extensions.reporting_sinks.otel_collector",
+    portal: "extensions.reporting_sinks.portal"
 };
 const TRACKING_FEATURE_BY_KIND = {
     http: "endpoint.http",
@@ -57,6 +58,9 @@ export class LoadStrikeLocalClient {
         this.licensingApiBaseUrl = resolveLicensingApiBaseUrl();
         this.licenseValidationTimeoutMs = normalizeTimeoutMs(options.licenseValidationTimeoutMs);
     }
+    portalReportingIngestUrl() {
+        return `${this.licensingApiBaseUrl.replace(/\/+$/, "")}/api/v1/reporting/ingest`;
+    }
     async run(request) {
         const sanitized = sanitizeRequest(request);
         const licenseSession = await this.acquireLicenseLease(sanitized);

package/dist/esm/runtime.js

@@ -7,6 +7,7 @@ import { DistributedClusterAgent, DistributedClusterCoordinator } from "./cluste
 import { CorrelationStoreConfiguration, CrossPlatformTrackingRuntime, RedisCorrelationStore, RedisCorrelationStoreOptions, TrackingFieldSelector } from "./correlation.js";
 import { EndpointAdapterFactory, LOADSTRIKE_TRACE_ID_TRACKING_FIELD } from "./transports.js";
 import { buildDotnetCsvReport, buildDotnetHtmlReport, buildDotnetMarkdownReport, buildDotnetTxtReport } from "./reporting.js";
+import { PortalReportingSink } from "./sinks.js";
 export const LoadStrikeNodeType = {
     SingleNode: "SingleNode",
     Coordinator: "Coordinator",
@@ -1378,6 +1379,16 @@ export class LoadStrikeContext {
         validateNamedReportingSinks(sinks);
         return this.mergeValues({ ReportingSinks: sinks });
     }
+    withPortalReporting() {
+        return this.WithPortalReporting();
+    }
+    WithPortalReporting() {
+        const sinks = [...(this.values.ReportingSinks ?? [])];
+        if (!sinks.some((sink, index) => resolveSinkName(sink, index).trim().toLowerCase() === "portal")) {
+            sinks.push(new PortalReportingSink());
+        }
+        return this.mergeValues({ ReportingSinks: sinks });
+    }
     /**
      * Registers runtime policies for the run.
      * Use this when scenario selection or step execution should obey policy callbacks.
@@ -2118,6 +2129,9 @@ export class LoadStrikeRunner {
     static WithReportingSinks(context, ...sinks) {
         return context.WithReportingSinks(...sinks);
     }
+    static WithPortalReporting(context) {
+        return context.WithPortalReporting();
+    }
     /**
      * Registers runtime policies for the run.
      * Use this when scenario selection or step execution should obey policy callbacks.
@@ -2346,6 +2360,29 @@ export class LoadStrikeRunner {
     WithReportingInterval(intervalSeconds) {
         return this.withReportingInterval(intervalSeconds);
     }
+    withReportingSinks(...sinks) {
+        if (!sinks.length) {
+            throw new Error("At least one reporting sink should be provided.");
+        }
+        if (sinks.some((sink) => sink == null)) {
+            throw new Error("Reporting sink collection cannot contain null values.");
+        }
+        validateNamedReportingSinks(sinks);
+        return this.configure({ reportingSinks: sinks });
+    }
+    WithReportingSinks(...sinks) {
+        return this.withReportingSinks(...sinks);
+    }
+    withPortalReporting() {
+        const sinks = [...(this.options.reportingSinks ?? [])];
+        if (!sinks.some((sink, index) => resolveSinkName(sink, index).trim().toLowerCase() === "portal")) {
+            sinks.push(new PortalReportingSink());
+        }
+        return this.configure({ reportingSinks: sinks });
+    }
+    WithPortalReporting() {
+        return this.withPortalReporting();
+    }
     /**
      * Sets the timeout for cluster command round-trips.
      * Use this when distributed control messages need a tighter or looser deadline.
@@ -2519,6 +2556,7 @@ export class LoadStrikeRunner {
             testInfo,
             getNodeInfo: () => attachNodeInfoAliases({ ...nodeInfo })
         };
+        attachPortalReportingSession(sinkSession, sessionInfo, licenseClient, licenseSession);
         attachSessionStartInfoAliases(sessionInfo);
         nodeInfo.currentOperation = "Init";
         for (const plugin of plugins) {
@@ -4052,10 +4090,35 @@ function attachSessionStartInfoAliases(session) {
     attachAliasMap(session, {
         StartedUtc: "startedUtc",
         ScenarioNames: "scenarioNames",
-        Scenarios: "scenarios"
+        Scenarios: "scenarios",
+        RunToken: "runToken",
+        PortalReportingIngestUrl: "portalReportingIngestUrl",
+        PortalReportingRunId: "portalReportingRunId"
     });
     return session;
 }
+function attachPortalReportingSession(sinkSession, sessionInfo, licenseClient, licenseSession) {
+    const runToken = stringValueOrDefault(licenseSession?.runToken, "").trim();
+    if (!runToken || !licenseClient) {
+        return;
+    }
+    const ingestUrl = licenseClient.portalReportingIngestUrl();
+    const runId = buildPortalReportingRunId(sessionInfo.testInfo.sessionId);
+    sinkSession.runToken = runToken;
+    sinkSession.portalReportingIngestUrl = ingestUrl;
+    sinkSession.portalReportingRunId = runId;
+    sessionInfo.runToken = runToken;
+    sessionInfo.portalReportingIngestUrl = ingestUrl;
+    sessionInfo.portalReportingRunId = runId;
+}
+function buildPortalReportingRunId(sessionId) {
+    const sessionPart = String(sessionId ?? "")
+        .replace(/[^A-Za-z0-9._-]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 80);
+    const uniquePart = generateRuntimeSessionId().slice(0, 16);
+    return sessionPart ? `${sessionPart}-${uniquePart}` : uniquePart;
+}
 function attachScenarioInitContextAliases(context) {
     context.nodeInfo = attachNodeInfoAliases(context.nodeInfo);
     context.testInfo = attachTestInfoAliases(context.testInfo);

package/dist/esm/sinks.js

@@ -1,4 +1,5 @@
 import { LoadStrikePluginData as LoadStrikePluginDataModel, LoadStrikePluginDataTable as LoadStrikePluginDataTableModel } from "./runtime.js";
+import { createHash } from "node:crypto";
 import { Pool } from "pg";
 const DEFAULT_INFLUX_CONFIGURATION_SECTION_PATH = "LoadStrike:ReportingSinks:InfluxDb";
 const DEFAULT_GRAFANA_LOKI_CONFIGURATION_SECTION_PATH = "LoadStrike:ReportingSinks:GrafanaLoki";
@@ -372,6 +373,91 @@ export class CompositeReportingSink {
         await this.stop();
     }
 }
+export class PortalReportingSink {
+    constructor(options = {}) {
+        this.sinkName = "portal";
+        this.SinkName = "portal";
+        this.licenseFeature = "extensions.reporting_sinks.portal";
+        this.LicenseFeature = "extensions.reporting_sinks.portal";
+        this.baseContext = null;
+        this.session = null;
+        this.runToken = "";
+        this.ingestUrl = "";
+        const source = asRecord(options);
+        this.timeoutMs = resolveTimeoutMs(optionNumber(source, "timeoutSeconds", "TimeoutSeconds"), optionNumber(source, "timeoutMs", "TimeoutMs"));
+        this.fetchImpl = pickRecordValue(source, "fetchImpl", "FetchImpl") ?? fetch;
+    }
+    init(context, _infraConfig) {
+        this.baseContext = cloneBaseContext(context);
+    }
+    Init(context, infraConfig) {
+        this.init(context, infraConfig);
+    }
+    start(session) {
+        this.runToken = String(session.runToken ?? session.RunToken ?? "").trim();
+        this.ingestUrl = String(session.portalReportingIngestUrl ?? session.PortalReportingIngestUrl ?? "").trim();
+        if (!this.runToken || !this.ingestUrl) {
+            throw new Error("PortalReportingSink requires a managed portal reporting session.");
+        }
+        this.session = sinkSessionMetadataFromContext(this.getBaseContext(), session);
+    }
+    Start(session) {
+        this.start(session);
+    }
+    async saveRealtimeStats(scenarioStats) {
+        await this.persistEvents(createRealtimeStatsEvents(this.getSession(), scenarioStats));
+    }
+    async SaveRealtimeStats(scenarioStats) {
+        await this.saveRealtimeStats(scenarioStats);
+    }
+    async saveRealtimeMetrics(metrics) {
+        await this.persistEvents(createRealtimeMetricEvents(this.getSession(), metrics));
+    }
+    async SaveRealtimeMetrics(metrics) {
+        await this.saveRealtimeMetrics(metrics);
+    }
+    async saveRunResult(result) {
+        await this.persistEvents(createRunResultEvents(this.getSession(), result));
+    }
+    async SaveRunResult(result) {
+        await this.saveRunResult(result);
+    }
+    stop() {
+        this.session = null;
+    }
+    Stop() {
+        this.stop();
+    }
+    Dispose() {
+        this.baseContext = null;
+        this.stop();
+    }
+    getBaseContext() {
+        if (!this.baseContext) {
+            throw new Error(`${this.sinkName} has not been initialized.`);
+        }
+        return this.baseContext;
+    }
+    getSession() {
+        if (!this.session) {
+            throw new Error(`${this.sinkName} has not been started.`);
+        }
+        return this.session;
+    }
+    async persistEvents(events) {
+        if (!events.length) {
+            return;
+        }
+        await postWithTimeout(this.fetchImpl, this.ingestUrl, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                runToken: this.runToken,
+                events: events.map((event, index) => portalEventPayload(event, index))
+            })
+        }, this.timeoutMs, "PortalReportingSink");
+    }
+}
 export class InfluxDbReportingSink {
     constructor(options = {}) {
         this.sinkName = "influxdb";
@@ -1514,6 +1600,7 @@ function createReportingEvent(session, occurredUtc, eventType, scenarioName, ste
         eventFields.completed_utc = occurredUtc.toISOString();
     }
     return {
+        runId: session.runId,
         eventType,
         occurredUtc,
         sessionId: session.sessionId,
@@ -1528,6 +1615,38 @@ function createReportingEvent(session, occurredUtc, eventType, scenarioName, ste
         fields: eventFields
     };
 }
+function portalEventPayload(event, index) {
+    return {
+        eventId: portalEventId(event, index),
+        runId: event.runId,
+        eventType: event.eventType,
+        occurredUtc: event.occurredUtc.toISOString(),
+        sessionId: event.sessionId,
+        testSuite: event.testSuite,
+        testName: event.testName,
+        clusterId: event.clusterId,
+        nodeType: event.nodeType,
+        machineName: event.machineName,
+        scenarioName: event.scenarioName,
+        stepName: event.stepName,
+        tags: { ...event.tags },
+        fields: deepCloneRecord(event.fields)
+    };
+}
+function portalEventId(event, index) {
+    const material = JSON.stringify({
+        sessionId: event.sessionId,
+        runId: event.runId,
+        eventType: event.eventType,
+        occurredUtc: event.occurredUtc.toISOString(),
+        scenarioName: event.scenarioName ?? "",
+        stepName: event.stepName ?? "",
+        index,
+        tags: event.tags,
+        fields: event.fields
+    });
+    return `lsr_${createHash("sha256").update(material).digest("hex").slice(0, 40)}`;
+}
 function addMeasurementFields(fields, prefix, measurement) {
     const request = measurement?.request ?? { count: 0, percent: 0, rps: 0 };
     const latency = measurement?.latency ?? {
@@ -2075,7 +2194,9 @@ function sinkSessionMetadataFromContext(context, session) {
     const testInfo = context.testInfo;
     const sessionStartedUtc = String(session?.startedUtc ?? session?.StartedUtc ?? "");
     const contextStartedUtc = String(testInfo.createdUtc ?? testInfo.CreatedUtc ?? "");
+    const runId = String(session?.portalReportingRunId ?? session?.PortalReportingRunId ?? testInfo.sessionId ?? "").trim();
     return {
+        runId: runId || String(testInfo.sessionId ?? ""),
         sessionId: String(testInfo.sessionId ?? ""),
         testSuite: String(testInfo.testSuite ?? ""),
         testName: String(testInfo.testName ?? ""),
@@ -2553,7 +2674,10 @@ function cloneSessionStartInfo(session) {
         ...cloneBaseContext(session),
         startedUtc: session.startedUtc,
         scenarioNames: [...session.scenarioNames],
-        scenarios: session.scenarios.map((value) => ({ ...value }))
+        scenarios: session.scenarios.map((value) => ({ ...value })),
+        runToken: session.runToken,
+        portalReportingIngestUrl: session.portalReportingIngestUrl,
+        portalReportingRunId: session.portalReportingRunId
     };
 }
 function cloneNodeInfo(nodeInfo) {
@@ -2655,23 +2779,7 @@ function runResultToNodeStats(result) {
         disabledSinks: [...(result.disabledSinks ?? [])],
         sinkErrors: (result.sinkErrors ?? []).map((value) => ({ ...value })),
         reportFiles: [...(result.reportFiles ?? [])],
-        logFiles: [...(result.logFiles ?? [])],
-        findScenarioStats: (scenarioName) => result.scenarioStats.find((value) => value.scenarioName === scenarioName),
-        getScenarioStats: (scenarioName) => {
-            const scenario = result.scenarioStats.find((value) => value.scenarioName === scenarioName);
-            if (!scenario) {
-                throw new Error(`Scenario stats not found: ${scenarioName}`);
-            }
-            return scenario;
-        },
-        FindScenarioStats: (scenarioName) => result.scenarioStats.find((value) => value.scenarioName === scenarioName),
-        GetScenarioStats: (scenarioName) => {
-            const scenario = result.scenarioStats.find((value) => value.scenarioName === scenarioName);
-            if (!scenario) {
-                throw new Error(`Scenario stats not found: ${scenarioName}`);
-            }
-            return scenario;
-        }
+        logFiles: [...(result.logFiles ?? [])]
     };
 }
 function deepCloneRecord(value) {

package/dist/types/index.d.ts

@@ -8,5 +8,5 @@ export { CorrelationStoreConfiguration, CrossPlatformTrackingRuntime, InMemoryCo
 export type { CorrelationEntry, DestinationConsumeResult, GatheredRow, CorrelationStoreKind, CorrelationRuntimeOptions, CorrelationRuntimePlugin, CorrelationRuntimeStats, CorrelationStore, SourceProduceResult, TrackingFieldLocation, TrackingPayload } 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 type { EndpointAdapter, EndpointDefinition, EndpointDefinitionInput, EndpointKind, EndpointMode, DotNetDelegateEndpointOptions, DotNetEndpointDefinition, DotNetHttpAuthOptions, DotNetHttpEndpointOptions, DotNetHttpOAuth2ClientCredentialsOptions, HttpAuthMode, HttpAuthType, HttpRequestBodyType, HttpResponseSource, HttpTrackingPayloadSource, KafkaSaslMechanismType, KafkaSecurityProtocolType, HttpEndpointOptions, KafkaEndpointOptions, RabbitMqEndpointOptions, NatsEndpointOptions, RedisStreamsEndpointOptions, AzureEventHubsEndpointOptions, SqsEndpointOptions, PushDiffusionEndpointOptions, TrackingFieldSelectorInput, TrackingRunMode, TrafficEndpointKind, TrafficEndpointMode, ProducedMessageRequest, ProducedMessageResult, ConsumedMessage, DelegateConsumeAsync, DelegateConsumeStreamHandler, DelegateEndpointOptions } from "./transports.js";
-export { DatadogReportingSink, DatadogReportingSinkOptions, GrafanaLokiReportingSink, GrafanaLokiReportingSinkOptions, InfluxDbReportingSink, InfluxDbReportingSinkOptions, OtelCollectorReportingSink, OtelCollectorReportingSinkOptions, SplunkReportingSink, SplunkReportingSinkOptions, TimescaleDbReportingSink, TimescaleDbReportingSinkOptions } from "./sinks.js";
-export type { DatadogSinkOptions, GrafanaLokiSinkOptions, InfluxDbSinkOptions, OtelCollectorSinkOptions, SplunkSinkOptions, TimescaleDbSinkOptions } from "./sinks.js";
+export { DatadogReportingSink, DatadogReportingSinkOptions, GrafanaLokiReportingSink, GrafanaLokiReportingSinkOptions, InfluxDbReportingSink, InfluxDbReportingSinkOptions, OtelCollectorReportingSink, OtelCollectorReportingSinkOptions, PortalReportingSink, SplunkReportingSink, SplunkReportingSinkOptions, TimescaleDbReportingSink, TimescaleDbReportingSinkOptions } from "./sinks.js";
+export type { DatadogSinkOptions, GrafanaLokiSinkOptions, InfluxDbSinkOptions, OtelCollectorSinkOptions, PortalReportingSinkOptionsInput, SplunkSinkOptions, TimescaleDbSinkOptions } from "./sinks.js";

package/dist/types/local.d.ts

@@ -29,6 +29,7 @@ export declare class LoadStrikeLocalClient {
      * Use this when the surrounding wrapper type makes this operation the clearest way to express your intent.
      */
     constructor(options?: LoadStrikeLocalClientOptions);
+    portalReportingIngestUrl(): string;
     run(request: LoadStrikeRunRequest): Promise<LoadStrikeRunResponse>;
     acquireLicenseLease(request: LoadStrikeRunRequest): Promise<LicenseValidationSession>;
     releaseLicenseLease(session: LicenseValidationSession, request: LoadStrikeRunRequest): Promise<void>;

package/dist/types/runtime.d.ts

@@ -558,6 +558,9 @@ export interface LoadStrikeSinkSession {
     configPath?: string;
     infraConfigPath?: string;
     infraConfig?: Record<string, unknown>;
+    runToken?: string;
+    portalReportingIngestUrl?: string;
+    portalReportingRunId?: string;
 }
 export interface LoadStrikeBaseContext {
     logger: LoadStrikeLogger;
@@ -573,9 +576,15 @@ export interface LoadStrikeSessionStartInfo extends LoadStrikeBaseContext {
     startedUtc: string;
     scenarioNames: string[];
     scenarios: LoadStrikeScenarioStartInfo[];
+    runToken?: string;
+    portalReportingIngestUrl?: string;
+    portalReportingRunId?: string;
     readonly StartedUtc?: string;
     readonly ScenarioNames?: string[];
     readonly Scenarios?: LoadStrikeScenarioStartInfo[];
+    readonly RunToken?: string;
+    readonly PortalReportingIngestUrl?: string;
+    readonly PortalReportingRunId?: string;
 }
 type RequireAtLeastOne<T, Keys extends keyof T = keyof T> = Omit<T, Keys> & {
     [Key in Keys]-?: Required<Pick<T, Key>> & Partial<Pick<T, Exclude<Keys, Key>>>;
@@ -1339,6 +1348,8 @@ export declare class LoadStrikeContext {
      * Use this when run results must be pushed to external observability or storage systems.
      */
     WithReportingSinks(...sinks: ILoadStrikeReportingSink[]): LoadStrikeContext;
+    withPortalReporting(): LoadStrikeContext;
+    WithPortalReporting(): LoadStrikeContext;
     /**
      * Registers runtime policies for the run.
      * Use this when scenario selection or step execution should obey policy callbacks.
@@ -1790,6 +1801,7 @@ export declare class LoadStrikeRunner {
      * Use this when run results must be pushed to external observability or storage systems.
      */
     static WithReportingSinks(context: LoadStrikeContext, ...sinks: ILoadStrikeReportingSink[]): LoadStrikeContext;
+    static WithPortalReporting(context: LoadStrikeContext): LoadStrikeContext;
     /**
      * Registers runtime policies for the run.
      * Use this when scenario selection or step execution should obey policy callbacks.
@@ -1924,6 +1936,10 @@ export declare class LoadStrikeRunner {
      * Use this when sinks or dashboards should receive updates at a controlled interval.
      */
     WithReportingInterval(intervalSeconds: number): LoadStrikeRunner;
+    withReportingSinks(...sinks: ILoadStrikeReportingSink[]): LoadStrikeRunner;
+    WithReportingSinks(...sinks: ILoadStrikeReportingSink[]): LoadStrikeRunner;
+    withPortalReporting(): LoadStrikeRunner;
+    WithPortalReporting(): LoadStrikeRunner;
     /**
      * Sets the timeout for cluster command round-trips.
      * Use this when distributed control messages need a tighter or looser deadline.

package/dist/types/sinks.d.ts

@@ -21,13 +21,10 @@ interface LoadStrikeNodeStats {
     sinkErrors: LoadStrikeSinkError[];
     reportFiles: string[];
     logFiles: string[];
-    findScenarioStats: (scenarioName: string) => LoadStrikeScenarioStats | undefined;
-    getScenarioStats: (scenarioName: string) => LoadStrikeScenarioStats;
-    FindScenarioStats: (scenarioName: string) => LoadStrikeScenarioStats | undefined;
-    GetScenarioStats: (scenarioName: string) => LoadStrikeScenarioStats;
 }
 type SinkFetch = (input: string, init?: RequestInit) => Promise<Response>;
 interface ReportingSinkEvent {
+    runId: string;
     eventType: string;
     occurredUtc: Date;
     sessionId: string;
@@ -42,6 +39,7 @@ interface ReportingSinkEvent {
     fields: Record<string, unknown>;
 }
 interface SinkSessionMetadata {
+    runId: string;
     sessionId: string;
     testSuite: string;
     testName: string;
@@ -282,6 +280,14 @@ export interface OtelCollectorSinkOptionsInput {
     FetchImpl?: SinkFetch;
     fetchImpl?: SinkFetch;
 }
+export interface PortalReportingSinkOptionsInput {
+    TimeoutSeconds?: number;
+    timeoutSeconds?: number;
+    TimeoutMs?: number;
+    timeoutMs?: number;
+    FetchImpl?: SinkFetch;
+    fetchImpl?: SinkFetch;
+}
 export declare class InfluxDbReportingSinkOptions {
     ConfigurationSectionPath: string;
     BaseUrl: string;
@@ -439,6 +445,35 @@ export declare class CompositeReportingSink implements LoadStrikeReportingSink {
     stop(): Promise<void>;
     Stop(): Promise<void>;
 }
+export declare class PortalReportingSink implements LoadStrikeReportingSink {
+    readonly sinkName = "portal";
+    readonly SinkName = "portal";
+    readonly licenseFeature = "extensions.reporting_sinks.portal";
+    readonly LicenseFeature = "extensions.reporting_sinks.portal";
+    private readonly fetchImpl;
+    private readonly timeoutMs;
+    private baseContext;
+    private session;
+    private runToken;
+    private ingestUrl;
+    constructor(options?: PortalReportingSinkOptionsInput);
+    init(context: LoadStrikeBaseContext, _infraConfig: Record<string, unknown>): void;
+    Init(context: LoadStrikeBaseContext, infraConfig: Record<string, unknown>): void;
+    start(session: LoadStrikeSessionStartInfo): void;
+    Start(session: LoadStrikeSessionStartInfo): void;
+    saveRealtimeStats(scenarioStats: LoadStrikeScenarioStats[]): Promise<void>;
+    SaveRealtimeStats(scenarioStats: LoadStrikeScenarioStats[]): Promise<void>;
+    saveRealtimeMetrics(metrics: LoadStrikeMetricStats): Promise<void>;
+    SaveRealtimeMetrics(metrics: LoadStrikeMetricStats): Promise<void>;
+    saveRunResult(result: LoadStrikeRunResult): Promise<void>;
+    SaveRunResult(result: LoadStrikeRunResult): Promise<void>;
+    stop(): void;
+    Stop(): void;
+    Dispose(): void;
+    private getBaseContext;
+    private getSession;
+    private persistEvents;
+}
 export declare class InfluxDbReportingSink implements LoadStrikeReportingSink {
     readonly sinkName = "influxdb";
     readonly SinkName = "influxdb";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loadstrike/loadstrike-sdk",
-  "version": "1.0.23001",
+  "version": "1.0.23401",
   "description": "TypeScript and JavaScript SDK for in-process load execution, traffic correlation, and reporting.",
   "keywords": [
     "load-testing",