@chaaskit/server 0.1.0

package/dist/queue/providers/memory.js.map

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

package/dist/queue/providers/sqs.js

@@ -0,0 +1,275 @@
+/**
+ * AWS SQS Queue Provider
+ *
+ * Production-ready queue provider using Amazon SQS.
+ * Features:
+ * - Long polling for efficient message retrieval
+ * - Visibility timeout for at-least-once delivery
+ * - Optional dead letter queue support
+ * - Message deduplication (for FIFO queues)
+ *
+ * Requires @aws-sdk/client-sqs to be installed:
+ *   pnpm add @aws-sdk/client-sqs
+ */
+import { SQSClient, SendMessageCommand, ReceiveMessageCommand, DeleteMessageCommand, ChangeMessageVisibilityCommand, GetQueueAttributesCommand, } from '@aws-sdk/client-sqs';
+import { randomUUID } from 'crypto';
+// SQS max delay is 15 minutes (900 seconds)
+const SQS_MAX_DELAY_SECONDS = 900;
+/**
+ * AWS SQS Queue Provider
+ */
+export class SQSQueueProvider {
+    name = 'sqs';
+    client;
+    queueUrl;
+    deadLetterQueueUrl;
+    visibilityTimeout;
+    closed = false;
+    // In-memory tracking for job metadata (SQS doesn't store this)
+    jobMetadata = new Map();
+    constructor(config) {
+        this.client = new SQSClient({
+            region: config.region,
+        });
+        this.queueUrl = config.queueUrl;
+        this.deadLetterQueueUrl = config.deadLetterQueueUrl;
+        this.visibilityTimeout = config.visibilityTimeout ?? 30;
+        console.log(`[SQS] Initialized with queue: ${this.queueUrl}`);
+    }
+    async enqueue(type, payload, options) {
+        if (this.closed) {
+            throw new Error('Queue provider is closed');
+        }
+        const now = new Date();
+        const jobOptions = {
+            maxRetries: options?.maxRetries ?? 3,
+            timeout: options?.timeout ?? 30000,
+            priority: options?.priority ?? 0,
+            deduplicationKey: options?.deduplicationKey,
+        };
+        const jobId = randomUUID();
+        let delaySeconds = 0;
+        let scheduledFor;
+        let status = 'pending';
+        // Handle delay
+        if (options?.scheduledFor) {
+            const delayMs = options.scheduledFor.getTime() - now.getTime();
+            if (delayMs > 0) {
+                // SQS max delay is 15 minutes
+                if (delayMs > SQS_MAX_DELAY_SECONDS * 1000) {
+                    // For longer delays, caller should use the scheduler
+                    console.warn(`[SQS] Delay of ${delayMs}ms exceeds SQS max (${SQS_MAX_DELAY_SECONDS}s). ` +
+                        'Consider using the scheduler for long delays.');
+                    delaySeconds = SQS_MAX_DELAY_SECONDS;
+                }
+                else {
+                    delaySeconds = Math.ceil(delayMs / 1000);
+                }
+                scheduledFor = options.scheduledFor;
+                status = 'scheduled';
+            }
+        }
+        else if (options?.delay) {
+            if (options.delay > SQS_MAX_DELAY_SECONDS * 1000) {
+                console.warn(`[SQS] Delay of ${options.delay}ms exceeds SQS max (${SQS_MAX_DELAY_SECONDS}s). ` +
+                    'Consider using the scheduler for long delays.');
+                delaySeconds = SQS_MAX_DELAY_SECONDS;
+            }
+            else {
+                delaySeconds = Math.ceil(options.delay / 1000);
+            }
+            scheduledFor = new Date(now.getTime() + delaySeconds * 1000);
+            status = delaySeconds > 0 ? 'scheduled' : 'pending';
+        }
+        // Create job metadata
+        const metadata = {
+            id: jobId,
+            type,
+            options: jobOptions,
+            status,
+            attempts: 0,
+            createdAt: now.toISOString(),
+            scheduledFor: scheduledFor?.toISOString(),
+        };
+        // Store metadata locally
+        this.jobMetadata.set(jobId, metadata);
+        // Build message body
+        const messageBody = JSON.stringify({
+            jobId,
+            type,
+            payload,
+            options: jobOptions,
+            createdAt: now.toISOString(),
+            scheduledFor: scheduledFor?.toISOString(),
+        });
+        // Send to SQS
+        const command = new SendMessageCommand({
+            QueueUrl: this.queueUrl,
+            MessageBody: messageBody,
+            DelaySeconds: delaySeconds,
+            MessageAttributes: {
+                JobId: { DataType: 'String', StringValue: jobId },
+                JobType: { DataType: 'String', StringValue: type },
+            },
+            // For FIFO queues, use deduplication key
+            ...(options?.deduplicationKey && {
+                MessageDeduplicationId: options.deduplicationKey,
+                MessageGroupId: type, // Group by job type for ordering
+            }),
+        });
+        await this.client.send(command);
+        const job = {
+            id: jobId,
+            type,
+            payload,
+            options: jobOptions,
+            status,
+            attempts: 0,
+            createdAt: now,
+            scheduledFor,
+        };
+        console.log(`[SQS] Enqueued job ${jobId} (type: ${type}${delaySeconds > 0 ? `, delay: ${delaySeconds}s` : ''})`);
+        return job;
+    }
+    async receive(maxMessages = 1, waitTimeSeconds = 20) {
+        if (this.closed) {
+            return [];
+        }
+        // Long polling - blocks until messages arrive or timeout
+        const command = new ReceiveMessageCommand({
+            QueueUrl: this.queueUrl,
+            MaxNumberOfMessages: Math.min(maxMessages, 10), // SQS max is 10
+            WaitTimeSeconds: Math.min(waitTimeSeconds, 20), // SQS max is 20
+            VisibilityTimeout: this.visibilityTimeout,
+            MessageAttributeNames: ['All'],
+            MessageSystemAttributeNames: ['ApproximateReceiveCount'],
+        });
+        const response = await this.client.send(command);
+        if (!response.Messages || response.Messages.length === 0) {
+            return [];
+        }
+        const jobs = [];
+        for (const message of response.Messages) {
+            try {
+                const job = this.parseMessage(message);
+                if (job) {
+                    jobs.push(job);
+                }
+            }
+            catch (error) {
+                console.error('[SQS] Failed to parse message:', error);
+                // Delete malformed message to prevent infinite retries
+                if (message.ReceiptHandle) {
+                    try {
+                        await this.deleteMessage(message.ReceiptHandle);
+                    }
+                    catch {
+                        // Ignore deletion errors
+                    }
+                }
+            }
+        }
+        return jobs;
+    }
+    async acknowledge(receiptHandle) {
+        await this.deleteMessage(receiptHandle);
+        console.log('[SQS] Acknowledged message');
+    }
+    async fail(receiptHandle, error) {
+        // Make message visible again immediately for retry
+        // The retry delay is handled by SQS's built-in retry mechanism
+        try {
+            const command = new ChangeMessageVisibilityCommand({
+                QueueUrl: this.queueUrl,
+                ReceiptHandle: receiptHandle,
+                VisibilityTimeout: 0, // Make visible immediately
+            });
+            await this.client.send(command);
+            console.log('[SQS] Failed message, returning to queue:', error.message);
+        }
+        catch (sqsError) {
+            // If changing visibility fails, the message will eventually become visible again
+            console.error('[SQS] Failed to change message visibility:', sqsError);
+        }
+    }
+    async getJob(jobId) {
+        // SQS doesn't support fetching by ID, use local metadata
+        const metadata = this.jobMetadata.get(jobId);
+        if (!metadata) {
+            return null;
+        }
+        return {
+            id: metadata.id,
+            type: metadata.type,
+            payload: null, // Payload not stored in metadata
+            options: metadata.options,
+            status: metadata.status,
+            attempts: metadata.attempts,
+            createdAt: new Date(metadata.createdAt),
+            scheduledFor: metadata.scheduledFor ? new Date(metadata.scheduledFor) : undefined,
+        };
+    }
+    async getStats() {
+        try {
+            const command = new GetQueueAttributesCommand({
+                QueueUrl: this.queueUrl,
+                AttributeNames: [
+                    'ApproximateNumberOfMessages',
+                    'ApproximateNumberOfMessagesNotVisible',
+                    'ApproximateNumberOfMessagesDelayed',
+                ],
+            });
+            const response = await this.client.send(command);
+            const attrs = response.Attributes || {};
+            return {
+                pending: parseInt(attrs.ApproximateNumberOfMessages || '0', 10),
+                processing: parseInt(attrs.ApproximateNumberOfMessagesNotVisible || '0', 10),
+                scheduled: parseInt(attrs.ApproximateNumberOfMessagesDelayed || '0', 10),
+                completed: 0, // SQS doesn't track completed
+                failed: 0, // Would need DLQ stats
+                dead: 0,
+            };
+        }
+        catch (error) {
+            console.error('[SQS] Failed to get queue stats:', error);
+            return { pending: 0, processing: 0, completed: 0, failed: 0, dead: 0, scheduled: 0 };
+        }
+    }
+    async close() {
+        this.closed = true;
+        this.client.destroy();
+        console.log('[SQS] Provider closed');
+    }
+    async deleteMessage(receiptHandle) {
+        const command = new DeleteMessageCommand({
+            QueueUrl: this.queueUrl,
+            ReceiptHandle: receiptHandle,
+        });
+        await this.client.send(command);
+    }
+    parseMessage(message) {
+        if (!message.Body || !message.ReceiptHandle) {
+            return null;
+        }
+        const body = JSON.parse(message.Body);
+        const receiveCount = parseInt(message.Attributes?.ApproximateReceiveCount || '1', 10);
+        // Update local metadata
+        const metadata = this.jobMetadata.get(body.jobId);
+        if (metadata) {
+            metadata.attempts = receiveCount;
+            metadata.status = 'processing';
+        }
+        return {
+            id: body.jobId,
+            type: body.type,
+            payload: body.payload,
+            options: body.options,
+            status: 'processing',
+            attempts: receiveCount,
+            createdAt: new Date(body.createdAt),
+            scheduledFor: body.scheduledFor ? new Date(body.scheduledFor) : undefined,
+            receiptHandle: message.ReceiptHandle,
+        };
+    }
+}
+//# sourceMappingURL=sqs.js.map

package/dist/queue/providers/sqs.js.map

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

package/dist/queue/scheduler.js

@@ -0,0 +1,355 @@
+/**
+ * Queue Scheduler
+ *
+ * Database-backed scheduler for delayed and recurring jobs.
+ * - One-time scheduled jobs: stored in ScheduledJob table, enqueued when due
+ * - Recurring jobs: stored in RecurringJob table, enqueued on schedule
+ *
+ * Supports both cron expressions and interval syntax.
+ */
+import { db } from '@chaaskit/db';
+import { CronExpressionParser } from 'cron-parser';
+/**
+ * Parse an interval string like "every 5 minutes" into milliseconds
+ */
+function parseInterval(schedule) {
+    const match = schedule.match(/^every\s+(\d+)\s+(second|minute|hour|day|week)s?$/i);
+    if (!match)
+        return null;
+    const value = parseInt(match[1], 10);
+    const unit = match[2].toLowerCase();
+    const multipliers = {
+        second: 1000,
+        minute: 60 * 1000,
+        hour: 60 * 60 * 1000,
+        day: 24 * 60 * 60 * 1000,
+        week: 7 * 24 * 60 * 60 * 1000,
+    };
+    return value * (multipliers[unit] || 0);
+}
+/**
+ * Calculate the next run time for a schedule
+ */
+function calculateNextRun(schedule, timezone, fromDate) {
+    // Try interval syntax first
+    const intervalMs = parseInterval(schedule);
+    if (intervalMs !== null) {
+        const from = fromDate || new Date();
+        return new Date(from.getTime() + intervalMs);
+    }
+    // Parse as cron expression
+    try {
+        const options = {
+            currentDate: fromDate || new Date(),
+            tz: timezone,
+        };
+        const interval = CronExpressionParser.parse(schedule, options);
+        return interval.next().toDate();
+    }
+    catch (error) {
+        throw new Error(`Invalid schedule format: "${schedule}". Use cron expression (e.g., "0 9 * * *") ` +
+            `or interval (e.g., "every 5 minutes")`);
+    }
+}
+/**
+ * Scheduler for delayed and recurring jobs.
+ */
+export class Scheduler {
+    provider;
+    pollInterval;
+    running = false;
+    pollTimer = null;
+    constructor(options) {
+        this.provider = options.provider;
+        this.pollInterval = options.config.pollInterval ?? 60000;
+    }
+    /**
+     * Start the scheduler.
+     */
+    async start() {
+        if (this.running) {
+            console.warn('[Scheduler] Already running');
+            return;
+        }
+        this.running = true;
+        console.log(`[Scheduler] Starting with poll interval ${this.pollInterval}ms`);
+        // Run immediately on start
+        await this.poll();
+        // Schedule periodic polling
+        this.pollTimer = setInterval(async () => {
+            try {
+                await this.poll();
+            }
+            catch (error) {
+                console.error('[Scheduler] Error during poll:', error);
+            }
+        }, this.pollInterval);
+    }
+    /**
+     * Stop the scheduler.
+     */
+    async stop() {
+        if (!this.running) {
+            return;
+        }
+        console.log('[Scheduler] Stopping...');
+        this.running = false;
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = null;
+        }
+        console.log('[Scheduler] Stopped');
+    }
+    /**
+     * Schedule a one-time job for future execution.
+     */
+    async schedule(type, payload, scheduledFor, options) {
+        console.log(`[Scheduler] Scheduling job ${type} for ${scheduledFor.toISOString()}`);
+        const job = await db.scheduledJob.create({
+            data: {
+                type,
+                payload: JSON.stringify(payload),
+                options: JSON.stringify(options || {}),
+                scheduledFor,
+                status: 'scheduled',
+            },
+        });
+        return job;
+    }
+    /**
+     * Cancel a scheduled job.
+     */
+    async cancelScheduledJob(jobId) {
+        const result = await db.scheduledJob.updateMany({
+            where: {
+                id: jobId,
+                status: 'scheduled',
+            },
+            data: {
+                status: 'cancelled',
+            },
+        });
+        return result.count > 0;
+    }
+    /**
+     * Register or update a recurring job.
+     */
+    async registerRecurring(input) {
+        // Validate schedule by calculating next run
+        const nextRunAt = calculateNextRun(input.schedule, input.timezone || 'UTC');
+        console.log(`[Scheduler] Registering recurring job "${input.name}" with schedule "${input.schedule}", ` +
+            `next run: ${nextRunAt.toISOString()}`);
+        const job = await db.recurringJob.upsert({
+            where: { name: input.name },
+            create: {
+                name: input.name,
+                type: input.type,
+                payload: JSON.stringify(input.payload),
+                options: JSON.stringify(input.options || {}),
+                schedule: input.schedule,
+                timezone: input.timezone || 'UTC',
+                enabled: true,
+                nextRunAt,
+            },
+            update: {
+                type: input.type,
+                payload: JSON.stringify(input.payload),
+                options: JSON.stringify(input.options || {}),
+                schedule: input.schedule,
+                timezone: input.timezone || 'UTC',
+                enabled: true,
+                nextRunAt,
+                lastError: null,
+            },
+        });
+        return job;
+    }
+    /**
+     * Disable a recurring job.
+     */
+    async disableRecurring(name) {
+        const result = await db.recurringJob.updateMany({
+            where: { name },
+            data: { enabled: false },
+        });
+        return result.count > 0;
+    }
+    /**
+     * Enable a recurring job.
+     */
+    async enableRecurring(name) {
+        const job = await db.recurringJob.findUnique({ where: { name } });
+        if (!job)
+            return false;
+        const nextRunAt = calculateNextRun(job.schedule, job.timezone);
+        await db.recurringJob.update({
+            where: { name },
+            data: {
+                enabled: true,
+                nextRunAt,
+                lastError: null,
+            },
+        });
+        return true;
+    }
+    /**
+     * Delete a recurring job.
+     */
+    async deleteRecurring(name) {
+        const result = await db.recurringJob.deleteMany({
+            where: { name },
+        });
+        return result.count > 0;
+    }
+    /**
+     * Get all recurring jobs.
+     */
+    async listRecurring() {
+        return db.recurringJob.findMany({
+            orderBy: { name: 'asc' },
+        });
+    }
+    /**
+     * Poll for due jobs and enqueue them.
+     */
+    async poll() {
+        const now = new Date();
+        // Process one-time scheduled jobs
+        await this.processScheduledJobs(now);
+        // Process recurring jobs
+        await this.processRecurringJobs(now);
+    }
+    /**
+     * Process one-time scheduled jobs that are due.
+     */
+    async processScheduledJobs(now) {
+        // Find jobs that are due
+        const dueJobs = await db.scheduledJob.findMany({
+            where: {
+                status: 'scheduled',
+                scheduledFor: { lte: now },
+            },
+            take: 100, // Process in batches
+        });
+        for (const job of dueJobs) {
+            try {
+                const payload = JSON.parse(job.payload);
+                const options = JSON.parse(job.options);
+                await this.provider.enqueue(job.type, payload, options);
+                await db.scheduledJob.update({
+                    where: { id: job.id },
+                    data: { status: 'enqueued' },
+                });
+                console.log(`[Scheduler] Enqueued scheduled job ${job.id} (type: ${job.type})`);
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                console.error(`[Scheduler] Failed to enqueue scheduled job ${job.id}:`, errorMessage);
+                await db.scheduledJob.update({
+                    where: { id: job.id },
+                    data: {
+                        status: 'scheduled', // Keep it scheduled for retry
+                        error: errorMessage,
+                    },
+                });
+            }
+        }
+    }
+    /**
+     * Process recurring jobs that are due.
+     */
+    async processRecurringJobs(now) {
+        // Find recurring jobs that are due
+        const dueJobs = await db.recurringJob.findMany({
+            where: {
+                enabled: true,
+                nextRunAt: { lte: now },
+            },
+        });
+        for (const job of dueJobs) {
+            try {
+                const payload = JSON.parse(job.payload);
+                const options = JSON.parse(job.options);
+                await this.provider.enqueue(job.type, payload, options);
+                // Calculate next run time
+                const nextRunAt = calculateNextRun(job.schedule, job.timezone, now);
+                await db.recurringJob.update({
+                    where: { id: job.id },
+                    data: {
+                        lastRunAt: now,
+                        nextRunAt,
+                        lastError: null,
+                    },
+                });
+                console.log(`[Scheduler] Enqueued recurring job "${job.name}" (type: ${job.type}), ` +
+                    `next run: ${nextRunAt.toISOString()}`);
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                console.error(`[Scheduler] Failed to enqueue recurring job "${job.name}":`, errorMessage);
+                // Still calculate next run, but store the error
+                let nextRunAt;
+                try {
+                    nextRunAt = calculateNextRun(job.schedule, job.timezone, now);
+                }
+                catch {
+                    // If schedule is invalid, disable the job
+                    await db.recurringJob.update({
+                        where: { id: job.id },
+                        data: {
+                            enabled: false,
+                            lastError: `Invalid schedule: ${errorMessage}`,
+                        },
+                    });
+                    continue;
+                }
+                await db.recurringJob.update({
+                    where: { id: job.id },
+                    data: {
+                        nextRunAt,
+                        lastError: errorMessage,
+                    },
+                });
+            }
+        }
+    }
+}
+// Singleton scheduler instance
+let schedulerInstance = null;
+/**
+ * Get or create the scheduler singleton.
+ */
+export function getScheduler(options) {
+    if (!schedulerInstance && options) {
+        schedulerInstance = new Scheduler(options);
+    }
+    return schedulerInstance;
+}
+/**
+ * Start the scheduler with the given options.
+ */
+export async function startScheduler(options) {
+    if (schedulerInstance) {
+        console.warn('[Scheduler] Scheduler already exists');
+        return schedulerInstance;
+    }
+    schedulerInstance = new Scheduler(options);
+    await schedulerInstance.start();
+    return schedulerInstance;
+}
+/**
+ * Stop the scheduler.
+ */
+export async function stopScheduler() {
+    if (schedulerInstance) {
+        await schedulerInstance.stop();
+        schedulerInstance = null;
+    }
+}
+/**
+ * Reset the scheduler singleton (for testing).
+ */
+export function resetScheduler() {
+    schedulerInstance = null;
+}
+//# sourceMappingURL=scheduler.js.map