@moovio/sdk 0.8.1 → 0.9.0

package/src/mcp-server/prompts.ts

@@ -0,0 +1,110 @@
+/*
+ * 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 { GetPromptResult } from "@modelcontextprotocol/sdk/types.js";
+import {
+  objectOutputType,
+  ZodOptional,
+  ZodType,
+  ZodTypeAny,
+  ZodTypeDef,
+} from "zod";
+import { MoovCore } from "../core.js";
+import { ConsoleLogger } from "./console-logger.js";
+import { MCPScope } from "./scopes.js";
+
+// '@modelcontextprotocol/sdk' currently does not export this type
+export type PromptArgsRawShape = {
+  [k: string]:
+    | ZodType<string, ZodTypeDef, string>
+    | ZodOptional<ZodType<string, ZodTypeDef, string>>;
+};
+
+export type PromptDefinition<
+  Args extends undefined | PromptArgsRawShape = undefined,
+> = Args extends PromptArgsRawShape ? {
+    name: string;
+    description?: string;
+    scopes?: MCPScope[];
+    args: Args;
+    prompt: (
+      client: MoovCore,
+      args: objectOutputType<Args, ZodTypeAny>,
+      extra: RequestHandlerExtra,
+    ) => GetPromptResult | Promise<GetPromptResult>;
+  }
+  : {
+    name: string;
+    description?: string;
+    scopes?: MCPScope[];
+    args?: undefined;
+    prompt: (
+      client: MoovCore,
+      extra: RequestHandlerExtra,
+    ) => GetPromptResult | Promise<GetPromptResult>;
+  };
+
+// Optional function to assist with formatting prompt results
+export async function formatResult(value: string): Promise<GetPromptResult> {
+  return {
+    messages: [
+      {
+        role: "user",
+        content: {
+          type: "text",
+          text: value,
+        },
+      },
+    ],
+  };
+}
+
+export function createRegisterPrompt(
+  logger: ConsoleLogger,
+  server: McpServer,
+  sdk: MoovCore,
+  allowedScopes: Set<MCPScope>,
+): <A extends PromptArgsRawShape | undefined>(
+  prompt: PromptDefinition<A>,
+) => void {
+  return <A extends PromptArgsRawShape | undefined>(
+    prompt: PromptDefinition<A>,
+  ): void => {
+    const scopes = prompt.scopes ?? [];
+    if (!scopes.every((s: MCPScope) => allowedScopes.has(s))) {
+      return;
+    }
+
+    if (prompt.args) {
+      if (prompt.description) {
+        server.prompt(
+          prompt.name,
+          prompt.description,
+          prompt.args,
+          async (args, ctx) => prompt.prompt(sdk, args, ctx),
+        );
+      } else {
+        server.prompt(
+          prompt.name,
+          prompt.args,
+          async (args, ctx) => prompt.prompt(sdk, args, ctx),
+        );
+      }
+    } else {
+      if (prompt.description) {
+        server.prompt(
+          prompt.name,
+          prompt.description,
+          async (ctx) => prompt.prompt(sdk, ctx),
+        );
+      } else {
+        server.prompt(prompt.name, async (ctx) => prompt.prompt(sdk, ctx));
+      }
+    }
+
+    logger.debug("Registered prompt", { name: prompt.name });
+  };
+}

package/src/mcp-server/resources.ts

@@ -46,6 +46,7 @@ export type ResourceTemplateDefinition = {
   read: ReadResourceTemplateCallback;
 };
 
+// Optional function to assist with formatting resource results
 export async function formatResult(
   value: unknown,
   uri: URL,

package/src/mcp-server/server.ts

@@ -6,6 +6,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { MoovCore } from "../core.js";
 import { SDKOptions } from "../lib/config.js";
 import type { ConsoleLogger } from "./console-logger.js";
+import { createRegisterPrompt } from "./prompts.js";
 import {
   createRegisterResource,
   createRegisterResourceTemplate,
@@ -155,7 +156,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Moov",
-    version: "0.8.1",
+    version: "0.9.0",
   });
 
   const client = new MoovCore({
@@ -182,7 +183,8 @@ export function createMCPServer(deps: {
     client,
     scopes,
   );
-  const register = { tool, resource, resourceTemplate };
+  const prompt = createRegisterPrompt(deps.logger, server, client, scopes);
+  const register = { tool, resource, resourceTemplate, prompt };
   void register; // suppress unused warnings
 
   tool(tool$accountsCreate);

package/src/mcp-server/tools.ts

@@ -34,6 +34,7 @@ export type ToolDefinition<Args extends undefined | ZodRawShape = undefined> =
       ) => CallToolResult | Promise<CallToolResult>;
     };
 
+// Optional function to assist with formatting tool results
 export async function formatResult(
   value: unknown,
   init: { response?: Response | undefined },

package/src/models/components/createtransfersource.ts

@@ -31,6 +31,7 @@ export type CreateTransferSource = {
    */
   transferID?: string | undefined;
   paymentMethodID?: string | undefined;
+  paymentToken?: string | undefined;
   cardDetails?: CreateTransferSourceCard | undefined;
   achDetails?: CreateTransferSourceACH | undefined;
 };
@@ -43,6 +44,7 @@ export const CreateTransferSource$inboundSchema: z.ZodType<
 > = z.object({
   transferID: z.string().optional(),
   paymentMethodID: z.string().optional(),
+  paymentToken: z.string().optional(),
   cardDetails: CreateTransferSourceCard$inboundSchema.optional(),
   achDetails: CreateTransferSourceACH$inboundSchema.optional(),
 });
@@ -51,6 +53,7 @@ export const CreateTransferSource$inboundSchema: z.ZodType<
 export type CreateTransferSource$Outbound = {
   transferID?: string | undefined;
   paymentMethodID?: string | undefined;
+  paymentToken?: string | undefined;
   cardDetails?: CreateTransferSourceCard$Outbound | undefined;
   achDetails?: CreateTransferSourceACH$Outbound | undefined;
 };
@@ -63,6 +66,7 @@ export const CreateTransferSource$outboundSchema: z.ZodType<
 > = z.object({
   transferID: z.string().optional(),
   paymentMethodID: z.string().optional(),
+  paymentToken: z.string().optional(),
   cardDetails: CreateTransferSourceCard$outboundSchema.optional(),
   achDetails: CreateTransferSourceACH$outboundSchema.optional(),
 });

package/src/models/components/transfersource.ts

@@ -47,6 +47,12 @@ import {
   PaymentMethodType$inboundSchema,
   PaymentMethodType$outboundSchema,
 } from "./paymentmethodtype.js";
+import {
+  TerminalCard,
+  TerminalCard$inboundSchema,
+  TerminalCard$Outbound,
+  TerminalCard$outboundSchema,
+} from "./terminalcard.js";
 import {
   TransferAccount,
   TransferAccount$inboundSchema,
@@ -78,6 +84,10 @@ export type TransferSource = {
    * Describes an Apple Pay token on a Moov account.
    */
   applePay?: ApplePayResponse | undefined;
+  /**
+   * Describes payment card details captured with tap or in-person payment.
+   */
+  terminalCard?: TerminalCard | undefined;
   /**
    * Card-specific details about the transaction.
    */
@@ -102,6 +112,7 @@ export const TransferSource$inboundSchema: z.ZodType<
   wallet: PaymentMethodsWallet$inboundSchema.optional(),
   card: PaymentMethodsCard$inboundSchema.optional(),
   applePay: ApplePayResponse$inboundSchema.optional(),
+  terminalCard: TerminalCard$inboundSchema.optional(),
   cardDetails: CardTransactionDetails$inboundSchema.optional(),
   achDetails: ACHTransactionDetails$inboundSchema.optional(),
 });
@@ -116,6 +127,7 @@ export type TransferSource$Outbound = {
   wallet?: PaymentMethodsWallet$Outbound | undefined;
   card?: PaymentMethodsCard$Outbound | undefined;
   applePay?: ApplePayResponse$Outbound | undefined;
+  terminalCard?: TerminalCard$Outbound | undefined;
   cardDetails?: CardTransactionDetails$Outbound | undefined;
   achDetails?: ACHTransactionDetails$Outbound | undefined;
 };
@@ -134,6 +146,7 @@ export const TransferSource$outboundSchema: z.ZodType<
   wallet: PaymentMethodsWallet$outboundSchema.optional(),
   card: PaymentMethodsCard$outboundSchema.optional(),
   applePay: ApplePayResponse$outboundSchema.optional(),
+  terminalCard: TerminalCard$outboundSchema.optional(),
   cardDetails: CardTransactionDetails$outboundSchema.optional(),
   achDetails: ACHTransactionDetails$outboundSchema.optional(),
 });

package/src/models/components/wallettransactionsourcetype.ts

@@ -12,6 +12,7 @@ export const WalletTransactionSourceType = {
   IssuingAuthorization: "issuing-authorization",
   Sweep: "sweep",
   Adjustment: "adjustment",
+  Fee: "fee",
 } as const;
 export type WalletTransactionSourceType = ClosedEnum<
   typeof WalletTransactionSourceType