@aerostack/cli 1.3.5 → 1.5.0

package/README.md

@@ -29,6 +29,21 @@ npx aerostack deploy
 
 The first run downloads the binary from GitHub releases. Subsequent runs use the cached binary at `~/.aerostack/bin` (shared with the curl install).
 
+## Registry: add community functions
+
+Install open-source functions from the Aerostack registry into your project (Cloudflare or Node.js):
+
+```bash
+npx aerostack add stripe-checkout
+npx aerostack add alice/stripe-checkout
+npx aerostack add stripe-checkout --runtime=node
+```
+
+- **Cloudflare** (default): Adds Hono + D1 adapter and wires the route. Uses Drizzle in `src/db/` when the function has a schema.
+- **Node.js** (`--runtime=node`): Adds a Node/Express adapter. Pass your own Drizzle client (pg or sqlite) and mount the router in your app.
+
+Functions follow the **Open Function Standard**: one portable core, multiple adapters. You can use them in any Node.js project, not only on the Aerostack platform. See `planning/OPEN_FUNCTION_STANDARD.md` for the spec.
+
 ## Uninstall
 
 ```bash

package/bin/postinstall.js

@@ -1,41 +1,10 @@
 #!/usr/bin/env node
-/**
- * Postinstall: print PATH fix if aerostack bin not in PATH.
- */
-const path = require("path");
-const fs = require("fs");
-
-// Assuming there's a download function that might be added or already exists
-// and the user wants to wrap its execution.
-// For the purpose of this edit, we'll assume `downloadBinary()` is a placeholder
-// for the actual download logic that would be placed here.
-try {
-  // Original download logic (placeholder, as it's not in the provided original code)
-  // If downloadBinary() is not defined, this will cause a ReferenceError.
-  // The user's instruction implies this function exists or will be added.
-  // downloadBinary(); // Uncomment and define if actual download logic is intended here
-} catch (e) {
-  console.warn('⚠️  Aerostack CLI download failed. You may need to install it manually or check your connection.');
-  console.warn('   Details: ' + e.message);
-  // Do not exit with error, allow install to continue
-  process.exit(0);
-}
-
-// Global install: package at prefix/node_modules/aerostack, bin at prefix/bin
-const pkgRoot = path.resolve(__dirname, "..");
-const prefix = path.dirname(path.dirname(pkgRoot));
-const binDir = path.join(prefix, "bin");
-const binPath = path.join(binDir, process.platform === "win32" ? "aerostack.cmd" : "aerostack");
-
-if (!fs.existsSync(binDir)) return;
-
-const pathEnv = (process.env.PATH || "").split(path.delimiter);
-const inPath = pathEnv.some((p) => path.resolve(p) === path.resolve(binDir));
-
-if (!inPath) {
-  console.log("\n\u001b[33mAerostack installed. Add to PATH (run once, or add to ~/.zshrc):\u001b[0m");
-  console.log(`  \u001b[36mexport PATH="$PATH:${binDir}"\u001b[0m\n`);
-  console.log("Or use \u001b[32mnpx aerostack\u001b[0m (no PATH config needed).\n");
-} else {
-  console.log("\n\u001b[32mAerostack installed. Run: aerostack --version\u001b[0m\n");
+import { existsSync } from 'fs';
+import { join } from 'path';
+
+// Just a polite notice
+const binDir = join(process.env.HOME || process.env.USERPROFILE || '.', '.aerostack', 'bin');
+if (existsSync(binDir)) {
+  console.log(`\nAerostack is installed.`);
+  console.log(`To use the binary directly, add ${binDir} to your PATH.\n`);
 }

package/bin/run.js

@@ -1,20 +1,55 @@
 #!/usr/bin/env node
 /**
- * Aerostack CLI - npm/pnpm/yarn wrapper
- * Downloads the Go binary from GitHub releases on first run.
+ * Aerostack CLI - Hybrid Dispatcher
+ * 
+ * Routes specific commands (init, add, publish, list, login) to the
+ * pure Node.js implementation (drizzle/hono support).
+ * 
+ * All other commands map to the Go binary (legacy/platform).
  */
 
-const { spawn } = require("child_process");
-const fs = require("fs");
-const path = require("path");
+import { spawn } from 'child_process';
+import { existsSync, mkdirSync, chmodSync, writeFileSync, rmSync, renameSync } from 'fs';
+import { join, resolve } from 'path';
+import { platform as getOsPlatform, arch as getOsArch, tmpdir } from 'os';
+import { fileURLToPath } from 'url';
+
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+
+// ─── 1. Hybrid Dispatcher ──────────────────────────────────────────────────────
+
+const args = process.argv.slice(2);
+const command = args[0];
+const NODE_COMMANDS = ['init', 'add', 'publish', 'list', 'login'];
+
+if (command && NODE_COMMANDS.includes(command)) {
+  // Dispatch to Node.js implementation
+  import('../dist/index.js').then(m => m.run(args)).catch(err => {
+    console.error('Failed to run Node.js CLI:', err);
+    process.exit(1);
+  });
+} else {
+  // Dispatch to Go implementation
+  ensureBinary().then(binPath => {
+    const child = spawn(binPath, args, { stdio: 'inherit' });
+    child.on('exit', code => process.exit(code ?? 0));
+  }).catch(err => {
+    console.error('Error:', err.message);
+    process.exit(1);
+  });
+}
+
+// ─── 2. Go Binary Downloader (Legacy) ──────────────────────────────────────────
 
 const REPO = "aerostackdev/cli";
 const BINARY = "aerostack";
-const INSTALL_DIR = process.env.AEROSTACK_INSTALL_DIR || path.join(process.env.HOME || process.env.USERPROFILE, ".aerostack", "bin");
+// Use HOME or USERPROFILE for global install location
+const HOME = process.env.HOME || process.env.USERPROFILE || tmpdir();
+const INSTALL_DIR = process.env.AEROSTACK_INSTALL_DIR || join(HOME, ".aerostack", "bin");
 
 function getPlatform() {
-  const platform = process.platform;
-  const arch = process.arch;
+  const platform = getOsPlatform();
+  const arch = getOsArch();
   const map = {
     darwin: { arm64: "darwin_arm64", x64: "darwin_amd64" },
     linux: { arm64: "linux_arm64", x64: "linux_amd64" },
@@ -26,102 +61,69 @@ function getPlatform() {
 }
 
 async function getLatestVersion() {
-  const res = await fetch(`https://api.github.com/repos/${REPO}/releases/latest`, {
-    headers: { "User-Agent": "aerostack-cli-npm/1.0" },
-  });
-  if (!res.ok) throw new Error("Failed to fetch latest version");
-  const data = await res.text();
-  const m = data.match(/"tag_name":\s*"v([^"]+)"/);
-  if (!m) throw new Error("Could not parse version");
-  return m[1];
+  // If we can't check, fallback or fail. Here we try checking.
+  try {
+    const res = await fetch(`https://api.github.com/repos/${REPO}/releases/latest`, {
+      headers: { "User-Agent": "aerostack-cli-npm/1.5.0" },
+    });
+    if (!res.ok) return "1.3.0"; // Fallback if rate limited
+    const data = await res.json();
+    return data.tag_name.replace(/^v/, '');
+  } catch {
+    return "1.3.0";
+  }
 }
 
 async function downloadBinary(version, asset) {
   const ext = asset.startsWith("windows") ? "zip" : "tar.gz";
-  const archive = `${BINARY}_${version}_${asset}.${ext}`;
-  const url = `https://github.com/${REPO}/releases/download/v${version}/${archive}`;
+  const archive = `${BINARY}_v${version}_${asset}.${ext}`; // Check github release naming convention
+  // Usually: aerostack_1.3.0_darwin_arm64.tar.gz
+  // Let's assume standard GoReleaser naming: name_version_os_arch
+  const releaseName = `${BINARY}_${version}_${asset}.${ext}`;
 
-  const tmpDir = path.join(require("os").tmpdir(), `aerostack-${Date.now()}`);
-  fs.mkdirSync(tmpDir, { recursive: true });
-  const archivePath = path.join(tmpDir, archive);
+  const url = `https://github.com/${REPO}/releases/download/v${version}/${releaseName}`;
+  const tmpDir = join(tmpdir(), `aerostack-${Date.now()}`);
+  mkdirSync(tmpDir, { recursive: true });
+
+  const archivePath = join(tmpDir, releaseName);
+
+  console.error(`Downloading Aerostack Go Core v${version}...`);
+  const res = await fetch(url, { redirect: "follow" });
+  if (!res.ok) throw new Error(`Download failed: ${url} (${res.status})`);
 
-  const res = await fetch(url, {
-    headers: { "User-Agent": "aerostack-cli-npm/1.0" },
-    redirect: "follow",
-  });
-  if (!res.ok) throw new Error(`Download failed: ${url}`);
   const buffer = Buffer.from(await res.arrayBuffer());
-  fs.writeFileSync(archivePath, buffer);
+  writeFileSync(archivePath, buffer);
 
   const binDir = INSTALL_DIR;
-  fs.mkdirSync(binDir, { recursive: true });
-  const binPath = path.join(binDir, process.platform === "win32" ? `${BINARY}.exe` : BINARY);
+  mkdirSync(binDir, { recursive: true });
+  const binPath = join(binDir, process.platform === "win32" ? `${BINARY}.exe` : BINARY);
 
   if (ext === "zip") {
-    const AdmZip = require("adm-zip");
+    const AdmZip = (await import("adm-zip")).default;
     const zip = new AdmZip(archivePath);
     zip.extractAllTo(tmpDir, true);
-    const extracted = path.join(tmpDir, `${BINARY}.exe`);
-    fs.renameSync(extracted, binPath);
+    const extracted = join(tmpDir, `${BINARY}.exe`);
+    if (existsSync(extracted)) renameSync(extracted, binPath);
   } else {
-    const tar = require("tar");
+    const tar = (await import("tar")).default;
     await tar.x({ file: archivePath, cwd: tmpDir });
-    fs.renameSync(path.join(tmpDir, BINARY), binPath);
+    const extracted = join(tmpDir, BINARY);
+    if (existsSync(extracted)) renameSync(extracted, binPath);
   }
 
-  fs.chmodSync(binPath, 0o755);
-  fs.rmSync(tmpDir, { recursive: true, force: true });
+  chmodSync(binPath, 0o755);
+  try { rmSync(tmpDir, { recursive: true, force: true }); } catch { }
   return binPath;
 }
 
-async function getInstalledVersion(binPath) {
-  try {
-    const { execFileSync } = require("child_process");
-    const out = execFileSync(binPath, ["--version"], { encoding: "utf8" });
-    const m = out.match(/v?(\d+\.\d+\.\d+)/);
-    return m ? m[1] : null;
-  } catch {
-    return null;
-  }
-}
-
 async function ensureBinary() {
-  const binPath = path.join(INSTALL_DIR, process.platform === "win32" ? `${BINARY}.exe` : BINARY);
-  const { platform, arch, asset } = getPlatform();
-  const latestVersion = await getLatestVersion();
-
-  if (fs.existsSync(binPath)) {
-    const installed = await getInstalledVersion(binPath);
-    if (installed && installed === latestVersion) return binPath;
-    if (installed) console.error(`Updating Aerostack CLI v${installed} → v${latestVersion}...`);
-  } else {
-    console.error(`Downloading Aerostack CLI v${latestVersion}...`);
-  }
+  const binPath = join(INSTALL_DIR, process.platform === "win32" ? `${BINARY}.exe` : BINARY);
+  const { arch, asset } = getPlatform();
 
-  try {
-    return await downloadBinary(latestVersion, asset);
-  } catch (err) {
-    // Windows on ARM64 can run x64 binaries via emulation.
-    // If arm64 artifact is unavailable, fall back to windows_amd64.
-    if (platform === "win32" && arch === "arm64" && asset === "windows_arm64") {
-      return downloadBinary(latestVersion, "windows_amd64");
-    }
-    throw err;
-  }
-}
+  // For now, always try to grab latest or fallback
+  // In production we should cache version check
+  if (existsSync(binPath)) return binPath;
 
-async function main() {
-  try {
-    const binPath = await ensureBinary();
-    const child = spawn(binPath, process.argv.slice(2), {
-      stdio: "inherit",
-      shell: false,
-    });
-    child.on("exit", (code) => process.exit(code ?? 0));
-  } catch (err) {
-    console.error("Error:", err.message);
-    process.exit(1);
-  }
+  const version = await getLatestVersion();
+  return await downloadBinary(version, asset);
 }
-
-main();

package/package.json

@@ -1,20 +1,33 @@
 {
   "name": "@aerostack/cli",
-  "version": "1.3.5",
+  "version": "1.5.0",
   "description": "Aerostack CLI - Zero-config serverless development for Cloudflare",
+  "type": "module",
   "files": [
-    "bin"
+    "bin",
+    "dist",
+    "templates"
   ],
   "bin": {
     "aerostack": "bin/run.js"
   },
   "scripts": {
+    "build": "tsc",
     "postinstall": "node bin/postinstall.js",
     "uninstall": "node bin/uninstall.js"
   },
   "dependencies": {
     "adm-zip": "^0.5.16",
-    "tar": "^7.0.0"
+    "tar": "^7.0.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.0.1",
+    "prompts": "^2.4.2",
+    "node-fetch": "^3.3.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/prompts": "^2.4.9",
+    "typescript": "^5.9.3"
   },
   "keywords": [
     "aerostack",

package/templates/drizzle.config.ts

@@ -0,0 +1,16 @@
+import { defineConfig } from 'drizzle-kit';
+
+export default defineConfig({
+    schema: [
+        './src/db/schema.ts',           // Base/core tables
+        './src/modules/**/schema.ts'    // Auto-discover all installed module schemas
+    ],
+    out: './drizzle',
+    dialect: 'sqlite',
+    driver: 'd1-http',
+    dbCredentials: {
+        accountId: process.env.CLOUDFLARE_ACCOUNT_ID!,
+        databaseId: process.env.CLOUDFLARE_DATABASE_ID!,
+        token: process.env.CLOUDFLARE_D1_TOKEN!,
+    },
+});

package/templates/package.json

@@ -0,0 +1,23 @@
+{
+    "name": "{{PROJECT_NAME}}",
+    "version": "1.0.0",
+    "type": "module",
+    "private": true,
+    "scripts": {
+        "dev": "wrangler dev",
+        "deploy": "wrangler deploy",
+        "db:push": "drizzle-kit push",
+        "db:generate": "drizzle-kit generate",
+        "db:studio": "drizzle-kit studio"
+    },
+    "dependencies": {
+        "drizzle-orm": "^0.45.1",
+        "hono": "^4.0.0"
+    },
+    "devDependencies": {
+        "@cloudflare/workers-types": "^4.20250219.0",
+        "drizzle-kit": "^0.31.0",
+        "typescript": "^5.9.0",
+        "wrangler": "^4.0.0"
+    }
+}

package/templates/src/db/client.ts

@@ -0,0 +1,12 @@
+import { drizzle } from 'drizzle-orm/d1';
+import * as schema from './schema';
+
+export type DrizzleDB = ReturnType<typeof createDb>;
+
+/**
+ * Creates a Drizzle database client bound to the Cloudflare D1 instance.
+ * Call this inside each request handler: const db = createDb(c.env.DB);
+ */
+export function createDb(d1: D1Database) {
+    return drizzle(d1, { schema });
+}

package/templates/src/db/schema.ts

@@ -0,0 +1,14 @@
+/**
+ * src/db/schema.ts — Central Schema Hub
+ *
+ * This file re-exports all table schemas from installed modules.
+ * Drizzle uses this for type-safe query building.
+ *
+ * When you run `npx aerostack add <module>`, the module's schema
+ * is imported here automatically.
+ */
+
+// aerostack:schema-imports — module schemas are auto-imported above this line
+
+// Export everything for Drizzle's relational queries
+// aerostack:schema-exports — exports are auto-added above this line

package/templates/src/index.ts

@@ -0,0 +1,28 @@
+/**
+ * src/index.ts — Aerostack Base Project
+ * 
+ * This is the main entry point for your Cloudflare Worker.
+ * Routes from installed modules are mounted here automatically
+ * when you run `npx aerostack add <function-name>`.
+ */
+import { Hono } from 'hono';
+
+// ─── Module Routes ─────────────────────────────────────────────────────────────
+// aerostack:imports — imports are auto-injected above this line
+
+const app = new Hono<{
+    Bindings: {
+        DB: D1Database;
+        CACHE: KVNamespace;
+        AI: Ai;
+        [key: string]: unknown;
+    }
+}>();
+
+// ─── Installed Module Routes ──────────────────────────────────────────────────
+// aerostack:routes — routes are auto-injected above this line
+
+// ─── Health Check ─────────────────────────────────────────────────────────────
+app.get('/health', (c) => c.json({ status: 'ok', timestamp: Date.now() }));
+
+export default app;

package/templates/tsconfig.json

@@ -0,0 +1,29 @@
+{
+    "compilerOptions": {
+        "target": "ES2022",
+        "module": "ESNext",
+        "moduleResolution": "bundler",
+        "lib": [
+            "ES2022"
+        ],
+        "types": [
+            "@cloudflare/workers-types"
+        ],
+        "strict": true,
+        "noEmit": true,
+        "allowImportingTsExtensions": true,
+        "paths": {
+            "@/*": [
+                "./src/*"
+            ]
+        }
+    },
+    "include": [
+        "src",
+        "**/*.ts"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist"
+    ]
+}

package/templates/wrangler.toml

@@ -0,0 +1,16 @@
+name = "{{PROJECT_NAME}}"
+main = "src/index.ts"
+compatibility_date = "2025-01-01"
+compatibility_flags = ["nodejs_compat"]
+
+[[d1_databases]]
+binding = "DB"
+database_name = "{{PROJECT_NAME}}-db"
+database_id = "YOUR_DATABASE_ID_HERE"
+
+[[kv_namespaces]]
+binding = "CACHE"
+id = "YOUR_KV_ID_HERE"
+
+[ai]
+binding = "AI"