@fireberry/cli 0.0.5-beta.0 → 0.0.5-beta.12

package/.github/workflows/main.yml

@@ -15,6 +15,7 @@ on:
         required: false
         type: choice
         options:
+          - prerelease
           - patch
           - minor
           - major
@@ -26,6 +27,9 @@ jobs:
     permissions:
       contents: read
       id-token: write
+    environment:
+      name: npm
+      url: https://www.npmjs.com/package/@fireberry/cli/v/${{ github.event.inputs.version }}
 
     steps:
       - name: Checkout repository
@@ -44,7 +48,13 @@ jobs:
 
       - name: Update version (Beta)
         if: github.event.inputs.type == 'beta'
-        run: npm version prerelease --preid=beta --no-git-tag-version
+        run: |
+          CURRENT_VERSION=$(node -p "require('./package.json').version")
+          if [[ $CURRENT_VERSION == *"-beta."* ]]; then
+            npm version prerelease --preid=beta --no-git-tag-version
+          else
+            npm version prepatch --preid=beta --no-git-tag-version
+          fi
 
       - name: Update version (Production)
         if: github.event.inputs.type == 'production'
@@ -56,14 +66,13 @@ jobs:
       - name: Run tests
         run: npm test
 
+      - name: Update npm to latest version
+        run: npm install -g npm@latest
+
       - name: Publish to npm (Beta)
         if: github.event.inputs.type == 'beta'
         run: npm publish --tag beta --provenance --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
       - name: Publish to npm (Production)
         if: github.event.inputs.type == 'production'
         run: npm publish --tag latest --provenance --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Fireberry LTD
+
+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/dist/api/axios.js

@@ -2,7 +2,6 @@ import "../config/env.js";
 import axios from "axios";
 import { getApiToken } from "./config.js";
 import packageJson from "../../package.json" with { type: "json" };
-// Determine default API URL based on version
 const getDefaultApiUrl = () => {
     if (process.env.FIREBERRY_API_URL) {
         return process.env.FIREBERRY_API_URL;
@@ -26,7 +25,7 @@ fbApi.interceptors.request.use(async (config) => {
     try {
         const token = await getApiToken();
         if (token) {
-            config.headers.tokenid = token;
+            config.headers.tokenId = token;
         }
     }
     catch (error) {
@@ -43,9 +42,20 @@ export async function sendApiRequest(config) {
     }
     catch (error) {
         if (axios.isAxiosError(error)) {
-            const message = error.response?.data?.message || error.message;
             const status = error.response?.status;
-            throw new Error(`API Error${status ? ` (${status})` : ""}: ${message}`);
+            let errorMessage;
+            switch (status) {
+                case 401:
+                    console.log(error.response?.data?.message || error.message); // TODO: remove this
+                    errorMessage = "Unauthorized user.";
+                    break;
+                case 500:
+                    errorMessage = "Internal server error.";
+                    break;
+                default:
+                    errorMessage = error.response?.data?.message || error.message;
+            }
+            throw new Error(`Error: ${errorMessage}`);
         }
         throw error;
     }

package/dist/api/requests.d.ts

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

package/dist/api/requests.js

@@ -9,3 +9,21 @@ export const createApp = async (data) => {
         throw new Error(error instanceof Error ? error.message : "Unknown error");
     }
 };
+export const pushComponents = async (appId, components) => {
+    const url = `/services/developer/push`;
+    try {
+        await api.post(url, { appId, components });
+    }
+    catch (error) {
+        throw new Error(error instanceof Error ? error.message : "Unknown error");
+    }
+};
+export const installApp = async (manifest) => {
+    const url = `/services/developer/install`;
+    try {
+        await api.post(url, { manifest });
+    }
+    catch (error) {
+        throw new Error(error instanceof Error ? error.message : "Unknown error");
+    }
+};

package/dist/api/types.d.ts

@@ -11,3 +11,25 @@ export interface ApiResponse<T> {
     success: boolean;
     message?: string;
 }
+interface ManifestApp {
+    id: string;
+    name: string;
+    description?: string;
+}
+export interface ManifestComponent {
+    type: string;
+    title: string;
+    key: string;
+    path: string;
+    settings?: Record<string, unknown>;
+}
+export interface Manifest {
+    app: ManifestApp;
+    components?: ManifestComponent[];
+}
+export interface ZippedComponent {
+    title: string;
+    key: string;
+    build: Buffer;
+}
+export {};

package/dist/bin/fireberry.js

@@ -4,6 +4,8 @@ import chalk from "chalk";
 import { runInit } from "../commands/init.js";
 import { runCreate } from "../commands/create.js";
 import packageJson from "../../package.json" with { type: "json" };
+import { runPush } from "../commands/push.js";
+import { runInstall } from "../commands/install.js";
 const program = new Command();
 program
     .name("fireberry")
@@ -18,17 +20,30 @@ program
 });
 program
     .command("create")
-    .argument("[name]", "App name")
+    .argument("[name...]", "App name")
     .description("Create a new Fireberry app")
-    .action(async (name) => {
+    .action(async (nameArgs) => {
+    const name = nameArgs ? nameArgs.join("-") : undefined;
     await runCreate({ name });
 });
+program
+    .command("push")
+    .description("Push app to Fireberry")
+    .action(async () => {
+    await runPush();
+});
+program.command("install")
+    .description("Install app on your Fireberry account")
+    .action(async () => {
+    await runInstall();
+});
 program.parseAsync(process.argv).catch((err) => {
     const errorMessage = err instanceof Error
         ? err.message
         : typeof err === 'string'
             ? err
             : 'Unexpected error';
-    console.error(chalk.red(errorMessage));
+    const formattedError = errorMessage.startsWith('Error:') ? errorMessage : `Error: ${errorMessage}`;
+    console.error(chalk.red(formattedError));
     process.exit(1);
 });

package/dist/commands/create.js

@@ -13,11 +13,7 @@ function slugifyName(name) {
     if (!validPattern.test(name)) {
         throw new Error(`Invalid app name: "${name}". Only alphanumeric characters, underscores, and hyphens are allowed.`);
     }
-    return name
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/-+/g, "-")
-        .replace(/^-|-$/g, "");
+    return name;
 }
 export async function runCreate({ name }) {
     let appName = name;
@@ -28,13 +24,13 @@ export async function runCreate({ name }) {
         appName = (answers.name || "").trim();
     }
     if (!appName) {
-        throw new Error("App name is required.");
+        throw new Error("Missing name.");
     }
     const slug = slugifyName(appName);
     const appId = uuidv4();
     const appDir = path.resolve(process.cwd(), slug);
     if (await fs.pathExists(appDir)) {
-        throw new Error(`Directory already exists: ${chalk.yellow(appDir)}`);
+        throw new Error(`Already exists. ${chalk.yellow(slug)}`);
     }
     const spinner = ora(`Creating app "${chalk.cyan(appName)}"...`).start();
     try {
@@ -45,7 +41,7 @@ export async function runCreate({ name }) {
         const htmlTemplate = await fs.readFile(path.join(templatesDir, "index.html"), "utf-8");
         const manifestContent = manifestTemplate
             .replace(/{{appName}}/g, appName)
-            .replace(/{ { appId } }/g, appId);
+            .replace(/{{appId}}/g, appId);
         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);

package/dist/commands/init.js

@@ -5,7 +5,7 @@ import fs from "fs-extra";
 import ora from "ora";
 import chalk from "chalk";
 export async function runInit({ tokenid } = {}) {
-    let token = tokenid;
+    let token = tokenid?.trim();
     if (!token) {
         const answers = await inquirer.prompt([
             {

package/dist/commands/install.d.ts

@@ -0,0 +1 @@
+export declare function runInstall(): Promise<void>;

package/dist/commands/install.js

@@ -0,0 +1,8 @@
+import { installApp } from "../api/requests.js";
+import { getManifest, validateManifestComponents, } from "../utils/components.utils.js";
+export async function runInstall() {
+    const manifest = await getManifest();
+    await validateManifestComponents(manifest);
+    await installApp(manifest);
+    console.log("App installed successfully");
+}

package/dist/commands/push.d.ts

@@ -0,0 +1 @@
+export declare function runPush(): Promise<void>;

package/dist/commands/push.js

@@ -0,0 +1,32 @@
+import ora from "ora";
+import chalk from "chalk";
+import { getManifest, handleComponents } from "../utils/components.utils.js";
+import { pushComponents } from "../api/requests.js";
+export async function runPush() {
+    const spinner = ora("Checking manifest...").start();
+    try {
+        const manifest = await getManifest();
+        spinner.succeed("Manifest loaded successfully");
+        spinner.start("Validating and zipping components...");
+        const zippedComponents = await handleComponents(manifest);
+        const count = zippedComponents.length;
+        if (count > 0) {
+            spinner.succeed(`${count} component${count > 1 ? "s" : ""} validated and zipped`);
+            console.log(chalk.cyan("\nComponents ready to push:"));
+            zippedComponents.forEach((comp, idx) => {
+                const sizeKB = (comp.build.length / 1024).toFixed(2);
+                console.log(chalk.gray(`  ${idx + 1}. ${comp.title} (${comp.key}) - ${sizeKB} KB`));
+            });
+            spinner.start("Uploading to Fireberry...");
+            await pushComponents(manifest.app.id, zippedComponents);
+            spinner.succeed("Components pushed successfully");
+        }
+        else {
+            spinner.succeed("No components to push");
+        }
+    }
+    catch (error) {
+        spinner.fail("Push failed");
+        throw error;
+    }
+}

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

@@ -0,0 +1,6 @@
+import { Manifest, ManifestComponent, ZippedComponent } from "../api/types.js";
+export declare const getManifest: () => Promise<Manifest>;
+export declare const validateComponentBuild: (componentPath: string, comp: ManifestComponent) => Promise<void>;
+export declare const zipComponentBuild: (componentPath: string, title: string) => Promise<Buffer>;
+export declare const validateManifestComponents: (manifest: Manifest) => Promise<void>;
+export declare const handleComponents: (manifest: Manifest) => Promise<ZippedComponent[]>;

package/dist/utils/components.utils.js

@@ -0,0 +1,95 @@
+import path from "node:path";
+import fs from "fs-extra";
+import yaml from "js-yaml";
+import chalk from "chalk";
+import * as tar from "tar";
+import os from "node:os";
+export const getManifest = async () => {
+    const manifestPath = path.join(process.cwd(), "manifest.yml");
+    if (!(await fs.pathExists(manifestPath))) {
+        throw new Error(`No manifest.yml found at ${chalk.yellow(process.cwd())}.\n` +
+            `Please run this command from your Fireberry app directory.`);
+    }
+    const manifestContent = await fs.readFile(manifestPath, "utf-8");
+    const manifest = yaml.load(manifestContent);
+    if (!manifest || !manifest.app) {
+        throw new Error("manifest.yml must contain an 'app' section");
+    }
+    if (!manifest.app.id || !manifest.app.name) {
+        throw new Error("manifest.yml app section must contain 'id' and 'name' fields");
+    }
+    return manifest;
+};
+export const validateComponentBuild = async (componentPath, comp) => {
+    if (!(await fs.pathExists(componentPath))) {
+        throw new Error(`Component "${comp.title}" path does not exist: ${chalk.yellow(componentPath)}\n` + `Make sure the path in manifest.yml is correct.`);
+    }
+    const stats = await fs.stat(componentPath);
+    if (stats.isDirectory()) {
+        const files = await fs.readdir(componentPath);
+        if (files.length === 0) {
+            throw new Error(`Component <${comp.key}> at: /${comp.path} not found`);
+        }
+    }
+};
+export const zipComponentBuild = async (componentPath, title) => {
+    const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "fireberry-"));
+    const tarballPath = path.join(tmpDir, `${title}.tar.gz`);
+    try {
+        const stats = await fs.stat(componentPath);
+        if (stats.isDirectory()) {
+            await tar.create({
+                gzip: true,
+                file: tarballPath,
+                cwd: componentPath,
+            }, ["."]);
+        }
+        else {
+            const tempBuildDir = path.join(tmpDir, "build");
+            await fs.ensureDir(tempBuildDir);
+            const fileName = path.basename(componentPath);
+            await fs.copy(componentPath, path.join(tempBuildDir, fileName));
+            await tar.create({
+                gzip: true,
+                file: tarballPath,
+                cwd: tempBuildDir,
+            }, ["."]);
+        }
+        const buffer = await fs.readFile(tarballPath);
+        await fs.remove(tmpDir);
+        return buffer;
+    }
+    catch (error) {
+        await fs.remove(tmpDir);
+        throw error;
+    }
+};
+export const validateManifestComponents = async (manifest) => {
+    const components = manifest.components;
+    if (!components || components.length === 0) {
+        throw new Error("No components found in manifest");
+    }
+    const keys = components.map((comp) => comp.key);
+    if (new Set(keys).size !== keys.length) {
+        throw new Error("All component keys must be unique");
+    }
+    for (const comp of components) {
+        const componentPath = path.join(process.cwd(), comp.path);
+        await validateComponentBuild(componentPath, comp);
+    }
+};
+export const handleComponents = async (manifest) => {
+    await validateManifestComponents(manifest);
+    const components = manifest.components;
+    const zippedComponents = [];
+    for (const comp of components) {
+        const componentPath = path.join(process.cwd(), comp.path);
+        const buildBuffer = await zipComponentBuild(componentPath, comp.title);
+        zippedComponents.push({
+            title: comp.title,
+            key: comp.key,
+            build: buildBuffer,
+        });
+    }
+    return zippedComponents;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fireberry/cli",
-  "version": "0.0.5-beta.0",
+  "version": "0.0.5-beta.12",
   "description": "Fireberry CLI tool",
   "type": "module",
   "author": "",
@@ -14,6 +14,7 @@
   "scripts": {
     "start": "node dist/bin/fireberry.js",
     "build": "tsc",
+    "build:dev": "npm run clean && tsc && npm link && chmod +x dist/bin/fireberry.js",
     "dev": "tsc --watch",
     "clean": "rm -rf dist",
     "prebuild": "npm run clean",
@@ -30,7 +31,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/fireberry-crm/cli"
+    "url": "git+https://github.com/fireberry-crm/cli.git"
   },
   "bugs": {
     "url": "https://github.com/fireberry-crm/cli/issues"
@@ -47,12 +48,15 @@
     "env-paths": "^3.0.0",
     "fs-extra": "^11.2.0",
     "inquirer": "^9.2.12",
+    "js-yaml": "^4.1.0",
     "ora": "^8.0.1",
+    "tar": "^7.5.1",
     "uuid": "^13.0.0"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",
     "@types/inquirer": "^9.0.7",
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.11.24",
     "@types/uuid": "^10.0.0",
     "typescript": "^5.3.3"

package/src/api/axios.ts

@@ -3,7 +3,6 @@ import axios, { AxiosInstance, AxiosRequestConfig } from "axios";
 import { getApiToken } from "./config.js";
 import packageJson from "../../package.json" with { type: "json" };
 
-// Determine default API URL based on version
 const getDefaultApiUrl = () => {
   if (process.env.FIREBERRY_API_URL) {
     return process.env.FIREBERRY_API_URL;
@@ -34,7 +33,7 @@ fbApi.interceptors.request.use(
     try {
       const token = await getApiToken();
       if (token) {
-        config.headers.tokenid = token;
+        config.headers.tokenId = token;
       }
     } catch (error) {
       console.warn("Failed to get API token:", error);
@@ -55,9 +54,22 @@ export async function sendApiRequest<T = any>(
     return response.data;
   } catch (error) {
     if (axios.isAxiosError(error)) {
-      const message = error.response?.data?.message || error.message;
       const status = error.response?.status;
-      throw new Error(`API Error${status ? ` (${status})` : ""}: ${message}`);
+      let errorMessage:string;
+
+      switch (status) {
+        case 401:
+          console.log(error.response?.data?.message || error.message); // TODO: remove this
+          errorMessage = "Unauthorized user.";
+          break;
+        case 500:
+          errorMessage = "Internal server error.";
+          break;
+        default:
+          errorMessage = error.response?.data?.message || error.message;
+      }
+
+      throw new Error(`Error: ${errorMessage}`);
     }
     throw error;
   }

package/src/api/requests.ts

@@ -1,11 +1,32 @@
 import "../config/env.js";
 import { api } from "./axios.js";
-import type { CreateAppRequest } from "./types.js";
+import type { CreateAppRequest, Manifest, ZippedComponent } from "./types.js";
 
 export const createApp = async (data: CreateAppRequest): Promise<void> => {
   const url = "/services/developer/create";
   try {
-    await api.post(url, data);
+    await api.post<void>(url, data);
+  } catch (error) {
+    throw new Error(error instanceof Error ? error.message : "Unknown error");
+  }
+};
+
+export const pushComponents = async (
+  appId: string,
+  components: ZippedComponent[]
+): Promise<void> => {
+  const url = `/services/developer/push`;
+  try {
+    await api.post<void>(url, { appId, components });
+  } catch (error) {
+    throw new Error(error instanceof Error ? error.message : "Unknown error");
+  }
+};
+
+export const installApp = async (manifest: Manifest): Promise<void> => {
+  const url = `/services/developer/install`;
+  try {
+    await api.post<void>(url, { manifest });
   } catch (error) {
     throw new Error(error instanceof Error ? error.message : "Unknown error");
   }

package/src/api/types.ts

@@ -13,3 +13,28 @@ export interface ApiResponse<T> {
   success: boolean;
   message?: string;
 }
+
+interface ManifestApp {
+  id: string;
+  name: string;
+  description?: string;
+}
+
+export interface ManifestComponent {
+  type: string;
+  title: string;
+  key: string;
+  path: string;
+  settings?: Record<string, unknown>;
+}
+
+export interface Manifest {
+  app: ManifestApp;
+  components?: ManifestComponent[];
+}
+
+export interface ZippedComponent {
+  title: string;
+  key: string;
+  build: Buffer;
+}

package/src/bin/fireberry.ts

@@ -4,6 +4,8 @@ import chalk from "chalk";
 import { runInit } from "../commands/init.js";
 import { runCreate } from "../commands/create.js";
 import packageJson from "../../package.json" with { type: "json" };
+import { runPush } from "../commands/push.js";
+import { runInstall } from "../commands/install.js";
 
 const program = new Command();
 
@@ -22,18 +24,34 @@ program
 
 program
   .command("create")
-  .argument("[name]", "App name")
+  .argument("[name...]", "App name")
   .description("Create a new Fireberry app")
-  .action(async (name?: string) => {
-    await runCreate({ name });
+  .action(async (nameArgs?: string[]) => {
+    const name = nameArgs ? nameArgs.join("-") : undefined;
+        await runCreate({ name });
   });
 
+program
+  .command("push")
+  .description("Push app to Fireberry")
+  .action(async () => {
+    await runPush();
+  });
+
+  program.command("install")
+    .description("Install app on your Fireberry account")
+    .action(async () => {
+      await runInstall();
+    });
+
 program.parseAsync(process.argv).catch((err: unknown) => {
   const errorMessage = err instanceof Error 
     ? err.message
     : typeof err === 'string' 
       ? err 
       : 'Unexpected error';
-  console.error(chalk.red(errorMessage));
+  
+  const formattedError = errorMessage.startsWith('Error:') ? errorMessage : `Error: ${errorMessage}`;
+  console.error(chalk.red(formattedError));
   process.exit(1);
 });

package/src/commands/create.ts

@@ -22,15 +22,12 @@ function slugifyName(name: string) {
     );
   }
 
-  return name
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, "-")
-    .replace(/-+/g, "-")
-    .replace(/^-|-$/g, "");
+  return name;
 }
 
 export async function runCreate({ name }: CreateOptions): Promise<void> {
   let appName = name;
+
   if (!appName) {
     const answers = await inquirer.prompt([
       { type: "input", name: "name", message: "App name" },
@@ -38,7 +35,7 @@ export async function runCreate({ name }: CreateOptions): Promise<void> {
     appName = (answers.name || "").trim();
   }
   if (!appName) {
-    throw new Error("App name is required.");
+    throw new Error("Missing name.");
   }
 
   const slug = slugifyName(appName);
@@ -46,7 +43,7 @@ export async function runCreate({ name }: CreateOptions): Promise<void> {
   const appDir = path.resolve(process.cwd(), slug);
 
   if (await fs.pathExists(appDir)) {
-    throw new Error(`Directory already exists: ${chalk.yellow(appDir)}`);
+    throw new Error(`Already exists. ${chalk.yellow(slug)}`);
   }
 
   const spinner = ora(`Creating app "${chalk.cyan(appName)}"...`).start();
@@ -68,7 +65,7 @@ export async function runCreate({ name }: CreateOptions): Promise<void> {
 
     const manifestContent = manifestTemplate
       .replace(/{{appName}}/g, appName)
-      .replace(/{ { appId } }/g, appId);
+      .replace(/{{appId}}/g, appId);
 
     const htmlContent = htmlTemplate.replace(/{{appName}}/g, appName);
 

package/src/commands/init.ts

@@ -15,7 +15,7 @@ export interface Config {
 }
 
 export async function runInit({ tokenid }: InitOptions = {}): Promise<void> {
-  let token = tokenid;
+  let token = tokenid?.trim();
   if (!token) {
     const answers = await inquirer.prompt([
       {

package/src/commands/install.ts

@@ -0,0 +1,12 @@
+import { installApp } from "../api/requests.js";
+import {
+  getManifest,
+  validateManifestComponents,
+} from "../utils/components.utils.js";
+
+export async function runInstall(): Promise<void> {
+  const manifest = await getManifest();
+  await validateManifestComponents(manifest);
+  await installApp(manifest);
+  console.log("App installed successfully");
+}

package/src/commands/push.ts

@@ -0,0 +1,42 @@
+import ora from "ora";
+import chalk from "chalk";
+import { getManifest, handleComponents } from "../utils/components.utils.js";
+import { pushComponents } from "../api/requests.js";
+
+export async function runPush(): Promise<void> {
+  const spinner = ora("Checking manifest...").start();
+
+  try {
+    const manifest = await getManifest();
+    spinner.succeed("Manifest loaded successfully");
+
+    spinner.start("Validating and zipping components...");
+
+    const zippedComponents = await handleComponents(manifest);
+
+    const count = zippedComponents.length;
+    if (count > 0) {
+      spinner.succeed(
+        `${count} component${count > 1 ? "s" : ""} validated and zipped`
+      );
+
+      console.log(chalk.cyan("\nComponents ready to push:"));
+      zippedComponents.forEach((comp, idx) => {
+        const sizeKB = (comp.build.length / 1024).toFixed(2);
+        console.log(
+          chalk.gray(`  ${idx + 1}. ${comp.title} (${comp.key}) - ${sizeKB} KB`)
+        );
+      });
+
+      spinner.start("Uploading to Fireberry...");
+
+      await pushComponents(manifest.app.id, zippedComponents);
+      spinner.succeed("Components pushed successfully");
+    } else {
+      spinner.succeed("No components to push");
+    }
+  } catch (error) {
+    spinner.fail("Push failed");
+    throw error;
+  }
+}

package/src/templates/manifest.yml

@@ -7,4 +7,7 @@ components:
     title: my-first-component
     key: comp
     path: static/comp/build
-    settings: {}
+    settings:
+      iconName: "related-single"
+      iconColor: "#7aae7f"
+      objectType: 0

package/src/utils/components.utils.ts

@@ -0,0 +1,144 @@
+import path from "node:path";
+import fs from "fs-extra";
+import yaml from "js-yaml";
+import chalk from "chalk";
+import * as tar from "tar";
+import os from "node:os";
+import { Manifest, ManifestComponent, ZippedComponent } from "../api/types.js";
+
+export const getManifest = async (): Promise<Manifest> => {
+  const manifestPath = path.join(process.cwd(), "manifest.yml");
+
+  if (!(await fs.pathExists(manifestPath))) {
+    throw new Error(
+      `No manifest.yml found at ${chalk.yellow(process.cwd())}.\n` +
+        `Please run this command from your Fireberry app directory.`
+    );
+  }
+
+  const manifestContent = await fs.readFile(manifestPath, "utf-8");
+
+  const manifest = yaml.load(manifestContent) as Manifest;
+
+  if (!manifest || !manifest.app) {
+    throw new Error("manifest.yml must contain an 'app' section");
+  }
+
+  if (!manifest.app.id || !manifest.app.name) {
+    throw new Error(
+      "manifest.yml app section must contain 'id' and 'name' fields"
+    );
+  }
+
+  return manifest;
+};
+
+export const validateComponentBuild = async (
+  componentPath: string,
+  comp: ManifestComponent
+) => {
+  if (!(await fs.pathExists(componentPath))) {
+    throw new Error(
+      `Component "${comp.title}" path does not exist: ${chalk.yellow(
+        componentPath
+      )}\n` + `Make sure the path in manifest.yml is correct.`
+    );
+  }
+
+  const stats = await fs.stat(componentPath);
+
+  if (stats.isDirectory()) {
+    const files = await fs.readdir(componentPath);
+
+    if (files.length === 0) {
+      throw new Error(`Component <${comp.key}> at: /${comp.path} not found`);
+    }
+  }
+};
+
+export const zipComponentBuild = async (
+  componentPath: string,
+  title: string
+): Promise<Buffer> => {
+  const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "fireberry-"));
+  const tarballPath = path.join(tmpDir, `${title}.tar.gz`);
+
+  try {
+    const stats = await fs.stat(componentPath);
+
+    if (stats.isDirectory()) {
+      await tar.create(
+        {
+          gzip: true,
+          file: tarballPath,
+          cwd: componentPath,
+        },
+        ["."]
+      );
+    } else {
+      const tempBuildDir = path.join(tmpDir, "build");
+      await fs.ensureDir(tempBuildDir);
+
+      const fileName = path.basename(componentPath);
+      await fs.copy(componentPath, path.join(tempBuildDir, fileName));
+
+      await tar.create(
+        {
+          gzip: true,
+          file: tarballPath,
+          cwd: tempBuildDir,
+        },
+        ["."]
+      );
+    }
+
+    const buffer = await fs.readFile(tarballPath);
+
+    await fs.remove(tmpDir);
+
+    return buffer;
+  } catch (error) {
+    await fs.remove(tmpDir);
+    throw error;
+  }
+};
+
+export const validateManifestComponents = async (manifest: Manifest) => {
+  const components = manifest.components;
+  if (!components || components.length === 0) {
+    throw new Error("No components found in manifest");
+  }
+
+  const keys = components.map((comp) => comp.key);
+  if (new Set(keys).size !== keys.length) {
+    throw new Error("All component keys must be unique");
+  }
+
+  for (const comp of components) {
+    const componentPath = path.join(process.cwd(), comp.path);
+    await validateComponentBuild(componentPath, comp);
+  }
+};
+
+export const handleComponents = async (
+  manifest: Manifest
+): Promise<ZippedComponent[]> => {
+  await validateManifestComponents(manifest);
+  const components = manifest.components!;
+
+  const zippedComponents: ZippedComponent[] = [];
+
+  for (const comp of components) {
+    const componentPath = path.join(process.cwd(), comp.path);
+
+    const buildBuffer = await zipComponentBuild(componentPath, comp.title);
+
+    zippedComponents.push({
+      title: comp.title,
+      key: comp.key,
+      build: buildBuffer,
+    });
+  }
+
+  return zippedComponents;
+};