zotero-lib 1.0.79 → 1.0.83

package/README.md

@@ -1,76 +1,57 @@
 # zotero-lib
 
-## Introduction: Tools for working with the APIs of Zotero and Zenodo (zotzen)
+## Introduction
 
-This repository is part of a set of repositories, see here: https://github.com/orgs/OpenDevEd/teams/zotzen-team/repositories. Currently, this set contains a number of libraries
+Tools for working with the APIs of Zotero and Zenodo (zotzen)
 
-- zenodo-lib https://github.com/opendeved/zenodo-lib, https://www.npmjs.com/package/zenodo-lib
-- zotero-lib https://github.com/opendeved/zotero-lib, https://www.npmjs.com/package/zotero-lib
-- zotzen-lib https://github.com/opendeved/zotzen-lib, https://www.npmjs.com/package/zotzen-lib
+This repository is part of a set of repositories, [see here](https://github.com/orgs/OpenDevEd/teams/zotzen-team/repositories). Currently, this set contains a number of libraries
+
+- zenodo-lib [GitHub](https://github.com/opendeved/zenodo-lib), [npm](https://www.npmjs.com/package/zenodo-lib)
+- zotero-lib [GitHub](https://github.com/opendeved/zotero-lib), [npm](https://www.npmjs.com/package/zotero-lib)
+- zotzen-lib [GitHub](https://github.com/opendeved/zotzen-lib), [npm](https://www.npmjs.com/package/zotzen-lib)
 
 (The above tools can also be installed as command-line tools (CLI) with `npm -g`.)
 
 And a web application
 
-- zotzen-web https://github.com/opendeved/zotzen-web
+- [zotzen-web](https://github.com/opendeved/zotzen-web)
 
-# zotero-lib
+This code builds on earlier code for [zotero-cli](https://github.com/OpenDevEd/zotero-cli), which was developed by [@bjohas](https://github.com/bjohas), [@retorquere](https://github.com/retorquere) and [@a1diablo](https://github.com/a1diablo).
 
-Install this library with
+## Installation
 
-```
+Install this library in a module with
+
+```bash
 npm install zotero-lib
+yarn add zotero-lib
 ```
 
-or as CLI
+or as global CLI
 
+```bash
+npm install -g zotero-lib
+yarn global add zotero-lib
 ```
-sudo npm install -g zotero-lib
-```
-
-View entry on https://www.npmjs.com/package/zotero-lib
-
-# Used by
 
-This library is currently used by
+View entry on [npm](https://www.npmjs.com/package/zotero-lib)
 
-- https://github.com/OpenDevEd/zotero-lib
-- https://github.com/OpenDevEd/zotzen-lib
-- https://github.com/OpenDevEd/zotzen-web
-
-This code builds on earlier code for https://github.com/OpenDevEd/zotero-cli, which was developed by [@bjohas](https://github.com/bjohas), [@retorquere](https://github.com/retorquere) and [@a1diablo](https://github.com/a1diablo).
-
-# Use of the library and the CLI
+## Use of the library and the CLI
 
 The directory tests/ contains a number of tests that illustrate the
 use of the npm library. The file tests/test_cli.sh has examples for
 use of the library from the command line.
 
-# Also see:
-
-https://github.com/tnajdek/zotero-api-client (With hindsight we might have built on zotero-api-client - we might still rebuild our code to use zotero-api-client.)
-
-# CLI Documentation:
+## CLI Documentation
 
 The zotero-cli allows you to access zoter from cmd line, it allows you to automate redundant taskse easily
 
-## Installation
-
-`npm install -g zotero-lib`
-
-OR
-
-`yarn global add zotero-lib`
-
 ## Basic usage
 
 ### Help
 
-```
+```bash
 zotero-lib -h
-
-OR
-
 zotero-lib --help
 ```
 
@@ -78,70 +59,148 @@ This will print help for all commands and options accepted by zotero-lib
 
 ### Version
 
-```
+```bash
 zotero-lib -v
-
-OR
-
 zotero-lib --version
 ```
 
 This will print the version of cli you have installed
 
-### Item
-
-### Items
+### create
 
-### Create
+This allows you to create item(s). You can create items in two different ways either by providing file containg json or json items as string
 
-This allows you to create item(s). You can create items in two different ways by providing following arguments
+Both of these options can be used by providing following arguments
 
 - `--files` - this accepts text files containing json
 - `--items` - this accepts items as json string
 
-for example
+**Note**: You must use only one of these at a time
+
+Examples
+
+```bash
+zotero-lib create --files filepath.txt
+zotero-lib create --items '{"title": "zotero item 1", "itemType": "book"}' '{"title": "zotero item 2", "itemType": "book"}'
+```
+
+### update
+
+This sub-command can be used to update existing items
 
+```bash
+zotero-lib update --key key-here --json '{"title": "zotero item 1 updat", "itemType": "book"}'
+zotero-lib update --key key-here --file filepath.txt
 ```
-zotero-lib create items --files filepath.txt
-zotero-lib create items --items '{"title": "zotero item"}'
+
+You can also specify option replace which completely replace existing item and only keep provided information
+
+```bash
+zotero-lib update --replace --key key-here --json '{"title": "zotero item 1 updat", "itemType": "book"}'
+```
+
+### item
+
+This sub-command has various use cases
+
+To fetch item
+
+```bash
+zotero-lib item --key key-here
 ```
 
-### Update
+To add files
+
+```bash
+zotero-lib item --key key-here --addfiles test.json
+```
+
+### items
+
+This sub-command can be used to fetch items with various filters
+
+```bash
+zotero-lib items --filter '{"limit": 10}'
+```
+
+### collection
+
+### collections
+
+### publications
+
+### tags
+
+### attachment
+
+### types
+
+### groups
+
+### fields
+
+### searches
+
+### key
+
+### field
+
+### update-url
+
+### get-doi
+
+### update-doi
+
+### enclose-item
+
+### attach-link
 
-### Collection
+### attach-note
 
-### Collections
+### kciaka
 
-### Publications
+### bibliography
 
-### Tags
+### Local Database Syncing
 
-### Attachment
+You can use this cli to locally backup your online zotero library. The `db` cmd allows you to sync online library in local sqlite database. On first run all online records are synced into local database. On subsequent runs only those records are fetched, which were modifed since last sync.
 
-### Types
+The underlying database is SQLite. You dont need to install any server or anything it will work out of box as SQLite comes bundled with this cli. 
 
-### Groups
+To use this cmd you need to provide your db name along with one or more options. The options which you can specify are detailed below.
 
-### Fields
+`--sync` make local db synced with online library  
+`--lookup` allow you to lookup specific items in the local db  
+`--keys` this must be used with `--lookup` to specify specfic keys you want to locate  
+`--lockfile` name of lock file to be used, default is "sync.lock" 
+`--lock-timeout` if a lock file already exist, how much older it should be to classify it as outdated, if its outdated it will be removed and a new one will be generated
+`--export-json=<file-name.json>` export localdb as json with given `file-name.json`  
+`--demon=<valid-cron-pattern` this will make the sync process run in demon mode, where it will peridically sync by itself, see [https://crontab.guru](https://crontab.guru) to learn about crontab pattern  
+`--errors` this will list all inconsistent items which have non zero children and non zero references 
 
-### Searches
+These options are optional and can be combined as required. If all options are specified then they will be read/applied in above order.
 
-### Key
+#### Examples
 
-### Field
+To sync given db file `backup.db` with online version
 
-### Update-url
+````bash
+zotero-cli db backup.db --sync
+````
 
-### Get-doi
+To export give db file `backup.db` as json file `./backup.json`
 
-### Update-doi
+````bash
+zotero-cli db backup.db --export-json="./backup.json"
+````
 
-### Enclose-item
+You can combine previous two steps in one cmd
 
-### Attach-link
+````bash
+zotero-cli db backup.db --sync --export-json="./backup.json"
+````
 
-### Attach-note
 
-### Kciaka
+## Also see
 
-### Bibliography
+[zotero-api-client](https://github.com/tnajdek/zotero-api-client) (With hindsight we might have built on zotero-api-client - we might still rebuild our code to use zotero-api-client.)

package/build/decorations.d.ts

@@ -0,0 +1,35 @@
+declare const decorations: {
+    kerko_url: {
+        title: string;
+        tags: string[];
+    };
+    kerko_site_url: {
+        title: string;
+        tags: string[];
+    };
+    googledoc: {
+        title: string;
+        tags: string[];
+    };
+    deposit: {
+        title: string;
+        tags: string[];
+    };
+    record: {
+        title: string;
+        tags: string[];
+    };
+    doi: {
+        title: string;
+        tags: string[];
+    };
+    primarycollection: {
+        title: string;
+        tags: string[];
+    };
+    collection: {
+        title: string;
+        tags: string[];
+    };
+};
+export default decorations;

package/build/decorations.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const decorations = {
+    kerko_url: {
+        title: '👀View item in Evidence Library',
+        tags: ['_r:kerko', '_r:zotzen'],
+    },
+    kerko_site_url: {
+        title: '👀View item in Evidence Library',
+        tags: ['_r:kerko', '_r:zotzen'],
+    },
+    googledoc: {
+        title: '📝View Google Doc and download alternative formats',
+        tags: ['_r:googleDoc', '_r:zotzen'],
+    },
+    deposit: {
+        title: '🔄View entry on Zenodo (deposit)',
+        tags: ['_r:zenodoDeposit', '_r:zotzen'],
+    },
+    record: {
+        title: '🔄View entry on Zenodo (record)',
+        tags: ['_r:zenodoRecord', '_r:zotzen'],
+    },
+    doi: {
+        title: '🔄Look up this DOI (once activated)',
+        tags: ['_r:doi', '_r:zotzen'],
+    },
+    primarycollection: {
+        title: '🆉View primary collection for this item',
+        tags: ['_r:primary_collection', '_r:zotzen'],
+    },
+    collection: {
+        title: '🆉View collection for this item',
+        tags: ['_r:collection', '_r:zotzen'],
+    },
+};
+exports.default = decorations;
+//# sourceMappingURL=decorations.js.map

package/build/decorations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorations.js","sourceRoot":"","sources":["../src/decorations.ts"],"names":[],"mappings":";;AAAA,MAAM,WAAW,GAAG;IAClB,SAAS,EAAE;QACT,KAAK,EAAE,iCAAiC;QACxC,IAAI,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC;KAChC;IACD,cAAc,EAAE;QACd,KAAK,EAAE,iCAAiC;QACxC,IAAI,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC;KAChC;IACD,SAAS,EAAE;QACT,KAAK,EAAE,oDAAoD;QAC3D,IAAI,EAAE,CAAC,cAAc,EAAE,WAAW,CAAC;KACpC;IACD,OAAO,EAAE;QACP,KAAK,EAAE,kCAAkC;QACzC,IAAI,EAAE,CAAC,kBAAkB,EAAE,WAAW,CAAC;KACxC;IACD,MAAM,EAAE;QACN,KAAK,EAAE,iCAAiC;QACxC,IAAI,EAAE,CAAC,iBAAiB,EAAE,WAAW,CAAC;KACvC;IACD,GAAG,EAAE;QACH,KAAK,EAAE,qCAAqC;QAC5C,IAAI,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;KAC9B;IACD,iBAAiB,EAAE;QACjB,KAAK,EAAE,yCAAyC;QAChD,IAAI,EAAE,CAAC,uBAAuB,EAAE,WAAW,CAAC;KAC7C;IACD,UAAU,EAAE;QACV,KAAK,EAAE,iCAAiC;QACxC,IAAI,EAAE,CAAC,eAAe,EAAE,WAAW,CAAC;KACrC;CACF,CAAC;AAEF,kBAAe,WAAW,CAAC"}

package/build/http.client.d.ts

@@ -0,0 +1,19 @@
+export declare function createHttpClient(options?: {}): HttpClient;
+export declare class HttpClient {
+    private headers;
+    constructor({ headers }: {
+        headers?: {};
+    });
+    post(uri: any, data: any, headers?: {}, config?: any): Promise<any>;
+    get(uri: any, options?: {
+        fulluri?: boolean;
+        userOrGroupPrefix?: boolean;
+        params?: any;
+        resolveWithFullResponse?: boolean;
+        json?: boolean;
+        arraybuffer?: boolean;
+    }, config?: any): Promise<any>;
+    put(uri: any, data: any, config: any): Promise<any>;
+    patch(uri: any, data: any, version?: number, config?: any): Promise<any>;
+    delete(uri: any, version?: number, config?: any): Promise<any>;
+}

package/build/http.client.js

@@ -0,0 +1,195 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = exports.createHttpClient = void 0;
+const logger_1 = __importDefault(require("./logger"));
+const utils_1 = require("./utils");
+const axios = require('axios');
+const base = 'https://api.zotero.org';
+function createHttpClient(options = {}) {
+    return new HttpClient(options);
+}
+exports.createHttpClient = createHttpClient;
+class HttpClient {
+    constructor({ headers = {} }) {
+        this.headers = headers;
+    }
+    async post(uri, data, headers = {}, config = {}) {
+        const prefix = config.user_id
+            ? `/users/${config.user_id}`
+            : `/groups/${config.group_id}`;
+        if (!uri.startsWith('http')) {
+            uri = `${base}${prefix}${uri}`;
+        }
+        console.log('POST uri: ' + uri);
+        if (config.verbose)
+            console.error('POST', uri);
+        console.log('POST data: ', data);
+        return axios({
+            method: 'POST',
+            url: uri,
+            headers: {
+                ...this.headers,
+                'Content-Type': 'application/json',
+                ...headers,
+            },
+            data,
+        }).then((res) => res.data);
+    }
+    async get(uri, options = {}, config = {}) {
+        if (typeof options.userOrGroupPrefix === 'undefined')
+            options.userOrGroupPrefix = true;
+        if (typeof options.params === 'undefined')
+            options.params = {};
+        if (typeof options.json === 'undefined')
+            options.json = true;
+        let prefix = '';
+        if (options.userOrGroupPrefix) {
+            prefix = config.user_id
+                ? `/users/${config.user_id}`
+                : `/groups/${config.group_id}`;
+        }
+        const params = Object.keys(options.params)
+            .map((param) => {
+            let values = options.params[param];
+            values = (0, utils_1.as_array)(values);
+            return values.map((v) => `${param}=${encodeURI(v)}`).join('&');
+        })
+            .join('&');
+        if (!options.fulluri) {
+            uri = `${base}${prefix}${uri}${params ? '?' + params : ''}`;
+        }
+        if (config.verbose)
+            console.error('GET', uri);
+        logger_1.default.info('get uri: %s', uri);
+        const requestConfig = {
+            method: 'get',
+            url: uri,
+            headers: { ...this.headers },
+            encoding: null,
+            json: options.json,
+            resolveWithFullResponse: options.resolveWithFullResponse,
+        };
+        if (options.arraybuffer) {
+            requestConfig.responseType = 'arraybuffer';
+        }
+        const res = await axios(requestConfig)
+            .then(function (response) {
+            return {
+                body: response.data,
+                status: response.status,
+                statusText: response.statusText,
+                headers: response.headers,
+                config: response.config,
+            };
+        })
+            .catch((error) => {
+            if (config.verbose) {
+                console.log(`Error in zotero.get = ${JSON.stringify(error, null, 2)}`);
+            }
+            logger_1.default.error('error in zotero get %O', error);
+            // console.log(`Error in zotero.get = ${JSON.stringify(error.error.data, null, 2)}`)
+            const message = error.error && error.error.data;
+            const shortError = {
+                name: error.name,
+                statusCode: error.statusCode,
+                message,
+                url: uri,
+                json: options.json,
+            };
+            console.log('Error in zotero.get = ' + JSON.stringify(shortError, null, 2));
+            return error;
+        });
+        // console.log("all=" + JSON.stringify(res, null, 2))
+        if (options.resolveWithFullResponse) {
+            return res;
+        }
+        else {
+            return res.body;
+        }
+    }
+    // TODO: Add resolveWithFullResponse: options.resolveWithFullResponse,
+    async put(uri, data, config) {
+        const prefix = config.user_id
+            ? `/users/${config.user_id}`
+            : `/groups/${config.group_id}`;
+        uri = `${base}${prefix}${uri}`;
+        if (config.verbose)
+            console.error('PUT', uri);
+        return axios({
+            method: 'PUT',
+            url: uri,
+            headers: { ...this.headers, 'Content-Type': 'application/json' },
+            data,
+        })
+            .then((res) => {
+            return {
+                body: res.data,
+                status: res.status,
+                statusText: res.statusText,
+                headers: res.headers,
+                config: res.config,
+            };
+        })
+            .catch((error) => {
+            console.log('PUT ERROR=' + JSON.stringify(error, null, 2));
+            return error;
+        });
+    }
+    // patch does not return any data.
+    // TODO: Errors are not handled - add this to patch (below) but needs adding to others.
+    async patch(uri, data, version, config) {
+        const prefix = config.user_id
+            ? `/users/${config.user_id}`
+            : `/groups/${config.group_id}`;
+        const headers = { ...this.headers, 'Content-Type': 'application/json' };
+        if (typeof version !== 'undefined') {
+            headers['If-Unmodified-Since-Version'] = version;
+        }
+        uri = `${base}${prefix}${uri}`;
+        if (config.verbose)
+            console.error('PATCH', uri);
+        return axios({
+            method: 'PATCH',
+            url: uri,
+            headers,
+            data,
+            resolveWithFullResponse: true,
+        })
+            .then((response) => {
+            return {
+                body: response.data,
+                statusCode: response.status,
+                statusText: response.statusText,
+                headers: response.headers,
+                config: response.config,
+            };
+        })
+            .catch((error) => {
+            console.log('PAT ERROR=' + JSON.stringify(error, null, 2));
+            return error;
+        });
+    }
+    // TODO: Add resolveWithFullResponse: options.resolveWithFullResponse,
+    async delete(uri, version, config) {
+        const prefix = config.user_id
+            ? `/users/${config.user_id}`
+            : `/groups/${config.group_id}`;
+        const headers = { ...this.headers, 'Content-Type': 'application/json' };
+        if (typeof version !== 'undefined') {
+            headers['If-Unmodified-Since-Version'] = version;
+        }
+        uri = `${base}${prefix}${uri}`;
+        if (config.verbose)
+            console.error('DELETE', uri);
+        return axios({
+            method: 'DELETE',
+            url: uri,
+            headers,
+        }).then((res) => res.data);
+    }
+}
+exports.HttpClient = HttpClient;
+//# sourceMappingURL=http.client.js.map

package/build/http.client.js.map

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

package/build/local-db/api.d.ts

@@ -0,0 +1,6 @@
+import { RequestArgs } from './types';
+export declare function fetchCurrentKey(options?: RequestArgs): Promise<any>;
+export declare function fetchGroups(options?: RequestArgs): Promise<any>;
+export declare function fetchGroupData(options?: RequestArgs): Promise<any>;
+export declare function getChangedItemsForGroup(options: any): Promise<any>;
+export declare function fetchItemsByIds(options: any): Promise<any>;

package/build/local-db/api.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchItemsByIds = exports.getChangedItemsForGroup = exports.fetchGroupData = exports.fetchGroups = exports.fetchCurrentKey = void 0;
+const axios = require('axios');
+function getZoteroURL(subpath = '') {
+    const BASE_URL = 'https://api.zotero.org';
+    if (subpath.trim().length) {
+        return `${BASE_URL}/${subpath}`;
+    }
+    return BASE_URL;
+}
+async function fetchCurrentKey(options = { api_key: '' }) {
+    const { api_key } = options;
+    const headers = { Authorization: `Bearer ${api_key}` };
+    return axios
+        .get(getZoteroURL('keys/current'), { headers })
+        .then((res) => res.data);
+}
+exports.fetchCurrentKey = fetchCurrentKey;
+async function fetchGroups(options = { api_key: '', user_id: '' }) {
+    const { api_key, user_id } = options;
+    const headers = { Authorization: `Bearer ${api_key}` };
+    return axios
+        .get(getZoteroURL(`users/${user_id}/groups/?format=versions`), { headers })
+        .then((res) => res.data);
+}
+exports.fetchGroups = fetchGroups;
+async function fetchGroupData(options = { api_key: '', user_id: '' }) {
+    const { api_key, group_id } = options;
+    const headers = { Authorization: `Bearer ${api_key}` };
+    const requestURL = getZoteroURL(`groups/${group_id}`);
+    return axios.get(requestURL, { headers }).then((res) => {
+        return res.data;
+    });
+}
+exports.fetchGroupData = fetchGroupData;
+async function getChangedItemsForGroup(options) {
+    const { api_key, group, version = 0 } = options;
+    const headers = { Authorization: `Bearer ${api_key}` };
+    return axios
+        .get(getZoteroURL(`groups/${group}/items?since=${version}&format=versions&includeTrashed=1`), { headers })
+        .then((res) => res.data);
+}
+exports.getChangedItemsForGroup = getChangedItemsForGroup;
+async function fetchItemsByIds(options) {
+    const { api_key, group, itemIds } = options;
+    const headers = { Authorization: `Bearer ${api_key}` };
+    return axios.get(getZoteroURL(`groups/${group}/items/?itemKey=${itemIds}`), {
+        headers,
+    });
+}
+exports.fetchItemsByIds = fetchItemsByIds;
+//# sourceMappingURL=api.js.map

package/build/local-db/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/local-db/api.ts"],"names":[],"mappings":";;;AAEA,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAE/B,SAAS,YAAY,CAAC,OAAO,GAAG,EAAE;IAChC,MAAM,QAAQ,GAAG,wBAAwB,CAAC;IAE1C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE;QACzB,OAAO,GAAG,QAAQ,IAAI,OAAO,EAAE,CAAC;KACjC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAEM,KAAK,UAAU,eAAe,CAAC,UAAuB,EAAE,OAAO,EAAE,EAAE,EAAE;IAC1E,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAE5B,MAAM,OAAO,GAAG,EAAE,aAAa,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;IAEvD,OAAO,KAAK;SACT,GAAG,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC;SAC9C,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AARD,0CAQC;AAEM,KAAK,UAAU,WAAW,CAC/B,UAAuB,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;IAEnD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAErC,MAAM,OAAO,GAAG,EAAE,aAAa,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;IAEvD,OAAO,KAAK;SACT,GAAG,CAAC,YAAY,CAAC,SAAS,OAAO,0BAA0B,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC;SAC1E,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAVD,kCAUC;AAEM,KAAK,UAAU,cAAc,CAClC,UAAuB,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;IAEnD,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAEtC,MAAM,OAAO,GAAG,EAAE,aAAa,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;IAEvD,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,QAAQ,EAAE,CAAC,CAAC;IACtD,OAAO,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;QACrD,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAXD,wCAWC;AAEM,KAAK,UAAU,uBAAuB,CAAC,OAAO;IACnD,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAChD,MAAM,OAAO,GAAG,EAAE,aAAa,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;IAEvD,OAAO,KAAK;SACT,GAAG,CACF,YAAY,CACV,UAAU,KAAK,gBAAgB,OAAO,mCAAmC,CAC1E,EACD,EAAE,OAAO,EAAE,CACZ;SACA,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAZD,0DAYC;AAEM,KAAK,UAAU,eAAe,CAAC,OAAO;IAC3C,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC5C,MAAM,OAAO,GAAG,EAAE,aAAa,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;IAEvD,OAAO,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,UAAU,KAAK,mBAAmB,OAAO,EAAE,CAAC,EAAE;QAC1E,OAAO;KACR,CAAC,CAAC;AACL,CAAC;AAPD,0CAOC"}