@altazion/commerce-sdk-core 26.512.7969 → 26.601.8195

package/README.md

@@ -83,6 +83,62 @@ try {
 }
 ```
 
+## Résumé panier local
+
+Le module `cart` maintient désormais un résumé local dérivé du panier complet.
+
+- `client.cart.peekSummary()` retourne le dernier snapshot en mémoire sans I/O ;
+- `client.cart.getSummary()` retourne le snapshot mémoire ou persistant, puis lance un lazy reload si le résumé est périmé ;
+- `client.cart.refreshSummary()` force une relecture du panier et régénère le résumé.
+
+Le résumé expose notamment :
+
+- le total TTC global ;
+- la quantité totale ;
+- le nombre de références principales ;
+- un détail par `contentType` avec total TTC, nombre de références principales, nombre de lignes principales et quantité principale.
+
+```ts
+const summary = await client.cart.getSummary()
+
+console.log(summary?.totalAmountWithTax)
+console.log(summary?.contents)
+```
+
+  ## Bridge host borne
+
+  Le package core expose aussi un bridge léger vers le host WebView des bornes pour piloter les périphériques remontés par le shell embarqué.
+
+  ```ts
+  import { CommerceClient, PeripheralTpe } from '@altazion/commerce-sdk-core'
+
+  const client = new CommerceClient({
+    baseUrl: 'https://votre-api.altazion.com',
+  })
+
+  client.devices.initialize()
+
+  const tpe = client.devices.findPeripheralByType('TPE')[0] as PeripheralTpe | undefined
+
+  tpe?.on((notification) => {
+    console.log(notification.kind, notification.getNormalizedPayload())
+  })
+
+  tpe?.onSuccess((type, orderGuid, notification) => {
+    console.log(type, orderGuid, notification.getNormalizedPayload())
+  })
+
+  tpe?.makePayment('order-guid', 'CMD123', 'mrg-guid', 42.5, 'EUR')
+  ```
+
+  Capacités couvertes dans cette première reprise :
+
+  - découverte des périphériques remontés par le host via `DeviceManager.Init` ;
+  - dispatch des notifications `TPE:*`, `BARCODE:*` et des mises à jour d'état ;
+  - normalisation des payloads host via `notification.getNormalizedPayload()` pour absorber les variantes anciennes ;
+  - commandes shell `shell.state-change` et `app.status-update` ;
+  - mode mock pour les templates et les développements hors borne.
+
 ## Licence
 
 Propriétaire — © Altazion SAS. Tous droits réservés.