Files
baya-monorepo/client/src/services/refunds/apis/clientApi.ts
T
2026-07-10 12:51:53 +03:30

97 lines
3.7 KiB
TypeScript

import { clientFetch } from '@/lib/api/client';
import { unwrap, type ApiEnvelope } from '@/lib/api/types';
import { ApiError } from '@/lib/api/errors';
import type {
CancelBookingInput,
CancellationPolicyPreview,
RefundChannel,
RefundStatus,
RefundSummary,
RefundsApi,
} from '../types';
const BOOKINGS = '/api/v1/bookings';
const REFUNDS = '/api/v1/refunds';
/**
* The thin b11 customer refund payload (`GET refunds/{id}/status`) — the only refund shape the contract
* exposes to a customer. The fee-leg decomposition + policy snapshot live on the admin-only
* `RefundListItem`, so this maps into `RefundSummary` with those fields `null` until REQ-021 serves them.
*/
interface RefundStatusWire {
id: number;
bookingId: number;
status: RefundStatus;
refundChannel: RefundChannel;
amount: string;
expectedCustomerRefundEta: string | null;
reference: string | null;
}
function toSummary(wire: RefundStatusWire): RefundSummary {
return {
id: wire.id,
bookingId: wire.bookingId,
refundStatus: wire.status,
refundChannel: wire.refundChannel,
totalRefundedIrr: wire.amount,
expectedCustomerRefundEta: wire.expectedCustomerRefundEta,
externalRevertReference: wire.reference,
// REQ-021: the customer status carries no decomposition/policy/timestamps yet — the fee-split section
// is hidden until these are served (the mock fills them so the transparency split demos end-to-end).
refundPercentageApplied: null,
cancellationPolicyCode: null,
platformFeeRefundedIrr: null,
nursePayoutRefundedIrr: null,
createdAt: null,
completedAt: null,
};
}
/**
* Real HTTP implementation of the `RefundsApi` seam. Only `getRefund` maps a **published** b11 route
* (`GET refunds/{id}/status`, tenancy-scoped); the other three target contract gaps the frontend filed
* (which is why the domain stays mock-primary — see `constants.ts`):
* - `resolveCancellationPolicy` → REQ-020 (`GET bookings/{id}/cancellation_policy`): b9 snapshots the
* policy only *after* a cancel; there is no pre-cancel preview resolving the tier by current lead time
* + per-session refundability.
* - `cancelBooking` → REQ-019 (`POST bookings/{id}/cancel`): b11 refunds are admin-only, no customer path.
* - `getRefundByBooking` → REQ-021 (`GET refunds/by_booking/{id}`): the customer cannot obtain a refund
* id from the admin-only worklist, so it needs to reach its refund from the booking. `404` = no refund.
*
* NOT the primary implementation this phase (`USE_REFUNDS_MOCK = true`).
*/
export const refundsClientApi: RefundsApi = {
resolveCancellationPolicy: async (bookingId: number) =>
unwrap(
await clientFetch<ApiEnvelope<CancellationPolicyPreview>>(
`${BOOKINGS}/${bookingId}/cancellation_policy`,
),
),
cancelBooking: async ({ bookingId, sessionIds, reasonCategory, reasonNotes }: CancelBookingInput) =>
toSummary(
unwrap(
await clientFetch<ApiEnvelope<RefundStatusWire>>(`${BOOKINGS}/${bookingId}/cancel`, {
method: 'POST',
body: JSON.stringify({ sessionIds, reasonCategory, reasonNotes }),
}),
),
),
getRefundByBooking: async (bookingId: number) => {
try {
return toSummary(
unwrap(await clientFetch<ApiEnvelope<RefundStatusWire>>(`${REFUNDS}/by_booking/${bookingId}`)),
);
} catch (error) {
// No refund for this booking (e.g. not cancelled) is a clean empty state, not a failure.
if (error instanceof ApiError && error.status === 404) return null;
throw error;
}
},
getRefund: async (refundId: number) =>
toSummary(unwrap(await clientFetch<ApiEnvelope<RefundStatusWire>>(`${REFUNDS}/${refundId}/status`))),
};