@emeryld/rrroutes-openapi 2.5.18 → 2.5.21

package/dist/web/v2/hooks/useOptions.d.ts

@@ -0,0 +1,6 @@
+import { Registry } from '../registries/genericRegistry';
+export type SetOption<T, O> = (item: T) => O[] | O | undefined;
+export type OptionKey<O> = (option: O) => string | number;
+export declare function useOptions<T, O>(items: T[], getOption: SetOption<T, O>, optionKey?: OptionKey<O>): O[];
+export declare function useRegistryOptions<T, O>(items: T[], getOption: SetOption<T, O>, registry: Registry<O[]>, optionKey?: OptionKey<O>): O[];
+export declare function getRandomColorFromString(input: string): string;

package/dist/web/v2/hooks/useQueryState.d.ts

@@ -1,7 +1 @@
-type UseQueryStateOptions<T> = {
-    defaultValue: T;
-    serialize?: (value: T) => string | null;
-    deserialize?: (value: string) => T;
-};
-export declare function useQueryState<T>(key: string, options: UseQueryStateOptions<T>): [T, (next: T | ((prev: T) => T)) => void];
-export {};
+export declare function useQueryState<T extends Record<string, any>>(key: string, defaultValue: T): [T, (next: T | ((prev: T) => T)) => void];

package/dist/web/v2/pages/CacheLogsPage.d.ts

@@ -0,0 +1 @@
+export default function CacheLogsPage(): import("react/jsx-runtime").JSX.Element;

package/dist/web/v2/pages/SettingsPage.d.ts

@@ -0,0 +1 @@
+export default function SettingsPage(): import("react/jsx-runtime").JSX.Element;

package/dist/web/v2/registries/genericRegistry.d.ts

@@ -0,0 +1,14 @@
+export type RegistryConfig<T> = {
+    storageKey: string;
+    version?: number;
+    initialState: T;
+    /** Optional migration or validation logic after loading from storage */
+    onLoad?: (stored: T) => T;
+};
+export type Registry<T> = {
+    getState: () => T;
+    setState: (updater: ((prev: T) => T) | T, persistChange?: boolean) => void;
+    subscribe: (listener: () => void) => () => void;
+    useRegistry: <R = T>(selector?: (state: T) => R) => R;
+};
+export declare function createRegistry<T>(config: RegistryConfig<T>): Registry<T>;

package/dist/web/v2/registries/optionRegistries.d.ts

@@ -0,0 +1,12 @@
+export declare const statusRegistry: import("./genericRegistry").Registry<number[]>;
+export declare const endpointRegistry: import("./genericRegistry").Registry<{
+    encodedId: string;
+    path: string;
+    method: string;
+    displayId: string;
+}[]>;
+export declare const levelRegistry: import("./genericRegistry").Registry<{
+    color: string;
+    value: string;
+}[]>;
+export declare const endpointTagRegistry: import("./genericRegistry").Registry<string[]>;

package/dist/web/v2/stores/modalStore.d.ts

@@ -0,0 +1,41 @@
+import { ReactNode } from 'react';
+import type { MethodType } from '../types/types.base.js';
+import type { CacheTraceType } from '../types/types.cacheLog.js';
+import type { LogType } from '../types/types.log.js';
+import type { SocketEventType } from '../types/types.socket.js';
+export type BucketRequestSummary = {
+    id: string;
+    method: MethodType;
+    path: string;
+    status: number;
+    durationMs: number;
+    createdAt: number;
+    requestSize?: number;
+    responseSize?: number;
+};
+export type BucketRequestsPayload = {
+    label: string;
+    requests: BucketRequestSummary[];
+};
+type ModalContextValue = {
+    openRequestDetail: (args: {
+        requestId: string;
+        allowReplay?: boolean;
+    }) => void;
+    openLogGroupDetail: (args: {
+        groupId?: string;
+        baseQuery: Record<string, unknown>;
+        triggerLog?: LogType;
+    }) => void;
+    openSocketEventDetail: (event: SocketEventType) => void;
+    openCacheGroup: (groupId: string) => void;
+    openCacheKeyDetail: (cacheKey: string) => void;
+    openCacheTraceDetail: (trace: CacheTraceType) => void;
+    openBucketRequests: (bucket: BucketRequestsPayload) => void;
+    closeModal: () => void;
+};
+export declare function ModalProvider({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useModal(): ModalContextValue;
+export {};

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

@@ -6,6 +6,7 @@ export declare const cacheLogSchema: 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;
@@ -110,6 +111,7 @@ export declare const cacheLeaves: readonly [{
             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;
@@ -159,6 +161,7 @@ export declare const cacheLeaves: readonly [{
             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;
@@ -206,6 +209,7 @@ export declare const cacheLeaves: readonly [{
                 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;
@@ -263,6 +267,7 @@ export declare const cacheLeaves: readonly [{
                 updatedAt: number;
                 value: any;
                 description?: string | undefined;
+                groupId?: string | undefined;
                 tags?: string[] | undefined;
                 size?: number | undefined;
                 setAt?: number | undefined;
@@ -280,6 +285,7 @@ export declare const cacheLeaves: readonly [{
                 updatedAt: number;
                 value: any;
                 description?: string | undefined;
+                groupId?: string | undefined;
                 tags?: string[] | undefined;
                 size?: number | undefined;
                 setAt?: number | undefined;

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

@@ -31,6 +31,28 @@ export declare const requestSchema: z.ZodObject<{
     responseSize: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type RequestLogType = z.infer<typeof requestSchema>;
+export declare const extraRequestQuery: z.ZodObject<{
+    methodsInclude: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        get: "get";
+        post: "post";
+        put: "put";
+        patch: "patch";
+        delete: "delete";
+    }>>>;
+    methodsExclude: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        get: "get";
+        post: "post";
+        put: "put";
+        patch: "patch";
+        delete: "delete";
+    }>>>;
+    statusesInclude: z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>;
+    statusesExclude: z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>;
+    path: z.ZodOptional<z.ZodString>;
+    endpointKeysInclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    endpointKeysExclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type ExtraRequestQuery = z.infer<typeof extraRequestQuery>;
 export declare const requestQuerySchema: z.ZodObject<{
     beforeDate: z.ZodOptional<z.ZodString>;
     afterDate: z.ZodOptional<z.ZodString>;

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

@@ -2,4 +2,5 @@ export declare function nowIso(): 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 formatDurationFriendly(value?: number | null): string;
 export declare function formatRelative(value?: number | null): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emeryld/rrroutes-openapi",
-  "version": "2.5.18",
+  "version": "2.5.21",
   "private": false,
   "type": "module",
   "main": "dist/index.cjs",
@@ -17,8 +17,8 @@
     "dist"
   ],
   "dependencies": {
-    "@emeryld/rrroutes-client": "^2.5.2",
-    "@emeryld/rrroutes-contract": "^2.5.0",
+    "@emeryld/rrroutes-client": "^2.5.3",
+    "@emeryld/rrroutes-contract": "^2.5.2",
     "@emotion/cache": "^11.14.0",
     "@emotion/react": "^11.14.0",
     "@emotion/styled": "^11.14.1",
@@ -27,10 +27,10 @@
     "@tanstack/react-query": "^5.90.12",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
-    "react-router-dom": "^7.10.1",
+    "react-router-dom": "^7.11.0",
     "recharts": "^3.6.0",
-    "socket.io-client": "^4.8.1",
-    "zod": "^4.2.0"
+    "socket.io-client": "^4.8.3",
+    "zod": "^4.2.1"
   },
   "peerDependencies": {
     "express": "^5.1.0"

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

@@ -1,8 +0,0 @@
-type EndpointVolumeChartProps = {
-    data: {
-        timestamp: number;
-        count: number;
-    }[];
-};
-export default function EndpointVolumeChart({ data, }: EndpointVolumeChartProps): import("react/jsx-runtime").JSX.Element;
-export {};

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

@@ -1,7 +0,0 @@
-import type { RequestLogType } from '../../types/types.requestLog.js';
-type RequestTableProps = {
-    requests: RequestLogType[];
-    onSelect: (request: RequestLogType, index: number) => void;
-};
-export default function RequestTable({ requests, onSelect, }: RequestTableProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/web/v2/components/logs/LogsTable.d.ts

@@ -1,7 +0,0 @@
-import type { LogType } from '../../types/types.log.js';
-type LogsTableProps = {
-    logs: LogType[];
-    onSelect?: (log: LogType) => void;
-};
-export default function LogsTable({ logs, onSelect }: LogsTableProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/web/v2/components/requests/timeline/RequestTimelineEventMiniCard.d.ts

@@ -1,13 +0,0 @@
-import type { CacheTraceType } from '../../../types/types.cacheLog.js';
-import type { LogType } from '../../../types/types.log.js';
-import type { SocketEventType } from '../../../types/types.socket.js';
-import type { RequestTimelineEvent } from './types.js';
-type MiniCardProps = {
-    event: RequestTimelineEvent;
-    onSelectCache?: (cache: CacheTraceType) => void;
-    onSelectLog?: (log: LogType) => void;
-    onSelectSocket?: (socket: SocketEventType) => void;
-    onSelectCacheKey?: (key: string) => void;
-};
-export default function RequestTimelineEventMiniCard({ event, onSelectCache, onSelectLog, onSelectSocket, onSelectCacheKey, }: MiniCardProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/web/v2/components/sockets/SocketEventsTable.d.ts

@@ -1,8 +0,0 @@
-import type { SocketEventType } from '../../types/types.socket.js';
-type SocketEventsTableProps = {
-    events: SocketEventType[];
-    onSelect?: (event: SocketEventType, ordered: SocketEventType[]) => void;
-    onOpenGroup?: (groupId: string, event: SocketEventType) => void;
-};
-export default function SocketEventsTable({ events, onSelect, onOpenGroup, }: SocketEventsTableProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/web/v2/registries/logLevelRegistry.d.ts

@@ -1,27 +0,0 @@
-export type LogLevel = string;
-export type CssColor = string;
-export type SetColorMode = 'set' | 'override';
-export declare const DEFAULT_LEVEL_COLORS: {
-    readonly info: "#42a5f5";
-    readonly warning: "#ffa726";
-    readonly error: "#ef5350";
-    readonly debug: "#ab47bc";
-    readonly trace: "#26a69a";
-};
-/** Non-react snapshot getters (use hooks below if you need reactivity). */
-export declare const getSeenLevels: () => string[];
-export declare const getLevelColor: (level: LogLevel, fallback?: CssColor) => string;
-export declare const getLevelColorMap: () => Readonly<Record<string, CssColor>>;
-/**
- * Tracks levels discovered from the API and persists them.
- * Levels are normalized to lower-case.
- */
-export declare const trackSeenLevels: (levels: Iterable<string>) => void;
-/**
- * Sets (or overrides) the color for a level.
- * - mode="set": only sets if no color exists yet
- * - mode="override": always replaces existing value
- */
-export declare const setLevelColor: (level: LogLevel, color: CssColor, mode?: SetColorMode) => boolean;
-export declare const useSeenLogLevels: () => string[];
-export declare const useLogLevelColor: (level: LogLevel, fallback?: CssColor) => CssColor;