@actuate-media/cms-admin 0.22.0 → 0.23.0

package/src/lib/forms-service.ts

@@ -21,6 +21,9 @@ import type {
   FormStats,
   FormsSidebarCount,
   FetchFormsParams,
+  FormSubmission,
+  FetchFormEntriesParams,
+  EntryCounts,
 } from '@actuate-media/cms-core'
 
 export type {
@@ -35,6 +38,11 @@ export type {
   FormStatus,
   FormStats,
   FormsSidebarCount,
+  FormSubmission,
+  FormSubmissionFile,
+  FetchFormEntriesParams,
+  EntryCounts,
+  SpamStatus,
 } from '@actuate-media/cms-core'
 
 /**
@@ -242,3 +250,94 @@ export async function updateEmbedSettings(
   })
   return { data: res.data, error: res.error }
 }
+
+// ─── Entries (submissions) ─────────────────────────────────────────────────
+
+/** A page of submissions as returned by `GET /forms/entries`. */
+export interface EntriesPage {
+  entries: FormSubmission[]
+  total: number
+  page: number
+  pageSize: number
+}
+
+/** Patch shape accepted by the entry mutation endpoints. */
+export interface EntryPatch {
+  unread?: boolean
+  starred?: boolean
+  archived?: boolean
+}
+
+function buildEntriesQuery(params: FetchFormEntriesParams): string {
+  const qs = new URLSearchParams()
+  if (params.search) qs.set('search', params.search)
+  if (params.formId) qs.set('formId', params.formId)
+  if (typeof params.unread === 'boolean') qs.set('unread', String(params.unread))
+  if (typeof params.starred === 'boolean') qs.set('starred', String(params.starred))
+  if (typeof params.archived === 'boolean') qs.set('archived', String(params.archived))
+  if (params.spamStatus) qs.set('spamStatus', params.spamStatus)
+  if (params.dateFrom) qs.set('dateFrom', params.dateFrom)
+  if (params.dateTo) qs.set('dateTo', params.dateTo)
+  if (params.thisWeek) qs.set('thisWeek', 'true')
+  if (params.sortBy) qs.set('sortBy', params.sortBy)
+  if (params.sortDirection) qs.set('sortDirection', params.sortDirection)
+  if (params.page) qs.set('page', String(params.page))
+  if (params.pageSize) qs.set('pageSize', String(params.pageSize))
+  const str = qs.toString()
+  return str ? `?${str}` : ''
+}
+
+const EMPTY_PAGE: EntriesPage = { entries: [], total: 0, page: 1, pageSize: 25 }
+
+export async function fetchEntries(params: FetchFormEntriesParams = {}): Promise<EntriesPage> {
+  const res = await cmsApi<EntriesPage>(`/forms/entries${buildEntriesQuery(params)}`)
+  throwIfError(res)
+  return res.data ?? EMPTY_PAGE
+}
+
+const EMPTY_COUNTS: EntryCounts = { total: 0, unread: 0, starred: 0, thisWeek: 0, byForm: {} }
+
+export async function fetchEntryCounts(params: FetchFormEntriesParams = {}): Promise<EntryCounts> {
+  const res = await cmsApi<EntryCounts>(`/forms/entries/counts${buildEntriesQuery(params)}`)
+  throwIfError(res)
+  return res.data ?? EMPTY_COUNTS
+}
+
+/** A single entry rendered against the schema version it was captured with. */
+export interface EntryDetail {
+  entry: FormSubmission
+  fields: FormField[]
+}
+
+export async function fetchEntry(id: string): Promise<EntryDetail | null> {
+  const res = await cmsApi<EntryDetail>(`/forms/entries/${encodeURIComponent(id)}`)
+  throwIfError(res)
+  return res.data ?? null
+}
+
+export async function updateEntry(
+  id: string,
+  patch: EntryPatch,
+): Promise<{ data?: FormSubmission; error?: string }> {
+  const res = await cmsApi<FormSubmission>(`/forms/entries/${encodeURIComponent(id)}`, {
+    method: 'PATCH',
+    body: JSON.stringify(patch),
+  })
+  return { data: res.data, error: res.error }
+}
+
+export async function deleteEntry(id: string): Promise<{ error?: string }> {
+  const res = await cmsApi(`/forms/entries/${encodeURIComponent(id)}`, { method: 'DELETE' })
+  return { error: res.error }
+}
+
+export async function bulkUpdateEntries(
+  ids: string[],
+  patch: EntryPatch,
+): Promise<{ data?: { updated: number }; error?: string }> {
+  const res = await cmsApi<{ updated: number }>('/forms/entries/bulk', {
+    method: 'POST',
+    body: JSON.stringify({ ids, patch }),
+  })
+  return { data: res.data, error: res.error }
+}