import {z} from 'zod' export type GetApiIssuesIssueIdArgs = {issueId: string}; export type GetApiIssuesIssueIdOptions = {baseUrl?: string | undefined, bearerAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const actorType = z.enum(["USER", "WORKFLOW_GENERATED"]); export const actor = z.object({actorType: actorType, actorId: z.string()}); export const ownerType = z.enum(["USER", "TEAM"]); export const issueOwner = z.object({ownerType: ownerType, ownerId: z.string()}); export const issueSeverity = z.enum(["CRITICAL", "HIGH", "MEDIUM", "LOW", "NO_SEVERITY"]); export const issueStatus = z.enum(["NOT_STARTED", "IN_PROGRESS", "CLOSED"]); export const sourceType = z.enum(["AUDIT", "AUDIT_EXTERNAL", "INCIDENT", "EXTERNAL_PARTY", "SELF_ASSESSMENT", "OTHER"]); export const source = z.object({sourceType: sourceType, sourceId: z.string().optional()}); export const closedReason = z.enum(["RESOLVED", "DUPLICATE", "ACCEPTED", "OTHER"]); export const closedMetadata = z.object({reason: closedReason, comment: z.string(), closedAt: z.string()}); export const issueCustomField = z.object({label: z.string(), value: z.union([z.string(), z.array(z.string())])}); export const extractIssueTemplateSTANDARDISSUE = z.literal("STANDARD_ISSUE"); export const standardIssueType = z.enum(["AREA_OF_CONCERN", "MAJOR_NONCONFORMITY", "MINOR_NONCONFORMITY", "OPP_FOR_IMPROVEMENT", "EXCEPTION", "PROCESS_FOR_IMPROVEMENT"]); export const standardIssue = z.object({id: z.string(), readableIssueId: z.string(), createdDate: z.string(), createdBy: actor, lastModifiedBy: actor, lastModifiedDate: z.string(), title: z.string(), description: z.string(), owners: z.array(issueOwner), severity: issueSeverity, status: issueStatus, rootCause: z.string().nullable(), correctiveAction: z.string().nullable(), dueDate: z.string().nullable(), source: source.nullable(), controlDomain: z.string().nullable(), closedMetadata: closedMetadata.nullable(), detectedDate: z.string(), mappedControlIds: z.array(z.string()), mappedRiskScenarioIds: z.array(z.string()), mappedPolicyIds: z.array(z.string()), customFields: z.array(issueCustomField), template: extractIssueTemplateSTANDARDISSUE, type: standardIssueType.nullable()}); export const extractIssueTemplateSTANDARDPOAM = z.literal("STANDARD_POAM"); export const standardPOAM = z.object({id: z.string(), readableIssueId: z.string(), createdDate: z.string(), createdBy: actor, lastModifiedBy: actor, lastModifiedDate: z.string(), title: z.string(), description: z.string(), owners: z.array(issueOwner), severity: issueSeverity, status: issueStatus, rootCause: z.string().nullable(), correctiveAction: z.string().nullable(), dueDate: z.string().nullable(), source: source.nullable(), controlDomain: z.string().nullable(), closedMetadata: closedMetadata.nullable(), detectedDate: z.string(), mappedControlIds: z.array(z.string()), mappedRiskScenarioIds: z.array(z.string()), mappedPolicyIds: z.array(z.string()), customFields: z.array(issueCustomField), template: extractIssueTemplateSTANDARDPOAM, requiredResources: z.string().nullable(), systemsDescription: z.string().nullable()}); export const issue = z.union([standardIssue, standardPOAM]); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Get issue by ID * * GET /issues/{issueId} */ export const getApiIssuesIssueId = async (args: GetApiIssuesIssueIdArgs, options?: GetApiIssuesIssueIdOptions) => { const {baseUrl = "https://api.vanta.com", fetch: fetchFn = fetch, bearerAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (bearerAuth !== undefined) headers.set('authorization', `Bearer ${bearerAuth}`) const url = `${baseUrl.replace(/\/+$/, '')}/issues/${encodeURIComponent(String(args.issueId))}${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(issue, await res.json()) };