@flowengine.cloud/flowengine-cli 3.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FlowEngine
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+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 THE
+AUTHORS OR COPYRIGHT HOLDERS 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,290 @@
+# FlowEngine MCP Server
+
+**Control your white-label automation platform directly from Claude**
+
+The official Model Context Protocol (MCP) server for FlowEngine. Manage instances, client portals, and build UI components using AI - all from Claude Desktop, VSCode, or Claude Code CLI.
+
+## What is FlowEngine?
+
+FlowEngine is a white-label n8n automation platform that lets you build and deploy workflow automations for your clients. This MCP server brings FlowEngine's core capabilities into Claude for seamless management.
+
+## Core Features
+
+### Instance Management
+Provision and manage FlowEngine instances for your clients:
+- List all instances with details
+- Monitor health and performance
+- Create new instances
+- Update configurations
+- Delete instances
+
+### Client Portals
+Access and monitor your client portals:
+- View all client portal URLs and access details
+- Monitor workflows and components per portal
+
+### AI FlowBuilder
+Create and manage UI components with AI:
+- Build forms, chatbots, and widgets
+- List all components across instances
+- Update component configurations
+- Delete components
+
+## Installation
+
+### Prerequisites
+- Node.js 18 or higher
+- FlowEngine account with API key ([Get one here](https://flowengine.cloud))
+- Claude Desktop, VSCode, or Claude Code CLI
+
+### Get Your API Key
+
+1. Log in to [FlowEngine](https://flowengine.cloud)
+2. Go to Settings → API Access
+3. Click "Generate API Key"
+4. Copy your key (shown only once)
+
+### Quick Setup
+
+#### Claude Desktop
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "flowengine": {
+      "command": "npx",
+      "args": ["-y", "flowengine-mcp-app"],
+      "env": {
+        "FLOWENGINE_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+#### Claude Code CLI
+
+Edit `~/.claude/claude_code_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "flowengine": {
+      "command": "npx",
+      "args": ["-y", "flowengine-mcp-app"],
+      "env": {
+        "FLOWENGINE_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+#### VSCode (Claude Extension)
+
+Add to your VSCode settings:
+
+```json
+{
+  "mcp.servers": {
+    "flowengine": {
+      "command": "npx",
+      "args": ["-y", "flowengine-mcp-app"],
+      "env": {
+        "FLOWENGINE_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+**Then restart** Claude Desktop, start a new Claude Code session, or reload VSCode.
+
+## Usage
+
+### 🎨 Interactive Dashboards (MCP Apps)
+
+**NEW!** Visual dashboards with interactive HTML interfaces. Ask Claude:
+
+| Command | What You Get |
+|---------|--------------|
+| **"Show me the FlowEngine client portals dashboard"** | Interactive dashboard with all your client portals, URLs, and storage details |
+| **"Show me the AI FlowBuilder"** | Visual dashboard for managing forms, chatbots, and widgets across all instances |
+| **"Show me my FlowEngine instances"** | Instance manager dashboard with resource details and quick actions |
+
+**How it works:**
+1. Ask Claude using the exact commands above
+2. Claude will display a rich HTML dashboard
+3. View all your data in a visual, organized format
+
+**Fallback:** If dashboards don't appear, use text-based tools:
+```
+"Use flowengine_list_portals to show my portals"
+"Use flowengine_list_instances"
+"Use flowengine_list_components"
+```
+
+### 💬 Natural Language Commands
+
+Manage your platform through conversation:
+
+```
+"List all my FlowEngine instances"
+"What's the status of instance abc123?"
+"Create a new contact form widget"
+"Show me all UI components"
+"Provision a new instance for Acme Corp"
+```
+
+## Available Tools
+
+### Instance Management (5 tools)
+- `flowengine_list_instances` - List all instances
+- `flowengine_get_instance_status` - Get instance health
+- `flowengine_create_instance` - Provision new instance
+- `flowengine_update_instance` - Update settings
+- `flowengine_delete_instance` - Delete instance
+
+### Client Portals (1 tool)
+- `flowengine_list_portals` - List all portals
+
+### AI FlowBuilder (5 tools)
+- `flowengine_list_components` - List UI components
+- `flowengine_get_component` - Get component details
+- `flowengine_create_component` - Create form/chatbot/widget
+- `flowengine_update_component` - Update component
+- `flowengine_delete_component` - Delete component
+
+**Total: 11 tools** (optimized to prevent API concurrency issues)
+
+## Resources
+
+Interactive UI dashboards available via MCP Apps (MCP v1.1+):
+
+- `ui://flowengine/portals` - Client Portals Dashboard
+- `ui://flowengine/ui-builder` - AI FlowBuilder
+- `ui://flowengine/instances` - Instance Manager
+
+**Note**: MCP Apps is a new feature announced January 26, 2026. Support may vary by client:
+- ✅ Claude Desktop: Coming soon
+- ✅ Claude Code: Check version compatibility
+- ✅ VSCode: Depends on extension version
+
+## Configuration
+
+### Environment Variables
+
+- `FLOWENGINE_API_KEY` (required) - Your FlowEngine API key
+- `FLOWENGINE_BASE_URL` (optional) - Custom base URL (defaults to https://flowengine.cloud)
+
+### Custom Base URL
+
+For self-hosted or custom deployments:
+
+```json
+{
+  "env": {
+    "FLOWENGINE_API_KEY": "your-key",
+    "FLOWENGINE_BASE_URL": "https://your-domain.com"
+  }
+}
+```
+
+## Development
+
+### Local Development
+
+```bash
+# Clone and install
+git clone https://github.com/FlowEngine-cloud/flowengine.git
+cd flowengine/flowengine-mcp
+npm install
+
+# Build
+npm run build
+
+# Test locally
+node build/index.js
+```
+
+### Project Structure
+
+```
+flowengine-mcp/
+├── src/
+│   ├── index.ts       # MCP server
+│   ├── client.ts      # FlowEngine API client
+│   └── ui/            # Dashboard renderers
+│       ├── base.ts
+│       ├── portals.ts
+│       ├── widgets.ts
+│       └── instances.ts
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+### Using Local Build
+
+Point your MCP config to local build:
+
+```json
+{
+  "mcpServers": {
+    "flowengine": {
+      "command": "node",
+      "args": ["/path/to/flowengine-mcp/build/index.js"],
+      "env": {
+        "FLOWENGINE_API_KEY": "your-key"
+      }
+    }
+  }
+}
+```
+
+## Troubleshooting
+
+### API Key Issues
+
+**Error: "FlowEngine API key not configured"**
+
+Solution: Verify `FLOWENGINE_API_KEY` is set in your MCP config
+
+### Connection Issues
+
+**Error: "Failed to connect to FlowEngine API"**
+
+Solutions:
+- Check your internet connection
+- Verify API key is valid
+- Ensure `FLOWENGINE_BASE_URL` is correct (if using custom)
+
+### MCP Server Not Starting
+
+**Server doesn't appear in Claude**
+
+Solutions:
+- Restart Claude Desktop / reload VSCode / start new Claude Code session
+- Check MCP config JSON syntax is valid
+- View logs: `~/.claude/debug/latest` (Claude Code)
+
+## Support
+
+- **FlowEngine Support**: [flowengine.cloud/support](https://flowengine.cloud/support)
+- **Documentation**: [docs.flowengine.cloud](https://docs.flowengine.cloud)
+- **GitHub Issues**: [github.com/FlowEngine-cloud/flowengine/issues](https://github.com/FlowEngine-cloud/flowengine/issues)
+- **MCP Protocol**: [modelcontextprotocol.io](https://modelcontextprotocol.io)
+
+## License
+
+MIT License - See LICENSE file for details
+
+## Contributing
+
+Contributions welcome! Please read our contributing guidelines before submitting PRs.
+
+---
+
+Built by the FlowEngine team

package/build/cli/api.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Minimal fetch wrapper for the CLI. Uses Node 18+ native fetch / FormData.
+ *
+ * Separate from `src/client.ts` (which is the MCP server's class-based client)
+ * because the CLI surface is just /api/v1/functions/* and we want crisp error
+ * messages tuned for the terminal.
+ */
+export interface ApiContext {
+    apiKey: string;
+    baseUrl: string;
+}
+export declare function getApiContext(): Promise<ApiContext>;
+export declare class ApiError extends Error {
+    status: number;
+    body?: unknown;
+    constructor(message: string, status: number, body?: unknown);
+}
+export declare function apiRequest<T>(ctx: ApiContext, path: string, init?: RequestInit): Promise<T>;
+//# sourceMappingURL=api.d.ts.map

package/build/cli/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/cli/api.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC,CAUzD;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;gBACH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAK5D;AAmBD,wBAAsB,UAAU,CAAC,CAAC,EAChC,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,CAAC,CAAC,CAgBZ"}

package/build/cli/api.js

@@ -0,0 +1,62 @@
+/**
+ * Minimal fetch wrapper for the CLI. Uses Node 18+ native fetch / FormData.
+ *
+ * Separate from `src/client.ts` (which is the MCP server's class-based client)
+ * because the CLI surface is just /api/v1/functions/* and we want crisp error
+ * messages tuned for the terminal.
+ */
+import { loadConfig, resolveApiKey, resolveBaseUrl } from './config.js';
+export async function getApiContext() {
+    const stored = await loadConfig();
+    const apiKey = resolveApiKey(stored);
+    if (!apiKey) {
+        throw new ApiError('Not logged in. Run `fe login` first, or set FLOWENGINE_API_KEY.', 401);
+    }
+    return { apiKey, baseUrl: resolveBaseUrl(stored) };
+}
+export class ApiError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.status = status;
+        this.body = body;
+    }
+}
+async function parseError(res) {
+    const ct = res.headers.get('content-type') || '';
+    if (ct.includes('application/json')) {
+        try {
+            const j = (await res.json());
+            return j.error || j.message || `HTTP ${res.status}`;
+        }
+        catch {
+            return `HTTP ${res.status}`;
+        }
+    }
+    const text = await res.text();
+    if (text.includes('<!DOCTYPE') || text.includes('<html')) {
+        return `HTTP ${res.status} (server returned HTML)`;
+    }
+    return text.length > 300 ? `${text.slice(0, 300)}...` : text || `HTTP ${res.status}`;
+}
+export async function apiRequest(ctx, path, init = {}) {
+    const url = `${ctx.baseUrl}${path}`;
+    const headers = new Headers(init.headers);
+    headers.set('Authorization', `Bearer ${ctx.apiKey}`);
+    if (init.body && !(init.body instanceof FormData) && !headers.has('Content-Type')) {
+        headers.set('Content-Type', 'application/json');
+    }
+    const res = await fetch(url, { ...init, headers });
+    if (!res.ok) {
+        const msg = await parseError(res);
+        throw new ApiError(msg, res.status);
+    }
+    if (res.status === 204)
+        return undefined;
+    const ct = res.headers.get('content-type') || '';
+    if (ct.includes('application/json'))
+        return (await res.json());
+    return (await res.text());
+}
+//# sourceMappingURL=api.js.map

package/build/cli/api.js.map

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

package/build/cli/commands/delete.d.ts

@@ -0,0 +1,4 @@
+export declare function cmdDelete(id: string, opts: {
+    yes?: boolean;
+}): Promise<number>;
+//# sourceMappingURL=delete.d.ts.map

package/build/cli/commands/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/delete.ts"],"names":[],"mappings":"AAGA,wBAAsB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAYpF"}

package/build/cli/commands/delete.js

@@ -0,0 +1,16 @@
+import { apiRequest, getApiContext } from '../api.js';
+import { ok, prompt, info } from '../ui.js';
+export async function cmdDelete(id, opts) {
+    if (!opts.yes) {
+        const answer = (await prompt(`  Delete function ${id}? Type "yes" to confirm: `)).trim();
+        if (answer !== 'yes') {
+            info('Cancelled.');
+            return 1;
+        }
+    }
+    const ctx = await getApiContext();
+    await apiRequest(ctx, `/api/v1/functions/${encodeURIComponent(id)}`, { method: 'DELETE' });
+    ok(`Deleted ${id}`);
+    return 0;
+}
+//# sourceMappingURL=delete.js.map

package/build/cli/commands/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/cli/commands/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,EAAU,EAAE,IAAuB;IACjE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACd,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,qBAAqB,EAAE,2BAA2B,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACzF,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YACrB,IAAI,CAAC,YAAY,CAAC,CAAC;YACnB,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,aAAa,EAAE,CAAC;IAClC,MAAM,UAAU,CAAC,GAAG,EAAE,qBAAqB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC3F,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACpB,OAAO,CAAC,CAAC;AACX,CAAC"}

package/build/cli/commands/deploy.d.ts

@@ -0,0 +1,24 @@
+/**
+ * fe deploy [path] [options]
+ *
+ * Walks the target folder, packs each file into a multipart form using the
+ * file's relative path as the field name, and POSTs to
+ * /api/v1/functions/upload. The server builds the tarball + runs the deploy.
+ *
+ * If --name matches an existing function, the server treats it as a new
+ * revision of that function; otherwise it creates one.
+ */
+export interface DeployOptions {
+    name?: string;
+    runtime?: string;
+    memory?: string;
+    cpu?: string;
+    maxInstances?: string;
+    minInstances?: string;
+    timeout?: string;
+    region?: string;
+    concurrency?: string;
+    cpuThrottling?: boolean;
+}
+export declare function cmdDeploy(path: string | undefined, opts: DeployOptions): Promise<number>;
+//# sourceMappingURL=deploy.d.ts.map

package/build/cli/commands/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/deploy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmBH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAgF9F"}

package/build/cli/commands/deploy.js

@@ -0,0 +1,103 @@
+/**
+ * fe deploy [path] [options]
+ *
+ * Walks the target folder, packs each file into a multipart form using the
+ * file's relative path as the field name, and POSTs to
+ * /api/v1/functions/upload. The server builds the tarball + runs the deploy.
+ *
+ * If --name matches an existing function, the server treats it as a new
+ * revision of that function; otherwise it creates one.
+ */
+import { resolve } from 'node:path';
+import { apiRequest, getApiContext, ApiError } from '../api.js';
+import { packFolder, buildUploadForm } from '../pack.js';
+import { c, info, ok, err, bytes, warn } from '../ui.js';
+const MAX_TOTAL_BYTES = 100 * 1024 * 1024;
+const MAX_FILE_BYTES = 25 * 1024 * 1024;
+export async function cmdDeploy(path, opts) {
+    const root = resolve(path || '.');
+    info(`Packing ${c.bold(root)}`);
+    const packed = await packFolder(root);
+    if (packed.files.length === 0) {
+        err('No files found in folder (after .feignore + skip rules).');
+        return 1;
+    }
+    if (packed.totalBytes > MAX_TOTAL_BYTES) {
+        err(`Folder is ${bytes(packed.totalBytes)} - exceeds 100 MB upload cap.`);
+        err('Add patterns to .feignore (e.g. data/, *.zip) and retry.');
+        return 1;
+    }
+    for (const f of packed.files) {
+        if (f.size > MAX_FILE_BYTES) {
+            err(`File ${f.path} is ${bytes(f.size)} - exceeds 25 MB per-file cap.`);
+            return 1;
+        }
+    }
+    info(`${packed.files.length} files, ${bytes(packed.totalBytes)} total`);
+    if (packed.files.length <= 8) {
+        for (const f of packed.files) {
+            console.log(`  ${c.dim(f.path.padEnd(40))}  ${c.dim(bytes(f.size))}`);
+        }
+    }
+    const compute = {};
+    if (opts.memory)
+        compute.memory = opts.memory;
+    if (opts.cpu)
+        compute.cpu = Number(opts.cpu);
+    if (opts.maxInstances)
+        compute.max_instances = Number(opts.maxInstances);
+    if (opts.minInstances)
+        compute.min_instances = Number(opts.minInstances);
+    if (opts.timeout)
+        compute.timeout_seconds = Number(opts.timeout);
+    if (opts.region)
+        compute.region = opts.region;
+    if (opts.concurrency)
+        compute.concurrency = Number(opts.concurrency);
+    if (opts.cpuThrottling !== undefined)
+        compute.cpu_throttling = opts.cpuThrottling;
+    const form = buildUploadForm(packed, {
+        name: opts.name,
+        runtime: opts.runtime,
+        compute,
+    });
+    info(`Uploading to FlowEngine...`);
+    const ctx = await getApiContext();
+    let result;
+    try {
+        result = await apiRequest(ctx, '/api/v1/functions/upload', {
+            method: 'POST',
+            body: form,
+        });
+    }
+    catch (e) {
+        if (e instanceof ApiError) {
+            err(`Deploy failed (${e.status}): ${e.message}`);
+        }
+        else {
+            err(`Deploy failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+        return 1;
+    }
+    if (!result.success) {
+        err(`Deploy rejected: ${result.error || 'unknown reason'}`);
+        return 1;
+    }
+    ok(`Deployed function ${c.bold(result.id || '')}`);
+    if (result.revision)
+        info(`Revision: ${result.revision}`);
+    // deploy field can be either an object or a string ("already deploying", etc)
+    if (typeof result.deploy === 'object' && result.deploy) {
+        if (result.deploy.url)
+            info(`URL: ${c.cyan(result.deploy.url)}`);
+        if (result.deploy.status)
+            info(`Status: ${result.deploy.status}`);
+    }
+    else if (typeof result.deploy === 'string') {
+        info(result.deploy);
+    }
+    if (result.reason)
+        warn(result.reason);
+    return 0;
+}
+//# sourceMappingURL=deploy.js.map

package/build/cli/commands/deploy.js.map

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

package/build/cli/commands/domain.d.ts

@@ -0,0 +1,9 @@
+/**
+ *   fe domain add    <id> <domain>
+ *   fe domain status <id>
+ *   fe domain rm     <id>
+ */
+export declare function cmdDomainAdd(id: string, domain: string): Promise<number>;
+export declare function cmdDomainStatus(id: string): Promise<number>;
+export declare function cmdDomainRm(id: string): Promise<number>;
+//# sourceMappingURL=domain.d.ts.map

package/build/cli/commands/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/domain.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,wBAAsB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAU9E;AAED,wBAAsB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQjE;AAED,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK7D"}

package/build/cli/commands/domain.js

@@ -0,0 +1,27 @@
+/**
+ *   fe domain add    <id> <domain>
+ *   fe domain status <id>
+ *   fe domain rm     <id>
+ */
+import { apiRequest, getApiContext } from '../api.js';
+import { ok } from '../ui.js';
+export async function cmdDomainAdd(id, domain) {
+    const ctx = await getApiContext();
+    const data = await apiRequest(ctx, `/api/v1/functions/${encodeURIComponent(id)}/domain`, { method: 'POST', body: JSON.stringify({ domain }) });
+    ok(`Mapping requested for ${domain}`);
+    console.log(JSON.stringify(data, null, 2));
+    return 0;
+}
+export async function cmdDomainStatus(id) {
+    const ctx = await getApiContext();
+    const data = await apiRequest(ctx, `/api/v1/functions/${encodeURIComponent(id)}/domain`);
+    console.log(JSON.stringify(data, null, 2));
+    return 0;
+}
+export async function cmdDomainRm(id) {
+    const ctx = await getApiContext();
+    await apiRequest(ctx, `/api/v1/functions/${encodeURIComponent(id)}/domain`, { method: 'DELETE' });
+    ok(`Domain mapping removed from ${id}`);
+    return 0;
+}
+//# sourceMappingURL=domain.js.map

package/build/cli/commands/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../../../src/cli/commands/domain.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAE9B,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,EAAU,EAAE,MAAc;IAC3D,MAAM,GAAG,GAAG,MAAM,aAAa,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,UAAU,CAC3B,GAAG,EACH,qBAAqB,kBAAkB,CAAC,EAAE,CAAC,SAAS,EACpD,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CACrD,CAAC;IACF,EAAE,CAAC,yBAAyB,MAAM,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3C,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EAAU;IAC9C,MAAM,GAAG,GAAG,MAAM,aAAa,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,UAAU,CAC3B,GAAG,EACH,qBAAqB,kBAAkB,CAAC,EAAE,CAAC,SAAS,CACrD,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3C,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAAU;IAC1C,MAAM,GAAG,GAAG,MAAM,aAAa,EAAE,CAAC;IAClC,MAAM,UAAU,CAAC,GAAG,EAAE,qBAAqB,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClG,EAAE,CAAC,+BAA+B,EAAE,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,CAAC;AACX,CAAC"}

package/build/cli/commands/env.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Function-scoped env vars (a.k.a. secret bindings).
+ *
+ *   fe env list   <id>
+ *   fe env set    <id> KEY=VALUE
+ *   fe env unset  <id> KEY
+ */
+export declare function cmdEnvList(id: string, opts: {
+    json?: boolean;
+}): Promise<number>;
+export declare function cmdEnvSet(id: string, kv: string): Promise<number>;
+export declare function cmdEnvUnset(id: string, name: string): Promise<number>;
+//# sourceMappingURL=env.d.ts.map

package/build/cli/commands/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH,wBAAsB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBtF;AAED,wBAAsB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBvE;AAED,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM3E"}