@quadrokit/client 0.3.12 → 0.3.14

package/README.md

@@ -16,6 +16,7 @@ The package exposes:
 
 - **`@quadrokit/client`** — runtime + types (and anything your generated code needs).
 - **`@quadrokit/client/runtime`** — low-level helpers if you build custom integrations.
+- **`@quadrokit/client/rx`** — optional RxJS bridge for `QuadroEventBus` (install **`rxjs`** in your app).
 
 ---
 
@@ -53,7 +54,7 @@ Environment variables (often via `.env` in the project root): `VITE_4D_ORIGIN`,
 |------|---------|
 | **`types.gen.ts`** | Entity interfaces; **`*Path`** aliases use **`QuadroAttributePaths<T>`** (recursive dot paths, depth-limited for circular relations); **`QuadroClient`** typing. |
 | **`catalog.gen.json`** | Catalog runtime spec (dataclass layouts, methods, relations) consumed by `@quadrokit/client/runtime` — keeps **`client.gen.ts`** tiny. |
-| **`client.gen.ts`** | Thin `createClient(config)` that wires `QuadroHttp` + `buildQuadroClientFromCatalogSpec` + `catalog.gen.json`. |
+| **`client.gen.ts`** | Thin `createClient(config)` that wires `QuadroHttp` + `buildQuadroClientFromCatalogSpec` + `catalog.gen.json`. Config supports optional **`events`** (see [Request lifecycle events](#request-lifecycle-events)). |
 | **`meta.json`** | `__NAME`, `sessionCookieName` hint for 4D session cookies. |
 
 Point your app imports at the generated folder, for example:
@@ -80,10 +81,90 @@ const quadro = createClient({
 })
 ```
 
+Optional **`events: new QuadroEventBus()`** (from **`@quadrokit/client/runtime`**) enables [request lifecycle events](#request-lifecycle-events) on every call through the client.
+
 At runtime, requests use **`credentials: 'include'`** so session cookies (e.g. `4DSID_<datastore>`) are sent when your app and 4D share the same site or proxy. See `meta.json` → `sessionCookieName` after generate.
 
 ---
 
+## Request lifecycle events
+
+Pass a **`QuadroEventBus`** from **`@quadrokit/client/runtime`** into **`createClient({ …, events })`**. The runtime emits a **loading → success** or **loading → error** sequence per logical operation (lists, `get`, `delete`, class functions, datastore paths, login, etc.).
+
+```ts
+import { createClient } from './.quadrokit/generated/client.gen.js'
+import { QuadroEventBus } from '@quadrokit/client/runtime'
+
+const events = new QuadroEventBus()
+
+const quadro = createClient({
+  baseURL: '/rest',
+  events,
+})
+
+const unsub = events.subscribe((e) => {
+  if (e.type === 'loading') {
+    console.debug(e.context.operation, e.path, e.method)
+  }
+  if (e.type === 'success') {
+    console.debug(e.durationMs, e.body)
+  }
+  if (e.type === 'error') {
+    console.warn(e.status, e.message, e.error)
+  }
+})
+
+// later: unsub()
+```
+
+You can also subscribe on the HTTP instance: **`quadro._http.subscribe(listener)`** returns an unsubscribe function.
+
+### Event shapes (`QuadroClientEvent`)
+
+| Field | `loading` | `success` | `error` |
+|-------|-----------|-----------|---------|
+| **`type`** | `'loading'` | `'success'` | `'error'` |
+| **`operationId`** | Correlates one start → one outcome | same | same |
+| **`context`** | **`QuadroRequestContext`**: **`operation`** (**`QuadroOperation`** string), optional **`className`**, **`methodName`**, **`entityKey`**, **`attributes`** | same | same |
+| **`path`** | Request path | same | same |
+| **`method`** | HTTP method | — | — |
+| **`startedAt`** | Timestamp | — | — |
+| **`durationMs`** | — | Elapsed | Elapsed |
+| **`status`** | — | If HTTP response is raw `Response` | If thrown value has HTTP **`status`** (e.g. **`QuadroHttpError`**) |
+| **`body`** | — | Result: parsed JSON, rows, `void`, or a small summary for raw **`Response`** | — |
+| **`message` / `error`** | — | — | User-facing message + original error |
+
+### Operations (`QuadroOperation`)
+
+Examples include: **`http.json`**, **`http.void`**, **`http.request`**, **`collection.list`**, **`collection.release`**, **`dataclass.get`**, **`dataclass.delete`**, **`function.dataclass`**, **`function.entity`**, **`function.entityCollection`**, **`datastore`**, **`auth.login`**.
+
+### `QuadroHttp` helpers (advanced)
+
+When **`events`** is set, **`json`**, **`void`**, and **`request`** accept an optional trailing **`QuadroRequestContext`** so emissions can be tagged. **`QuadroHttp`** also exposes:
+
+- **`rawRequest(path, init)`** — fetch without emitting (used inside multi-step flows).
+- **`runWithEvents(context, path, method, fn)`** — run an async function with the same loading/success/error envelope as the built-in methods.
+- **`events`** getter — the bus instance, if any.
+
+---
+
+## RxJS (`@quadrokit/client/rx`)
+
+Install **`rxjs`** in your app, then bridge the bus to an observable:
+
+```ts
+import { quadroEventsObservable } from '@quadrokit/client/rx'
+import { filter } from 'rxjs/operators'
+
+const sub = quadroEventsObservable(events)
+  .pipe(filter((e) => e.type === 'error'))
+  .subscribe((e) => console.warn(e.message))
+```
+
+**`rxjs`** is an **optional peer dependency** of `@quadrokit/client`; you only need it if you import `@quadrokit/client/rx`.
+
+---
+
 ## Dataclass API (generated)
 
 For each exposed dataclass, the client exposes a namespace such as `quadro.Agency`, `quadro.Reservation`, etc.
@@ -178,7 +259,8 @@ Import from **`@quadrokit/client/runtime`** when you need primitives without cod
 
 | Export | Use |
 |--------|-----|
-| **`QuadroHttp`** | Thin wrapper: `json()`, `void()`, `request()` with base URL + default headers. |
+| **`QuadroHttp`** | Thin wrapper: **`json()`**, **`void()`**, **`request()`** with base URL + default headers; optional **`events`**; **`rawRequest`**, **`runWithEvents`**, **`subscribe`**. |
+| **`QuadroEventBus`**, **`QuadroClientEvent`**, **`QuadroLoadingEvent`**, **`QuadroSuccessEvent`**, **`QuadroErrorEvent`**, **`QuadroRequestContext`**, **`QuadroOperation`** | Lifecycle event types and bus (see [Request lifecycle events](#request-lifecycle-events)). |
 | **`createCollection`** | Build a `CollectionHandle` from a `CollectionContext` + options + row mapper. |
 | **`callDataClassFunction`**, **`callEntityFunction`**, **`callEntityCollectionFunction`** | Call ORDA functions by name and path (same REST rules as above). |
 | **`callDatastorePath`**, **`createClient`’s `rpc`** | Arbitrary segments under the REST root, e.g. datastore or singleton paths. |
@@ -191,7 +273,7 @@ The generated `createClient` is the recommended surface; these are for tooling,
 
 ## Errors
 
-Failed HTTP responses throw **`QuadroHttpError`** (status + response body). Handle network errors separately (`fetch` failures).
+Failed HTTP responses throw **`QuadroHttpError`** (status + response body). Handle network errors separately (`fetch` failures). When **`events`** is configured, failures also emit a **`QuadroErrorEvent`** with **`message`**, **`error`**, and optional **`status`** before the error propagates.
 
 ---
 

package/dist/generate/codegen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../src/generate/codegen.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAsC,WAAW,EAAE,MAAM,mBAAmB,CAAA;AA4GxF,yFAAyF;AACzF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG;IAC7D,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QACnC,QAAQ,EAAE,MAAM,EAAE,CAAA;QAClB,iBAAiB,EAAE,MAAM,EAAE,CAAA;QAC3B,2BAA2B,EAAE,MAAM,EAAE,CAAA;QACrC,oBAAoB,EAAE,MAAM,EAAE,CAAA;QAC9B,SAAS,EAAE;YACT,IAAI,EAAE,MAAM,CAAA;YACZ,WAAW,EAAE,MAAM,CAAA;YACnB,2BAA2B,EAAE,MAAM,EAAE,CAAA;SACtC,EAAE,CAAA;KACJ,EAAE,CAAA;IACH,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IACzC,aAAa,EAAE,OAAO,CAAA;CACvB,CAuBA;AA0GD,uIAAuI;AACvI,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAYvE;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBxF"}
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../src/generate/codegen.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAsC,WAAW,EAAE,MAAM,mBAAmB,CAAA;AA4GxF,yFAAyF;AACzF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG;IAC7D,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QACnC,QAAQ,EAAE,MAAM,EAAE,CAAA;QAClB,iBAAiB,EAAE,MAAM,EAAE,CAAA;QAC3B,2BAA2B,EAAE,MAAM,EAAE,CAAA;QACrC,oBAAoB,EAAE,MAAM,EAAE,CAAA;QAC9B,SAAS,EAAE;YACT,IAAI,EAAE,MAAM,CAAA;YACZ,WAAW,EAAE,MAAM,CAAA;YACnB,2BAA2B,EAAE,MAAM,EAAE,CAAA;SACtC,EAAE,CAAA;KACJ,EAAE,CAAA;IACH,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IACzC,aAAa,EAAE,OAAO,CAAA;CACvB,CAuBA;AA6GD,uIAAuI;AACvI,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAYvE;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBxF"}

package/dist/generate/codegen.mjs

@@ -193,6 +193,8 @@ export interface QuadroClientConfig {
   baseURL: string;
   fetchImpl?: typeof fetch;
   defaultHeaders?: Record<string, string>;
+  /** Optional bus for request lifecycle events (loading / success / error). See {@link QuadroEventBus} from \`@quadrokit/client/runtime\`. */
+  events?: import('@quadrokit/client/runtime').QuadroEventBus;
 }
 `;
     const body = `
@@ -201,6 +203,7 @@ export function createClient(config: QuadroClientConfig): QuadroClient {
     baseURL: config.baseURL,
     fetchImpl: config.fetchImpl,
     defaultHeaders: config.defaultHeaders,
+    events: config.events,
   });
   return buildQuadroClientFromCatalogSpec(
     http,

package/dist/runtime/catalog-builder.mjs

@@ -86,7 +86,7 @@ export function buildQuadroClientFromCatalogSpec(http, spec, meta) {
     const out = {};
     if (spec.hasAuthentify) {
         out.authentify = {
-            login: (body) => callDatastorePath(http, ['authentify', 'login'], { body }),
+            login: (body) => callDatastorePath(http, ['authentify', 'login'], { body }, { operation: 'auth.login' }),
         };
     }
     for (const c of spec.classes) {

package/dist/runtime/class-function.d.ts

@@ -1,7 +1,3 @@
-/**
- * ORDA class functions over REST ([4D docs](https://developer.4d.com/docs/REST/classFunctions.html)):
- * dataclass, entity selection (entityCollection), and entity methods.
- */
 import type { QuadroHttp } from './http.js';
 import { type MethodSelectionQuery } from './query.js';
 export type ClassFunctionHttpOptions = {

package/dist/runtime/class-function.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"class-function.d.ts","sourceRoot":"","sources":["../../src/runtime/class-function.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAA6B,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEjF,MAAM,MAAM,wBAAwB,GAAG;IACrC,4EAA4E;IAC5E,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;IACvB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,CAAA;AAED,uGAAuG;AACvG,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CAK7D;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,EAC3C,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,SAAS,OAAO,EAAE,EACxB,OAAO,CAAC,EAAE,wBAAwB,GAAG;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9D,OAAO,CAAC,CAAC,CAAC,CAoBZ;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,SAAS,OAAO,EAAE,EACxB,OAAO,CAAC,EAAE,wBAAwB,GAAG;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9D,OAAO,CAAC,CAAC,CAAC,CAqBZ;AAED,MAAM,MAAM,6BAA6B,GAAG,wBAAwB,GAAG;IACrE,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,oBAAoB,CAAA;IAChC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,CAAC,CAAC,EAClD,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,SAAS,OAAO,EAAE,EACxB,OAAO,CAAC,EAAE,6BAA6B,GACtC,OAAO,CAAC,CAAC,CAAC,CA2BZ"}
+{"version":3,"file":"class-function.d.ts","sourceRoot":"","sources":["../../src/runtime/class-function.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAA6B,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEjF,MAAM,MAAM,wBAAwB,GAAG;IACrC,4EAA4E;IAC5E,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;IACvB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,CAAA;AAED,uGAAuG;AACvG,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CAK7D;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,EAC3C,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,SAAS,OAAO,EAAE,EACxB,OAAO,CAAC,EAAE,wBAAwB,GAAG;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9D,OAAO,CAAC,CAAC,CAAC,CAkCZ;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,SAAS,OAAO,EAAE,EACxB,OAAO,CAAC,EAAE,wBAAwB,GAAG;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9D,OAAO,CAAC,CAAC,CAAC,CAoCZ;AAED,MAAM,MAAM,6BAA6B,GAAG,wBAAwB,GAAG;IACrE,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,oBAAoB,CAAA;IAChC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,CAAC,CAAC,EAClD,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,SAAS,OAAO,EAAE,EACxB,OAAO,CAAC,EAAE,6BAA6B,GACtC,OAAO,CAAC,CAAC,CAAC,CA4CZ"}

package/dist/runtime/class-function.mjs

@@ -14,6 +14,12 @@ export async function callDataClassFunction(http, dataClass, functionName, args,
     const method = options?.method ?? 'POST';
     const unwrap = options?.unwrapResult !== false;
     const base = `/${dataClass}/${functionName}`;
+    const ctx = {
+        operation: 'function.dataclass',
+        className: dataClass,
+        methodName: functionName,
+        attributes: { argCount: args.length },
+    };
     let body;
     if (method === 'GET') {
         const params = new URLSearchParams();
@@ -21,14 +27,14 @@ export async function callDataClassFunction(http, dataClass, functionName, args,
         body = await http.json(`${base}?${params.toString()}`, {
             method: 'GET',
             signal: options?.signal,
-        });
+        }, ctx);
     }
     else {
         body = await http.json(base, {
             method: 'POST',
             body: JSON.stringify([...args]),
             signal: options?.signal,
-        });
+        }, ctx);
     }
     return (unwrap ? unwrapClassFunctionResult(body) : body);
 }
@@ -40,6 +46,13 @@ export async function callEntityFunction(http, dataClass, entityKey, functionNam
     const unwrap = options?.unwrapResult !== false;
     const key = encodeURIComponent(String(entityKey));
     const base = `/${dataClass}(${key})/${functionName}`;
+    const ctx = {
+        operation: 'function.entity',
+        className: dataClass,
+        methodName: functionName,
+        entityKey,
+        attributes: { argCount: args.length },
+    };
     let body;
     if (method === 'GET') {
         const params = new URLSearchParams();
@@ -47,14 +60,14 @@ export async function callEntityFunction(http, dataClass, entityKey, functionNam
         body = await http.json(`${base}?${params.toString()}`, {
             method: 'GET',
             signal: options?.signal,
-        });
+        }, ctx);
     }
     else {
         body = await http.json(base, {
             method: 'POST',
             body: JSON.stringify([...args]),
             signal: options?.signal,
-        });
+        }, ctx);
     }
     return (unwrap ? unwrapClassFunctionResult(body) : body);
 }
@@ -72,6 +85,15 @@ export async function callEntityCollectionFunction(http, dataClass, relationMap,
         path += `/$entityset/${encodeURIComponent(id)}`;
     }
     path += buildMethodSelectionQuery(dataClass, relationMap, options?.selection);
+    const ctx = {
+        operation: 'function.entityCollection',
+        className: dataClass,
+        methodName: functionName,
+        attributes: {
+            argCount: args.length,
+            ...(options?.entitySet ? { entitySet: options.entitySet } : {}),
+        },
+    };
     let body;
     if (method === 'GET') {
         const params = new URLSearchParams();
@@ -80,14 +102,14 @@ export async function callEntityCollectionFunction(http, dataClass, relationMap,
         body = await http.json(`${path}${join}${params.toString()}`, {
             method: 'GET',
             signal: options?.signal,
-        });
+        }, ctx);
     }
     else {
         body = await http.json(path, {
             method: 'POST',
             body: JSON.stringify([...args]),
             signal: options?.signal,
-        });
+        }, ctx);
     }
     return (unwrap ? unwrapClassFunctionResult(body) : body);
 }

package/dist/runtime/collection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../src/runtime/collection.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AACnF,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,YAAY,CAAA;AAGnB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,gEAAgE;IAChE,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sFAAsF;IACtF,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,6FAA6F;IAC7F,gBAAgB,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,CAAA;CACnD;AAED,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,CAAA;AAsE3C;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,GAAG,EAAE,iBAAiB,EACtB,cAAc,EAAE,iBAAiB,EACjC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAChB,gBAAgB,CAAC,CAAC,CAAC,CAmKrB;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,GAAG;IACnD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB,CAAA"}
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../src/runtime/collection.ts"],"names":[],"mappings":"AACA,OAAO,EAA0C,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AACnF,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,YAAY,CAAA;AAGnB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,gEAAgE;IAChE,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sFAAsF;IACtF,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,6FAA6F;IAC7F,gBAAgB,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,CAAA;CACnD;AAED,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,CAAA;AAsE3C;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,GAAG,EAAE,iBAAiB,EACtB,cAAc,EAAE,iBAAiB,EACjC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAChB,gBAAgB,CAAC,CAAC,CAAC,CA6LrB;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,GAAG;IACnD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB,CAAA"}

package/dist/runtime/collection.mjs

@@ -1,3 +1,4 @@
+import { QuadroHttpError } from './errors.mjs';
 import { mountPathFromBaseURL, normalizeBaseURL } from './http.mjs';
 import { buildEntitySetCreationParams, buildEntitySetPageParams, buildListSearchParams, } from './query.mjs';
 import { unwrapEntityList } from './unwrap.mjs';
@@ -93,57 +94,68 @@ export function createCollection(ctx, initialOptions, mapRow) {
                 }
             }
         }
-        if (useEntitySet && !entitySetUrl) {
-            const qsCreate = buildEntitySetCreationParams(initialOptions);
-            const createPath = `${ctx.path}${qsCreate}`;
-            const resCreate = await ctx.http.request(createPath, {
-                signal: initialOptions.signal,
-            });
-            const textCreate = await resCreate.text();
-            if (!resCreate.ok) {
-                throw new Error(`Entity set creation failed ${resCreate.status}: ${textCreate.slice(0, 200)}`);
+        const listContext = {
+            operation: 'collection.list',
+            className: ctx.className,
+            attributes: {
+                page,
+                useEntitySet,
+                ...(initialOptions.filter !== undefined ? { filter: initialOptions.filter } : {}),
+            },
+        };
+        return ctx.http.runWithEvents(listContext, ctx.path, 'GET', async () => {
+            if (useEntitySet && !entitySetUrl) {
+                const qsCreate = buildEntitySetCreationParams(initialOptions);
+                const createPath = `${ctx.path}${qsCreate}`;
+                const resCreate = await ctx.http.rawRequest(createPath, {
+                    signal: initialOptions.signal,
+                });
+                const textCreate = await resCreate.text();
+                if (!resCreate.ok) {
+                    throw new QuadroHttpError(resCreate.status, textCreate);
+                }
+                const jsonCreate = textCreate ? JSON.parse(textCreate) : [];
+                await parseEntitySetFromResponse(jsonCreate, resCreate);
+                if (!entitySetUrl) {
+                    return unwrapEntityList(ctx.className, jsonCreate);
+                }
+                const qsPage = buildEntitySetPageParams(skip, pageSize, initialOptions.select);
+                const base = entitySetUrl;
+                const pagePath = qsPage
+                    ? base.includes('?')
+                        ? `${base}&${qsPage.slice(1)}`
+                        : `${base}${qsPage}`
+                    : base;
+                const res = await ctx.http.rawRequest(pagePath, {
+                    signal: initialOptions.signal,
+                });
+                const text = await res.text();
+                if (!res.ok) {
+                    throw new QuadroHttpError(res.status, text);
+                }
+                const json = text ? JSON.parse(text) : [];
+                return unwrapEntityList(ctx.className, json);
             }
-            const jsonCreate = textCreate ? JSON.parse(textCreate) : [];
-            await parseEntitySetFromResponse(jsonCreate, resCreate);
-            if (!entitySetUrl) {
-                return unwrapEntityList(ctx.className, jsonCreate);
+            let requestPath;
+            if (entitySetUrl && useEntitySet) {
+                const qs = buildEntitySetPageParams(skip, pageSize, initialOptions.select);
+                const base = entitySetUrl;
+                requestPath = qs ? (base.includes('?') ? `${base}&${qs.slice(1)}` : `${base}${qs}`) : base;
             }
-            const qsPage = buildEntitySetPageParams(skip, pageSize, initialOptions.select);
-            const base = entitySetUrl;
-            const pagePath = qsPage
-                ? base.includes('?')
-                    ? `${base}&${qsPage.slice(1)}`
-                    : `${base}${qsPage}`
-                : base;
-            const res = await ctx.http.request(pagePath, {
+            else {
+                const qs = buildListSearchParams(ctx.className, { ...initialOptions, page }, ctx.relationMap);
+                requestPath = `${ctx.path}${qs}`;
+            }
+            const res = await ctx.http.rawRequest(requestPath, {
                 signal: initialOptions.signal,
             });
             const text = await res.text();
             if (!res.ok) {
-                throw new Error(`List failed ${res.status}: ${text.slice(0, 200)}`);
+                throw new QuadroHttpError(res.status, text);
             }
             const json = text ? JSON.parse(text) : [];
             return unwrapEntityList(ctx.className, json);
-        }
-        let requestPath;
-        if (entitySetUrl && useEntitySet) {
-            const qs = buildEntitySetPageParams(skip, pageSize, initialOptions.select);
-            const base = entitySetUrl;
-            requestPath = qs ? (base.includes('?') ? `${base}&${qs.slice(1)}` : `${base}${qs}`) : base;
-        }
-        else {
-            const qs = buildListSearchParams(ctx.className, { ...initialOptions, page }, ctx.relationMap);
-            requestPath = `${ctx.path}${qs}`;
-        }
-        const res = await ctx.http.request(requestPath, {
-            signal: initialOptions.signal,
         });
-        const text = await res.text();
-        if (!res.ok) {
-            throw new Error(`List failed ${res.status}: ${text.slice(0, 200)}`);
-        }
-        const json = text ? JSON.parse(text) : [];
-        return unwrapEntityList(ctx.className, json);
     }
     async function* iteratePages() {
         let page = initialOptions.page ?? 1;
@@ -190,6 +202,10 @@ export function createCollection(ctx, initialOptions, mapRow) {
             }
             await Promise.all(ids.map((id) => ctx.http.void(`${ctx.className}(${encodeURIComponent(String(id))})`, {
                 method: 'DELETE',
+            }, {
+                operation: 'dataclass.delete',
+                className: ctx.className,
+                entityKey: id,
             })));
             seenIds.clear();
         },
@@ -201,7 +217,7 @@ export function createCollection(ctx, initialOptions, mapRow) {
             entitySetUrl = undefined;
             try {
                 const path = appendReleaseQuery(toRelease);
-                const res = await ctx.http.request(path, { method: 'GET' });
+                const res = await ctx.http.request(path, { method: 'GET' }, { operation: 'collection.release', className: ctx.className });
                 await res.text();
             }
             catch {

package/dist/runtime/data-class.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-class.d.ts","sourceRoot":"","sources":["../../src/runtime/data-class.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAoB,MAAM,iBAAiB,CAAA;AACjG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C,OAAO,EAAgB,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE5D,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,UAAU,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,wGAAwG;IACxG,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAC5B;AAED,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,sBAAsB;QAIjE,CAAC,SAAS,SAAS,MAAM,EAAE,0BACnB,iBAAiB,GAAG;QAAE,MAAM,CAAC,EAAE,CAAC,CAAA;KAAE,GAC3C,gBAAgB,CAAC,CAAC,SAAS,SAAS,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QAc7C,CAAC,SAAS,SAAS,MAAM,EAAE,oBAC/B,MAAM,GAAG,MAAM,YACT;QAAE,MAAM,CAAC,EAAE,CAAC,CAAA;KAAE,GACvB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;eASH,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;UAU7C,CAAC,SAAS,SAAS,MAAM,EAAE,wBACvB,MAAM,YACJ,iBAAiB,GAAG;QAAE,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,CAAC,CAAA;KAAE,GAC/D,gBAAgB,CAAC,CAAC,SAAS,SAAS,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;EAe1D;AA6BD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,UAAU,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;IACzB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAA;CAC5C;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,gFAAgF;IAChF,2BAA2B,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAChD;AAED,6FAA6F;AAC7F,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,MAAM,EAC1D,MAAM,EAAE,CAAC,EACT,GAAG,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,WAAW,GAAG,aAAa,CAAC,EACvE,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,CAAC,CAiBH;AAgBD,iEAAiE;AACjE,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,WAAW,GAAG,aAAa,GAAG,UAAU,CAAC,EACpF,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,IAAI,CAmBN;AAED,yEAAyE;AACzE,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,sBAAsB,EAC3B,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,MAAM,EACvB,2BAA2B,CAAC,EAAE,SAAS,MAAM,EAAE;SAKxC,CAAC,SAAS,SAAS,MAAM,EAAE,0BACpB,iBAAiB,GAAG;QAAE,MAAM,CAAC,EAAE,CAAC,CAAA;KAAE,GAC3C,gBAAgB,CAAC,OAAO,CAAC;EAmB/B;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,sBAAsB,EAC3B,SAAS,EAAE,SAAS,qBAAqB,EAAE,GAC1C,IAAI,CAYN;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAA"}
+{"version":3,"file":"data-class.d.ts","sourceRoot":"","sources":["../../src/runtime/data-class.ts"],"names":[],"mappings":"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"}

package/dist/runtime/data-class.mjs

@@ -19,13 +19,21 @@ export function makeDataClassApi(cfg) {
                 ? buildEntityParams(cfg.className, options.select, cfg.relationMap)
                 : '';
             const key = encodeURIComponent(String(id));
-            const body = await cfg.http.json(`${cfg.className}(${key})${qs}`);
+            const body = await cfg.http.json(`${cfg.className}(${key})${qs}`, {}, {
+                operation: 'dataclass.get',
+                className: cfg.className,
+                entityKey: id,
+            });
             return unwrapEntity(cfg.className, body);
         },
         async delete(id) {
             const key = encodeURIComponent(String(id));
             try {
-                await cfg.http.void(`${cfg.className}(${key})`, { method: 'DELETE' });
+                await cfg.http.void(`${cfg.className}(${key})`, { method: 'DELETE' }, {
+                    operation: 'dataclass.delete',
+                    className: cfg.className,
+                    entityKey: id,
+                });
                 return true;
             }
             catch {

package/dist/runtime/datastore.d.ts

@@ -1,8 +1,9 @@
+import type { QuadroRequestContext } from './events.js';
 import type { QuadroHttp } from './http.js';
 /** Call nested datastore paths like `authentify/login` (POST by default). */
 export declare function callDatastorePath(http: QuadroHttp, segments: readonly string[], init?: {
     method?: 'GET' | 'POST';
     body?: unknown;
-}): Promise<unknown>;
+}, context?: QuadroRequestContext): Promise<unknown>;
 export declare function createDatastoreNamespace(_http: QuadroHttp, tree: Record<string, unknown>): Record<string, unknown>;
 //# sourceMappingURL=datastore.d.ts.map

package/dist/runtime/datastore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"datastore.d.ts","sourceRoot":"","sources":["../../src/runtime/datastore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C,6EAA6E;AAC7E,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GACjD,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB"}
+{"version":3,"file":"datastore.d.ts","sourceRoot":"","sources":["../../src/runtime/datastore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C,6EAA6E;AAC7E,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,EAClD,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,OAAO,CAAC,CAoBlB;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB"}

package/dist/runtime/datastore.mjs

@@ -1,14 +1,19 @@
 /** Call nested datastore paths like `authentify/login` (POST by default). */
-export async function callDatastorePath(http, segments, init) {
+export async function callDatastorePath(http, segments, init, context) {
     const path = `/${segments.join('/')}`;
     const method = init?.method ?? 'POST';
+    const ctx = context ??
+        {
+            operation: 'datastore',
+            methodName: segments.join('/'),
+        };
     if (method === 'GET') {
-        return http.json(path, { method: 'GET' });
+        return http.json(path, { method: 'GET' }, ctx);
     }
     return http.json(path, {
         method: 'POST',
         body: init?.body !== undefined ? JSON.stringify(init.body) : undefined,
-    });
+    }, ctx);
 }
 export function createDatastoreNamespace(_http, tree) {
     return tree;

package/dist/runtime/events.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Structured lifecycle events for all Quadro HTTP-backed operations.
+ * Use {@link QuadroEventBus} with {@link QuadroHttp} options, or bridge to RxJS via `@quadrokit/client/rx`.
+ */
+/** What the client is doing (for filtering and UI). */
+export type QuadroOperation = 'http.json' | 'http.void' | 'http.request' | 'collection.list' | 'collection.release' | 'dataclass.get' | 'dataclass.delete' | 'function.dataclass' | 'function.entity' | 'function.entityCollection' | 'datastore' | 'auth.login';
+/** Optional metadata for an operation (class, method, entity key, arbitrary tags). */
+export type QuadroRequestContext = {
+    operation: QuadroOperation;
+    /** Dataclass name when applicable. */
+    className?: string;
+    /** 4D method / function name for `function.*` operations. */
+    methodName?: string;
+    /** Primary key for entity-scoped calls. */
+    entityKey?: string | number;
+    /** Extra structured data (page, filter summary, datastore path, …). */
+    attributes?: Record<string, unknown>;
+};
+export type QuadroLoadingEvent = {
+    type: 'loading';
+    operationId: string;
+    context: QuadroRequestContext;
+    path: string;
+    method: string;
+    startedAt: number;
+};
+export type QuadroSuccessEvent = {
+    type: 'success';
+    operationId: string;
+    context: QuadroRequestContext;
+    path: string;
+    durationMs: number;
+    /** HTTP status when applicable. */
+    status?: number;
+    /** Result payload: parsed JSON, rows, void, or a summary for raw `Response`. */
+    body?: unknown;
+};
+export type QuadroErrorEvent = {
+    type: 'error';
+    operationId: string;
+    context: QuadroRequestContext;
+    path: string;
+    durationMs: number;
+    message: string;
+    error: unknown;
+    /** HTTP status when the failure came from the transport. */
+    status?: number;
+};
+export type QuadroClientEvent = QuadroLoadingEvent | QuadroSuccessEvent | QuadroErrorEvent;
+/**
+ * Subscribe to {@link QuadroClientEvent} from a {@link QuadroHttp} client.
+ * Pass `new QuadroEventBus()` as `events` in {@link QuadroFetchOptions}.
+ */
+export declare class QuadroEventBus {
+    private readonly listeners;
+    subscribe(listener: (e: QuadroClientEvent) => void): () => void;
+    /** @internal */
+    emit(event: QuadroClientEvent): void;
+    /**
+     * Run an async operation with loading → success | error events.
+     * @internal
+     */
+    runWithEvents<T>(context: QuadroRequestContext, path: string, method: string, fn: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/runtime/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/runtime/events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,uDAAuD;AACvD,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,WAAW,GACX,cAAc,GACd,iBAAiB,GACjB,oBAAoB,GACpB,eAAe,GACf,kBAAkB,GAClB,oBAAoB,GACpB,iBAAiB,GACjB,2BAA2B,GAC3B,WAAW,GACX,YAAY,CAAA;AAEhB,sFAAsF;AACtF,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,eAAe,CAAA;IAC1B,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC3B,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,SAAS,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,oBAAoB,CAAA;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,SAAS,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,oBAAoB,CAAA;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gFAAgF;IAChF,IAAI,CAAC,EAAE,OAAO,CAAA;CACf,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,OAAO,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,oBAAoB,CAAA;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,OAAO,CAAA;IACd,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,gBAAgB,CAAA;AAM1F;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4C;IAEtE,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI;IAO/D,gBAAgB;IAChB,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAUpC;;;OAGG;IACH,aAAa,CAAC,CAAC,EACb,OAAO,EAAE,oBAAoB,EAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC;CAmDd"}

package/dist/runtime/events.mjs

@@ -0,0 +1,86 @@
+/**
+ * Structured lifecycle events for all Quadro HTTP-backed operations.
+ * Use {@link QuadroEventBus} with {@link QuadroHttp} options, or bridge to RxJS via `@quadrokit/client/rx`.
+ */
+function newOperationId() {
+    return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 11)}`;
+}
+/**
+ * Subscribe to {@link QuadroClientEvent} from a {@link QuadroHttp} client.
+ * Pass `new QuadroEventBus()` as `events` in {@link QuadroFetchOptions}.
+ */
+export class QuadroEventBus {
+    listeners = new Set();
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    /** @internal */
+    emit(event) {
+        for (const fn of this.listeners) {
+            try {
+                fn(event);
+            }
+            catch {
+                /* listener errors must not break the client */
+            }
+        }
+    }
+    /**
+     * Run an async operation with loading → success | error events.
+     * @internal
+     */
+    runWithEvents(context, path, method, fn) {
+        const operationId = newOperationId();
+        const startedAt = Date.now();
+        this.emit({ type: 'loading', operationId, context, path, method, startedAt });
+        return (async () => {
+            try {
+                const result = await fn();
+                const durationMs = Date.now() - startedAt;
+                let body = result;
+                if (result instanceof Response) {
+                    body = {
+                        kind: 'response',
+                        status: result.status,
+                        ok: result.ok,
+                        url: result.url,
+                    };
+                }
+                this.emit({
+                    type: 'success',
+                    operationId,
+                    context,
+                    path,
+                    durationMs,
+                    status: result instanceof Response ? result.status : undefined,
+                    body,
+                });
+                return result;
+            }
+            catch (error) {
+                const durationMs = Date.now() - startedAt;
+                const message = error instanceof Error ? error.message : String(error);
+                const status = error &&
+                    typeof error === 'object' &&
+                    'status' in error &&
+                    typeof error.status === 'number'
+                    ? error.status
+                    : undefined;
+                this.emit({
+                    type: 'error',
+                    operationId,
+                    context,
+                    path,
+                    durationMs,
+                    message,
+                    error,
+                    status,
+                });
+                throw error;
+            }
+        })();
+    }
+}

package/dist/runtime/http.d.ts

@@ -1,8 +1,14 @@
+import type { QuadroClientEvent, QuadroEventBus, QuadroRequestContext } from './events.js';
 export interface QuadroFetchOptions {
     baseURL: string;
     fetchImpl?: typeof fetch;
     /** Extra headers on every request (e.g. Authorization for generate). */
     defaultHeaders?: Record<string, string>;
+    /**
+     * Optional bus for {@link QuadroClientEvent}: loading, success, error per logical operation.
+     * Create with `new QuadroEventBus()` and pass here; subscribe before calling the client.
+     */
+    events?: QuadroEventBus;
 }
 export declare function normalizeBaseURL(baseURL: string): string;
 /**
@@ -14,8 +20,23 @@ export declare class QuadroHttp {
     private readonly opts;
     constructor(opts: QuadroFetchOptions);
     get baseURL(): string;
-    request(path: string, init?: RequestInit): Promise<Response>;
-    json<T>(path: string, init?: RequestInit): Promise<T>;
-    void(path: string, init?: RequestInit): Promise<void>;
+    /** Optional event bus from constructor options. */
+    get events(): QuadroEventBus | undefined;
+    /**
+     * Run a logical operation with loading / success / error events (when `events` is set).
+     * Use from collection code and other multi-step flows that do not use {@link json}.
+     */
+    runWithEvents<T>(context: QuadroRequestContext, path: string, method: string, fn: () => Promise<T>): Promise<T>;
+    /** Subscribe without reaching into options: `quadro._http.subscribe(cb)`. */
+    subscribe(listener: (e: QuadroClientEvent) => void): () => void;
+    /** @internal Raw fetch without events (used inside {@link runWithEvents}). */
+    rawRequest(path: string, init?: RequestInit): Promise<Response>;
+    /**
+     * Low-level request. When `events` is configured, emits loading/success/error unless
+     * you pass `context: undefined` and use {@link rawRequest} for manual control.
+     */
+    request(path: string, init?: RequestInit, context?: QuadroRequestContext): Promise<Response>;
+    json<T>(path: string, init?: RequestInit, context?: QuadroRequestContext): Promise<T>;
+    void(path: string, init?: RequestInit, context?: QuadroRequestContext): Promise<void>;
 }
 //# sourceMappingURL=http.d.ts.map

package/dist/runtime/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/runtime/http.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACxB,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACxC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAa5D;AAED,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,kBAAkB;IAErD,IAAI,OAAO,IAAI,MAAM,CAEpB;IAEK,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAwBhE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,CAAC;IAYzD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAOhE"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/runtime/http.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAE1F,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACxB,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC;;;OAGG;IACH,MAAM,CAAC,EAAE,cAAc,CAAA;CACxB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAa5D;AAED,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,kBAAkB;IAErD,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,mDAAmD;IACnD,IAAI,MAAM,IAAI,cAAc,GAAG,SAAS,CAEvC;IAED;;;OAGG;IACH,aAAa,CAAC,CAAC,EACb,OAAO,EAAE,oBAAoB,EAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC;IAQb,6EAA6E;IAC7E,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI;IAI/D,8EAA8E;IACxE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAwBzE;;;OAGG;IACG,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,WAAgB,EACtB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,QAAQ,CAAC;IAUd,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,CAAC,CAAC;IAqBzF,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBhG"}

package/dist/runtime/http.mjs

@@ -29,7 +29,27 @@ export class QuadroHttp {
     get baseURL() {
         return normalizeBaseURL(this.opts.baseURL);
     }
-    async request(path, init = {}) {
+    /** Optional event bus from constructor options. */
+    get events() {
+        return this.opts.events;
+    }
+    /**
+     * Run a logical operation with loading / success / error events (when `events` is set).
+     * Use from collection code and other multi-step flows that do not use {@link json}.
+     */
+    runWithEvents(context, path, method, fn) {
+        const bus = this.opts.events;
+        if (!bus) {
+            return fn();
+        }
+        return bus.runWithEvents(context, path, method, fn);
+    }
+    /** Subscribe without reaching into options: `quadro._http.subscribe(cb)`. */
+    subscribe(listener) {
+        return this.opts.events?.subscribe(listener) ?? (() => { });
+    }
+    /** @internal Raw fetch without events (used inside {@link runWithEvents}). */
+    async rawRequest(path, init = {}) {
         const url = path.startsWith('http')
             ? path
             : `${this.baseURL}${path.startsWith('/') ? '' : '/'}${path}`;
@@ -52,22 +72,53 @@ export class QuadroHttp {
             headers,
         });
     }
-    async json(path, init = {}) {
-        const res = await this.request(path, init);
-        const text = await res.text();
-        if (!res.ok) {
-            throw new QuadroHttpError(res.status, text);
-        }
-        if (!text) {
-            return undefined;
+    /**
+     * Low-level request. When `events` is configured, emits loading/success/error unless
+     * you pass `context: undefined` and use {@link rawRequest} for manual control.
+     */
+    async request(path, init = {}, context) {
+        const ctx = context ?? { operation: 'http.request' };
+        const method = (init.method ?? 'GET').toUpperCase();
+        const bus = this.opts.events;
+        if (!bus) {
+            return this.rawRequest(path, init);
         }
-        return JSON.parse(text);
+        return bus.runWithEvents(ctx, path, method, () => this.rawRequest(path, init));
     }
-    async void(path, init = {}) {
-        const res = await this.request(path, init);
-        if (!res.ok) {
+    async json(path, init = {}, context) {
+        const ctx = context ?? { operation: 'http.json' };
+        const method = (init.method ?? 'GET').toUpperCase();
+        const bus = this.opts.events;
+        const exec = async () => {
+            const res = await this.rawRequest(path, init);
             const text = await res.text();
-            throw new QuadroHttpError(res.status, text);
+            if (!res.ok) {
+                throw new QuadroHttpError(res.status, text);
+            }
+            if (!text) {
+                return undefined;
+            }
+            return JSON.parse(text);
+        };
+        if (!bus) {
+            return exec();
+        }
+        return bus.runWithEvents(ctx, path, method, exec);
+    }
+    async void(path, init = {}, context) {
+        const ctx = context ?? { operation: 'http.void' };
+        const method = (init.method ?? 'GET').toUpperCase();
+        const bus = this.opts.events;
+        const exec = async () => {
+            const res = await this.rawRequest(path, init);
+            if (!res.ok) {
+                const text = await res.text();
+                throw new QuadroHttpError(res.status, text);
+            }
+        };
+        if (!bus) {
+            return exec();
         }
+        return bus.runWithEvents(ctx, path, method, exec);
     }
 }

package/dist/runtime/index.d.ts

@@ -5,6 +5,7 @@ export { type CollectionContext, type CollectionHandle, type CollectionOptions,
 export { attachEntityClassMethods, attachRelatedApis, bindEntityCollectionMethods, type DataClassRuntimeConfig, type EntityNavigationConfig, makeDataClassApi, makeRelatedCollectionApi, type RelatedNavigationSpec, } from './data-class.js';
 export { callDatastorePath, createDatastoreNamespace } from './datastore.js';
 export { QuadroHttpError } from './errors.js';
+export { type QuadroClientEvent, type QuadroErrorEvent, QuadroEventBus, type QuadroLoadingEvent, type QuadroOperation, type QuadroRequestContext, type QuadroSuccessEvent, } from './events.js';
 export { mountPathFromBaseURL, normalizeBaseURL, type QuadroFetchOptions, QuadroHttp, } from './http.js';
 export type { Paths1, QuadroAttributePaths, SelectedEntity } from './paths.js';
 export { buildEntitySetCreationParams, buildEntitySetPageParams, buildListSearchParams, buildMethodSelectionQuery, type ListQueryParams, type MethodSelectionQuery, } from './query.js';

package/dist/runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,GACxB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,KAAK,wBAAwB,EAC7B,qBAAqB,EACrB,4BAA4B,EAC5B,kBAAkB,EAClB,KAAK,6BAA6B,EAClC,yBAAyB,GAC1B,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,gBAAgB,GACjB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,2BAA2B,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,gBAAgB,EAChB,wBAAwB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,UAAU,GACX,MAAM,WAAW,CAAA;AAClB,YAAY,EAAE,MAAM,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC9E,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,GACxB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,KAAK,wBAAwB,EAC7B,qBAAqB,EACrB,4BAA4B,EAC5B,kBAAkB,EAClB,KAAK,6BAA6B,EAClC,yBAAyB,GAC1B,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,gBAAgB,GACjB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,2BAA2B,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,gBAAgB,EAChB,wBAAwB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,UAAU,GACX,MAAM,WAAW,CAAA;AAClB,YAAY,EAAE,MAAM,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC9E,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA"}

package/dist/runtime/index.mjs

@@ -4,6 +4,7 @@ export { createCollection, } from './collection.mjs';
 export { attachEntityClassMethods, attachRelatedApis, bindEntityCollectionMethods, makeDataClassApi, makeRelatedCollectionApi, } from './data-class.mjs';
 export { callDatastorePath, createDatastoreNamespace } from './datastore.mjs';
 export { QuadroHttpError } from './errors.mjs';
+export { QuadroEventBus, } from './events.mjs';
 export { mountPathFromBaseURL, normalizeBaseURL, QuadroHttp, } from './http.mjs';
 export { buildEntitySetCreationParams, buildEntitySetPageParams, buildListSearchParams, buildMethodSelectionQuery, } from './query.mjs';
 export { unwrapEntity, unwrapEntityList } from './unwrap.mjs';

package/dist/runtime/rxjs.d.ts

@@ -0,0 +1,20 @@
+/**
+ * RxJS bridge for {@link QuadroEventBus}. Install `rxjs` as a dependency in your app.
+ *
+ * @example
+ * ```ts
+ * import { QuadroEventBus } from '@quadrokit/client/runtime'
+ * import { quadroEventsObservable } from '@quadrokit/client/rx'
+ * import { filter } from 'rxjs/operators'
+ *
+ * const bus = new QuadroEventBus()
+ * const quadro = createClient({ baseURL: '/rest', events: bus })
+ * quadroEventsObservable(bus)
+ *   .pipe(filter((e) => e.type === 'error'))
+ *   .subscribe(console.warn)
+ * ```
+ */
+import { Observable } from 'rxjs';
+import type { QuadroClientEvent, QuadroEventBus } from './events.js';
+export declare function quadroEventsObservable(bus: QuadroEventBus): Observable<QuadroClientEvent>;
+//# sourceMappingURL=rxjs.d.ts.map

package/dist/runtime/rxjs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rxjs.d.ts","sourceRoot":"","sources":["../../src/runtime/rxjs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AACjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEpE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,cAAc,GAAG,UAAU,CAAC,iBAAiB,CAAC,CASzF"}

package/dist/runtime/rxjs.mjs

@@ -0,0 +1,27 @@
+/**
+ * RxJS bridge for {@link QuadroEventBus}. Install `rxjs` as a dependency in your app.
+ *
+ * @example
+ * ```ts
+ * import { QuadroEventBus } from '@quadrokit/client/runtime'
+ * import { quadroEventsObservable } from '@quadrokit/client/rx'
+ * import { filter } from 'rxjs/operators'
+ *
+ * const bus = new QuadroEventBus()
+ * const quadro = createClient({ baseURL: '/rest', events: bus })
+ * quadroEventsObservable(bus)
+ *   .pipe(filter((e) => e.type === 'error'))
+ *   .subscribe(console.warn)
+ * ```
+ */
+import { Observable } from 'rxjs';
+export function quadroEventsObservable(bus) {
+    return new Observable((subscriber) => {
+        const unsub = bus.subscribe((e) => {
+            subscriber.next(e);
+        });
+        return () => {
+            unsub();
+        };
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quadrokit/client",
-  "version": "0.3.12",
+  "version": "0.3.14",
   "description": "Typed 4D REST client and catalog code generator for QuadroKit",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -17,6 +17,10 @@
     "./runtime": {
       "types": "./dist/runtime/index.d.ts",
       "import": "./dist/runtime/index.mjs"
+    },
+    "./rx": {
+      "types": "./dist/runtime/rxjs.d.ts",
+      "import": "./dist/runtime/rxjs.mjs"
     }
   },
   "files": [
@@ -29,15 +33,22 @@
     "generate:fixture": "bun run src/cli.ts generate --url file://../../assets/catalog.json --out ../../.quadrokit/generated-demo"
   },
   "dependencies": {
-    "@quadrokit/shared": "^0.3.12",
+    "@quadrokit/shared": "^0.3.14",
     "undici": "^6.21.0"
   },
   "peerDependencies": {
+    "rxjs": ">=7.8.0",
     "typescript": ">=5.4"
   },
+  "peerDependenciesMeta": {
+    "rxjs": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/bun": "^1.3.11",
     "@types/node": "^25.5.0",
+    "rxjs": "^7.8.2",
     "typescript": "^5.9.3"
   }
 }