Quel SDK choisir

Quatre paquets, deux mondes : ce qui tourne sur votre serveur avec la clé secrète, et ce qui tourne dans le navigateur avec la clé publique.

Vous voulez…	Utilisez	Clé	Page
Piloter plans, événements et réservations depuis Node	@mitoera/sdk	Secrète	Installation JS/TS
La même chose depuis PHP	mitoera/php-sdk	Secrète	Installation PHP
Afficher un plan et laisser choisir des sièges	SeatingChart	Publique	Widget par CDN
Embarquer l'éditeur de plan	ChartDesigner	Secrète	Éditeur embarqué
Ni Node ni PHP	L'API REST en direct	Secrète	Référence API

Les deux SDK serveur exposent la même arborescence de sous-clients, avec les mêmes noms de méthodes. Passer de l'un à l'autre ne demande pas de réapprentissage :

client
├── holds        hold, book, release, changeStatus
├── sessions     create, refresh
├── events       listAll, get, findByIdentifier, listSeats, bulkUpdateSeats,
│                create, update, linkChart, delete
├── charts       listAll, get, create, update, setObjects, publish,
│                markPending, delete
├── categories   listForChart, get, create, update, delete
├── apiKeys      listAll, create, delete
├── workspaces   listAll, getCurrent, create, switchTo, invite, listMembers
└── reporting    monthly, byEvent, seatList, workspaces

La référence détaillée est sur Client serveur.

État de publication

SDK	Dépôt	Version	Registre
PHP	mitoera-php-sdk	v1.0.1	Packagist
JS / TS	mitoera-ts-sdk	0.1.0	npm

Les deux SDK sont publiés sur leur registre, sous licence MIT et sans dépendance de production :

PHP

composer require mitoera/php-sdk:^1.0

JavaScript / TypeScript

npm install @mitoera/sdk

Numérotation

Le SDK PHP est en 1.0.0 : son API est stable. Le SDK TypeScript est en 0.1.0 — une version mineure peut y introduire des ruptures, épinglez-la.

Prérequis

SDK	Prérequis
@mitoera/sdk	Node.js 18+ (ESM et CJS fournis), TypeScript facultatif
@mitoera/sdk/browser	Un navigateur moderne, ou un bundler (Vite, webpack, Rollup…)
mitoera/php-sdk	PHP ≥ 8.1, extensions curl et json
Widget CDN	Aucun — une balise <script> suffit

Le SDK PHP n'a aucune dépendance Composer : le transport est du cURL natif, sans Guzzle ni PSR-18.

Choisir entre CDN et npm côté navigateur

Le widget existe en deux emballages pour le même code :

Par CDN — une balise <script>, l'objet global Mitoera.SeatingChart. Zéro outillage, idéal pour un site WordPress, une page statique ou un template serveur. Voir Widget par CDN.

Par npm — import { SeatingChart } from '@mitoera/sdk/browser'. Typé, arbre de dépendances propre, intégration naturelle dans une application Vue ou React. Voir SeatingChart.

Les options et les méthodes sont identiques dans les deux cas.