popiart-node-canvas/.planning/codebase/INTEGRATIONS.md

External Integrations

Analysis Date: 2026-01-09

APIs & External Services

AI Image Generation - Google Gemini:

• SDK/Client: @google/genai 1.30.0 - package.json
• Route: src/app/api/generate/route.ts (5-minute timeout)
• Models: gemini-2.5-flash-image, gemini-3-pro-image-preview
• Internal names: nano-banana, nano-banana-pro
• Auth: GEMINI_API_KEY env var
• Features: Aspect ratio, resolution (2K/4K), Google Search tool

AI Text Generation - Google Gemini:

• Route: src/app/api/llm/route.ts (1-minute timeout)
• Models: gemini-2.5-flash, gemini-3-flash-preview, gemini-3-pro-preview
• Auth: GEMINI_API_KEY env var
• Features: Temperature, max tokens, multimodal (text + images)

AI Text Generation - OpenAI (Optional):

• Route: src/app/api/llm/route.ts
• Models: gpt-4.1-mini, gpt-4.1-nano
• Endpoint: https://api.openai.com/v1/chat/completions
• Auth: OPENAI_API_KEY env var (optional)
• Features: Temperature, max tokens, multimodal support

Data Storage

File System (Server-side):

• Workflow JSON files - src/app/api/workflow/route.ts
• Generated images as PNG - src/app/api/save-generation/route.ts
• Auto-creates inputs/ and generations/ subdirectories
• Uses fs/promises for async file operations

LocalStorage (Client-side):

• node-banana-workflow-configs - Project metadata and file paths
• node-banana-workflow-costs - Cost tracking per workflow
• node-banana-nanoBanana-defaults - Sticky generation settings
• Reference: src/store/workflowStore.ts

Caching:

• None (all database queries, no Redis)

Authentication & Identity

Auth Provider:

• None - Local-first application
• API keys stored in environment variables only

Monitoring & Observability

Custom Logging:

• Logger: src/utils/logger.ts (client), src/utils/logger-server.ts (server)
• Session-based logging with unique session IDs
• Structured JSON format with timestamps
• Categories: workflow, node execution, API calls, file operations
• Privacy: Truncates prompts (200 chars), sanitizes image data
• Server persistence: src/app/api/logs/route.ts
• Rotation: Keeps last 10 sessions

Error Tracking:

• Console logging only (no Sentry/external service)

Analytics:

• None

CI/CD & Deployment

Hosting:

• Local development primary use case
• Compatible with Vercel for production deployment

CI Pipeline:

• None configured (no GitHub Actions workflows found)

Environment Configuration

Development:

• Required: GEMINI_API_KEY
• Optional: OPENAI_API_KEY
• Secrets location: .env.local (gitignored)
• Reference: .env.example

Production:

• Same env vars as development
• No staging environment configured

Webhooks & Callbacks

Incoming:

• None

Outgoing:

• None

API Timeout Configuration

Route	Timeout	Purpose
/api/generate	5 min	Image generation via Gemini
/api/llm	1 min	Text generation (Google/OpenAI)
/api/workflow	Default	Save/load workflow files
Other routes	Default	Various operations

Request Body Size Limits

• Server Actions body limit: 50MB - next.config.ts
• Supports large image payloads in workflows

---

Integration audit: 2026-01-09 Update when adding/removing external services