@knowledge-stack/ksapi 1.11.2 → 1.13.0

package/src/apis/TagsApi.ts

@@ -0,0 +1,517 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * The version of the OpenAPI document: 0.1.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+import * as runtime from '../runtime';
+import type {
+  CreateTagRequest,
+  HTTPValidationError,
+  PaginatedResponseTagResponse,
+  TagPathPartRequest,
+  TagResponse,
+  UpdateTagRequest,
+} from '../models/index';
+import {
+    CreateTagRequestFromJSON,
+    CreateTagRequestToJSON,
+    HTTPValidationErrorFromJSON,
+    HTTPValidationErrorToJSON,
+    PaginatedResponseTagResponseFromJSON,
+    PaginatedResponseTagResponseToJSON,
+    TagPathPartRequestFromJSON,
+    TagPathPartRequestToJSON,
+    TagResponseFromJSON,
+    TagResponseToJSON,
+    UpdateTagRequestFromJSON,
+    UpdateTagRequestToJSON,
+} from '../models/index';
+
+export interface AttachTagToPathPartRequest {
+    tagId: string;
+    tagPathPartRequest: TagPathPartRequest;
+    ksUat?: string;
+}
+
+export interface CreateTagOperationRequest {
+    createTagRequest: CreateTagRequest;
+    ksUat?: string;
+}
+
+export interface DeleteTagRequest {
+    tagId: string;
+    ksUat?: string;
+}
+
+export interface DetachTagFromPathPartRequest {
+    tagId: string;
+    pathPartId: string;
+    ksUat?: string;
+}
+
+export interface GetTagRequest {
+    tagId: string;
+    ksUat?: string;
+}
+
+export interface ListTagsRequest {
+    limit?: number;
+    offset?: number;
+    ksUat?: string;
+}
+
+export interface UpdateTagOperationRequest {
+    tagId: string;
+    updateTagRequest: UpdateTagRequest;
+    ksUat?: string;
+}
+
+/**
+ * TagsApi - interface
+ * 
+ * @export
+ * @interface TagsApiInterface
+ */
+export interface TagsApiInterface {
+    /**
+     * Attach a tag to a path part. Requires ADMIN or OWNER role.
+     * @summary Attach Tag Handler
+     * @param {string} tagId 
+     * @param {TagPathPartRequest} tagPathPartRequest 
+     * @param {string} [ksUat] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof TagsApiInterface
+     */
+    attachTagToPathPartRaw(requestParameters: AttachTagToPathPartRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TagResponse>>;
+
+    /**
+     * Attach a tag to a path part. Requires ADMIN or OWNER role.
+     * Attach Tag Handler
+     */
+    attachTagToPathPart(requestParameters: AttachTagToPathPartRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TagResponse>;
+
+    /**
+     * Create a new tag for the current tenant. Requires ADMIN or OWNER role.
+     * @summary Create Tag Handler
+     * @param {CreateTagRequest} createTagRequest 
+     * @param {string} [ksUat] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof TagsApiInterface
+     */
+    createTagRaw(requestParameters: CreateTagOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TagResponse>>;
+
+    /**
+     * Create a new tag for the current tenant. Requires ADMIN or OWNER role.
+     * Create Tag Handler
+     */
+    createTag(requestParameters: CreateTagOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TagResponse>;
+
+    /**
+     * Delete a tag and all its path_part associations. Requires ADMIN or OWNER role.
+     * @summary Delete Tag Handler
+     * @param {string} tagId 
+     * @param {string} [ksUat] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof TagsApiInterface
+     */
+    deleteTagRaw(requestParameters: DeleteTagRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+
+    /**
+     * Delete a tag and all its path_part associations. Requires ADMIN or OWNER role.
+     * Delete Tag Handler
+     */
+    deleteTag(requestParameters: DeleteTagRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+
+    /**
+     * Detach a tag from a path part. Requires ADMIN or OWNER role.
+     * @summary Detach Tag Handler
+     * @param {string} tagId 
+     * @param {string} pathPartId 
+     * @param {string} [ksUat] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof TagsApiInterface
+     */
+    detachTagFromPathPartRaw(requestParameters: DetachTagFromPathPartRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+
+    /**
+     * Detach a tag from a path part. Requires ADMIN or OWNER role.
+     * Detach Tag Handler
+     */
+    detachTagFromPathPart(requestParameters: DetachTagFromPathPartRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+
+    /**
+     * Get a tag by its ID.
+     * @summary Get Tag Handler
+     * @param {string} tagId 
+     * @param {string} [ksUat] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof TagsApiInterface
+     */
+    getTagRaw(requestParameters: GetTagRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TagResponse>>;
+
+    /**
+     * Get a tag by its ID.
+     * Get Tag Handler
+     */
+    getTag(requestParameters: GetTagRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TagResponse>;
+
+    /**
+     * List all tags for the current tenant.
+     * @summary List Tags Handler
+     * @param {number} [limit] Number of items per page
+     * @param {number} [offset] Number of items to skip
+     * @param {string} [ksUat] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof TagsApiInterface
+     */
+    listTagsRaw(requestParameters: ListTagsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseTagResponse>>;
+
+    /**
+     * List all tags for the current tenant.
+     * List Tags Handler
+     */
+    listTags(requestParameters: ListTagsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseTagResponse>;
+
+    /**
+     * Update a tag (name, color, and/or description). Requires ADMIN or OWNER role.
+     * @summary Update Tag Handler
+     * @param {string} tagId 
+     * @param {UpdateTagRequest} updateTagRequest 
+     * @param {string} [ksUat] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof TagsApiInterface
+     */
+    updateTagRaw(requestParameters: UpdateTagOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TagResponse>>;
+
+    /**
+     * Update a tag (name, color, and/or description). Requires ADMIN or OWNER role.
+     * Update Tag Handler
+     */
+    updateTag(requestParameters: UpdateTagOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TagResponse>;
+
+}
+
+/**
+ * 
+ */
+export class TagsApi extends runtime.BaseAPI implements TagsApiInterface {
+
+    /**
+     * Attach a tag to a path part. Requires ADMIN or OWNER role.
+     * Attach Tag Handler
+     */
+    async attachTagToPathPartRaw(requestParameters: AttachTagToPathPartRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TagResponse>> {
+        if (requestParameters['tagId'] == null) {
+            throw new runtime.RequiredError(
+                'tagId',
+                'Required parameter "tagId" was null or undefined when calling attachTagToPathPart().'
+            );
+        }
+
+        if (requestParameters['tagPathPartRequest'] == null) {
+            throw new runtime.RequiredError(
+                'tagPathPartRequest',
+                'Required parameter "tagPathPartRequest" was null or undefined when calling attachTagToPathPart().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+
+        let urlPath = `/v1/tags/{tag_id}/path-parts`;
+        urlPath = urlPath.replace(`{${"tag_id"}}`, encodeURIComponent(String(requestParameters['tagId'])));
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: TagPathPartRequestToJSON(requestParameters['tagPathPartRequest']),
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => TagResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Attach a tag to a path part. Requires ADMIN or OWNER role.
+     * Attach Tag Handler
+     */
+    async attachTagToPathPart(requestParameters: AttachTagToPathPartRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TagResponse> {
+        const response = await this.attachTagToPathPartRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Create a new tag for the current tenant. Requires ADMIN or OWNER role.
+     * Create Tag Handler
+     */
+    async createTagRaw(requestParameters: CreateTagOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TagResponse>> {
+        if (requestParameters['createTagRequest'] == null) {
+            throw new runtime.RequiredError(
+                'createTagRequest',
+                'Required parameter "createTagRequest" was null or undefined when calling createTag().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+
+        let urlPath = `/v1/tags`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: CreateTagRequestToJSON(requestParameters['createTagRequest']),
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => TagResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Create a new tag for the current tenant. Requires ADMIN or OWNER role.
+     * Create Tag Handler
+     */
+    async createTag(requestParameters: CreateTagOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TagResponse> {
+        const response = await this.createTagRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Delete a tag and all its path_part associations. Requires ADMIN or OWNER role.
+     * Delete Tag Handler
+     */
+    async deleteTagRaw(requestParameters: DeleteTagRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>> {
+        if (requestParameters['tagId'] == null) {
+            throw new runtime.RequiredError(
+                'tagId',
+                'Required parameter "tagId" was null or undefined when calling deleteTag().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/v1/tags/{tag_id}`;
+        urlPath = urlPath.replace(`{${"tag_id"}}`, encodeURIComponent(String(requestParameters['tagId'])));
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'DELETE',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.VoidApiResponse(response);
+    }
+
+    /**
+     * Delete a tag and all its path_part associations. Requires ADMIN or OWNER role.
+     * Delete Tag Handler
+     */
+    async deleteTag(requestParameters: DeleteTagRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void> {
+        await this.deleteTagRaw(requestParameters, initOverrides);
+    }
+
+    /**
+     * Detach a tag from a path part. Requires ADMIN or OWNER role.
+     * Detach Tag Handler
+     */
+    async detachTagFromPathPartRaw(requestParameters: DetachTagFromPathPartRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>> {
+        if (requestParameters['tagId'] == null) {
+            throw new runtime.RequiredError(
+                'tagId',
+                'Required parameter "tagId" was null or undefined when calling detachTagFromPathPart().'
+            );
+        }
+
+        if (requestParameters['pathPartId'] == null) {
+            throw new runtime.RequiredError(
+                'pathPartId',
+                'Required parameter "pathPartId" was null or undefined when calling detachTagFromPathPart().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/v1/tags/{tag_id}/path-parts/{path_part_id}`;
+        urlPath = urlPath.replace(`{${"tag_id"}}`, encodeURIComponent(String(requestParameters['tagId'])));
+        urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'DELETE',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.VoidApiResponse(response);
+    }
+
+    /**
+     * Detach a tag from a path part. Requires ADMIN or OWNER role.
+     * Detach Tag Handler
+     */
+    async detachTagFromPathPart(requestParameters: DetachTagFromPathPartRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void> {
+        await this.detachTagFromPathPartRaw(requestParameters, initOverrides);
+    }
+
+    /**
+     * Get a tag by its ID.
+     * Get Tag Handler
+     */
+    async getTagRaw(requestParameters: GetTagRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TagResponse>> {
+        if (requestParameters['tagId'] == null) {
+            throw new runtime.RequiredError(
+                'tagId',
+                'Required parameter "tagId" was null or undefined when calling getTag().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/v1/tags/{tag_id}`;
+        urlPath = urlPath.replace(`{${"tag_id"}}`, encodeURIComponent(String(requestParameters['tagId'])));
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => TagResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Get a tag by its ID.
+     * Get Tag Handler
+     */
+    async getTag(requestParameters: GetTagRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TagResponse> {
+        const response = await this.getTagRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * List all tags for the current tenant.
+     * List Tags Handler
+     */
+    async listTagsRaw(requestParameters: ListTagsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseTagResponse>> {
+        const queryParameters: any = {};
+
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+
+        if (requestParameters['offset'] != null) {
+            queryParameters['offset'] = requestParameters['offset'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/v1/tags`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseTagResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * List all tags for the current tenant.
+     * List Tags Handler
+     */
+    async listTags(requestParameters: ListTagsRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseTagResponse> {
+        const response = await this.listTagsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Update a tag (name, color, and/or description). Requires ADMIN or OWNER role.
+     * Update Tag Handler
+     */
+    async updateTagRaw(requestParameters: UpdateTagOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TagResponse>> {
+        if (requestParameters['tagId'] == null) {
+            throw new runtime.RequiredError(
+                'tagId',
+                'Required parameter "tagId" was null or undefined when calling updateTag().'
+            );
+        }
+
+        if (requestParameters['updateTagRequest'] == null) {
+            throw new runtime.RequiredError(
+                'updateTagRequest',
+                'Required parameter "updateTagRequest" was null or undefined when calling updateTag().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+
+        let urlPath = `/v1/tags/{tag_id}`;
+        urlPath = urlPath.replace(`{${"tag_id"}}`, encodeURIComponent(String(requestParameters['tagId'])));
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'PATCH',
+            headers: headerParameters,
+            query: queryParameters,
+            body: UpdateTagRequestToJSON(requestParameters['updateTagRequest']),
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => TagResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Update a tag (name, color, and/or description). Requires ADMIN or OWNER role.
+     * Update Tag Handler
+     */
+    async updateTag(requestParameters: UpdateTagOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TagResponse> {
+        const response = await this.updateTagRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}

package/src/apis/ThreadsApi.ts

@@ -87,7 +87,7 @@ export interface ThreadsApiInterface {
     createThread(requestParameters: CreateThreadOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ThreadResponse>;
 
     /**
-     * Delete a thread.  Authorization: only conversation threads belonging to the current user (under /users/{user_id}/threads/) can be deleted.
+     * Delete a thread.  Authorization: only conversation threads belonging to the current user (under /users/{user_id}/threads/) can be deleted. Asset threads (attached to documents/sections) are never deletable via this endpoint.
      * @summary Delete Thread Handler
      * @param {string} threadId 
      * @param {string} [ksUat] 
@@ -98,7 +98,7 @@ export interface ThreadsApiInterface {
     deleteThreadRaw(requestParameters: DeleteThreadRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
 
     /**
-     * Delete a thread.  Authorization: only conversation threads belonging to the current user (under /users/{user_id}/threads/) can be deleted.
+     * Delete a thread.  Authorization: only conversation threads belonging to the current user (under /users/{user_id}/threads/) can be deleted. Asset threads (attached to documents/sections) are never deletable via this endpoint.
      * Delete Thread Handler
      */
     deleteThread(requestParameters: DeleteThreadRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
@@ -206,7 +206,7 @@ export class ThreadsApi extends runtime.BaseAPI implements ThreadsApiInterface {
     }
 
     /**
-     * Delete a thread.  Authorization: only conversation threads belonging to the current user (under /users/{user_id}/threads/) can be deleted.
+     * Delete a thread.  Authorization: only conversation threads belonging to the current user (under /users/{user_id}/threads/) can be deleted. Asset threads (attached to documents/sections) are never deletable via this endpoint.
      * Delete Thread Handler
      */
     async deleteThreadRaw(requestParameters: DeleteThreadRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>> {
@@ -236,7 +236,7 @@ export class ThreadsApi extends runtime.BaseAPI implements ThreadsApiInterface {
     }
 
     /**
-     * Delete a thread.  Authorization: only conversation threads belonging to the current user (under /users/{user_id}/threads/) can be deleted.
+     * Delete a thread.  Authorization: only conversation threads belonging to the current user (under /users/{user_id}/threads/) can be deleted. Asset threads (attached to documents/sections) are never deletable via this endpoint.
      * Delete Thread Handler
      */
     async deleteThread(requestParameters: DeleteThreadRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void> {