import {z} from 'zod' export type RepositoryID = string; export type RepositorySet = Array; export type DeveloperID = string; export type JIRAStatusCategory = 'To Do' | 'In Progress' | 'Done' | 'No Category'; export type JIRAFilter = {epics?: Array | undefined, labels_include?: Array | undefined, labels_exclude?: Array | undefined, issue_types?: Array | undefined, priorities?: Array | undefined, projects?: Array | undefined, status_categories?: Array | undefined, unmapped?: boolean | undefined}; export type ForSetDevelopers = {repositories: RepositorySet, developers: Array, repogroups?: Array> | undefined, aggregate_devgroups?: Array> | undefined, labels_include?: Array | undefined, labels_exclude?: Array | undefined, jira?: JIRAFilter | undefined}; export type DeveloperMetricID = 'dev-commits-pushed' | 'dev-lines-changed' | 'dev-prs-created' | 'dev-prs-reviewed' | 'dev-prs-merged' | 'dev-releases' | 'dev-reviews' | 'dev-review-approvals' | 'dev-review-rejections' | 'dev-review-neutrals' | 'dev-pr-comments' | 'dev-regular-pr-comments' | 'dev-review-pr-comments' | 'dev-active' | 'dev-active0' | 'dev-worked'; export type TimeZone = number; export type Granularity = string; export type Granularities = Array; export type DeveloperMetricsRequest = {for: Array, metrics: Array, date_from: string, date_to: string, timezone?: TimeZone | undefined, account: number, granularities: Granularities}; export type CreateApiMetricsDevelopersArgs = {body: DeveloperMetricsRequest}; export type CreateApiMetricsDevelopersOptions = {baseUrl: string, bearerAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const repositoryID = z.string(); export const repositorySet = z.array(repositoryID); export const developerID = z.string(); export const jIRAStatusCategory = z.enum(["To Do", "In Progress", "Done", "No Category"]); export const jIRAFilter = z.object({epics: z.array(z.string()).optional(), labels_include: z.array(z.string()).optional(), labels_exclude: z.array(z.string()).optional(), issue_types: z.array(z.string()).optional(), priorities: z.array(z.string()).optional(), projects: z.array(z.string()).optional(), status_categories: z.array(jIRAStatusCategory).optional(), unmapped: z.boolean().optional()}); export const forSetDevelopers = z.object({repositories: repositorySet, developers: z.array(developerID), repogroups: z.array(z.array(z.number().int().gte(0))).optional(), aggregate_devgroups: z.array(z.array(z.number().int().gte(0))).optional(), labels_include: z.array(z.string()).optional(), labels_exclude: z.array(z.string()).optional(), jira: jIRAFilter.optional()}); export const granularity = z.string(); export const timeDuration = z.string(); export const calculatedLinearMetricValues = z.object({date: z.string(), values: z.array(z.union([z.number(), timeDuration, z.object({})])), confidence_mins: z.array(z.union([z.number().nullable(), timeDuration])).optional(), confidence_maxs: z.array(z.union([z.number().nullable(), timeDuration])).optional(), confidence_scores: z.array(z.number().int().nullable()).optional()}); export const calculatedDeveloperMetricsItem = z.object({for: forSetDevelopers, granularity: granularity, values: z.array(z.array(calculatedLinearMetricValues))}); export const developerMetricID = z.enum(["dev-commits-pushed", "dev-lines-changed", "dev-prs-created", "dev-prs-reviewed", "dev-prs-merged", "dev-releases", "dev-reviews", "dev-review-approvals", "dev-review-rejections", "dev-review-neutrals", "dev-pr-comments", "dev-regular-pr-comments", "dev-review-pr-comments", "dev-active", "dev-active0", "dev-worked"]); export const timeZone = z.number().int().gte(-720).lte(780); export const granularities = z.array(granularity); export const calculatedDeveloperMetrics = z.object({calculated: z.array(calculatedDeveloperMetricsItem), metrics: z.array(developerMetricID), date_from: z.string(), date_to: z.string(), timezone: timeZone.optional(), granularities: granularities}); 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 }; /** * Calculate metrics over developer activities. * * POST /metrics/developers * * Also accepts auth: apiKeyAuth */ export const createApiMetricsDevelopers = async (args: CreateApiMetricsDevelopersArgs, options: CreateApiMetricsDevelopersOptions) => { const {baseUrl, fetch: fetchFn = fetch, bearerAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (bearerAuth !== undefined) headers.set('authorization', `Bearer ${bearerAuth}`) const url = `${baseUrl.replace(/\/+$/, '')}/metrics/developers${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(calculatedDeveloperMetrics, await res.json()) };