@stacksjs/defaults 0.70.57 → 0.70.59

package/app/Actions/Buddy/JobCancelAction.ts

@@ -0,0 +1,32 @@
+import { Action } from '@stacksjs/actions'
+
+/**
+ * POST /api/buddy/jobs/:id/cancel
+ *
+ * Mark an in-flight job as cancelled. Workers that call
+ * `isJobCancelled(id)` between iterations will see the flag and exit
+ * cleanly. The framework can't preempt a running handler, so the
+ * worker is responsible for honoring the cancellation between units
+ * of work.
+ */
+export default new Action({
+  name: 'Buddy Job Cancel',
+  description: 'Signal a running job to stop on its next checkpoint.',
+
+  async handle(request) {
+    const id = String(request.get('id', '') ?? '')
+    if (!id) return new Response(JSON.stringify({ error: 'missing id' }), { status: 400 })
+
+    try {
+      const { cancelJob } = await import('@stacksjs/queue')
+      await cancelJob(id)
+      return { ok: true, id }
+    }
+    catch (err) {
+      return new Response(
+        JSON.stringify({ error: err instanceof Error ? err.message : String(err) }),
+        { status: 500, headers: { 'Content-Type': 'application/json' } },
+      )
+    }
+  },
+})

package/app/Actions/Buddy/JobRetryAction.ts

@@ -0,0 +1,49 @@
+import { Action } from '@stacksjs/actions'
+
+/**
+ * POST /api/buddy/jobs/:id/retry
+ *
+ * Move a failed job back into the active queue. The dashboard's
+ * `jobs/history.stx` calls this when the user clicks "Retry" on a
+ * failed-job row.
+ */
+export default new Action({
+  name: 'Buddy Job Retry',
+  description: 'Re-queue a failed job for processing.',
+
+  async handle(request) {
+    const id = String(request.get('id', '') ?? '')
+    if (!id) return new Response(JSON.stringify({ error: 'missing id' }), { status: 400 })
+
+    try {
+      const { db } = await import('@stacksjs/database')
+      const dbAny = db as any
+
+      const failed = await dbAny.selectFrom('failed_jobs').selectAll().where('id', '=', id).executeTakeFirst()
+      if (!failed) {
+        return new Response(JSON.stringify({ error: 'failed job not found' }), { status: 404 })
+      }
+
+      // Move the row back to the live queue, resetting attempts so the
+      // worker doesn't immediately re-fail it.
+      const now = Math.floor(Date.now() / 1000)
+      await dbAny.insertInto('jobs').values({
+        queue: failed.queue,
+        payload: failed.payload,
+        attempts: 0,
+        reserved_at: null,
+        available_at: now,
+        created_at: new Date().toISOString().slice(0, 19).replace('T', ' '),
+      }).execute()
+      await dbAny.deleteFrom('failed_jobs').where('id', '=', id).execute()
+
+      return { ok: true, retriedAt: now }
+    }
+    catch (err) {
+      return new Response(
+        JSON.stringify({ error: err instanceof Error ? err.message : String(err) }),
+        { status: 500, headers: { 'Content-Type': 'application/json' } },
+      )
+    }
+  },
+})

package/app/Actions/Buddy/JobsListAction.ts

@@ -0,0 +1,141 @@
+import { Action } from '@stacksjs/actions'
+
+/**
+ * GET /api/buddy/jobs
+ *
+ * Powers the existing `dashboard/jobs/history.stx` view. Reads the
+ * `jobs` and `failed_jobs` tables and merges them into a single
+ * timeline shape the dashboard already understands.
+ *
+ * Query params:
+ *   - status: 'all' | 'queued' | 'processing' | 'completed' | 'failed'
+ *   - queue:  'all' | <queue-name>
+ *   - q:      free-text filter on job name
+ *   - page, perPage: pagination
+ */
+export default new Action({
+  name: 'Buddy Jobs List',
+  description: 'List queued, in-flight, completed, and failed jobs for the admin dashboard.',
+
+  async handle(request) {
+    const status = String(request.get('status', 'all') ?? 'all')
+    const queue = String(request.get('queue', 'all') ?? 'all')
+    const q = String(request.get('q', '') ?? '')
+    const page = Math.max(1, Number(request.get('page', 1) ?? 1))
+    const perPage = Math.min(100, Math.max(1, Number(request.get('perPage', 25) ?? 25)))
+
+    try {
+      const { db } = await import('@stacksjs/database')
+      const dbAny = db as any
+
+      // Pull the live `jobs` table — this contains queued + reserved (processing) rows.
+      let pendingQuery = dbAny.selectFrom('jobs').selectAll()
+      if (queue !== 'all') pendingQuery = pendingQuery.where('queue', '=', queue)
+      if (q) pendingQuery = pendingQuery.where('payload', 'like', `%${q}%`)
+
+      // Pull the failed_jobs table for the failed status.
+      let failedQuery = dbAny.selectFrom('failed_jobs').selectAll()
+      if (queue !== 'all') failedQuery = failedQuery.where('queue', '=', queue)
+      if (q) failedQuery = failedQuery.where('payload', 'like', `%${q}%`)
+
+      const [pending, failed] = await Promise.all([
+        status === 'failed' ? Promise.resolve([]) : pendingQuery.execute(),
+        status === 'queued' || status === 'processing' || status === 'completed' ? Promise.resolve([]) : failedQuery.execute(),
+      ])
+
+      const normalized = [
+        ...(pending as Array<Record<string, unknown>>).map(row => normalizePending(row, status)),
+        ...(failed as Array<Record<string, unknown>>).map(normalizeFailed),
+      ]
+        .filter((j): j is NonNullable<typeof j> => j !== null)
+        .sort((a, b) => (b.created_at?.localeCompare(a.created_at ?? '') ?? 0))
+
+      const total = normalized.length
+      const start = (page - 1) * perPage
+      const items = normalized.slice(start, start + perPage)
+
+      return {
+        items,
+        total,
+        page,
+        perPage,
+        totalPages: Math.max(1, Math.ceil(total / perPage)),
+      }
+    }
+    catch (err) {
+      // Fail soft so the dashboard can render an empty state instead of
+      // an opaque 500. Surface the underlying message so it's visible
+      // in the dev-mode error toast.
+      return {
+        items: [],
+        total: 0,
+        page,
+        perPage,
+        totalPages: 1,
+        error: err instanceof Error ? err.message : String(err),
+      }
+    }
+  },
+})
+
+interface NormalizedJob {
+  id: string
+  name: string
+  queue: string
+  status: 'queued' | 'processing' | 'completed' | 'failed'
+  attempts: number
+  runtime?: number
+  started_at?: string
+  finished_at?: string
+  error?: string
+  payload: unknown
+  created_at?: string
+}
+
+function normalizePending(row: Record<string, unknown>, statusFilter: string): NormalizedJob | null {
+  const status: NormalizedJob['status'] = row.reserved_at ? 'processing' : 'queued'
+  if (statusFilter !== 'all' && statusFilter !== status) return null
+  let payload: unknown = row.payload
+  let name = 'unknown'
+  if (typeof payload === 'string') {
+    try {
+      const parsed = JSON.parse(payload) as { jobName?: string }
+      name = parsed.jobName ?? 'unknown'
+      payload = parsed
+    }
+    catch { /* leave as raw string */ }
+  }
+  return {
+    id: String(row.id ?? ''),
+    name,
+    queue: String(row.queue ?? 'default'),
+    status,
+    attempts: Number(row.attempts ?? 0),
+    payload,
+    created_at: row.created_at ? String(row.created_at) : undefined,
+  }
+}
+
+function normalizeFailed(row: Record<string, unknown>): NormalizedJob {
+  let payload: unknown = row.payload
+  let name = 'unknown'
+  if (typeof payload === 'string') {
+    try {
+      const parsed = JSON.parse(payload) as { jobName?: string }
+      name = parsed.jobName ?? 'unknown'
+      payload = parsed
+    }
+    catch { /* leave as raw */ }
+  }
+  return {
+    id: String(row.id ?? ''),
+    name,
+    queue: String(row.queue ?? 'default'),
+    status: 'failed',
+    attempts: Number(row.attempts ?? 0),
+    error: row.exception ? String(row.exception) : undefined,
+    finished_at: row.failed_at ? String(row.failed_at) : undefined,
+    payload,
+    created_at: row.failed_at ? String(row.failed_at) : undefined,
+  }
+}

package/app/Actions/Buddy/ScheduleListAction.ts

@@ -0,0 +1,52 @@
+import { Action } from '@stacksjs/actions'
+
+/**
+ * GET /api/buddy/schedule
+ *
+ * Snapshot of every registered scheduled task — pattern, last run,
+ * next run, status — for the admin dashboard's schedule view.
+ *
+ * Reads from the queue/database scheduler's `scheduled_jobs` table
+ * if it exists, falling back to an empty list otherwise so the
+ * dashboard doesn't 500 on apps that don't use scheduled jobs.
+ */
+export default new Action({
+  name: 'Buddy Schedule List',
+  description: 'List registered scheduled tasks with their next/last run times.',
+
+  async handle() {
+    try {
+      const { db } = await import('@stacksjs/database')
+      const dbAny = db as any
+
+      const rows = await dbAny
+        .selectFrom('scheduled_jobs')
+        .selectAll()
+        .orderBy('next_run_at', 'asc')
+        .execute()
+
+      return {
+        items: (rows as Array<Record<string, unknown>>).map(row => ({
+          id: String(row.id ?? ''),
+          name: String(row.name ?? row.action ?? 'unnamed'),
+          pattern: String(row.cron_expression ?? row.pattern ?? '?'),
+          timezone: row.timezone ? String(row.timezone) : null,
+          lastRunAt: row.last_run_at ? String(row.last_run_at) : null,
+          nextRunAt: row.next_run_at ? String(row.next_run_at) : null,
+          enabled: row.enabled !== false,
+          consecutiveFailures: Number(row.consecutive_failures ?? 0),
+        })),
+      }
+    }
+    catch (err) {
+      // Most common cause: the scheduled_jobs table doesn't exist
+      // because the user hasn't run the scheduler migration. Return
+      // an empty list with a hint instead of a 500.
+      return {
+        items: [],
+        error: err instanceof Error ? err.message : String(err),
+        hint: 'If you see "no such table: scheduled_jobs", run `buddy migrate`.',
+      }
+    }
+  },
+})

package/app/Actions/Buddy/VersionsAction.ts

@@ -0,0 +1,12 @@
+import { Action } from '@stacksjs/actions'
+
+export default new Action({
+  name: 'Buddy Versions',
+  description: 'This command displays the buddy version.',
+
+  handle() {
+    return {
+      versions: ['1.0'],
+    }
+  },
+})

package/app/Actions/Cms/AuthorDestroyAction.ts

@@ -0,0 +1,21 @@
+import { Action } from '@stacksjs/actions'
+import { Author } from '@stacksjs/orm'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'Author Destroy',
+  description: 'Delete an author',
+  method: 'DELETE',
+  async handle(request: RequestInstance) {
+    const id = request.getParam('id')
+    const author = await Author.find(Number(id))
+
+    if (!author) {
+      return response.json({ error: 'Author not found' }, 404)
+    }
+
+    await author.delete()
+
+    return response.json({ success: true, message: 'Author deleted' })
+  },
+})

package/app/Actions/Cms/AuthorIndexAction.ts

@@ -0,0 +1,14 @@
+import { Action } from '@stacksjs/actions'
+import { Author } from '@stacksjs/orm'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'Author Index',
+  description: 'Fetch all authors',
+  method: 'GET',
+  async handle() {
+    const results = await Author.all()
+
+    return response.json(results)
+  },
+})

package/app/Actions/Cms/AuthorShowAction.ts

@@ -0,0 +1,19 @@
+import { Action } from '@stacksjs/actions'
+import { Author } from '@stacksjs/orm'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'Author Show',
+  description: 'Fetch a single author by ID',
+  method: 'GET',
+  async handle(request: RequestInstance) {
+    const id = request.getParam('id')
+    const result = await Author.find(Number(id))
+
+    if (!result) {
+      return response.json({ error: 'Author not found' }, 404)
+    }
+
+    return response.json(result)
+  },
+})

package/app/Actions/Cms/AuthorStoreAction.ts

@@ -0,0 +1,20 @@
+import { Action } from '@stacksjs/actions'
+import { Author } from '@stacksjs/orm'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'Author Store',
+  description: 'Create a new author',
+  method: 'POST',
+  async handle(request: RequestInstance) {
+    const result = await Author.firstOrCreate(
+      { email: request.get('email') },
+      {
+        name: request.get('name'),
+        email: request.get('email'),
+      },
+    )
+
+    return response.json(result)
+  },
+})

package/app/Actions/Cms/AuthorUpdateAction.ts

@@ -0,0 +1,24 @@
+import { Action } from '@stacksjs/actions'
+import { Author } from '@stacksjs/orm'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'Author Update',
+  description: 'Update an existing author',
+  method: 'PATCH',
+  async handle(request: RequestInstance) {
+    const id = request.getParam('id')
+    const author = await Author.find(Number(id))
+
+    if (!author) {
+      return response.json({ error: 'Author not found' }, 404)
+    }
+
+    const result = await author.update({
+      name: request.get('name'),
+      email: request.get('email'),
+    })
+
+    return response.json(result)
+  },
+})

package/app/Actions/Cms/CategorizableDestroyAction.ts

@@ -0,0 +1,16 @@
+import { Action } from '@stacksjs/actions'
+import { categorizable } from '@stacksjs/cms'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'Category Destroy',
+  description: 'Category Destroy ORM Action',
+  method: 'DELETE',
+  async handle(request: RequestInstance) {
+    const id = request.getParam('id')
+
+    await categorizable.destroy(id)
+
+    return response.json({ message: 'Category deleted successfully' })
+  },
+})

package/app/Actions/Cms/CategorizableIndexAction.ts

@@ -0,0 +1,14 @@
+import { Action } from '@stacksjs/actions'
+import { categorizable } from '@stacksjs/cms'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'Category Index',
+  description: 'Category Index ORM Action',
+  method: 'GET',
+  async handle() {
+    const results = await categorizable.fetchAll()
+
+    return response.json(results)
+  },
+})

package/app/Actions/Cms/CategorizableShowAction.ts

@@ -0,0 +1,16 @@
+import { Action } from '@stacksjs/actions'
+import { categorizable } from '@stacksjs/cms'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'Category Show',
+  description: 'Category Show ORM Action',
+  method: 'GET',
+  async handle(request: RequestInstance) {
+    const id = request.getParam('id')
+
+    const model = await categorizable.fetchById(id)
+
+    return response.json(model)
+  },
+})

package/app/Actions/Cms/CategorizableStoreAction.ts

@@ -0,0 +1,42 @@
+import { Action } from '@stacksjs/actions'
+import { categorizable } from '@stacksjs/cms'
+import { response } from '@stacksjs/router'
+import { schema } from '@stacksjs/validation'
+
+export default new Action({
+  name: 'Category Store',
+  description: 'Category Store ORM Action',
+  method: 'POST',
+  async handle(request: RequestInstance) {
+    await request.validate({
+      name: {
+        rule: schema.string(),
+        message: {
+          name: 'Name is required',
+        },
+      },
+      description: {
+        rule: schema.string(),
+        message: {
+          description: 'Description is required',
+        },
+      },
+
+      categorizable_type: {
+        rule: schema.string(),
+        message: {
+          categorizable_type: 'Categorizable type is required',
+        },
+      },
+    })
+    const data = {
+      name: request.get('name'),
+      description: request.get('description'),
+      categorizable_type: request.get('categorizable_type'),
+    }
+
+    const model = await categorizable.store(data)
+
+    return response.json(model)
+  },
+})

package/app/Actions/Cms/CategorizableUpdateAction.ts

@@ -0,0 +1,38 @@
+import type { CategorizableRequestType } from '@stacksjs/types'
+import { Action } from '@stacksjs/actions'
+import { categorizable } from '@stacksjs/cms'
+import { response } from '@stacksjs/router'
+import { schema } from '@stacksjs/validation'
+
+export default new Action({
+  name: 'Category Update',
+  description: 'Category Update ORM Action',
+  method: 'PATCH',
+  async handle(request: RequestInstance) {
+    await request.validate({
+      name: {
+        rule: schema.string(),
+        message: {
+          name: 'Name is required',
+        },
+      },
+      description: {
+        rule: schema.string(),
+        message: {
+          description: 'Description is required',
+        },
+      },
+    })
+
+    const id = request.getParam('id')
+
+    const data = {
+      name: request.get('name'),
+      description: request.get('description'),
+    }
+
+    const model = await categorizable.update(id, data)
+
+    return response.json(model)
+  },
+})

package/app/Actions/Cms/CommentDestroyAction.ts

@@ -0,0 +1,16 @@
+import { Action } from '@stacksjs/actions'
+import { comments } from '@stacksjs/cms'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'Comment Destroy',
+  description: 'Comment Destroy ORM Action',
+  method: 'DELETE',
+  async handle(request: RequestInstance) {
+    const id = request.getParam('id')
+
+    await comments.destroy(id)
+
+    return response.json({ message: 'Model deleted!' })
+  },
+})

package/app/Actions/Cms/CommentIndexAction.ts

@@ -0,0 +1,17 @@
+import { Action } from '@stacksjs/actions'
+import { comments } from '@stacksjs/cms'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'Comment Index',
+  description: 'Comment Index ORM Action',
+  method: 'GET',
+  async handle(request: RequestInstance) {
+    const commentables_id = request.getParam('commentables_id')
+    const commentables_type = request.getParam('commentables_type')
+
+    const results = await comments.fetchCommentsByCommentables(Number(commentables_id), commentables_type)
+
+    return response.json(results)
+  },
+})

package/app/Actions/Cms/CommentShowAction.ts

@@ -0,0 +1,16 @@
+import { Action } from '@stacksjs/actions'
+import { comments } from '@stacksjs/cms'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'Comment Show',
+  description: 'Comment Show ORM Action',
+  method: 'GET',
+  async handle(request: RequestInstance) {
+    const id = request.getParam('id')
+
+    const model = await comments.fetchCommentById(id)
+
+    return response.json(model)
+  },
+})

package/app/Actions/Cms/CommentStoreAction.ts

@@ -0,0 +1,39 @@
+import { Action } from '@stacksjs/actions'
+import { comments } from '@stacksjs/cms'
+import { response } from '@stacksjs/router'
+import { schema } from '@stacksjs/validation'
+
+export default new Action({
+  name: 'Comment Store',
+  description: 'Comment Store ORM Action',
+  method: 'POST',
+  async handle(request: RequestInstance) {
+    await request.validate({
+      title: {
+        rule: schema.string(),
+        message: {
+          title: 'Title is required',
+        },
+      },
+      body: {
+        rule: schema.string(),
+        message: {
+          body: 'Body is required',
+        },
+      },
+    })
+
+    const data = {
+      title: request.get('title'),
+      body: request.get('body'),
+      status: request.get('status'),
+      commentables_id: request.get<number>('commentables_id'),
+      commentables_type: request.get<string>('commentables_type'),
+      user_id: request.get<number>('user_id'),
+    }
+
+    const model = await comments.store(data)
+
+    return response.json(model)
+  },
+})

package/app/Actions/Cms/CommentUpdateAction.ts

@@ -0,0 +1,37 @@
+import { Action } from '@stacksjs/actions'
+import { comments } from '@stacksjs/cms'
+import { response } from '@stacksjs/router'
+import { schema } from '@stacksjs/validation'
+
+export default new Action({
+  name: 'Comment Update',
+  description: 'Comment Update ORM Action',
+  method: 'PATCH',
+  async handle(request: RequestInstance) {
+    await request.validate({
+      title: {
+        rule: schema.string(),
+        message: {
+          title: 'Title is required',
+        },
+      },
+      body: {
+        rule: schema.string(),
+        message: {
+          body: 'Body is required',
+        },
+      },
+    })
+    const id = request.getParam('id')
+
+    const data = {
+      title: request.get('title'),
+      body: request.get('body'),
+      status: request.get('status'),
+    }
+
+    const model = await comments.update(id, data)
+
+    return response.json(model)
+  },
+})

package/app/Actions/Cms/PageDestroyAction.ts

@@ -0,0 +1,16 @@
+import { Action } from '@stacksjs/actions'
+import { pages } from '@stacksjs/cms'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'Page Destroy',
+  description: 'Page Destroy ORM Action',
+  method: 'DELETE',
+  async handle(request: RequestInstance) {
+    const id = request.getParam('id')
+
+    await pages.destroy(id)
+
+    return response.json({ message: 'Page deleted!' })
+  },
+})