litestar-vite-plugin 0.28.0 → 0.29.0

package/dist/js/astro.d.ts

@@ -26,6 +26,8 @@
  * @module
  */
 import type { Plugin, ViteDevServer } from "vite";
+import { type LitestarIntegrationConfig } from "./shared/integration-config.js";
+import { type TypesConfigShape } from "./shared/typegen-plugin.js";
 /**
  * Astro integration interface.
  * This is a minimal type definition to avoid requiring astro as a dependency.
@@ -94,130 +96,19 @@ interface AstroIntegrationLogger {
     error: (message: string) => void;
 }
 /**
- * Configuration for TypeScript type generation in Astro.
+ * Configuration for TypeScript type generation.
+ *
+ * Alias of the shared {@link TypesConfigShape} so every integration accepts an identical
+ * `types` option. Retained as a named export for backwards compatibility.
  */
-export interface AstroTypesConfig {
-    /**
-     * Enable type generation.
-     *
-     * @default false
-     */
-    enabled?: boolean;
-    /**
-     * Path to output generated TypeScript types.
-     * Relative to the Astro project root.
-     *
-     * @default 'src/generated'
-     */
-    output?: string;
-    /**
-     * Path where the OpenAPI schema is exported by Litestar.
-     *
-     * @default `${output}/openapi.json`
-     */
-    openapiPath?: string;
-    /**
-     * Path where route metadata is exported by Litestar.
-     *
-     * @default `${output}/routes.json`
-     */
-    routesPath?: string;
-    /**
-     * Optional path for the generated schemas.ts helper file.
-     *
-     * @default `${output}/schemas.ts`
-     */
-    schemasTsPath?: string;
-    /**
-     * Path where Inertia page props metadata is exported by Litestar.
-     *
-     * @default `${output}/inertia-pages.json`
-     */
-    pagePropsPath?: string;
-    /**
-     * Generate Zod schemas in addition to TypeScript types.
-     *
-     * @default false
-     */
-    generateZod?: boolean;
-    /**
-     * Generate SDK client functions for API calls.
-     *
-     * @default true
-     */
-    generateSdk?: boolean;
-    /**
-     * Generate typed routes.ts from routes.json metadata.
-     *
-     * @default true
-     */
-    generateRoutes?: boolean;
-    /**
-     * Generate Inertia page props types from inertia-pages.json metadata.
-     *
-     * @default true
-     */
-    generatePageProps?: boolean;
-    /**
-     * Generate schemas.ts with ergonomic form/response type helpers.
-     *
-     * @default true
-     */
-    generateSchemas?: boolean;
-    /**
-     * Register route() globally on window object.
-     *
-     * @default false
-     */
-    globalRoute?: boolean;
-    /**
-     * Fail Vite when type generation fails.
-     *
-     * Defaults to true during build and false during dev.
-     */
-    failOnError?: boolean;
-    /**
-     * Debounce time in milliseconds for type regeneration.
-     *
-     * @default 300
-     */
-    debounce?: number;
-}
+export type AstroTypesConfig = TypesConfigShape;
 /**
- * Configuration options for the Litestar Astro integration.
+ * Configuration options for the Litestar integration.
+ *
+ * Alias of the shared {@link LitestarIntegrationConfig}. Retained as a named export for
+ * backwards compatibility.
  */
-export interface LitestarAstroConfig {
-    /**
-     * URL of the Litestar API backend for proxying requests during development.
-     *
-     * @example 'http://127.0.0.1:8000'
-     * @default 'http://localhost:8000'
-     */
-    apiProxy?: string;
-    /**
-     * API route prefix to proxy to the Litestar backend.
-     * Requests matching this prefix will be forwarded to the apiProxy URL.
-     *
-     * @example '/api'
-     * @default '/api'
-     */
-    apiPrefix?: string;
-    /**
-     * Enable and configure TypeScript type generation.
-     *
-     * When set to `true`, enables type generation with default settings.
-     * When set to an AstroTypesConfig object, enables type generation with custom settings.
-     *
-     * @default false
-     */
-    types?: boolean | AstroTypesConfig;
-    /**
-     * Enable verbose logging for debugging.
-     *
-     * @default false
-     */
-    verbose?: boolean;
-}
+export type LitestarAstroConfig = LitestarIntegrationConfig;
 /**
  * Litestar integration for Astro.
  *

package/dist/js/astro.js

@@ -1,63 +1,12 @@
 import fs from "node:fs";
 import path from "node:path";
-import { readBridgeConfig } from "./shared/bridge-schema.js";
+import { resolveIntegrationConfig } from "./shared/integration-config.js";
 import { installManagedShutdown } from "./shared/managed-shutdown.js";
-import { normalizeHost, resolveHotFilePath, resolveLitestarPort } from "./shared/network.js";
-import { createLitestarTypeGenPlugin, resolveTypesConfig } from "./shared/typegen-plugin.js";
+import { normalizeHost } from "./shared/network.js";
+import { createLitestarTypeGenPlugin } from "./shared/typegen-plugin.js";
 import { hmrServerConfig } from "./shared/vite-compat.js";
 function resolveConfig(config = {}) {
-  let hotFile;
-  let proxyMode = "vite";
-  let port;
-  let pythonTypesConfig;
-  let pythonExecutor;
-  let hasPythonConfig = false;
-  const envPort = process.env.VITE_PORT;
-  if (envPort) {
-    port = Number.parseInt(envPort, 10);
-    if (Number.isNaN(port)) {
-      port = void 0;
-    }
-  }
-  const runtime = readBridgeConfig();
-  let assetUrl;
-  let litestarPort;
-  if (runtime) {
-    hasPythonConfig = true;
-    const hot = runtime.hotFile;
-    hotFile = resolveHotFilePath(runtime.bundleDir, hot);
-    proxyMode = runtime.proxyMode;
-    port = runtime.port;
-    pythonExecutor = runtime.executor;
-    assetUrl = runtime.assetUrl;
-    if (runtime.types) {
-      pythonTypesConfig = runtime.types;
-    }
-  }
-  const resolvedLitestarPort = resolveLitestarPort(runtime?.litestarPort, runtime?.appUrl);
-  if (resolvedLitestarPort !== null) {
-    litestarPort = resolvedLitestarPort;
-  }
-  const typesConfig = resolveTypesConfig({
-    requested: config.types,
-    pythonConfig: pythonTypesConfig ?? void 0,
-    defaultOutput: "src/generated",
-    mergePythonWhenTrue: true,
-    mergePythonForObject: true
-  });
-  return {
-    apiProxy: config.apiProxy ?? "http://localhost:8000",
-    apiPrefix: config.apiPrefix ?? "/api",
-    types: typesConfig,
-    verbose: config.verbose ?? false,
-    hotFile,
-    proxyMode,
-    port,
-    litestarPort,
-    assetUrl,
-    executor: pythonExecutor,
-    hasPythonConfig
-  };
+  return resolveIntegrationConfig(config, "src/generated");
 }
 function createProxyPlugin(config) {
   return {

package/dist/js/helpers/csrf.d.ts

@@ -12,9 +12,11 @@
 declare global {
     interface Window {
         __LITESTAR_CSRF__?: string;
+        __LITESTAR_CSRF_HEADER_NAME__?: string;
+        __LITESTAR_CSRF_COOKIE_NAME__?: string;
     }
 }
-export declare const DEFAULT_CSRF_HEADER_NAME = "X-CSRFToken";
+export declare function getCsrfHeaderName(): string;
 /**
  * Get the CSRF token from the page.
  *

package/dist/js/helpers/csrf.js

@@ -10,7 +10,13 @@
  * @module
  */
 let csrfTokenCache = null;
-export const DEFAULT_CSRF_HEADER_NAME = "X-CSRFToken";
+const DEFAULT_CSRF_HEADER_NAME = "X-CSRFToken";
+export function getCsrfHeaderName() {
+    if (typeof window !== "undefined" && typeof window.__LITESTAR_CSRF_HEADER_NAME__ === "string" && window.__LITESTAR_CSRF_HEADER_NAME__.length > 0) {
+        return window.__LITESTAR_CSRF_HEADER_NAME__;
+    }
+    return DEFAULT_CSRF_HEADER_NAME;
+}
 function getWindowToken() {
     if (typeof window !== "undefined") {
         return window.__LITESTAR_CSRF__;
@@ -63,6 +69,12 @@ function getCookie(name) {
     return undefined;
 }
 function getCookieToken() {
+    if (typeof window !== "undefined" && typeof window.__LITESTAR_CSRF_COOKIE_NAME__ === "string" && window.__LITESTAR_CSRF_COOKIE_NAME__.length > 0) {
+        const configured = getCookie(window.__LITESTAR_CSRF_COOKIE_NAME__);
+        if (configured !== undefined) {
+            return configured;
+        }
+    }
     return getCookie("csrftoken") ?? getCookie("XSRF-TOKEN");
 }
 /**
@@ -122,17 +134,17 @@ export function getCsrfToken() {
     };
     return token;
 }
-function hasCsrfHeader(headers) {
+function hasCsrfHeader(headers, headerName) {
     if (headers == null) {
         return false;
     }
     if (headers instanceof Headers) {
-        return headers.has(DEFAULT_CSRF_HEADER_NAME);
+        return headers.has(headerName);
     }
     if (Array.isArray(headers)) {
-        return headers.some((entry) => Array.isArray(entry) && entry.length >= 2 && typeof entry[0] === "string" && entry[0].toLowerCase() === DEFAULT_CSRF_HEADER_NAME.toLowerCase());
+        return headers.some((entry) => Array.isArray(entry) && entry.length >= 2 && typeof entry[0] === "string" && entry[0].toLowerCase() === headerName.toLowerCase());
     }
-    return Object.keys(headers).some((key) => key.toLowerCase() === DEFAULT_CSRF_HEADER_NAME.toLowerCase());
+    return Object.keys(headers).some((key) => key.toLowerCase() === headerName.toLowerCase());
 }
 /**
  * Create headers object with CSRF token included.
@@ -156,13 +168,14 @@ export function csrfHeaders(additionalHeaders = {}) {
     if (!token) {
         return additionalHeaders;
     }
-    const existingTokenHeader = Object.keys(additionalHeaders).find((key) => key.toLowerCase() === DEFAULT_CSRF_HEADER_NAME.toLowerCase());
+    const headerName = getCsrfHeaderName();
+    const existingTokenHeader = Object.keys(additionalHeaders).find((key) => key.toLowerCase() === headerName.toLowerCase());
     if (existingTokenHeader !== undefined) {
         return additionalHeaders;
     }
     return {
         ...additionalHeaders,
-        [DEFAULT_CSRF_HEADER_NAME]: token,
+        [headerName]: token,
     };
 }
 /**
@@ -188,31 +201,32 @@ export function csrfFetch(input, init) {
     if (!token) {
         return fetch(input, init);
     }
-    if (!hasCsrfHeader(init?.headers)) {
+    const headerName = getCsrfHeaderName();
+    if (!hasCsrfHeader(init?.headers, headerName)) {
         if (!init || typeof init.headers === "undefined") {
             return fetch(input, {
                 ...init,
-                headers: { [DEFAULT_CSRF_HEADER_NAME]: token },
+                headers: { [headerName]: token },
             });
         }
         if (typeof init.headers === "object" && init.headers !== null && !(init.headers instanceof Headers)) {
             if (Array.isArray(init.headers)) {
                 return fetch(input, {
                     ...init,
-                    headers: [...init.headers, [DEFAULT_CSRF_HEADER_NAME, token]],
+                    headers: [...init.headers, [headerName, token]],
                 });
             }
             return fetch(input, {
                 ...init,
                 headers: {
                     ...init.headers,
-                    [DEFAULT_CSRF_HEADER_NAME]: token,
+                    [headerName]: token,
                 },
             });
         }
         if (init.headers instanceof Headers) {
             const headers = new Headers(init.headers);
-            headers.set(DEFAULT_CSRF_HEADER_NAME, token);
+            headers.set(headerName, token);
             return fetch(input, {
                 ...init,
                 headers,

package/dist/js/helpers/expression.d.ts

@@ -0,0 +1,3 @@
+type ExpressionContext = Record<string, unknown>;
+export declare function compileExpression(source: string): ((context: ExpressionContext) => unknown) | null;
+export {};