@bubblelab/bubble-core 0.1.19 → 0.1.20

package/dist/bubbles.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "generatedAt": "2026-01-19T12:59:03.762Z",
+  "generatedAt": "2026-01-19T17:35:58.866Z",
   "totalCount": 50,
   "bubbles": [
     {
@@ -119,7 +119,7 @@
       "useCase": "- Upload files and documents to Google Drive",
       "inputSchema": "Complex schema - see usage example for structure",
       "outputSchema": "Complex schema - see usage example for structure",
-      "usageExample": "// Upload File example\nconst googleDrive_upload_file = new GoogleDriveBubble({\n  operation: \"upload_file\", // Upload a file to Google Drive\n  name: \"example string\", // Name for the uploaded file\n  content: \"example string\", // File content as base64 encoded string or plain text\n  mimeType: \"example string\", // MIME type of the file (auto-detected if not provided)\n  parent_folder_id: \"example string\", // ID of the parent folder (uploads to root if not provided)\n  convert_to_google_docs: false // default, // Convert uploaded file to Google Docs format if possible\n});\n\nconst result = await googleDrive_upload_file.action();\n// outputSchema for result.data when operation === 'upload_file':\n// {\n//   operation: \"upload_file\" // Upload a file to Google Drive,\n//   success: boolean // Whether the file was uploaded successfully,\n//   file: { id: string // Unique file identifier, name: string // Name of the file, mimeType: string // MIME type of the file, size: string | undefined // Size of the file in bytes, createdTime: string | undefined // Creation time in RFC 3339 format, modifiedTime: string | undefined // Last modified time in RFC 3339 format, webViewLink: string | undefined // Link to view the file in Google Drive, webContentLink: string | undefined // Link to download the file, parents: string[] | undefined // Parent folder IDs, shared: boolean | undefined // Whether the file is shared, owners: { displayName: string | undefined // Owner display name, emailAddress: string | undefined // Owner email address }[] | undefined // File owners } | undefined // Uploaded file metadata,\n//   error: string // Error message if operation failed\n// }\n\n\n// Download File example\nconst googleDrive_download_file = new GoogleDriveBubble({\n  operation: \"download_file\", // Download a file from Google Drive\n  file_id: \"example string\", // Google Drive file ID to download\n  export_format: \"example string\", // Export format for Google Workspace files (e.g., \"application/pdf\", \"text/plain\")\n});\n\nconst result = await googleDrive_download_file.action();\n// outputSchema for result.data when operation === 'download_file':\n// {\n//   operation: \"download_file\" // Download a file from Google Drive,\n//   success: boolean // Whether the file was downloaded successfully,\n//   content: string | undefined // File content as plain text (for text-based files) or base64 encoded string (for binary files),\n//   filename: string | undefined // Original filename,\n//   mimeType: string | undefined // MIME type of the downloaded file,\n//   error: string // Error message if operation failed\n// }\n\n\n// List Files example\nconst googleDrive_list_files = new GoogleDriveBubble({\n  operation: \"list_files\", // List files and folders in Google Drive\n  folder_id: \"example string\", // ID of folder to list files from (lists from root if not provided)\n  query: \"example string\", // Search query to filter files (e.g., \"name contains 'report'\"\n  max_results: 100 // default, // Maximum number of files to return\n  include_folders: true // default, // Include folders in the results\n  order_by: \"modifiedTime desc\" // default, // Order results by field (e.g., \"name\", \"modifiedTime desc\")\n});\n\nconst result = await googleDrive_list_files.action();\n// outputSchema for result.data when operation === 'list_files':\n// {\n//   operation: \"list_files\" // List files and folders in Google Drive,\n//   success: boolean // Whether the file list was retrieved successfully,\n//   files: { id: string // Unique file identifier, name: string // Name of the file, mimeType: string // MIME type of the file, size: string | undefined // Size of the file in bytes, createdTime: string | undefined // Creation time in RFC 3339 format, modifiedTime: string | undefined // Last modified time in RFC 3339 format, webViewLink: string | undefined // Link to view the file in Google Drive, webContentLink: string | undefined // Link to download the file, parents: string[] | undefined // Parent folder IDs, shared: boolean | undefined // Whether the file is shared, owners: { displayName: string | undefined // Owner display name, emailAddress: string | undefined // Owner email address }[] | undefined // File owners }[] | undefined // List of files and folders,\n//   total_count: number | undefined // Total number of files found,\n//   next_page_token: string | undefined // Token for fetching next page of results,\n//   error: string // Error message if operation failed\n// }\n\n\n// Create Folder example\nconst googleDrive_create_folder = new GoogleDriveBubble({\n  operation: \"create_folder\", // Create a new folder in Google Drive\n  name: \"example string\", // Name of the folder to create\n  parent_folder_id: \"example string\", // ID of the parent folder (creates in root if not provided)\n});\n\nconst result = await googleDrive_create_folder.action();\n// outputSchema for result.data when operation === 'create_folder':\n// {\n//   operation: \"create_folder\" // Create a new folder in Google Drive,\n//   success: boolean // Whether the folder was created successfully,\n//   folder: { id: string // Unique folder identifier, name: string // Name of the folder, webViewLink: string | undefined // Link to view the folder in Google Drive, parents: string[] | undefined // Parent folder IDs } | undefined // Created folder metadata,\n//   error: string // Error message if operation failed\n// }\n\n\n// Delete File example\nconst googleDrive_delete_file = new GoogleDriveBubble({\n  operation: \"delete_file\", // Delete a file or folder from Google Drive\n  file_id: \"example string\", // Google Drive file or folder ID to delete\n  permanent: false // default, // Permanently delete (true) or move to trash (false)\n});\n\nconst result = await googleDrive_delete_file.action();\n// outputSchema for result.data when operation === 'delete_file':\n// {\n//   operation: \"delete_file\" // Delete a file or folder from Google Drive,\n//   success: boolean // Whether the file was deleted successfully,\n//   deleted_file_id: string | undefined // ID of the deleted file,\n//   error: string // Error message if operation failed\n// }\n\n\n// Get File Info example\nconst googleDrive_get_file_info = new GoogleDriveBubble({\n  operation: \"get_file_info\", // Get detailed information about a file or folder\n  file_id: \"example string\", // Google Drive file or folder ID to get info for\n  include_permissions: false // default, // Include file permissions in the response\n});\n\nconst result = await googleDrive_get_file_info.action();\n// outputSchema for result.data when operation === 'get_file_info':\n// {\n//   operation: \"get_file_info\" // Get detailed information about a file or folder,\n//   success: boolean // Whether the file information was retrieved successfully,\n//   file: { id: string // Unique file identifier, name: string // Name of the file, mimeType: string // MIME type of the file, size: string | undefined // Size of the file in bytes, createdTime: string | undefined // Creation time in RFC 3339 format, modifiedTime: string | undefined // Last modified time in RFC 3339 format, webViewLink: string | undefined // Link to view the file in Google Drive, webContentLink: string | undefined // Link to download the file, parents: string[] | undefined // Parent folder IDs, shared: boolean | undefined // Whether the file is shared, owners: { displayName: string | undefined // Owner display name, emailAddress: string | undefined // Owner email address }[] | undefined // File owners } | undefined // File metadata and information,\n//   permissions: { id: string, type: string, role: string, emailAddress: string | undefined // Permission holder email address, displayName: string | undefined // Permission holder display name }[] | undefined // File permissions (if requested),\n//   error: string // Error message if operation failed\n// }\n\n\n// Share File example\nconst googleDrive_share_file = new GoogleDriveBubble({\n  operation: \"share_file\", // Share a file or folder with specific users or make it public\n  file_id: \"example string\", // Google Drive file or folder ID to share\n  email_address: \"example string\", // Email address to share with (for specific user sharing)\n  role: \"reader\" // options: \"reader\", \"writer\", \"commenter\", \"owner\", // Permission role to grant\n  type: \"user\" // options: \"user\", \"group\", \"domain\", \"anyone\", // Type of permission to create\n  send_notification: true // default, // Send notification email to the user\n});\n\nconst result = await googleDrive_share_file.action();\n// outputSchema for result.data when operation === 'share_file':\n// {\n//   operation: \"share_file\" // Share a file or folder with specific users or make it public,\n//   success: boolean // Whether the file was shared successfully,\n//   permission_id: string | undefined // ID of the created permission,\n//   share_link: string | undefined // Shareable link to the file,\n//   error: string // Error message if operation failed\n// }\n\n\n// Move File example\nconst googleDrive_move_file = new GoogleDriveBubble({\n  operation: \"move_file\", // Move a file or folder to a different location in Google Drive\n  file_id: \"example string\", // Google Drive file or folder ID to move\n  new_parent_folder_id: \"example string\", // ID of the new parent folder (moves to root if not provided)\n  remove_parent_folder_id: \"example string\", // ID of the parent folder to remove (removes from all parents if not provided)\n});\n\nconst result = await googleDrive_move_file.action();\n// outputSchema for result.data when operation === 'move_file':\n// {\n//   operation: \"move_file\" // Move a file or folder to a different location in Google Drive,\n//   success: boolean // Whether the file was moved successfully,\n//   file: { id: string // Unique file identifier, name: string // Name of the file, mimeType: string // MIME type of the file, size: string | undefined // Size of the file in bytes, createdTime: string | undefined // Creation time in RFC 3339 format, modifiedTime: string | undefined // Last modified time in RFC 3339 format, webViewLink: string | undefined // Link to view the file in Google Drive, webContentLink: string | undefined // Link to download the file, parents: string[] | undefined // Parent folder IDs, shared: boolean | undefined // Whether the file is shared, owners: { displayName: string | undefined // Owner display name, emailAddress: string | undefined // Owner email address }[] | undefined // File owners } | undefined // Updated file metadata after move,\n//   error: string // Error message if operation failed\n// }\n\n\n// Always check success status before using data\nif (!result.success) {\n  throw new Error(`google-drive failed: ${result.error}`);\n}\n\n// Access the actual data\nconst actualData = result.data;\nconsole.log(actualData);",
+      "usageExample": "// Upload File example\nconst googleDrive_upload_file = new GoogleDriveBubble({\n  operation: \"upload_file\", // Upload a file to Google Drive\n  name: \"example string\", // Name for the uploaded file\n  content: \"example string\", // File content as base64 encoded string or plain text\n  mimeType: \"example string\", // MIME type of the file (auto-detected if not provided)\n  parent_folder_id: \"example string\", // ID of the parent folder (uploads to root if not provided)\n  convert_to_google_docs: false // default, // Convert uploaded file to Google Docs format if possible\n});\n\nconst result = await googleDrive_upload_file.action();\n// outputSchema for result.data when operation === 'upload_file':\n// {\n//   operation: \"upload_file\" // Upload a file to Google Drive,\n//   success: boolean // Whether the file was uploaded successfully,\n//   file: { id: string // Unique file identifier, name: string // Name of the file, mimeType: string // MIME type of the file, size: string | undefined // Size of the file in bytes, createdTime: string | undefined // Creation time in RFC 3339 format, modifiedTime: string | undefined // Last modified time in RFC 3339 format, webViewLink: string | undefined // Link to view the file in Google Drive, webContentLink: string | undefined // Link to download the file, parents: string[] | undefined // Parent folder IDs, shared: boolean | undefined // Whether the file is shared, owners: { displayName: string | undefined // Owner display name, emailAddress: string | undefined // Owner email address }[] | undefined // File owners } | undefined // Uploaded file metadata,\n//   error: string // Error message if operation failed\n// }\n\n\n// Download File example\nconst googleDrive_download_file = new GoogleDriveBubble({\n  operation: \"download_file\", // Download a file from Google Drive\n  file_id: \"example string\", // Google Drive file ID to download\n  export_format: \"example string\", // Export format for Google Workspace files (e.g., \"application/pdf\", \"text/plain\")\n});\n\nconst result = await googleDrive_download_file.action();\n// outputSchema for result.data when operation === 'download_file':\n// {\n//   operation: \"download_file\" // Download a file from Google Drive,\n//   success: boolean // Whether the file was downloaded successfully,\n//   content: string | undefined // File content as plain text (for text-based files) or base64 encoded string (for binary files),\n//   filename: string | undefined // Original filename,\n//   mimeType: string | undefined // MIME type of the downloaded file,\n//   error: string // Error message if operation failed\n// }\n\n\n// List Files example\nconst googleDrive_list_files = new GoogleDriveBubble({\n  operation: \"list_files\", // List files and folders in Google Drive\n  folder_id: \"example string\", // ID of folder to list files from (lists from root if not provided)\n  query: \"example string\", // Search query to filter files (e.g., \"name contains 'report'\"\n  max_results: 100 // default, // Maximum number of files to return\n  include_folders: true // default, // Include folders in the results\n  order_by: \"modifiedTime desc\" // default, // Order results by field (e.g., \"name\", \"modifiedTime desc\")\n});\n\nconst result = await googleDrive_list_files.action();\n// outputSchema for result.data when operation === 'list_files':\n// {\n//   operation: \"list_files\" // List files and folders in Google Drive,\n//   success: boolean // Whether the file list was retrieved successfully,\n//   files: { id: string // Unique file identifier, name: string // Name of the file, mimeType: string // MIME type of the file, size: string | undefined // Size of the file in bytes, createdTime: string | undefined // Creation time in RFC 3339 format, modifiedTime: string | undefined // Last modified time in RFC 3339 format, webViewLink: string | undefined // Link to view the file in Google Drive, webContentLink: string | undefined // Link to download the file, parents: string[] | undefined // Parent folder IDs, shared: boolean | undefined // Whether the file is shared, owners: { displayName: string | undefined // Owner display name, emailAddress: string | undefined // Owner email address }[] | undefined // File owners }[] | undefined // List of files and folders,\n//   total_count: number | undefined // Total number of files found,\n//   next_page_token: string | undefined // Token for fetching next page of results,\n//   error: string // Error message if operation failed\n// }\n\n\n// Create Folder example\nconst googleDrive_create_folder = new GoogleDriveBubble({\n  operation: \"create_folder\", // Create a new folder in Google Drive\n  name: \"example string\", // Name of the folder to create\n  parent_folder_id: \"example string\", // ID of the parent folder (creates in root if not provided)\n});\n\nconst result = await googleDrive_create_folder.action();\n// outputSchema for result.data when operation === 'create_folder':\n// {\n//   operation: \"create_folder\" // Create a new folder in Google Drive,\n//   success: boolean // Whether the folder was created successfully,\n//   folder: { id: string // Unique folder identifier, name: string // Name of the folder, webViewLink: string | undefined // Link to view the folder in Google Drive, parents: string[] | undefined // Parent folder IDs } | undefined // Created folder metadata,\n//   error: string // Error message if operation failed\n// }\n\n\n// Delete File example\nconst googleDrive_delete_file = new GoogleDriveBubble({\n  operation: \"delete_file\", // Delete a file or folder from Google Drive\n  file_id: \"example string\", // Google Drive file or folder ID to delete\n  permanent: false // default, // Permanently delete (true) or move to trash (false)\n});\n\nconst result = await googleDrive_delete_file.action();\n// outputSchema for result.data when operation === 'delete_file':\n// {\n//   operation: \"delete_file\" // Delete a file or folder from Google Drive,\n//   success: boolean // Whether the file was deleted successfully,\n//   deleted_file_id: string | undefined // ID of the deleted file,\n//   error: string // Error message if operation failed\n// }\n\n\n// Get File Info example\nconst googleDrive_get_file_info = new GoogleDriveBubble({\n  operation: \"get_file_info\", // Get detailed information about a file or folder\n  file_id: \"example string\", // Google Drive file or folder ID to get info for\n  include_permissions: false // default, // Include file permissions in the response\n});\n\nconst result = await googleDrive_get_file_info.action();\n// outputSchema for result.data when operation === 'get_file_info':\n// {\n//   operation: \"get_file_info\" // Get detailed information about a file or folder,\n//   success: boolean // Whether the file information was retrieved successfully,\n//   file: { id: string // Unique file identifier, name: string // Name of the file, mimeType: string // MIME type of the file, size: string | undefined // Size of the file in bytes, createdTime: string | undefined // Creation time in RFC 3339 format, modifiedTime: string | undefined // Last modified time in RFC 3339 format, webViewLink: string | undefined // Link to view the file in Google Drive, webContentLink: string | undefined // Link to download the file, parents: string[] | undefined // Parent folder IDs, shared: boolean | undefined // Whether the file is shared, owners: { displayName: string | undefined // Owner display name, emailAddress: string | undefined // Owner email address }[] | undefined // File owners } | undefined // File metadata and information,\n//   permissions: { id: string, type: string, role: string, emailAddress: string | undefined // Permission holder email address, displayName: string | undefined // Permission holder display name }[] | undefined // File permissions (if requested),\n//   error: string // Error message if operation failed\n// }\n\n\n// Share File example\nconst googleDrive_share_file = new GoogleDriveBubble({\n  operation: \"share_file\", // Share a file or folder with specific users or make it public\n  file_id: \"example string\", // Google Drive file or folder ID to share\n  email_address: \"example string\", // Email address to share with (for specific user sharing)\n  role: \"reader\" // options: \"reader\", \"writer\", \"commenter\", \"owner\", // Permission role to grant\n  type: \"user\" // options: \"user\", \"group\", \"domain\", \"anyone\", // Type of permission to create\n  send_notification: true // default, // Send notification email to the user\n});\n\nconst result = await googleDrive_share_file.action();\n// outputSchema for result.data when operation === 'share_file':\n// {\n//   operation: \"share_file\" // Share a file or folder with specific users or make it public,\n//   success: boolean // Whether the file was shared successfully,\n//   permission_id: string | undefined // ID of the created permission,\n//   share_link: string | undefined // Shareable link to the file,\n//   error: string // Error message if operation failed\n// }\n\n\n// Move File example\nconst googleDrive_move_file = new GoogleDriveBubble({\n  operation: \"move_file\", // Move a file or folder to a different location in Google Drive\n  file_id: \"example string\", // Google Drive file or folder ID to move\n  new_parent_folder_id: \"example string\", // ID of the new parent folder (moves to root if not provided)\n  remove_parent_folder_id: \"example string\", // ID of the parent folder to remove (removes from all parents if not provided)\n});\n\nconst result = await googleDrive_move_file.action();\n// outputSchema for result.data when operation === 'move_file':\n// {\n//   operation: \"move_file\" // Move a file or folder to a different location in Google Drive,\n//   success: boolean // Whether the file was moved successfully,\n//   file: { id: string // Unique file identifier, name: string // Name of the file, mimeType: string // MIME type of the file, size: string | undefined // Size of the file in bytes, createdTime: string | undefined // Creation time in RFC 3339 format, modifiedTime: string | undefined // Last modified time in RFC 3339 format, webViewLink: string | undefined // Link to view the file in Google Drive, webContentLink: string | undefined // Link to download the file, parents: string[] | undefined // Parent folder IDs, shared: boolean | undefined // Whether the file is shared, owners: { displayName: string | undefined // Owner display name, emailAddress: string | undefined // Owner email address }[] | undefined // File owners } | undefined // Updated file metadata after move,\n//   error: string // Error message if operation failed\n// }\n\n\n// Get Doc example\nconst googleDrive_get_doc = new GoogleDriveBubble({\n  operation: \"get_doc\", // Get the content and metadata of a Google Doc using the Google Docs API, use this over download_file for Google Docs\n  document_id: \"example string\", // The ID of the Google Doc to retrieve\n});\n\nconst result = await googleDrive_get_doc.action();\n// outputSchema for result.data when operation === 'get_doc':\n// {\n//   operation: \"get_doc\" // Get the content and metadata of a Google Doc using the Google Docs API,\n//   success: boolean // Whether the document was retrieved successfully,\n//   document: { documentId: string // The ID of the document, title: string // The title of the document, revisionId: string | undefined // The revision ID of the document, body: Record<string, unknown> | undefined // The main body of the document containing content array, suggestionsViewMode: string | undefined // The suggestions view mode applied to the document, inlineObjects: Record<string, unknown> | undefined // The inline objects (images, etc.) in the document, lists: Record<string, unknown> | undefined // The lists in the document, keyed by list ID } | undefined // The Google Docs document content and metadata,\n//   plainText: string | undefined // Extracted plain text content from the document,\n//   error: string // Error message if operation failed\n// }\n\n\n// Always check success status before using data\nif (!result.success) {\n  throw new Error(`google-drive failed: ${result.error}`);\n}\n\n// Access the actual data\nconst actualData = result.data;\nconsole.log(actualData);",
       "requiredCredentials": [
         "GOOGLE_DRIVE_CRED"
       ]
@@ -158,7 +158,7 @@
       "useCase": "- List calendars and events with filters and pagination",
       "inputSchema": "Complex schema - see usage example for structure",
       "outputSchema": "Complex schema - see usage example for structure",
-      "usageExample": "// List Calendars example\nconst googleCalendar_list_calendars = new GoogleCalendarBubble({\n  operation: \"list_calendars\", // List calendars for the user\n  max_results: 50 // default, // Maximum number of calendars to return\n  page_token: \"example string\", // Token for fetching next page\n});\n\nconst result = await googleCalendar_list_calendars.action();\n// outputSchema for result.data when operation === 'list_calendars':\n// {\n//   operation: \"list_calendars\" // List calendars for the user,\n//   success: boolean // Whether the calendar list was retrieved successfully,\n//   calendars: { id: string // Calendar ID, summary: string | undefined // Calendar title, description: string | undefined // Calendar description, timeZone: string | undefined // Calendar time zone, selected: boolean | undefined // Whether this calendar is selected, accessRole: \"freeBusyReader\" | \"reader\" | \"writer\" | \"owner\" | undefined // Access role for the user }[] | undefined // List of calendars,\n//   next_page_token: string | undefined // Token for fetching next page,\n//   error: string // Error message if operation failed\n// }\n\n\n// List Events example\nconst googleCalendar_list_events = new GoogleCalendarBubble({\n  operation: \"list_events\", // List events in a calendar\n  calendar_id: \"primary\" // default, // Calendar ID\n  time_min: \"example string\", // Lower bound (RFC3339 timestamp)\n  time_max: \"example string\", // Upper bound (RFC3339 timestamp)\n  q: \"example string\", // Free text search query\n  single_events: true // default, // Expand recurring events\n  order_by: \"startTime\" // options: \"startTime\", \"updated\", // Sort order\n  page_token: \"example string\", // Token for fetching next page\n  max_results: 50 // default, // Maximum number of events to return\n});\n\nconst result = await googleCalendar_list_events.action();\n// outputSchema for result.data when operation === 'list_events':\n// {\n//   operation: \"list_events\" // List events in a calendar,\n//   success: boolean // Whether the event list was retrieved successfully,\n//   events: { id: string // Event ID, status: string | undefined // Event status (confirmed, tentative, cancelled), htmlLink: string | undefined // Link to the event in Calendar UI, created: string | undefined // Event creation timestamp, updated: string | undefined // Event last updated timestamp, summary: string | undefined // Event title, description: string | undefined // Event description, location: string | undefined // Event location, start: { dateTime: string | undefined // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: string | undefined // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: string | undefined // Time zone for the event time } | undefined // Event start date/time, end: { dateTime: string | undefined // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: string | undefined // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: string | undefined // Time zone for the event time } | undefined // Event end date/time, attendees: { email: string // Attendee email, optional: boolean | undefined // Whether this attendee is optional, responseStatus: \"needsAction\" | \"declined\" | \"tentative\" | \"accepted\" | undefined // Response status of the attendee, displayName: string | undefined // Display name of the attendee }[] | undefined // List of event attendees, organizer: { email: string | undefined // Organizer email address, displayName: string | undefined // Organizer display name } | undefined // Event organizer information, hangoutLink: string | undefined // Google Hangout/Meet link for the event, conferenceData: unknown | undefined // Conference data for virtual meetings }[] | undefined // List of events,\n//   next_page_token: string | undefined // Token for fetching next page,\n//   error: string // Error message if operation failed\n// }\n\n\n// Get Event example\nconst googleCalendar_get_event = new GoogleCalendarBubble({\n  operation: \"get_event\", // Get a single event\n  calendar_id: \"primary\" // default, // Calendar ID\n  event_id: \"example string\", // Event ID to retrieve\n});\n\nconst result = await googleCalendar_get_event.action();\n// outputSchema for result.data when operation === 'get_event':\n// {\n//   operation: \"get_event\" // Get a single event,\n//   success: boolean // Whether the event was retrieved successfully,\n//   event: { id: string // Event ID, status: string | undefined // Event status (confirmed, tentative, cancelled), htmlLink: string | undefined // Link to the event in Calendar UI, created: string | undefined // Event creation timestamp, updated: string | undefined // Event last updated timestamp, summary: string | undefined // Event title, description: string | undefined // Event description, location: string | undefined // Event location, start: { dateTime: string | undefined // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: string | undefined // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: string | undefined // Time zone for the event time } | undefined // Event start date/time, end: { dateTime: string | undefined // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: string | undefined // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: string | undefined // Time zone for the event time } | undefined // Event end date/time, attendees: { email: string // Attendee email, optional: boolean | undefined // Whether this attendee is optional, responseStatus: \"needsAction\" | \"declined\" | \"tentative\" | \"accepted\" | undefined // Response status of the attendee, displayName: string | undefined // Display name of the attendee }[] | undefined // List of event attendees, organizer: { email: string | undefined // Organizer email address, displayName: string | undefined // Organizer display name } | undefined // Event organizer information, hangoutLink: string | undefined // Google Hangout/Meet link for the event, conferenceData: unknown | undefined // Conference data for virtual meetings } | undefined // Event details,\n//   error: string // Error message if operation failed\n// }\n\n\n// Create Event example\nconst googleCalendar_create_event = new GoogleCalendarBubble({\n  operation: \"create_event\", // Create an event\n  calendar_id: \"primary\" // default, // Calendar ID\n  summary: \"example string\", // Event title\n  description: \"example string\", // Event description\n  location: \"example string\", // Event location\n  start: { dateTime: \"example string\" // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: \"example string\" // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: \"example string\" // Time zone for the event time }, // Start date/time\n  end: { dateTime: \"example string\" // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: \"example string\" // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: \"example string\" // Time zone for the event time }, // End date/time\n  attendees: [{ email: \"example string\" // Attendee email, optional: true // Whether this attendee is optional, responseStatus: \"needsAction\" // options: \"needsAction\", \"declined\", \"tentative\", \"accepted\" // Response status of the attendee, displayName: \"example string\" // Display name of the attendee }], // List of event attendees\n  conference: false // default, // Create a Google Meet conference link\n});\n\nconst result = await googleCalendar_create_event.action();\n// outputSchema for result.data when operation === 'create_event':\n// {\n//   operation: \"create_event\" // Create an event,\n//   success: boolean // Whether the event was created successfully,\n//   event: { id: string // Event ID, status: string | undefined // Event status (confirmed, tentative, cancelled), htmlLink: string | undefined // Link to the event in Calendar UI, created: string | undefined // Event creation timestamp, updated: string | undefined // Event last updated timestamp, summary: string | undefined // Event title, description: string | undefined // Event description, location: string | undefined // Event location, start: { dateTime: string | undefined // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: string | undefined // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: string | undefined // Time zone for the event time } | undefined // Event start date/time, end: { dateTime: string | undefined // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: string | undefined // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: string | undefined // Time zone for the event time } | undefined // Event end date/time, attendees: { email: string // Attendee email, optional: boolean | undefined // Whether this attendee is optional, responseStatus: \"needsAction\" | \"declined\" | \"tentative\" | \"accepted\" | undefined // Response status of the attendee, displayName: string | undefined // Display name of the attendee }[] | undefined // List of event attendees, organizer: { email: string | undefined // Organizer email address, displayName: string | undefined // Organizer display name } | undefined // Event organizer information, hangoutLink: string | undefined // Google Hangout/Meet link for the event, conferenceData: unknown | undefined // Conference data for virtual meetings } | undefined // Created event details,\n//   error: string // Error message if operation failed\n// }\n\n\n// Update Event example\nconst googleCalendar_update_event = new GoogleCalendarBubble({\n  operation: \"update_event\", // Update an existing event\n  calendar_id: \"primary\" // default, // Calendar ID\n  event_id: \"example string\", // Event ID to update\n  summary: \"example string\", // Event title\n  description: \"example string\", // Event description\n  location: \"example string\", // Event location\n  start: { dateTime: \"example string\" // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: \"example string\" // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: \"example string\" // Time zone for the event time }, // Start date/time\n  end: { dateTime: \"example string\" // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: \"example string\" // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: \"example string\" // Time zone for the event time }, // End date/time\n  attendees: [{ email: \"example string\" // Attendee email, optional: true // Whether this attendee is optional, responseStatus: \"needsAction\" // options: \"needsAction\", \"declined\", \"tentative\", \"accepted\" // Response status of the attendee, displayName: \"example string\" // Display name of the attendee }], // List of event attendees\n});\n\nconst result = await googleCalendar_update_event.action();\n// outputSchema for result.data when operation === 'update_event':\n// {\n//   operation: \"update_event\" // Update an existing event,\n//   success: boolean // Whether the event was updated successfully,\n//   event: { id: string // Event ID, status: string | undefined // Event status (confirmed, tentative, cancelled), htmlLink: string | undefined // Link to the event in Calendar UI, created: string | undefined // Event creation timestamp, updated: string | undefined // Event last updated timestamp, summary: string | undefined // Event title, description: string | undefined // Event description, location: string | undefined // Event location, start: { dateTime: string | undefined // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: string | undefined // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: string | undefined // Time zone for the event time } | undefined // Event start date/time, end: { dateTime: string | undefined // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: string | undefined // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: string | undefined // Time zone for the event time } | undefined // Event end date/time, attendees: { email: string // Attendee email, optional: boolean | undefined // Whether this attendee is optional, responseStatus: \"needsAction\" | \"declined\" | \"tentative\" | \"accepted\" | undefined // Response status of the attendee, displayName: string | undefined // Display name of the attendee }[] | undefined // List of event attendees, organizer: { email: string | undefined // Organizer email address, displayName: string | undefined // Organizer display name } | undefined // Event organizer information, hangoutLink: string | undefined // Google Hangout/Meet link for the event, conferenceData: unknown | undefined // Conference data for virtual meetings } | undefined // Updated event details,\n//   error: string // Error message if operation failed\n// }\n\n\n// Delete Event example\nconst googleCalendar_delete_event = new GoogleCalendarBubble({\n  operation: \"delete_event\", // Delete an event\n  calendar_id: \"primary\" // default, // Calendar ID\n  event_id: \"example string\", // Event ID to delete\n  send_updates: \"all\" // options: \"all\", \"externalOnly\", \"none\", // Whether to notify attendees\n});\n\nconst result = await googleCalendar_delete_event.action();\n// outputSchema for result.data when operation === 'delete_event':\n// {\n//   operation: \"delete_event\" // Delete an event,\n//   success: boolean // Whether the event was deleted successfully,\n//   deleted: boolean | undefined // Whether the event was actually deleted,\n//   error: string // Error message if operation failed\n// }\n\n\n// Always check success status before using data\nif (!result.success) {\n  throw new Error(`google-calendar failed: ${result.error}`);\n}\n\n// Access the actual data\nconst actualData = result.data;\nconsole.log(actualData);",
+      "usageExample": "// List Calendars example\nconst googleCalendar_list_calendars = new GoogleCalendarBubble({\n  operation: \"list_calendars\", // List calendars for the user\n  max_results: 50 // default, // Maximum number of calendars to return\n  page_token: \"example string\", // Token for fetching next page\n});\n\nconst result = await googleCalendar_list_calendars.action();\n// outputSchema for result.data when operation === 'list_calendars':\n// {\n//   operation: \"list_calendars\" // List calendars for the user,\n//   success: boolean // Whether the calendar list was retrieved successfully,\n//   calendars: { id: string // Calendar ID, summary: string | undefined // Calendar title, description: string | undefined // Calendar description, timeZone: string | undefined // Calendar time zone, selected: boolean | undefined // Whether this calendar is selected, accessRole: \"freeBusyReader\" | \"reader\" | \"writer\" | \"owner\" | undefined // Access role for the user }[] | undefined // List of calendars,\n//   next_page_token: string | undefined // Token for fetching next page,\n//   error: string // Error message if operation failed\n// }\n\n\n// List Events example\nconst googleCalendar_list_events = new GoogleCalendarBubble({\n  operation: \"list_events\", // List events in a calendar\n  calendar_id: \"primary\" // default, // Calendar ID\n  time_min: \"example string\", // Lower bound (RFC3339 timestamp)\n  time_max: \"example string\", // Upper bound (RFC3339 timestamp)\n  q: \"example string\", // Free text search query\n  single_events: true // default, // Expand recurring events\n  order_by: \"startTime\" // options: \"startTime\", \"updated\", // Sort order\n  page_token: \"example string\", // Token for fetching next page\n  max_results: 50 // default, // Maximum number of events to return\n});\n\nconst result = await googleCalendar_list_events.action();\n// outputSchema for result.data when operation === 'list_events':\n// {\n//   operation: \"list_events\" // List events in a calendar,\n//   success: boolean // Whether the event list was retrieved successfully,\n//   events: { id: string // Event ID, status: string | undefined // Event status (confirmed, tentative, cancelled), htmlLink: string | undefined // Link to the event in Calendar UI, created: string | undefined // Event creation timestamp, updated: string | undefined // Event last updated timestamp, summary: string | undefined // Event title, description: string | undefined // Event description, location: string | undefined // Event location, start: { dateTime: string | undefined // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: string | undefined // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: string | undefined // Time zone for the event time } | undefined // Event start date/time, end: { dateTime: string | undefined // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: string | undefined // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: string | undefined // Time zone for the event time } | undefined // Event end date/time, attendees: { email: string // Attendee email, optional: boolean | undefined // Whether this attendee is optional, responseStatus: \"needsAction\" | \"declined\" | \"tentative\" | \"accepted\" | undefined // Response status of the attendee, displayName: string | undefined // Display name of the attendee }[] | undefined // List of event attendees, organizer: { email: string | undefined // Organizer email address, displayName: string | undefined // Organizer display name } | undefined // Event organizer information, hangoutLink: string | undefined // Google Hangout/Meet link for the event, conferenceData: unknown | undefined // Conference data for virtual meetings, attachments: { fileId: string | undefined // Google Drive file ID, fileUrl: string | undefined // URL link to the attachment, title: string | undefined // Attachment title/filename, mimeType: string | undefined // MIME type of the attachment, iconLink: string | undefined // URL link to the attachment icon }[] | undefined // List of file attachments on the event, driveAttachmentFileIds: string[] | undefined // List of Google Drive file IDs extracted from event attachments }[] | undefined // List of events,\n//   next_page_token: string | undefined // Token for fetching next page,\n//   error: string // Error message if operation failed\n// }\n\n\n// Get Event example\nconst googleCalendar_get_event = new GoogleCalendarBubble({\n  operation: \"get_event\", // Get a single event\n  calendar_id: \"primary\" // default, // Calendar ID\n  event_id: \"example string\", // Event ID to retrieve\n});\n\nconst result = await googleCalendar_get_event.action();\n// outputSchema for result.data when operation === 'get_event':\n// {\n//   operation: \"get_event\" // Get a single event,\n//   success: boolean // Whether the event was retrieved successfully,\n//   event: { id: string // Event ID, status: string | undefined // Event status (confirmed, tentative, cancelled), htmlLink: string | undefined // Link to the event in Calendar UI, created: string | undefined // Event creation timestamp, updated: string | undefined // Event last updated timestamp, summary: string | undefined // Event title, description: string | undefined // Event description, location: string | undefined // Event location, start: { dateTime: string | undefined // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: string | undefined // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: string | undefined // Time zone for the event time } | undefined // Event start date/time, end: { dateTime: string | undefined // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: string | undefined // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: string | undefined // Time zone for the event time } | undefined // Event end date/time, attendees: { email: string // Attendee email, optional: boolean | undefined // Whether this attendee is optional, responseStatus: \"needsAction\" | \"declined\" | \"tentative\" | \"accepted\" | undefined // Response status of the attendee, displayName: string | undefined // Display name of the attendee }[] | undefined // List of event attendees, organizer: { email: string | undefined // Organizer email address, displayName: string | undefined // Organizer display name } | undefined // Event organizer information, hangoutLink: string | undefined // Google Hangout/Meet link for the event, conferenceData: unknown | undefined // Conference data for virtual meetings, attachments: { fileId: string | undefined // Google Drive file ID, fileUrl: string | undefined // URL link to the attachment, title: string | undefined // Attachment title/filename, mimeType: string | undefined // MIME type of the attachment, iconLink: string | undefined // URL link to the attachment icon }[] | undefined // List of file attachments on the event, driveAttachmentFileIds: string[] | undefined // List of Google Drive file IDs extracted from event attachments } | undefined // Event details,\n//   error: string // Error message if operation failed\n// }\n\n\n// Create Event example\nconst googleCalendar_create_event = new GoogleCalendarBubble({\n  operation: \"create_event\", // Create an event\n  calendar_id: \"primary\" // default, // Calendar ID\n  summary: \"example string\", // Event title\n  description: \"example string\", // Event description\n  location: \"example string\", // Event location\n  start: { dateTime: \"example string\" // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: \"example string\" // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: \"example string\" // Time zone for the event time }, // Start date/time\n  end: { dateTime: \"example string\" // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: \"example string\" // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: \"example string\" // Time zone for the event time }, // End date/time\n  attendees: [{ email: \"example string\" // Attendee email, optional: true // Whether this attendee is optional, responseStatus: \"needsAction\" // options: \"needsAction\", \"declined\", \"tentative\", \"accepted\" // Response status of the attendee, displayName: \"example string\" // Display name of the attendee }], // List of event attendees\n  conference: false // default, // Create a Google Meet conference link\n});\n\nconst result = await googleCalendar_create_event.action();\n// outputSchema for result.data when operation === 'create_event':\n// {\n//   operation: \"create_event\" // Create an event,\n//   success: boolean // Whether the event was created successfully,\n//   event: { id: string // Event ID, status: string | undefined // Event status (confirmed, tentative, cancelled), htmlLink: string | undefined // Link to the event in Calendar UI, created: string | undefined // Event creation timestamp, updated: string | undefined // Event last updated timestamp, summary: string | undefined // Event title, description: string | undefined // Event description, location: string | undefined // Event location, start: { dateTime: string | undefined // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: string | undefined // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: string | undefined // Time zone for the event time } | undefined // Event start date/time, end: { dateTime: string | undefined // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: string | undefined // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: string | undefined // Time zone for the event time } | undefined // Event end date/time, attendees: { email: string // Attendee email, optional: boolean | undefined // Whether this attendee is optional, responseStatus: \"needsAction\" | \"declined\" | \"tentative\" | \"accepted\" | undefined // Response status of the attendee, displayName: string | undefined // Display name of the attendee }[] | undefined // List of event attendees, organizer: { email: string | undefined // Organizer email address, displayName: string | undefined // Organizer display name } | undefined // Event organizer information, hangoutLink: string | undefined // Google Hangout/Meet link for the event, conferenceData: unknown | undefined // Conference data for virtual meetings, attachments: { fileId: string | undefined // Google Drive file ID, fileUrl: string | undefined // URL link to the attachment, title: string | undefined // Attachment title/filename, mimeType: string | undefined // MIME type of the attachment, iconLink: string | undefined // URL link to the attachment icon }[] | undefined // List of file attachments on the event, driveAttachmentFileIds: string[] | undefined // List of Google Drive file IDs extracted from event attachments } | undefined // Created event details,\n//   error: string // Error message if operation failed\n// }\n\n\n// Update Event example\nconst googleCalendar_update_event = new GoogleCalendarBubble({\n  operation: \"update_event\", // Update an existing event\n  calendar_id: \"primary\" // default, // Calendar ID\n  event_id: \"example string\", // Event ID to update\n  summary: \"example string\", // Event title\n  description: \"example string\", // Event description\n  location: \"example string\", // Event location\n  start: { dateTime: \"example string\" // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: \"example string\" // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: \"example string\" // Time zone for the event time }, // Start date/time\n  end: { dateTime: \"example string\" // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: \"example string\" // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: \"example string\" // Time zone for the event time }, // End date/time\n  attendees: [{ email: \"example string\" // Attendee email, optional: true // Whether this attendee is optional, responseStatus: \"needsAction\" // options: \"needsAction\", \"declined\", \"tentative\", \"accepted\" // Response status of the attendee, displayName: \"example string\" // Display name of the attendee }], // List of event attendees\n});\n\nconst result = await googleCalendar_update_event.action();\n// outputSchema for result.data when operation === 'update_event':\n// {\n//   operation: \"update_event\" // Update an existing event,\n//   success: boolean // Whether the event was updated successfully,\n//   event: { id: string // Event ID, status: string | undefined // Event status (confirmed, tentative, cancelled), htmlLink: string | undefined // Link to the event in Calendar UI, created: string | undefined // Event creation timestamp, updated: string | undefined // Event last updated timestamp, summary: string | undefined // Event title, description: string | undefined // Event description, location: string | undefined // Event location, start: { dateTime: string | undefined // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: string | undefined // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: string | undefined // Time zone for the event time } | undefined // Event start date/time, end: { dateTime: string | undefined // RFC3339 timestamp, e.g. 2025-09-10T10:00:00-07:00, date: string | undefined // All-day date in YYYY-MM-DD (mutually exclusive with dateTime), timeZone: string | undefined // Time zone for the event time } | undefined // Event end date/time, attendees: { email: string // Attendee email, optional: boolean | undefined // Whether this attendee is optional, responseStatus: \"needsAction\" | \"declined\" | \"tentative\" | \"accepted\" | undefined // Response status of the attendee, displayName: string | undefined // Display name of the attendee }[] | undefined // List of event attendees, organizer: { email: string | undefined // Organizer email address, displayName: string | undefined // Organizer display name } | undefined // Event organizer information, hangoutLink: string | undefined // Google Hangout/Meet link for the event, conferenceData: unknown | undefined // Conference data for virtual meetings, attachments: { fileId: string | undefined // Google Drive file ID, fileUrl: string | undefined // URL link to the attachment, title: string | undefined // Attachment title/filename, mimeType: string | undefined // MIME type of the attachment, iconLink: string | undefined // URL link to the attachment icon }[] | undefined // List of file attachments on the event, driveAttachmentFileIds: string[] | undefined // List of Google Drive file IDs extracted from event attachments } | undefined // Updated event details,\n//   error: string // Error message if operation failed\n// }\n\n\n// Delete Event example\nconst googleCalendar_delete_event = new GoogleCalendarBubble({\n  operation: \"delete_event\", // Delete an event\n  calendar_id: \"primary\" // default, // Calendar ID\n  event_id: \"example string\", // Event ID to delete\n  send_updates: \"all\" // options: \"all\", \"externalOnly\", \"none\", // Whether to notify attendees\n});\n\nconst result = await googleCalendar_delete_event.action();\n// outputSchema for result.data when operation === 'delete_event':\n// {\n//   operation: \"delete_event\" // Delete an event,\n//   success: boolean // Whether the event was deleted successfully,\n//   deleted: boolean | undefined // Whether the event was actually deleted,\n//   error: string // Error message if operation failed\n// }\n\n\n// Always check success status before using data\nif (!result.success) {\n  throw new Error(`google-calendar failed: ${result.error}`);\n}\n\n// Access the actual data\nconst actualData = result.data;\nconsole.log(actualData);",
       "requiredCredentials": [
         "GOOGLE_CALENDAR_CRED"
       ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bubblelab/bubble-core",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "type": "module",
   "license": "Apache-2.0",
   "main": "./dist/index.js",
@@ -41,7 +41,7 @@
     "resend": "^4.8.0",
     "zod": "^3.24.1",
     "zod-to-json-schema": "^3.24.6",
-    "@bubblelab/shared-schemas": "0.1.20"
+    "@bubblelab/shared-schemas": "0.1.21"
   },
   "devDependencies": {
     "@types/node": "^20.12.12",