@gurezo/web-serial-rxjs 0.1.0 → 0.1.3

package/dist/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/client/serial-client.ts", "../src/errors/serial-error-code.ts", "../src/errors/serial-error.ts", "../src/browser/browser-detection.ts", "../src/browser/browser-support.ts", "../src/filters/build-request-options.ts", "../src/io/observable-to-writable.ts", "../src/io/readable-to-observable.ts", "../src/types/options.ts", "../src/client/index.ts"],
+  "sourcesContent": ["import { Observable, defer, switchMap } from 'rxjs';\nimport { checkBrowserSupport } from '../browser/browser-support';\nimport { SerialError, SerialErrorCode } from '../errors/serial-error';\nimport { buildRequestOptions } from '../filters/build-request-options';\nimport { subscribeToWritable } from '../io/observable-to-writable';\nimport { readableToObservable } from '../io/readable-to-observable';\nimport {\n  DEFAULT_SERIAL_CLIENT_OPTIONS,\n  SerialClientOptions,\n} from '../types/options';\n\n/**\n * Internal implementation of SerialClient interface.\n *\n * This class implements the {@link SerialClient} interface and provides the actual\n * functionality for serial port communication. Users should not instantiate this class\n * directly; instead, use {@link createSerialClient} to create a SerialClient instance.\n *\n * @internal\n */\nexport class SerialClientImpl {\n  /** @internal */\n  private port: SerialPort | null = null;\n  /** @internal */\n  private isOpen = false;\n  /** @internal */\n  private readSubscription: { unsubscribe: () => void } | null = null;\n  /** @internal */\n  private writeSubscription: { unsubscribe: () => void } | null = null;\n  /** @internal */\n  private readonly options: Required<Omit<SerialClientOptions, 'filters'>> & {\n    filters?: SerialClientOptions['filters'];\n  };\n\n  /**\n   * Creates a new SerialClientImpl instance.\n   *\n   * @param options - Optional configuration options for the serial port connection\n   * @throws {@link SerialError} with code {@link SerialErrorCode.BROWSER_NOT_SUPPORTED} if the browser doesn't support Web Serial API\n   * @internal\n   */\n  constructor(options?: SerialClientOptions) {\n    checkBrowserSupport();\n    this.options = {\n      ...DEFAULT_SERIAL_CLIENT_OPTIONS,\n      ...options,\n      filters: options?.filters,\n    };\n  }\n\n  /**\n   * Request a serial port from the user.\n   *\n   * @returns Observable that emits the selected SerialPort\n   * @internal\n   */\n  requestPort(): Observable<SerialPort> {\n    return defer(() => {\n      checkBrowserSupport();\n\n      return navigator.serial\n        .requestPort(buildRequestOptions(this.options))\n        .catch((error) => {\n          if (error instanceof DOMException && error.name === 'NotFoundError') {\n            throw new SerialError(\n              SerialErrorCode.OPERATION_CANCELLED,\n              'Port selection was cancelled by the user',\n              error,\n            );\n          }\n          throw new SerialError(\n            SerialErrorCode.PORT_NOT_AVAILABLE,\n            `Failed to request port: ${error instanceof Error ? error.message : String(error)}`,\n            error instanceof Error ? error : new Error(String(error)),\n          );\n        });\n    });\n  }\n\n  /**\n   * Get available serial ports.\n   *\n   * @returns Observable that emits an array of available SerialPorts\n   * @internal\n   */\n  getPorts(): Observable<SerialPort[]> {\n    return defer(() => {\n      checkBrowserSupport();\n\n      return navigator.serial.getPorts().catch((error) => {\n        throw new SerialError(\n          SerialErrorCode.PORT_NOT_AVAILABLE,\n          `Failed to get ports: ${error instanceof Error ? error.message : String(error)}`,\n          error instanceof Error ? error : new Error(String(error)),\n        );\n      });\n    });\n  }\n\n  /**\n   * Connect to a serial port.\n   *\n   * @param port - Optional SerialPort to connect to. If not provided, will request one.\n   * @returns Observable that completes when the port is opened\n   * @internal\n   */\n  connect(port?: SerialPort): Observable<void> {\n    checkBrowserSupport();\n\n    if (this.isOpen) {\n      return new Observable<void>((subscriber) => {\n        subscriber.error(\n          new SerialError(\n            SerialErrorCode.PORT_ALREADY_OPEN,\n            'Port is already open',\n          ),\n        );\n      });\n    }\n\n    const port$ = port\n      ? new Observable<SerialPort>((subscriber) => {\n          subscriber.next(port);\n          subscriber.complete();\n        })\n      : this.requestPort();\n\n    return port$.pipe(\n      switchMap((selectedPort) => {\n        return defer(() => {\n          this.port = selectedPort;\n\n          return this.port\n            .open({\n              baudRate: this.options.baudRate,\n              dataBits: this.options.dataBits,\n              stopBits: this.options.stopBits,\n              parity: this.options.parity,\n              bufferSize: this.options.bufferSize,\n              flowControl: this.options.flowControl,\n            })\n            .then(() => {\n              this.isOpen = true;\n            })\n            .catch((error) => {\n              this.port = null;\n              this.isOpen = false;\n\n              if (error instanceof SerialError) {\n                throw error;\n              }\n\n              throw new SerialError(\n                SerialErrorCode.PORT_OPEN_FAILED,\n                `Failed to open port: ${error instanceof Error ? error.message : String(error)}`,\n                error instanceof Error ? error : new Error(String(error)),\n              );\n            });\n        });\n      }),\n    );\n  }\n\n  /**\n   * Disconnect from the serial port.\n   *\n   * @returns Observable that completes when the port is closed\n   * @internal\n   */\n  disconnect(): Observable<void> {\n    return defer(() => {\n      if (!this.isOpen || !this.port) {\n        return Promise.resolve();\n      }\n\n      // Unsubscribe from read/write streams\n      if (this.readSubscription) {\n        this.readSubscription.unsubscribe();\n        this.readSubscription = null;\n      }\n\n      if (this.writeSubscription) {\n        this.writeSubscription.unsubscribe();\n        this.writeSubscription = null;\n      }\n\n      // Close the port\n      return this.port\n        .close()\n        .then(() => {\n          this.port = null;\n          this.isOpen = false;\n        })\n        .catch((error) => {\n          this.port = null;\n          this.isOpen = false;\n\n          throw new SerialError(\n            SerialErrorCode.CONNECTION_LOST,\n            `Failed to close port: ${error instanceof Error ? error.message : String(error)}`,\n            error instanceof Error ? error : new Error(String(error)),\n          );\n        });\n    });\n  }\n\n  /**\n   * Get an Observable that emits data read from the serial port.\n   *\n   * @returns Observable that emits Uint8Array chunks\n   * @internal\n   */\n  getReadStream(): Observable<Uint8Array> {\n    if (!this.isOpen || !this.port || !this.port.readable) {\n      throw new SerialError(\n        SerialErrorCode.PORT_NOT_OPEN,\n        'Port is not open or readable stream is not available',\n      );\n    }\n\n    return readableToObservable(this.port.readable);\n  }\n\n  /**\n   * Write data to the serial port from an Observable.\n   *\n   * @param data$ - Observable that emits Uint8Array chunks to write\n   * @returns Observable that completes when writing is finished\n   * @internal\n   */\n  writeStream(data$: Observable<Uint8Array>): Observable<void> {\n    if (!this.isOpen || !this.port || !this.port.writable) {\n      throw new SerialError(\n        SerialErrorCode.PORT_NOT_OPEN,\n        'Port is not open or writable stream is not available',\n      );\n    }\n\n    // Cancel previous write subscription if exists\n    if (this.writeSubscription) {\n      this.writeSubscription.unsubscribe();\n    }\n\n    this.writeSubscription = subscribeToWritable(data$, this.port.writable);\n\n    return new Observable<void>((subscriber) => {\n      // The subscription is already active, we just need to track completion\n      if (!this.writeSubscription) {\n        subscriber.error(\n          new SerialError(\n            SerialErrorCode.WRITE_FAILED,\n            'Write subscription is not available',\n          ),\n        );\n        return;\n      }\n      const originalUnsubscribe = this.writeSubscription.unsubscribe;\n\n      this.writeSubscription = {\n        unsubscribe: () => {\n          originalUnsubscribe();\n          subscriber.complete();\n        },\n      };\n\n      // If the observable completes, complete the subscriber\n      data$.subscribe({\n        complete: () => {\n          if (this.writeSubscription) {\n            this.writeSubscription.unsubscribe();\n            this.writeSubscription = null;\n          }\n          subscriber.complete();\n        },\n        error: (error) => {\n          if (this.writeSubscription) {\n            this.writeSubscription.unsubscribe();\n            this.writeSubscription = null;\n          }\n          subscriber.error(error);\n        },\n      });\n    });\n  }\n\n  /**\n   * Write a single chunk of data to the serial port.\n   *\n   * @param data - Data to write\n   * @returns Observable that completes when the data is written\n   * @internal\n   */\n  write(data: Uint8Array): Observable<void> {\n    return defer(() => {\n      if (!this.isOpen || !this.port || !this.port.writable) {\n        throw new SerialError(\n          SerialErrorCode.PORT_NOT_OPEN,\n          'Port is not open or writable stream is not available',\n        );\n      }\n\n      const writer = this.port.writable.getWriter();\n      return writer\n        .write(data)\n        .then(() => {\n          writer.releaseLock();\n        })\n        .catch((error) => {\n          writer.releaseLock();\n          throw new SerialError(\n            SerialErrorCode.WRITE_FAILED,\n            `Failed to write data: ${error instanceof Error ? error.message : String(error)}`,\n            error instanceof Error ? error : new Error(String(error)),\n          );\n        });\n    });\n  }\n\n  /**\n   * Check if the port is currently open.\n   *\n   * @returns `true` if a port is currently open, `false` otherwise\n   * @internal\n   */\n  get connected(): boolean {\n    return this.isOpen;\n  }\n\n  /**\n   * Get the current SerialPort instance.\n   *\n   * @returns The current SerialPort instance, or `null` if no port is open\n   * @internal\n   */\n  get currentPort(): SerialPort | null {\n    return this.port;\n  }\n}\n", "/**\n * Error codes for serial port operations.\n *\n * These codes identify specific error conditions that can occur when working with\n * serial ports. Each error code corresponds to a specific failure scenario, making\n * it easier to handle errors programmatically.\n *\n * @example\n * ```typescript\n * try {\n *   await client.connect().toPromise();\n * } catch (error) {\n *   if (error instanceof SerialError) {\n *     switch (error.code) {\n *       case SerialErrorCode.BROWSER_NOT_SUPPORTED:\n *         console.error('Please use a Chromium-based browser');\n *         break;\n *       case SerialErrorCode.OPERATION_CANCELLED:\n *         console.log('User cancelled port selection');\n *         break;\n *       // ... handle other error codes\n *     }\n *   }\n * }\n * ```\n */\nexport enum SerialErrorCode {\n  /**\n   * Browser does not support the Web Serial API.\n   *\n   * This error occurs when attempting to use serial port functionality in a browser\n   * that doesn't support the Web Serial API. Only Chromium-based browsers (Chrome,\n   * Edge, Opera) support this API.\n   *\n   * **Suggested action**: Inform the user to use a supported browser.\n   */\n  BROWSER_NOT_SUPPORTED = 'BROWSER_NOT_SUPPORTED',\n\n  /**\n   * Serial port is not available.\n   *\n   * This error occurs when a requested port cannot be accessed, such as when\n   * getting previously granted ports fails or when the port is already in use\n   * by another application.\n   *\n   * **Suggested action**: Check if the port is available or being used by another application.\n   */\n  PORT_NOT_AVAILABLE = 'PORT_NOT_AVAILABLE',\n\n  /**\n   * Failed to open the serial port.\n   *\n   * This error occurs when the port cannot be opened, typically due to incorrect\n   * connection parameters, hardware issues, or permission problems.\n   *\n   * **Suggested action**: Verify connection parameters and check hardware connections.\n   */\n  PORT_OPEN_FAILED = 'PORT_OPEN_FAILED',\n\n  /**\n   * Serial port is already open.\n   *\n   * This error occurs when attempting to open a port that is already connected.\n   * Only one connection can be active at a time per SerialClient instance.\n   *\n   * **Suggested action**: Disconnect the current port before connecting a new one.\n   */\n  PORT_ALREADY_OPEN = 'PORT_ALREADY_OPEN',\n\n  /**\n   * Serial port is not open.\n   *\n   * This error occurs when attempting to read from or write to a port that hasn't\n   * been opened yet. The port must be connected before performing I/O operations.\n   *\n   * **Suggested action**: Call {@link SerialClient.connect} before reading or writing.\n   */\n  PORT_NOT_OPEN = 'PORT_NOT_OPEN',\n\n  /**\n   * Failed to read from the serial port.\n   *\n   * This error occurs when reading data from the port fails, typically due to\n   * connection loss, hardware issues, or stream errors.\n   *\n   * **Suggested action**: Check the connection and hardware, then retry the read operation.\n   */\n  READ_FAILED = 'READ_FAILED',\n\n  /**\n   * Failed to write to the serial port.\n   *\n   * This error occurs when writing data to the port fails, typically due to\n   * connection loss, hardware issues, or stream errors.\n   *\n   * **Suggested action**: Check the connection and hardware, then retry the write operation.\n   */\n  WRITE_FAILED = 'WRITE_FAILED',\n\n  /**\n   * Serial port connection was lost.\n   *\n   * This error occurs when the connection to the serial port is unexpectedly\n   * terminated, such as when the device is disconnected or the port is closed\n   * by another process.\n   *\n   * **Suggested action**: Check the physical connection and reconnect if needed.\n   */\n  CONNECTION_LOST = 'CONNECTION_LOST',\n\n  /**\n   * Invalid filter options provided.\n   *\n   * This error occurs when port filter options are invalid, such as when\n   * filter values are out of range or missing required fields.\n   *\n   * **Suggested action**: Verify filter options match the expected format and value ranges.\n   */\n  INVALID_FILTER_OPTIONS = 'INVALID_FILTER_OPTIONS',\n\n  /**\n   * Operation was cancelled by the user.\n   *\n   * This error occurs when the user cancels a port selection dialog or aborts\n   * an operation before it completes.\n   *\n   * **Suggested action**: This is a normal condition - no action required, but you may want\n   * to inform the user that the operation was cancelled.\n   */\n  OPERATION_CANCELLED = 'OPERATION_CANCELLED',\n\n  /**\n   * Unknown error occurred.\n   *\n   * This error code is used for errors that don't fit into any other category.\n   * The original error details may be available in the error's message or originalError property.\n   *\n   * **Suggested action**: Check the error message and originalError for more details.\n   */\n  UNKNOWN = 'UNKNOWN',\n}\n", "import { SerialErrorCode } from './serial-error-code';\n\n// Re-export SerialErrorCode for convenience\nexport { SerialErrorCode };\n\n/**\n * Custom error class for serial port operations.\n *\n * This error class extends the standard Error class and includes additional information\n * about the type of error that occurred. It provides an error code for programmatic\n * error handling and may include the original error that caused the failure.\n *\n * @example\n * ```typescript\n * try {\n *   await client.connect().toPromise();\n * } catch (error) {\n *   if (error instanceof SerialError) {\n *     console.error(`Error code: ${error.code}`);\n *     console.error(`Message: ${error.message}`);\n *     if (error.originalError) {\n *       console.error(`Original error:`, error.originalError);\n *     }\n *\n *     // Check specific error code\n *     if (error.is(SerialErrorCode.BROWSER_NOT_SUPPORTED)) {\n *       // Handle browser not supported\n *     }\n *   }\n * }\n * ```\n */\nexport class SerialError extends Error {\n  /**\n   * The error code identifying the type of error that occurred.\n   *\n   * Use this code to programmatically handle specific error conditions.\n   *\n   * @see {@link SerialErrorCode} for all available error codes\n   */\n  public readonly code: SerialErrorCode;\n\n  /**\n   * The original error that caused this SerialError, if available.\n   *\n   * This property contains the underlying error (e.g., DOMException, TypeError)\n   * that was wrapped in this SerialError. It may be undefined if no original error exists.\n   */\n  public readonly originalError?: Error;\n\n  /**\n   * Creates a new SerialError instance.\n   *\n   * @param code - The error code identifying the type of error\n   * @param message - A human-readable error message\n   * @param originalError - The original error that caused this SerialError, if any\n   */\n  constructor(code: SerialErrorCode, message: string, originalError?: Error) {\n    super(message);\n    this.name = 'SerialError';\n    this.code = code;\n    this.originalError = originalError;\n\n    // Maintains proper stack trace for where our error was thrown (only available on V8)\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    if ((Error as any).captureStackTrace) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      (Error as any).captureStackTrace(this, SerialError);\n    }\n  }\n\n  /**\n   * Check if the error matches a specific error code.\n   *\n   * This is a convenience method for checking the error code without directly\n   * comparing the code property.\n   *\n   * @param code - The error code to check against\n   * @returns `true` if this error's code matches the provided code, `false` otherwise\n   *\n   * @example\n   * ```typescript\n   * if (error.is(SerialErrorCode.PORT_NOT_OPEN)) {\n   *   // Handle port not open error\n   * }\n   * ```\n   */\n  public is(code: SerialErrorCode): boolean {\n    return this.code === code;\n  }\n}\n", "/**\n * Browser type enumeration for identifying the browser environment.\n *\n * This enum is used to identify the specific browser type, which is useful for\n * browser-specific behavior or error messages.\n *\n * @example\n * ```typescript\n * const browserType = detectBrowserType();\n * if (browserType === BrowserType.CHROME) {\n *   console.log('Running in Chrome');\n * }\n * ```\n */\nexport enum BrowserType {\n  /** Google Chrome browser */\n  CHROME = 'chrome',\n  /** Microsoft Edge browser */\n  EDGE = 'edge',\n  /** Opera browser */\n  OPERA = 'opera',\n  /** Unknown or unsupported browser */\n  UNKNOWN = 'unknown',\n}\n\n/**\n * Feature detection for Web Serial API.\n *\n * Checks if the browser supports the Web Serial API by verifying the presence\n * of `navigator.serial`. This is a non-throwing check that returns `false` if\n * the API is not available.\n *\n * Note: This function only checks for API availability, not whether the browser\n * type is supported. For a throwing check that provides better error messages,\n * use {@link checkBrowserSupport}.\n *\n * @returns `true` if the Web Serial API is available, `false` otherwise\n *\n * @example\n * ```typescript\n * if (hasWebSerialSupport()) {\n *   // Safe to use serial port functionality\n *   const client = createSerialClient();\n * } else {\n *   console.error('Web Serial API is not supported');\n * }\n * ```\n *\n * @see {@link checkBrowserSupport} for a throwing version with better error messages\n * @see {@link isBrowserSupported} for an alias to this function\n */\nexport function hasWebSerialSupport(): boolean {\n  return (\n    typeof navigator !== 'undefined' &&\n    'serial' in navigator &&\n    navigator.serial !== undefined &&\n    navigator.serial !== null\n  );\n}\n\n/**\n * Detect browser type from the user agent string.\n *\n * Analyzes the browser's user agent string to identify the browser type.\n * This function is useful for providing browser-specific functionality or\n * error messages.\n *\n * @returns The detected {@link BrowserType}, or {@link BrowserType.UNKNOWN} if the browser cannot be identified\n *\n * @example\n * ```typescript\n * const browserType = detectBrowserType();\n * switch (browserType) {\n *   case BrowserType.CHROME:\n *     console.log('Running in Chrome');\n *     break;\n *   case BrowserType.EDGE:\n *     console.log('Running in Edge');\n *     break;\n *   case BrowserType.OPERA:\n *     console.log('Running in Opera');\n *     break;\n *   default:\n *     console.log('Unknown browser');\n * }\n * ```\n *\n * @see {@link isChromiumBased} for checking if the browser is Chromium-based\n */\nexport function detectBrowserType(): BrowserType {\n  if (typeof navigator === 'undefined' || !navigator.userAgent) {\n    return BrowserType.UNKNOWN;\n  }\n\n  const ua = navigator.userAgent.toLowerCase();\n\n  if (ua.includes('edg/')) {\n    return BrowserType.EDGE;\n  }\n\n  if (ua.includes('opr/') || ua.includes('opera/')) {\n    return BrowserType.OPERA;\n  }\n\n  if (ua.includes('chrome/')) {\n    return BrowserType.CHROME;\n  }\n\n  return BrowserType.UNKNOWN;\n}\n\n/**\n * Check if the browser is Chromium-based.\n *\n * Determines if the current browser is based on Chromium, which includes\n * Chrome, Edge, and Opera. These browsers support the Web Serial API.\n *\n * @returns `true` if the browser is Chromium-based (Chrome, Edge, or Opera), `false` otherwise\n *\n * @example\n * ```typescript\n * if (isChromiumBased()) {\n *   // Browser supports Web Serial API\n *   const client = createSerialClient();\n * } else {\n *   console.error('Please use a Chromium-based browser (Chrome, Edge, or Opera)');\n * }\n * ```\n *\n * @see {@link detectBrowserType} for identifying the specific browser type\n * @see {@link hasWebSerialSupport} for checking Web Serial API availability\n */\nexport function isChromiumBased(): boolean {\n  const browserType = detectBrowserType();\n  return (\n    browserType === BrowserType.CHROME ||\n    browserType === BrowserType.EDGE ||\n    browserType === BrowserType.OPERA\n  );\n}\n", "import { SerialError, SerialErrorCode } from '../errors/serial-error';\nimport {\n  BrowserType,\n  detectBrowserType,\n  hasWebSerialSupport,\n} from './browser-detection';\n\n/**\n * Check if the browser supports the Web Serial API, throwing an error if not supported.\n *\n * This function performs a feature detection check and throws a {@link SerialError}\n * with code {@link SerialErrorCode.BROWSER_NOT_SUPPORTED} if the Web Serial API\n * is not available. The error message includes the detected browser type for better\n * user feedback.\n *\n * This is the recommended way to check browser support before using serial port\n * functionality, as it provides clear error messages.\n *\n * @throws {@link SerialError} with code {@link SerialErrorCode.BROWSER_NOT_SUPPORTED}\n *         if the browser doesn't support the Web Serial API\n *\n * @example\n * ```typescript\n * try {\n *   checkBrowserSupport();\n *   // Safe to use serial port functionality\n *   const client = createSerialClient();\n * } catch (error) {\n *   if (error instanceof SerialError && error.code === SerialErrorCode.BROWSER_NOT_SUPPORTED) {\n *     console.error(error.message);\n *     // Show user-friendly message: \"Please use a Chromium-based browser...\"\n *   }\n * }\n * ```\n *\n * @see {@link isBrowserSupported} for a non-throwing version that returns a boolean\n * @see {@link hasWebSerialSupport} for the underlying feature detection function\n */\nexport function checkBrowserSupport(): void {\n  if (!hasWebSerialSupport()) {\n    const browserType = detectBrowserType();\n    const browserName =\n      browserType === BrowserType.UNKNOWN\n        ? 'your browser'\n        : browserType.toUpperCase();\n\n    throw new SerialError(\n      SerialErrorCode.BROWSER_NOT_SUPPORTED,\n      `Web Serial API is not supported in ${browserName}. Please use a Chromium-based browser (Chrome, Edge, or Opera).`,\n    );\n  }\n}\n\n/**\n * Check if the browser supports the Web Serial API (non-throwing version).\n *\n * This is a convenience function that returns a boolean indicating whether\n * the Web Serial API is available. Unlike {@link checkBrowserSupport}, this\n * function does not throw an error if the API is not available.\n *\n * @returns `true` if the Web Serial API is supported, `false` otherwise\n *\n * @example\n * ```typescript\n * if (isBrowserSupported()) {\n *   const client = createSerialClient();\n *   // Use serial port functionality\n * } else {\n *   console.error('Web Serial API is not supported in this browser');\n *   // Show fallback UI or message\n * }\n * ```\n *\n * @see {@link checkBrowserSupport} for a throwing version with better error messages\n * @see {@link hasWebSerialSupport} which this function calls internally\n */\nexport function isBrowserSupported(): boolean {\n  return hasWebSerialSupport();\n}\n", "import { SerialError, SerialErrorCode } from '../errors/serial-error';\nimport { SerialClientOptions } from '../types/options';\n\n/**\n * Build SerialPortRequestOptions from SerialClientOptions.\n *\n * This utility function converts filter options from {@link SerialClientOptions} into\n * the format expected by the Web Serial API's `navigator.serial.requestPort()` method.\n * It validates the filter options to ensure they are valid before returning them.\n *\n * If no filters are provided in the options, this function returns `undefined`, which\n * allows the port selection dialog to show all available ports.\n *\n * @param options - Optional SerialClientOptions containing filter configuration\n * @returns SerialPortRequestOptions object with validated filters, or `undefined` if no filters are provided\n * @throws {@link SerialError} with code {@link SerialErrorCode.INVALID_FILTER_OPTIONS} if filter validation fails\n *\n * @example\n * ```typescript\n * // With filters\n * const options = {\n *   baudRate: 9600,\n *   filters: [\n *     { usbVendorId: 0x1234 },\n *     { usbVendorId: 0x5678, usbProductId: 0x9abc },\n *   ],\n * };\n * const requestOptions = buildRequestOptions(options);\n * // Returns: { filters: [...] }\n *\n * // Without filters\n * const requestOptions = buildRequestOptions({ baudRate: 9600 });\n * // Returns: undefined\n *\n * // Invalid filter (will throw)\n * try {\n *   buildRequestOptions({ filters: [{ usbVendorId: -1 }] });\n * } catch (error) {\n *   // SerialError with code INVALID_FILTER_OPTIONS\n * }\n * ```\n */\nexport function buildRequestOptions(\n  options?: SerialClientOptions,\n): SerialPortRequestOptions | undefined {\n  if (!options || !options.filters || options.filters.length === 0) {\n    return undefined;\n  }\n\n  // Validate filters\n  for (const filter of options.filters) {\n    if (!filter.usbVendorId && !filter.usbProductId) {\n      throw new SerialError(\n        SerialErrorCode.INVALID_FILTER_OPTIONS,\n        'Filter must have at least usbVendorId or usbProductId',\n      );\n    }\n\n    if (filter.usbVendorId !== undefined) {\n      if (\n        !Number.isInteger(filter.usbVendorId) ||\n        filter.usbVendorId < 0 ||\n        filter.usbVendorId > 0xffff\n      ) {\n        throw new SerialError(\n          SerialErrorCode.INVALID_FILTER_OPTIONS,\n          `Invalid usbVendorId: ${filter.usbVendorId}. Must be an integer between 0 and 65535.`,\n        );\n      }\n    }\n\n    if (filter.usbProductId !== undefined) {\n      if (\n        !Number.isInteger(filter.usbProductId) ||\n        filter.usbProductId < 0 ||\n        filter.usbProductId > 0xffff\n      ) {\n        throw new SerialError(\n          SerialErrorCode.INVALID_FILTER_OPTIONS,\n          `Invalid usbProductId: ${filter.usbProductId}. Must be an integer between 0 and 65535.`,\n        );\n      }\n    }\n  }\n\n  return {\n    filters: options.filters,\n  };\n}\n", "import { Observable } from 'rxjs';\nimport { SerialError, SerialErrorCode } from '../errors/serial-error';\n\n/**\n * Convert an RxJS Observable to a WritableStream.\n *\n * This utility function converts an RxJS Observable into a Web Streams API WritableStream.\n * Values emitted by the Observable will be written to the returned WritableStream. The stream\n * will close when the Observable completes or abort if the Observable errors.\n *\n * Note: This function creates a new WritableStream. For directly subscribing to an Observable\n * and writing to an existing WritableStream, use {@link subscribeToWritable} instead.\n *\n * @param observable - The Observable to convert to a WritableStream\n * @returns A WritableStream that writes Uint8Array chunks emitted by the Observable\n *\n * @example\n * ```typescript\n * const data$ = from([\n *   new TextEncoder().encode('Hello'),\n *   new TextEncoder().encode('World'),\n * ]);\n *\n * const writableStream = observableToWritable(data$);\n * // Use the writable stream with other Web Streams APIs\n * ```\n */\nexport function observableToWritable(\n  observable: Observable<Uint8Array>,\n): WritableStream<Uint8Array> {\n  let writer: WritableStreamDefaultWriter<Uint8Array> | null = null;\n  let subscription: { unsubscribe: () => void } | null = null;\n  let stream: WritableStream<Uint8Array> | null = null;\n\n  stream = new WritableStream<Uint8Array>({\n    async start() {\n      if (!stream) {\n        return;\n      }\n      writer = stream.getWriter();\n\n      subscription = observable.subscribe({\n        next: async (chunk) => {\n          if (writer) {\n            try {\n              await writer.write(chunk);\n            } catch (error) {\n              subscription?.unsubscribe();\n              if (writer) {\n                writer.releaseLock();\n              }\n              throw error;\n            }\n          }\n        },\n        error: async (error) => {\n          if (writer) {\n            try {\n              await writer.abort(error);\n            } catch {\n              // Ignore abort errors\n            } finally {\n              writer.releaseLock();\n              writer = null;\n            }\n          }\n        },\n        complete: async () => {\n          if (writer) {\n            try {\n              await writer.close();\n            } catch {\n              // Ignore close errors\n            } finally {\n              writer.releaseLock();\n              writer = null;\n            }\n          }\n        },\n      });\n    },\n\n    abort(reason) {\n      if (subscription) {\n        subscription.unsubscribe();\n        subscription = null;\n      }\n      if (writer) {\n        writer.abort(reason).catch(() => {\n          // Ignore abort errors\n        });\n        writer.releaseLock();\n        writer = null;\n      }\n    },\n  });\n\n  return stream;\n}\n\n/**\n * Subscribe to an Observable and write its values to a WritableStream.\n *\n * This utility function subscribes to an RxJS Observable and writes all emitted values\n * to the provided WritableStream. This is commonly used to write Observable data to a\n * serial port's writable stream.\n *\n * The function returns a subscription object that can be used to unsubscribe and clean up.\n * When unsubscribed, the writer lock will be released properly.\n *\n * @param observable - The Observable to subscribe to and read data from\n * @param stream - The WritableStream to write data to\n * @returns A subscription object with an `unsubscribe` method for cleanup\n * @throws {@link SerialError} with code {@link SerialErrorCode.WRITE_FAILED} if writing to the stream fails\n *\n * @example\n * ```typescript\n * const data$ = from([\n *   new TextEncoder().encode('Hello'),\n *   new TextEncoder().encode('World'),\n * ]);\n *\n * const subscription = subscribeToWritable(data$, port.writable);\n *\n * // Later, to cancel and clean up:\n * subscription.unsubscribe();\n *\n * // Use with RxJS operators\n * const processedData$ = of('Hello, Serial!').pipe(\n *   map((text) => new TextEncoder().encode(text))\n * );\n *\n * subscribeToWritable(processedData$, port.writable);\n * ```\n */\nexport function subscribeToWritable(\n  observable: Observable<Uint8Array>,\n  stream: WritableStream<Uint8Array>,\n): { unsubscribe: () => void } {\n  const writer = stream.getWriter();\n\n  // Define error handler separately so we can call it directly\n  const errorHandler = async (error: unknown) => {\n    try {\n      await writer.abort(error);\n    } catch {\n      // Ignore abort errors\n    } finally {\n      writer.releaseLock();\n    }\n  };\n\n  const subscription = observable.subscribe({\n    next: async (chunk) => {\n      try {\n        await writer.write(chunk);\n      } catch (error) {\n        subscription.unsubscribe();\n        writer.releaseLock();\n        // Convert write error to SerialError and pass to error handler\n        const serialError = new SerialError(\n          SerialErrorCode.WRITE_FAILED,\n          `Failed to write to stream: ${error instanceof Error ? error.message : String(error)}`,\n          error instanceof Error ? error : new Error(String(error)),\n        );\n        // Manually trigger error handler to avoid unhandled rejection\n        await errorHandler(serialError);\n      }\n    },\n    error: errorHandler,\n    complete: async () => {\n      try {\n        await writer.close();\n      } catch {\n        // Ignore close errors\n      } finally {\n        writer.releaseLock();\n      }\n    },\n  });\n\n  return {\n    unsubscribe: () => {\n      subscription.unsubscribe();\n      writer.releaseLock();\n    },\n  };\n}\n", "import { Observable } from 'rxjs';\nimport { SerialError, SerialErrorCode } from '../errors/serial-error';\n\n/**\n * Convert a ReadableStream to an RxJS Observable.\n *\n * This utility function converts a Web Streams API ReadableStream into an RxJS Observable,\n * allowing you to use RxJS operators with stream data. The Observable will emit Uint8Array\n * chunks as they are read from the stream, complete when the stream ends, or error if\n * the stream encounters an error.\n *\n * The returned Observable handles stream cleanup automatically - if you unsubscribe before\n * the stream completes, the reader lock will be released properly.\n *\n * @param stream - The ReadableStream to convert to an Observable\n * @returns An Observable that emits Uint8Array chunks from the stream\n * @throws {@link SerialError} with code {@link SerialErrorCode.READ_FAILED} if reading from the stream fails\n *\n * @example\n * ```typescript\n * // Convert a serial port's readable stream to an Observable\n * const readable$ = readableToObservable(port.readable);\n *\n * readable$.subscribe({\n *   next: (chunk) => {\n *     console.log('Received chunk:', chunk);\n *   },\n *   complete: () => {\n *     console.log('Stream completed');\n *   },\n *   error: (error) => {\n *     console.error('Stream error:', error);\n *   },\n * });\n *\n * // Use with RxJS operators\n * readableToObservable(port.readable)\n *   .pipe(\n *     map((chunk) => new TextDecoder().decode(chunk)),\n *     filter((text) => text.includes('OK'))\n *   )\n *   .subscribe((text) => console.log('Filtered text:', text));\n * ```\n */\nexport function readableToObservable(\n  stream: ReadableStream<Uint8Array>,\n): Observable<Uint8Array> {\n  return new Observable<Uint8Array>((subscriber) => {\n    const reader = stream.getReader();\n\n    const pump = async (): Promise<void> => {\n      try {\n        while (true) {\n          const { done, value } = await reader.read();\n\n          if (done) {\n            subscriber.complete();\n            break;\n          }\n\n          if (value) {\n            subscriber.next(value);\n          }\n        }\n      } catch (error) {\n        if (error instanceof Error) {\n          subscriber.error(\n            new SerialError(\n              SerialErrorCode.READ_FAILED,\n              `Failed to read from stream: ${error.message}`,\n              error,\n            ),\n          );\n        } else {\n          subscriber.error(\n            new SerialError(\n              SerialErrorCode.READ_FAILED,\n              'Failed to read from stream: Unknown error',\n              error as Error,\n            ),\n          );\n        }\n      } finally {\n        reader.releaseLock();\n      }\n    };\n\n    pump().catch((error) => {\n      if (!subscriber.closed) {\n        subscriber.error(error);\n      }\n    });\n\n    // Cleanup function\n    return () => {\n      reader.releaseLock();\n    };\n  });\n}\n", "/**\n * Options for creating a SerialClient instance.\n *\n * These options configure the serial port connection parameters. All properties are optional\n * and will use default values if not specified. See {@link DEFAULT_SERIAL_CLIENT_OPTIONS} for\n * the default values used.\n *\n * @example\n * ```typescript\n * const client = createSerialClient({\n *   baudRate: 115200,\n *   dataBits: 8,\n *   stopBits: 1,\n *   parity: 'none',\n *   flowControl: 'none',\n *   filters: [{ usbVendorId: 0x1234, usbProductId: 0x5678 }],\n * });\n * ```\n */\nexport interface SerialClientOptions {\n  /**\n   * Baud rate for the serial port connection (bits per second).\n   *\n   * Common values include 9600, 19200, 38400, 57600, 115200, etc.\n   * Must match the baud rate configured on the connected device.\n   *\n   * @default 9600\n   */\n  baudRate?: number;\n\n  /**\n   * Number of data bits per character (7 or 8).\n   *\n   * - `7`: Seven data bits (used with parity)\n   * - `8`: Eight data bits (most common, used without parity)\n   *\n   * @default 8\n   */\n  dataBits?: 7 | 8;\n\n  /**\n   * Number of stop bits (1 or 2).\n   *\n   * - `1`: One stop bit (most common)\n   * - `2`: Two stop bits (less common, used for slower devices)\n   *\n   * @default 1\n   */\n  stopBits?: 1 | 2;\n\n  /**\n   * Parity checking mode.\n   *\n   * - `'none'`: No parity checking (most common)\n   * - `'even'`: Even parity\n   * - `'odd'`: Odd parity\n   *\n   * @default 'none'\n   */\n  parity?: 'none' | 'even' | 'odd';\n\n  /**\n   * Buffer size for reading data from the serial port, in bytes.\n   *\n   * This determines how much data can be buffered before it needs to be read.\n   * Larger buffers can improve performance but use more memory.\n   *\n   * @default 255\n   */\n  bufferSize?: number;\n\n  /**\n   * Flow control mode.\n   *\n   * - `'none'`: No flow control (most common)\n   * - `'hardware'`: Hardware flow control (RTS/CTS)\n   *\n   * @default 'none'\n   */\n  flowControl?: 'none' | 'hardware';\n\n  /**\n   * Filters for port selection when requesting a port.\n   *\n   * When specified, the port selection dialog will only show devices matching\n   * these filters. Each filter can specify `usbVendorId` and/or `usbProductId`\n   * to filter by USB device identifiers.\n   *\n   * @example\n   * ```typescript\n   * filters: [\n   *   { usbVendorId: 0x1234 },\n   *   { usbVendorId: 0x1234, usbProductId: 0x5678 },\n   * ]\n   * ```\n   *\n   * @see {@link SerialPortFilter} for the filter structure\n   */\n  filters?: SerialPortFilter[];\n}\n\n/**\n * Default options for SerialClient instances.\n *\n * These are the default values used when creating a SerialClient if no options\n * are provided or if specific options are omitted. The values are chosen to work\n * with most common serial devices.\n *\n * @see {@link SerialClientOptions} for details on each option\n */\nexport const DEFAULT_SERIAL_CLIENT_OPTIONS: Required<\n  Omit<SerialClientOptions, 'filters'>\n> & { filters?: SerialPortFilter[] } = {\n  baudRate: 9600,\n  dataBits: 8,\n  stopBits: 1,\n  parity: 'none',\n  bufferSize: 255,\n  flowControl: 'none',\n  filters: undefined,\n};\n", "import { Observable } from 'rxjs';\nimport { SerialClientOptions } from '../types/options';\nimport { SerialClientImpl } from './serial-client';\n\n/**\n * SerialClient interface for interacting with serial ports using RxJS Observables.\n *\n * This interface provides a reactive API for serial port communication, allowing you to\n * connect to serial devices, read and write data using RxJS Observables.\n *\n * @example\n * ```typescript\n * const client = createSerialClient({ baudRate: 9600 });\n *\n * // Connect to a port\n * client.connect().subscribe({\n *   next: () => {\n *     console.log('Connected!');\n *\n *     // Read data\n *     client.getReadStream().subscribe({\n *       next: (data) => console.log('Received:', data),\n *     });\n *\n *     // Write data\n *     const encoder = new TextEncoder();\n *     client.write(encoder.encode('Hello')).subscribe();\n *   },\n *   error: (error) => console.error('Connection error:', error),\n * });\n * ```\n */\nexport interface SerialClient {\n  /**\n   * Request a serial port from the user.\n   *\n   * This method opens the browser's port selection dialog and returns an Observable\n   * that emits the selected SerialPort when the user chooses a port.\n   *\n   * @returns An Observable that emits the selected {@link SerialPort} when the user selects a port\n   * @throws {@link SerialError} with code {@link SerialErrorCode.OPERATION_CANCELLED} if the user cancels the selection\n   * @throws {@link SerialError} with code {@link SerialErrorCode.PORT_NOT_AVAILABLE} if the port request fails\n   * @throws {@link SerialError} with code {@link SerialErrorCode.BROWSER_NOT_SUPPORTED} if the browser doesn't support Web Serial API\n   *\n   * @example\n   * ```typescript\n   * client.requestPort().subscribe({\n   *   next: (port) => console.log('Selected port:', port),\n   *   error: (error) => console.error('Port selection failed:', error),\n   * });\n   * ```\n   */\n  requestPort(): Observable<SerialPort>;\n\n  /**\n   * Get available serial ports that have been previously granted access.\n   *\n   * This method returns an Observable that emits an array of SerialPort instances\n   * that the user has previously granted access to in this browser session.\n   *\n   * @returns An Observable that emits an array of available {@link SerialPort} instances\n   * @throws {@link SerialError} with code {@link SerialErrorCode.PORT_NOT_AVAILABLE} if getting ports fails\n   * @throws {@link SerialError} with code {@link SerialErrorCode.BROWSER_NOT_SUPPORTED} if the browser doesn't support Web Serial API\n   *\n   * @example\n   * ```typescript\n   * client.getPorts().subscribe({\n   *   next: (ports) => {\n   *     console.log(`Found ${ports.length} available ports`);\n   *     if (ports.length > 0) {\n   *       client.connect(ports[0]).subscribe();\n   *     }\n   *   },\n   * });\n   * ```\n   */\n  getPorts(): Observable<SerialPort[]>;\n\n  /**\n   * Connect to a serial port.\n   *\n   * Opens the specified port (or requests one if not provided) and configures it\n   * with the options passed to {@link createSerialClient}. The port must be connected\n   * before reading or writing data.\n   *\n   * @param port - Optional {@link SerialPort} to connect to. If not provided, will call {@link requestPort} to prompt the user.\n   * @returns An Observable that completes when the port is successfully opened\n   * @throws {@link SerialError} with code {@link SerialErrorCode.PORT_ALREADY_OPEN} if a port is already open\n   * @throws {@link SerialError} with code {@link SerialErrorCode.PORT_OPEN_FAILED} if opening the port fails\n   * @throws {@link SerialError} with code {@link SerialErrorCode.OPERATION_CANCELLED} if the user cancels port selection\n   * @throws {@link SerialError} with code {@link SerialErrorCode.BROWSER_NOT_SUPPORTED} if the browser doesn't support Web Serial API\n   *\n   * @example\n   * ```typescript\n   * // Connect by requesting a port\n   * client.connect().subscribe({\n   *   next: () => console.log('Connected!'),\n   *   error: (error) => console.error('Connection failed:', error),\n   * });\n   *\n   * // Connect to a specific port\n   * client.getPorts().subscribe({\n   *   next: (ports) => {\n   *     if (ports.length > 0) {\n   *       client.connect(ports[0]).subscribe();\n   *     }\n   *   },\n   * });\n   * ```\n   */\n  connect(port?: SerialPort): Observable<void>;\n\n  /**\n   * Disconnect from the serial port.\n   *\n   * Closes the currently open port and stops all active read/write streams.\n   * This method is safe to call even if no port is currently open.\n   *\n   * @returns An Observable that completes when the port is successfully closed\n   * @throws {@link SerialError} with code {@link SerialErrorCode.CONNECTION_LOST} if closing the port fails\n   *\n   * @example\n   * ```typescript\n   * client.disconnect().subscribe({\n   *   next: () => console.log('Disconnected'),\n   *   error: (error) => console.error('Disconnect failed:', error),\n   * });\n   * ```\n   */\n  disconnect(): Observable<void>;\n\n  /**\n   * Get an Observable that emits data read from the serial port.\n   *\n   * Returns an Observable stream that emits Uint8Array chunks as data is received\n   * from the serial port. The stream will continue until the port is disconnected\n   * or an error occurs.\n   *\n   * @returns An Observable that emits Uint8Array chunks containing data read from the serial port\n   * @throws {@link SerialError} with code {@link SerialErrorCode.PORT_NOT_OPEN} if the port is not open\n   *\n   * @example\n   * ```typescript\n   * client.getReadStream().subscribe({\n   *   next: (data) => {\n   *     const text = new TextDecoder().decode(data);\n   *     console.log('Received:', text);\n   *   },\n   *   error: (error) => console.error('Read error:', error),\n   * });\n   * ```\n   */\n  getReadStream(): Observable<Uint8Array>;\n\n  /**\n   * Write data to the serial port from an Observable.\n   *\n   * Writes data from an Observable stream to the serial port. The Observable should\n   * emit Uint8Array chunks that will be written sequentially to the port. If a previous\n   * write stream is active, it will be cancelled before starting the new one.\n   *\n   * @param data$ - Observable that emits Uint8Array chunks to write to the serial port\n   * @returns An Observable that completes when all data has been written and the stream completes\n   * @throws {@link SerialError} with code {@link SerialErrorCode.PORT_NOT_OPEN} if the port is not open\n   * @throws {@link SerialError} with code {@link SerialErrorCode.WRITE_FAILED} if writing fails\n   *\n   * @example\n   * ```typescript\n   * const data$ = from([\n   *   new TextEncoder().encode('Hello'),\n   *   new TextEncoder().encode('World'),\n   * ]);\n   *\n   * client.writeStream(data$).subscribe({\n   *   next: () => console.log('Writing...'),\n   *   complete: () => console.log('All data written'),\n   *   error: (error) => console.error('Write error:', error),\n   * });\n   * ```\n   */\n  writeStream(data$: Observable<Uint8Array>): Observable<void>;\n\n  /**\n   * Write a single chunk of data to the serial port.\n   *\n   * Writes a single Uint8Array chunk to the serial port. For writing multiple chunks,\n   * consider using {@link writeStream} with an Observable instead.\n   *\n   * @param data - Uint8Array data to write to the serial port\n   * @returns An Observable that completes when the data has been written\n   * @throws {@link SerialError} with code {@link SerialErrorCode.PORT_NOT_OPEN} if the port is not open\n   * @throws {@link SerialError} with code {@link SerialErrorCode.WRITE_FAILED} if writing fails\n   *\n   * @example\n   * ```typescript\n   * const encoder = new TextEncoder();\n   * const data = encoder.encode('Hello, Serial!');\n   *\n   * client.write(data).subscribe({\n   *   next: () => console.log('Data written'),\n   *   error: (error) => console.error('Write error:', error),\n   * });\n   * ```\n   */\n  write(data: Uint8Array): Observable<void>;\n\n  /**\n   * Check if the port is currently open and connected.\n   *\n   * @returns `true` if a port is currently open, `false` otherwise\n   */\n  readonly connected: boolean;\n\n  /**\n   * Get the current SerialPort instance.\n   *\n   * Returns the currently connected SerialPort instance, or `null` if no port is open.\n   * This allows direct access to the underlying Web Serial API SerialPort object if needed.\n   *\n   * @returns The current {@link SerialPort} instance, or `null` if no port is open\n   */\n  readonly currentPort: SerialPort | null;\n}\n\n/**\n * Create a new SerialClient instance for interacting with serial ports.\n *\n * This is the main entry point for creating a serial client. The client provides\n * a reactive RxJS-based API for connecting to serial ports and reading/writing data.\n *\n * @param options - Optional configuration options for the serial port connection.\n *                  If not provided, default values will be used (9600 baud, 8 data bits, etc.)\n * @returns A new {@link SerialClient} instance\n * @throws {@link SerialError} with code {@link SerialErrorCode.BROWSER_NOT_SUPPORTED} if the browser doesn't support Web Serial API\n *\n * @example\n * ```typescript\n * // Create a client with default settings (9600 baud)\n * const client = createSerialClient();\n *\n * // Create a client with custom settings\n * const client = createSerialClient({\n *   baudRate: 115200,\n *   dataBits: 8,\n *   stopBits: 1,\n *   parity: 'none',\n *   filters: [{ usbVendorId: 0x1234 }],\n * });\n *\n * // Check browser support before creating a client\n * import { isBrowserSupported } from '@gurezo/web-serial-rxjs';\n *\n * if (!isBrowserSupported()) {\n *   console.error('Web Serial API is not supported');\n * } else {\n *   const client = createSerialClient();\n * }\n * ```\n */\nexport function createSerialClient(\n  options?: SerialClientOptions,\n): SerialClient {\n  return new SerialClientImpl(options);\n}\n"],
+  "mappings": "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",
+  "names": ["Observable", "SerialErrorCode", "BrowserType", "Observable"]
+}

package/dist/io/observable-to-writable.d.ts

@@ -0,0 +1,65 @@
+import { Observable } from 'rxjs';
+/**
+ * Convert an RxJS Observable to a WritableStream.
+ *
+ * This utility function converts an RxJS Observable into a Web Streams API WritableStream.
+ * Values emitted by the Observable will be written to the returned WritableStream. The stream
+ * will close when the Observable completes or abort if the Observable errors.
+ *
+ * Note: This function creates a new WritableStream. For directly subscribing to an Observable
+ * and writing to an existing WritableStream, use {@link subscribeToWritable} instead.
+ *
+ * @param observable - The Observable to convert to a WritableStream
+ * @returns A WritableStream that writes Uint8Array chunks emitted by the Observable
+ *
+ * @example
+ * ```typescript
+ * const data$ = from([
+ *   new TextEncoder().encode('Hello'),
+ *   new TextEncoder().encode('World'),
+ * ]);
+ *
+ * const writableStream = observableToWritable(data$);
+ * // Use the writable stream with other Web Streams APIs
+ * ```
+ */
+export declare function observableToWritable(observable: Observable<Uint8Array>): WritableStream<Uint8Array>;
+/**
+ * Subscribe to an Observable and write its values to a WritableStream.
+ *
+ * This utility function subscribes to an RxJS Observable and writes all emitted values
+ * to the provided WritableStream. This is commonly used to write Observable data to a
+ * serial port's writable stream.
+ *
+ * The function returns a subscription object that can be used to unsubscribe and clean up.
+ * When unsubscribed, the writer lock will be released properly.
+ *
+ * @param observable - The Observable to subscribe to and read data from
+ * @param stream - The WritableStream to write data to
+ * @returns A subscription object with an `unsubscribe` method for cleanup
+ * @throws {@link SerialError} with code {@link SerialErrorCode.WRITE_FAILED} if writing to the stream fails
+ *
+ * @example
+ * ```typescript
+ * const data$ = from([
+ *   new TextEncoder().encode('Hello'),
+ *   new TextEncoder().encode('World'),
+ * ]);
+ *
+ * const subscription = subscribeToWritable(data$, port.writable);
+ *
+ * // Later, to cancel and clean up:
+ * subscription.unsubscribe();
+ *
+ * // Use with RxJS operators
+ * const processedData$ = of('Hello, Serial!').pipe(
+ *   map((text) => new TextEncoder().encode(text))
+ * );
+ *
+ * subscribeToWritable(processedData$, port.writable);
+ * ```
+ */
+export declare function subscribeToWritable(observable: Observable<Uint8Array>, stream: WritableStream<Uint8Array>): {
+    unsubscribe: () => void;
+};
+//# sourceMappingURL=observable-to-writable.d.ts.map

package/dist/io/observable-to-writable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observable-to-writable.d.ts","sourceRoot":"","sources":["../../src/io/observable-to-writable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAGlC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,GACjC,cAAc,CAAC,UAAU,CAAC,CAqE5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,EAClC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GACjC;IAAE,WAAW,EAAE,MAAM,IAAI,CAAA;CAAE,CAiD7B"}

package/dist/io/readable-to-observable.d.ts

@@ -0,0 +1,44 @@
+import { Observable } from 'rxjs';
+/**
+ * Convert a ReadableStream to an RxJS Observable.
+ *
+ * This utility function converts a Web Streams API ReadableStream into an RxJS Observable,
+ * allowing you to use RxJS operators with stream data. The Observable will emit Uint8Array
+ * chunks as they are read from the stream, complete when the stream ends, or error if
+ * the stream encounters an error.
+ *
+ * The returned Observable handles stream cleanup automatically - if you unsubscribe before
+ * the stream completes, the reader lock will be released properly.
+ *
+ * @param stream - The ReadableStream to convert to an Observable
+ * @returns An Observable that emits Uint8Array chunks from the stream
+ * @throws {@link SerialError} with code {@link SerialErrorCode.READ_FAILED} if reading from the stream fails
+ *
+ * @example
+ * ```typescript
+ * // Convert a serial port's readable stream to an Observable
+ * const readable$ = readableToObservable(port.readable);
+ *
+ * readable$.subscribe({
+ *   next: (chunk) => {
+ *     console.log('Received chunk:', chunk);
+ *   },
+ *   complete: () => {
+ *     console.log('Stream completed');
+ *   },
+ *   error: (error) => {
+ *     console.error('Stream error:', error);
+ *   },
+ * });
+ *
+ * // Use with RxJS operators
+ * readableToObservable(port.readable)
+ *   .pipe(
+ *     map((chunk) => new TextDecoder().decode(chunk)),
+ *     filter((text) => text.includes('OK'))
+ *   )
+ *   .subscribe((text) => console.log('Filtered text:', text));
+ * ```
+ */
+export declare function readableToObservable(stream: ReadableStream<Uint8Array>): Observable<Uint8Array>;
+//# sourceMappingURL=readable-to-observable.d.ts.map

package/dist/io/readable-to-observable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readable-to-observable.d.ts","sourceRoot":"","sources":["../../src/io/readable-to-observable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAGlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GACjC,UAAU,CAAC,UAAU,CAAC,CAoDxB"}

package/dist/lib/web-serial-rxjs.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Utility function that returns the library name.
+ *
+ * @returns The library name as a string: 'web-serial-rxjs'
+ */
+export declare function webSerialRxjs(): string;
+//# sourceMappingURL=web-serial-rxjs.d.ts.map

package/dist/lib/web-serial-rxjs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-serial-rxjs.d.ts","sourceRoot":"","sources":["../../src/lib/web-serial-rxjs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/types/options.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Options for creating a SerialClient instance.
+ *
+ * These options configure the serial port connection parameters. All properties are optional
+ * and will use default values if not specified. See {@link DEFAULT_SERIAL_CLIENT_OPTIONS} for
+ * the default values used.
+ *
+ * @example
+ * ```typescript
+ * const client = createSerialClient({
+ *   baudRate: 115200,
+ *   dataBits: 8,
+ *   stopBits: 1,
+ *   parity: 'none',
+ *   flowControl: 'none',
+ *   filters: [{ usbVendorId: 0x1234, usbProductId: 0x5678 }],
+ * });
+ * ```
+ */
+export interface SerialClientOptions {
+    /**
+     * Baud rate for the serial port connection (bits per second).
+     *
+     * Common values include 9600, 19200, 38400, 57600, 115200, etc.
+     * Must match the baud rate configured on the connected device.
+     *
+     * @default 9600
+     */
+    baudRate?: number;
+    /**
+     * Number of data bits per character (7 or 8).
+     *
+     * - `7`: Seven data bits (used with parity)
+     * - `8`: Eight data bits (most common, used without parity)
+     *
+     * @default 8
+     */
+    dataBits?: 7 | 8;
+    /**
+     * Number of stop bits (1 or 2).
+     *
+     * - `1`: One stop bit (most common)
+     * - `2`: Two stop bits (less common, used for slower devices)
+     *
+     * @default 1
+     */
+    stopBits?: 1 | 2;
+    /**
+     * Parity checking mode.
+     *
+     * - `'none'`: No parity checking (most common)
+     * - `'even'`: Even parity
+     * - `'odd'`: Odd parity
+     *
+     * @default 'none'
+     */
+    parity?: 'none' | 'even' | 'odd';
+    /**
+     * Buffer size for reading data from the serial port, in bytes.
+     *
+     * This determines how much data can be buffered before it needs to be read.
+     * Larger buffers can improve performance but use more memory.
+     *
+     * @default 255
+     */
+    bufferSize?: number;
+    /**
+     * Flow control mode.
+     *
+     * - `'none'`: No flow control (most common)
+     * - `'hardware'`: Hardware flow control (RTS/CTS)
+     *
+     * @default 'none'
+     */
+    flowControl?: 'none' | 'hardware';
+    /**
+     * Filters for port selection when requesting a port.
+     *
+     * When specified, the port selection dialog will only show devices matching
+     * these filters. Each filter can specify `usbVendorId` and/or `usbProductId`
+     * to filter by USB device identifiers.
+     *
+     * @example
+     * ```typescript
+     * filters: [
+     *   { usbVendorId: 0x1234 },
+     *   { usbVendorId: 0x1234, usbProductId: 0x5678 },
+     * ]
+     * ```
+     *
+     * @see {@link SerialPortFilter} for the filter structure
+     */
+    filters?: SerialPortFilter[];
+}
+/**
+ * Default options for SerialClient instances.
+ *
+ * These are the default values used when creating a SerialClient if no options
+ * are provided or if specific options are omitted. The values are chosen to work
+ * with most common serial devices.
+ *
+ * @see {@link SerialClientOptions} for details on each option
+ */
+export declare const DEFAULT_SERIAL_CLIENT_OPTIONS: Required<Omit<SerialClientOptions, 'filters'>> & {
+    filters?: SerialPortFilter[];
+};
+//# sourceMappingURL=options.d.ts.map

package/dist/types/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/types/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAEjB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAEjB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IAEjC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAElC;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,EAAE,QAAQ,CAClD,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,CACrC,GAAG;IAAE,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAA;CAQjC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gurezo/web-serial-rxjs",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "A TypeScript library that provides a reactive RxJS-based wrapper for the Web Serial API, enabling easy serial port communication in web applications.",
   "author": "Akihiko Kigure <akihiko.kigure@gmail.com>",
   "license": "MIT",
@@ -19,6 +19,15 @@
     "README.ja.md",
     "LICENSE"
   ],
+  "scripts": {
+    "build": "pnpm run build:types && pnpm run build:bundle && pnpm run build:copy-files && pnpm run build:cleanup",
+    "build:types": "../../node_modules/.bin/tsc --project tsconfig.lib.json",
+    "build:bundle": "node esbuild.config.mjs",
+    "build:copy-files": "cp ../../LICENSE . 2>/dev/null || true",
+    "build:cleanup": "rm -rf dist/packages dist/package.json 2>/dev/null || true",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "pnpm run build"
+  },
   "dependencies": {},
   "peerDependencies": {
     "rxjs": "^7.8.0"
@@ -43,12 +52,5 @@
   ],
   "publishConfig": {
     "access": "public"
-  },
-  "scripts": {
-    "build": "pnpm run build:types && pnpm run build:bundle && pnpm run build:copy-files",
-    "build:types": "tsc --project tsconfig.lib.json",
-    "build:bundle": "node esbuild.config.mjs",
-    "build:copy-files": "cp ../../LICENSE . 2>/dev/null || true",
-    "clean": "rm -rf dist"
   }
-}
+}