@nuetzliches/croniq-runner 0.1.0

package/dist/dispatcher.d.ts

@@ -0,0 +1,33 @@
+import type { CroniqClient } from './client.js';
+import { type HandlerRegistry } from './handler.js';
+import { type Logger } from './logger.js';
+import type { ResolvedRunnerOptions } from './options.js';
+import type { WorkAssignment } from './protocol.js';
+export interface DispatcherDeps {
+    client: CroniqClient;
+    registry: HandlerRegistry;
+    options: ResolvedRunnerOptions;
+    runnerId: string;
+    runnerTags: readonly string[];
+    logger: Logger;
+}
+/**
+ * Owns the lifecycle of a single in-flight execution: builds the
+ * {@link ExecutionContext}, runs the handler under a per-execution
+ * AbortSignal, periodically renews the work-item lease, drains the
+ * streaming log writer (if used), and acks the outcome.
+ */
+export declare class ExecutionDispatcher {
+    #private;
+    constructor(deps: DispatcherDeps);
+    /**
+     * Dispatch a single work assignment.
+     *
+     * @param executionAC – AbortController owned by the runner; aborted on
+     *   server-initiated cancel or drain-timeout.
+     * @param outerSignal – host shutdown signal. Used to distinguish "draining"
+     *   from "server-cancelled" when classifying errors.
+     */
+    dispatch(assignment: WorkAssignment, executionAC: AbortController, outerSignal: AbortSignal): Promise<void>;
+}
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,OAAO,EAAE,KAAK,eAAe,EAA4B,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAyB,cAAc,EAAE,MAAM,eAAe,CAAC;AAE3E,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,qBAAa,mBAAmB;;gBAGlB,IAAI,EAAE,cAAc;IAIhC;;;;;;;OAOG;IACG,QAAQ,CACZ,UAAU,EAAE,cAAc,EAC1B,WAAW,EAAE,eAAe,EAC5B,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,IAAI,CAAC;CA+HjB"}

package/dist/dispatcher.js

@@ -0,0 +1,159 @@
+import { anySignal } from './abort.js';
+import { ExecutionContextImpl } from './context.js';
+import { sleep } from './deferred.js';
+import { parseTimeoutMs } from './duration.js';
+import { LogEnrichment } from './enrichment.js';
+import { NoHandlerRegisteredError } from './handler.js';
+import { scopedLogger } from './logger.js';
+/**
+ * Owns the lifecycle of a single in-flight execution: builds the
+ * {@link ExecutionContext}, runs the handler under a per-execution
+ * AbortSignal, periodically renews the work-item lease, drains the
+ * streaming log writer (if used), and acks the outcome.
+ */
+export class ExecutionDispatcher {
+    #deps;
+    constructor(deps) {
+        this.#deps = deps;
+    }
+    /**
+     * Dispatch a single work assignment.
+     *
+     * @param executionAC – AbortController owned by the runner; aborted on
+     *   server-initiated cancel or drain-timeout.
+     * @param outerSignal – host shutdown signal. Used to distinguish "draining"
+     *   from "server-cancelled" when classifying errors.
+     */
+    async dispatch(assignment, executionAC, outerSignal) {
+        const { client, registry, options, runnerId, runnerTags, logger } = this.#deps;
+        const executionId = assignment.execution_id;
+        const jobKey = assignment.job_key;
+        const attempt = assignment.attempt;
+        const timeoutMs = parseTimeoutMs(assignment.timeout) ?? 5 * 60_000;
+        const handlerLogger = scopedLogger(logger, {
+            execution_id: executionId,
+            job_key: jobKey,
+            runner_id: runnerId,
+            attempt,
+        });
+        const enrichment = new LogEnrichment(jobKey, runnerId, runnerTags);
+        const ctx = new ExecutionContextImpl({
+            executionId,
+            jobKey,
+            attempt,
+            metadata: assignment.metadata,
+            timeoutMs,
+            runnerId,
+            runnerTags,
+            signal: executionAC.signal,
+            logger: handlerLogger,
+            client,
+            enrichment,
+            logWriterOptions: options.logWriter,
+            sdkLogger: logger,
+        });
+        // Lease-renewal loop runs alongside the handler. Linked to the
+        // execution's abort signal so server-cancel/drain stops it.
+        const renewAC = new AbortController();
+        const renewSignal = anySignal(executionAC.signal, renewAC.signal);
+        const renewTask = this.#renewLoop(executionId, runnerId, renewSignal);
+        const startedAt = Date.now();
+        let status;
+        let error;
+        try {
+            const handler = registry.resolve(jobKey);
+            if (!handler)
+                throw new NoHandlerRegisteredError(jobKey);
+            await handler(ctx);
+            status = 'success';
+        }
+        catch (err) {
+            if (executionAC.signal.aborted && outerSignal.aborted) {
+                status = 'failure';
+                error = 'runner draining';
+            }
+            else if (executionAC.signal.aborted) {
+                status = 'failure';
+                error = 'cancelled by server';
+            }
+            else {
+                const ex = err instanceof Error ? err : new Error(String(err));
+                logger.warn(`handler for ${jobKey} (execution ${executionId}) threw`, {
+                    error: ex.message,
+                    job_key: jobKey,
+                    execution_id: executionId,
+                });
+                status = 'failure';
+                error = ex.message;
+            }
+        }
+        finally {
+            renewAC.abort();
+            try {
+                await renewTask;
+            }
+            catch {
+                // expected on cancellation
+            }
+        }
+        const durationMs = Date.now() - startedAt;
+        const writer = ctx.logWriterIfCreated;
+        if (writer) {
+            try {
+                await writer.dispose();
+            }
+            catch (err) {
+                logger.warn(`log_writer drain failed for execution ${executionId}`, {
+                    error: String(err),
+                    execution_id: executionId,
+                });
+            }
+        }
+        // Ack uses a fresh AbortController so a draining outer signal cannot
+        // cancel the final ack POST. Match the .NET SDK's `CancellationToken.None`.
+        const ackAC = new AbortController();
+        try {
+            const payload = {
+                runner_id: runnerId,
+                execution_id: executionId,
+                status,
+                attempt,
+                duration_ms: durationMs,
+            };
+            if (error !== undefined)
+                payload.error = error;
+            await client.ack(payload, ackAC.signal);
+        }
+        catch (err) {
+            logger.error(`failed to ack execution ${executionId}`, {
+                error: String(err),
+                execution_id: executionId,
+            });
+        }
+    }
+    async #renewLoop(executionId, runnerId, signal) {
+        const { client, options, logger } = this.#deps;
+        while (!signal.aborted) {
+            try {
+                await sleep(options.renewIntervalMs, signal);
+            }
+            catch {
+                return;
+            }
+            if (signal.aborted)
+                return;
+            try {
+                await client.renew({ runner_id: runnerId, execution_id: executionId }, signal);
+            }
+            catch (err) {
+                if (signal.aborted)
+                    return;
+                logger.debug(`lease renew failed for execution ${executionId}`, {
+                    error: String(err),
+                    execution_id: executionId,
+                });
+            }
+        }
+    }
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/dispatcher.js.map

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

package/dist/duration.d.ts

@@ -0,0 +1,2 @@
+export declare function parseTimeoutMs(raw: string | undefined | null): number | undefined;
+//# sourceMappingURL=duration.d.ts.map

package/dist/duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../src/duration.ts"],"names":[],"mappings":"AAIA,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAejF"}

package/dist/duration.js

@@ -0,0 +1,23 @@
+// Humane duration strings (e.g. "5m", "30s", "1h") emitted by the Croniq
+// server in `WorkAssignment.timeout`. The .NET SDK supports `s/m/h/d`; we
+// match that vocabulary here so the same server output parses identically.
+export function parseTimeoutMs(raw) {
+    if (raw == null)
+        return undefined;
+    const text = String(raw).trim().toLowerCase();
+    if (text.length < 2)
+        return undefined;
+    const unit = text[text.length - 1];
+    const valueStr = text.slice(0, -1);
+    const value = Number(valueStr);
+    if (!Number.isFinite(value))
+        return undefined;
+    switch (unit) {
+        case 's': return value * 1_000;
+        case 'm': return value * 60_000;
+        case 'h': return value * 3_600_000;
+        case 'd': return value * 86_400_000;
+        default: return undefined;
+    }
+}
+//# sourceMappingURL=duration.js.map

package/dist/duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.js","sourceRoot":"","sources":["../src/duration.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,0EAA0E;AAC1E,2EAA2E;AAE3E,MAAM,UAAU,cAAc,CAAC,GAA8B;IAC3D,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,GAAG,KAAK,CAAC;QAC/B,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,GAAG,MAAM,CAAC;QAChC,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,GAAG,SAAS,CAAC;QACnC,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,GAAG,UAAU,CAAC;QACpC,OAAO,CAAC,CAAC,OAAO,SAAS,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/enrichment.d.ts

@@ -0,0 +1,15 @@
+import type { WorkEvent } from './protocol.js';
+/**
+ * Per-execution helper that injects `job_key`, `runner_id`, and (when set)
+ * `runner_tags` into every event's `fields` map. Explicit caller values win
+ * — the enricher uses `TryAdd` semantics, so a handler that puts an
+ * `runner_id` in its own fields keeps that override.
+ *
+ * Mirrors `LogEnrichment` from the .NET SDK.
+ */
+export declare class LogEnrichment {
+    #private;
+    constructor(jobKey: string, runnerId: string, runnerTags: readonly string[]);
+    enrich(source: WorkEvent): WorkEvent;
+}
+//# sourceMappingURL=enrichment.d.ts.map

package/dist/enrichment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrichment.d.ts","sourceRoot":"","sources":["../src/enrichment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;;GAOG;AACH,qBAAa,aAAa;;gBAKZ,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE;IAM3E,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS;CASrC"}

package/dist/enrichment.js

@@ -0,0 +1,30 @@
+/**
+ * Per-execution helper that injects `job_key`, `runner_id`, and (when set)
+ * `runner_tags` into every event's `fields` map. Explicit caller values win
+ * — the enricher uses `TryAdd` semantics, so a handler that puts an
+ * `runner_id` in its own fields keeps that override.
+ *
+ * Mirrors `LogEnrichment` from the .NET SDK.
+ */
+export class LogEnrichment {
+    #jobKey;
+    #runnerId;
+    #serializedTags;
+    constructor(jobKey, runnerId, runnerTags) {
+        this.#jobKey = jobKey;
+        this.#runnerId = runnerId;
+        this.#serializedTags = runnerTags.length === 0 ? undefined : JSON.stringify(runnerTags);
+    }
+    enrich(source) {
+        const fields = { ...(source.fields ?? {}) };
+        if (!('job_key' in fields))
+            fields.job_key = this.#jobKey;
+        if (!('runner_id' in fields))
+            fields.runner_id = this.#runnerId;
+        if (this.#serializedTags !== undefined && !('runner_tags' in fields)) {
+            fields.runner_tags = this.#serializedTags;
+        }
+        return { ...source, fields };
+    }
+}
+//# sourceMappingURL=enrichment.js.map

package/dist/enrichment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrichment.js","sourceRoot":"","sources":["../src/enrichment.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,OAAO,aAAa;IACf,OAAO,CAAS;IAChB,SAAS,CAAS;IAClB,eAAe,CAAqB;IAE7C,YAAY,MAAc,EAAE,QAAgB,EAAE,UAA6B;QACzE,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,eAAe,GAAG,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC1F,CAAC;IAED,MAAM,CAAC,MAAiB;QACtB,MAAM,MAAM,GAA2B,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;QACpE,IAAI,CAAC,CAAC,SAAS,IAAI,MAAM,CAAC;YAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC1D,IAAI,CAAC,CAAC,WAAW,IAAI,MAAM,CAAC;YAAE,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChE,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,IAAI,CAAC,CAAC,aAAa,IAAI,MAAM,CAAC,EAAE,CAAC;YACrE,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC;QAC5C,CAAC;QACD,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,CAAC;IAC/B,CAAC;CACF"}

package/dist/handler.d.ts

@@ -0,0 +1,35 @@
+import type { ExecutionContext } from './context.js';
+export type JobHandler = (ctx: ExecutionContext) => void | Promise<void>;
+export interface JobRegistrationOptions {
+    /**
+     * If set, the runner calls `POST /v1/jobs/register` with this schedule
+     * string at startup. Format follows the Croniqfile interval/cron syntax,
+     * e.g. `"5m"`, `"1h"`, or a 5-field crontab expression.
+     */
+    schedule?: string;
+    /** Server-side timeout to register with the schedule (e.g. `"10m"`). */
+    timeout?: string;
+    /** Human-readable description for the registered job. */
+    description?: string;
+}
+export interface SelfRegisterEntry {
+    jobKey: string;
+    schedule: string;
+    timeout: string | undefined;
+    description: string | undefined;
+}
+/** Map of `job_key` → handler, plus an optional default handler. */
+export declare class HandlerRegistry {
+    #private;
+    register(jobKey: string, handler: JobHandler, opts?: JobRegistrationOptions): void;
+    registerDefault(handler: JobHandler): void;
+    resolve(jobKey: string): JobHandler | undefined;
+    get selfRegister(): readonly SelfRegisterEntry[];
+    get hasDefault(): boolean;
+    get keys(): readonly string[];
+}
+export declare class NoHandlerRegisteredError extends Error {
+    readonly jobKey: string;
+    constructor(jobKey: string);
+}
+//# sourceMappingURL=handler.d.ts.map

package/dist/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEzE,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,oEAAoE;AACpE,qBAAa,eAAe;;IAK1B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,sBAAsB,GAAG,IAAI;IAclF,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAK1C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI/C,IAAI,YAAY,IAAI,SAAS,iBAAiB,EAAE,CAE/C;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,IAAI,IAAI,SAAS,MAAM,EAAE,CAE5B;CACF;AAED,qBAAa,wBAAyB,SAAQ,KAAK;aACrB,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM;CAI3C"}

package/dist/handler.js

@@ -0,0 +1,47 @@
+/** Map of `job_key` → handler, plus an optional default handler. */
+export class HandlerRegistry {
+    #handlers = new Map();
+    #selfRegister = [];
+    #default;
+    register(jobKey, handler, opts) {
+        if (!jobKey)
+            throw new TypeError('jobKey is required');
+        if (typeof handler !== 'function')
+            throw new TypeError('handler must be a function');
+        this.#handlers.set(jobKey, handler);
+        if (opts?.schedule) {
+            this.#selfRegister.push({
+                jobKey,
+                schedule: opts.schedule,
+                timeout: opts.timeout,
+                description: opts.description,
+            });
+        }
+    }
+    registerDefault(handler) {
+        if (typeof handler !== 'function')
+            throw new TypeError('handler must be a function');
+        this.#default = handler;
+    }
+    resolve(jobKey) {
+        return this.#handlers.get(jobKey) ?? this.#default;
+    }
+    get selfRegister() {
+        return this.#selfRegister;
+    }
+    get hasDefault() {
+        return this.#default !== undefined;
+    }
+    get keys() {
+        return [...this.#handlers.keys()];
+    }
+}
+export class NoHandlerRegisteredError extends Error {
+    jobKey;
+    constructor(jobKey) {
+        super(`No handler registered for job '${jobKey}' and no default handler configured`);
+        this.jobKey = jobKey;
+        this.name = 'NoHandlerRegisteredError';
+    }
+}
+//# sourceMappingURL=handler.js.map

package/dist/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAwBA,oEAAoE;AACpE,MAAM,OAAO,eAAe;IACjB,SAAS,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC1C,aAAa,GAAwB,EAAE,CAAC;IACjD,QAAQ,CAAyB;IAEjC,QAAQ,CAAC,MAAc,EAAE,OAAmB,EAAE,IAA6B;QACzE,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,SAAS,CAAC,oBAAoB,CAAC,CAAC;QACvD,IAAI,OAAO,OAAO,KAAK,UAAU;YAAE,MAAM,IAAI,SAAS,CAAC,4BAA4B,CAAC,CAAC;QACrF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,IAAI,IAAI,EAAE,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;gBACtB,MAAM;gBACN,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,eAAe,CAAC,OAAmB;QACjC,IAAI,OAAO,OAAO,KAAK,UAAU;YAAE,MAAM,IAAI,SAAS,CAAC,4BAA4B,CAAC,CAAC;QACrF,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,OAAO,CAAC,MAAc;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC;IACrD,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC;IACrC,CAAC;IAED,IAAI,IAAI;QACN,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACrB;IAA5B,YAA4B,MAAc;QACxC,KAAK,CAAC,kCAAkC,MAAM,qCAAqC,CAAC,CAAC;QAD3D,WAAM,GAAN,MAAM,CAAQ;QAExC,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF"}

package/dist/identity.d.ts

@@ -0,0 +1,23 @@
+import type { Logger } from './logger.js';
+export interface IdentityResolverInput {
+    /** Explicit runner-id from configuration. */
+    runnerId?: string | undefined;
+    /** Prefix used when generating a fresh id. */
+    runnerIdPrefix: string;
+    /** Optional data dir override. Falls back to env var, then platform default. */
+    runnerDataDir?: string | undefined;
+}
+/**
+ * Resolves the runner ID with the same precedence as the .NET / Rust SDKs:
+ *
+ *  1. Explicit option
+ *  2. `RUNNER_ID` env var
+ *  3. Persisted `runner-id` state file under {@link IdentityResolverInput.runnerDataDir}
+ *     (or `CRONIQ_RUNNER_DATA_DIR`, or the platform default)
+ *  4. Newly generated `{prefix}-{hex8}`, persisted to the state file
+ *
+ * If persistence fails (filesystem read-only etc.), returns a deterministic
+ * `{prefix}-{hostname}` fallback so the runner can still start.
+ */
+export declare function resolveRunnerId(input: IdentityResolverInput, logger: Logger): string;
+//# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,qBAAqB;IACpC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,8CAA8C;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA4BpF"}

package/dist/identity.js

@@ -0,0 +1,64 @@
+import { randomBytes } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir, hostname } from 'node:os';
+import { join } from 'node:path';
+/**
+ * Resolves the runner ID with the same precedence as the .NET / Rust SDKs:
+ *
+ *  1. Explicit option
+ *  2. `RUNNER_ID` env var
+ *  3. Persisted `runner-id` state file under {@link IdentityResolverInput.runnerDataDir}
+ *     (or `CRONIQ_RUNNER_DATA_DIR`, or the platform default)
+ *  4. Newly generated `{prefix}-{hex8}`, persisted to the state file
+ *
+ * If persistence fails (filesystem read-only etc.), returns a deterministic
+ * `{prefix}-{hostname}` fallback so the runner can still start.
+ */
+export function resolveRunnerId(input, logger) {
+    if (input.runnerId && input.runnerId.length > 0)
+        return input.runnerId;
+    const fromEnv = process.env.RUNNER_ID;
+    if (fromEnv && fromEnv.length > 0)
+        return fromEnv;
+    const dataDir = resolveDataDir(input.runnerDataDir);
+    const idFile = join(dataDir, 'runner-id');
+    try {
+        if (existsSync(idFile)) {
+            const persisted = readFileSync(idFile, 'utf8').trim();
+            if (persisted.length > 0)
+                return persisted;
+        }
+    }
+    catch (err) {
+        logger.warn(`could not read persisted runner ID from ${idFile}`, { error: String(err) });
+    }
+    const generated = `${input.runnerIdPrefix}-${randomBytes(4).toString('hex')}`;
+    try {
+        mkdirSync(dataDir, { recursive: true });
+        writeFileSync(idFile, generated, 'utf8');
+    }
+    catch (err) {
+        logger.warn(`could not persist generated runner ID to ${idFile}`, { error: String(err) });
+        return `${input.runnerIdPrefix}-${hostname().toLowerCase()}`;
+    }
+    return generated;
+}
+function resolveDataDir(override) {
+    if (override && override.length > 0)
+        return override;
+    const fromEnv = process.env.CRONIQ_RUNNER_DATA_DIR;
+    if (fromEnv && fromEnv.length > 0)
+        return fromEnv;
+    // Platform-appropriate state directory.
+    // On Linux/macOS use $XDG_STATE_HOME or ~/.local/state; on Windows use %LOCALAPPDATA%.
+    if (process.platform === 'win32') {
+        const localAppData = process.env.LOCALAPPDATA ?? join(homedir(), 'AppData', 'Local');
+        return join(localAppData, 'croniq-runner');
+    }
+    const xdgStateHome = process.env.XDG_STATE_HOME;
+    const base = xdgStateHome && xdgStateHome.length > 0
+        ? xdgStateHome
+        : join(homedir(), '.local', 'state');
+    return join(base, 'croniq-runner');
+}
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { CroniqRunner, createRunner } from './runner.js';
+export type { CroniqRunnerOptions, LogWriterOptions, ResolvedRunnerOptions, ResolvedLogWriterOptions, } from './options.js';
+export type { ExecutionContext } from './context.js';
+export type { JobHandler, JobRegistrationOptions } from './handler.js';
+export { NoHandlerRegisteredError } from './handler.js';
+export type { Logger, LogLevel } from './logger.js';
+export { consoleLogger, noopLogger } from './logger.js';
+export type { LogWriter } from './log-writer.js';
+export type { AckRequest, AckStatus, PollRequest, PollResponse, RegisterJobRequest, RegisterJobResponse, RenewRequest, WorkAssignment, WorkEvent, WorkEventLevel, } from './protocol.js';
+export { HttpError } from './client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,SAAS,EACT,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// Public API surface for `@nuetzliches/croniq-runner`.
+export { CroniqRunner, createRunner } from './runner.js';
+export { NoHandlerRegisteredError } from './handler.js';
+export { consoleLogger, noopLogger } from './logger.js';
+export { HttpError } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AASzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAcxD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/log-writer.d.ts

@@ -0,0 +1,38 @@
+import type { CroniqClient } from './client.js';
+import type { LogEnrichment } from './enrichment.js';
+import type { Logger } from './logger.js';
+import type { ResolvedLogWriterOptions } from './options.js';
+import type { WorkEvent, WorkEventLevel } from './protocol.js';
+export interface LogWriter {
+    /** Append an event. Awaits a slot if the bounded buffer is full. */
+    write(level: WorkEventLevel, message: string, fields?: Record<string, string>): Promise<void>;
+    /** Append a pre-built event. */
+    writeEvent(event: WorkEvent): Promise<void>;
+    /** Block until every queued event has been POSTed. */
+    flush(): Promise<void>;
+    /**
+     * Close the writer and wait for the background flusher to drain, bounded
+     * by `shutdownTimeoutMs`. Safe to call multiple times.
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * 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 declare class StreamingLogWriter implements LogWriter {
+    #private;
+    constructor(client: CroniqClient, executionId: string, enrichment: LogEnrichment, opts: ResolvedLogWriterOptions, logger: Logger);
+    write(level: WorkEventLevel, message: string, fields?: Record<string, string>): Promise<void>;
+    writeEvent(event: WorkEvent): Promise<void>;
+    flush(): Promise<void>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=log-writer.d.ts.map

package/dist/log-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-writer.d.ts","sourceRoot":"","sources":["../src/log-writer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/D,MAAM,WAAW,SAAS;IACxB,oEAAoE;IACpE,KAAK,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9F,gCAAgC;IAChC,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,sDAAsD;IACtD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,kBAAmB,YAAW,SAAS;;gBAkBhD,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,aAAa,EACzB,IAAI,EAAE,wBAAwB,EAC9B,MAAM,EAAE,MAAM;IAUV,KAAK,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7F,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQhB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAyG/B"}