@loadstrike/loadstrike-sdk 1.0.30201 → 1.0.31001

package/dist/types/sinks.d.ts

@@ -1,4 +1,5 @@
 import type { ILoadStrikeReportingSink, LoadStrikeBaseContext, LoadStrikeMetricStats, LoadStrikeMetricValue, LoadStrikeNodeInfo, LoadStrikePluginData, LoadStrikeReportingSink, LoadStrikeRunResult, LoadStrikeScenarioStats, LoadStrikeSessionStartInfo, LoadStrikeSinkError, LoadStrikeStepStats, LoadStrikeTestInfo, LoadStrikeThresholdResult } from "./runtime.js";
+import { type LoadStrikeIterationObservationBatchV1, type LoadStrikeIterationObservationStreamCompletionV1 } from "./iteration-observations.js";
 interface LoadStrikeNodeStats {
     startedUtc: string;
     completedUtc: string;
@@ -442,10 +443,15 @@ export declare class CompositeReportingSink implements LoadStrikeReportingSink {
     SaveRealtimeMetrics(metrics: LoadStrikeMetricStats): Promise<void>;
     saveRunResult(result: LoadStrikeRunResult): Promise<void>;
     SaveRunResult(result: LoadStrikeRunResult): Promise<void>;
+    saveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    SaveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    completeIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
+    CompleteIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
     stop(): Promise<void>;
     Stop(): Promise<void>;
 }
 export declare class PortalReportingSink implements LoadStrikeReportingSink {
+    readonly iterationObservationPortalSink = true;
     readonly sinkName = "portal";
     readonly SinkName = "portal";
     readonly licenseFeature = "extensions.reporting_sinks.portal";
@@ -456,6 +462,7 @@ export declare class PortalReportingSink implements LoadStrikeReportingSink {
     private baseContext;
     private session;
     private runToken;
+    private runTokenProvider;
     private ingestUrl;
     constructor(options?: PortalReportingSinkOptionsInput);
     cloneForRun(): PortalReportingSink;
@@ -469,12 +476,18 @@ export declare class PortalReportingSink implements LoadStrikeReportingSink {
     SaveRealtimeMetrics(metrics: LoadStrikeMetricStats): Promise<void>;
     saveRunResult(result: LoadStrikeRunResult): Promise<void>;
     SaveRunResult(result: LoadStrikeRunResult): Promise<void>;
+    saveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    SaveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    completeIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
+    CompleteIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
     stop(): void;
     Stop(): void;
     Dispose(): void;
     private getBaseContext;
     private getSession;
     private persistEvents;
+    private persistObservationPayload;
+    private currentRunToken;
 }
 export declare function cloneReportingSinkForRun(sink: LoadStrikeReportingSink): LoadStrikeReportingSink;
 export declare class InfluxDbReportingSink implements LoadStrikeReportingSink {
@@ -497,6 +510,10 @@ export declare class InfluxDbReportingSink implements LoadStrikeReportingSink {
     SaveRealtimeMetrics(metrics: LoadStrikeMetricStats): Promise<void>;
     saveRunResult(result: LoadStrikeRunResult): Promise<void>;
     SaveRunResult(result: LoadStrikeRunResult): Promise<void>;
+    saveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    SaveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    completeIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
+    CompleteIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
     stop(): void;
     Stop(): void;
     Dispose(): void;
@@ -524,6 +541,10 @@ export declare class GrafanaLokiReportingSink implements LoadStrikeReportingSink
     SaveRealtimeMetrics(metrics: LoadStrikeMetricStats): Promise<void>;
     saveRunResult(result: LoadStrikeRunResult): Promise<void>;
     SaveRunResult(result: LoadStrikeRunResult): Promise<void>;
+    saveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    SaveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    completeIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
+    CompleteIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
     stop(): void;
     Stop(): void;
     Dispose(): void;
@@ -552,6 +573,10 @@ export declare class TimescaleDbReportingSink implements LoadStrikeReportingSink
     SaveRealtimeMetrics(metrics: LoadStrikeMetricStats): Promise<void>;
     saveRunResult(result: LoadStrikeRunResult): Promise<void>;
     SaveRunResult(result: LoadStrikeRunResult): Promise<void>;
+    saveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    SaveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    completeIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
+    CompleteIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
     stop(): Promise<void>;
     Stop(): Promise<void>;
     Dispose(): Promise<void>;
@@ -581,6 +606,10 @@ export declare class DatadogReportingSink implements LoadStrikeReportingSink {
     SaveRealtimeMetrics(metrics: LoadStrikeMetricStats): Promise<void>;
     saveRunResult(result: LoadStrikeRunResult): Promise<void>;
     SaveRunResult(result: LoadStrikeRunResult): Promise<void>;
+    saveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    SaveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    completeIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
+    CompleteIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
     stop(): void;
     Stop(): void;
     Dispose(): void;
@@ -608,6 +637,10 @@ export declare class SplunkReportingSink implements LoadStrikeReportingSink {
     SaveRealtimeMetrics(metrics: LoadStrikeMetricStats): Promise<void>;
     saveRunResult(result: LoadStrikeRunResult): Promise<void>;
     SaveRunResult(result: LoadStrikeRunResult): Promise<void>;
+    saveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    SaveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    completeIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
+    CompleteIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
     stop(): void;
     Stop(): void;
     Dispose(): void;
@@ -635,6 +668,10 @@ export declare class OtelCollectorReportingSink implements LoadStrikeReportingSi
     SaveRealtimeMetrics(metrics: LoadStrikeMetricStats): Promise<void>;
     saveRunResult(result: LoadStrikeRunResult): Promise<void>;
     SaveRunResult(result: LoadStrikeRunResult): Promise<void>;
+    saveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    SaveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    completeIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
+    CompleteIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
     stop(): void;
     Stop(): void;
     Dispose(): void;
@@ -665,6 +702,7 @@ declare abstract class ExpandedEventReportingSink implements LoadStrikeReporting
     readonly licenseFeature: string;
     protected baseContext: LoadStrikeBaseContext | null;
     protected session: SinkSessionMetadata | null;
+    protected preservesRawIterationObservations: boolean;
     protected constructor(sinkName: string, licenseFeature: string);
     init(context: LoadStrikeBaseContext, _infraConfig: Record<string, unknown>): void;
     Init(context: LoadStrikeBaseContext, infraConfig: Record<string, unknown>): void;
@@ -676,6 +714,10 @@ declare abstract class ExpandedEventReportingSink implements LoadStrikeReporting
     SaveRealtimeMetrics(metrics: LoadStrikeMetricStats): Promise<void>;
     saveRunResult(result: LoadStrikeRunResult): Promise<void>;
     SaveRunResult(result: LoadStrikeRunResult): Promise<void>;
+    saveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    SaveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    completeIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
+    CompleteIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
     stop(): void;
     Stop(): void;
     Dispose(): void;
@@ -694,14 +736,20 @@ declare class ExpandedHttpJsonReportingSink extends ExpandedEventReportingSink {
     constructor(sinkName: string, licenseFeature: string, defaultEndpointPath: string, options?: ExpandedSinkOptionsInput);
     init(context: LoadStrikeBaseContext, infraConfig: Record<string, unknown>): void;
     protected persistEvents(events: ReportingSinkEvent[]): Promise<void>;
+    saveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    completeIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
+    protected persistCanonicalGzipPayload(payload: unknown): Promise<void>;
 }
 export declare class PrometheusRemoteWriteReportingSink extends ExpandedHttpJsonReportingSink {
+    readonly iterationObservationShapeLimited = true;
     constructor(options?: ExpandedSinkOptionsInput);
 }
 export declare class CloudWatchReportingSink extends ExpandedHttpJsonReportingSink {
+    readonly iterationObservationShapeLimited = true;
     constructor(options?: ExpandedSinkOptionsInput);
 }
 export declare class DynatraceReportingSink extends ExpandedHttpJsonReportingSink {
+    readonly iterationObservationShapeLimited = true;
     constructor(options?: ExpandedSinkOptionsInput);
 }
 export declare class ElasticsearchReportingSink extends ExpandedHttpJsonReportingSink {
@@ -711,10 +759,16 @@ export declare class OpenSearchReportingSink extends ExpandedHttpJsonReportingSi
     constructor(options?: ExpandedSinkOptionsInput);
 }
 export declare class NewRelicReportingSink extends ExpandedHttpJsonReportingSink {
+    readonly iterationObservationShapeLimited = true;
     constructor(options?: ExpandedSinkOptionsInput);
 }
 export declare class GenericWebhookReportingSink extends ExpandedHttpJsonReportingSink {
+    protected preservesRawIterationObservations: boolean;
     constructor(options?: ExpandedSinkOptionsInput);
+    saveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    SaveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    completeIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
+    CompleteIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
 }
 export interface KafkaReportingSinkOptionsInput {
     Topic?: string;
@@ -731,7 +785,10 @@ export declare class KafkaReportingSink extends ExpandedEventReportingSink {
     private readonly staticTags;
     private readonly publishAsync?;
     constructor(options?: KafkaReportingSinkOptionsInput);
+    saveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    completeIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
     protected persistEvents(events: ReportingSinkEvent[]): Promise<void>;
+    private publishCanonicalValue;
 }
 export interface StatsDReportingSinkOptionsInput {
     Prefix?: string;
@@ -746,6 +803,7 @@ export interface StatsDReportingSinkOptionsInput {
     sendLineAsync?: (line: string) => Promise<void> | void;
 }
 declare class StatsDReportingSinkBase extends ExpandedEventReportingSink {
+    readonly iterationObservationShapeLimited = true;
     private readonly prefix;
     private readonly host;
     private readonly port;
@@ -753,6 +811,8 @@ declare class StatsDReportingSinkBase extends ExpandedEventReportingSink {
     private readonly sendLineAsync?;
     private readonly dogStatsD;
     constructor(sinkName: string, licenseFeature: string, options?: StatsDReportingSinkOptionsInput, dogStatsD?: boolean);
+    saveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    completeIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
     protected persistEvents(events: ReportingSinkEvent[]): Promise<void>;
     private formatPoint;
     private sendLine;
@@ -773,15 +833,25 @@ export interface JsonlFileReportingSinkOptionsInput {
     staticTags?: Record<string, string>;
 }
 export declare class JsonlFileReportingSink extends ExpandedEventReportingSink {
+    protected preservesRawIterationObservations: boolean;
     private readonly filePath;
     private readonly staticTags;
+    private writeTail;
     constructor(options?: JsonlFileReportingSinkOptionsInput);
     protected persistEvents(events: ReportingSinkEvent[]): Promise<void>;
+    saveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    SaveIterationBatch(batch: LoadStrikeIterationObservationBatchV1): Promise<void>;
+    completeIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
+    CompleteIterationObservationStream(completion: LoadStrikeIterationObservationStreamCompletionV1): Promise<void>;
+    private persistCanonicalPayload;
 }
 declare function createRealtimeStatsEvents(session: SinkSessionMetadata, scenarios: LoadStrikeScenarioStats[]): ReportingSinkEvent[];
 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;
@@ -830,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;
@@ -846,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;
@@ -1087,11 +1089,8 @@ declare function parseBodyObject(body: unknown): Record<string, unknown> | null;
 declare function resolveConnectionMetadata(endpoint: EndpointDefinition): Record<string, string>;
 declare function canonicalizeHttpResponseSource(value: string): HttpResponseSource;
 declare function inferLegacyHttpResponseSource(value: string | undefined): HttpResponseSource | undefined;
-declare function buildKafkaClientOptions(endpoint: EndpointDefinition): any;
-declare function shouldUseConfluentKafkaClient(endpoint: EndpointDefinition): boolean;
+declare let kafkaClientFactoryForTests: ((endpoint: EndpointDefinition) => any | Promise<any>) | null;
 declare function buildConfluentKafkaClientOptions(endpoint: EndpointDefinition): Record<string, unknown>;
-declare function resolveKafkaOAuthBearerToken(options: Record<string, unknown>): Promise<string>;
-declare function mapKafkaSaslMechanism(mechanism: string): string;
 declare function mapConfluentKafkaSecurityProtocol(protocol: string): string;
 declare function mapConfluentKafkaSaslMechanism(mechanism: string): string;
 declare function toKafkaHeadersWithContentType(headers: Record<string, string>, contentType?: string): Record<string, Buffer>;
@@ -1140,14 +1139,15 @@ export declare const __loadstrikeTestExports: {
     applyHttpAuthHeaders: typeof applyHttpAuthHeaders;
     buildHttpRequestBody: typeof buildHttpRequestBody;
     buildConfluentKafkaClientOptions: typeof buildConfluentKafkaClientOptions;
-    buildKafkaClientOptions: typeof buildKafkaClientOptions;
     canonicalizeHttpResponseSource: typeof canonicalizeHttpResponseSource;
     createDelegateRequestEndpointView: typeof createDelegateRequestEndpointView;
     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;
@@ -1156,7 +1156,6 @@ export declare const __loadstrikeTestExports: {
     injectTrackingValue: typeof injectTrackingValue;
     mapConfluentKafkaSaslMechanism: typeof mapConfluentKafkaSaslMechanism;
     mapConfluentKafkaSecurityProtocol: typeof mapConfluentKafkaSecurityProtocol;
-    mapKafkaSaslMechanism: typeof mapKafkaSaslMechanism;
     parseBodyObject: typeof parseBodyObject;
     partitionFromKey: typeof partitionFromKey;
     payloadBodyAsUtf8: typeof payloadBodyAsUtf8;
@@ -1164,15 +1163,14 @@ export declare const __loadstrikeTestExports: {
     protocolBus: unknown;
     readFirstRedisStreamEntry: typeof readFirstRedisStreamEntry;
     resolveConnectionMetadata: typeof resolveConnectionMetadata;
-    resolveKafkaOAuthBearerToken: typeof resolveKafkaOAuthBearerToken;
     serializePayloadBody: typeof serializePayloadBody;
     setJsonBodyValue: typeof setJsonBodyValue;
-    shouldUseConfluentKafkaClient: typeof shouldUseConfluentKafkaClient;
     toHeaderRecord: typeof toHeaderRecord;
     toKafkaHeadersWithContentType: typeof toKafkaHeadersWithContentType;
     toSqsMessageAttributes: typeof toSqsMessageAttributes;
     fromSqsMessageAttributes: typeof fromSqsMessageAttributes;
     setSqsClientFactoryForTests: (factory: typeof sqsClientFactoryForTests) => void;
+    setKafkaClientFactoryForTests: (factory: typeof kafkaClientFactoryForTests) => void;
     validateHttpEndpoint: typeof validateHttpEndpoint;
     validateTrackingSelectorPath: typeof validateTrackingSelectorPath;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loadstrike/loadstrike-sdk",
-  "version": "1.0.30201",
+  "version": "1.0.31001",
   "description": "TypeScript and JavaScript SDK for in-process load execution, traffic correlation, and reporting.",
   "keywords": [
     "load-testing",
@@ -66,7 +66,6 @@
     "@confluentinc/kafka-javascript": "^1.8.2",
     "@types/pg": "^8.18.0",
     "amqplib": "^0.10.9",
-    "kafkajs": "^2.2.4",
     "nats": "^2.29.3",
     "pg": "^8.20.0",
     "redis": "^4.7.1"
@@ -82,7 +81,7 @@
     "typescript": "^5.9.2"
   },
   "overrides": {
-    "brace-expansion": "5.0.6",
-    "tar": "7.5.16"
+    "brace-expansion": "5.0.8",
+    "tar": "7.5.21"
   }
 }