@flight-framework/core 0.6.1 → 0.6.2

package/dist/{chunk-56ZZNOJD.js → chunk-NU3HX5T7.js}

@@ -2,10 +2,11 @@
 function serverBoundaryPlugin(options = {}) {
   const {
     serverFilePatterns = [".server.ts", ".server.tsx", ".server.js", ".server.jsx"],
-    serverDirPatterns = ["/server/", "/api/"],
-    violationBehavior = "error",
+    serverDirPatterns = ["/server/"],
+    violationBehavior = "warn",
     customErrorMessage,
-    exclude = ["**/*.test.*", "**/*.spec.*", "**/node_modules/**"]
+    exclude = [],
+    skipServerActions = true
   } = options;
   const filePatterns = serverFilePatterns.map(
     (p) => new RegExp(p.replace(/\./g, "\\.") + "$", "i")
@@ -13,6 +14,7 @@ function serverBoundaryPlugin(options = {}) {
   const dirPatterns = serverDirPatterns.map(
     (p) => new RegExp(p.replace(/\//g, "[\\\\/]"), "i")
   );
+  const serverActionFiles = /* @__PURE__ */ new Set();
   function isServerOnlyModule(id) {
     for (const pattern of filePatterns) {
       if (pattern.test(id)) return true;
@@ -23,6 +25,7 @@ function serverBoundaryPlugin(options = {}) {
     return false;
   }
   function isExcluded(id) {
+    if (id.includes("node_modules")) return true;
     for (const pattern of exclude) {
       const regex = new RegExp(
         pattern.replace(/\*\*/g, ".*").replace(/\*/g, "[^/\\\\]*").replace(/\./g, "\\.")
@@ -35,52 +38,36 @@ function serverBoundaryPlugin(options = {}) {
     if (customErrorMessage) {
       return customErrorMessage(module, importer);
     }
-    return `[Flight] Cannot import server-only module in client code.
-
+    return `[Flight] Server-only module imported 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`;
+Solutions: Rename to *.server.ts, add 'use server', or use dynamic import.`;
   }
   return {
     name: "flight:server-boundary",
-    enforce: "pre",
+    enforce: "post",
+    transform(code, id, options2) {
+      if (options2?.ssr) return null;
+      if (skipServerActions) {
+        const trimmed = code.trim();
+        if (trimmed.startsWith("'use server'") || trimmed.startsWith('"use server"')) {
+          serverActionFiles.add(id);
+        }
+      }
+      return null;
+    },
     resolveId(source, importer, options2) {
       if (options2?.ssr) return null;
       if (!importer) return null;
       if (isExcluded(importer)) return null;
+      if (skipServerActions && serverActionFiles.has(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);
+          console.warn(message);
         }
       }
       return null;
@@ -89,5 +76,5 @@ This file should only run on the server. Check your import graph to find where t
 }
 
 export { serverBoundaryPlugin };
-//# sourceMappingURL=chunk-56ZZNOJD.js.map
-//# sourceMappingURL=chunk-56ZZNOJD.js.map
+//# sourceMappingURL=chunk-NU3HX5T7.js.map
+//# sourceMappingURL=chunk-NU3HX5T7.js.map

package/dist/chunk-NU3HX5T7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugins/server-boundary-plugin.ts"],"names":["options"],"mappings":"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","file":"chunk-NU3HX5T7.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 * NOTE: This plugin is designed to work WITH serverActionsPlugin.\r\n * It will NOT flag 'use server' files because those are handled\r\n * by the Server Actions transformation.\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/']\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 'warn'\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.\r\n     */\r\n    exclude?: string[];\r\n\r\n    /**\r\n     * Skip checking 'use server' files. These are handled by serverActionsPlugin.\r\n     * @default true\r\n     */\r\n    skipServerActions?: boolean;\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\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/'],\r\n        violationBehavior = 'warn',\r\n        customErrorMessage,\r\n        exclude = [],\r\n        skipServerActions = true,\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    // Track files with 'use server' to skip them\r\n    const serverActionFiles = new Set<string>();\r\n\r\n    function isServerOnlyModule(id: string): boolean {\r\n        for (const pattern of filePatterns) {\r\n            if (pattern.test(id)) return true;\r\n        }\r\n        for (const pattern of dirPatterns) {\r\n            if (pattern.test(id)) return true;\r\n        }\r\n        return false;\r\n    }\r\n\r\n    function isExcluded(id: string): boolean {\r\n        if (id.includes('node_modules')) return true;\r\n        for (const pattern of exclude) {\r\n            const regex = new RegExp(\r\n                pattern.replace(/\\*\\*/g, '.*').replace(/\\*/g, '[^/\\\\\\\\]*').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        return (\r\n            `[Flight] Server-only module imported in client code.\\n` +\r\n            `  Module: ${module}\\n` +\r\n            `  Imported by: ${importer}\\n` +\r\n            `Solutions: Rename to *.server.ts, add 'use server', or use dynamic import.`\r\n        );\r\n    }\r\n\r\n    return {\r\n        name: 'flight:server-boundary',\r\n        enforce: 'post',\r\n\r\n        transform(code, id, options) {\r\n            if (options?.ssr) return null;\r\n\r\n            // Track 'use server' files\r\n            if (skipServerActions) {\r\n                const trimmed = code.trim();\r\n                if (trimmed.startsWith(\"'use server'\") || trimmed.startsWith('\"use server\"')) {\r\n                    serverActionFiles.add(id);\r\n                }\r\n            }\r\n            return null;\r\n        },\r\n\r\n        resolveId(source, importer, options) {\r\n            if (options?.ssr) return null;\r\n            if (!importer) return null;\r\n            if (isExcluded(importer)) return null;\r\n            if (skipServerActions && serverActionFiles.has(importer)) return null;\r\n            if (isServerOnlyModule(importer)) return null;\r\n\r\n            if (isServerOnlyModule(source)) {\r\n                const message = createErrorMessage(source, importer);\r\n                if (violationBehavior === 'error') {\r\n                    this.error(message);\r\n                } else {\r\n                    console.warn(message);\r\n                }\r\n            }\r\n            return null;\r\n        },\r\n    };\r\n}\r\n"]}

package/dist/plugins/index.js

@@ -1,5 +1,5 @@
-import { serverBoundaryPlugin } from '../chunk-56ZZNOJD.js';
-export { serverBoundaryPlugin } from '../chunk-56ZZNOJD.js';
+import { serverBoundaryPlugin } from '../chunk-NU3HX5T7.js';
+export { serverBoundaryPlugin } from '../chunk-NU3HX5T7.js';
 import { flightEnvPlugin } from '../chunk-RFTE6JVG.js';
 export { flightEnvPlugin } from '../chunk-RFTE6JVG.js';
 

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

@@ -6,21 +6,9 @@ import { Plugin } from 'vite';
  * Vite plugin to detect server-only code imported in client bundles.
  * OPTIONAL - use if you want build-time protection.
  *
- * Features:
- * - Detects *.server.ts files imported in client code
- * - Detects /server/ and /api/ directory imports
- * - Configurable behavior (warn, error)
- * - Clear error messages with solutions
- *
- * @example
- * ```typescript
- * // vite.config.ts
- * import { serverBoundaryPlugin } from '@flight-framework/core/plugins';
- *
- * export default {
- *   plugins: [serverBoundaryPlugin()],
- * };
- * ```
+ * NOTE: This plugin is designed to work WITH serverActionsPlugin.
+ * It will NOT flag 'use server' files because those are handled
+ * by the Server Actions transformation.
  */
 
 interface ServerBoundaryPluginOptions {
@@ -31,14 +19,14 @@ interface ServerBoundaryPluginOptions {
     serverFilePatterns?: string[];
     /**
      * Directory patterns that are server-only.
-     * @default ['/server/', '/api/']
+     * @default ['/server/']
      */
     serverDirPatterns?: string[];
     /**
      * How to handle violations.
      * - 'error': Build error (recommended for production)
      * - 'warn': Warning only (for migration)
-     * @default 'error'
+     * @default 'warn'
      */
     violationBehavior?: 'error' | 'warn';
     /**
@@ -46,21 +34,17 @@ interface ServerBoundaryPluginOptions {
      */
     customErrorMessage?: (module: string, importer: string) => string;
     /**
-     * Files to exclude from checking (e.g., tests).
-     * @default ['**\/*.test.*', '**\/*.spec.*']
+     * Files to exclude from checking.
      */
     exclude?: string[];
+    /**
+     * Skip checking 'use server' files. These are handled by serverActionsPlugin.
+     * @default true
+     */
+    skipServerActions?: 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
  */
 declare function serverBoundaryPlugin(options?: ServerBoundaryPluginOptions): Plugin;
 

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

@@ -1,3 +1,3 @@
-export { serverBoundaryPlugin } from '../chunk-56ZZNOJD.js';
+export { serverBoundaryPlugin } from '../chunk-NU3HX5T7.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.2",
   "description": "Core primitives for Flight Framework - routing, rendering, caching, server/client boundaries",
   "keywords": [
     "flight",

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"]}