Files
hackerspace.sh/lib/actions/payments.ts
T
Moheeb Zara 2c847befeb feat(me): my-payments self-view in the Membership tab (P3d)
New getMyPayments: payments SELECT is treasurer-scoped (RLS), so the
self-view uses the validated service client strictly scoped to the
caller's space_id + member_id (same convention as getMyBilling /
getMyNotifications). Read-only list (amount, date, platform, status)
in the Membership tab. Docs updated. 521 tests; build clean.
2026-05-18 15:50:34 -07:00

195 lines
5.8 KiB
TypeScript

'use server'
import { revalidatePath } from 'next/cache'
import { createClient } from '@/lib/supabase/server'
import { createAdminClient } from '@/lib/supabase/admin'
import {
requireMember,
requireMemberWithRole,
logActivity,
parseInput,
} from '@/lib/auth-helpers'
import { TREASURER_ROLES } from '@/lib/permissions'
import {
logCashPaymentSchema,
linkPaymentSchema,
importPaymentsCsvSchema,
} from '@/lib/validations'
import type { Enums } from '@/types/database'
type PaymentPlatform = Enums<'payment_platform'>
export async function logCashPayment(formData: {
amount: number
from_note: string
member_id?: string
transaction_date?: string
}) {
const v = parseInput(logCashPaymentSchema, formData)
if (!v.ok) return { error: v.error }
const supabase = await createClient()
const auth = await requireMemberWithRole(supabase, TREASURER_ROLES, 'Treasurer access required')
if (!auth.ok) return { error: auth.error }
const { member } = auth
const transactionDate = v.data.transaction_date ?? new Date().toISOString()
const { data, error } = await supabase
.from('payments')
.insert({
space_id: member.space_id,
platform: 'cash',
amount: v.data.amount,
from_identifier: 'Cash',
from_note: v.data.from_note,
member_id: v.data.member_id ?? null,
link_status: v.data.member_id ? 'linked' : 'unlinked',
transaction_date: transactionDate,
})
.select()
.single()
if (error) return { error: error.message }
if (v.data.member_id) {
await supabase
.from('space_members')
.update({
last_paid_at: transactionDate,
payment_status: 'current',
})
.eq('id', v.data.member_id)
.eq('space_id', member.space_id)
}
await logActivity(
supabase,
member,
'logged',
'payment',
data.id,
`$${v.data.amount} cash, ${v.data.from_note}`,
)
revalidatePath('/payments')
revalidatePath('/dashboard')
return { data }
}
export async function linkPaymentToMember(paymentId: string, memberId: string) {
const v = parseInput(linkPaymentSchema, { paymentId, memberId })
if (!v.ok) return { error: v.error }
const supabase = await createClient()
const auth = await requireMemberWithRole(supabase, TREASURER_ROLES, 'Treasurer access required')
if (!auth.ok) return { error: auth.error }
const { member: self } = auth
const { data: payment } = await supabase
.from('payments')
.select('amount, transaction_date')
.eq('id', v.data.paymentId)
.single()
const { error } = await supabase
.from('payments')
.update({ member_id: v.data.memberId, link_status: 'linked' })
.eq('id', v.data.paymentId)
.eq('space_id', self.space_id)
if (error) return { error: error.message }
if (payment) {
await supabase
.from('space_members')
.update({
last_paid_at: payment.transaction_date,
payment_status: 'current',
})
.eq('id', v.data.memberId)
.eq('space_id', self.space_id)
}
revalidatePath('/payments')
revalidatePath('/members')
revalidatePath('/dashboard')
return { success: true as const }
}
export async function importPaymentsCsv(rows: unknown) {
if (!Array.isArray(rows) || rows.length === 0) {
return { error: 'No rows to import' }
}
const supabase = await createClient()
const auth = await requireMemberWithRole(supabase, TREASURER_ROLES, 'Treasurer access required')
if (!auth.ok) return { error: auth.error }
const { member } = auth
// Per-row validation: platform enum, positive finite amount, normalized
// transaction_date. Invalid rows are skipped and counted, not silently
// dropped without feedback.
const rowSchema = importPaymentsCsvSchema.element
const inserts: Array<Record<string, unknown>> = []
let skipped = 0
for (const raw of rows) {
const r = rowSchema.safeParse(raw)
if (!r.success) { skipped++; continue }
inserts.push({
space_id: member.space_id,
platform: r.data.platform as PaymentPlatform,
amount: r.data.amount,
from_identifier: r.data.from_identifier,
from_note: r.data.from_note ?? null,
link_status: 'unlinked' as const,
transaction_date: r.data.transaction_date ?? new Date().toISOString(),
})
}
if (inserts.length === 0) {
return { error: `No valid rows to import (${skipped} skipped: bad platform, amount, or date).` }
}
const { data, error } = await supabase.from('payments').insert(inserts).select()
if (error) return { error: error.message }
revalidatePath('/payments')
revalidatePath('/dashboard')
return { data, count: data.length, skipped }
}
// The caller's own payment history. `payments` SELECT is treasurer-scoped
// (RLS), so the member self-view goes through the validated service client,
// strictly scoped to their own space_id + member_id (same convention as
// getMyBilling / getMyNotifications).
export async function getMyPayments() {
const supabase = await createClient()
const auth = await requireMember(supabase)
if (!auth.ok) return { error: auth.error }
const { member } = auth
const { data } = await createAdminClient()
.from('payments')
.select('id, amount, currency, platform, description, status, transaction_date, payment_date, created_at')
.eq('space_id', member.space_id)
.eq('member_id', member.id)
.order('transaction_date', { ascending: false, nullsFirst: false })
.limit(50)
return {
data: (data ?? []).map(p => ({
id: p.id as string,
amount: p.amount as number,
currency: (p.currency as string | null) ?? 'USD',
platform: p.platform as string,
description: (p.description as string | null) ?? null,
status: p.status as string,
date:
(p.transaction_date as string | null) ??
(p.payment_date as string | null) ??
(p.created_at as string),
})),
}
}