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

package/dist/http/BotApi.d.ts

@@ -0,0 +1,43 @@
+import { HttpClient } from './HttpClient.js';
+import type { BotDto, CreateBotRequest, UpdateBotRequest } from '../types/bot.js';
+import type { PagedResult } from '../types/common.js';
+/**
+ * Bot API client.
+ *
+ * GET endpoints (list, getById) are public — no JWT required.
+ * Management endpoints (create, update, activate, deactivate, delete)
+ * require JWT with claim role=dev (obtained via loginWithDev).
+ * Non-dev users receive 404 Not Found on management endpoints.
+ */
+export declare class BotApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * GET /api/bots?page={page}&pageSize={pageSize}
+     * List all bots (public).
+     * page is 1-based.
+     */
+    list(params?: {
+        page?: number;
+        pageSize?: number;
+    }): Promise<PagedResult<BotDto>>;
+    /** GET /api/bots/{id} (public) */
+    getById(id: string): Promise<BotDto>;
+    /**
+     * POST /api/bots (dev-only)
+     * Register a new bot.
+     */
+    create(request: CreateBotRequest): Promise<BotDto>;
+    /**
+     * PATCH /api/bots/{id} (dev-only)
+     * Update bot metadata. kafkaTopic cannot be changed after creation.
+     */
+    update(id: string, request: UpdateBotRequest): Promise<BotDto>;
+    /** POST /api/bots/{id}/activate (dev-only) */
+    activate(id: string): Promise<void>;
+    /** POST /api/bots/{id}/deactivate (dev-only) */
+    deactivate(id: string): Promise<void>;
+    /** DELETE /api/bots/{id} (dev-only) — soft delete */
+    delete(id: string): Promise<void>;
+}
+//# sourceMappingURL=BotApi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BotApi.d.ts","sourceRoot":"","sources":["../../src/http/BotApi.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;;GAOG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAI5B;;;;OAIG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAQjF,kCAAkC;IAClC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIpC;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlD;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9D,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInC,gDAAgD;IAChD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC,qDAAqD;IACrD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGlC"}

package/dist/http/BotApi.js

@@ -0,0 +1,60 @@
+// BotApi.ts — Bot management endpoints
+import { HttpClient } from './HttpClient.js';
+/**
+ * Bot API client.
+ *
+ * GET endpoints (list, getById) are public — no JWT required.
+ * Management endpoints (create, update, activate, deactivate, delete)
+ * require JWT with claim role=dev (obtained via loginWithDev).
+ * Non-dev users receive 404 Not Found on management endpoints.
+ */
+export class BotApi {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * GET /api/bots?page={page}&pageSize={pageSize}
+     * List all bots (public).
+     * page is 1-based.
+     */
+    list(params) {
+        const qs = new URLSearchParams();
+        if (params?.page !== undefined)
+            qs.set('page', String(params.page));
+        if (params?.pageSize !== undefined)
+            qs.set('pageSize', String(params.pageSize));
+        const q = qs.toString();
+        return this.http.get(`/api/bots${q ? `?${q}` : ''}`);
+    }
+    /** GET /api/bots/{id} (public) */
+    getById(id) {
+        return this.http.get(`/api/bots/${encodeURIComponent(id)}`);
+    }
+    /**
+     * POST /api/bots (dev-only)
+     * Register a new bot.
+     */
+    create(request) {
+        return this.http.post('/api/bots', request);
+    }
+    /**
+     * PATCH /api/bots/{id} (dev-only)
+     * Update bot metadata. kafkaTopic cannot be changed after creation.
+     */
+    update(id, request) {
+        return this.http.patch(`/api/bots/${encodeURIComponent(id)}`, request);
+    }
+    /** POST /api/bots/{id}/activate (dev-only) */
+    activate(id) {
+        return this.http.post(`/api/bots/${encodeURIComponent(id)}/activate`);
+    }
+    /** POST /api/bots/{id}/deactivate (dev-only) */
+    deactivate(id) {
+        return this.http.post(`/api/bots/${encodeURIComponent(id)}/deactivate`);
+    }
+    /** DELETE /api/bots/{id} (dev-only) — soft delete */
+    delete(id) {
+        return this.http.delete(`/api/bots/${encodeURIComponent(id)}`);
+    }
+}
+//# sourceMappingURL=BotApi.js.map

package/dist/http/BotApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BotApi.js","sourceRoot":"","sources":["../../src/http/BotApi.ts"],"names":[],"mappings":"AAAA,uCAAuC;AAEvC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAI7C;;;;;;;GAOG;AACH,MAAM,OAAO,MAAM;IAGjB,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,MAA6C;QAChD,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;QACjC,IAAI,MAAM,EAAE,IAAI,KAAK,SAAS;YAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACpE,IAAI,MAAM,EAAE,QAAQ,KAAK,SAAS;YAAE,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChF,MAAM,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAsB,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,kCAAkC;IAClC,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAS,aAAa,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,OAAyB;QAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAS,WAAW,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,EAAU,EAAE,OAAyB;QAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAS,aAAa,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC;IAED,8CAA8C;IAC9C,QAAQ,CAAC,EAAU;QACjB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAO,aAAa,kBAAkB,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC;IAC9E,CAAC;IAED,gDAAgD;IAChD,UAAU,CAAC,EAAU;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAO,aAAa,kBAAkB,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC;IAChF,CAAC;IAED,qDAAqD;IACrD,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAO,aAAa,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;CACF"}

package/dist/http/ConversationApi.d.ts

@@ -0,0 +1,92 @@
+import { HttpClient } from './HttpClient.js';
+import type { ConversationDto, ConversationListItemDto, ConversationMediaItemDto, ConversationMediaKindFilter, ConversationParticipantDto, CreateConversationRequest, UpdateConversationRequest, AddParticipantRequest } from '../types/conversation.js';
+import type { CursorPaginatedResult } from '../types/common.js';
+/**
+ * Conversation API client.
+ * All endpoints require JWT Bearer token.
+ *
+ * The system only supports Group conversations (spec §6.2); there is no
+ * direct 1-1 or self chat — a conversation with one user and one bot is
+ * still modelled as a 2-member Group.
+ */
+export declare class ConversationApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * GET /api/conversations?limit={limit}&cursor={cursor}
+     *
+     * Returns paginated conversations sorted by pinned first (by pinnedAt desc),
+     * then by lastMessageAt desc.
+     *
+     * Each item includes the full lastMessage (MessageDto) for preview. Clients
+     * MUST check `lastMessage.isDeleted` before displaying — the aggregator
+     * bypasses the deleted-filter (spec §6.1).
+     *
+     * NOTE: cursor is an opaque composite string "<UnixMs>_<ULID>". Always treat
+     *       as a string — NEVER cast to number.
+     */
+    list(params?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<CursorPaginatedResult<ConversationListItemDto>>;
+    /** POST /api/conversations */
+    create(request: CreateConversationRequest): Promise<ConversationDto>;
+    /**
+     * GET /api/conversations/search?q={query}&limit={limit}
+     * Search conversations by name or participant name.
+     */
+    search(query: string, limit?: number): Promise<ConversationListItemDto[]>;
+    /** GET /api/conversations/{id} */
+    getById(id: string): Promise<ConversationDto>;
+    /** PATCH /api/conversations/{id} */
+    update(id: string, request: UpdateConversationRequest): Promise<ConversationDto>;
+    /**
+     * DELETE /api/conversations/{id}
+     * Alias for {@link leave}: the caller leaves the conversation; other
+     * participants keep it (spec §6.7).
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * POST /api/conversations/{id}/leave
+     * Leave the conversation. Identical to {@link delete}; kept as a separate
+     * method because the spec exposes both URLs (spec §6.6).
+     */
+    leave(id: string): Promise<void>;
+    /**
+     * POST /api/conversations/{id}/participants
+     * Add a participant to the conversation.
+     */
+    addParticipant(conversationId: string, request: AddParticipantRequest): Promise<void>;
+    /**
+     * DELETE /api/conversations/{id}/participants/{participantId}
+     * Remove a participant from the conversation.
+     */
+    removeParticipant(conversationId: string, participantId: string): Promise<void>;
+    /**
+     * GET /api/conversations/{id}/participants
+     * Returns all participants (including those who have left).
+     */
+    getParticipants(conversationId: string): Promise<ConversationParticipantDto[]>;
+    /** POST /api/conversations/{id}/pin */
+    pin(id: string): Promise<void>;
+    /** DELETE /api/conversations/{id}/pin */
+    unpin(id: string): Promise<void>;
+    /**
+     * GET /api/conversations/{id}/media?kind={kind}&limit={limit}&cursor={cursor}
+     *
+     * List every media/link item that has appeared in the conversation, newest first.
+     *
+     * - `kind`   — `all` (default), `attachment`, or `link` (case-insensitive on the wire).
+     * - `limit`  — 1..100, default 50.
+     * - `cursor` — opaque `nextCursor` from a prior page.
+     *
+     * Participants only see items from messages created after they joined the
+     * conversation. Returns 403 if the caller is not a participant.
+     */
+    getMedia(conversationId: string, params?: {
+        kind?: ConversationMediaKindFilter;
+        limit?: number;
+        cursor?: string;
+    }): Promise<CursorPaginatedResult<ConversationMediaItemDto>>;
+}
+//# sourceMappingURL=ConversationApi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationApi.d.ts","sourceRoot":"","sources":["../../src/http/ConversationApi.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EACV,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE;;;;;;;GAOG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAI5B;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,qBAAqB,CAAC,uBAAuB,CAAC,CAAC;IAU3D,8BAA8B;IAC9B,MAAM,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,eAAe,CAAC;IAIpE;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAMzE,kCAAkC;IAClC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAI7C,oCAAoC;IACpC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,eAAe,CAAC;IAIhF;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC;;;;OAIG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhC;;;OAGG;IACH,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrF;;;OAGG;IACH,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/E;;;OAGG;IACH,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,EAAE,CAAC;IAM9E,uCAAuC;IACvC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9B,yCAAyC;IACzC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,2BAA2B,CAAC;QACnC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GACA,OAAO,CAAC,qBAAqB,CAAC,wBAAwB,CAAC,CAAC;CAU5D"}

package/dist/http/ConversationApi.js

@@ -0,0 +1,128 @@
+// ConversationApi.ts — Conversation management endpoints
+import { HttpClient } from './HttpClient.js';
+/**
+ * Conversation API client.
+ * All endpoints require JWT Bearer token.
+ *
+ * The system only supports Group conversations (spec §6.2); there is no
+ * direct 1-1 or self chat — a conversation with one user and one bot is
+ * still modelled as a 2-member Group.
+ */
+export class ConversationApi {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * GET /api/conversations?limit={limit}&cursor={cursor}
+     *
+     * Returns paginated conversations sorted by pinned first (by pinnedAt desc),
+     * then by lastMessageAt desc.
+     *
+     * Each item includes the full lastMessage (MessageDto) for preview. Clients
+     * MUST check `lastMessage.isDeleted` before displaying — the aggregator
+     * bypasses the deleted-filter (spec §6.1).
+     *
+     * NOTE: cursor is an opaque composite string "<UnixMs>_<ULID>". Always treat
+     *       as a string — NEVER cast to number.
+     */
+    list(params) {
+        const qs = new URLSearchParams();
+        if (params?.limit !== undefined)
+            qs.set('limit', String(params.limit));
+        if (params?.cursor !== undefined)
+            qs.set('cursor', params.cursor);
+        const q = qs.toString();
+        return this.http.get(`/api/conversations${q ? `?${q}` : ''}`);
+    }
+    /** POST /api/conversations */
+    create(request) {
+        return this.http.post('/api/conversations', request);
+    }
+    /**
+     * GET /api/conversations/search?q={query}&limit={limit}
+     * Search conversations by name or participant name.
+     */
+    search(query, limit) {
+        const qs = new URLSearchParams({ q: query });
+        if (limit !== undefined)
+            qs.set('limit', String(limit));
+        return this.http.get(`/api/conversations/search?${qs.toString()}`);
+    }
+    /** GET /api/conversations/{id} */
+    getById(id) {
+        return this.http.get(`/api/conversations/${encodeURIComponent(id)}`);
+    }
+    /** PATCH /api/conversations/{id} */
+    update(id, request) {
+        return this.http.patch(`/api/conversations/${encodeURIComponent(id)}`, request);
+    }
+    /**
+     * DELETE /api/conversations/{id}
+     * Alias for {@link leave}: the caller leaves the conversation; other
+     * participants keep it (spec §6.7).
+     */
+    delete(id) {
+        return this.http.delete(`/api/conversations/${encodeURIComponent(id)}`);
+    }
+    /**
+     * POST /api/conversations/{id}/leave
+     * Leave the conversation. Identical to {@link delete}; kept as a separate
+     * method because the spec exposes both URLs (spec §6.6).
+     */
+    leave(id) {
+        return this.http.post(`/api/conversations/${encodeURIComponent(id)}/leave`);
+    }
+    /**
+     * POST /api/conversations/{id}/participants
+     * Add a participant to the conversation.
+     */
+    addParticipant(conversationId, request) {
+        return this.http.post(`/api/conversations/${encodeURIComponent(conversationId)}/participants`, request);
+    }
+    /**
+     * DELETE /api/conversations/{id}/participants/{participantId}
+     * Remove a participant from the conversation.
+     */
+    removeParticipant(conversationId, participantId) {
+        return this.http.delete(`/api/conversations/${encodeURIComponent(conversationId)}/participants/${encodeURIComponent(participantId)}`);
+    }
+    /**
+     * GET /api/conversations/{id}/participants
+     * Returns all participants (including those who have left).
+     */
+    getParticipants(conversationId) {
+        return this.http.get(`/api/conversations/${encodeURIComponent(conversationId)}/participants`);
+    }
+    /** POST /api/conversations/{id}/pin */
+    pin(id) {
+        return this.http.post(`/api/conversations/${encodeURIComponent(id)}/pin`);
+    }
+    /** DELETE /api/conversations/{id}/pin */
+    unpin(id) {
+        return this.http.delete(`/api/conversations/${encodeURIComponent(id)}/pin`);
+    }
+    /**
+     * GET /api/conversations/{id}/media?kind={kind}&limit={limit}&cursor={cursor}
+     *
+     * List every media/link item that has appeared in the conversation, newest first.
+     *
+     * - `kind`   — `all` (default), `attachment`, or `link` (case-insensitive on the wire).
+     * - `limit`  — 1..100, default 50.
+     * - `cursor` — opaque `nextCursor` from a prior page.
+     *
+     * Participants only see items from messages created after they joined the
+     * conversation. Returns 403 if the caller is not a participant.
+     */
+    getMedia(conversationId, params) {
+        const qs = new URLSearchParams();
+        if (params?.kind !== undefined)
+            qs.set('kind', params.kind);
+        if (params?.limit !== undefined)
+            qs.set('limit', String(params.limit));
+        if (params?.cursor !== undefined)
+            qs.set('cursor', params.cursor);
+        const q = qs.toString();
+        return this.http.get(`/api/conversations/${encodeURIComponent(conversationId)}/media${q ? `?${q}` : ''}`);
+    }
+}
+//# sourceMappingURL=ConversationApi.js.map

package/dist/http/ConversationApi.js.map

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

package/dist/http/FileApi.d.ts

@@ -0,0 +1,60 @@
+import { HttpClient } from './HttpClient.js';
+import type { CreateUploadUrlRequest, CreateUploadUrlResponse, UploadResponse } from '../types/file.js';
+import type { UploadProgressCallback } from '../types/common.js';
+/**
+ * File API client.
+ * Upload endpoints require JWT Bearer token.
+ * Download (GET /api/files/*) is public — no JWT required.
+ */
+export declare class FileApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * POST /api/files/upload-url
+     * Request a presigned upload URL. Returns a relative uploadUrl that must
+     * be combined with baseUrl before calling upload().
+     */
+    createUploadUrl(request: CreateUploadUrlRequest): Promise<CreateUploadUrlResponse>;
+    /**
+     * POST {uploadUrl} (relative URL from createUploadUrl response)
+     * Upload the file using multipart/form-data under the field name "file".
+     *
+     * When onProgress is provided, XHR is used (supports upload progress events).
+     * Otherwise fetch is used.
+     *
+     * NOTE: uploadUrl from the server is a relative path like "/api/files/upload?key=...&sig=...".
+     * HttpClient.buildUrl() automatically prepends baseUrl for relative paths.
+     */
+    upload(uploadUrl: string, file: File | Blob, onProgress?: UploadProgressCallback): Promise<UploadResponse>;
+    /**
+     * Returns the absolute download URL for a given storageKey.
+     *
+     * Default download is public — no auth required:
+     *   getDownloadUrl("01HXABCDEF/photo.jpg")
+     *   → "{baseUrl}/api/files/01HXABCDEF/photo.jpg"
+     *
+     * Pass `signed` to build a signed URL (spec §8.3) when the server enforces
+     * controlled access. Both `expires` and `sig` must be supplied — typically
+     * forwarded from the upload-url response or another server-issued source.
+     * Server returns 400 Bad Request (title `Invalid Signature`) if the URL has
+     * been tampered with or has expired.
+     */
+    getDownloadUrl(storageKey: string, signed?: {
+        expires: string;
+        sig: string;
+    }): string;
+    /**
+     * DELETE /api/files/{storageKey}
+     * Delete an uploaded file. Only the uploader can delete.
+     * storageKey may contain path separators (e.g. "01HXABCDEF/photo.jpg") — `/`
+     * is preserved as a path delimiter; other special characters are percent-encoded.
+     */
+    delete(storageKey: string): Promise<void>;
+    /**
+     * Convenience method: create upload URL then immediately upload the file.
+     * Equivalent to calling createUploadUrl() + upload() in sequence.
+     * onProgress is forwarded to the upload step.
+     */
+    uploadFile(file: File, onProgress?: UploadProgressCallback): Promise<UploadResponse>;
+}
+//# sourceMappingURL=FileApi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FileApi.d.ts","sourceRoot":"","sources":["../../src/http/FileApi.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE;;;;GAIG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAI5B;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAIlF;;;;;;;;;OASG;IACH,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,UAAU,CAAC,EAAE,sBAAsB,GAClC,OAAO,CAAC,cAAc,CAAC;IAS1B;;;;;;;;;;;;OAYG;IACH,cAAc,CACZ,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GACxC,MAAM;IAOT;;;;;OAKG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC;;;;OAIG;IACG,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,cAAc,CAAC;CAQ3F"}

package/dist/http/FileApi.js

@@ -0,0 +1,91 @@
+// FileApi.ts — File upload/download endpoints
+import { HttpClient } from './HttpClient.js';
+/**
+ * File API client.
+ * Upload endpoints require JWT Bearer token.
+ * Download (GET /api/files/*) is public — no JWT required.
+ */
+export class FileApi {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * POST /api/files/upload-url
+     * Request a presigned upload URL. Returns a relative uploadUrl that must
+     * be combined with baseUrl before calling upload().
+     */
+    createUploadUrl(request) {
+        return this.http.post('/api/files/upload-url', request);
+    }
+    /**
+     * POST {uploadUrl} (relative URL from createUploadUrl response)
+     * Upload the file using multipart/form-data under the field name "file".
+     *
+     * When onProgress is provided, XHR is used (supports upload progress events).
+     * Otherwise fetch is used.
+     *
+     * NOTE: uploadUrl from the server is a relative path like "/api/files/upload?key=...&sig=...".
+     * HttpClient.buildUrl() automatically prepends baseUrl for relative paths.
+     */
+    upload(uploadUrl, file, onProgress) {
+        const formData = new FormData();
+        formData.append('file', file);
+        if (onProgress) {
+            return this.http.postFormDataWithProgress(uploadUrl, formData, onProgress);
+        }
+        return this.http.postFormData(uploadUrl, formData);
+    }
+    /**
+     * Returns the absolute download URL for a given storageKey.
+     *
+     * Default download is public — no auth required:
+     *   getDownloadUrl("01HXABCDEF/photo.jpg")
+     *   → "{baseUrl}/api/files/01HXABCDEF/photo.jpg"
+     *
+     * Pass `signed` to build a signed URL (spec §8.3) when the server enforces
+     * controlled access. Both `expires` and `sig` must be supplied — typically
+     * forwarded from the upload-url response or another server-issued source.
+     * Server returns 400 Bad Request (title `Invalid Signature`) if the URL has
+     * been tampered with or has expired.
+     */
+    getDownloadUrl(storageKey, signed) {
+        const path = `/api/files/${encodeStorageKeyPath(storageKey)}`;
+        if (!signed)
+            return `${this.http.baseUrl}${path}`;
+        const qs = new URLSearchParams({ expires: signed.expires, sig: signed.sig });
+        return `${this.http.baseUrl}${path}?${qs.toString()}`;
+    }
+    /**
+     * DELETE /api/files/{storageKey}
+     * Delete an uploaded file. Only the uploader can delete.
+     * storageKey may contain path separators (e.g. "01HXABCDEF/photo.jpg") — `/`
+     * is preserved as a path delimiter; other special characters are percent-encoded.
+     */
+    delete(storageKey) {
+        return this.http.delete(`/api/files/${encodeStorageKeyPath(storageKey)}`);
+    }
+    /**
+     * Convenience method: create upload URL then immediately upload the file.
+     * Equivalent to calling createUploadUrl() + upload() in sequence.
+     * onProgress is forwarded to the upload step.
+     */
+    async uploadFile(file, onProgress) {
+        const { uploadUrl } = await this.createUploadUrl({
+            fileName: file.name,
+            contentType: file.type,
+            fileSize: file.size,
+        });
+        return this.upload(uploadUrl, file, onProgress);
+    }
+}
+/**
+ * Percent-encode each segment of a storage key while preserving `/` as the
+ * path separator. The server's catch-all route accepts the unencoded key it
+ * generated, but a key containing characters like spaces, `?`, `#`, or `%`
+ * would otherwise corrupt the URL. Pure pass-through (the previous behaviour)
+ * is preserved for the common case where keys are ULID/filename-safe.
+ */
+function encodeStorageKeyPath(storageKey) {
+    return storageKey.split('/').map(encodeURIComponent).join('/');
+}
+//# sourceMappingURL=FileApi.js.map

package/dist/http/FileApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileApi.js","sourceRoot":"","sources":["../../src/http/FileApi.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAQ7C;;;;GAIG;AACH,MAAM,OAAO,OAAO;IAGlB,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,OAA+B;QAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAA0B,uBAAuB,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CACJ,SAAiB,EACjB,IAAiB,EACjB,UAAmC;QAEnC,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;QAChC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC9B,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAiB,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC7F,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAiB,SAAS,EAAE,QAAQ,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,cAAc,CACZ,UAAkB,EAClB,MAAyC;QAEzC,MAAM,IAAI,GAAG,cAAc,oBAAoB,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9D,IAAI,CAAC,MAAM;YAAE,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;QAClD,MAAM,EAAE,GAAG,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;QAC7E,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;IACxD,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,UAAkB;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAO,cAAc,oBAAoB,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,IAAU,EAAE,UAAmC;QAC9D,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC;YAC/C,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,WAAW,EAAE,IAAI,CAAC,IAAI;YACtB,QAAQ,EAAE,IAAI,CAAC,IAAI;SACpB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAClD,CAAC;CACF;AAED;;;;;;GAMG;AACH,SAAS,oBAAoB,CAAC,UAAkB;IAC9C,OAAO,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACjE,CAAC"}

package/dist/http/HealthApi.d.ts

@@ -0,0 +1,28 @@
+import { HttpClient } from './HttpClient.js';
+/**
+ * Health check API client.
+ * All endpoints are public — no JWT required.
+ *
+ * Both endpoints return `text/plain` ("Healthy" / "Degraded" / "Unhealthy"),
+ * NOT JSON — the server uses ASP.NET Health Checks' default ResponseWriter.
+ */
+export declare class HealthApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * GET /health/live
+     * Liveness probe — returns the plain text string "Healthy" when the server is up.
+     */
+    live(): Promise<string>;
+    /**
+     * GET /health/ready
+     * Readiness probe — returns plain text "Healthy" / "Degraded" / "Unhealthy".
+     * HTTP status: 200 when Healthy/Degraded, 503 when Unhealthy.
+     *
+     * Note: the gateway is stateless and registers no checks tagged `ready`, so
+     * this currently always returns "Healthy". Call the backend's own
+     * `/health/ready` if you need infrastructure readiness.
+     */
+    ready(): Promise<string>;
+}
+//# sourceMappingURL=HealthApi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HealthApi.d.ts","sourceRoot":"","sources":["../../src/http/HealthApi.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;;;GAMG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAI5B;;;OAGG;IACH,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAIvB;;;;;;;;OAQG;IACH,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;CAGzB"}

package/dist/http/HealthApi.js

@@ -0,0 +1,34 @@
+// HealthApi.ts — Health check endpoints
+import { HttpClient } from './HttpClient.js';
+/**
+ * Health check API client.
+ * All endpoints are public — no JWT required.
+ *
+ * Both endpoints return `text/plain` ("Healthy" / "Degraded" / "Unhealthy"),
+ * NOT JSON — the server uses ASP.NET Health Checks' default ResponseWriter.
+ */
+export class HealthApi {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * GET /health/live
+     * Liveness probe — returns the plain text string "Healthy" when the server is up.
+     */
+    live() {
+        return this.http.getText('/health/live');
+    }
+    /**
+     * GET /health/ready
+     * Readiness probe — returns plain text "Healthy" / "Degraded" / "Unhealthy".
+     * HTTP status: 200 when Healthy/Degraded, 503 when Unhealthy.
+     *
+     * Note: the gateway is stateless and registers no checks tagged `ready`, so
+     * this currently always returns "Healthy". Call the backend's own
+     * `/health/ready` if you need infrastructure readiness.
+     */
+    ready() {
+        return this.http.getText('/health/ready');
+    }
+}
+//# sourceMappingURL=HealthApi.js.map

package/dist/http/HealthApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthApi.js","sourceRoot":"","sources":["../../src/http/HealthApi.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,OAAO,SAAS;IAGpB,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK;QACH,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/dist/http/HttpClient.d.ts

@@ -0,0 +1,69 @@
+import type { UploadProgressCallback } from '../types/common.js';
+/** Default per-request timeout (ms) when none is supplied. */
+export declare const DEFAULT_REQUEST_TIMEOUT_MS = 30000;
+export interface HttpClientOptions {
+    baseUrl: string;
+    /** Returns the current JWT token, or null if not authenticated */
+    tokenProvider?: () => string | null;
+    /**
+     * Per-request timeout in milliseconds. Default 30000.
+     * Pass `null` to disable the timeout (uploads of large files may need this).
+     */
+    requestTimeoutMs?: number | null;
+}
+/**
+ * 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 declare class HttpClient {
+    readonly baseUrl: string;
+    private readonly tokenProvider;
+    private readonly requestTimeoutMs;
+    constructor(options: HttpClientOptions);
+    private buildUrl;
+    private buildHeaders;
+    private buildAuthHeader;
+    /**
+     * 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.
+     */
+    private parseBody;
+    private handleResponse;
+    /**
+     * 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.
+     */
+    private fetchWithTimeout;
+    get<T>(path: string, headers?: Record<string, string>): Promise<T>;
+    /**
+     * GET a plain-text response (e.g. /health/live which returns "Healthy").
+     * Unlike get<T>(), this does not attempt JSON parsing.
+     */
+    getText(path: string): Promise<string>;
+    post<T>(path: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
+    patch<T>(path: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
+    put<T>(path: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
+    delete<T>(path: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
+    /**
+     * POST with multipart/form-data — no explicit Content-Type header
+     * (browser sets it with the boundary automatically).
+     */
+    postFormData<T>(path: string, formData: FormData): Promise<T>;
+    /**
+     * POST with multipart/form-data and upload progress reporting.
+     * Uses XMLHttpRequest instead of fetch because fetch does not support
+     * upload progress events.
+     */
+    postFormDataWithProgress<T>(path: string, formData: FormData, onProgress?: UploadProgressCallback): Promise<T>;
+}
+//# sourceMappingURL=HttpClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HttpClient.d.ts","sourceRoot":"","sources":["../../src/http/HttpClient.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,8DAA8D;AAC9D,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACpC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,UAAU;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAgB;gBAErC,OAAO,EAAE,iBAAiB;IAYtC,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,eAAe;IAQvB;;;;OAIG;YACW,SAAS;YAaT,cAAc;IAW5B;;;;OAIG;YACW,gBAAgB;IA6BxB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAQxE;;;OAGG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWtC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IASnF,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IASpF,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IASlF,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAW3F;;;OAGG;IACG,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC;IASnE;;;;OAIG;IACH,wBAAwB,CAAC,CAAC,EACxB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,EAClB,UAAU,CAAC,EAAE,sBAAsB,GAClC,OAAO,CAAC,CAAC,CAAC;CA2Dd"}