@fireberry/cli 0.0.5-beta.19 → 0.0.5-beta.21

package/dist/api/requests.d.ts

@@ -1,6 +1,8 @@
 import "../config/env.js";
-import type { CreateAppRequest, Manifest, ZippedComponent } from "./types.js";
-export declare const createApp: (data: CreateAppRequest) => Promise<void>;
+import type { Manifest, ZippedComponent } from "./types.js";
+export declare const createApp: (manifest: Manifest) => Promise<void>;
 export declare const pushComponents: (appId: string, components: ZippedComponent[], manifest: Manifest) => Promise<void>;
 export declare const installApp: (manifest: Manifest) => Promise<void>;
 export declare const deleteApp: (manifest: Manifest) => Promise<void>;
+export declare const startDebug: (appId: string, componentId: string, debugUrl: string, manifest: Manifest) => Promise<void>;
+export declare const stopDebug: (appId: string, componentId: string, manifest: Manifest) => Promise<void>;

package/dist/api/requests.js

@@ -1,16 +1,17 @@
 import "../config/env.js";
+import { BASE_SERVICE_URL } from "../constants/component-types.js";
 import { api } from "./axios.js";
-export const createApp = async (data) => {
-    const url = "/services/developer/create";
+export const createApp = async (manifest) => {
+    const url = `${BASE_SERVICE_URL}/create`;
     try {
-        await api.post(url, data);
+        await api.post(url, { manifest });
     }
     catch (error) {
         throw new Error(error instanceof Error ? error.message : "Unknown error");
     }
 };
 export const pushComponents = async (appId, components, manifest) => {
-    const url = `/services/developer/push`;
+    const url = `${BASE_SERVICE_URL}/push`;
     try {
         await api.post(url, { appId, components, manifest });
     }
@@ -19,7 +20,7 @@ export const pushComponents = async (appId, components, manifest) => {
     }
 };
 export const installApp = async (manifest) => {
-    const url = `/services/developer/install`;
+    const url = `${BASE_SERVICE_URL}/install`;
     try {
         await api.post(url, { manifest }, { timeout: 300000 }); // 5 minutes
     }
@@ -28,7 +29,7 @@ export const installApp = async (manifest) => {
     }
 };
 export const deleteApp = async (manifest) => {
-    const url = `/services/developer/delete`;
+    const url = `${BASE_SERVICE_URL}/delete`;
     try {
         await api.delete(url, { manifest });
     }
@@ -36,3 +37,21 @@ export const deleteApp = async (manifest) => {
         throw new Error(error instanceof Error ? error.message : "Unknown error");
     }
 };
+export const startDebug = async (appId, componentId, debugUrl, manifest) => {
+    const url = `${BASE_SERVICE_URL}/debug`;
+    try {
+        await api.post(url, { appId, componentId, debugUrl, manifest });
+    }
+    catch (error) {
+        throw new Error(error instanceof Error ? error.message : "Unknown error");
+    }
+};
+export const stopDebug = async (appId, componentId, manifest) => {
+    const url = `${BASE_SERVICE_URL}/debug`;
+    try {
+        await api.delete(url, { appId, componentId, manifest });
+    }
+    catch (error) {
+        throw new Error(error instanceof Error ? error.message : "Unknown error");
+    }
+};

package/dist/api/types.d.ts

@@ -1,4 +1,5 @@
 import { COMPONENT_TYPE } from "../constants/component-types.js";
+import { HeightOption } from "../constants/height-options.js";
 export interface CreateAppRequest {
     appId: string;
     componentId: string;
@@ -22,6 +23,7 @@ export interface RecordComponentSettings {
     iconName: string;
     iconColor: string;
     objectType: number;
+    height: HeightOption;
 }
 export interface GlobalMenuComponentSettings {
     displayName: string;

package/dist/bin/fireberry.js

@@ -7,6 +7,7 @@ import packageJson from "../../package.json" with { type: "json" };
 import { runPush } from "../commands/push.js";
 import { runInstall } from "../commands/install.js";
 import { runDelete } from "../commands/delete.js";
+import { runDebug } from "../commands/debug.js";
 const program = new Command();
 program
     .name("fireberry")
@@ -44,6 +45,15 @@ program
     .action(async () => {
     await runDelete();
 });
+program
+    .command("debug")
+    .argument("<component-id>", "Component ID to debug")
+    .argument("[url]", "Debug URL in format localhost:[port]")
+    .option("--stop", "Stop debugging the component")
+    .description("Start or stop debugging a component")
+    .action(async (componentId, url, options) => {
+    await runDebug(componentId, url, options);
+});
 program.parseAsync(process.argv).catch((err) => {
     const errorMessage = err instanceof Error
         ? err.message

package/dist/commands/create.js

@@ -6,6 +6,7 @@ import { fileURLToPath } from "node:url";
 import ora from "ora";
 import chalk from "chalk";
 import { createApp } from "../api/requests.js";
+import { getManifest } from "../utils/components.utils.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 function slugifyName(name) {
@@ -35,7 +36,6 @@ export async function runCreate({ name }) {
     }
     const spinner = ora(`Creating app "${chalk.cyan(appName)}"...`).start();
     try {
-        await createApp({ appId, componentId });
         await fs.ensureDir(appDir);
         const templatesDir = path.join(__dirname, "..", "..", "src", "templates");
         const manifestTemplate = await fs.readFile(path.join(templatesDir, "manifest.yml"), "utf-8");
@@ -47,6 +47,8 @@ export async function runCreate({ name }) {
         const htmlContent = htmlTemplate.replace(/{{appName}}/g, appName);
         await fs.writeFile(path.join(appDir, "manifest.yml"), manifestContent);
         await fs.writeFile(path.join(appDir, "index.html"), htmlContent);
+        const manifest = await getManifest(appDir);
+        await createApp(manifest);
         spinner.succeed(`Successfully created "${chalk.cyan(appName)}" app!`);
         console.log(chalk.gray(`📁 Location: ${appDir}`));
         console.log(chalk.gray(`App ID: ${appId}`));

package/dist/commands/debug.d.ts

@@ -0,0 +1,3 @@
+export declare function runDebug(componentId: string, url?: string, options?: {
+    stop?: boolean;
+}): Promise<void>;

package/dist/commands/debug.js

@@ -0,0 +1,54 @@
+import ora from "ora";
+import chalk from "chalk";
+import { startDebug, stopDebug } from "../api/requests.js";
+import { getManifest } from "../utils/components.utils.js";
+function validateDebugUrl(url) {
+    const localhostPattern = /^localhost:\d+$/;
+    if (!localhostPattern.test(url)) {
+        throw new Error("Invalid URL format. URL must be in format: localhost:[port] (e.g., localhost:3000)\n" +
+            "Do not include http:// or https://");
+    }
+}
+function validateComponentExists(manifest, componentId) {
+    const component = manifest.components?.find((comp) => comp.id === componentId);
+    if (!component) {
+        throw new Error(`Component with ID "${componentId}" not found in manifest.\n` +
+            `Available components:\n` +
+            manifest.components
+                ?.map((comp) => `  - ${comp.title} (${comp.id})`)
+                .join("\n"));
+    }
+}
+export async function runDebug(componentId, url, options) {
+    const spinner = ora("Loading manifest...").start();
+    try {
+        const manifest = await getManifest();
+        spinner.succeed("Manifest loaded");
+        // Validate component exists
+        validateComponentExists(manifest, componentId);
+        if (options?.stop) {
+            // Stop debugging
+            spinner.start("Stopping debug mode...");
+            await stopDebug(manifest.app.id, componentId, manifest);
+            spinner.succeed(chalk.green(`Debug mode stopped for component: ${componentId}`));
+        }
+        else {
+            // Start debugging
+            if (!url) {
+                throw new Error("URL is required when starting debug mode.\n" +
+                    `Usage: fireberry debug ${componentId} localhost:[port]`);
+            }
+            validateDebugUrl(url);
+            spinner.start(`Starting debug mode for component ${componentId}...`);
+            await startDebug(manifest.app.id, componentId, url, manifest);
+            spinner.succeed(chalk.green(`Debug mode started!\n` +
+                `  Component: ${componentId}\n` +
+                `  URL: ${url}\n\n` +
+                `To stop debugging, run: ${chalk.cyan(`fireberry debug ${componentId} --stop`)}`));
+        }
+    }
+    catch (error) {
+        spinner.fail(options?.stop ? "Failed to stop debug mode" : "Failed to start debug mode");
+        throw error;
+    }
+}

package/dist/constants/component-types.d.ts

@@ -4,3 +4,4 @@ export declare const COMPONENT_TYPE: {
     readonly SIDE_MENU: "side-menu";
 };
 export type ComponentType = (typeof COMPONENT_TYPE)[keyof typeof COMPONENT_TYPE];
+export declare const BASE_SERVICE_URL = "/services/developer/app";

package/dist/constants/component-types.js

@@ -3,3 +3,4 @@ export const COMPONENT_TYPE = {
     GLOBAL_MENU: "global-menu",
     SIDE_MENU: "side-menu",
 };
+export const BASE_SERVICE_URL = "/services/developer/app";

package/dist/constants/height-options.d.ts

@@ -0,0 +1,2 @@
+export declare const HEIGHT_OPTIONS: readonly ["S", "M", "L", "XL"];
+export type HeightOption = (typeof HEIGHT_OPTIONS)[number];

package/dist/constants/height-options.js

@@ -0,0 +1 @@
+export const HEIGHT_OPTIONS = ["S", "M", "L", "XL"];

package/dist/utils/components.utils.d.ts

@@ -1,5 +1,5 @@
 import { Manifest, ZippedComponent, UntypedManifestComponent } from "../api/types.js";
-export declare const getManifest: () => Promise<Manifest>;
+export declare const getManifest: (basePath?: string) => Promise<Manifest>;
 export declare const validateComponentBuild: (componentPath: string, comp: UntypedManifestComponent) => Promise<void>;
 export declare const zipComponentBuild: (componentPath: string, title: string) => Promise<Buffer>;
 export declare const validateManifestComponents: (manifest: Manifest) => Promise<void>;

package/dist/utils/components.utils.js

@@ -5,10 +5,12 @@ import chalk from "chalk";
 import * as tar from "tar";
 import os from "node:os";
 import { COMPONENT_TYPE } from "../constants/component-types.js";
-export const getManifest = async () => {
-    const manifestPath = path.join(process.cwd(), "manifest.yml");
+import { HEIGHT_OPTIONS } from "../constants/height-options.js";
+export const getManifest = async (basePath) => {
+    const manifestPath = path.join(basePath || process.cwd(), "manifest.yml");
+    const searchDir = basePath || process.cwd();
     if (!(await fs.pathExists(manifestPath))) {
-        throw new Error(`No manifest.yml found at ${chalk.yellow(process.cwd())}.\n` +
+        throw new Error(`No manifest.yml found at ${chalk.yellow(searchDir)}.\n` +
             `Please run this command from your Fireberry app directory.`);
     }
     const manifestContent = await fs.readFile(manifestPath, "utf-8");
@@ -30,6 +32,7 @@ const validateRecordComponentSettings = (comp) => {
         "iconName",
         "iconColor",
         "objectType",
+        "height",
     ];
     for (const fieldName of requiredFields) {
         if (settings[fieldName] === undefined || settings[fieldName] === null) {
@@ -45,6 +48,12 @@ const validateRecordComponentSettings = (comp) => {
     if (typeof settings.objectType !== "number") {
         throw new Error(`Component "${comp.title}" (type: ${COMPONENT_TYPE.RECORD}) setting "objectType" must be a number`);
     }
+    if (!settings.height) {
+        throw new Error(`Component "${comp.title}" (type: ${COMPONENT_TYPE.RECORD}) setting "height" must be one of: ${HEIGHT_OPTIONS.join(" | ")}`);
+    }
+    if (!HEIGHT_OPTIONS.includes(settings.height)) {
+        throw new Error(`Component "${comp.title}" (type: ${COMPONENT_TYPE.RECORD}) setting "height" must be one of: ${HEIGHT_OPTIONS.join(" | ")}`);
+    }
 };
 const validateGlobalMenuComponentSettings = (comp) => {
     const settings = comp.settings;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fireberry/cli",
-  "version": "0.0.5-beta.19",
+  "version": "0.0.5-beta.21",
   "description": "Fireberry CLI tool",
   "type": "module",
   "author": "",

package/src/api/requests.ts

@@ -1,11 +1,12 @@
 import "../config/env.js";
+import { BASE_SERVICE_URL } from "../constants/component-types.js";
 import { api } from "./axios.js";
-import type { CreateAppRequest, Manifest, ZippedComponent } from "./types.js";
+import type { Manifest, ZippedComponent } from "./types.js";
 
-export const createApp = async (data: CreateAppRequest): Promise<void> => {
-  const url = "/services/developer/create";
+export const createApp = async (manifest: Manifest): Promise<void> => {
+  const url = `${BASE_SERVICE_URL}/create`;
   try {
-    await api.post<void>(url, data);
+    await api.post<void>(url, { manifest });
   } catch (error) {
     throw new Error(error instanceof Error ? error.message : "Unknown error");
   }
@@ -16,7 +17,7 @@ export const pushComponents = async (
   components: ZippedComponent[],
   manifest: Manifest
 ): Promise<void> => {
-  const url = `/services/developer/push`;
+  const url = `${BASE_SERVICE_URL}/push`;
   try {
     await api.post<void>(url, { appId, components, manifest });
   } catch (error) {
@@ -25,7 +26,7 @@ export const pushComponents = async (
 };
 
 export const installApp = async (manifest: Manifest): Promise<void> => {
-  const url = `/services/developer/install`;
+  const url = `${BASE_SERVICE_URL}/install`;
   try {
     await api.post<void>(url, { manifest }, { timeout: 300000 }); // 5 minutes
   } catch (error) {
@@ -34,10 +35,37 @@ export const installApp = async (manifest: Manifest): Promise<void> => {
 };
 
 export const deleteApp = async (manifest: Manifest): Promise<void> => {
-  const url = `/services/developer/delete`;
+  const url = `${BASE_SERVICE_URL}/delete`;
   try {
     await api.delete<void>(url, { manifest });
   } catch (error) {
     throw new Error(error instanceof Error ? error.message : "Unknown error");
   }
 };
+
+export const startDebug = async (
+  appId: string,
+  componentId: string,
+  debugUrl: string,
+  manifest: Manifest
+): Promise<void> => {
+  const url = `${BASE_SERVICE_URL}/debug`;
+  try {
+    await api.post<void>(url, { appId, componentId, debugUrl, manifest });
+  } catch (error) {
+    throw new Error(error instanceof Error ? error.message : "Unknown error");
+  }
+};
+
+export const stopDebug = async (
+  appId: string,
+  componentId: string,
+  manifest: Manifest
+): Promise<void> => {
+  const url = `${BASE_SERVICE_URL}/debug`;
+  try {
+    await api.delete<void>(url, { appId, componentId, manifest });
+  } catch (error) {
+    throw new Error(error instanceof Error ? error.message : "Unknown error");
+  }
+};

package/src/api/types.ts

@@ -1,4 +1,5 @@
 import { COMPONENT_TYPE } from "../constants/component-types.js";
+import { HeightOption } from "../constants/height-options.js";
 
 export interface CreateAppRequest {
   appId: string;
@@ -27,6 +28,7 @@ export interface RecordComponentSettings {
   iconName: string;
   iconColor: string;
   objectType: number;
+  height: HeightOption;
 }
 
 export interface GlobalMenuComponentSettings {

package/src/bin/fireberry.ts

@@ -7,6 +7,7 @@ import packageJson from "../../package.json" with { type: "json" };
 import { runPush } from "../commands/push.js";
 import { runInstall } from "../commands/install.js";
 import { runDelete } from "../commands/delete.js";
+import { runDebug } from "../commands/debug.js";
 
 const program = new Command();
 
@@ -52,6 +53,16 @@ program
     await runDelete();
   });
 
+program
+  .command("debug")
+  .argument("<component-id>", "Component ID to debug")
+  .argument("[url]", "Debug URL in format localhost:[port]")
+  .option("--stop", "Stop debugging the component")
+  .description("Start or stop debugging a component")
+  .action(async (componentId: string, url?: string, options?: { stop?: boolean }) => {
+    await runDebug(componentId, url, options);
+  });
+
 program.parseAsync(process.argv).catch((err: unknown) => {
   const errorMessage = err instanceof Error 
     ? err.message

package/src/commands/create.ts

@@ -6,6 +6,7 @@ import { fileURLToPath } from "node:url";
 import ora from "ora";
 import chalk from "chalk";
 import { createApp } from "../api/requests.js";
+import { getManifest } from "../utils/components.utils.js";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -50,8 +51,6 @@ export async function runCreate({ name }: CreateOptions): Promise<void> {
   const spinner = ora(`Creating app "${chalk.cyan(appName)}"...`).start();
 
   try {
-    await createApp({ appId, componentId });
-
     await fs.ensureDir(appDir);
 
     const templatesDir = path.join(__dirname, "..", "..", "src", "templates");
@@ -73,6 +72,9 @@ export async function runCreate({ name }: CreateOptions): Promise<void> {
 
     await fs.writeFile(path.join(appDir, "manifest.yml"), manifestContent);
     await fs.writeFile(path.join(appDir, "index.html"), htmlContent);
+    const manifest = await getManifest(appDir);
+
+    await createApp(manifest);
 
     spinner.succeed(`Successfully created "${chalk.cyan(appName)}" app!`);
     console.log(chalk.gray(`📁 Location: ${appDir}`));

package/src/commands/debug.ts

@@ -0,0 +1,84 @@
+import ora from "ora";
+import chalk from "chalk";
+import { startDebug, stopDebug } from "../api/requests.js";
+import { getManifest } from "../utils/components.utils.js";
+
+function validateDebugUrl(url: string): void {
+  const localhostPattern = /^localhost:\d+$/;
+
+  if (!localhostPattern.test(url)) {
+    throw new Error(
+      "Invalid URL format. URL must be in format: localhost:[port] (e.g., localhost:3000)\n" +
+        "Do not include http:// or https://"
+    );
+  }
+}
+
+function validateComponentExists(manifest: any, componentId: string): void {
+  const component = manifest.components?.find(
+    (comp: any) => comp.id === componentId
+  );
+
+  if (!component) {
+    throw new Error(
+      `Component with ID "${componentId}" not found in manifest.\n` +
+        `Available components:\n` +
+        manifest.components
+          ?.map((comp: any) => `  - ${comp.title} (${comp.id})`)
+          .join("\n")
+    );
+  }
+}
+
+export async function runDebug(
+  componentId: string,
+  url?: string,
+  options?: { stop?: boolean }
+): Promise<void> {
+  const spinner = ora("Loading manifest...").start();
+
+  try {
+    const manifest = await getManifest();
+    spinner.succeed("Manifest loaded");
+
+    // Validate component exists
+    validateComponentExists(manifest, componentId);
+
+    if (options?.stop) {
+      // Stop debugging
+      spinner.start("Stopping debug mode...");
+      await stopDebug(manifest.app.id, componentId, manifest);
+      spinner.succeed(
+        chalk.green(`Debug mode stopped for component: ${componentId}`)
+      );
+    } else {
+      // Start debugging
+      if (!url) {
+        throw new Error(
+          "URL is required when starting debug mode.\n" +
+            `Usage: fireberry debug ${componentId} localhost:[port]`
+        );
+      }
+
+      validateDebugUrl(url);
+
+      spinner.start(`Starting debug mode for component ${componentId}...`);
+      await startDebug(manifest.app.id, componentId, url, manifest);
+      spinner.succeed(
+        chalk.green(
+          `Debug mode started!\n` +
+            `  Component: ${componentId}\n` +
+            `  URL: ${url}\n\n` +
+            `To stop debugging, run: ${chalk.cyan(
+              `fireberry debug ${componentId} --stop`
+            )}`
+        )
+      );
+    }
+  } catch (error) {
+    spinner.fail(
+      options?.stop ? "Failed to stop debug mode" : "Failed to start debug mode"
+    );
+    throw error;
+  }
+}

package/src/constants/component-types.ts

@@ -6,3 +6,5 @@ export const COMPONENT_TYPE = {
 
 export type ComponentType =
   (typeof COMPONENT_TYPE)[keyof typeof COMPONENT_TYPE];
+
+export const BASE_SERVICE_URL = "/services/developer/app";

package/src/constants/height-options.ts

@@ -0,0 +1,3 @@
+export const HEIGHT_OPTIONS = ["S", "M", "L", "XL"] as const;
+
+export type HeightOption = (typeof HEIGHT_OPTIONS)[number];

package/src/templates/manifest.yml

@@ -11,3 +11,4 @@ components:
       iconName: "related-single"
       iconColor: "#7aae7f"
       objectType: 0
+      height: "M"

package/src/utils/components.utils.ts

@@ -13,13 +13,15 @@ import {
   SideMenuComponentSettings,
 } from "../api/types.js";
 import { COMPONENT_TYPE } from "../constants/component-types.js";
+import { HEIGHT_OPTIONS } from "../constants/height-options.js";
 
-export const getManifest = async (): Promise<Manifest> => {
-  const manifestPath = path.join(process.cwd(), "manifest.yml");
+export const getManifest = async (basePath?: string): Promise<Manifest> => {
+  const manifestPath = path.join(basePath || process.cwd(), "manifest.yml");
+  const searchDir = basePath || process.cwd();
 
   if (!(await fs.pathExists(manifestPath))) {
     throw new Error(
-      `No manifest.yml found at ${chalk.yellow(process.cwd())}.\n` +
+      `No manifest.yml found at ${chalk.yellow(searchDir)}.\n` +
         `Please run this command from your Fireberry app directory.`
     );
   }
@@ -58,6 +60,7 @@ const validateRecordComponentSettings = (
     "iconName",
     "iconColor",
     "objectType",
+    "height",
   ];
 
   for (const fieldName of requiredFields) {
@@ -85,6 +88,17 @@ const validateRecordComponentSettings = (
       `Component "${comp.title}" (type: ${COMPONENT_TYPE.RECORD}) setting "objectType" must be a number`
     );
   }
+  if (!settings.height) {
+    throw new Error(
+      `Component "${comp.title}" (type: ${COMPONENT_TYPE.RECORD}) setting "height" must be one of: ${HEIGHT_OPTIONS.join(" | ")}`
+    );
+  }
+
+  if (!HEIGHT_OPTIONS.includes(settings.height as any)) {
+    throw new Error(
+      `Component "${comp.title}" (type: ${COMPONENT_TYPE.RECORD}) setting "height" must be one of: ${HEIGHT_OPTIONS.join(" | ")}`
+    );
+  }
 };
 
 const validateGlobalMenuComponentSettings = (