import {z} from 'zod' export type SortEnum = 'date' | '-date'; export type GetApiAccountsAccountIdTransactionsArgs = {accountId: string, consent: string, 'psu-id'?: string | undefined, 'psu-corporate-id'?: string | undefined, 'psu-ip-address'?: string | undefined, 'sub-application'?: string | undefined, from?: string | undefined, before?: string | undefined, limit?: number | undefined, sort?: SortEnum | undefined, offset?: number | undefined, cursor?: string | undefined}; export type GetApiAccountsAccountIdTransactionsOptions = {baseUrl?: string | undefined, basicAuth?: {username: string, password: string} | undefined, fetch?: typeof fetch | undefined}; export const sortEnum = z.enum(["date", "-date"]); export const filterAndSort = z.object({from: z.string().optional(), before: z.string().optional(), limit: z.number().int().optional(), sort: sortEnum.optional(), offset: z.number().int().optional(), cursor: z.string().optional()}); export const next = z.object({from: z.string().optional(), before: z.string().optional(), limit: z.number().int().optional(), cursor: z.string().optional()}); export const pagination = z.object({totalCount: z.number().int().optional(), self: filterAndSort.optional(), next: next.optional()}); export const responseListMeta = z.object({tracingId: z.string().optional(), count: z.number().int().optional(), pagination: pagination.optional()}); export const transactionStatusEnum = z.enum(["BOOKED", "PENDING"]); export const amount = z.object({amount: z.number(), currency: z.string()}); export const currencyExchange = z.object({sourceCurrency: z.string().optional(), targetCurrency: z.string().optional(), unitCurrency: z.string().optional(), exchangeRate: z.number().optional()}); export const transactionChargeDetails = z.object({chargeAmount: amount.optional()}); export const statementReference = z.object({value: z.string().optional()}); export const addressDetails = z.object({addressLine: z.string().optional()}); export const isoCodeDetails = z.object({code: z.string().optional(), name: z.string().optional()}); export const isoBankTransactionCode = z.object({domainCode: isoCodeDetails.optional(), familyCode: isoCodeDetails.optional(), subFamilyCode: isoCodeDetails.optional()}); export const proprietaryBankTransactionCode = z.object({code: z.string().optional(), issuer: z.string().optional()}); export const accountBalanceType = z.enum(["CLOSING_AVAILABLE", "CLOSING_BOOKED", "CLOSING_CLEARED", "EXPECTED", "FORWARD_AVAILABLE", "INFORMATION", "INTERIM_AVAILABLE", "INTERIM_BOOKED", "INTERIM_CLEARED", "OPENING_AVAILABLE", "OPENING_BOOKED", "OPENING_CLEARED", "PREVIOUSLY_CLOSED_BOOKED", "AUTHORISED", "OTHER", "UNKNOWN"]); export const transactionBalance = z.object({type: accountBalanceType.optional(), balanceAmount: amount.optional()}); export const accountIdentificationType = z.enum(["SORT_CODE", "ACCOUNT_NUMBER", "IBAN", "BBAN", "BIC", "PAN", "MASKED_PAN", "MSISDN", "BSB", "NCC", "ABA", "ABA_WIRE", "ABA_ACH", "EMAIL", "ROLL_NUMBER", "BLZ", "IFS", "CLABE", "CTN", "BRANCH_CODE", "VIRTUAL_ACCOUNT_ID"]); export const merchant = z.object({merchantName: z.string().optional(), merchantCategoryCode: z.string().optional()}); export const categorisation = z.object({categories: z.array(z.string()).optional(), source: z.string().optional()}); export const transactionHash = z.object({hash: z.string().optional()}); export const enrichmentMerchant = z.object({merchantName: z.string().optional(), parentGroup: z.string().optional()}); export const enrichment = z.object({categorisation: categorisation.optional(), transactionHash: transactionHash.optional(), cleansedDescription: z.string().optional(), merchant: enrichmentMerchant.optional(), location: z.string().optional(), paymentProcessor: z.string().optional(), correctedDate: z.string().optional()}); export const transaction = z.object({id: z.string().optional(), date: z.string().optional(), bookingDateTime: z.string().optional(), valueDateTime: z.string().optional(), status: transactionStatusEnum.optional(), amount: z.number().optional(), currency: z.string().optional(), transactionAmount: amount.optional(), grossAmount: amount.optional(), currencyExchange: currencyExchange.optional(), chargeDetails: transactionChargeDetails.optional(), reference: z.string().optional(), statementReferences: z.array(statementReference).optional(), description: z.string().optional(), transactionInformation: z.array(z.string()).optional(), addressDetails: addressDetails.optional(), isoBankTransactionCode: isoBankTransactionCode.optional(), proprietaryBankTransactionCode: proprietaryBankTransactionCode.optional(), balance: transactionBalance.optional(), payeeDetails: z.object({name: z.string().optional(), accountIdentifications: z.array(z.object({type: accountIdentificationType.optional(), identification: z.string().optional()})).optional()}).optional(), payerDetails: z.object({name: z.string().optional(), accountIdentifications: z.array(z.object({type: accountIdentificationType.optional(), identification: z.string().optional()})).optional()}).optional(), merchant: merchant.optional(), enrichment: enrichment.optional(), supplementaryData: z.object({}).optional(), transactionMutability: z.string().optional()}); export const responseForwardedData = z.object({headers: z.record(z.string(), z.string()).optional(), url: z.string().optional()}); export const rawRequest = z.object({method: z.string().optional(), url: z.string().optional(), requestInstant: z.string().optional(), headers: z.record(z.string(), z.string()).optional(), body: z.object({}).optional(), bodyParameters: z.record(z.string(), z.string()).optional(), startTime: z.string().optional(), startedAt: z.string().optional()}); export const rawResponse = z.object({request: rawRequest.optional(), duration: z.string().optional(), headers: z.record(z.string(), z.string()).optional(), resultCode: z.number().int().optional(), result: z.object({}).optional()}); export const apiCall = z.object({}); export const filteredClientPayloadListTransaction = z.object({apiCall: apiCall.optional(), data: z.array(transaction).optional(), nextCursorHash: z.string().optional(), nextLink: z.string().optional(), pagingMap: z.record(z.string(), filterAndSort).optional(), totalCount: z.number().int().optional()}); export const apiListResponseOfTransaction = z.object({meta: responseListMeta.optional(), data: z.array(transaction).optional(), links: z.record(z.string(), z.string()).optional(), forwardedData: z.array(responseForwardedData).optional(), raw: z.array(rawResponse).optional(), paging: filteredClientPayloadListTransaction.optional(), tracingId: z.string().optional()}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Get Account Transactions * * GET /accounts/{accountId}/transactions */ export const getApiAccountsAccountIdTransactions = async (args: GetApiAccountsAccountIdTransactionsArgs, options?: GetApiAccountsAccountIdTransactionsOptions) => { const {baseUrl = "https://api.yapily.com", fetch: fetchFn = fetch, basicAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json;charset=UTF-8") if (args.consent != null) headers.set("consent", String(args.consent)) if (args['psu-id'] != null) headers.set("psu-id", String(args['psu-id'])) if (args['psu-corporate-id'] != null) headers.set("psu-corporate-id", String(args['psu-corporate-id'])) if (args['psu-ip-address'] != null) headers.set("psu-ip-address", String(args['psu-ip-address'])) if (args['sub-application'] != null) headers.set("sub-application", String(args['sub-application'])) if (args.from != null) query.append("from", String(args.from)) if (args.before != null) query.append("before", String(args.before)) if (args.limit != null) query.append("limit", String(args.limit)) if (args.sort != null) query.append("sort", String(args.sort)) if (args.offset != null) query.append("offset", String(args.offset)) if (args.cursor != null) query.append("cursor", String(args.cursor)) if (basicAuth !== undefined) headers.set('authorization', `Basic ${btoa(`${basicAuth.username}:${basicAuth.password}`)}`) const url = `${baseUrl.replace(/\/+$/, '')}/accounts/${encodeURIComponent(String(args.accountId))}/transactions${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(apiListResponseOfTransaction, await res.json()) };