JsonStreamParser class

A streaming JSON parser optimized for LLM responses.

This parser processes JSON data character-by-character as it streams in, allowing you to react to properties before the entire JSON is received. It's specifically designed for handling Large Language Model (LLM) streaming responses that output structured JSON data.

Key Features

• Reactive property access: Subscribe to JSON properties as they complete
• Streaming string values: Receive string content chunk-by-chunk as it arrives
• Path-based subscriptions: Access nested properties with dot notation or chainable API
• Type safety: Typed property streams for all JSON types
• Dynamic list handling: React to array elements as soon as they start arriving

Basic Usage

final parser = JsonStreamParser(streamFromLLM);

// Subscribe to properties
parser.getStringProperty('title').stream.listen((chunk) {
  print('Title chunk: $chunk');
});

// Wait for complete values
final age = await parser.getNumberProperty('user.age').future;
print('Age: $age');

Path Syntax

Access nested properties using dot notation:

• 'title' - Root property
• 'user.name' - Nested property
• 'items[0].name' - Array element property
• 'data.users[2].profile.age' - Deep nesting

Disposal

Call dispose when done to clean up resources:

await parser.dispose();