spine-framework 0.3.124 → 0.3.126

package/.framework/functions/deliveries.ts

@@ -0,0 +1,117 @@
+// CIL[BEGIN chunk_id="deliveries_module_header_1784200008" type="module_header" identity="imports" parent="none"]
+// CIL[DOC-MACRO purpose="List and manage webhook delivery records"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide admin API for webhook_deliveries ledger"]
+// CIL[DOC-CONTEXT module="deliveries" layer="backend_functions" related_files="[".framework/migrations/051_integration_broker.sql",".framework/functions/_shared/retry-deliveries.ts",".framework/functions/integration-outbound.ts",".framework/src/pages/admin/DeliveriesPage.tsx"]"]
+// CIL[DOC-CONTRACT inputs="ctx, body" outputs="{ data }" errors="account_required, not_found" side_effects="DB reads, optional retry side effects"]
+// CIL[DOC-MICRO logic_summary="Lists webhook deliveries with filters, gets a single delivery, and can trigger a manual retry for outbound records." notable_decisions="["webhook_deliveries is not a runtime type, so it gets its own function instead of using admin-data.","Manual retry reuses the delivery_id path in integration-outbound for outbound records."]"]
+// CIL[DOC-CONFIDENCE pass="first" score="0.85" flags="none"]
+// CIL[DOC-STABILITY stability="experimental"]
+// CIL[DOC-AUDIENCE audience="developer"]
+// CIL[DOC-VECTOR type="context" content="Layer: backend_functions. Direct callers: 0. Direct calls: 0. Related files: .framework/migrations/051_integration_broker.sql, .framework/functions/_shared/retry-deliveries.ts, .framework/functions/integration-outbound.ts, .framework/src/pages/admin/DeliveriesPage.tsx."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="Requires account context."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="Called by the admin Deliveries page."]
+// CIL[DOC-VECTOR type="user_journey" content="Admins monitor webhook delivery attempts."]
+
+import { createHandler } from './_shared/middleware'
+import { emitLog } from './_shared/audit'
+import { SYSTEM_PRINCIPAL } from './_shared/principal'
+import { execute as executeOutbound } from './integration-outbound'
+
+export const list = createHandler(async (ctx, _body) => {
+  const { direction, status, integration_id, api_key_id, limit = 100, offset = 0 } = ctx.query || {}
+
+  if (!ctx.accountId) {
+    throw new Error('Account context required')
+  }
+
+  let query = ctx.db
+    .from('webhook_deliveries')
+    .select('*')
+    .eq('account_id', ctx.accountId)
+    .order('created_at', { ascending: false })
+
+  if (direction) query = query.eq('direction', direction)
+  if (status) query = query.eq('status', status)
+  if (integration_id) query = query.eq('integration_id', integration_id)
+  if (api_key_id) query = query.eq('api_key_id', api_key_id)
+
+  const { data, error: err } = await query.range(
+    parseInt(offset.toString()),
+    parseInt(offset.toString()) + parseInt(limit.toString()) - 1
+  )
+
+  if (err) throw err
+  return data || []
+})
+
+export const get = createHandler(async (ctx, _body) => {
+  const { id } = ctx.query || {}
+
+  if (!id) throw new Error('Delivery ID is required')
+
+  const { data, error: err } = await ctx.db
+    .from('webhook_deliveries')
+    .select('*')
+    .eq('id', id)
+    .single()
+
+  if (err) throw err
+  return data
+})
+
+export const retry = createHandler(async (ctx, body) => {
+  const { id } = body
+
+  if (!id) throw new Error('Delivery ID is required')
+
+  const { data: delivery, error } = await ctx.db
+    .from('webhook_deliveries')
+    .select('*')
+    .eq('id', id)
+    .single()
+
+  if (error || !delivery) throw new Error('Delivery not found')
+
+  if (delivery.direction !== 'outbound') {
+    throw new Error('Manual retry is only supported for outbound deliveries in this release')
+  }
+
+  const retryCtx = {
+    ...ctx,
+    db: ctx.db,
+    accountId: delivery.account_id,
+    principal: SYSTEM_PRINCIPAL
+  }
+
+  const result = await executeOutbound(retryCtx, { delivery_id: delivery.id })
+
+  await emitLog(ctx, 'delivery.manual_retry', { type: 'webhook_delivery', id }, undefined, {
+    direction: delivery.direction,
+    integration_id: delivery.integration_id,
+    account_id: ctx.accountId
+  })
+
+  return result
+})
+
+export const handler = createHandler(async (ctx, body) => {
+  const { action } = ctx.query || {}
+  const method = ctx.query?.method || 'GET'
+
+  switch (action) {
+    case 'retry':
+      if (method === 'POST') return await retry(ctx, body)
+      break
+    default:
+      if (method === 'GET') {
+        if (ctx.query?.id) return await get(ctx, body)
+        return await list(ctx, body)
+      }
+  }
+
+  throw new Error('Invalid action or method')
+})
+
+// CIL[END chunk_id="deliveries_module_header_1784200008"]