@durable-streams/client-conformance-tests 0.1.5 → 0.1.7

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { AppendCommand, AppendResult, BenchmarkAppendOp, BenchmarkCommand, BenchmarkCreateOp, BenchmarkOperation, BenchmarkReadOp, BenchmarkResult, BenchmarkRoundtripOp, BenchmarkStats, BenchmarkThroughputAppendOp, BenchmarkThroughputReadOp, ClearDynamicCommand, ClearDynamicResult, ConnectCommand, ConnectResult, CreateCommand, CreateResult, DeleteCommand, DeleteResult, ErrorCode, ErrorCodes, ErrorResult, HeadCommand, HeadResult, InitCommand, InitResult, ReadChunk, ReadCommand, ReadResult, SetDynamicHeaderCommand, SetDynamicHeaderResult, SetDynamicParamCommand, SetDynamicParamResult, ShutdownCommand, ShutdownResult, TestCommand, TestResult, calculateStats, decodeBase64, encodeBase64, formatStats, parseCommand, parseResult, serializeCommand, serializeResult } from "./protocol-3cf94Xyb.cjs";
+import { AppendCommand, AppendResult, BenchmarkAppendOp, BenchmarkCommand, BenchmarkCreateOp, BenchmarkOperation, BenchmarkReadOp, BenchmarkResult, BenchmarkRoundtripOp, BenchmarkStats, BenchmarkThroughputAppendOp, BenchmarkThroughputReadOp, ClearDynamicCommand, ClearDynamicResult, ConnectCommand, ConnectResult, CreateCommand, CreateResult, DeleteCommand, DeleteResult, ErrorCode, ErrorCodes, ErrorResult, HeadCommand, HeadResult, IdempotentAppendBatchCommand, IdempotentAppendBatchResult, IdempotentAppendCommand, IdempotentAppendResult, InitCommand, InitResult, ReadChunk, ReadCommand, ReadResult, SetDynamicHeaderCommand, SetDynamicHeaderResult, SetDynamicParamCommand, SetDynamicParamResult, ShutdownCommand, ShutdownResult, TestCommand, TestResult, calculateStats, decodeBase64, encodeBase64, formatStats, parseCommand, parseResult, serializeCommand, serializeResult } from "./protocol-D37G3c4e.cjs";
 
 //#region src/test-cases.d.ts
 interface TestSuite {
@@ -85,10 +85,16 @@ interface AppendOperation {
   data?: string;
   /** Binary data (base64 encoded) */
   binaryData?: string;
-  /** Sequence number for ordering */
+  /** Sequence number for ordering (Stream-Seq header) */
   seq?: number;
   headers?: Record<string, string>;
   expect?: AppendExpectation;
+  /** Producer ID for idempotent producers */
+  producerId?: string;
+  /** Producer epoch for idempotent producers */
+  producerEpoch?: number;
+  /** Producer sequence for idempotent producers */
+  producerSeq?: number;
 }
 /**
 * Append multiple items (tests batching behavior).
@@ -106,6 +112,60 @@ interface AppendBatchOperation {
   expect?: AppendBatchExpectation;
 }
 /**
+* Append via IdempotentProducer client (tests client-side exactly-once semantics).
+*/
+interface IdempotentAppendOperation {
+  action: `idempotent-append`;
+  path: string;
+  /** Producer ID */
+  producerId: string;
+  /** Producer epoch */
+  epoch?: number;
+  /** Data to append (string or JSON for JSON streams) */
+  data: string;
+  /** Auto-claim epoch on 403 */
+  autoClaim?: boolean;
+  headers?: Record<string, string>;
+  expect?: IdempotentAppendExpectation;
+}
+/**
+* Batch append via IdempotentProducer client (tests client-side JSON batching).
+*/
+interface IdempotentAppendBatchOperation {
+  action: `idempotent-append-batch`;
+  path: string;
+  /** Producer ID */
+  producerId: string;
+  /** Producer epoch */
+  epoch?: number;
+  /** Items to append (will be batched by the client) */
+  items: Array<{
+    data: string;
+  }>;
+  /** Auto-claim epoch on 403 */
+  autoClaim?: boolean;
+  /** Max concurrent batches in flight (default 1, set higher to test 409 retry) */
+  maxInFlight?: number;
+  headers?: Record<string, string>;
+  expect?: IdempotentAppendBatchExpectation;
+}
+/**
+* Expectation for idempotent-append operation.
+*/
+interface IdempotentAppendExpectation extends BaseExpectation {
+  /** Expected duplicate flag */
+  duplicate?: boolean;
+  /** Store the returned offset */
+  storeOffsetAs?: string;
+}
+/**
+* Expectation for idempotent-append-batch operation.
+*/
+interface IdempotentAppendBatchExpectation extends BaseExpectation {
+  /** All items should succeed */
+  allSucceed?: boolean;
+}
+/**
 * Read from a stream.
 */
 interface ReadOperation {
@@ -194,13 +254,41 @@ interface AssertOperation {
 }
 /**
 * Append to stream via direct server HTTP (bypasses client adapter).
-* Used for concurrent operations when adapter is blocked on a read.
+* Used for concurrent operations when adapter is blocked on a read,
+* and for testing protocol-level behavior like idempotent producers.
 */
 interface ServerAppendOperation {
   action: `server-append`;
   path: string;
   data: string;
   headers?: Record<string, string>;
+  /** Producer ID for idempotent producers */
+  producerId?: string;
+  /** Producer epoch for idempotent producers */
+  producerEpoch?: number;
+  /** Producer sequence for idempotent producers */
+  producerSeq?: number;
+  /** Expected result */
+  expect?: ServerAppendExpectation;
+}
+/**
+* Expectation for server-append operation.
+*/
+interface ServerAppendExpectation {
+  /** Expected HTTP status code */
+  status?: number;
+  /** Store the returned offset */
+  storeOffsetAs?: string;
+  /** Expected duplicate flag (true for 204 idempotent success) */
+  duplicate?: boolean;
+  /** Expected producer epoch in response */
+  producerEpoch?: number;
+  /** Expected producer seq in response (highest accepted sequence) */
+  producerSeq?: number;
+  /** Expected producer expected seq (on 409 sequence gap) */
+  producerExpectedSeq?: number;
+  /** Expected producer received seq (on 409 sequence gap) */
+  producerReceivedSeq?: number;
 }
 /**
 * Wait for a background operation to complete.
@@ -212,19 +300,34 @@ interface AwaitOperation {
   expect?: ReadExpectation;
 }
 /**
-* Inject an error to be returned on the next N requests to a path.
+* Inject a fault to be triggered on the next N requests to a path.
 * Used for testing retry/resilience behavior.
+* Supports various fault types: errors, delays, connection drops, body corruption, etc.
 */
 interface InjectErrorOperation {
   action: `inject-error`;
-  /** Stream path to inject error for */
+  /** Stream path to inject fault for */
   path: string;
-  /** HTTP status code to return */
-  status: number;
-  /** Number of times to return this error (default: 1) */
+  /** HTTP status code to return (if set, returns error response) */
+  status?: number;
+  /** Number of times to trigger this fault (default: 1) */
   count?: number;
   /** Optional Retry-After header value (seconds) */
   retryAfter?: number;
+  /** Delay in milliseconds before responding */
+  delayMs?: number;
+  /** Drop the connection after sending headers (simulates network failure) */
+  dropConnection?: boolean;
+  /** Truncate response body to this many bytes */
+  truncateBodyBytes?: number;
+  /** Probability of triggering fault (0-1, default 1.0 = always) */
+  probability?: number;
+  /** Only match specific HTTP method (GET, POST, PUT, DELETE) */
+  method?: string;
+  /** Corrupt the response body by flipping random bits */
+  corruptBody?: boolean;
+  /** Add jitter to delay (random 0-jitterMs added to delayMs) */
+  jitterMs?: number;
 }
 /**
 * Clear all injected errors.
@@ -264,7 +367,7 @@ interface ClearDynamicOperation {
 /**
 * All possible test operations.
 */
-type TestOperation = CreateOperation | ConnectOperation | AppendOperation | AppendBatchOperation | ReadOperation | HeadOperation | DeleteOperation | WaitOperation | SetOperation | AssertOperation | ServerAppendOperation | AwaitOperation | InjectErrorOperation | ClearErrorsOperation | SetDynamicHeaderOperation | SetDynamicParamOperation | ClearDynamicOperation;
+type TestOperation = CreateOperation | ConnectOperation | AppendOperation | AppendBatchOperation | IdempotentAppendOperation | IdempotentAppendBatchOperation | ReadOperation | HeadOperation | DeleteOperation | WaitOperation | SetOperation | AssertOperation | ServerAppendOperation | AwaitOperation | InjectErrorOperation | ClearErrorsOperation | SetDynamicHeaderOperation | SetDynamicParamOperation | ClearDynamicOperation;
 /**
 * Base expectation fields.
 */
@@ -284,13 +387,23 @@ interface ConnectExpectation extends BaseExpectation {
   status?: 200 | 404 | number;
 }
 interface AppendExpectation extends BaseExpectation {
-  status?: 200 | 404 | 409 | number;
+  status?: 200 | 204 | 400 | 403 | 404 | 409 | number;
   /** Store the returned offset */
   storeOffsetAs?: string;
   /** Expected headers that were sent (for dynamic header testing) */
   headersSent?: Record<string, string>;
   /** Expected params that were sent (for dynamic param testing) */
   paramsSent?: Record<string, string>;
+  /** Expected duplicate flag (true for 204 idempotent success) */
+  duplicate?: boolean;
+  /** Expected producer epoch in response */
+  producerEpoch?: number;
+  /** Expected producer seq in response (highest accepted sequence) */
+  producerSeq?: number;
+  /** Expected producer expected seq (on 409 sequence gap) */
+  producerExpectedSeq?: number;
+  /** Expected producer received seq (on 409 sequence gap) */
+  producerReceivedSeq?: number;
 }
 interface AppendBatchExpectation extends BaseExpectation {
   /** All items should succeed */
@@ -308,6 +421,8 @@ interface ReadExpectation extends BaseExpectation {
   dataContains?: string;
   /** Expected data to contain all of these substrings */
   dataContainsAll?: Array<string>;
+  /** Expected exact messages in order (for JSON streams, verifies each chunk) */
+  dataExact?: Array<string>;
   /** Expected number of chunks */
   chunkCount?: number;
   /** Minimum number of chunks */
@@ -505,4 +620,4 @@ interface BenchmarkSummary {
 declare function runBenchmarks(options: BenchmarkRunnerOptions): Promise<BenchmarkSummary>;
 
 //#endregion
-export { AppendCommand, AppendResult, BenchmarkAppendOp, BenchmarkCommand, BenchmarkCreateOp, BenchmarkCriteria, BenchmarkOperation, BenchmarkReadOp, BenchmarkResult, BenchmarkRoundtripOp, BenchmarkRunnerOptions, BenchmarkScenario, BenchmarkScenarioConfig, BenchmarkStats, BenchmarkSummary, BenchmarkThroughputAppendOp, BenchmarkThroughputReadOp, ClearDynamicCommand, ClearDynamicResult, ClientFeature, ConnectCommand, ConnectResult, CreateCommand, CreateResult, DeleteCommand, DeleteResult, ErrorCode, ErrorCodes, ErrorResult, HeadCommand, HeadResult, InitCommand, InitResult, ReadChunk, ReadCommand, ReadResult, RunSummary, RunnerOptions, ScenarioContext, ScenarioResult, SetDynamicHeaderCommand, SetDynamicHeaderResult, SetDynamicParamCommand, SetDynamicParamResult, ShutdownCommand, ShutdownResult, TestCase, TestCommand, TestOperation, TestResult, TestRunResult, TestSuite, allScenarios, calculateStats, countTests, decodeBase64, encodeBase64, filterByCategory, formatStats, getScenarioById, getScenariosByCategory, loadEmbeddedTestSuites, loadTestSuites, parseCommand, parseResult, runBenchmarks, runConformanceTests, scenariosByCategory, serializeCommand, serializeResult };
+export { AppendCommand, AppendResult, BenchmarkAppendOp, BenchmarkCommand, BenchmarkCreateOp, BenchmarkCriteria, BenchmarkOperation, BenchmarkReadOp, BenchmarkResult, BenchmarkRoundtripOp, BenchmarkRunnerOptions, BenchmarkScenario, BenchmarkScenarioConfig, BenchmarkStats, BenchmarkSummary, BenchmarkThroughputAppendOp, BenchmarkThroughputReadOp, ClearDynamicCommand, ClearDynamicResult, ClientFeature, ConnectCommand, ConnectResult, CreateCommand, CreateResult, DeleteCommand, DeleteResult, ErrorCode, ErrorCodes, ErrorResult, HeadCommand, HeadResult, IdempotentAppendBatchCommand, IdempotentAppendBatchResult, IdempotentAppendCommand, IdempotentAppendResult, InitCommand, InitResult, ReadChunk, ReadCommand, ReadResult, RunSummary, RunnerOptions, ScenarioContext, ScenarioResult, SetDynamicHeaderCommand, SetDynamicHeaderResult, SetDynamicParamCommand, SetDynamicParamResult, ShutdownCommand, ShutdownResult, TestCase, TestCommand, TestOperation, TestResult, TestRunResult, TestSuite, allScenarios, calculateStats, countTests, decodeBase64, encodeBase64, filterByCategory, formatStats, getScenarioById, getScenariosByCategory, loadEmbeddedTestSuites, loadTestSuites, parseCommand, parseResult, runBenchmarks, runConformanceTests, scenariosByCategory, serializeCommand, serializeResult };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { AppendCommand, AppendResult, BenchmarkAppendOp, BenchmarkCommand, BenchmarkCreateOp, BenchmarkOperation, BenchmarkReadOp, BenchmarkResult, BenchmarkRoundtripOp, BenchmarkStats, BenchmarkThroughputAppendOp, BenchmarkThroughputReadOp, ClearDynamicCommand, ClearDynamicResult, ConnectCommand, ConnectResult, CreateCommand, CreateResult, DeleteCommand, DeleteResult, ErrorCode, ErrorCodes$1 as ErrorCodes, ErrorResult, HeadCommand, HeadResult, InitCommand, InitResult, ReadChunk, ReadCommand, ReadResult, SetDynamicHeaderCommand, SetDynamicHeaderResult, SetDynamicParamCommand, SetDynamicParamResult, ShutdownCommand, ShutdownResult, TestCommand, TestResult, calculateStats$1 as calculateStats, decodeBase64$1 as decodeBase64, encodeBase64$1 as encodeBase64, formatStats$1 as formatStats, parseCommand$1 as parseCommand, parseResult$1 as parseResult, serializeCommand$1 as serializeCommand, serializeResult$1 as serializeResult } from "./protocol-DyEvTHPF.js";
+import { AppendCommand, AppendResult, BenchmarkAppendOp, BenchmarkCommand, BenchmarkCreateOp, BenchmarkOperation, BenchmarkReadOp, BenchmarkResult, BenchmarkRoundtripOp, BenchmarkStats, BenchmarkThroughputAppendOp, BenchmarkThroughputReadOp, ClearDynamicCommand, ClearDynamicResult, ConnectCommand, ConnectResult, CreateCommand, CreateResult, DeleteCommand, DeleteResult, ErrorCode, ErrorCodes$1 as ErrorCodes, ErrorResult, HeadCommand, HeadResult, IdempotentAppendBatchCommand, IdempotentAppendBatchResult, IdempotentAppendCommand, IdempotentAppendResult, InitCommand, InitResult, ReadChunk, ReadCommand, ReadResult, SetDynamicHeaderCommand, SetDynamicHeaderResult, SetDynamicParamCommand, SetDynamicParamResult, ShutdownCommand, ShutdownResult, TestCommand, TestResult, calculateStats$1 as calculateStats, decodeBase64$1 as decodeBase64, encodeBase64$1 as encodeBase64, formatStats$1 as formatStats, parseCommand$1 as parseCommand, parseResult$1 as parseResult, serializeCommand$1 as serializeCommand, serializeResult$1 as serializeResult } from "./protocol-Mcbiq3nQ.js";
 
 //#region src/test-cases.d.ts
 interface TestSuite {
@@ -85,10 +85,16 @@ interface AppendOperation {
   data?: string;
   /** Binary data (base64 encoded) */
   binaryData?: string;
-  /** Sequence number for ordering */
+  /** Sequence number for ordering (Stream-Seq header) */
   seq?: number;
   headers?: Record<string, string>;
   expect?: AppendExpectation;
+  /** Producer ID for idempotent producers */
+  producerId?: string;
+  /** Producer epoch for idempotent producers */
+  producerEpoch?: number;
+  /** Producer sequence for idempotent producers */
+  producerSeq?: number;
 }
 /**
 * Append multiple items (tests batching behavior).
@@ -106,6 +112,60 @@ interface AppendBatchOperation {
   expect?: AppendBatchExpectation;
 }
 /**
+* Append via IdempotentProducer client (tests client-side exactly-once semantics).
+*/
+interface IdempotentAppendOperation {
+  action: `idempotent-append`;
+  path: string;
+  /** Producer ID */
+  producerId: string;
+  /** Producer epoch */
+  epoch?: number;
+  /** Data to append (string or JSON for JSON streams) */
+  data: string;
+  /** Auto-claim epoch on 403 */
+  autoClaim?: boolean;
+  headers?: Record<string, string>;
+  expect?: IdempotentAppendExpectation;
+}
+/**
+* Batch append via IdempotentProducer client (tests client-side JSON batching).
+*/
+interface IdempotentAppendBatchOperation {
+  action: `idempotent-append-batch`;
+  path: string;
+  /** Producer ID */
+  producerId: string;
+  /** Producer epoch */
+  epoch?: number;
+  /** Items to append (will be batched by the client) */
+  items: Array<{
+    data: string;
+  }>;
+  /** Auto-claim epoch on 403 */
+  autoClaim?: boolean;
+  /** Max concurrent batches in flight (default 1, set higher to test 409 retry) */
+  maxInFlight?: number;
+  headers?: Record<string, string>;
+  expect?: IdempotentAppendBatchExpectation;
+}
+/**
+* Expectation for idempotent-append operation.
+*/
+interface IdempotentAppendExpectation extends BaseExpectation {
+  /** Expected duplicate flag */
+  duplicate?: boolean;
+  /** Store the returned offset */
+  storeOffsetAs?: string;
+}
+/**
+* Expectation for idempotent-append-batch operation.
+*/
+interface IdempotentAppendBatchExpectation extends BaseExpectation {
+  /** All items should succeed */
+  allSucceed?: boolean;
+}
+/**
 * Read from a stream.
 */
 interface ReadOperation {
@@ -194,13 +254,41 @@ interface AssertOperation {
 }
 /**
 * Append to stream via direct server HTTP (bypasses client adapter).
-* Used for concurrent operations when adapter is blocked on a read.
+* Used for concurrent operations when adapter is blocked on a read,
+* and for testing protocol-level behavior like idempotent producers.
 */
 interface ServerAppendOperation {
   action: `server-append`;
   path: string;
   data: string;
   headers?: Record<string, string>;
+  /** Producer ID for idempotent producers */
+  producerId?: string;
+  /** Producer epoch for idempotent producers */
+  producerEpoch?: number;
+  /** Producer sequence for idempotent producers */
+  producerSeq?: number;
+  /** Expected result */
+  expect?: ServerAppendExpectation;
+}
+/**
+* Expectation for server-append operation.
+*/
+interface ServerAppendExpectation {
+  /** Expected HTTP status code */
+  status?: number;
+  /** Store the returned offset */
+  storeOffsetAs?: string;
+  /** Expected duplicate flag (true for 204 idempotent success) */
+  duplicate?: boolean;
+  /** Expected producer epoch in response */
+  producerEpoch?: number;
+  /** Expected producer seq in response (highest accepted sequence) */
+  producerSeq?: number;
+  /** Expected producer expected seq (on 409 sequence gap) */
+  producerExpectedSeq?: number;
+  /** Expected producer received seq (on 409 sequence gap) */
+  producerReceivedSeq?: number;
 }
 /**
 * Wait for a background operation to complete.
@@ -212,19 +300,34 @@ interface AwaitOperation {
   expect?: ReadExpectation;
 }
 /**
-* Inject an error to be returned on the next N requests to a path.
+* Inject a fault to be triggered on the next N requests to a path.
 * Used for testing retry/resilience behavior.
+* Supports various fault types: errors, delays, connection drops, body corruption, etc.
 */
 interface InjectErrorOperation {
   action: `inject-error`;
-  /** Stream path to inject error for */
+  /** Stream path to inject fault for */
   path: string;
-  /** HTTP status code to return */
-  status: number;
-  /** Number of times to return this error (default: 1) */
+  /** HTTP status code to return (if set, returns error response) */
+  status?: number;
+  /** Number of times to trigger this fault (default: 1) */
   count?: number;
   /** Optional Retry-After header value (seconds) */
   retryAfter?: number;
+  /** Delay in milliseconds before responding */
+  delayMs?: number;
+  /** Drop the connection after sending headers (simulates network failure) */
+  dropConnection?: boolean;
+  /** Truncate response body to this many bytes */
+  truncateBodyBytes?: number;
+  /** Probability of triggering fault (0-1, default 1.0 = always) */
+  probability?: number;
+  /** Only match specific HTTP method (GET, POST, PUT, DELETE) */
+  method?: string;
+  /** Corrupt the response body by flipping random bits */
+  corruptBody?: boolean;
+  /** Add jitter to delay (random 0-jitterMs added to delayMs) */
+  jitterMs?: number;
 }
 /**
 * Clear all injected errors.
@@ -264,7 +367,7 @@ interface ClearDynamicOperation {
 /**
 * All possible test operations.
 */
-type TestOperation = CreateOperation | ConnectOperation | AppendOperation | AppendBatchOperation | ReadOperation | HeadOperation | DeleteOperation | WaitOperation | SetOperation | AssertOperation | ServerAppendOperation | AwaitOperation | InjectErrorOperation | ClearErrorsOperation | SetDynamicHeaderOperation | SetDynamicParamOperation | ClearDynamicOperation;
+type TestOperation = CreateOperation | ConnectOperation | AppendOperation | AppendBatchOperation | IdempotentAppendOperation | IdempotentAppendBatchOperation | ReadOperation | HeadOperation | DeleteOperation | WaitOperation | SetOperation | AssertOperation | ServerAppendOperation | AwaitOperation | InjectErrorOperation | ClearErrorsOperation | SetDynamicHeaderOperation | SetDynamicParamOperation | ClearDynamicOperation;
 /**
 * Base expectation fields.
 */
@@ -284,13 +387,23 @@ interface ConnectExpectation extends BaseExpectation {
   status?: 200 | 404 | number;
 }
 interface AppendExpectation extends BaseExpectation {
-  status?: 200 | 404 | 409 | number;
+  status?: 200 | 204 | 400 | 403 | 404 | 409 | number;
   /** Store the returned offset */
   storeOffsetAs?: string;
   /** Expected headers that were sent (for dynamic header testing) */
   headersSent?: Record<string, string>;
   /** Expected params that were sent (for dynamic param testing) */
   paramsSent?: Record<string, string>;
+  /** Expected duplicate flag (true for 204 idempotent success) */
+  duplicate?: boolean;
+  /** Expected producer epoch in response */
+  producerEpoch?: number;
+  /** Expected producer seq in response (highest accepted sequence) */
+  producerSeq?: number;
+  /** Expected producer expected seq (on 409 sequence gap) */
+  producerExpectedSeq?: number;
+  /** Expected producer received seq (on 409 sequence gap) */
+  producerReceivedSeq?: number;
 }
 interface AppendBatchExpectation extends BaseExpectation {
   /** All items should succeed */
@@ -308,6 +421,8 @@ interface ReadExpectation extends BaseExpectation {
   dataContains?: string;
   /** Expected data to contain all of these substrings */
   dataContainsAll?: Array<string>;
+  /** Expected exact messages in order (for JSON streams, verifies each chunk) */
+  dataExact?: Array<string>;
   /** Expected number of chunks */
   chunkCount?: number;
   /** Minimum number of chunks */
@@ -505,4 +620,4 @@ interface BenchmarkSummary {
 declare function runBenchmarks(options: BenchmarkRunnerOptions): Promise<BenchmarkSummary>;
 
 //#endregion
-export { AppendCommand, AppendResult, BenchmarkAppendOp, BenchmarkCommand, BenchmarkCreateOp, BenchmarkCriteria, BenchmarkOperation, BenchmarkReadOp, BenchmarkResult, BenchmarkRoundtripOp, BenchmarkRunnerOptions, BenchmarkScenario, BenchmarkScenarioConfig, BenchmarkStats, BenchmarkSummary, BenchmarkThroughputAppendOp, BenchmarkThroughputReadOp, ClearDynamicCommand, ClearDynamicResult, ClientFeature, ConnectCommand, ConnectResult, CreateCommand, CreateResult, DeleteCommand, DeleteResult, ErrorCode, ErrorCodes, ErrorResult, HeadCommand, HeadResult, InitCommand, InitResult, ReadChunk, ReadCommand, ReadResult, RunSummary, RunnerOptions, ScenarioContext, ScenarioResult, SetDynamicHeaderCommand, SetDynamicHeaderResult, SetDynamicParamCommand, SetDynamicParamResult, ShutdownCommand, ShutdownResult, TestCase, TestCommand, TestOperation, TestResult, TestRunResult, TestSuite, allScenarios, calculateStats, countTests, decodeBase64, encodeBase64, filterByCategory, formatStats, getScenarioById, getScenariosByCategory, loadEmbeddedTestSuites, loadTestSuites, parseCommand, parseResult, runBenchmarks, runConformanceTests, scenariosByCategory, serializeCommand, serializeResult };
+export { AppendCommand, AppendResult, BenchmarkAppendOp, BenchmarkCommand, BenchmarkCreateOp, BenchmarkCriteria, BenchmarkOperation, BenchmarkReadOp, BenchmarkResult, BenchmarkRoundtripOp, BenchmarkRunnerOptions, BenchmarkScenario, BenchmarkScenarioConfig, BenchmarkStats, BenchmarkSummary, BenchmarkThroughputAppendOp, BenchmarkThroughputReadOp, ClearDynamicCommand, ClearDynamicResult, ClientFeature, ConnectCommand, ConnectResult, CreateCommand, CreateResult, DeleteCommand, DeleteResult, ErrorCode, ErrorCodes, ErrorResult, HeadCommand, HeadResult, IdempotentAppendBatchCommand, IdempotentAppendBatchResult, IdempotentAppendCommand, IdempotentAppendResult, InitCommand, InitResult, ReadChunk, ReadCommand, ReadResult, RunSummary, RunnerOptions, ScenarioContext, ScenarioResult, SetDynamicHeaderCommand, SetDynamicHeaderResult, SetDynamicParamCommand, SetDynamicParamResult, ShutdownCommand, ShutdownResult, TestCase, TestCommand, TestOperation, TestResult, TestRunResult, TestSuite, allScenarios, calculateStats, countTests, decodeBase64, encodeBase64, filterByCategory, formatStats, getScenarioById, getScenariosByCategory, loadEmbeddedTestSuites, loadTestSuites, parseCommand, parseResult, runBenchmarks, runConformanceTests, scenariosByCategory, serializeCommand, serializeResult };

package/dist/index.js

@@ -1,4 +1,4 @@
 import { ErrorCodes, calculateStats, decodeBase64, encodeBase64, formatStats, parseCommand, parseResult, serializeCommand, serializeResult } from "./protocol-qb83AeUH.js";
-import { allScenarios, countTests, filterByCategory, getScenarioById, getScenariosByCategory, loadEmbeddedTestSuites, loadTestSuites, runBenchmarks, runConformanceTests, scenariosByCategory } from "./benchmark-runner-C_Yghc8f.js";
+import { allScenarios, countTests, filterByCategory, getScenarioById, getScenariosByCategory, loadEmbeddedTestSuites, loadTestSuites, runBenchmarks, runConformanceTests, scenariosByCategory } from "./benchmark-runner-CrE6JkbX.js";
 
 export { ErrorCodes, allScenarios, calculateStats, countTests, decodeBase64, encodeBase64, filterByCategory, formatStats, getScenarioById, getScenariosByCategory, loadEmbeddedTestSuites, loadTestSuites, parseCommand, parseResult, runBenchmarks, runConformanceTests, scenariosByCategory, serializeCommand, serializeResult };

package/dist/{protocol-3cf94Xyb.d.cts → protocol-D37G3c4e.d.cts}

@@ -55,10 +55,52 @@ interface AppendCommand {
   data: string;
   /** Whether data is base64 encoded binary */
   binary?: boolean;
-  /** Optional sequence number for ordering */
+  /** Optional sequence number for ordering (Stream-Seq header) */
   seq?: number;
   /** Custom headers to include */
   headers?: Record<string, string>;
+  /** Producer ID for idempotent producers */
+  producerId?: string;
+  /** Producer epoch for idempotent producers */
+  producerEpoch?: number;
+  /** Producer sequence for idempotent producers */
+  producerSeq?: number;
+}
+/**
+* Append via IdempotentProducer client (tests client-side exactly-once semantics).
+*/
+interface IdempotentAppendCommand {
+  type: `idempotent-append`;
+  path: string;
+  /** Data to append (string - will be JSON parsed for JSON streams) */
+  data: string;
+  /** Producer ID */
+  producerId: string;
+  /** Producer epoch */
+  epoch: number;
+  /** Auto-claim epoch on 403 */
+  autoClaim: boolean;
+  /** Custom headers to include */
+  headers?: Record<string, string>;
+}
+/**
+* Batch append via IdempotentProducer client (tests client-side JSON batching).
+*/
+interface IdempotentAppendBatchCommand {
+  type: `idempotent-append-batch`;
+  path: string;
+  /** Items to append - will be batched by the client */
+  items: Array<string>;
+  /** Producer ID */
+  producerId: string;
+  /** Producer epoch */
+  epoch: number;
+  /** Auto-claim epoch on 403 */
+  autoClaim: boolean;
+  /** Max concurrent batches in flight (default 1, set higher to test 409 retry) */
+  maxInFlight?: number;
+  /** Custom headers to include */
+  headers?: Record<string, string>;
 }
 /**
 * Read from a stream (GET request).
@@ -193,7 +235,7 @@ interface BenchmarkThroughputReadOp {
 /**
 * All possible commands from test runner to client.
 */
-type TestCommand = InitCommand | CreateCommand | ConnectCommand | AppendCommand | ReadCommand | HeadCommand | DeleteCommand | ShutdownCommand | SetDynamicHeaderCommand | SetDynamicParamCommand | ClearDynamicCommand | BenchmarkCommand;
+type TestCommand = InitCommand | CreateCommand | ConnectCommand | AppendCommand | IdempotentAppendCommand | IdempotentAppendBatchCommand | ReadCommand | HeadCommand | DeleteCommand | ShutdownCommand | SetDynamicHeaderCommand | SetDynamicParamCommand | ClearDynamicCommand | BenchmarkCommand;
 /**
 * Successful initialization result.
 */
@@ -256,6 +298,40 @@ interface AppendResult {
   headersSent?: Record<string, string>;
   /** Params that were sent in the request (for dynamic param testing) */
   paramsSent?: Record<string, string>;
+  /** Whether this was a duplicate (204 response) - for idempotent producers */
+  duplicate?: boolean;
+  /** Current producer epoch from server (on 200 or 403) */
+  producerEpoch?: number;
+  /** Server's highest accepted sequence for this (stream, producerId, epoch) - returned in Producer-Seq header on 200/204 */
+  producerSeq?: number;
+  /** Expected producer sequence (on 409 sequence gap) */
+  producerExpectedSeq?: number;
+  /** Received producer sequence (on 409 sequence gap) */
+  producerReceivedSeq?: number;
+}
+/**
+* Successful idempotent-append result.
+*/
+interface IdempotentAppendResult {
+  type: `idempotent-append`;
+  success: true;
+  status: number;
+  /** New offset after append */
+  offset?: string;
+  /** Whether this was a duplicate */
+  duplicate?: boolean;
+  /** Server's highest accepted sequence for this (stream, producerId, epoch) - returned in Producer-Seq header */
+  producerSeq?: number;
+}
+/**
+* Successful idempotent-append-batch result.
+*/
+interface IdempotentAppendBatchResult {
+  type: `idempotent-append-batch`;
+  success: true;
+  status: number;
+  /** Server's highest accepted sequence for this (stream, producerId, epoch) - returned in Producer-Seq header */
+  producerSeq?: number;
 }
 /**
 * A chunk of data read from the stream.
@@ -385,7 +461,7 @@ interface ErrorResult {
 /**
 * All possible results from client to test runner.
 */
-type TestResult = InitResult | CreateResult | ConnectResult | AppendResult | ReadResult | HeadResult | DeleteResult | ShutdownResult | SetDynamicHeaderResult | SetDynamicParamResult | ClearDynamicResult | BenchmarkResult | ErrorResult;
+type TestResult = InitResult | CreateResult | ConnectResult | AppendResult | IdempotentAppendResult | IdempotentAppendBatchResult | ReadResult | HeadResult | DeleteResult | ShutdownResult | SetDynamicHeaderResult | SetDynamicParamResult | ClearDynamicResult | BenchmarkResult | ErrorResult;
 /**
 * Parse a JSON line into a TestCommand.
 */
@@ -469,4 +545,4 @@ declare function calculateStats(durationsNs: Array<bigint>): BenchmarkStats;
 * Format a BenchmarkStats object for display.
 */
 declare function formatStats(stats: BenchmarkStats, unit?: string): Record<string, string>; //#endregion
-export { AppendCommand, AppendResult, BenchmarkAppendOp, BenchmarkCommand, BenchmarkCreateOp, BenchmarkOperation, BenchmarkReadOp, BenchmarkResult, BenchmarkRoundtripOp, BenchmarkStats, BenchmarkThroughputAppendOp, BenchmarkThroughputReadOp, ClearDynamicCommand, ClearDynamicResult, ConnectCommand, ConnectResult, CreateCommand, CreateResult, DeleteCommand, DeleteResult, ErrorCode, ErrorCodes, ErrorResult, HeadCommand, HeadResult, InitCommand, InitResult, ReadChunk, ReadCommand, ReadResult, SetDynamicHeaderCommand, SetDynamicHeaderResult, SetDynamicParamCommand, SetDynamicParamResult, ShutdownCommand, ShutdownResult, TestCommand, TestResult, calculateStats, decodeBase64, encodeBase64, formatStats, parseCommand, parseResult, serializeCommand, serializeResult };
+export { AppendCommand, AppendResult, BenchmarkAppendOp, BenchmarkCommand, BenchmarkCreateOp, BenchmarkOperation, BenchmarkReadOp, BenchmarkResult, BenchmarkRoundtripOp, BenchmarkStats, BenchmarkThroughputAppendOp, BenchmarkThroughputReadOp, ClearDynamicCommand, ClearDynamicResult, ConnectCommand, ConnectResult, CreateCommand, CreateResult, DeleteCommand, DeleteResult, ErrorCode, ErrorCodes, ErrorResult, HeadCommand, HeadResult, IdempotentAppendBatchCommand, IdempotentAppendBatchResult, IdempotentAppendCommand, IdempotentAppendResult, InitCommand, InitResult, ReadChunk, ReadCommand, ReadResult, SetDynamicHeaderCommand, SetDynamicHeaderResult, SetDynamicParamCommand, SetDynamicParamResult, ShutdownCommand, ShutdownResult, TestCommand, TestResult, calculateStats, decodeBase64, encodeBase64, formatStats, parseCommand, parseResult, serializeCommand, serializeResult };