@jesusacd/mediafire 1.0.0 → 1.2.0

package/dist/modules/files.d.ts

@@ -52,5 +52,148 @@ export declare class FilesModule {
      * ```
      */
     search(query: string): Promise<SearchResults>;
+    /**
+     * Set file privacy (public or private)
+     *
+     * @param quickKey - File quick key
+     * @param privacy - Privacy setting: 'public' or 'private'
+     * @returns True if successful
+     * @throws MediaFireError if not authenticated or API error
+     *
+     * @example
+     * ```typescript
+     * // Make file public
+     * await client.files.setPrivacy('abc123quickkey', 'public');
+     *
+     * // Make file private
+     * await client.files.setPrivacy('abc123quickkey', 'private');
+     * ```
+     */
+    setPrivacy(quickKey: string, privacy: 'public' | 'private'): Promise<boolean>;
+    /**
+     * Make a file public
+     *
+     * @param quickKey - File quick key
+     * @returns True if successful
+     *
+     * @example
+     * ```typescript
+     * await client.files.makePublic('abc123quickkey');
+     * ```
+     */
+    makePublic(quickKey: string): Promise<boolean>;
+    /**
+     * Make a file private
+     *
+     * @param quickKey - File quick key
+     * @returns True if successful
+     *
+     * @example
+     * ```typescript
+     * await client.files.makePrivate('abc123quickkey');
+     * ```
+     */
+    makePrivate(quickKey: string): Promise<boolean>;
+    /**
+     * Copy a file to another folder
+     *
+     * @param quickKey - File quick key (or comma-separated list)
+     * @param folderKey - Destination folder key (default: root)
+     * @returns New quick keys of copied files
+     *
+     * @example
+     * ```typescript
+     * const newKeys = await client.files.copy('abc123', 'destFolder');
+     * ```
+     */
+    copy(quickKey: string, folderKey?: string): Promise<string[]>;
+    /**
+     * Delete a file (move to trash)
+     *
+     * @param quickKey - File quick key (or comma-separated list)
+     * @returns True if successful
+     *
+     * @example
+     * ```typescript
+     * await client.files.delete('abc123');
+     * ```
+     */
+    delete(quickKey: string): Promise<boolean>;
+    /**
+     * Move a file to another folder
+     *
+     * @param quickKey - File quick key (or comma-separated list, max 500)
+     * @param folderKey - Destination folder key (default: root)
+     * @returns True if successful
+     *
+     * @example
+     * ```typescript
+     * await client.files.move('abc123', 'destFolder');
+     * ```
+     */
+    move(quickKey: string, folderKey?: string): Promise<boolean>;
+    /**
+     * Rename a file
+     *
+     * @param quickKey - File quick key
+     * @param newName - New file name (with extension)
+     * @returns True if successful
+     *
+     * @example
+     * ```typescript
+     * await client.files.rename('abc123', 'newname.pdf');
+     * ```
+     */
+    rename(quickKey: string, newName: string): Promise<boolean>;
+    /**
+     * Permanently delete a file (cannot be recovered)
+     *
+     * @param quickKey - File quick key (or comma-separated list)
+     * @returns True if successful
+     *
+     * @example
+     * ```typescript
+     * await client.files.purge('abc123');
+     * ```
+     */
+    purge(quickKey: string): Promise<boolean>;
+    /**
+     * Restore a file from trash
+     *
+     * @param quickKey - File quick key (or comma-separated list)
+     * @returns True if successful
+     *
+     * @example
+     * ```typescript
+     * await client.files.restore('abc123');
+     * ```
+     */
+    restore(quickKey: string): Promise<boolean>;
+    /**
+     * Get file version history
+     *
+     * @param quickKey - File quick key
+     * @returns Array of file versions
+     *
+     * @example
+     * ```typescript
+     * const versions = await client.files.getVersions('abc123');
+     * ```
+     */
+    getVersions(quickKey: string): Promise<Array<{
+        revision: number;
+        date: string;
+    }>>;
+    /**
+     * Get recently modified files
+     *
+     * @returns Array of recently modified files
+     *
+     * @example
+     * ```typescript
+     * const recent = await client.files.getRecentlyModified();
+     * ```
+     */
+    getRecentlyModified(): Promise<FileInfo[]>;
 }
 //# sourceMappingURL=files.d.ts.map

package/dist/modules/files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/modules/files.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAW,eAAe,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAe,aAAa,EAAE,MAAM,UAAU,CAAC;AAG/E;;GAEG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,MAAM,eAAe,GAAG,IAAI;IAE5D;;;;;;;;;;;;OAYG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAqDlD;;;;;;;;;;;;OAYG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA2BxD;;;;;;;;;;;;;OAaG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CA8DpD"}
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/modules/files.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAW,eAAe,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAe,aAAa,EAAE,MAAM,UAAU,CAAC;AAG/E;;GAEG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,MAAM,eAAe,GAAG,IAAI;IAE5D;;;;;;;;;;;;OAYG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAqDlD;;;;;;;;;;;;OAYG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA2BxD;;;;;;;;;;;;;OAaG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA+DnD;;;;;;;;;;;;;;;;OAgBG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBnF;;;;;;;;;;OAUG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpD;;;;;;;;;;OAUG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrD;;;;;;;;;;;OAWG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBnE;;;;;;;;;;OAUG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAahD;;;;;;;;;;;OAWG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAclE;;;;;;;;;;;OAWG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAcjE;;;;;;;;;;OAUG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAa/C;;;;;;;;;;OAUG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAajD;;;;;;;;;;OAUG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAuBvF;;;;;;;;;OASG;IACG,mBAAmB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;CA0BjD"}

package/dist/modules/files.js

@@ -139,6 +139,247 @@ class FilesModule {
             total: items.length
         };
     }
+    /**
+     * Set file privacy (public or private)
+     *
+     * @param quickKey - File quick key
+     * @param privacy - Privacy setting: 'public' or 'private'
+     * @returns True if successful
+     * @throws MediaFireError if not authenticated or API error
+     *
+     * @example
+     * ```typescript
+     * // Make file public
+     * await client.files.setPrivacy('abc123quickkey', 'public');
+     *
+     * // Make file private
+     * await client.files.setPrivacy('abc123quickkey', 'private');
+     * ```
+     */
+    async setPrivacy(quickKey, privacy) {
+        const session = this.getSession();
+        if (!session) {
+            throw new Error('Not authenticated. Please call login() first.');
+        }
+        await (0, api_1.apiCall)('file/update', {
+            quick_key: quickKey,
+            privacy: privacy
+        }, session);
+        return true;
+    }
+    /**
+     * Make a file public
+     *
+     * @param quickKey - File quick key
+     * @returns True if successful
+     *
+     * @example
+     * ```typescript
+     * await client.files.makePublic('abc123quickkey');
+     * ```
+     */
+    async makePublic(quickKey) {
+        return this.setPrivacy(quickKey, 'public');
+    }
+    /**
+     * Make a file private
+     *
+     * @param quickKey - File quick key
+     * @returns True if successful
+     *
+     * @example
+     * ```typescript
+     * await client.files.makePrivate('abc123quickkey');
+     * ```
+     */
+    async makePrivate(quickKey) {
+        return this.setPrivacy(quickKey, 'private');
+    }
+    /**
+     * Copy a file to another folder
+     *
+     * @param quickKey - File quick key (or comma-separated list)
+     * @param folderKey - Destination folder key (default: root)
+     * @returns New quick keys of copied files
+     *
+     * @example
+     * ```typescript
+     * const newKeys = await client.files.copy('abc123', 'destFolder');
+     * ```
+     */
+    async copy(quickKey, folderKey) {
+        const session = this.getSession();
+        if (!session) {
+            throw new Error('Not authenticated. Please call login() first.');
+        }
+        const response = await (0, api_1.apiCall)('file/copy', {
+            quick_key: quickKey,
+            folder_key: folderKey || 'myfiles'
+        }, session);
+        return response.new_quickkeys || [];
+    }
+    /**
+     * Delete a file (move to trash)
+     *
+     * @param quickKey - File quick key (or comma-separated list)
+     * @returns True if successful
+     *
+     * @example
+     * ```typescript
+     * await client.files.delete('abc123');
+     * ```
+     */
+    async delete(quickKey) {
+        const session = this.getSession();
+        if (!session) {
+            throw new Error('Not authenticated. Please call login() first.');
+        }
+        await (0, api_1.apiCall)('file/delete', {
+            quick_key: quickKey
+        }, session);
+        return true;
+    }
+    /**
+     * Move a file to another folder
+     *
+     * @param quickKey - File quick key (or comma-separated list, max 500)
+     * @param folderKey - Destination folder key (default: root)
+     * @returns True if successful
+     *
+     * @example
+     * ```typescript
+     * await client.files.move('abc123', 'destFolder');
+     * ```
+     */
+    async move(quickKey, folderKey) {
+        const session = this.getSession();
+        if (!session) {
+            throw new Error('Not authenticated. Please call login() first.');
+        }
+        await (0, api_1.apiCall)('file/move', {
+            quick_key: quickKey,
+            folder_key: folderKey || 'myfiles'
+        }, session);
+        return true;
+    }
+    /**
+     * Rename a file
+     *
+     * @param quickKey - File quick key
+     * @param newName - New file name (with extension)
+     * @returns True if successful
+     *
+     * @example
+     * ```typescript
+     * await client.files.rename('abc123', 'newname.pdf');
+     * ```
+     */
+    async rename(quickKey, newName) {
+        const session = this.getSession();
+        if (!session) {
+            throw new Error('Not authenticated. Please call login() first.');
+        }
+        await (0, api_1.apiCall)('file/update', {
+            quick_key: quickKey,
+            filename: newName
+        }, session);
+        return true;
+    }
+    /**
+     * Permanently delete a file (cannot be recovered)
+     *
+     * @param quickKey - File quick key (or comma-separated list)
+     * @returns True if successful
+     *
+     * @example
+     * ```typescript
+     * await client.files.purge('abc123');
+     * ```
+     */
+    async purge(quickKey) {
+        const session = this.getSession();
+        if (!session) {
+            throw new Error('Not authenticated. Please call login() first.');
+        }
+        await (0, api_1.apiCall)('file/purge', {
+            quick_key: quickKey
+        }, session);
+        return true;
+    }
+    /**
+     * Restore a file from trash
+     *
+     * @param quickKey - File quick key (or comma-separated list)
+     * @returns True if successful
+     *
+     * @example
+     * ```typescript
+     * await client.files.restore('abc123');
+     * ```
+     */
+    async restore(quickKey) {
+        const session = this.getSession();
+        if (!session) {
+            throw new Error('Not authenticated. Please call login() first.');
+        }
+        await (0, api_1.apiCall)('file/restore', {
+            quick_key: quickKey
+        }, session);
+        return true;
+    }
+    /**
+     * Get file version history
+     *
+     * @param quickKey - File quick key
+     * @returns Array of file versions
+     *
+     * @example
+     * ```typescript
+     * const versions = await client.files.getVersions('abc123');
+     * ```
+     */
+    async getVersions(quickKey) {
+        const session = this.getSession();
+        if (!session) {
+            throw new Error('Not authenticated. Please call login() first.');
+        }
+        const response = await (0, api_1.apiCall)('file/get_versions', {
+            quick_key: quickKey
+        }, session);
+        return (response.file_versions || []).map(v => ({
+            revision: parseInt(v.revision, 10),
+            date: v.date
+        }));
+    }
+    /**
+     * Get recently modified files
+     *
+     * @returns Array of recently modified files
+     *
+     * @example
+     * ```typescript
+     * const recent = await client.files.getRecentlyModified();
+     * ```
+     */
+    async getRecentlyModified() {
+        const session = this.getSession();
+        if (!session) {
+            throw new Error('Not authenticated. Please call login() first.');
+        }
+        const response = await (0, api_1.apiCall)('file/recently_modified', {}, session);
+        const files = [];
+        const quickKeys = response.quickkeys || [];
+        for (const qk of quickKeys.slice(0, 10)) {
+            try {
+                const info = await this.getInfo(qk);
+                files.push(info);
+            }
+            catch {
+                // Skip files that can't be retrieved
+            }
+        }
+        return files;
+    }
 }
 exports.FilesModule = FilesModule;
 //# sourceMappingURL=files.js.map

package/dist/modules/files.js.map

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

package/dist/modules/folders.d.ts

@@ -57,5 +57,123 @@ export declare class FoldersModule {
      * @returns Array of folders
      */
     getFolders(folderKey?: string, options?: Omit<GetContentOptions, 'contentType'>): Promise<FolderItem[]>;
+    /**
+     * Get folder information
+     *
+     * @param folderKey - Folder key
+     * @returns Folder info
+     *
+     * @example
+     * ```typescript
+     * const info = await client.folders.getInfo('abc123');
+     * console.log(`Folder: ${info.name}`);
+     * ```
+     */
+    getInfo(folderKey: string): Promise<{
+        folderKey: string;
+        name: string;
+        description?: string;
+        created?: string;
+        privacy: string;
+        fileCount: number;
+        folderCount: number;
+        totalSize: number;
+    }>;
+    /**
+     * Create a new folder
+     *
+     * @param name - Folder name
+     * @param parentKey - Parent folder key (default: root)
+     * @param options - Create options
+     * @returns Created folder info
+     *
+     * @example
+     * ```typescript
+     * const folder = await client.folders.create('My New Folder');
+     * console.log(`Created: ${folder.folderKey}`);
+     * ```
+     */
+    create(name: string, parentKey?: string, options?: {
+        actionOnDuplicate?: 'skip' | 'keep' | 'replace';
+    }): Promise<{
+        folderKey: string;
+        name: string;
+    }>;
+    /**
+     * Delete a folder (move to trash)
+     *
+     * @param folderKey - Folder key (or comma-separated list)
+     * @returns True if successful
+     *
+     * @example
+     * ```typescript
+     * await client.folders.delete('abc123');
+     * ```
+     */
+    delete(folderKey: string): Promise<boolean>;
+    /**
+     * Move a folder to another location
+     *
+     * @param folderKey - Folder key (or comma-separated list)
+     * @param destFolderKey - Destination folder key (default: root)
+     * @returns True if successful
+     *
+     * @example
+     * ```typescript
+     * await client.folders.move('abc123', 'destFolder');
+     * ```
+     */
+    move(folderKey: string, destFolderKey?: string): Promise<boolean>;
+    /**
+     * Copy a folder to another location
+     *
+     * @param folderKey - Folder key
+     * @param destFolderKey - Destination folder key (default: root)
+     * @returns New folder key
+     *
+     * @example
+     * ```typescript
+     * const newKey = await client.folders.copy('abc123', 'destFolder');
+     * ```
+     */
+    copy(folderKey: string, destFolderKey?: string): Promise<string>;
+    /**
+     * Rename a folder
+     *
+     * @param folderKey - Folder key
+     * @param newName - New folder name
+     * @returns True if successful
+     *
+     * @example
+     * ```typescript
+     * await client.folders.rename('abc123', 'New Name');
+     * ```
+     */
+    rename(folderKey: string, newName: string): Promise<boolean>;
+    /**
+     * Set folder privacy
+     *
+     * @param folderKey - Folder key
+     * @param privacy - Privacy setting: 'public' or 'private'
+     * @returns True if successful
+     *
+     * @example
+     * ```typescript
+     * await client.folders.setPrivacy('abc123', 'public');
+     * ```
+     */
+    setPrivacy(folderKey: string, privacy: 'public' | 'private'): Promise<boolean>;
+    /**
+     * Permanently delete a folder (cannot be recovered)
+     *
+     * @param folderKey - Folder key (or comma-separated list)
+     * @returns True if successful
+     *
+     * @example
+     * ```typescript
+     * await client.folders.purge('abc123');
+     * ```
+     */
+    purge(folderKey: string): Promise<boolean>;
 }
 //# sourceMappingURL=folders.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../src/modules/folders.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAW,eAAe,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,aAAa,EAAe,QAAQ,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG5E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,KAAK,CAAC;IAC1C,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,MAAM,eAAe,GAAG,IAAI;IAE5D;;;;;;;;;;;;;;;;;;;OAmBG;IACG,UAAU,CAAC,SAAS,GAAE,MAAkB,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC;IA8GxG;;;;;;OAMG;IACG,QAAQ,CAAC,SAAS,GAAE,MAAkB,EAAE,OAAO,GAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAKxH;;;;;;OAMG;IACG,UAAU,CAAC,SAAS,GAAE,MAAkB,EAAE,OAAO,GAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAI7H"}
+{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../src/modules/folders.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAW,eAAe,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,aAAa,EAAe,QAAQ,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG5E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,KAAK,CAAC;IAC1C,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,MAAM,eAAe,GAAG,IAAI;IAE5D;;;;;;;;;;;;;;;;;;;OAmBG;IACG,UAAU,CAAC,SAAS,GAAE,MAAkB,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC;IA8GxG;;;;;;OAMG;IACG,QAAQ,CAAC,SAAS,GAAE,MAAkB,EAAE,OAAO,GAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAKxH;;;;;;OAMG;IACG,UAAU,CAAC,SAAS,GAAE,MAAkB,EAAE,OAAO,GAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAK5H;;;;;;;;;;;OAWG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QACxC,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAwCF;;;;;;;;;;;;;OAaG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QACvD,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;KACjD,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBhD;;;;;;;;;;OAUG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAajD;;;;;;;;;;;OAWG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAcvE;;;;;;;;;;;OAWG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBtE;;;;;;;;;;;OAWG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAclE;;;;;;;;;;;OAWG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAcpF;;;;;;;;;;OAUG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAYjD"}