Vue d'ensemble des SDK

Jichio distribue une logique cœur unique et des adaptateurs fins par environnement. Choisissez l’adaptateur correspondant à votre plateforme ; il branche les hooks spécifiques et délègue tout le pipeline au core.

@jichio/core

Pipeline framework-agnostic : capture, file offline, batch, retry, auto-capture.

@jichio/react

Provider React / Next.js et pageviews SPA.

@jichio/wordpress

Plugin zero-code, config admin, bundle UMD injecté.

Quel package installer ?

Votre plateforme	Package	Statut
Next.js, React (App Router / React Router)	`@jichio/react`	✅ V1
WordPress	`@jichio/wordpress`	✅ V1
Usage direct / SSR / worker	`@jichio/core`	✅ V1
Site statique / vanilla JS	`@jichio/vanilla`	🕓 V2
Angular	`@jichio/angular`	🕓 V2+
Mobile (React Native, Kotlin natif)	packages dédiés	🕓 V3

Dépendances entre packages

@jichio/shared-types   (contrat d'événement : TrackedEvent, EventProperties)
        ▲
        │
@jichio/core           (pipeline complet — seule source de vérité)
        ▲
        ├──────────────► @jichio/react       (peer: react)
        └──────────────► @jichio/wordpress   (bundle UMD)

Le contrat commun

Tous les connecteurs produisent le même format d’événement, défini dans @jichio/shared-types. Le champ source (sdk-react, sdk-wordpress, …) permet la réconciliation multi-connecteurs côté ClickHouse.

{
  "eventId": "uuid-v4",
  "eventName": "pageview | click | <custom>",
  "source": "sdk-react | sdk-wordpress | sdk-core | ...",
  "anonymousId": "uuid",
  "userId": "optionnel",
  "sessionId": "uuid",
  "timestamp": "ISO 8601 (client)",
  "properties": { "...": "libre, JSON" }
}

projectId n’est jamais envoyé par le SDK : il est résolu côté serveur à partir de la clé API. Voir Modèle d’événement.

Prise en main

SDK

Concepts

Guides

Vue d'ensemble des SDK

@jichio/core

@jichio/react

@jichio/wordpress

Quel package installer ?

Dépendances entre packages

Le contrat commun

@jichio/core

@jichio/react

@jichio/wordpress

​Quel package installer ?

​Dépendances entre packages

​Le contrat commun

Quel package installer ?

Dépendances entre packages

Le contrat commun