@manonero/chat-client-sdk 0.0.1-beta.1

package/dist/http/HttpClient.js

@@ -0,0 +1,244 @@
+// HttpClient.ts — Base HTTP client (fetch wrapper)
+import { ChatApiError } from '../errors/ChatApiError.js';
+/** Default per-request timeout (ms) when none is supplied. */
+export const DEFAULT_REQUEST_TIMEOUT_MS = 30000;
+/**
+ * Base HTTP client wrapping the Fetch API.
+ *
+ * Features:
+ * - Automatic Authorization: Bearer token injection via tokenProvider
+ * - JSON request/response serialization
+ * - Throws ChatApiError on non-OK responses
+ * - Handles empty responses (204 No Content, 200 with no body) — the SDK
+ *   convention is to type T as `null` or `void` for empty-body endpoints
+ * - Multipart file upload with optional XHR-based upload progress
+ * - Per-request timeout via AbortController (configurable, default 30s)
+ */
+export class HttpClient {
+    constructor(options) {
+        // Strip trailing slash for consistent URL joining
+        this.baseUrl = options.baseUrl.replace(/\/$/, '');
+        this.tokenProvider = options.tokenProvider ?? (() => null);
+        this.requestTimeoutMs =
+            options.requestTimeoutMs === undefined ? DEFAULT_REQUEST_TIMEOUT_MS : options.requestTimeoutMs;
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    buildUrl(path) {
+        // If path already looks absolute, use it directly
+        if (path.startsWith('http://') || path.startsWith('https://')) {
+            return path;
+        }
+        // Ensure exactly one slash between base and path
+        const separator = path.startsWith('/') ? '' : '/';
+        return `${this.baseUrl}${separator}${path}`;
+    }
+    buildHeaders(extra) {
+        const headers = {
+            'Content-Type': 'application/json',
+            ...extra,
+        };
+        const token = this.tokenProvider();
+        if (token) {
+            headers['Authorization'] = `Bearer ${token}`;
+        }
+        return headers;
+    }
+    buildAuthHeader() {
+        const token = this.tokenProvider();
+        if (token) {
+            return { Authorization: `Bearer ${token}` };
+        }
+        return {};
+    }
+    /**
+     * Parse response body safely.
+     * Returns null for 204 No Content or empty bodies.
+     * Wraps JSON parse failures in ChatApiError for consistency with the XHR path.
+     */
+    async parseBody(response) {
+        if (response.status === 204)
+            return null;
+        const text = await response.text();
+        if (!text || text.trim() === '')
+            return null;
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            throw new ChatApiError(response.status, 'Parse Error', 'Failed to parse response JSON');
+        }
+    }
+    async handleResponse(response) {
+        if (!response.ok) {
+            throw await ChatApiError.fromResponse(response);
+        }
+        // Empty bodies (204 / empty 200) resolve as `null` cast to T. Public methods
+        // keep the `Promise<T>` signature; callers expecting an empty body should
+        // type T as `null` or `void` (see HttpClient.test.ts for the convention).
+        const result = await this.parseBody(response);
+        return result;
+    }
+    /**
+     * Run a fetch with an AbortController-based timeout.
+     * Throws ChatApiError(0, 'Timeout', ...) when the timeout fires before the
+     * response arrives. If `requestTimeoutMs` is null, fetch is used directly.
+     */
+    async fetchWithTimeout(input, init) {
+        const timeoutMs = this.requestTimeoutMs;
+        if (timeoutMs === null) {
+            return fetch(input, init);
+        }
+        const controller = new AbortController();
+        // Use an explicit flag instead of `controller.signal.aborted` so a network
+        // error that races with the timer firing is not misclassified as a timeout.
+        let timedOut = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            controller.abort();
+        }, timeoutMs);
+        try {
+            return await fetch(input, { ...init, signal: controller.signal });
+        }
+        catch (err) {
+            if (timedOut) {
+                throw new ChatApiError(0, 'Timeout', `Request timed out after ${timeoutMs}ms`);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Public methods
+    // ---------------------------------------------------------------------------
+    async get(path, headers) {
+        const response = await this.fetchWithTimeout(this.buildUrl(path), {
+            method: 'GET',
+            headers: { ...this.buildAuthHeader(), ...headers },
+        });
+        return this.handleResponse(response);
+    }
+    /**
+     * GET a plain-text response (e.g. /health/live which returns "Healthy").
+     * Unlike get<T>(), this does not attempt JSON parsing.
+     */
+    async getText(path) {
+        const response = await this.fetchWithTimeout(this.buildUrl(path), {
+            method: 'GET',
+            headers: { ...this.buildAuthHeader() },
+        });
+        if (!response.ok) {
+            throw await ChatApiError.fromResponse(response);
+        }
+        return response.text();
+    }
+    async post(path, body, headers) {
+        const response = await this.fetchWithTimeout(this.buildUrl(path), {
+            method: 'POST',
+            headers: { ...this.buildHeaders(headers) },
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        return this.handleResponse(response);
+    }
+    async patch(path, body, headers) {
+        const response = await this.fetchWithTimeout(this.buildUrl(path), {
+            method: 'PATCH',
+            headers: { ...this.buildHeaders(headers) },
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        return this.handleResponse(response);
+    }
+    async put(path, body, headers) {
+        const response = await this.fetchWithTimeout(this.buildUrl(path), {
+            method: 'PUT',
+            headers: { ...this.buildHeaders(headers) },
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        return this.handleResponse(response);
+    }
+    async delete(path, body, headers) {
+        const response = await this.fetchWithTimeout(this.buildUrl(path), {
+            method: 'DELETE',
+            headers: body !== undefined
+                ? { ...this.buildHeaders(headers) }
+                : { ...this.buildAuthHeader(), ...headers },
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        return this.handleResponse(response);
+    }
+    /**
+     * POST with multipart/form-data — no explicit Content-Type header
+     * (browser sets it with the boundary automatically).
+     */
+    async postFormData(path, formData) {
+        const response = await this.fetchWithTimeout(this.buildUrl(path), {
+            method: 'POST',
+            headers: { ...this.buildAuthHeader() },
+            body: formData,
+        });
+        return this.handleResponse(response);
+    }
+    /**
+     * POST with multipart/form-data and upload progress reporting.
+     * Uses XMLHttpRequest instead of fetch because fetch does not support
+     * upload progress events.
+     */
+    postFormDataWithProgress(path, formData, onProgress) {
+        return new Promise((resolve, reject) => {
+            const xhr = new XMLHttpRequest();
+            xhr.open('POST', this.buildUrl(path));
+            // Apply per-request timeout (null disables it)
+            if (this.requestTimeoutMs !== null) {
+                xhr.timeout = this.requestTimeoutMs;
+            }
+            const token = this.tokenProvider();
+            if (token) {
+                xhr.setRequestHeader('Authorization', `Bearer ${token}`);
+            }
+            if (onProgress) {
+                xhr.upload.onprogress = (event) => {
+                    if (event.lengthComputable) {
+                        onProgress(event.loaded, event.total);
+                    }
+                };
+            }
+            xhr.onload = () => {
+                if (xhr.status >= 200 && xhr.status < 300) {
+                    if (xhr.status === 204 || !xhr.responseText || xhr.responseText.trim() === '') {
+                        // Empty body — same convention as fetch path: cast null to T.
+                        resolve(null);
+                    }
+                    else {
+                        try {
+                            resolve(JSON.parse(xhr.responseText));
+                        }
+                        catch {
+                            reject(new ChatApiError(xhr.status, 'Parse Error', 'Failed to parse response JSON'));
+                        }
+                    }
+                }
+                else {
+                    // Build a minimal Response-like object to reuse ChatApiError.fromResponse.
+                    // Use `.then(reject, reject)` so a thrown error from the parser is also surfaced.
+                    const syntheticResponse = new Response(xhr.responseText, {
+                        status: xhr.status,
+                        statusText: xhr.statusText,
+                        headers: { 'Content-Type': 'application/json' },
+                    });
+                    ChatApiError.fromResponse(syntheticResponse).then(reject, reject);
+                }
+            };
+            xhr.onerror = () => {
+                reject(new ChatApiError(0, 'Network Error', 'Request failed due to a network error'));
+            };
+            xhr.ontimeout = () => {
+                reject(new ChatApiError(0, 'Timeout', `Request timed out after ${xhr.timeout}ms`));
+            };
+            xhr.send(formData);
+        });
+    }
+}
+//# sourceMappingURL=HttpClient.js.map

package/dist/http/HttpClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpClient.js","sourceRoot":"","sources":["../../src/http/HttpClient.ts"],"names":[],"mappings":"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"}

package/dist/http/MessageApi.d.ts

@@ -0,0 +1,69 @@
+import { HttpClient } from './HttpClient.js';
+import type { MessageDto, SendMessageRequest, EditMessageRequest } from '../types/message.js';
+import type { CursorPaginatedResult } from '../types/common.js';
+/**
+ * Message API client.
+ * All endpoints require JWT Bearer token.
+ */
+export declare class MessageApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * POST /api/conversations/{conversationId}/messages
+     * Send a new message. Returns 201 Created with the full MessageDto.
+     */
+    send(conversationId: string, request: SendMessageRequest): Promise<MessageDto>;
+    /**
+     * GET /api/conversations/{conversationId}/messages?limit={limit}&cursor={cursor}&direction={direction}
+     *
+     * Fetch message history with cursor-based pagination.
+     * direction: 'older' (default) loads messages older than cursor; 'newer' loads newer.
+     * NOTE: cursor is an opaque ULID message ID (e.g. "01JRZXYZ1234567890ABCDEF").
+     *       Always treat as a string — NEVER cast to number.
+     */
+    getHistory(conversationId: string, params?: {
+        limit?: number;
+        cursor?: string;
+        direction?: 'older' | 'newer';
+    }): Promise<CursorPaginatedResult<MessageDto>>;
+    /**
+     * GET /api/conversations/{conversationId}/messages/search?q={query}&limit={limit}
+     * Full-text search within a conversation.
+     */
+    search(conversationId: string, query: string, limit?: number): Promise<MessageDto[]>;
+    /** GET /api/messages/{messageId} */
+    getById(messageId: string): Promise<MessageDto>;
+    /**
+     * PATCH /api/messages/{messageId}
+     * Edit message content. Only the original sender can edit.
+     * NOTE: REST uses { blocks, mentions } — different from SignalR ChatEditMessageRequest.
+     */
+    edit(messageId: string, request: EditMessageRequest): Promise<MessageDto>;
+    /**
+     * DELETE /api/messages/{messageId}
+     * Soft-delete a message. Returns { messageId, deletedAt } (not 204).
+     */
+    delete(messageId: string): Promise<{
+        messageId: string;
+        deletedAt: string;
+    }>;
+    /**
+     * POST /api/messages/{messageId}/recover
+     * Recover a soft-deleted message. Only available within 10 minutes of deletion.
+     * Returns 204 No Content. Call GET /api/messages/{messageId} afterwards if
+     * you need the recovered MessageDto.
+     */
+    recover(messageId: string): Promise<void>;
+    /**
+     * POST /api/messages/{messageId}/reactions
+     * Add an emoji reaction. Returns 409 Conflict if already reacted with the same emoji.
+     */
+    addReaction(messageId: string, emoji: string): Promise<void>;
+    /**
+     * DELETE /api/messages/{messageId}/reactions/{emoji}
+     * Remove an emoji reaction.
+     * emoji is automatically URL-encoded (required by the server).
+     */
+    removeReaction(messageId: string, emoji: string): Promise<void>;
+}
+//# sourceMappingURL=MessageApi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MessageApi.d.ts","sourceRoot":"","sources":["../../src/http/MessageApi.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGhE;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAI5B;;;OAGG;IACH,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAa9E;;;;;;;OAOG;IACH,UAAU,CACR,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;KAAE,GAC1E,OAAO,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAW7C;;;OAGG;IACH,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAQpF,oCAAoC;IACpC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI/C;;;;OAIG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAWzE;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAM5E;;;;;OAKG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5D;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKhE"}

package/dist/http/MessageApi.js

@@ -0,0 +1,104 @@
+// MessageApi.ts — Message operation endpoints
+import { HttpClient } from './HttpClient.js';
+import { normalizeBlocksForSend } from '../types/block.js';
+/**
+ * Message API client.
+ * All endpoints require JWT Bearer token.
+ */
+export class MessageApi {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * POST /api/conversations/{conversationId}/messages
+     * Send a new message. Returns 201 Created with the full MessageDto.
+     */
+    send(conversationId, request) {
+        // Spec §6: `$type` must be the first property in each block when sent to
+        // the server, otherwise the polymorphic deserializer rejects the payload.
+        const normalized = {
+            ...request,
+            blocks: normalizeBlocksForSend(request.blocks),
+        };
+        return this.http.post(`/api/conversations/${encodeURIComponent(conversationId)}/messages`, normalized);
+    }
+    /**
+     * GET /api/conversations/{conversationId}/messages?limit={limit}&cursor={cursor}&direction={direction}
+     *
+     * Fetch message history with cursor-based pagination.
+     * direction: 'older' (default) loads messages older than cursor; 'newer' loads newer.
+     * NOTE: cursor is an opaque ULID message ID (e.g. "01JRZXYZ1234567890ABCDEF").
+     *       Always treat as a string — NEVER cast to number.
+     */
+    getHistory(conversationId, params) {
+        const qs = new URLSearchParams();
+        if (params?.limit !== undefined)
+            qs.set('limit', String(params.limit));
+        if (params?.cursor !== undefined)
+            qs.set('cursor', params.cursor);
+        if (params?.direction !== undefined)
+            qs.set('direction', params.direction);
+        const q = qs.toString();
+        return this.http.get(`/api/conversations/${encodeURIComponent(conversationId)}/messages${q ? `?${q}` : ''}`);
+    }
+    /**
+     * GET /api/conversations/{conversationId}/messages/search?q={query}&limit={limit}
+     * Full-text search within a conversation.
+     */
+    search(conversationId, query, limit) {
+        const qs = new URLSearchParams({ q: query });
+        if (limit !== undefined)
+            qs.set('limit', String(limit));
+        return this.http.get(`/api/conversations/${encodeURIComponent(conversationId)}/messages/search?${qs.toString()}`);
+    }
+    /** GET /api/messages/{messageId} */
+    getById(messageId) {
+        return this.http.get(`/api/messages/${encodeURIComponent(messageId)}`);
+    }
+    /**
+     * PATCH /api/messages/{messageId}
+     * Edit message content. Only the original sender can edit.
+     * NOTE: REST uses { blocks, mentions } — different from SignalR ChatEditMessageRequest.
+     */
+    edit(messageId, request) {
+        const normalized = {
+            ...request,
+            blocks: normalizeBlocksForSend(request.blocks),
+        };
+        return this.http.patch(`/api/messages/${encodeURIComponent(messageId)}`, normalized);
+    }
+    /**
+     * DELETE /api/messages/{messageId}
+     * Soft-delete a message. Returns { messageId, deletedAt } (not 204).
+     */
+    delete(messageId) {
+        return this.http.delete(`/api/messages/${encodeURIComponent(messageId)}`);
+    }
+    /**
+     * POST /api/messages/{messageId}/recover
+     * Recover a soft-deleted message. Only available within 10 minutes of deletion.
+     * Returns 204 No Content. Call GET /api/messages/{messageId} afterwards if
+     * you need the recovered MessageDto.
+     */
+    recover(messageId) {
+        return this.http.post(`/api/messages/${encodeURIComponent(messageId)}/recover`);
+    }
+    /**
+     * POST /api/messages/{messageId}/reactions
+     * Add an emoji reaction. Returns 409 Conflict if already reacted with the same emoji.
+     */
+    addReaction(messageId, emoji) {
+        return this.http.post(`/api/messages/${encodeURIComponent(messageId)}/reactions`, {
+            emoji,
+        });
+    }
+    /**
+     * DELETE /api/messages/{messageId}/reactions/{emoji}
+     * Remove an emoji reaction.
+     * emoji is automatically URL-encoded (required by the server).
+     */
+    removeReaction(messageId, emoji) {
+        return this.http.delete(`/api/messages/${encodeURIComponent(messageId)}/reactions/${encodeURIComponent(emoji)}`);
+    }
+}
+//# sourceMappingURL=MessageApi.js.map

package/dist/http/MessageApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageApi.js","sourceRoot":"","sources":["../../src/http/MessageApi.ts"],"names":[],"mappings":"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"}

package/dist/http/ParticipantApi.d.ts

@@ -0,0 +1,28 @@
+import { HttpClient } from './HttpClient.js';
+import type { ParticipantDto, CreateOrUpdateParticipantRequest } from '../types/participant.js';
+/**
+ * Participant API client.
+ * All endpoints require JWT Bearer token.
+ * GET endpoints are cached for 5 minutes on the server.
+ */
+export declare class ParticipantApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * POST /api/participants
+     * Create or update a participant (upsert by ID).
+     * Returns 201 Created for new participants, 200 OK for updates.
+     */
+    createOrUpdate(request: CreateOrUpdateParticipantRequest): Promise<ParticipantDto>;
+    /** GET /api/participants/{id} */
+    getById(id: string): Promise<ParticipantDto>;
+    /** GET /api/participants/by-uniquename/{uniqueName} */
+    getByUniqueName(uniqueName: string): Promise<ParticipantDto>;
+    /**
+     * POST /api/participants/batch
+     * Fetch multiple participants by an array of IDs in a single request.
+     * Returns only the participants that were found (missing IDs are silently skipped).
+     */
+    getBatch(ids: string[]): Promise<ParticipantDto[]>;
+}
+//# sourceMappingURL=ParticipantApi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ParticipantApi.d.ts","sourceRoot":"","sources":["../../src/http/ParticipantApi.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,gCAAgC,EAAE,MAAM,yBAAyB,CAAC;AAEhG;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAI5B;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,gCAAgC,GAAG,OAAO,CAAC,cAAc,CAAC;IAIlF,iCAAiC;IACjC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAI5C,uDAAuD;IACvD,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAM5D;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAGnD"}

package/dist/http/ParticipantApi.js

@@ -0,0 +1,37 @@
+// ParticipantApi.ts — Participant management endpoints
+import { HttpClient } from './HttpClient.js';
+/**
+ * Participant API client.
+ * All endpoints require JWT Bearer token.
+ * GET endpoints are cached for 5 minutes on the server.
+ */
+export class ParticipantApi {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * POST /api/participants
+     * Create or update a participant (upsert by ID).
+     * Returns 201 Created for new participants, 200 OK for updates.
+     */
+    createOrUpdate(request) {
+        return this.http.post('/api/participants', request);
+    }
+    /** GET /api/participants/{id} */
+    getById(id) {
+        return this.http.get(`/api/participants/${encodeURIComponent(id)}`);
+    }
+    /** GET /api/participants/by-uniquename/{uniqueName} */
+    getByUniqueName(uniqueName) {
+        return this.http.get(`/api/participants/by-uniquename/${encodeURIComponent(uniqueName)}`);
+    }
+    /**
+     * POST /api/participants/batch
+     * Fetch multiple participants by an array of IDs in a single request.
+     * Returns only the participants that were found (missing IDs are silently skipped).
+     */
+    getBatch(ids) {
+        return this.http.post('/api/participants/batch', ids);
+    }
+}
+//# sourceMappingURL=ParticipantApi.js.map

package/dist/http/ParticipantApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParticipantApi.js","sourceRoot":"","sources":["../../src/http/ParticipantApi.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C;;;;GAIG;AACH,MAAM,OAAO,cAAc;IAGzB,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,cAAc,CAAC,OAAyC;QACtD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAiB,mBAAmB,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED,iCAAiC;IACjC,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAiB,qBAAqB,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,uDAAuD;IACvD,eAAe,CAAC,UAAkB;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,mCAAmC,kBAAkB,CAAC,UAAU,CAAC,EAAE,CACpE,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,GAAa;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAmB,yBAAyB,EAAE,GAAG,CAAC,CAAC;IAC1E,CAAC;CACF"}

package/dist/http/ProxyApi.d.ts

@@ -0,0 +1,59 @@
+import { HttpClient } from './HttpClient.js';
+/**
+ * Proxy API client.
+ * Forwards requests to registered backend services via the gateway.
+ *
+ * Example:
+ *   proxy.get('trading', 'api/stocks/VN30')
+ *   → GET /api/proxy/trading/api/stocks/VN30
+ *
+ * Auth: depends on the target service. Pass JWT when required.
+ * Error format: simple { "detail": "..." } — handled by ChatApiError.fromResponse().
+ */
+export declare class ProxyApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Generic proxy request supporting any HTTP method.
+     *
+     * @param target - The registered backend target name (e.g. "trading")
+     * @param url - The URL path to forward, may include path and query string (e.g. "api/stocks/VN30?page=1")
+     * @param options.method - HTTP method (default: GET)
+     * @param options.body - Request body (for POST/PATCH)
+     * @param options.headers - Additional headers to forward
+     */
+    request<T>(target: string, url: string, options?: {
+        method?: string;
+        body?: unknown;
+        headers?: Record<string, string>;
+    }): Promise<T>;
+    /**
+     * GET /api/proxy/{target}/{url}
+     * Forward a GET request to the target service.
+     */
+    get<T>(target: string, url: string, headers?: Record<string, string>): Promise<T>;
+    /**
+     * POST /api/proxy/{target}/{url}
+     * Forward a POST request with an optional JSON body to the target service.
+     */
+    post<T>(target: string, url: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
+    /**
+     * PUT /api/proxy/{target}/{url}
+     * Forward a PUT request with an optional JSON body to the target service.
+     */
+    put<T>(target: string, url: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
+    /**
+     * PATCH /api/proxy/{target}/{url}
+     * Forward a PATCH request with an optional JSON body to the target service.
+     */
+    patch<T>(target: string, url: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
+    /**
+     * DELETE /api/proxy/{target}/{url}
+     * Forward a DELETE request to the target service. An optional JSON body is
+     * forwarded verbatim per spec §10.1 ("Forward HTTP method, query string,
+     * request body, và tất cả request headers").
+     */
+    delete<T>(target: string, url: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
+    private buildPath;
+}
+//# sourceMappingURL=ProxyApi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProxyApi.d.ts","sourceRoot":"","sources":["../../src/http/ProxyApi.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAI5B;;;;;;;;OAQG;IACH,OAAO,CAAC,CAAC,EACP,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,GACA,OAAO,CAAC,CAAC,CAAC;IAkBb;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIjF;;;OAGG;IACH,IAAI,CAAC,CAAC,EACJ,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IAIb;;;OAGG;IACH,GAAG,CAAC,CAAC,EACH,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IAIb;;;OAGG;IACH,KAAK,CAAC,CAAC,EACL,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IAIb;;;;;OAKG;IACH,MAAM,CAAC,CAAC,EACN,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IAIb,OAAO,CAAC,SAAS;CAIlB"}