vanta-auditor-api-sdk 0.4.1 → 0.5.0

package/src/models/components/informationrequestevidence.ts

@@ -0,0 +1,100 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  InformationRequestEvidenceUnion,
+  InformationRequestEvidenceUnion$inboundSchema,
+} from "./informationrequestevidenceunion.js";
+import {
+  InformationRequestSupportedEvidenceType,
+  InformationRequestSupportedEvidenceType$inboundSchema,
+} from "./informationrequestsupportedevidencetype.js";
+
+export type InformationRequestEvidence = {
+  /**
+   * The unique identifier for the evidence within Vanta's system.
+   *
+   * @remarks
+   * Format: ObjectId as a string (e.g., "6890e473dce1da5d8406f5e7").
+   */
+  id: string;
+  evidenceType: InformationRequestSupportedEvidenceType;
+  /**
+   * Timestamp when the evidence was made visible to the auditor.
+   *
+   * @remarks
+   * Null if the customer has not yet shared this evidence with the auditor.
+   * Evidence must be shared before the auditor can review it.
+   * Format: ISO 8601 UTC timestamp.
+   */
+  visibleToAuditorDate?: Date | null | undefined;
+  /**
+   * Timestamp when the evidence was created/uploaded.
+   *
+   * @remarks
+   * Format: ISO 8601 UTC timestamp.
+   */
+  creationDate: Date;
+  /**
+   * Timestamp when the evidence was last modified.
+   *
+   * @remarks
+   * Format: ISO 8601 UTC timestamp.
+   */
+  modificationDate: Date;
+  /**
+   * Timestamp when the evidence was soft-deleted.
+   *
+   * @remarks
+   * Null if the evidence has not been deleted.
+   * Soft deletes retain evidence in the system for audit history while hiding
+   * it from normal operations.
+   * Format: ISO 8601 UTC timestamp.
+   */
+  deletionDate?: Date | null | undefined;
+  /**
+   * Union type representing the different forms of evidence content.
+   *
+   * @remarks
+   * The specific type is determined by the `evidenceType` field in InformationRequestEvidence.
+   */
+  evidence: InformationRequestEvidenceUnion;
+};
+
+/** @internal */
+export const InformationRequestEvidence$inboundSchema: z.ZodType<
+  InformationRequestEvidence,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  evidenceType: InformationRequestSupportedEvidenceType$inboundSchema,
+  visibleToAuditorDate: z.nullable(
+    z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  ).optional(),
+  creationDate: z.string().datetime({ offset: true }).transform(v =>
+    new Date(v)
+  ),
+  modificationDate: z.string().datetime({ offset: true }).transform(v =>
+    new Date(v)
+  ),
+  deletionDate: z.nullable(
+    z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  ).optional(),
+  evidence: InformationRequestEvidenceUnion$inboundSchema,
+});
+
+export function informationRequestEvidenceFromJSON(
+  jsonString: string,
+): SafeParseResult<InformationRequestEvidence, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => InformationRequestEvidence$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'InformationRequestEvidence' from JSON`,
+  );
+}

package/src/models/components/informationrequestevidenceunion.ts

@@ -0,0 +1,73 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import { LinkEvidence, LinkEvidence$inboundSchema } from "./linkevidence.js";
+import {
+  ObservationEvidence,
+  ObservationEvidence$inboundSchema,
+} from "./observationevidence.js";
+import {
+  UploadedDocumentEvidence,
+  UploadedDocumentEvidence$inboundSchema,
+} from "./uploadeddocumentevidence.js";
+import {
+  VantaDocumentEvidence,
+  VantaDocumentEvidence$inboundSchema,
+} from "./vantadocumentevidence.js";
+import {
+  VantaPolicyEvidence,
+  VantaPolicyEvidence$inboundSchema,
+} from "./vantapolicyevidence.js";
+import {
+  VantaTestEvidence,
+  VantaTestEvidence$inboundSchema,
+} from "./vantatestevidence.js";
+import {
+  VantaTestSnapshotEvidence,
+  VantaTestSnapshotEvidence$inboundSchema,
+} from "./vantatestsnapshotevidence.js";
+
+/**
+ * Union type representing the different forms of evidence content.
+ *
+ * @remarks
+ * The specific type is determined by the `evidenceType` field in InformationRequestEvidence.
+ */
+export type InformationRequestEvidenceUnion =
+  | VantaTestEvidence
+  | VantaTestSnapshotEvidence
+  | VantaPolicyEvidence
+  | UploadedDocumentEvidence
+  | VantaDocumentEvidence
+  | LinkEvidence
+  | ObservationEvidence;
+
+/** @internal */
+export const InformationRequestEvidenceUnion$inboundSchema: z.ZodType<
+  InformationRequestEvidenceUnion,
+  z.ZodTypeDef,
+  unknown
+> = z.union([
+  VantaTestEvidence$inboundSchema,
+  VantaTestSnapshotEvidence$inboundSchema,
+  VantaPolicyEvidence$inboundSchema,
+  UploadedDocumentEvidence$inboundSchema,
+  VantaDocumentEvidence$inboundSchema,
+  LinkEvidence$inboundSchema,
+  ObservationEvidence$inboundSchema,
+]);
+
+export function informationRequestEvidenceUnionFromJSON(
+  jsonString: string,
+): SafeParseResult<InformationRequestEvidenceUnion, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => InformationRequestEvidenceUnion$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'InformationRequestEvidenceUnion' from JSON`,
+  );
+}

package/src/models/components/informationrequestsupportedevidencetype.ts

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../../types/enums.js";
+
+export const InformationRequestSupportedEvidenceType = {
+  UploadedDocument: "UPLOADED_DOCUMENT",
+  Observation: "OBSERVATION",
+  Link: "LINK",
+  VantaDocument: "VANTA_DOCUMENT",
+  VantaPolicy: "VANTA_POLICY",
+  VantaTest: "VANTA_TEST",
+  VantaTestSnapshot: "VANTA_TEST_SNAPSHOT",
+} as const;
+export type InformationRequestSupportedEvidenceType = ClosedEnum<
+  typeof InformationRequestSupportedEvidenceType
+>;
+
+/** @internal */
+export const InformationRequestSupportedEvidenceType$inboundSchema:
+  z.ZodNativeEnum<typeof InformationRequestSupportedEvidenceType> = z
+    .nativeEnum(InformationRequestSupportedEvidenceType);
+/** @internal */
+export const InformationRequestSupportedEvidenceType$outboundSchema:
+  z.ZodNativeEnum<typeof InformationRequestSupportedEvidenceType> =
+    InformationRequestSupportedEvidenceType$inboundSchema;

package/src/models/components/informationrequesttype.ts

@@ -0,0 +1,40 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../../types/enums.js";
+
+/**
+ * Type of information request, defining what scope of evidence is needed.
+ *
+ * @remarks
+ *
+ * - POINT_IN_TIME: Evidence for a specific moment (e.g., current state of a policy)
+ * - POPULATION: Evidence covering all items in a category (e.g., all employees)
+ * - SAMPLE: Evidence for a representative sample (e.g., 10 random customer records)
+ */
+export const InformationRequestType = {
+  PointInTime: "POINT_IN_TIME",
+  Population: "POPULATION",
+  Sample: "SAMPLE",
+} as const;
+/**
+ * Type of information request, defining what scope of evidence is needed.
+ *
+ * @remarks
+ *
+ * - POINT_IN_TIME: Evidence for a specific moment (e.g., current state of a policy)
+ * - POPULATION: Evidence covering all items in a category (e.g., all employees)
+ * - SAMPLE: Evidence for a representative sample (e.g., 10 random customer records)
+ */
+export type InformationRequestType = ClosedEnum<typeof InformationRequestType>;
+
+/** @internal */
+export const InformationRequestType$inboundSchema: z.ZodNativeEnum<
+  typeof InformationRequestType
+> = z.nativeEnum(InformationRequestType);
+/** @internal */
+export const InformationRequestType$outboundSchema: z.ZodNativeEnum<
+  typeof InformationRequestType
+> = InformationRequestType$inboundSchema;

package/src/models/components/issuesnapshotitem.ts

@@ -0,0 +1,105 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  IssueStatusTypeForSnapshot,
+  IssueStatusTypeForSnapshot$inboundSchema,
+} from "./issuestatustypeforsnapshot.js";
+
+export type IssueSnapshotItem = {
+  /**
+   * The unique identifier for the snapshot of an issue.
+   *
+   * @remarks
+   *
+   * This is distinct from the issueId, which identifies the underlying issue across snapshots.
+   * The snapshot item ID is unique to this specific snapshot of the issue.
+   */
+  id: string;
+  /**
+   * The issue title
+   */
+  title?: string | undefined;
+  /**
+   * The issue description
+   */
+  description?: string | undefined;
+  /**
+   * The human-readable identifier for the issue.
+   *
+   * @remarks
+   *
+   * This field is unique per-domain, and can be used to correlate
+   * this issue snapshot item to the underlying issue across different snapshots.
+   */
+  readableIssueId: string;
+  /**
+   * The globally unique identifier for the underlying issue across snapshots.
+   *
+   * @remarks
+   *
+   * This field can be used to correlate this snapshot item to the underlying issue across different snapshots.
+   */
+  issueId: string;
+  /**
+   * The identifier for the snapshot this issue item belongs to.
+   */
+  snapshotId: string;
+  /**
+   * The due date for the issue.
+   */
+  dueDate?: Date | null | undefined;
+  status?: IssueStatusTypeForSnapshot | undefined;
+  /**
+   * The date and time when the issue was last modified.
+   */
+  lastModifiedAt?: Date | undefined;
+  /**
+   * The date and time when the issue was created.
+   */
+  createdAt?: Date | undefined;
+  /**
+   * The date and time when the issue was detected.
+   */
+  detectedAt?: Date | undefined;
+};
+
+/** @internal */
+export const IssueSnapshotItem$inboundSchema: z.ZodType<
+  IssueSnapshotItem,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  title: z.string().optional(),
+  description: z.string().optional(),
+  readableIssueId: z.string(),
+  issueId: z.string(),
+  snapshotId: z.string(),
+  dueDate: z.nullable(
+    z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  ).optional(),
+  status: IssueStatusTypeForSnapshot$inboundSchema.optional(),
+  lastModifiedAt: z.string().datetime({ offset: true }).transform(v =>
+    new Date(v)
+  ).optional(),
+  createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v))
+    .optional(),
+  detectedAt: z.string().datetime({ offset: true }).transform(v => new Date(v))
+    .optional(),
+});
+
+export function issueSnapshotItemFromJSON(
+  jsonString: string,
+): SafeParseResult<IssueSnapshotItem, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => IssueSnapshotItem$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'IssueSnapshotItem' from JSON`,
+  );
+}

package/src/models/components/issuesnapshotmetadata.ts

@@ -0,0 +1,50 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type IssueSnapshotMetadata = {
+  /**
+   * The unique identifier for the issue snapshot.
+   */
+  id: string;
+  /**
+   * The title of the snapshot
+   */
+  title?: string | undefined;
+  /**
+   * The description of the snapshot
+   */
+  description?: string | undefined;
+  /**
+   * The date and time when the snapshot was created.
+   */
+  createdAt?: Date | undefined;
+};
+
+/** @internal */
+export const IssueSnapshotMetadata$inboundSchema: z.ZodType<
+  IssueSnapshotMetadata,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  title: z.string().optional(),
+  description: z.string().optional(),
+  createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v))
+    .optional(),
+});
+
+export function issueSnapshotMetadataFromJSON(
+  jsonString: string,
+): SafeParseResult<IssueSnapshotMetadata, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => IssueSnapshotMetadata$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'IssueSnapshotMetadata' from JSON`,
+  );
+}

package/src/models/components/issuestatustypeforsnapshot.ts

@@ -0,0 +1,20 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../../types/enums.js";
+
+export const IssueStatusTypeForSnapshot = {
+  InProgress: "IN_PROGRESS",
+  NotStarted: "NOT_STARTED",
+  Closed: "CLOSED",
+} as const;
+export type IssueStatusTypeForSnapshot = ClosedEnum<
+  typeof IssueStatusTypeForSnapshot
+>;
+
+/** @internal */
+export const IssueStatusTypeForSnapshot$inboundSchema: z.ZodNativeEnum<
+  typeof IssueStatusTypeForSnapshot
+> = z.nativeEnum(IssueStatusTypeForSnapshot);

package/src/models/components/linkevidence.ts

@@ -0,0 +1,47 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * Evidence in the form of a link to external documentation or resources.
+ */
+export type LinkEvidence = {
+  /**
+   * The title or descriptive name for the link.
+   */
+  title: string;
+  /**
+   * Optional description providing additional context about the link.
+   */
+  description?: string | undefined;
+  /**
+   * The URL pointing to the external documentation or resource.
+   */
+  url: string;
+};
+
+/** @internal */
+export const LinkEvidence$inboundSchema: z.ZodType<
+  LinkEvidence,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  title: z.string(),
+  description: z.string().optional(),
+  url: z.string(),
+});
+
+export function linkEvidenceFromJSON(
+  jsonString: string,
+): SafeParseResult<LinkEvidence, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => LinkEvidence$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'LinkEvidence' from JSON`,
+  );
+}

package/src/models/components/observationevidence.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * Evidence in the form of a text observation or note.
+ */
+export type ObservationEvidence = {
+  /**
+   * The text content of the observation.
+   */
+  observationDetails: string;
+};
+
+/** @internal */
+export const ObservationEvidence$inboundSchema: z.ZodType<
+  ObservationEvidence,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  observationDetails: z.string(),
+});
+
+export function observationEvidenceFromJSON(
+  jsonString: string,
+): SafeParseResult<ObservationEvidence, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ObservationEvidence$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ObservationEvidence' from JSON`,
+  );
+}

package/src/models/components/pageinfo.ts

@@ -40,29 +40,7 @@ export const PageInfo$inboundSchema: z.ZodType<
   hasPreviousPage: z.boolean(),
   startCursor: z.nullable(z.string()),
 });
-/** @internal */
-export type PageInfo$Outbound = {
-  endCursor: string | null;
-  hasNextPage: boolean;
-  hasPreviousPage: boolean;
-  startCursor: string | null;
-};
-
-/** @internal */
-export const PageInfo$outboundSchema: z.ZodType<
-  PageInfo$Outbound,
-  z.ZodTypeDef,
-  PageInfo
-> = z.object({
-  endCursor: z.nullable(z.string()),
-  hasNextPage: z.boolean(),
-  hasPreviousPage: z.boolean(),
-  startCursor: z.nullable(z.string()),
-});
 
-export function pageInfoToJSON(pageInfo: PageInfo): string {
-  return JSON.stringify(PageInfo$outboundSchema.parse(pageInfo));
-}
 export function pageInfoFromJSON(
   jsonString: string,
 ): SafeParseResult<PageInfo, SDKValidationError> {

package/src/models/components/paginatedissuesnapshotitemsresponse.ts

@@ -0,0 +1,71 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  IssueSnapshotItem,
+  IssueSnapshotItem$inboundSchema,
+} from "./issuesnapshotitem.js";
+import { PageInfo, PageInfo$inboundSchema } from "./pageinfo.js";
+
+export type PaginatedIssueSnapshotItemsResponseResults = {
+  data: Array<IssueSnapshotItem>;
+  /**
+   * Provides information about the pagination of a dataset.
+   */
+  pageInfo: PageInfo;
+};
+
+export type PaginatedIssueSnapshotItemsResponse = {
+  results: PaginatedIssueSnapshotItemsResponseResults;
+};
+
+/** @internal */
+export const PaginatedIssueSnapshotItemsResponseResults$inboundSchema:
+  z.ZodType<PaginatedIssueSnapshotItemsResponseResults, z.ZodTypeDef, unknown> =
+    z.object({
+      data: z.array(IssueSnapshotItem$inboundSchema),
+      pageInfo: PageInfo$inboundSchema,
+    });
+
+export function paginatedIssueSnapshotItemsResponseResultsFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  PaginatedIssueSnapshotItemsResponseResults,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      PaginatedIssueSnapshotItemsResponseResults$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'PaginatedIssueSnapshotItemsResponseResults' from JSON`,
+  );
+}
+
+/** @internal */
+export const PaginatedIssueSnapshotItemsResponse$inboundSchema: z.ZodType<
+  PaginatedIssueSnapshotItemsResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  results: z.lazy(() =>
+    PaginatedIssueSnapshotItemsResponseResults$inboundSchema
+  ),
+});
+
+export function paginatedIssueSnapshotItemsResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<PaginatedIssueSnapshotItemsResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      PaginatedIssueSnapshotItemsResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PaginatedIssueSnapshotItemsResponse' from JSON`,
+  );
+}

package/src/models/components/paginatedissuesnapshotmetadataresponse.ts

@@ -0,0 +1,74 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  IssueSnapshotMetadata,
+  IssueSnapshotMetadata$inboundSchema,
+} from "./issuesnapshotmetadata.js";
+import { PageInfo, PageInfo$inboundSchema } from "./pageinfo.js";
+
+export type PaginatedIssueSnapshotMetadataResponseResults = {
+  data: Array<IssueSnapshotMetadata>;
+  /**
+   * Provides information about the pagination of a dataset.
+   */
+  pageInfo: PageInfo;
+};
+
+export type PaginatedIssueSnapshotMetadataResponse = {
+  results: PaginatedIssueSnapshotMetadataResponseResults;
+};
+
+/** @internal */
+export const PaginatedIssueSnapshotMetadataResponseResults$inboundSchema:
+  z.ZodType<
+    PaginatedIssueSnapshotMetadataResponseResults,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    data: z.array(IssueSnapshotMetadata$inboundSchema),
+    pageInfo: PageInfo$inboundSchema,
+  });
+
+export function paginatedIssueSnapshotMetadataResponseResultsFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  PaginatedIssueSnapshotMetadataResponseResults,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      PaginatedIssueSnapshotMetadataResponseResults$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'PaginatedIssueSnapshotMetadataResponseResults' from JSON`,
+  );
+}
+
+/** @internal */
+export const PaginatedIssueSnapshotMetadataResponse$inboundSchema: z.ZodType<
+  PaginatedIssueSnapshotMetadataResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  results: z.lazy(() =>
+    PaginatedIssueSnapshotMetadataResponseResults$inboundSchema
+  ),
+});
+
+export function paginatedIssueSnapshotMetadataResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<PaginatedIssueSnapshotMetadataResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      PaginatedIssueSnapshotMetadataResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PaginatedIssueSnapshotMetadataResponse' from JSON`,
+  );
+}