@financeable/lenders 0.0.1

package/src/mcp-server/shared.ts

@@ -0,0 +1,75 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { bytesToBase64 } from "../lib/base64.js";
+
+type BinaryData =
+  | Uint8Array
+  | ArrayBuffer
+  | Blob
+  | ReadableStream
+  | Response
+  | string;
+
+export async function consumeStream(
+  stream: ReadableStream<Uint8Array>,
+): Promise<Uint8Array> {
+  const reader = stream.getReader();
+  const chunks: Uint8Array[] = [];
+
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (value != null) chunks.push(value);
+      if (done) break;
+    }
+  } finally {
+    reader.releaseLock();
+  }
+
+  return new Uint8Array(await new Blob(chunks).arrayBuffer());
+}
+
+export function isAsyncIterable(
+  value: unknown,
+): value is AsyncIterable<string> {
+  return (
+    typeof value === "object" && value != null && Symbol.asyncIterator in value
+  );
+}
+
+export function isBinaryData(value: unknown): value is BinaryData {
+  return (
+    value instanceof Uint8Array
+    || value instanceof ArrayBuffer
+    || value instanceof Blob
+    || value instanceof ReadableStream
+    || value instanceof Response
+    || typeof value === "string"
+  );
+}
+
+const base64Schema = z.string().base64();
+
+export async function valueToBase64(
+  value: BinaryData | null | undefined,
+): Promise<string | null> {
+  if (value == null) {
+    return null;
+  } else if (value instanceof Uint8Array) {
+    return bytesToBase64(value);
+  } else if (value instanceof ArrayBuffer) {
+    return bytesToBase64(new Uint8Array(value));
+  } else if (value instanceof Response || value instanceof Blob) {
+    return bytesToBase64(new Uint8Array(await value.arrayBuffer()));
+  } else if (value instanceof ReadableStream) {
+    return bytesToBase64(await consumeStream(value));
+  } else if (typeof value === "string") {
+    return base64Schema.parse(value);
+  } else {
+    value satisfies never;
+    throw new Error(`Unsupported image value type: ${typeof value}`);
+  }
+}

package/src/mcp-server/tools/consumersCreatePepper.ts

@@ -0,0 +1,35 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { consumersCreatePepper } from "../../funcs/consumersCreatePepper.js";
+import * as components from "../../models/components/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: components.PepperConsumerRequest$inboundSchema,
+};
+
+export const tool$consumersCreatePepper: ToolDefinition<typeof args> = {
+  name: "consumers-create-pepper",
+  description: `Pepper Consumer route`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await consumersCreatePepper(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools.ts

@@ -0,0 +1,126 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { objectOutputType, ZodRawShape, ZodTypeAny } from "zod";
+import { FinanceableLendersCore } from "../core.js";
+import { ConsoleLogger } from "./console-logger.js";
+import { MCPScope } from "./scopes.js";
+import { isAsyncIterable, isBinaryData, valueToBase64 } from "./shared.js";
+
+export type ToolDefinition<Args extends undefined | ZodRawShape = undefined> =
+  Args extends ZodRawShape ? {
+      name: string;
+      description: string;
+      scopes?: MCPScope[];
+      args: Args;
+      tool: (
+        client: FinanceableLendersCore,
+        args: objectOutputType<Args, ZodTypeAny>,
+        extra: RequestHandlerExtra,
+      ) => CallToolResult | Promise<CallToolResult>;
+    }
+    : {
+      name: string;
+      description: string;
+      scopes?: MCPScope[];
+      args?: undefined;
+      tool: (
+        client: FinanceableLendersCore,
+        extra: RequestHandlerExtra,
+      ) => CallToolResult | Promise<CallToolResult>;
+    };
+
+// Optional function to assist with formatting tool results
+export async function formatResult(
+  value: unknown,
+  init: { response?: Response | undefined },
+): Promise<CallToolResult> {
+  if (typeof value === "undefined") {
+    return { content: [] };
+  }
+
+  const { response } = init;
+  const contentType = response?.headers.get("content-type") ?? "";
+  let content: CallToolResult["content"] = [];
+
+  if (contentType.search(/\bjson\b/g)) {
+    content = [{ type: "text", text: JSON.stringify(value) }];
+  } else if (
+    contentType.startsWith("text/event-stream")
+    && isAsyncIterable(value)
+  ) {
+    content = await consumeSSE(value);
+  } else if (contentType.startsWith("text/") && typeof value === "string") {
+    content = [{ type: "text", text: value }];
+  } else if (isBinaryData(value) && contentType.startsWith("image/")) {
+    const data = await valueToBase64(value);
+    content = data == null
+      ? []
+      : [{ type: "image", data, mimeType: contentType }];
+  } else {
+    return {
+      content: [{
+        type: "text",
+        text: `Unsupported content type: "${contentType}"`,
+      }],
+      isError: true,
+    };
+  }
+
+  return { content };
+}
+
+async function consumeSSE(
+  value: AsyncIterable<unknown>,
+): Promise<CallToolResult["content"]> {
+  const content: CallToolResult["content"] = [];
+
+  for await (const chunk of value) {
+    if (typeof chunk === "string") {
+      content.push({ type: "text", text: chunk });
+    } else {
+      content.push({ type: "text", text: JSON.stringify(chunk) });
+    }
+  }
+
+  return content;
+}
+
+export function createRegisterTool(
+  logger: ConsoleLogger,
+  server: McpServer,
+  sdk: FinanceableLendersCore,
+  allowedScopes: Set<MCPScope>,
+  allowedTools?: Set<string>,
+): <A extends ZodRawShape | undefined>(tool: ToolDefinition<A>) => void {
+  return <A extends ZodRawShape | undefined>(tool: ToolDefinition<A>): void => {
+    if (allowedTools && !allowedTools.has(tool.name)) {
+      return;
+    }
+
+    const toolScopes = tool.scopes ?? [];
+    if (allowedScopes.size > 0 && toolScopes.length === 0) {
+      return;
+    }
+
+    if (!toolScopes.every((s) => allowedScopes.has(s))) {
+      return;
+    }
+
+    if (tool.args) {
+      server.tool(tool.name, tool.description, tool.args, async (args, ctx) => {
+        return tool.tool(sdk, args, ctx);
+      });
+    } else {
+      server.tool(tool.name, tool.description, async (ctx) => {
+        return tool.tool(sdk, ctx);
+      });
+    }
+
+    logger.debug("Registered tool", { name: tool.name });
+  };
+}

package/src/models/components/address.ts

@@ -0,0 +1,135 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+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";
+
+/**
+ * Address model
+ */
+export type Address = {
+  id?: string | undefined;
+  addressType?: string | undefined;
+  fullAddress: string;
+  addressLine2?: string | undefined;
+  unitNumber?: string | undefined;
+  streetNumber?: string | undefined;
+  street?: string | undefined;
+  streetType?: string | undefined;
+  streetAddress?: string | undefined;
+  city?: string | undefined;
+  state?: string | undefined;
+  status?: string | undefined;
+  postCode?: string | undefined;
+  country?: string | undefined;
+  yearsAt: number;
+  monthsAt: number;
+  residencyStatus?: string | undefined;
+};
+
+/** @internal */
+export const Address$inboundSchema: z.ZodType<Address, z.ZodTypeDef, unknown> =
+  z.object({
+    _id: z.string().optional(),
+    addressType: z.string().optional(),
+    fullAddress: z.string(),
+    addressLine2: z.string().optional(),
+    unitNumber: z.string().optional(),
+    streetNumber: z.string().optional(),
+    street: z.string().optional(),
+    streetType: z.string().optional(),
+    streetAddress: z.string().optional(),
+    city: z.string().optional(),
+    state: z.string().optional(),
+    status: z.string().optional(),
+    postCode: z.string().optional(),
+    country: z.string().optional(),
+    yearsAt: z.number().int(),
+    monthsAt: z.number().int(),
+    residencyStatus: z.string().optional(),
+  }).transform((v) => {
+    return remap$(v, {
+      "_id": "id",
+    });
+  });
+
+/** @internal */
+export type Address$Outbound = {
+  _id?: string | undefined;
+  addressType?: string | undefined;
+  fullAddress: string;
+  addressLine2?: string | undefined;
+  unitNumber?: string | undefined;
+  streetNumber?: string | undefined;
+  street?: string | undefined;
+  streetType?: string | undefined;
+  streetAddress?: string | undefined;
+  city?: string | undefined;
+  state?: string | undefined;
+  status?: string | undefined;
+  postCode?: string | undefined;
+  country?: string | undefined;
+  yearsAt: number;
+  monthsAt: number;
+  residencyStatus?: string | undefined;
+};
+
+/** @internal */
+export const Address$outboundSchema: z.ZodType<
+  Address$Outbound,
+  z.ZodTypeDef,
+  Address
+> = z.object({
+  id: z.string().optional(),
+  addressType: z.string().optional(),
+  fullAddress: z.string(),
+  addressLine2: z.string().optional(),
+  unitNumber: z.string().optional(),
+  streetNumber: z.string().optional(),
+  street: z.string().optional(),
+  streetType: z.string().optional(),
+  streetAddress: z.string().optional(),
+  city: z.string().optional(),
+  state: z.string().optional(),
+  status: z.string().optional(),
+  postCode: z.string().optional(),
+  country: z.string().optional(),
+  yearsAt: z.number().int(),
+  monthsAt: z.number().int(),
+  residencyStatus: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    id: "_id",
+  });
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace Address$ {
+  /** @deprecated use `Address$inboundSchema` instead. */
+  export const inboundSchema = Address$inboundSchema;
+  /** @deprecated use `Address$outboundSchema` instead. */
+  export const outboundSchema = Address$outboundSchema;
+  /** @deprecated use `Address$Outbound` instead. */
+  export type Outbound = Address$Outbound;
+}
+
+export function addressToJSON(address: Address): string {
+  return JSON.stringify(Address$outboundSchema.parse(address));
+}
+
+export function addressFromJSON(
+  jsonString: string,
+): SafeParseResult<Address, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Address$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Address' from JSON`,
+  );
+}

package/src/models/components/apierror.ts

@@ -0,0 +1,170 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  ApiErrorCodes,
+  ApiErrorCodes$inboundSchema,
+  ApiErrorCodes$outboundSchema,
+} from "./apierrorcodes.js";
+import {
+  APIErrorLinks,
+  APIErrorLinks$inboundSchema,
+  APIErrorLinks$Outbound,
+  APIErrorLinks$outboundSchema,
+} from "./apierrorlinks.js";
+import {
+  ErrorSource,
+  ErrorSource$inboundSchema,
+  ErrorSource$Outbound,
+  ErrorSource$outboundSchema,
+} from "./errorsource.js";
+
+/**
+ * The application-specific error code. This is not a status code.
+ */
+export type Code = ApiErrorCodes | string;
+
+/**
+ * Api Error response
+ */
+export type ApiError = {
+  /**
+   * A URI linking to the Financeable documentation of the error
+   */
+  links?: APIErrorLinks | undefined;
+  /**
+   * The application-specific error code. This is not a status code.
+   */
+  code: ApiErrorCodes | string;
+  /**
+   * A short, human-readable summary of the problem.
+   */
+  title: string;
+  /**
+   * The HTTP status code as a string.
+   */
+  status: string;
+  /**
+   * An object describing the source of the error from the request
+   */
+  source?: ErrorSource | undefined;
+  /**
+   * A human-readable explanation specific to this occurrence of the problem.
+   */
+  detail?: string | undefined;
+  /**
+   * Additional information that can not be classified
+   */
+  meta?: { [k: string]: any } | undefined;
+};
+
+/** @internal */
+export const Code$inboundSchema: z.ZodType<Code, z.ZodTypeDef, unknown> = z
+  .union([ApiErrorCodes$inboundSchema, z.string()]);
+
+/** @internal */
+export type Code$Outbound = string | string;
+
+/** @internal */
+export const Code$outboundSchema: z.ZodType<Code$Outbound, z.ZodTypeDef, Code> =
+  z.union([ApiErrorCodes$outboundSchema, z.string()]);
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace Code$ {
+  /** @deprecated use `Code$inboundSchema` instead. */
+  export const inboundSchema = Code$inboundSchema;
+  /** @deprecated use `Code$outboundSchema` instead. */
+  export const outboundSchema = Code$outboundSchema;
+  /** @deprecated use `Code$Outbound` instead. */
+  export type Outbound = Code$Outbound;
+}
+
+export function codeToJSON(code: Code): string {
+  return JSON.stringify(Code$outboundSchema.parse(code));
+}
+
+export function codeFromJSON(
+  jsonString: string,
+): SafeParseResult<Code, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Code$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Code' from JSON`,
+  );
+}
+
+/** @internal */
+export const ApiError$inboundSchema: z.ZodType<
+  ApiError,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  links: APIErrorLinks$inboundSchema.optional(),
+  code: z.union([ApiErrorCodes$inboundSchema, z.string()]),
+  title: z.string(),
+  status: z.string(),
+  source: ErrorSource$inboundSchema.optional(),
+  detail: z.string().optional(),
+  meta: z.record(z.any()).optional(),
+});
+
+/** @internal */
+export type ApiError$Outbound = {
+  links?: APIErrorLinks$Outbound | undefined;
+  code: string | string;
+  title: string;
+  status: string;
+  source?: ErrorSource$Outbound | undefined;
+  detail?: string | undefined;
+  meta?: { [k: string]: any } | undefined;
+};
+
+/** @internal */
+export const ApiError$outboundSchema: z.ZodType<
+  ApiError$Outbound,
+  z.ZodTypeDef,
+  ApiError
+> = z.object({
+  links: APIErrorLinks$outboundSchema.optional(),
+  code: z.union([ApiErrorCodes$outboundSchema, z.string()]),
+  title: z.string(),
+  status: z.string(),
+  source: ErrorSource$outboundSchema.optional(),
+  detail: z.string().optional(),
+  meta: z.record(z.any()).optional(),
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace ApiError$ {
+  /** @deprecated use `ApiError$inboundSchema` instead. */
+  export const inboundSchema = ApiError$inboundSchema;
+  /** @deprecated use `ApiError$outboundSchema` instead. */
+  export const outboundSchema = ApiError$outboundSchema;
+  /** @deprecated use `ApiError$Outbound` instead. */
+  export type Outbound = ApiError$Outbound;
+}
+
+export function apiErrorToJSON(apiError: ApiError): string {
+  return JSON.stringify(ApiError$outboundSchema.parse(apiError));
+}
+
+export function apiErrorFromJSON(
+  jsonString: string,
+): SafeParseResult<ApiError, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ApiError$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ApiError' from JSON`,
+  );
+}

package/src/models/components/apierrorcodes.ts

@@ -0,0 +1,42 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../../types/enums.js";
+
+export const ApiErrorCodes = {
+  ValidationError: "VALIDATION_ERROR",
+  InternalServerError: "INTERNAL_SERVER_ERROR",
+  FileUploadError: "FILE_UPLOAD_ERROR",
+  DataMappingError: "DATA_MAPPING_ERROR",
+  ExternalApiError: "EXTERNAL_API_ERROR",
+  RateLimitExceeded: "RATE_LIMIT_EXCEEDED",
+  AuthenticationError: "AUTHENTICATION_ERROR",
+  AuthorizationError: "AUTHORIZATION_ERROR",
+  NotFound: "NOT_FOUND",
+  MethodNotAllowed: "METHOD_NOT_ALLOWED",
+  Conflict: "CONFLICT",
+} as const;
+export type ApiErrorCodes = ClosedEnum<typeof ApiErrorCodes>;
+
+/** @internal */
+export const ApiErrorCodes$inboundSchema: z.ZodNativeEnum<
+  typeof ApiErrorCodes
+> = z.nativeEnum(ApiErrorCodes);
+
+/** @internal */
+export const ApiErrorCodes$outboundSchema: z.ZodNativeEnum<
+  typeof ApiErrorCodes
+> = ApiErrorCodes$inboundSchema;
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace ApiErrorCodes$ {
+  /** @deprecated use `ApiErrorCodes$inboundSchema` instead. */
+  export const inboundSchema = ApiErrorCodes$inboundSchema;
+  /** @deprecated use `ApiErrorCodes$outboundSchema` instead. */
+  export const outboundSchema = ApiErrorCodes$outboundSchema;
+}

package/src/models/components/apierrorlinks.ts

@@ -0,0 +1,65 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type APIErrorLinks = {
+  /**
+   * A URI linking to the Financeable documentation of the error
+   */
+  about?: string | undefined;
+};
+
+/** @internal */
+export const APIErrorLinks$inboundSchema: z.ZodType<
+  APIErrorLinks,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  about: z.string().optional(),
+});
+
+/** @internal */
+export type APIErrorLinks$Outbound = {
+  about?: string | undefined;
+};
+
+/** @internal */
+export const APIErrorLinks$outboundSchema: z.ZodType<
+  APIErrorLinks$Outbound,
+  z.ZodTypeDef,
+  APIErrorLinks
+> = z.object({
+  about: z.string().optional(),
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace APIErrorLinks$ {
+  /** @deprecated use `APIErrorLinks$inboundSchema` instead. */
+  export const inboundSchema = APIErrorLinks$inboundSchema;
+  /** @deprecated use `APIErrorLinks$outboundSchema` instead. */
+  export const outboundSchema = APIErrorLinks$outboundSchema;
+  /** @deprecated use `APIErrorLinks$Outbound` instead. */
+  export type Outbound = APIErrorLinks$Outbound;
+}
+
+export function apiErrorLinksToJSON(apiErrorLinks: APIErrorLinks): string {
+  return JSON.stringify(APIErrorLinks$outboundSchema.parse(apiErrorLinks));
+}
+
+export function apiErrorLinksFromJSON(
+  jsonString: string,
+): SafeParseResult<APIErrorLinks, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => APIErrorLinks$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'APIErrorLinks' from JSON`,
+  );
+}