/* * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT. */ import { Gr4vyCore } from "../core.js"; import { encodeFormQuery, encodeSimple } from "../lib/encodings.js"; import { matchStatusCode } from "../lib/http.js"; import * as M from "../lib/matchers.js"; import { compactMap } from "../lib/primitives.js"; import { safeParse } from "../lib/schemas.js"; import { RequestOptions } from "../lib/sdks.js"; import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js"; import { pathToFunc } from "../lib/url.js"; import { Gr4vyError } from "../models/errors/gr4vyerror.js"; import { ConnectionError, InvalidRequestError, RequestAbortedError, RequestTimeoutError, UnexpectedClientError, } from "../models/errors/httpclienterrors.js"; import * as errors from "../models/errors/index.js"; import { ResponseValidationError } from "../models/errors/responsevalidationerror.js"; import { SDKValidationError } from "../models/errors/sdkvalidationerror.js"; import * as operations from "../models/operations/index.js"; import { APICall, APIPromise } from "../types/async.js"; import { Result } from "../types/fp.js"; import { createPageIterator, haltIterator, PageIterator, Paginator, } from "../types/operations.js"; /** * List transactions * * @remarks * Returns a paginated list of transactions for the merchant account, sorted by most recently updated. You can filter, sort, and search transactions using query parameters. */ export function transactionsList( client: Gr4vyCore, request?: operations.ListTransactionsRequest | undefined, options?: RequestOptions, ): APIPromise< PageIterator< Result< operations.ListTransactionsResponse, | errors.Error400 | errors.Error401 | errors.Error403 | errors.Error404 | errors.Error405 | errors.Error409 | errors.HTTPValidationError | errors.Error425 | errors.Error429 | errors.Error500 | errors.Error502 | errors.Error504 | Gr4vyError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError >, { cursor: string } > > { return new APIPromise($do( client, request, options, )); } async function $do( client: Gr4vyCore, request?: operations.ListTransactionsRequest | undefined, options?: RequestOptions, ): Promise< [ PageIterator< Result< operations.ListTransactionsResponse, | errors.Error400 | errors.Error401 | errors.Error403 | errors.Error404 | errors.Error405 | errors.Error409 | errors.HTTPValidationError | errors.Error425 | errors.Error429 | errors.Error500 | errors.Error502 | errors.Error504 | Gr4vyError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError >, { cursor: string } >, APICall, ] > { const parsed = safeParse( request, (value) => operations.ListTransactionsRequest$outboundSchema.optional().parse(value), "Input validation failed", ); if (!parsed.ok) { return [haltIterator(parsed), { status: "invalid" }]; } const payload = parsed.value; const body = null; const path = pathToFunc("/transactions")(); const query = encodeFormQuery({ "amount_eq": payload?.amount_eq, "amount_gte": payload?.amount_gte, "amount_lte": payload?.amount_lte, "buyer_email_address": payload?.buyer_email_address, "buyer_external_identifier": payload?.buyer_external_identifier, "buyer_id": payload?.buyer_id, "buyer_search": payload?.buyer_search, "checkout_session_id": payload?.checkout_session_id, "country": payload?.country, "created_at_gte": payload?.created_at_gte, "created_at_lte": payload?.created_at_lte, "currency": payload?.currency, "cursor": payload?.cursor, "disputed": payload?.disputed, "error_code": payload?.error_code, "external_identifier": payload?.external_identifier, "gift_card_id": payload?.gift_card_id, "gift_card_last4": payload?.gift_card_last4, "has_gift_card_redemptions": payload?.has_gift_card_redemptions, "has_refunds": payload?.has_refunds, "has_settlements": payload?.has_settlements, "id": payload?.id, "ip_address": payload?.ip_address, "is_subsequent_payment": payload?.is_subsequent_payment, "limit": payload?.limit, "merchant_initiated": payload?.merchant_initiated, "metadata": payload?.metadata, "method": payload?.method, "payment_link_id": payload?.payment_link_id, "payment_method_bin": payload?.payment_method_bin, "payment_method_country": payload?.payment_method_country, "payment_method_fingerprint": payload?.payment_method_fingerprint, "payment_method_id": payload?.payment_method_id, "payment_method_label": payload?.payment_method_label, "payment_method_scheme": payload?.payment_method_scheme, "payment_service_id": payload?.payment_service_id, "payment_service_transaction_id": payload?.payment_service_transaction_id, "payment_source": payload?.payment_source, "pending_review": payload?.pending_review, "reauthorized_from_transaction_id": payload ?.reauthorized_from_transaction_id, "reconciliation_id": payload?.reconciliation_id, "search": payload?.search, "status": payload?.status, "updated_at_gte": payload?.updated_at_gte, "updated_at_lte": payload?.updated_at_lte, "used_3ds": payload?.used_3ds, }); const headers = new Headers(compactMap({ Accept: "application/json", "x-gr4vy-merchant-account-id": encodeSimple( "x-gr4vy-merchant-account-id", payload?.merchantAccountId ?? client._options.merchantAccountId, { explode: false, charEncoding: "none" }, ), })); const secConfig = await extractSecurity(client._options.bearerAuth); const securityInput = secConfig == null ? {} : { bearerAuth: secConfig }; const requestSecurity = resolveGlobalSecurity(securityInput); const context = { options: client._options, baseURL: options?.serverURL ?? client._baseURL ?? "", operationID: "list_transactions", oAuth2Scopes: null, resolvedSecurity: requestSecurity, securitySource: client._options.bearerAuth, retryConfig: options?.retries || client._options.retryConfig || { strategy: "backoff", backoff: { initialInterval: 200, maxInterval: 200, exponent: 1, maxElapsedTime: 1000, }, retryConnectionErrors: true, } || { strategy: "none" }, retryCodes: options?.retryCodes || ["5XX"], }; const requestRes = client._createRequest(context, { security: requestSecurity, method: "GET", baseURL: options?.serverURL, path: path, headers: headers, query: query, body: body, userAgent: client._options.userAgent, timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1, }, options); if (!requestRes.ok) { return [haltIterator(requestRes), { status: "invalid" }]; } const req = requestRes.value; const doResult = await client._do(req, { context, isErrorStatusCode: (statusCode: number) => matchStatusCode({ status: statusCode } as Response, ["4XX", "5XX"]), retryConfig: context.retryConfig, retryCodes: context.retryCodes, }); if (!doResult.ok) { return [haltIterator(doResult), { status: "request-error", request: req }]; } const response = doResult.value; const responseFields = { HttpMeta: { Response: response, Request: req }, }; const [result, raw] = await M.match< operations.ListTransactionsResponse, | errors.Error400 | errors.Error401 | errors.Error403 | errors.Error404 | errors.Error405 | errors.Error409 | errors.HTTPValidationError | errors.Error425 | errors.Error429 | errors.Error500 | errors.Error502 | errors.Error504 | Gr4vyError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError >( M.json(200, operations.ListTransactionsResponse$inboundSchema, { key: "Result", }), M.jsonErr(400, errors.Error400$inboundSchema), M.jsonErr(401, errors.Error401$inboundSchema), M.jsonErr(403, errors.Error403$inboundSchema), M.jsonErr(404, errors.Error404$inboundSchema), M.jsonErr(405, errors.Error405$inboundSchema), M.jsonErr(409, errors.Error409$inboundSchema), M.jsonErr(422, errors.HTTPValidationError$inboundSchema), M.jsonErr(425, errors.Error425$inboundSchema), M.jsonErr(429, errors.Error429$inboundSchema), M.jsonErr(500, errors.Error500$inboundSchema), M.jsonErr(502, errors.Error502$inboundSchema), M.jsonErr(504, errors.Error504$inboundSchema), M.fail("4XX"), M.fail("5XX"), )(response, req, { extraFields: responseFields }); if (!result.ok) { return [haltIterator(result), { status: "complete", request: req, response, }]; } const nextFunc = ( responseData: unknown, ): { next: Paginator< Result< operations.ListTransactionsResponse, | errors.Error400 | errors.Error401 | errors.Error403 | errors.Error404 | errors.Error405 | errors.Error409 | errors.HTTPValidationError | errors.Error425 | errors.Error429 | errors.Error500 | errors.Error502 | errors.Error504 | Gr4vyError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError > >; "~next"?: { cursor: string }; } => { const nextCursor = (responseData as { next_cursor?: unknown | null }).next_cursor; if (typeof nextCursor !== "string") { return { next: () => null }; } if (nextCursor.trim() === "") { return { next: () => null }; } const nextVal = () => transactionsList( client, { ...request!, cursor: nextCursor, }, options, ); return { next: nextVal, "~next": { cursor: nextCursor } }; }; const page = { ...result, ...nextFunc(raw) }; return [{ ...page, ...createPageIterator(page, (v) => !v.ok) }, { status: "complete", request: req, response, }]; }