Add new Tomba email, domain and phone actions
new Actions
- Author Finder - Find email from blog post URLs
- Email Finder - Generate email from domain + name
- LinkedIn Finder - Find email from LinkedIn profile
- Email Verifier - Verify email deliverability
- Email Enrichment - Get person/company data from email
- Email Sources - Find where email appears online
- Domain Search - Find all emails for a domain (with filters)
- Domain Status - Check if domain is webmail/disposable
- Email Count - Get total emails for domain
- Email Format - Get domain email patterns
- Location - Get employee locations by domain
- Technology - Analyze domain tech stack
- Similar Domains - Find competitor domains
- Domain Suggestions - Get related domains
- Phone Finder - Find phones by email/domain/LinkedIn
- Phone Validator - Validate phone numbers
- Autocomplete - Company search with logos
- Get Account - Account info and statistics
- Get Usage - API usage tracking
- Get Logs - Request history
- Get Status - API health monitoring
WHY
providing email finder, verification, and enrichment capabilities to Pipedream users.
Summary by CodeRabbit
-
New Features
- Added 20+ Tomba actions for email & phone discovery, verification, enrichment, domain research, LinkedIn lookups, company search, technology detection, usage/logs and account info β enabling broader contact and domain workflows.
- Expanded Tomba integration capabilities and improved end-to-end lookups and summaries.
-
Documentation
- Expanded README with Getting Started, detailed use cases, step-by-step setup, and Troubleshooting (authentication, rate limits, no results).
The latest updates on your projects. Learn more about Vercel for GitHub.
1 Skipped Deployment
| Project | Deployment | Preview | Comments | Updated (UTC) |
|---|---|---|---|---|
| pipedream-docs-redirect-do-not-edit | Nov 30, 2025 0:38am |
Thank you so much for submitting this! We've added it to our backlog to review, and our team has been notified.
Thanks for submitting this PR! When we review PRs, we follow the Pipedream component guidelines. If you're not familiar, here's a quick checklist:
- [ ] Create components to address specific use cases whenever possible
- [ ] Component
keys should follow the formatapp_name_slug-slugified-component-name - [ ] Components should follow the standard directory structure
- [ ] Prefer Node.js client libraries to REST APIs
- [ ] When making API requests, handle pagination to ensure all data / events are processed
- [ ] Use
secretprops to capture sensitive data - [ ] Props and methods should be defined in app files whenever possible
- [ ] Document methods with JS Docs
- [ ] Use
optionalprops whenever possible, and set adefaultvalue where you can - [ ] Use async options to accept user input wherever possible
Walkthrough
This PR adds ~24 new Tomba action modules, expands the tomba.app.mjs with comprehensive propDefinitions, request helpers, and ~21 new API operation methods, updates package metadata (version, deps, keywords), and rewrites the component README with expanded usage and troubleshooting guidance.
Changes
| Cohort / File(s) | Summary |
|---|---|
Documentation components/tomba/README.md |
Rewrites and expands the README: broader Overview, new and detailed use cases (Lead Generation Automation, Domain Research, Competitive Intelligence), Getting Started guide, and Troubleshooting (Authentication Issues, Rate Limiting, No Results, Invalid Emails). |
Email & Domain Actions components/tomba/actions/email-finder/email-finder.mjs, components/tomba/actions/email-enrichment/email-enrichment.mjs, components/tomba/actions/email-verifier/email-verifier.mjs, components/tomba/actions/email-count/email-count.mjs, components/tomba/actions/email-format/email-format.mjs, components/tomba/actions/email-sources/email-sources.mjs, components/tomba/actions/domain-search/domain-search.mjs, components/tomba/actions/domain-status/domain-status.mjs, components/tomba/actions/domain-suggestions/domain-suggestions.mjs, components/tomba/actions/location/location.mjs, components/tomba/actions/technology/technology.mjs, components/tomba/actions/similar/similar.mjs |
Adds 12 read-only action modules that import the app, declare props via propDefinitions, call the corresponding app method in run(), export a $summary, and return the API response. |
Contact & Author Discovery Actions components/tomba/actions/author-finder/author-finder.mjs, components/tomba/actions/linkedin-finder/linkedin-finder.mjs, components/tomba/actions/phone-finder/phone-finder.mjs, components/tomba/actions/phone-validator/phone-validator.mjs |
Adds 4 actions for author/contact discovery and phone validation; Phone Finder includes dynamic additionalProps for multiple search types; all delegate to app methods and export summaries. |
Account, Usage & Logs Actions components/tomba/actions/get-account/get-account.mjs, components/tomba/actions/get-usage/get-usage.mjs, components/tomba/actions/get-logs/get-logs.mjs |
Adds 3 actions for account info, usage, and paginated logs; each calls the app, exports a summary, and returns the response. |
Company Search Action components/tomba/actions/search-companies/search-companies.mjs |
Adds Search Companies action supporting query, filters, limit, and page; delegates to app.searchCompanies and exports a summary. |
App Module components/tomba/tomba.app.mjs |
Substantially expands the app: adds a full propDefinitions object (many input fields), helper methods (_baseUrl, _headers, _makeRequest), and ~21 API methods (authorFinder, domainSearch, domainStatus, emailCount, emailEnrichment, emailFinder, emailFormat, emailSources, emailVerifier, linkedinFinder, location, phoneFinder, phoneValidator, similar, technology, getAccount, searchCompanies, domainSuggestions, getUsage, getLogs). |
Package Metadata components/tomba/package.json |
Bumps version 0.0.5 β 0.2.0, expands description, adds keywords (email, finder, verifier, enrichment, domain, phone, linkedin, company, search), and adds dependency @pipedream/platform ^3.0.3. |
Sequence Diagram(s)
sequenceDiagram
participant User
participant Action
participant App
participant API
User->>Action: Invoke action with params
Action->>App: this.app.<operation>({ $, ...params })
App->>App: Build headers & path via _headers/_baseUrl
App->>API: _makeRequest -> HTTP call
API-->>App: Return response
App-->>Action: Return response payload
Action->>Action: $.export("$summary", "...")
Action-->>User: Return response
Estimated code review effort
π― 4 (Complex) | β±οΈ ~75 minutes
Poem
π I hopped through code, a curious spree,
New finders, verifiers, and logs for me.
APIs connected, props set just right,
Summaries glowing in soft twilight.
A warren of endpoints β oh what a sight! β¨
Pre-merge checks and finishing touches
β Passed checks (3 passed)
| Check name | Status | Explanation |
|---|---|---|
| Title Check | β Passed | The title succinctly describes the main change by stating that new Tomba email, domain, and phone actions are being added, which directly reflects the extensive set of new action modules introduced in this PR. It is clear and specific without including extraneous details. A teammate scanning the history can immediately grasp the primary purpose of the changeset. |
| Description Check | β Passed | The pull request description includes the required β## WHYβ section with a clear rationale and also lists all new actions added, providing comprehensive context about the scope of the updates. It adheres to the repositoryβs minimal template by completing the mandatory WHY section and supplements it with useful detail. All required information is present and the description is focused and relevant. |
| Docstring Coverage | β Passed | No functions found in the changes. Docstring coverage check skipped. |
β¨ Finishing touches
- [ ] π Generate docstrings
π§ͺ Generate unit tests (beta)
- [ ] Create PR with unit tests
- [ ] Post copyable unit tests in a comment
π Recent review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
π₯ Commits
Reviewing files that changed from the base of the PR and between 6fd422f35b3afc4e1e5e9bc528e8d407aad1f13d and a6f37865227df9d1100a84478b31284f89d1e7d5.
π Files selected for processing (2)
-
components/tomba/actions/get-logs/get-logs.mjs(1 hunks) -
components/tomba/actions/phone-finder/phone-finder.mjs(1 hunks)
π§ Files skipped from review as they are similar to previous changes (2)
- components/tomba/actions/phone-finder/phone-finder.mjs
- components/tomba/actions/get-logs/get-logs.mjs
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.
Comment @coderabbitai help to get the list of available commands and usage tips.
Hi everyone, all test cases are passed! Ready for release!
Test reports
- Add new Tomba email, domain and phone actions - Actions Batch 2: https://www.notion.so/Add-new-Tomba-email-domain-and-phone-actions-Actions-Batch-2-2-2bdbf548bb5e8139b46dd232e18bce11
- Add new Tomba email, domain and phone actions - Actions Batch 1: https://www.notion.so/Add-new-Tomba-email-domain-and-phone-actions-Actions-Batch-1-2-2bdbf548bb5e814db7a6c07051b10e75