at-builder 1.2.8 → 1.3.3

package/lib/install-checks.js

@@ -0,0 +1,236 @@
+/* eslint-disable no-undef */
+/* eslint-env node */
+'use strict';
+
+/**
+ * Shared install-environment validation for at-builder.
+ *
+ * Used by both:
+ *   - lib/postinstall.js — runs once on `npm i -g at-builder`
+ *   - src/services/doctor.ts — surfaces the same problems via `atb doctor`
+ *     for users who installed with `--ignore-scripts` or who skipped the
+ *     postinstall warnings.
+ *
+ * checkInstallEnvironment() returns pure data — no console I/O — so the
+ * caller decides how to present results. The one side effect is an attempt
+ * to chmod 755 the shim / local bin script on POSIX when fixPermissions is
+ * true (the default), since that's a fix, not output.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execFileSync } = require('child_process');
+
+function isLikelyGlobalInstall() {
+    if (String(process.env.npm_config_global || '').toLowerCase() === 'true') return true;
+    try {
+        const argv = JSON.parse(process.env.npm_config_argv || '{}');
+        const cooked = Array.isArray(argv.cooked) ? argv.cooked : [];
+        return cooked.includes('-g') || cooked.includes('--global');
+    } catch {
+        return false;
+    }
+}
+
+function getPathEntries() {
+    const isWin = process.platform === 'win32';
+    const sep = isWin ? ';' : ':';
+    return (process.env.PATH || process.env.Path || '')
+        .split(sep)
+        .map((p) => p.trim())
+        .filter(Boolean);
+}
+
+function normalizeForCompare(pth) {
+    const isWin = process.platform === 'win32';
+    let n = path.normalize(pth || '');
+    if (isWin) n = n.toLowerCase();
+    return n.replace(/[\\/]+$/, '');
+}
+
+// `npm bin -g` was removed in npm 9. Use `npm config get prefix` instead.
+// execFileSync (not execSync) — argv is hardcoded but execFile avoids a shell
+// entirely on POSIX. On Windows we set shell:true so npm.cmd is found.
+function npmPrefixBin() {
+    try {
+        const out = execFileSync('npm', ['config', 'get', 'prefix'], {
+            stdio: ['ignore', 'pipe', 'ignore'],
+            timeout: 2500,
+            shell: process.platform === 'win32'
+        }).toString().trim();
+        if (!out) return '';
+        const isWin = process.platform === 'win32';
+        return isWin ? path.join(out, 'npm') : path.join(out, 'bin');
+    } catch {
+        return '';
+    }
+}
+
+function windowsDefaultNpmBin() {
+    const appData = process.env.APPDATA;
+    if (!appData) return '';
+    return path.join(appData, 'npm');
+}
+
+function dedupe(arr, keyFn = (v) => v) {
+    const seen = new Set();
+    const out = [];
+    for (const v of arr) {
+        const k = keyFn(v);
+        if (!seen.has(k)) {
+            seen.add(k);
+            out.push(v);
+        }
+    }
+    return out;
+}
+
+function detectGlobalBinCandidates() {
+    const candidates = [];
+
+    const pref = npmPrefixBin();
+    if (pref) candidates.push(pref);
+
+    if (process.platform === 'win32') {
+        const appBin = windowsDefaultNpmBin();
+        if (appBin) candidates.push(appBin);
+    }
+
+    if (process.env.npm_config_prefix) {
+        const isWin = process.platform === 'win32';
+        candidates.push(path.join(process.env.npm_config_prefix, isWin ? 'npm' : 'bin'));
+    }
+
+    return dedupe(candidates.filter(Boolean), (p) => normalizeForCompare(p));
+}
+
+function findExistingDir(dirs) {
+    for (const d of dirs) {
+        try {
+            if (fs.existsSync(d) && fs.statSync(d).isDirectory()) return d;
+        } catch {
+            // ignore
+        }
+    }
+    return '';
+}
+
+function isExecutable(filePath) {
+    if (!fs.existsSync(filePath)) return false;
+    if (process.platform === 'win32') return true;
+    try {
+        fs.accessSync(filePath, fs.constants.X_OK);
+        return true;
+    } catch {
+        return false;
+    }
+}
+
+function ensureExecutable(filePath) {
+    if (process.platform === 'win32') return true;
+    try {
+        if (!fs.existsSync(filePath)) return false;
+        const st = fs.statSync(filePath);
+        if ((st.mode & 0o111) === 0) {
+            fs.chmodSync(filePath, 0o755);
+        }
+        return isExecutable(filePath);
+    } catch {
+        return false;
+    }
+}
+
+/**
+ * @param {object} [opts]
+ * @param {string} [opts.localBinScript] absolute path to this package's bin/index.js;
+ *   used to verify/repair its POSIX exec bit. Defaults to bin/index.js relative to this file.
+ * @param {boolean} [opts.fixPermissions=true] auto-chmod 755 on POSIX when missing exec bit.
+ * @returns {{
+ *   ok: boolean,
+ *   problems: string[],
+ *   globalBin: string,
+ *   shimPath: string,
+ *   shimExecutable: boolean,
+ *   isWin: boolean,
+ *   isGlobalInstall: boolean,
+ *   nodeMajor: number
+ * }}
+ */
+function checkInstallEnvironment(opts = {}) {
+    const isWin = process.platform === 'win32';
+    const localBinScript = opts.localBinScript || path.resolve(__dirname, '..', 'bin', 'index.js');
+    const fixPermissions = opts.fixPermissions !== false;
+    const isGlobalInstall = isLikelyGlobalInstall();
+
+    const problems = [];
+    let globalBin = '';
+    let shimPath = '';
+    let shimExecutable = false;
+
+    // Node version check (soft)
+    const nodeVer = process.versions.node || '';
+    const minNodeMajor = 16;
+    const major = parseInt(nodeVer.split('.')[0] || '0', 10);
+    const nodeMajor = Number.isFinite(major) ? major : 0;
+    if (nodeMajor && nodeMajor < minNodeMajor) {
+        problems.push(`Node.js version too low (${nodeVer}). Please upgrade to >= ${minNodeMajor}.x`);
+    }
+
+    // Local bin script exec bit (POSIX only) — useful for npm link / local dev too.
+    if (!isWin && fixPermissions) {
+        if (fs.existsSync(localBinScript) && !ensureExecutable(localBinScript)) {
+            problems.push(`Local bin script not executable: ${localBinScript}`);
+        }
+    }
+
+    // Global bin discovery + shim verification
+    const pathEntries = getPathEntries().map(normalizeForCompare);
+    const candidates = detectGlobalBinCandidates();
+    globalBin = findExistingDir(candidates);
+
+    if (!globalBin) {
+        problems.push('Could not determine global npm bin directory.');
+    } else {
+        const globalBinNorm = normalizeForCompare(globalBin);
+        if (!pathEntries.includes(globalBinNorm)) {
+            problems.push(`Global npm bin is not on PATH: ${globalBin}`);
+        }
+
+        const atbUnix = path.join(globalBin, 'atb');
+        const atbCmd = path.join(globalBin, 'atb.cmd');
+        const atbPs1 = path.join(globalBin, 'atb.ps1');
+        const shims = [atbUnix, atbCmd, atbPs1].filter((p) => fs.existsSync(p));
+
+        if (shims.length === 0) {
+            problems.push(`"atb" binary not found in global npm bin: ${globalBin}`);
+        } else {
+            const preferred = isWin ? [atbCmd, atbPs1] : [atbUnix];
+            shimPath = preferred.find((p) => fs.existsSync(p)) || shims[0];
+
+            if (!isExecutable(shimPath)) {
+                if (fixPermissions) ensureExecutable(shimPath);
+                if (!isExecutable(shimPath)) {
+                    problems.push(`"atb" shim exists but is not executable: ${shimPath}`);
+                }
+            }
+            shimExecutable = isExecutable(shimPath);
+        }
+    }
+
+    return {
+        ok: problems.length === 0,
+        problems,
+        globalBin,
+        shimPath,
+        shimExecutable,
+        isWin,
+        isGlobalInstall,
+        nodeMajor
+    };
+}
+
+module.exports = {
+    checkInstallEnvironment,
+    isExecutable,
+    ensureExecutable
+};

package/lib/postinstall.js

@@ -0,0 +1,90 @@
+/* eslint-disable no-undef, no-console */
+/* eslint-env node */
+'use strict';
+
+/**
+ * Cross-platform postinstall validator for at-builder.
+ *
+ * Runs once on `npm i -g at-builder`. Verifies that the global npm bin is
+ * on PATH and that the `atb` shim exists + is executable. Auto-chmods the
+ * shim on POSIX when possible. Emits OS-specific guidance otherwise.
+ *
+ * Never fails the install: any unexpected error is caught, and the script
+ * always exits 0. Worst case, the user sees a warning instead of a blocked
+ * install. The same checks are mirrored in `atb doctor` for users who skip
+ * scripts.
+ */
+
+const path = require('path');
+const { checkInstallEnvironment } = require('./install-checks');
+
+function c(code, text) { return `\u001b[${code}m${text}\u001b[0m`; }
+const red = (t) => c('31', t);
+const yellow = (t) => c('33', t);
+const green = (t) => c('32', t);
+const bold = (t) => c('1', t);
+
+(function run() {
+    try {
+        const result = checkInstallEnvironment({
+            localBinScript: path.resolve(__dirname, '..', 'bin', 'index.js')
+        });
+
+        // For local installs (e.g. someone adding at-builder as a project dep
+        // — not a documented use case but possible), stay silent. The chmod
+        // side effect inside checkInstallEnvironment already ran.
+        if (!result.isGlobalInstall) return;
+
+        if (result.ok) {
+            console.log(green('✔ at-builder postinstall checks passed.'));
+            if (result.globalBin) console.log(`Detected global npm bin: ${bold(result.globalBin)}`);
+            if (result.shimPath) {
+                console.log(`Using shim: ${bold(result.shimPath)}${!result.isWin ? ' (POSIX exec verified)' : ''}`);
+            }
+            return;
+        }
+
+        console.error(red('✖ at-builder postinstall detected configuration issues:'));
+        for (const p of result.problems) console.error(red(`- ${p}`));
+
+        if (result.isWin) {
+            console.error(yellow('\nSuggested fixes (Windows):'));
+            if (result.globalBin) {
+                console.error(bold('PowerShell (current user):'));
+                console.error(`  ${bold(`[Environment]::SetEnvironmentVariable("Path", "$env:Path;${result.globalBin}", "User")`)}`);
+                console.error(bold('Then restart your terminal.'));
+                console.error(bold('\nCMD (current user):'));
+                console.error(`  ${bold(`setx PATH "%PATH%;${result.globalBin}"`)}`);
+                console.error(bold('Then restart your terminal.'));
+            } else {
+                console.error(bold('Find your npm global bin via:  npm config get prefix'));
+                console.error(bold('Then add it to PATH using PowerShell or setx as shown above.'));
+            }
+            console.error(bold('\nReinstall the CLI after fixing PATH:'));
+            console.error(bold('  npm uninstall -g at-builder && npm install -g at-builder'));
+        } else {
+            console.error(yellow('\nSuggested fixes (macOS/Linux):'));
+            if (result.globalBin) {
+                console.error(bold('# Ensure the shim is executable'));
+                console.error(`  ${bold(`chmod +x "${path.join(result.globalBin, 'atb')}"`)}`);
+                console.error(bold('# Ensure global npm bin is on PATH'));
+                console.error(`  ${bold(`echo 'export PATH="$PATH:${result.globalBin}"' >> ~/.zshrc && source ~/.zshrc`)}`);
+                console.error(bold('# Refresh shell command cache'));
+                console.error(`  ${bold('hash -r || true')}`);
+            } else {
+                console.error(bold(`prefix="$(npm config get prefix)"`));
+                console.error(bold(`echo 'export PATH="$PATH:'"$prefix"'/bin"' >> ~/.zshrc && source ~/.zshrc`));
+            }
+            console.error(bold('\nThen reinstall the CLI:'));
+            console.error(bold('  npm uninstall -g at-builder && npm install -g at-builder'));
+        }
+
+        console.error(yellow('\nThis is a warning — install is complete. Run "atb doctor" later to re-check.'));
+    } catch (err) {
+        // Belt-and-suspenders: a bug here must NEVER fail the install.
+        console.error(`[at-builder postinstall] unexpected error (install will continue): ${err && err.message ? err.message : err}`);
+    } finally {
+        // Always succeed — see file header.
+        process.exit(0);
+    }
+})();

package/package/package.json

@@ -0,0 +1,86 @@
+{
+    "name": "at-builder",
+    "version": "1.3.0",
+    "main": "bin/index.js",
+    "bin": {
+        "atb": "bin/index.js"
+    },
+    "scripts": {
+        "build:atb": "tsc",
+        "build:atb:dev": "tsc -w",
+        "atb:build:prod": "cross-env NODE_ENV=production webpack",
+        "atb:build:dev": "webpack -- -w",
+        "atb:build:dev:puppeteer": "webpack -- -w & npm run atb:puppeteer",
+        "atb:puppeteer": "node puppeteer.js $b",
+        "atb:plop:new:activity": "plop page",
+        "atb:build:deploy": "node lib/at-deploy.js",
+        "atb:build:sync": "node lib/at-sync.js"
+    },
+    "author": "Upendra Sengar <upendrasengar456@gmail.com>",
+    "license": "MIT",
+    "dependencies": {
+        "@babel/core": "^7.26.9",
+        "@babel/eslint-parser": "^7.26.8",
+        "@babel/plugin-proposal-class-properties": "^7.18.6",
+        "@babel/plugin-syntax-dynamic-import": "^7.8.3",
+        "@babel/plugin-transform-runtime": "^7.18.9",
+        "@babel/preset-env": "^7.18.9",
+        "@babel/preset-react": "^7.18.6",
+        "@eslint/js": "^9.20.0",
+        "@types/node": "^22.13.2",
+        "async": "^3.2.3",
+        "axios": "^1.12.2",
+        "babel-loader": "^9.2.1",
+        "babel-plugin-transform-async-to-generator": "^6.24.1",
+        "build": "^0.1.4",
+        "chokidar": "^4.0.3",
+        "cli-color": "^2.0.3",
+        "commander": "^13.1.0",
+        "cross-env": "^7.0.3",
+        "css-loader": "^7.1.2",
+        "dotenv": "16.4.5",
+        "eslint": "^9.20.1",
+        "eslint-webpack-plugin": "^4.2.0",
+        "globals": "^15.15.0",
+        "inquirer": "^12.4.1",
+        "kleur": "^4.1.5",
+        "plop": "^4.0.1",
+        "postcss": "^8.4.12",
+        "postcss-loader": "^8.1.1",
+        "postcss-preset-env": "^10.1.4",
+        "puppeteer": "^24.2.0",
+        "querystring": "^0.2.1",
+        "readline": "^1.3.0",
+        "sass": "^1.53.0",
+        "sass-loader": "^16.0.4",
+        "style-loader": "^4.0.0",
+        "terser-webpack-plugin": "^5.3.3",
+        "ts-loader": "^9.3.1",
+        "typescript": "^5.7.3",
+        "typescript-eslint": "^8.24.1",
+        "webpack": "^5.72.0",
+        "webpack-cli": "^6.0.1",
+        "wrapper-webpack-plugin": "^2.1.0"
+    },
+    "description": "[![npm version](https://badge.fury.io/js/at-builder.svg)](https://www.npmjs.com/package/at-builder)   [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)",
+    "directories": {
+        "lib": "lib",
+        "test": "test"
+    },
+    "devDependencies": {
+        "@babel/runtime": "^7.29.2"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/upesenga/at-builder.git"
+    },
+    "keywords": [],
+    "bugs": {
+        "url": "https://github.com/upesenga/at-builder/issues"
+    },
+    "homepage": "https://github.com/upesenga/at-builder#readme",
+    "engines": {
+        "node": ">=16.0.0"
+    },
+    "packageManager": "yarn@1.22.22+sha1.ac34549e6aa8e7ead463a7407e1c7390f61a6610"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "at-builder",
-    "version": "1.2.8",
+    "version": "1.3.3",
     "main": "bin/index.js",
     "bin": {
         "atb": "bin/index.js"
@@ -13,7 +13,9 @@
         "atb:build:dev:puppeteer": "webpack -- -w & npm run atb:puppeteer",
         "atb:puppeteer": "node puppeteer.js $b",
         "atb:plop:new:activity": "plop page",
-        "atb:build:deploy": "node lib/at-deploy.js"
+        "atb:build:deploy": "node lib/at-deploy.js",
+        "atb:build:sync": "node lib/at-sync.js",
+        "postinstall": "node lib/postinstall.js"
     },
     "author": "Upendra Sengar <upendrasengar456@gmail.com>",
     "license": "MIT",
@@ -25,6 +27,7 @@
         "@babel/plugin-transform-runtime": "^7.18.9",
         "@babel/preset-env": "^7.18.9",
         "@babel/preset-react": "^7.18.6",
+        "@eslint/js": "^9.20.0",
         "@types/node": "^22.13.2",
         "async": "^3.2.3",
         "axios": "^1.12.2",
@@ -36,10 +39,12 @@
         "commander": "^13.1.0",
         "cross-env": "^7.0.3",
         "css-loader": "^7.1.2",
-        "dotenv": "^16.0.0",
+        "dotenv": "16.4.5",
         "eslint": "^9.20.1",
         "eslint-webpack-plugin": "^4.2.0",
+        "globals": "^15.15.0",
         "inquirer": "^12.4.1",
+        "kleur": "^4.1.5",
         "plop": "^4.0.1",
         "postcss": "^8.4.12",
         "postcss-loader": "^8.1.1",
@@ -53,21 +58,19 @@
         "terser-webpack-plugin": "^5.3.3",
         "ts-loader": "^9.3.1",
         "typescript": "^5.7.3",
+        "typescript-eslint": "^8.24.1",
         "webpack": "^5.72.0",
         "webpack-cli": "^6.0.1",
-        "wrapper-webpack-plugin": "^2.1.0",
-        "@babel/runtime": "^7.28.3",
-        "@eslint/js": "^9.20.0",
-        "globals": "^15.15.0",
-        "kleur": "^4.1.5",
-        "typescript-eslint": "^8.24.1"
+        "wrapper-webpack-plugin": "^2.1.0"
     },
     "description": "[![npm version](https://badge.fury.io/js/at-builder.svg)](https://www.npmjs.com/package/at-builder)   [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)",
     "directories": {
         "lib": "lib",
         "test": "test"
     },
-    "devDependencies": {},
+    "devDependencies": {
+        "@babel/runtime": "^7.29.2"
+    },
     "repository": {
         "type": "git",
         "url": "git+https://github.com/upesenga/at-builder.git"
@@ -76,5 +79,9 @@
     "bugs": {
         "url": "https://github.com/upesenga/at-builder/issues"
     },
-    "homepage": "https://github.com/upesenga/at-builder#readme"
+    "homepage": "https://github.com/upesenga/at-builder#readme",
+    "engines": {
+        "node": ">=16.0.0"
+    },
+    "packageManager": "yarn@1.22.22+sha1.ac34549e6aa8e7ead463a7407e1c7390f61a6610"
 }