@durable-streams/server 0.1.2 → 0.1.4

package/dist/index.d.cts

@@ -159,6 +159,15 @@ declare class StreamStore {
   private streams;
   private pendingLongPolls;
   /**
+  * Check if a stream is expired based on TTL or Expires-At.
+  */
+  private isExpired;
+  /**
+  * Get a stream, deleting it if expired.
+  * Returns undefined if stream doesn't exist or is expired.
+  */
+  private getIfNotExpired;
+  /**
   * Create a new stream.
   * @throws Error if stream already exists with different config
   * @returns existing stream if config matches (idempotent)
@@ -171,10 +180,11 @@ declare class StreamStore {
   }): Stream;
   /**
   * Get a stream by path.
+  * Returns undefined if stream doesn't exist or is expired.
   */
   get(path: string): Stream | undefined;
   /**
-  * Check if a stream exists.
+  * Check if a stream exists (and is not expired).
   */
   has(path: string): boolean;
   /**
@@ -183,7 +193,7 @@ declare class StreamStore {
   delete(path: string): boolean;
   /**
   * Append data to a stream.
-  * @throws Error if stream doesn't exist
+  * @throws Error if stream doesn't exist or is expired
   * @throws Error if seq is lower than lastSeq
   * @throws Error if JSON mode and array is empty
   */
@@ -193,6 +203,7 @@ declare class StreamStore {
   }): StreamMessage;
   /**
   * Read messages from a stream starting at the given offset.
+  * @throws Error if stream doesn't exist or is expired
   */
   read(path: string, offset?: string): {
     messages: Array<StreamMessage>;
@@ -201,10 +212,12 @@ declare class StreamStore {
   /**
   * Format messages for response.
   * For JSON mode, wraps concatenated data in array brackets.
+  * @throws Error if stream doesn't exist or is expired
   */
   formatResponse(path: string, messages: Array<StreamMessage>): Uint8Array;
   /**
   * Wait for new messages (long-poll).
+  * @throws Error if stream doesn't exist or is expired
   */
   waitForMessages(path: string, offset: string, timeoutMs: number): Promise<{
     messages: Array<StreamMessage>;
@@ -212,6 +225,7 @@ declare class StreamStore {
   }>;
   /**
   * Get the current offset for a stream.
+  * Returns undefined if stream doesn't exist or is expired.
   */
   getCurrentOffset(path: string): string | undefined;
   /**
@@ -263,6 +277,15 @@ declare class FileBackedStreamStore {
   */
   private streamMetaToStream;
   /**
+  * Check if a stream is expired based on TTL or Expires-At.
+  */
+  private isExpired;
+  /**
+  * Get stream metadata, deleting it if expired.
+  * Returns undefined if stream doesn't exist or is expired.
+  */
+  private getMetaIfNotExpired;
+  /**
   * Close the store, closing all file handles and database.
   * All data is already fsynced on each append, so no final flush needed.
   */
@@ -292,6 +315,7 @@ declare class FileBackedStreamStore {
   /**
   * Format messages for response.
   * For JSON mode, wraps concatenated data in array brackets.
+  * @throws Error if stream doesn't exist or is expired
   */
   formatResponse(streamPath: string, messages: Array<StreamMessage>): Uint8Array;
   getCurrentOffset(streamPath: string): string | undefined;
@@ -308,6 +332,36 @@ declare class FileBackedStreamStore {
 
 //#endregion
 //#region src/server.d.ts
+/**
+* HTTP server for testing durable streams.
+* Supports both in-memory and file-backed storage modes.
+*/
+/**
+* Configuration for injected faults (for testing retry/resilience).
+* Supports various fault types beyond simple HTTP errors.
+*/
+interface InjectedFault {
+  /** HTTP status code to return (if set, returns error response) */
+  status?: number;
+  /** Number of times to trigger this fault (decremented on each use) */
+  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;
+}
 declare class DurableStreamTestServer {
   readonly store: StreamStore | FileBackedStreamStore;
   private server;
@@ -315,8 +369,8 @@ declare class DurableStreamTestServer {
   private _url;
   private activeSSEResponses;
   private isShuttingDown;
-  /** Injected errors for testing retry/resilience */
-  private injectedErrors;
+  /** Injected faults for testing retry/resilience */
+  private injectedFaults;
   constructor(options?: TestServerOptions);
   /**
   * Start the server.
@@ -337,17 +391,34 @@ declare class DurableStreamTestServer {
   /**
   * Inject an error to be returned on the next N requests to a path.
   * Used for testing retry/resilience behavior.
+  * @deprecated Use injectFault for full fault injection capabilities
   */
   injectError(path: string, status: number, count?: number, retryAfter?: number): void;
   /**
-  * Clear all injected errors.
+  * Inject a fault to be triggered on the next N requests to a path.
+  * Supports various fault types: delays, connection drops, body corruption, etc.
+  */
+  injectFault(path: string, fault: Omit<InjectedFault, `count`> & {
+    count?: number;
+  }): void;
+  /**
+  * Clear all injected faults.
   */
-  clearInjectedErrors(): void;
+  clearInjectedFaults(): void;
   /**
-  * Check if there's an injected error for this path and consume it.
-  * Returns the error config if one should be returned, null otherwise.
+  * Check if there's an injected fault for this path/method and consume it.
+  * Returns the fault config if one should be triggered, null otherwise.
   */
-  private consumeInjectedError;
+  private consumeInjectedFault;
+  /**
+  * Apply delay from fault config (including jitter).
+  */
+  private applyFaultDelay;
+  /**
+  * Apply body modifications from stored fault (truncation, corruption).
+  * Returns modified body, or original if no modifications needed.
+  */
+  private applyFaultBodyModification;
   private handleRequest;
   /**
   * Handle PUT - create stream
@@ -380,9 +451,7 @@ declare class DurableStreamTestServer {
   */
   private handleTestInjectError;
   private readBody;
-}
-
-//#endregion
+} //#endregion
 //#region src/path-encoding.d.ts
 /**
 * Encode a stream path to a filesystem-safe directory name using base64url encoding.

package/dist/index.d.ts

@@ -159,6 +159,15 @@ declare class StreamStore {
   private streams;
   private pendingLongPolls;
   /**
+  * Check if a stream is expired based on TTL or Expires-At.
+  */
+  private isExpired;
+  /**
+  * Get a stream, deleting it if expired.
+  * Returns undefined if stream doesn't exist or is expired.
+  */
+  private getIfNotExpired;
+  /**
   * Create a new stream.
   * @throws Error if stream already exists with different config
   * @returns existing stream if config matches (idempotent)
@@ -171,10 +180,11 @@ declare class StreamStore {
   }): Stream;
   /**
   * Get a stream by path.
+  * Returns undefined if stream doesn't exist or is expired.
   */
   get(path: string): Stream | undefined;
   /**
-  * Check if a stream exists.
+  * Check if a stream exists (and is not expired).
   */
   has(path: string): boolean;
   /**
@@ -183,7 +193,7 @@ declare class StreamStore {
   delete(path: string): boolean;
   /**
   * Append data to a stream.
-  * @throws Error if stream doesn't exist
+  * @throws Error if stream doesn't exist or is expired
   * @throws Error if seq is lower than lastSeq
   * @throws Error if JSON mode and array is empty
   */
@@ -193,6 +203,7 @@ declare class StreamStore {
   }): StreamMessage;
   /**
   * Read messages from a stream starting at the given offset.
+  * @throws Error if stream doesn't exist or is expired
   */
   read(path: string, offset?: string): {
     messages: Array<StreamMessage>;
@@ -201,10 +212,12 @@ declare class StreamStore {
   /**
   * Format messages for response.
   * For JSON mode, wraps concatenated data in array brackets.
+  * @throws Error if stream doesn't exist or is expired
   */
   formatResponse(path: string, messages: Array<StreamMessage>): Uint8Array;
   /**
   * Wait for new messages (long-poll).
+  * @throws Error if stream doesn't exist or is expired
   */
   waitForMessages(path: string, offset: string, timeoutMs: number): Promise<{
     messages: Array<StreamMessage>;
@@ -212,6 +225,7 @@ declare class StreamStore {
   }>;
   /**
   * Get the current offset for a stream.
+  * Returns undefined if stream doesn't exist or is expired.
   */
   getCurrentOffset(path: string): string | undefined;
   /**
@@ -263,6 +277,15 @@ declare class FileBackedStreamStore {
   */
   private streamMetaToStream;
   /**
+  * Check if a stream is expired based on TTL or Expires-At.
+  */
+  private isExpired;
+  /**
+  * Get stream metadata, deleting it if expired.
+  * Returns undefined if stream doesn't exist or is expired.
+  */
+  private getMetaIfNotExpired;
+  /**
   * Close the store, closing all file handles and database.
   * All data is already fsynced on each append, so no final flush needed.
   */
@@ -292,6 +315,7 @@ declare class FileBackedStreamStore {
   /**
   * Format messages for response.
   * For JSON mode, wraps concatenated data in array brackets.
+  * @throws Error if stream doesn't exist or is expired
   */
   formatResponse(streamPath: string, messages: Array<StreamMessage>): Uint8Array;
   getCurrentOffset(streamPath: string): string | undefined;
@@ -308,6 +332,36 @@ declare class FileBackedStreamStore {
 
 //#endregion
 //#region src/server.d.ts
+/**
+* HTTP server for testing durable streams.
+* Supports both in-memory and file-backed storage modes.
+*/
+/**
+* Configuration for injected faults (for testing retry/resilience).
+* Supports various fault types beyond simple HTTP errors.
+*/
+interface InjectedFault {
+  /** HTTP status code to return (if set, returns error response) */
+  status?: number;
+  /** Number of times to trigger this fault (decremented on each use) */
+  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;
+}
 declare class DurableStreamTestServer {
   readonly store: StreamStore | FileBackedStreamStore;
   private server;
@@ -315,8 +369,8 @@ declare class DurableStreamTestServer {
   private _url;
   private activeSSEResponses;
   private isShuttingDown;
-  /** Injected errors for testing retry/resilience */
-  private injectedErrors;
+  /** Injected faults for testing retry/resilience */
+  private injectedFaults;
   constructor(options?: TestServerOptions);
   /**
   * Start the server.
@@ -337,17 +391,34 @@ declare class DurableStreamTestServer {
   /**
   * Inject an error to be returned on the next N requests to a path.
   * Used for testing retry/resilience behavior.
+  * @deprecated Use injectFault for full fault injection capabilities
   */
   injectError(path: string, status: number, count?: number, retryAfter?: number): void;
   /**
-  * Clear all injected errors.
+  * Inject a fault to be triggered on the next N requests to a path.
+  * Supports various fault types: delays, connection drops, body corruption, etc.
+  */
+  injectFault(path: string, fault: Omit<InjectedFault, `count`> & {
+    count?: number;
+  }): void;
+  /**
+  * Clear all injected faults.
   */
-  clearInjectedErrors(): void;
+  clearInjectedFaults(): void;
   /**
-  * Check if there's an injected error for this path and consume it.
-  * Returns the error config if one should be returned, null otherwise.
+  * Check if there's an injected fault for this path/method and consume it.
+  * Returns the fault config if one should be triggered, null otherwise.
   */
-  private consumeInjectedError;
+  private consumeInjectedFault;
+  /**
+  * Apply delay from fault config (including jitter).
+  */
+  private applyFaultDelay;
+  /**
+  * Apply body modifications from stored fault (truncation, corruption).
+  * Returns modified body, or original if no modifications needed.
+  */
+  private applyFaultBodyModification;
   private handleRequest;
   /**
   * Handle PUT - create stream
@@ -380,9 +451,7 @@ declare class DurableStreamTestServer {
   */
   private handleTestInjectError;
   private readBody;
-}
-
-//#endregion
+} //#endregion
 //#region src/path-encoding.d.ts
 /**
 * Encode a stream path to a filesystem-safe directory name using base64url encoding.