@securelend/sdk 0.1.0-beta.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 SecureLend, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,169 @@
+# @securelend/sdk
+
+Official SecureLend SDK for JavaScript and TypeScript.
+
+## Installation
+
+```bash
+npm install @securelend/sdk
+```
+
+## Quick Start
+
+```typescript
+import { SecureLend } from "@securelend/sdk";
+
+const securelend = new SecureLend("sk_test_...");
+
+// Compare business loans
+const loans = await securelend.loans.compare({
+  amount: 200000,
+  purpose: "equipment",
+  business: {
+    revenue: 1200000,
+    creditScore: 720,
+    timeInBusiness: 36,
+  },
+});
+
+console.log(`Found ${loans.summary.totalOffers} offers`);
+console.log(`Best rate: ${loans.offers[0].terms.interestRate.rate}%`);
+
+// Compare business banking
+const banking = await securelend.banking.compare({
+  accountType: "checking",
+  monthlyRevenue: 100000,
+  monthlyTransactions: 500,
+});
+
+// Compare business credit cards
+const cards = await securelend.creditCards.compare({
+  creditScore: 720,
+  monthlySpend: 15000,
+});
+```
+
+## Documentation
+
+- [Full Documentation](https://docs.securelend.ai)
+- [API Reference](https://docs.securelend.ai/api)
+- [Guides](https://docs.securelend.ai/guides)
+
+## Features
+
+- ✅ **AI Native** - Built on the Model Context Protocol for seamless integration with AI applications.
+- ✅ **Business Loans** - Compare term loans, SBA loans, lines of credit
+- ✅ **Business Banking** - Compare checking, savings, money market accounts
+- ✅ **Business Credit Cards** - Compare rewards, cashback, and travel cards
+- ✅ **Insurance** (coming soon) - Compare business insurance policies
+- ✅ **TypeScript** - Full type safety with TypeScript definitions
+- ✅ **React Hooks** - Available in `@securelend/react`
+- ✅ **Error Handling** - Comprehensive error types
+- ✅ **Widgets** - Supports interactive UI widgets from the MCP server.
+
+## Usage
+
+### Initialize Client
+
+```typescript
+import { SecureLend } from "@securelend/sdk";
+
+const securelend = new SecureLend("sk_test_...", {
+  mcpURL: "https://mcp.securelend.ai/sse", // Optional
+});
+```
+
+### Compare Loans
+
+```typescript
+const result = await securelend.loans.compare({
+  amount: 200000,
+  purpose: "working_capital",
+  business: {
+    revenue: 1200000,
+    creditScore: 720,
+    timeInBusiness: 36,
+    industry: "Retail",
+    entityType: "llc",
+  },
+  termPreferenceMonths: 60,
+});
+
+// Access best offer
+const bestOffer = result.offers[0];
+console.log(bestOffer.lender.name);
+console.log(bestOffer.terms.interestRate.rate);
+console.log(bestOffer.matching.approvalProbability);
+```
+
+### Calculate Loan Payment
+
+```typescript
+const calculation = await securelend.loans.calculate({
+  amount: 200000,
+  rate: 8.5,
+  termMonths: 60,
+  fees: {
+    origination: 2000,
+  },
+});
+
+console.log(`Monthly payment: $${calculation.monthlyPayment}`);
+console.log(`Total interest: $${calculation.totalInterest}`);
+console.log(`APR: ${calculation.apr}%`);
+```
+
+### Error Handling
+
+```typescript
+import {
+  SecureLendError,
+  AuthenticationError,
+  RateLimitError
+} from '@securelend/sdk';
+
+try {
+  // Connection can fail, or tool calls can fail
+  const loans = await securelend.loans.compare({...});
+} catch (error) {
+  if (error instanceof AuthenticationError) {
+    console.error('Invalid API key');
+  } else if (error instanceof RateLimitError) {
+    console.error('Rate limit exceeded, retry after:', error.retryAfter);
+  } else if (error instanceof SecureLendError) {
+    console.error('SecureLend error:', error.message);
+    console.error('Error type:', error.type);
+  } else {
+    console.error('Unexpected error:', error);
+  }
+}
+```
+
+## TypeScript Support
+
+This package includes TypeScript definitions:
+
+```typescript
+import type {
+  LoanOffer,
+  BankingAccount,
+  CreditCardOffer,
+  BusinessProfile,
+} from "@securelend/sdk";
+
+const business: BusinessProfile = {
+  basic: {
+    legalName: "Acme Corp",
+    entityType: "llc",
+  },
+  financials: {
+    revenue: {
+      annual: { amount: 1200000 },
+    },
+  },
+};
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,81 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { SecureLendConfig, PersonalLoanSearchParams, LoanComparisonResponse, BusinessLoanSearchParams, MortgageSearchParams, AutoLoanSearchParams, StudentLoanSearchParams, BusinessBankingSearchSchema, BusinessBankingComparisonResponse, PersonalBankingSearchSchema, PersonalBankingComparisonResponse, SavingsSearchSchema, SavingsAccountComparisonResponse, BusinessCreditCardSearchParams, BusinessCreditCardComparisonResponse, PersonalCreditCardSearchSchema, PersonalCreditCardComparisonResponse, LoanPaymentParams, LoanCalculationResponse, MortgagePaymentParams, MortgageCalculationResponse, LeaseVsPurchaseParams, LeaseVsPurchaseResponse, GetOfferParams, PersonalApplication, GetMultipleOffersParams, DisplayOfferFormParams, DisplayOfferFormResponse, TrackOfferStatusParams, TrackOfferStatusResponse, DisplayUploadDocumentsFormParams, DisplayUploadDocumentsFormResponse, SubmitDocumentsParams, SubmitDocumentsResponse } from './types/index.mjs';
+export { Application, ApplicationProvider, ApplicationStatus, ApplicationType, AutoLenderAdapter, BankAccountOffer, BasisPoints, BusinessApplicant, BusinessApplication, BusinessBankingAdapter, BusinessBankingOffer, BusinessCreditCardAdapter, BusinessCreditCardOffer, BusinessLenderAdapter, CreateBusinessApplicationDTO, CreatePersonalApplicationDTO, CreditCardOffer, CreditTier, DateString, DocumentType, GenericApplication, Lender, LenderSearchCriteria, LoanOffer, Money, MortgageLenderAdapter, Percentage, PersonalApplicant, PersonalBankingAdapter, PersonalBankingOffer, PersonalCreditCardAdapter, PersonalCreditCardOffer, PersonalLenderAdapter, ProductType, ProviderStatus, SavingsAdapter, SavingsOffer, StudentLenderAdapter, anyOfferSchema, applicationProviderSchema, autoLoanSearchSchema, bankAccountOfferSchema, businessApplicantSchema, businessBankingComparisonResponseSchema, businessBankingOfferSchema, businessBankingSearchSchema, businessCreditCardComparisonResponseSchema, businessCreditCardOfferSchema, businessCreditCardSearchSchema, businessLoanSearchSchema, createBusinessApplicationSchema, createPersonalApplicationSchema, creditCardOfferSchema, displayOfferFormResponseSchema, displayOfferFormSchema, displayUploadDocumentsFormResponseSchema, displayUploadDocumentsFormSchema, documentTypeEnum, getMultipleOffersSchema, getOfferSchema, leaseVsPurchaseResponseSchema, leaseVsPurchaseSchema, loanComparisonResponseSchema, loanOfferSchema, loanPaymentResponseSchema, loanPaymentSchema, mortgagePaymentResponseSchema, mortgagePaymentSchema, mortgageSearchSchema, personalApplicantSchema, personalApplicationSchema, personalBankingComparisonResponseSchema, personalBankingOfferSchema, personalBankingSearchSchema, personalCreditCardComparisonResponseSchema, personalCreditCardOfferSchema, personalCreditCardSearchSchema, personalLoanSearchSchema, savingsComparisonResponseSchema, savingsOfferSchema, savingsSearchSchema, studentLoanSearchSchema, submitDocumentsResponseSchema, submitDocumentsSchema, trackOfferStatusResponseSchema, trackOfferStatusSchema } from './types/index.mjs';
+import 'zod';
+
+interface MCPClientConfig {
+    apiKey: string;
+    mcpURL: string;
+}
+declare class MCPClient {
+    mcp: Client;
+    private config;
+    private debug;
+    private isConnected;
+    constructor(config: MCPClientConfig);
+    connect(): Promise<void>;
+    callTool(name: string, args: Record<string, any>): Promise<any>;
+    setApiKey(apiKey: string): void;
+    enableDebug(): void;
+    disableDebug(): void;
+}
+
+declare class SecureLend {
+    private mcpClient;
+    readonly mcp: MCPClient["mcp"];
+    constructor(config?: SecureLendConfig);
+    comparePersonalLoans(request: PersonalLoanSearchParams): Promise<LoanComparisonResponse>;
+    compareBusinessLoans(request: BusinessLoanSearchParams): Promise<LoanComparisonResponse>;
+    comparePersonalMortgages(request: MortgageSearchParams): Promise<LoanComparisonResponse>;
+    compareBusinessMortgages(request: MortgageSearchParams): Promise<LoanComparisonResponse>;
+    compareCarLoans(request: AutoLoanSearchParams): Promise<LoanComparisonResponse>;
+    compareStudentLoans(request: StudentLoanSearchParams): Promise<LoanComparisonResponse>;
+    compareBusinessBanking(request: BusinessBankingSearchSchema): Promise<BusinessBankingComparisonResponse>;
+    comparePersonalBanking(request: PersonalBankingSearchSchema): Promise<PersonalBankingComparisonResponse>;
+    compareSavingsAccounts(request: SavingsSearchSchema): Promise<SavingsAccountComparisonResponse>;
+    compareBusinessCreditCards(request: BusinessCreditCardSearchParams): Promise<BusinessCreditCardComparisonResponse>;
+    comparePersonalCreditCards(request: PersonalCreditCardSearchSchema): Promise<PersonalCreditCardComparisonResponse>;
+    calculateLoanPayment(request: LoanPaymentParams): Promise<LoanCalculationResponse>;
+    calculateMortgagePayment(request: MortgagePaymentParams): Promise<MortgageCalculationResponse>;
+    compareLeaseVsPurchase(request: LeaseVsPurchaseParams): Promise<LeaseVsPurchaseResponse>;
+    getOffer(request: GetOfferParams): Promise<PersonalApplication>;
+    getMultipleOffers(request: GetMultipleOffersParams): Promise<PersonalApplication>;
+    displayOfferForm(request: DisplayOfferFormParams): Promise<DisplayOfferFormResponse>;
+    trackOfferStatus(request: TrackOfferStatusParams): Promise<TrackOfferStatusResponse>;
+    displayUploadDocumentsForm(request: DisplayUploadDocumentsFormParams): Promise<DisplayUploadDocumentsFormResponse>;
+    submitDocuments(request: SubmitDocumentsParams): Promise<SubmitDocumentsResponse>;
+    connect(): Promise<void>;
+    enableDebug(): void;
+    disableDebug(): void;
+    setApiKey(apiKey: string): void;
+    private callTool;
+    private parseJsonResponse;
+    private getWidget;
+}
+
+declare class SecureLendError extends Error {
+    readonly type: string;
+    readonly details?: unknown;
+    constructor(message: string, type: string, details?: unknown);
+}
+declare class AuthenticationError extends SecureLendError {
+    constructor(message: string);
+}
+declare class RateLimitError extends SecureLendError {
+    readonly retryAfter?: number;
+    constructor(message: string, retryAfter?: number);
+}
+declare class ValidationError extends SecureLendError {
+    constructor(message: string, errors?: unknown);
+}
+declare class NotFoundError extends SecureLendError {
+    constructor(message: string);
+}
+declare class NetworkError extends SecureLendError {
+    constructor(message: string);
+}
+declare class ServerError extends SecureLendError {
+    constructor(message: string);
+}
+
+export { AuthenticationError, AutoLoanSearchParams, BusinessBankingComparisonResponse, BusinessBankingSearchSchema, BusinessCreditCardComparisonResponse, BusinessCreditCardSearchParams, BusinessLoanSearchParams, DisplayOfferFormParams, DisplayOfferFormResponse, DisplayUploadDocumentsFormParams, DisplayUploadDocumentsFormResponse, GetMultipleOffersParams, GetOfferParams, LeaseVsPurchaseParams, LeaseVsPurchaseResponse, LoanCalculationResponse, LoanComparisonResponse, LoanPaymentParams, MortgageCalculationResponse, MortgagePaymentParams, MortgageSearchParams, NetworkError, NotFoundError, PersonalApplication, PersonalBankingComparisonResponse, PersonalBankingSearchSchema, PersonalCreditCardComparisonResponse, PersonalCreditCardSearchSchema, PersonalLoanSearchParams, RateLimitError, SavingsAccountComparisonResponse, SavingsSearchSchema, SecureLend, SecureLendConfig, SecureLendError, ServerError, StudentLoanSearchParams, SubmitDocumentsParams, SubmitDocumentsResponse, TrackOfferStatusParams, TrackOfferStatusResponse, ValidationError };

package/dist/index.d.ts

@@ -0,0 +1,81 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { SecureLendConfig, PersonalLoanSearchParams, LoanComparisonResponse, BusinessLoanSearchParams, MortgageSearchParams, AutoLoanSearchParams, StudentLoanSearchParams, BusinessBankingSearchSchema, BusinessBankingComparisonResponse, PersonalBankingSearchSchema, PersonalBankingComparisonResponse, SavingsSearchSchema, SavingsAccountComparisonResponse, BusinessCreditCardSearchParams, BusinessCreditCardComparisonResponse, PersonalCreditCardSearchSchema, PersonalCreditCardComparisonResponse, LoanPaymentParams, LoanCalculationResponse, MortgagePaymentParams, MortgageCalculationResponse, LeaseVsPurchaseParams, LeaseVsPurchaseResponse, GetOfferParams, PersonalApplication, GetMultipleOffersParams, DisplayOfferFormParams, DisplayOfferFormResponse, TrackOfferStatusParams, TrackOfferStatusResponse, DisplayUploadDocumentsFormParams, DisplayUploadDocumentsFormResponse, SubmitDocumentsParams, SubmitDocumentsResponse } from './types/index.js';
+export { Application, ApplicationProvider, ApplicationStatus, ApplicationType, AutoLenderAdapter, BankAccountOffer, BasisPoints, BusinessApplicant, BusinessApplication, BusinessBankingAdapter, BusinessBankingOffer, BusinessCreditCardAdapter, BusinessCreditCardOffer, BusinessLenderAdapter, CreateBusinessApplicationDTO, CreatePersonalApplicationDTO, CreditCardOffer, CreditTier, DateString, DocumentType, GenericApplication, Lender, LenderSearchCriteria, LoanOffer, Money, MortgageLenderAdapter, Percentage, PersonalApplicant, PersonalBankingAdapter, PersonalBankingOffer, PersonalCreditCardAdapter, PersonalCreditCardOffer, PersonalLenderAdapter, ProductType, ProviderStatus, SavingsAdapter, SavingsOffer, StudentLenderAdapter, anyOfferSchema, applicationProviderSchema, autoLoanSearchSchema, bankAccountOfferSchema, businessApplicantSchema, businessBankingComparisonResponseSchema, businessBankingOfferSchema, businessBankingSearchSchema, businessCreditCardComparisonResponseSchema, businessCreditCardOfferSchema, businessCreditCardSearchSchema, businessLoanSearchSchema, createBusinessApplicationSchema, createPersonalApplicationSchema, creditCardOfferSchema, displayOfferFormResponseSchema, displayOfferFormSchema, displayUploadDocumentsFormResponseSchema, displayUploadDocumentsFormSchema, documentTypeEnum, getMultipleOffersSchema, getOfferSchema, leaseVsPurchaseResponseSchema, leaseVsPurchaseSchema, loanComparisonResponseSchema, loanOfferSchema, loanPaymentResponseSchema, loanPaymentSchema, mortgagePaymentResponseSchema, mortgagePaymentSchema, mortgageSearchSchema, personalApplicantSchema, personalApplicationSchema, personalBankingComparisonResponseSchema, personalBankingOfferSchema, personalBankingSearchSchema, personalCreditCardComparisonResponseSchema, personalCreditCardOfferSchema, personalCreditCardSearchSchema, personalLoanSearchSchema, savingsComparisonResponseSchema, savingsOfferSchema, savingsSearchSchema, studentLoanSearchSchema, submitDocumentsResponseSchema, submitDocumentsSchema, trackOfferStatusResponseSchema, trackOfferStatusSchema } from './types/index.js';
+import 'zod';
+
+interface MCPClientConfig {
+    apiKey: string;
+    mcpURL: string;
+}
+declare class MCPClient {
+    mcp: Client;
+    private config;
+    private debug;
+    private isConnected;
+    constructor(config: MCPClientConfig);
+    connect(): Promise<void>;
+    callTool(name: string, args: Record<string, any>): Promise<any>;
+    setApiKey(apiKey: string): void;
+    enableDebug(): void;
+    disableDebug(): void;
+}
+
+declare class SecureLend {
+    private mcpClient;
+    readonly mcp: MCPClient["mcp"];
+    constructor(config?: SecureLendConfig);
+    comparePersonalLoans(request: PersonalLoanSearchParams): Promise<LoanComparisonResponse>;
+    compareBusinessLoans(request: BusinessLoanSearchParams): Promise<LoanComparisonResponse>;
+    comparePersonalMortgages(request: MortgageSearchParams): Promise<LoanComparisonResponse>;
+    compareBusinessMortgages(request: MortgageSearchParams): Promise<LoanComparisonResponse>;
+    compareCarLoans(request: AutoLoanSearchParams): Promise<LoanComparisonResponse>;
+    compareStudentLoans(request: StudentLoanSearchParams): Promise<LoanComparisonResponse>;
+    compareBusinessBanking(request: BusinessBankingSearchSchema): Promise<BusinessBankingComparisonResponse>;
+    comparePersonalBanking(request: PersonalBankingSearchSchema): Promise<PersonalBankingComparisonResponse>;
+    compareSavingsAccounts(request: SavingsSearchSchema): Promise<SavingsAccountComparisonResponse>;
+    compareBusinessCreditCards(request: BusinessCreditCardSearchParams): Promise<BusinessCreditCardComparisonResponse>;
+    comparePersonalCreditCards(request: PersonalCreditCardSearchSchema): Promise<PersonalCreditCardComparisonResponse>;
+    calculateLoanPayment(request: LoanPaymentParams): Promise<LoanCalculationResponse>;
+    calculateMortgagePayment(request: MortgagePaymentParams): Promise<MortgageCalculationResponse>;
+    compareLeaseVsPurchase(request: LeaseVsPurchaseParams): Promise<LeaseVsPurchaseResponse>;
+    getOffer(request: GetOfferParams): Promise<PersonalApplication>;
+    getMultipleOffers(request: GetMultipleOffersParams): Promise<PersonalApplication>;
+    displayOfferForm(request: DisplayOfferFormParams): Promise<DisplayOfferFormResponse>;
+    trackOfferStatus(request: TrackOfferStatusParams): Promise<TrackOfferStatusResponse>;
+    displayUploadDocumentsForm(request: DisplayUploadDocumentsFormParams): Promise<DisplayUploadDocumentsFormResponse>;
+    submitDocuments(request: SubmitDocumentsParams): Promise<SubmitDocumentsResponse>;
+    connect(): Promise<void>;
+    enableDebug(): void;
+    disableDebug(): void;
+    setApiKey(apiKey: string): void;
+    private callTool;
+    private parseJsonResponse;
+    private getWidget;
+}
+
+declare class SecureLendError extends Error {
+    readonly type: string;
+    readonly details?: unknown;
+    constructor(message: string, type: string, details?: unknown);
+}
+declare class AuthenticationError extends SecureLendError {
+    constructor(message: string);
+}
+declare class RateLimitError extends SecureLendError {
+    readonly retryAfter?: number;
+    constructor(message: string, retryAfter?: number);
+}
+declare class ValidationError extends SecureLendError {
+    constructor(message: string, errors?: unknown);
+}
+declare class NotFoundError extends SecureLendError {
+    constructor(message: string);
+}
+declare class NetworkError extends SecureLendError {
+    constructor(message: string);
+}
+declare class ServerError extends SecureLendError {
+    constructor(message: string);
+}
+
+export { AuthenticationError, AutoLoanSearchParams, BusinessBankingComparisonResponse, BusinessBankingSearchSchema, BusinessCreditCardComparisonResponse, BusinessCreditCardSearchParams, BusinessLoanSearchParams, DisplayOfferFormParams, DisplayOfferFormResponse, DisplayUploadDocumentsFormParams, DisplayUploadDocumentsFormResponse, GetMultipleOffersParams, GetOfferParams, LeaseVsPurchaseParams, LeaseVsPurchaseResponse, LoanCalculationResponse, LoanComparisonResponse, LoanPaymentParams, MortgageCalculationResponse, MortgagePaymentParams, MortgageSearchParams, NetworkError, NotFoundError, PersonalApplication, PersonalBankingComparisonResponse, PersonalBankingSearchSchema, PersonalCreditCardComparisonResponse, PersonalCreditCardSearchSchema, PersonalLoanSearchParams, RateLimitError, SavingsAccountComparisonResponse, SavingsSearchSchema, SecureLend, SecureLendConfig, SecureLendError, ServerError, StudentLoanSearchParams, SubmitDocumentsParams, SubmitDocumentsResponse, TrackOfferStatusParams, TrackOfferStatusResponse, ValidationError };