@oatfi/oatfi-sdk-ts 0.11.55 → 0.11.56

package/src/funcs/businessesGetAccountHolderInformation.ts

@@ -0,0 +1,190 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { OatFiSDKCore } from "../core.js";
+import { encodeFormQuery, encodeSimple } from "../lib/encodings.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 {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { OatFiSDKError } from "../models/errors/oatfisdkerror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Retrieve account holder information
+ *
+ * @remarks
+ * Retrieve account holder information and virtual accounts related to the business
+ */
+export function businessesGetAccountHolderInformation(
+  client: OatFiSDKCore,
+  request: operations.BusinessesControllerGetAccountHolderInformationRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    models.GetAccountHolderInformationResponseDto,
+    | OatFiSDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: OatFiSDKCore,
+  request: operations.BusinessesControllerGetAccountHolderInformationRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      models.GetAccountHolderInformationResponseDto,
+      | OatFiSDKError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations
+        .BusinessesControllerGetAccountHolderInformationRequest$outboundSchema
+        .parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    id: encodeSimple("id", payload.id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+
+  const path = pathToFunc("/v3/businesses/{id}/account-holder-information")(
+    pathParams,
+  );
+
+  const query = encodeFormQuery({
+    "counter_party_business_external_id":
+      payload.counter_party_business_external_id,
+    "page_number": payload.page_number,
+    "page_size": payload.page_size,
+  });
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.bearer);
+  const securityInput = secConfig == null ? {} : { bearer: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "BusinessesController_getAccountHolderInformation",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.bearer,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || {
+        strategy: "backoff",
+        backoff: {
+          initialInterval: 500,
+          maxInterval: 60000,
+          exponent: 1.5,
+          maxElapsedTime: 120000,
+        },
+        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 [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    errorCodes: ["400", "401", "403", "404", "4XX", "5XX"],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const [result] = await M.match<
+    models.GetAccountHolderInformationResponseDto,
+    | OatFiSDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, models.GetAccountHolderInformationResponseDto$inboundSchema),
+    M.fail([400, 401, 403, 404, "4XX"]),
+    M.fail("5XX"),
+  )(response, req);
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/funcs/businessesGetVirtualAccountInformation.ts

@@ -0,0 +1,190 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { OatFiSDKCore } from "../core.js";
+import { encodeFormQuery, encodeSimple } from "../lib/encodings.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 {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { OatFiSDKError } from "../models/errors/oatfisdkerror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Retrieve virtual account information
+ *
+ * @remarks
+ * Retrieve virtual accounts related to a business (Oatfi Payments only)
+ */
+export function businessesGetVirtualAccountInformation(
+  client: OatFiSDKCore,
+  request: operations.BusinessesControllerGetVirtualAccountInformationRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    models.GetVirtualAccountInformationResponseDto,
+    | OatFiSDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: OatFiSDKCore,
+  request: operations.BusinessesControllerGetVirtualAccountInformationRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      models.GetVirtualAccountInformationResponseDto,
+      | OatFiSDKError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations
+        .BusinessesControllerGetVirtualAccountInformationRequest$outboundSchema
+        .parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    id: encodeSimple("id", payload.id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+
+  const path = pathToFunc("/v3/businesses/{id}/virtual-account-information")(
+    pathParams,
+  );
+
+  const query = encodeFormQuery({
+    "account_holder_business_external_id":
+      payload.account_holder_business_external_id,
+    "page_number": payload.page_number,
+    "page_size": payload.page_size,
+  });
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.bearer);
+  const securityInput = secConfig == null ? {} : { bearer: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "BusinessesController_getVirtualAccountInformation",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.bearer,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || {
+        strategy: "backoff",
+        backoff: {
+          initialInterval: 500,
+          maxInterval: 60000,
+          exponent: 1.5,
+          maxElapsedTime: 120000,
+        },
+        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 [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    errorCodes: ["400", "401", "403", "404", "4XX", "5XX"],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const [result] = await M.match<
+    models.GetVirtualAccountInformationResponseDto,
+    | OatFiSDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, models.GetVirtualAccountInformationResponseDto$inboundSchema),
+    M.fail([400, 401, 403, 404, "4XX"]),
+    M.fail("5XX"),
+  )(response, req);
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/funcs/filesList.ts

@@ -104,6 +104,7 @@ async function $do(
     "ending_before": payload?.ending_before,
     "file_type": payload?.file_type,
     "limit": payload?.limit,
+    "q": payload?.q,
     "resource_id": payload?.resource_id,
     "resource_type": payload?.resource_type,
     "starting_after": payload?.starting_after,

package/src/funcs/filesUpload.ts

@@ -103,6 +103,17 @@ async function $do(
         || "application/octet-stream";
       const blob = new Blob([buffer], { type: contentType });
       appendForm(body, "files[]", blob, fileItem.fileName);
+    } else if (fileItem.content instanceof Uint8Array) {
+      const contentType = getContentTypeFromFileName(fileItem.fileName)
+        || "application/octet-stream";
+      appendForm(
+        body,
+        "files[]",
+        new Blob([new Uint8Array(fileItem.content).buffer], {
+          type: contentType,
+        }),
+        fileItem.fileName,
+      );
     } else {
       const contentType = getContentTypeFromFileName(fileItem.fileName)
         || "application/octet-stream";

package/src/lib/config.ts

@@ -69,8 +69,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "3.0.0",
-  sdkVersion: "0.11.55",
-  genVersion: "2.845.1",
+  sdkVersion: "0.11.56",
+  genVersion: "2.849.8",
   userAgent:
-    "speakeasy-sdk/typescript 0.11.55 2.845.1 3.0.0 @oatfi/oatfi-sdk-ts",
+    "speakeasy-sdk/typescript 0.11.56 2.849.8 3.0.0 @oatfi/oatfi-sdk-ts",
 } as const;

package/src/lib/matchers.ts

@@ -251,8 +251,9 @@ export function match<T, E>(
         raw = body;
         break;
       default:
-        encoding satisfies never;
-        throw new Error(`Unsupported response type: ${encoding}`);
+        throw new Error(
+          `Unsupported response type: ${encoding satisfies never}`,
+        );
     }
 
     if (matcher.enc === "fail") {

package/src/lib/security.ts

@@ -198,8 +198,7 @@ export function resolveSecurity(
         applyBearer(state, spec);
         break;
       default:
-        spec satisfies never;
-        throw SecurityError.unrecognizedType(type);
+        throw SecurityError.unrecognizedType((spec satisfies never, type));
     }
   });
 

package/src/models/accountholdervirtualaccountitemdto.ts

@@ -0,0 +1,69 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+import {
+  LockboxAddressDto,
+  LockboxAddressDto$inboundSchema,
+} from "./lockboxaddressdto.js";
+
+export type AccountHolderVirtualAccountItemDto = {
+  /**
+   * Payment method ID
+   */
+  paymentMethodId: string;
+  /**
+   * Counter party holder business external ID
+   */
+  counterPartyHolderBusinessExternalId: string;
+  /**
+   * Account number
+   */
+  accountNumber: string;
+  /**
+   * Routing number
+   */
+  routingNumber: string;
+  /**
+   * Lockbox address
+   */
+  lockboxAddress?: LockboxAddressDto | undefined;
+};
+
+/** @internal */
+export const AccountHolderVirtualAccountItemDto$inboundSchema: z.ZodType<
+  AccountHolderVirtualAccountItemDto,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  payment_method_id: z.string(),
+  counter_party_holder_business_external_id: z.string(),
+  account_number: z.string(),
+  routing_number: z.string(),
+  lockbox_address: LockboxAddressDto$inboundSchema.optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "payment_method_id": "paymentMethodId",
+    "counter_party_holder_business_external_id":
+      "counterPartyHolderBusinessExternalId",
+    "account_number": "accountNumber",
+    "routing_number": "routingNumber",
+    "lockbox_address": "lockboxAddress",
+  });
+});
+
+export function accountHolderVirtualAccountItemDtoFromJSON(
+  jsonString: string,
+): SafeParseResult<AccountHolderVirtualAccountItemDto, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      AccountHolderVirtualAccountItemDto$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AccountHolderVirtualAccountItemDto' from JSON`,
+  );
+}

package/src/models/createoriginationofferdto.ts

@@ -4,11 +4,6 @@
 
 import * as z from "zod/v3";
 import { remap as remap$ } from "../lib/primitives.js";
-import {
-  PaymentIntentDto,
-  PaymentIntentDto$Outbound,
-  PaymentIntentDto$outboundSchema,
-} from "./paymentintentdto.js";
 
 /**
  * Metadata to associate with the offer request
@@ -68,10 +63,6 @@ export type CreateOriginationOfferDto = {
    * The repayment date timestamp
    */
   repaymentDate?: number | undefined;
-  /**
-   * Array of payment intents
-   */
-  paymentIntents?: Array<PaymentIntentDto> | undefined;
   /**
    * Metadata to associate with the offer request
    */
@@ -113,7 +104,6 @@ export type CreateOriginationOfferDto$Outbound = {
   payment_intent_id?: string | undefined;
   due_date?: number | undefined;
   repayment_date?: number | undefined;
-  payment_intents?: Array<PaymentIntentDto$Outbound> | undefined;
   metadata?: CreateOriginationOfferDtoMetadata$Outbound | undefined;
 };
 
@@ -136,7 +126,6 @@ export const CreateOriginationOfferDto$outboundSchema: z.ZodType<
   paymentIntentId: z.string().optional(),
   dueDate: z.number().optional(),
   repaymentDate: z.number().optional(),
-  paymentIntents: z.array(PaymentIntentDto$outboundSchema).optional(),
   metadata: z.lazy(() => CreateOriginationOfferDtoMetadata$outboundSchema)
     .optional(),
 }).transform((v) => {
@@ -152,7 +141,6 @@ export const CreateOriginationOfferDto$outboundSchema: z.ZodType<
     paymentIntentId: "payment_intent_id",
     dueDate: "due_date",
     repaymentDate: "repayment_date",
-    paymentIntents: "payment_intents",
   });
 });
 

package/src/models/createpaymentintentdto.ts

@@ -65,6 +65,10 @@ export type CreatePaymentIntentDto = {
    * External identifier of the payee entity.
    */
   payee?: string | undefined;
+  /**
+   * Array of loan IDs to associate with this payment intent.
+   */
+  loanIds?: Array<string> | undefined;
 };
 
 /** @internal */
@@ -85,6 +89,7 @@ export type CreatePaymentIntentDto$Outbound = {
   approved_by_payor?: boolean | undefined;
   payor?: string | undefined;
   payee?: string | undefined;
+  loan_ids?: Array<string> | undefined;
 };
 
 /** @internal */
@@ -104,6 +109,7 @@ export const CreatePaymentIntentDto$outboundSchema: z.ZodType<
   approvedByPayor: z.boolean().optional(),
   payor: z.string().optional(),
   payee: z.string().optional(),
+  loanIds: z.array(z.string()).optional(),
 }).transform((v) => {
   return remap$(v, {
     externalId: "external_id",
@@ -112,6 +118,7 @@ export const CreatePaymentIntentDto$outboundSchema: z.ZodType<
     dueDate: "due_date",
     paymentDate: "payment_date",
     approvedByPayor: "approved_by_payor",
+    loanIds: "loan_ids",
   });
 });
 

package/src/models/financialaccountdatadto.ts

@@ -137,6 +137,10 @@ export type FinancialAccountDataDto = {
    * Routing Number
    */
   oatfiRoutingNumber?: string | undefined;
+  /**
+   * Plaid processor token for transaction data extraction. Used by partners who already collect Plaid access from their borrowers.
+   */
+  processorPlaidToken?: string | undefined;
 };
 
 /** @internal */
@@ -288,6 +292,7 @@ export const FinancialAccountDataDto$inboundSchema: z.ZodType<
   account_number_id: z.string().optional(),
   oatfi_account_number: z.string().optional(),
   oatfi_routing_number: z.string().optional(),
+  processor_plaid_token: z.string().optional(),
 }).transform((v) => {
   return remap$(v, {
     "account_id": "accountId",
@@ -306,6 +311,7 @@ export const FinancialAccountDataDto$inboundSchema: z.ZodType<
     "account_number_id": "accountNumberId",
     "oatfi_account_number": "oatfiAccountNumber",
     "oatfi_routing_number": "oatfiRoutingNumber",
+    "processor_plaid_token": "processorPlaidToken",
   });
 });
 /** @internal */
@@ -326,6 +332,7 @@ export type FinancialAccountDataDto$Outbound = {
   account_number_id?: string | undefined;
   oatfi_account_number?: string | undefined;
   oatfi_routing_number?: string | undefined;
+  processor_plaid_token?: string | undefined;
 };
 
 /** @internal */
@@ -352,6 +359,7 @@ export const FinancialAccountDataDto$outboundSchema: z.ZodType<
   accountNumberId: z.string().optional(),
   oatfiAccountNumber: z.string().optional(),
   oatfiRoutingNumber: z.string().optional(),
+  processorPlaidToken: z.string().optional(),
 }).transform((v) => {
   return remap$(v, {
     accountId: "account_id",
@@ -370,6 +378,7 @@ export const FinancialAccountDataDto$outboundSchema: z.ZodType<
     accountNumberId: "account_number_id",
     oatfiAccountNumber: "oatfi_account_number",
     oatfiRoutingNumber: "oatfi_routing_number",
+    processorPlaidToken: "processor_plaid_token",
   });
 });
 

package/src/models/financialaccountverificationdto.ts

@@ -13,6 +13,7 @@ export const ConsentSource = {
   Embedded: "EMBEDDED",
   Hosted: "HOSTED",
   PartnerApi: "PARTNER_API",
+  PartnerAdmin: "PARTNER_ADMIN",
 } as const;
 /**
  * Source of consent

package/src/models/financialaccountverificationresponsedto.ts

@@ -16,7 +16,7 @@ export type FinancialAccountVerificationResponseDto = {
   /**
    * Source of consent
    */
-  consentSource: string;
+  consentSource?: string | undefined;
   /**
    * Timestamp when consent was given
    */
@@ -46,7 +46,7 @@ export const FinancialAccountVerificationResponseDto$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   consent_given: z.boolean(),
-  consent_source: z.string(),
+  consent_source: z.string().optional(),
   consent_timestamp: z.string().datetime({ offset: true }).transform(v =>
     new Date(v)
   ).optional(),