@terascope/scripts 2.20.0 → 2.21.0

package/dist/src/helpers/bump/index.js

@@ -4,7 +4,7 @@ import { listPackages, isMainPackage, updatePkgJSON, bumpHelmChart } from '../pa
 import { getRootInfo, writeIfChanged } from '../misc.js';
 import { bumpPackagesList, getPackagesToBump, getBumpCommitMessages, bumpVersion } from './utils.js';
 import signale from '../signale.js';
-import { setup } from '../scripts.js';
+import { setup } from '../package-manager.js';
 export async function bumpPackages(options, isAsset) {
     const rootInfo = getRootInfo();
     const _packages = listPackages();

package/dist/src/helpers/bump/index.js.map

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

package/dist/src/helpers/certs.d.ts

@@ -0,0 +1,28 @@
+export declare function readCertFromPath(certPath: string): string;
+/**
+ * Extracts the admin distinguished name (DN) from a certificate.
+ *
+ * This function is designed specifically for mkcert generated certificates.
+ * It reads the certificate file (`opensearch-cert.pem`), extracts the `O`
+ * and `OU` fields from the subject, and formats them
+ * in the required order (`OU` first, `O` second) for OpenSearch authentication.
+ *
+ * @returns {string} The formatted (DN) string in the format:
+ * `"OU=example, O=example"`
+ * @throws {Error} If the certificate file is missing or invalid.
+ *
+ * @example
+ * ```ts
+ * const adminDn = getAdminDnFromCert();
+ * console.log(adminDn);
+ * // Output: "OU=anon@anon-MBP (Anon User),O=mkcert development certificate"
+ * ```
+ */
+export declare function getAdminDnFromCert(): string;
+/**
+ * Generates CA certificates for encrypted services in the test environment if needed
+ *
+ * @throws {Error} If certificate generation fails.
+ */
+export declare function generateTestCaCerts(): Promise<void>;
+//# sourceMappingURL=certs.d.ts.map

package/dist/src/helpers/certs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"certs.d.ts","sourceRoot":"","sources":["../../../src/helpers/certs.ts"],"names":[],"mappings":"AAUA,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAiC3C;AAsLD;;;;GAIG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAmDzD"}

package/dist/src/helpers/certs.js

@@ -0,0 +1,267 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { X509Certificate } from 'node:crypto';
+import { execa } from 'execa';
+import fse from 'fs-extra';
+import { TSError } from '@terascope/core-utils';
+import config from './config.js';
+import signale from './signale.js';
+// Helper function for reading the contents of a certificate by providing its path
+export function readCertFromPath(certPath) {
+    if (!fs.existsSync(certPath)) {
+        throw new TSError(`Unable to find cert at: ${certPath}`);
+    }
+    return fs.readFileSync(certPath, 'utf8');
+}
+/**
+ * Extracts the admin distinguished name (DN) from a certificate.
+ *
+ * This function is designed specifically for mkcert generated certificates.
+ * It reads the certificate file (`opensearch-cert.pem`), extracts the `O`
+ * and `OU` fields from the subject, and formats them
+ * in the required order (`OU` first, `O` second) for OpenSearch authentication.
+ *
+ * @returns {string} The formatted (DN) string in the format:
+ * `"OU=example, O=example"`
+ * @throws {Error} If the certificate file is missing or invalid.
+ *
+ * @example
+ * ```ts
+ * const adminDn = getAdminDnFromCert();
+ * console.log(adminDn);
+ * // Output: "OU=anon@anon-MBP (Anon User),O=mkcert development certificate"
+ * ```
+ */
+export function getAdminDnFromCert() {
+    let ca;
+    let organization;
+    let organizationalUnit;
+    try {
+        ca = readCertFromPath(path.join(config.CERT_PATH, 'opensearch-cert.pem'));
+    }
+    catch (err) {
+        throw new TSError(`Failed to read certificate file (opensearch-cert.pem).\n${err}`);
+    }
+    try {
+        const rootCA = new X509Certificate(ca);
+        // This splits the OU and O in two separate parts
+        const subjectParts = rootCA.subject.split('\n');
+        // Loop through the parts and assign based on prefix
+        // We don't want to assume the order that these are returned
+        for (const part of subjectParts) {
+            if (part.startsWith('OU=')) {
+                organizationalUnit = part;
+            }
+            else if (part.startsWith('O=')) {
+                organization = part;
+            }
+        }
+    }
+    catch (err) {
+        throw new TSError(`Failed to parse openSearch certificate. Make sure it's a valid X.509 certificate.\n${err}`);
+    }
+    if (!organizationalUnit || !organization) {
+        throw new TSError(`Certificate is missing required fields. Expected both 'OU' and 'O' fields.`);
+    }
+    // Return with specific format that opensearch expects
+    return `${organizationalUnit},${organization}`;
+}
+/**
+ * Writes the Opensearch internal_users.yml file with demo user credentials
+ * to the specified certificate directory. This file is required by Opensearch
+ * security configuration to define local user accounts.
+ *
+ * @param certDir - Absolute path to the directory where the file will be written
+ */
+function createInternalUsersFile(certDir) {
+    const content = `# This is the internal user database
+# The hash value is a bcrypt hash and can be generated with plugin/tools/hash.sh
+
+_meta:
+  type: "internalusers"
+  config_version: 2
+
+# Define your internal users here
+
+## Demo users
+# This hash password is passwordsufhbivbU123%$
+admin:
+  hash: "$2y$12$Z234bambHnVJMAXiccuMluNgGhNNdOFIY6pFT2/lk3ZC.RDoDIFme"
+  reserved: true
+  backend_roles:
+  - "admin"
+  description: "Demo admin user"
+anomalyadmin:
+  hash: "$2y$12$TRwAAJgnNo67w3rVUz4FIeLx9Dy/llB79zf9I15CKJ9vkM4ZzAd3."
+  reserved: false
+  opendistro_security_roles:
+  - "anomaly_full_access"
+  description: "Demo anomaly admin user, using internal role"
+kibanaserver:
+  hash: "$2a$12$4AcgAt3xwOWadA5s5blL6ev39OXDNhmOesEoo33eZtrq2N0YrU3H."
+  reserved: true
+  description: "Demo OpenSearch Dashboards user"
+kibanaro:
+  hash: "$2a$12$JJSXNfTowz7Uu5ttXfeYpeYE0arACvcwlPBStB1F.MI7f0U9Z4DGC"
+  reserved: false
+  backend_roles:
+  - "kibanauser"
+  - "readall"
+  attributes:
+    attribute1: "value1"
+    attribute2: "value2"
+    attribute3: "value3"
+  description: "Demo OpenSearch Dashboards read only user, using external role mapping"
+logstash:
+  hash: "$2a$12$u1ShR4l4uBS3Uv59Pa2y5.1uQuZBrZtmNfqB3iM/.jL0XoV9sghS2"
+  reserved: false
+  backend_roles:
+  - "logstash"
+  description: "Demo logstash user, using external role mapping"
+readall:
+  hash: "$2a$12$ae4ycwzwvLtZxwZ82RmiEunBbIPiAmGZduBAjKN0TXdwQFtCwARz2"
+  reserved: false
+  backend_roles:
+  - "readall"
+  description: "Demo readall user, using external role mapping"
+snapshotrestore:
+  hash: "$2y$12$DpwmetHKwgYnorbgdvORCenv4NAK8cPUg8AI6pxLCuWf/ALc0.v7W"
+  reserved: false
+  backend_roles:
+  - "snapshotrestore"
+  description: "Demo snapshotrestore user, using external role mapping"
+`;
+    fs.writeFileSync(path.join(certDir, 'internal_users.yml'), content, 'utf8');
+}
+/**
+ * Generates TLS certs using mkcert and organizes the output files
+ * into the layout expected by each service format.
+ *
+ * mkcert creates a locally-trusted CA and issues certificates signed by it.
+ * This function handles the full lifecycle:
+ *   1. Runs mkcert to produce a key + certificate for the given DNS names
+ *   2. Copies the root CA certificate into a CAs/ subdirectory
+ *   3. Renames/copies files into the structure each service expects
+ *   4. Cleans up the raw mkcert output files
+ *
+ * Supported formats:
+ *   - `minio`      → private.key, public.crt
+ *   - `opensearch` → opensearch-key.pem, opensearch-cert.pem, internal_users.yml
+ *   - `kafka`      → kafka-keypair.pem (key + cert concatenated)
+ *
+ * @param formats  - List of service formats to produce (e.g. ['minio', 'opensearch'])
+ * @param dirPath  - Absolute path to the output directory (recreated if it already exists)
+ * @param dnsNames - DNS names / IPs the certificate should be valid for
+ * @throws {Error} If mkcert is not installed, dirPath is relative, or cert files cannot be found
+ */
+async function generateCerts(formats, dirPath, dnsNames) {
+    // mkcert must be installed
+    try {
+        await execa('mkcert', ['--version']);
+    }
+    catch {
+        throw new Error('mkcert is not installed. Please install mkcert and try again.');
+    }
+    if (!path.isAbsolute(dirPath)) {
+        throw new Error('dirPath must be an absolute path');
+    }
+    if (dnsNames.length === 0) {
+        throw new Error('At least one DNS name is required');
+    }
+    // Always start with a clean dir in the case there is stuff here
+    if (fse.existsSync(dirPath)) {
+        await fse.remove(dirPath);
+    }
+    await fse.mkdirp(dirPath);
+    // Run mkcert in the output directory — it writes the key and cert files there
+    await execa('mkcert', ['--client', ...dnsNames], { cwd: dirPath });
+    // mkcert stores its root CA in a system dir. copy it into our cert dir
+    const { stdout: caRoot } = await execa('mkcert', ['-CAROOT']);
+    fse.copySync(path.join(caRoot.trim(), 'rootCA.pem'), path.join(dirPath, 'rootCA.pem'));
+    // Move the root CA into a CAs/ subdirectory. Keeps it organized
+    await fse.mkdirp(path.join(dirPath, 'CAs'));
+    fse.moveSync(path.join(dirPath, 'rootCA.pem'), path.join(dirPath, 'CAs', 'rootCA.pem'));
+    // mkcert names its output files based on the DNS names, so we locate them by pattern
+    const files = fs.readdirSync(dirPath);
+    const privateKeyName = files.find((f) => f.toLowerCase().includes('key.pem'));
+    const publicCertName = files.find((f) => f.toLowerCase().endsWith('.pem') && !f.toLowerCase().includes('key.pem'));
+    if (!privateKeyName || !publicCertName) {
+        throw new Error(`Could not locate key.pem or public cert in ${dirPath}`);
+    }
+    const privateKeyPath = path.join(dirPath, privateKeyName);
+    const publicCertPath = path.join(dirPath, publicCertName);
+    // Copy/rename files into the layout each service expects. Each service like it in
+    // a specific format.
+    for (const format of formats) {
+        switch (format) {
+            case 'minio':
+                // https://min.io/docs/minio/linux/operations/network-encryption.html
+                fse.copySync(privateKeyPath, path.join(dirPath, 'private.key'));
+                fse.copySync(publicCertPath, path.join(dirPath, 'public.crt'));
+                break;
+            case 'opensearch':
+                // https://opensearch.org/docs/latest/security/configuration/tls/#x509-pem-certificates-and-pkcs-8-keys
+                fse.copySync(privateKeyPath, path.join(dirPath, 'opensearch-key.pem'));
+                fse.copySync(publicCertPath, path.join(dirPath, 'opensearch-cert.pem'));
+                // Opensearch also needs a user database file alongside the certs
+                createInternalUsersFile(dirPath);
+                break;
+            case 'kafka': {
+                // https://kafka.apache.org/42/security/encryption-and-authentication-using-ssl/
+                // Kafka expects key and cert in a single PEM file
+                const keyContent = fs.readFileSync(privateKeyPath, 'utf8');
+                const certContent = fs.readFileSync(publicCertPath, 'utf8');
+                fs.writeFileSync(path.join(dirPath, 'kafka-keypair.pem'), keyContent + certContent, 'utf8');
+                break;
+            }
+            default:
+                signale.warn(`Unknown format '${format}' ignored.`);
+        }
+    }
+    // Remove the original mkcert files now that we've copied and renamed them
+    if (formats.length > 0) {
+        fs.unlinkSync(privateKeyPath);
+        fs.unlinkSync(publicCertPath);
+    }
+    // Make sure all cert files are readable
+    await execa('chmod', ['-R', 'a+rX', dirPath]);
+}
+/**
+ * Generates CA certificates for encrypted services in the test environment if needed
+ *
+ * @throws {Error} If certificate generation fails.
+ */
+export async function generateTestCaCerts() {
+    const encryptedServices = [];
+    const hostNames = ['localhost'];
+    if (config.ENCRYPT_OPENSEARCH) {
+        encryptedServices.push('opensearch');
+        hostNames.push('opensearch2.services-dev1', 'opensearch3.services-dev1', 'opensearch', config.OPENSEARCH_HOSTNAME);
+    }
+    if (config.ENCRYPT_MINIO) {
+        encryptedServices.push('minio');
+        hostNames.push('minio.services-dev1', 'minio', config.MINIO_HOSTNAME);
+    }
+    if (config.ENCRYPT_KAFKA) {
+        encryptedServices.push('kafka');
+        hostNames.push('kafka-headless.services-dev1.svc.cluster.local', 'kafka-headless.services-dev1', 'kafka-headless', 'kafka', config.KAFKA_HOSTNAME);
+    }
+    if (encryptedServices.length > 0) {
+        // Formats the encrypted service list to print with the user feedback
+        const serviceList = encryptedServices.length === 1
+            ? encryptedServices[0]
+            : encryptedServices.length === 2
+                ? encryptedServices.join(' and ')
+                : `${encryptedServices.slice(0, -1).join(', ')} and ${encryptedServices[encryptedServices.length - 1]}`;
+        try {
+            signale.pending(`Generating new ca-certificates for ${serviceList}...`);
+            signale.debug('Generating certs: ', { formats: encryptedServices, dirPath: config.CERT_PATH, dnsNames: hostNames });
+            await generateCerts(encryptedServices, config.CERT_PATH, hostNames);
+            signale.success(`Created certs in ${config.CERT_PATH}`);
+        }
+        catch (err) {
+            throw new Error(`Error generating ca-certificates for ${serviceList}: ${err.message}`);
+        }
+    }
+}
+//# sourceMappingURL=certs.js.map

package/dist/src/helpers/certs.js.map

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

package/dist/src/helpers/doc-builder/index.js

@@ -1,6 +1,6 @@
 import path from 'node:path';
 import { updateReadme, ensureOverview } from './overview.js';
-import { build } from '../scripts.js';
+import { build } from '../package-manager.js';
 import { updateSidebarJSON } from './sidebar.js';
 import { generateTSDocs } from './typedoc.js';
 import { getRootDir, writePkgHeader } from '../misc.js';

package/dist/src/helpers/doc-builder/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/helpers/doc-builder/index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAuB;IACvD,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC7B,cAAc,CAAC,eAAe,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;QAEpD,IAAI,OAAO,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC;YAClC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC9E,MAAM,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YACzC,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;QAED,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;QAC5B,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/helpers/doc-builder/index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAuB;IACvD,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC7B,cAAc,CAAC,eAAe,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;QAEpD,IAAI,OAAO,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC;YAClC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC9E,MAAM,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YACzC,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;QAED,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;QAC5B,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC"}

package/dist/src/helpers/docker.d.ts

@@ -0,0 +1,78 @@
+import { type ExecEnv } from './exec.js';
+export declare function dockerPull(image: string, timeout?: number): Promise<void>;
+export declare function dockerStop(name: string): Promise<void>;
+export declare function dockerTag(from: string, to: string): Promise<void>;
+export declare function getNodeVersionFromImage(image: string): Promise<string>;
+export declare function getContainerInfo(name: string): Promise<any>;
+export declare function dockerNetworkExists(name: string): Promise<boolean>;
+export declare function remoteDockerImageExists(image: string): Promise<boolean>;
+export type DockerRunOptions = {
+    name: string;
+    image: string;
+    ports?: (number | string)[];
+    tmpfs?: string[];
+    env?: ExecEnv;
+    network?: string;
+    args?: string[];
+    mount?: string[];
+};
+export declare function dockerRun(opt: DockerRunOptions, tag?: string, ignoreMount?: boolean, debug?: boolean): Promise<() => void>;
+export declare function dockerContainerReady(name: string, upFor: number, error: any): Promise<boolean>;
+export declare function dockerBuild(tag: string, cacheFrom?: string[], target?: string, buildArgs?: string[], dockerFileName?: string, dockerFilePath?: string): Promise<void>;
+export declare function dockerPush(image: string): Promise<void>;
+export declare function dockerExec(containerName: string, command: string[]): Promise<void>;
+/**
+ * Unzips and loads a Docker image from a Docker cache
+ * If successful and skipDelete is false the image will be deleted from the cache
+ * @param {string} imageName Name of the image to load
+ * @param {boolean} skipDelete Skip removal of docker image from cache
+ * @returns {Promise<boolean>} Whether or not the image loaded successfully
+ */
+export declare function loadThenDeleteImageFromCache(imageName: string, skipDelete?: boolean): Promise<boolean>;
+export declare function deleteDockerImageCache(): Promise<void>;
+/**
+ * Save a docker image as a tar.gz to a local directory.
+ * Then remove the image from docker
+ * @param {string} imageName Name of image to pull and save
+ * @param {string} imageSavePath Location where image will be saved and compressed.
+ * @returns void
+ */
+export declare function saveAndZip(imageName: string, imageSavePath: string): Promise<void>;
+/**
+ * Extracts the base Docker image information from the top-level Dockerfile
+ *
+ * This function parses the Dockerfile to determine the base image name,
+ * node version, registry, and repository.
+ *
+ * @throws {TSError} If the Dockerfile cannot be read or the base image format is unexpected.
+ * @returns {{
+*   name: string;
+*   tag: string;
+*   registry: string;
+*   repo: string;
+* }} An object containing:
+*    - `name: Full base image name
+*    - `tag`: Node version used in the image
+*    - `registry`: Docker registry (defaults to `docker.io` if not specified)
+*    - `repo`: Repository name including organization
+*/
+export declare function getDockerBaseImageInfo(): {
+    name: string;
+    tag: string;
+    registry: string;
+    repo: string;
+};
+/**
+ * Retrieves the Node.js version from the base Docker image specified in the Teraslice `Dockerfile`.
+ *
+ * This function:
+ * - Extracts the base image details from the `Dockerfile`
+ * - Authenticates with the container registry to retrieve a token
+ * - Fetches the image manifest and configuration
+ * - Extracts the `node_version` label from the image config
+ *
+ * @throws {TSError} If any request to the registry fails or expected data is missing.
+ * @returns {Promise<string>} Resolves with the Node.js version string.
+ */
+export declare function grabCurrentTSNodeVersion(): Promise<string>;
+//# sourceMappingURL=docker.d.ts.map

package/dist/src/helpers/docker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["../../../src/helpers/docker.ts"],"names":[],"mappings":"AASA,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAKrD,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAW1E;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK5D;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOvE;AAED,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAU5E;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAQjE;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMxE;AAED,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO7E;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,wBAAsB,SAAS,CAC3B,GAAG,EAAE,gBAAgB,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,OAAO,GAC5E,OAAO,CAAC,MAAM,IAAI,CAAC,CAmHrB;AAED,wBAAsB,oBAAoB,CACtC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,GAAG,GACX,OAAO,CAAC,OAAO,CAAC,CAoBlB;AAED,wBAAsB,WAAW,CAC7B,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,EAAE,EACpB,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAAE,EACpB,cAAc,CAAC,EAAE,MAAM,EACvB,cAAc,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS7D;AAED,wBAAsB,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CASxF;AAaD;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAC9C,SAAS,EAAE,MAAM,EACjB,UAAU,UAAQ,GACnB,OAAO,CAAC,OAAO,CAAC,CA0BlB;AAED,wBAAsB,sBAAsB,kBAG3C;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,iBAOxE;AAED;;;;;;;;;;;;;;;;;EAiBE;AACF,wBAAgB,sBAAsB;;;;;EAoBrC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,MAAM,CAAC,CAiFhE"}