litestar-vite-plugin 0.15.0-alpha.7 → 0.15.0-beta.2

package/dist/js/shared/format-path.js

@@ -0,0 +1,24 @@
+import path from "node:path";
+function formatPath(absolutePath, root) {
+  if (!absolutePath) return absolutePath;
+  const projectRoot = root ?? process.cwd();
+  if (!path.isAbsolute(absolutePath)) {
+    return absolutePath;
+  }
+  try {
+    const relativePath = path.relative(projectRoot, absolutePath);
+    if (path.isAbsolute(relativePath)) {
+      return absolutePath;
+    }
+    return relativePath;
+  } catch {
+    return absolutePath;
+  }
+}
+function formatPaths(paths, root, separator = ", ") {
+  return paths.map((p) => formatPath(p, root)).join(separator);
+}
+export {
+  formatPath,
+  formatPaths
+};

package/dist/js/shared/logger.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Logging utilities for litestar-vite with configurable output.
+ *
+ * @module
+ */
+/**
+ * Logging configuration matching the Python LoggingConfig.
+ */
+export interface LoggingConfig {
+    level: "quiet" | "normal" | "verbose";
+    showPathsAbsolute: boolean;
+    suppressNpmOutput: boolean;
+    suppressViteBanner: boolean;
+    timestamps: boolean;
+}
+/**
+ * Default logging configuration.
+ */
+export declare const defaultLoggingConfig: LoggingConfig;
+/**
+ * Logger instance with configurable behavior.
+ */
+export interface Logger {
+    /** Log a message at normal level */
+    info: (message: string) => void;
+    /** Log a message at verbose level */
+    debug: (message: string) => void;
+    /** Log a warning (always shown except in quiet mode) */
+    warn: (message: string) => void;
+    /** Log an error (always shown) */
+    error: (message: string) => void;
+    /** Format a path according to config (relative or absolute) */
+    path: (absolutePath: string, root?: string) => string;
+    /** Get the current config */
+    config: LoggingConfig;
+}
+/**
+ * Create a logger instance with the given configuration.
+ *
+ * @param config - Logging configuration (partial, will be merged with defaults)
+ * @returns A Logger instance
+ */
+export declare function createLogger(config?: Partial<LoggingConfig> | null): Logger;

package/dist/js/shared/logger.js

@@ -0,0 +1,59 @@
+import { formatPath } from "./format-path.js";
+const defaultLoggingConfig = {
+  level: "normal",
+  showPathsAbsolute: false,
+  suppressNpmOutput: false,
+  suppressViteBanner: false,
+  timestamps: false
+};
+const LOG_LEVELS = {
+  quiet: 0,
+  normal: 1,
+  verbose: 2
+};
+function createLogger(config) {
+  const mergedConfig = {
+    ...defaultLoggingConfig,
+    ...config
+  };
+  const levelNum = LOG_LEVELS[mergedConfig.level];
+  const formatMessage = (message) => {
+    if (mergedConfig.timestamps) {
+      const now = (/* @__PURE__ */ new Date()).toISOString().slice(11, 23);
+      return `[${now}] ${message}`;
+    }
+    return message;
+  };
+  const formatPathValue = (absolutePath, root) => {
+    if (mergedConfig.showPathsAbsolute) {
+      return absolutePath;
+    }
+    return formatPath(absolutePath, root);
+  };
+  return {
+    info: (message) => {
+      if (levelNum >= LOG_LEVELS.normal) {
+        console.log(formatMessage(message));
+      }
+    },
+    debug: (message) => {
+      if (levelNum >= LOG_LEVELS.verbose) {
+        console.log(formatMessage(message));
+      }
+    },
+    warn: (message) => {
+      if (levelNum >= LOG_LEVELS.normal) {
+        console.warn(formatMessage(message));
+      }
+    },
+    error: (message) => {
+      console.error(formatMessage(message));
+    },
+    path: formatPathValue,
+    config: mergedConfig
+  };
+}
+export {
+  createLogger,
+  defaultLoggingConfig
+};

package/dist/js/sveltekit.js

@@ -1,11 +1,7 @@
-import { exec } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
-import { promisify } from "node:util";
 import colors from "picocolors";
-import { resolveInstallHint, resolvePackageExecutor } from "./install-hint.js";
-import { debounce } from "./shared/debounce.js";
-const execAsync = promisify(exec);
+import { createTypeGenerationPlugin } from "./shared/create-type-gen-plugin.js";
 function resolveConfig(config = {}) {
   const runtimeConfigPath = process.env.LITESTAR_VITE_CONFIG_PATH;
   let hotFile;
@@ -155,233 +151,17 @@ function litestarSvelteKit(userConfig = {}) {
     }
   });
   if (config.types !== false && config.types.enabled) {
-    plugins.push(createTypeGenerationPlugin(config.types, config.executor));
+    plugins.push(
+      createTypeGenerationPlugin(config.types, {
+        frameworkName: "litestar-sveltekit",
+        pluginName: "litestar-sveltekit-types",
+        clientPlugin: "@hey-api/client-fetch",
+        executor: config.executor
+      })
+    );
   }
   return plugins;
 }
-async function emitRouteTypes(routesPath, outputDir) {
-  const contents = await fs.promises.readFile(routesPath, "utf-8");
-  const json = JSON.parse(contents);
-  const outDir = path.resolve(process.cwd(), outputDir);
-  await fs.promises.mkdir(outDir, { recursive: true });
-  const outFile = path.join(outDir, "routes.ts");
-  const banner = `// AUTO-GENERATED by litestar-vite. Do not edit.
-/* eslint-disable */
-
-`;
-  const routesData = json.routes || json;
-  const routeNames = Object.keys(routesData);
-  const routeNameType = routeNames.length > 0 ? routeNames.map((n) => `"${n}"`).join(" | ") : "never";
-  const routeParamTypes = [];
-  for (const [name, data] of Object.entries(routesData)) {
-    const routeData = data;
-    if (routeData.parameters && routeData.parameters.length > 0) {
-      const params = routeData.parameters.map((p) => `${p}: string | number`).join("; ");
-      routeParamTypes.push(`  "${name}": { ${params} }`);
-    } else {
-      routeParamTypes.push(`  "${name}": Record<string, never>`);
-    }
-  }
-  const body = `/**
- * AUTO-GENERATED by litestar-vite.
- *
- * Exports:
- * - routesMeta: full route metadata
- * - routes: name -> uri map
- * - serverRoutes: alias of routes for clarity in apps
- * - route(): type-safe URL generator
- * - hasRoute(): type guard
- * - csrf helpers re-exported from litestar-vite-plugin/helpers
- *
- * @see https://litestar-vite.litestar.dev/
- */
-export const routesMeta = ${JSON.stringify(json, null, 2)} as const
-
-/**
- * Route name to URI mapping.
- */
-export const routes = ${JSON.stringify(Object.fromEntries(Object.entries(routesData).map(([name, data]) => [name, data.uri])), null, 2)} as const
-
-/**
- * Alias for server-injected route map (more descriptive for consumers).
- */
-export const serverRoutes = routes
-
-/**
- * All available route names.
- */
-export type RouteName = ${routeNameType}
-
-/**
- * Parameter types for each route.
- */
-export interface RouteParams {
-${routeParamTypes.join("\n")}
-}
-
-/**
- * Generate a URL for a named route with type-safe parameters.
- *
- * @param name - The route name
- * @param params - Route parameters (required if route has path parameters)
- * @returns The generated URL
- *
- * @example
- * \`\`\`ts
- * import { route } from '@/generated/routes'
- *
- * // Route without parameters
- * route('home')  // "/"
- *
- * // Route with parameters
- * route('user:detail', { user_id: 123 })  // "/users/123"
- * \`\`\`
- */
-export function route<T extends RouteName>(
-  name: T,
-  ...args: RouteParams[T] extends Record<string, never> ? [] : [params: RouteParams[T]]
-): string {
-  let uri = routes[name] as string
-  const params = args[0] as Record<string, string | number> | undefined
-
-  if (params) {
-    for (const [key, value] of Object.entries(params)) {
-      // Handle both {param} and {param:type} syntax
-      uri = uri.replace(new RegExp(\`\\\\{\${key}(?::[^}]+)?\\\\}\`, "g"), String(value))
-    }
-  }
-
-  return uri
-}
-
-/**
- * Check if a route name exists.
- */
-export function hasRoute(name: string): name is RouteName {
-  return name in routes
-}
-
-declare global {
-  interface Window {
-    /**
-     * Fully-typed route metadata injected by Litestar.
-     */
-    __LITESTAR_ROUTES__?: typeof routesMeta
-    /**
-     * Simple route map (name -> uri) for legacy consumers.
-     */
-    routes?: typeof routes
-    serverRoutes?: typeof serverRoutes
-  }
-  // eslint-disable-next-line no-var
-  var routes: typeof routes | undefined
-  var serverRoutes: typeof serverRoutes | undefined
-}
-
-// Re-export helper functions from litestar-vite-plugin
-// These work with the routes defined above
-export { getCsrfToken, csrfHeaders, csrfFetch } from "litestar-vite-plugin/helpers"
-`;
-  await fs.promises.writeFile(outFile, `${banner}${body}`, "utf-8");
-}
-function createTypeGenerationPlugin(typesConfig, executor) {
-  let server = null;
-  let isGenerating = false;
-  async function runTypeGeneration() {
-    if (isGenerating) {
-      return false;
-    }
-    isGenerating = true;
-    const startTime = Date.now();
-    try {
-      const openapiPath = path.resolve(process.cwd(), typesConfig.openapiPath);
-      if (!fs.existsSync(openapiPath)) {
-        console.log(colors.cyan("[litestar-sveltekit]"), colors.yellow("OpenAPI schema not found:"), typesConfig.openapiPath);
-        return false;
-      }
-      console.log(colors.cyan("[litestar-sveltekit]"), colors.dim("Generating TypeScript types..."));
-      const projectRoot = process.cwd();
-      const candidates = [path.resolve(projectRoot, "openapi-ts.config.ts"), path.resolve(projectRoot, "hey-api.config.ts"), path.resolve(projectRoot, ".hey-api.config.ts")];
-      const configPath = candidates.find((p) => fs.existsSync(p)) || null;
-      let args;
-      if (configPath) {
-        console.log(colors.cyan("[litestar-sveltekit]"), colors.dim("Using config:"), configPath);
-        args = ["@hey-api/openapi-ts", "--file", configPath];
-      } else {
-        args = ["@hey-api/openapi-ts", "-i", typesConfig.openapiPath, "-o", typesConfig.output];
-        const plugins = ["@hey-api/typescript", "@hey-api/schemas"];
-        if (typesConfig.generateSdk) {
-          plugins.push("@hey-api/sdk", "@hey-api/client-fetch");
-        }
-        if (typesConfig.generateZod) {
-          plugins.push("zod");
-        }
-        if (plugins.length) {
-          args.push("--plugins", ...plugins);
-        }
-      }
-      await execAsync(resolvePackageExecutor(args.join(" "), executor), {
-        cwd: projectRoot
-      });
-      const routesPath = path.resolve(process.cwd(), typesConfig.routesPath);
-      if (fs.existsSync(routesPath)) {
-        await emitRouteTypes(routesPath, typesConfig.output);
-      }
-      const duration = Date.now() - startTime;
-      console.log(colors.cyan("[litestar-sveltekit]"), colors.green("Types generated"), colors.dim(`in ${duration}ms`));
-      if (server) {
-        server.ws.send({
-          type: "custom",
-          event: "litestar:types-updated",
-          data: {
-            output: typesConfig.output,
-            timestamp: Date.now()
-          }
-        });
-      }
-      return true;
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      if (message.includes("not found") || message.includes("ENOENT")) {
-        console.log(colors.cyan("[litestar-sveltekit]"), colors.yellow("@hey-api/openapi-ts not installed"), "- run:", resolveInstallHint());
-      } else {
-        console.error(colors.cyan("[litestar-sveltekit]"), colors.red("Type generation failed:"), message);
-      }
-      return false;
-    } finally {
-      isGenerating = false;
-    }
-  }
-  const debouncedRunTypeGeneration = debounce(runTypeGeneration, typesConfig.debounce);
-  return {
-    name: "litestar-sveltekit-types",
-    enforce: "pre",
-    configureServer(devServer) {
-      server = devServer;
-      console.log(colors.cyan("[litestar-sveltekit]"), colors.dim("Watching for schema changes:"), colors.yellow(typesConfig.openapiPath));
-    },
-    async buildStart() {
-      if (typesConfig.enabled) {
-        const openapiPath = path.resolve(process.cwd(), typesConfig.openapiPath);
-        if (fs.existsSync(openapiPath)) {
-          await runTypeGeneration();
-        }
-      }
-    },
-    handleHotUpdate({ file }) {
-      if (!typesConfig.enabled) {
-        return;
-      }
-      const relativePath = path.relative(process.cwd(), file);
-      const openapiPath = typesConfig.openapiPath.replace(/^\.\//, "");
-      const routesPath = typesConfig.routesPath.replace(/^\.\//, "");
-      if (relativePath === openapiPath || relativePath === routesPath || file.endsWith(openapiPath) || file.endsWith(routesPath)) {
-        console.log(colors.cyan("[litestar-sveltekit]"), colors.dim("Schema changed:"), colors.yellow(relativePath));
-        debouncedRunTypeGeneration();
-      }
-    }
-  };
-}
 var sveltekit_default = litestarSvelteKit;
 export {
   sveltekit_default as default,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "litestar-vite-plugin",
-  "version": "0.15.0-alpha.7",
+  "version": "0.15.0-beta.2",
   "type": "module",
   "description": "Litestar plugin for Vite.",
   "keywords": [
@@ -55,7 +55,7 @@
     "build": "npm run build-plugin && npm run build-helpers && npm run build-inertia-helpers && npm run build-integrations",
     "build-plugin": "rm -rf dist/js && npm run build-plugin-types && npm run build-plugin-esm && cp src/js/src/dev-server-index.html dist/js/",
     "build-plugin-types": "tsc --project src/js/tsconfig.json --emitDeclarationOnly",
-    "build-plugin-esm": "esbuild src/js/src/index.ts --platform=node --format=esm --outfile=dist/js/index.js && esbuild src/js/src/install-hint.ts --platform=node --format=esm --outfile=dist/js/install-hint.js && esbuild src/js/src/litestar-meta.ts --platform=node --format=esm --outfile=dist/js/litestar-meta.js && mkdir -p dist/js/shared && esbuild src/js/src/shared/debounce.ts --platform=node --format=esm --outfile=dist/js/shared/debounce.js",
+    "build-plugin-esm": "esbuild src/js/src/index.ts --platform=node --format=esm --outfile=dist/js/index.js && esbuild src/js/src/install-hint.ts --platform=node --format=esm --outfile=dist/js/install-hint.js && esbuild src/js/src/litestar-meta.ts --platform=node --format=esm --outfile=dist/js/litestar-meta.js && mkdir -p dist/js/shared && esbuild src/js/src/shared/debounce.ts src/js/src/shared/format-path.ts src/js/src/shared/logger.ts src/js/src/shared/emit-route-types.ts src/js/src/shared/create-type-gen-plugin.ts --platform=node --format=esm --outdir=dist/js/shared",
     "build-helpers": "rm -rf dist/js/helpers && tsc --project src/js/tsconfig.helpers.json",
     "build-inertia-helpers": "rm -rf dist/js/inertia-helpers && tsc --project src/js/tsconfig.inertia-helpers.json",
     "build-integrations": "esbuild src/js/src/astro.ts src/js/src/sveltekit.ts src/js/src/nuxt.ts --platform=node --format=esm --outdir=dist/js",