@vertesia/client 0.80.1 → 0.81.0

package/lib/cjs/store/AnalyzeDocApi.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnalyzeDocApi = void 0;
+const api_fetch_client_1 = require("@vertesia/api-fetch-client");
+class AnalyzeDocApi extends api_fetch_client_1.ApiTopic {
+    objectId;
+    constructor(parent, objectId) {
+        super(parent, `/${objectId}/analyze`);
+        this.objectId = objectId;
+    }
+    async start(payload) {
+        return this.post("/", { payload });
+    }
+    async getStatus() {
+        return this.get("/status");
+    }
+    async getResults() {
+        return this.get("/results");
+    }
+    async adaptTables(payload) {
+        return this.post("/adapt_tables", { payload });
+    }
+    async getAdaptedTables(runId, query) {
+        const path = runId ? `/adapt_tables/${runId}` : "/adapt_tables";
+        // Build query parameters
+        const queryParams = {};
+        if (query?.format)
+            queryParams.format = query.format;
+        if (query?.raw !== undefined)
+            queryParams.raw = query.raw;
+        // If format is CSV, set response type to text to avoid automatic JSON parsing
+        const options = { query: queryParams };
+        if (query?.format === 'csv') {
+            options.responseType = 'text';
+        }
+        return this.get(path, options);
+    }
+    async getXml() {
+        return this.get("/xml");
+    }
+    async getTables(format) {
+        const options = {};
+        if (format) {
+            options.query = { format: format };
+        }
+        return this.get("/tables", options);
+    }
+    async getImages() {
+        return this.get("/images");
+    }
+    async getAnnotated() {
+        return this.get("/annotated");
+    }
+}
+exports.AnalyzeDocApi = AnalyzeDocApi;
+//# sourceMappingURL=AnalyzeDocApi.js.map

package/lib/cjs/store/AnalyzeDocApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyzeDocApi.js","sourceRoot":"","sources":["../../../src/store/AnalyzeDocApi.ts"],"names":[],"mappings":";;;AAAA,iEAAkE;AAGlE,MAAa,aAAc,SAAQ,2BAAQ;IACA;IAAvC,YAAY,MAAkB,EAAS,QAAgB;QACnD,KAAK,CAAC,MAAM,EAAE,IAAI,QAAQ,UAAU,CAAC,CAAC;QADH,aAAQ,GAAR,QAAQ,CAAQ;IAEvD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAA6B;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,SAAS;QACX,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,UAAU;QACZ,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAA2B;QACzC,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,KAAc,EAAE,KAAoC;QACvE,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,iBAAiB,KAAK,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC;QAEhE,yBAAyB;QACzB,MAAM,WAAW,GAAQ,EAAE,CAAC;QAC5B,IAAI,KAAK,EAAE,MAAM;YAAE,WAAW,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QACrD,IAAI,KAAK,EAAE,GAAG,KAAK,SAAS;YAAE,WAAW,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QAE1D,8EAA8E;QAC9E,MAAM,OAAO,GAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QAC5C,IAAI,KAAK,EAAE,MAAM,KAAK,KAAK,EAAE,CAAC;YAC1B,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC;QAClC,CAAC;QAED,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,MAAM;QACR,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAA2B;QACvC,MAAM,OAAO,GAAQ,EAAE,CAAC;QACxB,IAAI,MAAM,EAAE,CAAC;YACT,OAAO,CAAC,KAAK,GAAG,EAAC,MAAM,EAAE,MAAM,EAAC,CAAA;QACpC,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,SAAS;QACX,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,YAAY;QACd,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAClC,CAAC;CACJ;AAzDD,sCAyDC"}

package/lib/cjs/store/CollectionsApi.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CollectionsApi = void 0;
+const api_fetch_client_1 = require("@vertesia/api-fetch-client");
+class CollectionsApi extends api_fetch_client_1.ApiTopic {
+    constructor(parent) {
+        super(parent, "/api/v1/collections");
+    }
+    /**
+     * List collections
+     * @param payload: CollectionSearchPayload
+     * @returns CollectionItem[] list of collections
+    **/
+    search(payload) {
+        return this.post("/search", { payload });
+    }
+    /**
+     * Compute facets for List collections
+     * @param query: ComputeCollectionFacetPayload
+     * @returns ComputeFacetsResponse list of facets
+    **/
+    computeListFacets(query) {
+        return this.post("/facets", {
+            payload: query
+        });
+    }
+    /**
+     * Get the collection data without members
+     * @param collectionId
+     * @returns
+     */
+    retrieve(collectionId) {
+        return this.get(`/${collectionId}`);
+    }
+    create(payload) {
+        return this.post(`/`, {
+            payload
+        });
+    }
+    update(collectionId, payload) {
+        return this.put(`/${collectionId}`, {
+            payload
+        });
+    }
+    addMembers(collectionId, members) {
+        return this.post(`/${collectionId}/members`, {
+            payload: {
+                action: 'add',
+                members
+            }
+        });
+    }
+    listMembers(collectionId, payload) {
+        return this.get(`/${collectionId}/members`, {
+            query: {
+                ...payload
+            }
+        });
+    }
+    computeFacets(collectionId, query) {
+        return this.post(`/${collectionId}/facets`, {
+            payload: query
+        });
+    }
+    searchMembers(collectionId, payload) {
+        return this.post(`/${collectionId}/search`, { payload });
+    }
+    deleteMembers(collectionId, members) {
+        return this.post(`/${collectionId}/members`, {
+            payload: {
+                action: 'delete',
+                members
+            }
+        });
+    }
+    addChildren(collectionId, children) {
+        return this.post(`/${collectionId}/children`, {
+            payload: {
+                action: 'add',
+                children
+            }
+        });
+    }
+    deleteChildren(collectionId, children) {
+        return this.post(`/${collectionId}/children`, {
+            payload: {
+                action: 'delete',
+                children
+            }
+        });
+    }
+    searchChildren(collectionId, query = {}) {
+        return this.post(`/${collectionId}/children/search`, {
+            payload: query
+        });
+    }
+    delete(id) {
+        return this.del(`/${id}`);
+    }
+    /**
+     * Update collection permissions and propagate to member objects
+     * @param collectionId - The collection ID
+     * @param permissions - Map of permission types to principal arrays
+     * @returns Object with collection id, updated security, and number of objects updated
+     */
+    updatePermissions(collectionId, permissions) {
+        return this.put(`/${collectionId}/permissions`, {
+            payload: permissions
+        });
+    }
+    /**
+     * Manually trigger permission propagation from collection to member objects
+     * Useful for debugging and fixing permission issues
+     * @param collectionId - The collection ID
+     * @returns Object with collection id, message, and number of objects updated
+     */
+    propagatePermissions(collectionId) {
+        return this.post(`/${collectionId}/propagate-permissions`);
+    }
+    /**
+     * Manually trigger shared properties propagation from collection to member objects
+     * Useful for debugging and fixing shared properties issues
+     * @param collectionId - The collection ID
+     * @returns Object with collection id, message, and number of objects updated
+     */
+    propagateSharedProperties(collectionId) {
+        return this.post(`/${collectionId}/propagate-shared-props`);
+    }
+}
+exports.CollectionsApi = CollectionsApi;
+//# sourceMappingURL=CollectionsApi.js.map

package/lib/cjs/store/CollectionsApi.js.map

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

package/lib/cjs/store/CommandsApi.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandsApi = void 0;
+const api_fetch_client_1 = require("@vertesia/api-fetch-client");
+const EmbeddingsApi_js_1 = require("./EmbeddingsApi.js");
+/**
+ * @deprecated use EmbeddingsApi instead
+ * @see EmbeddingsApi
+ */
+class CommandsApi extends api_fetch_client_1.ApiTopic {
+    constructor(parent) {
+        super(parent, "/api/v1/commands");
+    }
+    embeddings = new EmbeddingsApi_js_1.EmbeddingsApi(this, "/embeddings");
+}
+exports.CommandsApi = CommandsApi;
+//# sourceMappingURL=CommandsApi.js.map

package/lib/cjs/store/CommandsApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandsApi.js","sourceRoot":"","sources":["../../../src/store/CommandsApi.ts"],"names":[],"mappings":";;;AAAA,iEAAkE;AAClE,yDAAmD;AAEnD;;;GAGG;AACH,MAAa,WAAY,SAAQ,2BAAQ;IAErC,YAAY,MAAkB;QAC1B,KAAK,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACtC,CAAC;IAED,UAAU,GAAG,IAAI,gCAAa,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;CACvD;AAPD,kCAOC"}

package/lib/cjs/store/EmbeddingsApi.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmbeddingsApi = void 0;
+const api_fetch_client_1 = require("@vertesia/api-fetch-client");
+/**
+ * @since 0.52.0
+ */
+class EmbeddingsApi extends api_fetch_client_1.ApiTopic {
+    constructor(parent, basePath = "/api/v1/embeddings") {
+        super(parent, basePath);
+    }
+    async status(type) {
+        return this.get(type + "/status");
+    }
+    async activate(type, config) {
+        if (!config.environment) {
+            throw new Error("Invalid configuration: select environment");
+        }
+        return this.post(type + "/enable", { payload: config });
+    }
+    async disable(type) {
+        return this.post(type + "/disable");
+    }
+    async recalculate(type) {
+        return this.post(type + "/recalculate");
+    }
+}
+exports.EmbeddingsApi = EmbeddingsApi;
+//# sourceMappingURL=EmbeddingsApi.js.map

package/lib/cjs/store/EmbeddingsApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmbeddingsApi.js","sourceRoot":"","sources":["../../../src/store/EmbeddingsApi.ts"],"names":[],"mappings":";;;AAAA,iEAAkE;AAQlE;;GAEG;AACH,MAAa,aAAc,SAAQ,2BAAQ;IAEvC,YAAY,MAAkB,EAAE,WAAmB,oBAAoB;QACnE,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAA6B;QACtC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAA6B,EAAE,MAA+C;QAEzF,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAA6B;QACvC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAA6B;QAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC,CAAC;IAC5C,CAAC;CAEJ;AA3BD,sCA2BC"}

package/lib/cjs/store/FilesApi.js

@@ -0,0 +1,225 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilesApi = exports.ARTIFACTS_PREFIX = exports.MEMORIES_PREFIX = void 0;
+exports.getMemoryFilePath = getMemoryFilePath;
+exports.getAgentArtifactPath = getAgentArtifactPath;
+const api_fetch_client_1 = require("@vertesia/api-fetch-client");
+const StreamSource_js_1 = require("../StreamSource.js");
+exports.MEMORIES_PREFIX = "memories";
+exports.ARTIFACTS_PREFIX = "agents";
+function getMemoryFilePath(name) {
+    const nameWithExt = name.endsWith(".tar.gz") ? name : name + ".tar.gz";
+    return `${exports.MEMORIES_PREFIX}/${nameWithExt}`;
+}
+/**
+ * Build the storage path for an agent artifact
+ * @param runId - The workflow run ID
+ * @param name - The artifact filename
+ */
+function getAgentArtifactPath(runId, name) {
+    return `${exports.ARTIFACTS_PREFIX}/${runId}/${name}`;
+}
+class FilesApi extends api_fetch_client_1.ApiTopic {
+    constructor(parent) {
+        super(parent, "/api/v1/files");
+    }
+    async deleteFile(path, prefix) {
+        const res = await this.delete(`/${path}`, { query: { prefix } });
+        return res.count;
+    }
+    /**
+     * get the metadata of a blob given its URI. Supported URI are:
+     * starting with s3:// and gs://.
+     * For s3 blobs use #region to specify the region. Ex: s3://bucket/key#us-west-2
+     * @param uri
+     * @returns
+     */
+    getMetadata(uri) {
+        return this.get("/metadata", {
+            query: {
+                file: uri,
+            },
+        });
+    }
+    /**
+     * Set custom metadata on a file
+     * @param file - The file path or URI
+     * @param metadata - Custom metadata key-value pairs
+     * @returns Success status
+     */
+    setFileMetadata(file, metadata) {
+        const payload = { file, metadata };
+        return this.put("/metadata", { payload });
+    }
+    /**
+     * Get or create a bucket for the project. If the bucket already exists, it does nothing.
+     * The bucket URI is returned.
+     * @returns
+     */
+    getOrCreateBucket() {
+        return this.post("/bucket");
+    }
+    getUploadUrl(payload) {
+        return this.post("/upload-url", {
+            payload,
+        });
+    }
+    // Strictly typed: provide either simple args or a full payload via a separate method
+    getDownloadUrl(file, name, disposition) {
+        const payload = { file, name, disposition };
+        return this.post("/download-url", { payload });
+    }
+    getDownloadUrlWithOptions(payload) {
+        return this.post("/download-url", { payload });
+    }
+    /**
+     * Upload content to a file and return the full path (including bucket name) of the uploaded file
+     * @param source
+     * @returns
+     */
+    async uploadFile(source) {
+        const isStream = source instanceof StreamSource_js_1.StreamSource;
+        const { url, id, path } = await this.getUploadUrl(source);
+        await fetch(url, {
+            method: "PUT",
+            body: isStream ? source.stream : source,
+            //@ts-ignore: duplex is not in the types. See https://github.com/node-fetch/node-fetch/issues/1769
+            duplex: isStream ? "half" : undefined,
+            headers: {
+                "Content-Type": source.type || "application/gzip",
+            },
+        })
+            .then((res) => {
+            if (res.ok) {
+                return res;
+            }
+            else {
+                console.log(res);
+                throw new Error(`Failed to upload file: ${res.statusText}`);
+            }
+        })
+            .catch((err) => {
+            console.error("Failed to upload file", { err, url, id, path });
+            throw err;
+        });
+        return id;
+    }
+    /**
+     *
+     * @param location can be a relative path in the project, a reference to a cloud storage, or a accessible HTTPS URL (typically signed URL)
+     * @returns ReadableStream
+     */
+    async downloadFile(location) {
+        //if start with HTTPS, no download url needed - assume it's signed already
+        const needSign = !location.startsWith("https:");
+        const { url } = needSign
+            ? await this.getDownloadUrl(location)
+            : { url: location };
+        const res = await fetch(url, {
+            method: "GET",
+        })
+            .then((res) => {
+            if (res.ok) {
+                return res;
+            }
+            else if (res.status === 404) {
+                throw new Error(`File at ${url} not found`); //TODO: type fetch error better with a fetch error class
+            }
+            else if (res.status === 403) {
+                throw new Error(`File at ${url} is forbidden`);
+            }
+            else {
+                console.log(res);
+                throw new Error(`Failed to download file ${location}: ${res.statusText}`);
+            }
+        })
+            .catch((err) => {
+            console.error(`Failed to download file ${location}.`, err);
+            throw err;
+        });
+        if (!res.body) {
+            throw new Error(`No body in response while downloading file ${location}`);
+        }
+        return res.body;
+    }
+    async uploadMemoryPack(source) {
+        const fileId = getMemoryFilePath(source.name);
+        const nameWithExt = source.name.endsWith(".tar.gz")
+            ? source.name
+            : source.name + ".tar.gz";
+        if (source instanceof File) {
+            let file = source;
+            return this.uploadFile(new StreamSource_js_1.StreamSource(file.stream(), nameWithExt, file.type, fileId));
+        }
+        else {
+            return this.uploadFile(new StreamSource_js_1.StreamSource(source.stream, nameWithExt, source.type, fileId));
+        }
+    }
+    async downloadMemoryPack(name, gunzip = false) {
+        let stream = await this.downloadFile(getMemoryFilePath(name));
+        if (gunzip) {
+            const ds = new DecompressionStream("gzip");
+            stream = stream.pipeThrough(ds);
+        }
+        return stream;
+    }
+    // ==================== Agent Artifact Methods ====================
+    /**
+     * List files by prefix
+     * @param prefix - Path prefix to filter files
+     * @returns Array of file paths matching the prefix
+     */
+    listByPrefix(prefix) {
+        return this.get("/list", { query: { prefix } });
+    }
+    /**
+     * Upload an artifact for an agent run
+     * @param runId - The workflow run ID
+     * @param name - Artifact name (e.g., "output.json")
+     * @param source - File content source
+     * @returns The full path of the uploaded artifact
+     */
+    async uploadArtifact(runId, name, source) {
+        const artifactPath = getAgentArtifactPath(runId, name);
+        if (source instanceof File) {
+            const file = source;
+            return this.uploadFile(new StreamSource_js_1.StreamSource(file.stream(), name, file.type, artifactPath));
+        }
+        else {
+            return this.uploadFile(new StreamSource_js_1.StreamSource(source.stream, name, source.type, artifactPath));
+        }
+    }
+    /**
+     * Download an artifact from an agent run
+     * @param runId - The workflow run ID
+     * @param name - Artifact name
+     * @returns ReadableStream of the artifact content
+     */
+    async downloadArtifact(runId, name) {
+        const artifactPath = getAgentArtifactPath(runId, name);
+        return this.downloadFile(artifactPath);
+    }
+    /**
+     * Get download URL for an artifact
+     * @param runId - The workflow run ID
+     * @param name - Artifact name
+     * @param disposition - Content disposition (inline or attachment)
+     * @returns Signed URL response
+     */
+    getArtifactDownloadUrl(runId, name, disposition) {
+        const artifactPath = getAgentArtifactPath(runId, name);
+        return this.getDownloadUrl(artifactPath, name, disposition);
+    }
+    /**
+     * List artifacts for an agent run
+     * @param runId - The workflow run ID
+     * @returns Array of artifact file paths
+     */
+    async listArtifacts(runId) {
+        const prefix = `${exports.ARTIFACTS_PREFIX}/${runId}/`;
+        const result = await this.listByPrefix(prefix);
+        return result.files;
+    }
+}
+exports.FilesApi = FilesApi;
+//# sourceMappingURL=FilesApi.js.map

package/lib/cjs/store/FilesApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilesApi.js","sourceRoot":"","sources":["../../../src/store/FilesApi.ts"],"names":[],"mappings":";;;AAYA,8CAGC;AAOD,oDAEC;AAxBD,iEAAkE;AAOlE,wDAAkD;AAErC,QAAA,eAAe,GAAG,UAAU,CAAC;AAC7B,QAAA,gBAAgB,GAAG,QAAQ,CAAC;AAEzC,SAAgB,iBAAiB,CAAC,IAAY;IAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,SAAS,CAAC;IACvE,OAAO,GAAG,uBAAe,IAAI,WAAW,EAAE,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,KAAa,EAAE,IAAY;IAC5D,OAAO,GAAG,wBAAgB,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,MAAa,QAAS,SAAQ,2BAAQ;IAClC,YAAY,MAAkB;QAC1B,KAAK,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,MAAgB;QAC3C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QACjE,OAAO,GAAG,CAAC,KAAK,CAAC;IACrB,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,GAAW;QAQnB,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE;YACzB,KAAK,EAAE;gBACH,IAAI,EAAE,GAAG;aACZ;SACJ,CAAC,CAAC;IACP,CAAC;IAED;;;;;OAKG;IACH,eAAe,CAAC,IAAY,EAAE,QAAgC;QAC1D,MAAM,OAAO,GAA2B,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACH,iBAAiB;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;IAED,YAAY,CAAC,OAA4B;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE;YAC5B,OAAO;SACV,CAAC,CAAC;IACP,CAAC;IAED,qFAAqF;IACrF,cAAc,CAAC,IAAY,EAAE,IAAa,EAAE,WAAqC;QAC7E,MAAM,OAAO,GAAsB,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,yBAAyB,CAAC,OAA0B;QAChD,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACnD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,MAA2B;QACxC,MAAM,QAAQ,GAAG,MAAM,YAAY,8BAAY,CAAC;QAChD,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAE1D,MAAM,KAAK,CAAC,GAAG,EAAE;YACb,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;YACvC,kGAAkG;YAClG,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;YACrC,OAAO,EAAE;gBACL,cAAc,EAAE,MAAM,CAAC,IAAI,IAAI,kBAAkB;aACpD;SACJ,CAAC;aACG,IAAI,CAAC,CAAC,GAAa,EAAE,EAAE;YACpB,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;gBACT,OAAO,GAAG,CAAC;YACf,CAAC;iBAAM,CAAC;gBACJ,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;YAChE,CAAC;QACL,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACX,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/D,MAAM,GAAG,CAAC;QACd,CAAC,CAAC,CAAC;QAEP,OAAO,EAAE,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,QAAgB;QAC/B,0EAA0E;QAC1E,MAAM,QAAQ,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,EAAE,GAAG,QAAQ;YACpB,CAAC,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC;YACrC,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;QAExB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YACzB,MAAM,EAAE,KAAK;SAChB,CAAC;aACG,IAAI,CAAC,CAAC,GAAa,EAAE,EAAE;YACpB,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;gBACT,OAAO,GAAG,CAAC;YACf,CAAC;iBAAM,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,wDAAwD;YACzG,CAAC;iBAAM,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,WAAW,GAAG,eAAe,CAAC,CAAC;YACnD,CAAC;iBAAM,CAAC;gBACJ,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACjB,MAAM,IAAI,KAAK,CACX,2BAA2B,QAAQ,KAAK,GAAG,CAAC,UAAU,EAAE,CAC3D,CAAC;YACN,CAAC;QACL,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACX,OAAO,CAAC,KAAK,CAAC,2BAA2B,QAAQ,GAAG,EAAE,GAAG,CAAC,CAAC;YAC3D,MAAM,GAAG,CAAC;QACd,CAAC,CAAC,CAAC;QAEP,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACX,8CAA8C,QAAQ,EAAE,CAC3D,CAAC;QACN,CAAC;QAED,OAAO,GAAG,CAAC,IAAI,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,MAA2B;QAC9C,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC/C,CAAC,CAAC,MAAM,CAAC,IAAI;YACb,CAAC,CAAC,MAAM,CAAC,IAAI,GAAG,SAAS,CAAC;QAC9B,IAAI,MAAM,YAAY,IAAI,EAAE,CAAC;YACzB,IAAI,IAAI,GAAG,MAAc,CAAC;YAC1B,OAAO,IAAI,CAAC,UAAU,CAClB,IAAI,8BAAY,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAClE,CAAC;QACN,CAAC;aAAM,CAAC;YACJ,OAAO,IAAI,CAAC,UAAU,CAClB,IAAI,8BAAY,CACZ,MAAM,CAAC,MAAM,EACb,WAAW,EACX,MAAM,CAAC,IAAI,EACX,MAAM,CACT,CACJ,CAAC;QACN,CAAC;IACL,CAAC;IAED,KAAK,CAAC,kBAAkB,CACpB,IAAY,EACZ,SAAkB,KAAK;QAEvB,IAAI,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9D,IAAI,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,GAAG,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAC;YAC3C,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,mEAAmE;IAEnE;;;;OAIG;IACH,YAAY,CAAC,MAAc;QACvB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IACpD,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,cAAc,CAAC,KAAa,EAAE,IAAY,EAAE,MAA2B;QACzE,MAAM,YAAY,GAAG,oBAAoB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACvD,IAAI,MAAM,YAAY,IAAI,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,MAAc,CAAC;YAC5B,OAAO,IAAI,CAAC,UAAU,CAClB,IAAI,8BAAY,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CACjE,CAAC;QACN,CAAC;aAAM,CAAC;YACJ,OAAO,IAAI,CAAC,UAAU,CAClB,IAAI,8BAAY,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CACnE,CAAC;QACN,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,gBAAgB,CAAC,KAAa,EAAE,IAAY;QAC9C,MAAM,YAAY,GAAG,oBAAoB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;OAMG;IACH,sBAAsB,CAClB,KAAa,EACb,IAAY,EACZ,WAAqC;QAErC,MAAM,YAAY,GAAG,oBAAoB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IAChE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,KAAa;QAC7B,MAAM,MAAM,GAAG,GAAG,wBAAgB,IAAI,KAAK,GAAG,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAC/C,OAAO,MAAM,CAAC,KAAK,CAAC;IACxB,CAAC;CACJ;AAxPD,4BAwPC"}