@ludeo/cli 1.4.9 → 1.4.10

package/README.md

@@ -16,21 +16,19 @@ 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**.
+Both your **Game ID** and **Access Token** are available in the [Studio Labs](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.
+- **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.
+
+> **Windows note:** All commands below work in Command Prompt, PowerShell, and terminal emulators. For multi-line commands, replace `\` with `^` in Command Prompt.
 
 ### 1. Authentication
 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
@@ -40,20 +38,13 @@ 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`
+2. **Build Creation Type** - Choose between `new` or `sdkFree`
 3. **Build Type** - Select `major` or `minor` (with warning for major builds)
 4. **Major Version Selection** - If creating a minor build, select from existing major versions
 5. **Game Version** - Enter the version number (e.g., 1.2.3)
@@ -73,8 +64,6 @@ 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 \
@@ -97,18 +86,6 @@ 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 \
@@ -227,7 +204,6 @@ The test suite includes:
 
 ## Updating
 
-**npm:** 
 ```bash
 npm update -g @ludeo/cli
 ```
@@ -300,5 +276,3 @@ Need help? Here's how to get support:
 1. Check this README and troubleshooting section
 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) or [Ludeo CLI Documentation](https://docs.ludeo.com/cli).

package/README.npm.md

@@ -16,21 +16,19 @@ 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**.
+Both your **Game ID** and **Access Token** are available in the [Studio Labs](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.
+- **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.
+
+> **Windows note:** All commands below work in Command Prompt, PowerShell, and terminal emulators. For multi-line commands, replace `\` with `^` in Command Prompt.
 
 ### 1. Authentication
 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
@@ -40,20 +38,13 @@ 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`
+2. **Build Creation Type** - Choose between `new` or `sdkFree`
 3. **Build Type** - Select `major` or `minor` (with warning for major builds)
 4. **Major Version Selection** - If creating a minor build, select from existing major versions
 5. **Game Version** - Enter the version number (e.g., 1.2.3)
@@ -73,8 +64,6 @@ 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 \
@@ -97,18 +86,6 @@ 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 \
@@ -183,13 +160,10 @@ 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
@@ -228,11 +202,6 @@ sudo npm install -g @ludeo/cli
 - 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:**
@@ -254,7 +223,5 @@ sudo npm install -g @ludeo/cli
 Need help? Here's how to get support:
 
 1. Check this README and troubleshooting section
-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.
+2. Run `npm rebuild @ludeo/cli` if you encounter issues
 3. Contact the Ludeo platform team for additional assistance
-
-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.9",
+  "version": "1.4.10",
   "description": "Ludeo CLI - Upload game builds and manage content on the Ludeo platform",
   "main": "index.js",
   "bin": {
@@ -9,7 +9,7 @@
   "scripts": {
     "build": "make build-all",
     "postinstall": "node scripts/postinstall.js",
-    "prepublishOnly": "npm run build",
+    "prepublishOnly": "make npm-build",
     "release": "node scripts/release.js",
     "release:patch": "node scripts/release.js patch",
     "release:minor": "node scripts/release.js minor",

package/scripts/build-readme.js

@@ -1,9 +1,20 @@
 #!/usr/bin/env node
 /**
- * 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)
+ * Build README variants from docs/README.template.md.
+ *
+ * Outputs:
+ *   README.md                          — GitHub repo (includes Testing)
+ *   README.npm.md                      — npm package page (no Testing, no standalone exe refs)
+ *   windows-releases/template/README.md — Windows ZIP release (exe install, file info)
+ *
+ * Conditional markers in the template:
+ *   <!-- #if VARIANT -->   Include block only for that variant
+ *   <!-- #if !VARIANT -->  Include block for all variants EXCEPT that one
+ *   <!-- #else -->         Opposite of preceding #if
+ *   <!-- #endif -->        End conditional block
+ *
+ * Supported variant names: repo, npm, windows
+ * Template variable: {{VERSION}} (replaced from package.json)
  *
  * Run: node scripts/build-readme.js
  */
@@ -12,86 +23,90 @@ const fs = require('fs');
 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',
-  '02-installation.md',
-  '03-quick-start.md',
-  '04-features.md',
-  '05-testing.md',
-  '06-updating.md',
-  '07-cicd.md',
-  '08-troubleshooting.md',
-  '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(dir, order, excludeSet) {
-  const parts = [];
-  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}`);
+const TEMPLATE = path.join(ROOT, 'docs', 'README.template.md');
+
+const VARIANTS = {
+  repo: { flags: { repo: true, npm: false, windows: false } },
+  npm: { flags: { repo: false, npm: true, windows: false } },
+  windows: { flags: { repo: false, npm: false, windows: true } },
+};
+
+function processTemplate(template, flags, vars) {
+  const lines = template.split('\n');
+  const output = [];
+  const stack = []; // { include: boolean, hadElse: boolean }
+
+  for (const line of lines) {
+    const trimmed = line.trim();
+
+    const ifMatch = trimmed.match(/^<!--\s*#if\s+(!?)(\w+)\s*-->$/);
+    if (ifMatch) {
+      const negated = ifMatch[1] === '!';
+      const flag = ifMatch[2];
+      const value = !!flags[flag];
+      const include = negated ? !value : value;
+      const parentInclude = stack.length === 0 || stack[stack.length - 1].include;
+      stack.push({ include: parentInclude && include, hadElse: false });
       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}`);
+    if (trimmed === '<!-- #else -->') {
+      if (stack.length > 0) {
+        const top = stack[stack.length - 1];
+        const parentInclude = stack.length <= 1 || stack[stack.length - 2].include;
+        top.include = parentInclude && !top.include;
+        top.hadElse = true;
+      }
       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}`);
+
+    if (trimmed === '<!-- #endif -->') {
+      stack.pop();
       continue;
     }
-    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;
+
+    const shouldInclude = stack.length === 0 || stack[stack.length - 1].include;
+    if (shouldInclude) {
+      output.push(line);
     }
-    parts.push(fs.readFileSync(file, 'utf8').trim());
   }
-  return parts.join('\n\n');
+
+  let result = output.join('\n');
+
+  for (const [key, value] of Object.entries(vars)) {
+    result = result.replace(new RegExp(`\\{\\{${key}\\}\\}`, 'g'), value);
+  }
+
+  // Collapse 3+ consecutive blank lines into 2
+  result = result.replace(/\n{3,}/g, '\n\n');
+
+  return result.trim() + '\n';
 }
 
 function main() {
-  const repoReadme = buildVariant(README_DIR, FRAGMENTS_ORDER, null);
-  const npmReadme = buildVariant(README_DIR, FRAGMENTS_ORDER, NPM_EXCLUDE);
-  const windowsReadme = buildWindowsReadme();
+  const template = fs.readFileSync(TEMPLATE, 'utf8');
+  const version = require(path.join(ROOT, 'package.json')).version;
+  const vars = { VERSION: `v${version}` };
 
-  fs.writeFileSync(path.join(ROOT, 'README.md'), repoReadme + '\n', 'utf8');
-  fs.writeFileSync(path.join(ROOT, 'README.npm.md'), npmReadme + '\n', 'utf8');
+  // Build each variant
+  for (const [name, config] of Object.entries(VARIANTS)) {
+    const content = processTemplate(template, config.flags, vars);
+
+    let outputPath;
+    if (name === 'repo') {
+      outputPath = path.join(ROOT, 'README.md');
+    } else if (name === 'npm') {
+      outputPath = path.join(ROOT, 'README.npm.md');
+    } else if (name === 'windows') {
+      const dir = path.join(ROOT, 'windows-releases', 'template');
+      fs.mkdirSync(dir, { recursive: true });
+      outputPath = path.join(dir, 'README.md');
+    }
 
-  const windowsTemplateDir = path.join(ROOT, 'windows-releases', 'template');
-  if (!fs.existsSync(windowsTemplateDir)) {
-    fs.mkdirSync(windowsTemplateDir, { recursive: true });
+    fs.writeFileSync(outputPath, content, 'utf8');
   }
-  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)');
+  console.log('Built README.md (repo), README.npm.md (npm), windows-releases/template/README.md (windows)');
 }
 
 main();

package/scripts/release.js

@@ -84,8 +84,6 @@ function createWindowsRelease(version) {
 function updateWindowsDocumentation(version, releaseDir) {
   const files = [
     'README.md',
-    'INSTALL.txt', 
-    'install.bat',
     'PACKAGE_CONTENTS.txt'
   ];
   
@@ -127,21 +125,6 @@ function getBasicFileContent(filename, version) {
 ## Support
 - Email: support@ludeo.com
 - Documentation: https://docs.ludeo.com/cli
-`;
-    case 'INSTALL.txt':
-      return `LUDEO CLI v${version} - WINDOWS INSTALLATION
-
-1. Choose the right executable:
-   - ludeo-windows-amd64.exe (Intel/AMD)
-   - ludeo-windows-arm64.exe (ARM)
-
-2. Rename to "ludeo.exe"
-
-3. Add to PATH:
-   - Copy to C:\\ludeo-cli\\
-   - Add C:\\ludeo-cli\\ to PATH
-
-4. Test: ludeo --version
 `;
     default:
       return `# Ludeo CLI v${version} - ${filename}`;