pipedream icon indicating copy to clipboard operation
pipedream copied to clipboard

Add new Tomba email, domain and phone actions

Open benemohamed opened this issue 4 months ago β€’ 4 comments

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).

benemohamed avatar Oct 16 '25 17:10 benemohamed

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 Ignored Ignored Nov 30, 2025 0:38am

vercel[bot] avatar Oct 16 '25 17:10 vercel[bot]

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:

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.

❀️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

coderabbitai[bot] avatar Oct 16 '25 17:10 coderabbitai[bot]

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

vunguyenhung avatar Dec 03 '25 02:12 vunguyenhung