twelvelabs-js 1.2.9 → 1.3.0

package/api/resources/knowledgeStoreItemCollections/client/Client.js

@@ -0,0 +1,673 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KnowledgeStoreItemCollections = void 0;
+const environments = __importStar(require("../../../../environments"));
+const core = __importStar(require("../../../../core"));
+const TwelvelabsApi = __importStar(require("../../../index"));
+const serializers = __importStar(require("../../../../serialization/index"));
+const url_join_1 = __importDefault(require("url-join"));
+const errors = __importStar(require("../../../../errors/index"));
+class KnowledgeStoreItemCollections {
+    constructor(_options) {
+        this._options = _options;
+    }
+    /**
+     * Returns a list of the item collections in the specified knowledge store.
+     *
+     * @param {string} knowledgeStoreId - The unique identifier of the knowledge store.
+     * @param {TwelvelabsApi.KnowledgeStoreItemCollectionsListRequest} request
+     * @param {KnowledgeStoreItemCollections.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TwelvelabsApi.BadRequestError}
+     *
+     * @example
+     *     await client.knowledgeStoreItemCollections.list("ks_069e9869-1ea3-7481-8000-dae72bf6be6e", {
+     *         page: 1,
+     *         pageLimit: 10,
+     *         sortBy: "created_at",
+     *         sortOption: "desc"
+     *     })
+     */
+    list(knowledgeStoreId_1) {
+        return __awaiter(this, arguments, void 0, function* (knowledgeStoreId, request = {}, requestOptions) {
+            const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
+                var _a, _b;
+                const { page, pageLimit, sortBy, sortOption } = request;
+                const _queryParams = {};
+                if (page != null) {
+                    _queryParams["page"] = page.toString();
+                }
+                if (pageLimit != null) {
+                    _queryParams["page_limit"] = pageLimit.toString();
+                }
+                if (sortBy != null) {
+                    _queryParams["sort_by"] = serializers.KnowledgeStoreItemCollectionsListRequestSortBy.jsonOrThrow(sortBy, { unrecognizedObjectKeys: "strip" });
+                }
+                if (sortOption != null) {
+                    _queryParams["sort_option"] = sortOption;
+                }
+                const _response = yield core.fetcher({
+                    url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, `knowledge-stores/${encodeURIComponent(knowledgeStoreId)}/item-collections`),
+                    method: "GET",
+                    headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.3.0", "User-Agent": "twelvelabs-js/1.3.0", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                    contentType: "application/json",
+                    queryParameters: _queryParams,
+                    requestType: "json",
+                    timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 600000,
+                    maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                    abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                });
+                if (_response.ok) {
+                    return {
+                        data: serializers.KnowledgeStoreItemCollectionsListResponse.parseOrThrow(_response.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }),
+                        rawResponse: _response.rawResponse,
+                    };
+                }
+                if (_response.error.reason === "status-code") {
+                    switch (_response.error.statusCode) {
+                        case 400:
+                            throw new TwelvelabsApi.BadRequestError(_response.error.body, _response.rawResponse);
+                        default:
+                            throw new errors.TwelvelabsApiError({
+                                statusCode: _response.error.statusCode,
+                                body: _response.error.body,
+                                rawResponse: _response.rawResponse,
+                            });
+                    }
+                }
+                switch (_response.error.reason) {
+                    case "non-json":
+                        throw new errors.TwelvelabsApiError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.rawBody,
+                            rawResponse: _response.rawResponse,
+                        });
+                    case "timeout":
+                        throw new errors.TwelvelabsApiTimeoutError("Timeout exceeded when calling GET /knowledge-stores/{knowledge_store_id}/item-collections.");
+                    case "unknown":
+                        throw new errors.TwelvelabsApiError({
+                            message: _response.error.errorMessage,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }));
+            let _offset = (request === null || request === void 0 ? void 0 : request.page) != null ? request === null || request === void 0 ? void 0 : request.page : 1;
+            const dataWithRawResponse = yield list(request).withRawResponse();
+            return new core.Pageable({
+                response: dataWithRawResponse.data,
+                rawResponse: dataWithRawResponse.rawResponse,
+                hasNextPage: (response) => { var _a; return ((_a = response === null || response === void 0 ? void 0 : response.data) !== null && _a !== void 0 ? _a : []).length > 0; },
+                getItems: (response) => { var _a; return (_a = response === null || response === void 0 ? void 0 : response.data) !== null && _a !== void 0 ? _a : []; },
+                loadPage: (_response) => {
+                    _offset += 1;
+                    return list(core.setObjectProperty(request, "page", _offset));
+                },
+            });
+        });
+    }
+    /**
+     * Creates an item collection in the specified knowledge store. An item collection is a named collection of items. Use item collections to organize and reference subsets of items together.
+     *
+     * @param {string} knowledgeStoreId - The unique identifier of the knowledge store.
+     * @param {TwelvelabsApi.KnowledgeStoreItemCollectionsCreateRequest} request
+     * @param {KnowledgeStoreItemCollections.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TwelvelabsApi.BadRequestError}
+     *
+     * @example
+     *     await client.knowledgeStoreItemCollections.create("ks_069e9869-1ea3-7481-8000-dae72bf6be6e", {
+     *         name: "Q1 highlights"
+     *     })
+     */
+    create(knowledgeStoreId, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__create(knowledgeStoreId, request, requestOptions));
+    }
+    __create(knowledgeStoreId, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const _response = yield core.fetcher({
+                url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, `knowledge-stores/${encodeURIComponent(knowledgeStoreId)}/item-collections`),
+                method: "POST",
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.3.0", "User-Agent": "twelvelabs-js/1.3.0", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                contentType: "application/json",
+                requestType: "json",
+                body: serializers.KnowledgeStoreItemCollectionsCreateRequest.jsonOrThrow(request, {
+                    unrecognizedObjectKeys: "strip",
+                }),
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 600000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.KnowledgeStoreItemCollection.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new TwelvelabsApi.BadRequestError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.TwelvelabsApiError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.TwelvelabsApiError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.TwelvelabsApiTimeoutError("Timeout exceeded when calling POST /knowledge-stores/{knowledge_store_id}/item-collections.");
+                case "unknown":
+                    throw new errors.TwelvelabsApiError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Retrieves the details of a specific item collection.
+     *
+     * @param {string} knowledgeStoreId - The unique identifier of the knowledge store.
+     * @param {string} collectionId - The unique identifier of the knowledge store item collection.
+     * @param {KnowledgeStoreItemCollections.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TwelvelabsApi.BadRequestError}
+     *
+     * @example
+     *     await client.knowledgeStoreItemCollections.retrieve("ks_069e9869-1ea3-7481-8000-dae72bf6be6e", "ksic_069e9870-3c4d-7abc-9012-3456789abcde")
+     */
+    retrieve(knowledgeStoreId, collectionId, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__retrieve(knowledgeStoreId, collectionId, requestOptions));
+    }
+    __retrieve(knowledgeStoreId, collectionId, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const _response = yield core.fetcher({
+                url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, `knowledge-stores/${encodeURIComponent(knowledgeStoreId)}/item-collections/${encodeURIComponent(collectionId)}`),
+                method: "GET",
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.3.0", "User-Agent": "twelvelabs-js/1.3.0", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                contentType: "application/json",
+                requestType: "json",
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 600000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.KnowledgeStoreItemCollection.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new TwelvelabsApi.BadRequestError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.TwelvelabsApiError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.TwelvelabsApiError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.TwelvelabsApiTimeoutError("Timeout exceeded when calling GET /knowledge-stores/{knowledge_store_id}/item-collections/{collection_id}.");
+                case "unknown":
+                    throw new errors.TwelvelabsApiError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Deletes the specified item collection. The items themselves remain in the knowledge store.
+     *
+     * @param {string} knowledgeStoreId - The unique identifier of the knowledge store.
+     * @param {string} collectionId - The unique identifier of the knowledge store item collection.
+     * @param {KnowledgeStoreItemCollections.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TwelvelabsApi.BadRequestError}
+     *
+     * @example
+     *     await client.knowledgeStoreItemCollections.delete("ks_069e9869-1ea3-7481-8000-dae72bf6be6e", "ksic_069e9870-3c4d-7abc-9012-3456789abcde")
+     */
+    delete(knowledgeStoreId, collectionId, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__delete(knowledgeStoreId, collectionId, requestOptions));
+    }
+    __delete(knowledgeStoreId, collectionId, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const _response = yield core.fetcher({
+                url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, `knowledge-stores/${encodeURIComponent(knowledgeStoreId)}/item-collections/${encodeURIComponent(collectionId)}`),
+                method: "DELETE",
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.3.0", "User-Agent": "twelvelabs-js/1.3.0", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                contentType: "application/json",
+                requestType: "json",
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 600000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return { data: undefined, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new TwelvelabsApi.BadRequestError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.TwelvelabsApiError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.TwelvelabsApiError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.TwelvelabsApiTimeoutError("Timeout exceeded when calling DELETE /knowledge-stores/{knowledge_store_id}/item-collections/{collection_id}.");
+                case "unknown":
+                    throw new errors.TwelvelabsApiError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Updates the `name`, `description`, and `metadata` fields of the specified item collection.
+     *
+     * @param {string} knowledgeStoreId - The unique identifier of the knowledge store.
+     * @param {string} collectionId - The unique identifier of the knowledge store item collection.
+     * @param {TwelvelabsApi.KnowledgeStoreItemCollectionsUpdateRequest} request
+     * @param {KnowledgeStoreItemCollections.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TwelvelabsApi.BadRequestError}
+     *
+     * @example
+     *     await client.knowledgeStoreItemCollections.update("ks_069e9869-1ea3-7481-8000-dae72bf6be6e", "ksic_069e9870-3c4d-7abc-9012-3456789abcde")
+     */
+    update(knowledgeStoreId, collectionId, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__update(knowledgeStoreId, collectionId, request, requestOptions));
+    }
+    __update(knowledgeStoreId_1, collectionId_1) {
+        return __awaiter(this, arguments, void 0, function* (knowledgeStoreId, collectionId, request = {}, requestOptions) {
+            var _a, _b;
+            const _response = yield core.fetcher({
+                url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, `knowledge-stores/${encodeURIComponent(knowledgeStoreId)}/item-collections/${encodeURIComponent(collectionId)}`),
+                method: "PATCH",
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.3.0", "User-Agent": "twelvelabs-js/1.3.0", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                contentType: "application/json",
+                requestType: "json",
+                body: serializers.KnowledgeStoreItemCollectionsUpdateRequest.jsonOrThrow(request, {
+                    unrecognizedObjectKeys: "strip",
+                }),
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 600000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.KnowledgeStoreItemCollection.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new TwelvelabsApi.BadRequestError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.TwelvelabsApiError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.TwelvelabsApiError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.TwelvelabsApiTimeoutError("Timeout exceeded when calling PATCH /knowledge-stores/{knowledge_store_id}/item-collections/{collection_id}.");
+                case "unknown":
+                    throw new errors.TwelvelabsApiError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Returns a list of the items in the specified item collection.
+     *
+     * @param {string} knowledgeStoreId - The unique identifier of the knowledge store.
+     * @param {string} collectionId - The unique identifier of the knowledge store item collection.
+     * @param {TwelvelabsApi.KnowledgeStoreItemCollectionsListItemsRequest} request
+     * @param {KnowledgeStoreItemCollections.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TwelvelabsApi.BadRequestError}
+     *
+     * @example
+     *     await client.knowledgeStoreItemCollections.listItems("ks_069e9869-1ea3-7481-8000-dae72bf6be6e", "ksic_069e9870-3c4d-7abc-9012-3456789abcde", {
+     *         page: 1,
+     *         pageLimit: 10
+     *     })
+     */
+    listItems(knowledgeStoreId_1, collectionId_1) {
+        return __awaiter(this, arguments, void 0, function* (knowledgeStoreId, collectionId, request = {}, requestOptions) {
+            const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
+                var _a, _b;
+                const { page, pageLimit } = request;
+                const _queryParams = {};
+                if (page != null) {
+                    _queryParams["page"] = page.toString();
+                }
+                if (pageLimit != null) {
+                    _queryParams["page_limit"] = pageLimit.toString();
+                }
+                const _response = yield core.fetcher({
+                    url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, `knowledge-stores/${encodeURIComponent(knowledgeStoreId)}/item-collections/${encodeURIComponent(collectionId)}/items`),
+                    method: "GET",
+                    headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.3.0", "User-Agent": "twelvelabs-js/1.3.0", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                    contentType: "application/json",
+                    queryParameters: _queryParams,
+                    requestType: "json",
+                    timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 600000,
+                    maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                    abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                });
+                if (_response.ok) {
+                    return {
+                        data: serializers.KnowledgeStoreItemCollectionsListItemsResponse.parseOrThrow(_response.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }),
+                        rawResponse: _response.rawResponse,
+                    };
+                }
+                if (_response.error.reason === "status-code") {
+                    switch (_response.error.statusCode) {
+                        case 400:
+                            throw new TwelvelabsApi.BadRequestError(_response.error.body, _response.rawResponse);
+                        default:
+                            throw new errors.TwelvelabsApiError({
+                                statusCode: _response.error.statusCode,
+                                body: _response.error.body,
+                                rawResponse: _response.rawResponse,
+                            });
+                    }
+                }
+                switch (_response.error.reason) {
+                    case "non-json":
+                        throw new errors.TwelvelabsApiError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.rawBody,
+                            rawResponse: _response.rawResponse,
+                        });
+                    case "timeout":
+                        throw new errors.TwelvelabsApiTimeoutError("Timeout exceeded when calling GET /knowledge-stores/{knowledge_store_id}/item-collections/{collection_id}/items.");
+                    case "unknown":
+                        throw new errors.TwelvelabsApiError({
+                            message: _response.error.errorMessage,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }));
+            let _offset = (request === null || request === void 0 ? void 0 : request.page) != null ? request === null || request === void 0 ? void 0 : request.page : 1;
+            const dataWithRawResponse = yield list(request).withRawResponse();
+            return new core.Pageable({
+                response: dataWithRawResponse.data,
+                rawResponse: dataWithRawResponse.rawResponse,
+                hasNextPage: (response) => { var _a; return ((_a = response === null || response === void 0 ? void 0 : response.data) !== null && _a !== void 0 ? _a : []).length > 0; },
+                getItems: (response) => { var _a; return (_a = response === null || response === void 0 ? void 0 : response.data) !== null && _a !== void 0 ? _a : []; },
+                loadPage: (_response) => {
+                    _offset += 1;
+                    return list(core.setObjectProperty(request, "page", _offset));
+                },
+            });
+        });
+    }
+    /**
+     * Adds one or more items to the specified item collection. This operation is idempotent — items already in the collection are skipped. Every identifier must reference an existing item in the knowledge store.
+     *
+     * @param {string} knowledgeStoreId - The unique identifier of the knowledge store.
+     * @param {string} collectionId - The unique identifier of the knowledge store item collection.
+     * @param {TwelvelabsApi.KnowledgeStoreItemCollectionsAddItemsRequest} request
+     * @param {KnowledgeStoreItemCollections.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TwelvelabsApi.BadRequestError}
+     *
+     * @example
+     *     await client.knowledgeStoreItemCollections.addItems("ks_069e9869-1ea3-7481-8000-dae72bf6be6e", "ksic_069e9870-3c4d-7abc-9012-3456789abcde", {
+     *         itemIds: ["ksi_069e9870-3c4d-7abc-9012-3456789abcde"]
+     *     })
+     */
+    addItems(knowledgeStoreId, collectionId, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__addItems(knowledgeStoreId, collectionId, request, requestOptions));
+    }
+    __addItems(knowledgeStoreId, collectionId, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const _response = yield core.fetcher({
+                url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, `knowledge-stores/${encodeURIComponent(knowledgeStoreId)}/item-collections/${encodeURIComponent(collectionId)}/items/add`),
+                method: "POST",
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.3.0", "User-Agent": "twelvelabs-js/1.3.0", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                contentType: "application/json",
+                requestType: "json",
+                body: serializers.KnowledgeStoreItemCollectionsAddItemsRequest.jsonOrThrow(request, {
+                    unrecognizedObjectKeys: "strip",
+                }),
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 600000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.KnowledgeStoreItemCollection.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new TwelvelabsApi.BadRequestError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.TwelvelabsApiError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.TwelvelabsApiError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.TwelvelabsApiTimeoutError("Timeout exceeded when calling POST /knowledge-stores/{knowledge_store_id}/item-collections/{collection_id}/items/add.");
+                case "unknown":
+                    throw new errors.TwelvelabsApiError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Removes one or more items from the specified item collection. This operation is idempotent — identifiers that do not match a member of the collection are ignored. The items themselves remain in the knowledge store.
+     *
+     * @param {string} knowledgeStoreId - The unique identifier of the knowledge store.
+     * @param {string} collectionId - The unique identifier of the knowledge store item collection.
+     * @param {TwelvelabsApi.KnowledgeStoreItemCollectionsRemoveItemsRequest} request
+     * @param {KnowledgeStoreItemCollections.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TwelvelabsApi.BadRequestError}
+     *
+     * @example
+     *     await client.knowledgeStoreItemCollections.removeItems("ks_069e9869-1ea3-7481-8000-dae72bf6be6e", "ksic_069e9870-3c4d-7abc-9012-3456789abcde", {
+     *         itemIds: ["ksi_069e9870-3c4d-7abc-9012-3456789abcde"]
+     *     })
+     */
+    removeItems(knowledgeStoreId, collectionId, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__removeItems(knowledgeStoreId, collectionId, request, requestOptions));
+    }
+    __removeItems(knowledgeStoreId, collectionId, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const _response = yield core.fetcher({
+                url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, `knowledge-stores/${encodeURIComponent(knowledgeStoreId)}/item-collections/${encodeURIComponent(collectionId)}/items/remove`),
+                method: "POST",
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.3.0", "User-Agent": "twelvelabs-js/1.3.0", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                contentType: "application/json",
+                requestType: "json",
+                body: serializers.KnowledgeStoreItemCollectionsRemoveItemsRequest.jsonOrThrow(request, {
+                    unrecognizedObjectKeys: "strip",
+                }),
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 600000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return { data: undefined, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new TwelvelabsApi.BadRequestError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.TwelvelabsApiError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.TwelvelabsApiError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.TwelvelabsApiTimeoutError("Timeout exceeded when calling POST /knowledge-stores/{knowledge_store_id}/item-collections/{collection_id}/items/remove.");
+                case "unknown":
+                    throw new errors.TwelvelabsApiError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    _getCustomAuthorizationHeaders() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const apiKeyValue = yield core.Supplier.get(this._options.apiKey);
+            return { "x-api-key": apiKeyValue };
+        });
+    }
+}
+exports.KnowledgeStoreItemCollections = KnowledgeStoreItemCollections;