vanta-auditor-api-sdk 0.1.1 → 0.3.0

package/docs/sdks/auditors/README.md

@@ -22,12 +22,11 @@ const vanta = new Vanta({
 
 async function run() {
   const result = await vanta.auditors.create({
-    email: "Cooper59@hotmail.com",
+    email: "Genesis_Kunze87@yahoo.com",
     givenName: "<value>",
     familyName: "<value>",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -50,19 +49,16 @@ const vanta = new VantaCore({
 
 async function run() {
   const res = await auditorsCreate(vanta, {
-    email: "Cooper59@hotmail.com",
+    email: "Genesis_Kunze87@yahoo.com",
     givenName: "<value>",
     familyName: "<value>",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("auditorsCreate failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();

package/docs/sdks/audits/README.md

@@ -31,7 +31,6 @@ const vanta = new Vanta({
 async function run() {
   const result = await vanta.audits.list({});
 
-  // Handle the result
   console.log(result);
 }
 
@@ -54,15 +53,12 @@ const vanta = new VantaCore({
 
 async function run() {
   const res = await auditsList(vanta, {});
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("auditsList failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -89,7 +85,8 @@ run();
 
 ## getEvidenceUrls
 
-Returns a paginated list of evidence urls for an audit.
+Returns a paginated list of evidence urls for an audit. This endpoint should be called whenever an
+evidence is created or has a statusUpdatedAt field that is more recent than the most recent polling event.
 
 ### Example Usage
 
@@ -106,7 +103,6 @@ async function run() {
     auditEvidenceId: "<id>",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -132,15 +128,12 @@ async function run() {
     auditId: "<id>",
     auditEvidenceId: "<id>",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("auditsGetEvidenceUrls failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -183,7 +176,6 @@ async function run() {
     auditId: "<id>",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -208,15 +200,12 @@ async function run() {
   const res = await auditsListEvidence(vanta, {
     auditId: "<id>",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("auditsListEvidence failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -259,7 +248,6 @@ async function run() {
     auditId: "<id>",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -284,15 +272,12 @@ async function run() {
   const res = await auditsListComments(vanta, {
     auditId: "<id>",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("auditsListComments failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -335,7 +320,6 @@ async function run() {
     auditId: "<id>",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -360,15 +344,12 @@ async function run() {
   const res = await auditsListControls(vanta, {
     auditId: "<id>",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("auditsListControls failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -412,12 +393,11 @@ async function run() {
     auditEvidenceId: "<id>",
     addCommentInput: {
       text: "<value>",
-      email: "Earnestine28@yahoo.com",
-      creationDate: new Date("2024-11-28T04:59:12.710Z"),
+      email: "Carmen.Bogan@yahoo.com",
+      creationDate: new Date("2024-05-28T11:04:29.369Z"),
     },
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -444,19 +424,16 @@ async function run() {
     auditEvidenceId: "<id>",
     addCommentInput: {
       text: "<value>",
-      email: "Earnestine28@yahoo.com",
-      creationDate: new Date("2024-11-28T04:59:12.710Z"),
+      email: "Carmen.Bogan@yahoo.com",
+      creationDate: new Date("2024-05-28T11:04:29.369Z"),
     },
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("auditsCreateCommentForEvidence failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -501,7 +478,6 @@ async function run() {
     auditEvidenceUpdateInput: {},
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -528,15 +504,12 @@ async function run() {
     auditEvidenceId: "<id>",
     auditEvidenceUpdateInput: {},
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("auditsUpdateEvidence failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -579,17 +552,18 @@ async function run() {
     auditId: "<id>",
     createCustomEvidenceRequestInput: {
       controlIds: [
-        "<value>",
+        "<value 1>",
+        "<value 2>",
       ],
       title: "<value>",
-      description: "now whoa while",
-      cadence: "P3M",
+      description: "pure bludgeon deliberately question although",
+      cadence: "P1D",
       reminderWindow: "P0D",
-      isRestricted: true,
+      isRestricted: false,
+      auditorEmail: "<value>",
     },
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -615,24 +589,23 @@ async function run() {
     auditId: "<id>",
     createCustomEvidenceRequestInput: {
       controlIds: [
-        "<value>",
+        "<value 1>",
+        "<value 2>",
       ],
       title: "<value>",
-      description: "now whoa while",
-      cadence: "P3M",
+      description: "pure bludgeon deliberately question although",
+      cadence: "P1D",
       reminderWindow: "P0D",
-      isRestricted: true,
+      isRestricted: false,
+      auditorEmail: "<value>",
     },
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("auditsCreateCustomEvidenceRequest failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -675,14 +648,13 @@ async function run() {
     auditId: "<id>",
     createCustomControlInput: {
       externalId: "<id>",
-      name: "<value>",
-      description: "even keenly afore mmm yearningly ouch tough yearly intent",
-      effectiveDate: new Date("2024-07-08T11:52:30.590Z"),
-      category: "THREAT_MANAGEMENT",
+      name: null,
+      description: "yet plus utter queasily what juvenile wound",
+      effectiveDate: new Date("2024-11-10T13:58:54.564Z"),
+      category: "CLOUD_SECURITY",
     },
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -708,21 +680,18 @@ async function run() {
     auditId: "<id>",
     createCustomControlInput: {
       externalId: "<id>",
-      name: "<value>",
-      description: "even keenly afore mmm yearningly ouch tough yearly intent",
-      effectiveDate: new Date("2024-07-08T11:52:30.590Z"),
-      category: "THREAT_MANAGEMENT",
+      name: null,
+      description: "yet plus utter queasily what juvenile wound",
+      effectiveDate: new Date("2024-11-10T13:58:54.564Z"),
+      category: "CLOUD_SECURITY",
     },
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("auditsCreateCustomControl failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();

package/examples/README.md

@@ -0,0 +1,31 @@
+# vanta-auditor-api-sdk Examples
+
+This directory contains example scripts demonstrating how to use the vanta-auditor-api-sdk SDK.
+
+## Prerequisites
+
+- Node.js (v18 or higher)
+- npm
+
+## Setup
+
+1. Copy `.env.template` to `.env`:
+   ```bash
+   cp .env.template .env
+   ```
+
+2. Edit `.env` and add your actual credentials (API keys, tokens, etc.)
+
+## Running the Examples
+
+To run an example file from the examples directory:
+
+```bash
+npm run build && npx tsx example.ts
+```
+
+## Creating new examples
+
+Duplicate an existing example file, they won't be overwritten by the generation process.
+
+

package/examples/auditsList.example.ts

@@ -0,0 +1,26 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import dotenv from "dotenv";
+dotenv.config();
+/**
+ * Example usage of the vanta-auditor-api-sdk SDK
+ *
+ * To run this example from the examples directory:
+ * npm run build && npx tsx auditsList.ts
+ */
+
+import { Vanta } from "vanta-auditor-api-sdk";
+
+const vanta = new Vanta({
+  bearerAuth: process.env["VANTA_BEARER_AUTH"] ?? "",
+});
+
+async function main() {
+  const result = await vanta.list({});
+
+  console.log(result);
+}
+
+main().catch(console.error);