@nuetzliches/croniq-runner 0.1.0

package/dist/log-writer.js

@@ -0,0 +1,153 @@
+import { deferred, sleep } from './deferred.js';
+/**
+ * Streaming log writer. Backed by a bounded in-memory buffer and a single
+ * background flusher coroutine; mirrors the .NET / Rust SDKs:
+ *
+ *   - Batch by count: flush when {@link ResolvedLogWriterOptions.batchSizeThreshold} events accumulate.
+ *   - Batch by time: flush at least every {@link ResolvedLogWriterOptions.batchTimeThresholdMs} ms.
+ *   - Drain-before-ack: {@link dispose} waits up to `shutdownTimeoutMs` for the buffer to flush.
+ *   - Backpressure: {@link write} awaits when the buffer is at capacity.
+ *
+ * Enrichment runs at POST time (`job_key`, `runner_id`, `runner_tags`).
+ */
+export class StreamingLogWriter {
+    #client;
+    #executionId;
+    #enrichment;
+    #opts;
+    #logger;
+    #buffer = [];
+    #pendingFlushes = [];
+    /** Resolved when a slot frees up in the bounded buffer. */
+    #spaceAvailable = null;
+    /** Resolved when new events arrive (wakes the flusher early). */
+    #eventsAvailable = null;
+    #closed = false;
+    #disposed = false;
+    #flusherTask;
+    constructor(client, executionId, enrichment, opts, logger) {
+        this.#client = client;
+        this.#executionId = executionId;
+        this.#enrichment = enrichment;
+        this.#opts = opts;
+        this.#logger = logger;
+        this.#flusherTask = this.#runFlusher();
+    }
+    async write(level, message, fields) {
+        const event = fields ? { level, message, fields } : { level, message };
+        return this.writeEvent(event);
+    }
+    async writeEvent(event) {
+        while (!this.#closed && this.#buffer.length >= this.#opts.channelCapacity) {
+            this.#spaceAvailable ??= deferred();
+            await this.#spaceAvailable.promise;
+        }
+        if (this.#closed)
+            return;
+        this.#buffer.push(event);
+        this.#wake();
+    }
+    flush() {
+        if (this.#closed && this.#buffer.length === 0)
+            return Promise.resolve();
+        const d = deferred();
+        this.#pendingFlushes.push(d);
+        this.#wake();
+        return d.promise;
+    }
+    async dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        this.#closed = true;
+        this.#wake();
+        // Release any writers parked on a full buffer so they unblock and observe `closed`.
+        this.#releaseWriters();
+        let timedOut = false;
+        const timeoutController = new AbortController();
+        const timeout = sleep(this.#opts.shutdownTimeoutMs, timeoutController.signal).then(() => { timedOut = true; }, () => { });
+        await Promise.race([this.#flusherTask, timeout]);
+        timeoutController.abort();
+        if (timedOut) {
+            this.#logger.warn(`log_writer drain timed out after ${this.#opts.shutdownTimeoutMs}ms (execution ${this.#executionId})`, { execution_id: this.#executionId });
+        }
+    }
+    #wake() {
+        if (this.#eventsAvailable) {
+            const d = this.#eventsAvailable;
+            this.#eventsAvailable = null;
+            d.resolve();
+        }
+    }
+    #releaseWriters() {
+        if (this.#spaceAvailable) {
+            const d = this.#spaceAvailable;
+            this.#spaceAvailable = null;
+            d.resolve();
+        }
+    }
+    async #runFlusher() {
+        try {
+            while (!this.#closed || this.#buffer.length > 0 || this.#pendingFlushes.length > 0) {
+                // Wait for one of: new events arrived, the time-threshold tick fires,
+                // or the writer was closed. The deferred is re-created each iteration
+                // so callers awakening it have a fresh promise to settle.
+                if (this.#buffer.length === 0 && this.#pendingFlushes.length === 0 && !this.#closed) {
+                    this.#eventsAvailable = deferred();
+                    const tickController = new AbortController();
+                    const tick = sleep(this.#opts.batchTimeThresholdMs, tickController.signal).catch(() => undefined);
+                    await Promise.race([this.#eventsAvailable.promise, tick]);
+                    tickController.abort();
+                    this.#eventsAvailable = null;
+                }
+                // Drain whatever has accumulated. We pull *everything* — the
+                // batch-size threshold is honoured per-POST inside flushAll().
+                if (this.#buffer.length > 0) {
+                    const batch = this.#buffer;
+                    this.#buffer = [];
+                    this.#releaseWriters();
+                    await this.#flushAll(batch);
+                }
+                if (this.#pendingFlushes.length > 0) {
+                    // Drain any events that arrived while we were posting the prior batch.
+                    if (this.#buffer.length > 0) {
+                        const more = this.#buffer;
+                        this.#buffer = [];
+                        this.#releaseWriters();
+                        await this.#flushAll(more);
+                    }
+                    const resolvers = this.#pendingFlushes;
+                    this.#pendingFlushes = [];
+                    for (const r of resolvers)
+                        r.resolve();
+                }
+            }
+        }
+        catch (err) {
+            this.#logger.error(`log_writer flusher crashed (execution ${this.#executionId})`, { error: String(err) });
+        }
+        finally {
+            // Reject any remaining flushers so callers don't hang.
+            for (const r of this.#pendingFlushes)
+                r.resolve();
+            this.#pendingFlushes = [];
+            this.#releaseWriters();
+        }
+    }
+    async #flushAll(events) {
+        const max = this.#opts.maxBatchPerPost;
+        for (let i = 0; i < events.length; i += max) {
+            const chunk = events.slice(i, i + max).map((e) => this.#enrichment.enrich(e));
+            try {
+                // Use a fresh AbortController per POST so client cancellation is
+                // localised — a slow batch should not bring down later batches.
+                const ac = new AbortController();
+                await this.#client.pushEvents(this.#executionId, chunk, ac.signal);
+            }
+            catch (err) {
+                this.#logger.warn(`log_writer: batch POST failed — ${chunk.length} events dropped (execution ${this.#executionId})`, { error: String(err), execution_id: this.#executionId, dropped: chunk.length });
+            }
+        }
+    }
+}
+//# sourceMappingURL=log-writer.js.map

package/dist/log-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-writer.js","sourceRoot":"","sources":["../src/log-writer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAiB,MAAM,eAAe,CAAC;AAoB/D;;;;;;;;;;GAUG;AACH,MAAM,OAAO,kBAAkB;IACpB,OAAO,CAAe;IACtB,YAAY,CAAS;IACrB,WAAW,CAAgB;IAC3B,KAAK,CAA2B;IAChC,OAAO,CAAS;IAEzB,OAAO,GAAgB,EAAE,CAAC;IAC1B,eAAe,GAA0B,EAAE,CAAC;IAC5C,2DAA2D;IAC3D,eAAe,GAA0B,IAAI,CAAC;IAC9C,iEAAiE;IACjE,gBAAgB,GAA0B,IAAI,CAAC;IAC/C,OAAO,GAAG,KAAK,CAAC;IAChB,SAAS,GAAG,KAAK,CAAC;IACT,YAAY,CAAgB;IAErC,YACE,MAAoB,EACpB,WAAmB,EACnB,UAAyB,EACzB,IAA8B,EAC9B,MAAc;QAEd,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAqB,EAAE,OAAe,EAAE,MAA+B;QACjF,MAAM,KAAK,GAAc,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAClF,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAgB;QAC/B,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;YAC1E,IAAI,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;QACrC,CAAC;QACD,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QACxE,MAAM,CAAC,GAAG,QAAQ,EAAQ,CAAC;QAC3B,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,CAAC,OAAO,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,oFAAoF;QACpF,IAAI,CAAC,eAAe,EAAE,CAAC;QAEvB,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,MAAM,iBAAiB,GAAG,IAAI,eAAe,EAAE,CAAC;QAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC,IAAI,CAChF,GAAG,EAAE,GAAG,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,EAC1B,GAAG,EAAE,GAAE,CAAC,CACT,CAAC;QACF,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;QACjD,iBAAiB,CAAC,KAAK,EAAE,CAAC;QAE1B,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,OAAO,CAAC,IAAI,CACf,oCAAoC,IAAI,CAAC,KAAK,CAAC,iBAAiB,iBAAiB,IAAI,CAAC,YAAY,GAAG,EACrG,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CACpC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC;YAChC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;YAC7B,CAAC,CAAC,OAAO,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAED,eAAe;QACb,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC;YAC/B,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;YAC5B,CAAC,CAAC,OAAO,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,WAAW;QACf,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnF,sEAAsE;gBACtE,sEAAsE;gBACtE,0DAA0D;gBAC1D,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;oBACpF,IAAI,CAAC,gBAAgB,GAAG,QAAQ,EAAE,CAAC;oBACnC,MAAM,cAAc,GAAG,IAAI,eAAe,EAAE,CAAC;oBAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;oBAClG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;oBAC1D,cAAc,CAAC,KAAK,EAAE,CAAC;oBACvB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;gBAC/B,CAAC;gBAED,6DAA6D;gBAC7D,+DAA+D;gBAC/D,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC;oBAC3B,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;oBAClB,IAAI,CAAC,eAAe,EAAE,CAAC;oBACvB,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBAC9B,CAAC;gBAED,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACpC,uEAAuE;oBACvE,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC;wBAC1B,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;wBAClB,IAAI,CAAC,eAAe,EAAE,CAAC;wBACvB,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;oBAC7B,CAAC;oBACD,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC;oBACvC,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC;oBAC1B,KAAK,MAAM,CAAC,IAAI,SAAS;wBAAE,CAAC,CAAC,OAAO,EAAE,CAAC;gBACzC,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,yCAAyC,IAAI,CAAC,YAAY,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5G,CAAC;gBAAS,CAAC;YACT,uDAAuD;YACvD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,eAAe;gBAAE,CAAC,CAAC,OAAO,EAAE,CAAC;YAClD,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC;YAC1B,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAmB;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC;QACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9E,IAAI,CAAC;gBACH,iEAAiE;gBACjE,gEAAgE;gBAChE,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;gBACjC,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;YACrE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,OAAO,CAAC,IAAI,CACf,mCAAmC,KAAK,CAAC,MAAM,8BAA8B,IAAI,CAAC,YAAY,GAAG,EACjG,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,CAC/E,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/logger.d.ts

@@ -0,0 +1,27 @@
+import type { WorkEventLevel } from './protocol.js';
+export type LogLevel = WorkEventLevel;
+export interface Logger {
+    trace(message: string, fields?: Record<string, unknown>): void;
+    debug(message: string, fields?: Record<string, unknown>): void;
+    info(message: string, fields?: Record<string, unknown>): void;
+    warn(message: string, fields?: Record<string, unknown>): void;
+    error(message: string, fields?: Record<string, unknown>): void;
+}
+/**
+ * Console-backed logger that emits at or above {@link minLevel}.
+ *
+ * The runner's internal diagnostics default to `warn` so SDK noise stays
+ * out of an application's stdout/stderr unless something is going wrong.
+ * Job handlers receive a separate per-execution `Logger` whose minLevel
+ * defaults to `info`.
+ */
+export declare function consoleLogger(minLevel?: LogLevel, prefix?: string): Logger;
+/** Logger that drops every message — useful for tests. */
+export declare const noopLogger: Logger;
+/**
+ * Wraps a logger so every emitted record carries the given extra fields,
+ * merged with whatever the caller passes in (caller wins). Used to scope a
+ * handler-side logger with `execution_id`, `job_key`, `runner_id`, `attempt`.
+ */
+export declare function scopedLogger(base: Logger, extra: Record<string, unknown>): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,MAAM,QAAQ,GAAG,cAAc,CAAC;AAEtC,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAChE;AAUD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,QAAQ,GAAE,QAAiB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAwBlF;AAED,0DAA0D;AAC1D,eAAO,MAAM,UAAU,EAAE,MAMxB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CASjF"}

package/dist/logger.js

@@ -0,0 +1,65 @@
+const ORDER = {
+    trace: 0,
+    debug: 1,
+    info: 2,
+    warn: 3,
+    error: 4,
+};
+/**
+ * Console-backed logger that emits at or above {@link minLevel}.
+ *
+ * The runner's internal diagnostics default to `warn` so SDK noise stays
+ * out of an application's stdout/stderr unless something is going wrong.
+ * Job handlers receive a separate per-execution `Logger` whose minLevel
+ * defaults to `info`.
+ */
+export function consoleLogger(minLevel = 'warn', prefix) {
+    const threshold = ORDER[minLevel];
+    const tag = prefix ? `[${prefix}] ` : '';
+    const emit = (level, message, fields) => {
+        if (ORDER[level] < threshold)
+            return;
+        const line = fields && Object.keys(fields).length > 0
+            ? `${tag}${level}: ${message} ${JSON.stringify(fields)}`
+            : `${tag}${level}: ${message}`;
+        // Map to console method, but funnel everything to stderr for warn/error
+        // so application stdout stays clean for actual job output.
+        // eslint-disable-next-line no-console
+        if (level === 'error' || level === 'warn')
+            console.error(line);
+        // eslint-disable-next-line no-console
+        else
+            console.log(line);
+    };
+    return {
+        trace: (m, f) => emit('trace', m, f),
+        debug: (m, f) => emit('debug', m, f),
+        info: (m, f) => emit('info', m, f),
+        warn: (m, f) => emit('warn', m, f),
+        error: (m, f) => emit('error', m, f),
+    };
+}
+/** Logger that drops every message — useful for tests. */
+export const noopLogger = {
+    trace: () => { },
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+/**
+ * Wraps a logger so every emitted record carries the given extra fields,
+ * merged with whatever the caller passes in (caller wins). Used to scope a
+ * handler-side logger with `execution_id`, `job_key`, `runner_id`, `attempt`.
+ */
+export function scopedLogger(base, extra) {
+    const merge = (fields) => ({ ...extra, ...(fields ?? {}) });
+    return {
+        trace: (m, f) => base.trace(m, merge(f)),
+        debug: (m, f) => base.debug(m, merge(f)),
+        info: (m, f) => base.info(m, merge(f)),
+        warn: (m, f) => base.warn(m, merge(f)),
+        error: (m, f) => base.error(m, merge(f)),
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/options.d.ts

@@ -0,0 +1,89 @@
+import type { Logger } from './logger.js';
+export interface LogWriterOptions {
+    /** Bounded queue capacity. Backpressure kicks in when full. Default 256. */
+    channelCapacity?: number;
+    /** Flush when this many events have accumulated. Default 32. */
+    batchSizeThreshold?: number;
+    /** Flush at least this often, even if the size threshold isn't reached. Default 200 ms. */
+    batchTimeThresholdMs?: number;
+    /** Maximum events per outgoing HTTP POST. Default 100. */
+    maxBatchPerPost?: number;
+    /** Maximum time the runner waits for queued events to flush during per-execution drain. Default 5 s. */
+    shutdownTimeoutMs?: number;
+}
+export interface ResolvedLogWriterOptions {
+    channelCapacity: number;
+    batchSizeThreshold: number;
+    batchTimeThresholdMs: number;
+    maxBatchPerPost: number;
+    shutdownTimeoutMs: number;
+}
+export interface CroniqRunnerOptions {
+    /** Base URL of the Croniq server, e.g. `http://localhost:4000`. */
+    serverUrl: string;
+    /**
+     * Stable runner identifier. If omitted, the SDK resolves it via
+     * `RUNNER_ID` env var → state file under {@link runnerDataDir} →
+     * a newly generated `{prefix}-{hex8}` persisted to the state file.
+     */
+    runnerId?: string;
+    /** Prefix used when generating a fresh runner ID. Default `"runner"`. */
+    runnerIdPrefix?: string;
+    /**
+     * Directory the SDK reads/writes the persistent runner-id file in.
+     * Honors `CRONIQ_RUNNER_DATA_DIR` when omitted. Defaults to
+     * `$XDG_STATE_HOME/croniq-runner` (or platform equivalent).
+     */
+    runnerDataDir?: string;
+    /** API key used for `Authorization: ApiKey {key}`. Takes precedence over {@link bearerToken}. */
+    apiKey?: string;
+    /** Bearer token used for `Authorization: Bearer {token}`. */
+    bearerToken?: string;
+    /**
+     * Capabilities the runner advertises (e.g. `"billing"`, `"reporting"`).
+     * Used by the server for job routing (`require` / `prefer` in the Croniqfile).
+     */
+    capabilities?: string[];
+    /**
+     * Free-form tags the runner declares about itself. Filter-only — does
+     * NOT influence routing (capabilities do that). Convention is
+     * `key=value` strings (e.g. `"env=prod"`, `"lang=typescript"`).
+     */
+    tags?: string[];
+    /** Maximum concurrent in-flight executions. Default 5, range [1, 1024]. */
+    maxInflight?: number;
+    /** Per-request timeout for the long-poll work endpoint. Default 35 000 ms. */
+    pollTimeoutMs?: number;
+    /** Interval at which the runner sends lease-renewal heartbeats. Default 15 000 ms. */
+    renewIntervalMs?: number;
+    /** Maximum time the runner waits for in-flight handlers during graceful shutdown. Default 30 000 ms. */
+    drainTimeoutMs?: number;
+    /** Backoff after a failed poll request. Default 5 000 ms. */
+    pollRetryDelayMs?: number;
+    /** Idle delay when the runner is at `maxInflight` capacity. Default 500 ms. */
+    capacityBackoffMs?: number;
+    /** Streaming log-writer tunables. */
+    logWriter?: LogWriterOptions;
+    /** Optional logger for SDK-level diagnostics. Defaults to a console logger that emits warn/error only. */
+    logger?: Logger;
+}
+export interface ResolvedRunnerOptions {
+    serverUrl: string;
+    runnerId: string | undefined;
+    runnerIdPrefix: string;
+    runnerDataDir: string | undefined;
+    apiKey: string | undefined;
+    bearerToken: string | undefined;
+    capabilities: string[];
+    tags: string[];
+    maxInflight: number;
+    pollTimeoutMs: number;
+    renewIntervalMs: number;
+    drainTimeoutMs: number;
+    pollRetryDelayMs: number;
+    capacityBackoffMs: number;
+    logWriter: ResolvedLogWriterOptions;
+    logger: Logger;
+}
+export declare function resolveOptions(input: CroniqRunnerOptions, defaultLogger: Logger): ResolvedRunnerOptions;
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2FAA2F;IAC3F,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,0DAA0D;IAC1D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wGAAwG;IACxG,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,iGAAiG;IACjG,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,sFAAsF;IACtF,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,wGAAwG;IACxG,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,qCAAqC;IACrC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B,0GAA0G;IAC1G,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,wBAAwB,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB;AAUD,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,GAAG,qBAAqB,CA0CvG"}

package/dist/options.js

@@ -0,0 +1,50 @@
+import { trimTrailingSlashes } from './url.js';
+const DEFAULT_LOG_WRITER = {
+    channelCapacity: 256,
+    batchSizeThreshold: 32,
+    batchTimeThresholdMs: 200,
+    maxBatchPerPost: 100,
+    shutdownTimeoutMs: 5_000,
+};
+export function resolveOptions(input, defaultLogger) {
+    if (!input.serverUrl || typeof input.serverUrl !== 'string') {
+        throw new TypeError('CroniqRunnerOptions.serverUrl is required');
+    }
+    try {
+        // eslint-disable-next-line no-new
+        new URL(input.serverUrl);
+    }
+    catch {
+        throw new TypeError(`CroniqRunnerOptions.serverUrl is not a valid URL: ${input.serverUrl}`);
+    }
+    const maxInflight = input.maxInflight ?? 5;
+    if (!Number.isInteger(maxInflight) || maxInflight < 1 || maxInflight > 1024) {
+        throw new RangeError(`CroniqRunnerOptions.maxInflight must be an integer in [1, 1024], got ${maxInflight}`);
+    }
+    const logWriter = {
+        channelCapacity: input.logWriter?.channelCapacity ?? DEFAULT_LOG_WRITER.channelCapacity,
+        batchSizeThreshold: input.logWriter?.batchSizeThreshold ?? DEFAULT_LOG_WRITER.batchSizeThreshold,
+        batchTimeThresholdMs: input.logWriter?.batchTimeThresholdMs ?? DEFAULT_LOG_WRITER.batchTimeThresholdMs,
+        maxBatchPerPost: input.logWriter?.maxBatchPerPost ?? DEFAULT_LOG_WRITER.maxBatchPerPost,
+        shutdownTimeoutMs: input.logWriter?.shutdownTimeoutMs ?? DEFAULT_LOG_WRITER.shutdownTimeoutMs,
+    };
+    return {
+        serverUrl: trimTrailingSlashes(input.serverUrl),
+        runnerId: input.runnerId,
+        runnerIdPrefix: input.runnerIdPrefix ?? 'runner',
+        runnerDataDir: input.runnerDataDir,
+        apiKey: input.apiKey,
+        bearerToken: input.bearerToken,
+        capabilities: [...(input.capabilities ?? [])],
+        tags: [...(input.tags ?? [])],
+        maxInflight,
+        pollTimeoutMs: input.pollTimeoutMs ?? 35_000,
+        renewIntervalMs: input.renewIntervalMs ?? 15_000,
+        drainTimeoutMs: input.drainTimeoutMs ?? 30_000,
+        pollRetryDelayMs: input.pollRetryDelayMs ?? 5_000,
+        capacityBackoffMs: input.capacityBackoffMs ?? 500,
+        logWriter,
+        logger: input.logger ?? defaultLogger,
+    };
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AA2G/C,MAAM,kBAAkB,GAA6B;IACnD,eAAe,EAAE,GAAG;IACpB,kBAAkB,EAAE,EAAE;IACtB,oBAAoB,EAAE,GAAG;IACzB,eAAe,EAAE,GAAG;IACpB,iBAAiB,EAAE,KAAK;CACzB,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,KAA0B,EAAE,aAAqB;IAC9E,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC5D,MAAM,IAAI,SAAS,CAAC,2CAA2C,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,CAAC;QACH,kCAAkC;QAClC,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,SAAS,CAAC,qDAAqD,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,WAAW,GAAG,CAAC,IAAI,WAAW,GAAG,IAAI,EAAE,CAAC;QAC5E,MAAM,IAAI,UAAU,CAAC,wEAAwE,WAAW,EAAE,CAAC,CAAC;IAC9G,CAAC;IAED,MAAM,SAAS,GAA6B;QAC1C,eAAe,EAAE,KAAK,CAAC,SAAS,EAAE,eAAe,IAAI,kBAAkB,CAAC,eAAe;QACvF,kBAAkB,EAAE,KAAK,CAAC,SAAS,EAAE,kBAAkB,IAAI,kBAAkB,CAAC,kBAAkB;QAChG,oBAAoB,EAAE,KAAK,CAAC,SAAS,EAAE,oBAAoB,IAAI,kBAAkB,CAAC,oBAAoB;QACtG,eAAe,EAAE,KAAK,CAAC,SAAS,EAAE,eAAe,IAAI,kBAAkB,CAAC,eAAe;QACvF,iBAAiB,EAAE,KAAK,CAAC,SAAS,EAAE,iBAAiB,IAAI,kBAAkB,CAAC,iBAAiB;KAC9F,CAAC;IAEF,OAAO;QACL,SAAS,EAAE,mBAAmB,CAAC,KAAK,CAAC,SAAS,CAAC;QAC/C,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,QAAQ;QAChD,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,YAAY,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;QAC7C,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC7B,WAAW;QACX,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,MAAM;QAC5C,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,MAAM;QAChD,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,MAAM;QAC9C,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,IAAI,KAAK;QACjD,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,IAAI,GAAG;QACjD,SAAS;QACT,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,aAAa;KACtC,CAAC;AACJ,CAAC"}

package/dist/protocol.d.ts

@@ -0,0 +1,54 @@
+export interface PollRequest {
+    runner_id: string;
+    capabilities: string[];
+    max_inflight: number;
+    inflight: string[];
+    instance_id?: string;
+    tags: string[];
+}
+export interface WorkAssignment {
+    execution_id: string;
+    job_key: string;
+    fire_at: string;
+    attempt: number;
+    metadata: unknown;
+    timeout?: string;
+}
+export interface PollResponse {
+    work: WorkAssignment[];
+    cancel: string[];
+}
+export type AckStatus = 'success' | 'failure';
+export interface AckRequest {
+    runner_id: string;
+    execution_id: string;
+    status: AckStatus;
+    error?: string;
+    duration_ms?: number;
+    attempt: number;
+}
+export interface RenewRequest {
+    runner_id: string;
+    execution_id: string;
+}
+export interface RegisterJobRequest {
+    job_key: string;
+    schedule: string;
+    timezone?: string;
+    timeout?: string;
+    runner_id?: string;
+    capabilities: string[];
+    description?: string;
+}
+export interface RegisterJobResponse {
+    job_key: string;
+    trigger_id?: string;
+    status?: 'registered' | 'skipped_dsl_precedence';
+}
+export type WorkEventLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error';
+export interface WorkEvent {
+    level?: WorkEventLevel;
+    message: string;
+    fields?: Record<string, string>;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE9C,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,GAAG,wBAAwB,CAAC;CAClD;AAED,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3E,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC"}

package/dist/protocol.js

@@ -0,0 +1,8 @@
+// Wire-protocol types for the Croniq runner API.
+//
+// Field names are snake_case to match the JSON shape in `openapi.yaml`.
+// These types are sent and received verbatim over HTTP — no field
+// transformation happens at the client boundary, so consumer code that
+// touches `metadata` will see the original snake_case keys the server sent.
+export {};
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,wEAAwE;AACxE,kEAAkE;AAClE,uEAAuE;AACvE,4EAA4E"}

package/dist/runner.d.ts

@@ -0,0 +1,40 @@
+import { type JobHandler, type JobRegistrationOptions } from './handler.js';
+import { type CroniqRunnerOptions } from './options.js';
+/**
+ * The Croniq runner: polls the server for work, dispatches handlers
+ * concurrently up to {@link CroniqRunnerOptions.maxInflight}, renews leases
+ * for in-flight executions, and reports completion.
+ *
+ * Call {@link run} to drive the loop yourself. Wire `SIGTERM`/`SIGINT` to
+ * the AbortController you pass in for graceful shutdown.
+ */
+export declare class CroniqRunner {
+    #private;
+    constructor(options: CroniqRunnerOptions);
+    /**
+     * Register a handler for a specific `job_key`. If {@link JobRegistrationOptions.schedule}
+     * is set, the runner calls `POST /v1/jobs/register` for the job at startup
+     * (DSL precedence still applies server-side).
+     */
+    handle(jobKey: string, handler: JobHandler, opts?: JobRegistrationOptions): this;
+    /** Register a fallback handler for any job key that has no specific handler. */
+    setDefaultHandler(handler: JobHandler): this;
+    /** The stable runner ID, available after {@link run} has started. */
+    get runnerId(): string;
+    /** Snapshot of currently in-flight execution IDs. Diagnostic only. */
+    get inflight(): readonly string[];
+    /**
+     * Run the poll/dispatch/ack loop until {@link signal} aborts. Returns when
+     * the token signals AND all in-flight executions have either finished or
+     * the drain timeout elapses.
+     */
+    run(signal?: AbortSignal): Promise<void>;
+    /**
+     * Signal graceful shutdown without waiting. Cancels new polls; in-flight
+     * handlers keep running until they complete or the drain-timeout elapses.
+     */
+    requestDrain(): void;
+}
+/** Convenience factory. Equivalent to `new CroniqRunner(options)`. */
+export declare function createRunner(options: CroniqRunnerOptions): CroniqRunner;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,sBAAsB,EAC5B,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAkB,KAAK,mBAAmB,EAA8B,MAAM,cAAc,CAAC;AAGpG;;;;;;;GAOG;AACH,qBAAa,YAAY;;gBAaX,OAAO,EAAE,mBAAmB;IAYxC;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,sBAAsB,GAAG,IAAI;IAKhF,gFAAgF;IAChF,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAK5C,qEAAqE;IACrE,IAAI,QAAQ,IAAI,MAAM,CAGrB;IAED,sEAAsE;IACtE,IAAI,QAAQ,IAAI,SAAS,MAAM,EAAE,CAEhC;IAED;;;;OAIG;IACG,GAAG,CAAC,MAAM,GAAE,WAA0C,GAAG,OAAO,CAAC,IAAI,CAAC;IA4C5E;;;OAGG;IACH,YAAY,IAAI,IAAI;CAoHrB;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAEvE"}