@jelou/cli 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,25 @@
+Copyright 2026 Jelou Inc. All rights reserved.
+
+This software and associated documentation files (the "Software") are the
+proprietary property of Jelou Inc. ("Jelou").
+
+Permission is hereby granted to any person who obtains a copy of this Software
+to use the Software solely for the purpose of interacting with services
+provided by Jelou, subject to the following conditions:
+
+1. You may not modify, merge, publish, distribute, sublicense, or sell copies
+   of the Software.
+
+2. You may not reverse engineer, decompile, or disassemble the Software.
+
+3. You may not use the Software to build a competing product or service.
+
+4. The above copyright notice and this permission notice shall be included in
+   all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL JELOU
+INC. BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,115 @@
+# @jelou/cli
+
+Command-line tool for [Jelou Functions](https://jelou.ai) — serverless
+TypeScript functions on the edge.
+
+One `define()` call gives you:
+
+- An **HTTP endpoint** with Zod validation and CORS
+- An **MCP tool** discoverable by AI agents
+- **Cron schedules** for recurring tasks
+
+Use it to build webhook handlers, chatbot integrations, scheduled cleanups, API
+proxies, and AI agent tools.
+
+## Install
+
+```bash
+# npm (recommended)
+npm install -g @jelou/cli
+
+# npx (no install)
+npx @jelou/cli deploy
+
+# Deno
+deno install -A -n jelou jsr:@jelou/cli
+```
+
+Verify the installation:
+
+```bash
+jelou --version
+```
+
+## Quick Start
+
+```bash
+# Authenticate
+jelou login
+
+# Create a new function
+mkdir my-function && cd my-function
+jelou init
+
+# Start local dev server with hot reload
+jelou dev
+# → http://localhost:3000
+
+# Deploy to production
+jelou deploy
+# → https://my-function.fn.jelou.ai
+```
+
+## Commands
+
+| Group        | Command           | Description                         |
+| ------------ | ----------------- | ----------------------------------- |
+| **Auth**     | `jelou login`     | Authenticate with your access token |
+|              | `jelou logout`    | Remove stored credentials           |
+|              | `jelou whoami`    | Show current identity and scopes    |
+| **Workflow** | `jelou init`      | Scaffold a new function project     |
+|              | `jelou dev`       | Local dev server with hot reload    |
+|              | `jelou deploy`    | Deploy to production                |
+|              | `jelou rollback`  | Roll back to a previous deployment  |
+|              | `jelou logs`      | Stream or fetch function logs       |
+| **Manage**   | `jelou functions` | List, create, delete functions      |
+|              | `jelou secrets`   | Manage environment secrets          |
+|              | `jelou tokens`    | Manage access tokens                |
+|              | `jelou cron`      | View cron schedules                 |
+|              | `jelou analytics` | View request/latency metrics        |
+| **Setup**    | `jelou skill`     | Install Jelou Functions agent skill |
+
+Run `jelou <command> --help` for flags and usage details.
+
+## CI / Non-Interactive Mode
+
+Every command works headlessly in CI pipelines.
+
+```bash
+export JELOU_TOKEN=jfn_pat_your_token_here
+
+jelou deploy --no-confirm --json | jq '.data.url'
+```
+
+- `--no-input` disables all prompts (auto-detected when `CI=true` or stdin is
+  not a TTY)
+- `--json` outputs `{ "ok": true, "data": ... }` to stdout
+
+See the [full CI reference](../../docs/cli.md#ci--non-interactive-mode) for
+per-command flags and GitHub Actions examples.
+
+## Configuration
+
+| Source          | Purpose                                    |
+| --------------- | ------------------------------------------ |
+| `jelou.json`    | Project config (function slug, entrypoint) |
+| `~/.jelou/`     | User credentials and API URL override      |
+| `JELOU_TOKEN`   | Access token (overrides saved credentials) |
+| `JELOU_API_URL` | API base URL override                      |
+
+See the
+[full configuration reference](../../docs/cli.md#configuration-reference) for
+details.
+
+## Documentation
+
+- [CLI Reference](../../docs/cli.md) — full command docs, flags, CI usage,
+  troubleshooting
+- [SDK Guide](../../docs/functions.md) — `define()` API, context, validation,
+  testing
+
+## License
+
+Copyright 2026 Jelou Inc. All rights reserved.
+
+See [LICENSE](./LICENSE) for details.

package/bin/jelou

@@ -1,22 +1,44 @@
 #!/usr/bin/env node
 
-const { existsSync } = require("fs");
-const { join } = require("path");
 const { execFileSync } = require("child_process");
+const { join } = require("path");
+
+const PLATFORMS = {
+  "darwin-arm64": "@jelou/cli-darwin-arm64",
+  "darwin-x64": "@jelou/cli-darwin-x64",
+  "linux-x64": "@jelou/cli-linux-x64",
+  "linux-arm64": "@jelou/cli-linux-arm64",
+  "win32-x64": "@jelou/cli-win32-x64",
+};
 
-const ext = process.platform === "win32" ? ".exe" : "";
-const bin = join(__dirname, `jelou${ext}`);
+const key = `${process.platform}-${process.arch}`;
+const pkg = PLATFORMS[key];
 
-if (!existsSync(bin)) {
+if (!pkg) {
+  console.error(
+    `@jelou/cli: unsupported platform ${key}\n` +
+    `Supported: ${Object.keys(PLATFORMS).join(", ")}\n` +
+    `Download manually from https://github.com/JelouLatam/jelou-functions-api/releases`
+  );
+  process.exit(1);
+}
+
+let binPath;
+try {
+  const pkgJson = require.resolve(`${pkg}/package.json`);
+  const ext = process.platform === "win32" ? ".exe" : "";
+  binPath = join(pkgJson, "..", "bin", `jelou${ext}`);
+} catch {
   console.error(
-    "jelou binary not found. Try reinstalling:\n\n" +
-    "  npm install -g @jelou/cli\n"
+    `@jelou/cli: platform package ${pkg} is not installed.\n\n` +
+    `This usually means npm was run with --no-optional. Reinstall with:\n\n` +
+    `  npm install -g @jelou/cli\n`
   );
   process.exit(1);
 }
 
 try {
-  execFileSync(bin, process.argv.slice(2), { stdio: "inherit" });
+  execFileSync(binPath, process.argv.slice(2), { stdio: "inherit" });
 } catch (err) {
   if (err.status !== undefined) process.exit(err.status);
   throw err;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jelou/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Jelou Functions CLI — deploy serverless TypeScript functions to the edge",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {
@@ -12,15 +12,18 @@
   "bin": {
     "jelou": "bin/jelou"
   },
-  "scripts": {
-    "postinstall": "node scripts/postinstall.js"
-  },
   "files": [
     "bin/",
-    "scripts/",
     "README.md",
     "LICENSE"
   ],
+  "optionalDependencies": {
+    "@jelou/cli-darwin-arm64": "0.2.0",
+    "@jelou/cli-darwin-x64": "0.2.0",
+    "@jelou/cli-linux-x64": "0.2.0",
+    "@jelou/cli-linux-arm64": "0.2.0",
+    "@jelou/cli-win32-x64": "0.2.0"
+  },
   "keywords": [
     "jelou",
     "serverless",

package/scripts/postinstall.js

@@ -1,87 +0,0 @@
-#!/usr/bin/env node
-
-const { existsSync, mkdirSync, chmodSync, createWriteStream, unlinkSync } = require("fs");
-const { join } = require("path");
-const https = require("https");
-const { execSync } = require("child_process");
-
-const pkg = require("../package.json");
-const VERSION = pkg.version;
-const REPO = "JelouLatam/jelou-functions-api";
-const BIN_DIR = join(__dirname, "..", "bin");
-const BIN_PATH = join(BIN_DIR, process.platform === "win32" ? "jelou.exe" : "jelou");
-
-const PLATFORM_MAP = {
-  "darwin-arm64": "jelou-aarch64-apple-darwin",
-  "darwin-x64": "jelou-x86_64-apple-darwin",
-  "linux-x64": "jelou-x86_64-unknown-linux-gnu",
-  "linux-arm64": "jelou-aarch64-unknown-linux-gnu",
-  "win32-x64": "jelou-x86_64-pc-windows-msvc.exe",
-};
-
-function getAssetName() {
-  const key = `${process.platform}-${process.arch}`;
-  const name = PLATFORM_MAP[key];
-  if (!name) {
-    console.error(
-      `@jelou/cli: unsupported platform ${key}.\n` +
-      `Supported: ${Object.keys(PLATFORM_MAP).join(", ")}\n` +
-      `Install manually from https://github.com/${REPO}/releases`
-    );
-    process.exit(1);
-  }
-  return name;
-}
-
-function download(url, dest) {
-  return new Promise((resolve, reject) => {
-    const follow = (url) => {
-      https.get(url, { headers: { "User-Agent": "jelou-cli-postinstall" } }, (res) => {
-        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
-          follow(res.headers.location);
-          return;
-        }
-        if (res.statusCode !== 200) {
-          reject(new Error(`Download failed: HTTP ${res.statusCode} from ${url}`));
-          return;
-        }
-        const file = createWriteStream(dest);
-        res.pipe(file);
-        file.on("finish", () => file.close(resolve));
-        file.on("error", (err) => {
-          unlinkSync(dest);
-          reject(err);
-        });
-      }).on("error", reject);
-    };
-    follow(url);
-  });
-}
-
-async function main() {
-  if (process.env.JELOU_CLI_SKIP_INSTALL) {
-    console.log("@jelou/cli: skipping binary download (JELOU_CLI_SKIP_INSTALL)");
-    return;
-  }
-
-  const asset = getAssetName();
-  const url = `https://github.com/${REPO}/releases/download/cli-v${VERSION}/${asset}`;
-
-  if (!existsSync(BIN_DIR)) mkdirSync(BIN_DIR, { recursive: true });
-
-  console.log(`@jelou/cli: downloading ${asset} v${VERSION}...`);
-
-  try {
-    await download(url, BIN_PATH);
-    if (process.platform !== "win32") {
-      chmodSync(BIN_PATH, 0o755);
-    }
-    console.log("@jelou/cli: installed successfully");
-  } catch (err) {
-    console.error(`@jelou/cli: failed to download binary — ${err.message}`);
-    console.error(`Download manually from: https://github.com/${REPO}/releases/tag/cli-v${VERSION}`);
-    process.exit(0);
-  }
-}
-
-main();