u

docs/api/routes/attributename.post.md

@@ -22,6 +22,10 @@ Creates an attribute name for the selected company.
 }
 ```
 
+## Signals
+
+On success, emits SSE signal: `attributename` (see [`GET /events`](../events.md)).
+
 ## Response `201`
 
 Created attribute name

docs/api/routes/attributename/_id.delete.md

@@ -12,6 +12,10 @@ Deletes an attribute name and cascades to attribute values and article assignmen
 |-------|----------|------|-------------|
 | `id` | yes | integer |  |
 
+## Signals
+
+On success, emits SSE signal: `attributename` (see [`GET /events`](../events.md)).
+
 ## Response `200`
 
 Deleted successfully

docs/api/routes/attributename/_id.patch.md

@@ -28,6 +28,10 @@ Updates name, sort, and/or exclusive flag for an attribute name.
 }
 ```
 
+## Signals
+
+On success, emits SSE signal: `attributename` (see [`GET /events`](../events.md)).
+
 ## Response `200`
 
 Updated attribute name

docs/api/routes/attributename/order.md

@@ -20,6 +20,10 @@ Updates the display sort order of attribute names for the selected company.
 }
 ```
 
+## Signals
+
+On success, emits SSE signal: `attributename` (see [`GET /events`](../events.md)).
+
 ## Response `200`
 
 Reordered successfully

docs/api/routes/brand/list.md

@@ -4,7 +4,7 @@ Protected. Requires a valid session cookie (`credentials: 'include'`).
 
 List brands
 
-Lists brands for the authenticated user's selected company, sorted by name. Paged; `total` is the unpaged count.
+Lists brands for the authenticated user's selected company, sorted by name. Paged; `total` is the unpaged count. Small-thumbnail fields are omitted by default. Set `includeSmallThumbs=true` to include each picture's `smallThumbW`, `smallThumbH`, and `smallThumbBinary` (base64-encoded AVIF bytes, resized with a 40px maximum edge).
 
 ## Query parameters
 
@@ -12,6 +12,7 @@ Lists brands for the authenticated user's selected company, sorted by name. Page
 |-------|----------|------|-------------|
 | `offset` | no | integer | Number of brands to skip |
 | `limit` | no | integer | Number of brands to return |
+| `includeSmallThumbs` | no | boolean | Include each picture's small thumbnail dimensions and base64 AVIF bytes. |
 
 ## Response `200`
 
@@ -29,7 +30,10 @@ Brand list
           "fullHash": "…",
           "thumbW": 1,
           "thumbH": 1,
-          "thumbHash": "…"
+          "thumbHash": "…",
+          "smallThumbW": 1,
+          "smallThumbH": 1,
+          "smallThumbBinary": "…"
         }
       ]
     }
@@ -44,7 +48,7 @@ Brand list
 
 | Status | Description |
 |--------|-------------|
-| 400 | Invalid offset, invalid limit, or no company selected — `{"error":"…"}` |
+| 400 | Invalid offset, invalid limit, invalid includeSmallThumbs, or no company selected — `{"error":"…"}` |
 | 401 | Unauthorized — `{"error":"…"}` |
 | 403 | Not authorized — `{"error":"…"}` |
 | 404 | Company not found — `{"error":"…"}` |

docs/api/routes/events.md

@@ -24,21 +24,36 @@ to the company at connect time).
 
 ## Signals
 
-| Signal | Emitted after successful |
-|--------|--------------------------|
-| `category` | `POST /category`, `PATCH /category/{id}`, `PUT /category/order`, `DELETE /category/{id}`, `POST /category/{id}/image`, `DELETE /category/{id}/image` |
-| `articles` | `POST /article`, `PATCH /article/{sku}`, `DELETE /article/{sku}` |
-| `article-<sku>` | `PUT /article/{sku}/weight`, `PUT /article/{sku}/prices`, `PUT /article/{sku}/eans`, `PUT /article/{sku}/categories`, `PUT /article/{sku}/brand`, `PUT /article/{sku}/images/order`, `POST /article/{sku}/image`, `DELETE /article/{sku}/image/{fullHash}` |
-| `brand` | `POST /brand`, `PATCH /brand/{id}`, `DELETE /brand/{id}`, `POST /brand/{id}/image`, `DELETE /brand/{id}/image` |
+Every SSE event uses the event name as the signal id; payloads are
+JSON and most events send an empty object `{}`. Only `brand` emits a
+richer payload.
 
-The `brand` signal carries a JSON payload `{ sender, brandId }`:
-`sender` echoes the caller's `x-client-id` header (empty string if
-absent) so the sender can ignore its own event; `brandId` is the
-affected brand id (`null` only if unknown). Other signals send `{}`.
+| Signal | Payload | Emitted after successful |
+|--------|---------|--------------------------|
+| `category` | `{}` | `POST /category`, `PATCH /category/{id}`, `PUT /category/order`, `DELETE /category/{id}`, `POST /category/{id}/image`, `DELETE /category/{id}/image`, `PUT /category/{id}/property` |
+| `articles` | `{}` | `POST /article`, `PATCH /article/{sku}`, `DELETE /article/{sku}`, `PUT /article/{sku}/articles`-style list-level changes, `POST /category/{id}/article` and related article-assigning category mutations |
+| `article-<sku>` | `{}` | `PUT /article/{sku}/weight`, `PUT /article/{sku}/prices`, `PUT /article/{sku}/eans`, `PUT /article/{sku}/categories`, `PUT /article/{sku}/brand`, `PUT /article/{sku}/images/order`, `POST /article/{sku}/image`, `DELETE /article/{sku}/image/{fullHash}`, supplier/article-property mutations affecting the article |
+| `stock` | `{}` | `POST /stock/adjust` |
+| `ledger` | `{}` | `POST /stock/adjust` |
+| `attributename` | `{}` | `POST /attributename`, `PUT /attributename/order`, `PATCH /attributename/{id}`, `DELETE /attributename/{id}` |
+| `propertyname` | `{}` | `POST /propertyname`, `PUT /propertyname/order`, `PATCH /propertyname/{id}`, `DELETE /propertyname/{id}` |
+| `labeltemplate` | `{}` | `POST /labeltemplate`, `PUT /labeltemplate/{id}`, `PATCH /labeltemplate/{id}`, `DELETE /labeltemplate/{id}` |
+| `printer` | `{}` | `POST /printer`, `PUT /printer/{id}`, `PATCH /printer/{id}`, `DELETE /printer/{id}` |
+| `warehouse` | `{}` | `POST /warehouse`, `PUT /warehouse/{id}`, `PATCH /warehouse/{id}`, `DELETE /warehouse/{id}` |
+| `vfs` | `{}` | VFS uploads and filesystem mutations such as `POST /vfs/upload`, `POST /vfs/mkdir`, `POST /vfs/rename`, `PUT /vfs/{*path}`, `DELETE /vfs/{*path}` |
+| `modelconversation` | `{}` | `POST /modelconversation`, `DELETE /modelconversation/{id}` |
+| `modelconversation-<id>` | `{}` | Conversation-specific updates on the same model conversation thread; the concrete ID is used in the event name |
+| `brand` | `{ sender, brandId }` | `POST /brand`, `PATCH /brand/{id}`, `DELETE /brand/{id}`, `POST /brand/{id}/image`, `DELETE /brand/{id}/image` |
+
+The `brand` payload is `{ sender, brandId }`: `sender` echoes the
+caller's `x-client-id` header (empty string if absent) so the sender
+can ignore its own event; `brandId` is the affected brand id (`null`
+only if unknown). All other signals send `{}`.
 
 Signals are only sent when the mutation actually succeeds (2xx).
 Failed or no-op validation errors do not emit. The `article-<sku>`
-event name uses the concrete SKU (e.g. `article-42000045`).
+and `modelconversation-<id>` event names use the concrete item id at
+runtime (for example `article-42000045` and `modelconversation-123`).
 
 
 ## Response `200`

docs/api/routes/labeltemplate/create.md

@@ -46,6 +46,10 @@ and stored with the template.
 }
 ```
 
+## Signals
+
+On success, emits SSE signal: `labeltemplate` (see [`GET /events`](../events.md)).
+
 ## Response `201`
 
 Created label template

docs/api/routes/labeltemplate/delete.md

@@ -12,6 +12,10 @@ Deletes a label template for the authenticated user's selected company.
 |-------|----------|------|-------------|
 | `id` | yes | integer | Label template ID |
 
+## Signals
+
+On success, emits SSE signal: `labeltemplate` (see [`GET /events`](../events.md)).
+
 ## Response `204`
 
 Label template deleted

docs/api/routes/labeltemplate/update.md

@@ -51,6 +51,10 @@ When `content` (or `width`/`height`) is provided, the thumbnail is automatically
 }
 ```
 
+## Signals
+
+On success, emits SSE signal: `labeltemplate` (see [`GET /events`](../events.md)).
+
 ## Response `200`
 
 Updated label template

docs/api/routes/modelconversation.post.md

@@ -20,6 +20,10 @@ Creates a new conversation in state `idle`.
 }
 ```
 
+## Signals
+
+On success, emits SSE signal: `modelconversation` (see [`GET /events`](../events.md)).
+
 ## Response `201`
 
 Created conversation

docs/api/routes/modelconversation/_id.delete.md

@@ -12,6 +12,10 @@ Deletes one of the authenticated user's model conversations and all its messages
 |-------|----------|------|-------------|
 | `id` | yes | integer | Conversation ID |
 
+## Signals
+
+On success, emits SSE signal: `modelconversation` (see [`GET /events`](../events.md)).
+
 ## Response `204`
 
 Conversation deleted

docs/api/routes/modelconversation/_id/message.post.md

@@ -34,6 +34,10 @@ Refused with 409 unless the conversation state is `idle`.
 }
 ```
 
+## Signals
+
+On success, emits SSE signal: `modelconversation-<id>` (see [`GET /events`](../events.md)).
+
 ## Response `201`
 
 Created message

docs/api/routes/printer/_id.put.md

@@ -34,6 +34,10 @@ Updates specified fields of an existing printer for the selected company.
 }
 ```
 
+## Signals
+
+On success, emits SSE signal: `printer` (see [`GET /events`](../events.md)).
+
 ## Response `200`
 
 Updated printer

docs/api/routes/printer/create.md

@@ -30,6 +30,10 @@ Creates a new printer for the selected company.
 }
 ```
 
+## Signals
+
+On success, emits SSE signal: `printer` (see [`GET /events`](../events.md)).
+
 ## Response `201`
 
 Created printer

docs/api/routes/printer/delete.md

@@ -12,6 +12,10 @@ Deletes a printer for the authenticated user's selected company.
 |-------|----------|------|-------------|
 | `id` | yes | integer | Printer ID |
 
+## Signals
+
+On success, emits SSE signal: `printer` (see [`GET /events`](../events.md)).
+
 ## Response `204`
 
 Printer deleted

docs/api/routes/printer/order.md

@@ -22,6 +22,10 @@ Reorders printers for the selected company.
 }
 ```
 
+## Signals
+
+On success, emits SSE signal: `printer` (see [`GET /events`](../events.md)).
+
 ## Response `200`
 
 Applied printer order

docs/api/routes/printer/update.md

@@ -34,6 +34,10 @@ Updates specified fields of an existing printer for the selected company.
 }
 ```
 
+## Signals
+
+On success, emits SSE signal: `printer` (see [`GET /events`](../events.md)).
+
 ## Response `200`
 
 Updated printer

docs/api/routes/propertyname.post.md

@@ -22,6 +22,10 @@ Creates a new property name for the selected company.
 }
 ```
 
+## Signals
+
+On success, emits SSE signal: `propertyname` (see [`GET /events`](../events.md)).
+
 ## Response `201`
 
 Created property name

docs/api/routes/propertyname/_id.delete.md

@@ -12,6 +12,10 @@ Deletes a property name and cascades to article properties.
 |-------|----------|------|-------------|
 | `id` | yes | integer |  |
 
+## Signals
+
+On success, emits SSE signal: `propertyname` (see [`GET /events`](../events.md)).
+
 ## Response `200`
 
 Deleted successfully

docs/api/routes/propertyname/_id.patch.md

@@ -28,6 +28,10 @@ Updates name and/or sort for a property name.
 }
 ```
 
+## Signals
+
+On success, emits SSE signal: `propertyname` (see [`GET /events`](../events.md)).
+
 ## Response `200`
 
 Updated property name

docs/api/routes/propertyname/order.md

@@ -20,6 +20,10 @@ Updates the display sort order of property names for the selected company.
 }
 ```
 
+## Signals
+
+On success, emits SSE signal: `propertyname` (see [`GET /events`](../events.md)).
+
 ## Response `200`
 
 Reordered successfully

docs/api/routes/stock/adjust.md

@@ -41,6 +41,10 @@ of type "adjustment", allocating a number from the "adjustment" number scheme.
 }
 ```
 
+## Signals
+
+On success, emits SSE signals: `stock`, `ledger`, `articles`, `article-<sku>` (see [`GET /events`](../events.md)).
+
 ## Response `201`
 
 Stock adjusted successfully

docs/api/routes/warehouse/_id.put.md

@@ -26,6 +26,10 @@ Updates specified fields of an existing warehouse for the selected company.
 }
 ```
 
+## Signals
+
+On success, emits SSE signal: `warehouse` (see [`GET /events`](../events.md)).
+
 ## Response `200`
 
 Updated warehouse

docs/api/routes/warehouse/create.md

@@ -22,6 +22,10 @@ Sort order will be automatically appended if omitted.
 }
 ```
 
+## Signals
+
+On success, emits SSE signal: `warehouse` (see [`GET /events`](../events.md)).
+
 ## Response `201`
 
 Created warehouse

docs/api/routes/warehouse/delete.md

@@ -12,6 +12,10 @@ Deletes a warehouse if not in use in the ledger.
 |-------|----------|------|-------------|
 | `id` | yes | integer | Warehouse ID |
 
+## Signals
+
+On success, emits SSE signal: `warehouse` (see [`GET /events`](../events.md)).
+
 ## Response `204`
 
 Warehouse deleted

docs/api/routes/warehouse/order.md

@@ -22,6 +22,10 @@ Reorders warehouses for the selected company.
 }
 ```
 
+## Signals
+
+On success, emits SSE signal: `warehouse` (see [`GET /events`](../events.md)).
+
 ## Response `200`
 
 Applied warehouse order