import {z} from 'zod' export type GetApiTimmiProjectApiV4ProjectsArgs = {organizationId: number, search?: Array | undefined, limit?: number | undefined, page?: number | undefined, 'fields.root'?: 'count' | undefined, code?: string | undefined}; export type GetApiTimmiProjectApiV4ProjectsOptions = {baseUrl?: string | undefined, fetch?: typeof fetch | undefined}; export const currencyId = z.enum(["EUR", "USD", "CAD", "..."]); export const price = z.object({amount: z.number().optional(), currencyId: currencyId.optional()}); export const duration = z.object({iso: z.string().optional(), unit: z.enum(["day", "hour"]).optional()}); export const priceRate = z.object({price: price.optional(), unit: z.enum(["day", "hour"]).optional()}); export const project = z.object({id: z.number().int().gte(1).optional(), name: z.string().max(255), code: z.string().max(255).nullable().optional(), clientId: z.number().int().gte(1), client: z.object({id: z.number().optional(), name: z.string().min(1).optional(), code: z.string().min(1).optional(), externalCode: z.string().nullable().optional()}).optional(), ownerId: z.number().int().gte(1).optional(), owner: z.object({id: z.number().int().gte(1).optional(), firstName: z.string().optional(), lastName: z.string().optional(), picture: z.object({href: z.string().optional()}).optional(), dtContractEnd: z.string().optional(), establishmentId: z.number().int().gte(1).optional()}).nullable().optional(), status: z.enum(["draft", "ongoing", "completed", "cancelled", "suspended", "archived"]).optional(), contractType: z.enum(["nonBillable", "fixedPrice", "timeAndMaterials", "cappedTimeAndMaterials"]).optional(), startsOn: z.string().nullable().optional(), createdAt: z.string().optional(), lastModifiedAt: z.string().optional(), price: price.nullable().optional(), authorizedActions: z.array(z.enum(["canEditAndDelete", "canUpdateStatus"])).optional(), organizationId: z.number().int().gte(1).optional(), description: z.string().nullable().optional(), initialDeliveryDate: z.string().nullable().optional(), revisedDeliveryDate: z.string().nullable().optional(), launchedAt: z.string().nullable().optional(), lastChargedOn: z.string().nullable().optional(), standardRateCardId: z.number().int().gte(1), standardRateCard: z.object({id: z.number().int().gte(1).optional(), name: z.string().optional()}).optional(), initialTimeEstimate: duration.nullable().optional(), revisedTimeEstimate: duration.nullable().optional(), standardRate: priceRate.nullable().optional(), billRate: priceRate.nullable().optional(), initialBudget: price.nullable().optional(), revisedBudget: price.nullable().optional(), discount: price.nullable().optional(), discountRate: z.number().multipleOf(0.1).nullable().optional(), estimatedOverrun: price.nullable().optional(), initialRecoveryRate: z.number().nullable().optional(), estimatedRecoveryRate: z.number().nullable().optional(), totalInvoiced: price.nullable().optional(), risks: z.array(z.object({type: z.enum(["budgetOverRun", "delayedDelivery", "highlyDiscounted"]).optional(), label: z.string().optional()})).optional(), anomalies: z.array(z.object({type: z.enum(["noServices", "missingOwner", "missingClient", "missingName", "missingCode", "missingStandardRateCard", "fixedPriceInvoicingMismatch", "budgetExceeded", "deliveryDateExceeded", "dueInvoiceMilestone"]).optional(), label: z.string().optional()})).optional(), invoicingWarnings: z.array(z.object({type: z.enum(["unapprovedItems", "unconfirmedMilestone", "creditNote"]).optional(), applicableFrom: z.string().optional(), preventsInvoicing: z.boolean().optional(), label: z.string().optional()})).optional()}); export const getApiTimmiProjectApiV4ProjectsResponse = z.object({next: z.string().nullable().optional(), prev: z.string().nullable().optional(), count: z.number().int().gte(0).nullable().optional(), items: z.array(project).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 }; /** * List Projects * * GET /timmi-project/api/v4/projects */ export const getApiTimmiProjectApiV4Projects = async (args: GetApiTimmiProjectApiV4ProjectsArgs, options?: GetApiTimmiProjectApiV4ProjectsOptions) => { const {baseUrl = "https://example.ilucca.net", fetch: fetchFn = fetch} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.organizationId != null) query.append("organizationId", String(args.organizationId)) for (const item of args.search ?? []) query.append("search", String(item)) if (args.limit != null) query.append("limit", String(args.limit)) if (args.page != null) query.append("page", String(args.page)) if (args['fields.root'] != null) query.append("fields.root", String(args['fields.root'])) if (args.code != null) query.append("code", String(args.code)) const url = `${baseUrl.replace(/\/+$/, '')}/timmi-project/api/v4/projects${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(getApiTimmiProjectApiV4ProjectsResponse, await res.json()) };