Passer au contenu principal

CLI et déploiement de configuration

Les artefacts CLI/config publiés en version 0.3.1 implémentent le contrat de configuration/backend 0.3.0 et rejettent les clés inconnues aussi bien localement que côté backend.

La CLI crée, valide, déploie, promeut et restaure des versions immuables de la configuration ChattyBox. Les jetons de déploiement sont limités à un projet et aux environnements sélectionnés, ce qui rend le même flux adapté au développement local et à la CI.

État de publication et d’exécution​

Le registre public publie les packages CLI/config @openstaticfish/chattybox-cli@0.3.1 et @openstaticfish/chattybox-config@0.3.1, ainsi que le SDK JavaScript distinct @openstaticfish/chattybox@0.1.4. Les packages CLI et config publiés en version 0.3.1 prennent en charge les champs étendus (projet, découverte/planification, locales étendues, widget.icon, widget.showBranding), conformément au contrat de configuration/backend 0.3.0. Les versions des packages et schemaVersion: "1" sont distinctes.

La CLI est un programme ESM en ligne de commande déclarant Node.js 20 ou supérieur, pas un outil pour navigateur. Par défaut, bunx respecte son shebang Node : installez Node ou sélectionnez explicitement Bun avec bunx --bun @openstaticfish/chattybox-cli .... La CI des packages publiés teste Node 20, 22 et 24 sous Linux, sans constituer une matrice générale de compatibilité. Épinglez une version testée en production ; les exemples sans version utilisent le package installé, en cache ou du registre, pas le code de ce dépôt.

Périmètre de la configuration​

La configuration gère le nom et la description du projet, la persona et le repli de l’assistant, la découverte et l’actualisation du site, les langues et la présentation du widget hébergé. Un déploiement preview ou production applique ces valeurs et met en file une actualisation du corpus existant. Avec le verrouillage activé, les réglages gérés par configuration passent par des déploiements versionnés, sauf la préférence de marque soumise aux droits du forfait.

La création initiale du projet reste une étape unique dans le tableau de bord. Les clés publiques et leurs restrictions d’origine facultatives, le cycle de vie des jetons de déploiement, les analyses, conversations et lacunes, les actions destructives et les fichiers d’icône téléversés ne sont pas des champs de configuration. Utilisez une URL ou un emoji pour une icône personnalisée déclarative. Le fichier ne contient pas d’ID de projet : le jeton secret sélectionne exactement un projet existant et les environnements autorisés.

Une clé publique de widget peut figurer dans le code du navigateur ; sans restriction, elle fonctionne depuis toutes les origines, mais une clé préparée pour un site peut déjà être restreinte. Les restrictions d’origine sont une protection facultative, pas une authentification des visiteurs. Le jeton de déploiement, lui, doit rester secret dans l’environnement local ou la CI et ne doit jamais être exposé dans le navigateur.

Créer une configuration​

bunx @openstaticfish/chattybox-cli init

Cette commande crée chattybox.config.json :

{
"schemaVersion": "1",
"assistant": {
"name": "Support"
},
"knowledge": {
"sources": [
{
"type": "website",
"url": "https://example.com"
}
]
},
"widget": {
"enabled": true
}
}

Utilisez un chemin personnalisé lorsque la configuration doit se trouver dans un sous-répertoire :

bunx @openstaticfish/chattybox-cli init config/chattybox.config.json

Valider localement ou dans la CI​

bunx @openstaticfish/chattybox-cli validate
bunx @openstaticfish/chattybox-cli validate config/chattybox.config.json

La validation du contrat 0.3.0 partagé avec le backend rejette les clés inconnues, vérifie le schéma, le nom obligatoire de l'assistant, les types de sources pris en charge, les URL HTTP(S), les limites entières, les combinaisons de locales et les couleurs hexadécimales à six chiffres. knowledge peut être omis pour la validation locale ou le développement ; s’il est présent, il doit contenir exactement une source de site web. preview et production exigent cette source. Si widget est présent, widget.enabled est obligatoire.

La validation lit uniquement du JSON, sans charger TypeScript, JSONC, YAML ni schéma distant. Elle n’effectue aucune requête réseau, ne vérifie ni jeton ni droits du forfait et n’applique pas de valeurs par défaut. Une validation locale réussie ne garantit pas le déploiement. Le schéma v1 rejette les champs inconnus à tous les niveaux ; les entrées d’inclusion et d’exclusion doivent être des chaînes non vides. runtime.locale est un raccourci pour une locale fixe sans remplacement ; il ne peut être combiné avec localeMode, defaultLocale ou allowLocaleOverride: true. Le serveur vérifie les droits du forfait et la portée du jeton. Si mode est omis, crawl est sélectionné et un maxDepth: 0 explicite est conservé.

Créer un jeton de déploiement​

Dans le projet, ouvrez Paramètres du chatbot → Configuration pour les développeurs → Jetons de déploiement de configuration et créez un jeton pour les environnements que votre flux de travail peut modifier. Copiez immédiatement sa valeur complète : elle ne sera affichée qu'une seule fois. ChattyBox conserve un hash et des métadonnées limitées d'identification et de cycle de vie, mais ne peut pas réafficher la valeur complète.

Le formulaire sélectionne initialement development uniquement et ne définit aucune expiration. Sélectionnez explicitement preview ou production selon vos besoins. Le tableau de bord propose une durée de 7, 30, 90 ou 365 jours, ou aucune expiration ; l’API authentifiée accepte un entier de 1 à 365 jours ou l’omission pour une durée illimitée. Un projet peut avoir au plus 20 jetons actifs non expirés. Pour effectuer une rotation, créez un remplaçant, mettez à jour la CI puis révoquez l’ancien jeton. La CLI ne propose pas de commandes de connexion, création, liste ou révocation de jetons.

Définissez le jeton et l'URL d'API du widget. Dans Installer → Installation sur le site web, utilisez la valeur data-api-url de l'extrait lorsqu'elle est disponible ; sinon, récupérez l'URL de déploiement des actions HTTP dans votre configuration de déploiement. Le flux d'installation peut nécessiter que la configuration soit prête au préalable :

export CHATTYBOX_DEPLOY_TOKEN='cb_cfg_v1_...'
export CHATTYBOX_API_URL='https://your-deployment.convex.site/chat'

Utilisez l'URL racine du déploiement des actions HTTP ou l'URL du widget se terminant par /chat, et non une URL cliente .convex.cloud ni l'endpoint complet de gestion. HTTPS est obligatoire, sauf pour localhost, 127.0.0.1 et [::1]. L'URL ne doit contenir ni identifiants, ni paramètres de requête, ni fragment. Vérifiez l'hôte de destination avant d'envoyer le secret.

Ne commitez jamais le jeton et ne l'exposez jamais dans du code exécuté dans le navigateur. Conservez ce secret côté serveur ou dans le gestionnaire de secrets chiffrés de votre fournisseur CI.

Le jeton de déploiement s'authentifie avec Authorization: Bearer ... ; une clé publique de widget ne peut pas le remplacer. Les routes d'administration n'appliquent pas les restrictions d'origine du widget, n'exigent pas d'en-tête Origin et n'offrent pas d'accès CORS depuis le navigateur. Ce secret n'est pas lié à une origine : toute personne qui le détient peut appeler l'API depuis un serveur. Un jeton absent, mal formé, expiré, révoqué, non autorisé pour l’environnement ou autrement invalide renvoie HTTP 401 INVALID_TOKEN. Il cesse aussi de fonctionner si le projet ou son propriétaire manque ou est en cours de suppression.

Après avoir vérifié le flux, activez éventuellement Config-as-code lock. Il est irréversible dans le tableau de bord, la CLI et l’API actuels ; il ne crée pas de jeton et ne déploie pas de version. Gardez un processus de déploiement testé avant de verrouiller. Il bloque les écritures de configuration et les opérations manuelles de corpus depuis le tableau de bord (scraping, suppression, reconstruction), mais pas les opérations planifiées, la suppression du projet, les clés publiques ou les jetons. Le branding est l’exception : le réglage de branding reste modifiable, selon la formule. Masquer l’attribution nécessite au minimum Starter, y compris par déploiement de configuration ; Free impose toujours son affichage à l’exécution.

Déployer la configuration​

Le déploiement crée une version immuable et la promeut dans l'environnement sélectionné :

bunx @openstaticfish/chattybox-cli deploy --environment preview
bunx @openstaticfish/chattybox-cli deploy --environment production

development enregistre seulement une version/pointeur, sans l'appliquer. preview et production partagent le même runtime, corpus et clés publiques : la dernière promotion runtime gagne, sans isolation par environnement. Un jeton limité à preview peut donc modifier un projet qui sert du trafic de production. Utilisez des projets distincts, avec leurs propres jetons et clés, pour une vraie séparation. Une promotion runtime applique la configuration et met un scraping en file, sans attendre scraping ni embeddings. Elle ne supprime pas les anciennes URL omises et le corpus n’est pas un instantané versionné ; une mise à jour partielle peut subsister après échec.

Un échec d’actualisation n’annule pas la configuration appliquée. Les jobs enregistrent un ID de version, mais lisent aussi des paramètres d’exploration modifiables ; évitez de faire se chevaucher les déploiements lorsque la cohérence de l’indexation importe.

Utilisez --json dans les automatisations pour recevoir le résultat de l'API, notamment version._id, le pointeur d'environnement, applied, indexingStatus et l'ID du job de scraping s'il est mis en file. Pour status, le champ d'identifiant correspondant est activeVersion._id.

Remplacement de configuration et limites de pages​

Déployez la configuration complète souhaitée, pas un patch. Une promotion vers preview ou production efface ou réinitialise les valeurs gérées par la configuration qui sont omises, y compris les anciens réglages du tableau de bord :

Valeur omiseEffet à l'exécution
project.description, prompt/profil/message de repli de l'assistantEfface les personnalisations enregistrées ; le comportement de repli du runtime s'applique.
runtimeRétablit la détection automatique de la locale, en par défaut et l'autorisation de remplacement de locale.
widget ou texte, thème ou position facultatifs du widgetSi widget est omis, le widget est activé. Si l'objet widget est présent, sa valeur obligatoire enabled est respectée. Les personnalisations de présentation omises sont effacées pour rétablir les valeurs par défaut du runtime.
widget.iconRétablit l'icône par défaut de taille moyenne. La promotion supprime le fichier d'icône précédemment téléversé, même si un remplacement déclaratif est fourni.
Mode, filtres ou planification de la sourceLe mode devient crawl, les filtres omis sont effacés et l'actualisation automatique est désactivée. Les réglages propres à un mode ne s'appliquent que si ce mode est sélectionné.
widget.showBrandingException : si ce champ est omis, la préférence enregistrée est conservée, ou true s'il n'y en a pas ; une valeur explicite la remplace à la prochaine promotion runtime. false nécessite Starter ou une offre supérieure.

La version de configuration immuable conserve la valeur demandée de maxPages, tandis que la configuration de scraping appliquée au runtime est plafonnée à 100 000. Pour limiter la sélection, le worker tient compte de la valeur demandée et du plus élevé entre la capacité du fournisseur et le nombre de pages déjà indexées sur le projet ; l'admission de nouvelles pages est vérifiée séparément selon le quota de pages du propriétaire. La découverte d'un sitemap peut télécharger ses documents et énumérer des URL avant leur sélection : la capacité n'est donc ni une garantie de confidentialité ni une limite aux requêtes sortantes. Ce n'est pas une promesse que toutes les pages demandées seront indexées. Sans maxPages, la valeur de requête par défaut correspond au quota de pages inclus par compte dans l'offre : Free 10, Starter 150, Pro 5 000 et Business 25 000. Cela ne crée pas de quota propre au projet ni de droits supplémentaires ; chaque scraping revérifie séparément le quota actuel de pages/PAYG et les limites mensuelles d'actualisation.

En mode sitemap, une URL sitemapUrl explicite qui ne fournit aucune URL fait échouer l'opération. Si sitemapUrl est omis, le système essaie d'abord tout sitemap détecté, puis /sitemap.xml, puis /sitemap_index.xml et enfin l'URL du site enregistrée si aucun ne fournit d'URL.

L’actualisation quotidienne automatique et showBranding: false exigent Starter ou une offre supérieure ; Free accepte une actualisation hebdomadaire ou mensuelle. Ces droits sont vérifiés lors d’une promotion preview/production, y compris une restauration, et non lors de la validation locale ou de l’enregistrement en développement. Une ancienne version valide peut échouer après un changement de formule. La promotion utilise les données de formule mises en cache côté serveur, sans interroger directement le fournisseur de facturation ; vérifiez séparément la synchronisation et le quota d’exploration après un changement récent.

État, promotion et restauration​

bunx @openstaticfish/chattybox-cli status --environment production

bunx @openstaticfish/chattybox-cli promote \
--version '<config-version-id>' \
--environment production

bunx @openstaticfish/chattybox-cli rollback \
--version '<known-good-config-version-id>' \
--environment production

--version attend l'identifiant opaque de version de configuration, et non le numéro affiché : récupérez-le dans version._id du JSON de deploy, promote ou rollback, ou dans activeVersion._id du JSON de status. status montre la version de l’environnement sélectionné, tandis que runtimeConfigVersionId désigne la dernière configuration appliquée au runtime partagé : ils peuvent différer après la promotion d’un autre environnement. La restauration utilise la même opération backend que la promotion, n'est pas tenue de cibler une version antérieure et ne sélectionne pas automatiquement la version précédente. Elle écrase le pointeur ainsi que les métadonnées de promotion de l'environnement sélectionné ; il n'existe pas d'historique de promotions append-only. Pour preview ou production, elle réapplique la configuration avec les droits actuels et met une nouvelle actualisation en file, plutôt que de restaurer le contenu historique.

status ne montre ni la configuration effective, ni les différences avec le tableau de bord, ni la progression du scraping ou des embeddings ; vérifiez l’indexation séparément dans le tableau de bord. Un environnement jamais déployé renvoie environment: null et activeVersion: null. Un appel réussi met également à jour lastUsedAt et consomme une partie de la limite de débit d’administration. Si la configuration n’est pas verrouillée, des modifications ultérieures dans le tableau de bord peuvent changer les paramètres runtime sans changer l’ID de configuration appliquée. Des déploiements répétés créent de nouvelles versions, même identiques ; des promotions répétées peuvent mettre de nouveaux jobs en file.

Commandes, options et erreurs​

init [path] crée les répertoires parents mais refuse d’écraser un fichier existant. validate [path] lit le JSON local sans accès distant. deploy exige --environment et accepte --config <path> ; promote et rollback exigent --environment et --version <opaque-id>, sans lire de fichier local. status exige --environment et ne lit pas de fichier local. Utilisez chattybox --help pour l’aide générale ; --version ou -v au niveau principal affiche la version de la CLI, pas celle à promouvoir.

Les quatre commandes d’administration acceptent --token, --api-url et --json. Les options explicites priment sur CHATTYBOX_DEPLOY_TOKEN et CHATTYBOX_API_URL ; préférez les variables secrètes aux jetons dans l’historique du shell ou les arguments de processus. Les options de valeur acceptent --flag value ou --flag=value ; --json est un commutateur sans valeur. Aucun environnement n’est choisi par défaut. Les options inconnues, dupliquées, vides ou inapplicables sont rejetées ; les commandes locales n’acceptent qu’un chemin positionnel, sans options ni arguments supplémentaires.

Il n’existe pas d’options --dry-run, --wait, --force, --project, de message ou de contrôle de concurrence optimiste. L’API HTTP prend en charge des champs de version attendue, mais pas la CLI : sérialisez les déploiements CI vers un même projet. Une commande réussie renvoie le code 0 ; les erreurs de fichier, validation, arguments, transport, lecture de réponse ou HTTP renvoient 1. --json ne formate que les réussites, pas les erreurs. La CLI ne réessaie ni ne surveille automatiquement et ne définit pas de délai d’expiration des requêtes ; après un échec de transport, vérifiez l’état avant de réessayer, car le serveur peut déjà avoir enregistré le déploiement.

Les routes d’administration partagent une limite de 20 requêtes par minute et par jeton ; une réponse 429 utilise Retry-After. Parmi les erreurs possibles figurent 401 INVALID_TOKEN, 404 NOT_FOUND, 409 CONFIG_CONFLICT, 413 BODY_TOO_LARGE, 422 INVALID_CONFIG et 500 INTERNAL_ERROR. Un ID typé mal formé produit une erreur 422, pas nécessairement 404. La limite du corps de requête est de 262 144 octets.

Workflows CI/CD​

Ajoutez CHATTYBOX_DEPLOY_TOKEN en tant que secret chiffré limité à la production chez votre fournisseur CI. Ajoutez CHATTYBOX_API_URL comme secret ou variable en utilisant l'URL d'API du widget dans Installer → Installation sur le site web, si elle est disponible, ou l'URL de déploiement des actions HTTP. Exécutez la validation sur les pull requests, mais limitez le déploiement en production à votre branche par défaut protégée ou à un environnement de déploiement approuvé.

GitHub Actions​

name: Deploy ChattyBox configuration

on:
pull_request:
push:
branches: [main]

jobs:
validate:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: oven-sh/setup-bun@v2
- uses: actions/setup-node@v6
with:
node-version: 24
- run: bunx @openstaticfish/chattybox-cli validate

deploy:
if: github.event_name == 'push'
needs: validate
runs-on: ubuntu-latest
environment: production
steps:
- uses: actions/checkout@v4
- uses: oven-sh/setup-bun@v2
- uses: actions/setup-node@v6
with:
node-version: 24
- name: Validate and deploy
env:
CHATTYBOX_DEPLOY_TOKEN: ${{ secrets.CHATTYBOX_DEPLOY_TOKEN }}
CHATTYBOX_API_URL: ${{ vars.CHATTYBOX_API_URL }}
run: |
bunx @openstaticfish/chattybox-cli validate
bunx @openstaticfish/chattybox-cli deploy --environment production --json

Utilisez un secret de production limité à l'environnement et exigez une approbation de déploiement lorsque votre dépôt le permet. La CLI enregistre les variables CI courantes du commit et de la branche avec la version immuable.

GitLab CI/CD​

Stockez les deux valeurs sous Settings → CI/CD → Variables. Protégez le token de déploiement, masquez-le et limitez sa portée à l'environnement production.

.gitlab-ci.yml
image: oven/bun:1

validate_chattybox:
stage: test
rules:
- if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
script:
- bunx --bun @openstaticfish/chattybox-cli validate

deploy_chattybox:
stage: deploy
environment: production
rules:
- if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH'
script:
- bunx --bun @openstaticfish/chattybox-cli validate
- bunx --bun @openstaticfish/chattybox-cli deploy --environment production --json

GitLab expose automatiquement CHATTYBOX_DEPLOY_TOKEN et CHATTYBOX_API_URL au job en utilisant leurs noms de variables. Utilisez une branche par défaut protégée afin que les variables protégées ne soient pas disponibles pour les branches non fiables.

Les exemples utilisant l’image Bun sélectionnent explicitement --bun pour ne pas dépendre d’une installation Node séparée ; vérifiez la version de Bun et de l’image épinglée dans votre CI.

Bitbucket Pipelines​

Ajoutez les deux valeurs en tant que variables de déploiement sous Repository settings → Pipelines → Deployments → Production. Marquez le token de déploiement comme sécurisé.

bitbucket-pipelines.yml
image: oven/bun:1

pipelines:
pull-requests:
'**':
- step:
name: Validate ChattyBox configuration
script:
- bunx --bun @openstaticfish/chattybox-cli validate
branches:
main:
- step:
name: Deploy ChattyBox configuration
deployment: Production
script:
- bunx --bun @openstaticfish/chattybox-cli validate
- bunx --bun @openstaticfish/chattybox-cli deploy --environment production --json

Remplacez main si votre branche par défaut porte un autre nom. Bitbucket injecte les variables de déploiement uniquement dans les étapes associées à cet environnement de déploiement. La CLI ne possède pas de correspondance dédiée aux métadonnées BITBUCKET_* ; elle utilise Git local, qui peut ne pas fournir de nom de branche dans un checkout détaché.

Sections de configuration​

SectionObjectif
schemaVersionSélectionne le contrat de configuration public. La version 1 est actuellement prise en charge.
projectMétadonnées facultatives du projet, notamment sa description dans le tableau de bord.
assistantNomme l'assistant et définit une persona intégrée ou un prompt système personnalisé ainsi que le texte de repli.
knowledge.sourcesChoisit la découverte par page d’accueil, sitemap, URL manuelles ou crawl, avec limites, filtres et calendrier.
runtimeGère la locale automatique ou fixe, sa valeur par défaut et les remplacements au niveau de la page.
widgetGère l’activation, la position, les textes, les couleurs et l’icône par défaut, emoji ou URL.

Personas​

Définissez promptProfile sur default, support, sales ou sarcastic pour utiliser une persona intégrée. Pour une persona personnalisée, utilisez custom et fournissez systemPrompt. Si un profil intégré et systemPrompt sont tous deux fournis, le prompt explicite est prioritaire.

Découverte des connaissances​

Cet exemple est une entrée de knowledge.sources, pas une configuration complète. Il nécessite les packages CLI/config publiés en 0.3.1 et le contrat backend 0.3.0 correspondant. L’actualisation quotidienne nécessite Starter ou une offre supérieure ; maxPages: 500 reste une demande soumise à la capacité disponible, pas une garantie d’indexation.

{
"type": "website",
"url": "https://docs.example.com",
"mode": "sitemap",
"sitemapUrl": "https://docs.example.com/docs-sitemap.xml",
"include": ["/docs/"],
"exclude": ["/private/"],
"maxPages": 500,
"autoRescrape": true,
"rescrapeInterval": "daily"
}

Les modes pris en charge sont homepage (sélectionne uniquement url sans supprimer les pages existantes), sitemap, manual (liste manualUrls non vide) et crawl (sitemaps conventionnels, puis liens depuis url jusqu’à maxDepth, par défaut 3). Les champs étendus nécessitent les packages de configuration publiés en 0.3.1 et le contrat backend 0.3.0 correspondant.

include et exclude correspondent à des sous-chaînes d’URL sensibles à la casse, et non à des globs ou expressions régulières. Une correspondance d’inclusion admet une URL ; toute correspondance d’exclusion la rejette, même si elle est incluse. Les listes vides ne filtrent rien. Les filtres s’appliquent aussi à la page d’accueil et à la sélection manuelle.

maxPages doit être un entier positif ; la sélection reste soumise aux contrôles de capacité décrits ci-dessus. La découverte de sitemap peut énumérer des URL avant la sélection. maxDepth est un entier de 0 à 20 qui contrôle le repli par exploration de liens, pas l’énumération du sitemap. autoRescrape: true exige rescrapeInterval: "daily", "weekly" ou "monthly" ; un intervalle seul n’active pas la planification. « Mensuel » signifie 30 jours et le planificateur peut s’exécuter après l’heure prévue.

Validation des locales et du widget​

Les codes de locale pris en charge sont en, de, fr, es, it, nl, pl, pt, sv, fi, et, cs, cy et id. localeMode vaut auto ou fixed ; le mode fixe exige defaultLocale. allowLocaleOverride est configurable indépendamment, sous réserve des règles du raccourci runtime.locale indiquées ci-dessus.

Les positions du widget sont bottom-right, bottom-left, top-right et top-left. Les trois couleurs du thème utilisent #RRGGBB, sans forme courte, nom de couleur ni alpha. Les icônes utilisent default, emoji (chaîne emoji non vide) ou url (URL HTTP(S)), avec une taille facultative small, medium ou large. La validation ne télécharge pas les icônes, ne vérifie pas leur type MIME et n’exige pas exactement un emoji ; elle vérifie la syntaxe et le protocole des URL, pas leur accessibilité ni l’autorisation de les explorer. La description, le prompt et le repli de l’assistant, le titre et le message d’accueil du widget doivent être non vides s’ils sont fournis ; omettez-les pour effacer les valeurs personnalisées.

Utilitaire de configuration typé​

Installez le package de configuration pour créer des outils TypeScript distincts autour du schéma :

bun add -d @openstaticfish/chattybox-config
import { defineConfig } from '@openstaticfish/chattybox-config';

const config = defineConfig({
schemaVersion: '1',
assistant: { name: 'Support' },
knowledge: {
sources: [{ type: 'website', url: 'https://docs.example.com' }],
},
widget: { enabled: true },
});

La CLI elle-même lit des fichiers JSON. defineConfig() est destiné aux applications typées ou aux outils de build ; il ne permet pas à la CLI de charger directement des fichiers TypeScript. defineConfig(config) et validateConfig(config) valident de façon synchrone, lèvent une Error ordinaire à la première erreur et renvoient le même objet sans copie, gel, conversion ni ajout de valeurs par défaut. Le package exporte ces fonctions et des types TypeScript, mais pas de document JSON Schema ni d’URL $schema.

Pour une intégration fonctionnelle en production dès aujourd'hui, utilisez le widget hébergé ou créez une interface personnalisée avec le SDK JavaScript.