Événements et application

L’élément communique entièrement via des CustomEvent du DOM — abonnez-vous à autant que nécessaire.

Événement	Se déclenche quand	detail contient
import-ready	Licence vérifiée, widget monté	tenantId
import-ingested	Un fichier est décodé en un enregistrement	recordId, deduplicated
import-mapped	Les colonnes sont mises en correspondance avec votre schéma	mapping
import-step	L’assistant passe une étape	step
import-applied	L’import est livré	rowCount, action, mapping
import-error	Quelque chose échoue	code, message
import-cancel	L’utilisateur abandonne l’import	—

const el = document.querySelector('mildport-import')!;

el.addEventListener('import-applied', e => {
  const { rowCount, mapping } = (e as CustomEvent).detail;
  console.log(`${rowCount} rows delivered`, mapping);
});

Deux façons de recevoir les lignes

Mode navigateur (applyMode = 'browser') — les lignes sont rendues dans la page via onResults ou l’événement import-applied. Bien pour les démos et les petits flux côté client.

Mode webhook (applyMode = 'webhook') — le moteur envoie les lignes appliquées à votre backend par POST sous forme de livraison signée en HMAC, avec relances durables et un journal d’audit. C’est le chemin de production. Voir la référence des webhooks pour la signature et les en-têtes.

Note

Quel que soit le mode choisi, la charge utile a la même forme : des lignes mappées exactement sur votre columnSchema, plus le mapping qui les a produites.