@toothfairyai/sdk 0.1.0-beta.1

package/dist/client.js

@@ -0,0 +1,126 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToothFairyClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const types_1 = require("./types");
+const ChatManager_1 = require("./chat/ChatManager");
+const DocumentManager_1 = require("./documents/DocumentManager");
+const EntityManager_1 = require("./entities/EntityManager");
+const FolderManager_1 = require("./folders/FolderManager");
+const PromptManager_1 = require("./prompts/PromptManager");
+const StreamingManager_1 = require("./streaming/StreamingManager");
+class ToothFairyClient {
+    constructor(config) {
+        this.config = {
+            baseUrl: 'https://api.toothfairyai.com',
+            aiUrl: 'https://ai.toothfairyai.com',
+            aiStreamUrl: 'https://ai-stream.toothfairyai.com',
+            timeout: 120000,
+            ...config
+        };
+        if (!this.config.apiKey) {
+            throw new types_1.ToothFairyError('API key is required', 'MISSING_API_KEY');
+        }
+        if (!this.config.workspaceId) {
+            throw new types_1.ToothFairyError('Workspace ID is required', 'MISSING_WORKSPACE_ID');
+        }
+        this.httpClient = axios_1.default.create({
+            timeout: this.config.timeout,
+            headers: {
+                'Content-Type': 'application/json',
+                'x-api-key': this.config.apiKey,
+            },
+        });
+        this.httpClient.interceptors.request.use((config) => {
+            if (config.method === 'post' || config.method === 'put') {
+                if (config.data && typeof config.data === 'object') {
+                    config.data = { workspaceid: this.config.workspaceId, ...config.data };
+                }
+            }
+            else if (config.method === 'get' && config.params) {
+                config.params = { workspaceid: this.config.workspaceId, ...config.params };
+            }
+            return config;
+        });
+        this.httpClient.interceptors.response.use((response) => response, (error) => {
+            if (error.response) {
+                throw new types_1.ToothFairyError(error.response.data?.message || 'API request failed', 'API_ERROR', error.response.status, error.response.data);
+            }
+            else if (error.request) {
+                throw new types_1.ToothFairyError('Network error - please check your connection', 'NETWORK_ERROR');
+            }
+            else {
+                throw new types_1.ToothFairyError(error.message || 'Unknown error occurred', 'UNKNOWN_ERROR');
+            }
+        });
+        this.chat = new ChatManager_1.ChatManager(this);
+        this.documents = new DocumentManager_1.DocumentManager(this);
+        this.entities = new EntityManager_1.EntityManager(this);
+        this.folders = new FolderManager_1.FolderManager(this);
+        this.prompts = new PromptManager_1.PromptManager(this);
+        this.streaming = new StreamingManager_1.StreamingManager(this);
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    getWorkspaceId() {
+        return this.config.workspaceId;
+    }
+    async request(method, endpoint, data, config) {
+        const url = `${this.config.baseUrl}/${endpoint}`;
+        const requestConfig = {
+            method,
+            url,
+            ...(data && { data }),
+            ...config,
+        };
+        const response = await this.httpClient(requestConfig);
+        return response.data;
+    }
+    async aiRequest(method, endpoint, data, config) {
+        const url = `${this.config.aiUrl}/${endpoint}`;
+        const requestConfig = {
+            method,
+            url,
+            ...(data && { data }),
+            ...config,
+        };
+        if (data && typeof data === 'object') {
+            requestConfig.data = { workspaceid: this.config.workspaceId, ...data };
+        }
+        const response = await this.httpClient(requestConfig);
+        return response.data;
+    }
+    getStreamingUrl(endpoint) {
+        return `${this.config.aiStreamUrl}/${endpoint}`;
+    }
+    async testConnection() {
+        try {
+            await this.chat.list();
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    async getHealth() {
+        try {
+            const response = await this.request('GET', 'health');
+            return {
+                status: response.status || 'unknown',
+                timestamp: new Date().toISOString()
+            };
+        }
+        catch (error) {
+            return {
+                status: 'error',
+                timestamp: new Date().toISOString()
+            };
+        }
+    }
+}
+exports.ToothFairyClient = ToothFairyClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/documents/DocumentManager.d.ts

@@ -0,0 +1,34 @@
+import { Document, DocumentCreateData, DocumentUpdateData, FileUploadOptions, FileUploadResult, FileDownloadOptions, FileDownloadResult } from '../types';
+import { IToothFairyClient } from '../client';
+export declare class DocumentManager {
+    private client;
+    constructor(client: IToothFairyClient);
+    create(documentData: DocumentCreateData): Promise<Document>;
+    createFromPath(filePath: string, userId: string, options?: {
+        title?: string;
+        folderId?: string;
+        topics?: string[];
+        status?: string;
+        scope?: string;
+    }): Promise<Document>;
+    update(documentId: string, userId: string, fields: DocumentUpdateData): Promise<Document>;
+    get(documentId: string): Promise<Document>;
+    delete(documentId: string): Promise<{
+        success: boolean;
+    }>;
+    search(text: string, options?: {
+        topK?: number;
+        metadata?: Record<string, any>;
+    }): Promise<any[]>;
+    upload(filePath: string, options?: FileUploadOptions): Promise<FileUploadResult>;
+    download(filename: string, outputPath: string, options?: FileDownloadOptions): Promise<FileDownloadResult>;
+    private getUploadUrl;
+    private getDownloadUrl;
+    private sanitizeFilename;
+    private getImportType;
+    private getContentType;
+    private getDocumentType;
+    private getExternalPath;
+    private getTitleFromPath;
+}
+//# sourceMappingURL=DocumentManager.d.ts.map

package/dist/documents/DocumentManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentManager.d.ts","sourceRoot":"","sources":["../../src/documents/DocumentManager.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,kBAAkB,EAGlB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAGnB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AA+B9C,qBAAa,eAAe;IACd,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,iBAAiB;IAQvC,MAAM,CAAC,YAAY,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmB3D,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KACX,GACL,OAAO,CAAC,QAAQ,CAAC;IAgCd,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmBzF,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAU1C,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAWzD,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC3B,GACL,OAAO,CAAC,GAAG,EAAE,CAAC;IAuBX,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmGpF,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC;YA2DhB,YAAY;YAaZ,cAAc;IAe5B,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,cAAc;IA2CtB,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,gBAAgB;CAMzB"}

package/dist/documents/DocumentManager.js

@@ -0,0 +1,268 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentManager = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const axios_1 = __importDefault(require("axios"));
+class DocumentManager {
+    constructor(client) {
+        this.client = client;
+    }
+    async create(documentData) {
+        const payload = {
+            data: [{
+                    ...documentData,
+                    workspaceid: this.client.getWorkspaceId()
+                }]
+        };
+        return this.client.request('POST', 'doc/create', payload);
+    }
+    async createFromPath(filePath, userId, options = {}) {
+        const { title = this.getTitleFromPath(filePath), folderId = 'mrcRoot', topics = [], status = 'published', scope = undefined } = options;
+        const documentData = {
+            userid: userId,
+            type: this.getDocumentType(filePath),
+            title,
+            topics,
+            folderid: folderId,
+            external_path: this.getExternalPath(filePath),
+            source: 'api',
+            status,
+            ...(scope && { scope })
+        };
+        return this.create(documentData);
+    }
+    async update(documentId, userId, fields) {
+        const updateData = {
+            fields: {
+                workspaceid: this.client.getWorkspaceId(),
+                userid: userId,
+                id: documentId,
+                ...fields
+            }
+        };
+        return this.client.request('POST', 'doc/update', updateData);
+    }
+    async get(documentId) {
+        return this.client.request('GET', `doc/get/${documentId}`);
+    }
+    async delete(documentId) {
+        return this.client.request('DELETE', `doc/delete/${documentId}`);
+    }
+    async search(text, options = {}) {
+        const { topK = 10, metadata } = options;
+        if (topK < 1 || topK > 50) {
+            throw new Error('topK must be between 1 and 50');
+        }
+        const searchData = {
+            text,
+            topK,
+            ...(metadata && { metadata })
+        };
+        return this.client.aiRequest('POST', 'searcher', searchData);
+    }
+    async upload(filePath, options = {}) {
+        const { importType, contentType, onProgress } = options;
+        try {
+            await fs_1.promises.access(filePath);
+        }
+        catch (error) {
+            throw new Error(`File not found: ${filePath}`);
+        }
+        const stats = await fs_1.promises.stat(filePath);
+        const fileSizeInMB = stats.size / (1024 * 1024);
+        if (fileSizeInMB > 15) {
+            throw new Error(`File size (${fileSizeInMB.toFixed(2)}MB) exceeds 15MB limit`);
+        }
+        const originalFilename = (0, path_1.basename)(filePath);
+        const sanitizedFilename = this.sanitizeFilename(originalFilename);
+        const finalImportType = importType || this.getImportType(filePath);
+        const finalContentType = contentType || this.getContentType(filePath);
+        const fullFilename = `${this.client.getWorkspaceId()}/${sanitizedFilename}`;
+        const uploadData = await this.getUploadUrl(fullFilename, finalImportType, finalContentType);
+        let parsedUploadData;
+        if (uploadData.body && typeof uploadData.body === 'string') {
+            try {
+                parsedUploadData = JSON.parse(uploadData.body);
+            }
+            catch (error) {
+                throw new Error(`Failed to parse upload response: ${error.message}`);
+            }
+        }
+        else {
+            parsedUploadData = uploadData;
+        }
+        if (!parsedUploadData.uploadURL) {
+            throw new Error('Failed to get upload URL from server');
+        }
+        const fileData = await fs_1.promises.readFile(filePath);
+        const uploadConfig = {
+            method: 'PUT',
+            url: parsedUploadData.uploadURL,
+            data: fileData,
+            headers: {
+                'Content-Type': finalContentType,
+            },
+            maxContentLength: Infinity,
+            maxBodyLength: Infinity,
+            onUploadProgress: onProgress ? (progressEvent) => {
+                const percentCompleted = Math.round((progressEvent.loaded * 100) / progressEvent.total);
+                onProgress(percentCompleted, progressEvent.loaded, progressEvent.total);
+            } : undefined,
+        };
+        await (0, axios_1.default)(uploadConfig);
+        let downloadFilename = fullFilename;
+        if (parsedUploadData.filePath) {
+            downloadFilename = parsedUploadData.filePath.replace(/^s3:\/\/[^/]+\//, '');
+        }
+        return {
+            success: true,
+            originalFilename,
+            sanitizedFilename,
+            filename: downloadFilename,
+            importType: finalImportType,
+            contentType: finalContentType,
+            size: stats.size,
+            sizeInMB: fileSizeInMB,
+        };
+    }
+    async download(filename, outputPath, options = {}) {
+        const { context = 'pdf', onProgress } = options;
+        const downloadData = await this.getDownloadUrl(filename, context);
+        if (!downloadData.url) {
+            throw new Error('Failed to get download URL from server');
+        }
+        const outputDir = (0, path_1.dirname)(outputPath);
+        await fs_1.promises.mkdir(outputDir, { recursive: true });
+        const downloadConfig = {
+            method: 'GET',
+            url: downloadData.url,
+            responseType: 'stream',
+            onDownloadProgress: onProgress ? (progressEvent) => {
+                if (progressEvent.total) {
+                    const percentCompleted = Math.round((progressEvent.loaded * 100) / progressEvent.total);
+                    onProgress(percentCompleted, progressEvent.loaded, progressEvent.total);
+                }
+            } : undefined,
+        };
+        const response = await (0, axios_1.default)(downloadConfig);
+        return new Promise((resolve, reject) => {
+            const writeStream = require('fs').createWriteStream(outputPath);
+            response.data.pipe(writeStream);
+            writeStream.on('finish', async () => {
+                try {
+                    const stats = await fs_1.promises.stat(outputPath);
+                    resolve({
+                        success: true,
+                        outputPath,
+                        size: stats.size,
+                        sizeInMB: (stats.size / (1024 * 1024)).toFixed(2),
+                    });
+                }
+                catch (error) {
+                    reject(error);
+                }
+            });
+            writeStream.on('error', reject);
+        });
+    }
+    async getUploadUrl(filename, importType, contentType) {
+        const params = new URLSearchParams({ filename });
+        if (importType)
+            params.append('importType', importType);
+        if (contentType)
+            params.append('contentType', contentType);
+        return this.client.request('GET', `documents/requestPreSignedURL?${params.toString()}`);
+    }
+    async getDownloadUrl(filename, context) {
+        const params = new URLSearchParams({
+            filename,
+            context,
+            workspaceid: this.client.getWorkspaceId()
+        });
+        return this.client.request('GET', `documents/requestDownloadURLIncognito?${params.toString()}`);
+    }
+    sanitizeFilename(filename) {
+        let sanitized = filename.replace(/[^a-zA-Z0-9.]/g, '');
+        if (sanitized.length > 100) {
+            throw new Error('File name cannot be more than 100 characters.');
+        }
+        return String(Date.now()) + sanitized;
+    }
+    getImportType(filePath) {
+        const ext = (0, path_1.extname)(filePath).toLowerCase().slice(1);
+        const imageExts = ['png', 'jpg', 'jpeg', 'gif', 'bmp', 'svg'];
+        const videoExts = ['mp4', 'avi', 'mov', 'wmv', 'flv', 'webm'];
+        const audioExts = ['wav', 'mp3', 'aac', 'ogg', 'flac'];
+        if (imageExts.includes(ext))
+            return 'imported-image';
+        if (videoExts.includes(ext))
+            return 'imported_video_files';
+        if (audioExts.includes(ext))
+            return 'imported_audio_files';
+        return 'imported_doc_files';
+    }
+    getContentType(filePath) {
+        const ext = (0, path_1.extname)(filePath).toLowerCase().slice(1);
+        const contentTypes = {
+            txt: 'text/plain',
+            md: 'text/markdown',
+            html: 'text/html',
+            pdf: 'application/pdf',
+            json: 'application/json',
+            jsonl: 'application/json',
+            wav: 'audio/wav',
+            mp4: 'video/mp4',
+            png: 'image/png',
+            jpg: 'image/jpeg',
+            jpeg: 'image/jpeg',
+            csv: 'text/csv',
+            docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+            xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+            pptx: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+            ppt: 'application/vnd.ms-powerpoint',
+            java: 'text/plain',
+            py: 'text/plain',
+            js: 'text/plain',
+            ts: 'text/plain',
+            tsx: 'text/plain',
+            jsx: 'text/plain',
+            yaml: 'text/plain',
+            yml: 'text/plain',
+            sql: 'text/plain',
+            sh: 'text/plain',
+            php: 'text/plain',
+            csharp: 'text/plain',
+            rb: 'text/plain',
+        };
+        return contentTypes[ext] || 'application/octet-stream';
+    }
+    getDocumentType(filePath) {
+        if (filePath.startsWith('http://') || filePath.startsWith('https://')) {
+            return 'readComprehensionUrl';
+        }
+        const ext = (0, path_1.extname)(filePath).toLowerCase().slice(1);
+        if (ext === 'pdf') {
+            return 'readComprehensionPdf';
+        }
+        return 'readComprehensionFile';
+    }
+    getExternalPath(filePath) {
+        if (filePath.startsWith('http://') || filePath.startsWith('https://')) {
+            return filePath;
+        }
+        const filename = (0, path_1.basename)(filePath);
+        return `s3://files-to-import-aus-prod/imported-pdf/${filename}`;
+    }
+    getTitleFromPath(filePath) {
+        if (filePath.startsWith('http://') || filePath.startsWith('https://')) {
+            return filePath;
+        }
+        return (0, path_1.basename)(filePath);
+    }
+}
+exports.DocumentManager = DocumentManager;
+//# sourceMappingURL=DocumentManager.js.map

package/dist/documents/DocumentManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentManager.js","sourceRoot":"","sources":["../../src/documents/DocumentManager.ts"],"names":[],"mappings":";;;;;;AAAA,2BAAoC;AACpC,+BAAkD;AAClD,kDAA0B;AA6C1B,MAAa,eAAe;IAC1B,YAAoB,MAAyB;QAAzB,WAAM,GAAN,MAAM,CAAmB;IAAG,CAAC;IAQjD,KAAK,CAAC,MAAM,CAAC,YAAgC;QAC3C,MAAM,OAAO,GAAG;YACd,IAAI,EAAE,CAAC;oBACL,GAAG,YAAY;oBACf,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE;iBAC1C,CAAC;SACH,CAAC;QAEF,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAW,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAUD,KAAK,CAAC,cAAc,CAClB,QAAgB,EAChB,MAAc,EACd,UAMI,EAAE;QAEN,MAAM,EACJ,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EACvC,QAAQ,GAAG,SAAS,EACpB,MAAM,GAAG,EAAE,EACX,MAAM,GAAG,WAAW,EACpB,KAAK,GAAG,SAAS,EAClB,GAAG,OAAO,CAAC;QAEZ,MAAM,YAAY,GAAuB;YACvC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC;YACpC,KAAK;YACL,MAAM;YACN,QAAQ,EAAE,QAAQ;YAClB,aAAa,EAAE,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC;YAC7C,MAAM,EAAE,KAAK;YACb,MAAM;YACN,GAAG,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,CAAC;SACxB,CAAC;QAEF,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACnC,CAAC;IAUD,KAAK,CAAC,MAAM,CAAC,UAAkB,EAAE,MAAc,EAAE,MAA0B;QACzE,MAAM,UAAU,GAAG;YACjB,MAAM,EAAE;gBACN,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE;gBACzC,MAAM,EAAE,MAAM;gBACd,EAAE,EAAE,UAAU;gBACd,GAAG,MAAM;aACV;SACF,CAAC;QAEF,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAW,MAAM,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;IACzE,CAAC;IAQD,KAAK,CAAC,GAAG,CAAC,UAAkB;QAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAW,KAAK,EAAE,WAAW,UAAU,EAAE,CAAC,CAAC;IACvE,CAAC;IAQD,KAAK,CAAC,MAAM,CAAC,UAAkB;QAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAuB,QAAQ,EAAE,cAAc,UAAU,EAAE,CAAC,CAAC;IACzF,CAAC;IASD,KAAK,CAAC,MAAM,CACV,IAAY,EACZ,UAGI,EAAE;QAEN,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QAExC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,EAAE,EAAE;YACzB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;SAClD;QAED,MAAM,UAAU,GAA0B;YACxC,IAAI;YACJ,IAAI;YACJ,GAAG,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,CAAC;SAC9B,CAAC;QAEF,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IAC/D,CAAC;IASD,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,UAA6B,EAAE;QAC5D,MAAM,EACJ,UAAU,EACV,WAAW,EACX,UAAU,EACX,GAAG,OAAO,CAAC;QAGZ,IAAI;YACF,MAAM,aAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;SAC3B;QAAC,OAAO,KAAK,EAAE;YACd,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;SAChD;QAED,MAAM,KAAK,GAAG,MAAM,aAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QAGhD,IAAI,YAAY,GAAG,EAAE,EAAE;YACrB,MAAM,IAAI,KAAK,CACb,cAAc,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAC9D,CAAC;SACH;QAGD,MAAM,gBAAgB,GAAG,IAAA,eAAQ,EAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;QAClE,MAAM,eAAe,GAAG,UAAU,IAAI,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACnE,MAAM,gBAAgB,GAAG,WAAW,IAAI,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAGtE,MAAM,YAAY,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,IAAI,iBAAiB,EAAE,CAAC;QAG5E,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,eAAe,EAAE,gBAAgB,CAAC,CAAC;QAE5F,IAAI,gBAAgB,CAAC;QACrB,IAAI,UAAU,CAAC,IAAI,IAAI,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE;YAC1D,IAAI;gBACF,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;aAChD;YAAC,OAAO,KAAK,EAAE;gBACd,MAAM,IAAI,KAAK,CAAC,oCAAqC,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;aACjF;SACF;aAAM;YACL,gBAAgB,GAAG,UAAU,CAAC;SAC/B;QAED,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE;YAC/B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;SACzD;QAGD,MAAM,QAAQ,GAAG,MAAM,aAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAE7C,MAAM,YAAY,GAAG;YACnB,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,gBAAgB,CAAC,SAAS;YAC/B,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,gBAAgB;aACjC;YACD,gBAAgB,EAAE,QAAQ;YAC1B,aAAa,EAAE,QAAQ;YACvB,gBAAgB,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,aAAkB,EAAE,EAAE;gBACpD,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CACjC,CAAC,aAAa,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,aAAa,CAAC,KAAK,CACnD,CAAC;gBACF,UAAU,CAAC,gBAAgB,EAAE,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;YAC1E,CAAC,CAAC,CAAC,CAAC,SAAS;SACd,CAAC;QAEF,MAAM,IAAA,eAAK,EAAC,YAAY,CAAC,CAAC;QAG1B,IAAI,gBAAgB,GAAG,YAAY,CAAC;QACpC,IAAI,gBAAgB,CAAC,QAAQ,EAAE;YAC7B,gBAAgB,GAAG,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;SAC7E;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,gBAAgB;YAChB,iBAAiB;YACjB,QAAQ,EAAE,gBAAgB;YAC1B,UAAU,EAAE,eAAe;YAC3B,WAAW,EAAE,gBAAgB;YAC7B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,YAAY;SACvB,CAAC;IACJ,CAAC;IAUD,KAAK,CAAC,QAAQ,CACZ,QAAgB,EAChB,UAAkB,EAClB,UAA+B,EAAE;QAEjC,MAAM,EAAE,OAAO,GAAG,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QAGhD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAElE,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE;YACrB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;SAC3D;QAGD,MAAM,SAAS,GAAG,IAAA,cAAO,EAAC,UAAU,CAAC,CAAC;QACtC,MAAM,aAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAG/C,MAAM,cAAc,GAAG;YACrB,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,YAAY,CAAC,GAAG;YACrB,YAAY,EAAE,QAAiB;YAC/B,kBAAkB,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,aAAkB,EAAE,EAAE;gBACtD,IAAI,aAAa,CAAC,KAAK,EAAE;oBACvB,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CACjC,CAAC,aAAa,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,aAAa,CAAC,KAAK,CACnD,CAAC;oBACF,UAAU,CAAC,gBAAgB,EAAE,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;iBACzE;YACH,CAAC,CAAC,CAAC,CAAC,SAAS;SACd,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAA,eAAK,EAAC,cAAc,CAAC,CAAC;QAG7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;YAChE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAEhC,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;gBAClC,IAAI;oBACF,MAAM,KAAK,GAAG,MAAM,aAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;oBACxC,OAAO,CAAC;wBACN,OAAO,EAAE,IAAI;wBACb,UAAU;wBACV,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,QAAQ,EAAE,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;qBAClD,CAAC,CAAC;iBACJ;gBAAC,OAAO,KAAK,EAAE;oBACd,MAAM,CAAC,KAAK,CAAC,CAAC;iBACf;YACH,CAAC,CAAC,CAAC;YAEH,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC;IAOO,KAAK,CAAC,YAAY,CAAC,QAAgB,EAAE,UAAmB,EAAE,WAAoB;QACpF,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QACjD,IAAI,UAAU;YAAE,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QACxD,IAAI,WAAW;YAAE,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;QAE3D,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,iCAAiC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC1F,CAAC;IAOO,KAAK,CAAC,cAAc,CAAC,QAAgB,EAAE,OAAe;QAC5D,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;YACjC,QAAQ;YACR,OAAO;YACP,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE;SAC1C,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,yCAAyC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAClG,CAAC;IAOO,gBAAgB,CAAC,QAAgB;QACvC,IAAI,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;QAEvD,IAAI,SAAS,CAAC,MAAM,GAAG,GAAG,EAAE;YAC1B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;SAClE;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,SAAS,CAAC;IACxC,CAAC;IAOO,aAAa,CAAC,QAAgB;QACpC,MAAM,GAAG,GAAG,IAAA,cAAO,EAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAErD,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAC9D,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAC9D,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAEvD,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,gBAAgB,CAAC;QACrD,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,sBAAsB,CAAC;QAC3D,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,sBAAsB,CAAC;QAC3D,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAOO,cAAc,CAAC,QAAgB;QACrC,MAAM,GAAG,GAAG,IAAA,cAAO,EAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAErD,MAAM,YAAY,GAA2B;YAC3C,GAAG,EAAE,YAAY;YACjB,EAAE,EAAE,eAAe;YACnB,IAAI,EAAE,WAAW;YACjB,GAAG,EAAE,iBAAiB;YACtB,IAAI,EAAE,kBAAkB;YACxB,KAAK,EAAE,kBAAkB;YACzB,GAAG,EAAE,WAAW;YAChB,GAAG,EAAE,WAAW;YAChB,GAAG,EAAE,WAAW;YAChB,GAAG,EAAE,YAAY;YACjB,IAAI,EAAE,YAAY;YAClB,GAAG,EAAE,UAAU;YACf,IAAI,EAAE,yEAAyE;YAC/E,IAAI,EAAE,mEAAmE;YACzE,IAAI,EAAE,2EAA2E;YACjF,GAAG,EAAE,+BAA+B;YACpC,IAAI,EAAE,YAAY;YAClB,EAAE,EAAE,YAAY;YAChB,EAAE,EAAE,YAAY;YAChB,EAAE,EAAE,YAAY;YAChB,GAAG,EAAE,YAAY;YACjB,GAAG,EAAE,YAAY;YACjB,IAAI,EAAE,YAAY;YAClB,GAAG,EAAE,YAAY;YACjB,GAAG,EAAE,YAAY;YACjB,EAAE,EAAE,YAAY;YAChB,GAAG,EAAE,YAAY;YACjB,MAAM,EAAE,YAAY;YACpB,EAAE,EAAE,YAAY;SACjB,CAAC;QAEF,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,0BAA0B,CAAC;IACzD,CAAC;IAOO,eAAe,CAAC,QAAgB;QACtC,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;YACrE,OAAO,sBAAsB,CAAC;SAC/B;QAED,MAAM,GAAG,GAAG,IAAA,cAAO,EAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrD,IAAI,GAAG,KAAK,KAAK,EAAE;YACjB,OAAO,sBAAsB,CAAC;SAC/B;QAED,OAAO,uBAAuB,CAAC;IACjC,CAAC;IAOO,eAAe,CAAC,QAAgB;QACtC,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;YACrE,OAAO,QAAQ,CAAC;SACjB;QAED,MAAM,QAAQ,GAAG,IAAA,eAAQ,EAAC,QAAQ,CAAC,CAAC;QACpC,OAAO,8CAA8C,QAAQ,EAAE,CAAC;IAClE,CAAC;IAOO,gBAAgB,CAAC,QAAgB;QACvC,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;YACrE,OAAO,QAAQ,CAAC;SACjB;QACD,OAAO,IAAA,eAAQ,EAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;CACF;AA3bD,0CA2bC"}

package/dist/entities/EntityManager.d.ts

@@ -0,0 +1,24 @@
+import { Entity, EntityUpdateData, EntityType, ListResponse } from '../types';
+import { IToothFairyClient } from '../client';
+export declare class EntityManager {
+    private client;
+    constructor(client: IToothFairyClient);
+    create(userId: string, label: string, type?: EntityType, options?: {
+        description?: string;
+        emoji?: string;
+        parentEntity?: string;
+        backgroundColor?: string;
+    }): Promise<Entity>;
+    update(entityId: string, fields: EntityUpdateData): Promise<Entity>;
+    get(entityId: string): Promise<Entity>;
+    delete(entityId: string): Promise<{
+        success: boolean;
+    }>;
+    list(options?: {
+        limit?: number;
+        type?: EntityType;
+    }): Promise<ListResponse<Entity>>;
+    getByType(type: EntityType, limit?: number): Promise<Entity[]>;
+    search(searchTerm: string, type?: EntityType): Promise<Entity[]>;
+}
+//# sourceMappingURL=EntityManager.d.ts.map

package/dist/entities/EntityManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityManager.d.ts","sourceRoot":"","sources":["../../src/entities/EntityManager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EAEN,gBAAgB,EAChB,UAAU,EACV,YAAY,EACb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAwB9C,qBAAa,aAAa;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,iBAAiB;IAWvC,MAAM,CACV,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,UAAoB,EAC1B,OAAO,GAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,MAAM,CAAC;KACrB,GACL,OAAO,CAAC,MAAM,CAAC;IAmBZ,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBnE,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUtC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAUvD,IAAI,CAAC,OAAO,GAAE;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,UAAU,CAAC;KACd,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAuBhC,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAY9D,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAMvE"}

package/dist/entities/EntityManager.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityManager = void 0;
+class EntityManager {
+    constructor(client) {
+        this.client = client;
+    }
+    async create(userId, label, type = 'topic', options = {}) {
+        const entityData = {
+            workspaceid: this.client.getWorkspaceId(),
+            createdBy: userId,
+            label,
+            type,
+            ...options
+        };
+        return this.client.request('POST', 'entity/create', entityData);
+    }
+    async update(entityId, fields) {
+        const updateData = {
+            id: entityId,
+            workspaceid: this.client.getWorkspaceId(),
+            ...fields
+        };
+        return this.client.request('POST', 'entity/update', updateData);
+    }
+    async get(entityId) {
+        return this.client.request('GET', `entity/get/${entityId}`);
+    }
+    async delete(entityId) {
+        return this.client.request('DELETE', `entity/delete/${entityId}`);
+    }
+    async list(options = {}) {
+        const { limit, type } = options;
+        const params = { workspaceid: this.client.getWorkspaceId() };
+        if (limit)
+            params.limit = limit;
+        if (type)
+            params.type = type;
+        const response = await this.client.request('GET', 'entity/list', null, { params });
+        return {
+            items: Array.isArray(response) ? response : [],
+            total: Array.isArray(response) ? response.length : 0,
+            limit
+        };
+    }
+    async getByType(type, limit) {
+        const result = await this.list({ type, limit });
+        return result.items;
+    }
+    async search(searchTerm, type) {
+        const result = await this.list({ type });
+        return result.items.filter(entity => entity.label.toLowerCase().includes(searchTerm.toLowerCase()));
+    }
+}
+exports.EntityManager = EntityManager;
+//# sourceMappingURL=EntityManager.js.map

package/dist/entities/EntityManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityManager.js","sourceRoot":"","sources":["../../src/entities/EntityManager.ts"],"names":[],"mappings":";;;AA+BA,MAAa,aAAa;IACxB,YAAoB,MAAyB;QAAzB,WAAM,GAAN,MAAM,CAAmB;IAAG,CAAC;IAWjD,KAAK,CAAC,MAAM,CACV,MAAc,EACd,KAAa,EACb,OAAmB,OAAO,EAC1B,UAKI,EAAE;QAEN,MAAM,UAAU,GAAG;YACjB,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE;YACzC,SAAS,EAAE,MAAM;YACjB,KAAK;YACL,IAAI;YACJ,GAAG,OAAO;SACX,CAAC;QAEF,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;IAClE,CAAC;IASD,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,MAAwB;QACrD,MAAM,UAAU,GAAG;YACjB,EAAE,EAAE,QAAQ;YACZ,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE;YACzC,GAAG,MAAM;SACV,CAAC;QAEF,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;IAClE,CAAC;IAQD,KAAK,CAAC,GAAG,CAAC,QAAgB;QACxB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,cAAc,QAAQ,EAAE,CAAC,CAAC;IAC9D,CAAC;IAQD,KAAK,CAAC,MAAM,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,iBAAiB,QAAQ,EAAE,CAAC,CAAC;IACpE,CAAC;IAQD,KAAK,CAAC,IAAI,CAAC,UAGP,EAAE;QACJ,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;QAEhC,MAAM,MAAM,GAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC;QAClE,IAAI,KAAK;YAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QAChC,IAAI,IAAI;YAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QAE7B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAEnF,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;YAC9C,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACpD,KAAK;SACN,CAAC;IACJ,CAAC;IASD,KAAK,CAAC,SAAS,CAAC,IAAgB,EAAE,KAAc;QAC9C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAChD,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IASD,KAAK,CAAC,MAAM,CAAC,UAAkB,EAAE,IAAiB;QAChD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAClC,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAC9D,CAAC;IACJ,CAAC;CACF;AAzHD,sCAyHC"}

package/dist/folders/FolderManager.d.ts

@@ -0,0 +1,30 @@
+import { Folder, FolderUpdateData, ListResponse } from '../types';
+import { IToothFairyClient } from '../client';
+export declare class FolderManager {
+    private client;
+    constructor(client: IToothFairyClient);
+    create(userId: string, name: string, options?: {
+        description?: string;
+        emoji?: string;
+        status?: string;
+        parent?: string;
+    }): Promise<Folder>;
+    update(folderId: string, fields: FolderUpdateData): Promise<Folder>;
+    get(folderId: string): Promise<Folder>;
+    delete(folderId: string): Promise<{
+        success: boolean;
+    }>;
+    list(options?: {
+        status?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<ListResponse<Folder>>;
+    getRootFolders(): Promise<Folder[]>;
+    getSubfolders(parentId: string): Promise<Folder[]>;
+    getTree(): Promise<FolderTreeNode[]>;
+    search(searchTerm: string): Promise<Folder[]>;
+}
+export interface FolderTreeNode extends Folder {
+    children: FolderTreeNode[];
+}
+//# sourceMappingURL=FolderManager.d.ts.map

package/dist/folders/FolderManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FolderManager.d.ts","sourceRoot":"","sources":["../../src/folders/FolderManager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EAEN,gBAAgB,EAChB,YAAY,EACb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAwB9C,qBAAa,aAAa;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,iBAAiB;IAUvC,MAAM,CACV,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACZ,GACL,OAAO,CAAC,MAAM,CAAC;IAkBZ,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAenE,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUtC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAUvD,IAAI,CAAC,OAAO,GAAE;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACZ,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAuBhC,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAWnC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAUlD,OAAO,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAuCpC,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAMpD;AAKD,MAAM,WAAW,cAAe,SAAQ,MAAM;IAC5C,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B"}