Skip to content

feat(connectors): add smartrecruiters SmartRecruiters ATS connector#327

Open
andrei-hasna wants to merge 1 commit into
mainfrom
station02-claude/open-connectors/9277812b-1053-47bd-a43e-ed3381f08110-48d93704
Open

feat(connectors): add smartrecruiters SmartRecruiters ATS connector#327
andrei-hasna wants to merge 1 commit into
mainfrom
station02-claude/open-connectors/9277812b-1053-47bd-a43e-ed3381f08110-48d93704

Conversation

@andrei-hasna

Copy link
Copy Markdown
Contributor

Summary

Adds connectors/smartrecruiters, a first-class @hasna/connect-smartrecruiters standalone package for the SmartRecruiters ATS, rebuilt against the public SmartRecruiters REST API and existing open-connectors patterns (modeled on connectors/godaddy/linkedin; not copied from platform-alumia).

What's included

  • Real API client (src/api/client.ts): fetch wrapper with X-SmartToken header auth, base https://api.smartrecruiters.com (override via SMARTRECRUITERS_BASE_URL), retry/backoff on 429/5xx, typed SmartRecruitersApiError + parseApiError, and a token-preview that never leaks the key.
  • Resource modules: jobs (/jobs), candidates (/candidates, /jobs/{id}/candidates), public postings (/v1/companies/{companyIdentifier}/postings), users (/users), configuration (/configuration/{departments,locations,functions,industries}), plus a SmartRecruiters facade with fromEnv().
  • CLI (connect-smartrecruiters): commander-based, multi-profile config (~/.hasna/connectors/connect-smartrecruiters), -f json/pretty, resource + profile/config commands.
  • Types/utils, placeholder-only .env.example (SMARTRECRUITERS_API_KEY, optional company id / base url), README, CLAUDE.md.
  • Registry: adds a smartrecruiters Business Tools entry (tags hr, recruiting, ats) next to smartsuite.

Constraints honored

  • @hasna namespace, Apache-2.0, deps limited to commander + chalk (no browser-use/scraper dependency).
  • No secrets, tokens, internal URLs, or platform-alumia references; .env.example placeholders only.

Validation

  • bun run typecheckbun run buildbun test ✅ (30 pass, mocked fetch)
  • Repo root bun test src/lib/registry.test.ts ✅ (28 pass — category/uniqueness/version gates)

🤖 Generated with Claude Code

Add connectors/smartrecruiters as a first-class @hasna standalone package
rebuilt against the public SmartRecruiters REST API (base
https://api.smartrecruiters.com, X-SmartToken header auth). Provides a real
API client with retry/error mapping, resource modules (jobs, candidates,
public postings, users, configuration), a commander CLI with multi-profile
config, types/utils, a mocked-fetch test suite, and placeholder-only
.env.example. Registers a "smartrecruiters" Business Tools entry.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant