Merge pull request #18 from laravel/ssr-no-external

Prevent SSR build from externalizing Inertia helpers

Author: timacdonald

src/index.ts

@@ -2,7 +2,7 @@ import fs from 'fs'
 import { AddressInfo } from 'net'
 import path from 'path'
 import colors from 'picocolors'
-import { Plugin, loadEnv, UserConfig, ConfigEnv, Manifest, ResolvedConfig } from 'vite'
+import { Plugin, loadEnv, UserConfig, ConfigEnv, Manifest, ResolvedConfig, SSROptions } from 'vite'
 
 interface PluginConfig {
     /**
@@ -99,7 +99,10 @@ export default function laravel(config: string|string[]|PluginConfig): LaravelPl
                             ...defaultAliases,
                             ...userConfig.resolve?.alias,
                         }
-                }
+                },
+                ssr: {
+                    noExternal: noExternalInertiaHelpers(userConfig),
+                },
             }
         },
         configResolved(config) {
@@ -277,6 +280,9 @@ function resolveOutDir(config: Required<PluginConfig>, ssr: boolean): string|und
     return path.join(config.publicDirectory, config.buildDirectory)
 }
 
+/**
+ * Resolve the Vite manifest config from the configuration.
+ */
 function resolveManifestConfig(config: ResolvedConfig): string|false
 {
     const manifestConfig = config.build.ssr
@@ -293,3 +299,28 @@ function resolveManifestConfig(config: ResolvedConfig): string|false
 
     return manifestConfig
 }
+
+/**
+ * Add the Interia helpers to the list of SSR dependencies that aren't externalized.
+ *
+ * @see https://vitejs.dev/guide/ssr.html#ssr-externals
+ */
+function noExternalInertiaHelpers(config: UserConfig): true|Array<string|RegExp> {
+    /* eslint-disable-next-line @typescript-eslint/ban-ts-comment */
+    /* @ts-ignore */
+    const userNoExternal = (config.ssr as SSROptions|undefined)?.noExternal
+    const pluginNoExternal = ['laravel-vite-plugin']
+
+    if (userNoExternal === true) {
+        return true
+    }
+
+    if (typeof userNoExternal === 'undefined') {
+        return pluginNoExternal
+    }
+
+    return [
+        ...(Array.isArray(userNoExternal) ? userNoExternal : [userNoExternal]),
+        ...pluginNoExternal,
+    ]
+}

tests/index.test.ts

@@ -218,4 +218,28 @@ describe('laravel-vite-plugin', () => {
         delete process.env.LARAVEL_SAIL
         delete process.env.VITE_PORT
     })
+
+    it('prevents the Inertia helpers from being externalized', () => {
+        /* eslint-disable @typescript-eslint/ban-ts-comment */
+        const plugin = laravel('resources/js/app.js')
+
+        const noSsrConfig = plugin.config({ build: { ssr: true } }, { command: 'build', mode: 'production' })
+        /* @ts-ignore */
+        expect(noSsrConfig.ssr.noExternal).toEqual(['laravel-vite-plugin'])
+
+        /* @ts-ignore */
+        const nothingExternalConfig = plugin.config({ ssr: { noExternal: true }, build: { ssr: true } }, { command: 'build', mode: 'production' })
+        /* @ts-ignore */
+        expect(nothingExternalConfig.ssr.noExternal).toBe(true)
+
+        /* @ts-ignore */
+        const arrayNoExternalConfig = plugin.config({ ssr: { noExternal: ['foo'] }, build: { ssr: true } }, { command: 'build', mode: 'production' })
+        /* @ts-ignore */
+        expect(arrayNoExternalConfig.ssr.noExternal).toEqual(['foo', 'laravel-vite-plugin'])
+
+        /* @ts-ignore */
+        const stringNoExternalConfig = plugin.config({ ssr: { noExternal: 'foo' }, build: { ssr: true } }, { command: 'build', mode: 'production' })
+        /* @ts-ignore */
+        expect(stringNoExternalConfig.ssr.noExternal).toEqual(['foo', 'laravel-vite-plugin'])
+    })
 })