import {z} from 'zod' export type GetApi10TasksTaskIdArgs = {taskId: number, includeFields?: (Array<'startDateActual' | 'dueDateActual' | 'type' | 'phase' | 'assignees' | 'followers' | 'dependencies' | 'billable' | 'csatEnabled' | 'priority' | 'timeEntryCategory' | 'budgets' | 'taskPrivateNote' | 'parent' | 'externalReferenceId'>) | undefined, includeAllFields?: boolean | undefined}; export type GetApi10TasksTaskIdOptions = {baseUrl?: string | undefined, apiKey?: string | undefined, fetch?: typeof fetch | undefined}; export const taskCreatedByUserPublicAPI = z.object({emailId: z.string().optional(), userId: z.number().int().optional(), firstName: z.string().optional(), lastName: z.string().optional()}); export const projectPublicAPITaskResponseEntity = z.object({projectId: z.number().int().gte(1).optional(), projectName: z.string().optional()}); export const taskStatusPublicResponse = z.object({value: z.number().int().gte(1).optional(), label: z.string().optional()}); export const taskFieldPublicResponseAPIEntity = z.object({fieldId: z.number().int().gte(1).optional(), fieldLabel: z.string().optional(), fieldValue: z.object({}).optional(), fieldValueLabel: z.string().optional()}); export const revenueRecognitionPlanPublicResponse = z.object({budgetId: z.number().int().optional(), budgetName: z.string().optional(), recognisedPercentage: z.number().optional(), recognisedAmount: z.number().optional()}); export const taskPhasePublicLiteAPIResponseEntity = z.object({phaseId: z.number().int().optional(), phaseName: z.string().optional()}); export const taskUserPublicAPI = z.object({emailId: z.string().optional(), userId: z.number().int().optional(), firstName: z.string().optional(), lastName: z.string().optional()}); export const roleResponsePublicAPI = z.object({roleId: z.number().int().optional(), roleName: z.string().optional()}); export const taskPlaceholderPublicAPI = z.object({placeholderId: z.number().int().optional(), placeholderName: z.string().optional(), role: roleResponsePublicAPI.optional()}); export const assigneePublicAPI = z.object({members: z.array(taskUserPublicAPI).optional(), placeholders: z.array(taskPlaceholderPublicAPI).optional()}); export const taskFollowersPublicResponse = z.object({placeholders: z.array(taskPlaceholderPublicAPI).optional(), members: z.array(taskUserPublicAPI).optional()}); export const taskPublicLiteAPIResponseEntity = z.object({taskId: z.number().int().gte(1).optional(), taskName: z.string().optional()}); export const taskPublicTimeEntryCategoryResponse = z.object({categoryId: z.number().int().gte(1).optional(), categoryName: z.string().optional()}); export const taskPublicProjectFinancialsBudgetResponse = z.object({budgetId: z.number().int().gte(1).optional(), budgetName: z.string().optional()}); export const taskPriorityPublicResponse = z.object({value: z.number().int().gte(1).optional(), label: z.string().optional()}); export const taskPublicAPIResponseEntity = z.object({taskId: z.number().int().gte(1).optional(), taskName: z.string().optional(), taskDescription: z.string().optional(), startDate: z.string().optional(), dueDate: z.string().optional(), archived: z.boolean().optional(), effortInMinutes: z.number().int().optional(), progress: z.number().int().optional(), atRisk: z.boolean().optional(), createdAt: z.number().int().optional(), updatedAt: z.number().int().optional(), createdBy: taskCreatedByUserPublicAPI.optional(), updatedBy: taskCreatedByUserPublicAPI.optional(), project: projectPublicAPITaskResponseEntity.optional(), status: taskStatusPublicResponse.optional(), fields: z.array(taskFieldPublicResponseAPIEntity).optional(), revenueRecognitionTask: z.boolean().optional(), revenueRecognitionDetails: z.array(revenueRecognitionPlanPublicResponse).optional(), revRecRecognisedPercentage: z.number().optional(), revRecRecognisedAmount: z.number().optional(), totalAllocatedMins: z.number().int().optional(), startDateActual: z.string().optional(), dueDateActual: z.string().optional(), type: z.enum(["TASK", "MILESTONE"]).optional(), phase: taskPhasePublicLiteAPIResponseEntity.optional(), assignees: assigneePublicAPI.optional(), followers: taskFollowersPublicResponse.optional(), dependencies: z.array(taskPublicLiteAPIResponseEntity).optional(), parent: taskPublicLiteAPIResponseEntity.optional(), externalReferenceId: z.string().optional(), billable: z.boolean().optional(), timeEntryCategory: taskPublicTimeEntryCategoryResponse.optional(), budgets: z.array(taskPublicProjectFinancialsBudgetResponse).optional(), csatEnabled: z.boolean().optional(), priority: taskPriorityPublicResponse.optional(), taskPrivateNote: z.string().optional(), private: z.boolean().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 }; /** * Get task by Id * * GET /1.0/tasks/{taskId} */ export const getApi10TasksTaskId = async (args: GetApi10TasksTaskIdArgs, options?: GetApi10TasksTaskIdOptions) => { const {baseUrl = "https://api.rocketlane.com/api", fetch: fetchFn = fetch, apiKey} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.includeFields != null) query.append("includeFields", args.includeFields.join(',')) if (args.includeAllFields != null) query.append("includeAllFields", String(args.includeAllFields)) if (apiKey !== undefined) headers.set("api-key", apiKey) const url = `${baseUrl.replace(/\/+$/, '')}/1.0/tasks/${encodeURIComponent(String(args.taskId))}${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(taskPublicAPIResponseEntity, await res.json()) };