twenty/packages/twenty-apps/fireflies/CHANGELOG.md

Changelog

[0.2.1] - 2025-11-03

Added

• Import status tracking: Added four new meeting fields to track import status and failure handling:
  • importStatus (SELECT) - Tracks SUCCESS, FAILED, PENDING, RETRYING states
  • importError (TEXT) - Stores error messages when imports fail
  • lastImportAttempt (DATE_TIME) - Timestamp of the last import attempt
  • importAttempts (NUMBER) - Counter for number of import attempts
• Automatic failure tracking: Enhanced webhook handler to automatically create failed meeting records when processing fails
• Failed meeting formatter: Added toFailedMeetingCreateInput() method to create standardized failed meeting records

Enhanced

• Meeting type definition: Extended MeetingCreateInput type with import tracking fields
• Success status tracking: Successful meeting imports now automatically set importStatus: 'SUCCESS' and track timestamps
• Error handling: Webhook processing failures are now captured and stored as meeting records for visibility and potential retry

[0.2.0] - 2025-11-03

Changed

• Major refactoring: Split monolithic receive-fireflies-notes.ts into modular architecture:
  • fireflies-api-client.ts - Fireflies GraphQL API integration with retry logic
  • twenty-crm-service.ts - Twenty CRM operations (contacts, notes, meetings)
  • formatters.ts - Meeting and note body formatting
  • webhook-handler.ts - Main webhook orchestration
  • webhook-validator.ts - HMAC signature verification
  • utils.ts - Shared utility functions
  • types.ts - Centralized type definitions
• Schema update: Changed Meeting notes field from RICH_TEXT to RELATION type linking to Note object
• Enhanced participant extraction from multiple Fireflies API data sources (participants, meeting_attendees, speakers, meeting_attendance)
• Improved organizer email matching with name-based heuristics
• Updated note creation to use bodyV2.markdown format instead of legacy body field
• Modernized Meeting object schema with proper link field types for transcriptUrl and recordingUrl
• Enhanced test suite with improved mocking for new modular structure
• Configuration optimization: Reduced default retry attempts from 30 to 5 with increased delay (120s) to better respect Fireflies API rate limits (50 requests/day for free/pro plans)
• Updated field setup script to support relation field creation with Note object
• Restructured exports: types now exported from types.ts, runtime functions from index.ts
• Updated import paths in action handlers to use centralized index exports
• Added TypeScript path mappings for twenty-sdk in workspace configuration

Added

• createNoteTarget method for linking notes to multiple participants
• Support for extracting participants from extended Fireflies API response formats
• Better organizer identification logic matching email usernames to speaker names
• axios dependency for improved HTTP client capabilities
• API subscription plan documentation highlighting rate limit differences (50/day vs 60/minute)
• Enhanced README with rate limiting guidance and configuration documentation
• Relation field creation support in field provisioning script

Fixed

• Note linking now properly associates a single note with multiple participants in 1:1 meetings
• Participant extraction handles missing email addresses gracefully
• Improved handling of various Fireflies participant data structures
• Test mocks updated to use string format for participants ("Name <email>") matching Fireflies API response format
• Test assertions updated to validate bodyV2.markdown instead of deprecated body field

[0.1.0] - 2025-11-02

Added

• HMAC SHA-256 signature verification for incoming Fireflies webhooks
• Fireflies GraphQL client with retry logic, timeout handling, and summary readiness detection
• Summary-focused meeting processing that extracts action items, sentiment, keywords, and transcript/recording links
• Scripted custom field provisioning via yarn setup:fields
• Local webhook testing workflow via yarn test:webhook
• Comprehensive Jest suite (15 tests) covering authentication, API integration, summary strategies, and error handling

Changed

• Replaced legacy JSON manifests with TypeScript configuration:
  • application.config.ts now declares app metadata and configuration variables
  • src/objects/meeting.ts defines the Meeting object via @ObjectMetadata
  • src/actions/receive-fireflies-notes.ts exports the Fireflies webhook action plus its runtime config
• Updated documentation (README, Deployment Guide, Testing) to reflect the new project layout and workflows
• Switched utility scripts to tsx and aligned package management with the hello-world example

Fixed

• Resolved real-world Fireflies payload mismatch by adopting the minimal webhook schema
• Replaced body-based secrets with header-driven HMAC verification
• Ensured graceful degradation when summaries are pending or Fireflies is temporarily unavailable