import {z} from 'zod' export type ValidFiltersFields = 'integrationId' | 'eventType' | 'location' | 'assetType' | 'owner'; export type EventQueryParams = {searchText?: string | undefined, startTime?: string | undefined, endTime?: string | undefined, filters?: (Array<{key?: ValidFiltersFields | undefined, values?: Array | undefined}>) | undefined}; export type EventFacetsRequest = Array<{field?: ValidFiltersFields | undefined, size?: number | undefined}>; export type EventQuery = {query?: EventQueryParams | undefined, facets?: EventFacetsRequest | undefined, size?: number | undefined, continuationToken?: string | undefined}; export type CreateApiEventCenterArgs = {body: EventQuery}; export type CreateApiEventCenterOptions = {baseUrl?: string | undefined, fetch?: typeof fetch | undefined}; export const eventType = z.enum(["guardrails_violation", "workspace_run", "mutation", "iac_status", "governance_violation", "vcs_push", "vcs_pull_request", "workflows_run"]); export const mutationCreatedEvent = z.object({mutation_id: z.string().optional(), mutation_type: z.enum(["create", "update", "delete"]).optional(), attributes: z.array(z.object({key: z.string().optional(), value: z.string().optional()})).optional()}); export const guardrailsViolationEvent = z.object({guardrail_id: z.string().optional(), rule_type: z.enum(["cost", "policy", "resource"]).optional(), severity: z.enum(["high", "medium", "low"]).optional(), status: z.enum(["violated", "resolved"]).optional(), violation_timestamp: z.string().optional(), violation_reason: z.string().optional(), workspaceId: z.string().optional()}); export const iaCStatusEvent = z.object({status: z.enum(["drift", "managed", "unmanaged", "ghost"]).optional(), driftDetails: z.array(z.object({path: z.string().optional(), stateValue: z.union([z.string(), z.number(), z.boolean(), z.number()]).optional(), inventoryValue: z.union([z.string(), z.number(), z.boolean(), z.number()]).optional()})).optional()}); export const governanceViolationEvent = z.object({rule_id: z.string().optional()}); export const clickOpsEvent = z.object({event_id: z.string().optional(), event_name: z.string().optional(), region: z.string().optional(), service: z.string().optional(), owner: z.string().optional(), source_ip: z.string().optional(), agent: z.string().optional(), request_params: z.string().optional(), response_elements: z.string().optional(), tls_details: z.string().optional()}); export const vcsPushEvent = z.object({repository: z.string().optional(), branch: z.string().optional(), commit_sha: z.string().optional(), commit_message: z.string().optional(), author: z.string().optional(), author_email: z.string().optional(), pusher: z.string().optional(), commits_count: z.number().int().optional(), before_sha: z.string().optional(), after_sha: z.string().optional()}); export const vcsPullRequestEvent = z.object({repository: z.string().optional(), pull_request_id: z.number().int().optional(), title: z.string().optional(), description: z.string().optional(), source_branch: z.string().optional(), target_branch: z.string().optional(), author: z.string().optional(), status: z.string().optional(), merged_by: z.string().optional(), reviewers: z.array(z.string()).optional(), labels: z.array(z.string()).optional()}); export const event = z.object({id: z.string().optional(), account_id: z.string().optional(), integration_id: z.string().optional(), event_timestamp: z.string().optional(), event_type: eventType.optional(), provider_type: z.string().optional(), asset_id: z.string().optional(), asset_type: z.string().optional(), event: z.union([mutationCreatedEvent, guardrailsViolationEvent, iaCStatusEvent, governanceViolationEvent, clickOpsEvent, vcsPushEvent, vcsPullRequestEvent]).optional()}); export const validFiltersFields = z.enum(["integrationId", "eventType", "location", "assetType", "owner"]); export const facetResponse = z.array(z.object({field: validFiltersFields.optional(), size: z.number().int().optional(), values: z.array(z.object({value: z.string().optional(), count: z.number().int().optional()})).optional()})); export const eventResponse = z.object({events: z.array(event).optional(), facets: facetResponse.optional()}); 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 }; /** * Query events * * POST /event-center */ export const createApiEventCenter = async (args: CreateApiEventCenterArgs, options?: CreateApiEventCenterOptions) => { const {baseUrl = "https://api.firefly.ai/v2", fetch: fetchFn = fetch} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") const url = `${baseUrl.replace(/\/+$/, '')}/event-center${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "POST", headers, body: JSON.stringify(args.body)}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(eventResponse, await res.json()) };