@quadrokit/client 0.3.11 → 0.3.13

package/dist/runtime/collection.mjs

@@ -93,29 +93,59 @@ 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 Error(`Entity set creation failed ${resCreate.status}: ${textCreate.slice(0, 200)}`);
+                }
+                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 Error(`List failed ${res.status}: ${text.slice(0, 200)}`);
+                }
+                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();
@@ -124,26 +154,7 @@ export function createCollection(ctx, initialOptions, mapRow) {
             }
             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 +201,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 +216,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":"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"}
+{"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

@@ -1,10 +1,13 @@
+export { buildQuadroClientFromCatalogSpec, type CatalogClassRuntimeSpec, type CatalogRuntimeSpec, } from './catalog-builder.js';
 export { type ClassFunctionHttpOptions, callDataClassFunction, callEntityCollectionFunction, callEntityFunction, type EntityCollectionMethodOptions, unwrapClassFunctionResult, } from './class-function.js';
+export type { BaseDataClassApi } from './client-types.js';
 export { type CollectionContext, type CollectionHandle, type CollectionOptions, createCollection, } from './collection.js';
 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, SelectedEntity } from './paths.js';
+export type { Paths1, QuadroAttributePaths, SelectedEntity } from './paths.js';
 export { buildEntitySetCreationParams, buildEntitySetPageParams, buildListSearchParams, buildMethodSelectionQuery, type ListQueryParams, type MethodSelectionQuery, } from './query.js';
 export { unwrapEntity, unwrapEntityList } from './unwrap.js';
 //# sourceMappingURL=index.d.ts.map

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,KAAK,wBAAwB,EAC7B,qBAAqB,EACrB,4BAA4B,EAC5B,kBAAkB,EAClB,KAAK,6BAA6B,EAClC,yBAAyB,GAC1B,MAAM,qBAAqB,CAAA;AAC5B,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,cAAc,EAAE,MAAM,YAAY,CAAA;AACxD,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

@@ -1,8 +1,10 @@
+export { buildQuadroClientFromCatalogSpec, } from './catalog-builder.mjs';
 export { callDataClassFunction, callEntityCollectionFunction, callEntityFunction, unwrapClassFunctionResult, } from './class-function.mjs';
 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/paths.d.ts

@@ -1,4 +1,17 @@
 /** Type-level helpers for `$attributes` dot paths (compile-time only). */
+/** Decrements depth for {@link QuadroAttributePaths} (index = current max depth). */
+type QuadroPathDepthPrev = [never, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18];
+type QuadroPathNextDepth<D extends number> = D extends keyof QuadroPathDepthPrev ? QuadroPathDepthPrev[D] : 0;
+/**
+ * Valid `$attributes` dot paths for entity `T` (e.g. `ceo.manager.manager.employer.name`),
+ * including arbitrary nesting along related-entity fields. Bounded by `MaxDepth` so circular
+ * graphs (e.g. `Employee.manager: Employee`) stay instantiable in TypeScript.
+ *
+ * Index-signature objects (`Record<string, unknown>`) are treated as leaves (single segment only).
+ */
+export type QuadroAttributePaths<T, MaxDepth extends number = 8> = [MaxDepth] extends [0] ? never : T extends object ? T extends readonly unknown[] ? never : {
+    [K in keyof T & string]: NonNullable<T[K]> extends infer U ? U extends string | number | boolean | bigint | symbol ? K : U extends (...args: never) => unknown ? K : U extends readonly unknown[] ? K : [U] extends [never] ? K : U extends Date ? K : U extends object ? string extends keyof U ? K : K | `${K}.${QuadroAttributePaths<U, QuadroPathNextDepth<MaxDepth>>}` : K : K;
+}[keyof T & string] : never;
 type UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
 type PickOne<T, H extends string> = H extends keyof T & string ? Pick<T, H> : H extends `${infer K}.${infer R}` ? K extends keyof T & string ? NonNullable<T[K]> extends infer U ? U extends object ? {
     [P in K]: PickOne<U, R>;
@@ -8,7 +21,10 @@ declare const selectBrand: unique symbol;
 export type SelectedEntity<T, S extends readonly string[]> = UnionToIntersection<S[number] extends infer H ? (H extends string ? PickOne<T, H> : never) : never> extends infer O ? O extends object ? O & {
     readonly [selectBrand]: S;
 } : never : never;
-/** Flat union of first-level and nested dot paths (codegen emits concrete unions). */
+/**
+ * Recursive dot paths (can hit "excessively deep" on circular entity types).
+ * Prefer {@link QuadroAttributePaths} for catalog-generated entities.
+ */
 export type Paths1<T> = T extends object ? {
     [K in keyof T & string]: NonNullable<T[K]> extends infer U ? U extends object ? K | `${K}.${Paths1<U>}` : K : K;
 }[keyof T & string] : never;

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

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/runtime/paths.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,KAAK,mBAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,KAAK,CAAC,SAAS,CACjF,CAAC,EAAE,MAAM,CAAC,KACP,IAAI,GACL,CAAC,GACD,KAAK,CAAA;AAET,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,GAC1D,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GACV,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,MAAM,CAAC,EAAE,GAC/B,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,GACxB,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,GAC/B,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;CAAE,GAC3B,KAAK,GACP,KAAK,GACP,KAAK,GACP,KAAK,CAAA;AAEX,OAAO,CAAC,MAAM,WAAW,EAAE,OAAO,MAAM,CAAA;AAExC,2EAA2E;AAC3E,MAAM,MAAM,cAAc,CAAC,CAAC,EAAE,CAAC,SAAS,SAAS,MAAM,EAAE,IACvD,mBAAmB,CACjB,CAAC,CAAC,MAAM,CAAC,SAAS,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAC/E,SAAS,MAAM,CAAC,GACb,CAAC,SAAS,MAAM,GACd,CAAC,GAAG;IAAE,QAAQ,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;CAAE,GACjC,KAAK,GACP,KAAK,CAAA;AAEX,sFAAsF;AACtF,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GACpC;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,GACtD,CAAC,SAAS,MAAM,GACd,CAAC,GAAG,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,GACvB,CAAC,GACH,CAAC;CACN,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GACnB,KAAK,CAAA"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/runtime/paths.ts"],"names":[],"mappings":"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"}

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"}