@flight-framework/core 0.6.1 → 0.6.3

package/dist/chunk-J7WEZXWH.js

@@ -0,0 +1,14 @@
+// src/plugins/server-boundary-plugin.ts
+function serverBoundaryPlugin(_options = {}) {
+  console.warn(
+    "[Flight] serverBoundaryPlugin is deprecated. Use runtime guards (assertServer, assertClient) instead."
+  );
+  return {
+    name: "flight:server-boundary-deprecated"
+    // No-op plugin - just shows warning
+  };
+}
+
+export { serverBoundaryPlugin };
+//# sourceMappingURL=chunk-J7WEZXWH.js.map
+//# sourceMappingURL=chunk-J7WEZXWH.js.map

package/dist/chunk-J7WEZXWH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugins/server-boundary-plugin.ts"],"names":[],"mappings":";AAsCO,SAAS,oBAAA,CACZ,QAAA,GAAwC,EAAC,EACnC;AACN,EAAA,OAAA,CAAQ,IAAA;AAAA,IACJ;AAAA,GAEJ;AAEA,EAAA,OAAO;AAAA,IACH,IAAA,EAAM;AAAA;AAAA,GAEV;AACJ","file":"chunk-J7WEZXWH.js","sourcesContent":["/**\r\n * @flight-framework/core - Server Boundary Plugin (DEPRECATED)\r\n * \r\n * This plugin has been deprecated due to conflicts with serverActionsPlugin.\r\n * \r\n * The intended functionality (detecting server-only imports in client bundles)\r\n * is difficult to implement correctly with Vite's plugin system because:\r\n * \r\n * 1. It conflicts with serverActionsPlugin which transforms 'use server' files\r\n * 2. The resolveId hook runs before transforms, making detection unreliable\r\n * 3. Vite 6+ has different environment APIs that need careful handling\r\n * \r\n * For now, use runtime guards instead:\r\n * \r\n * @example\r\n * ```typescript\r\n * import { assertServer } from '@flight-framework/core';\r\n * \r\n * export function getSecretData() {\r\n *   assertServer('getSecretData'); // Throws if called on client\r\n *   return process.env.SECRET_KEY;\r\n * }\r\n * ```\r\n * \r\n * @deprecated Use runtime guards (assertServer, assertClient) instead\r\n */\r\n\r\nimport type { Plugin } from 'vite';\r\n\r\nexport interface ServerBoundaryPluginOptions {\r\n    /** @deprecated This plugin is deprecated */\r\n    enabled?: boolean;\r\n}\r\n\r\n/**\r\n * @deprecated This plugin has been deprecated due to conflicts with serverActionsPlugin.\r\n * Use runtime guards (assertServer, assertClient) from '@flight-framework/core' instead.\r\n */\r\nexport function serverBoundaryPlugin(\r\n    _options: ServerBoundaryPluginOptions = {}\r\n): Plugin {\r\n    console.warn(\r\n        '[Flight] serverBoundaryPlugin is deprecated. ' +\r\n        'Use runtime guards (assertServer, assertClient) instead.'\r\n    );\r\n\r\n    return {\r\n        name: 'flight:server-boundary-deprecated',\r\n        // No-op plugin - just shows warning\r\n    };\r\n}\r\n"]}

package/dist/chunk-MFUJN7RV.js

@@ -0,0 +1,20 @@
+// src/plugins/env-plugin.ts
+function flightEnvPlugin(options = {}) {
+  const {
+    publicPrefix = "FLIGHT_PUBLIC_",
+    additionalPrefixes = ["VITE_"]
+  } = options;
+  const prefixes = [.../* @__PURE__ */ new Set([publicPrefix, ...additionalPrefixes])];
+  return {
+    name: "flight:env",
+    config() {
+      return {
+        envPrefix: prefixes
+      };
+    }
+  };
+}
+
+export { flightEnvPlugin };
+//# sourceMappingURL=chunk-MFUJN7RV.js.map
+//# sourceMappingURL=chunk-MFUJN7RV.js.map

package/dist/chunk-MFUJN7RV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugins/env-plugin.ts"],"names":[],"mappings":";AA8CO,SAAS,eAAA,CAAgB,OAAA,GAAkC,EAAC,EAAW;AAC1E,EAAA,MAAM;AAAA,IACF,YAAA,GAAe,gBAAA;AAAA,IACf,kBAAA,GAAqB,CAAC,OAAO;AAAA,GACjC,GAAI,OAAA;AAGJ,EAAA,MAAM,QAAA,GAAW,CAAC,mBAAG,IAAI,GAAA,CAAI,CAAC,YAAA,EAAc,GAAG,kBAAkB,CAAC,CAAC,CAAA;AAEnE,EAAA,OAAO;AAAA,IACH,IAAA,EAAM,YAAA;AAAA,IACN,MAAA,GAAS;AACL,MAAA,OAAO;AAAA,QACH,SAAA,EAAW;AAAA,OACf;AAAA,IACJ;AAAA,GACJ;AACJ","file":"chunk-MFUJN7RV.js","sourcesContent":["/**\r\n * @flight-framework/core - Environment Plugin\r\n * \r\n * Simple Vite plugin to configure environment variable prefixes.\r\n * \r\n * NOTE: This is mostly a convenience wrapper around Vite's native envPrefix.\r\n * You can achieve the same by adding this to your vite.config.ts:\r\n * \r\n *   envPrefix: ['VITE_', 'FLIGHT_PUBLIC_']\r\n * \r\n * Use this plugin if you want a more explicit Flight integration.\r\n * \r\n * @example\r\n * ```typescript\r\n * // vite.config.ts\r\n * import { flightEnvPlugin } from '@flight-framework/core/plugins';\r\n * \r\n * export default {\r\n *   plugins: [flightEnvPlugin()],\r\n * };\r\n * ```\r\n */\r\n\r\nimport type { Plugin } from 'vite';\r\n\r\nexport interface FlightEnvPluginOptions {\r\n    /**\r\n     * Public environment variable prefix. Variables with this prefix\r\n     * are exposed to client-side code via import.meta.env.\r\n     * @default 'FLIGHT_PUBLIC_'\r\n     */\r\n    publicPrefix?: string;\r\n\r\n    /**\r\n     * Additional prefixes to expose (e.g., 'VITE_' is always included).\r\n     * @default ['VITE_']\r\n     */\r\n    additionalPrefixes?: string[];\r\n}\r\n\r\n/**\r\n * Vite plugin to configure Flight's environment variable prefixes.\r\n * \r\n * This adds 'FLIGHT_PUBLIC_' as an additional env prefix alongside 'VITE_'.\r\n * Use FLIGHT_PUBLIC_* for variables you want exposed to the browser.\r\n */\r\nexport function flightEnvPlugin(options: FlightEnvPluginOptions = {}): Plugin {\r\n    const {\r\n        publicPrefix = 'FLIGHT_PUBLIC_',\r\n        additionalPrefixes = ['VITE_'],\r\n    } = options;\r\n\r\n    // Build the list of prefixes\r\n    const prefixes = [...new Set([publicPrefix, ...additionalPrefixes])];\r\n\r\n    return {\r\n        name: 'flight:env',\r\n        config() {\r\n            return {\r\n                envPrefix: prefixes,\r\n            };\r\n        },\r\n    };\r\n}\r\n"]}

package/dist/plugins/env-plugin.d.ts

@@ -1,15 +1,16 @@
 import { Plugin } from 'vite';
 
 /**
- * @flight-framework/core - Environment Variables Plugin
+ * @flight-framework/core - Environment Plugin
  *
- * Vite plugin for environment variable protection.
- * OPTIONAL - use if you want build-time protection.
+ * Simple Vite plugin to configure environment variable prefixes.
  *
- * Features:
- * - FLIGHT_PUBLIC_* and VITE_* accessible on client
- * - Other vars replaced with undefined on client
- * - Configurable behavior (warn, error, silent)
+ * NOTE: This is mostly a convenience wrapper around Vite's native envPrefix.
+ * You can achieve the same by adding this to your vite.config.ts:
+ *
+ *   envPrefix: ['VITE_', 'FLIGHT_PUBLIC_']
+ *
+ * Use this plugin if you want a more explicit Flight integration.
  *
  * @example
  * ```typescript
@@ -24,41 +25,22 @@ import { Plugin } from 'vite';
 
 interface FlightEnvPluginOptions {
     /**
-     * Prefix for public environment variables.
-     * Variables with this prefix will be accessible on the client.
+     * Public environment variable prefix. Variables with this prefix
+     * are exposed to client-side code via import.meta.env.
      * @default 'FLIGHT_PUBLIC_'
      */
     publicPrefix?: string;
     /**
-     * Additional prefixes to treat as public.
+     * Additional prefixes to expose (e.g., 'VITE_' is always included).
      * @default ['VITE_']
      */
-    additionalPublicPrefixes?: string[];
-    /**
-     * How to handle private vars accessed in client code.
-     * - 'warn': Log warning, replace with undefined
-     * - 'error': Throw build error
-     * - 'silent': Replace with undefined, no warning
-     * @default 'warn'
-     */
-    privateVarBehavior?: 'warn' | 'error' | 'silent';
-    /**
-     * Specific variables to allow (bypass prefix check).
-     * @default ['NODE_ENV', 'MODE']
-     */
-    allowList?: string[];
+    additionalPrefixes?: string[];
 }
 /**
- * Vite plugin to protect environment variables.
- *
- * This plugin is OPTIONAL. Use it if you want build-time
- * protection for your environment variables.
+ * Vite plugin to configure Flight's environment variable prefixes.
  *
- * By default, it will:
- * - Allow FLIGHT_PUBLIC_* and VITE_* on client
- * - Allow NODE_ENV and MODE
- * - Replace other process.env.* with undefined on client
- * - Show warnings in development
+ * This adds 'FLIGHT_PUBLIC_' as an additional env prefix alongside 'VITE_'.
+ * Use FLIGHT_PUBLIC_* for variables you want exposed to the browser.
  */
 declare function flightEnvPlugin(options?: FlightEnvPluginOptions): Plugin;
 

package/dist/plugins/env-plugin.js

@@ -1,3 +1,3 @@
-export { flightEnvPlugin } from '../chunk-RFTE6JVG.js';
+export { flightEnvPlugin } from '../chunk-MFUJN7RV.js';
 //# sourceMappingURL=env-plugin.js.map
 //# sourceMappingURL=env-plugin.js.map

package/dist/plugins/index.d.ts

@@ -1,8 +1,7 @@
-import { Plugin } from 'vite';
 import { FlightEnvPluginOptions } from './env-plugin.js';
 export { flightEnvPlugin } from './env-plugin.js';
-import { ServerBoundaryPluginOptions } from './server-boundary-plugin.js';
-export { serverBoundaryPlugin } from './server-boundary-plugin.js';
+export { ServerBoundaryPluginOptions, serverBoundaryPlugin } from './server-boundary-plugin.js';
+import { Plugin } from 'vite';
 
 /**
  * @flight-framework/core - Critical CSS Plugin
@@ -127,29 +126,34 @@ interface CriticalCSSOptions {
 declare function criticalCSS(options?: CriticalCSSOptions): Plugin;
 
 /**
- * @flight-framework/core - Build Plugins
+ * @flight-framework/core - Vite Plugins
  *
- * Optional Vite plugins for advanced optimizations.
- * These plugins are opt-in and require explicit configuration.
- *
- * Flight doesn't force you to use any of these - use them if you want.
+ * Optional Vite plugins for Flight Framework.
+ * All plugins are opt-in - use only what you need.
  */
 
+interface FlightPluginsOptions {
+    env?: FlightEnvPluginOptions;
+}
 /**
- * Recommended plugins for most apps.
- * Provides sensible defaults with warnings for violations.
+ * Recommended Flight plugins for most projects.
+ * Currently only includes the env plugin (serverBoundaryPlugin is deprecated).
+ *
+ * @example
+ * ```typescript
+ * // vite.config.ts
+ * import { flightRecommendedPlugins } from '@flight-framework/core/plugins';
+ *
+ * export default {
+ *   plugins: [...flightRecommendedPlugins()],
+ * };
+ * ```
  */
-declare function flightRecommendedPlugins(options?: {
-    env?: FlightEnvPluginOptions;
-    serverBoundary?: ServerBoundaryPluginOptions;
-}): Plugin[];
+declare function flightRecommendedPlugins(options?: FlightPluginsOptions): Plugin[];
 /**
- * Strict mode plugins - errors instead of warnings.
- * Recommended for production builds.
+ * @deprecated Use flightRecommendedPlugins instead.
+ * Strict plugins are no longer needed since serverBoundaryPlugin is deprecated.
  */
-declare function flightStrictPlugins(options?: {
-    env?: FlightEnvPluginOptions;
-    serverBoundary?: ServerBoundaryPluginOptions;
-}): Plugin[];
+declare function flightStrictPlugins(options?: FlightPluginsOptions): Plugin[];
 
-export { type CriticalCSSOptions, FlightEnvPluginOptions, type PreloadStrategy, ServerBoundaryPluginOptions, criticalCSS, flightRecommendedPlugins, flightStrictPlugins };
+export { FlightEnvPluginOptions, type FlightPluginsOptions, criticalCSS, flightRecommendedPlugins, flightStrictPlugins };

package/dist/plugins/index.js

@@ -1,7 +1,6 @@
-import { serverBoundaryPlugin } from '../chunk-56ZZNOJD.js';
-export { serverBoundaryPlugin } from '../chunk-56ZZNOJD.js';
-import { flightEnvPlugin } from '../chunk-RFTE6JVG.js';
-export { flightEnvPlugin } from '../chunk-RFTE6JVG.js';
+export { serverBoundaryPlugin } from '../chunk-J7WEZXWH.js';
+import { flightEnvPlugin } from '../chunk-MFUJN7RV.js';
+export { flightEnvPlugin } from '../chunk-MFUJN7RV.js';
 
 // src/plugins/critical-css.ts
 function criticalCSS(options = {}) {
@@ -120,29 +119,14 @@ function matchesPattern(path, pattern) {
 }
 
 // src/plugins/index.ts
-function flightRecommendedPlugins(options) {
+function flightRecommendedPlugins(options = {}) {
   return [
-    flightEnvPlugin({
-      privateVarBehavior: "warn",
-      ...options?.env
-    }),
-    serverBoundaryPlugin({
-      violationBehavior: "warn",
-      ...options?.serverBoundary
-    })
+    flightEnvPlugin(options.env)
   ];
 }
-function flightStrictPlugins(options) {
-  return [
-    flightEnvPlugin({
-      privateVarBehavior: "error",
-      ...options?.env
-    }),
-    serverBoundaryPlugin({
-      violationBehavior: "error",
-      ...options?.serverBoundary
-    })
-  ];
+function flightStrictPlugins(options = {}) {
+  console.warn("[Flight] flightStrictPlugins is deprecated. Use flightRecommendedPlugins instead.");
+  return flightRecommendedPlugins(options);
 }
 
 export { criticalCSS, flightRecommendedPlugins, flightStrictPlugins };

package/dist/plugins/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/plugins/critical-css.ts","../../src/plugins/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * @flight-framework/core - Critical CSS Plugin\r\n *\r\n * Extract and inline critical CSS for improved Core Web Vitals.\r\n * Uses Critters under the hood for CSS extraction.\r\n *\r\n * This is an OPTIONAL plugin. Install 'critters' only if you use it.\r\n *\r\n * @example\r\n * ```typescript\r\n * // vite.config.ts\r\n * import { criticalCSS } from '@flight-framework/core/plugins';\r\n *\r\n * export default defineConfig({\r\n *     plugins: [\r\n *         criticalCSS({\r\n *             preload: 'swap',\r\n *             pruneSource: false,\r\n *         }),\r\n *     ],\r\n * });\r\n * ```\r\n */\r\n\r\nimport type { Plugin, ResolvedConfig } from 'vite';\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Preload strategy for non-critical CSS.\r\n *\r\n * - 'body': Move stylesheet links to end of body\r\n * - 'media': Use media=\"print\" and swap to \"all\" on load\r\n * - 'swap': Use link rel=\"preload\" and swap to stylesheet\r\n * - 'swap-high': Like swap, with fetchpriority=\"high\"\r\n * - 'js': Load via JavaScript\r\n * - 'js-lazy': Load via JavaScript when idle\r\n * - false: Don't preload\r\n */\r\nexport type PreloadStrategy =\r\n    | 'body'\r\n    | 'media'\r\n    | 'swap'\r\n    | 'swap-high'\r\n    | 'js'\r\n    | 'js-lazy'\r\n    | false;\r\n\r\n/**\r\n * Critical CSS plugin options.\r\n */\r\nexport interface CriticalCSSOptions {\r\n    /**\r\n     * Enable critical CSS extraction.\r\n     * @default true in production\r\n     */\r\n    enabled?: boolean;\r\n\r\n    /**\r\n     * Strategy for loading non-critical CSS.\r\n     * @default 'swap'\r\n     */\r\n    preload?: PreloadStrategy;\r\n\r\n    /**\r\n     * Remove inlined CSS rules from the source stylesheet.\r\n     * Reduces duplicate CSS but may cause issues with JS frameworks.\r\n     * @default false\r\n     */\r\n    pruneSource?: boolean;\r\n\r\n    /**\r\n     * Remove unused CSS selectors from critical CSS.\r\n     * @default true\r\n     */\r\n    reduceInlineStyles?: boolean;\r\n\r\n    /**\r\n     * Merge adjacent inline <style> tags.\r\n     * @default true\r\n     */\r\n    mergeStylesheets?: boolean;\r\n\r\n    /**\r\n     * Additional CSS selectors to always include as critical.\r\n     */\r\n    additionalStylesheets?: string[];\r\n\r\n    /**\r\n     * CSS selectors to exclude from critical extraction.\r\n     */\r\n    excludeSelectors?: string[];\r\n\r\n    /**\r\n     * Routes to include (glob patterns).\r\n     * @default ['**\\/*.html']\r\n     */\r\n    include?: string[];\r\n\r\n    /**\r\n     * Routes to exclude (glob patterns).\r\n     * @default ['/api/**']\r\n     */\r\n    exclude?: string[];\r\n\r\n    /**\r\n     * Inline external fonts.\r\n     * @default false\r\n     */\r\n    inlineFonts?: boolean;\r\n\r\n    /**\r\n     * Preload external fonts.\r\n     * @default true\r\n     */\r\n    preloadFonts?: boolean;\r\n\r\n    /**\r\n     * Maximum size of inlined CSS (in bytes).\r\n     * Larger stylesheets will be loaded normally.\r\n     * @default 100000 (100KB)\r\n     */\r\n    maxInlinedSize?: number;\r\n\r\n    /**\r\n     * Log extraction stats.\r\n     * @default true\r\n     */\r\n    verbose?: boolean;\r\n}\r\n\r\n// ============================================================================\r\n// Critters Integration\r\n// ============================================================================\r\n\r\n/**\r\n * Critters options interface (subset of full Critters options).\r\n * Full options available at: https://github.com/GoogleChromeLabs/critters\r\n */\r\ninterface CrittersOptions {\r\n    preload?: PreloadStrategy;\r\n    pruneSource?: boolean;\r\n    reduceInlineStyles?: boolean;\r\n    mergeStylesheets?: boolean;\r\n    external?: boolean;\r\n    inlineFonts?: boolean;\r\n    preloadFonts?: boolean;\r\n    additionalStylesheets?: string[];\r\n    noscriptFallback?: boolean;\r\n    path?: string;\r\n    publicPath?: string;\r\n    logLevel?: 'info' | 'warn' | 'error' | 'trace' | 'debug' | 'silent';\r\n}\r\n\r\n// ============================================================================\r\n// Vite Plugin\r\n// ============================================================================\r\n\r\n/**\r\n * Vite plugin for critical CSS extraction.\r\n *\r\n * This plugin extracts critical (above-the-fold) CSS and inlines it\r\n * in the HTML, deferring non-critical CSS for better performance.\r\n *\r\n * Requires 'critters' as a peer dependency:\r\n * ```bash\r\n * npm install critters\r\n * ```\r\n *\r\n * @param options - Plugin configuration\r\n * @returns Vite plugin\r\n */\r\nexport function criticalCSS(options: CriticalCSSOptions = {}): Plugin {\r\n    const {\r\n        preload = 'swap',\r\n        pruneSource = false,\r\n        reduceInlineStyles = true,\r\n        mergeStylesheets = true,\r\n        additionalStylesheets = [],\r\n        inlineFonts = false,\r\n        preloadFonts = true,\r\n        maxInlinedSize = 100000,\r\n        include = ['**/*.html'],\r\n        exclude = ['/api/**'],\r\n        verbose = true,\r\n    } = options;\r\n\r\n    let config: ResolvedConfig;\r\n    let isProduction = false;\r\n    let enabled = options.enabled;\r\n    let critters: {\r\n        process: (html: string) => Promise<string>;\r\n    } | null = null;\r\n\r\n    return {\r\n        name: 'flight-critical-css',\r\n        enforce: 'post',\r\n        apply: 'build',\r\n\r\n        configResolved(resolvedConfig) {\r\n            config = resolvedConfig;\r\n            isProduction = resolvedConfig.command === 'build';\r\n\r\n            // Enable by default only in production\r\n            if (enabled === undefined) {\r\n                enabled = isProduction;\r\n            }\r\n        },\r\n\r\n        async buildStart() {\r\n            if (!enabled) return;\r\n\r\n            try {\r\n                // Dynamic import of Critters (optional peer dependency)\r\n                // @ts-expect-error - critters has broken type exports in its package.json\r\n                const CrittersModule = await import('critters');\r\n                const Critters = CrittersModule.default || CrittersModule;\r\n\r\n                const crittersOptions: CrittersOptions = {\r\n                    preload,\r\n                    pruneSource,\r\n                    reduceInlineStyles,\r\n                    mergeStylesheets,\r\n                    inlineFonts,\r\n                    preloadFonts,\r\n                    additionalStylesheets,\r\n                    external: true,\r\n                    noscriptFallback: true,\r\n                    path: config.build.outDir,\r\n                    publicPath: config.base || '/',\r\n                    logLevel: verbose ? 'info' : 'silent',\r\n                };\r\n\r\n                critters = new Critters(crittersOptions);\r\n\r\n                if (verbose) {\r\n                    console.log('[flight-critical-css] Critical CSS extraction enabled');\r\n                }\r\n            } catch (error) {\r\n                console.warn(\r\n                    '[flight-critical-css] Critters not installed. Install with: npm install critters'\r\n                );\r\n                critters = null;\r\n            }\r\n        },\r\n\r\n        async transformIndexHtml(html, ctx) {\r\n            if (!enabled || !critters) {\r\n                return html;\r\n            }\r\n\r\n            // Check if this route should be processed\r\n            const path = ctx.path || '';\r\n\r\n            // Check exclusions\r\n            for (const pattern of exclude) {\r\n                if (matchesPattern(path, pattern)) {\r\n                    return html;\r\n                }\r\n            }\r\n\r\n            // Check inclusions\r\n            let shouldProcess = false;\r\n            for (const pattern of include) {\r\n                if (matchesPattern(path, pattern)) {\r\n                    shouldProcess = true;\r\n                    break;\r\n                }\r\n            }\r\n\r\n            if (!shouldProcess) {\r\n                return html;\r\n            }\r\n\r\n            try {\r\n                const processedHtml = await critters.process(html);\r\n\r\n                // Check if critical CSS is too large\r\n                const inlineStyleMatch = processedHtml.match(/<style[^>]*>([\\s\\S]*?)<\\/style>/gi);\r\n                if (inlineStyleMatch) {\r\n                    const totalInlineSize = inlineStyleMatch.reduce(\r\n                        (sum, style) => sum + style.length, 0\r\n                    );\r\n\r\n                    if (totalInlineSize > maxInlinedSize) {\r\n                        console.warn(\r\n                            `[flight-critical-css] Inline CSS (${totalInlineSize} bytes) exceeds max (${maxInlinedSize} bytes) for ${path}`\r\n                        );\r\n                    }\r\n                }\r\n\r\n                if (verbose) {\r\n                    console.log(`[flight-critical-css] Processed: ${path}`);\r\n                }\r\n\r\n                return processedHtml;\r\n            } catch (error) {\r\n                console.error(`[flight-critical-css] Error processing ${path}:`, error);\r\n                return html;\r\n            }\r\n        },\r\n\r\n        async closeBundle() {\r\n            if (verbose && critters) {\r\n                console.log('[flight-critical-css] Critical CSS extraction complete');\r\n            }\r\n        },\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Helper Functions\r\n// ============================================================================\r\n\r\n/**\r\n * Simple glob pattern matching.\r\n */\r\nfunction matchesPattern(path: string, pattern: string): boolean {\r\n    // Convert glob to regex\r\n    const regexPattern = pattern\r\n        .replace(/\\*\\*/g, '{{DOUBLE_STAR}}')\r\n        .replace(/\\*/g, '[^/]*')\r\n        .replace(/\\{\\{DOUBLE_STAR\\}\\}/g, '.*')\r\n        .replace(/\\?/g, '.');\r\n\r\n    const regex = new RegExp(`^${regexPattern}$`);\r\n    return regex.test(path);\r\n}\r\n\r\n// ============================================================================\r\n// CSS Optimization Utilities\r\n// ============================================================================\r\n\r\n/**\r\n * Extract inline styles from HTML.\r\n * Utility for manual critical CSS handling.\r\n */\r\nexport function extractInlineStyles(html: string): {\r\n    html: string;\r\n    styles: string[];\r\n} {\r\n    const styles: string[] = [];\r\n    const cleanedHtml = html.replace(\r\n        /<style[^>]*>([\\s\\S]*?)<\\/style>/gi,\r\n        (match, content) => {\r\n            styles.push(content);\r\n            return '';\r\n        }\r\n    );\r\n\r\n    return { html: cleanedHtml, styles };\r\n}\r\n\r\n/**\r\n * Merge multiple CSS strings into one.\r\n */\r\nexport function mergeCSS(styles: string[]): string {\r\n    return styles\r\n        .map(s => s.trim())\r\n        .filter(Boolean)\r\n        .join('\\n');\r\n}\r\n\r\n/**\r\n * Generate a preload link for a stylesheet.\r\n */\r\nexport function generatePreloadLink(\r\n    href: string,\r\n    strategy: PreloadStrategy\r\n): string {\r\n    switch (strategy) {\r\n        case 'swap':\r\n            return `<link rel=\"preload\" href=\"${href}\" as=\"style\" onload=\"this.onload=null;this.rel='stylesheet'\">`;\r\n        case 'swap-high':\r\n            return `<link rel=\"preload\" href=\"${href}\" as=\"style\" fetchpriority=\"high\" onload=\"this.onload=null;this.rel='stylesheet'\">`;\r\n        case 'media':\r\n            return `<link rel=\"stylesheet\" href=\"${href}\" media=\"print\" onload=\"this.media='all'\">`;\r\n        case 'js':\r\n            return `<script>\r\n                (function(){var l=document.createElement('link');l.rel='stylesheet';l.href='${href}';document.head.appendChild(l);})();\r\n            </script>`;\r\n        case 'js-lazy':\r\n            return `<script>\r\n                requestIdleCallback(function(){var l=document.createElement('link');l.rel='stylesheet';l.href='${href}';document.head.appendChild(l);});\r\n            </script>`;\r\n        default:\r\n            return '';\r\n    }\r\n}\r\n\r\n/**\r\n * Generate noscript fallback for preloaded stylesheet.\r\n */\r\nexport function generateNoscriptFallback(href: string): string {\r\n    return `<noscript><link rel=\"stylesheet\" href=\"${href}\"></noscript>`;\r\n}\r\n\r\n// ============================================================================\r\n// Exports\r\n// ============================================================================\r\n\r\nexport default criticalCSS;\r\n","/**\r\n * @flight-framework/core - Build Plugins\r\n *\r\n * Optional Vite plugins for advanced optimizations.\r\n * These plugins are opt-in and require explicit configuration.\r\n * \r\n * Flight doesn't force you to use any of these - use them if you want.\r\n */\r\n\r\n// Critical CSS Plugin (existing)\r\nexport { criticalCSS } from './critical-css.js';\r\nexport type {\r\n    CriticalCSSOptions,\r\n    PreloadStrategy,\r\n} from './critical-css.js';\r\n\r\n// Environment Variables Plugin (NEW)\r\nexport {\r\n    flightEnvPlugin,\r\n    type FlightEnvPluginOptions,\r\n} from './env-plugin.js';\r\n\r\n// Server Boundary Plugin (NEW)\r\nexport {\r\n    serverBoundaryPlugin,\r\n    type ServerBoundaryPluginOptions,\r\n} from './server-boundary-plugin.js';\r\n\r\n// ============================================================================\r\n// Convenience Presets\r\n// ============================================================================\r\n\r\nimport type { Plugin } from 'vite';\r\nimport { flightEnvPlugin, type FlightEnvPluginOptions } from './env-plugin.js';\r\nimport { serverBoundaryPlugin, type ServerBoundaryPluginOptions } from './server-boundary-plugin.js';\r\n\r\n/**\r\n * Recommended plugins for most apps.\r\n * Provides sensible defaults with warnings for violations.\r\n */\r\nexport function flightRecommendedPlugins(options?: {\r\n    env?: FlightEnvPluginOptions;\r\n    serverBoundary?: ServerBoundaryPluginOptions;\r\n}): Plugin[] {\r\n    return [\r\n        flightEnvPlugin({\r\n            privateVarBehavior: 'warn',\r\n            ...options?.env,\r\n        }),\r\n        serverBoundaryPlugin({\r\n            violationBehavior: 'warn',\r\n            ...options?.serverBoundary,\r\n        }),\r\n    ];\r\n}\r\n\r\n/**\r\n * Strict mode plugins - errors instead of warnings.\r\n * Recommended for production builds.\r\n */\r\nexport function flightStrictPlugins(options?: {\r\n    env?: FlightEnvPluginOptions;\r\n    serverBoundary?: ServerBoundaryPluginOptions;\r\n}): Plugin[] {\r\n    return [\r\n        flightEnvPlugin({\r\n            privateVarBehavior: 'error',\r\n            ...options?.env,\r\n        }),\r\n        serverBoundaryPlugin({\r\n            violationBehavior: 'error',\r\n            ...options?.serverBoundary,\r\n        }),\r\n    ];\r\n}\r\n"]}
+{"version":3,"sources":["../../src/plugins/critical-css.ts","../../src/plugins/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * @flight-framework/core - Critical CSS Plugin\r\n *\r\n * Extract and inline critical CSS for improved Core Web Vitals.\r\n * Uses Critters under the hood for CSS extraction.\r\n *\r\n * This is an OPTIONAL plugin. Install 'critters' only if you use it.\r\n *\r\n * @example\r\n * ```typescript\r\n * // vite.config.ts\r\n * import { criticalCSS } from '@flight-framework/core/plugins';\r\n *\r\n * export default defineConfig({\r\n *     plugins: [\r\n *         criticalCSS({\r\n *             preload: 'swap',\r\n *             pruneSource: false,\r\n *         }),\r\n *     ],\r\n * });\r\n * ```\r\n */\r\n\r\nimport type { Plugin, ResolvedConfig } from 'vite';\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Preload strategy for non-critical CSS.\r\n *\r\n * - 'body': Move stylesheet links to end of body\r\n * - 'media': Use media=\"print\" and swap to \"all\" on load\r\n * - 'swap': Use link rel=\"preload\" and swap to stylesheet\r\n * - 'swap-high': Like swap, with fetchpriority=\"high\"\r\n * - 'js': Load via JavaScript\r\n * - 'js-lazy': Load via JavaScript when idle\r\n * - false: Don't preload\r\n */\r\nexport type PreloadStrategy =\r\n    | 'body'\r\n    | 'media'\r\n    | 'swap'\r\n    | 'swap-high'\r\n    | 'js'\r\n    | 'js-lazy'\r\n    | false;\r\n\r\n/**\r\n * Critical CSS plugin options.\r\n */\r\nexport interface CriticalCSSOptions {\r\n    /**\r\n     * Enable critical CSS extraction.\r\n     * @default true in production\r\n     */\r\n    enabled?: boolean;\r\n\r\n    /**\r\n     * Strategy for loading non-critical CSS.\r\n     * @default 'swap'\r\n     */\r\n    preload?: PreloadStrategy;\r\n\r\n    /**\r\n     * Remove inlined CSS rules from the source stylesheet.\r\n     * Reduces duplicate CSS but may cause issues with JS frameworks.\r\n     * @default false\r\n     */\r\n    pruneSource?: boolean;\r\n\r\n    /**\r\n     * Remove unused CSS selectors from critical CSS.\r\n     * @default true\r\n     */\r\n    reduceInlineStyles?: boolean;\r\n\r\n    /**\r\n     * Merge adjacent inline <style> tags.\r\n     * @default true\r\n     */\r\n    mergeStylesheets?: boolean;\r\n\r\n    /**\r\n     * Additional CSS selectors to always include as critical.\r\n     */\r\n    additionalStylesheets?: string[];\r\n\r\n    /**\r\n     * CSS selectors to exclude from critical extraction.\r\n     */\r\n    excludeSelectors?: string[];\r\n\r\n    /**\r\n     * Routes to include (glob patterns).\r\n     * @default ['**\\/*.html']\r\n     */\r\n    include?: string[];\r\n\r\n    /**\r\n     * Routes to exclude (glob patterns).\r\n     * @default ['/api/**']\r\n     */\r\n    exclude?: string[];\r\n\r\n    /**\r\n     * Inline external fonts.\r\n     * @default false\r\n     */\r\n    inlineFonts?: boolean;\r\n\r\n    /**\r\n     * Preload external fonts.\r\n     * @default true\r\n     */\r\n    preloadFonts?: boolean;\r\n\r\n    /**\r\n     * Maximum size of inlined CSS (in bytes).\r\n     * Larger stylesheets will be loaded normally.\r\n     * @default 100000 (100KB)\r\n     */\r\n    maxInlinedSize?: number;\r\n\r\n    /**\r\n     * Log extraction stats.\r\n     * @default true\r\n     */\r\n    verbose?: boolean;\r\n}\r\n\r\n// ============================================================================\r\n// Critters Integration\r\n// ============================================================================\r\n\r\n/**\r\n * Critters options interface (subset of full Critters options).\r\n * Full options available at: https://github.com/GoogleChromeLabs/critters\r\n */\r\ninterface CrittersOptions {\r\n    preload?: PreloadStrategy;\r\n    pruneSource?: boolean;\r\n    reduceInlineStyles?: boolean;\r\n    mergeStylesheets?: boolean;\r\n    external?: boolean;\r\n    inlineFonts?: boolean;\r\n    preloadFonts?: boolean;\r\n    additionalStylesheets?: string[];\r\n    noscriptFallback?: boolean;\r\n    path?: string;\r\n    publicPath?: string;\r\n    logLevel?: 'info' | 'warn' | 'error' | 'trace' | 'debug' | 'silent';\r\n}\r\n\r\n// ============================================================================\r\n// Vite Plugin\r\n// ============================================================================\r\n\r\n/**\r\n * Vite plugin for critical CSS extraction.\r\n *\r\n * This plugin extracts critical (above-the-fold) CSS and inlines it\r\n * in the HTML, deferring non-critical CSS for better performance.\r\n *\r\n * Requires 'critters' as a peer dependency:\r\n * ```bash\r\n * npm install critters\r\n * ```\r\n *\r\n * @param options - Plugin configuration\r\n * @returns Vite plugin\r\n */\r\nexport function criticalCSS(options: CriticalCSSOptions = {}): Plugin {\r\n    const {\r\n        preload = 'swap',\r\n        pruneSource = false,\r\n        reduceInlineStyles = true,\r\n        mergeStylesheets = true,\r\n        additionalStylesheets = [],\r\n        inlineFonts = false,\r\n        preloadFonts = true,\r\n        maxInlinedSize = 100000,\r\n        include = ['**/*.html'],\r\n        exclude = ['/api/**'],\r\n        verbose = true,\r\n    } = options;\r\n\r\n    let config: ResolvedConfig;\r\n    let isProduction = false;\r\n    let enabled = options.enabled;\r\n    let critters: {\r\n        process: (html: string) => Promise<string>;\r\n    } | null = null;\r\n\r\n    return {\r\n        name: 'flight-critical-css',\r\n        enforce: 'post',\r\n        apply: 'build',\r\n\r\n        configResolved(resolvedConfig) {\r\n            config = resolvedConfig;\r\n            isProduction = resolvedConfig.command === 'build';\r\n\r\n            // Enable by default only in production\r\n            if (enabled === undefined) {\r\n                enabled = isProduction;\r\n            }\r\n        },\r\n\r\n        async buildStart() {\r\n            if (!enabled) return;\r\n\r\n            try {\r\n                // Dynamic import of Critters (optional peer dependency)\r\n                // @ts-expect-error - critters has broken type exports in its package.json\r\n                const CrittersModule = await import('critters');\r\n                const Critters = CrittersModule.default || CrittersModule;\r\n\r\n                const crittersOptions: CrittersOptions = {\r\n                    preload,\r\n                    pruneSource,\r\n                    reduceInlineStyles,\r\n                    mergeStylesheets,\r\n                    inlineFonts,\r\n                    preloadFonts,\r\n                    additionalStylesheets,\r\n                    external: true,\r\n                    noscriptFallback: true,\r\n                    path: config.build.outDir,\r\n                    publicPath: config.base || '/',\r\n                    logLevel: verbose ? 'info' : 'silent',\r\n                };\r\n\r\n                critters = new Critters(crittersOptions);\r\n\r\n                if (verbose) {\r\n                    console.log('[flight-critical-css] Critical CSS extraction enabled');\r\n                }\r\n            } catch (error) {\r\n                console.warn(\r\n                    '[flight-critical-css] Critters not installed. Install with: npm install critters'\r\n                );\r\n                critters = null;\r\n            }\r\n        },\r\n\r\n        async transformIndexHtml(html, ctx) {\r\n            if (!enabled || !critters) {\r\n                return html;\r\n            }\r\n\r\n            // Check if this route should be processed\r\n            const path = ctx.path || '';\r\n\r\n            // Check exclusions\r\n            for (const pattern of exclude) {\r\n                if (matchesPattern(path, pattern)) {\r\n                    return html;\r\n                }\r\n            }\r\n\r\n            // Check inclusions\r\n            let shouldProcess = false;\r\n            for (const pattern of include) {\r\n                if (matchesPattern(path, pattern)) {\r\n                    shouldProcess = true;\r\n                    break;\r\n                }\r\n            }\r\n\r\n            if (!shouldProcess) {\r\n                return html;\r\n            }\r\n\r\n            try {\r\n                const processedHtml = await critters.process(html);\r\n\r\n                // Check if critical CSS is too large\r\n                const inlineStyleMatch = processedHtml.match(/<style[^>]*>([\\s\\S]*?)<\\/style>/gi);\r\n                if (inlineStyleMatch) {\r\n                    const totalInlineSize = inlineStyleMatch.reduce(\r\n                        (sum, style) => sum + style.length, 0\r\n                    );\r\n\r\n                    if (totalInlineSize > maxInlinedSize) {\r\n                        console.warn(\r\n                            `[flight-critical-css] Inline CSS (${totalInlineSize} bytes) exceeds max (${maxInlinedSize} bytes) for ${path}`\r\n                        );\r\n                    }\r\n                }\r\n\r\n                if (verbose) {\r\n                    console.log(`[flight-critical-css] Processed: ${path}`);\r\n                }\r\n\r\n                return processedHtml;\r\n            } catch (error) {\r\n                console.error(`[flight-critical-css] Error processing ${path}:`, error);\r\n                return html;\r\n            }\r\n        },\r\n\r\n        async closeBundle() {\r\n            if (verbose && critters) {\r\n                console.log('[flight-critical-css] Critical CSS extraction complete');\r\n            }\r\n        },\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Helper Functions\r\n// ============================================================================\r\n\r\n/**\r\n * Simple glob pattern matching.\r\n */\r\nfunction matchesPattern(path: string, pattern: string): boolean {\r\n    // Convert glob to regex\r\n    const regexPattern = pattern\r\n        .replace(/\\*\\*/g, '{{DOUBLE_STAR}}')\r\n        .replace(/\\*/g, '[^/]*')\r\n        .replace(/\\{\\{DOUBLE_STAR\\}\\}/g, '.*')\r\n        .replace(/\\?/g, '.');\r\n\r\n    const regex = new RegExp(`^${regexPattern}$`);\r\n    return regex.test(path);\r\n}\r\n\r\n// ============================================================================\r\n// CSS Optimization Utilities\r\n// ============================================================================\r\n\r\n/**\r\n * Extract inline styles from HTML.\r\n * Utility for manual critical CSS handling.\r\n */\r\nexport function extractInlineStyles(html: string): {\r\n    html: string;\r\n    styles: string[];\r\n} {\r\n    const styles: string[] = [];\r\n    const cleanedHtml = html.replace(\r\n        /<style[^>]*>([\\s\\S]*?)<\\/style>/gi,\r\n        (match, content) => {\r\n            styles.push(content);\r\n            return '';\r\n        }\r\n    );\r\n\r\n    return { html: cleanedHtml, styles };\r\n}\r\n\r\n/**\r\n * Merge multiple CSS strings into one.\r\n */\r\nexport function mergeCSS(styles: string[]): string {\r\n    return styles\r\n        .map(s => s.trim())\r\n        .filter(Boolean)\r\n        .join('\\n');\r\n}\r\n\r\n/**\r\n * Generate a preload link for a stylesheet.\r\n */\r\nexport function generatePreloadLink(\r\n    href: string,\r\n    strategy: PreloadStrategy\r\n): string {\r\n    switch (strategy) {\r\n        case 'swap':\r\n            return `<link rel=\"preload\" href=\"${href}\" as=\"style\" onload=\"this.onload=null;this.rel='stylesheet'\">`;\r\n        case 'swap-high':\r\n            return `<link rel=\"preload\" href=\"${href}\" as=\"style\" fetchpriority=\"high\" onload=\"this.onload=null;this.rel='stylesheet'\">`;\r\n        case 'media':\r\n            return `<link rel=\"stylesheet\" href=\"${href}\" media=\"print\" onload=\"this.media='all'\">`;\r\n        case 'js':\r\n            return `<script>\r\n                (function(){var l=document.createElement('link');l.rel='stylesheet';l.href='${href}';document.head.appendChild(l);})();\r\n            </script>`;\r\n        case 'js-lazy':\r\n            return `<script>\r\n                requestIdleCallback(function(){var l=document.createElement('link');l.rel='stylesheet';l.href='${href}';document.head.appendChild(l);});\r\n            </script>`;\r\n        default:\r\n            return '';\r\n    }\r\n}\r\n\r\n/**\r\n * Generate noscript fallback for preloaded stylesheet.\r\n */\r\nexport function generateNoscriptFallback(href: string): string {\r\n    return `<noscript><link rel=\"stylesheet\" href=\"${href}\"></noscript>`;\r\n}\r\n\r\n// ============================================================================\r\n// Exports\r\n// ============================================================================\r\n\r\nexport default criticalCSS;\r\n","/**\r\n * @flight-framework/core - Vite Plugins\r\n * \r\n * Optional Vite plugins for Flight Framework.\r\n * All plugins are opt-in - use only what you need.\r\n */\r\n\r\n// Environment Variables Plugin\r\nexport { flightEnvPlugin, type FlightEnvPluginOptions } from './env-plugin.js';\r\n\r\n// Server Boundary Plugin (DEPRECATED)\r\nexport {\r\n    serverBoundaryPlugin,\r\n    type ServerBoundaryPluginOptions\r\n} from './server-boundary-plugin.js';\r\n\r\n// Critical CSS (existing)\r\nexport { criticalCSS } from './critical-css.js';\r\n\r\n// ============================================================================\r\n// Convenience Presets\r\n// ============================================================================\r\n\r\nimport type { Plugin } from 'vite';\r\nimport { flightEnvPlugin, type FlightEnvPluginOptions } from './env-plugin.js';\r\n\r\nexport interface FlightPluginsOptions {\r\n    env?: FlightEnvPluginOptions;\r\n}\r\n\r\n/**\r\n * Recommended Flight plugins for most projects.\r\n * Currently only includes the env plugin (serverBoundaryPlugin is deprecated).\r\n * \r\n * @example\r\n * ```typescript\r\n * // vite.config.ts\r\n * import { flightRecommendedPlugins } from '@flight-framework/core/plugins';\r\n * \r\n * export default {\r\n *   plugins: [...flightRecommendedPlugins()],\r\n * };\r\n * ```\r\n */\r\nexport function flightRecommendedPlugins(options: FlightPluginsOptions = {}): Plugin[] {\r\n    return [\r\n        flightEnvPlugin(options.env),\r\n    ];\r\n}\r\n\r\n/**\r\n * @deprecated Use flightRecommendedPlugins instead.\r\n * Strict plugins are no longer needed since serverBoundaryPlugin is deprecated.\r\n */\r\nexport function flightStrictPlugins(options: FlightPluginsOptions = {}): Plugin[] {\r\n    console.warn('[Flight] flightStrictPlugins is deprecated. Use flightRecommendedPlugins instead.');\r\n    return flightRecommendedPlugins(options);\r\n}\r\n"]}

package/dist/plugins/server-boundary-plugin.d.ts

@@ -1,67 +1,40 @@
 import { Plugin } from 'vite';
 
 /**
- * @flight-framework/core - Server Boundary Plugin
+ * @flight-framework/core - Server Boundary Plugin (DEPRECATED)
  *
- * Vite plugin to detect server-only code imported in client bundles.
- * OPTIONAL - use if you want build-time protection.
+ * This plugin has been deprecated due to conflicts with serverActionsPlugin.
  *
- * Features:
- * - Detects *.server.ts files imported in client code
- * - Detects /server/ and /api/ directory imports
- * - Configurable behavior (warn, error)
- * - Clear error messages with solutions
+ * The intended functionality (detecting server-only imports in client bundles)
+ * is difficult to implement correctly with Vite's plugin system because:
+ *
+ * 1. It conflicts with serverActionsPlugin which transforms 'use server' files
+ * 2. The resolveId hook runs before transforms, making detection unreliable
+ * 3. Vite 6+ has different environment APIs that need careful handling
+ *
+ * For now, use runtime guards instead:
  *
  * @example
  * ```typescript
- * // vite.config.ts
- * import { serverBoundaryPlugin } from '@flight-framework/core/plugins';
+ * import { assertServer } from '@flight-framework/core';
  *
- * export default {
- *   plugins: [serverBoundaryPlugin()],
- * };
+ * export function getSecretData() {
+ *   assertServer('getSecretData'); // Throws if called on client
+ *   return process.env.SECRET_KEY;
+ * }
  * ```
+ *
+ * @deprecated Use runtime guards (assertServer, assertClient) instead
  */
 
 interface ServerBoundaryPluginOptions {
-    /**
-     * File patterns that are server-only.
-     * @default ['.server.ts', '.server.tsx', '.server.js', '.server.jsx']
-     */
-    serverFilePatterns?: string[];
-    /**
-     * Directory patterns that are server-only.
-     * @default ['/server/', '/api/']
-     */
-    serverDirPatterns?: string[];
-    /**
-     * How to handle violations.
-     * - 'error': Build error (recommended for production)
-     * - 'warn': Warning only (for migration)
-     * @default 'error'
-     */
-    violationBehavior?: 'error' | 'warn';
-    /**
-     * Custom error message template.
-     */
-    customErrorMessage?: (module: string, importer: string) => string;
-    /**
-     * Files to exclude from checking (e.g., tests).
-     * @default ['**\/*.test.*', '**\/*.spec.*']
-     */
-    exclude?: string[];
+    /** @deprecated This plugin is deprecated */
+    enabled?: boolean;
 }
 /**
- * Vite plugin to detect server-only imports in client code.
- *
- * This plugin is OPTIONAL. Use it if you want build-time
- * detection of server code leaking to the client.
- *
- * By default, it will:
- * - Block imports of *.server.ts files in client code
- * - Block imports from /server/ and /api/ directories
- * - Throw build errors with clear solutions
+ * @deprecated This plugin has been deprecated due to conflicts with serverActionsPlugin.
+ * Use runtime guards (assertServer, assertClient) from '@flight-framework/core' instead.
  */
-declare function serverBoundaryPlugin(options?: ServerBoundaryPluginOptions): Plugin;
+declare function serverBoundaryPlugin(_options?: ServerBoundaryPluginOptions): Plugin;
 
 export { type ServerBoundaryPluginOptions, serverBoundaryPlugin };

package/dist/plugins/server-boundary-plugin.js

@@ -1,3 +1,3 @@
-export { serverBoundaryPlugin } from '../chunk-56ZZNOJD.js';
+export { serverBoundaryPlugin } from '../chunk-J7WEZXWH.js';
 //# sourceMappingURL=server-boundary-plugin.js.map
 //# sourceMappingURL=server-boundary-plugin.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flight-framework/core",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "Core primitives for Flight Framework - routing, rendering, caching, server/client boundaries",
   "keywords": [
     "flight",

package/dist/chunk-56ZZNOJD.js

@@ -1,93 +0,0 @@
-// src/plugins/server-boundary-plugin.ts
-function serverBoundaryPlugin(options = {}) {
-  const {
-    serverFilePatterns = [".server.ts", ".server.tsx", ".server.js", ".server.jsx"],
-    serverDirPatterns = ["/server/", "/api/"],
-    violationBehavior = "error",
-    customErrorMessage,
-    exclude = ["**/*.test.*", "**/*.spec.*", "**/node_modules/**"]
-  } = options;
-  const filePatterns = serverFilePatterns.map(
-    (p) => new RegExp(p.replace(/\./g, "\\.") + "$", "i")
-  );
-  const dirPatterns = serverDirPatterns.map(
-    (p) => new RegExp(p.replace(/\//g, "[\\\\/]"), "i")
-  );
-  function isServerOnlyModule(id) {
-    for (const pattern of filePatterns) {
-      if (pattern.test(id)) return true;
-    }
-    for (const pattern of dirPatterns) {
-      if (pattern.test(id)) return true;
-    }
-    return false;
-  }
-  function isExcluded(id) {
-    for (const pattern of exclude) {
-      const regex = new RegExp(
-        pattern.replace(/\*\*/g, ".*").replace(/\*/g, "[^/\\\\]*").replace(/\./g, "\\.")
-      );
-      if (regex.test(id)) return true;
-    }
-    return false;
-  }
-  function createErrorMessage(module, importer) {
-    if (customErrorMessage) {
-      return customErrorMessage(module, importer);
-    }
-    return `[Flight] Cannot import server-only module in client code.
-
-  Module: ${module}
-  Imported by: ${importer}
-
-Solutions:
-  1. Move the import to a 'use server' file
-  2. Use an API route instead
-  3. Use dynamic import with typeof window check
-  4. Rename the importing file to *.server.ts
-
-Learn more: https://flight-framework.dev/docs/server-client-boundaries`;
-  }
-  return {
-    name: "flight:server-boundary",
-    enforce: "pre",
-    resolveId(source, importer, options2) {
-      if (options2?.ssr) return null;
-      if (!importer) return null;
-      if (isExcluded(importer)) return null;
-      if (isServerOnlyModule(importer)) return null;
-      if (isServerOnlyModule(source)) {
-        const message = createErrorMessage(source, importer);
-        if (violationBehavior === "error") {
-          this.error(message);
-        } else {
-          this.warn(message);
-        }
-      }
-      return null;
-    },
-    transform(code, id, options2) {
-      if (options2?.ssr) return null;
-      if (isExcluded(id)) return null;
-      if (isServerOnlyModule(id)) return null;
-      const trimmed = code.trim();
-      if (trimmed.startsWith("'use server'") || trimmed.startsWith('"use server"')) {
-        const message = `[Flight] 'use server' file imported in client bundle.
-
-  File: ${id}
-
-This file should only run on the server. Check your import graph to find where this is imported.`;
-        if (violationBehavior === "error") {
-          this.error(message);
-        } else {
-          this.warn(message);
-        }
-      }
-      return null;
-    }
-  };
-}
-
-export { serverBoundaryPlugin };
-//# sourceMappingURL=chunk-56ZZNOJD.js.map
-//# sourceMappingURL=chunk-56ZZNOJD.js.map

package/dist/chunk-56ZZNOJD.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/plugins/server-boundary-plugin.ts"],"names":["options"],"mappings":"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","file":"chunk-56ZZNOJD.js","sourcesContent":["/**\r\n * @flight-framework/core - Server Boundary Plugin\r\n * \r\n * Vite plugin to detect server-only code imported in client bundles.\r\n * OPTIONAL - use if you want build-time protection.\r\n * \r\n * Features:\r\n * - Detects *.server.ts files imported in client code\r\n * - Detects /server/ and /api/ directory imports\r\n * - Configurable behavior (warn, error)\r\n * - Clear error messages with solutions\r\n * \r\n * @example\r\n * ```typescript\r\n * // vite.config.ts\r\n * import { serverBoundaryPlugin } from '@flight-framework/core/plugins';\r\n * \r\n * export default {\r\n *   plugins: [serverBoundaryPlugin()],\r\n * };\r\n * ```\r\n */\r\n\r\nimport type { Plugin } from 'vite';\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\nexport interface ServerBoundaryPluginOptions {\r\n    /**\r\n     * File patterns that are server-only.\r\n     * @default ['.server.ts', '.server.tsx', '.server.js', '.server.jsx']\r\n     */\r\n    serverFilePatterns?: string[];\r\n\r\n    /**\r\n     * Directory patterns that are server-only.\r\n     * @default ['/server/', '/api/']\r\n     */\r\n    serverDirPatterns?: string[];\r\n\r\n    /**\r\n     * How to handle violations.\r\n     * - 'error': Build error (recommended for production)\r\n     * - 'warn': Warning only (for migration)\r\n     * @default 'error'\r\n     */\r\n    violationBehavior?: 'error' | 'warn';\r\n\r\n    /**\r\n     * Custom error message template.\r\n     */\r\n    customErrorMessage?: (module: string, importer: string) => string;\r\n\r\n    /**\r\n     * Files to exclude from checking (e.g., tests).\r\n     * @default ['**\\/*.test.*', '**\\/*.spec.*']\r\n     */\r\n    exclude?: string[];\r\n}\r\n\r\n// ============================================================================\r\n// Plugin\r\n// ============================================================================\r\n\r\n/**\r\n * Vite plugin to detect server-only imports in client code.\r\n * \r\n * This plugin is OPTIONAL. Use it if you want build-time\r\n * detection of server code leaking to the client.\r\n * \r\n * By default, it will:\r\n * - Block imports of *.server.ts files in client code\r\n * - Block imports from /server/ and /api/ directories\r\n * - Throw build errors with clear solutions\r\n */\r\nexport function serverBoundaryPlugin(\r\n    options: ServerBoundaryPluginOptions = {}\r\n): Plugin {\r\n    const {\r\n        serverFilePatterns = ['.server.ts', '.server.tsx', '.server.js', '.server.jsx'],\r\n        serverDirPatterns = ['/server/', '/api/'],\r\n        violationBehavior = 'error',\r\n        customErrorMessage,\r\n        exclude = ['**/*.test.*', '**/*.spec.*', '**/node_modules/**'],\r\n    } = options;\r\n\r\n    // Build regex patterns\r\n    const filePatterns = serverFilePatterns.map(p =>\r\n        new RegExp(p.replace(/\\./g, '\\\\.') + '$', 'i')\r\n    );\r\n    const dirPatterns = serverDirPatterns.map(p =>\r\n        new RegExp(p.replace(/\\//g, '[\\\\\\\\/]'), 'i')\r\n    );\r\n\r\n    function isServerOnlyModule(id: string): boolean {\r\n        // Check file patterns\r\n        for (const pattern of filePatterns) {\r\n            if (pattern.test(id)) return true;\r\n        }\r\n\r\n        // Check directory patterns\r\n        for (const pattern of dirPatterns) {\r\n            if (pattern.test(id)) return true;\r\n        }\r\n\r\n        return false;\r\n    }\r\n\r\n    function isExcluded(id: string): boolean {\r\n        for (const pattern of exclude) {\r\n            // Simple glob matching\r\n            const regex = new RegExp(\r\n                pattern\r\n                    .replace(/\\*\\*/g, '.*')\r\n                    .replace(/\\*/g, '[^/\\\\\\\\]*')\r\n                    .replace(/\\./g, '\\\\.')\r\n            );\r\n            if (regex.test(id)) return true;\r\n        }\r\n        return false;\r\n    }\r\n\r\n    function createErrorMessage(module: string, importer: string): string {\r\n        if (customErrorMessage) {\r\n            return customErrorMessage(module, importer);\r\n        }\r\n\r\n        return (\r\n            `[Flight] Cannot import server-only module in client code.\\n\\n` +\r\n            `  Module: ${module}\\n` +\r\n            `  Imported by: ${importer}\\n\\n` +\r\n            `Solutions:\\n` +\r\n            `  1. Move the import to a 'use server' file\\n` +\r\n            `  2. Use an API route instead\\n` +\r\n            `  3. Use dynamic import with typeof window check\\n` +\r\n            `  4. Rename the importing file to *.server.ts\\n\\n` +\r\n            `Learn more: https://flight-framework.dev/docs/server-client-boundaries`\r\n        );\r\n    }\r\n\r\n    return {\r\n        name: 'flight:server-boundary',\r\n        enforce: 'pre',\r\n\r\n        resolveId(source, importer, options) {\r\n            // Skip SSR builds - server can import anything\r\n            if (options?.ssr) return null;\r\n\r\n            // Need an importer to check\r\n            if (!importer) return null;\r\n\r\n            // Skip excluded files\r\n            if (isExcluded(importer)) return null;\r\n\r\n            // Skip if importer is also server-only\r\n            if (isServerOnlyModule(importer)) return null;\r\n\r\n            // Check if the import target is server-only\r\n            // This is a simplified check - the resolved ID would be more accurate\r\n            if (isServerOnlyModule(source)) {\r\n                const message = createErrorMessage(source, importer);\r\n\r\n                if (violationBehavior === 'error') {\r\n                    this.error(message);\r\n                } else {\r\n                    this.warn(message);\r\n                }\r\n            }\r\n\r\n            return null;\r\n        },\r\n\r\n        transform(code, id, options) {\r\n            // Skip SSR builds\r\n            if (options?.ssr) return null;\r\n\r\n            // Skip excluded files\r\n            if (isExcluded(id)) return null;\r\n\r\n            // Skip server-only files (they shouldn't be in client bundle anyway)\r\n            if (isServerOnlyModule(id)) return null;\r\n\r\n            // Check for 'use server' directive at file level\r\n            const trimmed = code.trim();\r\n            if (trimmed.startsWith(\"'use server'\") || trimmed.startsWith('\"use server\"')) {\r\n                const message =\r\n                    `[Flight] 'use server' file imported in client bundle.\\n\\n` +\r\n                    `  File: ${id}\\n\\n` +\r\n                    `This file should only run on the server. ` +\r\n                    `Check your import graph to find where this is imported.`;\r\n\r\n                if (violationBehavior === 'error') {\r\n                    this.error(message);\r\n                } else {\r\n                    this.warn(message);\r\n                }\r\n            }\r\n\r\n            return null;\r\n        },\r\n    };\r\n}\r\n"]}

package/dist/chunk-RFTE6JVG.js

@@ -1,88 +0,0 @@
-// src/plugins/env-plugin.ts
-function flightEnvPlugin(options = {}) {
-  const {
-    publicPrefix = "FLIGHT_PUBLIC_",
-    additionalPublicPrefixes = ["VITE_"],
-    privateVarBehavior = "warn",
-    allowList = ["NODE_ENV", "MODE"]
-  } = options;
-  const allPublicPrefixes = [publicPrefix, ...additionalPublicPrefixes];
-  return {
-    name: "flight:env",
-    enforce: "pre",
-    configResolved(resolvedConfig) {
-    },
-    config(_, { isSsrBuild }) {
-      if (isSsrBuild) return {};
-      const publicEnvVars = {};
-      for (const [key, value] of Object.entries(process.env)) {
-        if (value !== void 0 && isPublicKey(key, allPublicPrefixes, allowList)) {
-          publicEnvVars[`process.env.${key}`] = JSON.stringify(value);
-        }
-      }
-      return {
-        define: publicEnvVars
-      };
-    },
-    transform(code, id, options2) {
-      if (options2?.ssr) return null;
-      if (id.includes("node_modules")) return null;
-      if (!code.includes("process.env.")) return null;
-      const envVarPattern = /process\.env\.([A-Z_][A-Z0-9_]*)/g;
-      let hasModifications = false;
-      let modifiedCode = code;
-      let match;
-      const issues = [];
-      while ((match = envVarPattern.exec(code)) !== null) {
-        const varName = match[1];
-        if (isPublicKey(varName, allPublicPrefixes, allowList)) {
-          continue;
-        }
-        hasModifications = true;
-        if (privateVarBehavior === "error") {
-          issues.push(
-            `Private env var "${varName}" accessed in client code.
-  File: ${id}
-  Use FLIGHT_PUBLIC_${varName} if this should be public.`
-          );
-        } else if (privateVarBehavior === "warn") {
-          console.warn(
-            `[Flight] Private env var "process.env.${varName}" in ${id}
-  \u2192 Replaced with undefined for security.
-  \u2192 Use FLIGHT_PUBLIC_${varName} if this should be public.`
-          );
-        }
-        modifiedCode = modifiedCode.replace(
-          new RegExp(`process\\.env\\.${varName}`, "g"),
-          "undefined"
-        );
-      }
-      if (issues.length > 0 && privateVarBehavior === "error") {
-        throw new Error(
-          `[Flight] Environment variable security violations:
-
-${issues.join("\n\n")}`
-        );
-      }
-      if (hasModifications) {
-        return {
-          code: modifiedCode,
-          map: null
-          // TODO: source map
-        };
-      }
-      return null;
-    }
-  };
-}
-function isPublicKey(key, prefixes, allowList) {
-  if (allowList.includes(key)) return true;
-  for (const prefix of prefixes) {
-    if (key.startsWith(prefix)) return true;
-  }
-  return false;
-}
-
-export { flightEnvPlugin };
-//# sourceMappingURL=chunk-RFTE6JVG.js.map
-//# sourceMappingURL=chunk-RFTE6JVG.js.map

package/dist/chunk-RFTE6JVG.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/plugins/env-plugin.ts"],"names":["options"],"mappings":"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","file":"chunk-RFTE6JVG.js","sourcesContent":["/**\r\n * @flight-framework/core - Environment Variables Plugin\r\n * \r\n * Vite plugin for environment variable protection.\r\n * OPTIONAL - use if you want build-time protection.\r\n * \r\n * Features:\r\n * - FLIGHT_PUBLIC_* and VITE_* accessible on client\r\n * - Other vars replaced with undefined on client\r\n * - Configurable behavior (warn, error, silent)\r\n * \r\n * @example\r\n * ```typescript\r\n * // vite.config.ts\r\n * import { flightEnvPlugin } from '@flight-framework/core/plugins';\r\n * \r\n * export default {\r\n *   plugins: [flightEnvPlugin()],\r\n * };\r\n * ```\r\n */\r\n\r\nimport type { Plugin, ResolvedConfig } from 'vite';\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\nexport interface FlightEnvPluginOptions {\r\n    /**\r\n     * Prefix for public environment variables.\r\n     * Variables with this prefix will be accessible on the client.\r\n     * @default 'FLIGHT_PUBLIC_'\r\n     */\r\n    publicPrefix?: string;\r\n\r\n    /**\r\n     * Additional prefixes to treat as public.\r\n     * @default ['VITE_']\r\n     */\r\n    additionalPublicPrefixes?: string[];\r\n\r\n    /**\r\n     * How to handle private vars accessed in client code.\r\n     * - 'warn': Log warning, replace with undefined\r\n     * - 'error': Throw build error\r\n     * - 'silent': Replace with undefined, no warning\r\n     * @default 'warn'\r\n     */\r\n    privateVarBehavior?: 'warn' | 'error' | 'silent';\r\n\r\n    /**\r\n     * Specific variables to allow (bypass prefix check).\r\n     * @default ['NODE_ENV', 'MODE']\r\n     */\r\n    allowList?: string[];\r\n}\r\n\r\n// ============================================================================\r\n// Plugin\r\n// ============================================================================\r\n\r\n/**\r\n * Vite plugin to protect environment variables.\r\n * \r\n * This plugin is OPTIONAL. Use it if you want build-time\r\n * protection for your environment variables.\r\n * \r\n * By default, it will:\r\n * - Allow FLIGHT_PUBLIC_* and VITE_* on client\r\n * - Allow NODE_ENV and MODE\r\n * - Replace other process.env.* with undefined on client\r\n * - Show warnings in development\r\n */\r\nexport function flightEnvPlugin(options: FlightEnvPluginOptions = {}): Plugin {\r\n    const {\r\n        publicPrefix = 'FLIGHT_PUBLIC_',\r\n        additionalPublicPrefixes = ['VITE_'],\r\n        privateVarBehavior = 'warn',\r\n        allowList = ['NODE_ENV', 'MODE'],\r\n    } = options;\r\n\r\n    const allPublicPrefixes = [publicPrefix, ...additionalPublicPrefixes];\r\n    let config: ResolvedConfig;\r\n\r\n    return {\r\n        name: 'flight:env',\r\n        enforce: 'pre',\r\n\r\n        configResolved(resolvedConfig) {\r\n            config = resolvedConfig;\r\n        },\r\n\r\n        config(_, { isSsrBuild }) {\r\n            // For SSR builds, don't modify anything\r\n            if (isSsrBuild) return {};\r\n\r\n            // Collect public environment variables\r\n            const publicEnvVars: Record<string, string> = {};\r\n\r\n            for (const [key, value] of Object.entries(process.env)) {\r\n                if (value !== undefined && isPublicKey(key, allPublicPrefixes, allowList)) {\r\n                    publicEnvVars[`process.env.${key}`] = JSON.stringify(value);\r\n                }\r\n            }\r\n\r\n            return {\r\n                define: publicEnvVars,\r\n            };\r\n        },\r\n\r\n        transform(code, id, options) {\r\n            // Skip SSR builds - server can access everything\r\n            if (options?.ssr) return null;\r\n\r\n            // Skip node_modules\r\n            if (id.includes('node_modules')) return null;\r\n\r\n            // Skip if no process.env references\r\n            if (!code.includes('process.env.')) return null;\r\n\r\n            // Find all process.env.VARIABLE_NAME patterns\r\n            const envVarPattern = /process\\.env\\.([A-Z_][A-Z0-9_]*)/g;\r\n            let hasModifications = false;\r\n            let modifiedCode = code;\r\n\r\n            let match;\r\n            const issues: string[] = [];\r\n\r\n            while ((match = envVarPattern.exec(code)) !== null) {\r\n                const varName = match[1];\r\n\r\n                // Skip public vars\r\n                if (isPublicKey(varName, allPublicPrefixes, allowList)) {\r\n                    continue;\r\n                }\r\n\r\n                // Private var accessed in client code\r\n                hasModifications = true;\r\n\r\n                if (privateVarBehavior === 'error') {\r\n                    issues.push(\r\n                        `Private env var \"${varName}\" accessed in client code.\\n` +\r\n                        `  File: ${id}\\n` +\r\n                        `  Use FLIGHT_PUBLIC_${varName} if this should be public.`\r\n                    );\r\n                } else if (privateVarBehavior === 'warn') {\r\n                    console.warn(\r\n                        `[Flight] Private env var \"process.env.${varName}\" in ${id}\\n` +\r\n                        `  → Replaced with undefined for security.\\n` +\r\n                        `  → Use FLIGHT_PUBLIC_${varName} if this should be public.`\r\n                    );\r\n                }\r\n\r\n                // Replace with undefined\r\n                modifiedCode = modifiedCode.replace(\r\n                    new RegExp(`process\\\\.env\\\\.${varName}`, 'g'),\r\n                    'undefined'\r\n                );\r\n            }\r\n\r\n            // Throw if using error mode\r\n            if (issues.length > 0 && privateVarBehavior === 'error') {\r\n                throw new Error(\r\n                    `[Flight] Environment variable security violations:\\n\\n${issues.join('\\n\\n')}`\r\n                );\r\n            }\r\n\r\n            if (hasModifications) {\r\n                return {\r\n                    code: modifiedCode,\r\n                    map: null, // TODO: source map\r\n                };\r\n            }\r\n\r\n            return null;\r\n        },\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Helpers\r\n// ============================================================================\r\n\r\nfunction isPublicKey(\r\n    key: string,\r\n    prefixes: string[],\r\n    allowList: string[]\r\n): boolean {\r\n    // Check allow list\r\n    if (allowList.includes(key)) return true;\r\n\r\n    // Check prefixes\r\n    for (const prefix of prefixes) {\r\n        if (key.startsWith(prefix)) return true;\r\n    }\r\n\r\n    return false;\r\n}\r\n"]}