@trainly/react 1.6.3 → 2.0.0

package/dist/api/TrainlyClient.js

@@ -45,13 +45,75 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
         if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
     }
 };
+var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; }
+    function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+};
+import { TestingClient } from "./TestingClient";
+import { FineTuningClient } from "./FineTuningClient";
+import { ConfigClient } from "./ConfigClient";
+import { AnalyticsClient } from "./AnalyticsClient";
+import { VersionsClient } from "./VersionsClient";
 var TrainlyClient = /** @class */ (function () {
     function TrainlyClient(config) {
         this.scopedToken = null;
         this.currentUserId = null;
         this.isV1Mode = false;
-        this.config = config;
+        this._config = config;
+        this._initSubClients();
     }
+    TrainlyClient.prototype._initSubClients = function () {
+        var _this = this;
+        var baseUrl = this._config.baseUrl || "https://api.trainlyai.com";
+        var chatId = this._config.chatId || "";
+        var getHeaders = function () { return _this._getHeaders(); };
+        // Determine authentication mode and initialize appropriate sub-clients
+        var authMode = this._detectAuthMode();
+        if (authMode === "api_key") {
+            // Full access for API key mode
+            this.testing = new TestingClient(baseUrl, chatId, getHeaders);
+            this.fineTuning = new FineTuningClient(baseUrl, chatId, getHeaders);
+            this.config = new ConfigClient(baseUrl, chatId, getHeaders);
+            this.analytics = new AnalyticsClient(baseUrl, chatId, getHeaders);
+            this.versions = new VersionsClient(baseUrl, chatId, getHeaders);
+        }
+        else if (authMode === "v1_oauth" || authMode === "app_secret") {
+            // Limited access for V1 OAuth and app secret modes
+            this.testing = new TestingClient(baseUrl, chatId, getHeaders);
+            this.config = new ConfigClient(baseUrl, chatId, getHeaders, true); // readonly
+            this.analytics = new AnalyticsClient(baseUrl, chatId, getHeaders, true); // limited
+        }
+    };
+    TrainlyClient.prototype._detectAuthMode = function () {
+        if (this._config.apiKey)
+            return "api_key";
+        if (this._config.appId)
+            return "v1_oauth";
+        if (this._config.appSecret)
+            return "app_secret";
+        return "unknown";
+    };
+    TrainlyClient.prototype._getHeaders = function () {
+        var headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.scopedToken) {
+            headers["Authorization"] = "Bearer ".concat(this.scopedToken);
+        }
+        if (this.isV1Mode && this._config.appId) {
+            headers["X-App-ID"] = this._config.appId;
+        }
+        return headers;
+    };
     /**
      * NEW: Connect using V1 Trusted Issuer authentication with OAuth ID token
      * This method allows users to authenticate directly with their OAuth provider tokens
@@ -62,16 +124,16 @@ var TrainlyClient = /** @class */ (function () {
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        if (!this.config.appId) {
+                        if (!this._config.appId) {
                             throw new Error("appId is required for V1 authentication.");
                         }
                         // For V1, we use the ID token directly - no need to provision
                         this.scopedToken = idToken;
                         this.isV1Mode = true;
-                        return [4 /*yield*/, fetch("".concat(this.config.baseUrl, "/v1/me/profile"), {
+                        return [4 /*yield*/, fetch("".concat(this._config.baseUrl, "/v1/me/profile"), {
                                 headers: {
                                     Authorization: "Bearer ".concat(idToken),
-                                    "X-App-ID": this.config.appId,
+                                    "X-App-ID": this._config.appId,
                                 },
                             })];
                     case 1:
@@ -100,23 +162,23 @@ var TrainlyClient = /** @class */ (function () {
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        if (this.config.apiKey) {
+                        if (this._config.apiKey) {
                             // Direct API key mode - no additional setup needed
-                            this.scopedToken = this.config.apiKey;
+                            this.scopedToken = this._config.apiKey;
                             return [2 /*return*/];
                         }
-                        if (!this.config.appSecret) {
+                        if (!this._config.appSecret) {
                             throw new Error("Either appSecret or apiKey must be provided");
                         }
                         // App secret mode - provision user
                         // Ensure we use the same user ID consistently
                         if (!this.currentUserId) {
-                            this.currentUserId = this.config.userId || this.generateAnonymousId();
+                            this.currentUserId = this._config.userId || this.generateAnonymousId();
                         }
-                        return [4 /*yield*/, fetch("".concat(this.config.baseUrl, "/v1/privacy/apps/users/provision"), {
+                        return [4 /*yield*/, fetch("".concat(this._config.baseUrl, "/v1/privacy/apps/users/provision"), {
                                 method: "POST",
                                 headers: {
-                                    Authorization: "Bearer ".concat(this.config.appSecret),
+                                    Authorization: "Bearer ".concat(this._config.appSecret),
                                     "Content-Type": "application/json",
                                 },
                                 body: JSON.stringify({
@@ -151,7 +213,7 @@ var TrainlyClient = /** @class */ (function () {
                         if (!this.scopedToken) {
                             throw new Error("Not connected. Call connect() or connectWithOAuthToken() first.");
                         }
-                        if (!(this.isV1Mode && this.config.appId)) return [3 /*break*/, 5];
+                        if (!(this.isV1Mode && this._config.appId)) return [3 /*break*/, 5];
                         params = {
                             messages: JSON.stringify([{ role: "user", content: question }]),
                             response_tokens: "150",
@@ -161,11 +223,11 @@ var TrainlyClient = /** @class */ (function () {
                             Object.keys(options.scope_filters).length > 0) {
                             params.scope_filters = JSON.stringify(options.scope_filters);
                         }
-                        return [4 /*yield*/, fetch("".concat(this.config.baseUrl, "/v1/me/chats/query"), {
+                        return [4 /*yield*/, fetch("".concat(this._config.baseUrl, "/v1/me/chats/query"), {
                                 method: "POST",
                                 headers: {
                                     Authorization: "Bearer ".concat(this.scopedToken),
-                                    "X-App-ID": this.config.appId,
+                                    "X-App-ID": this._config.appId,
                                     "Content-Type": "application/x-www-form-urlencoded",
                                 },
                                 body: new URLSearchParams(params),
@@ -185,21 +247,21 @@ var TrainlyClient = /** @class */ (function () {
                                 citations: includeCitations ? data_1.citations || [] : [],
                             }];
                     case 5:
-                        url = this.config.apiKey
-                            ? "".concat(this.config.baseUrl, "/v1/").concat(this.getChatId(), "/answer_question")
-                            : "".concat(this.config.baseUrl, "/v1/privacy/query");
+                        url = this._config.apiKey
+                            ? "".concat(this._config.baseUrl, "/v1/").concat(this.getChatId(), "/answer_question")
+                            : "".concat(this._config.baseUrl, "/v1/privacy/query");
                         headers = {
                             "Content-Type": "application/json",
                         };
                         body = { question: question };
-                        if (this.config.apiKey) {
-                            headers["Authorization"] = "Bearer ".concat(this.config.apiKey);
+                        if (this._config.apiKey) {
+                            headers["Authorization"] = "Bearer ".concat(this._config.apiKey);
                         }
                         else {
                             headers["x-scoped-token"] = this.scopedToken;
                             // Use the same user ID that was used during provisioning
                             body.end_user_id =
-                                this.currentUserId || this.config.userId || this.generateAnonymousId();
+                                this.currentUserId || this._config.userId || this.generateAnonymousId();
                             body.include_citations = options.includeCitations || false;
                         }
                         return [4 /*yield*/, fetch(url, {
@@ -225,6 +287,175 @@ var TrainlyClient = /** @class */ (function () {
             });
         });
     };
+    TrainlyClient.prototype.askStream = function (question_1) {
+        return __asyncGenerator(this, arguments, function askStream_1(question, options) {
+            var params, response, error, reader, decoder, buffer, _a, done, value, lines, _i, lines_1, line, data, parsed, e_1, response, error, reader, decoder, buffer, _b, done, value, lines, _c, lines_2, line, data, parsed, e_2;
+            var _d, _e, _f, _g;
+            if (options === void 0) { options = {}; }
+            return __generator(this, function (_h) {
+                switch (_h.label) {
+                    case 0:
+                        if (!(this.isV1Mode && this._config.appId)) return [3 /*break*/, 18];
+                        if (!this.scopedToken) {
+                            throw new Error("Not connected. Call connect() or connectWithOAuthToken() first.");
+                        }
+                        params = {
+                            messages: JSON.stringify([{ role: "user", content: question }]),
+                            response_tokens: "150",
+                            stream: "true",
+                        };
+                        if (options.scope_filters &&
+                            Object.keys(options.scope_filters).length > 0) {
+                            params.scope_filters = JSON.stringify(options.scope_filters);
+                        }
+                        return [4 /*yield*/, __await(fetch("".concat(this._config.baseUrl, "/v1/me/chats/query"), {
+                                method: "POST",
+                                headers: {
+                                    Authorization: "Bearer ".concat(this.scopedToken),
+                                    "X-App-ID": this._config.appId,
+                                    "Content-Type": "application/x-www-form-urlencoded",
+                                    Accept: "text/event-stream",
+                                },
+                                body: new URLSearchParams(params),
+                            }))];
+                    case 1:
+                        response = _h.sent();
+                        if (!!response.ok) return [3 /*break*/, 3];
+                        return [4 /*yield*/, __await(response.json())];
+                    case 2:
+                        error = _h.sent();
+                        throw new Error("V1 streaming query failed: ".concat(error.detail || response.statusText));
+                    case 3:
+                        reader = (_d = response.body) === null || _d === void 0 ? void 0 : _d.getReader();
+                        if (!reader)
+                            throw new Error("No response body for streaming");
+                        decoder = new TextDecoder();
+                        buffer = "";
+                        _h.label = 4;
+                    case 4:
+                        if (!true) return [3 /*break*/, 16];
+                        return [4 /*yield*/, __await(reader.read())];
+                    case 5:
+                        _a = _h.sent(), done = _a.done, value = _a.value;
+                        if (done)
+                            return [3 /*break*/, 16];
+                        buffer += decoder.decode(value, { stream: true });
+                        lines = buffer.split("\n");
+                        buffer = lines.pop() || "";
+                        _i = 0, lines_1 = lines;
+                        _h.label = 6;
+                    case 6:
+                        if (!(_i < lines_1.length)) return [3 /*break*/, 15];
+                        line = lines_1[_i];
+                        if (!line.startsWith("data: ")) return [3 /*break*/, 14];
+                        data = line.slice(6).trim();
+                        if (!(data === "[DONE]")) return [3 /*break*/, 8];
+                        return [4 /*yield*/, __await(void 0)];
+                    case 7: return [2 /*return*/, _h.sent()];
+                    case 8:
+                        _h.trys.push([8, 13, , 14]);
+                        parsed = JSON.parse(data);
+                        if (!(parsed.type === "content")) return [3 /*break*/, 11];
+                        (_e = options.onChunk) === null || _e === void 0 ? void 0 : _e.call(options, parsed.data);
+                        return [4 /*yield*/, __await(parsed.data)];
+                    case 9: return [4 /*yield*/, _h.sent()];
+                    case 10:
+                        _h.sent();
+                        return [3 /*break*/, 12];
+                    case 11:
+                        if (parsed.type === "error") {
+                            throw new Error(parsed.data);
+                        }
+                        _h.label = 12;
+                    case 12: return [3 /*break*/, 14];
+                    case 13:
+                        e_1 = _h.sent();
+                        if (e_1 instanceof SyntaxError)
+                            return [3 /*break*/, 14];
+                        throw e_1;
+                    case 14:
+                        _i++;
+                        return [3 /*break*/, 6];
+                    case 15: return [3 /*break*/, 4];
+                    case 16: return [4 /*yield*/, __await(void 0)];
+                    case 17: return [2 /*return*/, _h.sent()];
+                    case 18:
+                        if (!this._config.apiKey) return [3 /*break*/, 36];
+                        return [4 /*yield*/, __await(fetch("".concat(this._config.baseUrl, "/v1/").concat(this.getChatId(), "/answer_question_stream"), {
+                                method: "POST",
+                                headers: {
+                                    Authorization: "Bearer ".concat(this._config.apiKey),
+                                    "Content-Type": "application/json",
+                                    Accept: "text/event-stream",
+                                },
+                                body: JSON.stringify({ question: question }),
+                            }))];
+                    case 19:
+                        response = _h.sent();
+                        if (!!response.ok) return [3 /*break*/, 21];
+                        return [4 /*yield*/, __await(response.json())];
+                    case 20:
+                        error = _h.sent();
+                        throw new Error("Streaming query failed: ".concat(error.detail || response.statusText));
+                    case 21:
+                        reader = (_f = response.body) === null || _f === void 0 ? void 0 : _f.getReader();
+                        if (!reader)
+                            throw new Error("No response body for streaming");
+                        decoder = new TextDecoder();
+                        buffer = "";
+                        _h.label = 22;
+                    case 22:
+                        if (!true) return [3 /*break*/, 34];
+                        return [4 /*yield*/, __await(reader.read())];
+                    case 23:
+                        _b = _h.sent(), done = _b.done, value = _b.value;
+                        if (done)
+                            return [3 /*break*/, 34];
+                        buffer += decoder.decode(value, { stream: true });
+                        lines = buffer.split("\n");
+                        buffer = lines.pop() || "";
+                        _c = 0, lines_2 = lines;
+                        _h.label = 24;
+                    case 24:
+                        if (!(_c < lines_2.length)) return [3 /*break*/, 33];
+                        line = lines_2[_c];
+                        if (!line.startsWith("data: ")) return [3 /*break*/, 32];
+                        data = line.slice(6).trim();
+                        if (!(data === "[DONE]")) return [3 /*break*/, 26];
+                        return [4 /*yield*/, __await(void 0)];
+                    case 25: return [2 /*return*/, _h.sent()];
+                    case 26:
+                        _h.trys.push([26, 31, , 32]);
+                        parsed = JSON.parse(data);
+                        if (!(parsed.type === "content")) return [3 /*break*/, 29];
+                        (_g = options.onChunk) === null || _g === void 0 ? void 0 : _g.call(options, parsed.data);
+                        return [4 /*yield*/, __await(parsed.data)];
+                    case 27: return [4 /*yield*/, _h.sent()];
+                    case 28:
+                        _h.sent();
+                        return [3 /*break*/, 30];
+                    case 29:
+                        if (parsed.type === "error") {
+                            throw new Error(parsed.data);
+                        }
+                        _h.label = 30;
+                    case 30: return [3 /*break*/, 32];
+                    case 31:
+                        e_2 = _h.sent();
+                        if (e_2 instanceof SyntaxError)
+                            return [3 /*break*/, 32];
+                        throw e_2;
+                    case 32:
+                        _c++;
+                        return [3 /*break*/, 24];
+                    case 33: return [3 /*break*/, 22];
+                    case 34: return [4 /*yield*/, __await(void 0)];
+                    case 35: return [2 /*return*/, _h.sent()];
+                    case 36: throw new Error("Streaming is not supported in app secret mode");
+                }
+            });
+        });
+    };
     TrainlyClient.prototype.upload = function (file, scopeValues) {
         return __awaiter(this, void 0, void 0, function () {
             var formData, response, error, data, formData, response, error, result, fileId, sizeBytes, status_1, processed, err_1, presignedResponse, error, _a, upload_url, upload_headers, formData, uploadResponse;
@@ -235,18 +466,18 @@ var TrainlyClient = /** @class */ (function () {
                         if (!this.scopedToken) {
                             throw new Error("Not connected. Call connect() or connectWithOAuthToken() first.");
                         }
-                        if (!(this.isV1Mode && this.config.appId)) return [3 /*break*/, 5];
+                        if (!(this.isV1Mode && this._config.appId)) return [3 /*break*/, 5];
                         formData = new FormData();
                         formData.append("file", file);
                         // Add scope values if provided
                         if (scopeValues && Object.keys(scopeValues).length > 0) {
                             formData.append("scope_values", JSON.stringify(scopeValues));
                         }
-                        return [4 /*yield*/, fetch("".concat(this.config.baseUrl, "/v1/me/chats/files/upload"), {
+                        return [4 /*yield*/, fetch("".concat(this._config.baseUrl, "/v1/me/chats/files/upload"), {
                                 method: "POST",
                                 headers: {
                                     Authorization: "Bearer ".concat(this.scopedToken),
-                                    "X-App-ID": this.config.appId,
+                                    "X-App-ID": this._config.appId,
                                 },
                                 body: formData,
                             })];
@@ -267,15 +498,15 @@ var TrainlyClient = /** @class */ (function () {
                                 message: data.message || "File uploaded to your permanent private subchat",
                             }];
                     case 5:
-                        if (!this.config.apiKey) return [3 /*break*/, 14];
+                        if (!this._config.apiKey) return [3 /*break*/, 14];
                         formData = new FormData();
                         formData.append("file", file);
                         // Always send scope_values (default empty object) to match Python SDK behavior
                         formData.append("scope_values", JSON.stringify(scopeValues && Object.keys(scopeValues).length > 0 ? scopeValues : {}));
-                        return [4 /*yield*/, fetch("".concat(this.config.baseUrl, "/v1/").concat(this.getChatId(), "/upload_with_scopes"), {
+                        return [4 /*yield*/, fetch("".concat(this._config.baseUrl, "/v1/").concat(this.getChatId(), "/upload_with_scopes"), {
                                 method: "POST",
                                 headers: {
-                                    Authorization: "Bearer ".concat(this.config.apiKey),
+                                    Authorization: "Bearer ".concat(this._config.apiKey),
                                 },
                                 body: formData,
                             })];
@@ -323,7 +554,7 @@ var TrainlyClient = /** @class */ (function () {
                             size: sizeBytes,
                             message: result.message || "File uploaded successfully",
                         }];
-                    case 14: return [4 /*yield*/, fetch("".concat(this.config.baseUrl, "/v1/privacy/upload/presigned-url"), {
+                    case 14: return [4 /*yield*/, fetch("".concat(this._config.baseUrl, "/v1/privacy/upload/presigned-url"), {
                             method: "POST",
                             headers: {
                                 "Content-Type": "application/json",
@@ -331,7 +562,7 @@ var TrainlyClient = /** @class */ (function () {
                             },
                             body: JSON.stringify({
                                 end_user_id: this.currentUserId ||
-                                    this.config.userId ||
+                                    this._config.userId ||
                                     this.generateAnonymousId(),
                                 filename: file.name,
                                 file_type: file.type,
@@ -378,7 +609,7 @@ var TrainlyClient = /** @class */ (function () {
                         if (!this.scopedToken) {
                             throw new Error("Not connected. Call connect() or connectWithOAuthToken() first.");
                         }
-                        if (!(this.isV1Mode && this.config.appId)) return [3 /*break*/, 5];
+                        if (!(this.isV1Mode && this._config.appId)) return [3 /*break*/, 5];
                         formData = new FormData();
                         formData.append("text_content", text);
                         formData.append("content_name", contentName);
@@ -386,11 +617,11 @@ var TrainlyClient = /** @class */ (function () {
                         if (scopeValues && Object.keys(scopeValues).length > 0) {
                             formData.append("scope_values", JSON.stringify(scopeValues));
                         }
-                        return [4 /*yield*/, fetch("".concat(this.config.baseUrl, "/v1/me/chats/files/upload"), {
+                        return [4 /*yield*/, fetch("".concat(this._config.baseUrl, "/v1/me/chats/files/upload"), {
                                 method: "POST",
                                 headers: {
                                     Authorization: "Bearer ".concat(this.scopedToken),
-                                    "X-App-ID": this.config.appId,
+                                    "X-App-ID": this._config.appId,
                                 },
                                 body: formData,
                             })];
@@ -433,7 +664,7 @@ var TrainlyClient = /** @class */ (function () {
                         if (files.length > 10) {
                             throw new Error("Too many files. Maximum 10 files per bulk upload.");
                         }
-                        if (!(this.isV1Mode && this.config.appId)) return [3 /*break*/, 5];
+                        if (!(this.isV1Mode && this._config.appId)) return [3 /*break*/, 5];
                         formData_1 = new FormData();
                         // Append all files to the form data
                         files.forEach(function (file) {
@@ -443,11 +674,11 @@ var TrainlyClient = /** @class */ (function () {
                         if (scopeValues && Object.keys(scopeValues).length > 0) {
                             formData_1.append("scope_values", JSON.stringify(scopeValues));
                         }
-                        return [4 /*yield*/, fetch("".concat(this.config.baseUrl, "/v1/me/chats/files/upload-bulk"), {
+                        return [4 /*yield*/, fetch("".concat(this._config.baseUrl, "/v1/me/chats/files/upload-bulk"), {
                                 method: "POST",
                                 headers: {
                                     Authorization: "Bearer ".concat(this.scopedToken),
-                                    "X-App-ID": this.config.appId,
+                                    "X-App-ID": this._config.appId,
                                 },
                                 body: formData_1,
                             })];
@@ -545,7 +776,7 @@ var TrainlyClient = /** @class */ (function () {
                         if (textContents.length > 10) {
                             throw new Error("Too many items. Maximum 10 items per bulk upload.");
                         }
-                        if (!(this.isV1Mode && this.config.appId)) return [3 /*break*/, 5];
+                        if (!(this.isV1Mode && this._config.appId)) return [3 /*break*/, 5];
                         formData = new FormData();
                         texts = textContents.map(function (tc) { return tc.text; });
                         names = textContents.map(function (tc) { return tc.contentName; });
@@ -555,11 +786,11 @@ var TrainlyClient = /** @class */ (function () {
                         if (scopeValues && Object.keys(scopeValues).length > 0) {
                             formData.append("scope_values", JSON.stringify(scopeValues));
                         }
-                        return [4 /*yield*/, fetch("".concat(this.config.baseUrl, "/v1/me/chats/files/upload-bulk"), {
+                        return [4 /*yield*/, fetch("".concat(this._config.baseUrl, "/v1/me/chats/files/upload-bulk"), {
                                 method: "POST",
                                 headers: {
                                     Authorization: "Bearer ".concat(this.scopedToken),
-                                    "X-App-ID": this.config.appId,
+                                    "X-App-ID": this._config.appId,
                                 },
                                 body: formData,
                             })];
@@ -652,11 +883,11 @@ var TrainlyClient = /** @class */ (function () {
                         if (!this.scopedToken) {
                             throw new Error("Not connected. Call connect() or connectWithOAuthToken() first.");
                         }
-                        if (!this.config.apiKey) return [3 /*break*/, 5];
-                        return [4 /*yield*/, fetch("".concat(this.config.baseUrl, "/v1/").concat(this.getChatId(), "/files"), {
+                        if (!this._config.apiKey) return [3 /*break*/, 5];
+                        return [4 /*yield*/, fetch("".concat(this._config.baseUrl, "/v1/").concat(this.getChatId(), "/files"), {
                                 method: "GET",
                                 headers: {
-                                    Authorization: "Bearer ".concat(this.config.apiKey),
+                                    Authorization: "Bearer ".concat(this._config.apiKey),
                                 },
                             })];
                     case 1:
@@ -685,12 +916,12 @@ var TrainlyClient = /** @class */ (function () {
                                 total_size_bytes: (_c = data.total_size_bytes) !== null && _c !== void 0 ? _c : 0,
                             }];
                     case 5:
-                        if (!(this.isV1Mode && this.config.appId)) return [3 /*break*/, 10];
-                        return [4 /*yield*/, fetch("".concat(this.config.baseUrl, "/v1/me/chats/files"), {
+                        if (!(this.isV1Mode && this._config.appId)) return [3 /*break*/, 10];
+                        return [4 /*yield*/, fetch("".concat(this._config.baseUrl, "/v1/me/chats/files"), {
                                 method: "GET",
                                 headers: {
                                     Authorization: "Bearer ".concat(this.scopedToken),
-                                    "X-App-ID": this.config.appId,
+                                    "X-App-ID": this._config.appId,
                                 },
                             })];
                     case 6:
@@ -725,11 +956,11 @@ var TrainlyClient = /** @class */ (function () {
                         if (!fileId) {
                             throw new Error("File ID is required");
                         }
-                        if (!this.config.apiKey) return [3 /*break*/, 5];
-                        return [4 /*yield*/, fetch("".concat(this.config.baseUrl, "/v1/").concat(this.getChatId(), "/files/").concat(encodeURIComponent(fileId)), {
+                        if (!this._config.apiKey) return [3 /*break*/, 5];
+                        return [4 /*yield*/, fetch("".concat(this._config.baseUrl, "/v1/").concat(this.getChatId(), "/files/").concat(encodeURIComponent(fileId)), {
                                 method: "DELETE",
                                 headers: {
-                                    Authorization: "Bearer ".concat(this.config.apiKey),
+                                    Authorization: "Bearer ".concat(this._config.apiKey),
                                 },
                             })];
                     case 1:
@@ -762,12 +993,12 @@ var TrainlyClient = /** @class */ (function () {
                                 size_bytes_freed: (_c = data.size_bytes_freed) !== null && _c !== void 0 ? _c : 0,
                             }];
                     case 5:
-                        if (!(this.isV1Mode && this.config.appId)) return [3 /*break*/, 10];
-                        return [4 /*yield*/, fetch("".concat(this.config.baseUrl, "/v1/me/chats/files/").concat(encodeURIComponent(fileId)), {
+                        if (!(this.isV1Mode && this._config.appId)) return [3 /*break*/, 10];
+                        return [4 /*yield*/, fetch("".concat(this._config.baseUrl, "/v1/me/chats/files/").concat(encodeURIComponent(fileId)), {
                                 method: "DELETE",
                                 headers: {
                                     Authorization: "Bearer ".concat(this.scopedToken),
-                                    "X-App-ID": this.config.appId,
+                                    "X-App-ID": this._config.appId,
                                 },
                             })];
                     case 6:
@@ -801,10 +1032,10 @@ var TrainlyClient = /** @class */ (function () {
                         _a.label = 1;
                     case 1:
                         if (!true) return [3 /*break*/, 9];
-                        return [4 /*yield*/, fetch("".concat(this.config.baseUrl, "/v1/").concat(this.getChatId(), "/files/").concat(encodeURIComponent(fileId), "/status"), {
+                        return [4 /*yield*/, fetch("".concat(this._config.baseUrl, "/v1/").concat(this.getChatId(), "/files/").concat(encodeURIComponent(fileId), "/status"), {
                                 method: "GET",
                                 headers: {
-                                    Authorization: "Bearer ".concat(this.config.apiKey),
+                                    Authorization: "Bearer ".concat(this._config.apiKey),
                                 },
                             })];
                     case 2:
@@ -846,8 +1077,8 @@ var TrainlyClient = /** @class */ (function () {
         });
     };
     TrainlyClient.prototype.getChatId = function () {
-        if (this.config.chatId) {
-            return this.config.chatId;
+        if (this._config.chatId) {
+            return this._config.chatId;
         }
         return this.extractChatId();
     };
@@ -858,13 +1089,13 @@ var TrainlyClient = /** @class */ (function () {
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        if (!this.config.apiKey) {
+                        if (!this._config.apiKey) {
                             throw new Error("API key required to get chat settings");
                         }
-                        return [4 /*yield*/, fetch("".concat(this.config.baseUrl, "/v1/").concat(this.getChatId(), "/settings"), {
+                        return [4 /*yield*/, fetch("".concat(this._config.baseUrl, "/v1/").concat(this.getChatId(), "/settings"), {
                                 method: "GET",
                                 headers: {
-                                    Authorization: "Bearer ".concat(this.config.apiKey),
+                                    Authorization: "Bearer ".concat(this._config.apiKey),
                                 },
                             })];
                     case 1:
@@ -887,14 +1118,14 @@ var TrainlyClient = /** @class */ (function () {
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        if (!this.config.apiKey) {
+                        if (!this._config.apiKey) {
                             throw new Error("API key required to update chat settings");
                         }
-                        return [4 /*yield*/, fetch("".concat(this.config.baseUrl, "/v1/").concat(this.getChatId(), "/settings"), {
+                        return [4 /*yield*/, fetch("".concat(this._config.baseUrl, "/v1/").concat(this.getChatId(), "/settings"), {
                                 method: "POST",
                                 headers: {
                                     "Content-Type": "application/json",
-                                    Authorization: "Bearer ".concat(this.config.apiKey),
+                                    Authorization: "Bearer ".concat(this._config.apiKey),
                                 },
                                 body: JSON.stringify(settings),
                             })];
@@ -913,11 +1144,11 @@ var TrainlyClient = /** @class */ (function () {
         });
     };
     TrainlyClient.prototype.extractChatId = function () {
-        if (!this.config.apiKey) {
+        if (!this._config.apiKey) {
             throw new Error("API key not provided");
         }
         // Extract chat ID from API key format: tk_chat_id_rest
-        var parts = this.config.apiKey.split("_");
+        var parts = this._config.apiKey.split("_");
         if (parts.length < 3) {
             throw new Error("Invalid API key format");
         }

package/dist/api/VersionsClient.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Versions client for publishing and managing configuration versions.
+ */
+import { PublishedVersion, VersionDiff } from "../types";
+export declare class VersionsClient {
+    private baseUrl;
+    private chatId;
+    private getHeaders;
+    constructor(baseUrl: string, chatId: string, getHeaders: () => HeadersInit);
+    private request;
+    publish(version: string, description?: string): Promise<PublishedVersion>;
+    listVersions(page?: number, limit?: number): Promise<PublishedVersion[]>;
+    getVersion(versionId: string): Promise<PublishedVersion>;
+    rollback(versionId: string): Promise<boolean>;
+    compareVersions(versionA: string, versionB: string): Promise<VersionDiff>;
+    getUnpublishedChanges(): Promise<boolean>;
+    getActiveVersion(): Promise<PublishedVersion | null>;
+}