import {z} from 'zod' export type ProductAnalyticsJourneyNodeTargetType = 'node'; export type ProductAnalyticsJourneyNodeTarget = {type: ProductAnalyticsJourneyNodeTargetType, value: string}; export type ProductAnalyticsJourneyPathTargetType = 'path'; export type ProductAnalyticsJourneyPathTarget = {end: string, start: string, type: ProductAnalyticsJourneyPathTargetType}; export type ProductAnalyticsJourneyTarget = ProductAnalyticsJourneyNodeTarget | ProductAnalyticsJourneyPathTarget; export type ProductAnalyticsGraphQueryCompute = {aggregation: string, interval?: number | undefined, metric?: string | undefined, target?: ProductAnalyticsJourneyTarget | undefined}; export type QuerySortOrder = 'asc' | 'desc'; export type ProductAnalyticsGroupBySort = {aggregation?: string | undefined, metric?: string | undefined, order?: QuerySortOrder | undefined}; export type ProductAnalyticsGraphQueryGroupBySource = 'product_analytics_audience_filters.users' | 'product_analytics_audience_filters.accounts'; export type ProductAnalyticsGraphQueryGroupBy = {facet: string, limit?: number | undefined, should_exclude_missing?: boolean | undefined, sort?: ProductAnalyticsGroupBySort | undefined, source?: ProductAnalyticsGraphQueryGroupBySource | undefined, target?: ProductAnalyticsJourneyTarget | undefined, value_filters?: Array | undefined}; export type ProductAnalyticsJourneyAudienceAccountQuery = {name: string, query?: string | undefined}; export type ProductAnalyticsJourneyAudienceSegmentQuery = {name: string, segment_id: string}; export type ProductAnalyticsJourneyAudienceUserQuery = {name: string, query?: string | undefined}; export type ProductAnalyticsJourneyAudienceFilters = {accounts?: Array | undefined, formula?: string | undefined, segments?: Array | undefined, users?: Array | undefined}; export type ProductAnalyticsJourneySearchGraphFilterName = '__dd.time_to_convert' | '__dd.session' | '__dd.dropoff_rate'; export type ProductAnalyticsJourneySearchGraphFilterOperator = '=' | '<' | '>' | '<=' | '>='; export type ProductAnalyticsJourneySearchGraphFilter = {name: ProductAnalyticsJourneySearchGraphFilterName, operator: ProductAnalyticsJourneySearchGraphFilterOperator, target?: ProductAnalyticsJourneyTarget | undefined, value: number}; export type ProductAnalyticsJourneySearchFilters = {audience_filters?: ProductAnalyticsJourneyAudienceFilters | undefined, graph_filters?: Array | undefined, string_filter?: string | undefined}; export type ProductAnalyticsJoinKeys = {primary?: string | undefined, secondary?: Array | undefined}; export type ProductAnalyticsEventQueryDataSource = 'product_analytics'; export type ProductAnalyticsEventSearch = {query?: string | undefined}; export type ProductAnalyticsEventQuery = {data_source: ProductAnalyticsEventQueryDataSource, search: ProductAnalyticsEventSearch}; export type ProductAnalyticsOccurrenceQueryDataSource = 'product_analytics_occurrence'; export type ProductAnalyticsOccurrenceFilter = {meta?: {[key: string]: string} | undefined, operator: string, value: string}; export type ProductAnalyticsOccurrenceSearch = {occurrences?: ProductAnalyticsOccurrenceFilter | undefined, query?: string | undefined}; export type ProductAnalyticsOccurrenceQuery = {data_source: ProductAnalyticsOccurrenceQueryDataSource, search: ProductAnalyticsOccurrenceSearch}; export type ProductAnalyticsBaseQuery = ProductAnalyticsEventQuery | ProductAnalyticsOccurrenceQuery; export type ProductAnalyticsJourneySearch = {expression: string, filters?: ProductAnalyticsJourneySearchFilters | undefined, join_keys?: ProductAnalyticsJoinKeys | undefined, node_objects: {[key: string]: ProductAnalyticsBaseQuery}}; export type ProductAnalyticsFormulaJourneyQuery = {compute: ProductAnalyticsGraphQueryCompute, group_by?: Array | undefined, query_id?: string | undefined, search: ProductAnalyticsJourneySearch}; export type ProductAnalyticsFormulaJourneyRequestAttributes = {from: number, interval?: number | undefined, query: ProductAnalyticsFormulaJourneyQuery, to: number}; export type ProductAnalyticsFormulaJourneyRequestType = 'formula_journey_request'; export type ProductAnalyticsFormulaJourneyRequestData = {attributes: ProductAnalyticsFormulaJourneyRequestAttributes, type: ProductAnalyticsFormulaJourneyRequestType}; export type ProductAnalyticsFormulaJourneyRequest = {data: ProductAnalyticsFormulaJourneyRequestData}; export type CreateApiApiV2ProductAnalyticsJourneyTimeseriesArgs = {body: ProductAnalyticsFormulaJourneyRequest}; export type CreateApiApiV2ProductAnalyticsJourneyTimeseriesOptions = {baseUrl?: string | undefined, apiKeyAuth?: string | undefined, appKeyAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const productAnalyticsInterval = z.object({milliseconds: z.number().int().optional(), start_time: z.number().int().optional(), times: z.array(z.number().int()).optional(), type: z.string().optional()}); export const productAnalyticsUnit = z.object({family: z.string().optional(), id: z.number().int().optional(), name: z.string().optional(), plural: z.string().optional(), scale_factor: z.number().optional(), short_name: z.string().optional()}); export const productAnalyticsSerie = z.object({group_tags: z.array(z.string()).optional(), query_index: z.number().int().optional(), unit: z.array(productAnalyticsUnit).optional()}); export const productAnalyticsTimeseriesResponseAttributes = z.object({intervals: z.array(productAnalyticsInterval).optional(), series: z.array(productAnalyticsSerie).optional(), times: z.array(z.number().int()).optional(), values: z.array(z.array(z.number().nullable())).optional()}); export const productAnalyticsJourneyTimeseriesResponseType = z.literal("journey_timeseries_response"); export const productAnalyticsJourneyTimeseriesResponseData = z.object({attributes: productAnalyticsTimeseriesResponseAttributes, id: z.string(), type: productAnalyticsJourneyTimeseriesResponseType}); export const productAnalyticsJourneyTimeseriesResponse = z.object({data: productAnalyticsJourneyTimeseriesResponseData}); 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 }; /** * Compute journey timeseries analytics * * POST /api/v2/product-analytics/journey/timeseries * * Also accepts auth: AuthZ */ export const createApiApiV2ProductAnalyticsJourneyTimeseries = async (args: CreateApiApiV2ProductAnalyticsJourneyTimeseriesArgs, options?: CreateApiApiV2ProductAnalyticsJourneyTimeseriesOptions) => { const {baseUrl = "https://api.datadoghq.com", fetch: fetchFn = fetch, apiKeyAuth, appKeyAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (apiKeyAuth !== undefined) headers.set("DD-API-KEY", apiKeyAuth) if (appKeyAuth !== undefined) headers.set("DD-APPLICATION-KEY", appKeyAuth) const url = `${baseUrl.replace(/\/+$/, '')}/api/v2/product-analytics/journey/timeseries${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(productAnalyticsJourneyTimeseriesResponse, await res.json()) };