@pulse-editor/cli 0.1.1-beta.9 → 0.1.3

package/dist/components/commands/upgrade.js

@@ -0,0 +1,53 @@
+import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { $ } from 'execa';
+import React, { useEffect, useState } from 'react';
+import { Box, Text } from 'ink';
+import Spinner from 'ink-spinner';
+import fs from 'fs';
+export default function Upgrade({ cli }) {
+    const [isInProjectDir, setIsInProjectDir] = useState(false);
+    const [step, setStep] = useState('check-config');
+    const [isError, setIsError] = useState(false);
+    const [errorMessage, setErrorMessage] = useState(null);
+    useEffect(() => {
+        async function checkConfig() {
+            // Check if the current dir contains pulse.config.ts
+            const currentDir = process.cwd();
+            const pulseConfigPath = `${currentDir}/pulse.config.ts`;
+            if (fs.existsSync(pulseConfigPath)) {
+                setIsInProjectDir(true);
+            }
+            setStep('upgrade');
+        }
+        checkConfig();
+    }, []);
+    useEffect(() => {
+        async function start() {
+            try {
+                await upgradePackages();
+            }
+            catch (error) {
+                setIsError(true);
+                setErrorMessage(error.message);
+            }
+        }
+        if (isInProjectDir) {
+            start();
+        }
+    }, [isInProjectDir]);
+    async function upgradePackages() {
+        const tag = cli.flags.beta ? 'beta' : 'latest';
+        await $ `npm install react@${React.version} react-dom@${React.version} --save-exact --silent --force`;
+        await $ `npm install -D @pulse-editor/cli@${tag} --silent --force`;
+        await $ `npm install @pulse-editor/shared-utils@${tag} @pulse-editor/react-api@${tag} --silent --force`;
+        // Remove webpack.config.ts if exists
+        const webpackConfigPath = `${process.cwd()}/webpack.config.ts`;
+        if (fs.existsSync(webpackConfigPath)) {
+            fs.unlinkSync(webpackConfigPath);
+        }
+        // Uninstall @module-federation/node html-webpack-plugin copy-webpack-plugin glob mini-css-extract-plugin webpack webpack-cli webpack-dev-server
+        await $ `npm uninstall @module-federation/node html-webpack-plugin copy-webpack-plugin glob mini-css-extract-plugin webpack webpack-cli webpack-dev-server --silent --force`;
+        setStep('done');
+    }
+    return (_jsx(_Fragment, { children: isError ? (_jsxs(Text, { color: 'redBright', children: ["\u274C An error occurred: ", errorMessage || 'Unknown error'] })) : !isInProjectDir ? (_jsx(Text, { color: 'redBright', children: "\u26D4 The current directory does not contain a Pulse Editor project." })) : step === 'check-config' ? (_jsxs(Box, { children: [_jsx(Spinner, { type: "dots" }), _jsx(Text, { children: " Checking configuration..." })] })) : step === 'upgrade' ? (_jsx(_Fragment, { children: _jsxs(Box, { children: [_jsx(Spinner, { type: "dots" }), _jsx(Text, { children: " Upgrading packages..." })] }) })) : (_jsx(Box, { children: _jsx(Text, { color: 'greenBright', children: "\u2705 Upgrade completed successfully." }) })) }));
+}

package/dist/lib/backend/publish-app.d.ts

@@ -0,0 +1 @@
+export declare function publishApp(isStage: boolean): Promise<Response>;

package/dist/lib/backend/publish-app.js

@@ -0,0 +1,26 @@
+import { getToken } from '../token.js';
+import { getBackendUrl } from '../backend-url.js';
+import fs from 'fs';
+export async function publishApp(isStage) {
+    // Upload the zip file to the server
+    // Read pulse.config.json for visibility
+    const config = JSON.parse(fs.readFileSync('./dist/pulse.config.json', 'utf-8'));
+    const visibility = config.visibility;
+    const formData = new FormData();
+    const buffer = fs.readFileSync('./node_modules/@pulse-editor/dist.zip');
+    // @ts-ignore Create a Blob from the buffer
+    const blob = new Blob([buffer], {
+        type: 'application/zip',
+    });
+    formData.append('file', blob, 'dist.zip');
+    formData.append('visibility', visibility);
+    // Send the file to the server
+    const res = await fetch(`${getBackendUrl(isStage)}/api/app/publish`, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${getToken(isStage)}`,
+        },
+        body: formData,
+    });
+    return res;
+}

package/dist/lib/backend-url.d.ts

@@ -0,0 +1 @@
+export declare function getBackendUrl(stage: boolean): "https://localhost:8080" | "https://pulse-editor.com";

package/dist/lib/backend-url.js

@@ -0,0 +1,3 @@
+export function getBackendUrl(stage) {
+    return stage ? 'https://localhost:8080' : 'https://pulse-editor.com';
+}

package/dist/lib/cli-flags.d.ts

@@ -25,5 +25,27 @@ export declare const flags: {
         type: "string";
         shortFlag: string;
     };
+    beta: {
+        type: "boolean";
+    };
+    build: {
+        type: "boolean";
+        default: true;
+    };
+    path: {
+        type: "string";
+        shortFlag: string;
+    };
+    displayName: {
+        type: "string";
+    };
+    description: {
+        type: "string";
+        shortFlag: string;
+    };
+    continue: {
+        type: "boolean";
+        default: false;
+    };
 };
 export type Flags = typeof flags;

package/dist/lib/cli-flags.js

@@ -29,4 +29,26 @@ export const flags = defineFlags({
         type: 'string',
         shortFlag: 't',
     },
+    beta: {
+        type: 'boolean',
+    },
+    build: {
+        type: 'boolean',
+        default: true,
+    },
+    path: {
+        type: 'string',
+        shortFlag: 'p',
+    },
+    displayName: {
+        type: 'string',
+    },
+    description: {
+        type: 'string',
+        shortFlag: 'd',
+    },
+    continue: {
+        type: 'boolean',
+        default: false,
+    },
 });

package/dist/lib/manual.js

@@ -9,6 +9,17 @@ const chat = `\
                     --interactive, -i
                       Start an interactive chat session
 
+`;
+const code = `\
+  code            Generate a new Pulse App from a prompt using AI.
+
+                  Flags:
+                    --name, -n [app-name]
+                      Optional app name used for generation.
+                    --continue, -c
+                      Continue building on an existing app. Reads the app ID
+                      and version from the package.json in the current directory.
+
 `;
 const login = `\
   login           Login to the Pulse Editor Platform.
@@ -27,6 +38,9 @@ const logout = `\
 `;
 const publish = `\
   publish         Publish Pulse Editor Extension in current directory to the Pulse Editor Platform.
+                  Flags:
+                    --noBuild
+                      Skip the build step before publishing.
 
 `;
 const create = `\
@@ -41,6 +55,9 @@ const create = `\
                     --visibility, -v [visibility]
                       The visibility of the new project. Options are private,
                       public, and unlisted.
+                    --path, -p [path]
+                      The path where to create the new project. Defaults to
+                      the name of the project in the current working directory.
 
 `;
 const preview = `\
@@ -71,10 +88,31 @@ const start = `\
 const clean = `\
   clean           Clean the dist/ directory.
 
+`;
+const upgrade = `\
+  upgrade         Upgrade Pulse Editor CLI and related packages to the latest version.
+                  Flags:
+                    --beta
+                      Upgrade to the latest beta version.
+
+`;
+const skill = `\
+  skill           Manage skill actions for the current Pulse App.
+
+                  Subcommands:
+                    create <skill-name> --description "<description>"
+                      Generate a new skill action using AI and write it to
+                      src/skill/<skill-name>/action.ts.
+
+                    fix <action-name>
+                      Fix and apply valid JSDoc comments to an existing skill
+                      action at src/skill/<action-name>/action.ts using AI.
+
 `;
 export const commandsManual = {
     help,
     chat,
+    code,
     login,
     logout,
     publish,
@@ -84,4 +122,6 @@ export const commandsManual = {
     build,
     start,
     clean,
+    upgrade,
+    skill,
 };

package/dist/lib/server/express.js

@@ -1,32 +1,32 @@
 /**
  *  This is a local dev server for "npm run dev" and "npm run preview".
  */
-import express from 'express';
-import cors from 'cors';
-import dotenv from 'dotenv';
-import livereload from 'livereload';
-import connectLivereload from 'connect-livereload';
-import { networkInterfaces } from 'os';
-import { pipeline, Readable } from 'stream';
-import { promisify } from 'util';
-import { readConfigFile } from './utils.js';
-import path from 'path';
-import { pathToFileURL } from 'url';
+import connectLivereload from "connect-livereload";
+import cors from "cors";
+import dotenv from "dotenv";
+import express from "express";
+import livereload from "livereload";
+import { networkInterfaces } from "os";
+import path from "path";
+import { pipeline, Readable } from "stream";
+import { pathToFileURL } from "url";
+import { promisify } from "util";
+import { readConfigFile } from "../webpack/configs/utils.js";
 dotenv.config({
     quiet: true,
 });
-const isPreview = process.env?.['PREVIEW'];
-const isDev = process.env?.['NODE_ENV'];
-const workspaceId = process.env?.['WORKSPACE_ID'];
+const isPreview = process.env?.["PREVIEW"];
+const isDev = process.env?.["NODE_ENV"] === "development";
+const workspaceId = process.env?.["WORKSPACE_ID"];
 const pulseConfig = await readConfigFile();
 if (isDev || isPreview) {
     const livereloadServer = livereload.createServer({
         // @ts-expect-error override server options
-        host: '0.0.0.0',
+        host: "0.0.0.0",
     });
-    livereloadServer.watch('dist');
-    livereloadServer.server.once('connection', () => {
-        console.log('✅ LiveReload connected');
+    livereloadServer.watch("dist");
+    livereloadServer.server.once("connection", () => {
+        console.log("✅ LiveReload connected");
     });
 }
 const app = express();
@@ -49,51 +49,91 @@ app.use((req, res, next) => {
     return next();
 });
 // Serve backend
-app.use(`/${pulseConfig.id}/${pulseConfig.version}/server`, express.static('dist/server'));
+app.use(`/${pulseConfig.id}/${pulseConfig.version}/server`, express.static("dist/server"));
 // Catch backend function calls
 app.all(/^\/server-function\/(.*)/, async (req, res) => {
     const func = req.params[0];
-    const url = `${req.protocol}://${req.get('host')}${req.originalUrl}`;
+    const url = `${req.protocol}://${req.get("host")}${req.originalUrl}`;
     // Convert Express req -> Fetch Request
     const request = new Request(url, {
         method: req.method,
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         headers: req.headers,
-        body: ['GET', 'HEAD'].includes(req.method)
+        body: ["GET", "HEAD"].includes(req.method)
             ? null
             : JSON.stringify(req.body),
     });
-    const dir = path.resolve('node_modules/@pulse-editor/cli/dist/lib/server/preview/backend/load-remote.cjs');
+    const dir = path.resolve("node_modules/@pulse-editor/cli/dist/lib/server/preview/backend/load-remote.cjs");
     const fileUrl = pathToFileURL(dir).href;
-    const { loadAndCall } = await import(fileUrl);
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const response = await loadAndCall(func, request, pulseConfig.id, 'http://localhost:3030', pulseConfig.version);
-    const streamPipeline = promisify(pipeline);
-    // If loadAndCall returns a Response (Fetch API Response)
-    if (response.body) {
-        // Convert WHATWG stream to Node.js stream
-        const nodeStream = Readable.fromWeb(response.body);
-        // Pipe it directly to Express
-        await streamPipeline(nodeStream, res);
+    const { loadFunc, loadPrice } = await import(fileUrl);
+    const price = await loadPrice(func, pulseConfig.id, "http://localhost:3030", pulseConfig.version);
+    if (price) {
+        // Make func name and price bold in console
+        console.log(`🏃 Running function \x1b[1m${func}\x1b[0m, credits consumed: \x1b[1m${price}\x1b[0m`);
     }
     else {
-        res.end();
+        console.log(`🏃 Running function \x1b[1m${func}\x1b[0m.`);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const loadedFunc = await loadFunc(func, pulseConfig.id, "http://localhost:3030", pulseConfig.version);
+    const response = await loadedFunc(request);
+    const streamPipeline = promisify(pipeline);
+    if (response) {
+        // 1️⃣ Set status code
+        res.status(response.status);
+        // 2️⃣ Copy headers
+        response.headers.forEach((value, key) => {
+            res.setHeader(key, value);
+        });
+        // 3️⃣ Pipe body if present
+        if (response.body) {
+            const nodeStream = Readable.fromWeb(response.body);
+            await streamPipeline(nodeStream, res);
+        }
+        else {
+            res.end();
+        }
     }
 });
 if (isPreview) {
     /* Preview mode */
-    app.use(express.static('dist/client'));
-    app.listen(3030, '0.0.0.0');
+    app.use(express.static("dist/client"));
+    // Expose skill actions as REST API endpoints in dev and preview modes
+    const skillActions = pulseConfig?.actions || [];
+    const skillActionNames = skillActions.map((a) => a.name);
+    app.post("/skill/:actionName", async (req, res) => {
+        const { actionName } = req.params;
+        if (skillActionNames.length > 0 && !skillActionNames.includes(actionName)) {
+            res
+                .status(404)
+                .json({ error: `Skill action "${actionName}" not found.` });
+            return;
+        }
+        const dir = path.resolve("node_modules/@pulse-editor/cli/dist/lib/server/preview/backend/load-remote.cjs");
+        const fileUrl = pathToFileURL(dir).href;
+        const { loadFunc } = await import(fileUrl);
+        try {
+            const action = await loadFunc(`skill/${actionName}`, pulseConfig.id, "http://localhost:3030", pulseConfig.version);
+            const result = await action(req.body);
+            res.json(result);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(`❌ Error running skill action "${actionName}": ${message}`);
+            res.status(500).json({ error: message });
+        }
+    });
+    app.listen(3030, "0.0.0.0");
 }
 else if (isDev) {
     /* Dev mode  */
-    app.use(`/${pulseConfig.id}/${pulseConfig.version}`, express.static('dist'));
-    app.listen(3030, '0.0.0.0');
+    app.use(`/${pulseConfig.id}/${pulseConfig.version}`, express.static("dist"));
+    app.listen(3030, "0.0.0.0");
 }
 else {
     /* Production mode */
-    app.use(`/${pulseConfig.id}/${pulseConfig.version}`, express.static('dist'));
-    app.listen(3030, '0.0.0.0', () => {
+    app.use(`/${pulseConfig.id}/${pulseConfig.version}`, express.static("dist"));
+    app.listen(3030, "0.0.0.0", () => {
         console.log(`\
 🎉 Your Pulse extension \x1b[1m${pulseConfig.displayName}\x1b[0m is LIVE! 
 
@@ -109,10 +149,10 @@ function getLocalNetworkIP() {
         if (!iface)
             continue;
         for (const config of iface) {
-            if (config.family === 'IPv4' && !config.internal) {
+            if (config.family === "IPv4" && !config.internal) {
                 return config.address; // Returns the first non-internal IPv4 address
             }
         }
     }
-    return 'localhost'; // Fallback
+    return "localhost"; // Fallback
 }

package/dist/lib/server/preview/backend/load-remote.cjs

@@ -1,23 +1,33 @@
-const { createInstance } = require("@module-federation/runtime");
+const {createInstance} = require('@module-federation/runtime');
 
-async function loadAndCall(func, req, appId, origin, version) {
-  // here we assign the return value of the init() function, which can be used to do some more complex
-  // things with the module federation runtime
-  const instance = createInstance({
-    name: "server_function_runner",
-    remotes: [
-      {
-        name: appId + "_server",
-        entry: `${origin}/${appId}/${version}/server/remoteEntry.js`,
-      },
-    ],
-  });
+async function importRemoteModule(func, appId, origin, version) {
+	const instance = createInstance({
+		name: 'server_function_runner',
+		remotes: [
+			{
+				name: appId + '_server',
+				entry: `${origin}/${appId}/${version}/server/remoteEntry.js`,
+			},
+		],
+	});
 
-  const loadedFunc = (await instance.loadRemote(`${appId}_server/${func}`))
-    .default;
+	const loadedModule = await instance.loadRemote(`${appId}_server/${func}`);
+	return loadedModule;
+}
+
+async function loadFunc(func, appId, origin, version) {
+	// here we assign the return value of the init() function, which can be used to do some more complex
+	// things with the module federation runtime
+	const module = await importRemoteModule(func, appId, origin, version);
+	const loadedFunc = module.default;
+
+	return loadedFunc;
+}
 
-  const res = await loadedFunc(req);
-  return res;
+async function loadPrice(func, appId, origin, version) {
+	const module = await importRemoteModule(func, appId, origin, version);
+	const price = module._CREDIT_PER_CALL;
+	return price;
 }
 
-module.exports = { loadAndCall };
+module.exports = {loadFunc, loadPrice};

package/dist/lib/server/utils.js

@@ -1,10 +1,10 @@
 import fs from 'fs/promises';
 export async function readConfigFile() {
     // Read pulse.config.json from dist/client
-    // Wait until dist/client/pulse.config.json exists
+    // Wait until dist/pulse.config.json exists
     while (true) {
         try {
-            await fs.access('dist/client/pulse.config.json');
+            await fs.access('dist/pulse.config.json');
             break;
         }
         catch (err) {
@@ -12,6 +12,6 @@ export async function readConfigFile() {
             await new Promise(resolve => setTimeout(resolve, 100));
         }
     }
-    const data = await fs.readFile('dist/client/pulse.config.json', 'utf-8');
+    const data = await fs.readFile('dist/pulse.config.json', 'utf-8');
     return JSON.parse(data);
 }

package/dist/lib/token.js

@@ -1,6 +1,7 @@
 import os from 'os';
 import path from 'path';
 import fs from 'fs';
+import { getBackendUrl } from './backend-url.js';
 export function saveToken(token, devMode) {
     // Save the token to .pulse-editor/config.json in user home directory
     const configDir = path.join(os.homedir(), '.pulse-editor');
@@ -62,9 +63,7 @@ export function isTokenInEnv(devMode) {
     return false;
 }
 export async function checkToken(token, devMode) {
-    const res = await fetch(devMode
-        ? 'https://localhost:8080/api/api-keys/check'
-        : 'https://pulse-editor.com/api/api-keys/check', {
+    const res = await fetch(`${getBackendUrl(devMode)}/api/api-keys/check`, {
         body: JSON.stringify({ token }),
         headers: {
             'Content-Type': 'application/json',

package/dist/lib/webpack/compile.d.ts

@@ -0,0 +1,2 @@
+import webpack from "webpack";
+export declare function webpackCompile(mode: "development" | "production" | "preview", buildTarget?: "client" | "server", isWatchMode?: boolean): Promise<void | webpack.MultiCompiler>;

package/dist/lib/webpack/compile.js

@@ -0,0 +1,30 @@
+import webpack from "webpack";
+import { generateTempTsConfig } from "./configs/utils.js";
+import { createWebpackConfig } from "./webpack-config.js";
+export async function webpackCompile(mode, buildTarget, isWatchMode = false) {
+    generateTempTsConfig();
+    const configs = await createWebpackConfig(mode === "preview", buildTarget ?? "both", mode === "development"
+        ? "development"
+        : mode === "preview"
+            ? "development"
+            : "production");
+    const compiler = webpack(configs);
+    if (isWatchMode) {
+        compiler.watch({}, (err, stats) => {
+            if (err) {
+                console.error("❌ Webpack build failed", err);
+                return;
+            }
+        });
+        return compiler;
+    }
+    return new Promise((resolve, reject) => {
+        compiler.run((err) => {
+            if (err) {
+                reject(err);
+                return;
+            }
+            resolve();
+        });
+    });
+}

package/dist/lib/webpack/configs/mf-client.d.ts

@@ -0,0 +1,3 @@
+import { Configuration as WebpackConfig } from "webpack";
+import { Configuration as DevServerConfig } from "webpack-dev-server";
+export declare function makeMFClientConfig(mode: "development" | "production"): Promise<WebpackConfig & DevServerConfig>;