feat: Add Bigin by Zoho CRM integration piece

🚀 Feature: Bigin by Zoho CRM Integration

This PR implements a comprehensive integration piece for Bigin by Zoho CRM, addressing the feature request in issue #8601.

📋 What’s Implemented

🔐 Authentication

OAuth2 Authentication with support for all Zoho regional domains:
- United States (.com)
- Europe (.eu)
- India (.in)
- Australia (.com.au)
- Japan (.jp)
- China (.com.cn)
- Saudi Arabia (.sa)
- Canada (.ca)
Proper scope configuration for Bigin API access
Authentication validation with error handling

🔍 Search Actions (5 total)

Search Contact - Find contacts by email, name, phone, or mobile
Search Company - Find companies by name, phone, or website
Search Product - Find products by name or product code
Search Pipeline Record - Find deals by name, stage, or amount
Search User - Find users by email address

✏️ Write Actions (14 total)

Contact Management:

Create Contact - Full contact creation with all standard fields
Update Contact - Update existing contact records

Company Management:

Create Company - Company creation with billing address support
Update Company - Update existing company records

Pipeline Records (Deals):

Create Pipeline Record - Deal creation with amount, stage, closing date
Update Pipeline Record - Update existing deals

Task Management:

Create Task - Task creation with due dates, priority, status
Update Task - Update existing tasks

Event Management:

Create Event - Calendar event creation with start/end times, venues
Update Event - Update existing events

Call Logging:

Create Call - Call record creation with duration, type, status

🔔 Webhook Triggers (4 total)

New Contact - Triggers when a contact is created
Updated Contact - Triggers when a contact is modified
New Company - Triggers when a company is created
New Pipeline Record - Triggers when a deal is created

🛠️ Additional Features

Custom API Call Action - Allows arbitrary API calls to any Bigin endpoint
Comprehensive Error Handling - Proper error messages for authentication, rate limits, API errors
Field Validation - Required field validation and data cleanup
Multi-Domain Support - Dynamic API URL resolution based on selected domain

🎯 Addresses Issue Requirements

This implementation fully addresses the requirements outlined in issue #8601:

✅ Complete Bigin by Zoho CRM integration
✅ OAuth2 authentication with multi-domain support
✅ CRUD operations for all major CRM entities
✅ Search functionality across key data types
✅ Webhook triggers for real-time data synchronization
✅ Follows Activepieces coding standards and patterns

📁 Files Added

packages/pieces/community/bigin-by-zoho/
├── package.json
├── project.json
├── tsconfig.json
├── tsconfig.lib.json
├── README.md
└── src/
    ├── index.ts
    └── lib/
        ├── common/
        │   ├── auth.ts          # OAuth2 authentication configuration
        │   ├── client.ts        # API client with error handling
        │   └── utils.ts         # Utility functions and field mappings
        ├── actions/
        │   ├── search-*.ts      # 5 search actions
        │   ├── create-*.ts      # 7 create actions
        │   └── update-*.ts      # 7 update actions
        └── triggers/
            ├── new-contact.ts
            ├── updated-contact.ts
            ├── new-company.ts
            └── new-pipeline-record.ts

🧪 Testing Instructions

Prerequisites

Bigin by Zoho Account - Create a free account at bigin.zoho.com
Zoho Developer Console - Set up OAuth2 app at api-console.zoho.com
OAuth2 Credentials - Configure client ID, client secret, and redirect URLs

Authentication Testing

Configure OAuth2 credentials in Activepieces
Select appropriate domain based on account location
Complete OAuth2 flow and verify token acquisition
Test authentication validation with invalid credentials

Action Testing

Search Actions:

Test each search action with valid criteria
Verify search operators (equals, contains, starts_with, ends_with)
Test with non-existent records to verify empty results

Write Actions:

Test contact creation with required and optional fields
Test company creation with billing address
Test pipeline record creation with amount and dates
Test task creation with due dates and priorities
Test event creation with start/end times
Test call logging with duration and status
Verify update operations modify existing records correctly

Triggers:

Set up webhook triggers in test flows
Create/update records in Bigin to verify trigger firing
Verify payload structure matches expected format

Error Handling Testing

Test with invalid authentication tokens
Test with malformed API requests
Test rate limiting scenarios
Verify proper error messages are displayed

🔍 Code Quality

✅ TypeScript Compilation - No compilation errors
✅ Code Standards - Follows Activepieces patterns and conventions
✅ Error Handling - Comprehensive error handling throughout
✅ Documentation - Inline comments and README documentation
✅ Type Safety - Proper TypeScript types and interfaces
✅ Modularity - Clean separation of concerns and reusable components

📚 API Documentation

This integration is built against the official Bigin by Zoho API v2:

Closes #8601

/claim #8601