@ollie-shop/cli 0.1.2 → 0.2.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @ollie-shop/cli@0.1.2 build /home/runner/work/ollie-shop/ollie-shop/packages/cli
+> @ollie-shop/cli@0.2.0 build /home/runner/work/ollie-shop/ollie-shop/packages/cli
 > tsup
 
 CLI Building entry: src/index.ts
@@ -9,5 +9,5 @@
 CLI Target: esnext
 CLI Cleaning output folder
 CJS Build start
-CJS dist/index.js 7.47 KB
-CJS ⚡️ Build success in 699ms
+CJS dist/index.js 16.06 KB
+CJS ⚡️ Build success in 543ms

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ollie-shop/cli
 
+## 0.2.0
+
+### Minor Changes
+
+- 8f99b17: new CLI commands—docs, help, whoami, and validate—to the Ollie Shop CLI, along with supporting utility modules
+
+## 0.1.3
+
+### Patch Changes
+
+- 8d43054: Change browser opening to use open package
+
 ## 0.1.2
 
 ### Patch Changes

package/dist/index.js

@@ -2,17 +2,25 @@
 'use strict';
 
 var commander = require('commander');
-var child_process = require('child_process');
+var chalk3 = require('chalk');
 var crypto = require('crypto');
 var fs = require('fs/promises');
 var http = require('http');
 var os = require('os');
-var path = require('path');
+var path2 = require('path');
+var fs3 = require('fs');
+var module$1 = require('module');
+var latestVersion = require('latest-version');
+var jwtDecode = require('jwt-decode');
 
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
+var chalk3__default = /*#__PURE__*/_interopDefault(chalk3);
 var fs__default = /*#__PURE__*/_interopDefault(fs);
-var path__default = /*#__PURE__*/_interopDefault(path);
+var path2__default = /*#__PURE__*/_interopDefault(path2);
+var fs3__default = /*#__PURE__*/_interopDefault(fs3);
+var latestVersion__default = /*#__PURE__*/_interopDefault(latestVersion);
 
 var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
   get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
@@ -20,6 +28,48 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
   if (typeof require !== "undefined") return require.apply(this, arguments);
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
+function configureDocsCommand(program) {
+  program.command("docs").description("Show documentation links for Ollie Shop").action(() => {
+    console.log(chalk3__default.default.cyanBright("\nOllie Shop Documentation\n"));
+    console.log(
+      `${chalk3__default.default.green("Main Docs:".padEnd(20))} https://docs.ollie.shop/ollie-shop`
+    );
+    console.log(
+      `${chalk3__default.default.green("Components:".padEnd(20))} https://docs.ollie.shop/ollie-shop/concepts/component`
+    );
+    console.log(
+      `${chalk3__default.default.green("Functions:".padEnd(20))} https://docs.ollie.shop/ollie-shop/concepts/function`
+    );
+    console.log(
+      `${chalk3__default.default.green("Versions:".padEnd(20))} https://docs.ollie.shop/ollie-shop/concepts/version
+`
+    );
+  });
+}
+function configureHelpCommand(program) {
+  program.command("help [command]").description("Display help for a specific command or list all commands").action((cmdName) => {
+    if (cmdName) {
+      const cmd = program.commands.find((c) => c.name() === cmdName);
+      if (cmd) {
+        cmd.help();
+      } else {
+        console.log(chalk3__default.default.red(`Command '${cmdName}' not found.`));
+      }
+    } else {
+      console.log(chalk3__default.default.cyanBright("\nAvailable commands:\n"));
+      for (const cmd of program.commands) {
+        console.log(
+          `  ${chalk3__default.default.green(cmd.name().padEnd(20))} ${cmd.description()}`
+        );
+      }
+      console.log(
+        `
+Use ${chalk3__default.default.yellow("ollieshop help <command>")} to get more info on a command.
+`
+      );
+    }
+  });
+}
 var DEFAULT_CALLBACK_PORT = 7777;
 var AUTH_ENDPOINT = "https://admin.ollie.shop/auth/login";
 function configureLoginCommand(program) {
@@ -160,7 +210,7 @@ async function startWebAuthFlow(options) {
         });
       }
     });
-    server.listen(port, () => {
+    server.listen(port, async () => {
       const redirectUrl = `http://localhost:${port}/callback`;
       const authUrl = new URL(baseUrl);
       authUrl.searchParams.set("flow", "cli");
@@ -169,7 +219,8 @@ async function startWebAuthFlow(options) {
       console.log("\n\u{1F512} Please authenticate in your browser...\n");
       console.log(`Opening: ${authUrl}
 `);
-      openBrowser(authUrl.toString());
+      const open = (await import('open')).default;
+      open(authUrl.toString());
     });
     server.on("error", (err) => {
       if (err.code === "EADDRINUSE") {
@@ -197,14 +248,10 @@ async function startWebAuthFlow(options) {
     });
   });
 }
-function openBrowser(url) {
-  const command = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
-  child_process.spawn(command, [url], { detached: true }).unref();
-}
 async function saveCredentials(token) {
   console.log("Saving credentials...");
-  const configDir = path__default.default.join(os.homedir(), ".ollie-shop");
-  const credentialsPath = path__default.default.join(configDir, "credentials.json");
+  const configDir = path2__default.default.join(os.homedir(), ".ollie-shop");
+  const credentialsPath = path2__default.default.join(configDir, "credentials.json");
   try {
     await fs__default.default.mkdir(configDir, { recursive: true });
   } catch (error) {
@@ -215,22 +262,228 @@ async function saveCredentials(token) {
   await fs__default.default.writeFile(credentialsPath, JSON.stringify(token, null, 2));
   return true;
 }
+function configureValidateCommand(program) {
+  program.command("validate [componentPath]").description("Validate the structure of your custom component").action(async (componentPath) => {
+    if (!componentPath) {
+      console.error(
+        `${chalk3__default.default.red("\u274C Missing required argument:")} component path
+
+Example usage:
+  ${chalk3__default.default.cyan("ollieshop validate")} ./path/to/your/component
+`
+      );
+      process.exit(1);
+    }
+    const resolvedPath = path2__default.default.resolve(componentPath);
+    const requiredFiles = ["index.tsx", "package.json", "meta.json"];
+    const optionalFile = "styles.module.css";
+    let isValid = true;
+    for (const file of requiredFiles) {
+      try {
+        await fs__default.default.access(path2__default.default.join(resolvedPath, file));
+        console.log(`${chalk3__default.default.green("\u2714")} Found: ${chalk3__default.default.cyan(file)}`);
+      } catch {
+        console.log(`${chalk3__default.default.red("\u2716")} Missing: ${chalk3__default.default.cyan(file)}`);
+        isValid = false;
+      }
+    }
+    try {
+      await fs__default.default.access(path2__default.default.join(resolvedPath, optionalFile));
+      console.log(
+        `${chalk3__default.default.yellow("\u2139")} Optional file found: ${chalk3__default.default.cyan(optionalFile)}`
+      );
+    } catch {
+      console.log(
+        `${chalk3__default.default.dim("\u2139")} Optional file not found: ${chalk3__default.default.cyan(optionalFile)}`
+      );
+    }
+    if (isValid) {
+      console.log(`
+${chalk3__default.default.green("\u2714")} Component structure looks valid!`);
+    } else {
+      process.exit(1);
+    }
+  });
+}
+var require2 = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.js', document.baseURI).href)));
+var pkg = require2("../package.json");
+async function checkForUpdates() {
+  try {
+    const latest = await latestVersion__default.default(pkg.name);
+    if (latest !== pkg.version) {
+      console.log(
+        chalk3__default.default.yellow(
+          `
+\u26A0\uFE0F  A new version ${chalk3__default.default.bold(latest)} is available!
+   Update now: ${chalk3__default.default.bold(
+            "npm install -g @ollie-shop/cli"
+          )}
+`
+        )
+      );
+    }
+  } catch {
+  }
+}
+function showWelcomeMessage() {
+  console.log(
+    chalk3__default.default.cyanBright.bold(
+      `
+\u2728 Welcome to the Ollie Shop CLI - ${pkg.version} \u2728
+`
+    )
+  );
+  console.log("Build, customize and deploy your e-commerce with ease.\n");
+  console.log("Usage:");
+  console.log("  ollieshop <command> [options]\n");
+  console.log("Available commands:");
+  const stableCommands = [
+    { cmd: "login", desc: "Log in to your Ollie Shop account" },
+    { cmd: "validate", desc: "Validate your component files" },
+    { cmd: "whoami", desc: "Show logged-in user and current store" }
+  ];
+  for (const { cmd, desc } of stableCommands) {
+    console.log(`  ${chalk3__default.default.green(cmd.padEnd(20))} ${desc}`);
+  }
+  console.log("\nComing soon:");
+  const comingSoonCommands = [
+    { cmd: "build", desc: "Compile components for deployment" },
+    { cmd: "deploy", desc: "Deploy a component or function" },
+    { cmd: "dev", desc: "Start local preview server" },
+    { cmd: "status", desc: "Show store status" }
+  ];
+  for (const { cmd, desc } of comingSoonCommands) {
+    console.log(`  ${chalk3__default.default.yellow(cmd.padEnd(20))} ${desc}`);
+  }
+  console.log(
+    `
+For a full list of commands, run: ${chalk3__default.default.yellow.bold("ollieshop help")}
+`
+  );
+  console.log(
+    "Documentation:",
+    chalk3__default.default.underline.blue("https://docs.ollie.shop/ollie-shop")
+  );
+  console.log();
+}
+function validateProjectLocation() {
+  const command = process.argv[2] ?? "";
+  const allowedOutside = ["help", "docs", "version"];
+  if (allowedOutside.includes(command)) return;
+  const configPath = path2__default.default.join(process.cwd(), "ollie.json");
+  const isValidProject = fs3__default.default.existsSync(configPath);
+  if (!isValidProject) {
+    console.log(`
+      ${chalk3__default.default.red("\u274C")} This command must be run inside an ${chalk3__default.default.bold("Ollie Shop project")}.
+      Please navigate to your project directory and try again.
+`);
+    process.exit(1);
+  }
+}
+
+// src/commands/version.ts
+function configureVersionCommand(program) {
+  program.command("version").description("Display the current CLI version").action(() => {
+    console.log(
+      `${chalk3__default.default.bold("Ollie Shop CLI version:")} ${chalk3__default.default.cyan(pkg.version)}
+`
+    );
+  });
+}
+var CREDENTIALS_PATH = path2__default.default.join(
+  os.homedir(),
+  ".ollie-shop",
+  "credentials.json"
+);
+async function getCurrentUser() {
+  try {
+    const raw = await fs__default.default.readFile(CREDENTIALS_PATH, "utf-8");
+    const token = JSON.parse(raw);
+    if (!token.accessToken) return null;
+    const decoded = jwtDecode.jwtDecode(token.accessToken);
+    return {
+      email: decoded.email
+    };
+  } catch {
+    return null;
+  }
+}
+async function getOllieConfig() {
+  try {
+    const configPath = path2__default.default.join(process.cwd(), "ollie.json");
+    const raw = await fs__default.default.readFile(configPath, "utf-8");
+    const data = JSON.parse(raw);
+    return data;
+  } catch {
+    return null;
+  }
+}
+
+// src/commands/whoami.ts
+async function getUserInfo() {
+  try {
+    const user = await getCurrentUser();
+    const store = await getOllieConfig();
+    if (!user || !user.email) {
+      console.log("\u274C No user authenticated");
+      return {};
+    }
+    return {
+      email: user.email,
+      store: store ?? void 0
+    };
+  } catch {
+    return {};
+  }
+}
+function configureWhoamiCommand(program) {
+  program.command("whoami").description("Show logged-in user and current store").action(async () => {
+    const { email, store } = await getUserInfo();
+    if (!email) {
+      console.log(chalk3__default.default.red("You are not authenticated"));
+      return;
+    }
+    console.log();
+    console.log(
+      `${chalk3__default.default.bold("You are logged in as:")} ${chalk3__default.default.cyan(email)}`
+    );
+    if (store) {
+      console.log(
+        `${chalk3__default.default.bold("Current store:")} ${chalk3__default.default.cyan(store.platformStoreId ?? "unknown")}`
+      );
+    }
+    console.log();
+  });
+}
 
 // src/commands/index.ts
 function registerCommands(program) {
+  configureDocsCommand(program);
+  configureHelpCommand(program);
   configureLoginCommand(program);
+  configureWhoamiCommand(program);
+  configureValidateCommand(program);
+  configureVersionCommand(program);
 }
 
 // src/index.ts
 function createProgram() {
   const program = new commander.Command();
-  program.name("ollie").description("Ollie Shop CLI tools").version("0.1.0");
+  program.name("ollieshop").description("Ollie Shop CLI tools").version(pkg.version);
   registerCommands(program);
   return program;
 }
 if (__require.main === module) {
-  const program = createProgram();
-  program.parse();
+  (async () => {
+    const program = createProgram();
+    if (process.argv.length <= 2) {
+      await checkForUpdates();
+      showWelcomeMessage();
+      process.exit(0);
+    }
+    validateProjectLocation();
+    program.parse();
+  })();
 }
 
 exports.createProgram = createProgram;

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "@ollie-shop/cli",
-  "version": "0.1.2",
-  "description": "CLI tools for Ollie Shop",
+  "version": "0.2.0",
+  "description": "Command-line tools for developing with Ollie Shop",
   "bin": {
-    "ollie-shop": "./dist/index.js"
+    "ollieshop": "./dist/index.js"
   },
   "dependencies": {
-    "commander": "^11.1.0"
+    "chalk": "^5.4.1",
+    "commander": "^11.1.0",
+    "jwt-decode": "^4.0.0",
+    "latest-version": "^9.0.0",
+    "open": "^10.1.2"
   },
   "devDependencies": {
     "@types/node": "^22.15.23",

package/src/commands/docs.ts

@@ -0,0 +1,24 @@
+import chalk from "chalk";
+import type { Command } from "commander";
+
+export function configureDocsCommand(program: Command): void {
+  program
+    .command("docs")
+    .description("Show documentation links for Ollie Shop")
+    .action(() => {
+      console.log(chalk.cyanBright("\nOllie Shop Documentation\n"));
+
+      console.log(
+        `${chalk.green("Main Docs:".padEnd(20))} https://docs.ollie.shop/ollie-shop`,
+      );
+      console.log(
+        `${chalk.green("Components:".padEnd(20))} https://docs.ollie.shop/ollie-shop/concepts/component`,
+      );
+      console.log(
+        `${chalk.green("Functions:".padEnd(20))} https://docs.ollie.shop/ollie-shop/concepts/function`,
+      );
+      console.log(
+        `${chalk.green("Versions:".padEnd(20))} https://docs.ollie.shop/ollie-shop/concepts/version\n`,
+      );
+    });
+}

package/src/commands/help.ts

@@ -0,0 +1,28 @@
+import chalk from "chalk";
+import type { Command } from "commander";
+
+export function configureHelpCommand(program: Command): void {
+  program
+    .command("help [command]")
+    .description("Display help for a specific command or list all commands")
+    .action((cmdName) => {
+      if (cmdName) {
+        const cmd = program.commands.find((c) => c.name() === cmdName);
+        if (cmd) {
+          cmd.help();
+        } else {
+          console.log(chalk.red(`Command '${cmdName}' not found.`));
+        }
+      } else {
+        console.log(chalk.cyanBright("\nAvailable commands:\n"));
+        for (const cmd of program.commands) {
+          console.log(
+            `  ${chalk.green(cmd.name().padEnd(20))} ${cmd.description()}`,
+          );
+        }
+        console.log(
+          `\nUse ${chalk.yellow("ollieshop help <command>")} to get more info on a command.\n`,
+        );
+      }
+    });
+}

package/src/commands/index.ts

@@ -1,13 +1,20 @@
 import type { Command } from "commander";
+import { configureDocsCommand } from "./docs";
+import { configureHelpCommand } from "./help";
 import { configureLoginCommand } from "./login";
+import { configureValidateCommand } from "./validate";
+import { configureVersionCommand } from "./version";
+import { configureWhoamiCommand } from "./whoami";
 
 /**
  * Register all CLI commands with the program
  * @param program The commander program instance
  */
 export function registerCommands(program: Command): void {
-  // Register individual commands
+  configureDocsCommand(program);
+  configureHelpCommand(program);
   configureLoginCommand(program);
-
-  // Add more commands here as they are implemented
+  configureWhoamiCommand(program);
+  configureValidateCommand(program);
+  configureVersionCommand(program);
 }

package/src/commands/login.ts

@@ -1,4 +1,3 @@
-import { spawn } from "node:child_process";
 import { randomBytes } from "node:crypto";
 import fs from "node:fs/promises";
 import type { IncomingMessage, ServerResponse } from "node:http";
@@ -244,7 +243,7 @@ async function startWebAuthFlow(options: {
     });
 
     // Start the server
-    server.listen(port, () => {
+    server.listen(port, async () => {
       // Build the URL to your Next.js app with necessary parameters
       const redirectUrl = `http://localhost:${port}/callback`;
 
@@ -257,8 +256,10 @@ async function startWebAuthFlow(options: {
       console.log("\n🔒 Please authenticate in your browser...\n");
       console.log(`Opening: ${authUrl}\n`);
 
+      const open = (await import("open")).default;
+
       // Open the browser with the authorization URL
-      openBrowser(authUrl.toString());
+      open(authUrl.toString());
     });
 
     // Handle server errors
@@ -293,20 +294,6 @@ async function startWebAuthFlow(options: {
   });
 }
 
-/**
- * Open the default browser with the given URL
- */
-function openBrowser(url: string) {
-  const command =
-    process.platform === "darwin"
-      ? "open"
-      : process.platform === "win32"
-        ? "start"
-        : "xdg-open";
-
-  spawn(command, [url], { detached: true }).unref();
-}
-
 /**
  * Save authentication credentials locally
  *

package/src/commands/validate.ts

@@ -0,0 +1,62 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import chalk from "chalk";
+import type { Command } from "commander";
+
+/**
+ * Register the `validate` command
+ */
+export function configureValidateCommand(program: Command): void {
+  program
+    // Make componentPath optional here to suppress Commander error
+    .command("validate [componentPath]")
+    .description("Validate the structure of your custom component")
+    .action(async (componentPath: string | undefined) => {
+      if (!componentPath) {
+        console.error(
+          `${chalk.red("❌ Missing required argument:")} component path\n\n` +
+            `Example usage:\n  ${chalk.cyan("ollieshop validate")} ./path/to/your/component\n`,
+        );
+        process.exit(1);
+      }
+
+      const resolvedPath = path.resolve(componentPath);
+      const requiredFiles = ["index.tsx", "package.json", "meta.json"];
+      const optionalFile = "styles.module.css";
+
+      let isValid = true;
+
+      // Track missing required files
+      const missingFiles: string[] = [];
+
+      // Check required files
+      for (const file of requiredFiles) {
+        try {
+          await fs.access(path.join(resolvedPath, file));
+          console.log(`${chalk.green("✔")} Found: ${chalk.cyan(file)}`);
+        } catch {
+          console.log(`${chalk.red("✖")} Missing: ${chalk.cyan(file)}`);
+          missingFiles.push(file);
+          isValid = false;
+        }
+      }
+
+      // Check optional file presence
+      try {
+        await fs.access(path.join(resolvedPath, optionalFile));
+        console.log(
+          `${chalk.yellow("ℹ")} Optional file found: ${chalk.cyan(optionalFile)}`,
+        );
+      } catch {
+        console.log(
+          `${chalk.dim("ℹ")} Optional file not found: ${chalk.cyan(optionalFile)}`,
+        );
+      }
+
+      if (isValid) {
+        console.log(`\n${chalk.green("✔")} Component structure looks valid!`);
+      } else {
+        process.exit(1);
+      }
+    });
+}

package/src/commands/version.ts

@@ -0,0 +1,14 @@
+import chalk from "chalk";
+import type { Command } from "commander";
+import { pkg } from "../utils/core";
+
+export function configureVersionCommand(program: Command): void {
+  program
+    .command("version")
+    .description("Display the current CLI version")
+    .action(() => {
+      console.log(
+        `${chalk.bold("Ollie Shop CLI version:")} ${chalk.cyan(pkg.version)}\n`,
+      );
+    });
+}

package/src/commands/whoami.ts

@@ -0,0 +1,51 @@
+import chalk from "chalk";
+import type { Command } from "commander";
+import { getCurrentUser } from "../utils/auth";
+import { type OllieConfig, getOllieConfig } from "../utils/store";
+
+// Reads credentials from ~/.ollie-shop/credentials.json
+async function getUserInfo(): Promise<{ email?: string; store?: OllieConfig }> {
+  try {
+    const user = await getCurrentUser();
+    const store = await getOllieConfig();
+
+    if (!user || !user.email) {
+      console.log("❌ No user authenticated");
+      return {};
+    }
+
+    return {
+      email: user.email,
+      store: store ?? undefined,
+    };
+  } catch {
+    return {};
+  }
+}
+
+export function configureWhoamiCommand(program: Command) {
+  program
+    .command("whoami")
+    .description("Show logged-in user and current store")
+    .action(async () => {
+      const { email, store } = await getUserInfo();
+
+      if (!email) {
+        console.log(chalk.red("You are not authenticated"));
+        return;
+      }
+
+      console.log();
+      console.log(
+        `${chalk.bold("You are logged in as:")} ${chalk.cyan(email)}`,
+      );
+
+      if (store) {
+        console.log(
+          `${chalk.bold("Current store:")} ${chalk.cyan(store.platformStoreId ?? "unknown")}`,
+        );
+      }
+
+      console.log();
+    });
+}

package/src/index.ts

@@ -1,21 +1,42 @@
 import { Command } from "commander";
 import { registerCommands } from "./commands";
+import {
+  checkForUpdates,
+  pkg,
+  showWelcomeMessage,
+  validateProjectLocation,
+} from "./utils/core";
 
 /**
- * Create and configure the CLI program
+ * Creates and configures the CLI program instance
  */
 export function createProgram() {
   const program = new Command();
-  program.name("ollie").description("Ollie Shop CLI tools").version("0.1.0");
 
-  // Register all commands
+  program
+    .name("ollieshop")
+    .description("Ollie Shop CLI tools")
+    .version(pkg.version);
+
+  // Register CLI commands from external modules
   registerCommands(program);
 
   return program;
 }
 
-// If this file is run directly, execute the CLI
+// If this file is executed directly, initialize the CLI
 if (require.main === module) {
-  const program = createProgram();
-  program.parse();
+  (async () => {
+    const program = createProgram();
+
+    if (process.argv.length <= 2) {
+      await checkForUpdates();
+      showWelcomeMessage();
+      process.exit(0);
+    }
+
+    validateProjectLocation();
+
+    program.parse();
+  })();
 }

package/src/utils/auth.ts

@@ -0,0 +1,42 @@
+// lib/auth.ts
+import fs from "node:fs/promises";
+import { homedir } from "node:os";
+import path from "node:path";
+import { jwtDecode } from "jwt-decode";
+
+const CREDENTIALS_PATH = path.join(
+  homedir(),
+  ".ollie-shop",
+  "credentials.json",
+);
+
+type Token = {
+  accessToken: string;
+  refreshToken?: string;
+  expiresAt?: string;
+};
+
+type DecodedToken = {
+  email?: string;
+  exp?: number;
+  sub?: string;
+  iat?: number;
+  [key: string]: unknown;
+};
+
+export async function getCurrentUser(): Promise<{ email?: string } | null> {
+  try {
+    const raw = await fs.readFile(CREDENTIALS_PATH, "utf-8");
+    const token: Token = JSON.parse(raw);
+
+    if (!token.accessToken) return null;
+
+    const decoded = jwtDecode<DecodedToken>(token.accessToken);
+
+    return {
+      email: decoded.email,
+    };
+  } catch {
+    return null;
+  }
+}

package/src/utils/core.ts

@@ -0,0 +1,105 @@
+import fs from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import chalk from "chalk";
+import latestVersion from "latest-version";
+
+const require = createRequire(import.meta.url);
+export const pkg = require("../package.json");
+
+/**
+ * Checks if there is a newer version of the CLI available
+ * and notifies the user to update if so.
+ */
+export async function checkForUpdates() {
+  try {
+    const latest = await latestVersion(pkg.name);
+    if (latest !== pkg.version) {
+      console.log(
+        chalk.yellow(
+          `\n⚠️  A new version ${chalk.bold(latest)} is available!\n   Update now: ${chalk.bold(
+            "npm install -g @ollie-shop/cli",
+          )}\n`,
+        ),
+      );
+    }
+  } catch {
+    // Silently ignore errors if offline or failed
+  }
+}
+
+/**
+ * Displays a custom welcome message when no arguments are passed
+ */
+export function showWelcomeMessage() {
+  console.log(
+    chalk.cyanBright.bold(
+      `\n✨ Welcome to the Ollie Shop CLI - ${pkg.version} ✨\n`,
+    ),
+  );
+  console.log("Build, customize and deploy your e-commerce with ease.\n");
+
+  console.log("Usage:");
+  console.log("  ollieshop <command> [options]\n");
+
+  console.log("Available commands:");
+
+  // Stable commands
+  const stableCommands = [
+    { cmd: "login", desc: "Log in to your Ollie Shop account" },
+    { cmd: "validate", desc: "Validate your component files" },
+    { cmd: "whoami", desc: "Show logged-in user and current store" },
+  ];
+
+  for (const { cmd, desc } of stableCommands) {
+    console.log(`  ${chalk.green(cmd.padEnd(20))} ${desc}`);
+  }
+
+  console.log("\nComing soon:");
+
+  // Coming soon
+  const comingSoonCommands = [
+    { cmd: "build", desc: "Compile components for deployment" },
+    { cmd: "deploy", desc: "Deploy a component or function" },
+    { cmd: "dev", desc: "Start local preview server" },
+    { cmd: "status", desc: "Show store status" },
+  ];
+
+  for (const { cmd, desc } of comingSoonCommands) {
+    console.log(`  ${chalk.yellow(cmd.padEnd(20))} ${desc}`);
+  }
+
+  console.log(
+    `\nFor a full list of commands, run: ${chalk.yellow.bold("ollieshop help")}\n`,
+  );
+
+  console.log(
+    "Documentation:",
+    chalk.underline.blue("https://docs.ollie.shop/ollie-shop"),
+  );
+  console.log();
+}
+
+/**
+ * Ensures the current working directory is a valid Ollie Shop project.
+ * If not, it shows an error and exits the process.
+ */
+export function validateProjectLocation() {
+  const command = process.argv[2] ?? "";
+
+  // Commands allowed outside a valid Ollie Shop project
+  const allowedOutside = ["help", "docs", "version"];
+
+  if (allowedOutside.includes(command)) return;
+
+  const configPath = path.join(process.cwd(), "ollie.json");
+  const isValidProject = fs.existsSync(configPath);
+
+  if (!isValidProject) {
+    console.log(`
+      ${chalk.red("❌")} This command must be run inside an ${chalk.bold("Ollie Shop project")}.
+      Please navigate to your project directory and try again.\n`);
+
+    process.exit(1);
+  }
+}

package/src/utils/store.ts

@@ -0,0 +1,23 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+
+export type OllieConfig = {
+  storeId: string;
+  versionId: string;
+  platform: string;
+  platformStoreId: string;
+  sessionId: string;
+  props: unknown;
+  theme: Record<string, unknown>;
+};
+
+export async function getOllieConfig(): Promise<OllieConfig | null> {
+  try {
+    const configPath = path.join(process.cwd(), "ollie.json");
+    const raw = await fs.readFile(configPath, "utf-8");
+    const data: OllieConfig = JSON.parse(raw);
+    return data;
+  } catch {
+    return null;
+  }
+}