@loadstrike/loadstrike-sdk 1.0.30401 → 1.0.31601

package/dist/types/runtime.d.ts

@@ -1,6 +1,7 @@
 import { type ClusterNodeResult, type LoadEngineV2PlanInput } from "./cluster.js";
 import { RedisCorrelationStore, RedisCorrelationStoreOptions, TrackingFieldSelector, type TrackingPayload } from "./correlation.js";
 import { type EndpointAdapter, type EndpointDefinition } from "./transports.js";
+import { type ReportHistoryMeasurement, type ReportHistoryScenario } from "./report-history.js";
 import { LoadEngineV2ExecutionBudget, type LoadEngineV2DistributionRecord, type LoadStrikeHistogramV1Sidecar } from "./load-engine-v2.js";
 import { type LoadStrikeIterationObservationBatchV1, type LoadStrikeIterationObservationStreamCompletionV1, type LoadStrikeIterationStepObservationV1, type LoadStrikeObservationDeliveryStats } from "./iteration-observations.js";
 declare const LOAD_ENGINE_V2_SCHEDULER_DISTRIBUTIONS: unique symbol;
@@ -570,6 +571,17 @@ declare class MeasurementAccumulator {
      */
     build(allRequestCount: number, durationMs: number): LoadStrikeMeasurementStats;
     buildCombined(other: MeasurementAccumulator, allRequestCount: number, durationMs: number): LoadStrikeMeasurementStats;
+    /**
+     * Projects only the cumulative fields used by the private HTML-report
+     * history. Legacy distributions deliberately omit latency so this cadence
+     * path never scans their retained per-request arrays.
+     */
+    buildReportHistoryMeasurement(): ReportHistoryMeasurement;
+    /**
+     * Combines only bounded native latency state plus exact counters. It does
+     * not materialize status rows or any public measurement DTO.
+     */
+    buildCombinedReportHistoryMeasurement(other: MeasurementAccumulator): ReportHistoryMeasurement;
     private histogramSnapshot;
 }
 declare class StepStatsAccumulator {
@@ -627,6 +639,11 @@ declare class ScenarioStatsAccumulator {
      * Use this when the surrounding wrapper type makes this operation the clearest way to express your intent.
      */
     recordStep(stepName: string, reply: LoadStrikeStepReply, observedLatencyMs: number, sortIndex?: number): number;
+    /**
+     * Captures the bounded, private history view without building scenario
+     * steps, status rows, plugins, aliases, or any other public result shape.
+     */
+    buildReportHistorySnapshot(): ReportHistoryScenario;
     /**
      * Builds the configured payload or helper object.
      * Use this when all builder inputs are ready to be materialized.
@@ -2384,6 +2401,8 @@ export declare class LoadStrikeRunner {
     private collectPluginData;
 }
 declare function hasPluginRows(value: LoadStrikePluginData): boolean;
+declare function boundedReportingIntervalMs(seconds: number): number;
+declare function resolvedReportHistoryCadenceSeconds(seconds: number): number;
 declare function combineAbortSignals(...signals: AbortSignal[]): AbortSignal;
 declare function delayWithAbort(durationMs: number, signal: AbortSignal): Promise<void>;
 declare function createRuntimeRandom(): LoadStrikeRandom;
@@ -2434,6 +2453,7 @@ declare function normalizeThresholdScope(value: string): "scenario" | "step" | "
 declare function buildThresholdCheckExpression(scope: "scenario" | "step" | "metric", stepName: string, field: string): string;
 declare function detailedToNodeStats(result: LoadStrikeRunResult, metricStats?: LoadStrikeMetricStats): LoadStrikeNodeStats;
 declare function resolveClusterExecutionMode(options: LoadStrikeRunnerOptions): "single" | "local-coordinator" | "nats-coordinator" | "nats-agent";
+declare function isDistributedReportHistoryExecution(clusterMode: ReturnType<typeof resolveClusterExecutionMode>, options: Pick<LoadStrikeRunnerOptions, "clusterShardCount" | "loadEngineV2SegmentLifecycleOverride">): boolean;
 declare function buildEmptyNodeStats(args: {
     startedUtc: string;
     completedUtc: string;
@@ -2526,6 +2546,7 @@ declare function normalizeRuntimeTrackingPayload(payload: TrackingPayload | null
 declare function readRuntimeTrackingId(payload: TrackingPayload, selector: string): string | null;
 declare function runtimeParseBodyAsObject(body: unknown): Record<string, unknown> | null;
 declare function setRuntimeJsonPathValue(body: unknown, path: string, value: string): unknown;
+declare function pickTrackingValue(source: Record<string, unknown>, ...keys: string[]): unknown;
 declare function pickOptionalTrackingSelectorString(source: Record<string, unknown>, key: string, altKey: string): string | undefined;
 declare function pickTrackingNumber(source: Record<string, unknown>, keys: string[], fallback: number): number;
 declare function toTrackingStringMap(value: unknown): Record<string, string>;
@@ -2643,6 +2664,8 @@ export declare const __loadstrikeTestExports: {
     buildThresholdCheckExpression: typeof buildThresholdCheckExpression;
     buildTrackingLeaseKey: typeof buildTrackingLeaseKey;
     buildTrackingRunNamespace: typeof buildTrackingRunNamespace;
+    boundedReportingIntervalMs: typeof boundedReportingIntervalMs;
+    resolvedReportHistoryCadenceSeconds: typeof resolvedReportHistoryCadenceSeconds;
     clusterNodeResultToNodeStats: typeof clusterNodeResultToNodeStats;
     combineAbortSignals: typeof combineAbortSignals;
     computeScenarioRequestCount: typeof computeScenarioRequestCount;
@@ -2662,6 +2685,7 @@ export declare const __loadstrikeTestExports: {
     formatUtcReportTimestamp: typeof formatUtcReportTimestamp;
     hasPluginRows: typeof hasPluginRows;
     inferRuntimeLegacyHttpResponseSource: typeof inferRuntimeLegacyHttpResponseSource;
+    isDistributedReportHistoryExecution: typeof isDistributedReportHistoryExecution;
     isComparisonFailed: typeof isComparisonFailed;
     loadJsonObject: typeof loadJsonObject;
     logLevelOrder: typeof logLevelOrder;
@@ -2691,6 +2715,7 @@ export declare const __loadstrikeTestExports: {
     parseStrictBooleanToken: typeof parseStrictBooleanToken;
     percentile: typeof percentile;
     pickOptionalTrackingSelectorString: typeof pickOptionalTrackingSelectorString;
+    pickTrackingValue: typeof pickTrackingValue;
     pickTrackingNumber: typeof pickTrackingNumber;
     produceOrConsumeTrackingPayload: typeof produceOrConsumeTrackingPayload;
     readConfiguredSinkName: typeof readConfiguredSinkName;

package/dist/types/sink-retry-policy.d.ts

@@ -0,0 +1,9 @@
+export declare const DEFAULT_SINK_RETRY_COUNT = 3;
+export declare const DEFAULT_SINK_RETRY_BACKOFF_MS = 250;
+export declare const MAXIMUM_SINK_RETRY_COUNT = 100;
+export declare const MAXIMUM_TIMER_DELAY_MS = 2147483647;
+export declare function normalizeSinkRetryCount(value: number | undefined): number;
+export declare function normalizeSinkRetryBackoffMs(value: number | undefined): number;
+export declare function sinkRetryDelayMs(baseDelayMs: number, retryNumber: number): number;
+export declare function waitForSinkRetryDelay(delayMs: number): Promise<void>;
+export declare function cooperativeSinkRetryYield(): Promise<void>;

package/dist/types/sinks.d.ts

@@ -849,6 +849,9 @@ declare function createRealtimeStatsEvents(session: SinkSessionMetadata, scenari
 declare function createFinalStatsEvents(session: SinkSessionMetadata, stats: LoadStrikeNodeStats): ReportingSinkEvent[];
 declare function createRunResultEvents(session: SinkSessionMetadata, result: LoadStrikeRunResult): ReportingSinkEvent[];
 declare function createReportingEvent(session: SinkSessionMetadata, occurredUtc: Date, eventType: string, scenarioName: string | null, stepName: string | null, tags: Record<string, string>, fields: Record<string, unknown>): ReportingSinkEvent;
+declare function createIterationObservationEvents(session: SinkSessionMetadata, batch: LoadStrikeIterationObservationBatchV1): ReportingSinkEvent[];
+declare function createIterationCompletionEvents(session: SinkSessionMetadata, completion: LoadStrikeIterationObservationStreamCompletionV1): ReportingSinkEvent[];
+declare function portalEventPayload(event: ReportingSinkEvent, index: number): Record<string, unknown>;
 declare function toOtelAnyValue(value: unknown): Record<string, unknown>;
 declare function sinkSessionMetadataFromContext(context: LoadStrikeBaseContext, session?: LoadStrikeSessionStartInfo, options?: {
     distinctRunIdFallback?: boolean;
@@ -897,6 +900,8 @@ export declare const __loadstrikeTestExports: {
     cloneScenarioStats: typeof cloneScenarioStats;
     cloneSessionStartInfo: typeof cloneSessionStartInfo;
     createFinalStatsEvents: typeof createFinalStatsEvents;
+    createIterationCompletionEvents: typeof createIterationCompletionEvents;
+    createIterationObservationEvents: typeof createIterationObservationEvents;
     createRealtimeStatsEvents: typeof createRealtimeStatsEvents;
     createRunResultEvents: typeof createRunResultEvents;
     createReportingEvent: typeof createReportingEvent;
@@ -913,6 +918,7 @@ export declare const __loadstrikeTestExports: {
     normalizeStringMap: typeof normalizeStringMap;
     optionNumber: typeof optionNumber;
     optionString: typeof optionString;
+    portalEventPayload: typeof portalEventPayload;
     pickBooleanValue: typeof pickBooleanValue;
     pickRecordValue: typeof pickRecordValue;
     postWithTimeout: typeof postWithTimeout;

package/dist/types/transports.d.ts

@@ -1072,6 +1072,8 @@ declare function validateTrackingSelectorPath(expression: string, fieldName: "Tr
 declare function validateHttpEndpoint(endpoint: EndpointDefinition, mode: EndpointMode, hasModeDelegate: boolean): void;
 declare function applyHttpAuthHeaders(headers: Record<string, string>, options: HttpEndpointOptions, resolveOAuthToken: () => Promise<string>): Promise<void>;
 declare function buildHttpRequestBody(body: unknown, bodyType: NonNullable<HttpEndpointOptions["bodyType"]>, contentType: string): unknown;
+declare function extractJsonPath(value: unknown, arrayPath?: string): unknown;
+declare function headersToRecord(value: Headers): Record<string, string>;
 declare function partitionFromKey(value: string, partitionCount: number): string;
 declare function attachPayloadHelpers(payload: TrackingPayload): TrackingPayload;
 declare function attachDotNetTrackingPayloadAliases<T extends TrackingPayload>(payload: T): T;
@@ -1142,8 +1144,10 @@ export declare const __loadstrikeTestExports: {
     createNatsHeaders: typeof createNatsHeaders;
     createRedisStreamPayload: typeof createRedisStreamPayload;
     deserializeBrokerPayloadBody: typeof deserializeBrokerPayloadBody;
+    extractJsonPath: typeof extractJsonPath;
     extractTrackingValue: typeof extractTrackingValue;
     fromKafkaHeaders: typeof fromKafkaHeaders;
+    headersToRecord: typeof headersToRecord;
     headerValue: typeof headerValue;
     attachDotNetTrackingPayloadAliases: typeof attachDotNetTrackingPayloadAliases;
     attachPayloadHelpers: typeof attachPayloadHelpers;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loadstrike/loadstrike-sdk",
-  "version": "1.0.30401",
+  "version": "1.0.31601",
   "description": "TypeScript and JavaScript SDK for in-process load execution, traffic correlation, and reporting.",
   "keywords": [
     "load-testing",
@@ -81,7 +81,7 @@
     "typescript": "^5.9.2"
   },
   "overrides": {
-    "brace-expansion": "5.0.7",
+    "brace-expansion": "5.0.8",
     "tar": "7.5.21"
   }
 }