@factorialco/fcode-cli 3.1.0 → 3.3.0

package/dist/services/version-pull-reporter.d.ts

@@ -0,0 +1,20 @@
+/** One resource's version pull, named so a failure can say which resource it belongs to. */
+export interface VersionPull {
+    slug: string;
+    failure: Promise<string | undefined>;
+}
+/**
+ * Starts tracking one resource's version pull.
+ *
+ * The outcome is captured here rather than where it is reported, because the pulls are started in
+ * a loop that waits between them: a rejection would otherwise sit unhandled until the loop ends.
+ */
+export declare function trackVersionPull(slug: string, done: Promise<void>): VersionPull;
+/**
+ * Awaits every version pull and reports the ones that failed.
+ *
+ * The pulls run in parallel and must not take each other down — one resource the cloud refuses is
+ * not a reason to abandon the rest — but a swallowed rejection leaves `versions/` silently empty,
+ * which reads exactly like a resource that has no versions. This is what tells the two apart.
+ */
+export declare function reportFailedVersionPulls(pulls: Array<VersionPull>, resourceName: string): Promise<void>;

package/dist/services/version-pull-reporter.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trackVersionPull = trackVersionPull;
+exports.reportFailedVersionPulls = reportFailedVersionPulls;
+const color_1 = require("@oclif/color");
+const cli_1 = require("../utils/cli");
+/**
+ * Starts tracking one resource's version pull.
+ *
+ * The outcome is captured here rather than where it is reported, because the pulls are started in
+ * a loop that waits between them: a rejection would otherwise sit unhandled until the loop ends.
+ */
+function trackVersionPull(slug, done) {
+    return {
+        slug,
+        failure: done.then(() => undefined, (reason) => (reason instanceof Error ? reason.message : String(reason))),
+    };
+}
+/**
+ * Awaits every version pull and reports the ones that failed.
+ *
+ * The pulls run in parallel and must not take each other down — one resource the cloud refuses is
+ * not a reason to abandon the rest — but a swallowed rejection leaves `versions/` silently empty,
+ * which reads exactly like a resource that has no versions. This is what tells the two apart.
+ */
+async function reportFailedVersionPulls(pulls, resourceName) {
+    for (const { slug, failure } of pulls) {
+        const reason = await failure;
+        if (reason !== undefined) {
+            cli_1.default.log(color_1.default.yellow(`⚠️  could not pull the versions of ${resourceName} '${slug}': ${reason}`));
+        }
+    }
+}

package/dist/utils/child-process.d.ts

@@ -0,0 +1,26 @@
+import { type ChildProcess, type SpawnOptions } from 'node:child_process';
+export type Platform = NodeJS.Platform;
+export interface CommandLine {
+    command: string;
+    args: string[];
+    shell: boolean;
+}
+/**
+ * How to invoke a package-manager executable (`npm`, `npx`, a `node_modules/.bin` shim) on `platform`.
+ *
+ * On Windows those are `.cmd` batch files, which Node refuses to spawn without a shell, so the
+ * command line goes through `cmd.exe` with every part quoted for it.
+ */
+export declare function commandLineFor(command: string, args: string[], platform?: Platform): CommandLine;
+export declare function spawnCommand(command: string, args: string[], options?: SpawnOptions): ChildProcess;
+/** The `node_modules/.bin` shim `name` resolves to on `platform`. */
+export declare function binShimPath(nodeModulesPath: string, name: string, platform?: Platform): string;
+/** The executable `name` a Python virtual environment at `envPath` exposes on `platform`. */
+export declare function venvExecutablePath(envPath: string, name: string, platform?: Platform): string;
+/** The Python interpreter of the virtual environment at `envPath`; Windows venvs ship no `python3` alias. */
+export declare function venvPythonPath(envPath: string, platform?: Platform): string;
+/**
+ * An environment for a process run locally: the entries given plus, on Windows, the system
+ * variables Node and Python cannot start without (`SYSTEMROOT`, `TEMP`, ...).
+ */
+export declare function childEnv(entries: Record<string, string | undefined>, platform?: Platform, hostEnv?: NodeJS.ProcessEnv): Record<string, string>;

package/dist/utils/child-process.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commandLineFor = commandLineFor;
+exports.spawnCommand = spawnCommand;
+exports.binShimPath = binShimPath;
+exports.venvExecutablePath = venvExecutablePath;
+exports.venvPythonPath = venvPythonPath;
+exports.childEnv = childEnv;
+const node_child_process_1 = require("node:child_process");
+const path = require("node:path");
+const quoteForCmd = (part) => (/[\s"]/.test(part) ? `"${part.replace(/"/g, '""')}"` : part);
+/**
+ * How to invoke a package-manager executable (`npm`, `npx`, a `node_modules/.bin` shim) on `platform`.
+ *
+ * On Windows those are `.cmd` batch files, which Node refuses to spawn without a shell, so the
+ * command line goes through `cmd.exe` with every part quoted for it.
+ */
+function commandLineFor(command, args, platform = process.platform) {
+    if (platform !== 'win32') {
+        return { command, args, shell: false };
+    }
+    return { command: quoteForCmd(command), args: args.map(quoteForCmd), shell: true };
+}
+function spawnCommand(command, args, options = {}) {
+    const line = commandLineFor(command, args);
+    return (0, node_child_process_1.spawn)(line.command, line.args, { ...options, shell: line.shell });
+}
+/** The `node_modules/.bin` shim `name` resolves to on `platform`. */
+function binShimPath(nodeModulesPath, name, platform = process.platform) {
+    return path.join(nodeModulesPath, '.bin', platform === 'win32' ? `${name}.cmd` : name);
+}
+/** The executable `name` a Python virtual environment at `envPath` exposes on `platform`. */
+function venvExecutablePath(envPath, name, platform = process.platform) {
+    return platform === 'win32' ? path.join(envPath, 'Scripts', `${name}.exe`) : path.join(envPath, 'bin', name);
+}
+/** The Python interpreter of the virtual environment at `envPath`; Windows venvs ship no `python3` alias. */
+function venvPythonPath(envPath, platform = process.platform) {
+    return venvExecutablePath(envPath, platform === 'win32' ? 'python' : 'python3', platform);
+}
+const WINDOWS_SYSTEM_ENV_KEYS = ['SYSTEMROOT', 'SYSTEMDRIVE', 'WINDIR', 'COMSPEC', 'PATHEXT', 'TEMP', 'TMP', 'USERPROFILE', 'APPDATA', 'LOCALAPPDATA'];
+/**
+ * An environment for a process run locally: the entries given plus, on Windows, the system
+ * variables Node and Python cannot start without (`SYSTEMROOT`, `TEMP`, ...).
+ */
+function childEnv(entries, platform = process.platform, hostEnv = process.env) {
+    const env = {};
+    if (platform === 'win32') {
+        for (const [key, value] of Object.entries(hostEnv)) {
+            if (value !== undefined && WINDOWS_SYSTEM_ENV_KEYS.includes(key.toUpperCase())) {
+                env[key] = value;
+            }
+        }
+    }
+    for (const [key, value] of Object.entries(entries)) {
+        if (value !== undefined) {
+            env[key] = value;
+        }
+    }
+    return env;
+}

package/oclif.manifest.json

@@ -220,7 +220,7 @@
         },
         "prompt": {
           "char": "x",
-          "description": "Prompt for email and password (instead of opening browser)",
+          "description": "Prompt for email and password (instead of opening browser). Make it the default with 'fcode config:set disableBrowserLogin true' or FCODE_DISABLE_BROWSER_LOGIN=true",
           "name": "prompt",
           "allowNo": false,
           "type": "boolean"
@@ -701,6 +701,39 @@
         "test.js"
       ]
     },
+    "app:push": {
+      "aliases": [],
+      "args": {},
+      "description": "Upload the App folder's README.md and MARKETPLACE.md to the dashboard",
+      "examples": [
+        "$ fcode app:push",
+        "$ fcode app:push --force"
+      ],
+      "flags": {
+        "force": {
+          "char": "f",
+          "description": "Force command",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "app:push",
+      "pluginAlias": "@factorialco/fcode-cli",
+      "pluginName": "@factorialco/fcode-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "app",
+        "push.js"
+      ]
+    },
     "config:get": {
       "aliases": [],
       "args": {
@@ -2483,5 +2516,5 @@
       ]
     }
   },
-  "version": "3.1.0"
+  "version": "3.3.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@factorialco/fcode-cli",
-  "version": "3.1.0",
+  "version": "3.3.0",
   "packageManager": "pnpm@11.7.0",
   "description": "Factorial Code Command Line Interface",
   "homepage": "https://code.factorialhr.com/docs/cli/",
@@ -127,6 +127,9 @@
       },
       "team": {
         "description": "Work with every App your development team owns, in one folder"
+      },
+      "app": {
+        "description": "Work on the App folder around a workspace: its README, marketplace listing and changelog"
       }
     }
   },