Add script to copy wasm file

Signed-off-by: Thomas Poignant <[email protected]>

Author: thomaspoignant

libs/providers/go-feature-flag/project.json

@@ -20,20 +20,23 @@
       "executor": "nx:run-commands",
       "options": {
         "commands": [
-          "git submodule update --init wasm-releases",
-          "cp wasm-releases/evaluation/gofeatureflag-evaluation_v1.45.6.wasm src/lib/wasm/wasm-module/gofeatureflag-evaluation.wasm"
+          "node scripts/copy-latest-wasm.js"
         ],
         "cwd": "libs/providers/go-feature-flag",
         "parallel": false
       }
     },
     "lint": {
       "executor": "@nx/eslint:lint",
-      "outputs": ["{options.outputFile}"]
+      "outputs": [
+        "{options.outputFile}"
+      ]
     },
     "test": {
       "executor": "@nx/jest:jest",
-      "outputs": ["{workspaceRoot}/coverage/libs/providers/go-feature-flag"],
+      "outputs": [
+        "{workspaceRoot}/coverage/libs/providers/go-feature-flag"
+      ],
       "options": {
         "jestConfig": "libs/providers/go-feature-flag/jest.config.ts"
       },
@@ -45,7 +48,9 @@
     },
     "package": {
       "executor": "@nx/rollup:rollup",
-      "outputs": ["{options.outputPath}"],
+      "outputs": [
+        "{options.outputPath}"
+      ],
       "dependsOn": [
         {
           "target": "copy-wasm"
@@ -60,7 +65,10 @@
         "generateExportsField": true,
         "umdName": "go-feature-flag",
         "external": "all",
-        "format": ["cjs", "esm"],
+        "format": [
+          "cjs",
+          "esm"
+        ],
         "assets": [
           {
             "glob": "package.json",
@@ -82,4 +90,4 @@
     }
   },
   "tags": []
-}
+}

libs/providers/go-feature-flag/scripts/README.md

@@ -0,0 +1,41 @@
+# Scripts
+
+This directory contains utility scripts for the go-feature-flag provider.
+
+## copy-latest-wasm.js
+
+This script copies the go-feature-flag WASM evaluation module from the `wasm-releases` submodule.
+
+### Purpose
+
+Previously, the WASM filename was hardcoded with a specific version (e.g., `gofeatureflag-evaluation_v1.45.6.wasm`), which made updates cumbersome and error-prone. This script replaces that approach with a configurable solution that:
+
+1. Uses an explicit version constant (`TARGET_WASM_VERSION`) for controlled updates
+2. Updates the git submodule to get the latest WASM releases
+3. Validates that the requested version exists before copying
+4. Copies the WASM file to the expected location
+
+### Configuration
+
+The script has one configuration constant at the top:
+
+- `TARGET_WASM_VERSION`: The explicit version to use (e.g., `'v1.45.6'`)
+
+### Usage
+
+The script is automatically executed by the `copy-wasm` target in `project.json` and is used as a dependency for the `test` and `package` targets.
+
+You can also run it manually:
+
+```bash
+node scripts/copy-latest-wasm.js
+```
+
+### Benefits
+
+- **Explicit control**: You can specify exactly which version to use
+- **Easy updates**: Simply change the `TARGET_WASM_VERSION` constant when you want to upgrade
+- **Error prevention**: Validates that the requested version exists before copying
+- **Maintainability**: Reduces manual maintenance overhead while providing control
+- **Consistency**: Ensures reproducible builds with known versions
+- **Simplicity**: Clear and straightforward approach without complex logic

libs/providers/go-feature-flag/scripts/copy-latest-wasm.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+/**
+ * Script to copy the go-feature-flag WASM evaluation module
+ * This replaces the hardcoded version approach with a configurable one
+ */
+const TARGET_WASM_VERSION = 'v1.45.6';
+
+function copyWasmFile() {
+  try {
+    // Update git submodule first
+    console.log('Updating git submodule...');
+    execSync('git submodule update --init wasm-releases', {
+      cwd: path.join(__dirname, '..'),
+      stdio: 'inherit',
+    });
+
+    const wasmFileName = `gofeatureflag-evaluation_${TARGET_WASM_VERSION}.wasm`;
+    console.log(`Using explicit WASM version: ${TARGET_WASM_VERSION}`);
+
+    const sourcePath = path.join(__dirname, '../wasm-releases/evaluation', wasmFileName);
+    const targetPath = path.join(__dirname, '../src/lib/wasm/wasm-module/gofeatureflag-evaluation.wasm');
+
+    // Check if the source file exists
+    if (!fs.existsSync(sourcePath)) {
+      console.error(`Error: WASM file not found: ${sourcePath}`);
+      console.error('Available files in wasm-releases/evaluation:');
+      const evaluationDir = path.join(__dirname, '../wasm-releases/evaluation');
+      if (fs.existsSync(evaluationDir)) {
+        const files = fs.readdirSync(evaluationDir).filter((file) => file.endsWith('.wasm'));
+        files.forEach((file) => console.error(`  - ${file}`));
+      }
+      process.exit(1);
+    }
+
+    // Ensure target directory exists
+    const targetDir = path.dirname(targetPath);
+    if (!fs.existsSync(targetDir)) {
+      fs.mkdirSync(targetDir, { recursive: true });
+    }
+
+    // Copy the file
+    console.log(`Copying ${wasmFileName} to ${targetPath}...`);
+    fs.copyFileSync(sourcePath, targetPath);
+
+    console.log('✅ Successfully copied WASM file');
+  } catch (error) {
+    console.error('Error copying WASM file:', error.message);
+    process.exit(1);
+  }
+}
+
+// Run the script
+copyWasmFile();