docs: add SSE example for path params, query params, and error responses

Cover missing SSE scenarios: path parameter (/stock/{symbol}/watch),
query parameter (interval), and non-200 error response (404).

https://claude.ai/code/session_015wYib3JNLu2XuN6LrJtFED

Author: claude

examples/openapi-ts-sse/src/App.tsx

@@ -1,6 +1,11 @@
 import { useRef, useState } from 'react';
 
-import { getStockHistory, watchSelectedStocks, watchStockPrices } from './client/sdk.gen';
+import {
+  getStockHistory,
+  watchSelectedStocks,
+  watchSingleStock,
+  watchStockPrices,
+} from './client/sdk.gen';
 import type { StockUpdate } from './client/types.gen';
 
 function App() {
@@ -72,6 +77,32 @@ function App() {
     setStatus('disconnected');
   };
 
+  // SSE with path parameter, query parameter, and error response
+  const onWatchSingle = async () => {
+    const controller = new AbortController();
+    controllerRef.current = controller;
+    setStatus('connected');
+    setUpdates([]);
+
+    try {
+      const { stream } = await watchSingleStock({
+        path: { symbol: 'AAPL' },
+        query: { interval: 2 },
+        signal: controller.signal,
+      });
+
+      for await (const update of stream) {
+        setUpdates((prev) => [...prev, update]);
+      }
+    } catch {
+      if (!controller.signal.aborted) {
+        setStatus('error');
+        return;
+      }
+    }
+    setStatus('disconnected');
+  };
+
   // Cancel the stream using AbortController
   const onDisconnect = () => {
     controllerRef.current?.abort();
@@ -112,6 +143,9 @@ function App() {
         <button disabled={status === 'connected'} onClick={onWatchSelected}>
           Watch Selected (POST)
         </button>
+        <button disabled={status === 'connected'} onClick={onWatchSingle}>
+          Watch AAPL (Path Param)
+        </button>
         <button disabled={status !== 'connected'} onClick={onDisconnect}>
           Disconnect
         </button>

examples/openapi-ts-sse/src/client/index.ts

@@ -1,8 +1,15 @@
 // This file is auto-generated by @hey-api/openapi-ts
 
-export { getStockHistory, type Options, watchSelectedStocks, watchStockPrices } from './sdk.gen';
+export {
+  getStockHistory,
+  type Options,
+  watchSelectedStocks,
+  watchSingleStock,
+  watchStockPrices,
+} from './sdk.gen';
 export type {
   ClientOptions,
+  ErrorResponse,
   GetStockHistoryData,
   GetStockHistoryResponse,
   GetStockHistoryResponses,
@@ -14,6 +21,11 @@ export type {
   WatchSelectedStocksData,
   WatchSelectedStocksResponse,
   WatchSelectedStocksResponses,
+  WatchSingleStockData,
+  WatchSingleStockError,
+  WatchSingleStockErrors,
+  WatchSingleStockResponse,
+  WatchSingleStockResponses,
   WatchStockPricesData,
   WatchStockPricesResponse,
   WatchStockPricesResponses,

examples/openapi-ts-sse/src/client/sdk.gen.ts

@@ -7,6 +7,9 @@ import type {
   GetStockHistoryResponses,
   WatchSelectedStocksData,
   WatchSelectedStocksResponses,
+  WatchSingleStockData,
+  WatchSingleStockErrors,
+  WatchSingleStockResponses,
   WatchStockPricesData,
   WatchStockPricesResponses,
 } from './types.gen';
@@ -58,6 +61,20 @@ export const watchSelectedStocks = <ThrowOnError extends boolean = false>(
     },
   });
 
+/**
+ * Watch a single stock
+ *
+ * Stream real-time price updates for a specific stock symbol.
+ */
+export const watchSingleStock = <ThrowOnError extends boolean = false>(
+  options: Options<WatchSingleStockData, ThrowOnError>,
+) =>
+  (options.client ?? client).sse.get<
+    WatchSingleStockResponses,
+    WatchSingleStockErrors,
+    ThrowOnError
+  >({ url: '/stock/{symbol}/watch', ...options });
+
 /**
  * Get stock history
  *

examples/openapi-ts-sse/src/client/types.gen.ts

@@ -44,6 +44,11 @@ export type MarketAlert = {
   type: 'market_alert';
 };
 
+export type ErrorResponse = {
+  code: string;
+  message: string;
+};
+
 export type WatchStockPricesData = {
   body?: never;
   path?: never;
@@ -77,6 +82,41 @@ export type WatchSelectedStocksResponses = {
 export type WatchSelectedStocksResponse =
   WatchSelectedStocksResponses[keyof WatchSelectedStocksResponses];
 
+export type WatchSingleStockData = {
+  body?: never;
+  path: {
+    /**
+     * Stock ticker symbol (e.g. AAPL)
+     */
+    symbol: string;
+  };
+  query?: {
+    /**
+     * Update interval in seconds
+     */
+    interval?: number;
+  };
+  url: '/stock/{symbol}/watch';
+};
+
+export type WatchSingleStockErrors = {
+  /**
+   * Stock symbol not found
+   */
+  404: ErrorResponse;
+};
+
+export type WatchSingleStockError = WatchSingleStockErrors[keyof WatchSingleStockErrors];
+
+export type WatchSingleStockResponses = {
+  /**
+   * Stock price stream for the requested symbol
+   */
+  200: StockUpdate;
+};
+
+export type WatchSingleStockResponse = WatchSingleStockResponses[keyof WatchSingleStockResponses];
+
 export type GetStockHistoryData = {
   body?: never;
   path?: never;

specs/3.1.x/sse-example.yaml

@@ -34,6 +34,37 @@ paths:
             text/event-stream:
               schema:
                 $ref: '#/components/schemas/StockUpdate'
+  /stock/{symbol}/watch:
+    get:
+      operationId: watchSingleStock
+      summary: Watch a single stock
+      description: Stream real-time price updates for a specific stock symbol.
+      parameters:
+        - name: symbol
+          in: path
+          required: true
+          description: Stock ticker symbol (e.g. AAPL)
+          schema:
+            type: string
+        - name: interval
+          in: query
+          description: Update interval in seconds
+          schema:
+            type: integer
+            default: 5
+      responses:
+        '200':
+          description: Stock price stream for the requested symbol
+          content:
+            text/event-stream:
+              schema:
+                $ref: '#/components/schemas/StockUpdate'
+        '404':
+          description: Stock symbol not found
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
   /stock/history:
     get:
       operationId: getStockHistory
@@ -137,3 +168,13 @@ components:
             - critical
         message:
           type: string
+    ErrorResponse:
+      type: object
+      required:
+        - code
+        - message
+      properties:
+        code:
+          type: string
+        message:
+          type: string