@axpo/cli 1.0.0

package/README.md

@@ -0,0 +1,91 @@
+<div align="center">
+  <a href="https://github.com/MatrixCoder0101/axpo">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://iili.io/q0y2Jne.png">
+      <img alt="Axpo logo" src="https://iili.io/q0y2Jne.png" height="128">
+    </picture>
+  </a>
+  <h1>@axpo/cli</h1>
+
+  <p>CLI & build tool for <a href="https://acode.app">Acode</a> plugin development.</p>
+
+  <p>
+    <a href="https://www.npmjs.com/package/@axpo/cli">
+      <img src="https://img.shields.io/npm/v/@axpo/cli?style=flat-square&logo=npm&color=CB3837" alt="npm version" />
+    </a>
+    <a href="https://www.npmjs.com/package/@axpo/cli">
+      <img src="https://img.shields.io/npm/dm/@axpo/cli?style=flat-square&logo=npm&color=CB3837" alt="monthly downloads" />
+    </a>
+    <img src="https://img.shields.io/badge/TypeScript-3178C6?style=flat-square&logo=typescript&logoColor=white" alt="typescript" />
+    <img src="https://img.shields.io/badge/platform-Android-3DDC84?style=flat-square&logo=android&logoColor=white" alt="platform" />
+  </p>
+</div>
+
+> CLI and build tooling for Acode plugin development. Part of the [Axpo](https://github.com/MatrixCoder0101/axpo) ecosystem.
+
+---
+
+## Create your first plugin
+
+```bash
+npx @axpo/cli init
+```
+
+---
+
+## Commands
+
+### Inside a plugin project
+
+```bash
+npm run dev      # Start dev server with hot reload
+npm run build    # Build + zip for production
+npm run clean    # Clean build output
+npm run publish  # Publish to Acode registry
+```
+
+### Axpo CLI
+
+```bash
+axpo init [name]     # Create a new plugin project
+axpo dev             # Start development server
+axpo build           # Build plugin (creates zip by default)
+axpo build --no-zip  # Build only, skip zip
+axpo zip             # Create zip from existing build
+axpo publish         # Publish plugin to Acode registry
+axpo logout          # Clear saved Acode credentials
+axpo clean           # Remove build folder and zip files
+```
+
+**`axpo init` options**
+
+| Flag | Description |
+|------|-------------|
+| `[name]` | Project folder name |
+| `.` | Initialize in current directory |
+| `-y, --yes` | Skip prompts, use defaults |
+
+**`axpo build` options**
+
+| Flag | Description |
+|------|-------------|
+| `--no-zip` | Skip zip creation |
+| `-o, --output <file>` | Custom zip filename |
+
+**`axpo publish` options**
+
+| Flag | Description |
+|------|-------------|
+| `-z, --zip <file>` | Zip file to publish (default: `Plugin.zip`) |
+| `-f, --force` | Skip confirmation prompt |
+
+---
+
+
+## Links
+
+- **Core SDK:** [@axpo/core](https://www.npmjs.com/package/@axpo/core)
+- **GitHub:** [github.com/MatrixCoder0101/axpo](https://github.com/MatrixCoder0101/axpo)
+- **Acode Docs:** [docs.acode.app](https://docs.acode.app)
+
+<center>Made with ❤️ by Goutam Kumar</center>

package/bin/axpo.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import color from 'picocolors';
+import { build, dev, createZip, clean, publish, logout, init } from '../dist/index.js';
+
+const program = new Command();
+
+program
+  .name('axpo')
+  .description('💓 Modern Framework for Acode plugin development')
+  .version('1.0.0');
+
+//Init command
+program
+  .command('init [name]')
+  .description('Create a new Acode plugin project')
+  .option('-y, --yes', 'Skip prompts and use defaults')
+  .action(async (name, options) => {
+    // Check if name is "."
+    const isCurrent = name === '.';
+    await init({ 
+      name: isCurrent ? undefined : name, 
+      current: isCurrent,
+      ...options 
+    });
+  });
+
+// Dev command
+program
+  .command('dev')
+  .description('Start development server with hot reload')
+  .action(async () => {
+    try {
+      await dev();
+    } catch (error) {
+      console.error(color.red('\n✗ Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Build command
+program
+  .command('build')
+  .description('Build plugin for production')
+  .option('--no-zip', 'Skip zip creation after build')  // ✅ --no-zip flag
+  .option('-o, --output <filename>', 'Zip output filename (default: Plugin.zip)')
+  .option('-w, --watch', 'Watch for changes')
+  .action(async (options) => {
+    try {
+      if (options.watch) {
+        await dev();
+      } else {
+        await build({ 
+          zip: options.zip,      // ✅ --no-zip se automatically false ho jayega
+          zipFilename: options.output
+        });
+      }
+    } catch (error) {
+      console.error(color.red('\n✗ Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Zip command
+program
+  .command('zip')
+  .description('Create zip (requires build first)')
+  .option('-o, --output <filename>', 'Zip output filename (default: Plugin.zip)')
+  .action(async (options) => {
+    try {
+      await createZip(options.output);
+    } catch (error) {
+      console.error(color.red('\n✗ Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Publish command
+program
+  .command('publish')
+  .description('Publish plugin to Acode registry')
+  .option('-z, --zip <filename>', 'Zip filename to publish (default: Plugin.zip)')
+  .option('-f, --force', 'Skip confirmation prompts')
+  .action(async (options) => {
+    try {
+      await publish({
+        zipFilename: options.zip,
+        force: options.force
+      });
+    } catch (error) {
+      console.error(color.red('\n✗ Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Logout command
+program
+  .command('logout')
+  .description('Clear saved Acode credentials')
+  .action(async () => {
+    try {
+      await logout();
+    } catch (error) {
+      console.error(color.red('\n✗ Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Clean command
+program
+  .command('clean')
+  .description('Clean build artifacts (build/, zip files)')
+  .action(async () => {
+    try {
+      await clean();
+    } catch (error) {
+      console.error(color.red('\n✗ Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Show help if no command
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+}
+
+program.parse();

package/dist/index.d.ts

@@ -0,0 +1,87 @@
+import { AxpoConfig, PluginJson } from '@axpo/sdk';
+
+interface DeviceInfo {
+    packageName: string;
+    version: string;
+    versionCode: number;
+    buildType: string;
+    debug: boolean;
+    flavor: string;
+    installDate: string;
+    isPaid: boolean;
+    androidVersion: string;
+    deviceModel: string;
+    chromeVersion: string;
+    deviceVendor: string;
+    screenWidth: number;
+    screenHeight: number;
+    viewportWidth: number;
+    viewportHeight: number;
+    pixelRatio: number;
+    sys: string;
+    cpuCores: number;
+    ram: number;
+    os: string;
+    browser: string;
+    userAgent: string;
+}
+interface SessionWarnings {
+    minVersionCodeWarning: boolean;
+    apiWarnings: Set<string>;
+}
+interface APIWarning {
+    api: string;
+    requiredVersion: number;
+    file: string;
+    line: number;
+    severity: 'error' | 'warn' | 'info';
+}
+interface APIUsageAnalysis {
+    apis: Set<string>;
+    warnings: APIWarning[];
+    hasErrors: boolean;
+    hasWarnings: boolean;
+}
+interface BuildCommandOptions {
+    zip?: boolean;
+    zipFilename?: string;
+}
+interface PublishCommandOptions {
+    token?: string;
+    registry?: string;
+}
+
+interface PublishOptions {
+    zipFilename?: string;
+    force?: boolean;
+    token?: string;
+}
+declare function publish(options?: PublishOptions): Promise<void>;
+declare function logout(): Promise<void>;
+
+declare function build(options?: BuildCommandOptions): Promise<boolean>;
+declare function dev(): Promise<void>;
+declare function createZip(commandZipFilename?: string): Promise<void>;
+declare function clean(): Promise<void>;
+
+declare function loadPluginJson(): PluginJson;
+declare function loadConfig(configPath?: string): Promise<AxpoConfig>;
+declare function validateConfig(config: AxpoConfig, pluginJson: PluginJson): void;
+declare function getOutDir(config: AxpoConfig): string;
+
+interface VersionCheckResult {
+    isOutdated: boolean;
+    currentVersion: string;
+    latestVersion?: string;
+}
+declare function checkAxpoVersion(): Promise<VersionCheckResult | null>;
+declare function displayVersionWarning(result: VersionCheckResult): void;
+
+interface InitOptions {
+    name?: string;
+    yes?: boolean;
+    current?: boolean;
+}
+declare function init(options?: InitOptions): Promise<void>;
+
+export { type APIUsageAnalysis, type APIWarning, type BuildCommandOptions, type DeviceInfo, type PublishCommandOptions, type SessionWarnings, build, checkAxpoVersion, clean, createZip, dev, displayVersionWarning, getOutDir, init, loadConfig, loadPluginJson, logout, publish, validateConfig };