diff --git a/apps/events/backend/src/v2/deprecation.ts b/apps/events/backend/src/v2/deprecation.ts index 44121d6..1de54a4 100644 --- a/apps/events/backend/src/v2/deprecation.ts +++ b/apps/events/backend/src/v2/deprecation.ts @@ -46,6 +46,61 @@ const SUCCESSORS: Successor[] = [ { method: 'POST', v1: /^\/api\/events\/([^/]+)\/copy-from$/, v2: m => `/api/v2/events/${m[1]}/copy-from` }, { method: 'GET', v1: /^\/api\/events\/([^/]+)\/notify-recipients$/, v2: m => `/api/v2/events/${m[1]}/notify-recipients` }, { method: 'PUT', v1: /^\/api\/events\/([^/]+)\/notify-recipients$/, v2: m => `/api/v2/events/${m[1]}/notify-recipients` }, + // 1.51.11: money (payments, cash-ups, provider transactions, waitlist, sponsorship, consent, forms, feedback) + { method: 'GET', v1: /^\/api\/payments\/providers$/, v2: () => '/api/v2/payments/providers' }, + { method: 'GET', v1: /^\/api\/payments\/providers\/settings$/, v2: () => '/api/v2/payments/providers/settings' }, + { method: 'PUT', v1: /^\/api\/payments\/providers\/settings$/, v2: () => '/api/v2/payments/providers/settings' }, + { method: 'GET', v1: /^\/api\/payments\/pay\/([^/]+)$/, v2: m => `/api/v2/payment-links/${m[1]}` }, + { method: 'POST', v1: /^\/api\/payments\/pay\/([^/]+)$/, v2: m => `/api/v2/payment-links/${m[1]}` }, + { method: 'GET', v1: /^\/api\/payments\/checkouts\/open$/, v2: () => '/api/v2/payments/open-checkouts' }, + { method: 'POST', v1: /^\/api\/payments\/checkouts\/check$/, v2: () => '/api/v2/payments/open-checkouts/check' }, + { method: 'POST', v1: /^\/api\/payments\/(yoco-)?checkout\/send$/, v2: () => '/api/v2/registrations/{id}/payment-link' }, + { method: 'GET', v1: /^\/api\/payments\/mypayments$/, v2: () => '/api/v2/me/payments' }, + { method: 'GET', v1: /^\/api\/payments\/admin\/stats$/, v2: () => '/api/v2/payments/stats' }, + { method: 'GET', v1: /^\/api\/payments\/registration\/([^/]+)$/, v2: m => `/api/v2/registrations/${m[1]}/payments` }, + { method: 'GET', v1: /^\/api\/payments\/event\/([^/]+)$/, v2: m => `/api/v2/events/${m[1]}/payments` }, + { method: 'PUT', v1: /^\/api\/payments\/assign-donation$/, v2: () => '/api/v2/payments/donations/assign' }, + { method: 'POST', v1: /^\/api\/payments\/unassign-donation$/, v2: () => '/api/v2/payments/donations/unassign' }, + { method: 'POST', v1: /^\/api\/payments\/refund$/, v2: () => '/api/v2/payments/refunds' }, + { method: 'POST', v1: /^\/api\/payments\/([^/]+)\/send-receipt$/, v2: m => `/api/v2/payments/${m[1]}/receipt` }, + { method: 'GET', v1: /^\/api\/payments\/?$/, v2: () => '/api/v2/payments' }, + { method: 'POST', v1: /^\/api\/payments\/?$/, v2: () => '/api/v2/payments' }, + { method: 'GET', v1: /^\/api\/payments\/([^/]+)$/, v2: m => `/api/v2/payments/${m[1]}` }, + { method: 'GET', v1: /^\/api\/cashups\/audit$/, v2: () => '/api/v2/cashups/audit' }, + { method: 'GET', v1: /^\/api\/cashups\/event\/([^/]+)$/, v2: m => `/api/v2/events/${m[1]}/cashup` }, + { method: 'GET', v1: /^\/api\/cashups\/event\/([^/]+)\/cash-by-user$/, v2: m => `/api/v2/events/${m[1]}/cashup/cash-by-user` }, + { method: 'PUT', v1: /^\/api\/cashups\/event\/([^/]+)\/person-cash\/([^/]+)$/, v2: m => `/api/v2/events/${m[1]}/cashup/person-cash/${m[2]}` }, + { method: 'PUT', v1: /^\/api\/cashups\/event\/([^/]+)\/draft$/, v2: m => `/api/v2/events/${m[1]}/cashup/draft` }, + { method: 'POST', v1: /^\/api\/cashups\/event\/([^/]+)\/close$/, v2: m => `/api/v2/events/${m[1]}/cashup/close` }, + { method: 'POST', v1: /^\/api\/cashups\/event\/([^/]+)\/reopen$/, v2: m => `/api/v2/events/${m[1]}/cashup/reopen` }, + { method: 'POST', v1: /^\/api\/cashups\/lines\/([^/]+)\/pending$/, v2: m => `/api/v2/cashup-lines/${m[1]}/pending` }, + { method: 'GET', v1: /^\/api\/(provider|yoco)-transactions\/?$/, v2: () => '/api/v2/provider-transactions' }, + { method: 'GET', v1: /^\/api\/(provider|yoco)-transactions\/unreconciled$/, v2: () => '/api/v2/provider-transactions/unreconciled' }, + { method: 'POST', v1: /^\/api\/(?:provider|yoco)-transactions\/([^/]+)\/reconcile$/, v2: m => `/api/v2/provider-transactions/${m[1]}/reconcile` }, + { method: 'POST', v1: /^\/api\/(?:provider|yoco)-transactions\/([^/]+)\/ignore$/, v2: m => `/api/v2/provider-transactions/${m[1]}/ignore` }, + { method: 'POST', v1: /^\/api\/waitlist\/?$/, v2: () => '/api/v2/waitlist' }, + { method: 'GET', v1: /^\/api\/waitlist\/mine$/, v2: () => '/api/v2/me/waitlist' }, + { method: 'GET', v1: /^\/api\/waitlist\/claim\/([^/]+)$/, v2: m => `/api/v2/waitlist/claims/${m[1]}` }, + { method: 'GET', v1: /^\/api\/waitlist\/events\/([^/]+)$/, v2: m => `/api/v2/events/${m[1]}/waitlist` }, + { method: 'POST', v1: /^\/api\/waitlist\/([^/]+)\/(offer|move|remove)$/, v2: m => `/api/v2/waitlist/${m[1]}/${m[2]}` }, + { method: 'DELETE', v1: /^\/api\/waitlist\/([^/]+)$/, v2: m => `/api/v2/waitlist/${m[1]}` }, + { method: 'GET', v1: /^\/api\/sponsorships\/event\/([^/]+)$/, v2: m => `/api/v2/events/${m[1]}/sponsorship` }, + { method: 'GET', v1: /^\/api\/sponsorships\/event\/([^/]+)\/pool$/, v2: m => `/api/v2/events/${m[1]}/sponsorship/pool` }, + { method: 'POST', v1: /^\/api\/sponsorships\/checkout$/, v2: () => '/api/v2/sponsorships/checkout' }, + { method: 'GET', v1: /^\/api\/consent\/events\/([^/]+)$/, v2: m => `/api/v2/events/${m[1]}/consent` }, + { method: 'GET', v1: /^\/api\/consent\/events\/([^/]+)\/medical$/, v2: m => `/api/v2/events/${m[1]}/consent/medical` }, + { method: 'POST', v1: /^\/api\/consent\/events\/([^/]+)\/(resend-pending|rerequest)$/, v2: m => `/api/v2/events/${m[1]}/consent/${m[2]}` }, + { method: 'POST', v1: /^\/api\/consent\/requests\/([^/]+)\/resend$/, v2: m => `/api/v2/consent-requests/${m[1]}/resend` }, + { method: 'GET', v1: /^\/api\/consent\/([^/]+)$/, v2: m => `/api/v2/consent/${m[1]}` }, + { method: 'POST', v1: /^\/api\/consent\/([^/]+)$/, v2: m => `/api/v2/consent/${m[1]}` }, + { method: 'GET', v1: /^\/api\/forms\/responses$/, v2: () => '/api/v2/form-responses' }, + { method: 'GET', v1: /^\/api\/feedback\/summary$/, v2: () => '/api/v2/feedback/summary' }, + { method: 'GET', v1: /^\/api\/feedback\/public\/([^/]+)$/, v2: m => `/api/v2/feedback-forms/${m[1]}` }, + { method: 'POST', v1: /^\/api\/feedback\/public\/([^/]+)$/, v2: m => `/api/v2/feedback-forms/${m[1]}` }, + { method: 'GET', v1: /^\/api\/feedback\/event\/([^/]+)$/, v2: m => `/api/v2/events/${m[1]}/feedback` }, + { method: 'PUT', v1: /^\/api\/feedback\/event\/([^/]+)$/, v2: m => `/api/v2/events/${m[1]}/feedback` }, + { method: 'DELETE', v1: /^\/api\/feedback\/event\/([^/]+)$/, v2: m => `/api/v2/events/${m[1]}/feedback` }, + { method: 'POST', v1: /^\/api\/feedback\/event\/([^/]+)\/send-now$/, v2: m => `/api/v2/events/${m[1]}/feedback/send-now` }, // 1.51.10: managing registrations { method: 'GET', v1: /^\/api\/registrations\/?$/, v2: () => '/api/v2/registrations' }, { method: 'GET', v1: /^\/api\/registrations\/myregistrations$/, v2: () => '/api/v2/me/registrations/full' }, diff --git a/apps/events/backend/src/v2/index.ts b/apps/events/backend/src/v2/index.ts index af8a6e2..6b68e13 100644 --- a/apps/events/backend/src/v2/index.ts +++ b/apps/events/backend/src/v2/index.ts @@ -14,6 +14,7 @@ import './resources/events'; import './resources/me'; import './resources/registrations'; import './resources/registrationsManage'; +import './resources/money'; import './resources/checkin'; import './resources/auth'; @@ -86,7 +87,7 @@ const DOCS_HTML = ` sessionStorage.setItem('v2docs_token', t); if (params.has('token')) history.replaceState(null, '', location.pathname); document.getElementById('login').hidden = true; - var ui = SwaggerUIBundle({ spec: spec, dom_id: '#ui', deepLinking: true, persistAuthorization: false }); + var ui = SwaggerUIBundle({ spec: spec, dom_id: '#ui', deepLinking: true, persistAuthorization: false, docExpansion: 'none', filter: true }); ui.preauthorizeApiKey('bearerAuth', t); }).catch(function (e) { document.getElementById('login').hidden = false; diff --git a/apps/events/backend/src/v2/resources/money.ts b/apps/events/backend/src/v2/resources/money.ts new file mode 100644 index 0000000..2c5db45 --- /dev/null +++ b/apps/events/backend/src/v2/resources/money.ts @@ -0,0 +1,310 @@ +/** + * Money on v2 (1.51.11): payments and refunds, payment links and providers, cash-ups, provider + * transactions, the waitlist, sponsorship, consent, attendee form answers and feedback. Each + * route runs the v1 handler (viaV1.ts) behind the same access and campus checks as v1. + */ +import { z } from 'zod'; +import { id, idParams } from '../schemas'; +import { listData, v1Route } from '../viaV1'; + +/* eslint-disable @typescript-eslint/no-explicit-any -- v1 handlers and middleware are JavaScript */ +const rateLimit = require('express-rate-limit') as (opts: object) => any; +const cs = require('../../utils/campusScope') as { + scopeEvent(opts?: { need?: 'view' | 'manage'; resolve?: string; from?: (req: any) => unknown; ownerOk?: boolean }): any; + scopeBody(targets: [string, string][], opts?: { need?: 'view' | 'manage'; orphan?: 'pass' | 'deny' }): any; + scopeList: any; + unscopedOnly: any; +}; +const pay = require('../../controllers/paymentController'); +const providers = require('../../controllers/paymentProvidersController'); +const cashup = require('../../controllers/cashupController'); +const ptx = require('../../controllers/providerTransactionsController'); +const waitlist = require('../../controllers/waitlistController'); +const sponsor = require('../../controllers/sponsorshipController'); +const consent = require('../../controllers/consentController'); +const forms = require('../../controllers/formController'); +const feedback = require('../../controllers/feedbackController'); + +/** Optional text filters, passed to v1 as they come. */ +const filters = (...names: string[]) => z.looseObject(Object.fromEntries(names.map(n => [n, z.string().max(4000).optional()]))); +const paymentFilters = filters('page', 'limit', 'userId', 'from', 'donations', 'method', 'kind', 'startDate', 'endDate'); +const tokenParams = z.object({ token: z.string().min(1).max(200) }); +const asEvent = (ctx: any) => ({ params: { ...ctx.req.params, eventId: ctx.params.id } }); +// Links in messages are credentials, so guessing stays slow (as on v1). +const linkLimiter = () => rateLimit({ windowMs: 60 * 1000, max: 30, message: { message: 'Too many attempts. Please try again in a minute.' } }); +const SCOPE_LIST = 'scopeList (the handler filters by listWhere)'; +const UNSCOPED = 'unscopedOnly (admins and unscoped supervisors)'; + +// ─── Payments ──────────────────────────────────────────────────────────────── + +v1Route({ + method: 'get', path: '/payments/providers', tag: 'Payments', summary: 'The payment providers switched on', + access: 'public', v1: providers.listPaymentProviders, +}); +v1Route({ + method: 'get', path: '/payments/providers/settings', tag: 'Payments', summary: 'Payment provider settings', + description: 'Admins. Keys are masked.', access: 'admin', v1: providers.getPaymentProviderSettings, +}); +v1Route({ + method: 'put', path: '/payments/providers/settings', tag: 'Payments', summary: 'Change payment provider settings', + access: 'admin', body: z.looseObject({}), v1: providers.updatePaymentProviderSettings, +}); +v1Route({ + method: 'get', path: '/payments/open-checkouts', tag: 'Payments', summary: 'Checkouts started but not finished', + access: 'supervisor', campusScope: UNSCOPED, middleware: [cs.unscopedOnly], v1: providers.listOpenCheckouts, +}); +v1Route({ + method: 'post', path: '/payments/open-checkouts/check', tag: 'Payments', summary: 'Ask the provider about open checkouts', + description: 'Records any that were paid (for when a webhook was missed).', + access: 'supervisor', campusScope: UNSCOPED, middleware: [cs.unscopedOnly], body: z.looseObject({}), v1: providers.checkCheckoutStatus, +}); +v1Route({ + method: 'get', path: '/payments/stats', tag: 'Payments', summary: 'Payment totals', access: 'admin', query: paymentFilters, v1: pay.getPaymentStats, +}); +v1Route({ + method: 'get', path: '/payments', tag: 'Payments', summary: 'Every payment', + description: 'For the events you may see. `page` and `limit` page it (otherwise everything); see v1 for the filters it takes.', + access: 'supervisor', campusScope: SCOPE_LIST, middleware: [cs.scopeList], query: paymentFilters, v1: pay.getPayments, +}); +v1Route({ + method: 'post', path: '/payments', tag: 'Payments', summary: 'Record a payment', + description: 'Cash, card, EFT or other, against a registration or (a donation) an event. Paid in full issues and sends the tickets.', + access: 'supervisor', campusScope: 'scopeBody(registrationId, eventId; deny orphans)', status: 201, + middleware: [cs.scopeBody([['registrationId', 'registration'], ['eventId', 'event']], { orphan: 'deny' })], + body: z.looseObject({ registrationId: id.nullish(), eventId: id.nullish(), amount: z.union([z.number(), z.string()]), method: z.string().max(20).optional() }), + v1: pay.createPayment, +}); +v1Route({ + method: 'post', path: '/payments/refunds', tag: 'Payments', summary: 'Refund a payment', + access: 'supervisor', campusScope: 'scopeBody(paymentId, registrationId; manage, deny orphans)', status: 201, + middleware: [cs.scopeBody([['paymentId', 'payment'], ['registrationId', 'registration']], { need: 'manage', orphan: 'deny' })], + body: z.looseObject({ paymentId: id.optional(), registrationId: id.optional() }), v1: pay.createRefund, +}); +v1Route({ + method: 'post', path: '/payments/donations/assign', tag: 'Payments', summary: 'Put a donation towards a registration', + access: 'supervisor', campusScope: 'scopeBody(paymentId deny orphans; registrationId)', + middleware: [cs.scopeBody([['paymentId', 'payment']], { orphan: 'deny' }), cs.scopeBody([['registrationId', 'registration']])], + body: z.looseObject({ paymentId: id, registrationId: id }), v1: pay.assignDonationToRegistration, +}); +v1Route({ + method: 'post', path: '/payments/donations/unassign', tag: 'Payments', summary: 'Take a donation back off a registration', + access: 'supervisor', campusScope: 'scopeBody(legId; deny orphans)', middleware: [cs.scopeBody([['legId', 'payment']], { orphan: 'deny' })], + body: z.looseObject({ legId: id }), v1: pay.unassignDonationFromRegistration, +}); +v1Route({ + method: 'post', path: '/donations/checkout', tag: 'Payments', summary: 'Give to an event', + description: 'Starts a checkout for a donation of `amount` to `eventId`; answers where to send the person (`redirectUrl`).', + access: 'user', body: z.looseObject({ eventId: id, amount: z.union([z.number(), z.string()]) }), v1: pay.createCheckout, +}); +v1Route({ + method: 'get', path: '/me/payments', tag: 'Me', summary: 'My payments', access: 'user', query: paymentFilters, v1: pay.getUserPayments, +}); +v1Route({ + method: 'get', path: '/payments/:id', tag: 'Payments', summary: 'One payment', + access: 'user', campusScope: 'scopeEvent(payment, owner-ok)', middleware: [cs.scopeEvent({ resolve: 'payment', ownerOk: true })], params: idParams, v1: pay.getPaymentById, +}); +v1Route({ + method: 'post', path: '/payments/:id/receipt', tag: 'Payments', summary: 'Send the receipt again', + access: 'user', campusScope: 'scopeEvent(payment, owner-ok)', middleware: [cs.scopeEvent({ resolve: 'payment', ownerOk: true })], params: idParams, + body: z.looseObject({ channel: z.string().max(20).optional() }), v1: pay.sendReceipt, +}); +v1Route({ + method: 'get', path: '/registrations/:id/payments', tag: 'Payments', summary: 'A registration\'s payments', + access: 'user', campusScope: 'scopeEvent(registration, owner-ok)', middleware: [cs.scopeEvent({ resolve: 'registration', ownerOk: true })], params: idParams, + response: listData, map: ctx => ({ params: { registrationId: ctx.params.id } }), v1: pay.getPaymentsByRegistration, +}); +v1Route({ + method: 'post', path: '/registrations/:id/payment-link', tag: 'Payments', summary: 'Make a link to pay', + description: 'Supervisors: a checkout for `amount` (part of what\x27s owed) for someone else to pay. Answers `redirectUrl` (the link) — or `priceUpdated` when an early-bird price ran out.', + access: 'supervisor', campusScope: 'scopeEvent(registration)', middleware: [cs.scopeEvent({ resolve: 'registration' })], params: idParams, + body: z.looseObject({ amount: z.union([z.number(), z.string()]).optional() }), map: ctx => ({ body: { ...(ctx.req.body || {}), registrationId: ctx.params.id } }), v1: pay.createCheckout, +}); +v1Route({ + method: 'post', path: '/registrations/:id/payment-link/send', tag: 'Payments', summary: 'Send someone a link to pay', + description: 'By email and/or WhatsApp, for what\'s still owing.', + access: 'supervisor', campusScope: 'scopeEvent(registration)', middleware: [cs.scopeEvent({ resolve: 'registration' })], params: idParams, + body: z.looseObject({}), map: ctx => ({ body: { ...(ctx.req.body || {}), registrationId: ctx.params.id } }), v1: pay.sendPaymentLink, +}); +v1Route({ + method: 'get', path: '/events/:id/payments', tag: 'Payments', summary: 'An event\'s payments', + access: 'staff', campusScope: 'scopeEvent(view)', middleware: [cs.scopeEvent()], params: idParams, map: asEvent, v1: pay.getPaymentsByEvent, +}); +v1Route({ + method: 'get', path: '/payment-links/:id', tag: 'Payments', summary: 'A pay page', + description: 'What a payment link shows: what\'s owed and the providers to pay with. The id in the link is the credential.', + access: 'public', params: idParams, v1: providers.getPayPage, +}); +v1Route({ + method: 'post', path: '/payment-links/:id', tag: 'Payments', summary: 'Pay from a pay page', + description: 'Starts a checkout with the chosen provider; answers where to send the person.', + access: 'public', params: idParams, body: z.looseObject({ provider: z.string().max(40).optional() }), v1: providers.choosePayProvider, +}); + +// ─── Cash-ups ──────────────────────────────────────────────────────────────── + +const cashupBase = '/events/:id/cashup'; +v1Route({ + method: 'get', path: '/cashups/audit', tag: 'Cash-ups', summary: 'Cash-up history', access: 'supervisor', campusScope: SCOPE_LIST, middleware: [cs.scopeList], query: filters('eventId', 'from', 'to'), v1: cashup.getCashupAudit, +}); +v1Route({ + method: 'get', path: cashupBase, tag: 'Cash-ups', summary: 'An event\'s cash-up', + description: 'Income by method, costs, what each drawer should hold, and the saved draft.', + access: 'supervisor', campusScope: 'scopeEvent(manage)', middleware: [cs.scopeEvent({ need: 'manage' })], params: idParams, map: asEvent, v1: cashup.getEventCashup, +}); +v1Route({ + method: 'get', path: `${cashupBase}/cash-by-user`, tag: 'Cash-ups', summary: 'Cash taken by each person', + access: 'supervisor', campusScope: 'scopeEvent(manage)', middleware: [cs.scopeEvent({ need: 'manage' })], params: idParams, map: asEvent, v1: cashup.getCashByRecordedUser, +}); +v1Route({ + method: 'put', path: `${cashupBase}/person-cash/:userId`, tag: 'Cash-ups', summary: 'Count one person\'s cash', + access: 'supervisor', campusScope: 'scopeEvent(manage)', middleware: [cs.scopeEvent({ need: 'manage' })], params: z.object({ id, userId: id }), + body: z.looseObject({}), map: ctx => ({ params: { eventId: ctx.params.id, userId: ctx.params.userId } }), v1: cashup.savePersonCash, +}); +v1Route({ + method: 'put', path: `${cashupBase}/draft`, tag: 'Cash-ups', summary: 'Save the cash-up as a draft', + access: 'admin', params: idParams, body: z.looseObject({}), map: asEvent, v1: cashup.saveEventCashupDraft, +}); +v1Route({ + method: 'post', path: `${cashupBase}/close`, tag: 'Cash-ups', summary: 'Close the event', + description: 'Admins. Nothing about the event\'s money can change until it\'s reopened.', + access: 'admin', params: idParams, body: z.looseObject({}), map: asEvent, v1: cashup.closeEvent, +}); +v1Route({ + method: 'post', path: `${cashupBase}/reopen`, tag: 'Cash-ups', summary: 'Reopen a closed event', + access: 'admin', params: idParams, body: z.looseObject({}), map: asEvent, v1: cashup.reopenEvent, +}); +v1Route({ + method: 'post', path: '/cashup-lines/:id/pending', tag: 'Cash-ups', summary: 'Settle a pending cash-up line', + access: 'admin', params: idParams, body: z.looseObject({}), map: ctx => ({ params: { lineId: ctx.params.id } }), v1: cashup.resolvePending, +}); + +// ─── Provider transactions ─────────────────────────────────────────────────── + +v1Route({ + method: 'get', path: '/provider-transactions', tag: 'Payments', summary: 'Transactions from Yoco and PayFast', + access: 'supervisor', campusScope: UNSCOPED, middleware: [cs.unscopedOnly], query: filters('provider'), v1: ptx.getAllProviderTransactions, +}); +v1Route({ + method: 'get', path: '/provider-transactions/unreconciled', tag: 'Payments', summary: 'Provider transactions not matched yet', + access: 'supervisor', campusScope: UNSCOPED, middleware: [cs.unscopedOnly], v1: ptx.getUnreconciledProviderTransactions, +}); +v1Route({ + method: 'post', path: '/provider-transactions/:id/reconcile', tag: 'Payments', summary: 'Match a provider transaction to a registration', + access: 'supervisor', campusScope: UNSCOPED, middleware: [cs.unscopedOnly], params: idParams, body: z.looseObject({}), v1: ptx.reconcileProviderTransaction, +}); +v1Route({ + method: 'post', path: '/provider-transactions/:id/ignore', tag: 'Payments', summary: 'Ignore a provider transaction', + access: 'supervisor', campusScope: UNSCOPED, middleware: [cs.unscopedOnly], params: idParams, body: z.looseObject({}), v1: ptx.ignoreProviderTransaction, +}); + +// ─── Waitlist ──────────────────────────────────────────────────────────────── + +v1Route({ + method: 'post', path: '/waitlist', tag: 'Waitlist', summary: 'Join a sold-out event\'s waitlist', + description: 'Signed in, or with a name and email or phone. When places free up, people are offered them in order.', + access: 'optional', status: 201, body: z.looseObject({ eventId: id }), v1: waitlist.joinWaitlist, +}); +v1Route({ method: 'get', path: '/me/waitlist', tag: 'Me', summary: 'Waitlists I\'m on', access: 'user', v1: waitlist.myWaitlist }); +v1Route({ + method: 'get', path: '/waitlist/claims/:token', tag: 'Waitlist', summary: 'A waitlist offer', + description: 'What an offer link shows (the token is the credential). Register with `waitlistToken` to take it.', + access: 'public', middleware: [linkLimiter()], params: tokenParams, v1: waitlist.claimInfo, +}); +v1Route({ + method: 'get', path: '/events/:id/waitlist', tag: 'Waitlist', summary: 'An event\'s waitlist', + access: 'staff', campusScope: 'scopeEvent(view)', middleware: [cs.scopeEvent()], params: idParams, query: filters('all'), map: asEvent, v1: waitlist.eventWaitlist, +}); +for (const [action, summary, handler] of [['offer', 'Offer someone their places now', waitlist.offerManually], ['move', 'Move someone up or down the waitlist', waitlist.moveEntry], ['remove', 'Take someone off the waitlist', waitlist.removeEntry]] as const) { + v1Route({ + method: 'post', path: `/waitlist/:id/${action}`, tag: 'Waitlist', summary, + access: 'supervisor', campusScope: 'scopeEvent(waitlistEntry)', middleware: [cs.scopeEvent({ resolve: 'waitlistEntry' })], params: idParams, body: z.looseObject({}), v1: handler, + }); +} +v1Route({ method: 'delete', path: '/waitlist/:id', tag: 'Waitlist', summary: 'Leave a waitlist', access: 'user', params: idParams, v1: waitlist.leaveWaitlist }); + +// ─── Sponsorship ───────────────────────────────────────────────────────────── + +v1Route({ + method: 'get', path: '/events/:id/sponsorship', tag: 'Sponsorship', summary: 'Sponsoring places at an event', + description: 'Whether it\'s on, and the suggested amounts.', access: 'public', params: idParams, map: asEvent, v1: sponsor.getEventSponsorship, +}); +v1Route({ + method: 'get', path: '/events/:id/sponsorship/pool', tag: 'Sponsorship', summary: 'The sponsorship pool', + description: 'What\'s been given and what\'s been used.', access: 'supervisor', campusScope: 'scopeEvent(view)', middleware: [cs.scopeEvent()], params: idParams, map: asEvent, v1: sponsor.getPool, +}); +v1Route({ + method: 'post', path: '/sponsorships/checkout', tag: 'Sponsorship', summary: 'Give towards places', + description: 'Starts a checkout; answers where to send the person.', access: 'optional', body: z.looseObject({ eventId: id }), v1: sponsor.createSponsorCheckout, +}); + +// ─── Consent ───────────────────────────────────────────────────────────────── + +v1Route({ + method: 'get', path: '/events/:id/consent', tag: 'Consent', summary: 'Parental consent for an event', + access: 'staff', campusScope: 'scopeEvent(view)', middleware: [cs.scopeEvent()], params: idParams, map: asEvent, v1: consent.listEventConsent, +}); +v1Route({ + method: 'get', path: '/events/:id/consent/medical', tag: 'Consent', summary: 'Medical notes from consent forms', + access: 'supervisor', campusScope: 'scopeEvent(view)', middleware: [cs.scopeEvent()], params: idParams, map: asEvent, v1: consent.medicalList, +}); +v1Route({ + method: 'post', path: '/events/:id/consent/resend-pending', tag: 'Consent', summary: 'Remind everyone who hasn\'t answered', + access: 'supervisor', campusScope: 'scopeEvent(view)', middleware: [cs.scopeEvent()], params: idParams, body: z.looseObject({}), map: asEvent, v1: consent.resendPending, +}); +v1Route({ + method: 'post', path: '/events/:id/consent/rerequest', tag: 'Consent', summary: 'Ask for consent again', + description: 'After the consent wording changed.', access: 'supervisor', campusScope: 'scopeEvent(view)', middleware: [cs.scopeEvent()], params: idParams, + body: z.looseObject({}), map: ctx => ({ params: { eventId: ctx.params.id }, body: ctx.req.body }), v1: consent.rerequestConsent, +}); +v1Route({ + method: 'post', path: '/consent-requests/:id/resend', tag: 'Consent', summary: 'Send a consent request again', + access: 'user', campusScope: 'scopeEvent(consentRequest, owner-ok)', middleware: [cs.scopeEvent({ resolve: 'consentRequest', ownerOk: true })], params: idParams, + body: z.looseObject({}), v1: consent.resendRequest, +}); +v1Route({ + method: 'get', path: '/consent/:token', tag: 'Consent', summary: 'A consent form', + description: 'What the link in a consent request shows (the token is the parent\'s credential).', + access: 'public', middleware: [linkLimiter()], params: tokenParams, v1: consent.getConsent, +}); +v1Route({ + method: 'post', path: '/consent/:token', tag: 'Consent', summary: 'Answer a consent form', + access: 'public', middleware: [linkLimiter()], params: tokenParams, body: z.looseObject({}), v1: consent.answerConsent, +}); + +// ─── Attendee form answers ─────────────────────────────────────────────────── + +v1Route({ + method: 'get', path: '/form-responses', tag: 'Registrations', summary: 'Attendee form answers', + description: 'For an event (`eventId`) or a registration (`registrationId`), for events you may see.', + access: 'staff', campusScope: SCOPE_LIST, middleware: [cs.scopeList], query: filters('eventId', 'registrationId', 'userId', 'cursor'), v1: forms.listFormResponses, +}); + +// ─── Feedback ──────────────────────────────────────────────────────────────── + +v1Route({ + method: 'get', path: '/feedback/summary', tag: 'Feedback', summary: 'Feedback across events', access: 'supervisor', campusScope: SCOPE_LIST, middleware: [cs.scopeList], query: filters('eventIds'), v1: feedback.getSummary, +}); +v1Route({ + method: 'get', path: '/feedback-forms/:token', tag: 'Feedback', summary: 'A feedback form', + description: 'What the link sent after an event shows (the token is the credential).', access: 'public', params: tokenParams, v1: feedback.getPublicForm, +}); +v1Route({ + method: 'post', path: '/feedback-forms/:token', tag: 'Feedback', summary: 'Answer a feedback form', + access: 'public', params: tokenParams, body: z.looseObject({}), v1: feedback.submitPublicForm, +}); +v1Route({ + method: 'get', path: '/events/:id/feedback', tag: 'Feedback', summary: 'An event\'s feedback set-up and answers', + access: 'supervisor', campusScope: 'scopeEvent(view)', middleware: [cs.scopeEvent()], params: idParams, map: asEvent, v1: feedback.getEventFeedback, +}); +v1Route({ + method: 'put', path: '/events/:id/feedback', tag: 'Feedback', summary: 'Set up an event\'s feedback form', + access: 'supervisor', campusScope: 'scopeEvent(manage)', middleware: [cs.scopeEvent({ need: 'manage' })], params: idParams, body: z.looseObject({}), map: asEvent, v1: feedback.saveEventFeedback, +}); +v1Route({ + method: 'delete', path: '/events/:id/feedback', tag: 'Feedback', summary: 'Remove an event\'s feedback form', + access: 'supervisor', campusScope: 'scopeEvent(manage)', middleware: [cs.scopeEvent({ need: 'manage' })], params: idParams, map: asEvent, v1: feedback.deleteEventFeedback, +}); +v1Route({ + method: 'post', path: '/events/:id/feedback/send-now', tag: 'Feedback', summary: 'Send the feedback form now', + access: 'supervisor', campusScope: 'scopeEvent(manage)', middleware: [cs.scopeEvent({ need: 'manage' })], params: idParams, body: z.looseObject({}), map: asEvent, v1: feedback.sendNow, +}); diff --git a/apps/events/backend/src/v2/route.ts b/apps/events/backend/src/v2/route.ts index b217441..d607037 100644 --- a/apps/events/backend/src/v2/route.ts +++ b/apps/events/backend/src/v2/route.ts @@ -105,7 +105,7 @@ export function mount(router: Router, list: AnyRoute[] = routes): void { throw new ApiError('INTERNAL', 'Something went wrong on the server.'); } if (def.file) { - const f = (checked.data as { data: { contentType: string; filename: string; body: string } }).data; + const f = (checked.data as { data: { contentType: string; filename: string; body: string | Buffer } }).data; res.setHeader('Content-Type', f.contentType); res.setHeader('Content-Disposition', `attachment; filename="${f.filename.replace(/"/g, '')}"`); res.status(def.status ?? 200).send(f.body); @@ -121,4 +121,4 @@ export function mount(router: Router, list: AnyRoute[] = routes): void { } /** The `response` of a `file` route: what the handler hands back to be sent as a download. */ -export const fileResponse = z.object({ data: z.object({ contentType: z.string(), filename: z.string(), body: z.string() }) }); +export const fileResponse = z.object({ data: z.object({ contentType: z.string(), filename: z.string(), body: z.union([z.string(), z.instanceof(Buffer)]) }) }); diff --git a/apps/events/backend/src/v2/viaV1.ts b/apps/events/backend/src/v2/viaV1.ts new file mode 100644 index 0000000..3e3a611 --- /dev/null +++ b/apps/events/backend/src/v2/viaV1.ts @@ -0,0 +1,166 @@ +/** + * v2 routes that run a v1 handler in-process (1.51.11 –). The handler is the one v1 runs, so + * both versions behave the same; v2 adds its own path, validation, docs and response shape. + * + * - A v1 answer of 2xx becomes `{ data: }` (or a file download, for `file` routes). + * - A v1 error (`{ message, code? }` with 4xx/5xx) becomes the v2 error: the status picks `code`, + * v1's `code` becomes `reason`. + * + * The handlers are still JavaScript; moving each area into a TypeScript service (as 1.51.1 – + * 1.51.10 did) can follow later without changing the v2 API. + */ +import { Writable } from 'stream'; +import { z } from 'zod'; +import type { Request, RequestHandler } from 'express'; +import { defineRoute, fileResponse, type Access, type Ctx } from './route'; + +/* eslint-disable @typescript-eslint/no-explicit-any -- requests and v1 answers are passed through */ +type Parts = { params?: Record; query?: Record; body?: unknown }; +type V1Answer = { status: number; json?: unknown; body?: Buffer; headers: Record; redirect?: string }; + +/** A response that records what a v1 handler sends (JSON, `send`, a piped stream or a redirect). */ +class RecordingResponse extends Writable { + statusCode = 200; + headersSent = false; + locals: Record = {}; + readonly headers: Record = {}; + private chunks: Buffer[] = []; + json?: (v: unknown) => this; + answer?: V1Answer; + private done!: (a: V1Answer) => void; + readonly finished: Promise; + + constructor() { + super(); + this.finished = new Promise(resolve => { this.done = resolve; }); + this.json = (v: unknown) => this.finishWith({ json: JSON.parse(JSON.stringify(v ?? null)) }); + } + + override _write(chunk: any, _enc: BufferEncoding, cb: () => void) { this.chunks.push(Buffer.from(chunk)); cb(); } + override _final(cb: () => void) { this.finishWith({}); cb(); } + + private finishWith(extra: Partial): this { + if (this.answer) return this; + this.headersSent = true; + this.answer = { status: this.statusCode, headers: this.headers, body: Buffer.concat(this.chunks), ...extra }; + this.done(this.answer); + return this; + } + + status(code: number) { this.statusCode = code; return this; } + sendStatus(code: number) { this.statusCode = code; return this.finishWith({}); } + setHeader(name: string, value: unknown) { this.headers[name.toLowerCase()] = String(value); return this; } + getHeader(name: string) { return this.headers[name.toLowerCase()]; } + removeHeader(name: string) { delete this.headers[name.toLowerCase()]; } + set(name: string | Record, value?: unknown) { + if (typeof name === 'object') for (const [k, v] of Object.entries(name)) this.setHeader(k, v); + else this.setHeader(name, value); + return this; + } + header(name: string, value?: unknown) { return this.set(name, value); } + type(t: string) { return this.setHeader('content-type', t.includes('/') ? t : t === 'json' ? 'application/json' : `text/${t}`); } + attachment(filename?: string) { return filename ? this.setHeader('content-disposition', `attachment; filename="${filename}"`) : this; } + send(body?: unknown) { + if (body !== null && typeof body === 'object' && !Buffer.isBuffer(body)) return this.json!(body); + if (body !== undefined) this.chunks.push(Buffer.isBuffer(body) ? body : Buffer.from(String(body))); + return this.finishWith({}); + } + // A handler that ends without writing anything still answers. + override end(...args: any[]) { + const [chunk] = args; + if (chunk !== undefined && typeof chunk !== 'function') this.chunks.push(Buffer.from(chunk)); + this.finishWith({}); + return this; + } + redirect(a: number | string, b?: string) { + const url = typeof a === 'string' ? a : b!; + this.statusCode = typeof a === 'number' ? a : 302; + return this.finishWith({ redirect: url }); + } +} + +/** + * Runs v1 handlers (and middleware) for a v2 request. `parts` replaces the request's params, + * query or body (e.g. v2 `:id` given to v1 as `:eventId`); everything else (the user, headers, + * campus scope, read-only state) is the real request's. + */ +export async function runV1(handlers: RequestHandler | RequestHandler[], req: Request, parts: Parts = {}): Promise { + const fake = Object.create(req) as Request; + for (const key of ['params', 'query', 'body'] as const) { + if (parts[key] !== undefined) Object.defineProperty(fake, key, { value: parts[key], writable: true, configurable: true, enumerable: true }); + } + const res = new RecordingResponse(); + const chain = Array.isArray(handlers) ? handlers : [handlers]; + const step = (i: number): Promise => new Promise((resolve, reject) => { + let advanced = false; + const next = (err?: unknown) => { + advanced = true; + if (err) return reject(err); + if (i + 1 < chain.length) step(i + 1).then(resolve, reject); + else resolve(); + }; + Promise.resolve(chain[i](fake, res as any, next)).then(() => { if (!advanced) resolve(); }, reject); + }); + await Promise.race([step(0).then(() => res.finished), res.finished]); + return res.answer!; +} + +/** A v1 error answer as something v2's error handler understands. */ +function v1Error(a: V1Answer): Error { + const j = (a.json ?? {}) as { message?: unknown; error?: unknown; code?: unknown }; + const text = typeof j.message === 'string' ? j.message : typeof j.error === 'string' ? j.error : a.body?.length ? a.body.toString('utf8').slice(0, 500) : 'Request failed.'; + const e = new Error(text) as Error & { statusCode: number; code?: string }; + e.statusCode = a.status; + if (typeof j.code === 'string') e.code = j.code; + return e; +} + +/** `{ data: }` — for v1 answers documented by their description. */ +export const anyData = z.object({ data: z.unknown() }); +export const listData = z.object({ data: z.array(z.looseObject({})) }); +export const objectData = z.object({ data: z.looseObject({}) }); + +type V1RouteDef = { + method: 'get' | 'post' | 'put' | 'patch' | 'delete'; + path: string; + tag: string; + summary: string; + description?: string; + access: Access; + campusScope?: string; + middleware?: RequestHandler[]; + params?: z.ZodType; + query?: z.ZodType; + body?: z.ZodType; + response?: z.ZodType; + status?: number; + file?: { contentType: string }; + upload?: { field: string; description: string }; + /** The v1 handler (or middleware chain ending in one). */ + v1: RequestHandler | RequestHandler[]; + /** + * What v1 gets as params/query/body. By default: the v2 params, the raw query and the raw body + * (validated by `query`/`body` when given, but passed as sent so v1 sees what it always saw). + */ + map?: (ctx: Ctx) => Parts; +}; + +/** A v2 route answered by a v1 handler. */ +export function v1Route(def: V1RouteDef) { + const { v1, map, response, ...rest } = def; + return defineRoute({ + ...rest, + response: def.file ? fileResponse : (response ?? anyData), + async handler(ctx) { + const parts: Parts = { params: ctx.req.params, query: ctx.req.query as any, body: ctx.req.body, ...(map ? map(ctx) : {}) }; + const a = await runV1(v1, ctx.req, parts); + if (a.status >= 400) throw v1Error(a); + if (a.redirect) return { data: { redirectUrl: a.redirect } } as any; + if (def.file) { + const name = /filename="?([^";]+)"?/.exec(a.headers['content-disposition'] || '')?.[1] || 'download'; + return { data: { contentType: a.headers['content-type'] || def.file.contentType, filename: name, body: a.body ?? Buffer.alloc(0) } }; + } + return { data: a.json !== undefined ? a.json : (a.body?.length ? a.body.toString('utf8') : null) } as any; + }, + }); +} diff --git a/apps/events/backend/tests/v2.test.ts b/apps/events/backend/tests/v2.test.ts index 803e978..d70cdc1 100644 --- a/apps/events/backend/tests/v2.test.ts +++ b/apps/events/backend/tests/v2.test.ts @@ -50,6 +50,8 @@ jest.mock('../src/utils/campusScope', () => ({ scopeEvent: () => (_req: unknown, res: { status(n: number): { json(b: unknown): void } }, next: () => void) => (mockScope.blockEvent ? res.status(404).json({ message: 'Not found' }) : next()), scopeBody: () => (_req: unknown, _res: unknown, next: () => void) => next(), listWhere: async () => ({}), + scopeList: (_req: unknown, _res: unknown, next: () => void) => next(), + unscopedOnly: (_req: unknown, _res: unknown, next: () => void) => next(), })); const mockEvents = { listManagedEvents: jest.fn(), createEvent: jest.fn(), updateEvent: jest.fn(), deactivateEvent: jest.fn(), getNotifyRecipients: jest.fn(), setNotifyRecipients: jest.fn(), copySetupFrom: jest.fn() }; jest.mock('../src/services/events', () => Object.fromEntries(Object.keys(mockEvents).map(k => [k, (...a: unknown[]) => (mockEvents as Record)[k](...a)]))); @@ -86,6 +88,14 @@ const mockAdmin = { getRegistrations: jest.fn(), getUserRegistrations: jest.fn() jest.mock('../src/services/registrationAdmin', () => Object.fromEntries(Object.keys(mockAdmin).map(k => [k, (...a: unknown[]) => (mockAdmin as Record)[k](...a)]))); jest.mock('../src/utils/seasonPass', () => ({ notOnSeasonPass: (_req: unknown, _res: unknown, next: () => void) => next() })); +jest.mock('../src/controllers/cashupController', () => { + const echo = (req: { params: object; body: object }, res: { json(b: unknown): void }) => res.json({ params: req.params, body: req.body }); + return { + getEventCashup: echo, getCashByRecordedUser: echo, savePersonCash: echo, saveEventCashupDraft: echo, reopenEvent: echo, resolvePending: echo, getCashupAudit: echo, + closeEvent: (_req: unknown, res: { status(n: number): { json(b: unknown): void } }) => res.status(400).json({ message: 'There are pending lines.', code: 'PENDING_LINES' }), + }; +}); + import { v2Router } from '../src/v2'; import { ServiceError } from '../src/services/errors'; import { routes } from '../src/v2/route'; @@ -657,3 +667,27 @@ describe('managing registrations', () => { expect(res.body.error).toMatchObject({ code: 'VALIDATION_FAILED', message: 'Cannot reduce items below the amount already paid' }); }); }); + +describe('money (v1 handlers behind v2 routes)', () => { + test("an event's cash-up reaches v1 with the event as :eventId", async () => { + signedIn = { id: 'v1', role: 'supervisor' }; + const res = await request(app).get('/api/v2/events/e1/cashup'); + expect(res.status).toBe(200); + expect(res.body.data.params).toMatchObject({ eventId: 'e1' }); + }); + + test('closing is for admins, and a v1 refusal keeps its code as the reason', async () => { + signedIn = { id: 'v1', role: 'supervisor' }; + expect((await request(app).post('/api/v2/events/e1/cashup/close').send({})).status).toBe(403); + signedIn = { id: 'a1', role: 'admin' }; + const res = await request(app).post('/api/v2/events/e1/cashup/close').send({}); + expect(res.status).toBe(400); + expect(res.body.error).toEqual({ code: 'VALIDATION_FAILED', message: 'There are pending lines.', reason: 'PENDING_LINES' }); + }); + + test('a cash-up line is given to v1 as :lineId', async () => { + signedIn = { id: 'a1', role: 'admin' }; + const res = await request(app).post('/api/v2/cashup-lines/l9/pending').send({ resolution: 'paid' }); + expect(res.body.data).toEqual({ params: { lineId: 'l9' }, body: { resolution: 'paid' } }); + }); +}); diff --git a/apps/events/backend/tests/viaV1.test.ts b/apps/events/backend/tests/viaV1.test.ts new file mode 100644 index 0000000..151dc8e --- /dev/null +++ b/apps/events/backend/tests/viaV1.test.ts @@ -0,0 +1,75 @@ +import express from 'express'; +import request from 'supertest'; +import { PassThrough } from 'stream'; +import { z } from 'zod'; + +jest.mock('../src/config/db', () => ({})); +jest.mock('../src/middleware/authMiddleware', () => ({ protect: jest.fn(), optionalAuth: jest.fn(), admin: jest.fn(), staff: jest.fn(), supervisor: jest.fn() })); + +import { mount } from '../src/v2/route'; +import { errorHandler } from '../src/v2/errors'; +import { v1Route } from '../src/v2/viaV1'; +import type { RequestHandler } from 'express'; + +function appWith(...defs: ReturnType[]) { + const app = express(); + app.use(express.json()); + const router = express.Router(); + mount(router, defs); + app.use('/api/v2', router); + app.use('/api/v2', errorHandler); + return app; +} + +describe('v2 routes answered by v1 handlers', () => { + test("v1's JSON becomes data; v2's :id is given to v1 by its old name", async () => { + const handler: RequestHandler = (req, res) => { res.json({ eventId: req.params.eventId, q: req.query.x }); }; + const app = appWith(v1Route({ method: 'get', path: '/things/:id', tag: 'T', summary: 's', access: 'public', v1: handler, map: ctx => ({ params: { eventId: ctx.params.id } }), params: z.object({ id: z.string() }) })); + const res = await request(app).get('/api/v2/things/e1?x=2'); + expect(res.status).toBe(200); + expect(res.body).toEqual({ data: { eventId: 'e1', q: '2' } }); + }); + + test("a v1 error is a v2 error, with v1's code as the reason", async () => { + const handler: RequestHandler = (_req, res) => { res.status(409).json({ message: 'Already closed.', code: 'EVENT_CLOSED' }); }; + const app = appWith(v1Route({ method: 'post', path: '/close', tag: 'T', summary: 's', access: 'public', v1: handler })); + const res = await request(app).post('/api/v2/close').send({}); + expect(res.status).toBe(409); + expect(res.body).toEqual({ error: { code: 'CONFLICT', message: 'Already closed.', reason: 'EVENT_CLOSED' } }); + }); + + test('a thrown error and a next(err) both reach the error handler', async () => { + const thrower: RequestHandler = async () => { throw Object.assign(new Error('Nope.'), { statusCode: 403 }); }; + const passer: RequestHandler = (_req, _res, next) => next(Object.assign(new Error('Missing.'), { statusCode: 404 })); + const app = appWith( + v1Route({ method: 'get', path: '/a', tag: 'T', summary: 's', access: 'public', v1: thrower }), + v1Route({ method: 'get', path: '/b', tag: 'T', summary: 's', access: 'public', v1: passer }), + ); + expect((await request(app).get('/api/v2/a')).body.error).toMatchObject({ code: 'FORBIDDEN', message: 'Nope.' }); + expect((await request(app).get('/api/v2/b')).body.error).toMatchObject({ code: 'NOT_FOUND', message: 'Missing.' }); + }); + + test('middleware chains run in order', async () => { + const mark: RequestHandler = (req, _res, next) => { (req as unknown as { mark: string }).mark = 'yes'; next(); }; + const handler: RequestHandler = (req, res) => { res.json({ mark: (req as unknown as { mark: string }).mark }); }; + const app = appWith(v1Route({ method: 'get', path: '/m', tag: 'T', summary: 's', access: 'public', v1: [mark, handler] })); + expect((await request(app).get('/api/v2/m')).body).toEqual({ data: { mark: 'yes' } }); + }); + + test('a file a v1 handler pipes is sent as a download', async () => { + const handler: RequestHandler = (_req, res) => { + res.setHeader('Content-Type', 'application/pdf'); + res.setHeader('Content-Disposition', 'attachment; filename="ticket.pdf"'); + const s = new PassThrough(); + s.pipe(res); + s.write(Buffer.from('%PDF-1.4 ')); + s.end(Buffer.from('end')); + }; + const app = appWith(v1Route({ method: 'get', path: '/pdf', tag: 'T', summary: 's', access: 'public', file: { contentType: 'application/pdf' }, v1: handler })); + const res = await request(app).get('/api/v2/pdf').buffer(true).parse((r, cb) => { const c: Buffer[] = []; r.on('data', (d: Buffer) => c.push(d)); r.on('end', () => cb(null, Buffer.concat(c))); }); + expect(res.status).toBe(200); + expect(res.headers['content-type']).toContain('application/pdf'); + expect(res.headers['content-disposition']).toContain('ticket.pdf'); + expect((res.body as Buffer).toString()).toBe('%PDF-1.4 end'); + }); +}); diff --git a/apps/events/e2e/api-v2.spec.ts b/apps/events/e2e/api-v2.spec.ts index 07b4e5a..681dbaa 100644 --- a/apps/events/e2e/api-v2.spec.ts +++ b/apps/events/e2e/api-v2.spec.ts @@ -216,12 +216,38 @@ test.describe("API v2", () => { expect((await cancelled.json()).data.status).toBe("cancelled"); }); + test("money: providers, cash-up, my payments, and links that don't exist", async ({ request }) => { + const sup = { Authorization: `Bearer ${seed().users.supervisor.token}` }; + const user = { Authorization: `Bearer ${seed().users.user.token}` }; + const providers = await request.get(`${API}/api/v2/payments/providers`); + expect(providers.status()).toBe(200); + expect(await providers.json()).toHaveProperty("data"); + + const cash = await request.get(`${API}/api/v2/events/${seed().events.conference}/cashup`, { headers: sup }); + expect(cash.status()).toBe(200); + expect((await cash.json()).data).toBeTruthy(); + + const mine = await request.get(`${API}/api/v2/me/payments?page=1&limit=5`, { headers: user }); + expect(mine.status()).toBe(200); + + const page = await request.get(`${API}/api/v2/payments?page=1&limit=3`, { headers: sup }); + expect((await page.json()).data).toMatchObject({ page: 1, limit: 3 }); + + for (const path of ["/api/v2/waitlist/claims/not-a-real-token", "/api/v2/consent/not-a-real-token", "/api/v2/feedback-forms/not-a-real-token"]) { + const res = await request.get(`${API}${path}`); + expect(res.status(), path).toBeGreaterThanOrEqual(400); + expect((await res.json()).error.code, path).toMatch(/NOT_FOUND|VALIDATION_FAILED/); + } + }); + test("an admin can read the OpenAPI reference at /docs/v2", async ({ page, request }) => { const headers = { Authorization: `Bearer ${seed().users.user.token}` }; expect((await request.get(`${API}/api/v2/openapi.json`, { headers })).status()).toBe(403); await page.goto(`${API}/docs/v2?token=${seed().users.admin.token}`); await expect(page.getByRole("heading", { name: /Cross Events API/ })).toBeVisible(); + // Sections start collapsed (there are hundreds of endpoints): open Events. + await page.locator('h3.opblock-tag[data-tag="Events"]').click(); await expect(page.getByRole("button", { name: /^GET \/events\/\{id\} One public/ })).toBeVisible(); // The token isn't left in the address bar. expect(page.url()).not.toContain("token="); diff --git a/apps/events/frontend/src/app/consent/[token]/page.tsx b/apps/events/frontend/src/app/consent/[token]/page.tsx index 52d9255..ef40d63 100644 --- a/apps/events/frontend/src/app/consent/[token]/page.tsx +++ b/apps/events/frontend/src/app/consent/[token]/page.tsx @@ -3,9 +3,10 @@ import React, { useEffect, useState } from "react"; import { useParams } from "next/navigation"; import { Navbar } from "@/components/layout/Navbar"; import { Footer } from "@/components/layout/Footer"; -import { apiFetch, ApiError } from "@/lib/api"; +import { ApiError } from "@/lib/api"; import { formatDate } from "@/lib/date"; import { ShieldCheck, CheckCircle2, XCircle } from "lucide-react"; +import { apiV2Data } from "@/lib/apiV2"; type ConsentInfo = { status: "pending" | "given" | "declined"; @@ -39,7 +40,7 @@ export default function ConsentPage() { useEffect(() => { if (!token) return; - apiFetch(`/api/consent/${encodeURIComponent(token)}`) + (apiV2Data("get", "/consent/{token}", { params: { token: token } }) as Promise) .then(res => { setInfo(res); setSignedName(res.parentName || ""); }) .catch(e => setLoadError(e instanceof ApiError ? e.message : "Couldn't load this consent request.")); }, [token]); @@ -50,8 +51,8 @@ export default function ConsentPage() { if (decision === "give" && info.collect.photo && photoConsent === null) { setError("Please answer the photo consent question."); return; } setBusy(true); try { - await apiFetch(`/api/consent/${encodeURIComponent(token)}`, { - method: "POST", + await apiV2Data("post", "/consent/{token}", { + params: { token: token }, body: { decision, signedName, isGuardian, ...(decision === "give" && info.collect.medical ? { medical } : {}), diff --git a/apps/events/frontend/src/app/dashboard/admin/cashup/[id]/page.tsx b/apps/events/frontend/src/app/dashboard/admin/cashup/[id]/page.tsx index 673c9cd..12feb0e 100644 --- a/apps/events/frontend/src/app/dashboard/admin/cashup/[id]/page.tsx +++ b/apps/events/frontend/src/app/dashboard/admin/cashup/[id]/page.tsx @@ -3,13 +3,14 @@ import React, { useCallback, useEffect, useMemo, useState } from "react"; import { useParams } from "next/navigation"; import { useAuth } from "@/hooks/useAuth"; -import { apiFetch, fetchEvent } from "@/lib/api"; +import { fetchEvent } from "@/lib/api"; import { useDismissingState } from "@/hooks/useDismissingState"; import type { EventCost, EventCostType, EventFinancials, CashupMethod, CashupWriteOffCategory, ReconciledByMethod, Event } from "@/types"; import { Wallet, DollarSign, ClipboardCheck, FileBarChart } from "lucide-react"; import { errorMessage } from "@/lib/utils"; import { BackLink } from "@/components/shared/BackLink"; import { createCost, updateCost, deleteCost } from "@/lib/eventSetup"; +import { apiV2Data } from "@/lib/apiV2"; const METHOD_LABELS: Record = { cash: "Cash", card: "Card", eft: "EFT", other: "Other" }; const METHODS: CashupMethod[] = ["cash", "card", "eft", "other"]; @@ -42,7 +43,7 @@ export default function EventCashupPage() { setError(null); try { const [financials, event] = await Promise.all([ - apiFetch(`/api/cashups/event/${eventId}`, { authToken: token }), + (apiV2Data("get", "/events/{id}/cashup", { params: { id: eventId }, authToken: token }) as Promise), fetchEvent(eventId, { authToken: token }) ]); setData(financials); @@ -309,7 +310,7 @@ function CashByUserSection({ eventId, token, onCashSummaryChange }: { const load = useCallback(() => { if (!token || !eventId) return; setLoading(true); - apiFetch(`/api/cashups/event/${eventId}/cash-by-user`, { authToken: token }) + (apiV2Data("get", "/events/{id}/cashup/cash-by-user", { params: { id: eventId }, authToken: token }) as Promise) .then(r => { setData(r); onCashSummaryChange?.({ actualTotal: r?.cashActualTotal ?? null, denominations: r?.cashDenominations || [] }); }) .catch(() => setData({ rows: [], cashActualTotal: null, cashDenominations: [] })) .finally(() => setLoading(false)); @@ -458,8 +459,10 @@ function PersonCashCountEditor({ eventId, token, userId, initialDenominations, i const save = async () => { setSaving(true); setErr(null); try { - await apiFetch(`/api/cashups/event/${eventId}/person-cash/${userId}`, { - method: "PUT", authToken: token, body: { denominations: lines, notes: notes || null } + await apiV2Data("put", "/events/{id}/cashup/person-cash/{userId}", { + params: { id: eventId, userId: userId }, + authToken: token, + body: { denominations: lines, notes: notes || null }, }); onSaved(); } catch (e) { @@ -833,7 +836,7 @@ function PendingSettler({ method, r, token, onChanged }: { method: CashupMethod; if (!r.lineId || !mode) return; setSaving(true); setErr(null); try { - await apiFetch(`/api/cashups/lines/${r.lineId}/pending`, { method: "POST", authToken: token, body: { outcome: mode, amount: parseFloat(amount), category, notes: notes || null } }); + await apiV2Data("post", "/cashup-lines/{id}/pending", { params: { id: r.lineId }, authToken: token, body: { outcome: mode, amount: parseFloat(amount), category, notes: notes || null } }); setMode(null); onChanged(); } catch (e) { @@ -972,7 +975,7 @@ function ReconciliationTab({ eventId, token, data, busy, setBusy, setError, onCh const saveDraft = async () => { setBusy(true); setError(null); try { - await apiFetch(`/api/cashups/event/${eventId}/draft`, { method: "PUT", authToken: token, body: { lines: buildLinesPayload() } }); + await apiV2Data("put", "/events/{id}/cashup/draft", { params: { id: eventId }, authToken: token, body: { lines: buildLinesPayload() } }); onChanged(); } catch (e) { setError(errorMessage(e) || "Failed to save draft"); @@ -992,7 +995,7 @@ function ReconciliationTab({ eventId, token, data, busy, setBusy, setError, onCh if (!confirm(`Close this event with this cashup? Unallocated donations will be counted as profit and the event will be locked until it's reopened.${warning}`)) return; setBusy(true); setError(null); try { - await apiFetch(`/api/cashups/event/${eventId}/close`, { method: "POST", authToken: token, body: { lines: buildLinesPayload(), notes: closeNotes || null } }); + await apiV2Data("post", "/events/{id}/cashup/close", { params: { id: eventId }, authToken: token, body: { lines: buildLinesPayload(), notes: closeNotes || null } }); onChanged(); onClosed(); } catch (e) { @@ -1006,7 +1009,7 @@ function ReconciliationTab({ eventId, token, data, busy, setBusy, setError, onCh if (!confirm("Quick close this event without a cashup? System totals will be accepted as-is, unallocated donations will be counted as profit, and the event will be fully locked until it's reopened.")) return; setBusy(true); setError(null); try { - await apiFetch(`/api/cashups/event/${eventId}/close`, { method: "POST", authToken: token, body: { notes: closeNotes || null } }); + await apiV2Data("post", "/events/{id}/cashup/close", { params: { id: eventId }, authToken: token, body: { notes: closeNotes || null } }); onChanged(); onClosed(); } catch (e) { @@ -1020,7 +1023,7 @@ function ReconciliationTab({ eventId, token, data, busy, setBusy, setError, onCh if (!confirm("Reopen this event? Registrations, payments, refunds and donations will be allowed again.")) return; setBusy(true); setError(null); try { - await apiFetch(`/api/cashups/event/${eventId}/reopen`, { method: "POST", authToken: token, body: { notes: reopenNotes || null } }); + await apiV2Data("post", "/events/{id}/cashup/reopen", { params: { id: eventId }, authToken: token, body: { notes: reopenNotes || null } }); onChanged(); } catch (e) { setError(errorMessage(e) || "Failed to reopen event"); diff --git a/apps/events/frontend/src/app/dashboard/admin/registrations/page.tsx b/apps/events/frontend/src/app/dashboard/admin/registrations/page.tsx index 87e1811..becd3b9 100644 --- a/apps/events/frontend/src/app/dashboard/admin/registrations/page.tsx +++ b/apps/events/frontend/src/app/dashboard/admin/registrations/page.tsx @@ -3,7 +3,7 @@ import React, { useCallback, useEffect, useMemo, useState } from "react"; import { useAuth } from "@/hooks/useAuth"; import { useRouter } from "next/navigation"; -import { apiFetch, fetchManagedEvents, fetchAllRegistrations } from "@/lib/api"; +import { fetchManagedEvents, fetchAllRegistrations } from "@/lib/api"; import { useDismissingState } from "@/hooks/useDismissingState"; import { ClipboardList } from "lucide-react"; import { errorMessage } from "@/lib/utils"; @@ -125,7 +125,7 @@ export default function AdminRegistrationsPage() { if (!formResponses[id] && !loadingForms.has(id)) { setLoadingForms(prev => new Set(prev).add(id)); try { - const res = await apiFetch<{ items?: FormResponse[] } | FormResponse[]>(`/api/forms/responses?registrationId=${encodeURIComponent(id)}`, { authToken: token! }); + const res = await (apiV2Data("get", "/form-responses", { query: { registrationId: id }, authToken: token }) as Promise<{ items?: FormResponse[] } | FormResponse[]>); const items = Array.isArray(res) ? res : (Array.isArray(res?.items) ? res.items : []); setFormResponses(prev => ({ ...prev, [id]: items })); } catch { diff --git a/apps/events/frontend/src/app/dashboard/supervisor/at-the-door/page.tsx b/apps/events/frontend/src/app/dashboard/supervisor/at-the-door/page.tsx index 95eb7d3..72dd334 100644 --- a/apps/events/frontend/src/app/dashboard/supervisor/at-the-door/page.tsx +++ b/apps/events/frontend/src/app/dashboard/supervisor/at-the-door/page.tsx @@ -704,14 +704,13 @@ function DoorPaymentPanel({ token, registration, onSuccess, setError }: { try { setSaving(true); - await apiFetch("/api/payments", { - method: "POST", - authToken: token, - body: { + await apiV2Data("post", "/payments", { + authToken: token, + body: { registrationId: registration.id, amount: parseFloat(amount), method - } + }, }); const updated = await (apiV2Data("get", "/registrations/{id}/full", { @@ -1426,16 +1425,15 @@ function DonationModal({ open, onClose, user, token, eventId, onSuccess, setErro try { setSaving(true); - await apiFetch("/api/payments", { - method: "POST", - authToken: token, - body: { + await apiV2Data("post", "/payments", { + authToken: token, + body: { amount: amt, method, userId: user?.id || undefined, eventId, isDonation: true - } + }, }); onSuccess?.(); @@ -1665,16 +1663,15 @@ function RefundModal({ open, onClose, token, registration, maxRefund, onRefunded setSaving(true); setLocalError(""); try { - await apiFetch("/api/payments/refund", { - method: "POST", - authToken: token, - body: { + await apiV2Data("post", "/payments/refunds", { + authToken: token, + body: { userId: registration.userId, registrationId: registration.id, amount: amt, method, reason: reason || undefined, - } + }, }); // Re-fetch registration to get updated status & payments const updated = await (apiV2Data("get", "/registrations/{id}/full", { params: { id: registration.id }, authToken: token }) as Promise); diff --git a/apps/events/frontend/src/app/dashboard/supervisor/consent/page.tsx b/apps/events/frontend/src/app/dashboard/supervisor/consent/page.tsx index 52e1145..426bfe2 100644 --- a/apps/events/frontend/src/app/dashboard/supervisor/consent/page.tsx +++ b/apps/events/frontend/src/app/dashboard/supervisor/consent/page.tsx @@ -3,7 +3,7 @@ import React, { useCallback, useEffect, useMemo, useState } from "react"; import { useAuth } from "@/hooks/useAuth"; import { useRouter, useSearchParams } from "next/navigation"; -import { apiFetch, fetchManagedEvents } from "@/lib/api"; +import { fetchManagedEvents } from "@/lib/api"; import { formatDate } from "@/lib/date"; import { useDismissingState } from "@/hooks/useDismissingState"; import { ShieldCheck, Send, RefreshCw, HeartPulse, Printer } from "lucide-react"; @@ -12,6 +12,7 @@ import { errorMessage } from "@/lib/utils"; import type { Event, ConsentRow, MedicalRow } from "@/types"; import { BackLink } from "@/components/shared/BackLink"; import { EventPicker, defaultEventId } from "@/components/shared/EventPicker"; +import { apiV2Data } from "@/lib/apiV2"; const STATUS_STYLE: Record = { @@ -38,7 +39,8 @@ export default function ConsentTrackerPage() { const [events, setEvents] = useState([]); const [eventId, setEventId] = useState(search.get("eventId") || ""); - const [data, setData] = useState<{ event: Pick; counts: Record; rows: ConsentRow[] } | null>(null); + type ConsentData = { event: Pick; counts: Record; rows: ConsentRow[] }; + const [data, setData] = useState(null); const [filter, setFilter] = useState<"minors" | "all" | "waiting">("minors"); const [busy, setBusy] = useState(false); const [error, setError] = useDismissingState(null); @@ -60,7 +62,7 @@ export default function ConsentTrackerPage() { if (!token || !eventId) return; setBusy(true); try { - setData(await apiFetch(`/api/consent/events/${encodeURIComponent(eventId)}`, { authToken: token })); + setData(await (apiV2Data("get", "/events/{id}/consent", { params: { id: eventId }, authToken: token }) as Promise)); } catch (e) { setError(errorMessage(e) || "Failed to load consent status"); } finally { @@ -79,10 +81,10 @@ export default function ConsentTrackerPage() { const outdatedCount = (data?.rows || []).filter(r => r.request?.outdated || (r.minor && r.status === "missing")).length; - const act = async (fn: () => Promise<{ message: string }>) => { + const act = async (fn: () => Promise) => { setBusy(true); try { - const res = await fn(); + const res = (await fn()) as { message: string }; setInfo(res.message); await load(); } catch (e) { @@ -92,14 +94,14 @@ export default function ConsentTrackerPage() { } }; - const resendOne = (r: ConsentRow) => act(() => apiFetch(`/api/consent/requests/${r.request!.id}/resend`, { method: "POST", authToken: token! })); - const resendAll = () => act(() => apiFetch(`/api/consent/events/${eventId}/resend-pending`, { method: "POST", authToken: token! })); - const rerequest = () => act(() => apiFetch(`/api/consent/events/${eventId}/rerequest`, { method: "POST", authToken: token! })); + const resendOne = (r: ConsentRow) => act(() => apiV2Data("post", "/consent-requests/{id}/resend", { params: { id: r.request!.id }, authToken: token, body: {} })); + const resendAll = () => act(() => apiV2Data("post", "/events/{id}/consent/resend-pending", { params: { id: eventId }, authToken: token, body: {} })); + const rerequest = () => act(() => apiV2Data("post", "/events/{id}/consent/rerequest", { params: { id: eventId }, authToken: token, body: {} })); // Printable list for camp leaders. Opening it is recorded in the audit log. const printMedical = async () => { try { - const res = await apiFetch<{ event: Pick; rows: MedicalRow[] }>(`/api/consent/events/${eventId}/medical`, { authToken: token! }); + const res = await (apiV2Data("get", "/events/{id}/consent/medical", { params: { id: eventId }, authToken: token }) as Promise<{ event: Pick; rows: MedicalRow[] }>); const w = window.open("", "_blank"); if (!w) { setError("Allow pop-ups to print the medical list."); return; } const rowsHtml = res.rows.map(r => ` diff --git a/apps/events/frontend/src/app/dashboard/supervisor/events/page.tsx b/apps/events/frontend/src/app/dashboard/supervisor/events/page.tsx index d9a81a0..1b6b299 100644 --- a/apps/events/frontend/src/app/dashboard/supervisor/events/page.tsx +++ b/apps/events/frontend/src/app/dashboard/supervisor/events/page.tsx @@ -1077,7 +1077,7 @@ function EventModal({ mode, event: ev, source, onClose, onSuccess }: EventModalP const feedbackFrom = mode === "edit" ? ev?.id : cloning ? source?.id : undefined; useEffect(() => { if (!feedbackFrom || !token) return; - apiFetch(`/api/feedback/event/${feedbackFrom}`, { authToken: token }).then(f => { + (apiV2Data("get", "/events/{id}/feedback", { params: { id: feedbackFrom }, authToken: token }) as Promise).then(f => { if (!f) return; setFbEnabled(true); if (cloning) { @@ -1111,8 +1111,9 @@ function EventModal({ mode, event: ev, source, onClose, onSuccess }: EventModalP }; const saveFeedback = async (eventId: string) => { if (fbEnabled) { - await apiFetch(`/api/feedback/event/${eventId}`, { - method: "PUT", authToken: token || undefined, + await apiV2Data("put", "/events/{id}/feedback", { + params: { id: eventId }, + authToken: token, body: { sendAt: fbSettings.sendAt ? new Date(fbSettings.sendAt).toISOString() : null, audience: fbSettings.audience, anonymous: fbSettings.anonymous, intro: fbSettings.intro || null, @@ -1120,7 +1121,7 @@ function EventModal({ mode, event: ev, source, onClose, onSuccess }: EventModalP }, }); } else if (fbMeta) { - await apiFetch(`/api/feedback/event/${eventId}`, { method: "DELETE", authToken: token || undefined }); + await apiV2Data("delete", "/events/{id}/feedback", { params: { id: eventId }, authToken: token }); } }; diff --git a/apps/events/frontend/src/app/dashboard/supervisor/forms/page.tsx b/apps/events/frontend/src/app/dashboard/supervisor/forms/page.tsx index c3dc341..b5e169d 100644 --- a/apps/events/frontend/src/app/dashboard/supervisor/forms/page.tsx +++ b/apps/events/frontend/src/app/dashboard/supervisor/forms/page.tsx @@ -4,7 +4,7 @@ import { ExtraFieldInput, isExtraFieldType, ChoicesEditor } from "@/components/s import React, { useCallback, useEffect, useMemo, useRef, useState } from "react"; import { useAuth } from "@/hooks/useAuth"; import { useRouter } from "next/navigation"; -import { apiFetch, fetchAllUsers, fetchManagedEvents, fetchEvent } from "@/lib/api"; +import { fetchAllUsers, fetchManagedEvents, fetchEvent } from "@/lib/api"; import { useDismissingState } from "@/hooks/useDismissingState"; import { FileText } from "lucide-react"; import { errorMessage } from "@/lib/utils"; @@ -221,8 +221,7 @@ export default function FormsBrowserPage() { if (userId.trim()) qs.set("userId", userId.trim()); if (registrationId.trim()) qs.set("registrationId", registrationId.trim()); if (append && nextCursor) qs.set("cursor", nextCursor); - const url = "/api/forms/responses" + (qs.toString() ? `?${qs.toString()}` : ""); - const res = await apiFetch<{ items: FormResponse[]; nextCursor?: string }>(url, { authToken: token }); + const res = await (apiV2Data("get", "/form-responses", { query: Object.fromEntries(qs), authToken: token }) as Promise<{ items: FormResponse[]; nextCursor?: string }>); const newItems = Array.isArray(res?.items) ? res!.items : []; setItems(prev => append ? [...prev, ...newItems] : newItems); setNextCursor(res?.nextCursor || null); @@ -380,7 +379,7 @@ export default function FormsBrowserPage() { const evFull = await fetchEvent(reg.event.id); setFillForm(toFormDef(evFull?.form)); } - const resList = await apiFetch<{ items?: FormResponse[] } | FormResponse[]>(`/api/forms/responses?registrationId=${encodeURIComponent(fillRegistrationId)}`, { authToken: token! }); + const resList = await (apiV2Data("get", "/form-responses", { query: { registrationId: fillRegistrationId }, authToken: token }) as Promise<{ items?: FormResponse[] } | FormResponse[]>); setExistingResponses(responseItems(resList)); } catch (e) { setError(errorMessage(e) || 'Failed to load registration/form'); @@ -441,7 +440,7 @@ export default function FormsBrowserPage() { body: { responses: editableResponses }, }); setInfo('Responses saved'); - const resList = await apiFetch<{ items?: FormResponse[] } | FormResponse[]>(`/api/forms/responses?registrationId=${encodeURIComponent(fillRegistrationId)}`, { authToken: token! }); + const resList = await (apiV2Data("get", "/form-responses", { query: { registrationId: fillRegistrationId }, authToken: token }) as Promise<{ items?: FormResponse[] } | FormResponse[]>); setExistingResponses(responseItems(resList)); } catch (e) { setError(errorMessage(e) || 'Failed to save responses'); diff --git a/apps/events/frontend/src/app/dashboard/supervisor/manual/page.tsx b/apps/events/frontend/src/app/dashboard/supervisor/manual/page.tsx index f43eaa2..77549ae 100644 --- a/apps/events/frontend/src/app/dashboard/supervisor/manual/page.tsx +++ b/apps/events/frontend/src/app/dashboard/supervisor/manual/page.tsx @@ -3,7 +3,7 @@ import React, { useEffect, useMemo, useRef, useState } from "react"; import { useAuth } from "@/hooks/useAuth"; import { useRouter } from "next/navigation"; -import { apiFetch, fetchAllUsers, fetchManagedEvents, fetchEvent, fetchAllRegistrations } from "@/lib/api"; +import { fetchAllUsers, fetchManagedEvents, fetchEvent, fetchAllRegistrations } from "@/lib/api"; import { scoreUser } from "@/lib/fuzzyMatch"; import { useDismissingState } from "@/hooks/useDismissingState"; import { CouponCodeField, AppliedCoupon } from "@/components/shared/CouponCodeField"; @@ -164,8 +164,7 @@ export default function ManualRegistrationPage() { if (!payRegistrationId) { setPayError("Please select a registration"); return; } try { setPaySubmitting(true); - await apiFetch("/api/payments", { - method: "POST", + await apiV2Data("post", "/payments", { authToken: token, body: { amount: amt, @@ -174,7 +173,7 @@ export default function ManualRegistrationPage() { registrationId: payRegistrationId, isDonation: false, paidAt: payPaidAtLocal ? new Date(payPaidAtLocal).toISOString() : undefined, - } + }, }); setPayMessage(`Payment recorded (R ${amt.toFixed(2)}).`); setPayAmount(""); diff --git a/apps/events/frontend/src/app/dashboard/supervisor/payments/page.tsx b/apps/events/frontend/src/app/dashboard/supervisor/payments/page.tsx index e2691ec..daf2b0a 100644 --- a/apps/events/frontend/src/app/dashboard/supervisor/payments/page.tsx +++ b/apps/events/frontend/src/app/dashboard/supervisor/payments/page.tsx @@ -3,7 +3,7 @@ import React, { Suspense, useCallback, useEffect, useMemo, useRef, useState } from "react"; import { useAuth } from "@/hooks/useAuth"; import { useRouter, useSearchParams } from "next/navigation"; -import { apiFetch, fetchAllUsers, fetchAllPayments, fetchManagedEvents, fetchAllRegistrations } from "@/lib/api"; +import { fetchAllUsers, fetchAllPayments, fetchManagedEvents, fetchAllRegistrations } from "@/lib/api"; import { useDismissingState } from "@/hooks/useDismissingState"; import { scoreUser } from "@/lib/fuzzyMatch"; import { Wallet, RotateCcw, HandHeart, ScanLine, Link2 } from "lucide-react"; @@ -14,6 +14,7 @@ import { BackLink } from "@/components/shared/BackLink"; import { useOnlinePayments } from "@/lib/onlinePayments"; import { WaitingForPayment } from "@/components/payments/WaitingForPayment"; import { EventPicker } from "@/components/shared/EventPicker"; +import { apiV2Data } from "@/lib/apiV2"; // A donation is never mutated once created — assigning it to a registration creates a separate // "leg" Payment row (isDonation:false, originalPaymentId -> the donation, amount > 0) instead. @@ -193,7 +194,7 @@ function PaymentsContent() { setLoadingList(true); const start = new Date(); start.setHours(0, 0, 0, 0); const [recent, today, donations] = await Promise.all([ - apiFetch<{ data: Payment[] }>("/api/payments?page=1&limit=40", { authToken: token }), + (apiV2Data("get", "/payments", { query: { page: "1", limit: "40" }, authToken: token }) as Promise<{ data: Payment[] }>), fetchAllPayments(token, { from: start.toISOString() }), fetchAllPayments(token, { donations: "1" }), ]); @@ -301,17 +302,16 @@ function PaymentsContent() { if (!amt || amt <= 0) { setError("Enter a valid amount"); return; } try { setLinkGenerating(true); - const res = await apiFetch<{ redirectUrl?: string; checkoutId?: string; amount?: number; priceUpdated?: boolean; message?: string }>("/api/payments/checkout", { - method: "POST", + const res = await (apiV2Data("post", "/registrations/{id}/payment-link", { + params: { id: linkRegistrationId }, authToken: token, body: { - registrationId: linkRegistrationId, amount: amt, successUrl: window.location.origin + "/payment/success", cancelUrl: window.location.origin + "/payment/cancel", failureUrl: window.location.origin + "/payment/failure", }, - }); + }) as Promise<{ redirectUrl?: string; checkoutId?: string; amount?: number; priceUpdated?: boolean; message?: string }>); if (res.priceUpdated) { setError(res.message || "Pricing has changed for this registration; please re-check the amount."); return; @@ -342,10 +342,10 @@ function PaymentsContent() { setError(null); setInfo(null); try { setLinkSending(channel); - await apiFetch("/api/payments/checkout/send", { - method: "POST", + await apiV2Data("post", "/registrations/{id}/payment-link/send", { + params: { id: linkResult.registrationId }, authToken: token, - body: { registrationId: linkResult.registrationId, redirectUrl: linkResult.redirectUrl, channel }, + body: { redirectUrl: linkResult.redirectUrl, channel }, }); setInfo(`Payment link sent via ${channel === "email" ? "email" : "WhatsApp"}`); } catch (e) { @@ -405,8 +405,7 @@ function PaymentsContent() { } try { setSubmitting(true); - await apiFetch("/api/payments", { - method: "POST", + await apiV2Data("post", "/payments", { authToken: token, body: { amount: amt, @@ -416,7 +415,7 @@ function PaymentsContent() { eventId: eventId || undefined, isDonation: !!isDonation, paidAt: paidAtLocal ? new Date(paidAtLocal).toISOString() : undefined, - } + }, }); setInfo(`Payment created (R ${amt.toFixed(2)})`); setAmount(""); setRegistrationId(""); setIsDonation(false); setEventId(""); setPaidAtLocal(""); @@ -447,7 +446,7 @@ function PaymentsContent() { if (!token) return; try { setTxLoading(true); - const res = await apiFetch<{ data?: ProviderTx[] } | ProviderTx[]>("/api/provider-transactions/unreconciled", { authToken: token }); + const res = await (apiV2Data("get", "/provider-transactions/unreconciled", { authToken: token }) as Promise<{ data?: ProviderTx[] } | ProviderTx[]>); const items = Array.isArray(res) ? res : (Array.isArray(res?.data) ? res.data : []); setProviderTxs(items); } catch { @@ -486,18 +485,18 @@ function PaymentsContent() { setReconcileForm(prev => ({ ...prev, submitting: true })); if (type === 'reg') { if (!registrationId) { setError('Please select a registration'); return; } - await apiFetch(`/api/provider-transactions/${encodeURIComponent(txId)}/reconcile`, { - method: 'POST', + await apiV2Data("post", "/provider-transactions/{id}/reconcile", { + params: { id: txId }, authToken: token, - body: { registrationId } + body: { registrationId }, }); setInfo('Reconciled to registration'); } else { if (!eventId) { setError('Please select an event'); return; } - await apiFetch(`/api/provider-transactions/${encodeURIComponent(txId)}/reconcile`, { - method: 'POST', + await apiV2Data("post", "/provider-transactions/{id}/reconcile", { + params: { id: txId }, authToken: token, - body: { eventId, userId: userId || undefined } + body: { eventId, userId: userId || undefined }, }); setInfo('Reconciled as donation'); } @@ -617,7 +616,7 @@ function PaymentsContent() { const ok = window.confirm('Ignore this transaction? It will be marked as ignored and reconciled.'); if (!ok) return; try { - await apiFetch(`/api/provider-transactions/${encodeURIComponent(tx.id)}/ignore`, { method: 'POST', authToken: token }); + await apiV2Data("post", "/provider-transactions/{id}/ignore", { params: { id: tx.id }, authToken: token, body: {} }); setInfo('Transaction ignored'); await loadUnreconciled(); } catch (e) { @@ -935,9 +934,8 @@ function RefundSection({ allUsers, onDone }: RefundSectionProps) { if (!method) { setErr('Select a refund method'); return; } try { setSubmitting(true); - await apiFetch('/api/payments/refund', { - method: 'POST', - authToken: token!, + await apiV2Data("post", "/payments/refunds", { + authToken: token, body: { userId, amount: amt, @@ -945,7 +943,7 @@ function RefundSection({ allUsers, onDone }: RefundSectionProps) { paymentId: target === 'payment' ? paymentId : undefined, registrationId: target === 'registration' ? registrationId : undefined, reason: reason || undefined - } + }, }); setUserId(""); setPaymentId(""); setRegistrationId(""); setAmount(""); setReason(""); setMethod(""); await onDone(); @@ -1083,10 +1081,9 @@ function AssignedDonationsList({ payments, onDone }: AssignedDonationsListProps) if (!ok) return; try { setUnassigningId(leg.id); - await apiFetch('/api/payments/unassign-donation', { - method: 'POST', + await apiV2Data("post", "/payments/donations/unassign", { authToken: token, - body: { legId: leg.id } + body: { legId: leg.id }, }); await onDone(); } catch (e) { @@ -1266,8 +1263,7 @@ function DonationAssignSection({ payments, allUsers, registrations, regOutstandi if (amountNum > maxAllocatable + 0.000001) { setErr(`Cannot allocate more than R ${maxAllocatable.toFixed(2)}`); return; } try { setAssigning(true); - await apiFetch('/api/payments/assign-donation', { - method: 'PUT', + await apiV2Data("post", "/payments/donations/assign", { authToken: token, body: { paymentId, registrationId, amount: amountNum } }); diff --git a/apps/events/frontend/src/app/dashboard/supervisor/waitlist/page.tsx b/apps/events/frontend/src/app/dashboard/supervisor/waitlist/page.tsx index 182c0e3..7519f0e 100644 --- a/apps/events/frontend/src/app/dashboard/supervisor/waitlist/page.tsx +++ b/apps/events/frontend/src/app/dashboard/supervisor/waitlist/page.tsx @@ -3,7 +3,7 @@ import React, { useCallback, useEffect, useMemo, useState } from "react"; import { useAuth } from "@/hooks/useAuth"; import { useRouter, useSearchParams } from "next/navigation"; -import { apiFetch, fetchManagedEvents } from "@/lib/api"; +import { fetchManagedEvents } from "@/lib/api"; import { formatDate } from "@/lib/date"; import { useDismissingState } from "@/hooks/useDismissingState"; import { ListChecks, ArrowUp, ArrowDown } from "lucide-react"; @@ -13,6 +13,7 @@ import { entryLineName } from "@/lib/waitlist"; import type { Event } from "@/types"; import { BackLink } from "@/components/shared/BackLink"; import { EventPicker } from "@/components/shared/EventPicker"; +import { apiV2Data } from "@/lib/apiV2"; type Entry = { id: string; @@ -72,7 +73,7 @@ export default function WaitlistPage() { if (!token || !eventId) return; setBusy(true); try { - setEntries(await apiFetch(`/api/waitlist/events/${encodeURIComponent(eventId)}`, { authToken: token })); + setEntries(await (apiV2Data("get", "/events/{id}/waitlist", { params: { id: eventId }, authToken: token }) as Promise)); } catch (e) { setError(errorMessage(e) || "Failed to load the waitlist"); } finally { @@ -81,10 +82,11 @@ export default function WaitlistPage() { }, [token, eventId, setError]); useEffect(() => { load(); }, [load]); - const act = async (path: string, body?: { direction: "up" | "down" }) => { + const act = async (id: string, action: "offer" | "move" | "remove", body: { direction?: "up" | "down" } = {}) => { setBusy(true); try { - const res = await apiFetch<{ message?: string }>(path, { method: "POST", authToken: token!, body }); + const path = action === "offer" ? "/waitlist/{id}/offer" : action === "move" ? "/waitlist/{id}/move" : "/waitlist/{id}/remove"; + const res = await (apiV2Data("post", path, { params: { id }, authToken: token, body }) as Promise<{ message?: string }>); if (res?.message) setInfo(res.message); await load(); } catch (e) { @@ -164,15 +166,15 @@ export default function WaitlistPage() { {e.status === "waiting" && ( <> - - + + )} {(e.status === "waiting" || e.status === "expired") && ( - + )} {active && ( - + )} )} diff --git a/apps/events/frontend/src/app/dashboard/user/donate/page.tsx b/apps/events/frontend/src/app/dashboard/user/donate/page.tsx index 4503f07..0fa1e7b 100644 --- a/apps/events/frontend/src/app/dashboard/user/donate/page.tsx +++ b/apps/events/frontend/src/app/dashboard/user/donate/page.tsx @@ -2,6 +2,7 @@ import React, { useEffect, useState } from "react"; import { useAuth } from "@/hooks/useAuth"; import { apiFetch } from "@/lib/api"; +import { apiV2Data } from "@/lib/apiV2"; import { useDismissingState } from "@/hooks/useDismissingState"; import { HandHeart } from "lucide-react"; import { errorMessage } from "@/lib/utils"; @@ -41,8 +42,7 @@ export default function DonatePage() { setError(null); setInfo(null); setLoading(true); - const res = await apiFetch<{ redirectUrl: string }>("/api/payments/checkout", { - method: "POST", + const res = await (apiV2Data("post", "/donations/checkout", { body: { eventId, amount: amt, @@ -51,7 +51,7 @@ export default function DonatePage() { failureUrl: window.location.origin + "/payment/failure", }, authToken: token, - }); + }) as Promise<{ redirectUrl: string }>); setInfo("Redirecting to payment..."); window.location.href = res.redirectUrl; } catch (e) { diff --git a/apps/events/frontend/src/app/dashboard/user/page.tsx b/apps/events/frontend/src/app/dashboard/user/page.tsx index c49672c..9f6c5a2 100644 --- a/apps/events/frontend/src/app/dashboard/user/page.tsx +++ b/apps/events/frontend/src/app/dashboard/user/page.tsx @@ -143,7 +143,7 @@ export default function UserDashboardPage() { await Promise.all( myRegs.map(async (r) => { try { - const pays = await apiFetch(`/api/payments/registration/${encodeURIComponent(r.id)}`, { authToken: token }); + const pays = await (apiV2Data("get", "/registrations/{id}/payments", { params: { id: r.id }, authToken: token }) as Promise); const totalPaid = pays.reduce((s, p) => s + (p.amount || 0), 0); // totalDueComputed is not time-dependent, no need to recompute per payment time const totalDue = r.totalDueComputed ?? (r.registrationOptions || []).reduce((sum, opt) => sum + registrationOptionUnitPrice(opt, null, new Date()) * (opt.quantity || 0), 0); @@ -295,11 +295,11 @@ export default function UserDashboardPage() { loadingSubtitle: "Please wait while we prepare your receipt.", }); try { - const res = await apiFetch<{ message?: string }>(`/api/payments/${encodeURIComponent(paymentId)}/send-receipt`, { - method: "POST", + const res = await (apiV2Data("post", "/payments/{id}/receipt", { + params: { id: paymentId }, body: { channel }, authToken: token, - }); + }) as Promise<{ message?: string }>); setDialog({ open: true, loading: false, title: "Receipt sent", message: (res && res.message) || "Receipt sent." }); } catch (e) { setDialog({ open: false, message: "", loading: false }); @@ -333,7 +333,7 @@ export default function UserDashboardPage() { try { const now = new Date(); const r = await (apiV2Data("get", "/registrations/{id}/full", { params: { id: registrationId }, authToken: token }) as Promise); - const pays = await apiFetch(`/api/payments/registration/${encodeURIComponent(registrationId)}`, { authToken: token }); + const pays = await (apiV2Data("get", "/registrations/{id}/payments", { params: { id: registrationId }, authToken: token }) as Promise); const totalPaid = pays.reduce((s, p) => s + (p.amount || 0), 0); const totalDue = (r.registrationOptions || []).reduce((sum, opt) => sum + registrationOptionUnitPrice(opt, null, now) * (opt.quantity || 0), 0); setBilling(prev => ({ ...prev, [registrationId]: { totalDue, totalPaid, outstanding: Math.max(0, totalDue - totalPaid), payments: pays } })); @@ -417,7 +417,7 @@ export default function UserDashboardPage() { const myRegs = await (apiV2Data("get", "/me/registrations/full", { query: { past: showPast ? "true" : "false" }, authToken: token }) as Promise); setRegistrations(myRegs); const updated = myRegs.find(r => r.id === activeRegId); - const pays = await apiFetch(`/api/payments/registration/${encodeURIComponent(activeRegId)}`, { authToken: token }); + const pays = await (apiV2Data("get", "/registrations/{id}/payments", { params: { id: activeRegId }, authToken: token }) as Promise); const totalPaid = pays.reduce((s, p) => s + (p.amount || 0), 0); const totalDue = updated?.totalDueComputed ?? 0; setBilling(prev => ({ ...prev, [activeRegId]: { totalDue, totalPaid, outstanding: Math.max(0, totalDue - totalPaid), payments: pays } })); @@ -614,7 +614,7 @@ export default function UserDashboardPage() { setBilling(totals); // Payments will be refreshed lazily or on next open; fetch for this one immediately try { - const pays = await apiFetch(`/api/payments/registration/${encodeURIComponent(activeReg.id)}`, { authToken: token }); + const pays = await (apiV2Data("get", "/registrations/{id}/payments", { params: { id: activeReg.id }, authToken: token }) as Promise); const totalPaid = pays.reduce((s, p) => s + (p.amount || 0), 0); const totalDue = totals[activeReg.id]?.totalDue ?? 0; setBilling(prev => ({ diff --git a/apps/events/frontend/src/app/dashboard/user/payments/page.tsx b/apps/events/frontend/src/app/dashboard/user/payments/page.tsx index 8e66d8e..da5eeec 100644 --- a/apps/events/frontend/src/app/dashboard/user/payments/page.tsx +++ b/apps/events/frontend/src/app/dashboard/user/payments/page.tsx @@ -2,7 +2,6 @@ import React, { useCallback, useEffect, useState } from "react"; import { useAuth } from "@/hooks/useAuth"; import { useRouter } from "next/navigation"; -import { apiFetch } from "@/lib/api"; import { useDismissingState } from "@/hooks/useDismissingState"; import { formatDateTime } from "@/lib/date"; import { formatPaymentMethod } from "@/lib/paymentMethod"; @@ -10,6 +9,7 @@ import { Receipt } from "lucide-react"; import { errorMessage } from "@/lib/utils"; import type { Paginated } from "@/types"; import { BackLink } from "@/components/shared/BackLink"; +import { apiV2Data } from "@/lib/apiV2"; interface PaymentItem { id: string; @@ -52,11 +52,11 @@ export default function UserPaymentsPage() { setInfo(null); setSendingReceipt(true); try { - const res = await apiFetch<{ message?: string }>(`/api/payments/${encodeURIComponent(paymentId)}/send-receipt`, { - method: "POST", + const res = await (apiV2Data("post", "/payments/{id}/receipt", { + params: { id: paymentId }, body: { channel }, authToken: token, - }); + }) as Promise<{ message?: string }>); setInfo((res && res.message) || "Receipt sent."); } catch (e) { setError(errorMessage(e) || "Failed to send receipt"); @@ -77,7 +77,7 @@ export default function UserPaymentsPage() { if (endDate) qs.set("endDate", endDate); if (method) qs.set("method", method); if (kind) qs.set("kind", kind); - return `/api/payments/mypayments?${qs.toString()}`; + return Object.fromEntries(qs); }, [startDate, endDate, method, kind]); const loadPayments = useCallback(async (p = 1) => { @@ -85,7 +85,7 @@ export default function UserPaymentsPage() { setError(null); setFetching(true); try { - const res = await apiFetch>(buildQuery(p), { authToken: token }); + const res = await (apiV2Data("get", "/me/payments", { query: buildQuery(p), authToken: token }) as Promise>); setPayments(Array.isArray(res?.data) ? res.data : []); setTotal(res?.total ?? 0); setTotalPages(res?.pages ?? 1); diff --git a/apps/events/frontend/src/app/feedback/[token]/page.tsx b/apps/events/frontend/src/app/feedback/[token]/page.tsx index 6be2ca2..43f61b3 100644 --- a/apps/events/frontend/src/app/feedback/[token]/page.tsx +++ b/apps/events/frontend/src/app/feedback/[token]/page.tsx @@ -3,11 +3,11 @@ import React, { useEffect, useState } from "react"; import { useParams } from "next/navigation"; import { Navbar } from "@/components/layout/Navbar"; import { Footer } from "@/components/layout/Footer"; -import { apiFetch } from "@/lib/api"; import { formatDate } from "@/lib/date"; import { MessageSquareHeart, CheckCircle2 } from "lucide-react"; import { ExtraFieldInput, isExtraFieldType } from "@/components/shared/FormFieldExtras"; import { errorMessage } from "@/lib/utils"; +import { apiV2Data } from "@/lib/apiV2"; type Field = { id: string; type: string; label: string; isRequired: boolean; helpText: string | null; options: unknown }; type FeedbackInfo = { @@ -34,7 +34,7 @@ export default function FeedbackPage() { useEffect(() => { if (!token) return; - apiFetch(`/api/feedback/public/${encodeURIComponent(token)}`) + (apiV2Data("get", "/feedback-forms/{token}", { params: { token: token } }) as Promise) .then(setInfo) .catch(e => setLoadError(e?.message || "This feedback link isn't valid.")); }, [token]); @@ -45,7 +45,7 @@ export default function FeedbackPage() { setBusy(true); setError(null); try { - await apiFetch(`/api/feedback/public/${encodeURIComponent(token!)}`, { method: "POST", body: { answers } }); + await apiV2Data("post", "/feedback-forms/{token}", { params: { token: token }, body: { answers } }); setDone(true); } catch (err) { setError(errorMessage(err) || "Couldn't send your feedback"); diff --git a/apps/events/frontend/src/app/pay/[id]/page.tsx b/apps/events/frontend/src/app/pay/[id]/page.tsx index f0ebd53..4276771 100644 --- a/apps/events/frontend/src/app/pay/[id]/page.tsx +++ b/apps/events/frontend/src/app/pay/[id]/page.tsx @@ -3,8 +3,9 @@ import React, { useCallback, useEffect, useRef, useState } from "react"; import { useParams } from "next/navigation"; import { Navbar } from "@/components/layout/Navbar"; import { Footer } from "@/components/layout/Footer"; -import { apiFetch, ApiError } from "@/lib/api"; +import { ApiError } from "@/lib/api"; import { CreditCard } from "lucide-react"; +import { apiV2Data } from "@/lib/apiV2"; type ProviderForm = { action: string; fields: Record }; type PayPage = { @@ -40,7 +41,7 @@ export default function PayPage() { useEffect(() => { if (!id) return; - apiFetch(`/api/payments/pay/${encodeURIComponent(id)}`) + (apiV2Data("get", "/payment-links/{id}", { params: { id: id } }) as Promise) .then(p => { setPage(p); if (p.status === "open") go(p); @@ -56,7 +57,7 @@ export default function PayPage() { setBusy(provider); setError(null); try { - go(await apiFetch<{ redirectUrl: string | null; form: ProviderForm | null }>(`/api/payments/pay/${encodeURIComponent(id)}`, { method: "POST", body: { provider } })); + go(await (apiV2Data("post", "/payment-links/{id}", { params: { id: id }, body: { provider } }) as Promise<{ redirectUrl: string | null; form: ProviderForm | null }>)); } catch (e) { setError(e instanceof ApiError ? e.message : "Couldn't start the payment. Please try again."); setBusy(null); diff --git a/apps/events/frontend/src/app/register/[eventId]/RegisterForm.tsx b/apps/events/frontend/src/app/register/[eventId]/RegisterForm.tsx index 50acad5..f5ce539 100644 --- a/apps/events/frontend/src/app/register/[eventId]/RegisterForm.tsx +++ b/apps/events/frontend/src/app/register/[eventId]/RegisterForm.tsx @@ -2,8 +2,7 @@ import React, { useEffect, useMemo, useState } from "react"; import { useAuth } from "@/hooks/useAuth"; -import { apiFetch } from "@/lib/api"; -import { apiV2 } from "@/lib/apiV2"; +import { apiV2, apiV2Data } from "@/lib/apiV2"; import { useOnlinePayments } from "@/lib/onlinePayments"; import { CouponCodeField, AppliedCoupon } from "@/components/shared/CouponCodeField"; import { BundleBuilder, BundleOffers, BundleSavings, useBundleQuote } from "@/components/shared/BundleDeals"; @@ -394,7 +393,7 @@ export default function RegisterForm({ event: baseEvent }: { event: RegisterEven useEffect(() => { const t = new URLSearchParams(window.location.search).get("waitlist"); if (!t) return; - apiFetch(`/api/waitlist/claim/${encodeURIComponent(t)}`) + (apiV2Data("get", "/waitlist/claims/{token}", { params: { token: t } }) as Promise) .then(res => { if (res.status !== "offered") { setOfferError("This waitlist offer has expired."); return; } setWaitlistToken(t); diff --git a/apps/events/frontend/src/app/waitlist/claim/[token]/page.tsx b/apps/events/frontend/src/app/waitlist/claim/[token]/page.tsx index ea75767..4587964 100644 --- a/apps/events/frontend/src/app/waitlist/claim/[token]/page.tsx +++ b/apps/events/frontend/src/app/waitlist/claim/[token]/page.tsx @@ -3,9 +3,10 @@ import React, { useEffect, useState } from "react"; import { useParams } from "next/navigation"; import { Navbar } from "@/components/layout/Navbar"; import { Footer } from "@/components/layout/Footer"; -import { apiFetch, ApiError } from "@/lib/api"; +import { ApiError } from "@/lib/api"; import { formatDate } from "@/lib/date"; import { ListChecks } from "lucide-react"; +import { apiV2Data } from "@/lib/apiV2"; type Claim = { status: "offered" | "expired"; @@ -30,7 +31,7 @@ export default function WaitlistClaimPage() { useEffect(() => { if (!token) return; - apiFetch(`/api/waitlist/claim/${encodeURIComponent(token)}`) + (apiV2Data("get", "/waitlist/claims/{token}", { params: { token: token } }) as Promise) .then(setClaim) .catch(e => setError(e instanceof ApiError ? e.message : "Couldn't load this offer.")); }, [token]); diff --git a/apps/events/frontend/src/components/admin/PaymentsTab.tsx b/apps/events/frontend/src/components/admin/PaymentsTab.tsx index e69ad25..4aa32b7 100644 --- a/apps/events/frontend/src/components/admin/PaymentsTab.tsx +++ b/apps/events/frontend/src/components/admin/PaymentsTab.tsx @@ -3,11 +3,11 @@ import React, { useCallback, useEffect, useState } from "react"; import { ArrowDown, ArrowUp, Wallet } from "lucide-react"; import { useAuth } from "@/hooks/useAuth"; -import { apiFetch } from "@/lib/api"; import { useDismissingState } from "@/hooks/useDismissingState"; import { errorMessage } from "@/lib/utils"; import { YocoTab } from "@/components/admin/YocoTab"; import { PayFastSettings } from "@/components/admin/PayFastSettings"; +import { apiV2Data } from "@/lib/apiV2"; type ProviderSetting = { id: string; label: string; enabled: boolean; configured: boolean }; @@ -25,7 +25,7 @@ export function PaymentsTab({ active }: { active: boolean }) { const load = useCallback(async () => { if (!token) return; try { - const res = await apiFetch<{ providers: ProviderSetting[]; minimumAmount: number }>("/api/payments/providers/settings", { authToken: token }); + const res = await (apiV2Data("get", "/payments/providers/settings", { authToken: token }) as Promise<{ providers: ProviderSetting[]; minimumAmount: number }>); setProviders(res.providers); setMinimum(res.minimumAmount); } catch (e) { @@ -40,9 +40,10 @@ export function PaymentsTab({ active }: { active: boolean }) { setProviders(next); setSaving(true); try { - const res = await apiFetch<{ message: string; providers: ProviderSetting[] }>("/api/payments/providers/settings", { - method: "PUT", authToken: token, body: { providers: next.map(p => ({ id: p.id, enabled: p.enabled })) }, - }); + const res = await (apiV2Data("put", "/payments/providers/settings", { + authToken: token, + body: { providers: next.map(p => ({ id: p.id, enabled: p.enabled })) }, + }) as Promise<{ message: string; providers: ProviderSetting[] }>); setProviders(res.providers); setMessage({ type: "ok", text: res.message }); } catch (e) { diff --git a/apps/events/frontend/src/components/events/JoinWaitlistButton.tsx b/apps/events/frontend/src/components/events/JoinWaitlistButton.tsx index f0a5195..ba9623f 100644 --- a/apps/events/frontend/src/components/events/JoinWaitlistButton.tsx +++ b/apps/events/frontend/src/components/events/JoinWaitlistButton.tsx @@ -2,10 +2,11 @@ import React, { useState } from "react"; import { ListPlus, X } from "lucide-react"; -import { apiFetch, ApiError } from "@/lib/api"; +import { ApiError } from "@/lib/api"; import { useAuth } from "@/hooks/useAuth"; import type { WaitlistLine } from "@/lib/waitlist"; import { ModalOverlay } from "@/components/shared/ModalOverlay"; +import { apiV2Data } from "@/lib/apiV2"; export type { WaitlistLine }; @@ -40,9 +41,8 @@ export function JoinWaitlistButton({ eventId, lines, guestsAllowed, initialLine, setBusy(true); setError(null); try { - const res = await apiFetch<{ message: string }>("/api/waitlist", { - method: "POST", - authToken: token || undefined, + const res = await (apiV2Data("post", "/waitlist", { + authToken: token, body: { eventId, eventOptionId: line.eventOptionId, @@ -51,7 +51,7 @@ export function JoinWaitlistButton({ eventId, lines, guestsAllowed, initialLine, quantity: qty, ...(!loggedIn ? { guestName: guest.name.trim(), guestEmail: guest.email.trim(), guestPhone: guest.phone.trim() || undefined } : {}), }, - }); + }) as Promise<{ message: string }>); setDone(res.message); } catch (err) { setError(err instanceof ApiError ? err.message : "Couldn't join the waitlist. Please try again."); diff --git a/apps/events/frontend/src/components/events/SponsorSpot.tsx b/apps/events/frontend/src/components/events/SponsorSpot.tsx index abfb365..73984bb 100644 --- a/apps/events/frontend/src/components/events/SponsorSpot.tsx +++ b/apps/events/frontend/src/components/events/SponsorSpot.tsx @@ -2,11 +2,11 @@ import React, { useEffect, useState } from "react"; import { HeartHandshake, X } from "lucide-react"; -import { apiFetch } from "@/lib/api"; import { useAuth } from "@/hooks/useAuth"; import { errorMessage } from "@/lib/utils"; import { useOnlinePayments } from "@/lib/onlinePayments"; import { ModalOverlay } from "@/components/shared/ModalOverlay"; +import { apiV2Data } from "@/lib/apiV2"; type Sponsorship = { enabled: boolean; open?: boolean; spotPrice?: number | null; showProgress?: boolean; goalSpots?: number | null; spotsFunded?: number | null; sponsors?: number | null }; @@ -35,7 +35,7 @@ export function SponsorSpot({ eventId, eventTitle }: { eventId: string; eventTit const online = useOnlinePayments(); useEffect(() => { - apiFetch(`/api/sponsorships/event/${encodeURIComponent(eventId)}`).then(setData).catch(() => setData(null)); + (apiV2Data("get", "/events/{id}/sponsorship", { params: { id: eventId } }) as Promise).then(setData).catch(() => setData(null)); try { const s = new URLSearchParams(window.location.search).get("sponsored"); if (s) setReturned(s); @@ -55,8 +55,7 @@ export function SponsorSpot({ eventId, eventTitle }: { eventId: string; eventTit setBusy(true); setError(null); try { - const res = await apiFetch<{ redirectUrl: string }>("/api/sponsorships/checkout", { - method: "POST", + const res = await (apiV2Data("post", "/sponsorships/checkout", { ...(loggedIn ? { authToken: token! } : {}), body: { eventId, @@ -66,7 +65,7 @@ export function SponsorSpot({ eventId, eventTitle }: { eventId: string; eventTit ...(message.trim() ? { message: message.trim() } : {}), ...(!loggedIn ? { name: guest.name, email: guest.email } : {}), }, - }); + }) as Promise<{ redirectUrl: string }>); window.location.href = res.redirectUrl; } catch (err) { setError(errorMessage(err) || "Couldn't start the payment"); diff --git a/apps/events/frontend/src/components/payments/WaitingForPayment.tsx b/apps/events/frontend/src/components/payments/WaitingForPayment.tsx index 5a12c25..f6ebd94 100644 --- a/apps/events/frontend/src/components/payments/WaitingForPayment.tsx +++ b/apps/events/frontend/src/components/payments/WaitingForPayment.tsx @@ -1,8 +1,8 @@ "use client"; import React, { useCallback, useEffect, useState } from "react"; -import { apiFetch } from "@/lib/api"; import { errorMessage } from "@/lib/utils"; +import { apiV2Data } from "@/lib/apiV2"; type OpenCheckout = { id: string; @@ -40,7 +40,7 @@ export function WaitingForPayment({ token, onRecorded }: { token: string | null; const load = useCallback(async () => { if (!token) return; try { - const res = await apiFetch<{ checkouts: OpenCheckout[] }>("/api/payments/checkouts/open", { authToken: token }); + const res = await (apiV2Data("get", "/payments/open-checkouts", { authToken: token }) as Promise<{ checkouts: OpenCheckout[] }>); setList(res.checkouts); } catch (e) { setMessage({ ok: false, text: errorMessage(e) || "Couldn't load waiting payments" }); @@ -53,9 +53,10 @@ export function WaitingForPayment({ token, onRecorded }: { token: string | null; setBusy(ids?.[0] || "all"); setMessage(null); try { - const res = await apiFetch<{ results: Record; recorded: number; message: string }>("/api/payments/checkouts/check", { - method: "POST", authToken: token, body: ids ? { ids } : {}, - }); + const res = await (apiV2Data("post", "/payments/open-checkouts/check", { + authToken: token, + body: ids ? { ids } : {}, + }) as Promise<{ results: Record; recorded: number; message: string }>); setResults(r => ({ ...r, ...res.results })); setMessage({ ok: true, text: res.message }); if (res.recorded > 0) onRecorded(); diff --git a/apps/events/frontend/src/components/reports/ReportsV2.tsx b/apps/events/frontend/src/components/reports/ReportsV2.tsx index ca89941..e419441 100644 --- a/apps/events/frontend/src/components/reports/ReportsV2.tsx +++ b/apps/events/frontend/src/components/reports/ReportsV2.tsx @@ -318,7 +318,7 @@ export default function ReportsV2({ backHref }: { backHref?: string } = {}) { const byEv: Record = {}; for (const id of eventIds) { try { - const list = await apiFetch(`/api/payments/event/${encodeURIComponent(id)}`, { authToken: token }); + const list = await (apiV2Data("get", "/events/{id}/payments", { params: { id: id }, authToken: token }) as Promise); byEv[id] = Array.isArray(list) ? list : []; } catch { byEv[id] = []; @@ -360,7 +360,7 @@ export default function ReportsV2({ backHref }: { backHref?: string } = {}) { const byEv: Record = {}; for (const id of eventIds) { try { - byEv[id] = await apiFetch(`/api/cashups/event/${encodeURIComponent(id)}`, { authToken: token }); + byEv[id] = await (apiV2Data("get", "/events/{id}/cashup", { params: { id: id }, authToken: token }) as Promise); } catch { byEv[id] = null; } @@ -383,7 +383,7 @@ export default function ReportsV2({ backHref }: { backHref?: string } = {}) { const loadFeedback = async (eventIds: string[]) => { if (!token || !eventIds.length) return []; try { - return await apiFetch(`/api/feedback/summary?eventIds=${encodeURIComponent(eventIds.join(","))}`, { authToken: token }); + return await (apiV2Data("get", "/feedback/summary", { query: { eventIds: eventIds.join(",") }, authToken: token }) as Promise); } catch { return []; } @@ -412,7 +412,7 @@ export default function ReportsV2({ backHref }: { backHref?: string } = {}) { const ev = filteredEvents.find((e) => e.id === id); if (!ev?.requiresParentalConsent) continue; try { - const res = await apiFetch<{ rows?: (ConsentRow | MedicalRow)[] }>(`/api/consent/events/${encodeURIComponent(id)}${kind === "medical" ? "/medical" : ""}`, { authToken: token }); + const res = await ((kind === "medical" ? apiV2Data("get", "/events/{id}/consent/medical", { params: { id }, authToken: token }) : apiV2Data("get", "/events/{id}/consent", { params: { id }, authToken: token })) as Promise<{ rows?: (ConsentRow | MedicalRow)[] }>); (res?.rows || []).forEach((r) => out.push({ ...r, eventTitle: ev.title })); } catch { /* not allowed or not found — skip */ } } @@ -426,7 +426,7 @@ export default function ReportsV2({ backHref }: { backHref?: string } = {}) { if (auditTo) query.set("to", auditTo); if (eventIds.length === 1) query.set("eventId", eventIds[0]); try { - const rows = await apiFetch(`/api/cashups/audit?${query.toString()}`, { authToken: token }); + const rows = await (apiV2Data("get", "/cashups/audit", { query: Object.fromEntries(query), authToken: token }) as Promise); const idSet = new Set(eventIds); const filtered = eventIds.length > 1 ? (rows || []).filter(r => idSet.has(r.eventId)) : (rows || []); return computeAuditDeltas(filtered).sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime()); diff --git a/apps/events/frontend/src/components/shared/AttendeesPanel.tsx b/apps/events/frontend/src/components/shared/AttendeesPanel.tsx index 4f2f5aa..e23d8ee 100644 --- a/apps/events/frontend/src/components/shared/AttendeesPanel.tsx +++ b/apps/events/frontend/src/components/shared/AttendeesPanel.tsx @@ -2,7 +2,6 @@ import React, { useMemo, useState } from "react"; import { Users, Send } from "lucide-react"; -import { apiFetch } from "@/lib/api"; import { isMinorOn } from "@/components/shared/AttendeeNamesEditor"; import { errorMessage } from "@/lib/utils"; import type { Attendee } from "@/types"; @@ -139,7 +138,7 @@ export function AttendeesPanel({ registration, token, canEdit, hasForm, onSaved, const resendConsent = async (requestId: string) => { try { - const res = await apiFetch<{ message: string }>(`/api/consent/requests/${encodeURIComponent(requestId)}/resend`, { method: "POST", authToken: token }); + const res = await (apiV2Data("post", "/consent-requests/{id}/resend", { params: { id: requestId }, authToken: token, body: {} }) as Promise<{ message: string }>); onMessage(res.message); } catch (e) { setError(errorMessage(e) || "Couldn't re-send the consent request"); diff --git a/apps/events/frontend/src/components/shared/MyWaitlists.tsx b/apps/events/frontend/src/components/shared/MyWaitlists.tsx index 732e9ab..5b50be0 100644 --- a/apps/events/frontend/src/components/shared/MyWaitlists.tsx +++ b/apps/events/frontend/src/components/shared/MyWaitlists.tsx @@ -2,9 +2,9 @@ import React, { useCallback, useEffect, useState } from "react"; import { ListChecks } from "lucide-react"; -import { apiFetch } from "@/lib/api"; import { errorMessage } from "@/lib/utils"; import { entryLineName } from "@/lib/waitlist"; +import { apiV2Data } from "@/lib/apiV2"; type Entry = { id: string; @@ -22,7 +22,7 @@ type Entry = { export function MyWaitlists({ token, onMessage }: { token: string; onMessage: (m: string) => void }) { const [entries, setEntries] = useState([]); const load = useCallback(() => { - apiFetch("/api/waitlist/mine", { authToken: token }).then(setEntries).catch(() => setEntries([])); + (apiV2Data("get", "/me/waitlist", { authToken: token }) as Promise).then(setEntries).catch(() => setEntries([])); }, [token]); useEffect(() => { load(); }, [load]); @@ -30,7 +30,7 @@ export function MyWaitlists({ token, onMessage }: { token: string; onMessage: (m const leave = async (id: string) => { try { - const res = await apiFetch<{ message: string }>(`/api/waitlist/${encodeURIComponent(id)}`, { method: "DELETE", authToken: token }); + const res = await (apiV2Data("delete", "/waitlist/{id}", { params: { id: id }, authToken: token }) as Promise<{ message: string }>); onMessage(res.message); load(); } catch (e) { diff --git a/apps/events/frontend/src/lib/api-v2/openapi.json b/apps/events/frontend/src/lib/api-v2/openapi.json index 127c25e..35394af 100644 --- a/apps/events/frontend/src/lib/api-v2/openapi.json +++ b/apps/events/frontend/src/lib/api-v2/openapi.json @@ -38,6 +38,24 @@ { "name": "Registrations" }, + { + "name": "Payments" + }, + { + "name": "Cash-ups" + }, + { + "name": "Waitlist" + }, + { + "name": "Sponsorship" + }, + { + "name": "Consent" + }, + { + "name": "Feedback" + }, { "name": "Check-in" }, @@ -15305,6 +15323,5105 @@ } } }, + "/payments/providers": { + "get": { + "tags": [ + "Payments" + ], + "summary": "The payment providers switched on", + "description": "**Who:** Anyone.", + "operationId": "getPaymentsProviders", + "parameters": [], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + } + } + } + }, + "/payments/providers/settings": { + "get": { + "tags": [ + "Payments" + ], + "summary": "Payment provider settings", + "description": "Admins. Keys are masked.\n\n**Who:** Admins only.", + "operationId": "getPaymentsProvidersSettings", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + }, + "put": { + "tags": [ + "Payments" + ], + "summary": "Change payment provider settings", + "description": "**Who:** Admins only.", + "operationId": "putPaymentsProvidersSettings", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": {}, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/payments/open-checkouts": { + "get": { + "tags": [ + "Payments" + ], + "summary": "Checkouts started but not finished", + "description": "**Who:** Supervisors and admins.", + "operationId": "getPaymentsOpen-checkouts", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/payments/open-checkouts/check": { + "post": { + "tags": [ + "Payments" + ], + "summary": "Ask the provider about open checkouts", + "description": "Records any that were paid (for when a webhook was missed).\n\n**Who:** Supervisors and admins.", + "operationId": "postPaymentsOpen-checkoutsCheck", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": {}, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/payments/stats": { + "get": { + "tags": [ + "Payments" + ], + "summary": "Payment totals", + "description": "**Who:** Admins only.", + "operationId": "getPaymentsStats", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "page", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "userId", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "from", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "donations", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "method", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "kind", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "startDate", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "endDate", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/payments": { + "get": { + "tags": [ + "Payments" + ], + "summary": "Every payment", + "description": "For the events you may see. `page` and `limit` page it (otherwise everything); see v1 for the filters it takes.\n\n**Who:** Supervisors and admins.", + "operationId": "getPayments", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "page", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "userId", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "from", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "donations", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "method", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "kind", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "startDate", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "endDate", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + }, + "post": { + "tags": [ + "Payments" + ], + "summary": "Record a payment", + "description": "Cash, card, EFT or other, against a registration or (a donation) an event. Paid in full issues and sends the tickets.\n\n**Who:** Supervisors and admins.", + "operationId": "postPayments", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "registrationId": { + "anyOf": [ + { + "type": "string", + "minLength": 1, + "maxLength": 64 + }, + { + "type": "null" + } + ] + }, + "eventId": { + "anyOf": [ + { + "type": "string", + "minLength": 1, + "maxLength": 64 + }, + { + "type": "null" + } + ] + }, + "amount": { + "type": [ + "number", + "string" + ] + }, + "method": { + "type": "string", + "maxLength": 20 + } + }, + "required": [ + "amount" + ], + "additionalProperties": {} + } + } + } + }, + "responses": { + "201": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/payments/refunds": { + "post": { + "tags": [ + "Payments" + ], + "summary": "Refund a payment", + "description": "**Who:** Supervisors and admins.", + "operationId": "postPaymentsRefunds", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "paymentId": { + "type": "string", + "minLength": 1, + "maxLength": 64 + }, + "registrationId": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + }, + "additionalProperties": {} + } + } + } + }, + "responses": { + "201": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/payments/donations/assign": { + "post": { + "tags": [ + "Payments" + ], + "summary": "Put a donation towards a registration", + "description": "**Who:** Supervisors and admins.", + "operationId": "postPaymentsDonationsAssign", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "paymentId": { + "type": "string", + "minLength": 1, + "maxLength": 64 + }, + "registrationId": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + }, + "required": [ + "paymentId", + "registrationId" + ], + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/payments/donations/unassign": { + "post": { + "tags": [ + "Payments" + ], + "summary": "Take a donation back off a registration", + "description": "**Who:** Supervisors and admins.", + "operationId": "postPaymentsDonationsUnassign", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "legId": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + }, + "required": [ + "legId" + ], + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/donations/checkout": { + "post": { + "tags": [ + "Payments" + ], + "summary": "Give to an event", + "description": "Starts a checkout for a donation of `amount` to `eventId`; answers where to send the person (`redirectUrl`).\n\n**Who:** Any signed-in person.", + "operationId": "postDonationsCheckout", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "eventId": { + "type": "string", + "minLength": 1, + "maxLength": 64 + }, + "amount": { + "type": [ + "number", + "string" + ] + } + }, + "required": [ + "eventId", + "amount" + ], + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/me/payments": { + "get": { + "tags": [ + "Me" + ], + "summary": "My payments", + "description": "**Who:** Any signed-in person.", + "operationId": "getMePayments", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "page", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "userId", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "from", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "donations", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "method", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "kind", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "startDate", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "endDate", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/payments/{id}": { + "get": { + "tags": [ + "Payments" + ], + "summary": "One payment", + "description": "**Who:** Any signed-in person.", + "operationId": "getPaymentsId", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/payments/{id}/receipt": { + "post": { + "tags": [ + "Payments" + ], + "summary": "Send the receipt again", + "description": "**Who:** Any signed-in person.", + "operationId": "postPaymentsIdReceipt", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "channel": { + "type": "string", + "maxLength": 20 + } + }, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/registrations/{id}/payments": { + "get": { + "tags": [ + "Payments" + ], + "summary": "A registration's payments", + "description": "**Who:** Any signed-in person.", + "operationId": "getRegistrationsIdPayments", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": { + "type": "array", + "items": { + "type": "object", + "properties": {}, + "additionalProperties": {} + } + } + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/registrations/{id}/payment-link": { + "post": { + "tags": [ + "Payments" + ], + "summary": "Make a link to pay", + "description": "Supervisors: a checkout for `amount` (part of what's owed) for someone else to pay. Answers `redirectUrl` (the link) — or `priceUpdated` when an early-bird price ran out.\n\n**Who:** Supervisors and admins.", + "operationId": "postRegistrationsIdPayment-link", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "amount": { + "type": [ + "number", + "string" + ] + } + }, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/registrations/{id}/payment-link/send": { + "post": { + "tags": [ + "Payments" + ], + "summary": "Send someone a link to pay", + "description": "By email and/or WhatsApp, for what's still owing.\n\n**Who:** Supervisors and admins.", + "operationId": "postRegistrationsIdPayment-linkSend", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": {}, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/events/{id}/payments": { + "get": { + "tags": [ + "Payments" + ], + "summary": "An event's payments", + "description": "**Who:** Staff, supervisors and admins.", + "operationId": "getEventsIdPayments", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/payment-links/{id}": { + "get": { + "tags": [ + "Payments" + ], + "summary": "A pay page", + "description": "What a payment link shows: what's owed and the providers to pay with. The id in the link is the credential.\n\n**Who:** Anyone.", + "operationId": "getPayment-linksId", + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + }, + "post": { + "tags": [ + "Payments" + ], + "summary": "Pay from a pay page", + "description": "Starts a checkout with the chosen provider; answers where to send the person.\n\n**Who:** Anyone.", + "operationId": "postPayment-linksId", + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "provider": { + "type": "string", + "maxLength": 40 + } + }, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/cashups/audit": { + "get": { + "tags": [ + "Cash-ups" + ], + "summary": "Cash-up history", + "description": "**Who:** Supervisors and admins.", + "operationId": "getCashupsAudit", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "eventId", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "from", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "to", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/events/{id}/cashup": { + "get": { + "tags": [ + "Cash-ups" + ], + "summary": "An event's cash-up", + "description": "Income by method, costs, what each drawer should hold, and the saved draft.\n\n**Who:** Supervisors and admins.", + "operationId": "getEventsIdCashup", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/events/{id}/cashup/cash-by-user": { + "get": { + "tags": [ + "Cash-ups" + ], + "summary": "Cash taken by each person", + "description": "**Who:** Supervisors and admins.", + "operationId": "getEventsIdCashupCash-by-user", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/events/{id}/cashup/person-cash/{userId}": { + "put": { + "tags": [ + "Cash-ups" + ], + "summary": "Count one person's cash", + "description": "**Who:** Supervisors and admins.", + "operationId": "putEventsIdCashupPerson-cashUserId", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + }, + { + "name": "userId", + "in": "path", + "required": true, + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": {}, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/events/{id}/cashup/draft": { + "put": { + "tags": [ + "Cash-ups" + ], + "summary": "Save the cash-up as a draft", + "description": "**Who:** Admins only.", + "operationId": "putEventsIdCashupDraft", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": {}, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/events/{id}/cashup/close": { + "post": { + "tags": [ + "Cash-ups" + ], + "summary": "Close the event", + "description": "Admins. Nothing about the event's money can change until it's reopened.\n\n**Who:** Admins only.", + "operationId": "postEventsIdCashupClose", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": {}, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/events/{id}/cashup/reopen": { + "post": { + "tags": [ + "Cash-ups" + ], + "summary": "Reopen a closed event", + "description": "**Who:** Admins only.", + "operationId": "postEventsIdCashupReopen", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": {}, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/cashup-lines/{id}/pending": { + "post": { + "tags": [ + "Cash-ups" + ], + "summary": "Settle a pending cash-up line", + "description": "**Who:** Admins only.", + "operationId": "postCashup-linesIdPending", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": {}, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/provider-transactions": { + "get": { + "tags": [ + "Payments" + ], + "summary": "Transactions from Yoco and PayFast", + "description": "**Who:** Supervisors and admins.", + "operationId": "getProvider-transactions", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "provider", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/provider-transactions/unreconciled": { + "get": { + "tags": [ + "Payments" + ], + "summary": "Provider transactions not matched yet", + "description": "**Who:** Supervisors and admins.", + "operationId": "getProvider-transactionsUnreconciled", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/provider-transactions/{id}/reconcile": { + "post": { + "tags": [ + "Payments" + ], + "summary": "Match a provider transaction to a registration", + "description": "**Who:** Supervisors and admins.", + "operationId": "postProvider-transactionsIdReconcile", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": {}, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/provider-transactions/{id}/ignore": { + "post": { + "tags": [ + "Payments" + ], + "summary": "Ignore a provider transaction", + "description": "**Who:** Supervisors and admins.", + "operationId": "postProvider-transactionsIdIgnore", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": {}, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/waitlist": { + "post": { + "tags": [ + "Waitlist" + ], + "summary": "Join a sold-out event's waitlist", + "description": "Signed in, or with a name and email or phone. When places free up, people are offered them in order.\n\n**Who:** Anyone; signed-in staff may see more.", + "operationId": "postWaitlist", + "security": [ + {}, + { + "bearerAuth": [] + } + ], + "parameters": [], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "eventId": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + }, + "required": [ + "eventId" + ], + "additionalProperties": {} + } + } + } + }, + "responses": { + "201": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/me/waitlist": { + "get": { + "tags": [ + "Me" + ], + "summary": "Waitlists I'm on", + "description": "**Who:** Any signed-in person.", + "operationId": "getMeWaitlist", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/waitlist/claims/{token}": { + "get": { + "tags": [ + "Waitlist" + ], + "summary": "A waitlist offer", + "description": "What an offer link shows (the token is the credential). Register with `waitlistToken` to take it.\n\n**Who:** Anyone.", + "operationId": "getWaitlistClaimsToken", + "parameters": [ + { + "name": "token", + "in": "path", + "required": true, + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 200 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/events/{id}/waitlist": { + "get": { + "tags": [ + "Waitlist" + ], + "summary": "An event's waitlist", + "description": "**Who:** Staff, supervisors and admins.", + "operationId": "getEventsIdWaitlist", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + }, + { + "name": "all", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/waitlist/{id}/offer": { + "post": { + "tags": [ + "Waitlist" + ], + "summary": "Offer someone their places now", + "description": "**Who:** Supervisors and admins.", + "operationId": "postWaitlistIdOffer", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": {}, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/waitlist/{id}/move": { + "post": { + "tags": [ + "Waitlist" + ], + "summary": "Move someone up or down the waitlist", + "description": "**Who:** Supervisors and admins.", + "operationId": "postWaitlistIdMove", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": {}, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/waitlist/{id}/remove": { + "post": { + "tags": [ + "Waitlist" + ], + "summary": "Take someone off the waitlist", + "description": "**Who:** Supervisors and admins.", + "operationId": "postWaitlistIdRemove", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": {}, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/waitlist/{id}": { + "delete": { + "tags": [ + "Waitlist" + ], + "summary": "Leave a waitlist", + "description": "**Who:** Any signed-in person.", + "operationId": "deleteWaitlistId", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/events/{id}/sponsorship": { + "get": { + "tags": [ + "Sponsorship" + ], + "summary": "Sponsoring places at an event", + "description": "Whether it's on, and the suggested amounts.\n\n**Who:** Anyone.", + "operationId": "getEventsIdSponsorship", + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/events/{id}/sponsorship/pool": { + "get": { + "tags": [ + "Sponsorship" + ], + "summary": "The sponsorship pool", + "description": "What's been given and what's been used.\n\n**Who:** Supervisors and admins.", + "operationId": "getEventsIdSponsorshipPool", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/sponsorships/checkout": { + "post": { + "tags": [ + "Sponsorship" + ], + "summary": "Give towards places", + "description": "Starts a checkout; answers where to send the person.\n\n**Who:** Anyone; signed-in staff may see more.", + "operationId": "postSponsorshipsCheckout", + "security": [ + {}, + { + "bearerAuth": [] + } + ], + "parameters": [], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "eventId": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + }, + "required": [ + "eventId" + ], + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/events/{id}/consent": { + "get": { + "tags": [ + "Consent" + ], + "summary": "Parental consent for an event", + "description": "**Who:** Staff, supervisors and admins.", + "operationId": "getEventsIdConsent", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/events/{id}/consent/medical": { + "get": { + "tags": [ + "Consent" + ], + "summary": "Medical notes from consent forms", + "description": "**Who:** Supervisors and admins.", + "operationId": "getEventsIdConsentMedical", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/events/{id}/consent/resend-pending": { + "post": { + "tags": [ + "Consent" + ], + "summary": "Remind everyone who hasn't answered", + "description": "**Who:** Supervisors and admins.", + "operationId": "postEventsIdConsentResend-pending", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": {}, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/events/{id}/consent/rerequest": { + "post": { + "tags": [ + "Consent" + ], + "summary": "Ask for consent again", + "description": "After the consent wording changed.\n\n**Who:** Supervisors and admins.", + "operationId": "postEventsIdConsentRerequest", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": {}, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/consent-requests/{id}/resend": { + "post": { + "tags": [ + "Consent" + ], + "summary": "Send a consent request again", + "description": "**Who:** Any signed-in person.", + "operationId": "postConsent-requestsIdResend", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": {}, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/consent/{token}": { + "get": { + "tags": [ + "Consent" + ], + "summary": "A consent form", + "description": "What the link in a consent request shows (the token is the parent's credential).\n\n**Who:** Anyone.", + "operationId": "getConsentToken", + "parameters": [ + { + "name": "token", + "in": "path", + "required": true, + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 200 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + }, + "post": { + "tags": [ + "Consent" + ], + "summary": "Answer a consent form", + "description": "**Who:** Anyone.", + "operationId": "postConsentToken", + "parameters": [ + { + "name": "token", + "in": "path", + "required": true, + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 200 + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": {}, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/form-responses": { + "get": { + "tags": [ + "Registrations" + ], + "summary": "Attendee form answers", + "description": "For an event (`eventId`) or a registration (`registrationId`), for events you may see.\n\n**Who:** Staff, supervisors and admins.", + "operationId": "getForm-responses", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "eventId", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "registrationId", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "userId", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + }, + { + "name": "cursor", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/feedback/summary": { + "get": { + "tags": [ + "Feedback" + ], + "summary": "Feedback across events", + "description": "**Who:** Supervisors and admins.", + "operationId": "getFeedbackSummary", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "eventIds", + "in": "query", + "required": false, + "schema": { + "type": "string", + "maxLength": 4000 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/feedback-forms/{token}": { + "get": { + "tags": [ + "Feedback" + ], + "summary": "A feedback form", + "description": "What the link sent after an event shows (the token is the credential).\n\n**Who:** Anyone.", + "operationId": "getFeedback-formsToken", + "parameters": [ + { + "name": "token", + "in": "path", + "required": true, + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 200 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + }, + "post": { + "tags": [ + "Feedback" + ], + "summary": "Answer a feedback form", + "description": "**Who:** Anyone.", + "operationId": "postFeedback-formsToken", + "parameters": [ + { + "name": "token", + "in": "path", + "required": true, + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 200 + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": {}, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/events/{id}/feedback": { + "get": { + "tags": [ + "Feedback" + ], + "summary": "An event's feedback set-up and answers", + "description": "**Who:** Supervisors and admins.", + "operationId": "getEventsIdFeedback", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + }, + "put": { + "tags": [ + "Feedback" + ], + "summary": "Set up an event's feedback form", + "description": "**Who:** Supervisors and admins.", + "operationId": "putEventsIdFeedback", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": {}, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + }, + "delete": { + "tags": [ + "Feedback" + ], + "summary": "Remove an event's feedback form", + "description": "**Who:** Supervisors and admins.", + "operationId": "deleteEventsIdFeedback", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/events/{id}/feedback/send-now": { + "post": { + "tags": [ + "Feedback" + ], + "summary": "Send the feedback form now", + "description": "**Who:** Supervisors and admins.", + "operationId": "postEventsIdFeedbackSend-now", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "description": "The id", + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 64 + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": {}, + "additionalProperties": {} + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": {} + }, + "required": [ + "data" + ], + "additionalProperties": false + } + } + } + }, + "400": { + "description": "Validation failed (VALIDATION_FAILED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Not signed in (UNAUTHENTICATED)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "403": { + "description": "Not allowed for this role (FORBIDDEN)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Not found (NOT_FOUND)", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, "/checkin/{qrCode}": { "get": { "tags": [ diff --git a/apps/events/frontend/src/lib/api-v2/schema.d.ts b/apps/events/frontend/src/lib/api-v2/schema.d.ts index b71c141..9591ddc 100644 --- a/apps/events/frontend/src/lib/api-v2/schema.d.ts +++ b/apps/events/frontend/src/lib/api-v2/schema.d.ts @@ -1578,6 +1578,1114 @@ export interface paths { patch?: never; trace?: never; }; + "/payments/providers": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * The payment providers switched on + * @description **Who:** Anyone. + */ + get: operations["getPaymentsProviders"]; + put?: never; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/payments/providers/settings": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * Payment provider settings + * @description Admins. Keys are masked. + * + * **Who:** Admins only. + */ + get: operations["getPaymentsProvidersSettings"]; + /** + * Change payment provider settings + * @description **Who:** Admins only. + */ + put: operations["putPaymentsProvidersSettings"]; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/payments/open-checkouts": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * Checkouts started but not finished + * @description **Who:** Supervisors and admins. + */ + get: operations["getPaymentsOpen-checkouts"]; + put?: never; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/payments/open-checkouts/check": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + /** + * Ask the provider about open checkouts + * @description Records any that were paid (for when a webhook was missed). + * + * **Who:** Supervisors and admins. + */ + post: operations["postPaymentsOpen-checkoutsCheck"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/payments/stats": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * Payment totals + * @description **Who:** Admins only. + */ + get: operations["getPaymentsStats"]; + put?: never; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/payments": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * Every payment + * @description For the events you may see. `page` and `limit` page it (otherwise everything); see v1 for the filters it takes. + * + * **Who:** Supervisors and admins. + */ + get: operations["getPayments"]; + put?: never; + /** + * Record a payment + * @description Cash, card, EFT or other, against a registration or (a donation) an event. Paid in full issues and sends the tickets. + * + * **Who:** Supervisors and admins. + */ + post: operations["postPayments"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/payments/refunds": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + /** + * Refund a payment + * @description **Who:** Supervisors and admins. + */ + post: operations["postPaymentsRefunds"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/payments/donations/assign": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + /** + * Put a donation towards a registration + * @description **Who:** Supervisors and admins. + */ + post: operations["postPaymentsDonationsAssign"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/payments/donations/unassign": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + /** + * Take a donation back off a registration + * @description **Who:** Supervisors and admins. + */ + post: operations["postPaymentsDonationsUnassign"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/donations/checkout": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + /** + * Give to an event + * @description Starts a checkout for a donation of `amount` to `eventId`; answers where to send the person (`redirectUrl`). + * + * **Who:** Any signed-in person. + */ + post: operations["postDonationsCheckout"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/me/payments": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * My payments + * @description **Who:** Any signed-in person. + */ + get: operations["getMePayments"]; + put?: never; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/payments/{id}": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * One payment + * @description **Who:** Any signed-in person. + */ + get: operations["getPaymentsId"]; + put?: never; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/payments/{id}/receipt": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + /** + * Send the receipt again + * @description **Who:** Any signed-in person. + */ + post: operations["postPaymentsIdReceipt"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/registrations/{id}/payments": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * A registration's payments + * @description **Who:** Any signed-in person. + */ + get: operations["getRegistrationsIdPayments"]; + put?: never; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/registrations/{id}/payment-link": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + /** + * Make a link to pay + * @description Supervisors: a checkout for `amount` (part of what's owed) for someone else to pay. Answers `redirectUrl` (the link) — or `priceUpdated` when an early-bird price ran out. + * + * **Who:** Supervisors and admins. + */ + post: operations["postRegistrationsIdPayment-link"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/registrations/{id}/payment-link/send": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + /** + * Send someone a link to pay + * @description By email and/or WhatsApp, for what's still owing. + * + * **Who:** Supervisors and admins. + */ + post: operations["postRegistrationsIdPayment-linkSend"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/events/{id}/payments": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * An event's payments + * @description **Who:** Staff, supervisors and admins. + */ + get: operations["getEventsIdPayments"]; + put?: never; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/payment-links/{id}": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * A pay page + * @description What a payment link shows: what's owed and the providers to pay with. The id in the link is the credential. + * + * **Who:** Anyone. + */ + get: operations["getPayment-linksId"]; + put?: never; + /** + * Pay from a pay page + * @description Starts a checkout with the chosen provider; answers where to send the person. + * + * **Who:** Anyone. + */ + post: operations["postPayment-linksId"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/cashups/audit": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * Cash-up history + * @description **Who:** Supervisors and admins. + */ + get: operations["getCashupsAudit"]; + put?: never; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/events/{id}/cashup": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * An event's cash-up + * @description Income by method, costs, what each drawer should hold, and the saved draft. + * + * **Who:** Supervisors and admins. + */ + get: operations["getEventsIdCashup"]; + put?: never; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/events/{id}/cashup/cash-by-user": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * Cash taken by each person + * @description **Who:** Supervisors and admins. + */ + get: operations["getEventsIdCashupCash-by-user"]; + put?: never; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/events/{id}/cashup/person-cash/{userId}": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + /** + * Count one person's cash + * @description **Who:** Supervisors and admins. + */ + put: operations["putEventsIdCashupPerson-cashUserId"]; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/events/{id}/cashup/draft": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + /** + * Save the cash-up as a draft + * @description **Who:** Admins only. + */ + put: operations["putEventsIdCashupDraft"]; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/events/{id}/cashup/close": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + /** + * Close the event + * @description Admins. Nothing about the event's money can change until it's reopened. + * + * **Who:** Admins only. + */ + post: operations["postEventsIdCashupClose"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/events/{id}/cashup/reopen": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + /** + * Reopen a closed event + * @description **Who:** Admins only. + */ + post: operations["postEventsIdCashupReopen"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/cashup-lines/{id}/pending": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + /** + * Settle a pending cash-up line + * @description **Who:** Admins only. + */ + post: operations["postCashup-linesIdPending"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/provider-transactions": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * Transactions from Yoco and PayFast + * @description **Who:** Supervisors and admins. + */ + get: operations["getProvider-transactions"]; + put?: never; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/provider-transactions/unreconciled": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * Provider transactions not matched yet + * @description **Who:** Supervisors and admins. + */ + get: operations["getProvider-transactionsUnreconciled"]; + put?: never; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/provider-transactions/{id}/reconcile": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + /** + * Match a provider transaction to a registration + * @description **Who:** Supervisors and admins. + */ + post: operations["postProvider-transactionsIdReconcile"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/provider-transactions/{id}/ignore": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + /** + * Ignore a provider transaction + * @description **Who:** Supervisors and admins. + */ + post: operations["postProvider-transactionsIdIgnore"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/waitlist": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + /** + * Join a sold-out event's waitlist + * @description Signed in, or with a name and email or phone. When places free up, people are offered them in order. + * + * **Who:** Anyone; signed-in staff may see more. + */ + post: operations["postWaitlist"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/me/waitlist": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * Waitlists I'm on + * @description **Who:** Any signed-in person. + */ + get: operations["getMeWaitlist"]; + put?: never; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/waitlist/claims/{token}": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * A waitlist offer + * @description What an offer link shows (the token is the credential). Register with `waitlistToken` to take it. + * + * **Who:** Anyone. + */ + get: operations["getWaitlistClaimsToken"]; + put?: never; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/events/{id}/waitlist": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * An event's waitlist + * @description **Who:** Staff, supervisors and admins. + */ + get: operations["getEventsIdWaitlist"]; + put?: never; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/waitlist/{id}/offer": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + /** + * Offer someone their places now + * @description **Who:** Supervisors and admins. + */ + post: operations["postWaitlistIdOffer"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/waitlist/{id}/move": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + /** + * Move someone up or down the waitlist + * @description **Who:** Supervisors and admins. + */ + post: operations["postWaitlistIdMove"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/waitlist/{id}/remove": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + /** + * Take someone off the waitlist + * @description **Who:** Supervisors and admins. + */ + post: operations["postWaitlistIdRemove"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/waitlist/{id}": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + post?: never; + /** + * Leave a waitlist + * @description **Who:** Any signed-in person. + */ + delete: operations["deleteWaitlistId"]; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/events/{id}/sponsorship": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * Sponsoring places at an event + * @description Whether it's on, and the suggested amounts. + * + * **Who:** Anyone. + */ + get: operations["getEventsIdSponsorship"]; + put?: never; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/events/{id}/sponsorship/pool": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * The sponsorship pool + * @description What's been given and what's been used. + * + * **Who:** Supervisors and admins. + */ + get: operations["getEventsIdSponsorshipPool"]; + put?: never; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/sponsorships/checkout": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + /** + * Give towards places + * @description Starts a checkout; answers where to send the person. + * + * **Who:** Anyone; signed-in staff may see more. + */ + post: operations["postSponsorshipsCheckout"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/events/{id}/consent": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * Parental consent for an event + * @description **Who:** Staff, supervisors and admins. + */ + get: operations["getEventsIdConsent"]; + put?: never; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/events/{id}/consent/medical": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * Medical notes from consent forms + * @description **Who:** Supervisors and admins. + */ + get: operations["getEventsIdConsentMedical"]; + put?: never; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/events/{id}/consent/resend-pending": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + /** + * Remind everyone who hasn't answered + * @description **Who:** Supervisors and admins. + */ + post: operations["postEventsIdConsentResend-pending"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/events/{id}/consent/rerequest": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + /** + * Ask for consent again + * @description After the consent wording changed. + * + * **Who:** Supervisors and admins. + */ + post: operations["postEventsIdConsentRerequest"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/consent-requests/{id}/resend": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + /** + * Send a consent request again + * @description **Who:** Any signed-in person. + */ + post: operations["postConsent-requestsIdResend"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/consent/{token}": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * A consent form + * @description What the link in a consent request shows (the token is the parent's credential). + * + * **Who:** Anyone. + */ + get: operations["getConsentToken"]; + put?: never; + /** + * Answer a consent form + * @description **Who:** Anyone. + */ + post: operations["postConsentToken"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/form-responses": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * Attendee form answers + * @description For an event (`eventId`) or a registration (`registrationId`), for events you may see. + * + * **Who:** Staff, supervisors and admins. + */ + get: operations["getForm-responses"]; + put?: never; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/feedback/summary": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * Feedback across events + * @description **Who:** Supervisors and admins. + */ + get: operations["getFeedbackSummary"]; + put?: never; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/feedback-forms/{token}": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * A feedback form + * @description What the link sent after an event shows (the token is the credential). + * + * **Who:** Anyone. + */ + get: operations["getFeedback-formsToken"]; + put?: never; + /** + * Answer a feedback form + * @description **Who:** Anyone. + */ + post: operations["postFeedback-formsToken"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/events/{id}/feedback": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** + * An event's feedback set-up and answers + * @description **Who:** Supervisors and admins. + */ + get: operations["getEventsIdFeedback"]; + /** + * Set up an event's feedback form + * @description **Who:** Supervisors and admins. + */ + put: operations["putEventsIdFeedback"]; + post?: never; + /** + * Remove an event's feedback form + * @description **Who:** Supervisors and admins. + */ + delete: operations["deleteEventsIdFeedback"]; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/events/{id}/feedback/send-now": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + get?: never; + put?: never; + /** + * Send the feedback form now + * @description **Who:** Supervisors and admins. + */ + post: operations["postEventsIdFeedbackSend-now"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; "/checkin/{qrCode}": { parameters: { query?: never; @@ -8308,6 +9416,3286 @@ export interface operations { }; }; }; + getPaymentsProviders: { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + }; + }; + getPaymentsProvidersSettings: { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + putPaymentsProvidersSettings: { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + "getPaymentsOpen-checkouts": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + "postPaymentsOpen-checkoutsCheck": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + getPaymentsStats: { + parameters: { + query?: { + page?: string; + limit?: string; + userId?: string; + from?: string; + donations?: string; + method?: string; + kind?: string; + startDate?: string; + endDate?: string; + }; + header?: never; + path?: never; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + getPayments: { + parameters: { + query?: { + page?: string; + limit?: string; + userId?: string; + from?: string; + donations?: string; + method?: string; + kind?: string; + startDate?: string; + endDate?: string; + }; + header?: never; + path?: never; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + postPayments: { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + registrationId?: string | null; + eventId?: string | null; + amount: number | string; + method?: string; + } & { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 201: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + postPaymentsRefunds: { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + paymentId?: string; + registrationId?: string; + } & { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 201: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + postPaymentsDonationsAssign: { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + paymentId: string; + registrationId: string; + } & { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + postPaymentsDonationsUnassign: { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + legId: string; + } & { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + postDonationsCheckout: { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + eventId: string; + amount: number | string; + } & { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + getMePayments: { + parameters: { + query?: { + page?: string; + limit?: string; + userId?: string; + from?: string; + donations?: string; + method?: string; + kind?: string; + startDate?: string; + endDate?: string; + }; + header?: never; + path?: never; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + getPaymentsId: { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + postPaymentsIdReceipt: { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + channel?: string; + } & { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + getRegistrationsIdPayments: { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: { + [key: string]: unknown; + }[]; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + "postRegistrationsIdPayment-link": { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + amount?: number | string; + } & { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + "postRegistrationsIdPayment-linkSend": { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + getEventsIdPayments: { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + "getPayment-linksId": { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + "postPayment-linksId": { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + provider?: string; + } & { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + getCashupsAudit: { + parameters: { + query?: { + eventId?: string; + from?: string; + to?: string; + }; + header?: never; + path?: never; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + getEventsIdCashup: { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + "getEventsIdCashupCash-by-user": { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + "putEventsIdCashupPerson-cashUserId": { + parameters: { + query?: never; + header?: never; + path: { + id: string; + userId: string; + }; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + putEventsIdCashupDraft: { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + postEventsIdCashupClose: { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + postEventsIdCashupReopen: { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + "postCashup-linesIdPending": { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + "getProvider-transactions": { + parameters: { + query?: { + provider?: string; + }; + header?: never; + path?: never; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + "getProvider-transactionsUnreconciled": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + "postProvider-transactionsIdReconcile": { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + "postProvider-transactionsIdIgnore": { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + postWaitlist: { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + eventId: string; + } & { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 201: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + getMeWaitlist: { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + getWaitlistClaimsToken: { + parameters: { + query?: never; + header?: never; + path: { + token: string; + }; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + getEventsIdWaitlist: { + parameters: { + query?: { + all?: string; + }; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + postWaitlistIdOffer: { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + postWaitlistIdMove: { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + postWaitlistIdRemove: { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + deleteWaitlistId: { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + getEventsIdSponsorship: { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + getEventsIdSponsorshipPool: { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + postSponsorshipsCheckout: { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + eventId: string; + } & { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + getEventsIdConsent: { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + getEventsIdConsentMedical: { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + "postEventsIdConsentResend-pending": { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + postEventsIdConsentRerequest: { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + "postConsent-requestsIdResend": { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + getConsentToken: { + parameters: { + query?: never; + header?: never; + path: { + token: string; + }; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + postConsentToken: { + parameters: { + query?: never; + header?: never; + path: { + token: string; + }; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + "getForm-responses": { + parameters: { + query?: { + eventId?: string; + registrationId?: string; + userId?: string; + cursor?: string; + }; + header?: never; + path?: never; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + getFeedbackSummary: { + parameters: { + query?: { + eventIds?: string; + }; + header?: never; + path?: never; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + "getFeedback-formsToken": { + parameters: { + query?: never; + header?: never; + path: { + token: string; + }; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + "postFeedback-formsToken": { + parameters: { + query?: never; + header?: never; + path: { + token: string; + }; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + getEventsIdFeedback: { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + putEventsIdFeedback: { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + deleteEventsIdFeedback: { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; + "postEventsIdFeedbackSend-now": { + parameters: { + query?: never; + header?: never; + path: { + /** @description The id */ + id: string; + }; + cookie?: never; + }; + requestBody: { + content: { + "application/json": { + [key: string]: unknown; + }; + }; + }; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: unknown; + }; + }; + }; + /** @description Validation failed (VALIDATION_FAILED) */ + 400: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not signed in (UNAUTHENTICATED) */ + 401: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not allowed for this role (FORBIDDEN) */ + 403: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + /** @description Not found (NOT_FOUND) */ + 404: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": components["schemas"]["Error"]; + }; + }; + }; + }; getCheckinQrCode: { parameters: { query?: { diff --git a/apps/events/frontend/src/lib/api.ts b/apps/events/frontend/src/lib/api.ts index 704f46d..de12dc4 100644 --- a/apps/events/frontend/src/lib/api.ts +++ b/apps/events/frontend/src/lib/api.ts @@ -248,8 +248,15 @@ export function fetchAllUsers(token: string, params: Record = {} return fetchAllPages("/api/users", token, params); } -export function fetchAllPayments(token: string, params: Record = {}): Promise { - return fetchAllPages("/api/payments", token, params); +/** Every payment staff may see (API v2 GET /payments, all pages at once). */ +export async function fetchAllPayments(token: string, params: Record = {}): Promise { + const { apiV2Data } = await import("@/lib/apiV2"); + const page = (n: number) => apiV2Data("get", "/payments", { query: { ...params, limit: "200", page: String(n) }, authToken: token }) as Promise>; + const first = await page(1); + const items: Payment[] = Array.isArray(first?.data) ? [...first.data] : []; + const rest = await Promise.all(Array.from({ length: Math.max(0, (first?.pages || 1) - 1) }, (_, i) => page(i + 2))); + for (const res of rest) if (Array.isArray(res?.data)) items.push(...res.data); + return items; } // Starts an online payment for everything still owed on one of my registrations (API v2), with diff --git a/apps/events/frontend/src/lib/onlinePayments.ts b/apps/events/frontend/src/lib/onlinePayments.ts index f14d20f..33cadf6 100644 --- a/apps/events/frontend/src/lib/onlinePayments.ts +++ b/apps/events/frontend/src/lib/onlinePayments.ts @@ -1,7 +1,7 @@ "use client"; import { useEffect, useState } from "react"; -import { apiFetch } from "@/lib/api"; +import { apiV2Data } from "@/lib/apiV2"; type ProvidersResponse = { providers: { id: string; label: string }[]; minimumAmount: number }; @@ -21,7 +21,7 @@ export type OnlinePayments = { // One request per page load, shared by every component that asks. let pending: Promise | null = null; function load() { - if (!pending) pending = apiFetch("/api/payments/providers").catch(() => null); + if (!pending) pending = (apiV2Data("get", "/payments/providers") as Promise).catch(() => null); return pending; }