import {z} from 'zod' export type GetApiStocksFinancialsV1CashFlowStatementsArgs = {cik?: string | undefined, 'cik.any_of'?: string | undefined, 'cik.gt'?: string | undefined, 'cik.gte'?: string | undefined, 'cik.lt'?: string | undefined, 'cik.lte'?: string | undefined, period_end?: string | undefined, 'period_end.gt'?: string | undefined, 'period_end.gte'?: string | undefined, 'period_end.lt'?: string | undefined, 'period_end.lte'?: string | undefined, filing_date?: string | undefined, 'filing_date.gt'?: string | undefined, 'filing_date.gte'?: string | undefined, 'filing_date.lt'?: string | undefined, 'filing_date.lte'?: string | undefined, tickers?: string | undefined, 'tickers.all_of'?: string | undefined, 'tickers.any_of'?: string | undefined, fiscal_year?: number | undefined, 'fiscal_year.gt'?: number | undefined, 'fiscal_year.gte'?: number | undefined, 'fiscal_year.lt'?: number | undefined, 'fiscal_year.lte'?: number | undefined, fiscal_quarter?: number | undefined, 'fiscal_quarter.gt'?: number | undefined, 'fiscal_quarter.gte'?: number | undefined, 'fiscal_quarter.lt'?: number | undefined, 'fiscal_quarter.lte'?: number | undefined, timeframe?: string | undefined, 'timeframe.any_of'?: string | undefined, 'timeframe.gt'?: string | undefined, 'timeframe.gte'?: string | undefined, 'timeframe.lt'?: string | undefined, 'timeframe.lte'?: string | undefined, limit?: number | undefined, sort?: string | undefined}; export type GetApiStocksFinancialsV1CashFlowStatementsOptions = {baseUrl?: string | undefined, apiKey?: string | undefined, fetch?: typeof fetch | undefined}; export const getApiStocksFinancialsV1CashFlowStatementsResponse = z.object({next_url: z.string().optional(), request_id: z.string(), results: z.array(z.object({cash_from_operating_activities_continuing_operations: z.number().optional(), change_in_cash_and_equivalents: z.number().optional(), change_in_other_operating_assets_and_liabilities_net: z.number().optional(), cik: z.string().optional(), depreciation_depletion_and_amortization: z.number().optional(), dividends: z.number().optional(), effect_of_currency_exchange_rate: z.number().optional(), filing_date: z.string().optional(), fiscal_quarter: z.number().int().optional(), fiscal_year: z.number().int().optional(), income_loss_from_discontinued_operations: z.number().optional(), long_term_debt_issuances_repayments: z.number().optional(), net_cash_from_financing_activities: z.number().optional(), net_cash_from_financing_activities_continuing_operations: z.number().optional(), net_cash_from_financing_activities_discontinued_operations: z.number().optional(), net_cash_from_investing_activities: z.number().optional(), net_cash_from_investing_activities_continuing_operations: z.number().optional(), net_cash_from_investing_activities_discontinued_operations: z.number().optional(), net_cash_from_operating_activities: z.number().optional(), net_cash_from_operating_activities_discontinued_operations: z.number().optional(), net_income: z.number().optional(), noncontrolling_interests: z.number().optional(), other_cash_adjustments: z.number().optional(), other_financing_activities: z.number().optional(), other_investing_activities: z.number().optional(), other_operating_activities: z.number().optional(), period_end: z.string().optional(), purchase_of_property_plant_and_equipment: z.number().optional(), sale_of_property_plant_and_equipment: z.number().optional(), short_term_debt_issuances_repayments: z.number().optional(), tickers: z.array(z.string()).optional(), timeframe: z.string().optional()})), status: z.literal("OK")}); 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 }; /** * A comprehensive financial dataset containing quarterly, annual, and trailing twelve-month cash flow statement data for public companies. Includes detailed operating, investing, and financing cash flows with proper TTM calculations that sum all cash flow components over four quarters. TTM records are validated to ensure exactly four distinct quarters spanning 250-400 days for accurate trailing twelve-month cash flow analysis. * * GET /stocks/financials/v1/cash-flow-statements */ export const getApiStocksFinancialsV1CashFlowStatements = async (args: GetApiStocksFinancialsV1CashFlowStatementsArgs, options?: GetApiStocksFinancialsV1CashFlowStatementsOptions) => { const {baseUrl = "https://api.massive.com", fetch: fetchFn = fetch, apiKey} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.cik != null) query.append("cik", String(args.cik)) if (args['cik.any_of'] != null) query.append("cik.any_of", String(args['cik.any_of'])) if (args['cik.gt'] != null) query.append("cik.gt", String(args['cik.gt'])) if (args['cik.gte'] != null) query.append("cik.gte", String(args['cik.gte'])) if (args['cik.lt'] != null) query.append("cik.lt", String(args['cik.lt'])) if (args['cik.lte'] != null) query.append("cik.lte", String(args['cik.lte'])) if (args.period_end != null) query.append("period_end", String(args.period_end)) if (args['period_end.gt'] != null) query.append("period_end.gt", String(args['period_end.gt'])) if (args['period_end.gte'] != null) query.append("period_end.gte", String(args['period_end.gte'])) if (args['period_end.lt'] != null) query.append("period_end.lt", String(args['period_end.lt'])) if (args['period_end.lte'] != null) query.append("period_end.lte", String(args['period_end.lte'])) if (args.filing_date != null) query.append("filing_date", String(args.filing_date)) if (args['filing_date.gt'] != null) query.append("filing_date.gt", String(args['filing_date.gt'])) if (args['filing_date.gte'] != null) query.append("filing_date.gte", String(args['filing_date.gte'])) if (args['filing_date.lt'] != null) query.append("filing_date.lt", String(args['filing_date.lt'])) if (args['filing_date.lte'] != null) query.append("filing_date.lte", String(args['filing_date.lte'])) if (args.tickers != null) query.append("tickers", String(args.tickers)) if (args['tickers.all_of'] != null) query.append("tickers.all_of", String(args['tickers.all_of'])) if (args['tickers.any_of'] != null) query.append("tickers.any_of", String(args['tickers.any_of'])) if (args.fiscal_year != null) query.append("fiscal_year", String(args.fiscal_year)) if (args['fiscal_year.gt'] != null) query.append("fiscal_year.gt", String(args['fiscal_year.gt'])) if (args['fiscal_year.gte'] != null) query.append("fiscal_year.gte", String(args['fiscal_year.gte'])) if (args['fiscal_year.lt'] != null) query.append("fiscal_year.lt", String(args['fiscal_year.lt'])) if (args['fiscal_year.lte'] != null) query.append("fiscal_year.lte", String(args['fiscal_year.lte'])) if (args.fiscal_quarter != null) query.append("fiscal_quarter", String(args.fiscal_quarter)) if (args['fiscal_quarter.gt'] != null) query.append("fiscal_quarter.gt", String(args['fiscal_quarter.gt'])) if (args['fiscal_quarter.gte'] != null) query.append("fiscal_quarter.gte", String(args['fiscal_quarter.gte'])) if (args['fiscal_quarter.lt'] != null) query.append("fiscal_quarter.lt", String(args['fiscal_quarter.lt'])) if (args['fiscal_quarter.lte'] != null) query.append("fiscal_quarter.lte", String(args['fiscal_quarter.lte'])) if (args.timeframe != null) query.append("timeframe", String(args.timeframe)) if (args['timeframe.any_of'] != null) query.append("timeframe.any_of", String(args['timeframe.any_of'])) if (args['timeframe.gt'] != null) query.append("timeframe.gt", String(args['timeframe.gt'])) if (args['timeframe.gte'] != null) query.append("timeframe.gte", String(args['timeframe.gte'])) if (args['timeframe.lt'] != null) query.append("timeframe.lt", String(args['timeframe.lt'])) if (args['timeframe.lte'] != null) query.append("timeframe.lte", String(args['timeframe.lte'])) if (args.limit != null) query.append("limit", String(args.limit)) if (args.sort != null) query.append("sort", String(args.sort)) if (apiKey !== undefined) query.set("apiKey", apiKey) const url = `${baseUrl.replace(/\/+$/, '')}/stocks/financials/v1/cash-flow-statements${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(getApiStocksFinancialsV1CashFlowStatementsResponse, await res.json()) };