feat: add automatic reflect-metadata injection to all bundles

Added automatic injection of `import 'reflect-metadata';` at the top of all client and server bundles via a new esbuild plugin. The plugin forces reflect-metadata to be bundled (not external), injects the import into entry points, and skips injection for view builds. Updated package.json templates to include reflect-metadata as a dependency.

Author: Flussen

RELEASE.md

@@ -1,11 +1,13 @@
-## OpenCore CLI v0.5.0
+## OpenCore CLI v0.5.1
 
 ### Highlights
 - **Smart Views Auto-Discovery**: The builder now automatically discovers UI/Views directories (`ui`, `view`, `views`, `web`, `html`) within resources and standalones, detecting the framework and configuring build tasks without manual intervention.
+- **Reflect-Metadata Injection**: Added automatic injection of `import 'reflect-metadata';` at the top of all client and server bundles.
 
 ### Changes
 - **Views Discovery Logic**: Implemented `findViewsPath` to search for common UI directory conventions.
 - **Enhanced Task Generation**: Integrated auto-discovery into both glob-based and explicit resource/standalone collection.
+- **Global Decorator Support**: Injected `reflect-metadata` via esbuild banners for server/client builds.
 
 ## OpenCore CLI v0.5.0
 

internal/builder/embedded/build_functions.js

@@ -1,11 +1,12 @@
 const path = require('path')
 const fs = require('fs')
-const { getEsbuild, createSwcPlugin, createExcludeNodeAdaptersPlugin, createExternalPackagesPlugin, preserveFiveMExportsPlugin, createNodeGlobalsShimPlugin, createTsconfigPathsPlugin } = require('./plugins')
+const { getEsbuild, createSwcPlugin, createExcludeNodeAdaptersPlugin, createExternalPackagesPlugin, preserveFiveMExportsPlugin, createNodeGlobalsShimPlugin, createTsconfigPathsPlugin, createReflectMetadataPlugin } = require('./plugins')
 const { getSharedConfig, getBuildOptions, getExternals } = require('./config')
 const { handleDependencies, shouldHandleDependencies, detectNativePackages, printNativePackageWarnings } = require('./dependencies')
 
 function getCorePlugins(isServerBuild = false, externals = [], target = 'es2020', format = 'iife', resourcePath = null) {
     const plugins = [
+        createReflectMetadataPlugin(),
         createExternalPackagesPlugin(externals),
         createSwcPlugin(target),
         createExcludeNodeAdaptersPlugin(isServerBuild),
@@ -26,6 +27,7 @@ function getCorePlugins(isServerBuild = false, externals = [], target = 'es2020'
 
 function getResourcePlugins(isServerBuild = false, externals = [], target = 'es2020', format = 'iife', resourcePath = null) {
     const plugins = [
+        createReflectMetadataPlugin(),
         createExternalPackagesPlugin(externals),
         createSwcPlugin(target),
         createExcludeNodeAdaptersPlugin(isServerBuild),
@@ -45,6 +47,7 @@ function getResourcePlugins(isServerBuild = false, externals = [], target = 'es2
 
 function getStandalonePlugins(isServerBuild = false, externals = [], target = 'es2020', format = 'iife', resourcePath = null) {
     const plugins = [
+        createReflectMetadataPlugin(),
         createExternalPackagesPlugin(externals),
         createSwcPlugin(target),
         createExcludeNodeAdaptersPlugin(isServerBuild),

internal/builder/embedded/config.js

@@ -21,7 +21,7 @@ function getSharedConfig(options = {}) {
         supported: {
             'class-static-blocks': false,
         },
-        alias: {}
+        alias: {},
     }
 
     return config

internal/builder/embedded/plugins.js

@@ -321,12 +321,58 @@ function createTsconfigPathsPlugin(resourcePath) {
     }
 }
 
+function createReflectMetadataPlugin() {
+    return {
+        name: 'reflect-metadata-injector',
+        setup(build) {
+            // Force reflect-metadata to be bundled even if marked as external
+            build.onResolve({ filter: /^reflect-metadata$/ }, () => {
+                try {
+                    return { path: require.resolve('reflect-metadata'), external: false }
+                } catch (e) {
+                    return { errors: [{ text: 'reflect-metadata not found. Please install it with: pnpm add reflect-metadata' }] }
+                }
+            })
+
+            // Inject import at the top of the entry point
+            build.onLoad({ filter: /\.(ts|tsx|js|jsx)$/ }, async (args) => {
+                // Skip node_modules
+                if (args.path.includes('node_modules')) return null
+
+                // Only inject into the main entry points (client/server main files)
+                const isEntry = build.initialOptions.entryPoints.some(e => 
+                    path.resolve(e) === path.resolve(args.path)
+                )
+
+                if (!isEntry) return null
+
+                try {
+                    const contents = await fs.promises.readFile(args.path, 'utf8')
+                    if (contents.includes('reflect-metadata')) return null
+
+                    const ext = path.extname(args.path).slice(1)
+                    // If it's TS, use 'ts' or 'tsx' loader, otherwise esbuild will fail
+                    const loader = ext === 'ts' || ext === 'tsx' ? ext : 'js'
+
+                    return {
+                        contents: `import 'reflect-metadata';\n${contents}`,
+                        loader: loader,
+                    }
+                } catch (e) {
+                    return null
+                }
+            })
+        },
+    }
+}
+
 module.exports = {
     getEsbuild,
     createSwcPlugin,
     createExcludeNodeAdaptersPlugin,
     createExternalPackagesPlugin,
     preserveFiveMExportsPlugin,
     createNodeGlobalsShimPlugin,
-    createTsconfigPathsPlugin
+    createTsconfigPathsPlugin,
+    createReflectMetadataPlugin
 }

internal/builder/embedded/views.js

@@ -329,6 +329,9 @@ async function buildViews(viewPath, outDir, options = {}) {
 
     await esbuild.build({
         ...shared,
+        banner: {
+            js: "", // No reflect-metadata for views
+        },
         entryPoints: [entryPoint],
         outdir: outDir,
         platform: 'browser',

internal/templates/resource/package.json

@@ -7,6 +7,7 @@
     "build": "tsc"
   },
   "dependencies": {
+    "reflect-metadata": "^0.2.2",
     "@open-core/framework": "latest"
   },
   "devDependencies": {

internal/templates/starter-project/package.json

@@ -17,6 +17,7 @@
   "dependencies": {
     "@citizenfx/client": "2.0.22443-1",
     "@citizenfx/server": "2.0.22443-1",
+    "reflect-metadata": "^0.2.2",
     "@open-core/framework": "latest"{{if .InstallIdentity}},
     "@open-core/identity": "latest"{{end}}
   }