@emeryld/rrroutes-openapi 2.5.7 → 2.5.12

package/README.md

@@ -74,6 +74,12 @@ The docs UI expects serialized leaves from `@emeryld/rrroutes-contract`. Each le
 - `method`, `path`, and `cfg` (summary, description, tags, docsGroup, stability, deprecated, docsMeta, feed)
 - Optional Zod schemas for params/query/body/output; these are introspected into a serializable AST for schema tables.
 
+### Preset CSV format
+
+Presets use `packages/openapi/src/web/v2/utils/presetCsv.ts` for import/export. That module expects the heading
+`presetId,presetName,presetDescription,presetGroupId,presetTags,opStepNumber,opName,opDescription,opMethod,opPath,opEndpointId,opQueryJson,opExtraHeadersJson,opBodyJson`
+and emits the same order when saving CSV, with tags stored as `;`-separated values and JSON cells kept compact.
+
 ## Build / develop
 
 ```sh

package/dist/docs/LeafDocsPage.d.ts

@@ -1,4 +1,14 @@
 import type { ReactElement } from 'react';
+export type DocsThemeConfig = Partial<{
+    bg: string;
+    surface: string;
+    primary: string;
+    secondary: string;
+    success: string;
+    warning: string;
+    error: string;
+    textPrimary: string;
+}>;
 export interface RenderOptions {
     /** CSP nonce applied to data + script tags. */
     cspNonce?: string;
@@ -6,13 +16,19 @@ export interface RenderOptions {
     assetBasePath?: string;
     /** Root path where the docs are mounted (e.g. `/__rrroutes/docs`). Used for client routing. */
     docsBasePath?: string;
+    /**
+     * Optional theme seed overrides passed to the client.
+     * If omitted, the client uses its built-in default docs theme.
+     */
+    theme?: DocsThemeConfig;
 }
 type DocsDocumentProps = {
     assetBase: string;
     docsBase: string;
     cspNonce?: string;
+    theme?: DocsThemeConfig;
 };
-export declare const DocsDocument: ({ assetBase, docsBase, cspNonce, }: DocsDocumentProps) => import("react/jsx-runtime").JSX.Element;
+export declare const DocsDocument: ({ assetBase, docsBase, cspNonce, theme, }: DocsDocumentProps) => import("react/jsx-runtime").JSX.Element;
 export declare function createLeafDocsDocument(options?: RenderOptions): ReactElement;
 export declare function renderLeafDocsHTML(options?: RenderOptions): string;
 export type SerializableHistoryEntry = {

package/dist/index.cjs

@@ -252,13 +252,15 @@ function normalizeDocsBase(base) {
 var DocsDocument = ({
   assetBase,
   docsBase,
-  cspNonce
+  cspNonce,
+  theme
 }) => {
   const cssHref = `${assetBase}/docs.css`;
   const jsSrc = `${assetBase}/docs.js`;
   const configJson = serializeConfig({
     docsBasePath: docsBase,
-    cspNonce
+    cspNonce,
+    theme
   });
   return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("html", { lang: "en", children: [
     /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("head", { children: [
@@ -293,7 +295,8 @@ function createLeafDocsDocument(options = {}) {
     {
       assetBase,
       docsBase,
-      cspNonce: options.cspNonce
+      cspNonce: options.cspNonce,
+      theme: options.theme
     }
   );
 }
@@ -456,7 +459,7 @@ function applyDocsSecurityHeaders(res) {
 }
 
 // src/web/v2/types/types.ts
-var import_rrroutes_contract8 = require("@emeryld/rrroutes-contract");
+var import_rrroutes_contract9 = require("@emeryld/rrroutes-contract");
 
 // src/web/v2/types/types.cacheLog.ts
 var import_rrroutes_contract2 = require("@emeryld/rrroutes-contract");
@@ -498,16 +501,23 @@ var feedMeta = import_zod.default.object({
 // src/web/v2/types/types.cacheLog.ts
 var CACHE_OPERATIONS = ["hit", "miss", "set", "delete"];
 var operationEnum = import_zod2.default.enum(CACHE_OPERATIONS);
-var cacheLogSchema = baseEntitySchema.extend({
+var cacheTraceSchema = import_zod2.default.object({
+  id: import_zod2.default.string(),
+  timestamp: import_zod2.default.number(),
   operation: operationEnum,
-  // on hit, value = value retrieved
-  // on miss, value = null
-  // on set, value = value set
-  // on delete, value = value deleted
+  key: import_zod2.default.string(),
+  size: import_zod2.default.number().optional(),
+  durationMs: import_zod2.default.number().optional(),
+  groupId: import_zod2.default.string().optional(),
+  type: import_zod2.default.string().optional()
+  // 'redis', 'dataloader', etc.
+});
+var cacheTraceQuerySchema = baseQuerySchema;
+var cacheLogSchema = baseEntitySchema.extend({
   value: import_zod2.default.any().nullable(),
   size: import_zod2.default.number().optional(),
-  // End-to-end latency for this cache operation in milliseconds.
-  durationMs: import_zod2.default.number().optional()
+  setAt: import_zod2.default.number().optional(),
+  ttlMs: import_zod2.default.number().optional()
 });
 var cacheLogQuerySchema = baseQuerySchema.extend({
   operationsInclude: operationEnum.array().optional(),
@@ -603,6 +613,13 @@ var cacheLeaves = (0, import_rrroutes_contract2.resource)("cache").get({
   outputMetaSchema: feedMeta,
   queryExtensionSchema: paginationSchema
 }).sub(
+  (0, import_rrroutes_contract2.resource)(":cacheKey", {}, import_zod2.default.string()).get({
+    feed: true,
+    outputSchema: cacheTraceSchema.array(),
+    queryExtensionSchema: paginationSchema,
+    querySchema: cacheTraceQuerySchema,
+    outputMetaSchema: feedMeta
+  }).done(),
   (0, import_rrroutes_contract2.resource)("insights").get({
     outputSchema: cacheInsightsSchema,
     querySchema: cacheInsightsQuerySchema
@@ -624,14 +641,7 @@ var import_zod4 = __toESM(require("zod"), 1);
 // src/web/v2/types/types.log.ts
 var import_rrroutes_contract3 = require("@emeryld/rrroutes-contract");
 var import_zod3 = __toESM(require("zod"), 1);
-var LOG_LEVELS = [
-  "info",
-  "warning",
-  "error",
-  "debug",
-  "trace"
-];
-var levelSchema = import_zod3.default.enum(LOG_LEVELS);
+var levelSchema = import_zod3.default.string();
 var logSchema = baseEntitySchema.extend({
   level: levelSchema,
   meta: import_zod3.default.any().optional()
@@ -644,7 +654,9 @@ var logLeaves = (0, import_rrroutes_contract3.resource)("logs").get({
   feed: true,
   outputSchema: logSchema.array(),
   querySchema: logQuerySchema,
-  outputMetaSchema: feedMeta,
+  outputMetaSchema: feedMeta.extend({
+    levels: levelSchema.array().optional()
+  }),
   queryExtensionSchema: paginationSchema
 }).done();
 
@@ -662,7 +674,9 @@ var requestSchema = baseEntitySchema.extend({
   error: import_zod4.default.string().optional(),
   durationMs: import_zod4.default.number(),
   ip: import_zod4.default.string().optional(),
-  userAgent: import_zod4.default.string().optional()
+  userAgent: import_zod4.default.string().optional(),
+  requestSize: import_zod4.default.number().optional(),
+  responseSize: import_zod4.default.number().optional()
 });
 var requestQuerySchema = baseQuerySchema.extend({
   methodsInclude: methodSchema.array().optional(),
@@ -685,7 +699,7 @@ var requestLogLeaves = (0, import_rrroutes_contract4.resource)("requests").get({
       // Related by groupId
       // Do I just use the existing feed endpoints with filter: groupId=?
       logs: import_zod4.default.array(logSchema),
-      caches: import_zod4.default.array(cacheLogSchema)
+      caches: import_zod4.default.array(cacheTraceSchema)
     })
   }).done()
 ).done();
@@ -820,10 +834,42 @@ var presetLeaves = (0, import_rrroutes_contract6.resource)("presets").get({
   outputSchema: presetSchema
 }).done();
 
-// src/web/v2/types/types.socket.ts
+// src/web/v2/types/types.scheduling.ts
 var import_rrroutes_contract7 = require("@emeryld/rrroutes-contract");
 var import_zod7 = __toESM(require("zod"), 1);
-var socketEventDirectionSchema = import_zod7.default.enum([
+var schedulingSchema = baseEntitySchema.extend({
+  scheduledAt: import_zod7.default.number().optional(),
+  startedAt: import_zod7.default.number().optional(),
+  completedAt: import_zod7.default.number().optional(),
+  status: import_zod7.default.string()
+});
+var schedulingQuerySchema = baseQuerySchema.extend({
+  status: import_zod7.default.string().array().optional()
+});
+var schedulableHandler = import_zod7.default.object({
+  name: import_zod7.default.string(),
+  payload: import_zod7.default.string()
+});
+var schedulingLeaves = (0, import_rrroutes_contract7.resource)("schedulings").get({
+  feed: true,
+  outputSchema: schedulingSchema.array(),
+  querySchema: schedulingQuerySchema,
+  outputMetaSchema: feedMeta,
+  queryExtensionSchema: paginationSchema
+}).sub(
+  (0, import_rrroutes_contract7.resource)("handlers").get({
+    feed: true,
+    outputSchema: schedulableHandler.array(),
+    querySchema: import_zod7.default.object({ name: import_zod7.default.string().optional() }),
+    outputMetaSchema: feedMeta,
+    queryExtensionSchema: paginationSchema
+  }).done()
+).done();
+
+// src/web/v2/types/types.socket.ts
+var import_rrroutes_contract8 = require("@emeryld/rrroutes-contract");
+var import_zod8 = __toESM(require("zod"), 1);
+var socketEventDirectionSchema = import_zod8.default.enum([
   "incoming",
   // client -> server
   "outgoing",
@@ -833,37 +879,37 @@ var socketEventDirectionSchema = import_zod7.default.enum([
 ]);
 var socketEventSchema = baseEntitySchema.extend({
   // event name
-  name: import_zod7.default.string(),
+  name: import_zod8.default.string(),
   // arbitrary payload
-  message: import_zod7.default.any().optional(),
+  message: import_zod8.default.any().optional(),
   // "server" or socket id
-  origin: import_zod7.default.union([import_zod7.default.literal("server"), import_zod7.default.string()]),
+  origin: import_zod8.default.union([import_zod8.default.literal("server"), import_zod8.default.string()]),
   // "incoming" | "outgoing" | "broadcast"
-  direction: import_zod7.default.enum(["incoming", "outgoing", "broadcast"]),
+  direction: import_zod8.default.enum(["incoming", "outgoing", "broadcast"]),
   // for incoming/outgoing direct events
-  socketId: import_zod7.default.string().optional(),
+  socketId: import_zod8.default.string().optional(),
   // for broadcast events
-  rooms: import_zod7.default.array(import_zod7.default.string()).optional(),
-  except: import_zod7.default.array(import_zod7.default.string()).optional()
+  rooms: import_zod8.default.array(import_zod8.default.string()).optional(),
+  except: import_zod8.default.array(import_zod8.default.string()).optional()
 });
 var socketEventQuerySchema = baseQuerySchema.extend({
   // Exact event name match (single value for now)
-  eventName: import_zod7.default.string().optional(),
-  roomsInclude: import_zod7.default.array(import_zod7.default.string()).optional(),
-  roomsExclude: import_zod7.default.array(import_zod7.default.string()).optional()
+  eventName: import_zod8.default.string().optional(),
+  roomsInclude: import_zod8.default.array(import_zod8.default.string()).optional(),
+  roomsExclude: import_zod8.default.array(import_zod8.default.string()).optional()
 });
-var socketEmitSchema = import_zod7.default.object({
-  eventName: import_zod7.default.string(),
+var socketEmitSchema = import_zod8.default.object({
+  eventName: import_zod8.default.string(),
   // JSON payload for the event
-  message: import_zod7.default.json().optional(),
+  message: import_zod8.default.json().optional(),
   // Target room IDs. Use null for broadcast.
-  toRoomId: import_zod7.default.array(import_zod7.default.string()).nullable()
+  toRoomId: import_zod8.default.array(import_zod8.default.string()).nullable()
 });
-var socketEmitResultSchema = import_zod7.default.object({
-  success: import_zod7.default.boolean(),
-  eventId: import_zod7.default.string().optional()
+var socketEmitResultSchema = import_zod8.default.object({
+  success: import_zod8.default.boolean(),
+  eventId: import_zod8.default.string().optional()
 });
-var socketLeaves = (0, import_rrroutes_contract7.resource)("sockets").get({
+var socketLeaves = (0, import_rrroutes_contract8.resource)("sockets").get({
   feed: true,
   outputSchema: socketEventSchema.array(),
   querySchema: socketEventQuerySchema,
@@ -875,17 +921,18 @@ var socketLeaves = (0, import_rrroutes_contract7.resource)("sockets").get({
 }).done();
 
 // src/web/v2/types/types.ts
-var allLeaves = (0, import_rrroutes_contract8.resource)().sub(
-  (0, import_rrroutes_contract8.resource)("/__rrroutes").sub(
+var allLeaves = (0, import_rrroutes_contract9.resource)().sub(
+  (0, import_rrroutes_contract9.resource)("/__rrroutes").sub(
     endpointLeaves,
     requestLogLeaves,
     logLeaves,
     cacheLeaves,
     presetLeaves,
-    socketLeaves
+    socketLeaves,
+    schedulingLeaves
   ).done()
 ).done();
-var leaves = (0, import_rrroutes_contract8.finalize)(allLeaves);
+var leaves = (0, import_rrroutes_contract9.finalize)(allLeaves);
 
 // src/index.ts
 function resolvePublicDir() {
@@ -898,7 +945,8 @@ function resolvePublicDir() {
 }
 function mountRRRoutesDocs({
   router,
-  auth = {}
+  auth = {},
+  theme
 }) {
   const docsPath = "/__rrroutes/docs";
   const publicDir = resolvePublicDir();
@@ -926,8 +974,9 @@ function mountRRRoutesDocs({
     const nonce = cspEnabled ? (0, import_crypto.randomBytes)(16).toString("base64") : void 0;
     const html = renderLeafDocsHTML2({
       cspNonce: nonce,
-      assetBasePath: `${`${docsPath}/assets`}`,
-      docsBasePath: `${docsPath}`
+      assetBasePath: `${docsPath}/assets`,
+      docsBasePath: `${docsPath}`,
+      theme
     });
     applyDocsSecurityHeaders(res);
     if (cspEnabled && nonce) {