googleai_dart 1.0.0

googleai_dart: ^1.0.0 copied to clipboard

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.