@moovio/sdk 0.11.5 → 0.12.0

package/src/funcs/walletsList.ts

@@ -106,6 +106,7 @@ async function $do(
   const requestSecurity = resolveGlobalSecurity(securityInput);
 
   const context = {
+    options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "listWallets",
     oAuth2Scopes: [],
@@ -126,6 +127,7 @@ async function $do(
     path: path,
     headers: headers,
     body: body,
+    userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
   }, options);
   if (!requestRes.ok) {

package/src/hooks/types.ts

@@ -2,6 +2,7 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+import { SDKOptions } from "../lib/config.js";
 import { HTTPClient, RequestInput } from "../lib/http.js";
 import { RetryConfig } from "../lib/retries.js";
 import { SecurityState } from "../lib/security.js";
@@ -13,6 +14,7 @@ export type HookContext = {
   securitySource?: any | (() => Promise<any>);
   retryConfig: RetryConfig;
   resolvedSecurity: SecurityState | null;
+  options: SDKOptions;
 };
 
 export type Awaitable<T> = T | Promise<T>;

package/src/index.ts

@@ -4,4 +4,6 @@
 
 export * from "./lib/config.js";
 export * as files from "./lib/files.js";
+export { HTTPClient } from "./lib/http.js";
+export type { Fetcher, HTTPClientOptions } from "./lib/http.js";
 export * from "./sdk/sdk.js";

package/src/lib/config.ts

@@ -41,6 +41,10 @@ export type SDKOptions = {
    * Allows overriding the default server URL used by the SDK
    */
   serverURL?: string | undefined;
+  /**
+   * Allows overriding the default user agent used by the SDK
+   */
+  userAgent?: string | undefined;
   /**
    * Allows overriding the default retry config used by the SDK
    */
@@ -69,7 +73,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "latest",
-  sdkVersion: "0.11.5",
-  genVersion: "2.599.0",
-  userAgent: "speakeasy-sdk/typescript 0.11.5 2.599.0 latest @moovio/sdk",
+  sdkVersion: "0.12.0",
+  genVersion: "2.618.0",
+  userAgent: "speakeasy-sdk/typescript 0.12.0 2.618.0 latest @moovio/sdk",
 } as const;

package/src/lib/sdks.ts

@@ -64,6 +64,7 @@ type RequestConfig = {
   headers?: HeadersInit;
   security?: SecurityState | null;
   uaHeader?: string;
+  userAgent?: string | undefined;
   timeoutMs?: number;
 };
 
@@ -95,19 +96,21 @@ export class ClientSDK {
     } else {
       this.#hooks = new SDKHooks();
     }
-    this._options = { ...options, hooks: this.#hooks };
-
     const url = serverURLFromOptions(options);
     if (url) {
       url.pathname = url.pathname.replace(/\/+$/, "") + "/";
     }
+
     const { baseURL, client } = this.#hooks.sdkInit({
       baseURL: url,
       client: options.httpClient || new HTTPClient(),
     });
     this._baseURL = baseURL;
     this.#httpClient = client;
-    this.#logger = options.debugLogger;
+
+    this._options = { ...options, hooks: this.#hooks };
+
+    this.#logger = this._options.debugLogger;
   }
 
   public _createRequest(
@@ -180,7 +183,10 @@ export class ClientSDK {
     // Only set user agent header in non-browser-like environments since CORS
     // policy disallows setting it in browsers e.g. Chrome throws an error.
     if (!isBrowserLike) {
-      headers.set(conf.uaHeader ?? "user-agent", SDK_METADATA.userAgent);
+      headers.set(
+        conf.uaHeader ?? "user-agent",
+        conf.userAgent ?? SDK_METADATA.userAgent,
+      );
     }
 
     const fetchOptions: Omit<RequestInit, "method" | "body"> = {

package/src/mcp-server/cli/start/impl.ts

@@ -54,8 +54,8 @@ async function startStdio(flags: StartCommandFlags) {
     allowedTools: flags.tool,
     scopes: flags.scope,
     security: allRequired({
-      username: flags.username,
-      password: flags.password,
+      username: flags.username ?? "",
+      password: flags.password ?? "",
     }),
     xMoovVersion: flags["x-moov-version"],
     serverURL: flags["server-url"],
@@ -79,8 +79,8 @@ async function startSSE(flags: StartCommandFlags) {
     allowedTools: flags.tool,
     scopes: flags.scope,
     security: allRequired({
-      username: flags.username,
-      password: flags.password,
+      username: flags.username ?? "",
+      password: flags.password ?? "",
     }),
     xMoovVersion: flags["x-moov-version"],
     serverURL: flags["server-url"],

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

@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.11.5",
+    currentVersion: "0.12.0",
   },
 });
 

package/src/mcp-server/server.ts

@@ -160,7 +160,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Moov",
-    version: "0.11.5",
+    version: "0.12.0",
   });
 
   const client = new MoovCore({

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

@@ -13,9 +13,9 @@ const args = {
 export const tool$industriesList: ToolDefinition<typeof args> = {
   name: "industries-list",
   description:
-    `Returns a list of all industry titles and their corresponding MCC/SIC/NAICS codes. Results are ordered by title.    
+    `Returns a list of industries relevant to merchant profile enrichment.  Results are ordered by industry name.
 
-To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/) 
+To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/),
 you'll need to specify the \`/profile-enrichment.read\` scope.`,
   args,
   tool: async (client, args, ctx) => {

package/src/models/components/enrichedindustries.ts

@@ -7,14 +7,14 @@ import { safeParse } from "../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 import {
-  EnrichedIndustry,
-  EnrichedIndustry$inboundSchema,
-  EnrichedIndustry$Outbound,
-  EnrichedIndustry$outboundSchema,
-} from "./enrichedindustry.js";
+  IndustryTaxonomy,
+  IndustryTaxonomy$inboundSchema,
+  IndustryTaxonomy$Outbound,
+  IndustryTaxonomy$outboundSchema,
+} from "./industrytaxonomy.js";
 
 export type EnrichedIndustries = {
-  industries: Array<EnrichedIndustry>;
+  industries: Array<IndustryTaxonomy>;
 };
 
 /** @internal */
@@ -23,12 +23,12 @@ export const EnrichedIndustries$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  industries: z.array(EnrichedIndustry$inboundSchema),
+  industries: z.array(IndustryTaxonomy$inboundSchema),
 });
 
 /** @internal */
 export type EnrichedIndustries$Outbound = {
-  industries: Array<EnrichedIndustry$Outbound>;
+  industries: Array<IndustryTaxonomy$Outbound>;
 };
 
 /** @internal */
@@ -37,7 +37,7 @@ export const EnrichedIndustries$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   EnrichedIndustries
 > = z.object({
-  industries: z.array(EnrichedIndustry$outboundSchema),
+  industries: z.array(IndustryTaxonomy$outboundSchema),
 });
 
 /**

package/src/models/components/index.ts

@@ -159,7 +159,6 @@ export * from "./enrichedaddressresponse.js";
 export * from "./enrichedbusinessprofile.js";
 export * from "./enrichedbusinessresponse.js";
 export * from "./enrichedindustries.js";
-export * from "./enrichedindustry.js";
 export * from "./enrichedindustrycodes.js";
 export * from "./entrymode.js";
 export * from "./evidencetextresponse.js";
@@ -196,6 +195,7 @@ export * from "./individualnameerror.js";
 export * from "./individualnameupdate.js";
 export * from "./individualprofile.js";
 export * from "./industrycodes.js";
+export * from "./industrytaxonomy.js";
 export * from "./issuedcard.js";
 export * from "./issuedcardauthorization.js";
 export * from "./issuedcardauthorizationevent.js";
@@ -318,6 +318,7 @@ export * from "./sweepconfig.js";
 export * from "./sweepconfigpaymentmethod.js";
 export * from "./sweepconfigstatus.js";
 export * from "./sweepstatus.js";
+export * from "./sweepsubtotal.js";
 export * from "./taxid.js";
 export * from "./taxidupdate.js";
 export * from "./terminalapplication.js";

package/src/models/components/industrytaxonomy.ts

@@ -0,0 +1,100 @@
+/*
+ * 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";
+
+/**
+ * A structured industry taxonomy entry with category and mapped to a default MCC code.
+ */
+export type IndustryTaxonomy = {
+  /**
+   * URL-safe identifier for the industry
+   */
+  industry: string;
+  /**
+   * Display name of the industry
+   */
+  displayName: string;
+  /**
+   * Category slug
+   */
+  category: string;
+  /**
+   * Human-readable category label
+   */
+  categoryDisplayName: string;
+  /**
+   * Default Merchant Category Code
+   */
+  defaultMcc: string;
+};
+
+/** @internal */
+export const IndustryTaxonomy$inboundSchema: z.ZodType<
+  IndustryTaxonomy,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  industry: z.string(),
+  displayName: z.string(),
+  category: z.string(),
+  categoryDisplayName: z.string(),
+  defaultMcc: z.string(),
+});
+
+/** @internal */
+export type IndustryTaxonomy$Outbound = {
+  industry: string;
+  displayName: string;
+  category: string;
+  categoryDisplayName: string;
+  defaultMcc: string;
+};
+
+/** @internal */
+export const IndustryTaxonomy$outboundSchema: z.ZodType<
+  IndustryTaxonomy$Outbound,
+  z.ZodTypeDef,
+  IndustryTaxonomy
+> = z.object({
+  industry: z.string(),
+  displayName: z.string(),
+  category: z.string(),
+  categoryDisplayName: z.string(),
+  defaultMcc: 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 IndustryTaxonomy$ {
+  /** @deprecated use `IndustryTaxonomy$inboundSchema` instead. */
+  export const inboundSchema = IndustryTaxonomy$inboundSchema;
+  /** @deprecated use `IndustryTaxonomy$outboundSchema` instead. */
+  export const outboundSchema = IndustryTaxonomy$outboundSchema;
+  /** @deprecated use `IndustryTaxonomy$Outbound` instead. */
+  export type Outbound = IndustryTaxonomy$Outbound;
+}
+
+export function industryTaxonomyToJSON(
+  industryTaxonomy: IndustryTaxonomy,
+): string {
+  return JSON.stringify(
+    IndustryTaxonomy$outboundSchema.parse(industryTaxonomy),
+  );
+}
+
+export function industryTaxonomyFromJSON(
+  jsonString: string,
+): SafeParseResult<IndustryTaxonomy, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => IndustryTaxonomy$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'IndustryTaxonomy' from JSON`,
+  );
+}

package/src/models/components/sweep.ts

@@ -11,6 +11,12 @@ import {
   SweepStatus$inboundSchema,
   SweepStatus$outboundSchema,
 } from "./sweepstatus.js";
+import {
+  SweepSubtotal,
+  SweepSubtotal$inboundSchema,
+  SweepSubtotal$Outbound,
+  SweepSubtotal$outboundSchema,
+} from "./sweepsubtotal.js";
 
 export type Sweep = {
   sweepID: string;
@@ -52,6 +58,10 @@ export type Sweep = {
    * The text that appears on the banking statement. The default descriptor is a 10 character ID if an override is not set in the sweep configs statementDescriptor.
    */
   statementDescriptor?: string | undefined;
+  /**
+   * The subtotal of each transaction type contributing to the sweep's accrued amount.
+   */
+  subtotals?: Array<SweepSubtotal> | undefined;
 };
 
 /** @internal */
@@ -73,6 +83,7 @@ export const Sweep$inboundSchema: z.ZodType<Sweep, z.ZodTypeDef, unknown> = z
     transferID: z.string().optional(),
     transferAmount: z.string().optional(),
     statementDescriptor: z.string().optional(),
+    subtotals: z.array(SweepSubtotal$inboundSchema).optional(),
   });
 
 /** @internal */
@@ -89,6 +100,7 @@ export type Sweep$Outbound = {
   transferID?: string | undefined;
   transferAmount?: string | undefined;
   statementDescriptor?: string | undefined;
+  subtotals?: Array<SweepSubtotal$Outbound> | undefined;
 };
 
 /** @internal */
@@ -109,6 +121,7 @@ export const Sweep$outboundSchema: z.ZodType<
   transferID: z.string().optional(),
   transferAmount: z.string().optional(),
   statementDescriptor: z.string().optional(),
+  subtotals: z.array(SweepSubtotal$outboundSchema).optional(),
 });
 
 /**

package/src/models/components/sweepsubtotal.ts

@@ -0,0 +1,90 @@
+/*
+ * 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 {
+  AmountDecimal,
+  AmountDecimal$inboundSchema,
+  AmountDecimal$Outbound,
+  AmountDecimal$outboundSchema,
+} from "./amountdecimal.js";
+import {
+  WalletTransactionType,
+  WalletTransactionType$inboundSchema,
+  WalletTransactionType$outboundSchema,
+} from "./wallettransactiontype.js";
+
+export type SweepSubtotal = {
+  /**
+   * The type of wallet transaction the subtotal is for.
+   */
+  type: WalletTransactionType;
+  /**
+   * The number of transactions of this type accrued in the sweep.
+   */
+  count: number;
+  /**
+   * The value of transactions of this type accrued in the sweep.
+   */
+  amount: AmountDecimal;
+};
+
+/** @internal */
+export const SweepSubtotal$inboundSchema: z.ZodType<
+  SweepSubtotal,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  type: WalletTransactionType$inboundSchema,
+  count: z.number().int(),
+  amount: AmountDecimal$inboundSchema,
+});
+
+/** @internal */
+export type SweepSubtotal$Outbound = {
+  type: string;
+  count: number;
+  amount: AmountDecimal$Outbound;
+};
+
+/** @internal */
+export const SweepSubtotal$outboundSchema: z.ZodType<
+  SweepSubtotal$Outbound,
+  z.ZodTypeDef,
+  SweepSubtotal
+> = z.object({
+  type: WalletTransactionType$outboundSchema,
+  count: z.number().int(),
+  amount: AmountDecimal$outboundSchema,
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace SweepSubtotal$ {
+  /** @deprecated use `SweepSubtotal$inboundSchema` instead. */
+  export const inboundSchema = SweepSubtotal$inboundSchema;
+  /** @deprecated use `SweepSubtotal$outboundSchema` instead. */
+  export const outboundSchema = SweepSubtotal$outboundSchema;
+  /** @deprecated use `SweepSubtotal$Outbound` instead. */
+  export type Outbound = SweepSubtotal$Outbound;
+}
+
+export function sweepSubtotalToJSON(sweepSubtotal: SweepSubtotal): string {
+  return JSON.stringify(SweepSubtotal$outboundSchema.parse(sweepSubtotal));
+}
+
+export function sweepSubtotalFromJSON(
+  jsonString: string,
+): SafeParseResult<SweepSubtotal, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SweepSubtotal$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SweepSubtotal' from JSON`,
+  );
+}

package/src/sdk/industries.ts

@@ -9,9 +9,9 @@ import { unwrapAsync } from "../types/fp.js";
 
 export class Industries extends ClientSDK {
   /**
-   * Returns a list of all industry titles and their corresponding MCC/SIC/NAICS codes. Results are ordered by title.
+   * Returns a list of industries relevant to merchant profile enrichment.  Results are ordered by industry name.
    *
-   * To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/)
+   * To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/),
    * you'll need to specify the `/profile-enrichment.read` scope.
    */
   async list(

package/test/README.md

@@ -0,0 +1,2 @@
+1. Make sure you have `bun` [installed](https://bun.sh/docs/installation)
+2. Run `bun test` or `bun test:verbose` to see all the Requests and Responses

package/test/index.ts

@@ -0,0 +1 @@
+console.log("Hello via Bun!");

package/test/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "moov-typescript-test",
+  "module": "index.ts",
+  "type": "module",
+  "scripts": {
+    "format": "prettier --write \"**/*.{ts,tsx,md,json}\"",
+    "format:check": "prettier --check \"**/*.{ts,tsx,md,json}\"",
+    "test": "bun test --timeout 20000",
+    "test:verbose": "VERBOSE=1 bun test --timeout 20000"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/chance": "^1.1.6",
+    "bun-types": "^1.2.2",
+    "chance": "^1.1.12",
+    "prettier": "^3.1.0",
+    "@moovio/sdk": "link:@moovio/sdk"
+  },
+  "peerDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "remeda": "^2.20.1"
+  }
+}

package/test/setup.ts

@@ -0,0 +1,119 @@
+import { beforeAll, afterAll } from "bun:test";
+import { Moov } from "@moovio/sdk";
+import secrets from "./.secrets.json";
+
+export let moov: Moov;
+
+const verbose = process.env.VERBOSE === "1";
+
+type Seen = {
+  accountID: string;
+  bankAccountID?: string;
+  cardID?: string;
+  representativeID?: string;
+};
+
+const idsSeen: Set<Seen> = new Set();
+
+export const ids = {
+  seen: (seen: Seen) => {
+    idsSeen.add(seen);
+  },
+  cleanup: async () => {
+    for (const seen of idsSeen) {
+      if (seen.representativeID) {
+        try {
+          console.log("🔄  Removing Representative", seen.representativeID);
+          await moov.representatives.delete({ accountID: seen.accountID, representativeID: seen.representativeID! });
+        } catch (e) {
+          // empty
+        }
+      } else if (seen.bankAccountID) {
+        try {
+          console.log("🔄  Removing Bank Account", seen.bankAccountID);
+          await moov.bankAccounts.disable({ accountID: seen.accountID, bankAccountID: seen.bankAccountID! });
+        } catch (e) {
+          // eslint-disable
+        }
+      } else if (seen.cardID) {
+        try {
+          console.log("🔄  Removing Card", seen.cardID);
+          await moov.cards.disable({ accountID: seen.accountID, cardID: seen.cardID! });
+        } catch (e) {
+          // empty
+        }
+      } else if (seen.accountID) {
+        try {
+          console.log("🔄  Removing Account", seen.accountID);
+          await moov.accounts.disconnect({ accountID: seen.accountID });
+        } catch (e) {
+          // eslint-disable
+        }
+      }
+    }
+  },
+};
+
+beforeAll(() => {
+  if (verbose) {
+    // Override global fetch to attach a logger
+    const originalFetch = global.fetch;
+    global.fetch = async (input: RequestInfo | URL, init?: RequestInit) => {
+      const url = input instanceof Request ? input.url : input.toString();
+      const headers = input instanceof Request ? input.headers : "";
+      const body = input instanceof Request ? input.body : "";
+      const method = init?.method || (input instanceof Request ? input.method : "");
+
+      // Log requests
+      console.log(`↗️ API Request | ${method} | URL: ${url}`);
+      console.log(`Headers:`);
+      console.log(headers);
+      console.log(`Body:`);
+      console.log(body);
+      console.log("\n");
+
+      // Make the actual request
+      const response = await originalFetch(input, init);
+
+      // Clone the response since it can only be read once
+      const responseClone = response.clone();
+
+      // Log responses
+      console.log(`↙️ API Response | ${method} | URL: ${url}`);
+      console.log(`Status: ${response.status} ${response.statusText}`);
+      console.log(`Headers:`);
+      console.log(response.headers);
+      console.log(`Body:`);
+      try {
+        const responseBody = await responseClone.json();
+        console.log(JSON.stringify(responseBody, null, 2));
+      } catch (e) {
+        console.log("<non-JSON response>");
+      }
+      console.log("\n");
+
+      return response;
+    };
+
+    afterAll(() => {
+      global.fetch = originalFetch;
+    });
+    console.log("ℹ️  Logger setup complete\n\n");
+  }
+
+  moov = new Moov({
+    security: {
+      username: secrets.username,
+      password: secrets.password,
+    },
+    serverURL: secrets.serverURL,
+  });
+
+  console.log("ℹ️  Moov SDK setup complete\n\n");
+
+  afterAll(async () => {
+    console.log("\n\n🔄  Cleaning up after tests\n\n");
+    // Cleanup if we have the IDs available
+    await ids.cleanup();
+  });
+});