@start9labs/start-sdk 0.3.6-alpha1

package/cjs/lib/mainFn/Daemons.d.ts

@@ -0,0 +1,113 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { Signals } from "../StartSdk";
+import { HealthReceipt } from "../health/HealthReceipt";
+import { CheckResult } from "../health/checkFns";
+import { SDKManifest } from "../manifest/ManifestTypes";
+import { Trigger } from "../trigger";
+import { Effects, ValidIfNoStupidEscape } from "../types";
+import { MountOptions, Overlay } from "../util/Overlay";
+import * as CP from "node:child_process";
+export { Daemon } from "./Daemon";
+export { CommandController } from "./CommandController";
+import { HealthDaemon } from "./HealthDaemon";
+import { Daemon } from "./Daemon";
+import { CommandController } from "./CommandController";
+export declare const cpExecFile: typeof CP.execFile.__promisify__;
+export type Ready = {
+    display: string | null;
+    fn: () => Promise<CheckResult> | CheckResult;
+    trigger?: Trigger;
+};
+type DaemonsParams<Manifest extends SDKManifest, Ids extends string, Command extends string, Id extends string> = {
+    command: ValidIfNoStupidEscape<Command> | [string, ...string[]];
+    image: {
+        id: Manifest["images"][number];
+        sharedRun?: boolean;
+    };
+    mounts: {
+        path: string;
+        options: MountOptions;
+    }[];
+    env?: Record<string, string>;
+    ready: Ready;
+    requires: Exclude<Ids, Id>[];
+};
+type ErrorDuplicateId<Id extends string> = `The id '${Id}' is already used`;
+export declare const runCommand: <Manifest extends SDKManifest>() => <A extends string>(effects: Effects, imageId: {
+    id: Manifest["images"][number];
+    sharedRun?: boolean | undefined;
+}, command: [string, ...string[]] | ValidIfNoStupidEscape<A>, options: {
+    mounts?: {
+        path: string;
+        options: MountOptions;
+    }[] | undefined;
+    overlay?: Overlay | undefined;
+    env?: {
+        [variable: string]: string;
+    } | undefined;
+    cwd?: string | undefined;
+    user?: string | undefined;
+    onStdout?: ((x: Buffer) => void) | undefined;
+    onStderr?: ((x: Buffer) => void) | undefined;
+}) => Promise<CommandController>;
+/**
+ * A class for defining and controlling the service daemons
+```ts
+Daemons.of({
+  effects,
+  started,
+  interfaceReceipt, // Provide the interfaceReceipt to prove it was completed
+  healthReceipts, // Provide the healthReceipts or [] to prove they were at least considered
+}).addDaemon('webui', {
+  command: 'hello-world', // The command to start the daemon
+  ready: {
+    display: 'Web Interface',
+    // The function to run to determine the health status of the daemon
+    fn: () =>
+      checkPortListening(effects, 80, {
+        successMessage: 'The web interface is ready',
+        errorMessage: 'The web interface is not ready',
+      }),
+  },
+  requires: [],
+})
+```
+ */
+export declare class Daemons<Manifest extends SDKManifest, Ids extends string> {
+    readonly effects: Effects;
+    readonly started: (onTerm: () => PromiseLike<void>) => PromiseLike<void>;
+    readonly daemons: Promise<Daemon>[];
+    readonly ids: Ids[];
+    readonly healthDaemons: HealthDaemon[];
+    private constructor();
+    /**
+     * Returns an empty new Daemons class with the provided config.
+     *
+     * Call .addDaemon() on the returned class to add a daemon.
+     *
+     * Daemons run in the order they are defined, with latter daemons being capable of
+     * depending on prior daemons
+     * @param config
+     * @returns
+     */
+    static of<Manifest extends SDKManifest>(config: {
+        effects: Effects;
+        started: (onTerm: () => PromiseLike<void>) => PromiseLike<void>;
+        healthReceipts: HealthReceipt[];
+    }): Daemons<Manifest, never>;
+    /**
+     * Returns the complete list of daemons, including the one defined here
+     * @param id
+     * @param newDaemon
+     * @returns
+     */
+    addDaemon<Id extends string, Command extends string>(id: "" extends Id ? never : ErrorDuplicateId<Id> extends Id ? never : Id extends Ids ? ErrorDuplicateId<Id> : Id, options: DaemonsParams<Manifest, Ids, Command, Id>): Daemons<Manifest, Ids | Id>;
+    build(): Promise<{
+        term: (options?: {
+            signal?: Signals;
+            timeout?: number;
+        }) => Promise<void>;
+    }>;
+    private updateMainHealth;
+}

package/cjs/lib/mainFn/Daemons.js

@@ -0,0 +1,128 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Daemons = exports.runCommand = exports.cpExecFile = exports.CommandController = exports.Daemon = void 0;
+const node_util_1 = require("node:util");
+const CP = __importStar(require("node:child_process"));
+var Daemon_1 = require("./Daemon");
+Object.defineProperty(exports, "Daemon", { enumerable: true, get: function () { return Daemon_1.Daemon; } });
+var CommandController_1 = require("./CommandController");
+Object.defineProperty(exports, "CommandController", { enumerable: true, get: function () { return CommandController_1.CommandController; } });
+const HealthDaemon_1 = require("./HealthDaemon");
+const Daemon_2 = require("./Daemon");
+const CommandController_2 = require("./CommandController");
+const cpExec = (0, node_util_1.promisify)(CP.exec);
+exports.cpExecFile = (0, node_util_1.promisify)(CP.execFile);
+const runCommand = () => CommandController_2.CommandController.of();
+exports.runCommand = runCommand;
+/**
+ * A class for defining and controlling the service daemons
+```ts
+Daemons.of({
+  effects,
+  started,
+  interfaceReceipt, // Provide the interfaceReceipt to prove it was completed
+  healthReceipts, // Provide the healthReceipts or [] to prove they were at least considered
+}).addDaemon('webui', {
+  command: 'hello-world', // The command to start the daemon
+  ready: {
+    display: 'Web Interface',
+    // The function to run to determine the health status of the daemon
+    fn: () =>
+      checkPortListening(effects, 80, {
+        successMessage: 'The web interface is ready',
+        errorMessage: 'The web interface is not ready',
+      }),
+  },
+  requires: [],
+})
+```
+ */
+class Daemons {
+    constructor(effects, started, daemons, ids, healthDaemons) {
+        this.effects = effects;
+        this.started = started;
+        this.daemons = daemons;
+        this.ids = ids;
+        this.healthDaemons = healthDaemons;
+    }
+    /**
+     * Returns an empty new Daemons class with the provided config.
+     *
+     * Call .addDaemon() on the returned class to add a daemon.
+     *
+     * Daemons run in the order they are defined, with latter daemons being capable of
+     * depending on prior daemons
+     * @param config
+     * @returns
+     */
+    static of(config) {
+        return new Daemons(config.effects, config.started, [], [], []);
+    }
+    /**
+     * Returns the complete list of daemons, including the one defined here
+     * @param id
+     * @param newDaemon
+     * @returns
+     */
+    addDaemon(
+    // prettier-ignore
+    id, options) {
+        const daemonIndex = this.daemons.length;
+        const daemon = Daemon_2.Daemon.of()(this.effects, options.image, options.command, options);
+        const healthDaemon = new HealthDaemon_1.HealthDaemon(daemon, daemonIndex, options.requires
+            .map((x) => this.ids.indexOf(id))
+            .filter((x) => x >= 0)
+            .map((id) => this.healthDaemons[id]), id, this.ids, options.ready, this.effects);
+        const daemons = this.daemons.concat(daemon);
+        const ids = [...this.ids, id];
+        const healthDaemons = [...this.healthDaemons, healthDaemon];
+        return new Daemons(this.effects, this.started, daemons, ids, healthDaemons);
+    }
+    async build() {
+        this.updateMainHealth();
+        this.healthDaemons.forEach((x) => x.addWatcher(() => this.updateMainHealth()));
+        return {
+            term: async (options) => {
+                try {
+                    await Promise.all(this.healthDaemons.map((x) => x.term(options)));
+                }
+                finally {
+                    this.effects.setMainStatus({ status: "stopped" });
+                }
+            },
+        };
+    }
+    updateMainHealth() {
+        if (this.healthDaemons.every((x) => x.health.status === "success")) {
+            this.effects.setMainStatus({ status: "running" });
+        }
+        else {
+            this.effects.setMainStatus({ status: "starting" });
+        }
+    }
+}
+exports.Daemons = Daemons;
+//# sourceMappingURL=Daemons.js.map

package/cjs/lib/mainFn/Daemons.js.map

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

package/cjs/lib/mainFn/HealthDaemon.d.ts

@@ -0,0 +1,36 @@
+/// <reference types="node" />
+import { CheckResult } from "../health/checkFns";
+import { Ready } from "./Daemons";
+import { Daemon } from "./Daemon";
+import { Effects } from "../types";
+/**
+ * Wanted a structure that deals with controlling daemons by their health status
+ * States:
+ * -- Waiting for dependencies to be success
+ * -- Running: Daemon is running and the status is in the health
+ *
+ */
+export declare class HealthDaemon {
+    #private;
+    readonly daemon: Promise<Daemon>;
+    readonly daemonIndex: number;
+    readonly dependencies: HealthDaemon[];
+    readonly id: string;
+    readonly ids: string[];
+    readonly ready: Ready;
+    readonly effects: Effects;
+    constructor(daemon: Promise<Daemon>, daemonIndex: number, dependencies: HealthDaemon[], id: string, ids: string[], ready: Ready, effects: Effects);
+    /** Run after we want to do cleanup */
+    term(termOptions?: {
+        signal?: NodeJS.Signals | undefined;
+        timeout?: number | undefined;
+    }): Promise<void>;
+    /** Want to add another notifier that the health might have changed */
+    addWatcher(watcher: () => unknown): void;
+    get health(): Readonly<CheckResult>;
+    private changeRunning;
+    private turnOffHealthCheck;
+    private setupHealthCheck;
+    private setHealth;
+    private updateStatus;
+}

package/cjs/lib/mainFn/HealthDaemon.js

@@ -0,0 +1,146 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _HealthDaemon_health, _HealthDaemon_healthWatchers, _HealthDaemon_running, _HealthDaemon_hadSuccess, _HealthDaemon_healthCheckCleanup;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthDaemon = void 0;
+const defaultTrigger_1 = require("../trigger/defaultTrigger");
+const oncePromise = () => {
+    let resolve;
+    const promise = new Promise((res) => {
+        resolve = res;
+    });
+    return { resolve: resolve, promise };
+};
+/**
+ * Wanted a structure that deals with controlling daemons by their health status
+ * States:
+ * -- Waiting for dependencies to be success
+ * -- Running: Daemon is running and the status is in the health
+ *
+ */
+class HealthDaemon {
+    constructor(daemon, daemonIndex, dependencies, id, ids, ready, effects) {
+        this.daemon = daemon;
+        this.daemonIndex = daemonIndex;
+        this.dependencies = dependencies;
+        this.id = id;
+        this.ids = ids;
+        this.ready = ready;
+        this.effects = effects;
+        _HealthDaemon_health.set(this, { status: "starting", message: null });
+        _HealthDaemon_healthWatchers.set(this, []);
+        _HealthDaemon_running.set(this, false);
+        _HealthDaemon_hadSuccess.set(this, false);
+        _HealthDaemon_healthCheckCleanup.set(this, null);
+        this.updateStatus();
+        this.dependencies.forEach((d) => d.addWatcher(() => this.updateStatus()));
+    }
+    /** Run after we want to do cleanup */
+    async term(termOptions) {
+        var _a;
+        __classPrivateFieldSet(this, _HealthDaemon_healthWatchers, [], "f");
+        __classPrivateFieldSet(this, _HealthDaemon_running, false, "f");
+        (_a = __classPrivateFieldGet(this, _HealthDaemon_healthCheckCleanup, "f")) === null || _a === void 0 ? void 0 : _a.call(this);
+        await this.daemon.then((d) => d.stop(termOptions));
+    }
+    /** Want to add another notifier that the health might have changed */
+    addWatcher(watcher) {
+        __classPrivateFieldGet(this, _HealthDaemon_healthWatchers, "f").push(watcher);
+    }
+    get health() {
+        return Object.freeze(__classPrivateFieldGet(this, _HealthDaemon_health, "f"));
+    }
+    async changeRunning(newStatus) {
+        if (__classPrivateFieldGet(this, _HealthDaemon_running, "f") === newStatus)
+            return;
+        __classPrivateFieldSet(this, _HealthDaemon_running, newStatus, "f");
+        if (newStatus) {
+            ;
+            (await this.daemon).start();
+            this.setupHealthCheck();
+        }
+        else {
+            ;
+            (await this.daemon).stop();
+            this.turnOffHealthCheck();
+            this.setHealth({ status: "starting", message: null });
+        }
+    }
+    turnOffHealthCheck() {
+        var _a;
+        (_a = __classPrivateFieldGet(this, _HealthDaemon_healthCheckCleanup, "f")) === null || _a === void 0 ? void 0 : _a.call(this);
+    }
+    async setupHealthCheck() {
+        var _a;
+        if (__classPrivateFieldGet(this, _HealthDaemon_healthCheckCleanup, "f"))
+            return;
+        const trigger = ((_a = this.ready.trigger) !== null && _a !== void 0 ? _a : defaultTrigger_1.defaultTrigger)(() => ({
+            hadSuccess: __classPrivateFieldGet(this, _HealthDaemon_hadSuccess, "f"),
+            lastResult: __classPrivateFieldGet(this, _HealthDaemon_health, "f").status,
+        }));
+        const { promise: status, resolve: setStatus } = oncePromise();
+        new Promise(async () => {
+            for (let res = await Promise.race([status, trigger.next()]); !res.done; res = await Promise.race([status, trigger.next()])) {
+                const response = await Promise.resolve(this.ready.fn()).catch((err) => {
+                    console.error(err);
+                    return {
+                        status: "failure",
+                        message: "message" in err ? err.message : String(err),
+                    };
+                });
+                this.setHealth(response);
+                if (response.status === "success") {
+                    __classPrivateFieldSet(this, _HealthDaemon_hadSuccess, true, "f");
+                }
+            }
+        }).catch((err) => console.error(`Daemon ${this.id} failed: ${err}`));
+        __classPrivateFieldSet(this, _HealthDaemon_healthCheckCleanup, () => {
+            setStatus({ done: true });
+            __classPrivateFieldSet(this, _HealthDaemon_healthCheckCleanup, null, "f");
+        }, "f");
+    }
+    setHealth(health) {
+        __classPrivateFieldSet(this, _HealthDaemon_health, health, "f");
+        __classPrivateFieldGet(this, _HealthDaemon_healthWatchers, "f").forEach((watcher) => watcher());
+        const display = this.ready.display;
+        const status = health.status;
+        if (!display) {
+            return;
+        }
+        if (status === "success" ||
+            status === "disabled" ||
+            status === "starting") {
+            this.effects.setHealth({
+                result: status,
+                message: health.message,
+                id: display,
+                name: display,
+            });
+        }
+        else {
+            this.effects.setHealth({
+                result: health.status,
+                message: health.message || "",
+                id: display,
+                name: display,
+            });
+        }
+    }
+    async updateStatus() {
+        const healths = this.dependencies.map((d) => __classPrivateFieldGet(d, _HealthDaemon_health, "f"));
+        this.changeRunning(healths.every((x) => x.status === "success"));
+    }
+}
+exports.HealthDaemon = HealthDaemon;
+_HealthDaemon_health = new WeakMap(), _HealthDaemon_healthWatchers = new WeakMap(), _HealthDaemon_running = new WeakMap(), _HealthDaemon_hadSuccess = new WeakMap(), _HealthDaemon_healthCheckCleanup = new WeakMap();
+//# sourceMappingURL=HealthDaemon.js.map

package/cjs/lib/mainFn/HealthDaemon.js.map

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

package/cjs/lib/mainFn/Mounts.d.ts

@@ -0,0 +1,33 @@
+import { SDKManifest } from "../manifest/ManifestTypes";
+import { MountOptions } from "../util/Overlay";
+type MountArray = {
+    path: string;
+    options: MountOptions;
+}[];
+export declare class Mounts<Manifest extends SDKManifest> {
+    readonly volumes: {
+        id: Manifest["volumes"][number];
+        subpath: string | null;
+        mountpoint: string;
+        readonly: boolean;
+    }[];
+    readonly assets: {
+        id: Manifest["assets"][number];
+        subpath: string | null;
+        mountpoint: string;
+    }[];
+    readonly dependencies: {
+        dependencyId: string;
+        volumeId: string;
+        subpath: string | null;
+        mountpoint: string;
+        readonly: boolean;
+    }[];
+    private constructor();
+    static of<Manifest extends SDKManifest>(): Mounts<Manifest>;
+    addVolume(id: Manifest["volumes"][number], subpath: string | null, mountpoint: string, readonly: boolean): this;
+    addAssets(id: Manifest["assets"][number], subpath: string | null, mountpoint: string): this;
+    addDependency<DependencyManifest extends SDKManifest>(dependencyId: keyof Manifest["dependencies"] & string, volumeId: DependencyManifest["volumes"][number], subpath: string | null, mountpoint: string, readonly: boolean): this;
+    build(): MountArray;
+}
+export {};

package/cjs/lib/mainFn/Mounts.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Mounts = void 0;
+class Mounts {
+    constructor(volumes, assets, dependencies) {
+        this.volumes = volumes;
+        this.assets = assets;
+        this.dependencies = dependencies;
+    }
+    static of() {
+        return new Mounts([], [], []);
+    }
+    addVolume(id, subpath, mountpoint, readonly) {
+        this.volumes.push({
+            id,
+            subpath,
+            mountpoint,
+            readonly,
+        });
+        return this;
+    }
+    addAssets(id, subpath, mountpoint) {
+        this.assets.push({
+            id,
+            subpath,
+            mountpoint,
+        });
+        return this;
+    }
+    addDependency(dependencyId, volumeId, subpath, mountpoint, readonly) {
+        this.dependencies.push({
+            dependencyId,
+            volumeId,
+            subpath,
+            mountpoint,
+            readonly,
+        });
+        return this;
+    }
+    build() {
+        const mountpoints = new Set();
+        for (let mountpoint of this.volumes
+            .map((v) => v.mountpoint)
+            .concat(this.assets.map((a) => a.mountpoint))
+            .concat(this.dependencies.map((d) => d.mountpoint))) {
+            if (mountpoints.has(mountpoint)) {
+                throw new Error(`cannot mount more than once to mountpoint ${mountpoint}`);
+            }
+            mountpoints.add(mountpoint);
+        }
+        return []
+            .concat(this.volumes.map((v) => ({
+            path: v.mountpoint,
+            options: {
+                type: "volume",
+                id: v.id,
+                subpath: v.subpath,
+                readonly: v.readonly,
+            },
+        })))
+            .concat(this.assets.map((a) => ({
+            path: a.mountpoint,
+            options: {
+                type: "assets",
+                id: a.id,
+                subpath: a.subpath,
+            },
+        })))
+            .concat(this.dependencies.map((d) => ({
+            path: d.mountpoint,
+            options: {
+                type: "pointer",
+                packageId: d.dependencyId,
+                volumeId: d.volumeId,
+                subpath: d.subpath,
+                readonly: d.readonly,
+            },
+        })));
+    }
+}
+exports.Mounts = Mounts;
+//# sourceMappingURL=Mounts.js.map

package/cjs/lib/mainFn/Mounts.js.map

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

package/cjs/lib/mainFn/index.d.ts

@@ -0,0 +1,21 @@
+import { ExpectedExports } from "../types";
+import { Daemons } from "./Daemons";
+import "../interfaces/ServiceInterfaceBuilder";
+import "../interfaces/Origin";
+import "./Daemons";
+import { SDKManifest } from "../manifest/ManifestTypes";
+import { MainEffects } from "../StartSdk";
+/**
+ * Used to ensure that the main function is running with the valid proofs.
+ * We first do the folowing order of things
+ * 1. We get the interfaces
+ * 2. We setup all the commands to setup the system
+ * 3. We create the health checks
+ * 4. We setup the daemons init system
+ * @param fn
+ * @returns
+ */
+export declare const setupMain: <Manifest extends SDKManifest, Store>(fn: (o: {
+    effects: MainEffects;
+    started(onTerm: () => PromiseLike<void>): PromiseLike<void>;
+}) => Promise<Daemons<Manifest, any>>) => ExpectedExports.main;

package/cjs/lib/mainFn/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupMain = void 0;
+require("../interfaces/ServiceInterfaceBuilder");
+require("../interfaces/Origin");
+require("./Daemons");
+/**
+ * Used to ensure that the main function is running with the valid proofs.
+ * We first do the folowing order of things
+ * 1. We get the interfaces
+ * 2. We setup all the commands to setup the system
+ * 3. We create the health checks
+ * 4. We setup the daemons init system
+ * @param fn
+ * @returns
+ */
+const setupMain = (fn) => {
+    return async (options) => {
+        const result = await fn(options);
+        return result;
+    };
+};
+exports.setupMain = setupMain;
+//# sourceMappingURL=index.js.map

package/cjs/lib/mainFn/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/mainFn/index.ts"],"names":[],"mappings":";;;AAEA,iDAA8C;AAC9C,gCAA6B;AAE7B,qBAAkB;AAIlB;;;;;;;;;GASG;AACI,MAAM,SAAS,GAAG,CACvB,EAGqC,EACf,EAAE;IACxB,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,CAAA;QAChC,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;AACH,CAAC,CAAA;AAVY,QAAA,SAAS,aAUrB"}