@nuetzliches/croniq-runner 0.1.0

package/dist/runner.js

@@ -0,0 +1,226 @@
+import { randomBytes } from 'node:crypto';
+import { setMaxListeners } from 'node:events';
+import { anySignal } from './abort.js';
+import { CroniqClient, HttpError } from './client.js';
+import { sleep } from './deferred.js';
+import { ExecutionDispatcher } from './dispatcher.js';
+import { HandlerRegistry, } from './handler.js';
+import { resolveRunnerId } from './identity.js';
+import { consoleLogger } from './logger.js';
+import { resolveOptions } 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 class CroniqRunner {
+    #options;
+    #client;
+    #registry = new HandlerRegistry();
+    #logger;
+    #instanceId = randomBytes(16).toString('hex');
+    #inflight = new Map();
+    #drainAC = new AbortController();
+    #runnerId;
+    #dispatcher;
+    #ran = false;
+    constructor(options) {
+        const defaultLogger = consoleLogger('warn', 'croniq');
+        this.#options = resolveOptions(options, defaultLogger);
+        this.#logger = this.#options.logger;
+        this.#client = new CroniqClient({
+            baseUrl: this.#options.serverUrl,
+            apiKey: this.#options.apiKey,
+            bearerToken: this.#options.bearerToken,
+            logger: this.#logger,
+        });
+    }
+    /**
+     * 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, handler, opts) {
+        this.#registry.register(jobKey, handler, opts);
+        return this;
+    }
+    /** Register a fallback handler for any job key that has no specific handler. */
+    setDefaultHandler(handler) {
+        this.#registry.registerDefault(handler);
+        return this;
+    }
+    /** The stable runner ID, available after {@link run} has started. */
+    get runnerId() {
+        if (!this.#runnerId)
+            throw new Error('runnerId is only available after run() starts');
+        return this.#runnerId;
+    }
+    /** Snapshot of currently in-flight execution IDs. Diagnostic only. */
+    get inflight() {
+        return [...this.#inflight.keys()];
+    }
+    /**
+     * 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.
+     */
+    async run(signal = new AbortController().signal) {
+        if (this.#ran)
+            throw new Error('CroniqRunner.run() may only be called once per instance');
+        this.#ran = true;
+        this.#runnerId = resolveRunnerId({
+            runnerId: this.#options.runnerId,
+            runnerIdPrefix: this.#options.runnerIdPrefix,
+            runnerDataDir: this.#options.runnerDataDir,
+        }, this.#logger);
+        this.#dispatcher = new ExecutionDispatcher({
+            client: this.#client,
+            registry: this.#registry,
+            options: this.#options,
+            runnerId: this.#runnerId,
+            runnerTags: this.#options.tags,
+            logger: this.#logger,
+        });
+        this.#logger.info('Croniq runner starting', {
+            runner_id: this.#runnerId,
+            capabilities: this.#options.capabilities.join(',') || '<none>',
+            max_inflight: this.#options.maxInflight,
+        });
+        await this.#selfRegisterSchedules(signal);
+        const loopSignal = anySignal(signal, this.#drainAC.signal);
+        // The runner's loop signal is observed by every poll, every sleep, and
+        // every in-flight dispatch — well above Node's default ceiling of 10
+        // abort listeners. Lift the cap rather than letting the runtime emit a
+        // misleading "memory leak" warning. (Each listener is cleaned up by its
+        // owner; the count just legitimately grows with `maxInflight`.)
+        setMaxListeners(0, loopSignal);
+        try {
+            await this.#pollLoop(loopSignal);
+        }
+        finally {
+            await this.#drain();
+        }
+    }
+    /**
+     * Signal graceful shutdown without waiting. Cancels new polls; in-flight
+     * handlers keep running until they complete or the drain-timeout elapses.
+     */
+    requestDrain() {
+        if (!this.#drainAC.signal.aborted)
+            this.#drainAC.abort();
+    }
+    async #selfRegisterSchedules(signal) {
+        for (const entry of this.#registry.selfRegister) {
+            try {
+                const payload = {
+                    job_key: entry.jobKey,
+                    schedule: entry.schedule,
+                    runner_id: this.#runnerId,
+                    capabilities: this.#options.capabilities,
+                };
+                if (entry.timeout !== undefined)
+                    payload.timeout = entry.timeout;
+                if (entry.description !== undefined)
+                    payload.description = entry.description;
+                await this.#client.registerJob(payload, signal);
+            }
+            catch (err) {
+                this.#logger.warn(`self-register for job ${entry.jobKey} failed — runner will still poll, ` +
+                    'but the server may not have a schedule', { job_key: entry.jobKey, error: String(err) });
+            }
+        }
+    }
+    async #pollLoop(signal) {
+        while (!signal.aborted) {
+            if (this.#inflight.size >= this.#options.maxInflight) {
+                try {
+                    await sleep(this.#options.capacityBackoffMs, signal);
+                }
+                catch {
+                    return;
+                }
+                continue;
+            }
+            const request = {
+                runner_id: this.#runnerId,
+                capabilities: this.#options.capabilities,
+                max_inflight: this.#options.maxInflight,
+                inflight: [...this.#inflight.keys()],
+                instance_id: this.#instanceId,
+                tags: this.#options.tags,
+            };
+            let response;
+            try {
+                response = await this.#client.poll(request, this.#options.pollTimeoutMs, signal);
+            }
+            catch (err) {
+                if (signal.aborted)
+                    return;
+                const detail = err instanceof HttpError
+                    ? { status: err.status, status_text: err.statusText }
+                    : { error: String(err) };
+                this.#logger.warn(`poll failed — backing off ${this.#options.pollRetryDelayMs}ms`, detail);
+                try {
+                    await sleep(this.#options.pollRetryDelayMs, signal);
+                }
+                catch {
+                    return;
+                }
+                continue;
+            }
+            this.#handleCancellations(response.cancel);
+            for (const assignment of response.work) {
+                if (this.#inflight.has(assignment.execution_id))
+                    continue;
+                const ac = new AbortController();
+                this.#inflight.set(assignment.execution_id, ac);
+                // Fire-and-forget; the inflight map cleans up in the .finally().
+                void this.#dispatcher
+                    .dispatch(assignment, ac, signal)
+                    .finally(() => {
+                    this.#inflight.delete(assignment.execution_id);
+                });
+            }
+        }
+    }
+    #handleCancellations(cancelIds) {
+        if (cancelIds.length === 0)
+            return;
+        for (const id of cancelIds) {
+            const ac = this.#inflight.get(id);
+            if (ac && !ac.signal.aborted) {
+                this.#logger.info(`server requested cancellation of execution ${id}`, { execution_id: id });
+                ac.abort();
+            }
+        }
+    }
+    async #drain() {
+        if (this.#inflight.size === 0)
+            return;
+        this.#logger.info(`draining ${this.#inflight.size} in-flight execution(s) (timeout ${this.#options.drainTimeoutMs}ms)`, { count: this.#inflight.size, timeout_ms: this.#options.drainTimeoutMs });
+        const deadline = Date.now() + this.#options.drainTimeoutMs;
+        while (this.#inflight.size > 0 && Date.now() < deadline) {
+            await sleep(50);
+        }
+        if (this.#inflight.size > 0) {
+            this.#logger.warn(`drain timed out with ${this.#inflight.size} execution(s) still in-flight — hard-cancelling`, { count: this.#inflight.size });
+            for (const ac of this.#inflight.values()) {
+                if (!ac.signal.aborted)
+                    ac.abort();
+            }
+            // Give the dispatcher one tick to process the abort and ack.
+            const hardDeadline = Date.now() + 1_000;
+            while (this.#inflight.size > 0 && Date.now() < hardDeadline) {
+                await sleep(25);
+            }
+        }
+    }
+}
+/** Convenience factory. Equivalent to `new CroniqRunner(options)`. */
+export function createRunner(options) {
+    return new CroniqRunner(options);
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/dist/url.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Strips trailing forward slashes from a string. Linear in the length of
+ * the suffix that's stripped.
+ *
+ *   trimTrailingSlashes("http://x")    === "http://x"
+ *   trimTrailingSlashes("http://x/")   === "http://x"
+ *   trimTrailingSlashes("http://x///") === "http://x"
+ */
+export declare function trimTrailingSlashes(value: string): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../src/url.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMzD"}

package/dist/url.js

@@ -0,0 +1,20 @@
+// Small URL utilities. Kept regex-free on purpose: CodeQL's "polynomial
+// regex" heuristic flags even linear patterns like `/\/+$/` when the
+// input is library-controlled, and the loop equivalent is both clearer
+// and immune to the warning.
+/**
+ * Strips trailing forward slashes from a string. Linear in the length of
+ * the suffix that's stripped.
+ *
+ *   trimTrailingSlashes("http://x")    === "http://x"
+ *   trimTrailingSlashes("http://x/")   === "http://x"
+ *   trimTrailingSlashes("http://x///") === "http://x"
+ */
+export function trimTrailingSlashes(value) {
+    let end = value.length;
+    while (end > 0 && value.charCodeAt(end - 1) === 47 /* '/' */) {
+        end--;
+    }
+    return end === value.length ? value : value.slice(0, end);
+}
+//# sourceMappingURL=url.js.map

package/dist/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../src/url.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,qEAAqE;AACrE,uEAAuE;AACvE,6BAA6B;AAE7B;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IACvB,OAAO,GAAG,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,CAAC;QAC7D,GAAG,EAAE,CAAC;IACR,CAAC;IACD,OAAO,GAAG,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC5D,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@nuetzliches/croniq-runner",
+  "version": "0.1.0",
+  "description": "Croniq runner SDK for Node.js. Polls a Croniq server for work, dispatches handlers, streams logs back.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE-MIT",
+    "LICENSE-APACHE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist coverage",
+    "lint": "eslint src test",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.test.json"
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.30",
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
+    "@vitest/coverage-v8": "^2.1.9",
+    "eslint": "^8.57.1",
+    "typescript": "^5.5.4",
+    "vitest": "^2.1.9"
+  },
+  "keywords": [
+    "croniq",
+    "cron",
+    "scheduler",
+    "runner",
+    "sdk",
+    "jobs"
+  ],
+  "homepage": "https://github.com/nuetzliches/croniq/tree/main/sdks/typescript",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nuetzliches/croniq.git",
+    "directory": "sdks/typescript"
+  },
+  "license": "(MIT OR Apache-2.0)",
+  "bugs": {
+    "url": "https://github.com/nuetzliches/croniq/issues"
+  }
+}