theokit 0.2.0 → 0.2.1

package/dist/{chunk-FRBYJANT.js → chunk-4W447H7M.js}

@@ -8,6 +8,7 @@ import {
 import {
   BATCH_PATH,
   CSP_REPORT_PATH,
+  CsrfReadinessStore,
   TRACE_HEADER,
   applySecurityHeaders,
   createCorsHandler,
@@ -23,13 +24,17 @@ import {
   handleCsrfReadiness,
   loadEnv,
   logRequest,
-  matchRoute,
   resolveTransformer,
-  scanServerActions,
-  scanServerRoutes,
-  scanWebSocketRoutes,
   sendError
-} from "./chunk-OEB3OIYP.js";
+} from "./chunk-OJHO2X7C.js";
+import {
+  matchRoute,
+  scanServerRoutes,
+  scanWebSocketRoutes
+} from "./chunk-2BQYEBCK.js";
+import {
+  scanServerActions
+} from "./chunk-7DHGV77J.js";
 import {
   generateNonce
 } from "./chunk-PB4GR7EP.js";
@@ -612,13 +617,17 @@ function createActionMiddleware(vite, serverDir, options) {
         csrfMode,
         disallowed
       );
-      logRequest({
-        method: req.method ?? "POST",
-        url,
-        status: res.statusCode,
-        duration: Date.now() - start,
-        requestId
-      });
+      logRequest(
+        {
+          method: req.method ?? "POST",
+          url,
+          status: res.statusCode,
+          duration: Date.now() - start,
+          requestId
+        },
+        void 0,
+        req
+      );
     })();
   };
 }
@@ -698,6 +707,35 @@ async function handleBatchInline(req, res, batching, requestId) {
     sendError(res, "BATCH_ERROR", message, 400, void 0, requestId);
   }
 }
+async function runPluginsBeforeRouteMatch(pluginRunner, reqCtx) {
+  const { req, res, requestId, start, url } = reqCtx;
+  try {
+    const hookResult = await pluginRunner.runOnRequest({
+      request: req,
+      response: res,
+      ctx: {},
+      requestId
+    });
+    if (hookResult.shortCircuited) {
+      logRequest(
+        {
+          method: req.method ?? "GET",
+          url,
+          status: res.statusCode,
+          duration: Date.now() - start,
+          requestId
+        },
+        void 0,
+        req
+      );
+      return true;
+    }
+  } catch (err) {
+    sendError(res, "PLUGIN_ERROR", err.message, 500, void 0, requestId);
+    return true;
+  }
+  return false;
+}
 function createApiMiddleware(vite, serverDir, rateLimitConfigOrOptions) {
   const opts = rateLimitConfigOrOptions && "windowMs" in rateLimitConfigOrOptions ? { rateLimitConfig: rateLimitConfigOrOptions } : rateLimitConfigOrOptions ?? {};
   const loadModule = createViteLoader(vite);
@@ -715,7 +753,7 @@ function createApiMiddleware(vite, serverDir, rateLimitConfigOrOptions) {
   const csrfReadinessStore = opts.csrfReadinessStore;
   const servicesProxyPrefixes = opts.servicesProxyPrefixes ?? [];
   return (req, res, next) => {
-    void (async () => {
+    const handle = async () => {
       const url = req.url ?? "";
       if (await handleCspReportIfMatch(req, res, url, { auditLogger, onCspViolation })) {
         return;
@@ -739,6 +777,9 @@ function createApiMiddleware(vite, serverDir, rateLimitConfigOrOptions) {
       if (applyRateLimitOr429(req, res, { rateLimiter, requestId, url, start })) {
         return;
       }
+      if (pluginRunner && await runPluginsBeforeRouteMatch(pluginRunner, { req, res, requestId, start, url })) {
+        return;
+      }
       if (await handleBatchIfMatch(req, res, { url, batching, requestId, start })) {
         return;
       }
@@ -750,13 +791,17 @@ function createApiMiddleware(vite, serverDir, rateLimitConfigOrOptions) {
         const suggestion = findSuggestion(urlPath, routePaths);
         const msg = suggestion ? `API route not found: ${urlPath}. Did you mean: ${suggestion}?` : "API route not found";
         sendError(res, "NOT_FOUND", msg, 404, void 0, requestId);
-        logRequest({
-          method: req.method ?? "GET",
-          url,
-          status: 404,
-          duration: Date.now() - start,
-          requestId
-        });
+        logRequest(
+          {
+            method: req.method ?? "GET",
+            url,
+            status: 404,
+            duration: Date.now() - start,
+            requestId
+          },
+          void 0,
+          req
+        );
         return;
       }
       const method = (req.method ?? "GET").toUpperCase();
@@ -774,8 +819,13 @@ function createApiMiddleware(vite, serverDir, rateLimitConfigOrOptions) {
         csrfMode,
         disallowed
       });
-      logRequest({ method, url, status: res.statusCode, duration: Date.now() - start, requestId });
-    })();
+      logRequest(
+        { method, url, status: res.statusCode, duration: Date.now() - start, requestId },
+        void 0,
+        req
+      );
+    };
+    void handle();
   };
 }
 
@@ -1039,6 +1089,21 @@ var theoConfigSchema = z.object({
    * matching `--target`, `theokit build` emits a cross-reference note.
    */
   adapters: z.array(z.string()).optional(),
+  /**
+   * Extra package names to pre-bundle via Vite's `optimizeDeps.include`.
+   *
+   * Framework auto-includes `@usetheo/ui` and `lucide-react` when present.
+   * Apps adding plugin peer-deps that rely on a runtime `import('<pkg>')`
+   * (dynamic specifier) — e.g. `@theokit/plugin-canvas` consumers
+   * installing `mermaid` for Mermaid SVG rendering — must declare those
+   * here so Vite can resolve the literal in dev mode without
+   * "Failed to resolve module specifier" errors. Production builds use
+   * tsup/esbuild bundling and are not affected.
+   *
+   * Example:
+   *   viteOptimizeDeps: ['mermaid']
+   */
+  viteOptimizeDeps: z.array(z.string()).optional(),
   /**
    * Jobs backend (ADR D3 + T2.1). When configured, every request gets
    * `ctx.queue.enqueue` auto-wired via the outbox lifecycle. Pass a
@@ -1065,7 +1130,33 @@ var theoConfigSchema = z.object({
    * that boot alongside the TheoKit TS app. Empty `services: {}` is the
    * default and preserves Wave 1 behavior.
    */
-  services: servicesConfigSchema
+  services: servicesConfigSchema,
+  /**
+   * G2 — OpenAPI emit (build-time only).
+   *
+   * When present, `theokit build` writes a generated `openapi.json` from
+   * every `defineRoute()` body/query/params Zod schema. `undefined` keeps
+   * the framework backward-compatible (no emit). Pass `openapi: {}` to
+   * opt in with defaults.
+   *
+   * Defaults: spec 3.1.0 · servers `http://localhost:3000` · title
+   * "TheoKit App" · version "0.0.0" · outDir ".theo" (next to dist).
+   *
+   * The env var `THEOKIT_OPENAPI_SERVERS` (CSV of URLs) overrides
+   * `servers[].url` at emit time without rebuilding the config.
+   */
+  openapi: z.object({
+    servers: z.array(
+      z.object({
+        url: z.string().url(),
+        description: z.string().optional()
+      })
+    ).default([{ url: "http://localhost:3000", description: "Local development" }]),
+    specVersion: z.enum(["3.1.0", "3.0.3"]).default("3.1.0"),
+    title: z.string().default("TheoKit App"),
+    version: z.string().default("0.0.0"),
+    outDir: z.string().default(".theo")
+  }).optional()
 }).refine((cfg) => !Object.values(cfg.services).some((s) => s.port === cfg.port), {
   message: "service.port collides with TheoKit web port \u2014 change one of them",
   path: ["services"]
@@ -1164,7 +1255,7 @@ function resolveExportSubpath(pkgRoot, subpath) {
     }
     let target;
     if (typeof exp === "string") target = exp;
-    else if (exp && typeof exp === "object") {
+    else if (typeof exp === "object") {
       const e = exp;
       target = e.import ?? e.default;
     }
@@ -1234,7 +1325,9 @@ var DEFAULT_RESOLVED = {
   disallowed: void 0,
   cors: void 0,
   auditLogger: void 0,
-  devtoolsEnabled: true
+  devtoolsEnabled: true,
+  openapi: void 0,
+  distDir: ".theo"
 };
 async function resolvePluginConfig(projectRoot) {
   try {
@@ -1263,7 +1356,9 @@ async function resolvePluginConfig(projectRoot) {
       disallowed: userConfig.security?.disallowed,
       cors: userConfig.security?.cors,
       auditLogger,
-      devtoolsEnabled: userConfig.devtools !== false
+      devtoolsEnabled: userConfig.devtools !== false,
+      openapi: userConfig.openapi,
+      distDir: userConfig.distDir
     };
   } catch {
     return DEFAULT_RESOLVED;
@@ -1600,9 +1695,7 @@ async function integrateUseTheoUI(cwd, opts) {
   }
   const tailwindPlugins = normalizePluginReturn(tailwindPlugin);
   if (tailwindPlugins === null) {
-    console.warn(
-      `[theokit] @tailwindcss/vite returned unexpected shape. Skipping auto-config.`
-    );
+    console.warn(`[theokit] @tailwindcss/vite returned unexpected shape. Skipping auto-config.`);
     return [];
   }
   const uiPlugins = normalizePluginReturn(uiPlugin);
@@ -1876,7 +1969,42 @@ async function theoPluginAsync(rootOrOptions) {
       })
     );
   }
-  return [theoPlugin(rootOrOptions), ...uiPlugins, ...servicesPlugins];
+  const { appTypedClientPlugin } = await import("./app-typed-client-6PAT6VOL.js");
+  const appClientPlugin = appTypedClientPlugin({
+    cwd: projectRoot,
+    serverDir: resolve6(projectRoot, "server"),
+    distDir: resolve6(projectRoot, ".theo")
+  });
+  const { actionsVirtualModule } = await import("./actions-virtual-module-E7IELVHL.js");
+  const actionsPlugin = actionsVirtualModule({
+    serverDir: resolve6(projectRoot, "server"),
+    distDir: resolve6(projectRoot, ".theo")
+  });
+  return [
+    theoPlugin(rootOrOptions),
+    ...uiPlugins,
+    ...servicesPlugins,
+    appClientPlugin,
+    actionsPlugin
+  ];
+}
+function buildOptimizeDepsInclude(projectRoot, viteOptimizeDeps) {
+  const include = [];
+  if (existsSync7(resolve6(projectRoot, "node_modules", "@usetheo", "ui"))) {
+    include.push("@usetheo/ui");
+  }
+  if (existsSync7(resolve6(projectRoot, "node_modules", "lucide-react"))) {
+    include.push("lucide-react");
+  }
+  include.push("devalue");
+  if (Array.isArray(viteOptimizeDeps)) {
+    for (const pkg of viteOptimizeDeps) {
+      if (typeof pkg === "string" && pkg.length > 0 && !include.includes(pkg)) {
+        include.push(pkg);
+      }
+    }
+  }
+  return include;
 }
 function theoPlugin(rootOrOptions) {
   const options = typeof rootOrOptions === "string" ? { root: rootOrOptions } : rootOrOptions ?? {};
@@ -1895,6 +2023,8 @@ function theoPlugin(rootOrOptions) {
   let cors;
   let auditLogger;
   let devtoolsEnabled = true;
+  let resolvedOpenApi;
+  let resolvedDistDir = ".theo";
   let isDevMode = false;
   let configLoadedOnce = false;
   return {
@@ -1913,6 +2043,8 @@ function theoPlugin(rootOrOptions) {
       cors = resolved.cors;
       auditLogger = resolved.auditLogger;
       devtoolsEnabled = resolved.devtoolsEnabled;
+      resolvedOpenApi = resolved.openapi;
+      resolvedDistDir = resolved.distDir;
     },
     // Vite calls this hook (sync return is fine — no awaits left after
     // the auto-chain moved to theoPluginAsync). The @usetheo/ui +
@@ -1920,13 +2052,7 @@ function theoPlugin(rootOrOptions) {
     // Vite drops plugins returned from a child plugin's config() hook.
     config() {
       const ext = existsSync7(resolve6(theoSrcDir, "index.ts")) ? ".ts" : ".js";
-      const optimizeDepsInclude = [];
-      if (existsSync7(resolve6(projectRoot, "node_modules", "@usetheo", "ui"))) {
-        optimizeDepsInclude.push("@usetheo/ui");
-      }
-      if (existsSync7(resolve6(projectRoot, "node_modules", "lucide-react"))) {
-        optimizeDepsInclude.push("lucide-react");
-      }
+      const optimizeDepsInclude = buildOptimizeDepsInclude(projectRoot, options.viteOptimizeDeps);
       const warmupClientFiles = [];
       for (const candidate of ["app/layout.tsx", "app/page.tsx", "app/page.jsx"]) {
         const full = resolve6(projectRoot, candidate);
@@ -1935,7 +2061,10 @@ function theoPlugin(rootOrOptions) {
       const servicesProxy = options.services && Object.keys(options.services).length > 0 ? buildServicesProxyConfig(options.services) : void 0;
       return {
         envPrefix: "THEO_PUBLIC_",
-        optimizeDeps: optimizeDepsInclude.length > 0 ? { include: optimizeDepsInclude } : void 0,
+        optimizeDeps: {
+          ...optimizeDepsInclude.length > 0 ? { include: optimizeDepsInclude } : {},
+          force: true
+        },
         server: {
           ...warmupClientFiles.length > 0 ? { warmup: { clientFiles: warmupClientFiles } } : {},
           ...servicesProxy !== void 0 ? { proxy: servicesProxy } : {},
@@ -2050,7 +2179,7 @@ function theoPlugin(rootOrOptions) {
         ].join("\n");
       }
     },
-    configureServer(server) {
+    async configureServer(server) {
       isDevMode = true;
       globalThis.__theoViteHotServer = server;
       server.ws.on("theo:devtools:request-manifest", () => {
@@ -2065,6 +2194,7 @@ function theoPlugin(rootOrOptions) {
         createActionMiddleware(server, serverDir, { pluginRunner, csrfMode, disallowed })
       );
       const servicesProxyPrefixes = options.services && Object.keys(options.services).length > 0 ? Object.values(options.services).map((s) => s.proxy) : [];
+      const csrfReadinessStore = options.csrfReadinessStore ?? new CsrfReadinessStore();
       server.middlewares.use(
         createApiMiddleware(server, serverDir, {
           rateLimitConfig: options.rateLimit,
@@ -2076,7 +2206,8 @@ function theoPlugin(rootOrOptions) {
           disallowed,
           cors,
           auditLogger,
-          servicesProxyPrefixes
+          servicesProxyPrefixes,
+          csrfReadinessStore
         })
       );
       const configPath = resolve6(projectRoot, "theo.config.ts");
@@ -2105,6 +2236,29 @@ function theoPlugin(rootOrOptions) {
       }
       server.watcher.on("add", handleRouteChange);
       server.watcher.on("unlink", handleRouteChange);
+      if (resolvedOpenApi !== void 0) {
+        const openApiCfg = resolvedOpenApi;
+        const { reEmitOpenApi } = await import("./dev-emit-3CHM73TV.js");
+        const openApiServerDir = resolve6(projectRoot, "server");
+        const openApiDistDir = resolve6(projectRoot, resolvedDistDir);
+        const isRouteFileForOpenApi = (file) => file.startsWith(openApiServerDir) && /\.(ts|tsx|js|mjs)$/.test(file);
+        void reEmitOpenApi(openApiServerDir, openApiDistDir, openApiCfg);
+        server.watcher.on("change", (file) => {
+          if (isRouteFileForOpenApi(file)) {
+            void reEmitOpenApi(openApiServerDir, openApiDistDir, openApiCfg);
+          }
+        });
+        server.watcher.on("add", (file) => {
+          if (isRouteFileForOpenApi(file)) {
+            void reEmitOpenApi(openApiServerDir, openApiDistDir, openApiCfg);
+          }
+        });
+        server.watcher.on("unlink", (file) => {
+          if (isRouteFileForOpenApi(file)) {
+            void reEmitOpenApi(openApiServerDir, openApiDistDir, openApiCfg);
+          }
+        });
+      }
       setupWsUpgrade(server, projectRoot);
       server.httpServer?.once("close", () => {
         ;
@@ -2130,4 +2284,4 @@ export {
   theoPluginAsync,
   theoPlugin
 };
-//# sourceMappingURL=chunk-FRBYJANT.js.map
+//# sourceMappingURL=chunk-4W447H7M.js.map