import {z} from 'zod' export type GetApiOrganizationsOrgIdBillsIdArgs = {orgId: string, id: string, additional?: Array | undefined}; export type GetApiOrganizationsOrgIdBillsIdOptions = {baseUrl?: string | undefined, OAuth2?: string | undefined, fetch?: typeof fetch | undefined}; export const lineItemType = z.enum(["STANDING_CHARGE", "USAGE", "COUNTER_RUNNING_TOTAL_CHARGE", "COUNTER_ADJUSTMENT_DEBIT", "COUNTER_ADJUSTMENT_CREDIT", "USAGE_CREDIT", "MINIMUM_SPEND", "MINIMUM_SPEND_REFUND", "CREDIT_DEDUCTION", "MANUAL_ADJUSTMENT", "CREDIT_MEMO", "DEBIT_MEMO", "COMMITMENT_CONSUMED", "COMMITMENT_FEE", "OVERAGE_SURCHARGE", "OVERAGE_USAGE", "BALANCE_CONSUMED", "BALANCE_FEE", "AD_HOC"]); export const billLineItemPricingBandUsage = z.object({pricingBandId: z.string().optional(), lowerLimit: z.number().optional(), fixedPrice: z.number().optional(), unitSubtotal: z.number().optional(), unitPrice: z.number().optional(), bandUnits: z.number().optional(), bandQuantity: z.number().optional(), bandSubtotal: z.number().optional(), creditTypeId: z.string().optional(), convertedBandSubtotal: z.number().optional()}); export const grantDrawdown = z.object({balanceId: z.string().optional(), quantity: z.number().optional(), units: z.number().optional(), currencyAmount: z.number().optional()}); export const balanceDrawdown = z.object({balanceId: z.string().optional(), units: z.number().optional(), balanceAmount: z.number().optional(), lineItemAmount: z.number().optional(), billAmount: z.number().optional()}); export const commitmentDrawdown = z.object({commitmentId: z.string().optional(), units: z.number().optional(), commitmentAmount: z.number().optional(), lineItemAmount: z.number().optional(), billAmount: z.number().optional()}); export const creditCoverage = z.object({lineItemId: z.string().optional(), units: z.number().optional(), lineItemAmount: z.number().optional(), creditAmount: z.number().optional(), billAmount: z.number().optional()}); export const billLineItem = z.object({id: z.string().optional(), productId: z.string().optional(), productName: z.string().optional(), productCode: z.string().optional(), accountingProductId: z.string().optional(), accountingProductName: z.string().optional(), accountingProductCode: z.string().optional(), aggregationId: z.string().optional(), compoundAggregationId: z.string().optional(), counterId: z.string().optional(), chargeId: z.string().optional(), segment: z.record(z.string(), z.string()).optional(), group: z.record(z.string(), z.string()).optional(), meterId: z.string().optional(), planId: z.string().optional(), planGroupId: z.string().optional(), commitmentId: z.string().optional(), balanceId: z.string().optional(), description: z.string().min(1), quantity: z.number(), units: z.number(), unit: z.string(), subtotal: z.number(), currency: z.string().min(1), conversionRate: z.number(), convertedSubtotal: z.number(), creditTypeId: z.string().optional(), lineItemType: lineItemType, pricingId: z.string().optional(), childAccountId: z.string().optional(), childAccountCode: z.string().optional(), usagePerPricingBand: z.array(billLineItemPricingBandUsage).optional(), servicePeriodStartDate: z.string().optional(), servicePeriodEndDate: z.string().optional(), referencedBillId: z.string().optional(), referencedLineItemId: z.string().optional(), reasonId: z.string().optional(), contractId: z.string().optional(), averageUnitPrice: z.number(), sequenceNumber: z.number().int().optional(), additional: z.record(z.string(), z.unknown()).optional(), grantDrawdowns: z.array(grantDrawdown).optional(), balanceDrawdowns: z.array(balanceDrawdown).optional(), commitmentDrawdowns: z.array(commitmentDrawdown).optional(), creditCoverage: z.array(creditCoverage).optional()}); export const billingFrequency = z.enum(["DAILY", "WEEKLY", "MONTHLY", "ANNUALLY", "AD_HOC", "MIXED"]); export const billStatus = z.enum(["PENDING", "APPROVED"]); export const currencyConversion = z.object({from: z.string().min(1), to: z.string().min(1), multiplier: z.number().gt(0).optional()}); export const billResponse = z.object({lineItems: z.array(billLineItem).optional(), purchaseOrderNumber: z.string().optional(), externalInvoiceReference: z.string().optional(), externalInvoiceDate: z.string().optional(), jsonStatementGenerated: z.boolean().optional(), csvStatementGenerated: z.boolean().optional(), statementStale: z.boolean().optional(), billTotal: z.number().optional(), totalDebits: z.number().optional(), totalCredits: z.number().optional(), sequentialInvoiceNumber: z.string().optional(), dtCreated: z.string().optional(), dtLastModified: z.string().optional(), createdBy: z.string().optional(), lastModifiedBy: z.string().optional(), dtApproved: z.string().optional(), approvedBy: z.string().optional(), dtLocked: z.string().optional(), lockedBy: z.string().optional(), id: z.string(), version: z.number().int().optional(), accountId: z.string().optional(), accountCode: z.string().optional(), startDate: z.string().optional(), endDate: z.string().optional(), startDateTimeUTC: z.string().optional(), endDateTimeUTC: z.string().optional(), billDate: z.string().optional(), dueDate: z.string().optional(), billingFrequency: billingFrequency.optional(), billFrequencyInterval: z.number().int().optional(), timezone: z.string().optional(), currency: z.string().optional(), locked: z.boolean().optional(), createdDate: z.string().optional(), status: billStatus.optional(), billJobId: z.string().optional(), currencyConversions: z.array(currencyConversion).optional(), lastCalculatedDate: z.string().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 }; /** * Retrieve Bill * * GET /organizations/{orgId}/bills/{id} */ export const getApiOrganizationsOrgIdBillsId = async (args: GetApiOrganizationsOrgIdBillsIdArgs, options?: GetApiOrganizationsOrgIdBillsIdOptions) => { const {baseUrl = "https://api.m3ter.com", fetch: fetchFn = fetch, OAuth2} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") for (const item of args.additional ?? []) query.append("additional", String(item)) if (OAuth2 !== undefined) headers.set('authorization', `Bearer ${OAuth2}`) const url = `${baseUrl.replace(/\/+$/, '')}/organizations/${encodeURIComponent(String(args.orgId))}/bills/${encodeURIComponent(String(args.id))}${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(billResponse, await res.json()) };