clefbase 1.4.1 → 1.5.1

package/dist/cli.js

@@ -959,8 +959,8 @@ var require_command = __commonJS({
   "node_modules/commander/lib/command.js"(exports2) {
     var EventEmitter = require("node:events").EventEmitter;
     var childProcess = require("node:child_process");
-    var path5 = require("node:path");
-    var fs4 = require("node:fs");
+    var path6 = require("node:path");
+    var fs5 = require("node:fs");
     var process11 = require("node:process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
@@ -1893,11 +1893,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path5.resolve(baseDir, baseName);
-          if (fs4.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path5.extname(baseName))) return void 0;
+          const localBin = path6.resolve(baseDir, baseName);
+          if (fs5.existsSync(localBin)) return localBin;
+          if (sourceExt.includes(path6.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
-            (ext) => fs4.existsSync(`${localBin}${ext}`)
+            (ext) => fs5.existsSync(`${localBin}${ext}`)
           );
           if (foundExt) return `${localBin}${foundExt}`;
           return void 0;
@@ -1909,21 +1909,21 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._scriptPath) {
           let resolvedScriptPath;
           try {
-            resolvedScriptPath = fs4.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs5.realpathSync(this._scriptPath);
           } catch (err) {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path5.resolve(
-            path5.dirname(resolvedScriptPath),
+          executableDir = path6.resolve(
+            path6.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path5.basename(
+            const legacyName = path6.basename(
               this._scriptPath,
-              path5.extname(this._scriptPath)
+              path6.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -1934,7 +1934,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path5.extname(executableFile));
+        launchWithNode = sourceExt.includes(path6.extname(executableFile));
         let proc;
         if (process11.platform !== "win32") {
           if (launchWithNode) {
@@ -2776,7 +2776,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path5.basename(filename, path5.extname(filename));
+        this._name = path6.basename(filename, path6.extname(filename));
         return this;
       }
       /**
@@ -2790,9 +2790,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path6) {
-        if (path6 === void 0) return this._executableDir;
-        this._executableDir = path6;
+      executableDir(path7) {
+        if (path7 === void 0) return this._executableDir;
+        this._executableDir = path7;
         return this;
       }
       /**
@@ -13742,15 +13742,15 @@ var require_route = __commonJS({
       };
     }
     function wrapConversion(toModel, graph) {
-      const path5 = [graph[toModel].parent, toModel];
+      const path6 = [graph[toModel].parent, toModel];
       let fn = conversions[graph[toModel].parent][toModel];
       let cur = graph[toModel].parent;
       while (graph[cur].parent) {
-        path5.unshift(graph[cur].parent);
+        path6.unshift(graph[cur].parent);
         fn = link(conversions[graph[cur].parent][cur], fn);
         cur = graph[cur].parent;
       }
-      fn.conversion = path5;
+      fn.conversion = path6;
       return fn;
     }
     module2.exports = function(fromModel) {
@@ -25890,10 +25890,10 @@ var require_lib = __commonJS({
     exports2.analyse = analyse;
     var detectFile = (filepath, opts = {}) => new Promise((resolve, reject) => {
       let fd;
-      const fs4 = (0, node_1.default)();
+      const fs5 = (0, node_1.default)();
       const handler = (err, buffer) => {
         if (fd) {
-          fs4.closeSync(fd);
+          fs5.closeSync(fd);
         }
         if (err) {
           reject(err);
@@ -25905,9 +25905,9 @@ var require_lib = __commonJS({
       };
       const sampleSize = (opts === null || opts === void 0 ? void 0 : opts.sampleSize) || 0;
       if (sampleSize > 0) {
-        fd = fs4.openSync(filepath, "r");
+        fd = fs5.openSync(filepath, "r");
         let sample = Buffer.allocUnsafe(sampleSize);
-        fs4.read(fd, sample, 0, sampleSize, opts.offset, (err, bytesRead) => {
+        fs5.read(fd, sample, 0, sampleSize, opts.offset, (err, bytesRead) => {
           if (err) {
             handler(err, null);
           } else {
@@ -25919,22 +25919,22 @@ var require_lib = __commonJS({
         });
         return;
       }
-      fs4.readFile(filepath, handler);
+      fs5.readFile(filepath, handler);
     });
     exports2.detectFile = detectFile;
     var detectFileSync = (filepath, opts = {}) => {
-      const fs4 = (0, node_1.default)();
+      const fs5 = (0, node_1.default)();
       if (opts && opts.sampleSize) {
-        const fd = fs4.openSync(filepath, "r");
+        const fd = fs5.openSync(filepath, "r");
         let sample = Buffer.allocUnsafe(opts.sampleSize);
-        const bytesRead = fs4.readSync(fd, sample, 0, opts.sampleSize, opts.offset);
+        const bytesRead = fs5.readSync(fd, sample, 0, opts.sampleSize, opts.offset);
         if (bytesRead < opts.sampleSize) {
           sample = sample.subarray(0, bytesRead);
         }
-        fs4.closeSync(fd);
+        fs5.closeSync(fd);
         return (0, exports2.detect)(sample);
       }
-      return (0, exports2.detect)(fs4.readFileSync(filepath));
+      return (0, exports2.detect)(fs5.readFileSync(filepath));
     };
     exports2.detectFileSync = detectFileSync;
     exports2.default = {
@@ -32520,9 +32520,9 @@ var fetchAsyncQuestionProperty = function(question, prop, answers) {
 
 // node_modules/inquirer/lib/ui/prompt.js
 var _ = {
-  set: (obj, path5 = "", value) => {
+  set: (obj, path6 = "", value) => {
     let pointer = obj;
-    path5.split(".").forEach((key, index, arr) => {
+    path6.split(".").forEach((key, index, arr) => {
       if (key === "__proto__" || key === "constructor") return;
       if (index === arr.length - 1) {
         pointer[key] = value;
@@ -32532,8 +32532,8 @@ var _ = {
       pointer = pointer[key];
     });
   },
-  get: (obj, path5 = "", defaultValue) => {
-    const travel = (regexp) => String.prototype.split.call(path5, regexp).filter(Boolean).reduce(
+  get: (obj, path6 = "", defaultValue) => {
+    const travel = (regexp) => String.prototype.split.call(path6, regexp).filter(Boolean).reduce(
       // @ts-expect-error implicit any on res[key]
       (res, key) => res !== null && res !== void 0 ? res[key] : res,
       obj
@@ -33637,7 +33637,11 @@ function loadConfig(cwd = process.cwd()) {
   const p = findConfigPath(cwd);
   if (!p) return null;
   try {
-    return JSON.parse(import_fs2.default.readFileSync(p, "utf-8"));
+    const raw = JSON.parse(import_fs2.default.readFileSync(p, "utf-8"));
+    if (raw.services && raw.services.functions === void 0) {
+      raw.services.functions = false;
+    }
+    return raw;
   } catch {
     return null;
   }
@@ -33720,6 +33724,9 @@ function base(cfg) {
 function adminHeaders(cfg) {
   return { "Content-Type": "application/json", "x-admin-secret": cfg.adminSecret };
 }
+function cfxHeaders(cfg) {
+  return { "Content-Type": "application/json", "x-cfx-key": cfg.apiKey };
+}
 async function listSites(cfg) {
   return apiFetch(
     `${base(cfg)}/api/hosting/databases/${cfg.projectId}/sites`,
@@ -33729,11 +33736,7 @@ async function listSites(cfg) {
 async function createSite(cfg, name, description) {
   return apiFetch(
     `${base(cfg)}/api/hosting/databases/${cfg.projectId}/sites`,
-    {
-      method: "POST",
-      headers: adminHeaders(cfg),
-      body: JSON.stringify({ name, description })
-    }
+    { method: "POST", headers: adminHeaders(cfg), body: JSON.stringify({ name, description }) }
   );
 }
 async function getDnsStatus(cfg, siteId) {
@@ -33825,6 +33828,36 @@ async function getActiveDeploy(cfg, siteId) {
     throw err;
   }
 }
+async function apiFnList(cfg) {
+  return apiFetch(
+    `${base(cfg)}/functions/`,
+    { headers: cfxHeaders(cfg) }
+  );
+}
+async function apiFnDeploy(cfg, options) {
+  return apiFetch(
+    `${base(cfg)}/functions/deploy`,
+    { method: "POST", headers: cfxHeaders(cfg), body: JSON.stringify(options) }
+  );
+}
+async function apiFnDelete(cfg, name) {
+  return apiFetch(
+    `${base(cfg)}/functions/${encodeURIComponent(name)}`,
+    { method: "DELETE", headers: cfxHeaders(cfg) }
+  );
+}
+async function apiFnCall(cfg, name, data) {
+  return apiFetch(
+    `${base(cfg)}/functions/call/${encodeURIComponent(name)}`,
+    { method: "POST", headers: cfxHeaders(cfg), body: JSON.stringify({ data: data ?? null }) }
+  );
+}
+async function apiFnExecutions(cfg, name, limit = 30) {
+  return apiFetch(
+    `${base(cfg)}/functions/${encodeURIComponent(name)}/executions?limit=${Math.min(limit, 100)}`,
+    { headers: cfxHeaders(cfg) }
+  );
+}
 async function testConnection(cfg) {
   try {
     const fetchFn = await getFetch();
@@ -33882,7 +33915,7 @@ async function runInit(cwd = process.cwd()) {
     projectId: projectId.trim(),
     apiKey: apiKey.trim(),
     adminSecret: adminSecret.trim(),
-    services: { database: false, auth: false, storage: false, hosting: false }
+    services: { database: false, auth: false, storage: false, hosting: false, functions: false }
   };
   const connSpinner = ora2("Testing connection\u2026").start();
   const ok = await testConnection(cfg);
@@ -33897,17 +33930,19 @@ async function runInit(cwd = process.cwd()) {
     name: "services",
     message: "Which services will you use?",
     choices: [
-      { name: "Database  \u2014 store and query documents", value: "database", checked: true },
-      { name: "Auth      \u2014 user sign-up / sign-in", value: "auth", checked: true },
-      { name: "Storage   \u2014 file uploads", value: "storage", checked: false },
-      { name: "Hosting   \u2014 deploy static sites", value: "hosting", checked: false }
+      { name: "Database   \u2014 store and query documents", value: "database", checked: true },
+      { name: "Auth       \u2014 user sign-up / sign-in", value: "auth", checked: true },
+      { name: "Storage    \u2014 file uploads", value: "storage", checked: false },
+      { name: "Hosting    \u2014 deploy static sites", value: "hosting", checked: false },
+      { name: "Functions  \u2014 serverless JS/TS & Python functions", value: "functions", checked: false }
     ]
   }]);
   cfg.services = {
     database: services.includes("database"),
     auth: services.includes("auth"),
     storage: services.includes("storage"),
-    hosting: services.includes("hosting")
+    hosting: services.includes("hosting"),
+    functions: services.includes("functions")
   };
   if (cfg.services.hosting) {
     await setupHosting(cfg, cwd);
@@ -33936,7 +33971,6 @@ function scaffoldLib(cfg, cwd = process.cwd()) {
     serverUrl: cfg.serverUrl,
     projectId: cfg.projectId,
     apiKey: cfg.apiKey,
-    // adminSecret intentionally omitted — not needed in client code
     services: cfg.services,
     ...cfg.hosting ? { hosting: cfg.hosting } : {}
   };
@@ -33950,22 +33984,31 @@ function scaffoldLib(cfg, cwd = process.cwd()) {
   };
 }
 function buildLibTs(cfg) {
-  const { database, auth, storage } = cfg.services;
+  const { database, auth, storage, functions: fns } = cfg.services;
   const sdkImports = ["initClefbase"];
   if (database) sdkImports.push("getDatabase");
   if (auth) sdkImports.push("getAuth");
   if (storage) sdkImports.push("getStorage");
+  if (fns) sdkImports.push("getFunctions", "httpsCallable");
   const typeImports = [];
   if (database) typeImports.push("Database");
   if (auth) typeImports.push("Auth");
   if (storage) typeImports.push("ClefbaseStorage");
+  if (fns) typeImports.push("ClefbaseFunctions");
   const lines = [
     `/**`,
     ` * Clefbase \u2014 pre-initialised service exports`,
     ` *`,
     ` * Usage:`,
-    ` *   import { db, auth, storage } from "@lib/clefBase";`,
-    ` *   import db from "@lib/clefBase";`,
+    ...database ? [` *   import { db } from "@lib/clefBase";`] : [],
+    ...auth ? [` *   import { auth } from "@lib/clefBase";`] : [],
+    ...storage ? [` *   import { storage } from "@lib/clefBase";`] : [],
+    ...fns ? [
+      ` *   import { fns, httpsCallable } from "@lib/clefBase";`,
+      ` *`,
+      ` *   const greet = httpsCallable<{ name: string }, { message: string }>(fns, "greetUser");`,
+      ` *   const { data } = await greet({ name: "Alice" });`
+    ] : [],
     ` */`,
     ``,
     `import { ${sdkImports.join(", ")} } from "clefbase";`,
@@ -33982,7 +34025,8 @@ function buildLibTs(cfg) {
     `});`,
     ``
   ];
-  if (database || auth || storage) {
+  const hasServices = database || auth || storage || fns;
+  if (hasServices) {
     lines.push("// \u2500\u2500\u2500 Services \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
     lines.push("");
   }
@@ -34001,6 +34045,20 @@ function buildLibTs(cfg) {
     lines.push(`export const storage: ClefbaseStorage = getStorage(app);`);
     lines.push("");
   }
+  if (fns) {
+    lines.push(`/** Clefbase Functions \u2014 deploy and call serverless functions. */`);
+    lines.push(`export const fns: ClefbaseFunctions = getFunctions(app);`);
+    lines.push("");
+    lines.push(`/**`);
+    lines.push(` * Create a typed callable reference to an HTTP-triggered function.`);
+    lines.push(` *`);
+    lines.push(` * @example`);
+    lines.push(` * const greet = httpsCallable<{ name: string }, { message: string }>(fns, "greetUser");`);
+    lines.push(` * const { data } = await greet({ name: "Alice" });`);
+    lines.push(` */`);
+    lines.push(`export { httpsCallable };`);
+    lines.push("");
+  }
   lines.push(
     `// \u2500\u2500\u2500 Advanced \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`,
     ``,
@@ -34008,7 +34066,6 @@ function buildLibTs(cfg) {
     `export { app };`,
     ``
   );
-  lines.push("");
   return lines.join("\n");
 }
 async function setupHosting(cfg, cwd) {
@@ -34095,12 +34152,11 @@ function printUsageHint(cfg) {
   if (cfg.services.database) namedImports.push("db");
   if (cfg.services.auth) namedImports.push("auth");
   if (cfg.services.storage) namedImports.push("storage");
+  if (cfg.services.functions) namedImports.push("fns", "httpsCallable");
   console.log(source_default.bold("  Quick start:"));
   console.log();
   if (namedImports.length > 0) {
-    console.log(
-      source_default.cyan(`  import { ${namedImports.join(", ")} } from "@lib/clefBase";`)
-    );
+    console.log(source_default.cyan(`  import { ${namedImports.join(", ")} } from "@lib/clefBase";`));
   } else {
     console.log(source_default.cyan(`  import app from "@lib/clefBase";`));
   }
@@ -34116,6 +34172,16 @@ function printUsageHint(cfg) {
     console.log();
     console.log(source_default.cyan(`  await storage.ref("uploads/photo.jpg").upload(file);`));
   }
+  if (cfg.services.functions) {
+    console.log();
+    console.log(source_default.bold("  Functions:"));
+    console.log(source_default.cyan(`  // Deploy from a file`));
+    console.log(source_default.cyan(`  $ clefbase functions:deploy -f ./src/functions/hello.ts`));
+    console.log();
+    console.log(source_default.cyan(`  // Call from your app`));
+    console.log(source_default.cyan(`  const greet = httpsCallable(fns, "greetUser");`));
+    console.log(source_default.cyan(`  const { data } = await greet({ name: "Alice" });`));
+  }
   if (cfg.services.hosting && cfg.hosting) {
     console.log();
     console.log(source_default.bold("  Deploy:"));
@@ -34522,12 +34588,301 @@ async function runSitesList(cwd = process.cwd()) {
   }
 }
 
+// src/cli/commands/functions.ts
+var import_fs5 = __toESM(require("fs"));
+var import_path4 = __toESM(require("path"));
+function fmtDuration(ms) {
+  return ms < 1e3 ? `${ms}ms` : `${(ms / 1e3).toFixed(2)}s`;
+}
+function fmtDate(iso) {
+  return new Date(iso).toLocaleString(void 0, {
+    month: "short",
+    day: "numeric",
+    year: "numeric",
+    hour: "2-digit",
+    minute: "2-digit"
+  });
+}
+function triggerLabel(fn) {
+  const t = fn.trigger;
+  if (t.type === "schedule") return `schedule  ${source_default.dim(t.cron ?? "")}`;
+  if (t.collection) return `${t.type}  ${source_default.dim(t.collection)}`;
+  if (t.bucket) return `${t.type}  ${source_default.dim(t.bucket)}`;
+  return t.type;
+}
+function statusColor(status) {
+  if (status === "active" || status === "success") return source_default.green(status);
+  if (status === "error" || status === "timeout") return source_default.red(status);
+  if (status === "disabled") return source_default.dim(status);
+  return status;
+}
+async function runFunctionsList(cwd = process.cwd()) {
+  const cfg = requireConfig(cwd);
+  const sp = ora2("Fetching functions\u2026").start();
+  let fns;
+  try {
+    fns = await apiFnList(cfg);
+    sp.succeed(`${fns.length} function${fns.length !== 1 ? "s" : ""}`);
+  } catch (err) {
+    sp.fail(err.message);
+    return;
+  }
+  if (fns.length === 0) {
+    console.log(source_default.dim("\n  No functions deployed yet. Run `clefbase functions:deploy` to get started.\n"));
+    return;
+  }
+  console.log();
+  for (const fn of fns) {
+    const err = fn.errorCount > 0 ? source_default.red(`  ${fn.errorCount} err`) : "";
+    console.log(
+      `  ${source_default.bold(fn.name.padEnd(28))}${RUNTIME_BADGE[fn.runtime] ?? fn.runtime}  ${statusColor(fn.status).padEnd(14)}  ${triggerLabel(fn)}`
+    );
+    console.log(
+      `  ${source_default.dim("".padEnd(28))}invocations: ${fn.invocationCount}${err}  last: ${fn.lastInvokedAt ? fmtDate(fn.lastInvokedAt) : "\u2014"}`
+    );
+    console.log();
+  }
+}
+var RUNTIME_BADGE = {
+  node: source_default.green("[JS/TS]"),
+  python: source_default.blue("[PY]   ")
+};
+async function runFunctionsDeploy(opts) {
+  const cwd = opts.cwd ?? process.cwd();
+  const cfg = requireConfig(cwd);
+  console.log();
+  console.log(source_default.bold.cyan("  Deploy Function"));
+  console.log();
+  const name = opts.name ?? await promptRequired("Function name");
+  let source;
+  if (opts.file) {
+    const absFile = import_path4.default.isAbsolute(opts.file) ? opts.file : import_path4.default.join(cwd, opts.file);
+    if (!import_fs5.default.existsSync(absFile)) {
+      console.error(source_default.red(`
+  File not found: ${absFile}
+`));
+      process.exit(1);
+    }
+    source = import_fs5.default.readFileSync(absFile, "utf-8");
+  } else {
+    const { inputMode } = await lib_default.prompt([{
+      type: "list",
+      name: "inputMode",
+      message: "Source code",
+      choices: [
+        { name: "From a file  (recommended)", value: "file" },
+        { name: "Inline snippet (paste in terminal)", value: "inline" }
+      ]
+    }]);
+    if (inputMode === "file") {
+      const { filePath } = await lib_default.prompt([{
+        type: "input",
+        name: "filePath",
+        message: "Path to source file (.js, .ts, .py)",
+        validate: (v) => {
+          if (!v.trim()) return "Required";
+          const abs2 = import_path4.default.isAbsolute(v) ? v : import_path4.default.join(cwd, v);
+          return import_fs5.default.existsSync(abs2) || `File not found: ${abs2}`;
+        }
+      }]);
+      const abs = import_path4.default.isAbsolute(filePath) ? filePath : import_path4.default.join(cwd, filePath.trim());
+      source = import_fs5.default.readFileSync(abs, "utf-8");
+    } else {
+      const { snippet } = await lib_default.prompt([{
+        type: "editor",
+        name: "snippet",
+        message: "Paste your function source (opens $EDITOR)"
+      }]);
+      source = snippet;
+    }
+  }
+  let runtime = opts.runtime;
+  if (!runtime) {
+    if (opts.file) {
+      const ext = import_path4.default.extname(opts.file).toLowerCase();
+      if (ext === ".py") runtime = "python";
+      else runtime = "node";
+    } else {
+      const { rt } = await lib_default.prompt([{
+        type: "list",
+        name: "rt",
+        message: "Runtime",
+        choices: [
+          { name: "Node.js / TypeScript  (JS/TS)", value: "node" },
+          { name: "Python 3               (PY)", value: "python" }
+        ]
+      }]);
+      runtime = rt;
+    }
+  }
+  let triggerType = opts.trigger;
+  if (!triggerType) {
+    const { tt } = await lib_default.prompt([{
+      type: "list",
+      name: "tt",
+      message: "Trigger type",
+      choices: [
+        { name: "HTTP           (POST /functions/call/:name)", value: "http" },
+        { name: "Schedule       (cron timer)", value: "schedule" },
+        { name: "onDocumentCreate", value: "onDocumentCreate" },
+        { name: "onDocumentUpdate", value: "onDocumentUpdate" },
+        { name: "onDocumentDelete", value: "onDocumentDelete" },
+        { name: "onDocumentWrite  (create + update + delete)", value: "onDocumentWrite" },
+        { name: "onUserCreate", value: "onUserCreate" },
+        { name: "onUserDelete", value: "onUserDelete" },
+        { name: "onFileUpload", value: "onFileUpload" },
+        { name: "onFileDelete", value: "onFileDelete" }
+      ]
+    }]);
+    triggerType = tt;
+  }
+  const trigger = { type: triggerType };
+  if (triggerType === "schedule") {
+    trigger.cron = opts.cron ?? await promptRequired("Cron expression (e.g. 0 * * * *)");
+  }
+  if (["onDocumentWrite", "onDocumentCreate", "onDocumentUpdate", "onDocumentDelete"].includes(triggerType)) {
+    trigger.collection = opts.collection ?? await promptRequired("Collection path (e.g. users)");
+  }
+  if (["onFileUpload", "onFileDelete"].includes(triggerType)) {
+    const { bucket } = await lib_default.prompt([{
+      type: "input",
+      name: "bucket",
+      message: "Bucket name filter  (leave blank = all buckets)"
+    }]);
+    if (bucket.trim()) trigger.bucket = bucket.trim();
+  }
+  const entryPoint = opts.entry ?? "handler";
+  const timeoutMs = opts.timeout ? parseInt(opts.timeout, 10) : 3e4;
+  const env2 = {};
+  for (const pair of opts.env ?? []) {
+    const idx = pair.indexOf("=");
+    if (idx > 0) env2[pair.slice(0, idx)] = pair.slice(idx + 1);
+  }
+  const payload = { name, runtime, trigger, source, entryPoint, timeoutMs, env: env2 };
+  const sp = ora2(`Deploying "${name}"\u2026`).start();
+  try {
+    const result = await apiFnDeploy(cfg, payload);
+    sp.succeed(source_default.green(`Deployed "${result.name}"  \u2192  ${statusColor(result.status)}`));
+    console.log();
+    console.log(`  ${source_default.bold("Name:")}     ${result.name}`);
+    console.log(`  ${source_default.bold("Runtime:")}  ${runtime}`);
+    console.log(`  ${source_default.bold("Trigger:")}  ${triggerLabel({ trigger })}`);
+    if (trigger.type === "http") {
+      console.log(`  ${source_default.bold("Call:")}     POST ${cfg.serverUrl.replace(/\/+$/, "")}/functions/call/${name}`);
+    }
+    console.log();
+  } catch (err) {
+    sp.fail(err.message);
+    process.exit(1);
+  }
+}
+async function runFunctionsCall(name, opts) {
+  const cwd = opts.cwd ?? process.cwd();
+  const cfg = requireConfig(cwd);
+  let data = null;
+  if (opts.data) {
+    try {
+      data = JSON.parse(opts.data);
+    } catch {
+      console.error(source_default.red(`
+  --data must be valid JSON. Got: ${opts.data}
+`));
+      process.exit(1);
+    }
+  }
+  const sp = ora2(`Calling "${name}"\u2026`).start();
+  try {
+    const result = await apiFnCall(cfg, name, data);
+    sp.succeed(`${source_default.green("\u2713")} ${name}  ${source_default.dim(fmtDuration(result.durationMs))}`);
+    console.log();
+    console.log(JSON.stringify(result.data, null, 2));
+    console.log();
+  } catch (err) {
+    sp.fail(err.message);
+    process.exit(1);
+  }
+}
+async function runFunctionsDelete(name, opts) {
+  const cwd = opts.cwd ?? process.cwd();
+  const cfg = requireConfig(cwd);
+  if (!opts.force) {
+    const { confirmed } = await lib_default.prompt([{
+      type: "confirm",
+      name: "confirmed",
+      message: `Delete function "${name}"? This cannot be undone.`,
+      default: false
+    }]);
+    if (!confirmed) {
+      console.log(source_default.dim("\n  Cancelled.\n"));
+      return;
+    }
+  }
+  const sp = ora2(`Deleting "${name}"\u2026`).start();
+  try {
+    await apiFnDelete(cfg, name);
+    sp.succeed(source_default.green(`"${name}" deleted`));
+    console.log();
+  } catch (err) {
+    sp.fail(err.message);
+    process.exit(1);
+  }
+}
+async function runFunctionsLogs(name, opts) {
+  const cwd = opts.cwd ?? process.cwd();
+  const cfg = requireConfig(cwd);
+  const limit = opts.limit ? parseInt(opts.limit, 10) : 20;
+  const sp = ora2(`Fetching logs for "${name}"\u2026`).start();
+  let execs;
+  try {
+    execs = await apiFnExecutions(cfg, name, limit);
+    sp.succeed(`${execs.length} execution${execs.length !== 1 ? "s" : ""}`);
+  } catch (err) {
+    sp.fail(err.message);
+    return;
+  }
+  if (execs.length === 0) {
+    console.log(source_default.dim(`
+  No executions recorded yet for "${name}".
+`));
+    return;
+  }
+  console.log();
+  for (const ex of execs) {
+    const statusStr = statusColor(ex.status);
+    console.log(
+      `  ${statusStr.padEnd(16)}${source_default.dim(fmtDate(ex.startedAt))}  ${source_default.dim(fmtDuration(ex.durationMs))}  ${source_default.dim("via")} ${ex.triggeredBy}`
+    );
+    if (ex.error) {
+      console.log(source_default.red(`    \u2717 ${ex.error.split("\n")[0]}`));
+    }
+    if (ex.logs.length > 0) {
+      for (const line of ex.logs) {
+        console.log(source_default.dim(`    \u25B6 ${line}`));
+      }
+    }
+    if (ex.result !== void 0 && ex.result !== null) {
+      const preview = JSON.stringify(ex.result);
+      console.log(source_default.dim(`    \u2190 ${preview.length > 120 ? preview.slice(0, 120) + "\u2026" : preview}`));
+    }
+    console.log();
+  }
+}
+async function promptRequired(message) {
+  const { value } = await lib_default.prompt([{
+    type: "input",
+    name: "value",
+    message,
+    validate: (v) => v.trim().length > 0 || "Required"
+  }]);
+  return value.trim();
+}
+
 // package.json
-var version = "1.4.1";
+var version = "1.5.1";
 
 // src/cli/index.ts
 var program2 = new Command();
-program2.name("clefbase").description("Clefbase CLI \u2014 initialise projects, deploy sites, manage hosting").version(version);
+program2.name("clefbase").description("Clefbase CLI \u2014 initialise projects, deploy sites, manage functions").version(version);
 program2.command("init").description("Initialise a Clefbase project in the current directory").action(async () => {
   try {
     await runInit();
@@ -34577,6 +34932,41 @@ program2.command("hosting:dns:reprovision").alias("dns:reprovision").description
     fatal(err);
   }
 });
+program2.command("functions:list").alias("fn:list").description("List all deployed functions for this project").action(async () => {
+  try {
+    await runFunctionsList();
+  } catch (err) {
+    fatal(err);
+  }
+});
+program2.command("functions:deploy").alias("fn:deploy").description("Deploy (or redeploy) a function from a source file or interactively").option("-n, --name <name>", "Function name").option("-f, --file <path>", "Path to source file (.js, .ts, .py)").option("-r, --runtime <runtime>", "Runtime: node | python  (auto-detected from file ext)").option("-t, --trigger <type>", "Trigger type (http, schedule, onDocumentCreate, \u2026)").option("-c, --cron <expr>", "Cron expression for schedule triggers").option("-C, --collection <path>", "Collection path for document triggers").option("-T, --timeout <ms>", "Execution timeout in milliseconds (default: 30000)").option("-e, --entry <name>", "Exported function name to call (default: handler)").option("--env <KEY=VALUE...>", "Environment variable(s) \u2014 repeatable").action(async (opts) => {
+  try {
+    await runFunctionsDeploy(opts);
+  } catch (err) {
+    fatal(err);
+  }
+});
+program2.command("functions:call <name>").alias("fn:call").description("Call an HTTP-triggered function and print its return value").option("-d, --data <json>", "JSON payload to pass as ctx.data").action(async (name, opts) => {
+  try {
+    await runFunctionsCall(name, opts);
+  } catch (err) {
+    fatal(err);
+  }
+});
+program2.command("functions:delete <name>").alias("fn:delete").description("Delete a deployed function").option("-y, --force", "Skip confirmation prompt").action(async (name, opts) => {
+  try {
+    await runFunctionsDelete(name, opts);
+  } catch (err) {
+    fatal(err);
+  }
+});
+program2.command("functions:logs <name>").alias("fn:logs").description("Show recent execution history for a function").option("-l, --limit <n>", "Number of executions to show (default: 20, max: 100)").action(async (name, opts) => {
+  try {
+    await runFunctionsLogs(name, opts);
+  } catch (err) {
+    fatal(err);
+  }
+});
 program2.command("info").description("Show project config and server connectivity").action(async () => {
   try {
     await runInfo();
@@ -34586,16 +34976,29 @@ program2.command("info").description("Show project config and server connectivit
 });
 program2.addHelpText("after", `
 ${source_default.bold("Examples:")}
-  ${source_default.cyan("clefbase init")}                          Set up a new project
-  ${source_default.cyan("clefbase deploy")}                        Deploy your built site
-  ${source_default.cyan("clefbase deploy -d ./dist")}              Deploy from a specific directory
-  ${source_default.cyan('clefbase deploy -m "v2 release"')}       Deploy with a release note
-  ${source_default.cyan("clefbase hosting:init")}                   Link or create a hosted site
-  ${source_default.cyan("clefbase hosting:status")}                 Show current live deploy
-  ${source_default.cyan("clefbase hosting:sites")}                  List all sites
-  ${source_default.cyan("clefbase hosting:dns")}                    Show DNS status
-  ${source_default.cyan("clefbase hosting:dns:reprovision")}        Fix / create the preview CNAME
-  ${source_default.cyan("clefbase info")}                          Show config & connection status
+  ${source_default.bold("Project:")}
+  ${source_default.cyan("clefbase init")}                              Set up a new project
+  ${source_default.cyan("clefbase info")}                              Show config & connection status
+
+  ${source_default.bold("Hosting:")}
+  ${source_default.cyan("clefbase deploy")}                            Deploy your built site
+  ${source_default.cyan('clefbase deploy -d ./dist -m "v2"')}         Deploy from a dir with a note
+  ${source_default.cyan("clefbase hosting:init")}                      Link or create a hosted site
+  ${source_default.cyan("clefbase hosting:status")}                    Show current live deploy
+  ${source_default.cyan("clefbase hosting:sites")}                     List all sites
+  ${source_default.cyan("clefbase hosting:dns")}                       Show DNS status
+  ${source_default.cyan("clefbase hosting:dns:reprovision")}           Fix / create the preview CNAME
+
+  ${source_default.bold("Functions:")}
+  ${source_default.cyan("clefbase functions:list")}                    List all deployed functions
+  ${source_default.cyan("clefbase functions:deploy")}                  Interactive deploy wizard
+  ${source_default.cyan("clefbase functions:deploy -f ./fn.ts")}       Deploy from a file (auto-detects runtime)
+  ${source_default.cyan("clefbase functions:deploy -n greet -f fn.ts --trigger http")}
+  ${source_default.cyan("clefbase functions:call greetUser")}          Call an HTTP function
+  ${source_default.cyan(`clefbase functions:call greetUser -d '{"name":"Alice"}'}`)}
+  ${source_default.cyan("clefbase functions:logs greetUser")}          View execution history
+  ${source_default.cyan("clefbase functions:logs greetUser -l 50")}    View last 50 executions
+  ${source_default.cyan("clefbase functions:delete oldFunction")}      Delete a function
 `);
 program2.parse(process.argv);
 function fatal(err) {