@matech/thebigpos-sdk 2.45.1-rc0 → 2.45.1-rc10

package/scripts/apply-json-patch-content-type.js

@@ -1,56 +1,149 @@
-/* 
-  This script is meant to run after the SDK has been generated.
+/*
+  Post-generation fixup for the generated TypeScript SDK.
 
-  - It updates the generated code to ensure that all PATCH methods use ContentType.JsonPatch.
-  - It also ensures that the ContentType enum includes JsonPatch and modifies the Operation interface
-    to allow any value for the `value` property instead of just object or null.
+  swagger-typescript-api does not propagate the `application/json-patch+json`
+  request content type into the generated code, so PATCH methods that use JSON
+  Patch would otherwise go out with the wrong Content-Type. This script restores
+  it by reading the OpenAPI spec the SDK was generated from and, for every
+  generated PATCH method, setting:
 
-  This is necessary because the SDK generation does not currently handle these cases correctly.
+    - ContentType.JsonPatch  -> when the spec's requestBody for that path
+                                advertises application/json-patch+json
+    - ContentType.Json       -> for every other PATCH method
+                                (e.g. updateLoan, which the backend declares as
+                                [Consumes("application/json")])
+
+  The decision is taken entirely from the spec — there is no hard-coded list of
+  endpoints to keep in sync. It also ensures the ContentType enum includes
+  JsonPatch and relaxes the Operation interface `value` to accept any value.
+
+  Usage (pass the SAME spec given to `swagger-typescript-api -p`):
+    node scripts/apply-json-patch-content-type.js https://api.thebigpos.dev/swagger/<version>/swagger.json
+    node scripts/apply-json-patch-content-type.js ./swagger.json
+    SWAGGER_SPEC=<url-or-file> node scripts/apply-json-patch-content-type.js
+
+  Design notes:
+    - The rewrite is scoped to a single generated method block at a time
+      (anchored on that method's own `...params,`), so it can never bleed across
+      method boundaries.
+    - It sets each method's content type to its target value rather than doing a
+      conditional replace, so it is idempotent and self-healing (it also repairs
+      a previously-seen ContentType.JsonPatchPatch double-application).
+    - If no spec is provided (e.g. a plain commit-hook run), the content-type
+      rewrite is skipped instead of guessing, so it can never silently corrupt
+      the generated output.
 */
 
 const fs = require('fs')
+const nodePath = require('path')
 
-const path = require('path').resolve(__dirname, '../src/index.ts')
+const SRC = nodePath.resolve(__dirname, '../src/index.ts')
 
-if (!fs.existsSync(path)) {
-	console.error(`Error: File not found at path "${path}". Please ensure the SDK has been generated.`)
-	process.exit(1)
+async function loadSpec(source) {
+	if (!source) return null
+	if (/^https?:\/\//i.test(source)) {
+		const res = await fetch(source)
+		if (!res.ok) throw new Error(`Failed to fetch spec from "${source}": HTTP ${res.status}`)
+		return res.json()
+	}
+	return JSON.parse(fs.readFileSync(nodePath.resolve(source), 'utf8'))
 }
-let content
-try {
-	content = fs.readFileSync(path, 'utf8')
-} catch (err) {
-	console.error(`Error: Unable to read file at path "${path}". Details: ${err.message}`)
-	process.exit(1)
+
+// Collapse spec ("{id}") and generated ("${id}") path params to a common token
+// so generated paths can be matched against spec paths regardless of param names.
+function normalizePath(p) {
+	return p.replace(/\$\{[^}]+\}/g, '{}').replace(/\{[^}]+\}/g, '{}')
 }
 
-// Update PATCH methods to use ContentType.JsonPatch
-content = content.replace(
-	/(method:\s*"PATCH",[\s\S]*?type:\s*)ContentType\.Json\b(?!Patch)/g,
-	'$1ContentType.JsonPatch'
-)
+function jsonPatchPaths(spec) {
+	const set = new Set()
+	for (const [route, ops] of Object.entries(spec.paths || {})) {
+		const content = ops && ops.patch && ops.patch.requestBody && ops.patch.requestBody.content
+		if (content && Object.prototype.hasOwnProperty.call(content, 'application/json-patch+json')) {
+			set.add(normalizePath(route))
+		}
+	}
+	return set
+}
+
+function setContentType(block, member) {
+	const target = `type: ContentType.${member}`
+	if (/type:\s*ContentType\.\w+/.test(block)) return block.replace(/type:\s*ContentType\.\w+/, target)
+	if (/type:\s*"[^"]*"/.test(block)) return block.replace(/type:\s*"[^"]*"/, target)
+	if (/\n(\s*)format:/.test(block)) return block.replace(/\n(\s*)format:/, `\n$1${target},\n$1format:`)
+	return block.replace(/\n(\s*)\.\.\.params,/, `\n$1${target},\n$1...params,`)
+}
 
-// Ensure JsonPatch is included in the ContentType enum
-content = content.replace(
-	/export enum ContentType\s*{([\s\S]*?)}/,
-	(match, enumBody) => {
+function ensureJsonPatchEnum(content) {
+	return content.replace(/export enum ContentType\s*{([\s\S]*?)}/, (match, enumBody) => {
 		if (enumBody.includes('JsonPatch')) return match
-		const insertion = `  JsonPatch = "application/json-patch+json",\n  `
-		return `export enum ContentType {\n${insertion}${enumBody.trim()}\n}`
-	}
-)
+		return `export enum ContentType {\n  JsonPatch = "application/json-patch+json",\n  ${enumBody.trim()}\n}`
+	})
+}
 
-// Fix the Operation interface to allow any value
-content = content.replace(
-	/export interface Operation\s*{([\s\S]*?)}/,
-	(match, body) => {
+function relaxOperationValue(content) {
+	return content.replace(/export interface Operation\s*{([\s\S]*?)}/, (match, body) => {
 		const updated = body.replace(
 			/value\?:\s*object\s*\|?\s*null?;/,
 			'value?: string | number | boolean | null | object;'
 		)
 		return `export interface Operation {\n  ${updated.trim()}\n}`
+	})
+}
+
+function applyContentTypes(content, patchPaths) {
+	// Heal any earlier double-application (ContentType.JsonPatchPatch...).
+	content = content.replace(/ContentType\.JsonPatch(?:Patch)+\b/g, 'ContentType.JsonPatch')
+
+	const METHOD_BLOCK = /[a-zA-Z0-9_]+:\s*\([\s\S]*?\)\s*=>\s*this\.request<[^>]*>\(\{[\s\S]*?\.\.\.params,/g
+	return content.replace(METHOD_BLOCK, (block) => {
+		if (!/method:\s*"PATCH"/.test(block)) {
+			// Non-PATCH methods must never be JSON Patch.
+			return /type:\s*ContentType\.JsonPatch\b/.test(block)
+				? block.replace(/type:\s*ContentType\.JsonPatch\b/, 'type: ContentType.Json')
+				: block
+		}
+		const routeMatch = block.match(/path:\s*`([^`]*)`/)
+		const route = routeMatch ? normalizePath(routeMatch[1]) : ''
+		return setContentType(block, patchPaths.has(route) ? 'JsonPatch' : 'Json')
+	})
+}
+
+;(async () => {
+	if (!fs.existsSync(SRC)) {
+		console.error(`Error: File not found at "${SRC}". Generate the SDK first.`)
+		process.exit(1)
+	}
+
+	const source = process.argv[2] || process.env.SWAGGER_SPEC || process.env.SWAGGER_URL
+	let spec
+	try {
+		spec = await loadSpec(source)
+	} catch (err) {
+		console.error(`Error loading OpenAPI spec: ${err.message}`)
+		process.exit(1)
 	}
-)
 
-fs.writeFileSync(path, content)
-console.log('SDK patch complete: All PATCH methods now use ContentType.JsonPatch.')
+	let content = fs.readFileSync(SRC, 'utf8')
+	content = ensureJsonPatchEnum(content)
+	content = relaxOperationValue(content)
+
+	if (!spec) {
+		console.warn(
+			'No OpenAPI spec provided (argument / SWAGGER_SPEC / SWAGGER_URL) — skipping PATCH content-type rewrite.\n' +
+				'Re-run with the spec used for generation to apply it, e.g.:\n' +
+				'  node scripts/apply-json-patch-content-type.js https://api.thebigpos.dev/swagger/<version>/swagger.json'
+		)
+		fs.writeFileSync(SRC, content)
+		return
+	}
+
+	const patchPaths = jsonPatchPaths(spec)
+	content = applyContentTypes(content, patchPaths)
+
+	fs.writeFileSync(SRC, content)
+	console.log(`SDK patch complete: PATCH content types set from the OpenAPI spec (${patchPaths.size} json-patch endpoint(s)).`)
+})().catch((err) => {
+	console.error(err)
+	process.exit(1)
+})

package/src/index.ts

@@ -230,7 +230,8 @@ export type LoanLanguagePreference =
   | "Spanish"
   | "Tagalog"
   | "Vietnamese"
-  | "Other";
+  | "Other"
+  | "DoNotWishToRespond";
 
 export type LoanImportStatus =
   | "WaitingProcess"
@@ -263,7 +264,9 @@ export type LoanGiftSource =
   | "StateAgency"
   | "UnmarriedPartner"
   | "Lender"
-  | "Other";
+  | "Other"
+  | "Institutional"
+  | "Borrower";
 
 export type LoanGiftAssetType = "Cash" | "Asset" | "Equity";
 
@@ -715,7 +718,6 @@ export interface AccountSettingsRequest {
   isSmsEnabled: boolean;
   smsNumber?: string | null;
   isEarlyAdopter: boolean;
-  isAIEnabled: boolean;
 }
 
 export interface Action {
@@ -1392,11 +1394,6 @@ export interface ApplicationRowData {
   titleInsuranceAgent?: EncompassContact | null;
 }
 
-export interface Attachment {
-  fileName: string;
-  base64Data: string;
-}
-
 export interface AuditEntityType {
   entityType: string;
   rootEntityType?: string | null;
@@ -2486,6 +2483,7 @@ export interface EncompassPackageItem {
   /** @format date-time */
   createdAt: string;
   recipientId: string;
+  borrowerName?: string | null;
   title?: string | null;
   /** @format date-time */
   issuedAt?: string | null;
@@ -2760,8 +2758,6 @@ export interface FusionReportFilter {
 }
 
 export interface GenerateDocumentRequest {
-  /** @deprecated */
-  loanID?: string | null;
   /** @format uuid */
   templateID: string;
   /**
@@ -3136,6 +3132,8 @@ export interface Loan {
   financial?: LoanFinancial | null;
   financialTerms?: LoanFinancialTerms | null;
   monthlyPayment?: LoanMonthlyPayment | null;
+  costDetails?: LoanCostDetails | null;
+  metrics?: LoanMetrics | null;
   borrowers: LoanBorrower[];
   nonOwningBorrowers: LoanNonOwningBorrower[];
   userLoans: UserLoan[];
@@ -3176,6 +3174,8 @@ export interface LoanApplicationRequest {
   companyName?: string | null;
   property?: LoanPropertyRequest | null;
   financial?: LoanFinancialRequest | null;
+  financialTerms?: LoanFinancialTermsRequest | null;
+  monthlyPayment?: LoanMonthlyPaymentRequest | null;
   borrowers: LoanBorrowerRequest[];
   nonOwningBorrowers: LoanNonOwningBorrowerRequest[];
   /** @format uuid */
@@ -3203,6 +3203,8 @@ export interface LoanBorrower {
   applicationStatus: LoanBorrowerApplicationStatusEnum;
   /** @format int32 */
   numberOfDependents?: number | null;
+  /** @format int32 */
+  creditDecisionScore?: number | null;
   isPrimaryBorrower: boolean;
   isFirstTimeHomeBuyer?: boolean | null;
   hasJointAssetsAndLiabilities?: boolean | null;
@@ -3592,6 +3594,11 @@ export interface LoanBorrowerGift {
   isDeposited?: boolean | null;
   source?: LoanGiftSource | null;
   assetType?: LoanGiftAssetType | null;
+  grantorDonorName?: string | null;
+  /** @format double */
+  amountAppliedToDownPayment?: number | null;
+  /** @format double */
+  amountAppliedToClosingCosts?: number | null;
 }
 
 export interface LoanBorrowerGiftRequest {
@@ -3780,9 +3787,26 @@ export interface LoanBorrowerRealEstateAsset {
   /** @format double */
   marketValue?: number | null;
   /** @format double */
+  purchasePrice?: number | null;
+  /** @format int32 */
+  yearBuilt?: number | null;
+  /** @format int32 */
+  numberOfUnits?: number | null;
+  /** @format double */
   monthlyInsTaxDues?: number | null;
   /** @format double */
   monthlyRentalIncome?: number | null;
+  /** @format double */
+  rentalIncomeNetAmount?: number | null;
+  /** @format double */
+  maintenanceExpense?: number | null;
+  /** @format double */
+  percentageOfRental?: number | null;
+  /** @format double */
+  participationPercentage?: number | null;
+  /** @format date */
+  acquiredDate?: string | null;
+  dispositionStatus?: string | null;
   address?: AddressV3 | null;
   mortgages?: LoanBorrowerRealEstateAssetMortgage[] | null;
 }
@@ -3995,6 +4019,23 @@ export interface LoanContactList {
   email: string;
 }
 
+export interface LoanCostDetails {
+  /** @format uuid */
+  id?: string | null;
+  /** @format double */
+  closingCosts?: number | null;
+  /** @format double */
+  prepaidCharges?: number | null;
+  /** @format double */
+  discount?: number | null;
+  /** @format double */
+  lenderCredit?: number | null;
+  /** @format double */
+  totalCost?: number | null;
+  /** @format double */
+  totalFinancing?: number | null;
+}
+
 export interface LoanCustomFieldsRequest {
   additionalFields?: Record<string, string> | null;
 }
@@ -4160,6 +4201,25 @@ export interface LoanFinancialTerms {
   baseLoanAmount?: number | null;
   /** @format double */
   totalLoanAmount?: number | null;
+  /** @format double */
+  mortgageInsuranceFactor?: number | null;
+  isEscrowWaived?: boolean | null;
+}
+
+export interface LoanFinancialTermsRequest {
+  /** @format int32 */
+  loanTermMonths?: number | null;
+  amortizationType?: LoanAmortizationType | null;
+  /** @format double */
+  apr?: number | null;
+  /** @format double */
+  interestRate?: number | null;
+  /** @format double */
+  downPayment?: number | null;
+  /** @format double */
+  baseLoanAmount?: number | null;
+  /** @format double */
+  totalLoanAmount?: number | null;
 }
 
 export interface LoanIdentifier {
@@ -4281,6 +4341,19 @@ export interface LoanLogSearchCriteria {
   levels?: LogLevel[] | null;
 }
 
+export interface LoanMetrics {
+  /** @format uuid */
+  id?: string | null;
+  /** @format double */
+  ltv?: number | null;
+  /** @format double */
+  cltv?: number | null;
+  /** @format double */
+  frontDti?: number | null;
+  /** @format double */
+  backDti?: number | null;
+}
+
 export interface LoanMilestone {
   /** @format uuid */
   id: string;
@@ -4309,6 +4382,23 @@ export interface LoanMonthlyPayment {
   other?: number | null;
 }
 
+export interface LoanMonthlyPaymentRequest {
+  /** @format double */
+  principalAndInterest?: number | null;
+  /** @format double */
+  taxes?: number | null;
+  /** @format double */
+  insurance?: number | null;
+  /** @format double */
+  mortgageInsurance?: number | null;
+  /** @format double */
+  floodInsurance?: number | null;
+  /** @format double */
+  hoa?: number | null;
+  /** @format double */
+  other?: number | null;
+}
+
 export interface LoanNonOwningBorrower {
   /** @format uuid */
   id?: string | null;
@@ -5291,15 +5381,12 @@ export interface SendLoanTaskReminderRequest {
   userIds?: string[] | null;
 }
 
-export interface SendNotificationForLoanRequest {
-  loanID: string;
-  templateKey: string;
-  loanOfficerEmail?: string | null;
-  /** @format uuid */
-  siteConfigurationId?: string | null;
-  email?: string | null;
-  phone?: string | null;
-  attachments: Attachment[];
+export interface SendOutstandingTaskReminderRequest {
+  userIds?: string[] | null;
+}
+
+export interface SetAiEnabledRequest {
+  isEnabled: boolean;
 }
 
 export interface SetCustomFieldValueRequest {
@@ -6090,16 +6177,6 @@ export interface TaxRatesRequest {
   marginalIncomeTaxRate: number;
 }
 
-export interface TestSendNotificationForLoanRequest {
-  loanData: Record<string, string>;
-  /** @format uuid */
-  siteConfigurationId: string;
-  toAddress?: string | null;
-  toPhoneNumber?: string | null;
-  templateKey?: string | null;
-  attachments: Attachment[];
-}
-
 export interface Theme {
   logoURL: string;
   primaryColor: string;
@@ -9146,6 +9223,31 @@ export class Api<
         ...params,
       }),
 
+    /**
+     * No description
+     *
+     * @tags AiSuperAdmin
+     * @name SetAccountAiEnabled
+     * @summary Enable or disable AI for an account (SuperAdmin only)
+     * @request PUT:/api/ai/superadmin/accounts/{accountId}/ai-enabled
+     * @secure
+     * @response `204` `void` No Content
+     * @response `404` `ProblemDetails` Not Found
+     */
+    setAccountAiEnabled: (
+      accountId: string,
+      data: SetAiEnabledRequest,
+      params: RequestParams = {},
+    ) =>
+      this.request<void, ProblemDetails>({
+        path: `/api/ai/superadmin/accounts/${accountId}/ai-enabled`,
+        method: "PUT",
+        body: data,
+        secure: true,
+        type: "application/json",
+        ...params,
+      }),
+
     /**
      * No description
      *
@@ -11163,6 +11265,47 @@ export class Api<
         ...params,
       }),
 
+    /**
+     * No description
+     *
+     * @tags Encompass Packages
+     * @name GetLoanPackages
+     * @request GET:/api/los/encompass/eclose/loans/{loanId}/packages
+     * @secure
+     * @response `200` `EncompassPackageList` OK
+     * @response `400` `EncompassError` Bad Request
+     * @response `401` `EncompassError` Unauthorized
+     * @response `403` `EncompassError` Forbidden
+     * @response `500` `EncompassError` Internal Server Error
+     */
+    getLoanPackages: (
+      loanId: string,
+      query?: {
+        status?: string;
+        /**
+         * @format int32
+         * @default 1
+         */
+        page?: number;
+        /**
+         * @format int32
+         * @default 20
+         */
+        pageSize?: number;
+        sortBy?: string;
+        sortDirection?: string;
+      },
+      params: RequestParams = {},
+    ) =>
+      this.request<EncompassPackageList, EncompassError>({
+        path: `/api/los/encompass/eclose/loans/${loanId}/packages`,
+        method: "GET",
+        query: query,
+        secure: true,
+        format: "json",
+        ...params,
+      }),
+
     /**
      * No description
      *
@@ -12169,31 +12312,6 @@ export class Api<
         ...params,
       }),
 
-    /**
-     * No description
-     *
-     * @tags LegacyLoan
-     * @name CreateLegacyLoanDocument
-     * @summary Create Document
-     * @request POST:/api/los/loan/generatedocument
-     * @deprecated
-     * @secure
-     * @response `200` `DocumentDataRequest` OK
-     */
-    createLegacyLoanDocument: (
-      data: GenerateDocumentRequest,
-      params: RequestParams = {},
-    ) =>
-      this.request<DocumentDataRequest, any>({
-        path: `/api/los/loan/generatedocument`,
-        method: "POST",
-        body: data,
-        secure: true,
-        type: "application/json",
-        format: "json",
-        ...params,
-      }),
-
     /**
      * No description
      *
@@ -14543,30 +14661,6 @@ export class Api<
         ...params,
       }),
 
-    /**
-     * No description
-     *
-     * @tags LoanTaskDocuments
-     * @name CreateLoanTaskDocumentBucket
-     * @summary Create Bucket
-     * @request POST:/api/loans/{loanID}/tasks/{loanTaskId}/documents/bucket
-     * @secure
-     * @response `204` `UserLoanTask` No Content
-     * @response `422` `UnprocessableEntity` Unprocessable Content
-     */
-    createLoanTaskDocumentBucket: (
-      loanId: string,
-      loanTaskId: string,
-      params: RequestParams = {},
-    ) =>
-      this.request<UserLoanTask, UnprocessableEntity>({
-        path: `/api/loans/${loanId}/tasks/${loanTaskId}/documents/bucket`,
-        method: "POST",
-        secure: true,
-        format: "json",
-        ...params,
-      }),
-
     /**
      * No description
      *
@@ -14576,16 +14670,21 @@ export class Api<
      * @request POST:/api/loans/{loanID}/tasks/reminders/outstanding
      * @secure
      * @response `204` `void` No Content
+     * @response `400` `ProblemDetails` Bad Request
      * @response `404` `ProblemDetails` Not Found
+     * @response `422` `ProblemDetails` Unprocessable Content
      */
     sendOutstandingLoanTaskNotification: (
       loanId: string,
+      data: SendOutstandingTaskReminderRequest,
       params: RequestParams = {},
     ) =>
       this.request<void, ProblemDetails>({
         path: `/api/loans/${loanId}/tasks/reminders/outstanding`,
         method: "POST",
+        body: data,
         secure: true,
+        type: "application/json",
         ...params,
       }),
 
@@ -15245,56 +15344,6 @@ export class Api<
         ...params,
       }),
 
-    /**
-     * No description
-     *
-     * @tags Notifications
-     * @name SendNotificationForLoan
-     * @summary Send Notification for Loan
-     * @request POST:/api/notifications
-     * @deprecated
-     * @secure
-     * @response `200` `void` OK
-     * @response `422` `UnprocessableEntity` Unprocessable Content
-     */
-    sendNotificationForLoan: (
-      data: SendNotificationForLoanRequest,
-      params: RequestParams = {},
-    ) =>
-      this.request<void, UnprocessableEntity>({
-        path: `/api/notifications`,
-        method: "POST",
-        body: data,
-        secure: true,
-        type: "application/json",
-        ...params,
-      }),
-
-    /**
-     * No description
-     *
-     * @tags Notifications
-     * @name SendTestNotificationForLoan
-     * @summary Send Test Notification for Loan
-     * @request POST:/api/notifications/test
-     * @deprecated
-     * @secure
-     * @response `200` `void` OK
-     * @response `422` `UnprocessableEntity` Unprocessable Content
-     */
-    sendTestNotificationForLoan: (
-      data: TestSendNotificationForLoanRequest,
-      params: RequestParams = {},
-    ) =>
-      this.request<void, UnprocessableEntity>({
-        path: `/api/notifications/test`,
-        method: "POST",
-        body: data,
-        secure: true,
-        type: "application/json",
-        ...params,
-      }),
-
     /**
      * No description
      *