bunderstack 0.9.1 → 0.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bunderstack",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "description": "Batteries-included backend framework for Bun: CRUD APIs, auth, file storage, realtime, tRPC, email, and validated env from a single Drizzle schema and config object.",
   "keywords": [
     "backend",

package/src/jobs/define.ts

@@ -82,9 +82,10 @@ export type CronInvocation = { scheduledFor: Date }
 export type CronDefinition<
   TSchema extends Record<string, unknown> = Record<string, unknown>,
   TEnvResult = Record<string, unknown>,
+  TSchedule extends string = string,
 > = {
   kind: 'cron'
-  schedule: string
+  schedule: TSchedule
   handler: (
     invocation: CronInvocation,
     ctx: JobContext<TSchema, TEnvResult>,
@@ -97,18 +98,22 @@ export type BackgroundDefinition =
 export type BackgroundDefs = Record<string, BackgroundDefinition>
 
 /** @deprecated Use QueueJobDefinition. */
-export type JobDefinition<TInput, TSchema extends Record<string, unknown> = Record<string, unknown>, TEnvResult = Record<string, unknown>> = QueueJobDefinition<
+export type JobDefinition<
   TInput,
-  TSchema,
-  TEnvResult
->
+  TSchema extends Record<string, unknown> = Record<string, unknown>,
+  TEnvResult = Record<string, unknown>,
+> = QueueJobDefinition<TInput, TSchema, TEnvResult>
 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export type AnyJobDefinition = QueueJobDefinition<any, any, any>
 export type JobsDefs = BackgroundDefs
 
 export type QueueJobKeys<TDefs extends BackgroundDefs> = {
-  [K in keyof TDefs & string]: TDefs[K] extends QueueJobDefinition<any, any, any>
+  [K in keyof TDefs & string]: TDefs[K] extends QueueJobDefinition<
+    any,
+    any,
+    any
+  >
     ? K
     : never
 }[keyof TDefs & string]
@@ -123,11 +128,21 @@ export function validateBackgroundDefs(defs: BackgroundDefs): void {
       parseCron(def.schedule)
       continue
     }
-    if (def.retries !== undefined && (def.retries < 0 || !Number.isInteger(def.retries))) {
-      throw new Error(`[bunderstack] job "${name}": retries must be a non-negative integer`)
+    if (
+      def.retries !== undefined &&
+      (def.retries < 0 || !Number.isInteger(def.retries))
+    ) {
+      throw new Error(
+        `[bunderstack] job "${name}": retries must be a non-negative integer`,
+      )
     }
-    if (def.concurrency !== undefined && (def.concurrency < 1 || !Number.isInteger(def.concurrency))) {
-      throw new Error(`[bunderstack] job "${name}": concurrency must be a positive integer`)
+    if (
+      def.concurrency !== undefined &&
+      (def.concurrency < 1 || !Number.isInteger(def.concurrency))
+    ) {
+      throw new Error(
+        `[bunderstack] job "${name}": concurrency must be a positive integer`,
+      )
     }
     if (def.timeout !== undefined && def.timeout <= 0) {
       throw new Error(`[bunderstack] job "${name}": timeout must be positive`)
@@ -162,9 +177,9 @@ export function createJobsBuilder<
     ): QueueJobDefinition<TInput, TSchema, TEnvResult> {
       return { kind: 'job', ...def }
     },
-    cron(
-      def: Omit<CronDefinition<TSchema, TEnvResult>, 'kind'>,
-    ): CronDefinition<TSchema, TEnvResult> {
+    cron<const TSchedule extends string>(
+      def: Omit<CronDefinition<TSchema, TEnvResult, TSchedule>, 'kind'>,
+    ): CronDefinition<TSchema, TEnvResult, TSchedule> {
       parseCron(def.schedule)
       return { kind: 'cron', ...def }
     },
@@ -187,9 +202,8 @@ export type BunderstackJobsBuilder<
 // `TDef extends { input: ZodType<infer I> }` fails structurally because
 // `input?: ZodType<TInput>` desugars to `ZodType<TInput> | undefined`, which
 // can never satisfy a required-property pattern.
-type JobInputOf<TDef> = TDef extends QueueJobDefinition<infer TInput, any, any>
-  ? TInput
-  : undefined
+type JobInputOf<TDef> =
+  TDef extends QueueJobDefinition<infer TInput, any, any> ? TInput : undefined
 
 /**
  * `app.jobs`: `enqueue` narrowed to declared names + payloads. `Omit`s the

package/src/jobs/local-cron.ts

@@ -1,6 +1,6 @@
 import { cronMatches, parseCron } from './cron'
 
-type Timer = ReturnType<typeof setTimeout>
+type Timer = ReturnType<typeof setTimeout> | number
 
 export type LocalCronDefinition = {
   name: string
@@ -45,7 +45,9 @@ export function startLocalCronScheduler(
     timer = setTimer(() => {
       timer = undefined
       void tick().catch((error: unknown) => {
-        options.onError?.(error instanceof Error ? error : new Error(String(error)))
+        options.onError?.(
+          error instanceof Error ? error : new Error(String(error)),
+        )
       })
     }, delay)
   }