daemora 1.0.0-alpha.0

package/dist/cron/CronStore.js

@@ -0,0 +1,209 @@
+/**
+ * CronStore — SQLite-backed cron job persistence.
+ *
+ * Stores job definitions and run history. The actual scheduling loop
+ * lives in CronScheduler, which consumes this store.
+ *
+ * Tables:
+ *   cron_jobs  — job definitions (expression, task, timezone, etc.)
+ *   cron_runs  — execution log per job (status, result, error)
+ */
+import { randomUUID } from "node:crypto";
+import { createLogger } from "../util/logger.js";
+import { NotFoundError } from "../util/errors.js";
+import { parseCron, nextFire } from "./cronParser.js";
+const log = createLogger("cron-store");
+// ── Store ──────────────────────────────────────────────────────────
+export class CronStore {
+    db;
+    stmts;
+    constructor(db) {
+        this.db = db;
+        this.createTables();
+        this.stmts = this.prepareStatements();
+        log.debug("cron store initialized");
+    }
+    // ── Jobs ────────────────────────────────────────────────────────
+    addJob(opts) {
+        // Validate expression before persisting.
+        const fields = parseCron(opts.expression);
+        const tz = opts.timezone ?? "UTC";
+        const now = Date.now();
+        const id = randomUUID();
+        const computedNext = opts.enabled !== false
+            ? nextFire(fields, new Date(now), tz) ?? null
+            : null;
+        const deliveryJson = opts.delivery ? JSON.stringify(opts.delivery) : null;
+        this.stmts.insertJob.run(id, opts.name, opts.expression, opts.task, opts.enabled !== false ? 1 : 0, tz, deliveryJson, null, computedNext, now);
+        log.info({ id, name: opts.name, expression: opts.expression }, "job added");
+        return this.getJob(id);
+    }
+    listJobs() {
+        const rows = this.stmts.listJobs.all();
+        return rows.map(rowToJob);
+    }
+    getJob(id) {
+        const row = this.stmts.getJob.get(id);
+        return row ? rowToJob(row) : undefined;
+    }
+    updateJob(id, updates) {
+        const existing = this.getJob(id);
+        if (!existing)
+            throw new NotFoundError(`Cron job not found: ${id}`);
+        // Validate new expression if provided.
+        const expression = updates.expression ?? existing.expression;
+        const timezone = updates.timezone ?? existing.timezone;
+        const enabled = updates.enabled ?? existing.enabled;
+        const fields = parseCron(expression);
+        // Recompute next_run_at.
+        const computedNext = enabled
+            ? nextFire(fields, new Date(), timezone) ?? null
+            : null;
+        const deliveryJson = updates.delivery !== undefined
+            ? (updates.delivery !== null ? JSON.stringify(updates.delivery) : null)
+            : (existing.delivery !== null ? JSON.stringify(existing.delivery) : null);
+        this.stmts.updateJob.run(updates.name ?? existing.name, expression, updates.task ?? existing.task, enabled ? 1 : 0, timezone, deliveryJson, computedNext, id);
+        log.info({ id, updates: Object.keys(updates) }, "job updated");
+        return this.getJob(id);
+    }
+    deleteJob(id) {
+        // Children first — cron_runs.job_id has a FK without ON DELETE
+        // CASCADE, so deleting the job while runs still reference it
+        // errors with "FOREIGN KEY constraint failed".
+        this.stmts.deleteJobRuns.run(id);
+        const info = this.stmts.deleteJob.run(id);
+        if (info.changes > 0) {
+            log.info({ id }, "job deleted");
+            return true;
+        }
+        return false;
+    }
+    // ── Runs ────────────────────────────────────────────────────────
+    getJobRuns(jobId, limit = 50) {
+        const rows = this.stmts.getJobRuns.all(jobId, limit);
+        return rows.map(rowToRun);
+    }
+    recordRun(jobId, status, result, error) {
+        const id = randomUUID();
+        const now = Date.now();
+        const completedAt = status !== "running" ? now : null;
+        this.stmts.insertRun.run(id, jobId, now, completedAt, status, result ?? null, error ?? null);
+        // Update job's last_run_at and recompute next_run_at.
+        const job = this.getJob(jobId);
+        if (job) {
+            const fields = parseCron(job.expression);
+            const computedNext = job.enabled
+                ? nextFire(fields, new Date(now), job.timezone) ?? null
+                : null;
+            this.stmts.updateJobRunMeta.run(now, computedNext, jobId);
+        }
+        return { id, jobId, startedAt: now, completedAt, status, result: result ?? null, error: error ?? null };
+    }
+    /**
+     * Recent runs for a given job, newest first. Used by Heartbeat to
+     * detect consecutive-error patterns that suggest a broken job.
+     */
+    listRuns(jobId, limit = 20) {
+        const rows = this.stmts.getJobRuns.all(jobId, Math.min(limit, 100));
+        return rows.map((r) => ({
+            id: r.id,
+            jobId: r.job_id,
+            startedAt: r.started_at,
+            completedAt: r.completed_at,
+            status: r.status,
+            result: r.result,
+            error: r.error,
+        }));
+    }
+    /**
+     * Return all enabled jobs whose next_run_at <= the given epoch.
+     * CronScheduler calls this every tick.
+     */
+    dueJobs(now) {
+        const rows = this.stmts.dueJobs.all(now);
+        return rows.map(rowToJob);
+    }
+    // ── Internals ───────────────────────────────────────────────────
+    createTables() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS cron_jobs (
+        id           TEXT PRIMARY KEY,
+        name         TEXT NOT NULL,
+        expression   TEXT NOT NULL,
+        task         TEXT NOT NULL,
+        enabled      INTEGER NOT NULL DEFAULT 1,
+        timezone     TEXT NOT NULL DEFAULT 'UTC',
+        delivery_json TEXT,
+        last_run_at  INTEGER,
+        next_run_at  INTEGER,
+        created_at   INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS cron_runs (
+        id           TEXT PRIMARY KEY,
+        job_id       TEXT NOT NULL REFERENCES cron_jobs(id),
+        started_at   INTEGER NOT NULL,
+        completed_at INTEGER,
+        status       TEXT NOT NULL,
+        result       TEXT,
+        error        TEXT
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_cron_runs_job ON cron_runs(job_id);
+      CREATE INDEX IF NOT EXISTS idx_cron_jobs_next ON cron_jobs(next_run_at) WHERE enabled = 1;
+    `);
+    }
+    prepareStatements() {
+        return {
+            insertJob: this.db.prepare(`INSERT INTO cron_jobs (id, name, expression, task, enabled, timezone, delivery_json, last_run_at, next_run_at, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`),
+            listJobs: this.db.prepare("SELECT * FROM cron_jobs ORDER BY created_at DESC"),
+            getJob: this.db.prepare("SELECT * FROM cron_jobs WHERE id = ?"),
+            updateJob: this.db.prepare(`UPDATE cron_jobs SET name = ?, expression = ?, task = ?, enabled = ?, timezone = ?, delivery_json = ?, next_run_at = ?
+         WHERE id = ?`),
+            deleteJob: this.db.prepare("DELETE FROM cron_jobs WHERE id = ?"),
+            deleteJobRuns: this.db.prepare("DELETE FROM cron_runs WHERE job_id = ?"),
+            getJobRuns: this.db.prepare("SELECT * FROM cron_runs WHERE job_id = ? ORDER BY started_at DESC LIMIT ?"),
+            insertRun: this.db.prepare(`INSERT INTO cron_runs (id, job_id, started_at, completed_at, status, result, error)
+         VALUES (?, ?, ?, ?, ?, ?, ?)`),
+            updateJobRunMeta: this.db.prepare("UPDATE cron_jobs SET last_run_at = ?, next_run_at = ? WHERE id = ?"),
+            dueJobs: this.db.prepare("SELECT * FROM cron_jobs WHERE enabled = 1 AND next_run_at IS NOT NULL AND next_run_at <= ?"),
+        };
+    }
+}
+// ── Row mappers ────────────────────────────────────────────────────
+function rowToJob(row) {
+    let delivery = null;
+    if (row.delivery_json) {
+        try {
+            delivery = JSON.parse(row.delivery_json);
+        }
+        catch {
+            log.warn({ id: row.id }, "corrupt delivery_json, treating as null");
+        }
+    }
+    return {
+        id: row.id,
+        name: row.name,
+        expression: row.expression,
+        task: row.task,
+        enabled: row.enabled === 1,
+        timezone: row.timezone,
+        delivery,
+        lastRunAt: row.last_run_at,
+        nextRunAt: row.next_run_at,
+        createdAt: row.created_at,
+    };
+}
+function rowToRun(row) {
+    return {
+        id: row.id,
+        jobId: row.job_id,
+        startedAt: row.started_at,
+        completedAt: row.completed_at,
+        status: row.status,
+        result: row.result,
+        error: row.error,
+    };
+}
+//# sourceMappingURL=CronStore.js.map

package/dist/cron/CronStore.js.map

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

package/dist/cron/cronParser.d.ts

@@ -0,0 +1,33 @@
+/**
+ * cronParser -- lightweight cron expression parser.
+ *
+ * Supports standard 5-field cron: minute hour dom month dow
+ * Field syntax: *, N, N-M (range), N,M,... (list), star/N (step),
+ * N-M/S (range with step). Day-of-week: 0-7 (0 and 7 = Sunday).
+ *
+ * No external dependencies. Designed for CronScheduler, not general use.
+ */
+export interface CronFields {
+    readonly minutes: ReadonlySet<number>;
+    readonly hours: ReadonlySet<number>;
+    readonly daysOfMonth: ReadonlySet<number>;
+    readonly months: ReadonlySet<number>;
+    readonly daysOfWeek: ReadonlySet<number>;
+}
+/**
+ * Parse a 5-field cron expression into structured field sets.
+ * Throws on invalid syntax.
+ */
+export declare function parseCron(expression: string): CronFields;
+/**
+ * Check whether a Date matches a parsed cron expression.
+ * Evaluates in the context of the provided timezone (default UTC).
+ */
+export declare function cronMatches(fields: CronFields, date: Date, timezone?: string): boolean;
+/**
+ * Compute the next fire time after the given date for the cron fields.
+ * Searches minute-by-minute up to 2 years out (safety cap).
+ * Returns epoch millis, or undefined if no match found.
+ */
+export declare function nextFire(fields: CronFields, after: Date, timezone?: string): number | undefined;
+//# sourceMappingURL=cronParser.d.ts.map

package/dist/cron/cronParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronParser.d.ts","sourceRoot":"","sources":["../../src/cron/cronParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC1C;AA0ED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAqBxD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,SAAQ,GAAG,OAAO,CASrF;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,SAAQ,GAAG,MAAM,GAAG,SAAS,CAmC9F"}

package/dist/cron/cronParser.js

@@ -0,0 +1,211 @@
+/**
+ * cronParser -- lightweight cron expression parser.
+ *
+ * Supports standard 5-field cron: minute hour dom month dow
+ * Field syntax: *, N, N-M (range), N,M,... (list), star/N (step),
+ * N-M/S (range with step). Day-of-week: 0-7 (0 and 7 = Sunday).
+ *
+ * No external dependencies. Designed for CronScheduler, not general use.
+ */
+const FIELD_RANGES = [
+    { min: 0, max: 59 }, // minute
+    { min: 0, max: 23 }, // hour
+    { min: 1, max: 31 }, // day of month
+    { min: 1, max: 12 }, // month
+    { min: 0, max: 6 }, // day of week (0 = Sunday)
+];
+/**
+ * Parse a single cron field into the set of integers it represents.
+ */
+function parseField(raw, min, max) {
+    const result = new Set();
+    for (const part of raw.split(",")) {
+        const trimmed = part.trim();
+        if (trimmed.length === 0) {
+            throw new Error("Empty sub-expression in cron field: " + raw);
+        }
+        const slashIdx = trimmed.indexOf("/");
+        let step = 1;
+        let rangePart = trimmed;
+        if (slashIdx !== -1) {
+            step = strictInt(trimmed.slice(slashIdx + 1));
+            if (step < 1)
+                throw new Error("Step must be >= 1, got " + String(step));
+            rangePart = trimmed.slice(0, slashIdx);
+        }
+        let lo;
+        let hi;
+        if (rangePart === "*") {
+            lo = min;
+            hi = max;
+        }
+        else if (rangePart.includes("-")) {
+            const [aStr, bStr] = rangePart.split("-");
+            lo = strictInt(aStr);
+            hi = strictInt(bStr);
+            if (lo < min || hi > max || lo > hi) {
+                throw new Error("Range " + lo + "-" + hi + " out of bounds [" + min + "-" + max + "]");
+            }
+        }
+        else {
+            const val = strictInt(rangePart);
+            if (val < min || val > max) {
+                throw new Error("Value " + val + " out of bounds [" + min + "-" + max + "]");
+            }
+            if (slashIdx === -1) {
+                result.add(val);
+                continue;
+            }
+            lo = val;
+            hi = max;
+        }
+        for (let v = lo; v <= hi; v += step) {
+            result.add(v);
+        }
+    }
+    return result;
+}
+function strictInt(s) {
+    const trimmed = s.trim();
+    if (trimmed.length === 0 || !/^\d+$/.test(trimmed)) {
+        throw new Error("Invalid integer in cron expression: " + s);
+    }
+    return Number(trimmed);
+}
+/**
+ * Parse a 5-field cron expression into structured field sets.
+ * Throws on invalid syntax.
+ */
+export function parseCron(expression) {
+    const parts = expression.trim().split(/\s+/);
+    if (parts.length !== 5) {
+        throw new Error("Cron expression must have 5 fields (min hour dom month dow), got " + parts.length + ": " + expression);
+    }
+    const minutes = parseField(parts[0], FIELD_RANGES[0].min, FIELD_RANGES[0].max);
+    const hours = parseField(parts[1], FIELD_RANGES[1].min, FIELD_RANGES[1].max);
+    const daysOfMonth = parseField(parts[2], FIELD_RANGES[2].min, FIELD_RANGES[2].max);
+    const months = parseField(parts[3], FIELD_RANGES[3].min, FIELD_RANGES[3].max);
+    const rawDow = parseField(parts[4], 0, 7);
+    // Normalise: treat 7 as 0 (Sunday).
+    const daysOfWeek = new Set();
+    for (const d of rawDow) {
+        daysOfWeek.add(d === 7 ? 0 : d);
+    }
+    return { minutes, hours, daysOfMonth, months, daysOfWeek };
+}
+/**
+ * Check whether a Date matches a parsed cron expression.
+ * Evaluates in the context of the provided timezone (default UTC).
+ */
+export function cronMatches(fields, date, timezone = "UTC") {
+    const localized = toTimezone(date, timezone);
+    return (fields.minutes.has(localized.minute) &&
+        fields.hours.has(localized.hour) &&
+        fields.daysOfMonth.has(localized.dayOfMonth) &&
+        fields.months.has(localized.month) &&
+        fields.daysOfWeek.has(localized.dayOfWeek));
+}
+/**
+ * Compute the next fire time after the given date for the cron fields.
+ * Searches minute-by-minute up to 2 years out (safety cap).
+ * Returns epoch millis, or undefined if no match found.
+ */
+export function nextFire(fields, after, timezone = "UTC") {
+    // Start from the next whole minute after the reference date.
+    const start = new Date(after.getTime());
+    start.setSeconds(0, 0);
+    start.setTime(start.getTime() + 60_000);
+    const cap = after.getTime() + 2 * 365 * 24 * 60 * 60_000;
+    let cursor = start.getTime();
+    while (cursor < cap) {
+        const d = new Date(cursor);
+        const tz = toTimezone(d, timezone);
+        // Fast-forward: skip wrong month.
+        if (!fields.months.has(tz.month)) {
+            cursor = advanceToNextMonth(cursor, timezone);
+            continue;
+        }
+        // Skip wrong day.
+        if (!fields.daysOfMonth.has(tz.dayOfMonth) || !fields.daysOfWeek.has(tz.dayOfWeek)) {
+            cursor = advanceToNextDay(cursor);
+            continue;
+        }
+        // Skip wrong hour.
+        if (!fields.hours.has(tz.hour)) {
+            cursor = advanceToNextHour(cursor);
+            continue;
+        }
+        // Check minute.
+        if (fields.minutes.has(tz.minute)) {
+            return cursor;
+        }
+        cursor += 60_000;
+    }
+    return undefined;
+}
+function toTimezone(date, timezone) {
+    const parts = new Intl.DateTimeFormat("en-US", {
+        timeZone: timezone,
+        year: "numeric",
+        month: "numeric",
+        day: "numeric",
+        hour: "numeric",
+        minute: "numeric",
+        hour12: false,
+    }).formatToParts(date);
+    const get = (type) => {
+        const p = parts.find((x) => x.type === type);
+        return p ? Number(p.value) : 0;
+    };
+    // Intl hour12:false returns 24 for midnight in some engines -- normalise.
+    const rawHour = get("hour");
+    return {
+        minute: get("minute"),
+        hour: rawHour === 24 ? 0 : rawHour,
+        dayOfMonth: get("day"),
+        month: get("month"),
+        dayOfWeek: new Date(new Intl.DateTimeFormat("en-CA", { timeZone: timezone, year: "numeric", month: "2-digit", day: "2-digit" })
+            .format(date)).getDay(),
+    };
+}
+function advanceToNextMonth(epochMs, timezone) {
+    const d = new Date(epochMs);
+    const parts = new Intl.DateTimeFormat("en-US", {
+        timeZone: timezone,
+        year: "numeric",
+        month: "numeric",
+    }).formatToParts(d);
+    const year = Number(parts.find((p) => p.type === "year").value);
+    const month = Number(parts.find((p) => p.type === "month").value);
+    const nextMonth = month === 12 ? 1 : month + 1;
+    const nextYear = month === 12 ? year + 1 : year;
+    const isoStr = String(nextYear) + "-" + String(nextMonth).padStart(2, "0") + "-01T00:00:00";
+    return dateInTimezone(isoStr, timezone);
+}
+function advanceToNextDay(epochMs) {
+    return epochMs + 24 * 60 * 60_000;
+}
+function advanceToNextHour(epochMs) {
+    return epochMs + 60 * 60_000;
+}
+/**
+ * Approximate: create epoch ms for a wall-clock ISO string in the given timezone.
+ * Uses a two-pass approach via Intl for reasonable accuracy.
+ */
+function dateInTimezone(isoNaive, timezone) {
+    const rough = new Date(isoNaive + "Z").getTime();
+    const utcStr = new Intl.DateTimeFormat("en-CA", {
+        timeZone: timezone,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+        hour12: false,
+    }).format(new Date(rough));
+    const localRough = new Date(utcStr.replace(",", "") + "Z").getTime();
+    const offset = localRough - rough;
+    return rough - offset;
+}
+//# sourceMappingURL=cronParser.js.map

package/dist/cron/cronParser.js.map

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

package/dist/daemon/DaemonManager.d.ts

@@ -0,0 +1,59 @@
+/**
+ * DaemonManager — native OS service supervisor.
+ *
+ * macOS  → ~/Library/LaunchAgents/com.daemora.agent.plist (launchctl)
+ * Linux  → ~/.config/systemd/user/daemora-agent.service  (systemctl --user)
+ * Windows→ Scheduled Task "daemora-agent" running a .cmd wrapper
+ *
+ * Responsibilities:
+ * - install/uninstall the service (auto-start on login/boot)
+ * - start/stop/restart/status at runtime
+ * - inject VAULT_PASSPHRASE into the service environment when given one
+ *
+ * Entry-point resolution: prefers a compiled `dist/cli.mjs` (run via
+ * `node`). Falls back to `tsx src/cli/index.ts start` in dev. Both run
+ * with cwd == project root and NODE_ENV=production + DAEMON_MODE=true.
+ */
+export declare const SERVICE_NAME = "daemora-agent";
+export declare const SERVICE_LABEL = "com.daemora.agent";
+export type DaemonPlatform = "launchd" | "systemd" | "schtasks" | "unsupported";
+export interface DaemonStatus {
+    readonly running: boolean;
+    readonly platform: DaemonPlatform;
+    readonly pid?: number;
+    readonly installed: boolean;
+}
+export interface InstallResult {
+    readonly servicePath: string;
+    readonly platform: DaemonPlatform;
+}
+export declare class DaemonManager {
+    readonly platform: NodeJS.Platform;
+    readonly rootDir: string;
+    readonly logsDir: string;
+    readonly dataDir: string;
+    private readonly entry;
+    constructor(opts?: {
+        rootDir?: string;
+        dataDir?: string;
+    });
+    install(passphrase?: string): InstallResult;
+    uninstall(): void;
+    start(passphrase?: string): void;
+    stop(): void;
+    restart(passphrase?: string): void;
+    status(): DaemonStatus;
+    private plistPath;
+    private installMacOS;
+    private uninstallMacOS;
+    private renderPlist;
+    private injectMacOSPassphrase;
+    private unitPath;
+    private installLinux;
+    private uninstallLinux;
+    private batPath;
+    private installWindows;
+    private uninstallWindows;
+    private injectWindowsPassphrase;
+}
+//# sourceMappingURL=DaemonManager.d.ts.map

package/dist/daemon/DaemonManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DaemonManager.d.ts","sourceRoot":"","sources":["../../src/daemon/DaemonManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAYH,eAAO,MAAM,YAAY,kBAAkB,CAAC;AAC5C,eAAO,MAAM,aAAa,sBAAsB,CAAC;AAEjD,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,CAAC;AAEhF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;CACnC;AAWD,qBAAa,aAAa;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;gBAEvB,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO;IAQ7D,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa;IAQ3C,SAAS,IAAI,IAAI;IAMjB,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAmBhC,IAAI,IAAI,IAAI;IAeZ,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAKlC,MAAM,IAAI,YAAY;IAuCtB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,WAAW;IA2CnB,OAAO,CAAC,qBAAqB;IAiB7B,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,YAAY;IAuCpB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,uBAAuB;CAQhC"}