clefbase 1.4.1 → 1.5.0

package/dist/app.d.ts

@@ -3,6 +3,7 @@ import { Database } from "./db";
 import { Auth } from "./auth";
 import { ClefbaseStorage } from "./storage";
 import { ClefbaseHosting } from "./hosting";
+import { ClefbaseFunctions } from "./functions";
 import type { ClefbaseConfig } from "./types";
 /**
  * A Clefbase application instance.
@@ -14,10 +15,12 @@ export declare class ClefbaseApp {
     /** @internal */ readonly _authHttp: HttpClient;
     /** @internal */ readonly _storageHttp: HttpClient;
     /** @internal */ readonly _hostingHttp: HttpClient;
+    /** @internal */ readonly _functionsHttp: HttpClient;
     private _db;
     private _auth;
     private _storage;
     private _hosting;
+    private _functions;
     constructor(config: ClefbaseConfig);
     /** @internal */
     _getDb(): Database;
@@ -27,6 +30,8 @@ export declare class ClefbaseApp {
     _getStorage(): ClefbaseStorage;
     /** @internal */
     _getHosting(): ClefbaseHosting;
+    /** @internal */
+    _getFunctions(): ClefbaseFunctions;
 }
 /**
  * Initialise a Clefbase app. Call once at startup.
@@ -37,7 +42,7 @@ export declare class ClefbaseApp {
  *   serverUrl:   "https://api.cleforyx.com",
  *   projectId:   "my_project_abc",
  *   apiKey:      "cfx_...",
- *   adminSecret: "secret",  // only needed for hosting
+ *   adminSecret: "",  // only needed for hosting
  * });
  */
 export declare function initClefbase(config: ClefbaseConfig, name?: string): ClefbaseApp;
@@ -51,4 +56,17 @@ export declare function getAuth(app?: ClefbaseApp): Auth;
 export declare function getStorage(app?: ClefbaseApp): ClefbaseStorage;
 /** Get the Hosting service. Requires `adminSecret` in config. */
 export declare function getHosting(app?: ClefbaseApp): ClefbaseHosting;
+/**
+ * Get the Functions service.
+ *
+ * @example
+ * import { initClefbase, getFunctions, httpsCallable } from "clefbase";
+ *
+ * const app = initClefbase({ serverUrl, projectId, apiKey, adminSecret: "" });
+ * const fns = getFunctions(app);
+ *
+ * const greet = httpsCallable<{ name: string }, { message: string }>(fns, "greetUser");
+ * const { data } = await greet({ name: "Alice" });
+ */
+export declare function getFunctions(app?: ClefbaseApp): ClefbaseFunctions;
 //# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C;;;GAGG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAEhC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,EAAO,UAAU,CAAC;IACnD,gBAAgB,CAAC,QAAQ,CAAC,SAAS,EAAK,UAAU,CAAC;IACnD,gBAAgB,CAAC,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC;IACnD,gBAAgB,CAAC,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC;IAEnD,OAAO,CAAC,GAAG,CAAoC;IAC/C,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,QAAQ,CAA+B;gBAEnC,MAAM,EAAE,cAAc;IAYlC,gBAAgB;IAChB,MAAM,IAAI,QAAQ;IAKlB,gBAAgB;IAChB,QAAQ,IAAI,IAAI;IAKhB,gBAAgB;IAChB,WAAW,IAAI,eAAe;IAU9B,gBAAgB;IAChB,WAAW,IAAI,eAAe;CAS/B;AAOD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,cAAc,EACtB,IAAI,GAAE,MAAgB,GACrB,WAAW,CAKb;AAED,wEAAwE;AACxE,wBAAgB,MAAM,CAAC,IAAI,GAAE,MAAgB,GAAG,WAAW,CAQ1D;AAID,gCAAgC;AAChC,wBAAgB,WAAW,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,QAAQ,CAEvD;AAED,4BAA4B;AAC5B,wBAAgB,OAAO,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,CAE/C;AAED,+BAA+B;AAC/B,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,eAAe,CAE7D;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,eAAe,CAE7D"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C;;;GAGG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAEhC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,EAAS,UAAU,CAAC;IACrD,gBAAgB,CAAC,QAAQ,CAAC,SAAS,EAAO,UAAU,CAAC;IACrD,gBAAgB,CAAC,QAAQ,CAAC,YAAY,EAAI,UAAU,CAAC;IACrD,gBAAgB,CAAC,QAAQ,CAAC,YAAY,EAAI,UAAU,CAAC;IACrD,gBAAgB,CAAC,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC;IAErD,OAAO,CAAC,GAAG,CAAuC;IAClD,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,UAAU,CAAgC;gBAEtC,MAAM,EAAE,cAAc;IAalC,gBAAgB;IAChB,MAAM,IAAI,QAAQ;IAKlB,gBAAgB;IAChB,QAAQ,IAAI,IAAI;IAKhB,gBAAgB;IAChB,WAAW,IAAI,eAAe;IAU9B,gBAAgB;IAChB,WAAW,IAAI,eAAe;IAU9B,gBAAgB;IAChB,aAAa,IAAI,iBAAiB;CAKnC;AAOD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,cAAc,EACtB,IAAI,GAAE,MAAgB,GACrB,WAAW,CAKb;AAED,wEAAwE;AACxE,wBAAgB,MAAM,CAAC,IAAI,GAAE,MAAgB,GAAG,WAAW,CAQ1D;AAID,gCAAgC;AAChC,wBAAgB,WAAW,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,QAAQ,CAEvD;AAED,4BAA4B;AAC5B,wBAAgB,OAAO,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,CAE/C;AAED,+BAA+B;AAC/B,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,eAAe,CAE7D;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,eAAe,CAE7D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,iBAAiB,CAEjE"}

package/dist/app.js

@@ -7,11 +7,13 @@ exports.getDatabase = getDatabase;
 exports.getAuth = getAuth;
 exports.getStorage = getStorage;
 exports.getHosting = getHosting;
+exports.getFunctions = getFunctions;
 const http_1 = require("./http");
 const db_1 = require("./db");
 const auth_1 = require("./auth");
 const storage_1 = require("./storage");
 const hosting_1 = require("./hosting");
+const functions_1 = require("./functions");
 // ─── App ──────────────────────────────────────────────────────────────────────
 /**
  * A Clefbase application instance.
@@ -27,6 +29,7 @@ class ClefbaseApp {
         this._authHttp = new http_1.HttpClient(`${base}/auth`, cfxKey);
         this._storageHttp = new http_1.HttpClient(`${base}/storage`, cfxKey);
         this._hostingHttp = new http_1.HttpClient(`${base}/api/hosting`, admin);
+        this._functionsHttp = new http_1.HttpClient(`${base}/functions`, cfxKey);
     }
     /** @internal */
     _getDb() {
@@ -52,6 +55,12 @@ class ClefbaseApp {
             this._hosting = new hosting_1.ClefbaseHosting(this._hostingHttp, this.config.projectId, this.config.serverUrl);
         return this._hosting;
     }
+    /** @internal */
+    _getFunctions() {
+        if (!this._functions)
+            this._functions = new functions_1.ClefbaseFunctions(this._functionsHttp);
+        return this._functions;
+    }
 }
 exports.ClefbaseApp = ClefbaseApp;
 // ─── Registry ─────────────────────────────────────────────────────────────────
@@ -66,7 +75,7 @@ const registry = new Map();
  *   serverUrl:   "https://api.cleforyx.com",
  *   projectId:   "my_project_abc",
  *   apiKey:      "cfx_...",
- *   adminSecret: "secret",  // only needed for hosting
+ *   adminSecret: "",  // only needed for hosting
  * });
  */
 function initClefbase(config, name = DEFAULT) {
@@ -101,4 +110,19 @@ function getStorage(app) {
 function getHosting(app) {
     return (app ?? getApp())._getHosting();
 }
+/**
+ * Get the Functions service.
+ *
+ * @example
+ * import { initClefbase, getFunctions, httpsCallable } from "clefbase";
+ *
+ * const app = initClefbase({ serverUrl, projectId, apiKey, adminSecret: "" });
+ * const fns = getFunctions(app);
+ *
+ * const greet = httpsCallable<{ name: string }, { message: string }>(fns, "greetUser");
+ * const { data } = await greet({ name: "Alice" });
+ */
+function getFunctions(app) {
+    return (app ?? getApp())._getFunctions();
+}
 //# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"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"}

package/dist/cli-src/cli/api.js

@@ -48,6 +48,11 @@ exports.createDeploy = createDeploy;
 exports.uploadFileBatch = uploadFileBatch;
 exports.finalizeDeploy = finalizeDeploy;
 exports.getActiveDeploy = getActiveDeploy;
+exports.apiFnList = apiFnList;
+exports.apiFnDeploy = apiFnDeploy;
+exports.apiFnDelete = apiFnDelete;
+exports.apiFnCall = apiFnCall;
+exports.apiFnExecutions = apiFnExecutions;
 exports.testConnection = testConnection;
 // ─── Error ────────────────────────────────────────────────────────────────────
 class CliApiError extends Error {
@@ -88,23 +93,16 @@ 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 };
+}
 // ─── Hosting API ──────────────────────────────────────────────────────────────
 async function listSites(cfg) {
     return apiFetch(`${base(cfg)}/api/hosting/databases/${cfg.projectId}/sites`, { headers: adminHeaders(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 }),
-    });
+    return apiFetch(`${base(cfg)}/api/hosting/databases/${cfg.projectId}/sites`, { method: "POST", headers: adminHeaders(cfg), body: JSON.stringify({ name, description }) });
 }
-/**
- * Delete a site.
- *
- * First call (confirm=false): returns { requiresConfirmation: true, dnsRecord?, message }
- * Second call (confirm=true, deleteDns?): actually deletes
- */
 async function deleteSite(cfg, siteId, opts = {}) {
     const params = new URLSearchParams();
     if (opts.confirm)
@@ -192,6 +190,30 @@ async function getActiveDeploy(cfg, siteId) {
         throw err;
     }
 }
+// ─── Functions API ────────────────────────────────────────────────────────────
+//
+// All functions routes use the project API key (x-cfx-key), not adminSecret.
+// Base path: /functions
+/** List all deployed functions for the linked project */
+async function apiFnList(cfg) {
+    return apiFetch(`${base(cfg)}/functions/`, { headers: cfxHeaders(cfg) });
+}
+/** Deploy (or redeploy) a function from source code */
+async function apiFnDeploy(cfg, options) {
+    return apiFetch(`${base(cfg)}/functions/deploy`, { method: "POST", headers: cfxHeaders(cfg), body: JSON.stringify(options) });
+}
+/** Delete a function by name */
+async function apiFnDelete(cfg, name) {
+    return apiFetch(`${base(cfg)}/functions/${encodeURIComponent(name)}`, { method: "DELETE", headers: cfxHeaders(cfg) });
+}
+/** Call an HTTP function with a JSON payload. Returns the function's return value + durationMs */
+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 }) });
+}
+/** Fetch execution history for a function (or all functions in the project) */
+async function apiFnExecutions(cfg, name, limit = 30) {
+    return apiFetch(`${base(cfg)}/functions/${encodeURIComponent(name)}/executions?limit=${Math.min(limit, 100)}`, { headers: cfxHeaders(cfg) });
+}
 // ─── Connectivity ─────────────────────────────────────────────────────────────
 async function testConnection(cfg) {
     try {

package/dist/cli-src/cli/commands/functions.js

@@ -0,0 +1,331 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runFunctionsList = runFunctionsList;
+exports.runFunctionsDeploy = runFunctionsDeploy;
+exports.runFunctionsCall = runFunctionsCall;
+exports.runFunctionsDelete = runFunctionsDelete;
+exports.runFunctionsLogs = runFunctionsLogs;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const config_1 = require("../config");
+const api_1 = require("../api");
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function fmtDuration(ms) {
+    return ms < 1000 ? `${ms}ms` : `${(ms / 1000).toFixed(2)}s`;
+}
+function fmtDate(iso) {
+    return new Date(iso).toLocaleString(undefined, {
+        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  ${chalk_1.default.dim(t.cron ?? "")}`;
+    if (t.collection)
+        return `${t.type}  ${chalk_1.default.dim(t.collection)}`;
+    if (t.bucket)
+        return `${t.type}  ${chalk_1.default.dim(t.bucket)}`;
+    return t.type;
+}
+function statusColor(status) {
+    if (status === "active" || status === "success")
+        return chalk_1.default.green(status);
+    if (status === "error" || status === "timeout")
+        return chalk_1.default.red(status);
+    if (status === "disabled")
+        return chalk_1.default.dim(status);
+    return status;
+}
+// ─── functions:list ───────────────────────────────────────────────────────────
+async function runFunctionsList(cwd = process.cwd()) {
+    const cfg = (0, config_1.requireConfig)(cwd);
+    const sp = (0, ora_1.default)("Fetching functions…").start();
+    let fns;
+    try {
+        fns = await (0, api_1.apiFnList)(cfg);
+        sp.succeed(`${fns.length} function${fns.length !== 1 ? "s" : ""}`);
+    }
+    catch (err) {
+        sp.fail(err.message);
+        return;
+    }
+    if (fns.length === 0) {
+        console.log(chalk_1.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 ? chalk_1.default.red(`  ${fn.errorCount} err`) : "";
+        console.log(`  ${chalk_1.default.bold(fn.name.padEnd(28))}` +
+            `${RUNTIME_BADGE[fn.runtime] ?? fn.runtime}  ` +
+            `${statusColor(fn.status).padEnd(14)}  ` +
+            `${triggerLabel(fn)}`);
+        console.log(`  ${chalk_1.default.dim("".padEnd(28))}` +
+            `invocations: ${fn.invocationCount}${err}  ` +
+            `last: ${fn.lastInvokedAt ? fmtDate(fn.lastInvokedAt) : "—"}`);
+        console.log();
+    }
+}
+const RUNTIME_BADGE = {
+    node: chalk_1.default.green("[JS/TS]"),
+    python: chalk_1.default.blue("[PY]   "),
+};
+// ─── functions:deploy ─────────────────────────────────────────────────────────
+async function runFunctionsDeploy(opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const cfg = (0, config_1.requireConfig)(cwd);
+    console.log();
+    console.log(chalk_1.default.bold.cyan("  Deploy Function"));
+    console.log();
+    // ── Resolve function name ────────────────────────────────────────────────
+    const name = opts.name ?? await promptRequired("Function name");
+    // ── Resolve source ───────────────────────────────────────────────────────
+    let source;
+    if (opts.file) {
+        const absFile = path_1.default.isAbsolute(opts.file) ? opts.file : path_1.default.join(cwd, opts.file);
+        if (!fs_1.default.existsSync(absFile)) {
+            console.error(chalk_1.default.red(`\n  File not found: ${absFile}\n`));
+            process.exit(1);
+        }
+        source = fs_1.default.readFileSync(absFile, "utf-8");
+    }
+    else {
+        // Interactive: ask for a file path or inline snippet
+        const { inputMode } = await inquirer_1.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 inquirer_1.default.prompt([{
+                    type: "input",
+                    name: "filePath",
+                    message: "Path to source file (.js, .ts, .py)",
+                    validate: (v) => {
+                        if (!v.trim())
+                            return "Required";
+                        const abs = path_1.default.isAbsolute(v) ? v : path_1.default.join(cwd, v);
+                        return fs_1.default.existsSync(abs) || `File not found: ${abs}`;
+                    },
+                }]);
+            const abs = path_1.default.isAbsolute(filePath) ? filePath : path_1.default.join(cwd, filePath.trim());
+            source = fs_1.default.readFileSync(abs, "utf-8");
+        }
+        else {
+            const { snippet } = await inquirer_1.default.prompt([{
+                    type: "editor",
+                    name: "snippet",
+                    message: "Paste your function source (opens $EDITOR)",
+                }]);
+            source = snippet;
+        }
+    }
+    // ── Runtime ──────────────────────────────────────────────────────────────
+    let runtime = opts.runtime;
+    if (!runtime) {
+        // Auto-detect from file extension
+        if (opts.file) {
+            const ext = path_1.default.extname(opts.file).toLowerCase();
+            if (ext === ".py")
+                runtime = "python";
+            else
+                runtime = "node";
+        }
+        else {
+            const { rt } = await inquirer_1.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;
+        }
+    }
+    // ── Trigger ──────────────────────────────────────────────────────────────
+    let triggerType = opts.trigger;
+    if (!triggerType) {
+        const { tt } = await inquirer_1.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 inquirer_1.default.prompt([{
+                type: "input",
+                name: "bucket",
+                message: "Bucket name filter  (leave blank = all buckets)",
+            }]);
+        if (bucket.trim())
+            trigger.bucket = bucket.trim();
+    }
+    // ── Entry point & timeout ────────────────────────────────────────────────
+    const entryPoint = opts.entry ?? "handler";
+    const timeoutMs = opts.timeout ? parseInt(opts.timeout, 10) : 30000;
+    // ── Env vars ─────────────────────────────────────────────────────────────
+    const env = {};
+    for (const pair of (opts.env ?? [])) {
+        const idx = pair.indexOf("=");
+        if (idx > 0)
+            env[pair.slice(0, idx)] = pair.slice(idx + 1);
+    }
+    // ── Deploy ────────────────────────────────────────────────────────────────
+    const payload = { name, runtime, trigger, source, entryPoint, timeoutMs, env };
+    const sp = (0, ora_1.default)(`Deploying "${name}"…`).start();
+    try {
+        const result = await (0, api_1.apiFnDeploy)(cfg, payload);
+        sp.succeed(chalk_1.default.green(`Deployed "${result.name}"  →  ${statusColor(result.status)}`));
+        console.log();
+        console.log(`  ${chalk_1.default.bold("Name:")}     ${result.name}`);
+        console.log(`  ${chalk_1.default.bold("Runtime:")}  ${runtime}`);
+        console.log(`  ${chalk_1.default.bold("Trigger:")}  ${triggerLabel({ trigger })}`);
+        if (trigger.type === "http") {
+            console.log(`  ${chalk_1.default.bold("Call:")}     POST ${cfg.serverUrl.replace(/\/+$/, "")}/functions/call/${name}`);
+        }
+        console.log();
+    }
+    catch (err) {
+        sp.fail(err.message);
+        process.exit(1);
+    }
+}
+// ─── functions:call ───────────────────────────────────────────────────────────
+async function runFunctionsCall(name, opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const cfg = (0, config_1.requireConfig)(cwd);
+    let data = null;
+    if (opts.data) {
+        try {
+            data = JSON.parse(opts.data);
+        }
+        catch {
+            console.error(chalk_1.default.red(`\n  --data must be valid JSON. Got: ${opts.data}\n`));
+            process.exit(1);
+        }
+    }
+    const sp = (0, ora_1.default)(`Calling "${name}"…`).start();
+    try {
+        const result = await (0, api_1.apiFnCall)(cfg, name, data);
+        sp.succeed(`${chalk_1.default.green("✓")} ${name}  ${chalk_1.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);
+    }
+}
+// ─── functions:delete ─────────────────────────────────────────────────────────
+async function runFunctionsDelete(name, opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const cfg = (0, config_1.requireConfig)(cwd);
+    if (!opts.force) {
+        const { confirmed } = await inquirer_1.default.prompt([{
+                type: "confirm",
+                name: "confirmed",
+                message: `Delete function "${name}"? This cannot be undone.`,
+                default: false,
+            }]);
+        if (!confirmed) {
+            console.log(chalk_1.default.dim("\n  Cancelled.\n"));
+            return;
+        }
+    }
+    const sp = (0, ora_1.default)(`Deleting "${name}"…`).start();
+    try {
+        await (0, api_1.apiFnDelete)(cfg, name);
+        sp.succeed(chalk_1.default.green(`"${name}" deleted`));
+        console.log();
+    }
+    catch (err) {
+        sp.fail(err.message);
+        process.exit(1);
+    }
+}
+// ─── functions:logs ───────────────────────────────────────────────────────────
+async function runFunctionsLogs(name, opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const cfg = (0, config_1.requireConfig)(cwd);
+    const limit = opts.limit ? parseInt(opts.limit, 10) : 20;
+    const sp = (0, ora_1.default)(`Fetching logs for "${name}"…`).start();
+    let execs;
+    try {
+        execs = await (0, api_1.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(chalk_1.default.dim(`\n  No executions recorded yet for "${name}".\n`));
+        return;
+    }
+    console.log();
+    for (const ex of execs) {
+        const statusStr = statusColor(ex.status);
+        console.log(`  ${statusStr.padEnd(16)}` +
+            `${chalk_1.default.dim(fmtDate(ex.startedAt))}  ` +
+            `${chalk_1.default.dim(fmtDuration(ex.durationMs))}  ` +
+            `${chalk_1.default.dim("via")} ${ex.triggeredBy}`);
+        if (ex.error) {
+            console.log(chalk_1.default.red(`    ✗ ${ex.error.split("\n")[0]}`));
+        }
+        if (ex.logs.length > 0) {
+            for (const line of ex.logs) {
+                console.log(chalk_1.default.dim(`    ▶ ${line}`));
+            }
+        }
+        if (ex.result !== undefined && ex.result !== null) {
+            const preview = JSON.stringify(ex.result);
+            console.log(chalk_1.default.dim(`    ← ${preview.length > 120 ? preview.slice(0, 120) + "…" : preview}`));
+        }
+        console.log();
+    }
+}
+// ─── Prompt helper ────────────────────────────────────────────────────────────
+async function promptRequired(message) {
+    const { value } = await inquirer_1.default.prompt([{
+            type: "input",
+            name: "value",
+            message,
+            validate: (v) => v.trim().length > 0 || "Required",
+        }]);
+    return value.trim();
+}