@databehave/server 0.1.4 → 0.3.0

package/dist/bin-helpers.js

@@ -1,61 +0,0 @@
-export const HELP_TEXT = `Usage: databehave-server [options] <config>
-
-Options:
-  --open           After the server is listening, open the admin UI in
-                   the default browser. No-op (with a log line) when
-                   admin is absent or admin.enabled !== true.
-  -h, --help       Show this help and exit.
-`;
-/**
- * Parse argv (without `node` / script name). Unknown flags are
- * collected into `unknown` for the entry point to reject — we never
- * silently ignore an unrecognized option.
- */
-export const parseCliArgs = (argv) => {
-    const opts = {
-        open: false,
-        help: false,
-        unknown: [],
-    };
-    for (const a of argv) {
-        if (a === '--open')
-            opts.open = true;
-        else if (a === '-h' || a === '--help')
-            opts.help = true;
-        else if (a.startsWith('-'))
-            opts.unknown.push(a);
-        else if (opts.configPath === undefined)
-            opts.configPath = a;
-        else
-            opts.unknown.push(a);
-    }
-    return opts;
-};
-/**
- * Build the URL `--open` should hit. Returns `null` when the admin
- * panel is not active (no `admin`, or `enabled !== true`) — the
- * caller surfaces that as a skip-with-log message. Hosts bound to
- * `0.0.0.0` / `::` are rewritten to the matching loopback so the
- * browser doesn't try to dial the wildcard.
- */
-export const composeAdminUrl = (handle, admin) => {
-    if (!admin || admin.enabled !== true)
-        return null;
-    const host = handle.host === '0.0.0.0' || handle.host === '::' || handle.host === ''
-        ? '127.0.0.1'
-        : handle.host;
-    const path = typeof admin.path === 'string' && admin.path !== '' ? admin.path : '/databehave';
-    return `http://${host}:${handle.port}${path}`;
-};
-/** Platform-specific browser opener. Pure — returns the spawn args. */
-export const resolveOpener = (platform, url) => {
-    if (platform === 'darwin')
-        return { cmd: 'open', args: [url] };
-    // On Windows, `start` is a `cmd.exe` builtin. The empty string is
-    // the (required) window title — without it `start` treats the URL
-    // as the title and opens nothing.
-    if (platform === 'win32')
-        return { cmd: 'cmd', args: ['/c', 'start', '', url] };
-    return { cmd: 'xdg-open', args: [url] };
-};
-//# sourceMappingURL=bin-helpers.js.map

package/dist/bin-helpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bin-helpers.js","sourceRoot":"","sources":["../src/bin-helpers.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;CAOxB,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAuB,EAAc,EAAE;IAClE,MAAM,IAAI,GAAe;QACvB,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,EAAE;KACZ,CAAA;IACD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,KAAK,QAAQ;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;aAC/B,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,QAAQ;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;aAClD,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;aAC3C,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,CAAC,CAAA;;YACtD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC3B,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAcD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,MAAkB,EAClB,KAA+B,EAChB,EAAE;IACjB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IACjD,MAAM,IAAI,GACR,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,EAAE;QACrE,CAAC,CAAC,WAAW;QACb,CAAC,CAAC,MAAM,CAAC,IAAI,CAAA;IACjB,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAA;IAC7F,OAAO,UAAU,IAAI,IAAI,MAAM,CAAC,IAAI,GAAG,IAAI,EAAE,CAAA;AAC/C,CAAC,CAAA;AAED,uEAAuE;AACvE,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,QAAyB,EACzB,GAAW,EACsB,EAAE;IACnC,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAA;IAC9D,kEAAkE;IAClE,kEAAkE;IAClE,kCAAkC;IAClC,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,CAAA;IAC/E,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAA;AACzC,CAAC,CAAA"}

package/dist/bin.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -1,86 +0,0 @@
-#!/usr/bin/env node
-/**
- * `@databehave/server` CLI — thin wrapper around the programmatic
- * `run()` entry. Parses argv, delegates lifecycle to `run()`, and
- * wires `SIGINT` / `SIGTERM` to the returned `RunHandle.close()`.
- *
- * All server / opener wiring lives in `./run.ts`, so
- * `import { run } from '@databehave/server'` and `npx @databehave/server …`
- * are observationally equivalent (same log lines, same error model).
- *
- * Flags:
- *
- *   --open           After `listening`, open the admin URL.
- *   -h, --help       Print usage and exit 0.
- *
- * Exit codes: 0 on clean shutdown, 1 on bootstrap failure, 2 on bad
- * usage (unknown flag or missing config path).
- */
-import { HELP_TEXT, parseCliArgs } from './bin-helpers.js';
-import { run } from './run.js';
-const isAbortLikeError = (err) => {
-    if (err instanceof Error && err.name === 'AbortError')
-        return true;
-    if (typeof err !== 'object' || err === null)
-        return false;
-    const maybeCode = err.code;
-    const maybeName = err.name;
-    return maybeCode === 'ABORT_ERR' || maybeName === 'AbortError';
-};
-const main = async () => {
-    const opts = parseCliArgs(process.argv.slice(2));
-    if (opts.help) {
-        process.stdout.write(HELP_TEXT);
-        return;
-    }
-    if (opts.unknown.length > 0) {
-        console.error(`[@databehave/server] unknown option(s): ${opts.unknown.join(' ')}`);
-        process.stderr.write(HELP_TEXT);
-        process.exit(2);
-    }
-    if (!opts.configPath) {
-        process.stderr.write(HELP_TEXT);
-        process.exit(2);
-    }
-    let handle = null;
-    let pendingSignal = null;
-    let shuttingDown = false;
-    const shutdown = (signal) => {
-        if (shuttingDown)
-            return;
-        if (handle === null) {
-            pendingSignal = signal;
-            return;
-        }
-        shuttingDown = true;
-        console.info(`[@databehave/server] shutting down (${signal})`);
-        handle
-            .close()
-            .then(() => process.exit(0))
-            .catch((err) => {
-            console.error('[@databehave/server] failed to close', err);
-            process.exit(1);
-        });
-    };
-    process.on('SIGINT', () => shutdown('SIGINT'));
-    process.on('SIGTERM', () => shutdown('SIGTERM'));
-    try {
-        handle = await run({
-            config: opts.configPath,
-            open: opts.open,
-        });
-        if (pendingSignal !== null)
-            shutdown(pendingSignal);
-    }
-    catch (err) {
-        if (pendingSignal !== null && isAbortLikeError(err)) {
-            process.exit(0);
-        }
-        throw err;
-    }
-};
-main().catch((err) => {
-    console.error('[@databehave/server] failed to start', err);
-    process.exit(1);
-});
-//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

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

package/dist/define.d.ts

@@ -1,26 +0,0 @@
-import type { Config } from './types.js';
-/**
- * Identity helper providing TypeScript intellisense at the config
- * call site. Equivalent to `(config: Config) => config`.
- *
- * In non-production environments the returned config is **deep**-frozen
- * so accidental mutation — including `config.routes['GET /x'] = …`
- * or pushing into `cors.allowMethods` — throws loudly in tests instead
- * of corrupting the server silently. Production skips the freeze to
- * avoid breaking callers that legitimately patch the object after
- * `defineConfig()` for env-specific wiring.
- *
- * Handler functions inside `routes` are intentionally left mutable
- * (they're rebuilt per call anyway) — freeze stops at function
- * boundaries.
- *
- * Usage:
- * ```ts
- * import { defineConfig } from '@databehave/server'
- * export default defineConfig({ routes: { ... } })
- * ```
- */
-export declare const defineConfig: (config: Config) => Config;
-/** @internal exported for the JSON config loader to apply the same protection. */
-export declare const _deepFreezeForDev: <T>(value: T) => T;
-//# sourceMappingURL=define.d.ts.map

package/dist/define.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAoBxC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,KAAG,MAK7C,CAAA;AAED,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,CAG/C,CAAA"}

package/dist/define.js

@@ -1,55 +0,0 @@
-/**
- * Recursively freeze a value so mutation throws in strict mode.
- * Skips functions (handlers stay callable, and freezing their
- * own properties is rarely useful) and respects already-frozen
- * branches to avoid revisiting cycles.
- */
-const deepFreeze = (value, seen = new WeakSet()) => {
-    if (value === null || typeof value !== 'object')
-        return value;
-    if (seen.has(value))
-        return value;
-    seen.add(value);
-    if (Object.isFrozen(value))
-        return value;
-    for (const v of Object.values(value)) {
-        if (v !== null && typeof v === 'object')
-            deepFreeze(v, seen);
-    }
-    Object.freeze(value);
-    return value;
-};
-/**
- * Identity helper providing TypeScript intellisense at the config
- * call site. Equivalent to `(config: Config) => config`.
- *
- * In non-production environments the returned config is **deep**-frozen
- * so accidental mutation — including `config.routes['GET /x'] = …`
- * or pushing into `cors.allowMethods` — throws loudly in tests instead
- * of corrupting the server silently. Production skips the freeze to
- * avoid breaking callers that legitimately patch the object after
- * `defineConfig()` for env-specific wiring.
- *
- * Handler functions inside `routes` are intentionally left mutable
- * (they're rebuilt per call anyway) — freeze stops at function
- * boundaries.
- *
- * Usage:
- * ```ts
- * import { defineConfig } from '@databehave/server'
- * export default defineConfig({ routes: { ... } })
- * ```
- */
-export const defineConfig = (config) => {
-    if (process.env.NODE_ENV !== 'production') {
-        deepFreeze(config);
-    }
-    return config;
-};
-/** @internal exported for the JSON config loader to apply the same protection. */
-export const _deepFreezeForDev = (value) => {
-    if (process.env.NODE_ENV !== 'production')
-        deepFreeze(value);
-    return value;
-};
-//# sourceMappingURL=define.js.map

package/dist/define.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,GAAG,CAAI,KAAQ,EAAE,OAAwB,IAAI,OAAO,EAAE,EAAK,EAAE;IAC3E,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC7D,IAAI,IAAI,CAAC,GAAG,CAAC,KAAe,CAAC;QAAE,OAAO,KAAK,CAAA;IAC3C,IAAI,CAAC,GAAG,CAAC,KAAe,CAAC,CAAA;IACzB,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACxC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAgC,CAAC,EAAE,CAAC;QAChE,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;IAC9D,CAAC;IACD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACpB,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAc,EAAU,EAAE;IACrD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC1C,UAAU,CAAC,MAAM,CAAC,CAAA;IACpB,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,kFAAkF;AAClF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAI,KAAQ,EAAK,EAAE;IAClD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;QAAE,UAAU,CAAC,KAAK,CAAC,CAAA;IAC5D,OAAO,KAAK,CAAA;AACd,CAAC,CAAA"}

package/dist/json-config.d.ts

@@ -1,170 +0,0 @@
-import { type MockModeConfig } from './mock-mode.js';
-import type { Config, CorsConfig, Handler } from './types.js';
-/**
- * Static response declarable per endpoint. Returned verbatim when the
- * endpoint uses the `{ response }` form. Mirrors the JSON-safe subset
- * of `MockResponse` (no `text` / `html` / `raw`).
- */
-export interface EndpointResponse {
-    status: number;
-    json?: unknown;
-    empty?: boolean;
-    headers?: Record<string, string>;
-}
-/**
- * Per-endpoint declaration. Three forms:
- *
- *   - **string**: module path to a handler (shorthand for `{ handler }`)
- *   - **`{ handler, status? }`**: dynamic-import handler. Optional
- *     `status` registers an HTTP status override for this route in
- *     the mock-mode `pathOverrides` map (e.g. force 500 for that route).
- *   - **`{ response }`**: static response only — no handler module.
- *     The handler is synthesized to return the literal response.
- *
- * `handler` and `response` are mutually exclusive.
- */
-export type EndpointSpec = string | {
-    handler: string;
-    status?: number;
-    response?: never;
-} | {
-    response: EndpointResponse;
-    handler?: never;
-    status?: never;
-};
-/**
- * Raw JSON shape declared inside `databehave.json`. Mirrors a
- * narrow subset of `Config` plus the on-disk additions
- * (`endpoints` map of route-key → `EndpointSpec`).
- */
-export interface JsonConfig {
-    /** Path to the JSON OpenAPI document, relative to this file. */
-    openapi?: string;
-    /** Server listen options used by the CLI. */
-    server?: {
-        host?: string;
-        port?: number;
-    };
-    /**
-     * Prefix automatically prepended to every `endpoints` key.
-     * Lets callers write `"GET products/list"` instead of
-     * repeating the API prefix in every entry. Must start with `/` and
-     * must not end with `/` (e.g. `"/api/v1"`). OpenAPI paths are
-     * left untouched — they already carry their full path in the OAS document.
-     */
-    basePath?: string;
-    /**
-     * CORS knobs. `origin` may be a single allowed origin string or an
-     * allowlist of strings (the function form on `CorsConfig`
-     * is reserved for the programmatic API). Anything off the allowlist
-     * is rejected (empty header) so misconfigured callers fail loudly
-     * instead of silently leaking `*`.
-     */
-    cors?: Omit<CorsConfig, 'origin'> & {
-        origin?: string | readonly string[];
-    };
-    /** Built-in mock-mode behaviour. Disabled by default. */
-    mockMode?: MockModeConfig;
-    /**
-     * Opt-in admin / error-injection panel. Default: disabled.
-     * Pass-through to `Config.admin`. The JSON loader
-     * automatically supplements `openapiBody` from the resolved OpenAPI
-     * document so the UI route picker works without manual wiring.
-     */
-    admin?: Config['admin'];
-    /**
-     * Opt-in per-request access logs. Pass-through to
-     * `Config.log`. Default: disabled. See README
-     * "Access logs" for the shape.
-     */
-    log?: Config['log'];
-    /**
-     * Opt-in inbound request validation against the OpenAPI document.
-     * Pass-through to `Config.validation`. Default off
-     * (`{ request: false }`) — when omitted the runtime behaves
-     * byte-identical to a build without the validator.
-     */
-    validation?: Config['validation'];
-    /**
-     * Opt-in auto-schema mode (Phase 2C). When `enabled: true`, every
-     * OAS path not covered by `endpoints` is served from data
-     * generated by `@databehave/schema`'s `mock()` engine, derived
-     * from the OpenAPI document. The peer is loaded via dynamic
-     * `import()` at server-creation time; install it separately with
-     * `npm i @databehave/schema`. See README "Auto-schema mode".
-     *
-     * Always an object — the legacy boolean shorthand
-     * (`schema: true`) was removed. Unknown keys throw at
-     * config-load time. Fields:
-     *
-     * - `enabled` — required boolean. `false` (or omitting the
-     *   `schema` field entirely) keeps the default JSONC mock-only
-     *   flow.
-     * - `seed` — `number` (fixed), `"stable"` (per-request hash),
-     *            or `"random"` (fresh per request). Default `"stable"`.
-     * - `locale` — optional locale tag (forwarded as a future hint).
-     * - `arrayCount` — default array length when OAS lacks `minItems`.
-     */
-    schema?: {
-        enabled: boolean;
-        seed?: number | 'stable' | 'random';
-        locale?: string;
-        arrayCount?: number;
-    };
-    /**
-     * Route-key → endpoint declaration map. Keys may be written
-     * relative to `basePath` (e.g. `"GET products/list"`); they
-     * may also be absolute (`"GET /health"`) — any key starting with
-     * `/` after the method is registered verbatim.
-     */
-    endpoints?: Partial<Record<string, EndpointSpec>>;
-}
-/** Result of loading a JSON config from disk. */
-export interface LoadedConfig {
-    /** Fully-assembled config ready for `createServer`. */
-    readonly config: Config;
-    /** Server listen options copied verbatim from the JSON. */
-    readonly server: {
-        host: string;
-        port: number;
-    };
-}
-/**
- * Options for `loadConfig`.
- */
-export interface LoadConfigOptions {
-    /**
-     * Pre-resolved handler map. Keys may match the JSONC `endpoints`
-     * value either exactly (e.g. `./src/routes/health.js`) or in any
-     * canonically equivalent form — leading `./` and the file extension
-     * (`.js`/`.mjs`/`.cjs`/`.ts`/`.tsx`/`.mts`/`.cts`) are stripped
-     * before comparison. When a key matches, the handler is used
-     * directly and the dynamic `import()` for that route is skipped.
-     *
-     * Use case: test environments (vitest under plain Node 18) that cannot
-     * load `.ts` source files through native `import()`. Construct the map
-     * via static imports or `import.meta.glob('eager')`, then pass it in.
-     *
-     * Handlers not present in the map fall back to dynamic import. Values
-     * that are not functions raise an error at boot time.
-     */
-    handlers?: Record<string, Handler>;
-    /**
-     * Sink for non-fatal warnings emitted while wiring the OpenAPI
-     * adapter (walk errors, empty schemas). Defaults to `console.warn`.
-     * Inject a no-op logger from tests to silence the output, or a
-     * structured logger in production to capture the messages.
-     */
-    logger?: {
-        warn(message: string): void;
-    };
-}
-/**
- * Load and fully resolve a `databehave.json`.
- *
- * Returns a ready-to-run `Config` plus the listen options the
- * CLI should bind to. Errors are thrown synchronously after parsing
- * to fail fast on bad configs.
- */
-export declare const loadConfig: (configPath: string, options?: LoadConfigOptions) => Promise<LoadedConfig>;
-//# sourceMappingURL=json-config.d.ts.map

package/dist/json-config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"json-config.d.ts","sourceRoot":"","sources":["../src/json-config.ts"],"names":[],"mappings":"AAoBA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAA;AAYvB,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EACV,OAAO,EAGR,MAAM,YAAY,CAAA;AAEnB;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,GACpB,MAAM,GACN;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,KAAK,CAAA;CAAE,GACtD;IAAE,QAAQ,EAAE,gBAAgB,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,CAAA;AAEnE;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6CAA6C;IAC7C,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACzC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG;QAClC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;KACpC,CAAA;IACD,yDAAyD;IACzD,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;IACvB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;IACnB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC,CAAA;IACjC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,EAAE;QACP,OAAO,EAAE,OAAO,CAAA;QAChB,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAA;QACnC,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB,CAAA;IACD;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;CAClD;AAED,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAChD;AAybD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC;;;;;OAKG;IACH,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;CACzC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GACrB,YAAY,MAAM,EAClB,UAAU,iBAAiB,KAC1B,OAAO,CAAC,YAAY,CAgUtB,CAAA"}