Démarrer avec le SDK
Créer un client, appeler une capacité, lire un résultat.
Le SDK @carrier/sdk est un client TypeScript typé pour l'API publique de Talentsalve. Il suit toujours le même schéma : client → capacité → adaptateur → HTTP.
Diffusion
Le paquet est aujourd'hui un paquet interne du dépôt : il n'est pas publié sur npm. Les exemples ci-dessous décrivent son interface réelle ; son installation depuis un registre sera documentée quand il sera publié.
Créer un client
import { createClient } from "@carrier/sdk"
const talentsalve = createClient({
baseUrl: "https://talent-salve.crypto-ai-agent.com", // "" = même origine
timeoutMs: 10_000,
})Le client expose trois capacités de lecture :
| Capacité | Rôle | Page |
|---|---|---|
talentsalve.offers | liste paginée et détail d'une offre | Récupérer des offres |
talentsalve.geo | totaux par zone, pour une carte | Carte et facettes |
talentsalve.facets | valeurs de filtre avec leurs effectifs | Carte et facettes |
Un résultat, jamais une exception
Chaque appel renvoie un Result : soit { ok: true, value }, soit { ok: false, error }. Le SDK ne lève pas d'exception pour une erreur réseau ou une réponse en erreur.
const result = await talentsalve.offers.list({ continent: "Europe", limit: 10 })
if (!result.ok) {
console.error(result.error.code, result.error.message)
} else {
for (const offer of result.value.items) {
console.log(offer.title, "-", offer.company.name)
}
}Après le test result.ok, TypeScript sait quelle branche vous avez. Les erreurs possibles sont décrites dans Gérer les erreurs.
Annuler un appel
Chaque méthode accepte en dernier argument des options, dont un AbortSignal :
const controller = new AbortController()
const pending = talentsalve.offers.list({ q: "comptable" }, { signal: controller.signal })
controller.abort() // résultat : une erreur AbortError, pas une exceptionCe que le SDK ne fait pas encore
Il n'expose ni la notation d'une offre, ni la génération de CV : voir Noter une offre et Générer un CV.