capture-api-response-test-fixture

Narzędzie do automatycznego przechwytywania i przechowywania odpowiedzi API w postaci fixture'ów testowych. Umożliwia logowanie surowych odpowiedzi z funkcji generateText i streamText, a następnie zapisanie ich w strukturze folderów fixtures dla potrzeb testów parsowania dostawców. Obsługuje zarówno proste żądania tekstowe, jak i strumieniowe odpowiedzi z opcją includeRawChunks. Idealne dla zespołów rozwijających integracje z dostawcami AI, którzy chcą testować rzeczywiste scenariusze bez ręcznego tworzenia mock'ów.

1. Przygotuj skrypt testowy w folderze /examples/ai-functions. Dla generateText zaimportuj openai, generateText i funkcję run, następnie wywołaj generateText z wybranym modelem i promptem, logując surową odpowiedź do konsoli za pomocą console.log(JSON.stringify(result.response.body, null, 2)).

2. Uruchom skrypt poleceniem pnpm tsx src/sciezka/do/skryptu.ts i skopiuj wynik z konsoli.

3. Utwórz folder fixtures w odpowiedniej ścieżce pakietu (np. packages/openai/src/responses/fixtures) i wklej skopiowaną odpowiedź do nowego pliku, przestrzegając konwencji nazewnictwa używanej w istniejących fixture'ach.

4. Dla testów streamText ustaw includeRawChunks na true, zaimportuj helper saveRawChunks i uruchom skrypt z folderu /examples/ai-functions — wynik zostanie automatycznie zapisany w folderze output.

5. Przenieś wygenerowany plik z output do folderu fixtures w pakiecie, zachowując odpowiednią nazwę.

6. Skonfiguruj test parsowania w pliku testowym (np. openai-responses-language-model.test.ts), odwołując się do fixture'a i używając helper'ów testowych do weryfikacji poprawności parsowania odpowiedzi.