@oatfi/oatfi-sdk-ts 0.12.3 → 0.12.4

package/src/lib/sdks.ts

@@ -24,6 +24,7 @@ import {
   matchContentType,
 } from "./http.js";
 import { Logger } from "./logger.js";
+import { combineSignals } from "./primitives.js";
 import { retry, RetryConfig } from "./retries.js";
 import { SecurityState } from "./security.js";
 
@@ -131,27 +132,55 @@ export class ClientSDK {
     if (path) {
       baseURL.pathname = baseURL.pathname.replace(/\/+$/, "") + "/";
       reqURL = new URL(path, baseURL);
+      if (!reqURL.search && baseURL.search) {
+        reqURL.search = baseURL.search;
+      }
     } else {
       reqURL = baseURL;
     }
     reqURL.hash = "";
 
-    let finalQuery = query || "";
-
-    const secQuery: string[] = [];
-    for (const [k, v] of Object.entries(security?.queryParams || {})) {
-      const q = encodeForm(k, v, { charEncoding: "percent" });
-      if (typeof q !== "undefined") {
-        secQuery.push(q);
+    // Appends already-encoded query pairs to a query string, replacing any
+    // existing pairs with the same key so later sources take precedence.
+    const mergeQuery = (current: string, additions: string): string => {
+      if (!additions) {
+        return current;
       }
-    }
-    if (secQuery.length) {
-      finalQuery += `&${secQuery.join("&")}`;
-    }
+      const additionKeys = new Set(
+        additions
+          .split("&")
+          .filter((pair) => pair !== "")
+          .map((pair) => pair.split("=")[0] ?? ""),
+      );
+      const kept = current.split("&").filter((pair) => {
+        return pair !== "" && !additionKeys.has(pair.split("=")[0] ?? "");
+      });
+      return [...kept, additions].join("&");
+    };
+
+    const encodeQueryRecord = (record: Record<string, unknown>): string => {
+      return Object.entries(record)
+        .map(([k, v]) => {
+          if (v == null) {
+            return undefined;
+          }
+          const value = v;
+          return encodeForm(k, value, {
+            explode: Array.isArray(value),
+            charEncoding: "percent",
+          });
+        })
+        .filter((pair): pair is string => typeof pair !== "undefined")
+        .join("&");
+    };
+
+    const finalQuery = [
+      query || "",
+      encodeQueryRecord(security?.queryParams || {}),
+    ].reduce(mergeQuery, reqURL.search.slice(1));
 
     if (finalQuery) {
-      const q = finalQuery.startsWith("&") ? finalQuery.slice(1) : finalQuery;
-      reqURL.search = `?${q}`;
+      reqURL.search = `?${finalQuery}`;
     }
 
     const headers = new Headers(opHeaders);
@@ -197,9 +226,8 @@ export class ClientSDK {
       ...options?.fetchOptions,
       ...options,
     };
-    if (!fetchOptions?.signal && conf.timeoutMs && conf.timeoutMs > 0) {
-      const timeoutSignal = AbortSignal.timeout(conf.timeoutMs);
-      fetchOptions.signal = timeoutSignal;
+    if (!fetchOptions?.signal && conf.timeoutMs != null && conf.timeoutMs > 0) {
+      context.timeoutMs = conf.timeoutMs;
     }
 
     if (conf.body instanceof ReadableStream) {
@@ -246,10 +274,19 @@ export class ClientSDK {
     >
   > {
     const { context, isErrorStatusCode } = options;
+    const timeoutMs = context.timeoutMs;
 
     return retry(
       async () => {
-        const req = await this.#hooks.beforeRequest(context, request.clone());
+        const cloned = request.clone();
+        let attempt = cloned;
+        if (timeoutMs != null && timeoutMs > 0) {
+          const timeoutSignal = AbortSignal.timeout(timeoutMs);
+          const combined = combineSignals(cloned.signal, timeoutSignal)
+            ?? timeoutSignal;
+          attempt = new Request(cloned, { signal: combined });
+        }
+        const req = await this.#hooks.beforeRequest(context, attempt);
         await logRequest(this.#logger, req).catch((e) =>
           this.#logger?.log("Failed to log request:", e)
         );

package/src/models/adjustmentresponsedto.ts

@@ -10,6 +10,9 @@ import { Result as SafeParseResult } from "../types/fp.js";
 import * as types from "../types/primitives.js";
 import { SDKValidationError } from "./errors/sdkvalidationerror.js";
 
+/**
+ * Adjustment classification. Mirrors the partner-side CreateAdjustmentDto.type enum.
+ */
 export const AdjustmentResponseDtoType = {
   Reward: "REWARD",
   Return: "RETURN",
@@ -22,6 +25,9 @@ export const AdjustmentResponseDtoType = {
   FeeOther: "FEE_OTHER",
   Other: "OTHER",
 } as const;
+/**
+ * Adjustment classification. Mirrors the partner-side CreateAdjustmentDto.type enum.
+ */
 export type AdjustmentResponseDtoType = ClosedEnum<
   typeof AdjustmentResponseDtoType
 >;

package/src/models/authorizebuyerauthorizeddto.ts

@@ -0,0 +1,57 @@
+/*
+ * 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 * as types from "../types/primitives.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+
+export type AuthorizeBuyerAuthorizedDto = {
+  /**
+   * Authorized.
+   */
+  authorized: boolean;
+  /**
+   * Lender's offer reference. Stored on the ledger entry as lms_offer_id and used by Step 2 (auto-triggered purchase execution).
+   */
+  offerId: string;
+  /**
+   * Unix milliseconds when the offer reservation expires.
+   */
+  offerExpiresAt: number;
+  /**
+   * Lender-side identifier for the credit reservation backing this offer. Stored on the ledger entry as lms_hold_id.
+   */
+  holdId: string;
+};
+
+/** @internal */
+export const AuthorizeBuyerAuthorizedDto$inboundSchema: z.ZodType<
+  AuthorizeBuyerAuthorizedDto,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  authorized: types.boolean(),
+  offer_id: types.string(),
+  offer_expires_at: types.number(),
+  hold_id: types.string(),
+}).transform((v) => {
+  return remap$(v, {
+    "offer_id": "offerId",
+    "offer_expires_at": "offerExpiresAt",
+    "hold_id": "holdId",
+  });
+});
+
+export function authorizeBuyerAuthorizedDtoFromJSON(
+  jsonString: string,
+): SafeParseResult<AuthorizeBuyerAuthorizedDto, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AuthorizeBuyerAuthorizedDto$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AuthorizeBuyerAuthorizedDto' from JSON`,
+  );
+}

package/src/models/authorizenotauthorizeddto.ts

@@ -0,0 +1,35 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import * as types from "../types/primitives.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+
+export type AuthorizeNotAuthorizedDto = {
+  /**
+   * Not authorized.
+   */
+  authorized: boolean;
+};
+
+/** @internal */
+export const AuthorizeNotAuthorizedDto$inboundSchema: z.ZodType<
+  AuthorizeNotAuthorizedDto,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  authorized: types.boolean(),
+});
+
+export function authorizeNotAuthorizedDtoFromJSON(
+  jsonString: string,
+): SafeParseResult<AuthorizeNotAuthorizedDto, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AuthorizeNotAuthorizedDto$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AuthorizeNotAuthorizedDto' from JSON`,
+  );
+}

package/src/models/authorizerequestdto.ts

@@ -0,0 +1,52 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../lib/primitives.js";
+
+export type AuthorizeRequestDto = {
+  /**
+   * Role-specific program id (lms_program_id when called on LMS, ipp_program_id when called on IPP).
+   */
+  programId: string;
+  /**
+   * The counterparty's partner-assigned external id — buyer.external_id when calling LMS, vendor.external_id when calling IPP. Lets the lender correlate the request to its own onboarded-business record.
+   */
+  businessExternalId: string;
+  /**
+   * Amount being authorized, in cents.
+   */
+  amount: number;
+};
+
+/** @internal */
+export type AuthorizeRequestDto$Outbound = {
+  program_id: string;
+  business_external_id: string;
+  amount: number;
+};
+
+/** @internal */
+export const AuthorizeRequestDto$outboundSchema: z.ZodType<
+  AuthorizeRequestDto$Outbound,
+  z.ZodTypeDef,
+  AuthorizeRequestDto
+> = z.object({
+  programId: z.string(),
+  businessExternalId: z.string(),
+  amount: z.number(),
+}).transform((v) => {
+  return remap$(v, {
+    programId: "program_id",
+    businessExternalId: "business_external_id",
+  });
+});
+
+export function authorizeRequestDtoToJSON(
+  authorizeRequestDto: AuthorizeRequestDto,
+): string {
+  return JSON.stringify(
+    AuthorizeRequestDto$outboundSchema.parse(authorizeRequestDto),
+  );
+}

package/src/models/authorizevendorauthorizeddto.ts

@@ -0,0 +1,81 @@
+/*
+ * 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 * as types from "../types/primitives.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+
+export type AuthorizeVendorAuthorizedDto = {
+  /**
+   * Authorized.
+   */
+  authorized: boolean;
+  /**
+   * IPP's offer reference. Stored on the ledger entry as ipp_offer_id and used by Step 2 (auto-triggered purchase execution).
+   */
+  offerId: string;
+  /**
+   * Unix milliseconds when the offer reservation expires.
+   */
+  offerExpiresAt: number;
+  /**
+   * IPP-side identifier for the credit reservation backing this offer. Stored on the ledger entry as ipp_hold_id.
+   */
+  holdId: string;
+  /**
+   * In cents. IPP's discount on the receivable purchase.
+   */
+  discountAmount: number;
+  /**
+   * In cents. original_amount - discount_amount. Returned for explicit cross-check.
+   */
+  purchaseAmount: number;
+  /**
+   * Date IPP will disburse to the vendor (YYYY-MM-DD).
+   */
+  disbursementDate: string;
+  /**
+   * In cents. Reward amount calculated by IPP.
+   */
+  rewardAmount: number;
+};
+
+/** @internal */
+export const AuthorizeVendorAuthorizedDto$inboundSchema: z.ZodType<
+  AuthorizeVendorAuthorizedDto,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  authorized: types.boolean(),
+  offer_id: types.string(),
+  offer_expires_at: types.number(),
+  hold_id: types.string(),
+  discount_amount: types.number(),
+  purchase_amount: types.number(),
+  disbursement_date: types.string(),
+  reward_amount: types.number(),
+}).transform((v) => {
+  return remap$(v, {
+    "offer_id": "offerId",
+    "offer_expires_at": "offerExpiresAt",
+    "hold_id": "holdId",
+    "discount_amount": "discountAmount",
+    "purchase_amount": "purchaseAmount",
+    "disbursement_date": "disbursementDate",
+    "reward_amount": "rewardAmount",
+  });
+});
+
+export function authorizeVendorAuthorizedDtoFromJSON(
+  jsonString: string,
+): SafeParseResult<AuthorizeVendorAuthorizedDto, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AuthorizeVendorAuthorizedDto$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AuthorizeVendorAuthorizedDto' from JSON`,
+  );
+}

package/src/models/billingcyclesresponsedto.ts

@@ -14,6 +14,7 @@ import { SDKValidationError } from "./errors/sdkvalidationerror.js";
  * The status of the billing cycle.
  */
 export const BillingCyclesResponseDtoStatus = {
+  Scheduled: "SCHEDULED",
   Open: "OPEN",
   Closed: "CLOSED",
 } as const;

package/src/models/businessrefdto.ts

@@ -0,0 +1,35 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../lib/primitives.js";
+
+export type BusinessRefDto = {
+  /**
+   * Partner-assigned external id — the lender's natural key for the business.
+   */
+  externalId: string;
+};
+
+/** @internal */
+export type BusinessRefDto$Outbound = {
+  external_id: string;
+};
+
+/** @internal */
+export const BusinessRefDto$outboundSchema: z.ZodType<
+  BusinessRefDto$Outbound,
+  z.ZodTypeDef,
+  BusinessRefDto
+> = z.object({
+  externalId: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    externalId: "external_id",
+  });
+});
+
+export function businessRefDtoToJSON(businessRefDto: BusinessRefDto): string {
+  return JSON.stringify(BusinessRefDto$outboundSchema.parse(businessRefDto));
+}

package/src/models/businessresponsedto.ts

@@ -8,187 +8,57 @@ import { safeParse } from "../lib/schemas.js";
 import { ClosedEnum } from "../types/enums.js";
 import { Result as SafeParseResult } from "../types/fp.js";
 import * as types from "../types/primitives.js";
-import { AddressDto, AddressDto$inboundSchema } from "./addressdto.js";
 import { SDKValidationError } from "./errors/sdkvalidationerror.js";
-import {
-  IncreaseDataDto,
-  IncreaseDataDto$inboundSchema,
-} from "./increasedatadto.js";
 
 /**
- * Current status of the business account
+ * Lender-side account state. inactive covers suspended/frozen/closed/blocked.
  */
-export const AccountStatus = {
-  Active: "ACTIVE",
-  Frozen: "FROZEN",
-  Inactive: "INACTIVE",
-  Closed: "CLOSED",
-  BlockList: "BLOCK_LIST",
+export const BusinessResponseDtoStatus = {
+  Active: "active",
+  Inactive: "inactive",
 } as const;
 /**
- * Current status of the business account
+ * Lender-side account state. inactive covers suspended/frozen/closed/blocked.
  */
-export type AccountStatus = ClosedEnum<typeof AccountStatus>;
-
-/**
- * Current sub-status of the business account
- */
-export const AccountSubStatus = {
-  Standard: "STANDARD",
-  Manual: "MANUAL",
-  ManualLock: "MANUAL_LOCK",
-  Dq: "DQ",
-  WaiveDrawRules: "WAIVE_DRAW_RULES",
-  Unit: "UNIT",
-} as const;
-/**
- * Current sub-status of the business account
- */
-export type AccountSubStatus = ClosedEnum<typeof AccountSubStatus>;
-
-/**
- * Source of the requested credit limit.
- */
-export const BusinessResponseDtoRequestedLimitSource = {
-  Partner: "Partner",
-  Customer: "Customer",
-} as const;
-/**
- * Source of the requested credit limit.
- */
-export type BusinessResponseDtoRequestedLimitSource = ClosedEnum<
-  typeof BusinessResponseDtoRequestedLimitSource
+export type BusinessResponseDtoStatus = ClosedEnum<
+  typeof BusinessResponseDtoStatus
 >;
 
 export type BusinessResponseDto = {
   /**
-   * Unique identifier for the business.
-   */
-  id: string;
-  /**
-   * String representing the object's type. Always 'business'.
-   */
-  object: string;
-  /**
-   * External identifier for the business.
-   */
-  externalId?: string | undefined;
-  /**
-   * Identifier of the platform this business is associated with.
-   */
-  platform?: string | undefined;
-  /**
-   * List of financial account IDs associated with this business.
-   */
-  financialAccounts?: Array<string> | undefined;
-  /**
-   * List of Plaid token IDs associated with this business.
-   */
-  plaidTokens?: Array<string> | undefined;
-  /**
-   * List of person IDs associated with this business.
-   */
-  persons?: Array<string> | undefined;
-  /**
-   * Legal name of the business.
-   */
-  name?: string | undefined;
-  /**
-   * Doing Business As (DBA) name.
-   */
-  dbaName?: string | undefined;
-  /**
-   * Tax ID (e.g., EIN for US businesses).
-   */
-  taxId?: string | undefined;
-  /**
-   * Business address.
-   */
-  address?: AddressDto | undefined;
-  /**
-   * Contact person's first name. Populated from the primary user's first name.
-   */
-  contactFirstName?: string | undefined;
-  /**
-   * Contact person's last name. Populated from the primary user's last name.
-   */
-  contactLastName?: string | undefined;
-  /**
-   * Contact person's email address. Populated from the primary user's email.
-   */
-  contactEmail?: string | undefined;
-  /**
-   * Contact person's phone number.
-   */
-  contactPhone?: string | undefined;
-  /**
-   * Month the business started (MM).
-   */
-  businessStartDateMonth?: string | undefined;
-  /**
-   * Year the business started (YYYY).
+   * Partner-assigned external id (the path key).
    */
-  businessStartDateYear?: string | undefined;
+  externalId: string;
   /**
-   * Type of business entity (e.g., corporation, llc).
+   * Lender-side account state. inactive covers suspended/frozen/closed/blocked.
    */
-  businessEntityType?: string | undefined;
+  status: BusinessResponseDtoStatus;
   /**
-   * Current status of the business account
+   * Legal business name.
    */
-  accountStatus?: AccountStatus | undefined;
+  name?: string | null | undefined;
   /**
-   * Current sub-status of the business account
+   * Tax id (e.g. EIN).
    */
-  accountSubStatus?: AccountSubStatus | undefined;
+  taxId?: string | null | undefined;
   /**
-   * Timestamp of when the business was created.
+   * Legal entity type.
    */
-  createdAt?: Date | undefined;
+  businessEntityType?: string | null | undefined;
   /**
-   * Timestamp of when the business was last updated.
+   * Unix ms when the lender created its record.
    */
-  updatedAt?: Date | undefined;
+  createdAt?: number | undefined;
   /**
-   * List of user IDs associated with this business.
+   * Unix ms of the last update.
    */
-  users?: Array<string> | undefined;
-  /**
-   * ID of the primary user associated with this business.
-   */
-  primaryUser?: string | undefined;
-  /**
-   * Source of the requested credit limit.
-   */
-  requestedLimitSource?: BusinessResponseDtoRequestedLimitSource | undefined;
-  /**
-   * Requested credit limit amount.
-   */
-  requestedCreditLimit?: number | undefined;
-  /**
-   * A set of key-value pairs that can be used to store additional information about the object.
-   */
-  metadata?: { [k: string]: any } | undefined;
-  /**
-   * Increase account data associated with this business.
-   */
-  increase?: IncreaseDataDto | undefined;
+  updatedAt?: number | undefined;
 };
 
 /** @internal */
-export const AccountStatus$inboundSchema: z.ZodNativeEnum<
-  typeof AccountStatus
-> = z.nativeEnum(AccountStatus);
-
-/** @internal */
-export const AccountSubStatus$inboundSchema: z.ZodNativeEnum<
-  typeof AccountSubStatus
-> = z.nativeEnum(AccountSubStatus);
-
-/** @internal */
-export const BusinessResponseDtoRequestedLimitSource$inboundSchema:
-  z.ZodNativeEnum<typeof BusinessResponseDtoRequestedLimitSource> = z
-    .nativeEnum(BusinessResponseDtoRequestedLimitSource);
+export const BusinessResponseDtoStatus$inboundSchema: z.ZodNativeEnum<
+  typeof BusinessResponseDtoStatus
+> = z.nativeEnum(BusinessResponseDtoStatus);
 
 /** @internal */
 export const BusinessResponseDto$inboundSchema: z.ZodType<
@@ -196,57 +66,20 @@ export const BusinessResponseDto$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  id: types.string(),
-  object: types.string().default("business"),
-  external_id: types.optional(types.string()),
-  platform: types.optional(types.string()),
-  financial_accounts: types.optional(z.array(types.string())),
-  plaid_tokens: types.optional(z.array(types.string())),
-  persons: types.optional(z.array(types.string())),
-  name: types.optional(types.string()),
-  dba_name: types.optional(types.string()),
-  tax_id: types.optional(types.string()),
-  address: types.optional(AddressDto$inboundSchema),
-  contact_first_name: types.optional(types.string()),
-  contact_last_name: types.optional(types.string()),
-  contact_email: types.optional(types.string()),
-  contact_phone: types.optional(types.string()),
-  business_start_date_month: types.optional(types.string()),
-  business_start_date_year: types.optional(types.string()),
-  business_entity_type: types.optional(types.string()),
-  account_status: types.optional(AccountStatus$inboundSchema),
-  account_sub_status: types.optional(AccountSubStatus$inboundSchema),
-  created_at: types.optional(types.date()),
-  updated_at: types.optional(types.date()),
-  users: types.optional(z.array(types.string())),
-  primary_user: types.optional(types.string()),
-  requested_limit_source: types.optional(
-    BusinessResponseDtoRequestedLimitSource$inboundSchema,
-  ),
-  requested_credit_limit: types.optional(types.number()),
-  metadata: types.optional(z.record(z.any())),
-  increase: types.optional(IncreaseDataDto$inboundSchema),
+  external_id: types.string(),
+  status: BusinessResponseDtoStatus$inboundSchema,
+  name: z.nullable(types.string()).optional(),
+  tax_id: z.nullable(types.string()).optional(),
+  business_entity_type: z.nullable(types.string()).optional(),
+  created_at: types.optional(types.number()),
+  updated_at: types.optional(types.number()),
 }).transform((v) => {
   return remap$(v, {
     "external_id": "externalId",
-    "financial_accounts": "financialAccounts",
-    "plaid_tokens": "plaidTokens",
-    "dba_name": "dbaName",
     "tax_id": "taxId",
-    "contact_first_name": "contactFirstName",
-    "contact_last_name": "contactLastName",
-    "contact_email": "contactEmail",
-    "contact_phone": "contactPhone",
-    "business_start_date_month": "businessStartDateMonth",
-    "business_start_date_year": "businessStartDateYear",
     "business_entity_type": "businessEntityType",
-    "account_status": "accountStatus",
-    "account_sub_status": "accountSubStatus",
     "created_at": "createdAt",
     "updated_at": "updatedAt",
-    "primary_user": "primaryUser",
-    "requested_limit_source": "requestedLimitSource",
-    "requested_credit_limit": "requestedCreditLimit",
   });
 });