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

package/dist/{protocol-DyEvTHPF.d.ts → protocol-Mcbiq3nQ.d.ts}

@@ -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 as ErrorCodes$1, ErrorResult, HeadCommand, HeadResult, InitCommand, InitResult, ReadChunk, ReadCommand, ReadResult, SetDynamicHeaderCommand, SetDynamicHeaderResult, SetDynamicParamCommand, SetDynamicParamResult, ShutdownCommand, ShutdownResult, TestCommand, TestResult, calculateStats as calculateStats$1, decodeBase64 as decodeBase64$1, encodeBase64 as encodeBase64$1, formatStats as formatStats$1, parseCommand as parseCommand$1, parseResult as parseResult$1, serializeCommand as serializeCommand$1, serializeResult as serializeResult$1 };
+export { AppendCommand, AppendResult, BenchmarkAppendOp, BenchmarkCommand, BenchmarkCreateOp, BenchmarkOperation, BenchmarkReadOp, BenchmarkResult, BenchmarkRoundtripOp, BenchmarkStats, BenchmarkThroughputAppendOp, BenchmarkThroughputReadOp, ClearDynamicCommand, ClearDynamicResult, ConnectCommand, ConnectResult, CreateCommand, CreateResult, DeleteCommand, DeleteResult, ErrorCode, ErrorCodes as ErrorCodes$1, ErrorResult, HeadCommand, HeadResult, IdempotentAppendBatchCommand, IdempotentAppendBatchResult, IdempotentAppendCommand, IdempotentAppendResult, InitCommand, InitResult, ReadChunk, ReadCommand, ReadResult, SetDynamicHeaderCommand, SetDynamicHeaderResult, SetDynamicParamCommand, SetDynamicParamResult, ShutdownCommand, ShutdownResult, TestCommand, TestResult, calculateStats as calculateStats$1, decodeBase64 as decodeBase64$1, encodeBase64 as encodeBase64$1, formatStats as formatStats$1, parseCommand as parseCommand$1, parseResult as parseResult$1, serializeCommand as serializeCommand$1, serializeResult as serializeResult$1 };

package/dist/protocol.d.cts

@@ -1,2 +1,2 @@
-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";
-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 };
+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";
+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 };

package/dist/protocol.d.ts

@@ -1,2 +1,2 @@
-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";
-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 };
+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";
+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 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@durable-streams/client-conformance-tests",
   "description": "Conformance test suite for Durable Streams client implementations (producer and consumer)",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "author": "Durable Stream contributors",
   "bin": {
     "client-conformance-tests": "./dist/cli.js",
@@ -14,8 +14,8 @@
     "fast-check": "^4.4.0",
     "tsx": "^4.19.2",
     "yaml": "^2.7.1",
-    "@durable-streams/client": "0.1.2",
-    "@durable-streams/server": "0.1.3"
+    "@durable-streams/client": "0.1.4",
+    "@durable-streams/server": "0.1.5"
   },
   "devDependencies": {
     "tsdown": "^0.9.0",

package/src/adapters/typescript-adapter.ts

@@ -14,6 +14,7 @@ import {
   DurableStream,
   DurableStreamError,
   FetchError,
+  IdempotentProducer,
   stream,
 } from "@durable-streams/client"
 import {
@@ -439,7 +440,7 @@ async function handleCommand(command: TestCommand): Promise<TestResult> {
         return {
           type: `read`,
           success: true,
-          status: 200,
+          status: response.status,
           chunks,
           offset: finalOffset,
           upToDate,
@@ -543,6 +544,117 @@ async function handleCommand(command: TestCommand): Promise<TestResult> {
       }
     }
 
+    case `idempotent-append`: {
+      try {
+        const url = `${serverUrl}${command.path}`
+
+        // Get content-type from cache or use default
+        const contentType =
+          streamContentTypes.get(command.path) ?? `application/octet-stream`
+
+        const ds = new DurableStream({
+          url,
+          contentType,
+        })
+
+        const producer = new IdempotentProducer(ds, command.producerId, {
+          epoch: command.epoch,
+          autoClaim: command.autoClaim,
+          maxInFlight: 1,
+          lingerMs: 0, // Send immediately for testing
+        })
+
+        // For JSON streams, parse the string data into a native object
+        // (IdempotentProducer expects native objects for JSON streams)
+        const normalizedContentType = contentType
+          .split(`;`)[0]
+          ?.trim()
+          .toLowerCase()
+        const isJson = normalizedContentType === `application/json`
+        const data = isJson ? JSON.parse(command.data) : command.data
+
+        try {
+          // append() is fire-and-forget (synchronous), then flush() sends the batch
+          producer.append(data)
+          await producer.flush()
+          await producer.close()
+
+          return {
+            type: `idempotent-append`,
+            success: true,
+            status: 200,
+          }
+        } catch (err) {
+          await producer.close()
+          throw err
+        }
+      } catch (err) {
+        return errorResult(`idempotent-append`, err)
+      }
+    }
+
+    case `idempotent-append-batch`: {
+      try {
+        const url = `${serverUrl}${command.path}`
+
+        // Get content-type from cache or use default
+        const contentType =
+          streamContentTypes.get(command.path) ?? `application/octet-stream`
+
+        const ds = new DurableStream({
+          url,
+          contentType,
+        })
+
+        // Use provided maxInFlight or default to 1 for compatibility
+        const maxInFlight = command.maxInFlight ?? 1
+
+        // When testing concurrency (maxInFlight > 1), use small batches to force
+        // multiple concurrent requests. Otherwise batch all items together.
+        const testingConcurrency = maxInFlight > 1
+        const producer = new IdempotentProducer(ds, command.producerId, {
+          epoch: command.epoch,
+          autoClaim: command.autoClaim,
+          maxInFlight,
+          lingerMs: testingConcurrency ? 0 : 1000,
+          maxBatchBytes: testingConcurrency ? 1 : 1024 * 1024,
+        })
+
+        // For JSON streams, parse string items into native objects
+        // (IdempotentProducer expects native objects for JSON streams)
+        const normalizedContentType = contentType
+          .split(`;`)[0]
+          ?.trim()
+          .toLowerCase()
+        const isJson = normalizedContentType === `application/json`
+        const items = isJson
+          ? command.items.map((item: string) => JSON.parse(item))
+          : command.items
+
+        try {
+          // append() is fire-and-forget (synchronous), adds to pending batch
+          for (const item of items) {
+            producer.append(item)
+          }
+
+          // flush() sends the batch and waits for completion
+          await producer.flush()
+          await producer.close()
+
+          return {
+            type: `idempotent-append-batch`,
+            success: true,
+            status: 200,
+          }
+        } catch (err) {
+          await producer.close()
+          throw err
+        }
+      } catch (err) {
+        return errorResult(`idempotent-append-batch`, err)
+      }
+    }
+
     default:
       return {
         type: `error`,
@@ -708,6 +820,7 @@ async function handleBenchmark(command: BenchmarkCommand): Promise<TestResult> {
                 res.cancel()
                 resolve(chunk.data)
               }
+              return Promise.resolve()
             })
           })
         })()
@@ -748,10 +861,19 @@ async function handleBenchmark(command: BenchmarkCommand): Promise<TestResult> {
         // Generate payload (using fill for speed - don't want to measure PRNG)
         const payload = new Uint8Array(operation.size).fill(42)
 
-        // Submit all messages at once - client batching will handle the rest
-        await Promise.all(
-          Array.from({ length: operation.count }, () => ds.append(payload))
-        )
+        // Use IdempotentProducer for automatic batching and pipelining
+        const producer = new IdempotentProducer(ds, `bench-producer`, {
+          lingerMs: 0, // No linger - send batches immediately when ready
+          onError: (err) => console.error(`Batch failed:`, err),
+        })
+
+        // Fire-and-forget: don't await individual appends, producer batches in background
+        for (let i = 0; i < operation.count; i++) {
+          producer.append(payload)
+        }
+
+        // Wait for all messages to be delivered
+        await producer.flush()
 
         metrics.bytesTransferred = operation.count * operation.size
         metrics.messagesProcessed = operation.count

package/src/protocol.ts

@@ -62,10 +62,54 @@ export 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).
+ */
+export 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).
+ */
+export 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>
 }
 
 /**
@@ -235,6 +279,8 @@ export type TestCommand =
   | CreateCommand
   | ConnectCommand
   | AppendCommand
+  | IdempotentAppendCommand
+  | IdempotentAppendBatchCommand
   | ReadCommand
   | HeadCommand
   | DeleteCommand
@@ -313,6 +359,42 @@ export 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.
+ */
+export 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.
+ */
+export 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
 }
 
 /**
@@ -458,6 +540,8 @@ export type TestResult =
   | CreateResult
   | ConnectResult
   | AppendResult
+  | IdempotentAppendResult
+  | IdempotentAppendBatchResult
   | ReadResult
   | HeadResult
   | DeleteResult