@factorialco/fcode-cli 1.1.1 → 1.2.0

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @factorialco/fcode-cli
 $ fcode COMMAND
 running command...
 $ fcode (--version)
-@factorialco/fcode-cli/1.1.1 linux-x64 node-v22.22.3
+@factorialco/fcode-cli/1.2.0 linux-x64 node-v22.22.3
 $ fcode --help [COMMAND]
 USAGE
   $ fcode COMMAND

package/dist/core/executors/javascript-execution-task.js

@@ -587,7 +587,14 @@ const main = typeof _hooksModule['${fn}'] === 'function'
               console.log('[fcode] variables.delete removed ' + key + ' from variables.local.env (local run).');
             }
           };
-        })()
+        })(),
+        sendMail: async ({ to, subject, text, html } = {}) => {
+          // No manager locally: log the email contents instead of sending, so
+          // devs can see exactly what would be delivered when run in the cloud.
+          console.log('[fcode] sendMail (local run) — not sent, logging contents below:');
+          console.log(JSON.stringify({ to, subject, text, html }, null, 2));
+          return { messageId: 'local-run', accepted: [].concat(to || []), rejected: [] };
+        }
       };
       ${Object.entries(this.getVariablesObject())
                 .map(([key, value]) => `process.env['${key}'] = process.env['${key}'] ?? ${JSON.stringify(value)}`)

package/dist/env.d.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+/**
+ * Validated environment schema for the fcode CLI. This is the single source of truth
+ * for the environment variables the CLI reads — add new vars here.
+ *
+ * Unlike the long-running services (storage-api, ai), a CLI reads config lazily and
+ * different commands need different vars, so there is currently NO universally required
+ * variable: every entry is optional or carries a default that preserves prior behavior.
+ * The fail-fast (❌ + exit 1) path is kept for parity with the services and so that a
+ * genuinely-required var added later fails at process start listing every problem.
+ */
+export declare const envSchema: z.ZodObject<{
+    FCODE_CLOUD_URL: z.ZodDefault<z.ZodString>;
+    FCODE_AUTH_URL: z.ZodOptional<z.ZodString>;
+    FCODE_CLIENT_ID: z.ZodDefault<z.ZodString>;
+    FCODE_CONFIG_PATH: z.ZodOptional<z.ZodString>;
+    IGNORE_WORKSPACE_NOT_EMPTY: z.ZodOptional<z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>>;
+    FCODE_DISABLE_UPDATE_NOTIFIER: z.ZodOptional<z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>>;
+    SILENT_MODE: z.ZodOptional<z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>>;
+    CLI_UX_SKIP_TTY_CHECK: z.ZodOptional<z.ZodString>;
+    YC_COMMAND: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const env: {
+    FCODE_CLOUD_URL: string;
+    FCODE_CLIENT_ID: string;
+    FCODE_AUTH_URL?: string | undefined;
+    FCODE_CONFIG_PATH?: string | undefined;
+    IGNORE_WORKSPACE_NOT_EMPTY?: "true" | "false" | undefined;
+    FCODE_DISABLE_UPDATE_NOTIFIER?: "true" | "false" | undefined;
+    SILENT_MODE?: "true" | "false" | undefined;
+    CLI_UX_SKIP_TTY_CHECK?: string | undefined;
+    YC_COMMAND?: string | undefined;
+};
+export default env;

package/dist/env.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.env = exports.envSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Validated environment schema for the fcode CLI. This is the single source of truth
+ * for the environment variables the CLI reads — add new vars here.
+ *
+ * Unlike the long-running services (storage-api, ai), a CLI reads config lazily and
+ * different commands need different vars, so there is currently NO universally required
+ * variable: every entry is optional or carries a default that preserves prior behavior.
+ * The fail-fast (❌ + exit 1) path is kept for parity with the services and so that a
+ * genuinely-required var added later fails at process start listing every problem.
+ */
+exports.envSchema = zod_1.z.object({
+    // --- Cloud / auth endpoints ---
+    FCODE_CLOUD_URL: zod_1.z.string().min(1).default('https://code.factorial.dev/platform'),
+    FCODE_AUTH_URL: zod_1.z.string().min(1).optional(),
+    FCODE_CLIENT_ID: zod_1.z.string().min(1).default('cli'),
+    // --- Local config location (defaults to os.homedir() at the call site) ---
+    FCODE_CONFIG_PATH: zod_1.z.string().min(1).optional(),
+    // --- Behavior flags (compared as the strings 'true' / 'false' at the call sites) ---
+    IGNORE_WORKSPACE_NOT_EMPTY: zod_1.z.enum(['true', 'false']).optional(),
+    FCODE_DISABLE_UPDATE_NOTIFIER: zod_1.z.enum(['true', 'false']).optional(),
+    SILENT_MODE: zod_1.z.enum(['true', 'false']).optional(),
+    CLI_UX_SKIP_TTY_CHECK: zod_1.z.string().min(1).optional(),
+    // --- Debug tooling ---
+    YC_COMMAND: zod_1.z.string().min(1).optional(),
+});
+/** Treat empty strings (e.g. an unset shell/dotenv var rendered as "") as missing. */
+const raw = Object.fromEntries(Object.entries(process.env).filter(([, value]) => value !== ''));
+/**
+ * Skip the hard fail-fast under test runners and when explicitly opted out, so importing
+ * this module never kills a test worker. Real invocations always validate.
+ */
+const skipHardExit = Boolean(process.env.VITEST) || process.env.SKIP_ENV_VALIDATION === 'true';
+const result = exports.envSchema.safeParse(raw);
+let parsed;
+if (result.success) {
+    parsed = result.data;
+}
+else if (skipHardExit) {
+    // No universally-required vars today, so parsing `raw` alone succeeds; this branch stays
+    // for parity with the services if a required var is ever added.
+    parsed = exports.envSchema.parse(raw);
+}
+else {
+    const issues = result.error.issues.map((issue) => `  - ${issue.path.join('.') || '(root)'}: ${issue.message}`).join('\n');
+    process.stderr.write(`❌ Invalid environment variables:\n${issues}\n`);
+    process.exit(1);
+}
+exports.env = parsed;
+exports.default = exports.env;

package/dist/hooks/init/update.js

@@ -20,14 +20,12 @@ const updateNotifier = async function ({ config, id }) {
             await globalConfig.set('versionCheckTime', now);
             if (config.version !== lastestVersion) {
                 console.log(`
-        ${color_1.default.cyan(`__     __         _____          _
-        \\ \\   / /        / ____|        | |
-         \\ \\_/ /__ _ __ | |     ___   __| | ___
-          \\   / _ \\ '_ \\| |    / _ \\ / _\` |/ _ \\
-           | |  __/ |_) | |___| (_) | (_| |  __/
-           |_|\\___| .__/ \\_____\\___/ \\__,_|\\___|
-                  | |
-                  |_|`)}
+        ${color_1.default.cyan(` ______         _             _       _  _____          _
+        |  ____|       | |           (_)     | |/ ____|        | |
+        | |__ __ _  ___| |_ ___  _ __ _  __ _| | |     ___   __| | ___
+        |  __/ _\` |/ __| __/ _ \\| '__| |/ _\` | | |    / _ \\ / _\` |/ _ \\
+        | | | (_| | (__| || (_) | |  | | (_| | | |___| (_) | (_| |  __/
+        |_|  \\__,_|\\___|\\__\\___/|_|  |_|\\__,_|_|\\_____\\___/ \\__,_|\\___|`)}
 
         Update available ${color_1.default.red(config.version)} → ${color_1.default.greenBright(lastestVersion)}
         Run ${color_1.default.bold('`npm i -g @factorialco/fcode-cli`')} to update

package/dist/runtime/libs/python/fcode/context.py

@@ -90,6 +90,25 @@ class FcodeGlobal:
         self.variables = variables
         self.processes = Processes()
 
+    def send_mail(self, to=None, subject=None, text=None, html=None):
+        # No manager locally: log the email contents instead of sending, so devs
+        # can see exactly what would be delivered when run in the cloud.
+        import json
+        import logging
+
+        logger = logging.getLogger("fcode_logger")
+        logger.info(
+            "[fcode] send_mail (local run) — not sent, logging contents below:"
+        )
+        logger.info(
+            json.dumps(
+                {"to": to, "subject": subject, "text": text, "html": html},
+                indent=2,
+            )
+        )
+        accepted = to if isinstance(to, list) else ([to] if to else [])
+        return {"messageId": "local-run", "accepted": accepted, "rejected": []}
+
     def import_module(self, module_name, version=None):
         module_path = module_name
         if version:

package/oclif.manifest.json

@@ -1779,5 +1779,5 @@
       ]
     }
   },
-  "version": "1.1.1"
+  "version": "1.2.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@factorialco/fcode-cli",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "packageManager": "pnpm@11.7.0",
   "description": "Factorial Code Command Line Interface",
   "homepage": "https://code.factorialhr.com/docs/cli/",
@@ -40,7 +40,8 @@
     "open": "^8.4.2",
     "openid-client": "^5.6.5",
     "string-width": "^4.2.3",
-    "strip-comments": "^2.0.1"
+    "strip-comments": "^2.0.1",
+    "zod": "^4.4.3"
   },
   "peerDependencies": {
     "graphql-request": "^7.4.0",