@flowuent-org/diagramming-core 1.3.10 → 1.4.1

package/packages/diagrams/src/lib/examples/GoogleSheetsConfigurationExamples.ts

@@ -1,306 +0,0 @@
-// Google Sheets API Configuration Examples
-// This file shows how to configure the automation sheet node with real Google Sheets API
-
-export const googleSheetsConfigExamples = {
-  // Example 1: Service Account Authentication
-  serviceAccountExample: {
-    spreadsheetId: '1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms',
-    sheetName: 'Data Export',
-    range: 'A1:Z1000',
-    credentials: {
-      type: 'service-account' as const,
-      serviceAccountKey: JSON.stringify({
-        type: 'service_account',
-        project_id: 'your-project-id',
-        private_key_id: 'your-private-key-id',
-        private_key:
-          '-----BEGIN PRIVATE KEY-----\nYOUR_PRIVATE_KEY_HERE\n-----END PRIVATE KEY-----\n',
-        client_email:
-          'your-service-account@your-project.iam.gserviceaccount.com',
-        client_id: 'your-client-id',
-        auth_uri: 'https://accounts.google.com/o/oauth2/auth',
-        token_uri: 'https://oauth2.googleapis.com/token',
-        auth_provider_x509_cert_url:
-          'https://www.googleapis.com/oauth2/v1/certs',
-        client_x509_cert_url:
-          'https://www.googleapis.com/robot/v1/metadata/x509/your-service-account%40your-project.iam.gserviceaccount.com',
-      }),
-      // Alternative: separate fields
-      clientEmail: 'your-service-account@your-project.iam.gserviceaccount.com',
-      privateKey:
-        '-----BEGIN PRIVATE KEY-----\nYOUR_PRIVATE_KEY_HERE\n-----END PRIVATE KEY-----\n',
-    },
-  },
-
-  // Example 2: API Key Authentication (read-only access)
-  apiKeyExample: {
-    spreadsheetId: '1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms',
-    sheetName: 'Public Data',
-    range: 'A1:F100',
-    credentials: {
-      type: 'api-key' as const,
-      apiKey: 'YOUR_GOOGLE_API_KEY_HERE',
-    },
-  },
-
-  // Example 3: OAuth Authentication (user consent required)
-  oauthExample: {
-    spreadsheetId: '1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms',
-    sheetName: 'User Data',
-    range: 'A1:Z1000',
-    credentials: {
-      type: 'oauth' as const,
-      oauthToken: 'ya29.a0AfH6SMC...', // OAuth 2.0 access token
-    },
-  },
-};
-
-export const dataMappingExamples = {
-  // Example 1: News Analysis Data
-  newsAnalysis: {
-    headers: [
-      { column: 'A', sourceField: 'title', dataType: 'string' as const },
-      { column: 'B', sourceField: 'author', dataType: 'string' as const },
-      { column: 'C', sourceField: 'published_date', dataType: 'date' as const },
-      { column: 'D', sourceField: 'summary', dataType: 'string' as const },
-      { column: 'E', sourceField: 'topics', dataType: 'string' as const },
-      { column: 'F', sourceField: 'confidence', dataType: 'number' as const },
-      { column: 'G', sourceField: 'sentiment', dataType: 'string' as const },
-      { column: 'H', sourceField: 'word_count', dataType: 'number' as const },
-    ],
-    appendMode: true,
-    clearSheet: false,
-  },
-
-  // Example 2: User Data Export
-  userData: {
-    headers: [
-      { column: 'A', sourceField: 'id', dataType: 'string' as const },
-      { column: 'B', sourceField: 'name', dataType: 'string' as const },
-      { column: 'C', sourceField: 'email', dataType: 'string' as const },
-      { column: 'D', sourceField: 'created_at', dataType: 'date' as const },
-      { column: 'E', sourceField: 'is_active', dataType: 'boolean' as const },
-      { column: 'F', sourceField: 'profile.age', dataType: 'number' as const },
-      {
-        column: 'G',
-        sourceField: 'profile.location',
-        dataType: 'string' as const,
-      },
-    ],
-    appendMode: false,
-    clearSheet: true,
-  },
-
-  // Example 3: Financial Data
-  financialData: {
-    headers: [
-      {
-        column: 'A',
-        sourceField: 'transaction_id',
-        dataType: 'string' as const,
-      },
-      { column: 'B', sourceField: 'date', dataType: 'date' as const },
-      { column: 'C', sourceField: 'amount', dataType: 'number' as const },
-      { column: 'D', sourceField: 'currency', dataType: 'string' as const },
-      { column: 'E', sourceField: 'category', dataType: 'string' as const },
-      { column: 'F', sourceField: 'description', dataType: 'string' as const },
-      {
-        column: 'G',
-        sourceField: 'is_recurring',
-        dataType: 'boolean' as const,
-      },
-    ],
-    appendMode: true,
-    clearSheet: false,
-  },
-};
-
-export const exportOptionsExamples = {
-  // Example 1: Email to multiple recipients with Excel export
-  emailExcelExport: {
-    emailRecipients: [
-      'manager@company.com',
-      'analyst@company.com',
-      'stakeholder@company.com',
-    ],
-    fileName: 'monthly_report_2024.xlsx',
-    exportFormat: 'excel' as const,
-    includeHeaders: true,
-    sendEmailNotification: true,
-  },
-
-  // Example 2: Google Sheets only with email notification
-  sheetsOnlyExport: {
-    emailRecipients: ['team@company.com'],
-    fileName: 'shared_data_sheet',
-    exportFormat: 'sheets' as const,
-    includeHeaders: true,
-    sendEmailNotification: true,
-  },
-
-  // Example 3: Both formats with multiple recipients
-  bothFormatsExport: {
-    emailRecipients: [
-      'ceo@company.com',
-      'cto@company.com',
-      'finance@company.com',
-    ],
-    fileName: 'quarterly_analysis_report',
-    exportFormat: 'both' as const,
-    includeHeaders: true,
-    sendEmailNotification: true,
-  },
-
-  // Example 4: Local download only (no email)
-  localDownloadOnly: {
-    emailRecipients: [],
-    fileName: 'local_backup_data.xlsx',
-    exportFormat: 'excel' as const,
-    includeHeaders: true,
-    sendEmailNotification: false,
-  },
-};
-
-// Complete automation sheet node configuration example
-export const completeAutomationSheetsNodeExample = {
-  nodeId: 'google-sheets-export-node',
-  title: 'Google Sheets Export',
-  type: 'sheets' as const,
-  inputVariable: 'processedData',
-  sheetsConfig: googleSheetsConfigExamples.serviceAccountExample,
-  dataMapping: dataMappingExamples.newsAnalysis,
-  exportOptions: exportOptionsExamples.bothFormatsExport,
-  outputVariable: 'sheetsResponse',
-  errorHandling: {
-    onError: 'retry' as const,
-    maxRetries: 3,
-    fallbackAction: 'log' as const,
-  },
-  isPinned: false,
-  isBlock: false,
-  blocks: [],
-  parallelChildrenCount: 0,
-  conditions: {
-    combinator: 'and' as const,
-    rules: [],
-  },
-};
-
-// Sample input data for testing
-export const sampleInputData = [
-  {
-    title: 'Breaking: New AI Technology Announced',
-    author: 'John Smith',
-    published_date: '2024-01-15',
-    summary:
-      'A revolutionary AI technology has been announced that could change the industry.',
-    topics: 'AI, Technology, Innovation',
-    confidence: 0.95,
-    sentiment: 'positive',
-    word_count: 250,
-  },
-  {
-    title: 'Market Analysis: Tech Stocks Rise',
-    author: 'Jane Doe',
-    published_date: '2024-01-14',
-    summary:
-      "Technology stocks showed significant gains in today's trading session.",
-    topics: 'Finance, Technology, Market',
-    confidence: 0.87,
-    sentiment: 'neutral',
-    word_count: 180,
-  },
-  {
-    title: 'Climate Change Summit Results',
-    author: 'Mike Johnson',
-    published_date: '2024-01-13',
-    summary:
-      'World leaders reached new agreements on climate change initiatives.',
-    topics: 'Environment, Politics, Climate',
-    confidence: 0.92,
-    sentiment: 'positive',
-    word_count: 320,
-  },
-];
-
-// Usage instructions
-export const usageInstructions = `
-# Google Sheets Automation Node Usage Guide
-
-## Setup Instructions
-
-### 1. Google Cloud Console Setup
-1. Go to Google Cloud Console (https://console.cloud.google.com/)
-2. Create a new project or select existing one
-3. Enable Google Sheets API and Google Drive API
-4. Create service account credentials:
-   - Go to IAM & Admin > Service Accounts
-   - Create new service account
-   - Download JSON key file
-   - Share your Google Sheet with the service account email
-
-### 2. Authentication Methods
-
-#### Service Account (Recommended)
-- Most secure for automated processes
-- No user interaction required
-- Use the JSON key file content in serviceAccountKey field
-
-#### API Key
-- Read-only access only
-- Good for public data access
-- Limited functionality
-
-#### OAuth
-- Full user access
-- Requires user consent
-- Good for user-specific data
-
-### 3. Configuration
-
-#### Spreadsheet Configuration
-- spreadsheetId: Found in Google Sheets URL
-- sheetName: Name of the specific sheet tab
-- range: Cell range (e.g., 'A1:Z1000')
-
-#### Data Mapping
-- Map your input data fields to spreadsheet columns
-- Support nested fields with dot notation (e.g., 'profile.age')
-- Choose appropriate data types: string, number, date, boolean
-
-#### Export Options
-- emailRecipients: Array of email addresses
-- fileName: Name for downloaded files
-- exportFormat: 'sheets', 'excel', or 'both'
-- includeHeaders: Whether to include column headers
-- sendEmailNotification: Whether to send email notifications
-
-### 4. Error Handling
-- onError: 'stop', 'retry', or 'continue'
-- maxRetries: Number of retry attempts
-- fallbackAction: 'skip', 'log', or 'notify'
-
-## Example Workflow
-
-1. Configure the automation sheet node with your Google Sheets credentials
-2. Set up data mapping for your input data structure
-3. Configure export options (email recipients, file name, format)
-4. Connect the node to your data source
-5. Execute the workflow
-6. Check email for notifications and download links
-
-## Troubleshooting
-
-### Common Issues
-1. Authentication errors: Check service account permissions
-2. Spreadsheet not found: Verify spreadsheet ID and sharing permissions
-3. Data mapping errors: Check field names and data types
-4. Email delivery issues: Verify email service configuration
-
-### Best Practices
-1. Use service account authentication for production
-2. Test with small datasets first
-3. Set appropriate error handling strategies
-4. Monitor execution logs for issues
-5. Keep credentials secure and rotate regularly
-`;