@moovio/sdk 0.11.5 → 0.12.1

package/docs/sdks/files/README.md

@@ -38,6 +38,7 @@ import { Moov } from "@moovio/sdk";
 import { openAsBlob } from "node:fs";
 
 const moov = new Moov({
+  xMoovVersion: "v2024.01.00",
   security: {
     username: "",
     password: "",
@@ -46,7 +47,7 @@ const moov = new Moov({
 
 async function run() {
   const result = await moov.files.upload({
-    accountID: "6886a454-7910-4a2b-b98a-ab61ec65fc41",
+    accountID: "221c30bd-2551-4ae4-9a14-07bf6599b728",
     fileUploadRequestMultiPart: {
       file: await openAsBlob("example.file"),
       filePurpose: "representative_verification",
@@ -54,7 +55,6 @@ async function run() {
     },
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -73,6 +73,7 @@ import { openAsBlob } from "node:fs";
 // Use `MoovCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
 const moov = new MoovCore({
+  xMoovVersion: "v2024.01.00",
   security: {
     username: "",
     password: "",
@@ -81,22 +82,19 @@ const moov = new MoovCore({
 
 async function run() {
   const res = await filesUpload(moov, {
-    accountID: "6886a454-7910-4a2b-b98a-ab61ec65fc41",
+    accountID: "221c30bd-2551-4ae4-9a14-07bf6599b728",
     fileUploadRequestMultiPart: {
       file: await openAsBlob("example.file"),
       filePurpose: "representative_verification",
       metadata: "{\"requirement_id\": \"document.individual.verification\"}",
     },
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("filesUpload failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -136,6 +134,7 @@ you'll need to specify the `/accounts/{accountID}/files.read` scope.
 import { Moov } from "@moovio/sdk";
 
 const moov = new Moov({
+  xMoovVersion: "v2024.01.00",
   security: {
     username: "",
     password: "",
@@ -144,10 +143,9 @@ const moov = new Moov({
 
 async function run() {
   const result = await moov.files.list({
-    accountID: "c8a232aa-0b11-4b8a-b005-71e9e705d0e6",
+    accountID: "d1133bf2-4853-4436-9a03-23739895ab98",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -165,6 +163,7 @@ import { filesList } from "@moovio/sdk/funcs/filesList.js";
 // Use `MoovCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
 const moov = new MoovCore({
+  xMoovVersion: "v2024.01.00",
   security: {
     username: "",
     password: "",
@@ -173,17 +172,14 @@ const moov = new MoovCore({
 
 async function run() {
   const res = await filesList(moov, {
-    accountID: "c8a232aa-0b11-4b8a-b005-71e9e705d0e6",
+    accountID: "d1133bf2-4853-4436-9a03-23739895ab98",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("filesList failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -221,6 +217,7 @@ you'll need to specify the `/accounts/{accountID}/files.read` scope.
 import { Moov } from "@moovio/sdk";
 
 const moov = new Moov({
+  xMoovVersion: "v2024.01.00",
   security: {
     username: "",
     password: "",
@@ -229,11 +226,10 @@ const moov = new Moov({
 
 async function run() {
   const result = await moov.files.get({
-    accountID: "b888f774-3e7c-4135-a18c-6b985523c4bc",
-    fileID: "e50f7622-81da-484b-9c66-1c8a99c6b71b",
+    accountID: "7f888113-d35a-4536-b9bc-c55076736ab6",
+    fileID: "af170db9-0d17-4a9f-ade6-5dd2f1b3412d",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -251,6 +247,7 @@ import { filesGet } from "@moovio/sdk/funcs/filesGet.js";
 // Use `MoovCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
 const moov = new MoovCore({
+  xMoovVersion: "v2024.01.00",
   security: {
     username: "",
     password: "",
@@ -259,18 +256,15 @@ const moov = new MoovCore({
 
 async function run() {
   const res = await filesGet(moov, {
-    accountID: "b888f774-3e7c-4135-a18c-6b985523c4bc",
-    fileID: "e50f7622-81da-484b-9c66-1c8a99c6b71b",
+    accountID: "7f888113-d35a-4536-b9bc-c55076736ab6",
+    fileID: "af170db9-0d17-4a9f-ade6-5dd2f1b3412d",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("filesGet failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();

package/docs/sdks/industries/README.md

@@ -5,16 +5,16 @@
 
 ### Available Operations
 
-* [list](#list) - Returns a list of all industry titles and their corresponding MCC/SIC/NAICS codes. Results are ordered by title.    
+* [list](#list) - 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.
 
 ## list
 
-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.
 
 ### Example Usage
@@ -23,6 +23,7 @@ you'll need to specify the `/profile-enrichment.read` scope.
 import { Moov } from "@moovio/sdk";
 
 const moov = new Moov({
+  xMoovVersion: "v2024.01.00",
   security: {
     username: "",
     password: "",
@@ -32,7 +33,6 @@ const moov = new Moov({
 async function run() {
   const result = await moov.industries.list({});
 
-  // Handle the result
   console.log(result);
 }
 
@@ -50,6 +50,7 @@ import { industriesList } from "@moovio/sdk/funcs/industriesList.js";
 // Use `MoovCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
 const moov = new MoovCore({
+  xMoovVersion: "v2024.01.00",
   security: {
     username: "",
     password: "",
@@ -58,15 +59,12 @@ const moov = new MoovCore({
 
 async function run() {
   const res = await industriesList(moov, {});
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("industriesList failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();

package/docs/sdks/institutions/README.md

@@ -5,11 +5,102 @@
 
 ### Available Operations
 
+* [searchInstitutions](#searchinstitutions) - Search for financial institutions by name or routing number.
+
+This endpoint returns metadata about each matched institution, including basic identifying details (such as name, routing number, and address) and information about which payment services they support (e.g., ACH, RTP, and Wire).
+
+This can be used to validate a financial institution before initiating payment activity, or to check which payment rails are available for a given routing number.
+
+To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/)
+you'll need to specify the `/institutions.read` scope.
 * [search](#search) - Search for institutions by either their name or routing number.
 
 To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/) 
 you'll need to specify the `/fed.read` scope.
 
+## searchInstitutions
+
+Search for financial institutions by name or routing number.
+
+This endpoint returns metadata about each matched institution, including basic identifying details (such as name, routing number, and address) and information about which payment services they support (e.g., ACH, RTP, and Wire).
+
+This can be used to validate a financial institution before initiating payment activity, or to check which payment rails are available for a given routing number.
+
+To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/)
+you'll need to specify the `/institutions.read` scope.
+
+### Example Usage
+
+```typescript
+import { Moov } from "@moovio/sdk";
+
+const moov = new Moov({
+  xMoovVersion: "v2024.01.00",
+  security: {
+    username: "",
+    password: "",
+  },
+});
+
+async function run() {
+  const result = await moov.institutions.searchInstitutions({});
+
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { MoovCore } from "@moovio/sdk/core.js";
+import { institutionsSearchInstitutions } from "@moovio/sdk/funcs/institutionsSearchInstitutions.js";
+
+// Use `MoovCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const moov = new MoovCore({
+  xMoovVersion: "v2024.01.00",
+  security: {
+    username: "",
+    password: "",
+  },
+});
+
+async function run() {
+  const res = await institutionsSearchInstitutions(moov, {});
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("institutionsSearchInstitutions failed:", res.error);
+  }
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [operations.SearchInstitutionsRequest](../../models/operations/searchinstitutionsrequest.md)                                                                                   | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[operations.SearchInstitutionsResponse](../../models/operations/searchinstitutionsresponse.md)\>**
+
+### Errors
+
+| Error Type      | Status Code     | Content Type    |
+| --------------- | --------------- | --------------- |
+| errors.APIError | 4XX, 5XX        | \*/\*           |
+
 ## search
 
 Search for institutions by either their name or routing number.
@@ -23,6 +114,7 @@ you'll need to specify the `/fed.read` scope.
 import { Moov } from "@moovio/sdk";
 
 const moov = new Moov({
+  xMoovVersion: "v2024.01.00",
   security: {
     username: "",
     password: "",
@@ -32,7 +124,6 @@ const moov = new Moov({
 async function run() {
   const result = await moov.institutions.search({});
 
-  // Handle the result
   console.log(result);
 }
 
@@ -50,6 +141,7 @@ import { institutionsSearch } from "@moovio/sdk/funcs/institutionsSearch.js";
 // Use `MoovCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
 const moov = new MoovCore({
+  xMoovVersion: "v2024.01.00",
   security: {
     username: "",
     password: "",
@@ -58,15 +150,12 @@ const moov = new MoovCore({
 
 async function run() {
   const res = await institutionsSearch(moov, {});
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("institutionsSearch failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();

package/docs/sdks/issuingtransactions/README.md

@@ -39,6 +39,7 @@ you'll need to specify the `/accounts/{accountID}/issued-cards.read` scope.
 import { Moov } from "@moovio/sdk";
 
 const moov = new Moov({
+  xMoovVersion: "v2024.01.00",
   security: {
     username: "",
     password: "",
@@ -47,12 +48,11 @@ const moov = new Moov({
 
 async function run() {
   const result = await moov.issuingTransactions.listAuthorizations({
-    accountID: "c2c85e2d-634b-4cc0-8c5b-763c22a727b6",
+    accountID: "6465d95a-e945-4a49-8983-d74faa135bb4",
     skip: 60,
     count: 20,
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -70,6 +70,7 @@ import { issuingTransactionsListAuthorizations } from "@moovio/sdk/funcs/issuing
 // Use `MoovCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
 const moov = new MoovCore({
+  xMoovVersion: "v2024.01.00",
   security: {
     username: "",
     password: "",
@@ -78,19 +79,16 @@ const moov = new MoovCore({
 
 async function run() {
   const res = await issuingTransactionsListAuthorizations(moov, {
-    accountID: "c2c85e2d-634b-4cc0-8c5b-763c22a727b6",
+    accountID: "6465d95a-e945-4a49-8983-d74faa135bb4",
     skip: 60,
     count: 20,
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("issuingTransactionsListAuthorizations failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -128,6 +126,7 @@ you'll need to specify the `/accounts/{accountID}/issued-cards.read` scope.
 import { Moov } from "@moovio/sdk";
 
 const moov = new Moov({
+  xMoovVersion: "v2024.01.00",
   security: {
     username: "",
     password: "",
@@ -136,11 +135,10 @@ const moov = new Moov({
 
 async function run() {
   const result = await moov.issuingTransactions.getAuthorization({
-    accountID: "7fe28e4d-1e30-4ebb-8d22-aae768170b82",
-    authorizationID: "8db4b0c4-d99d-4878-bcde-c2700f82e331",
+    accountID: "0ccac2cc-6692-44a9-b0d1-35a1892c2db2",
+    authorizationID: "d9ee8dde-b1eb-492f-bea1-d8e09bccbc52",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -158,6 +156,7 @@ import { issuingTransactionsGetAuthorization } from "@moovio/sdk/funcs/issuingTr
 // Use `MoovCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
 const moov = new MoovCore({
+  xMoovVersion: "v2024.01.00",
   security: {
     username: "",
     password: "",
@@ -166,18 +165,15 @@ const moov = new MoovCore({
 
 async function run() {
   const res = await issuingTransactionsGetAuthorization(moov, {
-    accountID: "7fe28e4d-1e30-4ebb-8d22-aae768170b82",
-    authorizationID: "8db4b0c4-d99d-4878-bcde-c2700f82e331",
+    accountID: "0ccac2cc-6692-44a9-b0d1-35a1892c2db2",
+    authorizationID: "d9ee8dde-b1eb-492f-bea1-d8e09bccbc52",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("issuingTransactionsGetAuthorization failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -215,6 +211,7 @@ you'll need to specify the `/accounts/{accountID}/issued-cards.read` scope.
 import { Moov } from "@moovio/sdk";
 
 const moov = new Moov({
+  xMoovVersion: "v2024.01.00",
   security: {
     username: "",
     password: "",
@@ -223,13 +220,12 @@ const moov = new Moov({
 
 async function run() {
   const result = await moov.issuingTransactions.listAuthorizationEvents({
-    accountID: "e52b1b82-54cb-42aa-911b-6359b8490650",
-    authorizationID: "f1a90d72-3787-49c4-a11d-9e7efe0b3763",
+    accountID: "f30f8cb3-64d8-4a5f-a427-965317fa559a",
+    authorizationID: "e6a0946d-f3d8-451e-9b1c-5bc346a95dd6",
     skip: 60,
     count: 20,
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -247,6 +243,7 @@ import { issuingTransactionsListAuthorizationEvents } from "@moovio/sdk/funcs/is
 // Use `MoovCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
 const moov = new MoovCore({
+  xMoovVersion: "v2024.01.00",
   security: {
     username: "",
     password: "",
@@ -255,20 +252,17 @@ const moov = new MoovCore({
 
 async function run() {
   const res = await issuingTransactionsListAuthorizationEvents(moov, {
-    accountID: "e52b1b82-54cb-42aa-911b-6359b8490650",
-    authorizationID: "f1a90d72-3787-49c4-a11d-9e7efe0b3763",
+    accountID: "f30f8cb3-64d8-4a5f-a427-965317fa559a",
+    authorizationID: "e6a0946d-f3d8-451e-9b1c-5bc346a95dd6",
     skip: 60,
     count: 20,
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("issuingTransactionsListAuthorizationEvents failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -306,6 +300,7 @@ you'll need to specify the `/accounts/{accountID}/issued-cards.read` scope.
 import { Moov } from "@moovio/sdk";
 
 const moov = new Moov({
+  xMoovVersion: "v2024.01.00",
   security: {
     username: "",
     password: "",
@@ -314,12 +309,11 @@ const moov = new Moov({
 
 async function run() {
   const result = await moov.issuingTransactions.list({
-    accountID: "c8a232aa-0b11-4b8a-b005-71e9e705d0e6",
+    accountID: "4efcb497-f915-4b6e-b973-e5e5bcc1fd34",
     skip: 60,
     count: 20,
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -337,6 +331,7 @@ import { issuingTransactionsList } from "@moovio/sdk/funcs/issuingTransactionsLi
 // Use `MoovCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
 const moov = new MoovCore({
+  xMoovVersion: "v2024.01.00",
   security: {
     username: "",
     password: "",
@@ -345,19 +340,16 @@ const moov = new MoovCore({
 
 async function run() {
   const res = await issuingTransactionsList(moov, {
-    accountID: "c8a232aa-0b11-4b8a-b005-71e9e705d0e6",
+    accountID: "4efcb497-f915-4b6e-b973-e5e5bcc1fd34",
     skip: 60,
     count: 20,
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("issuingTransactionsList failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -395,6 +387,7 @@ you'll need to specify the `/accounts/{accountID}/issued-cards.read` scope.
 import { Moov } from "@moovio/sdk";
 
 const moov = new Moov({
+  xMoovVersion: "v2024.01.00",
   security: {
     username: "",
     password: "",
@@ -403,11 +396,10 @@ const moov = new Moov({
 
 async function run() {
   const result = await moov.issuingTransactions.get({
-    accountID: "b888f774-3e7c-4135-a18c-6b985523c4bc",
-    cardTransactionID: "e50f7622-81da-484b-9c66-1c8a99c6b71b",
+    accountID: "b2b6e23c-a5aa-46a9-adb7-d12876e47288",
+    cardTransactionID: "d5a1aab9-eb96-409a-ab95-88ac99cf00a5",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -425,6 +417,7 @@ import { issuingTransactionsGet } from "@moovio/sdk/funcs/issuingTransactionsGet
 // Use `MoovCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
 const moov = new MoovCore({
+  xMoovVersion: "v2024.01.00",
   security: {
     username: "",
     password: "",
@@ -433,18 +426,15 @@ const moov = new MoovCore({
 
 async function run() {
   const res = await issuingTransactionsGet(moov, {
-    accountID: "b888f774-3e7c-4135-a18c-6b985523c4bc",
-    cardTransactionID: "e50f7622-81da-484b-9c66-1c8a99c6b71b",
+    accountID: "b2b6e23c-a5aa-46a9-adb7-d12876e47288",
+    cardTransactionID: "d5a1aab9-eb96-409a-ab95-88ac99cf00a5",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("issuingTransactionsGet failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();