@emeryld/rrroutes-openapi 2.5.7 → 2.5.12

package/dist/web/v2/types/types.scheduling.d.ts

@@ -0,0 +1,423 @@
+import z from 'zod';
+export declare const schedulingSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    groupId: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    createdAt: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+    scheduledAt: z.ZodOptional<z.ZodNumber>;
+    startedAt: z.ZodOptional<z.ZodNumber>;
+    completedAt: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodString;
+}, z.core.$strip>;
+export declare const schedulingQuerySchema: z.ZodObject<{
+    beforeDate: z.ZodOptional<z.ZodString>;
+    afterDate: z.ZodOptional<z.ZodString>;
+    orderBy: z.ZodOptional<z.ZodEnum<{
+        timestamp: "timestamp";
+        duration: "duration";
+        level: "level";
+        path: "path";
+    }>>;
+    orderDirection: z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+    searchQuery: z.ZodOptional<z.ZodString>;
+    groupsInclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    groupsExclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tagsInclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tagsExclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    status: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type SchedulingType = z.infer<typeof schedulingSchema>;
+export type SchedulingFilter = z.infer<typeof schedulingQuerySchema>;
+export declare const schedulableHandler: z.ZodObject<{
+    name: z.ZodString;
+    payload: z.ZodString;
+}, z.core.$strip>;
+export type SchedulableHandlerType = z.infer<typeof schedulableHandler>;
+export declare const schedulingLeaves: readonly [{
+    readonly method: "get";
+    readonly path: "schedulings";
+    readonly cfg: Readonly<import("@emeryld/rrroutes-contract").Prettify<Omit<{}, "queryExtensionSchema" | "outputMetaSchema" | "bodySchema" | "querySchema" | "paramsSchema" | "outputSchema" | Exclude<keyof (import("@emeryld/rrroutes-contract").Prettify<Omit<C, "queryExtensionSchema" | "outputMetaSchema"> & {
+        queryExtensionSchema: C["queryExtensionSchema"] extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>> ? C["queryExtensionSchema"] : undefined;
+        outputMetaSchema: C["outputMetaSchema"] extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>> ? C["outputMetaSchema"] : undefined;
+    }> extends infer WithDefaults extends import("@emeryld/rrroutes-contract").MethodCfg ? import("@emeryld/rrroutes-contract").Prettify<import("@emeryld/rrroutes-contract").Prettify<Omit<Omit<import("@emeryld/rrroutes-contract").MethodCfg, "querySchema" | "outputSchema" | "feed">, Exclude<keyof WithDefaults, "querySchema" | "outputSchema" | "feed">> & Omit<WithDefaults, "querySchema" | "outputSchema" | "feed">> & (WithDefaults["feed"] extends true ? (WithDefaults["feed"] extends true ? {
+        feed: true;
+    } : {
+        feed?: boolean;
+    }) & import("@emeryld/rrroutes-contract").FeedQueryField<WithDefaults> & import("@emeryld/rrroutes-contract").OutputField<WithDefaults> & (WithDefaults["paramsSchema"] extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>> ? {
+        paramsSchema: WithDefaults["paramsSchema"];
+    } : {
+        paramsSchema: undefined;
+    }) : (WithDefaults["feed"] extends true ? {
+        feed: true;
+    } : {
+        feed?: boolean;
+    }) & (WithDefaults["querySchema"] extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>> ? {
+        querySchema: WithDefaults["querySchema"];
+    } : {
+        querySchema?: undefined;
+    }) & import("@emeryld/rrroutes-contract").OutputField<WithDefaults> & (WithDefaults["paramsSchema"] extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>> ? {
+        paramsSchema: WithDefaults["paramsSchema"];
+    } : {
+        paramsSchema: undefined;
+    }))> : never), "outputMetaSchema" | "bodySchema" | "querySchema" | "paramsSchema" | "outputSchema">> & import("@emeryld/rrroutes-contract").Prettify<Omit<import("@emeryld/rrroutes-contract").Prettify<import("@emeryld/rrroutes-contract").Prettify<Omit<Omit<import("@emeryld/rrroutes-contract").MethodCfg, "querySchema" | "outputSchema" | "feed">, "queryExtensionSchema" | "outputMetaSchema"> & Omit<import("@emeryld/rrroutes-contract").Prettify<Omit<{
+        feed: true;
+        outputSchema: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            groupId: z.ZodOptional<z.ZodString>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            createdAt: z.ZodNumber;
+            updatedAt: z.ZodNumber;
+            scheduledAt: z.ZodOptional<z.ZodNumber>;
+            startedAt: z.ZodOptional<z.ZodNumber>;
+            completedAt: z.ZodOptional<z.ZodNumber>;
+            status: z.ZodString;
+        }, z.core.$strip>>;
+        querySchema: z.ZodObject<{
+            beforeDate: z.ZodOptional<z.ZodString>;
+            afterDate: z.ZodOptional<z.ZodString>;
+            orderBy: z.ZodOptional<z.ZodEnum<{
+                timestamp: "timestamp";
+                duration: "duration";
+                level: "level";
+                path: "path";
+            }>>;
+            orderDirection: z.ZodOptional<z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>>;
+            searchQuery: z.ZodOptional<z.ZodString>;
+            groupsInclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            groupsExclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            tagsInclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            tagsExclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            status: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+        outputMetaSchema: z.ZodObject<{
+            totalCount: z.ZodOptional<z.ZodNumber>;
+            nextCursor: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        queryExtensionSchema: z.ZodObject<{
+            cursor: z.ZodOptional<z.ZodString>;
+            pageSize: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        }, z.core.$strip>;
+    }, "queryExtensionSchema" | "outputMetaSchema"> & {
+        queryExtensionSchema: z.ZodObject<{
+            cursor: z.ZodOptional<z.ZodString>;
+            pageSize: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        }, z.core.$strip>;
+        outputMetaSchema: z.ZodObject<{
+            totalCount: z.ZodOptional<z.ZodNumber>;
+            nextCursor: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    }>, "querySchema" | "outputSchema" | "feed">> & {
+        feed: true;
+    } & import("@emeryld/rrroutes-contract").FeedQueryField<import("@emeryld/rrroutes-contract").Prettify<Omit<{
+        feed: true;
+        outputSchema: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            groupId: z.ZodOptional<z.ZodString>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            createdAt: z.ZodNumber;
+            updatedAt: z.ZodNumber;
+            scheduledAt: z.ZodOptional<z.ZodNumber>;
+            startedAt: z.ZodOptional<z.ZodNumber>;
+            completedAt: z.ZodOptional<z.ZodNumber>;
+            status: z.ZodString;
+        }, z.core.$strip>>;
+        querySchema: z.ZodObject<{
+            beforeDate: z.ZodOptional<z.ZodString>;
+            afterDate: z.ZodOptional<z.ZodString>;
+            orderBy: z.ZodOptional<z.ZodEnum<{
+                timestamp: "timestamp";
+                duration: "duration";
+                level: "level";
+                path: "path";
+            }>>;
+            orderDirection: z.ZodOptional<z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>>;
+            searchQuery: z.ZodOptional<z.ZodString>;
+            groupsInclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            groupsExclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            tagsInclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            tagsExclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            status: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+        outputMetaSchema: z.ZodObject<{
+            totalCount: z.ZodOptional<z.ZodNumber>;
+            nextCursor: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        queryExtensionSchema: z.ZodObject<{
+            cursor: z.ZodOptional<z.ZodString>;
+            pageSize: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        }, z.core.$strip>;
+    }, "queryExtensionSchema" | "outputMetaSchema"> & {
+        queryExtensionSchema: z.ZodObject<{
+            cursor: z.ZodOptional<z.ZodString>;
+            pageSize: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        }, z.core.$strip>;
+        outputMetaSchema: z.ZodObject<{
+            totalCount: z.ZodOptional<z.ZodNumber>;
+            nextCursor: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    }>> & {
+        outputSchema: z.ZodObject<{
+            out: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                groupId: z.ZodOptional<z.ZodString>;
+                tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                createdAt: z.ZodNumber;
+                updatedAt: z.ZodNumber;
+                scheduledAt: z.ZodOptional<z.ZodNumber>;
+                startedAt: z.ZodOptional<z.ZodNumber>;
+                completedAt: z.ZodOptional<z.ZodNumber>;
+                status: z.ZodString;
+            }, z.core.$strip>>;
+            meta: z.ZodObject<{
+                totalCount: z.ZodOptional<z.ZodNumber>;
+                nextCursor: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    } & {
+        paramsSchema: undefined;
+    }>, "outputMetaSchema" | "bodySchema" | "querySchema" | "paramsSchema" | "outputSchema"> & {
+        bodySchema: import("@emeryld/rrroutes-contract").RouteSchema<unknown, unknown> | undefined;
+        querySchema: import("@emeryld/rrroutes-contract").RouteSchema<{
+            beforeDate?: string | undefined;
+            afterDate?: string | undefined;
+            orderBy?: "timestamp" | "duration" | "level" | "path" | undefined;
+            orderDirection?: "asc" | "desc" | undefined;
+            searchQuery?: string | undefined;
+            groupsInclude?: string[] | undefined;
+            groupsExclude?: string[] | undefined;
+            tagsInclude?: string[] | undefined;
+            tagsExclude?: string[] | undefined;
+            status?: string[] | undefined;
+        } & {
+            cursor?: string | undefined;
+            pageSize?: number | undefined;
+        }, {
+            beforeDate?: string | undefined;
+            afterDate?: string | undefined;
+            orderBy?: "timestamp" | "duration" | "level" | "path" | undefined;
+            orderDirection?: "asc" | "desc" | undefined;
+            searchQuery?: string | undefined;
+            groupsInclude?: string[] | undefined;
+            groupsExclude?: string[] | undefined;
+            tagsInclude?: string[] | undefined;
+            tagsExclude?: string[] | undefined;
+            status?: string[] | undefined;
+        } & {
+            cursor?: string | undefined;
+            pageSize?: unknown;
+        }>;
+        paramsSchema: undefined;
+        outputSchema: import("@emeryld/rrroutes-contract").RouteSchema<{
+            out: {
+                id: string;
+                name: string;
+                createdAt: number;
+                updatedAt: number;
+                status: string;
+                description?: string | undefined;
+                groupId?: string | undefined;
+                tags?: string[] | undefined;
+                scheduledAt?: number | undefined;
+                startedAt?: number | undefined;
+                completedAt?: number | undefined;
+            }[];
+            meta: {
+                totalCount?: number | undefined;
+                nextCursor?: string | undefined;
+            };
+        }, {
+            out: {
+                id: string;
+                name: string;
+                createdAt: number;
+                updatedAt: number;
+                status: string;
+                description?: string | undefined;
+                groupId?: string | undefined;
+                tags?: string[] | undefined;
+                scheduledAt?: number | undefined;
+                startedAt?: number | undefined;
+                completedAt?: number | undefined;
+            }[];
+            meta: {
+                totalCount?: number | undefined;
+                nextCursor?: string | undefined;
+            };
+        }>;
+        outputMetaSchema: import("@emeryld/rrroutes-contract").RouteSchema<{
+            totalCount?: number | undefined;
+            nextCursor?: string | undefined;
+        }, {
+            totalCount?: number | undefined;
+            nextCursor?: string | undefined;
+        }>;
+        queryExtensionSchema: import("@emeryld/rrroutes-contract").RouteSchema<{
+            cursor?: string | undefined;
+            pageSize?: number | undefined;
+        }, {
+            cursor?: string | undefined;
+            pageSize?: unknown;
+        }>;
+    }>>>;
+}, {
+    readonly method: "get";
+    readonly path: "schedulings/handlers";
+    readonly cfg: Readonly<import("@emeryld/rrroutes-contract").Prettify<Omit<Readonly<import("@emeryld/rrroutes-contract").Prettify<Omit<{}, "queryExtensionSchema" | "outputMetaSchema" | "bodySchema" | "querySchema" | "paramsSchema" | "outputSchema" | Exclude<keyof (import("@emeryld/rrroutes-contract").Prettify<Omit<C_1, "queryExtensionSchema" | "outputMetaSchema"> & {
+        queryExtensionSchema: C_1["queryExtensionSchema"] extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>> ? C_1["queryExtensionSchema"] : undefined;
+        outputMetaSchema: C_1["outputMetaSchema"] extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>> ? C_1["outputMetaSchema"] : undefined;
+    }> extends infer WithDefaults extends import("@emeryld/rrroutes-contract").MethodCfg ? import("@emeryld/rrroutes-contract").Prettify<import("@emeryld/rrroutes-contract").Prettify<Omit<Omit<import("@emeryld/rrroutes-contract").MethodCfg, "querySchema" | "outputSchema" | "feed">, Exclude<keyof WithDefaults, "querySchema" | "outputSchema" | "feed">> & Omit<WithDefaults, "querySchema" | "outputSchema" | "feed">> & (WithDefaults["feed"] extends true ? (WithDefaults["feed"] extends true ? {
+        feed: true;
+    } : {
+        feed?: boolean;
+    }) & import("@emeryld/rrroutes-contract").FeedQueryField<WithDefaults> & import("@emeryld/rrroutes-contract").OutputField<WithDefaults> & (WithDefaults["paramsSchema"] extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>> ? {
+        paramsSchema: WithDefaults["paramsSchema"];
+    } : {
+        paramsSchema: undefined;
+    }) : (WithDefaults["feed"] extends true ? {
+        feed: true;
+    } : {
+        feed?: boolean;
+    }) & (WithDefaults["querySchema"] extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>> ? {
+        querySchema: WithDefaults["querySchema"];
+    } : {
+        querySchema?: undefined;
+    }) & import("@emeryld/rrroutes-contract").OutputField<WithDefaults> & (WithDefaults["paramsSchema"] extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>> ? {
+        paramsSchema: WithDefaults["paramsSchema"];
+    } : {
+        paramsSchema: undefined;
+    }))> : never), "outputMetaSchema" | "bodySchema" | "querySchema" | "paramsSchema" | "outputSchema">> & import("@emeryld/rrroutes-contract").Prettify<Omit<import("@emeryld/rrroutes-contract").Prettify<import("@emeryld/rrroutes-contract").Prettify<Omit<Omit<import("@emeryld/rrroutes-contract").MethodCfg, "querySchema" | "outputSchema" | "feed">, "queryExtensionSchema" | "outputMetaSchema"> & Omit<import("@emeryld/rrroutes-contract").Prettify<Omit<{
+        feed: true;
+        outputSchema: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            payload: z.ZodString;
+        }, z.core.$strip>>;
+        querySchema: z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        outputMetaSchema: z.ZodObject<{
+            totalCount: z.ZodOptional<z.ZodNumber>;
+            nextCursor: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        queryExtensionSchema: z.ZodObject<{
+            cursor: z.ZodOptional<z.ZodString>;
+            pageSize: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        }, z.core.$strip>;
+    }, "queryExtensionSchema" | "outputMetaSchema"> & {
+        queryExtensionSchema: z.ZodObject<{
+            cursor: z.ZodOptional<z.ZodString>;
+            pageSize: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        }, z.core.$strip>;
+        outputMetaSchema: z.ZodObject<{
+            totalCount: z.ZodOptional<z.ZodNumber>;
+            nextCursor: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    }>, "querySchema" | "outputSchema" | "feed">> & {
+        feed: true;
+    } & import("@emeryld/rrroutes-contract").FeedQueryField<import("@emeryld/rrroutes-contract").Prettify<Omit<{
+        feed: true;
+        outputSchema: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            payload: z.ZodString;
+        }, z.core.$strip>>;
+        querySchema: z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        outputMetaSchema: z.ZodObject<{
+            totalCount: z.ZodOptional<z.ZodNumber>;
+            nextCursor: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        queryExtensionSchema: z.ZodObject<{
+            cursor: z.ZodOptional<z.ZodString>;
+            pageSize: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        }, z.core.$strip>;
+    }, "queryExtensionSchema" | "outputMetaSchema"> & {
+        queryExtensionSchema: z.ZodObject<{
+            cursor: z.ZodOptional<z.ZodString>;
+            pageSize: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        }, z.core.$strip>;
+        outputMetaSchema: z.ZodObject<{
+            totalCount: z.ZodOptional<z.ZodNumber>;
+            nextCursor: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    }>> & {
+        outputSchema: z.ZodObject<{
+            out: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                payload: z.ZodString;
+            }, z.core.$strip>>;
+            meta: z.ZodObject<{
+                totalCount: z.ZodOptional<z.ZodNumber>;
+                nextCursor: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    } & {
+        paramsSchema: undefined;
+    }>, "outputMetaSchema" | "bodySchema" | "querySchema" | "paramsSchema" | "outputSchema"> & {
+        bodySchema: import("@emeryld/rrroutes-contract").RouteSchema<unknown, unknown> | undefined;
+        querySchema: import("@emeryld/rrroutes-contract").RouteSchema<{
+            name?: string | undefined;
+        } & {
+            cursor?: string | undefined;
+            pageSize?: number | undefined;
+        }, {
+            name?: string | undefined;
+        } & {
+            cursor?: string | undefined;
+            pageSize?: unknown;
+        }>;
+        paramsSchema: undefined;
+        outputSchema: import("@emeryld/rrroutes-contract").RouteSchema<{
+            out: {
+                name: string;
+                payload: string;
+            }[];
+            meta: {
+                totalCount?: number | undefined;
+                nextCursor?: string | undefined;
+            };
+        }, {
+            out: {
+                name: string;
+                payload: string;
+            }[];
+            meta: {
+                totalCount?: number | undefined;
+                nextCursor?: string | undefined;
+            };
+        }>;
+        outputMetaSchema: import("@emeryld/rrroutes-contract").RouteSchema<{
+            totalCount?: number | undefined;
+            nextCursor?: string | undefined;
+        }, {
+            totalCount?: number | undefined;
+            nextCursor?: string | undefined;
+        }>;
+        queryExtensionSchema: import("@emeryld/rrroutes-contract").RouteSchema<{
+            cursor?: string | undefined;
+            pageSize?: number | undefined;
+        }, {
+            cursor?: string | undefined;
+            pageSize?: unknown;
+        }>;
+    }>>>, "paramsSchema"> & {
+        paramsSchema: undefined;
+    }>>;
+}];

package/dist/web/v2/utils/cache/cacheInsightsMappers.d.ts

@@ -0,0 +1,6 @@
+import { CacheKeyInsight, CacheTagInsight } from '../../types/types.cacheLog';
+import type { CacheInsightDatum } from './cacheInsightsMetrics';
+export declare function bytesToKilobytes(bytes: number | null | undefined): number;
+export declare function computeTotalRequests(hits: number | null | undefined, misses: number | null | undefined): number;
+export declare function mapKeyInsightsToChartData(keys: CacheKeyInsight[]): CacheInsightDatum[];
+export declare function mapTagInsightsToChartData(tags: CacheTagInsight[]): CacheInsightDatum[];

package/dist/web/v2/utils/cache/cacheInsightsMetrics.d.ts

@@ -0,0 +1,24 @@
+export type MetricKey = 'sets' | 'totalSizeKB' | 'totalRequests' | 'hitRate' | 'missRate' | 'avgMissDurationMs' | 'hitsSinceLastSet' | 'missesSinceLastSet' | 'deletesSinceLastSet' | 'avgTimeBetweenSetsMs' | 'avgHitsBetweenSets' | 'avgMissesBetweenSets';
+export declare const ALL_METRICS: MetricKey[];
+export declare const METRIC_LABEL: Record<MetricKey, string>;
+export type MetricPresentation = 'percent' | 'sizeKB' | 'durationMs' | 'count';
+export declare function getMetricPresentation(metric: MetricKey): MetricPresentation;
+export type CacheInsightDatum = {
+    id: string;
+    label: string;
+    sets: number;
+    totalSizeKB: number;
+    totalRequests: number;
+    hitRate: number;
+    missRate: number;
+    avgMissDurationMs: number | null;
+    hitsSinceLastSet?: number;
+    missesSinceLastSet?: number;
+    deletesSinceLastSet?: number;
+    avgTimeBetweenSetsMs?: number | null;
+    avgHitsBetweenSets?: number | null;
+    avgMissesBetweenSets?: number | null;
+};
+export declare function getMetricValue(stat: CacheInsightDatum, metric: MetricKey): number;
+export declare function formatYAxisTickValue(value: number, presentation: MetricPresentation): string;
+export declare function formatTooltipValue(value: number, metric: MetricKey, presentation: MetricPresentation): [string | number, string];

package/dist/web/v2/utils/cache/cacheTraceInsights.d.ts

@@ -0,0 +1,35 @@
+import { CacheTraceType } from '../../types/types.cacheLog';
+export type TimelinePoint = {
+    timestamp: number;
+    hits: number;
+    misses: number;
+    sets: number;
+    totalRequests: number;
+    hitRate: number;
+    avgDurationMs: number | null;
+};
+export type SizeTimelinePoint = {
+    timestamp: number;
+    sizeBytes: number;
+};
+export type LatencySummary = {
+    avgDurationMs: number | null;
+    p50DurationMs: number | null;
+    p95DurationMs: number | null;
+};
+export type OperationLatencySummary = {
+    hits: LatencySummary;
+    misses: LatencySummary;
+};
+export declare function buildTimeline(traces: CacheTraceType[], bucketSizeMs: number): TimelinePoint[];
+export declare function buildSizeTimeline(traces: CacheTraceType[]): SizeTimelinePoint[];
+export declare function summarizeTraces(traces: CacheTraceType[]): {
+    totalHits: number;
+    totalMisses: number;
+    totalSets: number;
+    lastHitAt: number | null;
+    lastMissAt: number | null;
+    lastSetAt: number | null;
+};
+export declare function computeLatencyStats(traces: CacheTraceType[]): OperationLatencySummary;
+export declare function formatTimeLabel(value: number | string): string;

package/dist/web/v2/utils/cacheFormat.d.ts

@@ -0,0 +1,7 @@
+export declare function formatSize(bytes?: number | null): string;
+export declare function formatTimestamp(value?: number | null): string;
+export declare function formatIsoDate(value?: number | null): string;
+export declare function formatDurationMs(value?: number | null): string;
+export declare function summarizeJson(value: unknown, maxLen?: number): string;
+export declare function formatJson(value: unknown): string;
+export declare function formatRelative(value?: number | null): string;

package/dist/web/v2/utils/cacheUtils.d.ts

@@ -0,0 +1,2 @@
+export declare function compactQuery<T extends Record<string, unknown>>(query: T): Partial<T>;
+export declare function extractPagedOut<T>(data: unknown): T[];

package/dist/web/v2/utils/colorScale.d.ts

@@ -0,0 +1,14 @@
+type DurationToColorArgs = {
+    deltaMs: number | null | undefined;
+    maxDeltaMs: number;
+    colors: {
+        min: string;
+        max: string;
+    };
+    neutral?: string;
+};
+export declare function clamp01(value: number): number;
+export declare function lerp(a: number, b: number, t: number): number;
+export declare function lerpRgb(color1: string, color2: string, t: number): string;
+export declare function durationToColor({ deltaMs, maxDeltaMs, colors, neutral, }: DurationToColorArgs): string;
+export {};

package/dist/web/v2/utils/downloadTextFile.d.ts

@@ -0,0 +1 @@
+export default function downloadTextFile(filename: string, text: string, mime?: string): void;

package/dist/web/v2/utils/kvRow.d.ts

@@ -1,4 +1,4 @@
-import type { PlaygroundKeyValueRow } from '../stores/playgroundStore.js';
+import type { KeyValueRow } from '../types/types.kvRow.js';
 export declare function makeRowId(): string;
 type CreateRowArgs = {
     id?: string;
@@ -8,8 +8,8 @@ type CreateRowArgs = {
     typeHint?: string;
     description?: string;
 };
-export declare function createKeyValueRow({ id, key, value, enabled, typeHint, description, }?: CreateRowArgs): PlaygroundKeyValueRow;
-export declare function cloneKeyValueRows(rows: PlaygroundKeyValueRow[], { preserveIds }?: {
+export declare function createKeyValueRow({ id, key, value, enabled, typeHint, description, }?: CreateRowArgs): KeyValueRow;
+export declare function cloneKeyValueRows(rows: KeyValueRow[], { preserveIds }?: {
     preserveIds?: boolean;
-}): PlaygroundKeyValueRow[];
+}): KeyValueRow[];
 export {};

package/dist/web/v2/utils/kvRowAdapters.d.ts

@@ -0,0 +1,14 @@
+import type { KeyValueRow } from '../types/types.kvRow.js';
+export declare function recordToRows(input?: Record<string, unknown>): KeyValueRow[];
+export declare function rowsToRecord(rows: KeyValueRow[]): Record<string, string>;
+export declare function stringifyJson(value: unknown): string;
+export declare function parseJsonOrError(raw: string): {
+    value?: undefined;
+    error?: undefined;
+} | {
+    value: any;
+    error?: undefined;
+} | {
+    error: string;
+    value?: undefined;
+};

package/dist/web/v2/utils/presetCsv.d.ts

@@ -0,0 +1,22 @@
+import type { PresetType } from '../types/types.preset.js';
+export declare const COLUMN_ORDER: readonly ["presetId", "presetName", "presetDescription", "presetGroupId", "presetTags", "opStepNumber", "opName", "opDescription", "opMethod", "opPath", "opEndpointId", "opQueryJson", "opExtraHeadersJson", "opBodyJson"];
+export declare const REQUIRED_COLUMNS: readonly ["presetName", "opStepNumber", "opMethod", "opPath"];
+export type ColumnKey = (typeof COLUMN_ORDER)[number];
+/**
+ * CSV column order:
+ * presetId, presetName, presetDescription, presetGroupId, presetTags,
+ * opStepNumber, opName, opDescription, opMethod, opPath, opEndpointId,
+ * opQueryJson, opExtraHeadersJson, opBodyJson
+ *
+ * JSON cells are exported as compact JSON (no whitespace) to keep rows single-line.
+ */
+export declare function presetToCsv(preset: PresetType): string;
+export declare function csvToPreset(csv: string): {
+    preset: PresetType | null;
+    errors: string[];
+};
+export declare function parseTags(cell: string): string[];
+export declare function serializeCell(value: string): string;
+export declare function parseCsv(csv: string): {
+    rows: string[][];
+};

package/dist/web/v2/utils/presetsCsv.d.ts

@@ -0,0 +1,6 @@
+import type { PresetType } from '../types/types.preset.js';
+export declare function presetsToCsv(presets: PresetType[]): string;
+export declare function csvToPresets(csv: string): {
+    presets: PresetType[];
+    errors: string[];
+};

package/dist/web/v2/utils/sizeFormat.d.ts

@@ -0,0 +1,2 @@
+export declare function formatSize(bytes?: number | null): string;
+export default formatSize;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emeryld/rrroutes-openapi",
-  "version": "2.5.7",
+  "version": "2.5.12",
   "private": false,
   "type": "module",
   "main": "dist/index.cjs",
@@ -28,9 +28,9 @@
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "react-router-dom": "^7.10.1",
-    "recharts": "^3.5.1",
+    "recharts": "^3.6.0",
     "socket.io-client": "^4.8.1",
-    "zod": "^4.1.13"
+    "zod": "^4.2.0"
   },
   "peerDependencies": {
     "express": "^5.1.0"

package/dist/web/v2/components/endpoints/PlaygroundRunPanel.d.ts

@@ -1,12 +0,0 @@
-import { ReactNode } from 'react';
-import { PlaygroundInputs } from '../../stores/clientStore.js';
-import { PlaygroundTab } from '../../stores/playgroundStore.js';
-type PlaygroundRunPanelProps = {
-    tab: PlaygroundTab;
-    isRunning: boolean;
-    onRun: () => void;
-    onOpenStandalone?: (inputs: PlaygroundInputs) => void;
-    runButtonSlot?: ReactNode;
-};
-export default function PlaygroundRunPanel({ tab, isRunning, onRun, onOpenStandalone, runButtonSlot, }: PlaygroundRunPanelProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/web/v2/components/endpoints/PlaygroundTopTabs.d.ts

@@ -1,11 +0,0 @@
-import type { PlaygroundTab } from '../../stores/playgroundStore.js';
-type PlaygroundTopTabsProps = {
-    tabs: PlaygroundTab[];
-    activeTabId: string | null;
-    isLoading: boolean;
-    onSelect: (tabId: string) => void;
-    onAdd: () => void;
-    onClose: (tabId: string) => void;
-};
-export default function PlaygroundTopTabs({ tabs, activeTabId, isLoading, onSelect, onAdd, onClose, }: PlaygroundTopTabsProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/web/v2/components/history/RequestTimeline.d.ts

@@ -1,10 +0,0 @@
-import type { CacheLogType } from '../../types/types.cacheLog.js';
-import type { LogType } from '../../types/types.log.js';
-import type { SocketEventType } from '../../types/types.socket.js';
-import { RequestTimelineEvent } from './RequestDetailContent.js';
-export declare function RequestTimeline({ events, onSelectCache, onSelectLog, onSelectSocket, }: {
-    events: RequestTimelineEvent[];
-    onSelectCache?: (cache: CacheLogType) => void;
-    onSelectLog?: (log: LogType) => void;
-    onSelectSocket?: (socket: SocketEventType) => void;
-}): import("react/jsx-runtime").JSX.Element;

package/dist/web/v2/components/logs/cache/CacheInsightsKeySection.d.ts

@@ -1,6 +0,0 @@
-import type { CacheKeyInsight } from '../../../types/types.cacheLog';
-type CacheInsightsKeySectionProps = {
-    keys: CacheKeyInsight[];
-};
-export default function CacheInsightsKeySection({ keys, }: CacheInsightsKeySectionProps): import("react/jsx-runtime").JSX.Element;
-export {};