xypriss 9.11.13 → 9.12.0

package/dist/src/xhsc/XyPrissRunner.js

@@ -0,0 +1,395 @@
+import { execFileSync, spawn } from "node:child_process";
+import { XHSC_SIGNATURE } from "../server/const/XHSC_SIGNATURE";
+import { Platform } from "./utils/Platform";
+import { Discovery } from "./utils/Discovery";
+/**
+ * Custom error class for XyPriss system operations.
+ */
+export class XyPrissError extends Error {
+    constructor(module, action, details, raw) {
+        super(`[XyPriss Error] ${module}.${action} failed: ${details}`);
+        this.module = module;
+        this.action = action;
+        this.details = details;
+        this.raw = raw;
+        this.name = "XyPrissError";
+    }
+}
+/**
+ * **Native System Runner**
+ *
+ * This class serves as the core bridge between the Node.js runtime and the
+ * high-performance system core. It manages process spawning, argument
+ * serialization, and bidirectional streaming.
+ */
+export class XyPrissRunner {
+    constructor(root) {
+        this.root = root;
+        this.binaryPath = this.discoverBinary();
+        //  console.log(
+        //      "[XyPrissRunner:getBinaryPath] Binary path: ",
+        //      this.discoverBinary(),
+        //  );
+    }
+    getRoot() {
+        // console.log("[XyPrissRunner:getRoot] Binary root: ", this.root);
+        return this.root;
+    }
+    getBinaryPath() {
+        return this.binaryPath;
+    }
+    /**
+     * Strategic discovery of the XyPriss System binary.
+     * Prioritizes the high-performance Go implementation (XHSC-GO).
+     */
+    discoverBinary() {
+        // 1. Environment Variable Override (Highest Priority)
+        const envPath = Discovery.getFromEnv("XYPRISS_XHSC_PATH");
+        if (envPath)
+            return envPath;
+        const osPart = Platform.getOsPart();
+        const archPart = Platform.getArchPart();
+        const suffix = Platform.getBinarySuffix();
+        // Candidate names in order of preference
+        const goBinName = `xhsc-${osPart}-${archPart}${suffix}`;
+        const genericBinName = osPart === "windows" ? "xhsc.exe" : "xhsc";
+        const candidates = [goBinName, genericBinName];
+        const searchBases = [];
+        // 2. Add Script Directory (where the library is located)
+        const scriptDir = Discovery.getScriptDir();
+        if (scriptDir)
+            searchBases.push(scriptDir);
+        // 3. Add Current Working Directory
+        searchBases.push(process.cwd());
+        // Perform recursive search from all bases using Discovery engine
+        const resolved = Discovery.resolveBinary(candidates, searchBases);
+        if (resolved)
+            return resolved;
+        // Final fallback (generic name which might be in PATH via system spawn)
+        return genericBinName;
+    }
+    /**
+     * Executes a command synchronously and returns the parsed JSON result.
+     * Standardizes all responses into a Promise-like data structure.
+     */
+    runSync(module, action, args = [], options = {}) {
+        const INTERNAL_SIGNATURE = XHSC_SIGNATURE;
+        const cmdArgs = [
+            "--root",
+            this.root,
+            "--signature",
+            INTERNAL_SIGNATURE,
+        ];
+        if (options.verbose)
+            cmdArgs.push("--verbose");
+        if (options.quiet)
+            cmdArgs.push("--quiet");
+        // Only add --json if not in interactive mode
+        if (!options.interactive) {
+            cmdArgs.push("--json");
+        }
+        cmdArgs.push(module, action, ...args);
+        // Add specific flags from options
+        for (const [key, value] of Object.entries(options)) {
+            if (["verbose", "quiet", "json", "interactive", "input"].includes(key))
+                continue;
+            // Convert camelCase to kebab-case (e.g. topCpu -> top-cpu)
+            const flag = key.replace(/[A-Z]/g, (m) => "-" + m.toLowerCase());
+            if (value === true)
+                cmdArgs.push(`--${flag}`);
+            else if (value !== false && value !== undefined) {
+                cmdArgs.push(`--${flag}`, String(value));
+            }
+        }
+        if (options.interactive) {
+            try {
+                // Interactive mode: inherited stdio for real-time terminal output (e.g., watch)
+                execFileSync(this.binaryPath, cmdArgs, {
+                    encoding: "utf8",
+                    stdio: "inherit",
+                    cwd: this.root,
+                });
+            }
+            catch (error) {
+                // Silent catch for interactive interruptions
+            }
+            return undefined;
+        }
+        try {
+            const execOptions = {
+                encoding: "utf8",
+                maxBuffer: 1024 * 1024 * 100, // 100MB buffer
+                stdio: ["ignore", "pipe", "pipe"], // Default: ignore stdin
+                cwd: this.root,
+            };
+            if (options.input !== undefined) {
+                execOptions.input = options.input;
+                execOptions.stdio = ["pipe", "pipe", "pipe"]; // Enable stdin
+            }
+            const output = execFileSync(this.binaryPath, cmdArgs, execOptions);
+            try {
+                let result;
+                try {
+                    result = JSON.parse(output);
+                }
+                catch {
+                    // Robust extraction: find the first { and last }
+                    const start = output.indexOf("{");
+                    const end = output.lastIndexOf("}");
+                    if (start !== -1 && end !== -1 && end > start) {
+                        result = JSON.parse(output.substring(start, end + 1));
+                    }
+                    else {
+                        throw new Error("No JSON found");
+                    }
+                }
+                // Handle both wrapped standard responses and raw direct object responses
+                if (result && typeof result === "object") {
+                    if ("status" in result && "data" in result) {
+                        if (result.status === "error") {
+                            throw new XyPrissError(module, action, result.message || "Unknown error occurred");
+                        }
+                        return result.data;
+                    }
+                    // Assume it's a raw response (like SysInfo)
+                    return result;
+                }
+                return result;
+            }
+            catch (parseError) {
+                // If parsing fails, it's likely a raw text output (e.g., from stream or watch)
+                // Just return the raw string output as T (which would be string in this case)
+                return output;
+            }
+        }
+        catch (error) {
+            // If it's already a XyPrissError, just rethrow it
+            if (error instanceof XyPrissError)
+                throw error;
+            let errorMessage = error.message;
+            // Try to extract JSON error from stdout if it exists
+            if (error.stdout) {
+                try {
+                    const result = JSON.parse(error.stdout.toString());
+                    if (result.status === "error" && result.message) {
+                        errorMessage = result.message;
+                    }
+                }
+                catch {
+                    // Ignore parsing error
+                }
+            }
+            else if (error.stderr) {
+                const stderrMsg = error.stderr.toString().trim();
+                if (stderrMsg)
+                    errorMessage = stderrMsg;
+            }
+            // Strip technical "Command failed:" prefix if present to keep it professional
+            if (errorMessage.includes("Command failed:")) {
+                errorMessage = errorMessage
+                    .replace(/Command failed:.*xhsc" /, "")
+                    .replace(/^.*execSync.*$/m, "") // Remove stack trace lines from message if bun adds them
+                    .trim();
+            }
+            // Remove redundant "Error: " prefix if it double-labels
+            if (errorMessage.startsWith("Error: ")) {
+                errorMessage = errorMessage.substring(7);
+            }
+            throw new XyPrissError(module, action, errorMessage, error);
+        }
+    }
+    /**
+     * Executes a command asynchronously and returns the parsed JSON result.
+     */
+    async runAsync(module, action, args = [], options = {}) {
+        try {
+            const { spawn } = await import("node:child_process");
+            const INTERNAL_SIGNATURE = XHSC_SIGNATURE;
+            const cmdArgs = [
+                "--root",
+                this.root,
+                "--signature",
+                INTERNAL_SIGNATURE,
+                "--json", // Ensure JSON output for parsing
+            ];
+            if (options.verbose)
+                cmdArgs.push("--verbose");
+            if (options.quiet)
+                cmdArgs.push("--quiet");
+            cmdArgs.push(module, action, ...args);
+            // Add specific flags from options
+            for (const [key, value] of Object.entries(options)) {
+                if ([
+                    "verbose",
+                    "quiet",
+                    "json",
+                    "interactive",
+                    "input",
+                ].includes(key))
+                    continue;
+                const flag = key.replace(/[A-Z]/g, (m) => "-" + m.toLowerCase());
+                if (value === true)
+                    cmdArgs.push(`--${flag}`);
+                else if (value !== false && value !== undefined) {
+                    cmdArgs.push(`--${flag}`, String(value));
+                }
+            }
+            return await new Promise((resolve, reject) => {
+                const child = spawn(this.binaryPath, cmdArgs, {
+                    cwd: this.root,
+                });
+                let stdout = "";
+                let stderr = "";
+                if (options.input !== undefined) {
+                    child.stdin.write(options.input);
+                    child.stdin.end();
+                }
+                child.stdout.on("data", (data) => {
+                    stdout += data.toString();
+                });
+                child.stderr.on("data", (data) => {
+                    stderr += data.toString();
+                });
+                child.on("close", (code) => {
+                    if (code !== 0) {
+                        let errorMessage = `Command failed with exit code ${code}`;
+                        try {
+                            const result = JSON.parse(stdout);
+                            if (result.status === "error" && result.message) {
+                                errorMessage = result.message;
+                            }
+                        }
+                        catch {
+                            if (stderr.trim())
+                                errorMessage = stderr.trim();
+                        }
+                        return reject(new XyPrissError(module, action, errorMessage, {
+                            stdout,
+                            stderr,
+                            code,
+                        }));
+                    }
+                    try {
+                        let result;
+                        try {
+                            result = JSON.parse(stdout);
+                        }
+                        catch {
+                            // Robust extraction: find the first { and last }
+                            const start = stdout.indexOf("{");
+                            const end = stdout.lastIndexOf("}");
+                            if (start !== -1 && end !== -1 && end > start) {
+                                result = JSON.parse(stdout.substring(start, end + 1));
+                            }
+                            else {
+                                throw new Error("No JSON found");
+                            }
+                        }
+                        if (result && typeof result === "object") {
+                            if ("status" in result && "data" in result) {
+                                if (result.status === "error") {
+                                    return reject(new XyPrissError(module, action, result.message ||
+                                        "Unknown error occurred"));
+                                }
+                                return resolve(result.data);
+                            }
+                        }
+                        resolve(result);
+                    }
+                    catch (parseError) {
+                        resolve(stdout);
+                    }
+                });
+                child.on("error", (err) => {
+                    reject(new XyPrissError(module, action, err.message, err));
+                });
+            });
+        }
+        catch (error) {
+            if (error instanceof XyPrissError)
+                throw error;
+            let errorMessage = error.message;
+            if (error.stdout) {
+                try {
+                    const result = JSON.parse(error.stdout.toString());
+                    if (result.status === "error" && result.message) {
+                        errorMessage = result.message;
+                    }
+                }
+                catch {
+                    // Ignore parsing error
+                }
+            }
+            else if (error.stderr) {
+                const stderrMsg = error.stderr.toString().trim();
+                if (stderrMsg)
+                    errorMessage = stderrMsg;
+            }
+            throw new XyPrissError(module, action, errorMessage, error);
+        }
+    }
+    /**
+     * Run a module action and return the stdout as a Readable stream
+     */
+    runStream(module, action, args = [], options = {}) {
+        const cmdArgs = [
+            "--root",
+            this.root,
+            "--signature",
+            XHSC_SIGNATURE,
+            module,
+            action,
+            ...args,
+        ];
+        for (const [key, value] of Object.entries(options)) {
+            if (["input"].includes(key))
+                continue;
+            const flag = key.replace(/[A-Z]/g, (m) => "-" + m.toLowerCase());
+            if (value === true)
+                cmdArgs.push(`--${flag}`);
+            else if (value !== false && value !== undefined) {
+                cmdArgs.push(`--${flag}`, String(value));
+            }
+        }
+        const child = spawn(this.binaryPath, cmdArgs, {
+            cwd: this.root,
+        });
+        if (options.input !== undefined) {
+            child.stdin.write(options.input);
+            child.stdin.end();
+        }
+        // Return the stdout stream
+        return child.stdout;
+    }
+    /**
+     * Run a module action and return the stdin as a Writable stream
+     */
+    runWritableStream(module, action, args = [], options = {}) {
+        const cmdArgs = [
+            "--root",
+            this.root,
+            "--signature",
+            XHSC_SIGNATURE,
+            module,
+            action,
+            ...args,
+        ];
+        for (const [key, value] of Object.entries(options)) {
+            const flag = key.replace(/[A-Z]/g, (m) => "-" + m.toLowerCase());
+            if (value === true)
+                cmdArgs.push(`--${flag}`);
+            else if (value !== false && value !== undefined) {
+                cmdArgs.push(`--${flag}`, String(value));
+            }
+        }
+        const child = spawn(this.binaryPath, cmdArgs, {
+            cwd: this.root,
+        });
+        // Return the stdin stream with an explicit close() method
+        const stdin = child.stdin;
+        // @ts-ignore
+        stdin.close = () => stdin.end();
+        return stdin;
+    }
+}
+//# sourceMappingURL=XyPrissRunner.js.map

package/dist/src/xhsc/XyPrissRunner.js.map

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

package/dist/src/xhsc/api/env/env.d.ts

@@ -0,0 +1,227 @@
+export declare const XY_ENV_STORE_KEY: unique symbol;
+export declare const XY_XHSC_REGISTER_FS: unique symbol;
+/** Characters that are unconditionally rejected in environment variable values. */
+export declare const FORBIDDEN_VALUE_PATTERN: RegExp;
+/**
+ * Represents the result of a bulk environment variable retrieval.
+ *
+ * The object is frozen at the moment of creation. Keys map to their
+ * corresponding string values, or `undefined` if the key was requested via
+ * `options.keys` but was not present in the store.
+ */
+export type EnvSnapshot = Readonly<Record<string, string | undefined>>;
+/**
+ * Options accepted by {@link EnvApi.getStrict} to control validation behaviour.
+ */
+export interface EnvGetStrictOptions {
+    /**
+     * When `true`, an empty string is treated as a missing value and triggers
+     * the same {@link EnvAccessError} as a completely absent key.
+     *
+     * @default false
+     */
+    rejectEmpty?: boolean;
+}
+/**
+ * Options accepted by {@link EnvApi.all}.
+ */
+export interface EnvAllOptions {
+    /**
+     * Restricts the snapshot to the listed keys. Keys absent from the store
+     * are included with value `undefined`. When omitted, all stored keys are
+     * returned.
+     *
+     * Providing an explicit key list is strongly preferred in production code
+     * to avoid accidentally surfacing secrets in logs or serialised payloads.
+     *
+     * @example
+     * const subset = __sys__.__env__.all({
+     *   keys: ["DATABASE_URL", "REDIS_URL"],
+     * });
+     */
+    keys?: string[];
+}
+/**
+ * Thrown by {@link EnvApi.getStrict} when a required environment variable is
+ * absent or — when `rejectEmpty` is set — when it is present but empty.
+ *
+ * @example
+ * try {
+ *   const dbUrl = __sys__.__env__.getStrict("DATABASE_URL");
+ * } catch (err) {
+ *   if (err instanceof EnvAccessError) {
+ *     process.exit(1); // Fail fast on missing critical configuration
+ *   }
+ * }
+ */
+export declare class EnvAccessError extends Error {
+    /** The variable name that could not be resolved. */
+    readonly key: string;
+    constructor(key: string, reason: "missing" | "empty");
+}
+/**
+ * Thrown by {@link EnvApi.set} when the key or value fails validation.
+ *
+ * @example
+ * try {
+ *   __sys__.__env__.set("", "value");        // empty key
+ *   __sys__.__env__.set("FOO", "bar\nbaz");  // newline injection attempt
+ * } catch (err) {
+ *   if (err instanceof EnvKeyError) {
+ *     logger.error("Invalid env write", { key: err.key, reason: err.message });
+ *   }
+ * }
+ */
+export declare class EnvKeyError extends Error {
+    readonly key: string;
+    constructor(key: string, reason: string);
+}
+/**
+ * Thrown when {@link EnvApi} methods are called before the internal store has
+ * been initialised by the XyPriss bootstrap process.
+ *
+ * This error should never occur in correctly bootstrapped applications.
+ * If it does, it indicates that framework initialisation was bypassed.
+ */
+export declare class EnvStoreError extends Error {
+    constructor();
+}
+/**
+ * Public contract for the XyPriss Environment Manager.
+ *
+ * All access to environment variables within XyPriss applications must go
+ * through this interface. Direct use of `process.env` is blocked by the
+ * Environment Security Shield and returns `undefined` at runtime.
+ *
+ * @see {@link EnvApi} for the concrete implementation.
+ *
+ * @example
+ * // Reading with a fallback
+ * const port = __sys__.__env__.get("PORT", "3000");
+ *
+ * // Reading a required variable — throws EnvAccessError if absent
+ * const secret = __sys__.__env__.getStrict("JWT_SECRET");
+ *
+ * // Checking the execution mode
+ * if (__sys__.__env__.isProduction()) {
+ *   // Apply production hardening
+ * }
+ */
+export interface IEnvApi {
+    /**
+     * The current execution mode (`"development"`, `"production"`,
+     * `"staging"`, `"test"`, or a custom value). Set once at bootstrap;
+     * never mutated at runtime.
+     */
+    readonly mode: string;
+    /**
+     * Writes an environment variable to the secure internal store.
+     *
+     * @param key   - Non-empty variable name without surrounding whitespace.
+     * @param value - The value to assign. Must not contain CR, LF, or NUL.
+     * @throws {EnvKeyError} When the key or value fails validation.
+     * @throws {EnvStoreError} When called before store initialisation.
+     */
+    set(key: string, value: string): void;
+    /**
+     * Reads an environment variable from the secure internal store.
+     *
+     * @param key          - The variable name to look up.
+     * @param defaultValue - Returned when the key is not defined.
+     * @returns The stored value, or `defaultValue` / `undefined`.
+     * @throws {EnvStoreError} When called before store initialisation.
+     *
+     * @example
+     * const host = __sys__.__env__.get("HOST", "0.0.0.0");
+     */
+    get(key: string): string | undefined;
+    get(key: string, defaultValue: string): string;
+    get(key: string, defaultValue?: string): string | undefined;
+    /**
+     * Reads an environment variable for a specific project root, bypassing caller discovery.
+     * Useful when parsing configuration files on behalf of another project context.
+     *
+     * @param key   - The variable name to look up.
+     * @param root  - The explicit project root to read the environment from.
+     * @returns The stored value, or `undefined`.
+     */
+    getForRoot(key: string, root: string): string | undefined;
+    /**
+     * Reads a required environment variable. Throws when absent.
+     *
+     * @param key     - The variable name to look up.
+     * @param options - Optional validation settings.
+     * @returns The stored value as a guaranteed non-undefined string.
+     * @throws {EnvAccessError} When the variable is missing or empty.
+     * @throws {EnvStoreError} When called before store initialisation.
+     *
+     * @example
+     * const dbUrl    = __sys__.__env__.getStrict("DATABASE_URL");
+     * const jwtKey   = __sys__.__env__.getStrict("JWT_SECRET", { rejectEmpty: true });
+     */
+    getStrict(key: string, options?: EnvGetStrictOptions): string;
+    /**
+     * Returns `true` when the variable is present in the store, regardless of
+     * its value (including empty strings).
+     *
+     * @throws {EnvStoreError} When called before store initialisation.
+     *
+     * @example
+     * if (__sys__.__env__.has("SENTRY_DSN")) {
+     *   Sentry.init({ dsn: __sys__.__env__.get("SENTRY_DSN") });
+     * }
+     */
+    has(key: string): boolean;
+    /**
+     * Removes a variable from the secure internal store and from `process.env`.
+     * Deleting a non-existent key is a no-op.
+     *
+     * @throws {EnvStoreError} When called before store initialisation.
+     *
+     * @example
+     * __sys__.__env__.delete("CI_DEPLOY_TOKEN");
+     */
+    delete(key: string): void;
+    /**
+     * Returns a frozen, point-in-time snapshot of stored variables.
+     *
+     * Providing `options.keys` is strongly recommended in production to avoid
+     * accidentally capturing secrets in logs or serialised payloads.
+     *
+     * @throws {EnvStoreError} When called before store initialisation.
+     *
+     * @example
+     * const dbConfig = __sys__.__env__.all({
+     *   keys: ["DATABASE_URL", "DATABASE_POOL_SIZE"],
+     * });
+     */
+    all(options?: EnvAllOptions): EnvSnapshot;
+    /** Returns `true` when the current execution mode is `"production"`. */
+    isProduction(): boolean;
+    /** Returns `true` when the current execution mode is `"development"`. */
+    isDevelopment(): boolean;
+    /** Returns `true` when the current execution mode is `"staging"`. */
+    isStaging(): boolean;
+    /** Returns `true` when the current execution mode is `"test"`. */
+    isTest(): boolean;
+    /**
+     * Returns `true` when the execution mode matches `envName` exactly
+     * (case-sensitive). Useful for custom environments beyond the four presets.
+     *
+     * @example
+     * if (__sys__.__env__.is("canary")) {
+     *   featureFlags.enableAll();
+     * }
+     */
+    is(envName: string): boolean;
+    /**
+     * Returns the OS-level username of the process owner, resolved via the
+     * XHSC native binary. Returns `""` on failure.
+     *
+     * @example
+     * const actor = __sys__.__env__.user() || "<unknown>";
+     * auditLog.write({ actor, action: "deploy" });
+     */
+    user(): string;
+}
+//# sourceMappingURL=env.d.ts.map

package/dist/src/xhsc/api/env/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../../src/xhsc/api/env/env.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,gBAAgB,eAA6B,CAAC;AAC3D,eAAO,MAAM,mBAAmB,eAAoC,CAAC;AASrE,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,QAAa,CAAC;AAMlD;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAMD;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACrC,oDAAoD;IACpD,SAAgB,GAAG,EAAE,MAAM,CAAC;gBAEhB,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO;CAYvD;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAClC,SAAgB,GAAG,EAAE,MAAM,CAAC;gBAEhB,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAM1C;AAED;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,KAAK;;CASvC;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,OAAO;IACpB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;;;OAOG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtC;;;;;;;;;;OAUG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACrC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAE5D;;;;;;;OAOG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAE1D;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAAC;IAE9D;;;;;;;;;;OAUG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAE1B;;;;;;;;OAQG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,WAAW,CAAC;IAE1C,wEAAwE;IACxE,YAAY,IAAI,OAAO,CAAC;IAExB,yEAAyE;IACzE,aAAa,IAAI,OAAO,CAAC;IAEzB,qEAAqE;IACrE,SAAS,IAAI,OAAO,CAAC;IAErB,kEAAkE;IAClE,MAAM,IAAI,OAAO,CAAC;IAElB;;;;;;;;OAQG;IACH,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAE7B;;;;;;;OAOG;IACH,IAAI,IAAI,MAAM,CAAC;CAClB"}