@supersoniks/concorde 4.9.92 → 4.9.94

package/ai/cursor/rules/concorde.mdc

@@ -23,6 +23,8 @@ Migration get/set/dp : `.cursor/skills/concorde-get-set-dp/SKILL.md`
 ## Interdits (nouveau code)
 
 - `sonic-fetch` → `sonic-queue` + filtre, ou `@get`
+- Les décorateurs API (`@get`, `@post`, `@put`, `@patch`) s'adaptent aux
+  propriétés et aux méthodes
 - `@onAssign` → `@handle` + `DataProviderKey`
 - `@bind` → `@subscribe` + `DataProviderKey<T, U>` (pas sur composants métier)
 - `data-bind` HTML → `@subscribe` / `sub()`
@@ -46,6 +48,11 @@ Placeholder `${prop}` = chaîne normale, résolu depuis le composant hôte.
 ## Scope / theme
 
 - **Scope** : `<sonic-scope serviceURL="…">` · `@get(endpoint)` ou `@get(endpoint, apiConfigKey)` — skills `concorde-scope`
+- **GET + handler** : `@get(endpoint)` sur une méthode ; le handler reçoit
+  `result`, `response`, `request`, ou `undefined`. Conserver le handle retourné
+  par `get` pour `refetch`.
+- **Write + handler** : même modèle avec `post`, `put`, `patch` ; `@send`
+  reste le déclencheur explicite.
 - **Theme** : `<sonic-theme background color font>` · `--sc-*` — skill `concorde-theme`
 
 ## Migration Subscriber / sonic-fetch (piège fréquent)

package/ai/jetbrains/rules/concorde.md

@@ -16,6 +16,8 @@ Référence doc : fichiers `.md` dans `node_modules/@supersoniks/concorde/src/`.
 ## Interdits (nouveau code)
 
 - sonic-fetch → sonic-queue + filtre, ou @get
+- Les décorateurs API (@get, @post, @put, @patch) s'adaptent aux propriétés
+  et aux méthodes
 - @onAssign → @handle + DataProviderKey
 - data-bind HTML → @subscribe / sub()
 - sonic-input + @input → formDataProvider + name
@@ -31,6 +33,10 @@ Placeholder `${prop}` dans une chaîne normale : `"users.${userIndex}"`.
 - **Scope** (`sonic-scope`) : `serviceURL`, `formDataProvider`, icônes — skill `concorde-scope`
 - **Theme** (`sonic-theme`) : `--sc-*` tokens, dark mode — skill `concorde-theme`
 - `@get(endpoint)` sans clé config → hérite scope ; `@get(endpoint, apiConfigKey)` → DataProvider
+- `@get(endpoint)` sur une méthode reçoit `result`, `response`, `request`, ou
+  `undefined` ; conserver le handle retourné par `get` pour `refetch`
+- Même modèle avec `post`, `put`, `patch` ; `@send` reste le déclencheur
+  explicite de l'opération
 - Modale / portal : préférer `apiConfigKey` si pas de scope DOM fiable
 
 ## Migration Subscriber / sonic-fetch

package/ai/skills/concorde/SKILL.md

@@ -29,6 +29,9 @@ Référence complète : skill **`concorde-imports`** (`.cursor/skills/concorde-i
 - **Ne pas** introduire `@onAssign` — préférer `@handle` + `DataProviderKey`.
 - **Ne pas** utiliser **`@bind`** sur les composants métier — préférer **`@subscribe`** + `DataProviderKey<T, U>` (typage + placeholders `${prop}` sur l’hôte).
 - **Ne pas** utiliser **`sonic-fetch`** — préférer **`sonic-queue`** (+ filtre `formDataProvider`) ou **`@get`** + `Endpoint`.
+- Les décorateurs API **`@get`**, **`@post`**, **`@put`** et **`@patch`**
+  s'adaptent aux propriétés et aux méthodes ; la méthode reçoit le
+  `ApiResult` complet.
 - **Ne pas** importer **`PublisherManager`** — utiliser **`get` / `set`** (réexport Concorde ou wrapper projet).
 - **Ne pas** promouvoir les templates HTML (`<template>`, `data-value`) pour **`sonic-list`** / **`sonic-queue`** — préférer **`.items`**, **`.noItems`**, **`.skeleton`**, **`.separator`** (binding propriété Lit obligatoire pour les fonctions).
 
@@ -94,6 +97,47 @@ users.path;
 
 Utilisé avec `@get(endpoint)` ou `@get(endpoint, apiConfigKey)` — voir **Scope** ci-dessous.
 
+### Décorateurs API sur une méthode
+
+`@get`, `@post`, `@put` et `@patch` peuvent décorer une propriété ou une
+méthode. En mode méthode, le callback reçoit le `ApiResult` complet :
+
+```typescript
+@get(endpoints.ticket)
+handleTicket(payload: ApiResult<PurchaseItem> | undefined) {
+  if (!payload?.result || !payload.response?.ok) return;
+  dp<PurchaseItem>(this.dataProvider).set(payload.result);
+}
+```
+
+La méthode reçoit le payload complet (`result`, `response`, `request`).
+`undefined` représente un appel terminé sans payload, par exemple une erreur
+réseau. Si un refetch nommé est nécessaire, conserver le handle et décorer la
+méthode avec lui :
+
+```typescript
+const ticketGet = get(endpoints.ticket);
+
+@ticketGet
+handleTicket(payload: ApiResult<PurchaseItem> | undefined) {}
+
+@refetch(ticketGet)
+reloadTicket() {}
+```
+
+`@send(handle)` reste le décorateur de méthode qui déclenche explicitement une
+écriture ; les mutations du body, triggers et polling conservent leur
+comportement.
+
+Exemple écriture :
+
+```typescript
+@post(endpoints.ticket, ticketBodyKey)
+handleTicketCreation(payload: ApiResult<PurchaseItem> | undefined) {
+  if (payload?.response?.ok) console.log(payload.result);
+}
+```
+
 ## Scope — defaults hérités
 
 Skill dédié : **`concorde-scope`**.
@@ -270,6 +314,8 @@ Propriétés Lit (recommandé) :
 | Lire (affichage Lit) | `@subscribe(dpKey.leaf)` + `@state()` — **une fois par champ** du `render()` |
 | Effet typé | `@handle(dpKey.a, …)` |
 | API HTTP | `@get(Endpoint)` ou `@get(Endpoint, apiConfigKey)` |
+| Effet après GET | `@get(endpoint)` sur une méthode |
+| Effet après écriture | `@post` / `@put` / `@patch` sur une méthode |
 | Écriture classe (hors form) | `@publish` |
 | Lecture classe (hors form) | `@subscribe` + `DataProviderKey` — pas `@bind` |
 
@@ -298,3 +344,5 @@ Propriétés Lit (recommandé) :
 - **Config API app-wide** : `<sonic-scope serviceURL="…">` ou `DataProviderKey<APIConfiguration>`.
 - **Theme / couleurs** : `<sonic-theme>` + CSS `--sc-*`.
 - **Clé dynamique** : `"chemin.${prop}"` + `DataProviderKey<T, { prop: … }>`.
+- **GET avec effet de bord** : `@get(endpoint)` sur une méthode ; conserver
+  `const request = get(endpoint)` si un refetch nommé est nécessaire.

package/build-infos.json

@@ -1 +1 @@
-{"date":1789469206}
+{"date":1790327430}