@ludeo/cli 1.4.8 → 1.4.9

package/README.md

@@ -15,12 +15,22 @@ ludeo version
 
 ## Quick Start
 
+### Getting Your Game ID and Access Token
+Both your **Game ID** and **Access Token** are available in the [Studio Lab](https://studio.ludeo.com) under **Environments**.
+
+- **Access Token:** In Environments, click **Create Token**, name it, then copy and save the token (you won’t be able to see it again).
+- **Game ID:** In Environments, it’s shown at the top of the page next to the API key.
+
 ### 1. Authentication
-Get your access token from the Ludeo platform and save it:
+Save your access token:
+
+**macOS / Linux:**
 ```bash
 ludeo auth set-token --access-token YOUR_ACCESS_TOKEN
 ```
 
+**Windows (Command Prompt):** use the same command; for multi-line commands use `^` at the end of each line instead of `\`.
+
 You can also check if a token is saved:
 ```bash
 ludeo auth status
@@ -30,10 +40,17 @@ ludeo auth status
 
 #### Interactive Mode (Recommended for First-Time Users)
 Simply run the upload command without flags to start the interactive wizard:
+
+**macOS / Linux:**
 ```bash
 ludeo builds upload
 ```
 
+**Windows (Command Prompt):**
+```cmd
+ludeo builds upload
+```
+
 The interactive mode will guide you through:
 1. **Game ID** - Enter your game's unique identifier
 2. **Build Creation Type** - Choose between `new`, or `sdkFree`
@@ -56,6 +73,8 @@ ludeo builds upload --no-interactive [flags...]
 Upload your game build with a simple command. The CLI supports two build creation types (**modification builds are not supported from the CLI—use [Studio Labs](https://studio.ludeo.com) for those**):
 
 #### New Build (Complete build from scratch) - DEFAULT
+
+**macOS / Linux:**
 ```bash
 # With explicit build-creation-type
 ludeo builds upload \
@@ -78,6 +97,18 @@ ludeo builds upload \
   --sdk-version "2.0.0"
 ```
 
+**Windows (Command Prompt):** use `^` at the end of each line for continuation:
+```cmd
+ludeo builds upload ^
+  --game-id YOUR_GAME_ID ^
+  --exec-path "game.exe" ^
+  --local-directory "C:\path\to\your\builds" ^
+  --build-creation-type new ^
+  --build-type major ^
+  --game-version "1.2.3" ^
+  --sdk-version "2.0.0"
+```
+
 #### SDK Free Build (Performance testing without Ludeo SDK)
 ```bash
 ludeo builds upload \
@@ -103,7 +134,6 @@ ludeo builds upload \
 - `minor`: Minor version build (requires major-build-id)
 
 **Additional Flags:**
-- `--runtime-environment`: Runtime environment (windows/proton) - only available for Ludeo admins
 - `--request-id`: Optional request ID for tracking
 - `--no-interactive`: Disable interactive prompts (for CI/CD or scripts)
 - `--dry-run`: Preview the upload without making any changes
@@ -197,10 +227,13 @@ The test suite includes:
 
 ## Updating
 
+**npm:** 
 ```bash
 npm update -g @ludeo/cli
 ```
 
+**Windows (standalone exe):** download the latest release from the [GitHub releases](https://github.com/ludeo/cli/releases) page and replace your existing executable.
+
 ## CI/CD Integration
 
 ### GitHub Actions
@@ -235,10 +268,15 @@ npm rebuild @ludeo/cli
 sudo npm install -g @ludeo/cli
 ```
 
-**Windows issues:**
+**Windows (npm):**
 - Run PowerShell as Administrator
 - Ensure Node.js is properly installed
 
+**Windows (standalone exe):**
+- **"ludeo is not recognized"** — Add the folder containing `ludeo.exe` to your PATH.
+- **"Access denied" / "Permission denied"** — Right-click the executable → Properties → Unblock → OK, or run Command Prompt as Administrator.
+- **Antivirus blocking** — Add an exception for the executable in your antivirus software.
+
 ### Common Issues
 
 **Authentication errors:**
@@ -260,7 +298,7 @@ sudo npm install -g @ludeo/cli
 Need help? Here's how to get support:
 
 1. Check this README and troubleshooting section
-2. Run `npm rebuild @ludeo/cli` if you encounter issues
+2. **npm:** run `npm rebuild @ludeo/cli` if you encounter issues. **Windows (standalone):** ensure `ludeo.exe` is in your PATH and see the troubleshooting section above.
 3. Contact the Ludeo platform team for additional assistance
 
-For detailed documentation and advanced usage, visit the [Ludeo Developer Portal](https://developers.ludeo.com).
+For detailed documentation and advanced usage, visit the [Ludeo Developer Portal](https://developers.ludeo.com) or [Ludeo CLI Documentation](https://docs.ludeo.com/cli).

package/README.npm.md

@@ -15,12 +15,22 @@ ludeo version
 
 ## Quick Start
 
+### Getting Your Game ID and Access Token
+Both your **Game ID** and **Access Token** are available in the [Studio Lab](https://studio.ludeo.com) under **Environments**.
+
+- **Access Token:** In Environments, click **Create Token**, name it, then copy and save the token (you won’t be able to see it again).
+- **Game ID:** In Environments, it’s shown at the top of the page next to the API key.
+
 ### 1. Authentication
-Get your access token from the Ludeo platform and save it:
+Save your access token:
+
+**macOS / Linux:**
 ```bash
 ludeo auth set-token --access-token YOUR_ACCESS_TOKEN
 ```
 
+**Windows (Command Prompt):** use the same command; for multi-line commands use `^` at the end of each line instead of `\`.
+
 You can also check if a token is saved:
 ```bash
 ludeo auth status
@@ -30,10 +40,17 @@ ludeo auth status
 
 #### Interactive Mode (Recommended for First-Time Users)
 Simply run the upload command without flags to start the interactive wizard:
+
+**macOS / Linux:**
 ```bash
 ludeo builds upload
 ```
 
+**Windows (Command Prompt):**
+```cmd
+ludeo builds upload
+```
+
 The interactive mode will guide you through:
 1. **Game ID** - Enter your game's unique identifier
 2. **Build Creation Type** - Choose between `new`, or `sdkFree`
@@ -56,6 +73,8 @@ ludeo builds upload --no-interactive [flags...]
 Upload your game build with a simple command. The CLI supports two build creation types (**modification builds are not supported from the CLI—use [Studio Labs](https://studio.ludeo.com) for those**):
 
 #### New Build (Complete build from scratch) - DEFAULT
+
+**macOS / Linux:**
 ```bash
 # With explicit build-creation-type
 ludeo builds upload \
@@ -78,6 +97,18 @@ ludeo builds upload \
   --sdk-version "2.0.0"
 ```
 
+**Windows (Command Prompt):** use `^` at the end of each line for continuation:
+```cmd
+ludeo builds upload ^
+  --game-id YOUR_GAME_ID ^
+  --exec-path "game.exe" ^
+  --local-directory "C:\path\to\your\builds" ^
+  --build-creation-type new ^
+  --build-type major ^
+  --game-version "1.2.3" ^
+  --sdk-version "2.0.0"
+```
+
 #### SDK Free Build (Performance testing without Ludeo SDK)
 ```bash
 ludeo builds upload \
@@ -103,7 +134,6 @@ ludeo builds upload \
 - `minor`: Minor version build (requires major-build-id)
 
 **Additional Flags:**
-- `--runtime-environment`: Runtime environment (windows/proton) - only available for Ludeo admins
 - `--request-id`: Optional request ID for tracking
 - `--no-interactive`: Disable interactive prompts (for CI/CD or scripts)
 - `--dry-run`: Preview the upload without making any changes
@@ -153,10 +183,13 @@ ludeo auth logout
 
 ## Updating
 
+**npm:** 
 ```bash
 npm update -g @ludeo/cli
 ```
 
+**Windows (standalone exe):** download the latest release from the [GitHub releases](https://github.com/ludeo/cli/releases) page and replace your existing executable.
+
 ## CI/CD Integration
 
 ### GitHub Actions
@@ -191,10 +224,15 @@ npm rebuild @ludeo/cli
 sudo npm install -g @ludeo/cli
 ```
 
-**Windows issues:**
+**Windows (npm):**
 - Run PowerShell as Administrator
 - Ensure Node.js is properly installed
 
+**Windows (standalone exe):**
+- **"ludeo is not recognized"** — Add the folder containing `ludeo.exe` to your PATH.
+- **"Access denied" / "Permission denied"** — Right-click the executable → Properties → Unblock → OK, or run Command Prompt as Administrator.
+- **Antivirus blocking** — Add an exception for the executable in your antivirus software.
+
 ### Common Issues
 
 **Authentication errors:**
@@ -216,7 +254,7 @@ sudo npm install -g @ludeo/cli
 Need help? Here's how to get support:
 
 1. Check this README and troubleshooting section
-2. Run `npm rebuild @ludeo/cli` if you encounter issues
+2. **npm:** run `npm rebuild @ludeo/cli` if you encounter issues. **Windows (standalone):** ensure `ludeo.exe` is in your PATH and see the troubleshooting section above.
 3. Contact the Ludeo platform team for additional assistance
 
-For detailed documentation and advanced usage, visit the [Ludeo Developer Portal](https://developers.ludeo.com).
+For detailed documentation and advanced usage, visit the [Ludeo Developer Portal](https://developers.ludeo.com) or [Ludeo CLI Documentation](https://docs.ludeo.com/cli).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ludeo/cli",
-  "version": "1.4.8",
+  "version": "1.4.9",
   "description": "Ludeo CLI - Upload game builds and manage content on the Ludeo platform",
   "main": "index.js",
   "bin": {

package/scripts/build-readme.js

@@ -3,6 +3,7 @@
  * Build README variants from docs/readme/*.md fragments.
  * - README.md = full (repo, includes Testing) — for GitHub
  * - README.npm.md = usage only (no Testing) — for NPM package page
+ * - windows-releases/template/README.md = Windows release (docs/readme + docs/readme-windows overrides)
  *
  * Run: node scripts/build-readme.js
  */
@@ -12,6 +13,7 @@ const path = require('path');
 
 const ROOT = path.resolve(__dirname, '..');
 const README_DIR = path.join(ROOT, 'docs', 'readme');
+const README_WINDOWS_DIR = path.join(ROOT, 'docs', 'readme-windows');
 
 const FRAGMENTS_ORDER = [
   '01-title-intro.md',
@@ -25,12 +27,38 @@ const FRAGMENTS_ORDER = [
   '09-support.md',
 ];
 
+/** Windows README: Windows-only title + installation, then shared 03–09 (skip 02 npm install, skip 05 testing), then Windows file-info/license */
+const WINDOWS_HEAD = ['01-title-overview.md', '02-installation.md'];
+const WINDOWS_TAIL = ['09-file-info-license.md'];
+const WINDOWS_FROM_README = ['03-quick-start.md', '04-features.md', '06-updating.md', '07-cicd.md', '08-troubleshooting.md', '09-support.md'];
+
 const NPM_EXCLUDE = new Set(['05-testing.md']);
 
-function buildVariant(excludeSet) {
+function buildVariant(dir, order, excludeSet) {
   const parts = [];
-  for (const name of FRAGMENTS_ORDER) {
+  for (const name of order) {
     if (excludeSet && excludeSet.has(name)) continue;
+    const file = path.join(dir, name);
+    if (!fs.existsSync(file)) {
+      console.warn(`Warning: fragment missing: ${name}`);
+      continue;
+    }
+    parts.push(fs.readFileSync(file, 'utf8').trim());
+  }
+  return parts.join('\n\n');
+}
+
+function buildWindowsReadme() {
+  const parts = [];
+  for (const name of WINDOWS_HEAD) {
+    const file = path.join(README_WINDOWS_DIR, name);
+    if (!fs.existsSync(file)) {
+      console.warn(`Warning: Windows fragment missing: ${name}`);
+      continue;
+    }
+    parts.push(fs.readFileSync(file, 'utf8').trim());
+  }
+  for (const name of WINDOWS_FROM_README) {
     const file = path.join(README_DIR, name);
     if (!fs.existsSync(file)) {
       console.warn(`Warning: fragment missing: ${name}`);
@@ -38,17 +66,32 @@ function buildVariant(excludeSet) {
     }
     parts.push(fs.readFileSync(file, 'utf8').trim());
   }
+  for (const name of WINDOWS_TAIL) {
+    const file = path.join(README_WINDOWS_DIR, name);
+    if (!fs.existsSync(file)) {
+      console.warn(`Warning: Windows fragment missing: ${name}`);
+      continue;
+    }
+    parts.push(fs.readFileSync(file, 'utf8').trim());
+  }
   return parts.join('\n\n');
 }
 
 function main() {
-  const repoReadme = buildVariant(null);
-  const npmReadme = buildVariant(NPM_EXCLUDE);
+  const repoReadme = buildVariant(README_DIR, FRAGMENTS_ORDER, null);
+  const npmReadme = buildVariant(README_DIR, FRAGMENTS_ORDER, NPM_EXCLUDE);
+  const windowsReadme = buildWindowsReadme();
 
   fs.writeFileSync(path.join(ROOT, 'README.md'), repoReadme + '\n', 'utf8');
   fs.writeFileSync(path.join(ROOT, 'README.npm.md'), npmReadme + '\n', 'utf8');
 
-  console.log('Built README.md (repo, full) and README.npm.md (npm, usage only)');
+  const windowsTemplateDir = path.join(ROOT, 'windows-releases', 'template');
+  if (!fs.existsSync(windowsTemplateDir)) {
+    fs.mkdirSync(windowsTemplateDir, { recursive: true });
+  }
+  fs.writeFileSync(path.join(windowsTemplateDir, 'README.md'), windowsReadme + '\n', 'utf8');
+
+  console.log('Built README.md (repo), README.npm.md (npm), windows-releases/template/README.md (Windows)');
 }
 
 main();

package/scripts/postinstall.js

@@ -2,60 +2,36 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
-// Copy the appropriate binary to dist/ directory
 function postinstall() {
   const platform = os.platform();
   const arch = os.arch();
-  
-  // Map Node.js arch to Go arch
-  const archMap = {
-    'x64': 'amd64',
-    'arm64': 'arm64'
-  };
-  
+
+  const archMap = { 'x64': 'amd64', 'arm64': 'arm64' };
+  const platformMap = { 'win32': 'windows', 'darwin': 'darwin', 'linux': 'linux' };
+
   const goArch = archMap[arch] || arch;
-  
-  // Map platform names
-  const platformMap = {
-    'win32': 'windows',
-    'darwin': 'darwin',
-    'linux': 'linux'
-  };
-  
   const goPlatform = platformMap[platform] || platform;
-  
-  // Construct binary names
-  const sourceBinaryName = platform === 'win32' 
+
+  const binaryName = platform === 'win32'
     ? `ludeo-${goPlatform}-${goArch}.exe`
     : `ludeo-${goPlatform}-${goArch}`;
-  
-  const targetBinaryName = platform === 'win32' ? 'ludeo.exe' : 'ludeo';
-  
-  const sourcePath = path.join(__dirname, '..', 'build', sourceBinaryName);
-  const distDir = path.join(__dirname, '..', 'dist');
-  const targetPath = path.join(distDir, targetBinaryName);
-  
-  // Create dist directory if it doesn't exist
-  if (!fs.existsSync(distDir)) {
-    fs.mkdirSync(distDir, { recursive: true });
-  }
-  
-  // Copy the binary
-  if (fs.existsSync(sourcePath)) {
-    fs.copyFileSync(sourcePath, targetPath);
-    
-    // Make executable on Unix systems
+
+  const distPath = path.join(__dirname, '..', 'dist', binaryName);
+
+  if (fs.existsSync(distPath)) {
     if (platform !== 'win32') {
-      fs.chmodSync(targetPath, '755');
+      fs.chmodSync(distPath, '755');
     }
-    
-    console.log(`✅ Ludeo CLI binary installed: ${targetPath}`);
-  } else {
-    console.warn(`⚠️  Warning: Binary not found at ${sourcePath}`);
-    console.warn('This might happen during development. Run "npm run build" first.');
+    return;
+  }
+
+  // Only warn in development (when installing from source with build/ directory)
+  const buildPath = path.join(__dirname, '..', 'build', binaryName);
+  if (!fs.existsSync(buildPath)) {
+    console.warn(`⚠️  Ludeo CLI: binary not found for ${platform}-${arch}.`);
+    console.warn('Try running: npm rebuild @ludeo/cli');
   }
 }
 
-// Run postinstall
 postinstall();