googleai_dart 3.0.0

googleai_dart: ^3.0.0 copied to clipboard

Note: This release has breaking changes.

• FEAT(googleai_dart): add convenience helpers for improved DX (#924). (634b4f97)
• FEAT(googleai_dart): Update default models to Gemini 3 family (#922). (62bca9da)
• FEAT(googleai_dart): Auto-populate batch.model from method parameter (#921). (abfeded8)
• BREAKING FEAT(googleai_dart): replace List

• FEAT(googleai_dart): Add Gemini Live API (WebSocket) support (#920). (4beb01dd)
• FEAT(googleai_dart): Add missing model properties from OpenAPI spec (#916). (fc0e2f8a)
• DOCS(googleai_dart): Add documentation for grounding tools (#917). (b5a529fe)

Note: This release has breaking changes.

• BREAKING FEAT(googleai_dart): Remove deprecated schema fields (#848). (e6d07ec4)
• BREAKING FEAT(googleai_dart): Remove deprecated Chunks and query APIs (#847). (9cae76d5)
• BREAKING FEAT(googleai_dart): Remove deprecated RagStores resource (#846). (1ab553f1)
• FEAT(googleai_dart): Add InteractionsResource and client integration (#905). (af6b13ea)
• FEAT(googleai_dart): Add Interactions API tool types (#904). (2258cfa1)
• FEAT(googleai_dart): Add Interactions API events and deltas (#903). (826d3f64)
• FEAT(googleai_dart): Add Interactions API content types (#902). (b8c61743)
• FEAT(googleai_dart): Add Interactions API core models (#901). (65f5db17)
• FEAT(googleai_dart): Update existing models with new properties (#856). (dd3893e0)
• FEAT(googleai_dart): Add RetrievalConfig to ToolConfig (#855). (5e11aa70)
• FEAT(googleai_dart): Add MediaResolution to Part (#854). (df76f8c5)
• FEAT(googleai_dart): Add GoogleMaps tool (#853). (54814614)
• FEAT(googleai_dart): Add McpServers tool (#852). (97970687)
• FEAT(googleai_dart): Add FileSearch tool (#851). (a00895b1)
• FEAT(googleai_dart): Add grounding models (#850). (bb1a6228)
• FEAT(googleai_dart): Add FileSearchStores resource (#849). (acb63d72)
• FEAT(googleai_dart): Add ThinkingConfig support to GenerationConfig (#817). (36de62a9)
• FIX(googleai_dart): Complete alignment with target implementation (#884). (60476e8d)
• DOCS(googleai_dart): Add Interactions API docs and example (#897). (f4a04677)

• FEAT: Make googleai_dart fully WASM compatible (#808). (07e597f3)
• REFACTOR: Fix pub format warnings (#809). (640cdefb)

Note: This release has breaking changes.

TL;DR: Complete reimplementation with a new architecture, minimal dependencies, unified resource-based API, and full Gemini API coverage. Includes new Files, Batches, Caching, Corpora/RAG, RAG Stores, Dynamic Content, Permissions, Tuned Models, and Prediction (Veo) support.

What's new #

• Unified client for both:
  • Google AI Gemini Developer API
  • Vertex AI Gemini API
• Complete API coverage: 78 endpoints.
  • Files API: upload, list, get, delete, download.
  • Generated Files API: list, get, getOperation (video outputs).
  • Cached Contents: full CRUD.
  • Batch operations: batchGenerateContent, batchEmbedContents, asyncBatchEmbedContent with LRO polling.
  • Corpora & RAG: corpus CRUD (Google AI); documents/chunks/query, metadata filters, batch chunk ops (Vertex AI only).
  • RAG Stores: documents list/create/get/delete/query + operations.
  • Dynamic Content: generate/stream content with dynamic model IDs.
  • Permissions: create/list/get/update/delete/transferOwnership for eligible resources.
  • Tuned Models: list, get, listOperations, generation APIs.
  • Prediction (Veo): predict, predictLongRunning, operation polling, RAI filtering.
• Architecture:
  • Interceptor chain (Auth → Logging → Error).
  • Authentication: API key, Bearer token, custom OAuth via AuthProvider.
  • Retry with exponential backoff + jitter.
  • Abortable requests via abortTrigger (streaming and non-streaming).
  • SSE streaming parser.
  • Central GoogleAIConfig (timeouts, retry policy, log level, baseUrl).
• Testing:
  • 560+ tests covering all endpoints, error branches, streaming/abort flows.

Breaking Changes #

• Resource-based API: Methods reorganized under strongly-typed resources:
  • client.models.* (generation, streaming, embeddings, tokens, prediction)
  • client.tunedModels.*
  • client.files.*, client.generatedFiles.*
  • client.cachedContents.*
  • client.batches.*
  • client.corpora.*
  • client.ragStores.*
• Parameter rename: modelId → model.
• Configuration: New GoogleAIConfig with AuthProvider pattern (API key / bearer / custom OAuth).
• Exceptions: Replaced ad-hoc errors with a typed hierarchy:
  • ApiException, ValidationException, RateLimitException, TimeoutException, AbortedException.
• Dependencies: Removed fetch_client; now minimal (http, logging).

See MIGRATION.md for step-by-step examples and mapping tables.

• FEAT: Migrate to Freezed v3 (#773). (f87c8c03)

• BUILD: Update dependencies (#751). (250a3c6)

• FEAT: Update dependencies (requires Dart 3.6.0) (#709). (9e3467f7)
• REFACTOR: Remove fetch_client dependency in favor of http v1.3.0 (#659). (0e0a685c)
• FIX: Fix linter issues (#656). (88a79c65)

• REFACTOR: Upgrade api clients generator version (#610). (0c8750e8)

• REFACTOR: Migrate conditional imports to js_interop (#453). (a6a78cfe)

• FIX: Fix deserialization of sealed classes (#435). (7b9cf223)

• REFACTOR: Minor changes (#407). (fa4b5c37)

• FEAT: Support generateContent for tuned model in googleai_dart client (#358). (b4641a09)
• FEAT: Support output dimensionality in Google AI Embeddings (#373). (6dcb27d8)
• FEAT: Support updating API key in Google AI client (#357). (b9b808e7)
• FIX: Have the == implementation use Object instead of dynamic (#334). (89f7b0b9)

• FEAT: Add streaming support to googleai_dart client (#299). (2cbd538a)
• FEAT: Update meta and test dependencies (#331). (912370ee)
• DOCS: Update pubspecs. (d23ed89a)

• DOCS: Update CHANGELOG.md. (d0d46534)

• REFACTOR: Make all LLM options fields nullable and add copyWith (#284). (57eceb9b)

• Update a dependency to the latest release.

• FIX: Fetch web requests with big payloads dropping connection (#273). (425889dc)

• FEAT: Implement Dart client for Google AI API (#267). (99083cd2)

• Bootstrap project.