@pulse-editor/cli 0.1.5 → 0.1.6

package/dist/lib/server/preview/frontend/index.js

@@ -46,7 +46,42 @@ class ErrorBoundary extends React.Component {
     }
 }
 const root = ReactDOM.createRoot(document.getElementById('root'));
+const PREVIEW_MODE_ERRORS = [
+    "Current window's ID is not defined.",
+];
+function isPreviewModeError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return PREVIEW_MODE_ERRORS.some((msg) => message.includes(msg));
+}
+function showPreviewModeWarning() {
+    const existing = document.getElementById('__pulse_preview_warning__');
+    if (existing)
+        return;
+    const banner = document.createElement('div');
+    banner.id = '__pulse_preview_warning__';
+    Object.assign(banner.style, {
+        position: 'fixed',
+        bottom: '1rem',
+        right: '1rem',
+        background: '#2a2000',
+        border: '1px solid #665500',
+        borderRadius: '8px',
+        padding: '0.75rem 1rem',
+        fontFamily: 'monospace',
+        fontSize: '0.8rem',
+        color: '#ffcc00',
+        maxWidth: '320px',
+        zIndex: '9999',
+        lineHeight: '1.4',
+    });
+    banner.textContent = '⚠ Preview mode: some Pulse Editor platform APIs are not available and will not work.';
+    document.body.appendChild(banner);
+}
 function showError(error) {
+    if (isPreviewModeError(error)) {
+        showPreviewModeWarning();
+        return;
+    }
     root.render(_jsx(ErrorPage, { error: error }));
 }
 // Fallback: catch errors that slip past the React error boundary

package/dist/lib/webpack/configs/mf-client.js

@@ -51,8 +51,6 @@ class MFClientPlugin {
                 else {
                     console.log("[client] ✅ Reload finished.");
                 }
-                // Write pulse config to dist
-                fs.writeFileSync(path.resolve(this.projectDirName, "dist/pulse.config.json"), JSON.stringify(this.pulseConfig, null, 2));
             });
         }
         else {
@@ -63,8 +61,6 @@ class MFClientPlugin {
                 }
                 else {
                     console.log(`[client] ✅ Successfully built client.`);
-                    // Write pulse config to dist
-                    fs.writeFileSync(path.resolve(this.projectDirName, "dist/pulse.config.json"), JSON.stringify(this.pulseConfig, null, 2));
                 }
             });
         }

package/dist/lib/webpack/configs/mf-server.js

@@ -46,13 +46,15 @@ class MFServerPlugin {
                         : false;
                     if (isActionChange) {
                         console.log(`[Server] Detected changes in actions. Recompiling...`);
-                        compileAppActionSkills(this.pulseConfig);
+                        this.pulseConfig = compileAppActionSkills(this.pulseConfig);
+                        this.saveConfig();
                     }
                 }
                 else {
                     console.log(`[Server] 🔄 Building app...`);
                     await this.compileServerFunctions(compiler);
-                    compileAppActionSkills(this.pulseConfig);
+                    this.pulseConfig = compileAppActionSkills(this.pulseConfig);
+                    this.saveConfig();
                     console.log(`[Server] ✅ Successfully built server.`);
                     const funcs = discoverServerFunctions();
                     console.log(`\n🛜 Server functions:
@@ -83,7 +85,8 @@ ${Object.entries(funcs)
                 else {
                     try {
                         await this.compileServerFunctions(compiler);
-                        compileAppActionSkills(this.pulseConfig);
+                        this.pulseConfig = compileAppActionSkills(this.pulseConfig);
+                        this.saveConfig();
                     }
                     catch (err) {
                         console.error(`[Server] ❌ Error during compilation:`, err);
@@ -104,6 +107,10 @@ ${Object.entries(funcs)
             console.log("Continuing...");
         }
     }
+    saveConfig() {
+        const filePath = path.resolve(this.projectDirName, "dist/pulse.config.json");
+        fs.writeFileSync(filePath, JSON.stringify(this.pulseConfig, null, 2));
+    }
     /**
      * Programmatically call webpack to compile server functions
      * whenever there are changes in the src/server-function directory.

package/dist/lib/webpack/configs/preview.d.ts

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

package/dist/lib/webpack/configs/preview.js

@@ -1,133 +1,10 @@
 /* eslint-disable @typescript-eslint/no-explicit-any */
-import mfNode from "@module-federation/node";
 import CopyWebpackPlugin from "copy-webpack-plugin";
 import fs from "fs";
 import HtmlWebpackPlugin from "html-webpack-plugin";
 import MiniCssExtractPlugin from "mini-css-extract-plugin";
 import path from "path";
-import wp from "webpack";
-import { compileAppActionSkills, discoverAppSkillActions, getLocalNetworkIP, loadPulseConfig, } from "./utils.js";
-const { NodeFederationPlugin } = mfNode;
-const { webpack } = wp;
-class MFPreviewPlugin {
-    projectDirName;
-    pulseConfig;
-    constructor(pulseConfig) {
-        this.projectDirName = process.cwd();
-        this.pulseConfig = pulseConfig;
-    }
-    apply(compiler) {
-        let isFirstRun = true;
-        compiler.hooks.environment.tap("WatchSkillPlugin", () => {
-            compiler.hooks.thisCompilation.tap("WatchActions", (compilation) => {
-                compilation.contextDependencies.add(path.resolve(this.projectDirName, "src/skill"));
-            });
-        });
-        compiler.hooks.watchRun.tap("MFPreviewPlugin", async () => {
-            if (!isFirstRun) {
-                const isActionChange = compiler.modifiedFiles
-                    ? Array.from(compiler.modifiedFiles).some((file) => file.includes("src/skill"))
-                    : false;
-                if (isActionChange) {
-                    console.log("[preview-server] Detected changes in actions. Recompiling...");
-                    await this.compileActions(compiler);
-                }
-            }
-            else {
-                console.log("[preview-server] 🔄 Building...");
-                await this.compileActions(compiler);
-                console.log("[preview-server] ✅ Successfully built preview server.");
-            }
-        });
-        compiler.hooks.done.tap("MFPreviewPlugin", () => {
-            if (isFirstRun) {
-                isFirstRun = false;
-            }
-            else {
-                console.log("[preview-server] ✅ Reload finished.");
-            }
-            fs.writeFileSync(path.resolve(this.projectDirName, "dist/pulse.config.json"), JSON.stringify(this.pulseConfig, null, 2));
-        });
-    }
-    makeNodeFederationPlugin() {
-        const actions = discoverAppSkillActions();
-        return new NodeFederationPlugin({
-            name: this.pulseConfig.id + "_server",
-            remoteType: "script",
-            useRuntimePlugin: true,
-            library: { type: "commonjs-module" },
-            filename: "remoteEntry.js",
-            exposes: { ...actions },
-        }, {});
-    }
-    async compileActions(compiler) {
-        compileAppActionSkills(this.pulseConfig);
-        const options = {
-            ...compiler.options,
-            watch: false,
-            plugins: [this.makeNodeFederationPlugin()],
-        };
-        const newCompiler = webpack(options);
-        return new Promise((resolve, reject) => {
-            newCompiler?.run((err, stats) => {
-                if (err) {
-                    console.error("[preview-server] ❌ Error during recompilation:", err);
-                    reject(err);
-                }
-                else if (stats?.hasErrors()) {
-                    console.error("[preview-server] ❌ Compilation errors:", stats.toJson().errors);
-                    reject(new Error("Compilation errors"));
-                }
-                else {
-                    console.log("[preview-server] ✅ Compiled actions successfully.");
-                    resolve();
-                }
-            });
-        });
-    }
-}
-export async function makeMFPreviewConfig() {
-    const projectDirName = process.cwd();
-    const pulseConfig = await loadPulseConfig();
-    return {
-        mode: "development",
-        name: "preview-server",
-        entry: {},
-        target: "async-node",
-        output: {
-            publicPath: "auto",
-            path: path.resolve(projectDirName, "dist/server"),
-        },
-        resolve: {
-            extensions: [".ts", ".js"],
-        },
-        plugins: [new MFPreviewPlugin(pulseConfig)],
-        module: {
-            rules: [
-                {
-                    test: /\.tsx?$/,
-                    use: {
-                        loader: "ts-loader",
-                        options: {
-                            configFile: "node_modules/.pulse/tsconfig.server.json",
-                        },
-                    },
-                    exclude: [/node_modules/, /dist/],
-                },
-            ],
-        },
-        stats: {
-            all: false,
-            errors: true,
-            warnings: true,
-            logging: "warn",
-            colors: true,
-        },
-        infrastructureLogging: {
-            level: "warn",
-        },
-    };
-}
+import { getLocalNetworkIP, loadPulseConfig } from "./utils.js";
 class PreviewClientPlugin {
     projectDirName;
     pulseConfig;
@@ -173,6 +50,8 @@ class PreviewClientPlugin {
             else {
                 console.log("[client-preview] ✅ Reload finished");
             }
+            // Write pulse config to dist
+            fs.writeFileSync(path.resolve(this.projectDirName, "dist/pulse.config.json"), JSON.stringify(this.pulseConfig, null, 2));
         });
     }
 }

package/dist/lib/webpack/configs/utils.d.ts

@@ -17,5 +17,5 @@ export declare function normalizeJSDocPropertyName(name: string | undefined): st
 export declare function isPromiseLikeType(type: import("ts-morph").Type): boolean;
 export declare function unwrapPromiseLikeType(type: import("ts-morph").Type): import("ts-morph").Type<import("ts-morph").ts.Type>;
 export declare function getActionType(text: string): TypedVariableType;
-export declare function compileAppActionSkills(pulseConfig: any): void;
+export declare function compileAppActionSkills(pulseConfig: any): any;
 export declare function generateTempTsConfig(): void;

package/dist/lib/webpack/configs/utils.js

@@ -225,6 +225,8 @@ export function compileAppActionSkills(pulseConfig) {
             if (declaration.getKind() !== SyntaxKind.FunctionDeclaration)
                 return;
             const funcDecl = declaration.asKindOrThrow(SyntaxKind.FunctionDeclaration);
+            // Get action name from path `src/skill/{actionName}/action.ts`
+            // Match `*/src/skill/{actionName}/action.ts` and extract {actionName}
             const pattern = /src\/skill\/([^\/]+)\/action\.ts$/;
             const match = file.replaceAll("\\", "/").match(pattern);
             if (!match) {
@@ -300,9 +302,11 @@ export function compileAppActionSkills(pulseConfig) {
                     params[name] = variable;
                 });
             }
+            /* Extract return type from JSDoc */
             const rawReturnType = funcDecl.getReturnType();
             const isPromiseLikeReturn = isPromiseLikeType(rawReturnType);
             const returnType = unwrapPromiseLikeType(rawReturnType);
+            // Check if the return type is an object
             if (!returnType.isObject()) {
                 console.warn(`[Action Registration] Function ${actionName}'s return type should be an object. Skipping...`);
                 return;
@@ -311,13 +315,17 @@ export function compileAppActionSkills(pulseConfig) {
             const returnProperties = returnType.getProperties();
             const outputTypeDef = typeDefs["output"] ?? {};
             const hasOutputTypeDef = !!typeDefs["output"];
-            if (returnProperties.length > 0 && !hasOutputTypeDef && !isPromiseLikeReturn) {
+            if (returnProperties.length > 0 &&
+                !hasOutputTypeDef &&
+                !isPromiseLikeReturn) {
                 throw new Error(`[Action Validation] Action "${actionName}" in ${file} returns properties but is missing an ` +
                     `"@typedef {Output}" JSDoc block. Please document all return values with ` +
                     `@typedef {Output} and @property tags.` +
                     `Run \`pulse skill fix ${actionName}\` to automatically add a JSDoc template for this action.`);
             }
-            if (returnProperties.length > 0 && !hasOutputTypeDef && isPromiseLikeReturn) {
+            if (returnProperties.length > 0 &&
+                !hasOutputTypeDef &&
+                isPromiseLikeReturn) {
                 console.warn(`[Action Validation] Action "${actionName}" in ${file} is missing an "@typedef {Object} output" JSDoc block. ` +
                     `Falling back to TypeScript-inferred return metadata because the action returns a Promise.`);
             }
@@ -361,6 +369,7 @@ export function compileAppActionSkills(pulseConfig) {
         });
     });
     pulseConfig.actions = actions;
+    return pulseConfig;
 }
 // Generate tsconfig for server functions
 export function generateTempTsConfig() {

package/dist/lib/webpack/webpack-config.js

@@ -1,12 +1,12 @@
 /* eslint-disable @typescript-eslint/no-explicit-any */
 import { makeMFClientConfig } from "./configs/mf-client.js";
 import { makeMFServerConfig } from "./configs/mf-server.js";
-import { makeMFPreviewConfig, makePreviewClientConfig } from "./configs/preview.js";
+import { makePreviewClientConfig } from "./configs/preview.js";
 export async function createWebpackConfig(isPreview, buildTarget, mode) {
     if (isPreview) {
         const previewClientConfig = await makePreviewClientConfig("development");
-        const mfPreviewConfig = await makeMFPreviewConfig();
-        return [previewClientConfig, mfPreviewConfig];
+        const mfServerConfig = await makeMFServerConfig("development");
+        return [previewClientConfig, mfServerConfig];
     }
     else if (buildTarget === "server") {
         const mfServerConfig = await makeMFServerConfig(mode);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pulse-editor/cli",
-	"version": "0.1.5",
+	"version": "0.1.6",
 	"license": "MIT",
 	"bin": {
 		"pulse": "dist/cli.js"
@@ -13,7 +13,8 @@
 		"build": "tsx build.ts",
 		"dev": "tsx watch --include \"./src/**/*\" build.ts",
 		"test": "prettier --check . && xo && ava",
-		"link": "npm link"
+		"link": "npm link",
+		"pack": "npm run build && npm pack --pack-destination dist"
 	},
 	"files": [
 		"dist"