@chrisivey01/builder 1.0.0

package/README.md

@@ -0,0 +1,110 @@
+# @pma/build
+
+A build tool for FiveM/RedM resources with watch mode and auto-restart support.
+
+## Features
+
+- 🔄 Auto-restart resources on file changes
+- 🎮 Support for both FiveM and RedM
+- 📦 Built-in TypeScript/JavaScript bundling with esbuild
+- 🌐 Web UI dev server integration
+- ⚡ Fast rebuilds with watch mode
+- 🎯 Automatic fxmanifest.lua updates
+
+## Installation
+
+```bash
+pnpm add -D @pma/build
+# or
+npm install --save-dev @pma/build
+# or
+yarn add -D @pma/build
+```
+
+## Usage
+
+### Command Line
+
+Add to your `package.json` scripts:
+
+```json
+{
+  "scripts": {
+    "build": "pma-build",
+    "watch": "pma-build --watch",
+    "build:redm": "pma-build --redm",
+    "watch:redm": "pma-build --watch --redm"
+  }
+}
+```
+
+Then run:
+
+```bash
+pnpm build        # Build for FiveM
+pnpm watch        # Watch mode for FiveM
+pnpm build:redm   # Build for RedM
+pnpm watch:redm   # Watch mode for RedM
+```
+
+### Programmatic API
+
+```javascript
+import { build } from '@pma/build';
+
+await build({
+  resourceName: 'my-resource',
+  restartEndpoint: 'http://127.0.0.1:4689/rr',
+  restartTimeout: 2000,
+  debounceDelay: 500,
+  webDevPort: 5173,
+  builds: {
+    client: { platform: 'browser', target: 'es2021', format: 'iife' },
+    server: { platform: 'node', target: 'node16', format: 'cjs' }
+  }
+});
+```
+
+## Configuration
+
+Create a `build.config.js` in your project root:
+
+```javascript
+export default {
+  restartEndpoint: 'http://127.0.0.1:4689/rr',
+  restartTimeout: 2000,
+  debounceDelay: 500,
+  webDevPort: 5173,
+  builds: {
+    client: { platform: 'browser', target: 'es2021', format: 'iife' },
+    server: { platform: 'node', target: 'node16', format: 'cjs' }
+  }
+};
+```
+
+## GAME Constant
+
+The build tool automatically injects a `GAME` constant into your code:
+
+```typescript
+// Available globally in your code
+if (GAME === 'REDM') {
+  console.log('Running on RedM');
+} else {
+  console.log('Running on FiveM');
+}
+```
+
+Add this to your `types/game.d.ts`:
+
+```typescript
+declare global {
+  const GAME: "REDM" | "FIVEM";
+}
+
+export {};
+```
+
+## License
+
+MIT

package/cli.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { build } from './index.js';
+
+build().catch((error) => {
+    console.error('Build failed:', error);
+    process.exit(1);
+});

package/index.js

@@ -0,0 +1,169 @@
+import esbuild from 'esbuild';
+import { execSync, spawn } from 'node:child_process';
+import fs from 'node:fs';
+import { basename, resolve } from 'path';
+
+export async function build(options = {}) {
+    const cwd = options.cwd || process.cwd();
+    const resource_name = options.resourceName || basename(resolve(cwd));
+    const args = options.args || process.argv.slice(2);
+    const IS_WATCH = args.includes('--watch');
+    const IS_REDM = args.includes('--redm');
+    const HAS_WEB_DIR = fs.existsSync(resolve(cwd, './web'));
+    
+    // Configuration defaults
+    const config = {
+        restartEndpoint: options.restartEndpoint || 'http://127.0.0.1:4689/rr',
+        restartTimeout: options.restartTimeout || 2000,
+        debounceDelay: options.debounceDelay || 500,
+        webDevPort: options.webDevPort || 5173,
+        builds: options.builds || {
+            client: { platform: 'browser', target: 'es2021', format: 'iife' },
+            server: { platform: 'node', target: 'node16', format: 'cjs' },
+        },
+        ...options
+    };
+
+    console.log(`🎮 Building ${resource_name} for ${IS_REDM ? 'RedM' : 'FiveM'}...`);
+
+    // Update fxmanifest.lua
+    const updateFxManifest = () => {
+        const fxmanifestPath = resolve(cwd, './fxmanifest.lua');
+        if (!fs.existsSync(fxmanifestPath)) return;
+
+        const contents = fs.readFileSync(fxmanifestPath, 'utf8');
+        let updated = contents;
+
+        // Update game field for RedM
+        if (IS_REDM) {
+            updated = updated.replace(/game\s+['"]gta5['"]/, "game 'rdr3'");
+            if (!updated.includes('rdr3_warning')) {
+                updated = updated.replace(
+                    /(game\s+['"]rdr3['"])/,
+                    `$1\nrdr3_warning 'I acknowledge that this is a prerelease build of RedM, and I am aware my resources *will* become incompatible once RedM ships.'`
+                );
+            }
+        } else {
+            updated = updated.replace(/game\s+['"]rdr3['"]/, "game 'gta5'");
+            updated = updated.replace(/\n?rdr3_warning\s+['"][^'"]*['"]\s*\n?/g, '\n');
+        }
+
+        // Update ui_page
+        if (!HAS_WEB_DIR) {
+            updated = updated.replace(/\n?\s*ui_page\s+['"][^'"]*['"]\s*\n?/g, '\n');
+        } else {
+            const desiredUiPage = IS_WATCH ? `ui_page 'http://127.0.0.1:${config.webDevPort}'` : "ui_page 'html/index.html'";
+            updated = updated.match(/ui_page\s+['"][^'"]*['"]/)
+                ? updated.replace(/ui_page\s+['"][^'"]*['"]/, desiredUiPage)
+                : `${updated.trimEnd()}\n\n${desiredUiPage}\n`;
+        }
+
+        if (updated !== contents) {
+            fs.writeFileSync(fxmanifestPath, updated, 'utf8');
+        }
+    };
+
+    updateFxManifest();
+
+    let lastRebuild = Date.now();
+
+    // Create restart plugin
+    const createRestartPlugin = () => ({
+        name: 'restart-resource',
+        setup(build) {
+            build.onEnd(async (result) => {
+                if (result.errors.length) return;
+
+                const now = Date.now();
+                if (now - lastRebuild < config.debounceDelay) return;
+
+                lastRebuild = now;
+                console.log(`\n📦 Build completed, restarting ${resource_name}...`);
+
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), config.restartTimeout);
+
+                fetch(`${config.restartEndpoint}?resource=${resource_name}`, {
+                    signal: controller.signal
+                })
+                    .then((response) => {
+                        clearTimeout(timeoutId);
+                        if (response.ok) {
+                            console.log(`✅ Restarted ${resource_name}`);
+                        } else {
+                            console.error(`⚠️  Restart returned: ${response.status}`);
+                        }
+                    })
+                    .catch((error) => {
+                        clearTimeout(timeoutId);
+                        if (error.name === 'AbortError') {
+                            console.error(`⚠️  Restart timed out (server might not be running)`);
+                        } else {
+                            console.error(`⚠️  Restart failed: ${error.message}`);
+                        }
+                    });
+            });
+        },
+    });
+
+    // Build configuration
+    const getBuildConfig = (name, buildConfig) => ({
+        bundle: true,
+        entryPoints: [resolve(cwd, `./${name}/main.ts`)],
+        outfile: resolve(cwd, `dist/${name}.js`),
+        sourcemap: true,
+        logLevel: 'info',
+        define: {
+            GAME: IS_REDM ? '"REDM"' : '"FIVEM"',
+            ...(config.define || {})
+        },
+        ...buildConfig,
+    });
+
+    if (IS_WATCH) {
+        // Watch mode
+        await Promise.all(
+            Object.entries(config.builds).map(async ([name, buildConfig]) => {
+                const ctx = await esbuild.context({
+                    ...getBuildConfig(name, buildConfig),
+                    plugins: [createRestartPlugin()],
+                });
+
+                await ctx.watch();
+                console.log(`👀 Watching ${name}...`);
+            })
+        );
+
+        if (HAS_WEB_DIR) {
+            console.log('🌐 Starting web dev server...');
+            const webProcess = spawn('pnpm', ['dev'], {
+                cwd: resolve(cwd, './web'),
+                stdio: 'inherit',
+                shell: true
+            });
+
+            webProcess.on('error', (error) => {
+                console.error('Failed to start web dev server:', error);
+            });
+        } else {
+            console.log('✅ Watch mode active. Press Ctrl+C to stop.');
+            await new Promise(() => { });
+        }
+    } else {
+        // Build mode
+        await Promise.all(
+            Object.entries(config.builds).map(async ([name, buildConfig]) => {
+                await esbuild.build(getBuildConfig(name, buildConfig));
+                console.log(`✅ Built ${name}`);
+            })
+        );
+
+        if (HAS_WEB_DIR) {
+            console.log('🌐 Building web...');
+            execSync('pnpm build', { cwd: resolve(cwd, './web'), stdio: 'inherit' });
+            console.log('✅ Web build completed');
+        }
+
+        process.exit(0);
+    }
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@chrisivey01/builder",
+  "version": "1.0.0",
+  "description": "Build tool for FiveM/RedM resources with watch mode and auto-restart",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "pma-build": "./cli.js"
+  },
+  "keywords": [
+    "fivem",
+    "redm",
+    "build",
+    "esbuild",
+    "cfx"
+  ],
+  "author": "Chris Ivey",
+  "license": "MIT",
+  "dependencies": {
+    "esbuild": "^0.24.2"
+  },
+  "peerDependencies": {
+    "esbuild": "^0.20.0"
+  }
+}