@queuebase/core 0.0.1

package/dist/handler.d.ts

@@ -0,0 +1,15 @@
+import type { AnyJobDefinition } from './router.js';
+import { WEBHOOK_HEADERS } from './webhook.js';
+export { WEBHOOK_HEADERS };
+export interface HandlerRequest {
+    body: string;
+    signatureHeader: string | null;
+}
+export interface HandlerResponse {
+    status: number;
+    body: unknown;
+}
+export declare function processJobCallback(router: Record<string, AnyJobDefinition>, request: HandlerRequest, options?: {
+    webhookSecret?: string;
+}): Promise<HandlerResponse>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,EAAmB,eAAe,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,CAAC;AAU3B,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACxC,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC,OAAO,CAAC,eAAe,CAAC,CAuD1B"}

package/dist/handler.js

@@ -0,0 +1,53 @@
+import { verifySignature, WEBHOOK_HEADERS } from './webhook.js';
+export { WEBHOOK_HEADERS };
+export async function processJobCallback(router, request, options) {
+    const webhookSecret = options?.webhookSecret ?? process.env.QUEUEBASE_WEBHOOK_SECRET;
+    if (webhookSecret) {
+        if (!request.signatureHeader) {
+            return {
+                status: 401,
+                body: { success: false, error: 'Missing webhook signature' },
+            };
+        }
+        if (!verifySignature(request.body, request.signatureHeader, webhookSecret)) {
+            return {
+                status: 401,
+                body: { success: false, error: 'Invalid webhook signature' },
+            };
+        }
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(request.body);
+    }
+    catch {
+        return { status: 400, body: { success: false, error: 'Invalid JSON body' } };
+    }
+    const { jobId, name, payload, attempt, maxAttempts } = parsed;
+    const jobDef = router[name];
+    if (!jobDef) {
+        return { status: 404, body: { success: false, error: `Unknown job: ${name}` } };
+    }
+    const parseResult = jobDef.input.safeParse(payload);
+    if (!parseResult.success) {
+        return {
+            status: 400,
+            body: { success: false, error: `Invalid payload: ${parseResult.error.message}` },
+        };
+    }
+    const context = {
+        input: parseResult.data,
+        jobId,
+        attempt,
+        maxAttempts,
+    };
+    try {
+        const output = await jobDef.handler(context);
+        return { status: 200, body: { success: true, output } };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return { status: 500, body: { success: false, error: message } };
+    }
+}
+//# sourceMappingURL=handler.js.map

package/dist/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,CAAC;AAoB3B,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAwC,EACxC,OAAuB,EACvB,OAAoC;IAEpC,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;IAErF,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YAC7B,OAAO;gBACL,MAAM,EAAE,GAAG;gBACX,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,2BAA2B,EAAE;aAC7D,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,EAAE,aAAa,CAAC,EAAE,CAAC;YAC3E,OAAO;gBACL,MAAM,EAAE,GAAG;gBACX,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,2BAA2B,EAAE;aAC7D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,MAA0B,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAuB,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,CAAC;IAC/E,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAE9D,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,IAAI,EAAE,EAAE,EAAE,CAAC;IAClF,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO;YACL,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE;SACjF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAwB;QACnC,KAAK,EAAE,WAAW,CAAC,IAAI;QACvB,KAAK;QACL,OAAO;QACP,WAAW;KACZ,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7C,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACzE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC;IACnE,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { JobStatus, BackoffStrategy, EnqueueOptions, JobDefinition, JobContext, QueuedJob, JobResult, QueuebaseConfig, } from './types.js';
+export { job, type InferJobInput, type InferJobOutput } from './job.js';
+export { createJobRouter, type AnyJobDefinition, type JobRouter, type CallableJob, type CallableJobRouter, } from './router.js';
+export { parseDelay, calculateBackoff, generateJobId, generatePublicId } from './utils.js';
+export { signPayload, verifySignature, WEBHOOK_HEADERS } from './webhook.js';
+export { processJobCallback, type HandlerRequest, type HandlerResponse, } from './handler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,SAAS,EACT,eAAe,EACf,cAAc,EACd,aAAa,EACb,UAAU,EACV,SAAS,EACT,SAAS,EACT,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,GAAG,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAGxE,OAAO,EACL,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG3F,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG7E,OAAO,EACL,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+// Job creation
+export { job } from './job.js';
+// Router
+export { createJobRouter, } from './router.js';
+// Utilities
+export { parseDelay, calculateBackoff, generateJobId, generatePublicId } from './utils.js';
+// Webhook signing
+export { signPayload, verifySignature, WEBHOOK_HEADERS } from './webhook.js';
+// Handler
+export { processJobCallback, } from './handler.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,eAAe;AACf,OAAO,EAAE,GAAG,EAA2C,MAAM,UAAU,CAAC;AAExE,SAAS;AACT,OAAO,EACL,eAAe,GAKhB,MAAM,aAAa,CAAC;AAErB,YAAY;AACZ,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE3F,kBAAkB;AAClB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE7E,UAAU;AACV,OAAO,EACL,kBAAkB,GAGnB,MAAM,cAAc,CAAC"}

package/dist/job.d.ts

@@ -0,0 +1,20 @@
+import type { z } from 'zod';
+import type { EnqueueOptions, JobContext } from './types.js';
+import type { AnyJobDefinition } from './router.js';
+/**
+ * Creates a job definition with typed input and handler
+ */
+export declare function job<TInput, TOutput>(definition: {
+    input: z.ZodType<TInput>;
+    handler: (ctx: JobContext<TInput>) => Promise<TOutput>;
+    defaults?: EnqueueOptions;
+}): AnyJobDefinition;
+/**
+ * Infer the input type from a job definition's Zod schema
+ */
+export type InferJobInput<T extends AnyJobDefinition> = T['input'] extends z.ZodType<infer I> ? I : never;
+/**
+ * Infer the output type from a job definition's handler
+ */
+export type InferJobOutput<T extends AnyJobDefinition> = T['handler'] extends (ctx: JobContext<unknown>) => Promise<infer O> ? O : never;
+//# sourceMappingURL=job.d.ts.map

package/dist/job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../src/job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;GAEG;AACH,wBAAgB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE;IAC/C,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,OAAO,EAAE,CAAC,GAAG,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B,GAAG,gBAAgB,CAInB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,gBAAgB,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GACzF,CAAC,GACD,KAAK,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,gBAAgB,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAC5E,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,KACrB,OAAO,CAAC,MAAM,CAAC,CAAC,GACjB,CAAC,GACD,KAAK,CAAC"}

package/dist/job.js

@@ -0,0 +1,9 @@
+/**
+ * Creates a job definition with typed input and handler
+ */
+export function job(definition) {
+    // Cast to AnyJobDefinition for storage in the router
+    // The actual types are preserved through the generic inference
+    return definition;
+}
+//# sourceMappingURL=job.js.map

package/dist/job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.js","sourceRoot":"","sources":["../src/job.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,UAAU,GAAG,CAAkB,UAIpC;IACC,qDAAqD;IACrD,+DAA+D;IAC/D,OAAO,UAAyC,CAAC;AACnD,CAAC"}

package/dist/router.d.ts

@@ -0,0 +1,45 @@
+import type { z } from 'zod';
+import type { EnqueueOptions, JobContext } from './types.js';
+/**
+ * A job definition - the basic building block
+ */
+export interface AnyJobDefinition {
+    input: z.ZodTypeAny;
+    handler: (ctx: JobContext<unknown>) => Promise<unknown>;
+    defaults?: EnqueueOptions;
+}
+/**
+ * A collection of job definitions
+ */
+export type JobRouter = Record<string, AnyJobDefinition>;
+/**
+ * Creates a typed job router from job definitions
+ */
+export declare function createJobRouter<T extends Record<string, AnyJobDefinition>>(jobs: T): T;
+/**
+ * Callable job that can be enqueued
+ */
+export interface CallableJob<TInput, TOutput> {
+    /** Enqueue this job for execution */
+    enqueue: (input: TInput, options?: EnqueueOptions) => Promise<{
+        jobId: string;
+    }>;
+    /** The underlying job definition */
+    _def: AnyJobDefinition;
+}
+/**
+ * Extract input type from a job definition
+ */
+type ExtractJobInput<T extends AnyJobDefinition> = T['input'] extends z.ZodType<infer I> ? I : never;
+/**
+ * Extract output type from a job definition (from handler return type)
+ */
+type ExtractJobOutput<T extends AnyJobDefinition> = T['handler'] extends (ctx: JobContext<unknown>) => Promise<infer O> ? O : never;
+/**
+ * Transform a job router into callable jobs
+ */
+export type CallableJobRouter<T extends Record<string, AnyJobDefinition>> = {
+    [K in keyof T]: CallableJob<ExtractJobInput<T[K]>, ExtractJobOutput<T[K]>>;
+};
+export {};
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,CAAC,CAAC,UAAU,CAAC;IACpB,OAAO,EAAE,CAAC,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAEzD;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAEtF;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,MAAM,EAAE,OAAO;IAC1C,qCAAqC;IACrC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjF,oCAAoC;IACpC,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED;;GAEG;AACH,KAAK,eAAe,CAAC,CAAC,SAAS,gBAAgB,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GACpF,CAAC,GACD,KAAK,CAAC;AAEV;;GAEG;AACH,KAAK,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CACvE,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,KACrB,OAAO,CAAC,MAAM,CAAC,CAAC,GACjB,CAAC,GACD,KAAK,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,IAAI;KACzE,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC3E,CAAC"}

package/dist/router.js

@@ -0,0 +1,7 @@
+/**
+ * Creates a typed job router from job definitions
+ */
+export function createJobRouter(jobs) {
+    return jobs;
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAiBA;;GAEG;AACH,MAAM,UAAU,eAAe,CAA6C,IAAO;IACjF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,91 @@
+import type { z } from 'zod';
+/**
+ * Status of a job in the queue
+ */
+export type JobStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+/**
+ * Backoff strategy for retries
+ */
+export type BackoffStrategy = 'linear' | 'exponential';
+/**
+ * Options for enqueueing a job
+ */
+export interface EnqueueOptions {
+    /** Delay before running the job (e.g., '5m', '1h', or milliseconds) */
+    delay?: string | number;
+    /** Number of retry attempts on failure */
+    retries?: number;
+    /** Backoff strategy for retries */
+    backoff?: BackoffStrategy;
+    /** Initial delay between retries in ms (default: 1000) */
+    backoffDelay?: number;
+    /** Maximum concurrent jobs of this type (per worker) */
+    concurrency?: number;
+}
+/**
+ * A job definition with typed input/output
+ */
+export interface JobDefinition<TInput = unknown, TOutput = unknown> {
+    /** Zod schema for validating job input */
+    input: z.ZodType<TInput>;
+    /** The handler function that executes the job */
+    handler: (ctx: JobContext<TInput>) => Promise<TOutput>;
+    /** Default options for this job */
+    defaults?: EnqueueOptions;
+}
+/**
+ * Context passed to job handlers
+ */
+export interface JobContext<TInput = unknown> {
+    /** The validated input data */
+    input: TInput;
+    /** Unique ID for this job execution */
+    jobId: string;
+    /** Current attempt number (1-indexed) */
+    attempt: number;
+    /** Maximum attempts allowed */
+    maxAttempts: number;
+}
+/**
+ * Internal representation of a queued job
+ */
+export interface QueuedJob {
+    id: number;
+    publicId: string;
+    name: string;
+    payload: unknown;
+    status: JobStatus;
+    attempt: number;
+    maxAttempts: number;
+    runAt: Date;
+    createdAt: Date;
+    startedAt: Date | null;
+    completedAt: Date | null;
+    result: unknown | null;
+    error: string | null;
+    backoffStrategy: BackoffStrategy;
+    backoffDelay: number;
+}
+/**
+ * Result of a job execution
+ */
+export interface JobResult<TOutput = unknown> {
+    success: boolean;
+    output?: TOutput;
+    error?: string;
+    duration: number;
+}
+/**
+ * Configuration for queuebase
+ */
+export interface QueuebaseConfig {
+    /** Directory containing job definitions */
+    jobsDir: string;
+    /** URL where the queuebase API can callback to execute jobs */
+    callbackUrl?: string;
+    /** API key for production (from queuebase.io) */
+    apiKey?: string;
+    /** Override the API endpoint (auto-detected by NODE_ENV) */
+    apiUrl?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAErF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAChE,0CAA0C;IAC1C,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,iDAAiD;IACjD,OAAO,EAAE,CAAC,GAAG,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,mCAAmC;IACnC,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,MAAM,GAAG,OAAO;IAC1C,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,IAAI,CAAC;IACZ,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,eAAe,EAAE,eAAe,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,OAAO,GAAG,OAAO;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Parse a delay string into milliseconds
+ * Supports: '5s', '5m', '5h', '5d' or raw milliseconds
+ */
+export declare function parseDelay(delay: string | number): number;
+/**
+ * Calculate the next retry delay based on backoff strategy
+ */
+export declare function calculateBackoff(attempt: number, strategy: 'linear' | 'exponential', baseDelay: number): number;
+/**
+ * Generate a unique job ID
+ * @deprecated Use `generatePublicId()` instead
+ */
+export declare function generateJobId(): string;
+/**
+ * Generate a Stripe-style public ID for external use
+ * @param prefix - Prefix for the ID (default: 'job')
+ * @returns A string like `job_V1StGXR8kZ5jx...`
+ */
+export declare function generatePublicId(prefix?: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CA6BzD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,GAAG,aAAa,EAClC,SAAS,EAAE,MAAM,GAChB,MAAM,CASR;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAItC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,SAAQ,GAAG,MAAM,CAEvD"}

package/dist/utils.js

@@ -0,0 +1,63 @@
+import { nanoid } from 'nanoid';
+/**
+ * Parse a delay string into milliseconds
+ * Supports: '5s', '5m', '5h', '5d' or raw milliseconds
+ */
+export function parseDelay(delay) {
+    if (typeof delay === 'number') {
+        return delay;
+    }
+    const match = delay.match(/^(\d+)(s|m|h|d)$/);
+    if (!match) {
+        const num = Number.parseInt(delay, 10);
+        if (Number.isNaN(num)) {
+            throw new Error(`Invalid delay format: ${delay}`);
+        }
+        return num;
+    }
+    const [, value, unit] = match;
+    const num = Number.parseInt(value, 10);
+    switch (unit) {
+        case 's':
+            return num * 1000;
+        case 'm':
+            return num * 60 * 1000;
+        case 'h':
+            return num * 60 * 60 * 1000;
+        case 'd':
+            return num * 24 * 60 * 60 * 1000;
+        default:
+            throw new Error(`Invalid delay unit: ${unit}`);
+    }
+}
+/**
+ * Calculate the next retry delay based on backoff strategy
+ */
+export function calculateBackoff(attempt, strategy, baseDelay) {
+    switch (strategy) {
+        case 'linear':
+            return baseDelay * attempt;
+        case 'exponential':
+            return baseDelay * 2 ** (attempt - 1);
+        default:
+            return baseDelay;
+    }
+}
+/**
+ * Generate a unique job ID
+ * @deprecated Use `generatePublicId()` instead
+ */
+export function generateJobId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 10);
+    return `job_${timestamp}_${random}`;
+}
+/**
+ * Generate a Stripe-style public ID for external use
+ * @param prefix - Prefix for the ID (default: 'job')
+ * @returns A string like `job_V1StGXR8kZ5jx...`
+ */
+export function generatePublicId(prefix = 'job') {
+    return `${prefix}_${nanoid(21)}`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACvC,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;IAC9B,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAM,EAAE,EAAE,CAAC,CAAC;IAExC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,GAAG;YACN,OAAO,GAAG,GAAG,IAAI,CAAC;QACpB,KAAK,GAAG;YACN,OAAO,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC;QACzB,KAAK,GAAG;YACN,OAAO,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC9B,KAAK,GAAG;YACN,OAAO,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACnC;YACE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,QAAkC,EAClC,SAAiB;IAEjB,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,SAAS,GAAG,OAAO,CAAC;QAC7B,KAAK,aAAa;YAChB,OAAO,SAAS,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;QACxC;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3D,OAAO,OAAO,SAAS,IAAI,MAAM,EAAE,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAM,GAAG,KAAK;IAC7C,OAAO,GAAG,MAAM,IAAI,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;AACnC,CAAC"}

package/dist/utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=utils.test.d.ts.map

package/dist/utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.test.d.ts","sourceRoot":"","sources":["../src/utils.test.ts"],"names":[],"mappings":""}

package/dist/utils.test.js

@@ -0,0 +1,75 @@
+import { describe, expect, it } from 'vitest';
+import { calculateBackoff, generateJobId, generatePublicId, parseDelay } from './utils.js';
+describe('parseDelay', () => {
+    it('should parse seconds', () => {
+        expect(parseDelay('5s')).toBe(5000);
+        expect(parseDelay('30s')).toBe(30000);
+    });
+    it('should parse minutes', () => {
+        expect(parseDelay('5m')).toBe(300000);
+        expect(parseDelay('1m')).toBe(60000);
+    });
+    it('should parse hours', () => {
+        expect(parseDelay('1h')).toBe(3600000);
+        expect(parseDelay('2h')).toBe(7200000);
+    });
+    it('should parse days', () => {
+        expect(parseDelay('1d')).toBe(86400000);
+    });
+    it('should handle raw milliseconds as number', () => {
+        expect(parseDelay(5000)).toBe(5000);
+    });
+    it('should handle raw milliseconds as string', () => {
+        expect(parseDelay('5000')).toBe(5000);
+    });
+    it('should throw on invalid format', () => {
+        expect(() => parseDelay('invalid')).toThrow('Invalid delay format');
+    });
+});
+describe('calculateBackoff', () => {
+    it('should calculate linear backoff', () => {
+        expect(calculateBackoff(1, 'linear', 1000)).toBe(1000);
+        expect(calculateBackoff(2, 'linear', 1000)).toBe(2000);
+        expect(calculateBackoff(3, 'linear', 1000)).toBe(3000);
+    });
+    it('should calculate exponential backoff', () => {
+        expect(calculateBackoff(1, 'exponential', 1000)).toBe(1000);
+        expect(calculateBackoff(2, 'exponential', 1000)).toBe(2000);
+        expect(calculateBackoff(3, 'exponential', 1000)).toBe(4000);
+        expect(calculateBackoff(4, 'exponential', 1000)).toBe(8000);
+    });
+});
+describe('generateJobId', () => {
+    it('should generate unique IDs', () => {
+        const id1 = generateJobId();
+        const id2 = generateJobId();
+        expect(id1).not.toBe(id2);
+    });
+    it('should start with job_ prefix', () => {
+        const id = generateJobId();
+        expect(id.startsWith('job_')).toBe(true);
+    });
+});
+describe('generatePublicId', () => {
+    it('should generate unique IDs', () => {
+        const id1 = generatePublicId();
+        const id2 = generatePublicId();
+        expect(id1).not.toBe(id2);
+    });
+    it('should use default job_ prefix', () => {
+        const id = generatePublicId();
+        expect(id.startsWith('job_')).toBe(true);
+    });
+    it('should use custom prefix', () => {
+        const id = generatePublicId('proj');
+        expect(id.startsWith('proj_')).toBe(true);
+    });
+    it('should have consistent length', () => {
+        const id1 = generatePublicId();
+        const id2 = generatePublicId();
+        expect(id1.length).toBe(id2.length);
+        // prefix (3) + underscore (1) + nanoid (21) = 25
+        expect(id1.length).toBe(25);
+    });
+});
+//# sourceMappingURL=utils.test.js.map

package/dist/utils.test.js.map

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

package/dist/webhook.d.ts

@@ -0,0 +1,17 @@
+export declare const WEBHOOK_HEADERS: {
+    readonly SIGNATURE: "X-Queuebase-Signature";
+};
+/**
+ * Sign a webhook payload using HMAC-SHA256.
+ * Returns a signature string in the format `t=<timestamp>,v1=<hmac>`.
+ */
+export declare function signPayload(payload: string, secret: string): {
+    signature: string;
+    timestamp: number;
+};
+/**
+ * Verify a webhook signature against a payload.
+ * Uses timing-safe comparison and enforces a timestamp tolerance for replay protection.
+ */
+export declare function verifySignature(payload: string, signature: string, secret: string, toleranceSeconds?: number): boolean;
+//# sourceMappingURL=webhook.d.ts.map

package/dist/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../src/webhook.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe;;CAElB,CAAC;AAIX;;;GAGG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAQ1C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,gBAAgB,SAA4B,GAC3C,OAAO,CAmCT"}

package/dist/webhook.js

@@ -0,0 +1,51 @@
+import { createHmac, timingSafeEqual } from 'node:crypto';
+export const WEBHOOK_HEADERS = {
+    SIGNATURE: 'X-Queuebase-Signature',
+};
+const DEFAULT_TOLERANCE_SECONDS = 5 * 60; // 5 minutes
+/**
+ * Sign a webhook payload using HMAC-SHA256.
+ * Returns a signature string in the format `t=<timestamp>,v1=<hmac>`.
+ */
+export function signPayload(payload, secret) {
+    const timestamp = Math.floor(Date.now() / 1000);
+    const signedContent = `${timestamp}.${payload}`;
+    const hmac = createHmac('sha256', secret).update(signedContent).digest('hex');
+    return {
+        signature: `t=${timestamp},v1=${hmac}`,
+        timestamp,
+    };
+}
+/**
+ * Verify a webhook signature against a payload.
+ * Uses timing-safe comparison and enforces a timestamp tolerance for replay protection.
+ */
+export function verifySignature(payload, signature, secret, toleranceSeconds = DEFAULT_TOLERANCE_SECONDS) {
+    const parts = signature.split(',');
+    const tPart = parts.find((p) => p.startsWith('t='));
+    const v1Part = parts.find((p) => p.startsWith('v1='));
+    if (!tPart || !v1Part) {
+        return false;
+    }
+    const timestamp = Number.parseInt(tPart.slice(2), 10);
+    const receivedHmac = v1Part.slice(3);
+    if (Number.isNaN(timestamp)) {
+        return false;
+    }
+    // Check timestamp tolerance for replay protection
+    const now = Math.floor(Date.now() / 1000);
+    if (Math.abs(now - timestamp) > toleranceSeconds) {
+        return false;
+    }
+    // Recompute the expected HMAC
+    const signedContent = `${timestamp}.${payload}`;
+    const expectedHmac = createHmac('sha256', secret).update(signedContent).digest('hex');
+    // Timing-safe comparison
+    const expected = Buffer.from(expectedHmac, 'hex');
+    const received = Buffer.from(receivedHmac, 'hex');
+    if (expected.length !== received.length) {
+        return false;
+    }
+    return timingSafeEqual(expected, received);
+}
+//# sourceMappingURL=webhook.js.map

package/dist/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../src/webhook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,SAAS,EAAE,uBAAuB;CAC1B,CAAC;AAEX,MAAM,yBAAyB,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,YAAY;AAEtD;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,OAAe,EACf,MAAc;IAEd,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,GAAG,SAAS,IAAI,OAAO,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9E,OAAO;QACL,SAAS,EAAE,KAAK,SAAS,OAAO,IAAI,EAAE;QACtC,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,SAAiB,EACjB,MAAc,EACd,gBAAgB,GAAG,yBAAyB;IAE5C,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAEtD,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAErC,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,kDAAkD;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1C,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,SAAS,CAAC,GAAG,gBAAgB,EAAE,CAAC;QACjD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8BAA8B;IAC9B,MAAM,aAAa,GAAG,GAAG,SAAS,IAAI,OAAO,EAAE,CAAC;IAChD,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEtF,yBAAyB;IACzB,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAElD,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC"}

package/dist/webhook.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=webhook.test.d.ts.map

package/dist/webhook.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.test.d.ts","sourceRoot":"","sources":["../src/webhook.test.ts"],"names":[],"mappings":""}

package/dist/webhook.test.js

@@ -0,0 +1,47 @@
+import { describe, expect, it, vi } from 'vitest';
+import { signPayload, verifySignature } from './webhook.js';
+const TEST_SECRET = 'qb_whsec_test_secret_key';
+describe('webhook signing', () => {
+    it('should sign and verify a payload successfully', () => {
+        const payload = JSON.stringify({ jobId: 'job_123', name: 'sendEmail' });
+        const { signature } = signPayload(payload, TEST_SECRET);
+        expect(signature).toMatch(/^t=\d+,v1=[a-f0-9]{64}$/);
+        expect(verifySignature(payload, signature, TEST_SECRET)).toBe(true);
+    });
+    it('should reject a tampered payload', () => {
+        const payload = JSON.stringify({ jobId: 'job_123' });
+        const { signature } = signPayload(payload, TEST_SECRET);
+        const tampered = JSON.stringify({ jobId: 'job_456' });
+        expect(verifySignature(tampered, signature, TEST_SECRET)).toBe(false);
+    });
+    it('should reject a wrong secret', () => {
+        const payload = JSON.stringify({ jobId: 'job_123' });
+        const { signature } = signPayload(payload, TEST_SECRET);
+        expect(verifySignature(payload, signature, 'wrong_secret')).toBe(false);
+    });
+    it('should reject an invalid signature format', () => {
+        const payload = JSON.stringify({ jobId: 'job_123' });
+        expect(verifySignature(payload, 'invalid', TEST_SECRET)).toBe(false);
+        expect(verifySignature(payload, 't=abc,v1=def', TEST_SECRET)).toBe(false);
+        expect(verifySignature(payload, 'v1=abc', TEST_SECRET)).toBe(false);
+    });
+    it('should reject an expired timestamp', () => {
+        const payload = JSON.stringify({ jobId: 'job_123' });
+        const { signature } = signPayload(payload, TEST_SECRET);
+        // Move time forward 10 minutes
+        vi.useFakeTimers();
+        vi.setSystemTime(Date.now() + 10 * 60 * 1000);
+        expect(verifySignature(payload, signature, TEST_SECRET)).toBe(false);
+        vi.useRealTimers();
+    });
+    it('should accept within custom tolerance', () => {
+        const payload = JSON.stringify({ jobId: 'job_123' });
+        const { signature } = signPayload(payload, TEST_SECRET);
+        // Move time forward 2 minutes — within 10-minute tolerance
+        vi.useFakeTimers();
+        vi.setSystemTime(Date.now() + 2 * 60 * 1000);
+        expect(verifySignature(payload, signature, TEST_SECRET, 600)).toBe(true);
+        vi.useRealTimers();
+    });
+});
+//# sourceMappingURL=webhook.test.js.map

package/dist/webhook.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.test.js","sourceRoot":"","sources":["../src/webhook.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE5D,MAAM,WAAW,GAAG,0BAA0B,CAAC;AAE/C,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACxE,MAAM,EAAE,SAAS,EAAE,GAAG,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAExD,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;QACrD,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACrD,MAAM,EAAE,SAAS,EAAE,GAAG,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAExD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACrD,MAAM,EAAE,SAAS,EAAE,GAAG,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAExD,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAErD,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrE,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1E,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACrD,MAAM,EAAE,SAAS,EAAE,GAAG,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAExD,+BAA+B;QAC/B,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAE9C,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAErE,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACrD,MAAM,EAAE,SAAS,EAAE,GAAG,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAExD,2DAA2D;QAC3D,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAE7C,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEzE,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@queuebase/core",
+  "version": "0.0.1",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "nanoid": "^5.0.9",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.9",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8",
+    "@queuebase/tsconfig": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "tsc -b --watch",
+    "clean": "rm -rf dist .turbo *.tsbuildinfo",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome lint ./src",
+    "lint:fix": "biome lint --write ./src",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}