@loadstrike/loadstrike-sdk 1.0.22801 → 1.0.23201

package/dist/types/runtime.d.ts

@@ -558,6 +558,8 @@ export interface LoadStrikeSinkSession {
     configPath?: string;
     infraConfigPath?: string;
     infraConfig?: Record<string, unknown>;
+    runToken?: string;
+    portalReportingIngestUrl?: string;
 }
 export interface LoadStrikeBaseContext {
     logger: LoadStrikeLogger;
@@ -573,9 +575,13 @@ export interface LoadStrikeSessionStartInfo extends LoadStrikeBaseContext {
     startedUtc: string;
     scenarioNames: string[];
     scenarios: LoadStrikeScenarioStartInfo[];
+    runToken?: string;
+    portalReportingIngestUrl?: string;
     readonly StartedUtc?: string;
     readonly ScenarioNames?: string[];
     readonly Scenarios?: LoadStrikeScenarioStartInfo[];
+    readonly RunToken?: string;
+    readonly PortalReportingIngestUrl?: 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 +1345,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 +1798,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 +1933,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,10 +21,6 @@ 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 {
@@ -282,6 +278,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 +443,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/dist/types/transports.d.ts

@@ -1,7 +1,7 @@
 import { TrackingFieldSelector, type TrackingPayload } from "./correlation.js";
 export declare const LOADSTRIKE_TRACE_ID_HEADER = "loadstrike-trace-id";
 export declare const LOADSTRIKE_TRACE_ID_TRACKING_FIELD = "header:loadstrike-trace-id";
-export type EndpointKind = "Http" | "Kafka" | "RabbitMq" | "Nats" | "RedisStreams" | "AzureEventHubs" | "PushDiffusion" | "DelegateStream";
+export type EndpointKind = "Http" | "Kafka" | "RabbitMq" | "Nats" | "RedisStreams" | "AzureEventHubs" | "Sqs" | "PushDiffusion" | "DelegateStream";
 export type EndpointMode = "Produce" | "Consume";
 export type HttpAuthMode = "None" | "Basic" | "Bearer" | "OAuth2ClientCredentials";
 export type HttpAuthType = HttpAuthMode;
@@ -228,6 +228,29 @@ export interface AzureEventHubsEndpointOptions {
     startFromEarliest?: boolean;
     [key: string]: unknown;
 }
+export interface SqsEndpointOptions {
+    QueueUrl?: string;
+    queueUrl?: string;
+    Region?: string;
+    region?: string;
+    ServiceUrl?: string;
+    serviceUrl?: string;
+    AccessKeyId?: string;
+    accessKeyId?: string;
+    SecretAccessKey?: string;
+    secretAccessKey?: string;
+    SessionToken?: string;
+    sessionToken?: string;
+    WaitTimeSeconds?: number;
+    waitTimeSeconds?: number;
+    MaxNumberOfMessages?: number;
+    maxNumberOfMessages?: number;
+    VisibilityTimeoutSeconds?: number;
+    visibilityTimeoutSeconds?: number;
+    DeleteAfterConsume?: boolean;
+    deleteAfterConsume?: boolean;
+    [key: string]: unknown;
+}
 export interface PushDiffusionEndpointOptions {
     ServerUrl?: string;
     serverUrl?: string;
@@ -322,6 +345,8 @@ export interface EndpointDefinition {
     redisStreams?: RedisStreamsEndpointOptions;
     AzureEventHubs?: AzureEventHubsEndpointOptions;
     azureEventHubs?: AzureEventHubsEndpointOptions;
+    Sqs?: SqsEndpointOptions;
+    sqs?: SqsEndpointOptions;
     PushDiffusion?: PushDiffusionEndpointOptions;
     pushDiffusion?: PushDiffusionEndpointOptions;
     Delegate?: DelegateEndpointOptions;
@@ -394,6 +419,7 @@ export interface DotNetEndpointDefinition {
     Nats?: NatsEndpointOptions;
     RedisStreams?: RedisStreamsEndpointOptions;
     AzureEventHubs?: AzureEventHubsEndpointOptions;
+    Sqs?: SqsEndpointOptions;
     PushDiffusion?: PushDiffusionEndpointOptions;
     Delegate?: DotNetDelegateEndpointOptions;
     DelegateStream?: DotNetDelegateEndpointOptions;
@@ -528,6 +554,30 @@ export interface AzureEventHubsEndpointDefinition extends TrafficEndpointDefinit
     StartFromEarliest?: boolean;
     startFromEarliest?: boolean;
 }
+export interface SqsEndpointDefinition extends TrafficEndpointDefinition {
+    Kind?: "Sqs";
+    kind?: "Sqs";
+    QueueUrl?: string;
+    queueUrl?: string;
+    Region?: string;
+    region?: string;
+    ServiceUrl?: string;
+    serviceUrl?: string;
+    AccessKeyId?: string;
+    accessKeyId?: string;
+    SecretAccessKey?: string;
+    secretAccessKey?: string;
+    SessionToken?: string;
+    sessionToken?: string;
+    WaitTimeSeconds?: number;
+    waitTimeSeconds?: number;
+    MaxNumberOfMessages?: number;
+    maxNumberOfMessages?: number;
+    VisibilityTimeoutSeconds?: number;
+    visibilityTimeoutSeconds?: number;
+    DeleteAfterConsume?: boolean;
+    deleteAfterConsume?: boolean;
+}
 export interface DelegateStreamEndpointDefinition extends TrafficEndpointDefinition {
     Kind?: "DelegateStream";
     kind?: "DelegateStream";
@@ -570,6 +620,7 @@ type RabbitMqEndpointDefinitionInit = Partial<RabbitMqEndpointDefinition>;
 type NatsEndpointDefinitionInit = Partial<NatsEndpointDefinition>;
 type RedisStreamsEndpointDefinitionInit = Partial<RedisStreamsEndpointDefinition>;
 type AzureEventHubsEndpointDefinitionInit = Partial<AzureEventHubsEndpointDefinition>;
+type SqsEndpointDefinitionInit = Partial<SqsEndpointDefinition>;
 type DelegateStreamEndpointDefinitionInit = Partial<DelegateStreamEndpointDefinition>;
 type PushDiffusionEndpointDefinitionInit = Partial<PushDiffusionEndpointDefinition>;
 declare abstract class TrafficEndpointDefinitionModel {
@@ -711,6 +762,21 @@ declare class AzureEventHubsEndpointDefinitionModel extends TrafficEndpointDefin
     constructor(initial?: AzureEventHubsEndpointDefinitionInit);
     Validate(): void;
 }
+declare class SqsEndpointDefinitionModel extends TrafficEndpointDefinitionModel {
+    readonly Kind: "Sqs";
+    QueueUrl: string;
+    Region: string;
+    ServiceUrl?: string;
+    AccessKeyId?: string;
+    SecretAccessKey?: string;
+    SessionToken?: string;
+    WaitTimeSeconds: number;
+    MaxNumberOfMessages: number;
+    VisibilityTimeoutSeconds?: number;
+    DeleteAfterConsume: boolean;
+    constructor(initial?: SqsEndpointDefinitionInit);
+    Validate(): void;
+}
 declare class DelegateStreamEndpointDefinitionModel extends TrafficEndpointDefinitionModel {
     readonly Kind: "DelegateStream";
     Produce?: (payload: TrackingPayload) => Promise<TrackingPayload | null> | TrackingPayload | null;
@@ -740,12 +806,13 @@ export declare const RabbitMqEndpointDefinition: typeof RabbitMqEndpointDefiniti
 export declare const NatsEndpointDefinition: typeof NatsEndpointDefinitionModel;
 export declare const RedisStreamsEndpointDefinition: typeof RedisStreamsEndpointDefinitionModel;
 export declare const AzureEventHubsEndpointDefinition: typeof AzureEventHubsEndpointDefinitionModel;
+export declare const SqsEndpointDefinition: typeof SqsEndpointDefinitionModel;
 export declare const DelegateStreamEndpointDefinition: typeof DelegateStreamEndpointDefinitionModel;
 export declare const PushDiffusionEndpointDefinition: typeof PushDiffusionEndpointDefinitionModel;
 export declare const HttpOAuth2ClientCredentialsOptions: typeof HttpOAuth2ClientCredentialsOptionsModel;
 export declare const HttpAuthOptions: typeof HttpAuthOptionsModel;
 export declare const KafkaSaslOptions: typeof KafkaSaslOptionsModel;
-export type EndpointDefinitionInput = EndpointDefinition | DotNetEndpointDefinition | HttpEndpointDefinition | KafkaEndpointDefinition | RabbitMqEndpointDefinition | NatsEndpointDefinition | RedisStreamsEndpointDefinition | AzureEventHubsEndpointDefinition | DelegateStreamEndpointDefinition | PushDiffusionEndpointDefinition;
+export type EndpointDefinitionInput = EndpointDefinition | DotNetEndpointDefinition | HttpEndpointDefinition | KafkaEndpointDefinition | RabbitMqEndpointDefinition | NatsEndpointDefinition | RedisStreamsEndpointDefinition | AzureEventHubsEndpointDefinition | SqsEndpointDefinition | DelegateStreamEndpointDefinition | PushDiffusionEndpointDefinition;
 export interface EndpointAdapter {
     initialize?(): Promise<void>;
     produce(payload?: TrackingPayload): Promise<TrackingPayload | null>;
@@ -794,6 +861,18 @@ declare class AzureEventHubsEndpointAdapter extends CallbackAdapter {
     private getConsumer;
     private ensureSubscriptionStarted;
 }
+type SqsClientLike = {
+    send(command: unknown): Promise<unknown>;
+    destroy?: () => void;
+};
+declare let sqsClientFactoryForTests: ((endpoint: EndpointDefinition) => SqsClientLike | Promise<SqsClientLike>) | null;
+declare class SqsEndpointAdapter extends CallbackAdapter {
+    private clientPromise;
+    produce(payload?: TrackingPayload): Promise<TrackingPayload | null>;
+    consume(): Promise<TrackingPayload | null>;
+    dispose(): Promise<void>;
+    private getClient;
+}
 export declare class EndpointAdapterFactory {
     static create(endpoint: EndpointDefinitionInput): EndpointAdapter;
 }
@@ -834,6 +913,16 @@ declare function readFirstRedisStreamEntry(value: unknown): {
     fields: Record<string, Uint8Array>;
 } | null;
 declare function createRedisStreamPayload(fields: Record<string, Uint8Array>, endpoint: EndpointDefinition): TrackingPayload;
+declare function toSqsMessageAttributes(headers: Record<string, string>, contentType?: string): Record<string, {
+    DataType: string;
+    StringValue: string;
+}>;
+declare function fromSqsMessageAttributes(attributes: Record<string, {
+    StringValue?: string;
+} | undefined> | undefined): {
+    headers: Record<string, string>;
+    contentType?: string;
+};
 declare function payloadBodyAsUtf8(body: unknown): string;
 export declare const __loadstrikeTestExports: {
     AzureEventHubsEndpointAdapter: typeof AzureEventHubsEndpointAdapter;
@@ -852,6 +941,9 @@ export declare const __loadstrikeTestExports: {
     RedisStreamsEndpointAdapter: typeof RedisStreamsEndpointAdapter;
     RedisStreamsEndpointDefinition: typeof RedisStreamsEndpointDefinitionModel;
     RedisStreamsEndpointDefinitionModel: typeof RedisStreamsEndpointDefinitionModel;
+    SqsEndpointAdapter: typeof SqsEndpointAdapter;
+    SqsEndpointDefinition: typeof SqsEndpointDefinitionModel;
+    SqsEndpointDefinitionModel: typeof SqsEndpointDefinitionModel;
     bufferToUint8Array: typeof bufferToUint8Array;
     applyHttpAuthHeaders: typeof applyHttpAuthHeaders;
     buildHttpRequestBody: typeof buildHttpRequestBody;
@@ -886,6 +978,9 @@ export declare const __loadstrikeTestExports: {
     shouldUseConfluentKafkaClient: typeof shouldUseConfluentKafkaClient;
     toHeaderRecord: typeof toHeaderRecord;
     toKafkaHeadersWithContentType: typeof toKafkaHeadersWithContentType;
+    toSqsMessageAttributes: typeof toSqsMessageAttributes;
+    fromSqsMessageAttributes: typeof fromSqsMessageAttributes;
+    setSqsClientFactoryForTests: (factory: typeof sqsClientFactoryForTests) => void;
     validateHttpEndpoint: typeof validateHttpEndpoint;
     validateTrackingSelectorPath: typeof validateTrackingSelectorPath;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loadstrike/loadstrike-sdk",
-  "version": "1.0.22801",
+  "version": "1.0.23201",
   "description": "TypeScript and JavaScript SDK for in-process load execution, traffic correlation, and reporting.",
   "keywords": [
     "load-testing",
@@ -37,12 +37,6 @@
       "import": "./dist/esm/correlation.js",
       "require": "./dist/cjs/correlation.js",
       "default": "./dist/esm/correlation.js"
-    },
-    "./transports": {
-      "types": "./dist/types/transports.d.ts",
-      "import": "./dist/esm/transports.js",
-      "require": "./dist/cjs/transports.js",
-      "default": "./dist/esm/transports.js"
     }
   },
   "files": [
@@ -67,6 +61,7 @@
     "test:broker": "node --test --test-concurrency=1 tests/broker-integration.test.mjs tests/broker-distributed.test.mjs"
   },
   "dependencies": {
+    "@aws-sdk/client-sqs": "^3.1045.0",
     "@azure/event-hubs": "^5.12.2",
     "@confluentinc/kafka-javascript": "^1.8.2",
     "@types/pg": "^8.18.0",