@stacksjs/actions 0.70.88 → 0.70.91

package/dist/queue/flush.js

@@ -0,0 +1,49 @@
+import process from "node:process";
+import { log } from "@stacksjs/logging";
+import { FailedJob } from "@stacksjs/orm";
+const options = parseArgs(), queueName = options.queue, force = options.force === "true";
+try {
+  if (!force) {
+    log.warn("This will permanently delete all failed jobs. Use --force to confirm.");
+    process.exit(1);
+  }
+  let deletedCount = 0;
+  if (queueName) {
+    log.info(`Flushing all failed jobs from queue "${queueName}"...`);
+    const failedJobs = await FailedJob.where("queue", queueName).get();
+    deletedCount = failedJobs.length;
+    for (const job of failedJobs)
+      await job.delete();
+  } else {
+    log.info("Flushing all failed jobs from all queues...");
+    const failedJobs = await FailedJob.all();
+    deletedCount = failedJobs.length;
+    for (const job of failedJobs)
+      await job.delete();
+  }
+  log.success(`Flushed ${deletedCount} failed job(s)`);
+  process.exit(0);
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  if (/no such table:\s*(?:jobs|failed_jobs)\b/i.test(message)) {
+    process.stdout.write(`Queue tables are not set up yet.
+`);
+    process.stdout.write("Run `buddy queue:table` to create the migrations, then `buddy migrate` to apply them.\n");
+    process.exit(0);
+  }
+  log.error("Failed to flush failed jobs", error);
+  process.exit(1);
+}
+function parseArgs() {
+  const args = {};
+  process.argv.forEach((arg) => {
+    if (arg.startsWith("--")) {
+      const [key, value] = arg.slice(2).split("=");
+      if (key && value)
+        args[key] = value;
+      else if (key)
+        args[key] = "true";
+    }
+  });
+  return args;
+}

package/dist/queue/inspect.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/queue/inspect.js

@@ -0,0 +1,154 @@
+import process from "node:process";
+import { log } from "@stacksjs/logging";
+import { Job, FailedJob } from "@stacksjs/orm";
+const options = parseArgs(), jobId = options.id, failedFlag = options.failed === "true";
+try {
+  if (!jobId) {
+    log.error("Please provide a job ID");
+    log.info("Usage: buddy queue:inspect --id=<jobId> [--failed]");
+    process.exit(1);
+  }
+  const id = Number.parseInt(jobId, 10);
+  if (Number.isNaN(id)) {
+    log.error("Invalid job ID provided");
+    process.exit(1);
+  }
+  if (failedFlag) {
+    const failedResult = await FailedJob.find(id);
+    if (!failedResult) {
+      log.error(`Failed job with ID ${id} not found`);
+      process.exit(1);
+    }
+    const job = failedResult;
+    console.log(`
+\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510`);
+    console.log("\u2502                    Failed Job Details                          \u2502");
+    console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");
+    console.log(`\u2502 ID:         ${String(job.id).padEnd(52)} \u2502`);
+    console.log(`\u2502 Queue:      ${(job.queue || "default").padEnd(52)} \u2502`);
+    console.log(`\u2502 Connection: ${(job.connection || "database").padEnd(52)} \u2502`);
+    console.log(`\u2502 Failed At:  ${(job.failed_at || "N/A").padEnd(52)} \u2502`);
+    console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");
+    console.log("\u2502 Exception:                                                     \u2502");
+    console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");
+    const exception = job.exception || "Unknown error", lines = exception.match(/.{1,62}/g) || [exception];
+    for (const line of lines.slice(0, 20))
+      console.log(`\u2502 ${line.padEnd(62)} \u2502`);
+    if (lines.length > 20)
+      console.log(`\u2502 ... (${lines.length - 20} more lines)`.padEnd(64) + " \u2502");
+    console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");
+    console.log("\u2502 Payload:                                                       \u2502");
+    console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");
+    if (job.payload)
+      try {
+        const payload = JSON.parse(job.payload);
+        console.log(`\u2502 Name:       ${payload.name.padEnd(52)} \u2502`);
+        console.log(`\u2502 Path:       ${payload.path.padEnd(52)} \u2502`);
+        console.log(`\u2502 Max Tries:  ${String(payload.maxTries).padEnd(52)} \u2502`);
+        console.log("\u2502 Parameters:                                                    \u2502");
+        const paramLines = JSON.stringify(payload.params, null, 2).split(`
+`);
+        for (const line of paramLines.slice(0, 15))
+          console.log(`\u2502   ${line.substring(0, 60).padEnd(60)} \u2502`);
+        if (paramLines.length > 15)
+          console.log(`\u2502   ... (${paramLines.length - 15} more lines)`.padEnd(64) + " \u2502");
+      } catch {
+        console.log(`\u2502 Raw: ${job.payload.substring(0, 58).padEnd(58)} \u2502`);
+      }
+    else
+      console.log("\u2502 (No payload)                                                   \u2502");
+    console.log("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");
+    console.log(`
+Actions:`);
+    console.log(`  Retry this job: buddy queue:retry --id=${id}`);
+    console.log(`  Delete this job: buddy queue:flush --id=${id}`);
+  } else {
+    const jobResult = await Job.find(id);
+    if (!jobResult) {
+      log.error(`Job with ID ${id} not found`);
+      log.info("Tip: Use --failed flag to inspect failed jobs");
+      process.exit(1);
+    }
+    const job = jobResult, now = Math.floor(Date.now() / 1000);
+    let status = "Pending";
+    if (job.reserved_at)
+      status = "Processing";
+    else if (job.available_at && job.available_at > now)
+      status = "Delayed";
+    console.log(`
+\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510`);
+    console.log("\u2502                       Job Details                              \u2502");
+    console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");
+    console.log(`\u2502 ID:           ${String(job.id).padEnd(50)} \u2502`);
+    console.log(`\u2502 Queue:        ${(job.queue || "default").padEnd(50)} \u2502`);
+    console.log(`\u2502 Status:       ${status.padEnd(50)} \u2502`);
+    console.log(`\u2502 Attempts:     ${String(job.attempts || 0).padEnd(50)} \u2502`);
+    console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");
+    if (job.available_at) {
+      const availableDate = new Date(job.available_at * 1000);
+      console.log(`\u2502 Available At: ${availableDate.toISOString().padEnd(50)} \u2502`);
+    }
+    if (job.reserved_at) {
+      const reservedDate = new Date(job.reserved_at * 1000);
+      console.log(`\u2502 Reserved At:  ${reservedDate.toISOString().padEnd(50)} \u2502`);
+    }
+    if (job.created_at)
+      console.log(`\u2502 Created At:   ${String(job.created_at).padEnd(50)} \u2502`);
+    console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");
+    console.log("\u2502 Payload:                                                       \u2502");
+    console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");
+    if (job.payload)
+      try {
+        const payload = JSON.parse(job.payload);
+        console.log(`\u2502 Name:       ${payload.name.padEnd(52)} \u2502`);
+        console.log(`\u2502 Path:       ${payload.path.padEnd(52)} \u2502`);
+        console.log(`\u2502 Max Tries:  ${String(payload.maxTries).padEnd(52)} \u2502`);
+        console.log(`\u2502 Timeout:    ${String(payload.timeOut || "N/A").padEnd(52)} \u2502`);
+        console.log("\u2502 Parameters:                                                    \u2502");
+        const paramLines = JSON.stringify(payload.params, null, 2).split(`
+`);
+        for (const line of paramLines.slice(0, 15))
+          console.log(`\u2502   ${line.substring(0, 60).padEnd(60)} \u2502`);
+        if (paramLines.length > 15)
+          console.log(`\u2502   ... (${paramLines.length - 15} more lines)`.padEnd(64) + " \u2502");
+        if (payload.classPayload)
+          try {
+            const classConfig = JSON.parse(payload.classPayload);
+            console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");
+            console.log("\u2502 Job Configuration:                                             \u2502");
+            console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");
+            console.log(`\u2502 Tries:      ${String(classConfig.tries || 3).padEnd(52)} \u2502`);
+            console.log(`\u2502 Timeout:    ${String(classConfig.timeout || 60).padEnd(52)} \u2502`);
+            if (classConfig.backoff)
+              console.log(`\u2502 Backoff:    ${String(JSON.stringify(classConfig.backoff)).substring(0, 52).padEnd(52)} \u2502`);
+          } catch {}
+      } catch {
+        console.log(`\u2502 Raw: ${job.payload.substring(0, 58).padEnd(58)} \u2502`);
+      }
+    else
+      console.log("\u2502 (No payload)                                                   \u2502");
+    console.log("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");
+    if (status === "Delayed" && job.available_at) {
+      const waitTime = job.available_at - now;
+      console.log(`
+This job will be available in ${waitTime} second(s)`);
+    }
+  }
+  process.exit(0);
+} catch (error) {
+  log.error("Failed to inspect job", error);
+  process.exit(1);
+}
+function parseArgs() {
+  const args = {};
+  process.argv.forEach((arg) => {
+    if (arg.startsWith("--")) {
+      const [key, value] = arg.slice(2).split("=");
+      if (key && value)
+        args[key] = value;
+      else if (key)
+        args[key] = "true";
+    }
+  });
+  return args;
+}

package/dist/queue/list.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/queue/list.js

@@ -0,0 +1,69 @@
+import process from "node:process";
+import { log } from "@stacksjs/logging";
+import { Job } from "@stacksjs/orm";
+const options = parseArgs(), queueName = options.queue, statusFilter = options.status, limit = options.limit ? Number.parseInt(options.limit, 10) : 50;
+try {
+  log.info(`Fetching queued jobs...
+`);
+  let jobs = queueName ? await Job.where("queue", queueName).get() : await Job.all();
+  const nowSec = Math.floor(Date.now() / 1000);
+  if (statusFilter === "pending")
+    jobs = jobs.filter((j) => !j.reserved_at && (j.available_at ?? 0) <= nowSec);
+  else if (statusFilter === "reserved")
+    jobs = jobs.filter((j) => Boolean(j.reserved_at));
+  else if (statusFilter === "delayed")
+    jobs = jobs.filter((j) => !j.reserved_at && (j.available_at ?? 0) > nowSec);
+  if (Number.isFinite(limit) && limit > 0)
+    jobs = jobs.slice(0, limit);
+  if (jobs.length === 0) {
+    console.log("\u2713 No queued jobs found");
+    process.exit(0);
+  }
+  console.log("\u250C\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
+  console.log("\u2502 ID  \u2502 Queue              \u2502 Job                              \u2502 Attempts \u2502 Status   \u2502 Available At        \u2502");
+  console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");
+  for (const j of jobs) {
+    const jobAny = j, id = String(jobAny.id ?? "").padEnd(3), queue = String(jobAny.queue ?? "default").substring(0, 18).padEnd(18), jobName = extractJobName(jobAny.payload).substring(0, 32).padEnd(32), attempts = String(jobAny.attempts ?? 0).padEnd(8), status = (jobAny.reserved_at ? "reserved" : (jobAny.available_at ?? 0) > nowSec ? "delayed" : "pending").padEnd(8), avail = formatUnixTime(jobAny.available_at).padEnd(19);
+    console.log(`\u2502 ${id} \u2502 ${queue} \u2502 ${jobName} \u2502 ${attempts} \u2502 ${status} \u2502 ${avail} \u2502`);
+  }
+  console.log("\u2514\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");
+  console.log(`
+Showing ${jobs.length} job(s)${queueName ? ` on queue '${queueName}'` : ""}${statusFilter ? ` (status=${statusFilter})` : ""}`);
+  process.exit(0);
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  if (/no such table:\s*jobs\b/i.test(message)) {
+    process.stdout.write(`Queue tables are not set up yet.
+`);
+    process.stdout.write("Run `buddy queue:table` to create the migrations, then `buddy migrate` to apply them.\n");
+    process.exit(0);
+  }
+  log.error("Failed to list queued jobs", error);
+  process.exit(1);
+}
+function extractJobName(payload) {
+  if (typeof payload !== "string")
+    return "unknown";
+  try {
+    const parsed = JSON.parse(payload);
+    return parsed.jobName ?? parsed.name ?? "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+function formatUnixTime(seconds) {
+  if (typeof seconds !== "number" || !Number.isFinite(seconds))
+    return "N/A";
+  return new Date(seconds * 1000).toISOString().slice(0, 19).replace("T", " ");
+}
+function parseArgs() {
+  const args = {};
+  process.argv.forEach((arg) => {
+    if (arg.startsWith("--")) {
+      const [key, value] = arg.slice(2).split("=");
+      if (key && value)
+        args[key] = value;
+    }
+  });
+  return args;
+}

package/dist/queue/monitor.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/queue/monitor.js

@@ -0,0 +1,95 @@
+import process from "node:process";
+import { log } from "@stacksjs/logging";
+import { Job, FailedJob } from "@stacksjs/orm";
+import { getActiveJobCount, isWorkerRunning } from "@stacksjs/queue";
+const options = parseArgs(), queueName = options.queue, refreshInterval = Number(options.interval) || 2000;
+let isRunning = !0;
+process.on("SIGINT", () => {
+  isRunning = !1;
+  console.log(`
+
+Monitoring stopped.`);
+  process.exit(0);
+});
+process.on("SIGTERM", () => {
+  isRunning = !1;
+  process.exit(0);
+});
+async function getStats() {
+  const allJobs = queueName ? await Job.where("queue", queueName).get() : await Job.all(), failedJobs = queueName ? await FailedJob.where("queue", queueName).get() : await FailedJob.all(), now = Math.floor(Date.now() / 1000);
+  let pending = 0, processing = 0, delayed = 0;
+  for (const job of allJobs)
+    if (job.reserved_at)
+      processing++;
+    else if (job.available_at && Number(job.available_at) > now)
+      delayed++;
+    else
+      pending++;
+  return {
+    pending,
+    processing,
+    delayed,
+    failed: failedJobs.length,
+    total: allJobs.length,
+    workerRunning: isWorkerRunning(),
+    activeJobs: getActiveJobCount()
+  };
+}
+async function displayStats() {
+  const stats = await getStats(), timestamp = new Date().toLocaleTimeString();
+  console.clear();
+  console.log("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
+  console.log("\u2502                    Queue Monitor                               \u2502");
+  console.log("\u2502                    Press Ctrl+C to exit                        \u2502");
+  console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");
+  console.log(`\u2502 Last Updated: ${timestamp.padEnd(48)} \u2502`);
+  console.log(`\u2502 Queue Filter: ${(queueName || "All Queues").padEnd(48)} \u2502`);
+  console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");
+  console.log("\u2502                                                                \u2502");
+  console.log(`\u2502   Pending Jobs:     ${String(stats.pending).padStart(8)}                              \u2502`);
+  console.log(`\u2502   Processing Jobs:  ${String(stats.processing).padStart(8)}                              \u2502`);
+  console.log(`\u2502   Delayed Jobs:     ${String(stats.delayed).padStart(8)}                              \u2502`);
+  console.log(`\u2502   Failed Jobs:      ${String(stats.failed).padStart(8)}                              \u2502`);
+  console.log("\u2502                     \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500                              \u2502");
+  console.log(`\u2502   Total Jobs:       ${String(stats.total).padStart(8)}                              \u2502`);
+  console.log("\u2502                                                                \u2502");
+  console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");
+  console.log("\u2502 Worker Status                                                  \u2502");
+  console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");
+  console.log(`\u2502   Worker Running:   ${(stats.workerRunning ? "Yes" : "No").padEnd(8)}                              \u2502`);
+  console.log(`\u2502   Active Jobs:      ${String(stats.activeJobs).padStart(8)}                              \u2502`);
+  console.log("\u2502                                                                \u2502");
+  console.log("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");
+  if (stats.failed > 0)
+    console.log(`
+\u26A0\uFE0F  Warning: ${stats.failed} failed job(s) - run 'buddy queue:failed' for details`);
+  if (!stats.workerRunning && stats.pending > 0)
+    console.log(`
+\u26A0\uFE0F  Warning: Worker not running but ${stats.pending} job(s) pending - run 'buddy queue:work'`);
+}
+try {
+  log.info(`Starting queue monitor...
+`);
+  await displayStats();
+  while (isRunning) {
+    await new Promise((resolve) => setTimeout(resolve, refreshInterval));
+    if (isRunning)
+      await displayStats();
+  }
+} catch (error) {
+  log.error("Monitor error:", error);
+  process.exit(1);
+}
+function parseArgs() {
+  const args = {};
+  process.argv.forEach((arg) => {
+    if (arg.startsWith("--")) {
+      const [key, value] = arg.slice(2).split("=");
+      if (key && value)
+        args[key] = value;
+      else if (key)
+        args[key] = "true";
+    }
+  });
+  return args;
+}

package/dist/queue/pause.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/queue/pause.js

@@ -0,0 +1,28 @@
+import process from "node:process";
+import { log } from "@stacksjs/logging";
+import { pauseQueue } from "@stacksjs/queue";
+const options = parseArgs(), queue = options.queue;
+if (!queue) {
+  log.error("Usage: buddy queue:pause --queue=<name> [--for=300]");
+  process.exit(1);
+}
+const pauseSeconds = options.for ? Number.parseInt(options.for, 10) : 300;
+try {
+  await pauseQueue(queue, pauseSeconds);
+  log.success(`Paused queue '${queue}' for ${pauseSeconds}s`);
+  process.exit(0);
+} catch (error) {
+  log.error("Failed to pause queue", error);
+  process.exit(1);
+}
+function parseArgs() {
+  const args = {};
+  process.argv.forEach((arg) => {
+    if (arg.startsWith("--")) {
+      const [key, value] = arg.slice(2).split("=");
+      if (key && value)
+        args[key] = value;
+    }
+  });
+  return args;
+}

package/dist/queue/quarantine.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/queue/quarantine.js

@@ -0,0 +1,42 @@
+import process from "node:process";
+import { log } from "@stacksjs/logging";
+import { listQuarantined, quarantineJob } from "@stacksjs/queue";
+const options = parseArgs();
+try {
+  if (options.add) {
+    const jobName = options.add;
+    await quarantineJob(jobName);
+    log.success(`Quarantined ${jobName}`);
+    process.exit(0);
+  }
+  const rows = await listQuarantined();
+  if (rows.length === 0) {
+    console.log("\u2713 No jobs currently quarantined");
+    process.exit(0);
+  }
+  console.log("\u250C\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
+  console.log("\u2502 ID  \u2502 Job Name                         \u2502 Payload Hash     \u2502 Failures \u2502 Quarantined At           \u2502");
+  console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");
+  for (const row of rows) {
+    const id = String(row.id).padEnd(3), jn = (row.job_name || "?").substring(0, 32).padEnd(32), ph = (row.payload_hash || "?").substring(0, 16).padEnd(16), fc = String(row.failure_count ?? 0).padEnd(8), qa = (row.quarantined_at || "N/A").substring(0, 24).padEnd(24);
+    console.log(`\u2502 ${id} \u2502 ${jn} \u2502 ${ph} \u2502 ${fc} \u2502 ${qa} \u2502`);
+  }
+  console.log("\u2514\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");
+  console.log(`
+${rows.length} quarantined entrie(s). Use \`queue:unquarantine <JobName>\` to lift.`);
+  process.exit(0);
+} catch (error) {
+  log.error("Failed to handle queue:quarantine", error);
+  process.exit(1);
+}
+function parseArgs() {
+  const args = {};
+  process.argv.forEach((arg) => {
+    if (arg.startsWith("--")) {
+      const [key, value] = arg.slice(2).split("=");
+      if (key && value)
+        args[key] = value;
+    }
+  });
+  return args;
+}

package/dist/queue/resume.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/queue/resume.js

@@ -0,0 +1,27 @@
+import process from "node:process";
+import { log } from "@stacksjs/logging";
+import { resumeQueue } from "@stacksjs/queue";
+const options = parseArgs(), queue = options.queue;
+if (!queue) {
+  log.error("Usage: buddy queue:resume --queue=<name>");
+  process.exit(1);
+}
+try {
+  await resumeQueue(queue);
+  log.success(`Resumed queue '${queue}'`);
+  process.exit(0);
+} catch (error) {
+  log.error("Failed to resume queue", error);
+  process.exit(1);
+}
+function parseArgs() {
+  const args = {};
+  process.argv.forEach((arg) => {
+    if (arg.startsWith("--")) {
+      const [key, value] = arg.slice(2).split("=");
+      if (key && value)
+        args[key] = value;
+    }
+  });
+  return args;
+}

package/dist/queue/retry.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/queue/retry.js

@@ -0,0 +1,41 @@
+import process from "node:process";
+import { log } from "@stacksjs/logging";
+import { executeFailedJobs, retryFailedJob } from "@stacksjs/queue";
+const options = parseArgs(), jobId = options.id, all = options.all === "true";
+try {
+  if (all) {
+    log.info("Retrying all failed jobs...");
+    await executeFailedJobs();
+    log.success("All failed jobs have been queued for retry");
+  } else if (jobId) {
+    const id = Number.parseInt(jobId, 10);
+    if (Number.isNaN(id)) {
+      log.error("Invalid job ID provided");
+      process.exit(1);
+    }
+    log.info(`Retrying failed job ${id}...`);
+    await retryFailedJob(id);
+    log.success(`Failed job ${id} has been queued for retry`);
+  } else {
+    log.warn("Please provide a job ID or use --all to retry all failed jobs");
+    log.info("Usage: buddy queue:retry <id> or buddy queue:retry --all");
+    process.exit(1);
+  }
+  process.exit(0);
+} catch (error) {
+  log.error("Failed to retry job(s)", error);
+  process.exit(1);
+}
+function parseArgs() {
+  const args = {};
+  process.argv.forEach((arg) => {
+    if (arg.startsWith("--")) {
+      const [key, value] = arg.slice(2).split("=");
+      if (key && value)
+        args[key] = value;
+      else if (key)
+        args[key] = "true";
+    }
+  });
+  return args;
+}

package/dist/queue/schedule-list.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/queue/schedule-list.js

@@ -0,0 +1,33 @@
+import process from "node:process";
+import { log } from "@stacksjs/logging";
+import { discoverJobs, getScheduledJobs } from "@stacksjs/queue";
+try {
+  log.info(`Discovering scheduled jobs...
+`);
+  await discoverJobs();
+  const scheduledJobs = getScheduledJobs();
+  if (scheduledJobs.length === 0) {
+    log.info("No scheduled jobs found.");
+    log.info('Tip: Add a "rate" or "schedule" property to your job configuration.');
+    process.exit(0);
+  }
+  console.log("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
+  console.log("\u2502 Job Name                                         \u2502 Schedule              \u2502 Queue     \u2502 Tries   \u2502");
+  console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");
+  for (const job of scheduledJobs) {
+    const name = job.name.substring(0, 48).padEnd(48), schedule = (job.config.rate || job.config.schedule || "N/A").substring(0, 21).padEnd(21), queue = (job.config.queue || "default").substring(0, 9).padEnd(9), tries = String(job.config.tries || 3).padStart(7);
+    console.log(`\u2502 ${name} \u2502 ${schedule} \u2502 ${queue} \u2502${tries} \u2502`);
+  }
+  console.log("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");
+  console.log(`
+Total: ${scheduledJobs.length} scheduled job(s)`);
+  console.log(`
+Schedule Formats:`);
+  console.log('  \u2022 Cron: "* * * * *" (minute hour day month dayOfWeek)');
+  console.log("  \u2022 Presets: @hourly, @daily, @weekly, @monthly");
+  console.log("  \u2022 Every: Every.Minute, Every.Hour, Every.Day");
+  process.exit(0);
+} catch (error) {
+  log.error("Failed to list scheduled jobs:", error);
+  process.exit(1);
+}

package/dist/queue/schedule.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/queue/schedule.js

@@ -0,0 +1,12 @@
+import process from "node:process";
+import { log } from "@stacksjs/logging";
+import { startScheduler } from "@stacksjs/queue";
+log.info("Starting job scheduler...");
+try {
+  await startScheduler();
+  log.success("Scheduler is running. Press Ctrl+C to stop.");
+  await new Promise(() => {});
+} catch (error) {
+  log.error("Failed to start scheduler:", error);
+  process.exit(1);
+}

package/dist/queue/status.d.ts

@@ -0,0 +1 @@
+export {};