ravenflow 0.4.0 → 0.4.1

package/dist/index.mjs

@@ -1,8 +1,8 @@
 import { z } from 'zod';
+import { Redis } from 'ioredis';
 import pino from 'pino';
 import { MongoClient, ObjectId, MongoBulkWriteError, BSON } from 'mongodb';
-import { Queue, Worker, MetricsTime, isRedisInstance, Job, DelayedError } from 'bullmq';
-import { Redis } from 'ioredis';
+import { Queue, Worker, MetricsTime, Job, isRedisInstance, DelayedError } from 'bullmq';
 import { format, inspect } from 'util';
 
 // src/config/validate-config/schemas/config.schema.ts
@@ -260,145 +260,6 @@ function throwIfAny(errors) {
   throw new Error(`[ravenflow] Config validation failed:
   - ${errors.join("\n  - ")}`);
 }
-function createLogger(options = {}) {
-  const isDev = process.env.NODE_ENV !== "production";
-  const usePretty = options.pretty ?? isDev;
-  return pino({
-    level: options.level ?? (isDev ? "debug" : "info"),
-    transport: usePretty ? {
-      target: "pino-pretty",
-      options: {
-        colorize: true,
-        translateTime: "HH:MM:ss",
-        ignore: "pid,hostname,job",
-        messageFormat: "{if job}({job}) {end}{msg}"
-      }
-    } : void 0
-  });
-}
-var MongoConnection = class {
-  constructor(uri) {
-    this.uri = uri;
-    this.client = null;
-    this.database = null;
-    this.connecting = null;
-  }
-  async connect() {
-    if (this.database) return this.database;
-    this.connecting ?? (this.connecting = this.openTheDatabase().catch(
-      (error) => this.forgetTheAttempt(error)
-    ));
-    return this.connecting;
-  }
-  async close() {
-    const closing = this.client;
-    this.client = null;
-    this.database = null;
-    this.connecting = null;
-    await closing?.close();
-  }
-  async openTheDatabase() {
-    const opened = new MongoClient(this.uri);
-    await opened.connect();
-    this.client = opened;
-    this.database = opened.db();
-    return this.database;
-  }
-  forgetTheAttempt(error) {
-    this.connecting = null;
-    throw error;
-  }
-};
-
-// src/queues/declared-queues.ts
-function declaredQueueNames(config) {
-  const queueOfEachJob = Object.values(config.jobs).map(
-    (job) => queueOf(job, config)
-  );
-  return [.../* @__PURE__ */ new Set([config.defaultQueue, ...queueOfEachJob])];
-}
-function jobsDeclaredOn(queue, config) {
-  return Object.fromEntries(
-    Object.entries(config.jobs).filter(
-      ([, job]) => queueOf(job, config) === queue
-    )
-  );
-}
-function queueOf(job, config) {
-  return job.queue ?? config.defaultQueue;
-}
-
-// src/queues/open-queues.ts
-function openQueues(config, connection) {
-  const settings = { connection, retention: config.queuesRetention };
-  return Object.fromEntries(
-    declaredQueueNames(config).map((name) => [
-      name,
-      openQueue(name, settings)
-    ])
-  );
-}
-function openQueue(name, settings) {
-  return new Queue(name, {
-    connection: settings.connection,
-    defaultJobOptions: defaultJobOptionsFor(settings.retention)
-  });
-}
-function defaultJobOptionsFor(retention = {}) {
-  return {
-    removeOnComplete: {
-      count: retention.completedCount ?? DEFAULT_COMPLETED_COUNT_RETENTION
-    },
-    removeOnFail: {
-      count: retention.failedCount ?? DEFAULT_FAILED_COUNT_RETENTION
-    }
-  };
-}
-
-// src/queues/close-queues.ts
-async function closeQueues(queues) {
-  await Promise.all(Object.values(queues).map((queue) => queue.close()));
-}
-
-// src/queues/build-job-options.ts
-function buildJobOptions(job) {
-  const options = {};
-  if (job.attempts !== void 0) options.attempts = job.attempts;
-  if (job.backoff !== void 0) options.backoff = backoffOptions(job.backoff);
-  return options;
-}
-function backoffOptions(backoff) {
-  return {
-    type: backoff.type,
-    delay: backoff.delayMs,
-    jitter: backoff.jitter
-  };
-}
-
-// src/queues/link-id.ts
-var LINK_SEPARATOR = ".";
-var A_NUMBERED_LINK = /^(.+)\.([1-9]\d*)$/;
-function nextLinkIdOf(linkId) {
-  const { runId, link } = linkOfItsRun(linkId);
-  return linkIdOf({ runId, link: link + 1 });
-}
-function linkIdOf({ runId, link }) {
-  if (link === 0) return runId;
-  return `${asACustomJobId(runId)}${LINK_SEPARATOR}${link}`;
-}
-function linkOfItsRun(linkId) {
-  const numbered = A_NUMBERED_LINK.exec(linkId);
-  if (numbered === null) return { runId: linkId, link: 0 };
-  return { runId: numbered[1], link: Number(numbered[2]) };
-}
-function asACustomJobId(runId) {
-  if (holdsColonsBullmqRefuses(runId)) return encodeURIComponent(runId);
-  return runId;
-}
-function holdsColonsBullmqRefuses(id) {
-  const parts = id.split(":").length;
-  return parts !== 1 && parts !== 3;
-}
 
 // src/control-plane/control-key.ts
 var JOB_PREFIX = "job:";
@@ -884,83 +745,222 @@ function initControlPlane(runtime) {
   });
   return new ControlPlane({ store, channel, logger: runtime.logger });
 }
-var BACKLOG_COLLECTION_PREFIX = "rav:spool-backlog:";
-var NEVER_CLAIMED = { claimedAt: { $exists: false } };
-var CLAIMED = { claimedAt: { $type: "date" } };
-var CLAIM_INDEX = { claimedAt: 1, _id: 1 };
-var OLDEST_FIRST = { _id: 1 };
-var MS_PER_SECOND = 1e3;
-var Backlog = class {
-  constructor(spoolName, connection) {
-    this.spoolName = spoolName;
-    this.connection = connection;
-  }
-  async push(item) {
-    const backlog = await this.collection();
-    const { insertedId } = await backlog.insertOne({ item });
-    return insertedId.toHexString();
-  }
-  async pushMany(items) {
-    if (items.length === 0) return [];
-    const backlog = await this.collection();
-    const { insertedIds } = await backlog.insertMany(
-      items.map((item) => ({ item }))
-    );
-    return items.map((_, position) => insertedIds[position].toHexString());
-  }
-  async purge() {
-    const backlog = await this.collection();
-    const { deletedCount } = await backlog.deleteMany(NEVER_CLAIMED);
-    return {
-      dropped: deletedCount,
-      inFlight: await backlog.countDocuments(CLAIMED)
-    };
-  }
-  async indexForTheClaim() {
-    const backlog = await this.collection();
-    await backlog.createIndex(CLAIM_INDEX);
-  }
-  async countInFlight() {
-    const backlog = await this.collection();
-    return backlog.countDocuments(CLAIMED);
+function createLogger(options = {}) {
+  const isDev = process.env.NODE_ENV !== "production";
+  const usePretty = options.pretty ?? isDev;
+  return pino({
+    level: options.level ?? (isDev ? "debug" : "info"),
+    transport: usePretty ? {
+      target: "pino-pretty",
+      options: {
+        colorize: true,
+        translateTime: "HH:MM:ss",
+        ignore: "pid,hostname,job",
+        messageFormat: "{if job}({job}) {end}{msg}"
+      }
+    } : void 0
+  });
+}
+var MongoConnection = class {
+  constructor(uri) {
+    this.uri = uri;
+    this.client = null;
+    this.database = null;
+    this.connecting = null;
   }
-  async expireUnclaimedPushedBefore(pushedBefore) {
-    const backlog = await this.collection();
-    const { deletedCount } = await backlog.deleteMany({
-      ...NEVER_CLAIMED,
-      _id: { $lt: ObjectId.createFromTime(secondsOf(pushedBefore)) }
-    });
-    return deletedCount;
+  async connect() {
+    if (this.database) return this.database;
+    this.connecting ?? (this.connecting = this.openTheDatabase().catch(
+      (error) => this.forgetTheAttempt(error)
+    ));
+    return this.connecting;
   }
-  async reclaimStaleClaims(claimedBefore, now) {
-    const staleClaim = {
-      claimedAt: { $lte: claimedBefore }
-    };
-    const backlog = await this.collection();
-    const stale = await backlog.find(staleClaim).toArray();
-    return this.claimAll(stale, staleClaim, now);
+  async close() {
+    const closing = this.client;
+    this.client = null;
+    this.database = null;
+    this.connecting = null;
+    await closing?.close();
   }
-  async claimOldestNeverClaimed(count, now) {
-    if (count <= 0) return [];
-    const backlog = await this.collection();
-    const oldest = await backlog.find(NEVER_CLAIMED, { sort: OLDEST_FIRST, limit: count }).toArray();
-    return this.claimAll(oldest, NEVER_CLAIMED, now);
+  async openTheDatabase() {
+    const opened = new MongoClient(this.uri);
+    await opened.connect();
+    this.client = opened;
+    this.database = opened.db();
+    return this.database;
   }
-  async removeAll(ids) {
-    if (ids.length === 0) return;
-    const backlog = await this.collection();
-    await backlog.deleteMany({ _id: { $in: ids } });
+  forgetTheAttempt(error) {
+    this.connecting = null;
+    throw error;
   }
-  async claimAll(entries, stillClaimable, claimedAt) {
-    if (entries.length === 0) return [];
-    const ids = entries.map(({ _id }) => _id);
-    const backlog = await this.collection();
-    const { modifiedCount } = await backlog.updateMany(
-      { _id: { $in: ids }, ...stillClaimable },
-      { $set: { claimedAt } }
-    );
-    if (modifiedCount < entries.length) {
-      return this.whatThisClaimTook(ids, claimedAt);
+};
+
+// src/queues/declared-queues.ts
+function declaredQueueNames(config) {
+  const queueOfEachJob = Object.values(config.jobs).map(
+    (job) => queueOf(job, config)
+  );
+  return [.../* @__PURE__ */ new Set([config.defaultQueue, ...queueOfEachJob])];
+}
+function jobsDeclaredOn(queue, config) {
+  return Object.fromEntries(
+    Object.entries(config.jobs).filter(
+      ([, job]) => queueOf(job, config) === queue
+    )
+  );
+}
+function queueOf(job, config) {
+  return job.queue ?? config.defaultQueue;
+}
+
+// src/queues/open-queues.ts
+function openQueues(config, connection) {
+  const settings = { connection, retention: config.queuesRetention };
+  return Object.fromEntries(
+    declaredQueueNames(config).map((name) => [
+      name,
+      openQueue(name, settings)
+    ])
+  );
+}
+function openQueue(name, settings) {
+  return new Queue(name, {
+    connection: settings.connection,
+    defaultJobOptions: defaultJobOptionsFor(settings.retention)
+  });
+}
+function defaultJobOptionsFor(retention = {}) {
+  return {
+    removeOnComplete: {
+      count: retention.completedCount ?? DEFAULT_COMPLETED_COUNT_RETENTION
+    },
+    removeOnFail: {
+      count: retention.failedCount ?? DEFAULT_FAILED_COUNT_RETENTION
+    }
+  };
+}
+
+// src/queues/close-queues.ts
+async function closeQueues(queues) {
+  await Promise.all(Object.values(queues).map((queue) => queue.close()));
+}
+
+// src/queues/build-job-options.ts
+function buildJobOptions(job) {
+  const options = {};
+  if (job.attempts !== void 0) options.attempts = job.attempts;
+  if (job.backoff !== void 0) options.backoff = backoffOptions(job.backoff);
+  return options;
+}
+function backoffOptions(backoff) {
+  return {
+    type: backoff.type,
+    delay: backoff.delayMs,
+    jitter: backoff.jitter
+  };
+}
+
+// src/queues/link-id.ts
+var LINK_SEPARATOR = ".";
+var A_NUMBERED_LINK = /^(.+)\.([1-9]\d*)$/;
+function nextLinkIdOf(linkId) {
+  const { runId, link } = linkOfItsRun(linkId);
+  return linkIdOf({ runId, link: link + 1 });
+}
+function linkIdOf({ runId, link }) {
+  if (link === 0) return runId;
+  return `${asACustomJobId(runId)}${LINK_SEPARATOR}${link}`;
+}
+function linkOfItsRun(linkId) {
+  const numbered = A_NUMBERED_LINK.exec(linkId);
+  if (numbered === null) return { runId: linkId, link: 0 };
+  return { runId: numbered[1], link: Number(numbered[2]) };
+}
+function asACustomJobId(runId) {
+  if (holdsColonsBullmqRefuses(runId)) return encodeURIComponent(runId);
+  return runId;
+}
+function holdsColonsBullmqRefuses(id) {
+  const parts = id.split(":").length;
+  return parts !== 1 && parts !== 3;
+}
+var BACKLOG_COLLECTION_PREFIX = "rav:spool-backlog:";
+var NEVER_CLAIMED = { claimedAt: { $exists: false } };
+var CLAIMED = { claimedAt: { $type: "date" } };
+var CLAIM_INDEX = { claimedAt: 1, _id: 1 };
+var OLDEST_FIRST = { _id: 1 };
+var MS_PER_SECOND = 1e3;
+var Backlog = class {
+  constructor(spoolName, connection) {
+    this.spoolName = spoolName;
+    this.connection = connection;
+  }
+  async push(item) {
+    const backlog = await this.collection();
+    const { insertedId } = await backlog.insertOne({ item });
+    return insertedId.toHexString();
+  }
+  async pushMany(items) {
+    if (items.length === 0) return [];
+    const backlog = await this.collection();
+    const { insertedIds } = await backlog.insertMany(
+      items.map((item) => ({ item }))
+    );
+    return items.map((_, position) => insertedIds[position].toHexString());
+  }
+  async purge() {
+    const backlog = await this.collection();
+    const { deletedCount } = await backlog.deleteMany(NEVER_CLAIMED);
+    return {
+      dropped: deletedCount,
+      inFlight: await backlog.countDocuments(CLAIMED)
+    };
+  }
+  async indexForTheClaim() {
+    const backlog = await this.collection();
+    await backlog.createIndex(CLAIM_INDEX);
+  }
+  async countInFlight() {
+    const backlog = await this.collection();
+    return backlog.countDocuments(CLAIMED);
+  }
+  async expireUnclaimedPushedBefore(pushedBefore) {
+    const backlog = await this.collection();
+    const { deletedCount } = await backlog.deleteMany({
+      ...NEVER_CLAIMED,
+      _id: { $lt: ObjectId.createFromTime(secondsOf(pushedBefore)) }
+    });
+    return deletedCount;
+  }
+  async reclaimStaleClaims(claimedBefore, now) {
+    const staleClaim = {
+      claimedAt: { $lte: claimedBefore }
+    };
+    const backlog = await this.collection();
+    const stale = await backlog.find(staleClaim).toArray();
+    return this.claimAll(stale, staleClaim, now);
+  }
+  async claimOldestNeverClaimed(count, now) {
+    if (count <= 0) return [];
+    const backlog = await this.collection();
+    const oldest = await backlog.find(NEVER_CLAIMED, { sort: OLDEST_FIRST, limit: count }).toArray();
+    return this.claimAll(oldest, NEVER_CLAIMED, now);
+  }
+  async removeAll(ids) {
+    if (ids.length === 0) return;
+    const backlog = await this.collection();
+    await backlog.deleteMany({ _id: { $in: ids } });
+  }
+  async claimAll(entries, stillClaimable, claimedAt) {
+    if (entries.length === 0) return [];
+    const ids = entries.map(({ _id }) => _id);
+    const backlog = await this.collection();
+    const { modifiedCount } = await backlog.updateMany(
+      { _id: { $in: ids }, ...stillClaimable },
+      { $set: { claimedAt } }
+    );
+    if (modifiedCount < entries.length) {
+      return this.whatThisClaimTook(ids, claimedAt);
     }
     return entries;
   }
@@ -1172,172 +1172,68 @@ function buildSendOrIngest(job, controls) {
   return { send: buildSend(job) };
 }
 
-// src/client/ravenflow-client.ts
-var RavenflowClient = class {
-  constructor(config, options) {
-    validateConfig(config);
-    this.config = config;
-    this.mongoUri = options.mongo;
-    this.redisConnectionOptions = options.redis;
-    this.logger = createLogger(config.logger);
-    this.mongo = new MongoConnection(options.mongo);
-    this.queues = openQueues(config, this.redisConnectionOptions);
+// src/client/create-ravenflow-client.ts
+function createRavenflowClient(config, options) {
+  validateConfig(config);
+  const logger = createLogger(config.logger);
+  const mongo = new MongoConnection(options.mongo);
+  const queues = openQueues(config, options.redis);
+  const controlPlane = initControlPlane({ redis: options.redis, mongo, logger });
+  return {
+    jobs: initJobProxies(config, { queues, mongo, controls: controlPlane }),
+    close: async () => {
+      await controlPlane.close();
+      await closeQueues(queues);
+      await mongo.close();
+    }
+  };
+}
+
+// src/worker/control-plane-reader.ts
+var ControlPlaneReader = class {
+  constructor(settings) {
+    this.mirrorConnection = new MongoConnection(settings.mongo);
     this.controlPlane = initControlPlane({
-      redis: this.redisConnectionOptions,
-      mongo: this.mongo,
-      logger: this.logger
-    });
-    this.jobs = initJobProxies(config, {
-      queues: this.queues,
-      mongo: this.mongo,
-      controls: this.controlPlane
+      redis: settings.redis,
+      mongo: this.mirrorConnection,
+      logger: settings.logger
     });
   }
+  async open() {
+    await this.controlPlane.rehydrate();
+    await this.mirrorConnection.close();
+  }
+  read(jobName) {
+    return this.controlPlane.read(jobName);
+  }
   async close() {
     await this.controlPlane.close();
-    await closeQueues(this.queues);
-    await this.mongo.close();
+    await this.mirrorConnection.close();
   }
 };
 
-// src/client/create-ravenflow-client.ts
-function createRavenflowClient(config, options) {
-  return new RavenflowClient(config, options);
+// src/worker/log-bullmq-errors.ts
+function logBullmqErrors(source, logger) {
+  source.on("error", (error) => {
+    logger.error(
+      { err: error, queue: source.name },
+      `[ravenflow] BullMQ reported an error on "${source.name}".`
+    );
+  });
 }
 
-// src/describe-error.ts
-function describeError(error) {
-  return error instanceof Error ? error.message : String(error);
-}
-var RAVENFLOW = `
- \u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557      \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557    \u2588\u2588\u2557
- \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551     \u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551    \u2588\u2588\u2551
- \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551     \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551 \u2588\u2557 \u2588\u2588\u2551
- \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u255A\u2588\u2588\u2557 \u2588\u2588\u2554\u255D\u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2551     \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2588\u2557\u2588\u2588\u2551
- \u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u255A\u2588\u2588\u2588\u2554\u2588\u2588\u2588\u2554\u255D
- \u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D  \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D\u255A\u2550\u255D     \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D  \u255A\u2550\u2550\u255D\u255A\u2550\u2550\u255D
-`;
-var RULE = "\u2550".repeat(85);
-var FEEDS_IN_ORDER = ["nothing", "clock", "spool"];
-function printBanner(facts) {
-  console.log(
-    [
-      RAVENFLOW,
-      RULE,
-      "[Config]",
-      ...configLines(facts),
-      "",
-      "[Registered Jobs]",
-      ...registeredJobLines(facts.jobs),
-      "",
-      "[Scheduled Jobs]",
-      ...schedulerLines(facts.schedulers),
-      RULE,
-      "Ready to process jobs..."
-    ].join("\n")
-  );
+// src/worker/mongodb-deadline-on-close.ts
+var MONGODB_DEADLINE_ON_CLOSE_MS = 5e3;
+async function waitOrCutShort(waitingOnMongoDB, cutItShort) {
+  if (await settlesBeforeTheDeadline(waitingOnMongoDB)) return;
+  await cutItShort();
+  await waitingOnMongoDB;
 }
-function configLines(facts) {
-  return [
-    `  -> queue:       ${facts.queue}`,
-    `  -> concurrency: ${facts.concurrency}`,
-    `  -> redis:       ${addressOf(facts.redis)}`,
-    `  -> mongo:       ${mongoLineOf(facts)}`
-  ];
-}
-function addressOf(redis) {
-  if (isRedisInstance(redis)) return "an ioredis client";
-  const {
-    url,
-    host = "localhost",
-    port = 6379,
-    db = 0
-  } = redis;
-  return url ? withoutPassword(url) : `${host}:${port}/${db}`;
-}
-function mongoLineOf({ mongo, recorderOpening }) {
-  const address = withoutPassword(mongo);
-  if (!recorderOpening.opened) {
-    return `${address} (job results are not recorded: ${recorderOpening.because})`;
-  }
-  return address;
-}
-function withoutPassword(uri) {
-  return uri.replace(/\/\/([^:/@]*):[^@]*@/, "//$1:***@");
-}
-function registeredJobLines(jobs) {
-  const lines = Object.entries(jobs).map(([name, job]) => ({ name, feed: feedOf(job) })).sort((a, b) => feedRank(a.feed) - feedRank(b.feed)).map(({ name, feed }) => `  . ${name}${feed.label}`);
-  return lines.length > 0 ? lines : ["  (none)"];
-}
-function feedOf(job) {
-  const cron = job.trigger?.cron;
-  if (cron) return { kind: "clock", label: ` (\u21BB ${cron})` };
-  if (isSpoolFed(job)) return { kind: "spool", label: spoolLabelOf(job) };
-  return { kind: "nothing", label: "" };
-}
-function spoolLabelOf({ trigger, pace }) {
-  const ceiling = inFlightCeilingOf(trigger.spool, pace);
-  return ` (\u2190 ${trigger.spool.name}, ${ceiling} in flight at most)`;
-}
-function feedRank(feed) {
-  return FEEDS_IN_ORDER.indexOf(feed.kind);
-}
-function schedulerLines(changes) {
-  const lines = [
-    ...changes.added.map(({ name, pattern }) => `  + ${name} \u2192 ${pattern}`),
-    ...changes.rescheduled.map(
-      ({ name, pattern, previousPattern }) => `  \u21BB ${name} \u2192 ${pattern} (was ${previousPattern})`
-    ),
-    ...changes.removed.map((name) => `  - ${name}`)
-  ];
-  return lines.length > 0 ? lines : ["  (no change)"];
-}
-
-// src/worker/control-plane-reader.ts
-var ControlPlaneReader = class {
-  constructor(settings) {
-    this.mirrorConnection = new MongoConnection(settings.mongo);
-    this.controlPlane = initControlPlane({
-      redis: settings.redis,
-      mongo: this.mirrorConnection,
-      logger: settings.logger
-    });
-  }
-  async open() {
-    await this.controlPlane.rehydrate();
-    await this.mirrorConnection.close();
-  }
-  read(jobName) {
-    return this.controlPlane.read(jobName);
-  }
-  async close() {
-    await this.controlPlane.close();
-    await this.mirrorConnection.close();
-  }
-};
-
-// src/worker/log-bullmq-errors.ts
-function logBullmqErrors(source, logger) {
-  source.on("error", (error) => {
-    logger.error(
-      { err: error, queue: source.name },
-      `[ravenflow] BullMQ reported an error on "${source.name}".`
-    );
-  });
-}
-
-// src/worker/mongodb-deadline-on-close.ts
-var MONGODB_DEADLINE_ON_CLOSE_MS = 5e3;
-async function waitOrCutShort(waitingOnMongoDB, cutItShort) {
-  if (await settlesBeforeTheDeadline(waitingOnMongoDB)) return;
-  await cutItShort();
-  await waitingOnMongoDB;
-}
-async function settlesBeforeTheDeadline(work) {
-  const deadline = new Promise((resolve) => {
-    setTimeout(() => resolve(false), MONGODB_DEADLINE_ON_CLOSE_MS).unref();
-  });
-  return Promise.race([work.then(() => true), deadline]);
+async function settlesBeforeTheDeadline(work) {
+  const deadline = new Promise((resolve) => {
+    setTimeout(() => resolve(false), MONGODB_DEADLINE_ON_CLOSE_MS).unref();
+  });
+  return Promise.race([work.then(() => true), deadline]);
 }
 var FLUSH_INTERVAL_MS = 3e4;
 var JOB_RESULTS_PER_BATCH = 1e3;
@@ -2700,100 +2596,6 @@ function abortWhenClosing(worker, shutdown) {
     shutdown.abort(new Error("[ravenflow] the worker is shutting down"));
   });
 }
-
-// src/worker/schedulers.ts
-async function reconcileSchedulers(queue, jobs) {
-  const declared = cronSchedulesOf(jobs);
-  const existing = await patternsByScheduler(queue);
-  const changes = changesBetween(declared, existing);
-  await Promise.all(
-    changes.removed.map((key) => queue.removeJobScheduler(key))
-  );
-  await Promise.all(declared.map((schedule) => upsert(queue, schedule)));
-  return changes;
-}
-function cronSchedulesOf(jobs) {
-  return Object.entries(jobs).flatMap(([name, job]) => {
-    const pattern = job.trigger?.cron;
-    if (pattern === void 0) return [];
-    return [{ name, pattern, options: buildJobOptions(job) }];
-  });
-}
-async function patternsByScheduler(queue) {
-  const schedulers = await queue.getJobSchedulers();
-  return new Map(
-    schedulers.map(({ key, pattern }) => [key, pattern ?? "no pattern"])
-  );
-}
-function changesBetween(declared, existing) {
-  const declaredNames = new Set(declared.map(({ name }) => name));
-  return {
-    added: declared.filter(({ name }) => !existing.has(name)),
-    rescheduled: declared.flatMap(
-      (schedule) => reschedulingOf(schedule, existing)
-    ),
-    removed: [...existing.keys()].filter((key) => !declaredNames.has(key))
-  };
-}
-function reschedulingOf(schedule, existing) {
-  const previousPattern = existing.get(schedule.name);
-  if (previousPattern === void 0) return [];
-  if (previousPattern === schedule.pattern) return [];
-  return [{ ...schedule, previousPattern }];
-}
-async function upsert(queue, { name, pattern, options }) {
-  try {
-    await queue.upsertJobScheduler(name, { pattern }, { name, opts: options });
-  } catch (error) {
-    throw new Error(
-      `[ravenflow] "${name}" could not be scheduled on "${pattern}": ${describeError(error)}`
-    );
-  }
-}
-
-// src/worker/served-queue.ts
-function refuseAQueueItsConfigDoesNotDeclare(queue, config) {
-  const declared = declaredQueueNames(config);
-  if (declared.includes(queue)) return;
-  const quoted = declared.map((name) => `"${name}"`).join(", ");
-  throw new Error(
-    `[ravenflow] no job of this config runs on "${queue}": its queues are ${quoted}.`
-  );
-}
-
-// src/worker/serving.ts
-async function closeInOrder(serving) {
-  await stopWatchingMongoDB(serving);
-  await stopTheTicks(serving);
-  await stopTheWorker(serving);
-  await writeWhatItsJobsLeft(serving);
-  await closeTheConnections(serving);
-}
-async function stopWatchingMongoDB(serving) {
-  await serving.mongoWatch.close();
-}
-async function stopTheTicks(serving) {
-  await Promise.all([
-    serving.jobResultsAggregator.stopTicking(),
-    serving.spoolFeeder.stopTicking()
-  ]);
-}
-async function stopTheWorker(serving) {
-  serving.jobResultsRecorder.stopHoldingJobs();
-  await serving.worker.close();
-}
-async function writeWhatItsJobsLeft(serving) {
-  await Promise.all([
-    serving.jobResultsRecorder.close(),
-    serving.spoolFeeder.finishTheRemovals()
-  ]);
-}
-async function closeTheConnections(serving) {
-  await serving.spoolFeeder.close();
-  await serving.jobResultsAggregator.close();
-  await serving.controlPlaneReader.close();
-  await serving.queue.close();
-}
 var THE_DRIVERS_RECOVERY_LAG_MS = 1e4;
 var MongoWatch = class {
   constructor(settings) {
@@ -2915,189 +2717,374 @@ async function callOnWithdraw({ logger, onWithdraw }, reason) {
   }
 }
 
-// src/worker/ravenflow-worker.ts
-var RavenflowWorker = class {
-  constructor(config, options) {
-    this.serving = null;
-    this.starting = null;
-    this.closing = null;
-    validateConfig(config);
-    refuseAQueueItsConfigDoesNotDeclare(options.queue, config);
-    this.config = config;
-    this.options = options;
-    this.jobs = jobsDeclaredOn(options.queue, config);
-    this.logger = createLogger(config.logger);
-  }
-  async start() {
-    this.refuseASecondStart();
-    const serving = this.openServing();
-    this.serving = serving;
-    this.starting = this.serveOrStop(serving);
+// src/worker/open-serving.ts
+function openServing(settings, onDurableLoss) {
+  const { config, options, jobs, logger } = settings;
+  const queue = openQueue(options.queue, {
+    connection: options.redis,
+    retention: config.queuesRetention
+  });
+  logBullmqErrors(queue, logger);
+  const controlPlaneReader = buildControlPlaneReader(settings);
+  const jobResultsRecorder = buildJobResultsRecorder(settings, queue);
+  const worker = openWorker(options, {
+    jobs,
+    logger,
+    queue,
+    controls: controlPlaneReader,
+    jobResultsRecorder
+  });
+  return {
+    queue,
+    controlPlaneReader,
+    jobResultsRecorder,
+    jobResultsAggregator: buildJobResultsAggregator(settings),
+    spoolFeeder: buildSpoolFeeder(settings, { queue, controlPlaneReader }),
+    mongoWatch: buildMongoWatch(settings, onDurableLoss),
+    worker
+  };
+}
+function buildControlPlaneReader({
+  options,
+  logger
+}) {
+  return new ControlPlaneReader({
+    redis: options.redis,
+    mongo: options.mongo,
+    logger
+  });
+}
+function buildJobResultsRecorder({ config, options, jobs, logger }, queue) {
+  return new JobResultsRecorder({
+    mongo: options.mongo,
+    retentionHours: config.jobResultsRetentionHours ?? DEFAULT_JOB_RESULTS_RETENTION_HOURS,
+    queue,
+    jobs,
+    logger
+  });
+}
+function buildJobResultsAggregator({
+  config,
+  options,
+  logger
+}) {
+  return new JobResultsAggregator({
+    redis: options.redis,
+    mongo: options.mongo,
+    retentionHours: config.aggregatedResultsRetentionHours ?? DEFAULT_AGGREGATED_RESULTS_RETENTION_HOURS,
+    logger
+  });
+}
+function buildSpoolFeeder({ options, jobs, logger }, { queue, controlPlaneReader }) {
+  return new SpoolFeeder({
+    redis: options.redis,
+    mongo: options.mongo,
+    queue,
+    controls: controlPlaneReader,
+    jobs,
+    logger
+  });
+}
+function buildMongoWatch({ options, logger }, onDurableLoss) {
+  return new MongoWatch({
+    mongo: options.mongo,
+    gracePeriodMs: options.withdrawal?.afterMs ?? DEFAULT_GRACE_PERIOD_MS,
+    logger,
+    onDurableLoss
+  });
+}
+
+// src/worker/served-queue.ts
+function refuseAQueueItsConfigDoesNotDeclare(queue, config) {
+  const declared = declaredQueueNames(config);
+  if (declared.includes(queue)) return;
+  const quoted = declared.map((name) => `"${name}"`).join(", ");
+  throw new Error(
+    `[ravenflow] no job of this config runs on "${queue}": its queues are ${quoted}.`
+  );
+}
+
+// src/describe-error.ts
+function describeError(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+var RAVENFLOW = `
+ \u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557      \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557    \u2588\u2588\u2557
+ \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551     \u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551    \u2588\u2588\u2551
+ \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551     \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551 \u2588\u2557 \u2588\u2588\u2551
+ \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u255A\u2588\u2588\u2557 \u2588\u2588\u2554\u255D\u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2551     \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2588\u2557\u2588\u2588\u2551
+ \u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u255A\u2588\u2588\u2588\u2554\u2588\u2588\u2588\u2554\u255D
+ \u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D  \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D\u255A\u2550\u255D     \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D  \u255A\u2550\u2550\u255D\u255A\u2550\u2550\u255D
+`;
+var RULE = "\u2550".repeat(85);
+var FEEDS_IN_ORDER = ["nothing", "clock", "spool"];
+function printBanner(facts) {
+  console.log(
+    [
+      RAVENFLOW,
+      RULE,
+      "[Config]",
+      ...configLines(facts),
+      "",
+      "[Registered Jobs]",
+      ...registeredJobLines(facts.jobs),
+      "",
+      "[Scheduled Jobs]",
+      ...schedulerLines(facts.schedulers),
+      RULE,
+      "Ready to process jobs..."
+    ].join("\n")
+  );
+}
+function configLines(facts) {
+  return [
+    `  -> queue:       ${facts.queue}`,
+    `  -> concurrency: ${facts.concurrency}`,
+    `  -> redis:       ${addressOf(facts.redis)}`,
+    `  -> mongo:       ${mongoLineOf(facts)}`
+  ];
+}
+function addressOf(redis) {
+  if (isRedisInstance(redis)) return "an ioredis client";
+  const {
+    url,
+    host = "localhost",
+    port = 6379,
+    db = 0
+  } = redis;
+  return url ? withoutPassword(url) : `${host}:${port}/${db}`;
+}
+function mongoLineOf({ mongo, recorderOpening }) {
+  const address = withoutPassword(mongo);
+  if (!recorderOpening.opened) {
+    return `${address} (job results are not recorded: ${recorderOpening.because})`;
+  }
+  return address;
+}
+function withoutPassword(uri) {
+  return uri.replace(/\/\/([^:/@]*):[^@]*@/, "//$1:***@");
+}
+function registeredJobLines(jobs) {
+  const lines = Object.entries(jobs).map(([name, job]) => ({ name, feed: feedOf(job) })).sort((a, b) => feedRank(a.feed) - feedRank(b.feed)).map(({ name, feed }) => `  . ${name}${feed.label}`);
+  return lines.length > 0 ? lines : ["  (none)"];
+}
+function feedOf(job) {
+  const cron = job.trigger?.cron;
+  if (cron) return { kind: "clock", label: ` (\u21BB ${cron})` };
+  if (isSpoolFed(job)) return { kind: "spool", label: spoolLabelOf(job) };
+  return { kind: "nothing", label: "" };
+}
+function spoolLabelOf({ trigger, pace }) {
+  const ceiling = inFlightCeilingOf(trigger.spool, pace);
+  return ` (\u2190 ${trigger.spool.name}, ${ceiling} in flight at most)`;
+}
+function feedRank(feed) {
+  return FEEDS_IN_ORDER.indexOf(feed.kind);
+}
+function schedulerLines(changes) {
+  const lines = [
+    ...changes.added.map(({ name, pattern }) => `  + ${name} \u2192 ${pattern}`),
+    ...changes.rescheduled.map(
+      ({ name, pattern, previousPattern }) => `  \u21BB ${name} \u2192 ${pattern} (was ${previousPattern})`
+    ),
+    ...changes.removed.map((name) => `  - ${name}`)
+  ];
+  return lines.length > 0 ? lines : ["  (no change)"];
+}
+
+// src/worker/schedulers.ts
+async function reconcileSchedulers(queue, jobs) {
+  const declared = cronSchedulesOf(jobs);
+  const existing = await patternsByScheduler(queue);
+  const changes = changesBetween(declared, existing);
+  await Promise.all(
+    changes.removed.map((key) => queue.removeJobScheduler(key))
+  );
+  await Promise.all(declared.map((schedule) => upsert(queue, schedule)));
+  return changes;
+}
+function cronSchedulesOf(jobs) {
+  return Object.entries(jobs).flatMap(([name, job]) => {
+    const pattern = job.trigger?.cron;
+    if (pattern === void 0) return [];
+    return [{ name, pattern, options: buildJobOptions(job) }];
+  });
+}
+async function patternsByScheduler(queue) {
+  const schedulers = await queue.getJobSchedulers();
+  return new Map(
+    schedulers.map(({ key, pattern }) => [key, pattern ?? "no pattern"])
+  );
+}
+function changesBetween(declared, existing) {
+  const declaredNames = new Set(declared.map(({ name }) => name));
+  return {
+    added: declared.filter(({ name }) => !existing.has(name)),
+    rescheduled: declared.flatMap(
+      (schedule) => reschedulingOf(schedule, existing)
+    ),
+    removed: [...existing.keys()].filter((key) => !declaredNames.has(key))
+  };
+}
+function reschedulingOf(schedule, existing) {
+  const previousPattern = existing.get(schedule.name);
+  if (previousPattern === void 0) return [];
+  if (previousPattern === schedule.pattern) return [];
+  return [{ ...schedule, previousPattern }];
+}
+async function upsert(queue, { name, pattern, options }) {
+  try {
+    await queue.upsertJobScheduler(name, { pattern }, { name, opts: options });
+  } catch (error) {
+    throw new Error(
+      `[ravenflow] "${name}" could not be scheduled on "${pattern}": ${describeError(error)}`
+    );
+  }
+}
+
+// src/worker/serving.ts
+async function serve(serving, settings) {
+  const { options, jobs } = settings;
+  const { queue, worker } = serving;
+  serving.mongoWatch.open();
+  await serving.controlPlaneReader.open();
+  const recorderOpening = await openRecorder(serving, settings);
+  await serving.jobResultsAggregator.open();
+  await serving.spoolFeeder.open(worker);
+  const schedulers = await reconcileSchedulers(queue, jobs);
+  takeJobs(worker, settings);
+  await worker.waitUntilReady();
+  printBanner({
+    queue: options.queue,
+    concurrency: worker.concurrency,
+    redis: options.redis,
+    mongo: options.mongo,
+    recorderOpening,
+    jobs,
+    schedulers
+  });
+}
+async function openRecorder({ jobResultsRecorder, worker }, settings) {
+  try {
+    await jobResultsRecorder.open(worker);
+  } catch (error) {
+    sayJobResultsAreNotRecorded(settings, error);
+    return { opened: false, because: describeError(error) };
+  }
+  return { opened: true };
+}
+function sayJobResultsAreNotRecorded({ options, logger }, error) {
+  logger.error(
+    { err: error },
+    `[ravenflow] the job results recorder could not start: the worker serves "${options.queue}", and its job results are not recorded.`
+  );
+}
+function takeJobs(worker, { options, logger }) {
+  worker.run().catch((error) => {
+    logger.error(
+      { err: error },
+      `[ravenflow] the worker serving "${options.queue}" stopped taking jobs.`
+    );
+  });
+}
+async function closeInOrder(serving) {
+  await stopWatchingMongoDB(serving);
+  await stopTheTicks(serving);
+  await stopTheWorker(serving);
+  await writeWhatItsJobsLeft(serving);
+  await closeTheConnections(serving);
+}
+async function stopWatchingMongoDB(serving) {
+  await serving.mongoWatch.close();
+}
+async function stopTheTicks(serving) {
+  await Promise.all([
+    serving.jobResultsAggregator.stopTicking(),
+    serving.spoolFeeder.stopTicking()
+  ]);
+}
+async function stopTheWorker(serving) {
+  serving.jobResultsRecorder.stopHoldingJobs();
+  await serving.worker.close();
+}
+async function writeWhatItsJobsLeft(serving) {
+  await Promise.all([
+    serving.jobResultsRecorder.close(),
+    serving.spoolFeeder.finishTheRemovals()
+  ]);
+}
+async function closeTheConnections(serving) {
+  await serving.spoolFeeder.close();
+  await serving.jobResultsAggregator.close();
+  await serving.controlPlaneReader.close();
+  await serving.queue.close();
+}
+
+// src/worker/create-ravenflow-worker.ts
+function createRavenflowWorker(config, options) {
+  validateConfig(config);
+  refuseAQueueItsConfigDoesNotDeclare(options.queue, config);
+  return workerOf({
+    config,
+    options,
+    jobs: jobsDeclaredOn(options.queue, config),
+    logger: createLogger(config.logger)
+  });
+}
+function workerOf(settings) {
+  let serving = null;
+  let starting = null;
+  let closing = null;
+  return { start, close };
+  async function start() {
+    if (serving) throw aSecondStart(settings);
+    const opened = openServing(settings, beginAWithdrawal);
+    serving = opened;
+    starting = serveOrStop(opened);
     try {
-      await this.starting;
+      await starting;
     } finally {
-      this.starting = null;
+      starting = null;
     }
   }
-  async close() {
-    await Promise.allSettled([this.starting]);
-    if (this.serving === null) return;
-    this.closing ?? (this.closing = this.stopServing(this.serving));
-    await this.closing;
+  async function close() {
+    await Promise.allSettled([starting]);
+    if (serving === null) return;
+    closing ?? (closing = stopServing(serving));
+    await closing;
   }
-  async serveOrStop(serving) {
+  async function serveOrStop(opened) {
     try {
-      await this.serve(serving);
+      await serve(opened, settings);
     } catch (error) {
-      await this.stopServing(serving);
+      await stopServing(opened);
       throw error;
     }
   }
-  async stopServing(serving) {
+  async function stopServing(opened) {
     try {
-      await closeInOrder(serving);
+      await closeInOrder(opened);
     } finally {
-      this.serving = null;
-      this.closing = null;
-    }
-  }
-  refuseASecondStart() {
-    if (!this.serving) return;
-    throw new Error(
-      `[ravenflow] this worker has already started on "${this.options.queue}".`
-    );
-  }
-  openServing() {
-    const queue = openQueue(this.options.queue, {
-      connection: this.options.redis,
-      retention: this.config.queuesRetention
-    });
-    logBullmqErrors(queue, this.logger);
-    const controlPlaneReader = this.buildControlPlaneReader();
-    const jobResultsRecorder = this.buildJobResultsRecorder(queue);
-    const worker = openWorker(this.options, {
-      jobs: this.jobs,
-      logger: this.logger,
-      queue,
-      controls: controlPlaneReader,
-      jobResultsRecorder
-    });
-    return {
-      queue,
-      controlPlaneReader,
-      jobResultsRecorder,
-      jobResultsAggregator: this.buildJobResultsAggregator(),
-      spoolFeeder: this.buildSpoolFeeder(queue, controlPlaneReader),
-      mongoWatch: this.buildMongoWatch(),
-      worker
-    };
-  }
-  buildControlPlaneReader() {
-    return new ControlPlaneReader({
-      redis: this.options.redis,
-      mongo: this.options.mongo,
-      logger: this.logger
-    });
-  }
-  buildJobResultsRecorder(queue) {
-    return new JobResultsRecorder({
-      mongo: this.options.mongo,
-      retentionHours: this.config.jobResultsRetentionHours ?? DEFAULT_JOB_RESULTS_RETENTION_HOURS,
-      queue,
-      jobs: this.jobs,
-      logger: this.logger
-    });
-  }
-  buildJobResultsAggregator() {
-    return new JobResultsAggregator({
-      redis: this.options.redis,
-      mongo: this.options.mongo,
-      retentionHours: this.config.aggregatedResultsRetentionHours ?? DEFAULT_AGGREGATED_RESULTS_RETENTION_HOURS,
-      logger: this.logger
-    });
-  }
-  buildSpoolFeeder(queue, controls) {
-    return new SpoolFeeder({
-      redis: this.options.redis,
-      mongo: this.options.mongo,
-      queue,
-      controls,
-      jobs: this.jobs,
-      logger: this.logger
-    });
-  }
-  buildMongoWatch() {
-    return new MongoWatch({
-      mongo: this.options.mongo,
-      gracePeriodMs: this.options.withdrawal?.afterMs ?? DEFAULT_GRACE_PERIOD_MS,
-      logger: this.logger,
-      onDurableLoss: (unreachableForMs) => this.beginAWithdrawal(unreachableForMs)
-    });
-  }
-  beginAWithdrawal(unreachableForMs) {
-    const withdrawing = {
-      queue: this.options.queue,
-      logger: this.logger,
-      onWithdraw: this.options.withdrawal?.onWithdraw,
-      close: () => this.close()
-    };
-    void withdraw(withdrawing, unreachableForMs);
-  }
-  async serve({
-    queue,
-    controlPlaneReader,
-    jobResultsRecorder,
-    jobResultsAggregator,
-    spoolFeeder,
-    mongoWatch,
-    worker
-  }) {
-    mongoWatch.open();
-    await controlPlaneReader.open();
-    const recorderOpening = await this.openRecorder(jobResultsRecorder, worker);
-    await jobResultsAggregator.open();
-    await spoolFeeder.open(worker);
-    const schedulers = await reconcileSchedulers(queue, this.jobs);
-    this.takeJobs(worker);
-    await worker.waitUntilReady();
-    printBanner({
-      queue: this.options.queue,
-      concurrency: worker.concurrency,
-      redis: this.options.redis,
-      mongo: this.options.mongo,
-      recorderOpening,
-      jobs: this.jobs,
-      schedulers
-    });
-  }
-  async openRecorder(jobResultsRecorder, worker) {
-    try {
-      await jobResultsRecorder.open(worker);
-    } catch (error) {
-      this.sayJobResultsAreNotRecorded(error);
-      return { opened: false, because: describeError(error) };
+      serving = null;
+      closing = null;
     }
-    return { opened: true };
   }
-  sayJobResultsAreNotRecorded(error) {
-    this.logger.error(
-      { err: error },
-      `[ravenflow] the job results recorder could not start: the worker serves "${this.options.queue}", and its job results are not recorded.`
-    );
+  function beginAWithdrawal(unreachableForMs) {
+    void withdraw(withdrawingOf(settings, close), unreachableForMs);
   }
-  takeJobs(worker) {
-    worker.run().catch((error) => {
-      this.logger.error(
-        { err: error },
-        `[ravenflow] the worker serving "${this.options.queue}" stopped taking jobs.`
-      );
-    });
-  }
-};
-
-// src/worker/create-ravenflow-worker.ts
-function createRavenflowWorker(config, options) {
-  return new RavenflowWorker(config, options);
+}
+function aSecondStart({ options }) {
+  return new Error(
+    `[ravenflow] this worker has already started on "${options.queue}".`
+  );
+}
+function withdrawingOf({ options, logger }, close) {
+  return {
+    queue: options.queue,
+    logger,
+    onWithdraw: options.withdrawal?.onWithdraw,
+    close
+  };
 }
 
 // src/config/ravenflow-config.ts