@stacksjs/actions 0.70.88 → 0.70.91

package/dist/make.js

@@ -0,0 +1,328 @@
+import process from "node:process";
+import { existsSync } from "node:fs";
+import { italic, runCommand } from "@stacksjs/cli";
+import { ExitCode } from "@stacksjs/types";
+import { localUrl } from "@stacksjs/config";
+import { Action } from "@stacksjs/enums";
+import { handleError } from "@stacksjs/error-handling";
+import { log } from "@stacksjs/logging";
+import { frameworkPath, path as p, resolve } from "@stacksjs/path";
+import { createFolder, doesFolderExist, writeTextFile } from "@stacksjs/storage";
+import { kebabCase, pascalCase, template } from "@stacksjs/strings";
+import { runAction } from "./helpers";
+import { CODE_TEMPLATES } from "./templates";
+let isDryRun = !1;
+export function setDryRun(enabled) {
+  isDryRun = Boolean(enabled);
+}
+export function isDryRunActive() {
+  return isDryRun;
+}
+function generateCode(templateKey, ...args) {
+  return template(CODE_TEMPLATES[templateKey], ...args);
+}
+async function writeOrPreview(path, data) {
+  if (isDryRun) {
+    const lines = data.split(`
+`), preview = lines.slice(0, 60).map((l) => `  ${l}`).join(`
+`), truncated = lines.length > 60 ? `
+  ${italic(`\u2026 ${lines.length - 60} more lines elided`)}` : "";
+    log.info(`[dry-run] would write ${path} (${lines.length} lines)`);
+    process.stdout.write(`${preview}${truncated}
+
+`);
+    return;
+  }
+  await writeTextFile({ path, data });
+}
+async function createFileWithTemplate(path, templateKey, ...args) {
+  await writeOrPreview(path, generateCode(templateKey, ...args));
+}
+export async function invoke(options) {
+  if (options.component)
+    await makeComponent(options);
+  if (options.database)
+    makeDatabase(options);
+  if (options.function)
+    await makeFunction(options);
+  if (options.language)
+    await makeLanguage(options);
+  if (options.middleware)
+    await createMiddleware(options);
+  if (options.notification)
+    await makeNotification(options);
+  if (options.page)
+    await makePage(options);
+  if (options.stack)
+    await makeStack(options);
+}
+export async function make(options) {
+  return await invoke(options);
+}
+export async function makeAction(options) {
+  try {
+    const name = options.name;
+    log.info("Creating your action...");
+    await createAction(options);
+    log.success(`Created ${italic(name)} action`);
+  } catch (error) {
+    log.error("There was an error creating your action", error);
+    process.exit(ExitCode.FatalError);
+  }
+}
+export async function makeComponent(options) {
+  try {
+    const name = options.name;
+    log.info("Creating your component...");
+    await createComponent(options);
+    log.success(`Created ${italic(name)} component`);
+  } catch (error) {
+    log.error("There was an error creating your component", error);
+    process.exit(ExitCode.FatalError);
+  }
+}
+export async function createAction(options) {
+  const name = options.name, opts = options, wantsValidation = Boolean(opts.withValidation || options["with-validation"]), wantsAuth = Boolean(opts.withAuth || options["with-auth"]), templateKey = wantsValidation && wantsAuth ? "actionWithBoth" : wantsValidation ? "actionWithValidation" : wantsAuth ? "actionWithAuth" : "action";
+  await createFileWithTemplate(p.userActionsPath(name), templateKey, name);
+}
+export async function createComponent(options) {
+  const name = options.name;
+  await createFileWithTemplate(p.userComponentsPath(`${name}.vue`), "component", name);
+}
+export function makeDatabase(options) {
+  try {
+    const name = options.name;
+    log.info(`Creating your ${italic(name)} database...`);
+    createDatabase(options);
+    log.success(`Created ${italic(name)} database`);
+  } catch (error) {
+    log.error("There was an error creating your database", error);
+    process.exit(ExitCode.FatalError);
+  }
+}
+export function createDatabase(options) {
+  log.debug("createDatabase options", options);
+}
+export function factory(options) {
+  try {
+    const name = options.name;
+    log.info(`Creating your ${italic(name)} factory...`);
+    createDatabase(options);
+    log.success(`Created ${italic(name)} factory`);
+  } catch (error) {
+    log.error("There was an error creating your factory", error);
+    process.exit(ExitCode.FatalError);
+  }
+}
+export async function createFactory(options) {
+  const name = options.name || "MyFactory", factoryName = name.endsWith("Factory") ? name : `${name}Factory`;
+  try {
+    const { path: p } = await import("@stacksjs/path"), factoryPath = `${p.userDatabasePath("factories")}/${factoryName}.ts`;
+    if (await Bun.file(factoryPath).exists()) {
+      log.warn(`Factory ${factoryName} already exists at ${factoryPath}`);
+      return;
+    }
+    const modelName = name.replace(/Factory$/, ""), content = `import type { ${modelName}Model } from '@stacksjs/orm'
+
+export function ${factoryName}(): Partial<${modelName}Model> {
+  return {
+    // Define your factory attributes here
+  }
+}
+
+export default ${factoryName}
+`;
+    await writeOrPreview(factoryPath, content);
+    log.success(`Created factory: ${factoryPath}`);
+  } catch (error) {
+    log.error(`Failed to create factory ${factoryName}`, error);
+    throw error;
+  }
+}
+export async function makeNotification(options) {
+  try {
+    const name = options.name;
+    log.info(`Creating your ${italic(name)} notification...`);
+    await createNotification(options);
+    log.success(`Created ${italic(name)} notification`);
+  } catch (error) {
+    log.error("There was an error creating your notification", error);
+    process.exit(ExitCode.FatalError);
+  }
+}
+export async function createMail(options) {
+  const rawName = String(options.name || "").trim();
+  if (!rawName) {
+    log.error("A mail name is required (e.g. `buddy make:mail OrderShipped`).");
+    return !1;
+  }
+  const className = pascalCase(rawName), kebabName = kebabCase(rawName), mailPath = p.userMailPath(`${className}.ts`), templatePath = p.userEmailsPath(`${kebabName}.stx`);
+  if (!options.force) {
+    if (existsSync(mailPath)) {
+      console.error(`${italic(mailPath)} already exists \u2014 re-run with --force to overwrite.`);
+      return !1;
+    }
+    if (existsSync(templatePath)) {
+      console.error(`${italic(templatePath)} already exists \u2014 re-run with --force to overwrite.`);
+      return !1;
+    }
+  }
+  if (!doesFolderExist(p.userMailPath()))
+    await createFolder(p.userMailPath());
+  if (!doesFolderExist(p.userEmailsPath()))
+    await createFolder(p.userEmailsPath());
+  try {
+    await createFileWithTemplate(mailPath, "mail", className, kebabName);
+    await createFileWithTemplate(templatePath, "mailTemplate", className, kebabName);
+    return !0;
+  } catch (error) {
+    handleError("Error creating mailable", error);
+    return !1;
+  }
+}
+export async function makeMail(options) {
+  try {
+    const name = options.name;
+    log.info(`Creating your ${italic(name)} mailable...`);
+    if (!await createMail(options))
+      process.exit(ExitCode.FatalError);
+    log.success(`Created ${italic(pascalCase(name))} mailable + ${italic(kebabCase(name))}.stx template`);
+  } catch (error) {
+    log.error("There was an error creating your mailable", error);
+    process.exit(ExitCode.FatalError);
+  }
+}
+export async function makePage(options) {
+  try {
+    const name = options.name;
+    log.info("Creating your page...");
+    await createPage(options);
+    log.success(`Created ${name} page`);
+  } catch (error) {
+    log.error("There was an error creating your page", error);
+    process.exit(ExitCode.FatalError);
+  }
+}
+export async function createPage(options) {
+  const name = options.name;
+  await createFileWithTemplate(p.userViewsPath(`${name}.vue`), "page", name);
+}
+export async function makeFunction(options) {
+  try {
+    const name = options.name;
+    log.info("Creating your function...");
+    await createFunction(options);
+    log.success(`Created ${name} function`);
+  } catch (error) {
+    log.error("There was an error creating your function", error);
+    process.exit(ExitCode.FatalError);
+  }
+}
+export async function createFunction(options) {
+  const name = options.name;
+  await createFileWithTemplate(p.userFunctionsPath(`${name}.ts`), "function", name);
+}
+export async function makeLanguage(options) {
+  try {
+    const name = options.name;
+    log.info("Creating your translation file...");
+    await createLanguage(options);
+    log.success(`Created ${name} translation file`);
+  } catch (error) {
+    log.error("There was an error creating your language.", error);
+    process.exit(ExitCode.FatalError);
+  }
+}
+export async function createLanguage(options) {
+  const name = options.name;
+  await createFileWithTemplate(p.resourcesPath(`lang/${name}.yml`), "language", name);
+}
+export async function makeStack(options) {
+  try {
+    const name = options.name;
+    log.info(`Creating your ${name} stack...`);
+    const stackDir = resolve(process.cwd(), name);
+    if (doesFolderExist(stackDir)) {
+      log.error(`Directory "${name}" already exists`);
+      process.exit(ExitCode.FatalError);
+    }
+    await createFolder(stackDir);
+    const dirs = ["app/Actions", "app/Models", "config", "database/migrations", "resources/views", "resources/components", "resources/functions", "routes", "public"];
+    for (const dir of dirs)
+      await createFolder(resolve(stackDir, dir));
+    const shortName = name.replace(/^@[^/]+\//, "").replace(/-stack$/, "");
+    await createFileWithTemplate(resolve(stackDir, "package.json"), "stackPackageJson", name, shortName);
+    log.success(`Successfully scaffolded your "${name}" stack`);
+    log.info("");
+    log.info(`  cd ${name}`);
+    log.info("  # Add your models, actions, views, etc.");
+    log.info("  # Then publish: bun publish");
+    log.info("");
+    log.info("  Users install it with:");
+    log.info(`  buddy stack:install ${name}`);
+  } catch (error) {
+    log.error("There was an error creating your stack", error);
+    process.exit(ExitCode.FatalError);
+  }
+}
+export async function createNotification(options) {
+  const name = options.name;
+  try {
+    let importOption = "EmailOptions";
+    if (!doesFolderExist("notifications"))
+      await createFolder("./notifications");
+    if (options.chat)
+      importOption = "ChatOptions";
+    if (options.sms)
+      importOption = "SMSOptions";
+    await createFileWithTemplate(p.userNotificationsPath(`${name}.ts`), "notification", importOption);
+    return !0;
+  } catch (error) {
+    handleError("Error creating notification", error);
+    return !1;
+  }
+}
+export async function createMigration(options) {
+  const optionName = options.name, table = "dummy-name";
+  if (!optionName[0])
+    throw Error("options.name is required and cannot be empty");
+  const name = optionName[0].toUpperCase() + optionName.slice(1), path = frameworkPath(`database/migrations/${name}.ts`);
+  try {
+    await createFileWithTemplate(path, "migration", table);
+    log.success(`Successfully created your migration file at stacks/database/migrations/${name}.ts`);
+  } catch (error) {
+    log.error(error);
+  }
+}
+export async function makeQueueTable() {
+  await runAction(Action.QueueTable);
+}
+export async function makeCertificate() {
+  const domain = await localUrl();
+  log.info("Creating SSL certificate...");
+  await runCommand(`tlsx ${domain}`, {
+    cwd: p.storagePath("keys")
+  });
+  log.success("Certificate created");
+  log.info("Installing SSL certificate...");
+  await runCommand("tlsx -install", {
+    cwd: p.storagePath("keys")
+  });
+  log.success("Certificate installed");
+}
+export async function createModel(options) {
+  const optionName = options.name;
+  if (!optionName[0])
+    throw Error("options.name is required and cannot be empty");
+  const name = optionName[0].toUpperCase() + optionName.slice(1), tableName = name.replace(/([A-Z])/g, "_$1").toLowerCase().replace(/^_/, "").replace(/([^s])$/, "$1s"), path = p.userModelsPath(`${name}.ts`);
+  try {
+    await createFileWithTemplate(path, "model", name, tableName);
+    log.success(`Model created: ${italic(`app/Models/${name}.ts`)}`);
+  } catch (error) {
+    log.error(error);
+  }
+}
+export async function createMiddleware(options) {
+  const name = options.name;
+  await createFileWithTemplate(p.userMiddlewarePath(`${name}.ts`), "middleware", name);
+}

package/dist/migrate/database.d.ts

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

package/dist/migrate/database.js

@@ -0,0 +1,16 @@
+import process from "node:process";
+import { generateMigrations, runDatabaseMigration } from "@stacksjs/database";
+import { log } from "@stacksjs/logging";
+const result = await generateMigrations();
+if (result?.isErr) {
+  console.error(result.error);
+  log.error("[stacks] generateMigrations failed", result.error);
+  process.exit(1);
+}
+const migrateResult = await runDatabaseMigration();
+if (migrateResult.isErr) {
+  log.error("runDatabaseMigration failed");
+  log.error(migrateResult.error);
+  process.exit(1);
+}
+process.exit(0);

package/dist/migrate/fresh.d.ts

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

package/dist/migrate/fresh.js

@@ -0,0 +1,31 @@
+import process from "node:process";
+import { generateMigrations, migrateAuthTables, migrateNotificationTables, migrateRbacTables, resetDatabase, runDatabaseMigration } from "@stacksjs/database";
+import { log } from "@stacksjs/logging";
+const resetResult = await resetDatabase();
+if (resetResult?.isErr) {
+  console.error(resetResult.error);
+  log.error("resetDatabase failed", resetResult.error);
+  process.exit(1);
+}
+const genResult = await generateMigrations();
+if (genResult?.isErr) {
+  console.error(genResult.error);
+  log.error("generateMigrations failed", genResult.error);
+  process.exit(1);
+}
+const authResult = await migrateAuthTables();
+if (!authResult.success)
+  log.error(`Failed to migrate auth tables: ${authResult.error}`);
+const notifResult = await migrateNotificationTables();
+if (!notifResult.success)
+  log.error(`Failed to migrate notification tables: ${notifResult.error}`);
+const rbacResult = await migrateRbacTables();
+if (!rbacResult.success)
+  log.error(`Failed to migrate RBAC tables: ${rbacResult.error}`);
+const migrateResult = await runDatabaseMigration();
+if (migrateResult.isErr) {
+  log.error("runDatabaseMigration failed");
+  log.error(migrateResult.error);
+  process.exit(1);
+}
+process.exit(0);

package/dist/orm/base.d.ts

@@ -0,0 +1 @@
+

package/dist/orm/test.d.ts

@@ -0,0 +1 @@
+

package/dist/prepublish.d.ts

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

package/dist/prepublish.js

@@ -0,0 +1,16 @@
+import process from "node:process";
+import { NpmScript } from "@stacksjs/enums";
+import { log } from "@stacksjs/logging";
+import { runtimePath } from "@stacksjs/path";
+import { ExitCode } from "@stacksjs/types";
+import { runNpmScript } from "@stacksjs/utils";
+log.info("Running prepublish command...");
+const result = await runNpmScript(NpmScript.BuildStacks, {
+  verbose: !0,
+  cwd: runtimePath()
+});
+if (result.isErr) {
+  log.error(Error("There was an error while prepublishing your stack"), result.error);
+  process.exit(ExitCode.FatalError);
+}
+log.success("Prepublishing completed");

package/dist/queue/clear.d.ts

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

package/dist/queue/clear.js

@@ -0,0 +1,42 @@
+import process from "node:process";
+import { log } from "@stacksjs/logging";
+import { Job } from "@stacksjs/orm";
+const options = parseArgs(), queueName = options.queue, force = options.force === "true";
+try {
+  if (!force) {
+    log.warn("This will delete all jobs from the queue. Use --force to confirm.");
+    process.exit(1);
+  }
+  let deletedCount = 0;
+  if (queueName) {
+    log.info(`Clearing all jobs from queue "${queueName}"...`);
+    const jobs = await Job.where("queue", queueName).get();
+    deletedCount = jobs.length;
+    for (const job of jobs)
+      await job.delete();
+  } else {
+    log.info("Clearing all jobs from all queues...");
+    const jobs = await Job.all();
+    deletedCount = jobs.length;
+    for (const job of jobs)
+      await job.delete();
+  }
+  log.success(`Cleared ${deletedCount} job(s)`);
+  process.exit(0);
+} catch (error) {
+  log.error("Failed to clear 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/dlq-purge.d.ts

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

package/dist/queue/dlq-purge.js

@@ -0,0 +1,28 @@
+import process from "node:process";
+import { log } from "@stacksjs/logging";
+import { purgeDeadLetterJobs } from "@stacksjs/queue";
+const options = parseArgs(), days = options.olderThanDays ? Number.parseInt(options.olderThanDays, 10) : options["older-than-days"] ? Number.parseInt(options["older-than-days"], 10) : 30;
+if (!Number.isFinite(days) || days < 1) {
+  log.error(`Invalid --older-than-days value '${options.olderThanDays ?? options["older-than-days"]}'`);
+  process.exit(1);
+}
+try {
+  log.info(`Pruning dead-letter rows older than ${days} day(s)...`);
+  const deleted = await purgeDeadLetterJobs(days);
+  log.success(`Deleted ${deleted} dead-letter row(s)`);
+  process.exit(0);
+} catch (error) {
+  log.error("Failed to purge dead-letter 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;
+    }
+  });
+  return args;
+}

package/dist/queue/dlq-retry.d.ts

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

package/dist/queue/dlq-retry.js

@@ -0,0 +1,35 @@
+import process from "node:process";
+import { log } from "@stacksjs/logging";
+import { retryDeadLetterJob } from "@stacksjs/queue";
+const options = parseArgs(), idArg = options.id;
+if (!idArg) {
+  log.error("Usage: buddy queue:dlq:retry --id=<id>");
+  process.exit(1);
+}
+const id = Number.parseInt(idArg, 10);
+if (Number.isNaN(id)) {
+  log.error("Invalid id provided");
+  process.exit(1);
+}
+try {
+  if (!await retryDeadLetterJob(id)) {
+    log.error(`Dead-letter job ${id} not found (or DLQ table missing)`);
+    process.exit(1);
+  }
+  log.success(`Re-enqueued dead-letter job ${id}`);
+  process.exit(0);
+} catch (error) {
+  log.error("Failed to re-enqueue dead-letter 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;
+    }
+  });
+  return args;
+}

package/dist/queue/dlq.d.ts

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

package/dist/queue/dlq.js

@@ -0,0 +1,55 @@
+import process from "node:process";
+import { log } from "@stacksjs/logging";
+import { listDeadLetterJobs } from "@stacksjs/queue";
+const options = parseArgs(), queueName = options.queue || void 0, reason = options.reason || void 0, sinceArg = options.since, limit = options.limit ? Number.parseInt(options.limit, 10) : 100;
+try {
+  log.info(`Fetching dead-letter jobs...
+`);
+  const sinceCutoffMs = sinceArg ? parseSinceDuration(sinceArg) ?? void 0 : void 0, rows = await listDeadLetterJobs({ queue: queueName, reason, sinceCutoffMs, limit });
+  if (rows.length === 0) {
+    console.log("\u2713 No dead-letter 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\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 Queue                            \u2502 Reason           \u2502 Failures \u2502 Dead-Lettered 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), q = (row.queue || "default").substring(0, 32).padEnd(32), r = (row.reason || "unknown").substring(0, 16).padEnd(16), f = String(row.total_failures ?? 1).padEnd(8), dt = (row.dead_lettered_at || "N/A").substring(0, 24).padEnd(24);
+    console.log(`\u2502 ${id} \u2502 ${q} \u2502 ${r} \u2502 ${f} \u2502 ${dt} \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(`
+Showing ${rows.length} dead-letter job(s)`);
+  process.exit(0);
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  if (/no such table:\s*dead_letter_jobs\b/i.test(message)) {
+    process.stdout.write(`Dead-letter queue table is 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 fetch dead-letter 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;
+    }
+  });
+  return args;
+}
+function parseSinceDuration(input) {
+  const m = /^(\d+)([smhd])$/.exec(input.trim());
+  if (!m)
+    return null;
+  const n = Number(m[1]);
+  if (!Number.isFinite(n) || n <= 0)
+    return null;
+  const mult = m[2] === "s" ? 1000 : m[2] === "m" ? 60000 : m[2] === "h" ? 3600000 : 86400000;
+  return Date.now() - n * mult;
+}

package/dist/queue/failed.d.ts

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

package/dist/queue/failed.js

@@ -0,0 +1,69 @@
+import process from "node:process";
+import { log } from "@stacksjs/logging";
+import { FailedJob } from "@stacksjs/orm";
+const options = parseArgs(), queueName = options.queue, sinceArg = options.since, sinceCutoff = sinceArg ? parseSinceDuration(sinceArg) : null;
+try {
+  log.info(`Fetching failed jobs...
+`);
+  let failedJobs;
+  if (queueName)
+    failedJobs = await FailedJob.where("queue", queueName).get();
+  else
+    failedJobs = await FailedJob.all();
+  if (sinceCutoff)
+    failedJobs = failedJobs.filter((j) => {
+      if (!j.failed_at)
+        return !1;
+      const ts = Date.parse(j.failed_at);
+      return Number.isFinite(ts) && ts >= sinceCutoff;
+    });
+  if (failedJobs.length === 0) {
+    if (sinceCutoff)
+      console.log(`\u2713 No failed jobs found since ${sinceArg}`);
+    else
+      console.log("\u2713 No failed 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\u2500\u2500\u2500\u2500\u2500\u2500\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\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 Queue                                            \u2502 Failed At             \u2502 Exception                       \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\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\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 job of failedJobs) {
+    const id = String(job.id).padEnd(3), queue = (job.queue || "default").substring(0, 48).padEnd(48), failedAt = (job.failed_at || "N/A").substring(0, 21).padEnd(21), exception = (job.exception || "Unknown error").substring(0, 31).padEnd(31);
+    console.log(`\u2502 ${id} \u2502 ${queue} \u2502 ${failedAt} \u2502 ${exception} \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\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\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(`
+Total: ${failedJobs.length} 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 fetch 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;
+    }
+  });
+  return args;
+}
+function parseSinceDuration(input) {
+  const m = /^(\d+)([smhd])$/.exec(input.trim());
+  if (!m)
+    return null;
+  const n = Number(m[1]);
+  if (!Number.isFinite(n) || n <= 0)
+    return null;
+  const mult = m[2] === "s" ? 1000 : m[2] === "m" ? 60000 : m[2] === "h" ? 3600000 : 86400000;
+  return Date.now() - n * mult;
+}

package/dist/queue/flush.d.ts

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