theokit 0.77.4 → 0.78.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. package/README.md +7 -0
  2. package/dist/{chunk-3XR6CBUA.js → chunk-ICLIUEST.js} +86 -19
  3. package/dist/chunk-ICLIUEST.js.map +1 -0
  4. package/dist/{chunk-QBK6YYZA.js → chunk-KSEPYAMJ.js} +8 -1
  5. package/dist/{chunk-QBK6YYZA.js.map → chunk-KSEPYAMJ.js.map} +1 -1
  6. package/dist/{chunk-XCPM72D6.js → chunk-ZWIKURA5.js} +52 -16
  7. package/dist/chunk-ZWIKURA5.js.map +1 -0
  8. package/dist/cli/index.js +3 -3
  9. package/dist/{dev-AE7EWSB7.js → dev-SCS6SPET.js} +4 -3
  10. package/dist/dev-SCS6SPET.js.map +1 -0
  11. package/dist/{index-CY_llLI7.d.ts → index-BGIX-H9s.d.ts} +1 -1
  12. package/dist/{job-backend-BX-PwnZW.d.ts → job-backend-BRfDfojf.d.ts} +24 -3
  13. package/dist/{preview-VMMBMNMM.js → preview-USC6FF55.js} +2 -2
  14. package/dist/server/http/index.d.ts +2 -2
  15. package/dist/server/index.d.ts +3 -3
  16. package/dist/server/index.js +4 -2
  17. package/dist/server/index.js.map +1 -1
  18. package/dist/server/jobs/index.d.ts +33 -5
  19. package/dist/server/jobs/index.js +3 -1
  20. package/dist/server/storage/index.d.ts +1 -1
  21. package/dist/server/storage/index.js +1 -1
  22. package/dist/{start-AE5YCDVS.js → start-QCGCORTH.js} +5 -5
  23. package/dist/start-QCGCORTH.js.map +1 -0
  24. package/dist/{storage-manager-3IUIEG2P.js → storage-manager-KK24UWB4.js} +8 -1
  25. package/dist/{storage-manager-3IUIEG2P.js.map → storage-manager-KK24UWB4.js.map} +1 -1
  26. package/dist/{storage-manager-Clu2RBpH.d.ts → storage-manager-vIxAHMwm.d.ts} +1 -0
  27. package/package.json +6 -6
  28. package/dist/chunk-3XR6CBUA.js.map +0 -1
  29. package/dist/chunk-XCPM72D6.js.map +0 -1
  30. package/dist/dev-AE7EWSB7.js.map +0 -1
  31. package/dist/start-AE5YCDVS.js.map +0 -1
  32. /package/dist/{preview-VMMBMNMM.js.map → preview-USC6FF55.js.map} +0 -0
package/README.md CHANGED
@@ -184,6 +184,13 @@ before closing storage. `jobs.worker` tunes it (`pollIntervalMs`, `batchSize`, `
184
184
  leased to one of them. To run a worker on its own, call `createJobWorker(createJobRunner(backend,
185
185
  definitions)).start()` from `theokit/server/jobs`.
186
186
 
187
+ A job leases for `lockSeconds`, and `ctx.signal` aborts when the lease runs out, so a handler that
188
+ may run longer than that calls `await ctx.extendLease(seconds)` while it makes progress. The
189
+ deadline of `signal` moves with it, and the call rejects with `JobLeaseLostError` (and aborts the
190
+ signal) if another worker holds the job by then. `PostgresJobBackend` and `InMemoryJobBackend` can
191
+ extend a lease; a custom backend opts in with `extendLease`, and without it the call rejects with
192
+ `JobLeaseExtensionUnsupportedError`.
193
+
187
194
  The pool you pass is yours, and so is its `error` listener if you attach one. A `pg.Pool` emits
188
195
  `error` when Postgres drops an idle connection, and the worker keeps idle clients in the pool. If
189
196
  the pool has no `error` listener when the backend is constructed, `PostgresJobBackend` attaches one
@@ -63,6 +63,17 @@ var JobLeaseLostError = class extends Error {
63
63
  this.operation = operation;
64
64
  }
65
65
  };
66
+ var JobLeaseExtensionUnsupportedError = class extends Error {
67
+ code = "JOB_LEASE_EXTENSION_UNSUPPORTED";
68
+ backend;
69
+ constructor(backend) {
70
+ super(
71
+ `The "${backend}" job backend cannot extend a lease. Give the worker a lockSeconds longer than the longest job, or use a backend that implements extendLease.`
72
+ );
73
+ this.name = "JobLeaseExtensionUnsupportedError";
74
+ this.backend = backend;
75
+ }
76
+ };
66
77
 
67
78
  // src/server/jobs/job-backend-memory.ts
68
79
  var DEFAULT_MAX_PENDING = 1e4;
@@ -157,6 +168,13 @@ var InMemoryJobBackend = class {
157
168
  this.#pending.delete(jobId);
158
169
  return Promise.resolve();
159
170
  }
171
+ async extendLease(jobId, opts) {
172
+ const entry = this.#pending.get(jobId);
173
+ this.#assertHeld(jobId, entry, opts, "extend");
174
+ if (!entry) throw new JobLeaseLostError(jobId, "extend");
175
+ entry.lockExpiresAt = Date.now() + opts.lockSeconds * 1e3;
176
+ return Promise.resolve(new Date(entry.lockExpiresAt));
177
+ }
160
178
  async nack(jobId, opts) {
161
179
  const entry = this.#pending.get(jobId);
162
180
  this.#assertHeld(jobId, entry, opts, "nack");
@@ -263,13 +281,27 @@ var PostgresJobBackend = class _PostgresJobBackend {
263
281
  * new PostgresJobBackend({ pool, ...options })
264
282
  * ```
265
283
  *
266
- * Errors thrown by the manager (unknown dbName, dangling server reference,
267
- * manager already disposed) propagate to the caller with actionable text.
284
+ * With a configured manager the pool is resolved at once, so errors thrown by the manager
285
+ * (unknown dbName, dangling server reference, manager already disposed) propagate to the caller
286
+ * with actionable text.
268
287
  *
288
+ * Called from `theo.config.ts`, where `jobs.backend` is declared, the manager has no
289
+ * configuration yet: the framework applies the config's `storage` block only after the module has
290
+ * been evaluated. The pool is then resolved on the first query, which `theokit start` and `theokit
291
+ * dev` make when they create the table at boot, and the same errors surface there
292
+ * (usetheokit/theokit#1133).
269
293
  */
270
294
  static fromStorageManager(manager, dbName, factory, options) {
271
- const pool = manager.usePostgres(dbName, factory);
272
- return new _PostgresJobBackend({ pool, ...options });
295
+ if (manager.isConfigured()) {
296
+ return new _PostgresJobBackend({ pool: manager.usePostgres(dbName, factory), ...options });
297
+ }
298
+ let pool;
299
+ const resolve = () => pool ??= manager.usePostgres(dbName, factory);
300
+ return new _PostgresJobBackend({
301
+ // The manager owns the pool and drains it on dispose, so the proxy has no `end`.
302
+ pool: { query: (sql, params) => resolve().query(sql, params) },
303
+ ...options
304
+ });
273
305
  }
274
306
  /**
275
307
  * A cron lock on this backend's pool, so replicas sharing the job database fire each cron tick
@@ -441,6 +473,23 @@ var PostgresJobBackend = class _PostgresJobBackend {
441
473
  throw new JobLeaseLostError(jobId, "ack");
442
474
  }
443
475
  }
476
+ /**
477
+ * Keep a lease for `lockSeconds` more, counted from the database clock, and return the new
478
+ * deadline. The write is fenced by the lease token, so a worker whose lease expired and was handed
479
+ * to another cannot extend the new holder's lock (usetheokit/theokit#1132).
480
+ */
481
+ async extendLease(jobId, opts) {
482
+ const r = await this.#pool.query(
483
+ `UPDATE ${this.#table}
484
+ SET locked_until = NOW() + ($3 || ' seconds')::interval
485
+ WHERE id = $1 AND lease_token = $2 AND failed_at IS NULL
486
+ RETURNING locked_until`,
487
+ [jobId, opts.leaseToken, opts.lockSeconds.toString()]
488
+ );
489
+ if (r.rows.length === 0) throw new JobLeaseLostError(jobId, "extend");
490
+ const until = r.rows[0].locked_until;
491
+ return until instanceof Date ? until : new Date(until);
492
+ }
444
493
  /**
445
494
  * Record a failure. The job is retried after `retryDelaySeconds(attempts)` while attempts remain,
446
495
  * and kept as failed (`failed_at`, `last_error`) once they are exhausted or the failure is
@@ -528,7 +577,7 @@ function createJobRunner(backend, definitions) {
528
577
  for (const def of definitions) {
529
578
  byName.set(def.name, def);
530
579
  }
531
- const runOne = async (lease) => {
580
+ const runOne = async (lease, lockSeconds) => {
532
581
  const def = byName.get(lease.name);
533
582
  if (!def) {
534
583
  await finish(
@@ -568,18 +617,37 @@ function createJobRunner(backend, definitions) {
568
617
  }
569
618
  }
570
619
  const abortController = new AbortController();
571
- const lockMs = lease.lockExpiresAt.getTime() - Date.now();
572
- const lockTimer = setTimeout(
573
- () => {
574
- abortController.abort();
575
- },
576
- Math.max(0, lockMs)
577
- );
620
+ let lockTimer;
621
+ const armLockTimer = (expiresAt) => {
622
+ lockTimer = setTimeout(
623
+ () => {
624
+ abortController.abort();
625
+ },
626
+ Math.max(0, expiresAt.getTime() - Date.now())
627
+ );
628
+ };
629
+ armLockTimer(lease.lockExpiresAt);
578
630
  const jobCtx = {
579
631
  traceId,
580
632
  input: parsedInput,
581
633
  signal: abortController.signal,
582
- attempt: lease.attempts
634
+ attempt: lease.attempts,
635
+ async extendLease(seconds = lockSeconds) {
636
+ if (backend.extendLease === void 0 || lease.leaseToken === void 0) {
637
+ throw new JobLeaseExtensionUnsupportedError(backend.name);
638
+ }
639
+ try {
640
+ const until = await backend.extendLease(lease.jobId, {
641
+ leaseToken: lease.leaseToken,
642
+ lockSeconds: seconds
643
+ });
644
+ clearTimeout(lockTimer);
645
+ armLockTimer(until);
646
+ } catch (err) {
647
+ if (err instanceof JobLeaseLostError) abortController.abort();
648
+ throw err;
649
+ }
650
+ }
583
651
  };
584
652
  let failure;
585
653
  let failed = false;
@@ -610,12 +678,10 @@ function createJobRunner(backend, definitions) {
610
678
  };
611
679
  return {
612
680
  async tick(opts) {
613
- const leases = await backend.dequeue({
614
- batchSize: opts?.batchSize ?? 10,
615
- lockSeconds: opts?.lockSeconds ?? 30
616
- });
681
+ const lockSeconds = opts?.lockSeconds ?? 30;
682
+ const leases = await backend.dequeue({ batchSize: opts?.batchSize ?? 10, lockSeconds });
617
683
  for (const lease of leases) {
618
- await runOne(lease);
684
+ await runOne(lease, lockSeconds);
619
685
  }
620
686
  return leases.length;
621
687
  }
@@ -779,6 +845,7 @@ export {
779
845
  defineJob,
780
846
  NonRetryableError,
781
847
  JobLeaseLostError,
848
+ JobLeaseExtensionUnsupportedError,
782
849
  InMemoryJobBackend,
783
850
  PostgresJobBackend,
784
851
  createJobRunner,
@@ -789,4 +856,4 @@ export {
789
856
  DuplicateJobNameError,
790
857
  scanJobs
791
858
  };
792
- //# sourceMappingURL=chunk-3XR6CBUA.js.map
859
+ //# sourceMappingURL=chunk-ICLIUEST.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/server/jobs/define-job.ts","../src/server/jobs/job-backend.ts","../src/server/jobs/job-backend-memory.ts","../src/server/jobs/job-backend-postgres.ts","../src/server/jobs/job-runner.ts","../src/server/jobs/job-worker.ts","../src/server/jobs/job-manifest.ts","../src/server/jobs/job-scan.ts"],"mappings":"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","names":["now"]}
@@ -173,6 +173,13 @@ var StorageManager = class {
173
173
  this.#disposed = false;
174
174
  }
175
175
  /** @internal Introspection helper for tests. */
176
+ /**
177
+ * Whether `configure()` has been applied. A `theo.config.ts` is evaluated before the framework
178
+ * applies its own `storage` block, so anything built there sees `false`.
179
+ */
180
+ isConfigured() {
181
+ return this.#config !== void 0;
182
+ }
176
183
  __isConfiguredForTests() {
177
184
  return this.#config !== void 0;
178
185
  }
@@ -260,4 +267,4 @@ export {
260
267
  useUnstorage,
261
268
  useDatabase
262
269
  };
263
- //# sourceMappingURL=chunk-QBK6YYZA.js.map
270
+ //# sourceMappingURL=chunk-KSEPYAMJ.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/server/storage/storage-manager.ts","../src/server/storage/use-unstorage.ts","../src/server/storage/use-database.ts"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../src/server/storage/storage-manager.ts","../src/server/storage/use-unstorage.ts","../src/server/storage/use-database.ts"],"mappings":"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","names":[]}
@@ -123,6 +123,13 @@ function createCronScheduler(definitions, options = {}) {
123
123
  };
124
124
  }
125
125
 
126
+ // src/cli/commands/resolve-listen-port.ts
127
+ function resolveListenPort(flag, env, configPort) {
128
+ if (flag !== void 0) return flag;
129
+ const fromEnv = Number.parseInt(env.PORT ?? "", 10);
130
+ return Number.isInteger(fromEnv) ? fromEnv : configPort;
131
+ }
132
+
126
133
  // src/cli/commands/start/bootstrap-stages.ts
127
134
  import { existsSync } from "fs";
128
135
  import { resolve } from "path";
@@ -152,7 +159,7 @@ async function configureAgentRegistryFromConfig(registryConfig) {
152
159
  async function configureStorageManagerFromConfig(storageConfig) {
153
160
  if (storageConfig === void 0 || storageConfig === null) return;
154
161
  try {
155
- const { getStorageManager } = await import("./storage-manager-3IUIEG2P.js");
162
+ const { getStorageManager } = await import("./storage-manager-KK24UWB4.js");
156
163
  const { storageSchema } = await import("./schema-2EAIJFWA.js");
157
164
  const parsed = storageSchema.parse(storageConfig);
158
165
  getStorageManager().configure(parsed);
@@ -229,6 +236,17 @@ var JobLeaseLostError = class extends Error {
229
236
  this.operation = operation;
230
237
  }
231
238
  };
239
+ var JobLeaseExtensionUnsupportedError = class extends Error {
240
+ code = "JOB_LEASE_EXTENSION_UNSUPPORTED";
241
+ backend;
242
+ constructor(backend) {
243
+ super(
244
+ `The "${backend}" job backend cannot extend a lease. Give the worker a lockSeconds longer than the longest job, or use a backend that implements extendLease.`
245
+ );
246
+ this.name = "JobLeaseExtensionUnsupportedError";
247
+ this.backend = backend;
248
+ }
249
+ };
232
250
 
233
251
  // src/server/jobs/job-runner.ts
234
252
  var runnerLogger = createLogger({ context: { component: "theokit:jobs:runner" } });
@@ -251,7 +269,7 @@ function createJobRunner(backend, definitions) {
251
269
  for (const def of definitions) {
252
270
  byName.set(def.name, def);
253
271
  }
254
- const runOne = async (lease) => {
272
+ const runOne = async (lease, lockSeconds) => {
255
273
  const def = byName.get(lease.name);
256
274
  if (!def) {
257
275
  await finish(
@@ -291,18 +309,37 @@ function createJobRunner(backend, definitions) {
291
309
  }
292
310
  }
293
311
  const abortController = new AbortController();
294
- const lockMs = lease.lockExpiresAt.getTime() - Date.now();
295
- const lockTimer = setTimeout(
296
- () => {
297
- abortController.abort();
298
- },
299
- Math.max(0, lockMs)
300
- );
312
+ let lockTimer;
313
+ const armLockTimer = (expiresAt) => {
314
+ lockTimer = setTimeout(
315
+ () => {
316
+ abortController.abort();
317
+ },
318
+ Math.max(0, expiresAt.getTime() - Date.now())
319
+ );
320
+ };
321
+ armLockTimer(lease.lockExpiresAt);
301
322
  const jobCtx = {
302
323
  traceId,
303
324
  input: parsedInput,
304
325
  signal: abortController.signal,
305
- attempt: lease.attempts
326
+ attempt: lease.attempts,
327
+ async extendLease(seconds = lockSeconds) {
328
+ if (backend.extendLease === void 0 || lease.leaseToken === void 0) {
329
+ throw new JobLeaseExtensionUnsupportedError(backend.name);
330
+ }
331
+ try {
332
+ const until = await backend.extendLease(lease.jobId, {
333
+ leaseToken: lease.leaseToken,
334
+ lockSeconds: seconds
335
+ });
336
+ clearTimeout(lockTimer);
337
+ armLockTimer(until);
338
+ } catch (err) {
339
+ if (err instanceof JobLeaseLostError) abortController.abort();
340
+ throw err;
341
+ }
342
+ }
306
343
  };
307
344
  let failure;
308
345
  let failed = false;
@@ -333,12 +370,10 @@ function createJobRunner(backend, definitions) {
333
370
  };
334
371
  return {
335
372
  async tick(opts) {
336
- const leases = await backend.dequeue({
337
- batchSize: opts?.batchSize ?? 10,
338
- lockSeconds: opts?.lockSeconds ?? 30
339
- });
373
+ const lockSeconds = opts?.lockSeconds ?? 30;
374
+ const leases = await backend.dequeue({ batchSize: opts?.batchSize ?? 10, lockSeconds });
340
375
  for (const lease of leases) {
341
- await runOne(lease);
376
+ await runOne(lease, lockSeconds);
342
377
  }
343
378
  return leases.length;
344
379
  }
@@ -490,6 +525,7 @@ function startJobWorker(config, definitions) {
490
525
  export {
491
526
  initCacheEngineFromConfig,
492
527
  createCronScheduler,
528
+ resolveListenPort,
493
529
  configureAgentRegistryFromConfig,
494
530
  configureStorageManagerFromConfig,
495
531
  resolveSsrEntry,
@@ -500,4 +536,4 @@ export {
500
536
  prepareJobBackend,
501
537
  startJobWorker
502
538
  };
503
- //# sourceMappingURL=chunk-XCPM72D6.js.map
539
+ //# sourceMappingURL=chunk-ZWIKURA5.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/server/cache-bootstrap.ts","../src/server/cron/cron-runtime-node.ts","../src/cli/commands/resolve-listen-port.ts","../src/cli/commands/start/bootstrap-stages.ts","../src/cli/commands/start/cron-bootstrap.ts","../src/cli/commands/start/job-bootstrap.ts","../src/server/jobs/job-backend.ts","../src/server/jobs/job-runner.ts","../src/server/jobs/job-worker.ts"],"sourcesContent":["import type { NormalizedCacheConfig } from '../cache/engine-singleton.js'\n\n/**\n * Initialize the singleton cache engine from `theo.config.ts > cache` (#352).\n *\n * Until this existed, `initCacheEngine` had no production caller while\n * `getCacheEngine` had three — so `revalidateTag`, `updateTag` and\n * `revalidatePath`, all exported publicly, threw \"Cache engine not initialized\"\n * in every application. The subsystem was not unreachable code; it was a bridge\n * with one half published and the other half never built.\n *\n * Three states a boot legitimately reaches, each handled by a guard rather than\n * by a `catch`, because `initCacheEngine` throws on all three and absorbing the\n * throws would absorb the real double-init bug with them:\n *\n * - no `cache` key at all — the framework stays backward compatible, no engine\n * - `enabled: false` — an explicit opt-out, not an error\n * - already initialized — HMR, a second server in one process, a test booting\n * twice in one worker\n *\n * Unlike `configureStorageManagerFromConfig`, its sibling in the CLI bootstrap,\n * a malformed config is NOT\n * degraded into a warning here, and the divergence is deliberate. Warning and\n * continuing would boot an application whose `revalidateTag` still throws — the\n * exact defect this function exists to remove, restored silently and now\n * attributable to nothing.\n */\nexport async function initCacheEngineFromConfig(cacheConfig: unknown): Promise<void> {\n if (cacheConfig === undefined || cacheConfig === null) return\n\n const { initCacheEngine, isCacheEngineInitialized } = await import('../cache/engine-singleton.js')\n if (isCacheEngineInitialized()) return\n\n const { cacheSchema } = await import('../config/schemas/index.js')\n const parsed = cacheSchema.parse(cacheConfig)\n if (!parsed.enabled) return\n\n initCacheEngine({\n enabled: parsed.enabled,\n // The schema accepts `'memory'` or a caller-supplied adapter instance, which\n // it cannot type beyond `unknown` without importing the adapter contract\n // into the config layer.\n storage: parsed.storage as NormalizedCacheConfig['storage'],\n maxEntries: parsed.maxEntries,\n defaults: parsed.defaults,\n })\n}\n","import { CronExpressionParser } from 'cron-parser'\n\nimport { generateNewTraceContext } from '../observability/trace-context-propagation.js'\n\nimport type { CronLock } from './cron-lock.js'\nimport type { CronContext, CronDefinition } from './cron-types.js'\n\n/**\n * In-process cron scheduler, run by `theokit start` (and by `theokit dev --crons`).\n *\n * Algorithm:\n * - For each cron, compute `nextFireAt = cron-parser.next()`.\n * - Schedule a `setTimeout(handler, nextFireAt - now)`.\n * - After handler invocation (sync return or Promise scheduled), recompute\n * next fire from CURRENT time (drift-free vs scheduled time).\n *\n * Per-cron isolation (EC-109):\n * - Each cron's handler invocation is fire-and-forget (`void` scheduled).\n * A hanging handler does NOT block the scheduler loop nor other crons.\n * - `concurrency: 'forbid'` (default) tracks an in-flight flag per-cron;\n * subsequent ticks skip + warn while the in-flight flag is set.\n * - `concurrency: 'allow'` runs handlers concurrently — caller's responsibility.\n *\n * Several processes (replicas) each run this scheduler under `theokit start`. Without a `lock`,\n * each one fires every tick. With one, each tick asks the lock first and only the process that\n * gets `true` runs the handler (usetheokit/theokit#1016). A lock that fails skips the tick and logs\n * the error: running unguarded would repeat the side effect on every replica, which is the defect\n * the lock exists for.\n *\n * Serverless targets use platform-native triggers (T1.5 adapter translators), which fire once.\n */\n\nexport interface CronSchedulerOptions {\n /** Shared lock deciding which process runs each tick. Absent: this process runs every tick. */\n lock?: CronLock\n}\n\nexport interface CronScheduler {\n start(): void\n stop(): void\n}\n\ninterface CronJobState {\n readonly def: CronDefinition\n inFlight: boolean\n timer: NodeJS.Timeout | null\n abortController: AbortController | null\n}\n\nexport function createCronScheduler(\n definitions: readonly CronDefinition[],\n options: CronSchedulerOptions = {},\n): CronScheduler {\n const lock = options.lock\n const states: CronJobState[] = definitions.map((def) => ({\n def,\n inFlight: false,\n timer: null,\n abortController: null,\n }))\n\n let started = false\n\n /** Run the tick if the lock (when there is one) gives it to this process. */\n const fireIfLockAllows = (state: CronJobState, scheduledAt: Date): void => {\n if (lock === undefined) {\n fireAndReschedule(state, scheduledAt)\n return\n }\n state.timer = null\n void lock.acquire(state.def.name, scheduledAt).then(\n (won) => {\n if (won) fireAndReschedule(state, scheduledAt)\n else scheduleNext(state)\n },\n (err: unknown) => {\n console.error(\n `[theokit:cron] \"${state.def.name}\" skipped tick at ${scheduledAt.toISOString()}: ` +\n 'the cron lock could not be acquired:',\n err instanceof Error ? err.message : err,\n )\n scheduleNext(state)\n },\n )\n }\n\n const fireAndReschedule = (state: CronJobState, scheduledAt: Date): void => {\n state.timer = null\n\n if (state.inFlight && state.def.concurrency === 'forbid') {\n console.warn(\n `[theokit:cron] \"${state.def.name}\" skipped tick at ${scheduledAt.toISOString()} ` +\n '— previous handler still running (concurrency: forbid).',\n )\n scheduleNext(state)\n return\n }\n\n state.inFlight = true\n state.abortController = new AbortController()\n const traceCtx = generateNewTraceContext()\n const ctx: CronContext = {\n traceId: traceCtx.trace_id,\n scheduledAt,\n signal: state.abortController.signal,\n }\n\n // Fire-and-forget: EC-109 — never await here so a hanging handler\n // can't block the scheduler loop or other crons.\n void Promise.resolve()\n .then(() => state.def.handler(ctx))\n .catch((err: unknown) => {\n console.error(\n `[theokit:cron] \"${state.def.name}\" handler error:`,\n err instanceof Error ? err.message : err,\n )\n })\n .finally(() => {\n state.inFlight = false\n })\n\n scheduleNext(state)\n }\n\n const scheduleNext = (state: CronJobState): void => {\n if (!started) return\n const interval = CronExpressionParser.parse(state.def.schedule, {\n tz: 'UTC',\n currentDate: new Date(),\n })\n const next = interval.next().toDate()\n const delayMs = Math.max(0, next.getTime() - Date.now())\n state.timer = setTimeout(() => {\n fireIfLockAllows(state, next)\n }, delayMs)\n // setTimeout returns a Timeout object; in Node, .unref() is available but\n // we DO want this to keep the event loop alive in dev — explicit no-unref.\n }\n\n return {\n start(): void {\n if (started) return\n started = true\n for (const state of states) {\n scheduleNext(state)\n }\n },\n stop(): void {\n started = false\n for (const state of states) {\n if (state.timer) {\n clearTimeout(state.timer)\n state.timer = null\n }\n state.abortController?.abort()\n state.abortController = null\n }\n },\n }\n}\n","/**\n * The port a command listens on: an explicit flag, then `PORT`, then `config.port`.\n *\n * The flag is a person typing now, the environment is where the process was put (`PORT` is what\n * every container platform injects, usetheokit/theokit#402), and the config is the project's default.\n * `theokit start` and `theokit dev` both resolve it here, so they cannot drift again\n * (usetheokit/theokit#1134: `dev` ignored `PORT` and listened on `config.port`).\n *\n * A `PORT` that is not an integer is ignored rather than turned into `NaN`.\n */\nexport function resolveListenPort(\n flag: number | undefined,\n env: NodeJS.ProcessEnv,\n configPort: number,\n): number {\n if (flag !== undefined) return flag\n const fromEnv = Number.parseInt(env.PORT ?? '', 10)\n return Number.isInteger(fromEnv) ? fromEnv : configPort\n}\n","/**\n * Bootstrap stages extracted from `start.ts` per T4.2 (architecture-cleanup, ADR-0017).\n *\n * The full goal of T4.2 is a ≤30-LOC `startCommand` spine + 6-8 stage files. This\n * file ships the first batch: the configure-from-config bootstrap helpers + the\n * SSR entry resolver. They are stand-alone, side-effect-free at module load, and\n * already individually testable.\n *\n * Remaining stages (request-handler extraction, graceful-shutdown extraction,\n * signal-handlers extraction) are deferred to a follow-up sprint — see plan\n * ks.\n */\n\nimport { existsSync } from 'node:fs'\nimport { resolve } from 'node:path'\n\nimport { warnOnce } from '../../../server/observability/logger.js'\n\ninterface SdkAgentRegistry {\n configure?: (opts: { maxAgents?: number; idleTimeoutMs?: number }) => void\n}\ninterface SdkModule {\n Agent?: { registry?: SdkAgentRegistry }\n}\n\n/**\n * Configure SDK's Agent.registry from `theo.config.ts > agents.registry`.\n * Lazy at boot; EC-3 sync flag flip prevents race under concurrent boot.\n * Silent no-op when registry config is absent or SDK is uninstalled.\n */\nexport async function configureAgentRegistryFromConfig(\n registryConfig: { maxAgents: number; idleTimeoutMs: number } | undefined,\n): Promise<void> {\n if (registryConfig === undefined) return\n try {\n const sdk = (await import('@theokit/sdk').catch(() => null)) as SdkModule | null\n const sdkConfigure = sdk?.Agent?.registry?.configure\n if (sdkConfigure === undefined) return\n const { configureAgentRegistryOnce } =\n await import('../../../server/agent/configure-agent-registry.js')\n configureAgentRegistryOnce(\n {\n configure: (opts) => {\n sdkConfigure(opts)\n },\n },\n registryConfig,\n )\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err)\n warnOnce('bootstrap.agent_registry_skip', {\n event: 'bootstrap.agent_registry_skip',\n message: msg,\n })\n }\n}\n\n/**\n * Configure the StorageManager from `theo.config.ts > storage` (ADR-0007).\n * Manager enforces configure-once internally (D3); this helper bridges the\n * config to the singleton with actionable error handling.\n */\nexport async function configureStorageManagerFromConfig(storageConfig: unknown): Promise<void> {\n if (storageConfig === undefined || storageConfig === null) return\n try {\n const { getStorageManager } = await import('../../../server/storage/storage-manager.js')\n const { storageSchema } = await import('../../../config/schema.js')\n // Re-validate at boot so a malformed config from a non-Zod source\n // (test fixtures, dynamic configs) surfaces a clear error early.\n const parsed = storageSchema.parse(storageConfig)\n getStorageManager().configure(parsed)\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err)\n warnOnce('bootstrap.storage_skip', {\n event: 'bootstrap.storage_skip',\n message: msg,\n })\n }\n}\n\nconst SSR_EXTENSIONS = ['.mjs', '.js'] as const\n\n/**\n * Resolve the SSR entry-server module path. tsup may emit `.mjs` or `.js`\n * depending on output format. Try `.mjs` first (modern default) then fall\n * back to `.js`. Returns null when neither exists — SSR stays disabled.\n *\n * Exported so unit tests can pin the resolution order without booting the\n * full CLI.\n */\nexport function resolveSsrEntry(distDir: string): string | null {\n for (const ext of SSR_EXTENSIONS) {\n const path = resolve(distDir, `server/entry-server${ext}`)\n\n if (existsSync(path)) return path\n }\n return null\n}\n","import { existsSync, readFileSync } from 'node:fs'\nimport { resolve } from 'node:path'\n\nimport type { CronManifest } from '../../../server/cron/cron-manifest.js'\nimport type { CronDefinition } from '../../../server/cron/cron-types.js'\n\n/**\n * Reads the cron manifest `theokit build` writes and re-loads each handler so\n * `theokit start` can drive the in-process scheduler.\n *\n * The build prints \"Cron → in-process scheduler (theokit start)\" for\n * `target: node`, but nothing on the serving side ever read `dist/crons.json`\n * — the crons were declared, validated, written, and then never ran\n * (theokit#324).\n *\n * The manifest names WHICH files hold a cron; the definition itself is taken\n * from the module, which is the source `defineCron` produced. Trusting the\n * manifest's copy of the schedule would let a stale build silently run a cron\n * on the wrong cadence.\n */\nexport async function loadCronDefinitions(\n manifestPath: string,\n projectRoot: string,\n loadModule: (filePath: string) => unknown,\n): Promise<CronDefinition[]> {\n if (!existsSync(manifestPath)) return []\n\n const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8')) as CronManifest\n return loadCronModules(\n manifest.crons.map((entry) => resolve(projectRoot, entry.filePath)),\n loadModule,\n )\n}\n\n/**\n * Import each file and take its `defineCron` default export, refusing a file without one. Shared\n * with `theokit dev --crons`, which lists the files itself and loads them through Vite.\n */\nexport async function loadCronModules(\n filePaths: readonly string[],\n loadModule: (filePath: string) => unknown,\n): Promise<CronDefinition[]> {\n const definitions: CronDefinition[] = []\n for (const filePath of filePaths) {\n const mod = (await loadModule(filePath)) as { default?: unknown }\n const exported = mod.default\n if (!isCronDefinition(exported)) {\n throw new Error(\n `\"${filePath}\" is listed as a cron but has no valid default export. ` +\n 'Expected `export default defineCron(name, { schedule, handler })`. ' +\n 'Re-run `theokit build` if the file changed since the last build.',\n )\n }\n definitions.push(exported)\n }\n return definitions\n}\n\nfunction isCronDefinition(value: unknown): value is CronDefinition {\n if (typeof value !== 'object' || value === null) return false\n const candidate = value as Record<string, unknown>\n return (\n typeof candidate.name === 'string' &&\n typeof candidate.schedule === 'string' &&\n typeof candidate.handler === 'function'\n )\n}\n","import { existsSync, readFileSync } from 'node:fs'\nimport { resolve } from 'node:path'\n\nimport type { TheoConfig } from '../../../config/schema.js'\nimport { jobBackendFromConfig } from '../../../server/jobs/job-backend-from-config.js'\nimport type { JobBackend } from '../../../server/jobs/job-backend.js'\nimport type { JobManifest } from '../../../server/jobs/job-manifest.js'\nimport { createJobRunner } from '../../../server/jobs/job-runner.js'\nimport type { JobDefinition } from '../../../server/jobs/job-types.js'\nimport { createJobWorker, type JobWorker } from '../../../server/jobs/job-worker.js'\n\n/**\n * Reads the job manifest `theokit build` writes and re-loads each definition, the jobs twin of\n * `loadCronDefinitions`. The manifest names WHICH files hold a job; the definition comes from the\n * module, so a stale build cannot run a handler the source no longer has.\n *\n * Before usetheokit/theokit#1010 nothing on the serving side read `jobs.json`.\n */\nexport async function loadJobDefinitions(\n manifestPath: string,\n projectRoot: string,\n loadModule: (filePath: string) => unknown,\n): Promise<JobDefinition[]> {\n if (!existsSync(manifestPath)) return []\n const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8')) as JobManifest\n return loadJobModules(\n manifest.jobs.map((entry) => resolve(projectRoot, entry.filePath)),\n loadModule,\n )\n}\n\n/** Import each file and take its `defineJob` default export, refusing a file without one. */\nexport async function loadJobModules(\n filePaths: readonly string[],\n loadModule: (filePath: string) => unknown,\n): Promise<JobDefinition[]> {\n const definitions: JobDefinition[] = []\n for (const filePath of filePaths) {\n const mod = (await loadModule(filePath)) as { default?: unknown }\n if (!isJobDefinition(mod.default)) {\n throw new Error(\n `\"${filePath}\" is listed as a job but has no valid default export. ` +\n \"Expected `export default defineJob(name, { handler })` from 'theokit/server/jobs'. \" +\n 'Re-run `theokit build` if the file changed since the last build.',\n )\n }\n definitions.push(mod.default)\n }\n return definitions\n}\n\nfunction isJobDefinition(value: unknown): value is JobDefinition {\n if (typeof value !== 'object' || value === null) return false\n const candidate = value as Record<string, unknown>\n return (\n typeof candidate.name === 'string' &&\n typeof candidate.handler === 'function' &&\n typeof candidate.maxAttempts === 'number'\n )\n}\n\n/**\n * `migrate()` of the configured `jobs.backend` rejected at boot. The process must not serve: every\n * route would answer 2xx while the outbox dropped each job it enqueued (usetheokit/theokit#1072).\n */\nclass JobBackendSetupError extends Error {\n readonly code = 'JOB_BACKEND_SETUP_FAILED'\n readonly backend: string\n constructor(backend: string, cause: unknown) {\n const reason = describeCause(cause)\n super(\n `jobs.backend (${backend}) could not create its storage at boot: ${reason}. ` +\n 'Jobs enqueued now would be lost, so the server did not start. Check that the database ' +\n 'in theo.config.ts is reachable and that its user may create tables.',\n { cause },\n )\n this.name = 'JobBackendSetupError'\n this.backend = backend\n }\n}\n\n/**\n * The text of a setup failure. `pg` connecting to `localhost` tries every address it resolves to\n * and rejects with an `AggregateError` whose own message is empty, which printed \"could not create\n * its storage at boot: .\" on a CI runner. The attempts are listed instead, and an error without a\n * message falls back to its code.\n */\nfunction describeCause(cause: unknown): string {\n if (cause instanceof AggregateError && cause.message === '') {\n return cause.errors.map(describeCause).join('; ')\n }\n if (cause instanceof Error) {\n const code = (cause as { code?: unknown }).code\n if (cause.message !== '') return cause.message\n return typeof code === 'string' ? code : cause.name\n }\n return String(cause)\n}\n\n/**\n * Run `migrate()` on the configured `jobs.backend`, when it has one, before anything can enqueue\n * or dequeue. `theokit start` and `theokit dev` call it at boot whether or not this process runs\n * the worker: a web-only process enqueues into the same table.\n *\n * It used to be the app's job, and nothing told the app: the README configured a\n * `PostgresJobBackend` without the call, and a fresh database answered 2xx while every job was\n * dropped. Calling it from `theo.config.ts` instead made `theokit build` need a database.\n */\nexport async function prepareJobBackend(config: Pick<TheoConfig, 'jobs'>): Promise<void> {\n const backend = jobBackendFromConfig(config)\n if (backend?.migrate === undefined) return\n try {\n await backend.migrate()\n } catch (err) {\n throw new JobBackendSetupError(backend.name, err)\n }\n}\n\nexport interface JobWorkerBootstrap {\n /** The running worker, or `undefined` when none was started (see `summary`). */\n readonly worker: JobWorker | undefined\n /** One line for the boot log saying what happens to the declared jobs, or `undefined` if none. */\n readonly summary: string | undefined\n}\n\n/**\n * Start the in-process job worker when there is something to run and somewhere to run it from.\n *\n * - no declared jobs: no worker. A worker with no definitions would lease other processes' jobs\n * and fail them as \"No job definition\".\n * - jobs but no `jobs.backend`: no worker, and the summary says the jobs cannot run.\n * - `jobs.worker.enabled: false`: no worker, said in the summary, so a web-only process is visibly\n * one.\n */\nexport function startJobWorker(\n config: Pick<TheoConfig, 'jobs'>,\n definitions: readonly JobDefinition[],\n): JobWorkerBootstrap {\n if (definitions.length === 0) return { worker: undefined, summary: undefined }\n const declared = `Jobs: ${String(definitions.length)} declared`\n const backend: JobBackend | undefined = jobBackendFromConfig(config)\n if (backend === undefined) {\n return {\n worker: undefined,\n summary:\n `${declared}, NOT running: theo.config.ts sets no jobs.backend, so ctx.queue is absent ` +\n 'and nothing can enqueue or run them.',\n }\n }\n const options = config.jobs?.worker\n if (options?.enabled === false) {\n return {\n worker: undefined,\n summary: `${declared}, worker disabled (jobs.worker.enabled: false); another process must run them.`,\n }\n }\n const worker = createJobWorker(createJobRunner(backend, definitions), {\n pollIntervalMs: options?.pollIntervalMs,\n batchSize: options?.batchSize,\n lockSeconds: options?.lockSeconds,\n })\n worker.start()\n return {\n worker,\n summary: `${declared}, worker polling the ${backend.name} backend in-process`,\n }\n}\n","/**\n * Neutral `JobBackend` interface.\n *\n * Implementations ship in core:\n * - `InMemoryJobBackend` (T2.2) — dev + tests; no external deps\n * - `PostgresJobBackend` (T3.1) — production; requires `pg` peer dep\n *\n * Community packages (`@theokit/jobs-redis`, `@theokit/jobs-sqs`, etc.)\n * implement this same interface to plug in alternate substrates without\n * modifying TheoKit core.\n */\n\nimport type { PoolLike } from '../storage/storage-types.js'\n\nexport interface JobEnqueueInput {\n /** The job name (matches a `defineJob` declaration). */\n name: string\n /** Validated input (already passed through Zod or equivalent at the queue-client layer). */\n input: unknown\n /**\n * Optional idempotency key, scoped to `name`: a second enqueue of the same (name, key) returns the\n * first job's id instead of creating a job, including when the two calls race. The window is\n * backend-specific: `PostgresJobBackend` holds the key while the row exists (until `ack`, or for\n * good once the job has failed); `InMemoryJobBackend` holds it for 60 seconds.\n */\n idempotencyKey?: string\n /** Optional delay before the job becomes available for dispatch. */\n delaySeconds?: number\n /** W3C Trace Context propagation per ADR/R0.5.9. */\n traceparent?: string\n /**\n * Maximum dispatch attempts stored with the job (default 1). The queue client has no access to\n * the job definitions and leaves it unset; `createJobRunner` passes the definition's\n * `maxAttempts` to `nack`, which takes precedence over this stored value.\n */\n maxAttempts?: number\n}\n\nexport interface JobLease {\n readonly jobId: string\n readonly name: string\n readonly input: unknown\n readonly attempts: number\n readonly maxAttempts: number\n readonly traceparent?: string\n readonly lockExpiresAt: Date\n /**\n * Identifies THIS lease. Pass it back to `ack`/`nack` so a worker whose lease expired, and was\n * handed to another worker, cannot finish the job on the new holder's behalf. Both first-party\n * backends set it; optional so a backend written against the earlier contract still compiles.\n */\n readonly leaseToken?: string\n}\n\n/** What `nack` is told about the failure. */\nexport interface JobNackOptions extends JobLeaseFence {\n /** The failure message. */\n error: string\n /** The handler threw `NonRetryableError`: no retry, whatever the attempts left. */\n nonRetryable?: boolean\n /**\n * The retry ceiling from the job's definition. Takes precedence over the value stored at\n * enqueue, which is 1 for every job enqueued through the queue client.\n */\n maxAttempts?: number\n}\n\n/** Fences `ack`/`nack` to the lease that is finishing the job. */\nexport interface JobLeaseFence {\n /** The `leaseToken` of the `JobLease` being finished. Omitted, the call is not fenced. */\n leaseToken?: string\n}\n\nexport interface JobBackend {\n /** Human-readable name for logging (e.g., \"memory\", \"postgres\"). */\n readonly name: string\n\n /** Persist a job for later dispatch. Returns the generated jobId. */\n enqueue(input: JobEnqueueInput): Promise<{ jobId: string }>\n\n /** Worker loop polls for the next available leases. */\n dequeue(opts: { batchSize?: number; lockSeconds?: number }): Promise<JobLease[]>\n\n /**\n * Mark a job complete (success). With `leaseToken`, rejects with `JobLeaseLostError` and leaves\n * the job alone when that lease no longer holds it.\n */\n ack(jobId: string, fence?: JobLeaseFence): Promise<void>\n\n /**\n * Mark a job failed; backend decides retry vs DLQ via attempts. With `leaseToken`, rejects with\n * `JobLeaseLostError` and leaves the job alone when that lease no longer holds it.\n */\n nack(jobId: string, opts: JobNackOptions): Promise<void>\n\n /**\n * Optional: keep a lease for `lockSeconds` more, counted from now, and return the new deadline.\n * A handler that is still making progress calls it (through `ctx.extendLease`) so a job that may\n * run for a long time does not need a long lock for every job. Rejects with `JobLeaseLostError`\n * (`operation: 'extend'`) when `leaseToken` no longer holds the job: the lease expired and was\n * handed on, or the job is gone (usetheokit/theokit#1132). A backend that leaves it out cannot\n * have its leases extended, and `ctx.extendLease` says so.\n */\n extendLease?(jobId: string, opts: { leaseToken: string; lockSeconds: number }): Promise<Date>\n\n /**\n * Optional: persist a job through `client`, a connection inside a transaction the caller opened,\n * so the job commits or rolls back with the caller's writes (usetheokit/theokit#1077). Only a\n * backend whose jobs live in the caller's database can offer it; `ctx.queue.enqueueInTransaction`\n * refuses a backend without it rather than enqueueing outside the transaction.\n */\n enqueueInTransaction?(client: PoolLike, input: JobEnqueueInput): Promise<{ jobId: string }>\n\n /**\n * Optional: resolve when the backend's store answers, reject when it does not. `GET /__theo/ready`\n * calls it under `theokit start` and `theokit dev`, so an unreachable job store answers 503\n * (usetheokit/theokit#1071). A backend with nothing remote to reach leaves it out.\n */\n ping?(): Promise<void>\n\n /**\n * Optional: create or upgrade whatever storage the backend needs (a table, an index). Must be\n * idempotent and safe to run from several processes at once. `theokit start` and `theokit dev`\n * call it once at boot, before serving a request or starting the worker, and refuse to boot when\n * it rejects (usetheokit/theokit#1072). A backend that needs no setup leaves it out.\n */\n migrate?(): Promise<void>\n\n /**\n * Optional: return the existing jobId if `key` was enqueued within `ttlSeconds`. Pass `name` to\n * scope the lookup to one job type, as `enqueue` deduplicates on (name, key); without it, a key\n * shared by two job types may return either job.\n */\n idempotency?(key: string, ttlSeconds: number, name?: string): Promise<{ jobId: string } | null>\n}\n\n/**\n * Thrown from a job handler to opt out of retry policy. The runner nacks with\n * `nonRetryable: true` and the backend never retries the job: `PostgresJobBackend`\n * keeps it as failed with the error, `InMemoryJobBackend` drops it with a warning.\n */\nexport class NonRetryableError extends Error {\n readonly code = 'NON_RETRYABLE'\n constructor(message: string) {\n super(message)\n this.name = 'NonRetryableError'\n }\n}\n\n/**\n * `ack`/`nack` was called with a lease token that no longer holds the job: the lease expired and\n * another worker leased the job again (or the job is gone). The job is left untouched, because the\n * current holder owns its outcome. The runner logs it and moves on; a direct caller decides.\n */\nexport class JobLeaseLostError extends Error {\n readonly code = 'JOB_LEASE_LOST'\n readonly jobId: string\n readonly operation: 'ack' | 'nack' | 'extend'\n constructor(jobId: string, operation: 'ack' | 'nack' | 'extend') {\n super(\n `Cannot ${operation} job \"${jobId}\": its lease expired and another worker holds it now, ` +\n 'or the job no longer exists. The current holder decides its outcome.',\n )\n this.name = 'JobLeaseLostError'\n this.jobId = jobId\n this.operation = operation\n }\n}\n\n/**\n * `ctx.extendLease` was called on a job whose backend has no `extendLease`. The lease keeps its\n * original deadline and `ctx.signal` aborts when it passes.\n */\nexport class JobLeaseExtensionUnsupportedError extends Error {\n readonly code = 'JOB_LEASE_EXTENSION_UNSUPPORTED'\n readonly backend: string\n constructor(backend: string) {\n super(\n `The \"${backend}\" job backend cannot extend a lease. Give the worker a lockSeconds longer ` +\n 'than the longest job, or use a backend that implements extendLease.',\n )\n this.name = 'JobLeaseExtensionUnsupportedError'\n this.backend = backend\n }\n}\n","import { createLogger } from '../observability/logger.js'\nimport {\n extractTraceContext,\n generateNewTraceContext,\n} from '../observability/trace-context-propagation.js'\n\nimport {\n type JobBackend,\n JobLeaseExtensionUnsupportedError,\n type JobLease,\n JobLeaseLostError,\n NonRetryableError,\n} from './job-backend.js'\nimport type { JobContext, JobDefinition } from './job-types.js'\n\n/**\n * Job runner — pulls leases from a backend and invokes the matching\n * handler. Each invocation wires up `JobContext` with:\n * - `traceId` extracted from the lease's `traceparent` header (W3C\n * Trace Context per R0.5.9), OR a fresh generated trace_id when\n * the upstream had no traceparent OR it was malformed.\n * - `attempt` from the lease.\n * - `signal` that aborts when the lease times out.\n *\n * `tick()` runs one dequeue+dispatch cycle and returns when all leases\n * have been ack'd or nack'd. `createJobWorker` (`job-worker.ts`) is the loop\n * around it, with idle polling and error backoff; `theokit start` and\n * `theokit dev` run one.\n *\n * EC-6 (trace continuity edge): when a lease has no traceparent OR a\n * malformed one, the handler still gets a valid traceId (generated) —\n * never null/undefined. The job MAY itself enqueue child jobs that\n * continue the new trace_id.\n */\n\nconst runnerLogger = createLogger({ context: { component: 'theokit:jobs:runner' } })\n\n/**\n * Run an ack or nack, fenced by the lease. A lost lease means another worker owns the job now, so\n * its outcome is not ours to write: log it and move on. Any other failure propagates.\n */\nasync function finish(\n lease: JobLease,\n outcome: 'ack' | 'nack',\n write: () => Promise<void>,\n): Promise<void> {\n try {\n await write()\n } catch (err) {\n if (!(err instanceof JobLeaseLostError)) throw err\n runnerLogger.warn('job lease lost before the outcome was written; the new holder decides it', {\n jobId: lease.jobId,\n job: lease.name,\n attempt: lease.attempts,\n outcome,\n code: err.code,\n })\n }\n}\n\nexport interface JobRunner {\n /** Run one dequeue+dispatch cycle. */\n tick(opts?: { batchSize?: number; lockSeconds?: number }): Promise<number>\n}\n\nexport function createJobRunner(\n backend: JobBackend,\n definitions: readonly JobDefinition[],\n): JobRunner {\n const byName = new Map<string, JobDefinition>()\n for (const def of definitions) {\n byName.set(def.name, def)\n }\n\n const runOne = async (lease: JobLease, lockSeconds: number): Promise<void> => {\n const def = byName.get(lease.name)\n if (!def) {\n // Job name not registered in this runner's definition set. Nack\n // permanently — the lease can't be processed by this runner.\n await finish(lease, 'nack', () =>\n backend.nack(lease.jobId, {\n error: `No job definition for \"${lease.name}\"`,\n nonRetryable: true,\n leaseToken: lease.leaseToken,\n }),\n )\n return\n }\n\n // Resolve trace ID from lease's traceparent, or fall back to fresh.\n let traceId: string\n if (lease.traceparent) {\n const headers = new Headers({ traceparent: lease.traceparent })\n const ctx = extractTraceContext(headers)\n traceId = ctx?.trace_id ?? generateNewTraceContext().trace_id\n } else {\n traceId = generateNewTraceContext().trace_id\n }\n\n // Optional Zod validation on input.\n let parsedInput: unknown = lease.input\n if (def.inputSchema) {\n try {\n parsedInput = def.inputSchema.parse(lease.input)\n } catch (err) {\n await finish(lease, 'nack', () =>\n backend.nack(lease.jobId, {\n error: `Input validation failed: ${err instanceof Error ? err.message : String(err)}`,\n nonRetryable: true,\n leaseToken: lease.leaseToken,\n }),\n )\n return\n }\n }\n\n const abortController = new AbortController()\n // Auto-abort when the lease expires. `extendLease` moves the deadline, so the timer is re-armed.\n let lockTimer: ReturnType<typeof setTimeout> | undefined\n const armLockTimer = (expiresAt: Date): void => {\n lockTimer = setTimeout(\n () => {\n abortController.abort()\n },\n Math.max(0, expiresAt.getTime() - Date.now()),\n )\n }\n armLockTimer(lease.lockExpiresAt)\n\n const jobCtx: JobContext = {\n traceId,\n input: parsedInput,\n signal: abortController.signal,\n attempt: lease.attempts,\n async extendLease(seconds = lockSeconds) {\n if (backend.extendLease === undefined || lease.leaseToken === undefined) {\n throw new JobLeaseExtensionUnsupportedError(backend.name)\n }\n try {\n const until = await backend.extendLease(lease.jobId, {\n leaseToken: lease.leaseToken,\n lockSeconds: seconds,\n })\n clearTimeout(lockTimer)\n armLockTimer(until)\n } catch (err) {\n // Another worker holds the job now: this handler must stop.\n if (err instanceof JobLeaseLostError) abortController.abort()\n throw err\n }\n },\n }\n\n let failure: unknown\n let failed = false\n try {\n await def.handler(jobCtx)\n } catch (err) {\n failed = true\n failure = err\n } finally {\n clearTimeout(lockTimer)\n }\n // The outcome is written outside the handler's try, so a failed ack is never mistaken for a\n // failed handler and nacked.\n if (!failed) {\n await finish(lease, 'ack', () => backend.ack(lease.jobId, { leaseToken: lease.leaseToken }))\n return\n }\n await finish(lease, 'nack', () =>\n backend.nack(lease.jobId, {\n error: failure instanceof Error ? failure.message : String(failure),\n nonRetryable: failure instanceof NonRetryableError,\n leaseToken: lease.leaseToken,\n // The definition is the source of truth: a job enqueued through the queue client was stored\n // with the backend default of 1 (usetheokit/theokit#1013).\n maxAttempts: def.maxAttempts,\n }),\n )\n }\n\n return {\n async tick(opts) {\n const lockSeconds = opts?.lockSeconds ?? 30\n const leases = await backend.dequeue({ batchSize: opts?.batchSize ?? 10, lockSeconds })\n // Process leases sequentially — caller controls concurrency via\n // batchSize and tick frequency.\n for (const lease of leases) {\n await runOne(lease, lockSeconds)\n }\n return leases.length\n },\n }\n}\n","import { createLogger } from '../observability/logger.js'\n\nimport type { JobRunner } from './job-runner.js'\n\n/**\n * The loop around `JobRunner.tick()`.\n *\n * `tick()` runs one dequeue-and-dispatch cycle and left the loop to its caller, and `theokit start`\n * never wrote one, so jobs were enqueued into a backend nothing drained (usetheokit/theokit#1010).\n * This is that loop, shared by `theokit start`, `theokit dev` and anyone running a worker process\n * of their own:\n *\n * - a tick that leased jobs is followed by another at once, so a backlog drains at full speed;\n * - an empty tick waits `pollIntervalMs` before asking again;\n * - a tick that throws (the database is down) is logged and retried with exponential backoff\n * capped at `maxErrorBackoffMs`, so an outage neither kills the process nor spins;\n * - `stop()` lets the tick in progress finish (its jobs are acked or nacked) and resolves after it.\n * A wait in progress is cut short.\n */\nexport interface JobWorkerOptions {\n /** Wait after a tick that leased nothing. Default 1000 ms. */\n pollIntervalMs?: number\n /** Leases per tick, passed to `tick()`. Default 10. */\n batchSize?: number\n /** Lease duration per job, passed to `tick()`. Default 30 s. */\n lockSeconds?: number\n /** Ceiling of the backoff after consecutive failed ticks. Default 30 000 ms. */\n maxErrorBackoffMs?: number\n}\n\nexport interface JobWorker {\n /** Start polling. A second call is a no-op. */\n start(): void\n /** Stop polling; resolves once the tick in progress, if any, has finished. */\n stop(): Promise<void>\n}\n\nconst workerLogger = createLogger({ context: { component: 'theokit:jobs:worker' } })\n\nexport function createJobWorker(runner: JobRunner, options: JobWorkerOptions = {}): JobWorker {\n const pollIntervalMs = options.pollIntervalMs ?? 1000\n const maxErrorBackoffMs = options.maxErrorBackoffMs ?? 30_000\n const tickOptions = { batchSize: options.batchSize ?? 10, lockSeconds: options.lockSeconds ?? 30 }\n\n let running = false\n let loop: Promise<void> | undefined\n let wake: (() => void) | undefined\n\n const wait = (ms: number): Promise<void> =>\n new Promise((resolve) => {\n const timer = setTimeout(done, ms)\n function done(): void {\n clearTimeout(timer)\n wake = undefined\n resolve()\n }\n wake = done\n })\n\n const run = async (): Promise<void> => {\n let failures = 0\n while (running) {\n try {\n const leased = await runner.tick(tickOptions)\n failures = 0\n if (leased > 0) continue\n await wait(pollIntervalMs)\n } catch (err) {\n failures++\n const delayMs = Math.min(pollIntervalMs * 2 ** failures, maxErrorBackoffMs)\n workerLogger.error('job worker tick failed; retrying', {\n error: err instanceof Error ? err.message : String(err),\n consecutiveFailures: failures,\n retryInMs: delayMs,\n })\n await wait(delayMs)\n }\n }\n }\n\n return {\n start() {\n if (running) return\n running = true\n loop = run()\n },\n async stop() {\n running = false\n wake?.()\n await loop\n loop = undefined\n },\n }\n}\n"],"mappings":"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","names":["existsSync","resolve","existsSync","readFileSync","resolve","resolve","existsSync","readFileSync","resolve"]}
package/dist/cli/index.js CHANGED
@@ -15,7 +15,7 @@ function cliVersion() {
15
15
  // src/cli/index.ts
16
16
  var cli = cac("theokit");
17
17
  cli.command("dev", "Start development server").option("--port <port>", "Port number").option("--crons", "Schedule the crons in dev too (off by default)").action(async (options) => {
18
- const { devCommand } = await import("../dev-AE7EWSB7.js");
18
+ const { devCommand } = await import("../dev-SCS6SPET.js");
19
19
  await devCommand({
20
20
  port: options.port ? Number(options.port) : void 0,
21
21
  crons: options.crons === true
@@ -35,7 +35,7 @@ cli.command("build", "Build for production").option("--target <target>", "Deploy
35
35
  });
36
36
  cli.command("start", "Start production server").option("--port <port>", "Port number").action(async (options) => {
37
37
  try {
38
- const { startCommand } = await import("../start-AE5YCDVS.js");
38
+ const { startCommand } = await import("../start-QCGCORTH.js");
39
39
  await startCommand({ port: options.port ? Number(options.port) : void 0 });
40
40
  } catch (err) {
41
41
  const msg = err instanceof Error ? err.message : String(err);
@@ -47,7 +47,7 @@ cli.command("start", "Start production server").option("--port <port>", "Port nu
47
47
  });
48
48
  cli.command("preview", "Build for production, then serve it \u2014 one step (B-030)").option("--port <port>", "Port number").option("--target <target>", "Deploy target (node, vercel, cloudflare)").action(async (options) => {
49
49
  try {
50
- const { previewCommand } = await import("../preview-VMMBMNMM.js");
50
+ const { previewCommand } = await import("../preview-USC6FF55.js");
51
51
  await previewCommand({
52
52
  port: options.port ? Number(options.port) : void 0,
53
53
  target: options.target
@@ -17,8 +17,9 @@ import {
17
17
  loadCronModules,
18
18
  loadJobModules,
19
19
  prepareJobBackend,
20
+ resolveListenPort,
20
21
  startJobWorker
21
- } from "./chunk-XCPM72D6.js";
22
+ } from "./chunk-ZWIKURA5.js";
22
23
  import {
23
24
  preflightNodeAndBindings
24
25
  } from "./chunk-KTMQUYED.js";
@@ -91,7 +92,7 @@ async function startDevServer(cwd, options) {
91
92
  `[services] services failed healthcheck: ${orchestration.unhealthy.join(", ")}. Check that each declared service binds its port and responds 200 on its healthcheck path within 30s.`
92
93
  );
93
94
  }
94
- const port = options?.port ?? config.port;
95
+ const port = resolveListenPort(options?.port, process.env, config.port);
95
96
  const flatRateLimit = config.rateLimit && "windowMs" in config.rateLimit && "max" in config.rateLimit ? config.rateLimit : void 0;
96
97
  let server;
97
98
  try {
@@ -179,4 +180,4 @@ export {
179
180
  devCommand,
180
181
  startDevServer
181
182
  };
182
- //# sourceMappingURL=dev-AE7EWSB7.js.map
183
+ //# sourceMappingURL=dev-SCS6SPET.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/cli/commands/dev.ts"],"sourcesContent":["import { resolve } from 'node:path'\n\nimport react from '@vitejs/plugin-react'\nimport { createServer, type Plugin, type ServerOptions, type ViteDevServer } from 'vite'\n\nimport { loadConfig } from '../../config/load-config.js'\nimport { loadEnv } from '../../config/load-env.js'\nimport type { TheoConfig } from '../../config/schema.js'\nimport { validateProjectStructure } from '../../config/validate-structure.js'\nimport { initCacheEngineFromConfig } from '../../server/cache-bootstrap.js'\nimport { createCronScheduler } from '../../server/cron/cron-runtime-node.js'\nimport { cronScanDirs, listCronFiles } from '../../server/cron/cron-scan.js'\nimport { listJobFiles } from '../../server/jobs/job-scan.js'\nimport { orchestrateDev } from '../../services/index.js'\nimport { theoPluginAsync } from '../../vite-plugin/index.js'\nimport { preflightNodeAndBindings } from '../preflight-node-version.js'\n\nimport { resolveListenPort } from './resolve-listen-port.js'\nimport { configureStorageManagerFromConfig } from './start/bootstrap-stages.js'\nimport { loadCronModules } from './start/cron-bootstrap.js'\nimport { loadJobModules, prepareJobBackend, startJobWorker } from './start/job-bootstrap.js'\n\ninterface DevOptions {\n port?: number\n /** Schedule the crons in dev (`theokit dev --crons`). Off by default (usetheokit/theokit#1017). */\n crons?: boolean\n}\n\n/**\n * The Vite `server` block, as a pure function of the loaded config — the same reasoning\n * `buildSecurityHeaders` is written down with: a setting that reaches Vite only from inside a\n * booted dev server can be asserted only by booting one, and a setting nobody can assert is how a\n * config field ends up existing and doing nothing (#555).\n *\n * Every key here is omitted rather than set to `undefined` when the app said nothing, so Vite's own\n * defaults apply. That matters most for `allowedHosts`, where the falsy value is `[]` — an empty\n * allowlist blocks every host, loopback included, so writing one on silence would turn \"no opinion\"\n * into \"refuse everything\".\n */\nexport function buildDevServerOptions(config: TheoConfig, port: number): ServerOptions {\n return {\n port,\n host: config.host,\n open: config.open,\n strictPort: config.strictPort,\n ...(config.allowedHosts !== undefined ? { allowedHosts: config.allowedHosts } : {}),\n warmup: config.warmup ?? {\n clientFiles: ['./app/**/*.tsx', './app/**/*.ts'],\n },\n }\n}\n\nexport async function startDevServer(cwd: string, options?: DevOptions): Promise<ViteDevServer> {\n // Preflight (FIRST — BEFORE anything that touches native bindings):\n // verifies Node version + native binding ABI match. Emits actionable\n // error referencing `nvm use` + `pnpm rebuild` when the dev server\n // was spawned under the wrong Node (common gotcha with `nohup env ...`\n // stripping the nvm PATH prefix).\n preflightNodeAndBindings(cwd)\n\n // Phase 1 (T1.2) — Load .env files into process.env BEFORE any module\n // reads them. Must run before loadConfig() so theo.config.ts functions\n // referencing process.env.* resolve correctly.\n loadEnv({ cwd, mode: 'development' })\n\n const config = await loadConfig(cwd)\n // #95 — pass config.appDir so the structure gate honors a custom frontend dir (e.g. apps/web).\n validateProjectStructure(cwd, config.appDir)\n\n // #352 — same engine, same config key, so `revalidateTag` behaves identically\n // under `theo dev` and `theo start`. A cache that only exists in production is\n // a cache nobody develops against.\n await initCacheEngineFromConfig(config.cache)\n\n // #1020 — the storage counterpart. `start` applied `config.storage` and `dev` did not, so every\n // `usePostgres(...)` threw \"Database not configured\" in development.\n await configureStorageManagerFromConfig(config.storage)\n\n // #1072 — create the job table before Vite serves a route that enqueues into it. A failure stops\n // the boot here, before any service or port is taken.\n await prepareJobBackend(config)\n\n // Wave 2 (T1.1) — spawn polyglot services BEFORE Vite. Healthcheck gates\n // readiness. Empty `services: {}` → early return (Wave 1 BC preserved).\n const orchestration = await orchestrateDev({\n cwd,\n services: config.services,\n })\n if (!orchestration.allHealthy) {\n await orchestration.stop()\n throw new Error(\n `[services] services failed healthcheck: ${orchestration.unhealthy.join(', ')}. ` +\n `Check that each declared service binds its port and responds 200 on its ` +\n `healthcheck path within 30s.`,\n )\n }\n\n // Phase 7 — legacy fs-mtime sweep removed: SDK's Agent.registry handles\n // LRU + idle eviction natively (configurable via theo.config.ts >\n // agents.registry; lazy-configured on first request).\n\n const port = resolveListenPort(options?.port, process.env, config.port)\n // Narrow the rateLimit union: only the legacy flat shape (windowMs+max)\n // flows into the theoPlugin's RateLimitConfig parameter. The per-route\n // variant is consumed inside the api-middleware via the loaded user\n // config separately.\n const flatRateLimit =\n config.rateLimit && 'windowMs' in config.rateLimit && 'max' in config.rateLimit\n ? config.rateLimit\n : undefined\n // theoPluginAsync auto-chains @theokit/ui + @tailwindcss/vite via\n // top-level Plugin[] return (sync `theoPlugin()` factory's config()\n // hook returning {plugins:[...]} is silently dropped by Vite — see\n // commit history). Spread the result so Vite flattens them.\n let server: ViteDevServer\n try {\n const theoPlugins = await theoPluginAsync({\n root: cwd,\n rateLimit: flatRateLimit,\n ssr: config.ssr,\n // #95 — honor config `serverDir` (default \"server\") so route/action discovery scans it.\n serverDir: config.serverDir,\n // #95 follow-up — honor config `agentsDir` (default \"agents\") for the agent scan/middleware.\n agentsDir: config.agentsDir,\n // #95 follow-up — honor config `appDir` (default \"app\") for the file-based router + SSR/client entry.\n appDir: config.appDir,\n // Wave 2 (T3.1) — wire typed-client plugin when services declared.\n services: config.services,\n // T4.1 (canvas-ecosystem-refactor / ADR D6) — passthrough peer-deps\n // that plugins import dynamically (e.g., mermaid via plugin-canvas).\n viteOptimizeDeps: config.viteOptimizeDeps,\n })\n server = await createServer({\n root: cwd,\n plugins: [react(), ...theoPlugins] as Plugin[],\n server: buildDevServerOptions(config, port),\n logLevel: options?.port === 0 ? 'silent' : undefined,\n })\n\n await server.listen()\n } catch (err) {\n // EC-1 / try-finally pattern: if Vite create/listen fails AFTER services\n // started, stop them so we don't leak child processes.\n await orchestration.stop()\n throw err\n }\n\n // EC-1 fix: attach orchestration.stop() to the underlying HTTP server's\n // close event via Node-native API. We do NOT mutate `server.close`\n // (fragile across Vite upgrades). httpServer is `http.Server | null`.\n server.httpServer?.on('close', () => {\n void orchestration.stop()\n })\n\n await startDevJobWorker(server, cwd, config)\n await startDevCrons(server, cwd, config, options?.crons === true)\n\n return server\n}\n\n/**\n * The job worker `theokit start` runs, in development too (usetheokit/theokit#1010): `ctx.queue`\n * works in dev since #1009, and a queue nothing drains would make every job untestable without a\n * production build. Job files load through Vite, like routes, and the worker stops with the server.\n */\nasync function startDevJobWorker(\n server: ViteDevServer,\n cwd: string,\n config: TheoConfig,\n): Promise<void> {\n const files = listJobFiles(resolve(cwd, config.serverDir, 'jobs'))\n const definitions = await loadJobModules(files, (filePath) => server.ssrLoadModule(filePath))\n const jobs = startJobWorker(config, definitions)\n if (jobs.summary !== undefined) console.log(`\\n ${jobs.summary}`)\n server.httpServer?.on('close', () => {\n void jobs.worker?.stop()\n })\n}\n\n/**\n * Crons in development (usetheokit/theokit#1017). `dev` had no cron code path and said nothing, so\n * a new cron neither fired nor got explained until `build` plus `start`. Scheduling is opt-in\n * (`--crons`): a cron that sends an email or charges a card should not do it on every dev boot\n * unasked. Either way the boot log says what happens to the declared crons. Files load through\n * Vite once at boot, so an edit to a cron applies after a restart. Single process, so no lock.\n */\nasync function startDevCrons(\n server: ViteDevServer,\n cwd: string,\n config: TheoConfig,\n schedule: boolean,\n): Promise<void> {\n const dirs = cronScanDirs(cwd, config.serverDir, config.agentsDir)\n const files = listCronFiles([dirs.crons, dirs.schedules])\n if (files.length === 0) return\n if (!schedule) {\n console.log(\n `\\n Crons: ${String(files.length)} declared, not scheduled in dev. ` +\n 'Run `theokit dev --crons` to schedule them (edits apply after a restart).',\n )\n return\n }\n const definitions = await loadCronModules(files, (filePath) => server.ssrLoadModule(filePath))\n const scheduler = createCronScheduler(definitions)\n scheduler.start()\n console.log(\n `\\n Crons: ${String(definitions.length)} scheduled in dev (--crons); edits apply after a restart.`,\n )\n server.httpServer?.on('close', () => {\n scheduler.stop()\n })\n}\n\nexport async function devCommand(options: DevOptions): Promise<void> {\n try {\n const cwd = process.cwd()\n const server = await startDevServer(cwd, options)\n server.printUrls()\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err)\n console.error(`\\n ✗ ${msg}\\n`)\n process.exit(1)\n }\n}\n"],"mappings":"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","names":[]}
@@ -3,7 +3,7 @@ import './health-route-CYI7z5g3.js';
3
3
  import { IncomingMessage, ServerResponse } from 'node:http';
4
4
  import { P as PluginContext, W as WebOnRequestHook, g as WebPreHandlerHook, h as WebOnResponseHook, i as WebOnErrorHook } from './plugin-types-BUVfUQ0V.js';
5
5
  import { P as PluginRunner } from './plugin-runner-BVMOSxvb.js';
6
- import { J as JobBackend } from './job-backend-BX-PwnZW.js';
6
+ import { J as JobBackend } from './job-backend-BRfDfojf.js';
7
7
  import { S as ServerRouteNode } from './match-DaKsL73w.js';
8
8
  import { L as LoadModule } from './module-loader-DCip7NoL.js';
9
9
  import { C as CsrfMode, D as DisallowedConfig } from './csrf-Dgot9qSM.js';