@optima-chat/bi-cli 0.2.0

package/dist/index.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { createAuthCommand } from './commands/auth.js';
+import { createSalesCommand } from './commands/sales.js';
+import { createProductCommand } from './commands/product.js';
+import { createTrendsCommand } from './commands/trends.js';
+import { createAnalyticsCommand } from './commands/analytics.js';
+const program = new Command();
+program
+    .name('bi-cli')
+    .description('Optima BI CLI - AI-friendly business intelligence tool')
+    .version('0.2.0');
+// Auth commands
+program.addCommand(createAuthCommand());
+// Sales commands
+program.addCommand(createSalesCommand());
+// Product commands
+program.addCommand(createProductCommand());
+// Trends commands
+program.addCommand(createTrendsCommand());
+// Analytics commands
+program.addCommand(createAnalyticsCommand());
+// Config commands (placeholder)
+program
+    .command('config')
+    .description('Manage configuration')
+    .action(() => {
+    console.log('Config management coming soon...');
+});
+// Customer commands (placeholder)
+program
+    .command('customer')
+    .description('Customer analytics')
+    .action(() => {
+    console.log('Customer analytics coming soon...');
+});
+// Inventory commands (placeholder)
+program
+    .command('inventory')
+    .description('Inventory analytics')
+    .action(() => {
+    console.log('Inventory analytics coming soon...');
+});
+// Platform commands (admin only - placeholder)
+program
+    .command('platform')
+    .description('Platform analytics (admin only)')
+    .action(() => {
+    console.log('Platform analytics coming soon...');
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,wDAAwD,CAAC;KACrE,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,gBAAgB;AAChB,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;AAExC,iBAAiB;AACjB,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAEzC,mBAAmB;AACnB,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;AAE3C,kBAAkB;AAClB,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAE1C,qBAAqB;AACrB,OAAO,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC,CAAC;AAE7C,gCAAgC;AAChC,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,sBAAsB,CAAC;KACnC,MAAM,CAAC,GAAG,EAAE;IACX,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;AAClD,CAAC,CAAC,CAAC;AAEL,kCAAkC;AAClC,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,oBAAoB,CAAC;KACjC,MAAM,CAAC,GAAG,EAAE;IACX,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;AACnD,CAAC,CAAC,CAAC;AAEL,mCAAmC;AACnC,OAAO;KACJ,OAAO,CAAC,WAAW,CAAC;KACpB,WAAW,CAAC,qBAAqB,CAAC;KAClC,MAAM,CAAC,GAAG,EAAE;IACX,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;AACpD,CAAC,CAAC,CAAC;AAEL,+CAA+C;AAC/C,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,iCAAiC,CAAC;KAC9C,MAAM,CAAC,GAAG,EAAE;IACX,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;AACnD,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/utils/output.d.ts

@@ -0,0 +1,11 @@
+export declare enum OutputFormat {
+    JSON = "json",
+    PRETTY = "pretty"
+}
+export declare function outputJson(data: any): void;
+export declare function outputPretty(data: any, headers?: string[]): void;
+export declare function success(message: string): void;
+export declare function error(message: string): void;
+export declare function info(message: string): void;
+export declare function warn(message: string): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/utils/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAGA,oBAAY,YAAY;IACtB,IAAI,SAAS;IACb,MAAM,WAAW;CAClB;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAE1C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAuBhE;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C"}

package/dist/utils/output.js

@@ -0,0 +1,45 @@
+import chalk from 'chalk';
+import { table } from 'table';
+export var OutputFormat;
+(function (OutputFormat) {
+    OutputFormat["JSON"] = "json";
+    OutputFormat["PRETTY"] = "pretty";
+})(OutputFormat || (OutputFormat = {}));
+export function outputJson(data) {
+    console.log(JSON.stringify(data, null, 2));
+}
+export function outputPretty(data, headers) {
+    if (Array.isArray(data)) {
+        if (data.length === 0) {
+            console.log(chalk.yellow('No data found.'));
+            return;
+        }
+        const keys = headers || Object.keys(data[0]);
+        const rows = [keys.map((k) => chalk.bold(k))];
+        data.forEach((item) => {
+            rows.push(keys.map((k) => String(item[k] || '')));
+        });
+        console.log(table(rows));
+    }
+    else {
+        // Single object
+        const rows = [];
+        Object.entries(data).forEach(([key, value]) => {
+            rows.push([chalk.bold(key), String(value)]);
+        });
+        console.log(table(rows));
+    }
+}
+export function success(message) {
+    console.log(chalk.green('✓ ' + message));
+}
+export function error(message) {
+    console.error(chalk.red('✗ ' + message));
+}
+export function info(message) {
+    console.log(chalk.blue('ℹ ' + message));
+}
+export function warn(message) {
+    console.log(chalk.yellow('⚠ ' + message));
+}
+//# sourceMappingURL=output.js.map

package/dist/utils/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B,MAAM,CAAN,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,6BAAa,CAAA;IACb,iCAAiB,CAAA;AACnB,CAAC,EAHW,YAAY,KAAZ,YAAY,QAGvB;AAED,MAAM,UAAU,UAAU,CAAC,IAAS;IAClC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAS,EAAE,OAAkB;IACxD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC;YAC5C,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAE9C,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YACpB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3B,CAAC;SAAM,CAAC;QACN,gBAAgB;QAChB,MAAM,IAAI,GAAe,EAAE,CAAC;QAC5B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YAC5C,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,OAAe;IACnC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@optima-chat/bi-cli",
+  "version": "0.2.0",
+  "type": "module",
+  "description": "Optima BI CLI - AI-friendly business intelligence tool",
+  "main": "dist/index.js",
+  "bin": {
+    "bi-cli": "./dist/index.js"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "test": "echo \"Error: no test specified\" && exit 0"
+  },
+  "dependencies": {
+    "axios": "^1.6.5",
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "conf": "^12.0.0",
+    "open": "^8.4.2",
+    "ora": "^5.4.1",
+    "table": "^6.8.1"
+  },
+  "devDependencies": {
+    "@types/node": "^18.19.50",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3"
+  },
+  "keywords": [
+    "bi",
+    "business-intelligence",
+    "analytics",
+    "cli",
+    "optima"
+  ]
+}

package/src/commands/analytics.ts

@@ -0,0 +1,352 @@
+import { Command } from 'commander';
+import axios from 'axios';
+import { getConfig } from '../config/index.js';
+import { outputJson, outputPretty, error, OutputFormat, info } from '../utils/output.js';
+
+interface CompareResponse {
+  success: boolean;
+  data: {
+    merchant_id: string;
+    period: { days: number; compare_to: string };
+    current: { revenue: number; orders: number; avg_order_value: number; customers: number };
+    previous: { revenue: number; orders: number; avg_order_value: number; customers: number };
+    changes: {
+      revenue: { absolute: number; percentage: number };
+      orders: { absolute: number; percentage: number };
+      avg_order_value: { absolute: number; percentage: number };
+      customers: { absolute: number; percentage: number };
+    };
+  };
+}
+
+interface GrowthResponse {
+  success: boolean;
+  data: {
+    merchant_id: string;
+    period_type: string;
+    trends: Array<{
+      period: string;
+      revenue: number;
+      orders: number;
+      avg_order_value: number;
+      customers: number;
+      revenue_growth: number | null;
+    }>;
+  };
+}
+
+interface CohortResponse {
+  success: boolean;
+  data: {
+    merchant_id: string;
+    cohorts: Array<{
+      month: string;
+      customers: number;
+      avg_lifetime_value: number;
+      avg_orders: number;
+      total_revenue: number;
+    }>;
+  };
+}
+
+interface FunnelResponse {
+  success: boolean;
+  data: {
+    merchant_id: string;
+    period: { days: number };
+    total_orders: number;
+    funnel: Array<{
+      stage: string;
+      count: number;
+      amount: number;
+      percentage: number;
+    }>;
+    dropoffs: Array<{
+      status: string;
+      count: number;
+      amount: number;
+      percentage: number;
+    }>;
+    conversion_rate: number;
+  };
+}
+
+export function createAnalyticsCommand(): Command {
+  const analytics = new Command('analytics').description('Advanced analytics');
+
+  // analytics compare
+  analytics
+    .command('compare')
+    .description('Compare current period with previous period')
+    .option('--days <number>', 'Number of days', '30')
+    .option(
+      '--compare-to <type>',
+      'Compare to: previous_period or previous_year',
+      'previous_period'
+    )
+    .option('--pretty', 'Output in pretty table format')
+    .action(async (options) => {
+      const cfg = getConfig();
+      if (!cfg.accessToken) {
+        error('Not logged in. Run: bi-cli auth login');
+        process.exit(1);
+      }
+
+      const format = options.pretty ? OutputFormat.PRETTY : OutputFormat.JSON;
+
+      try {
+        const response = await axios.get<CompareResponse>(
+          `${cfg.backendUrl}/api/v1/analytics/compare`,
+          {
+            params: { days: options.days, compare_to: options.compareTo },
+            headers: { Authorization: `Bearer ${cfg.accessToken}` },
+          }
+        );
+
+        if (!response.data.success) {
+          error('Failed to fetch comparison data');
+          process.exit(1);
+        }
+
+        const { current, previous, changes, period } = response.data.data;
+
+        if (format === OutputFormat.JSON) {
+          outputJson(response.data.data);
+        } else {
+          console.log(
+            `\n📊 Period Comparison (${period.days} days vs ${period.compare_to.replace('_', ' ')})\n`
+          );
+
+          const formatChange = (pct: number | null) => {
+            if (pct === null) return '-';
+            const icon = pct > 0 ? '↑' : pct < 0 ? '↓' : '→';
+            const color = pct > 0 ? '+' : '';
+            return `${icon} ${color}${pct.toFixed(1)}%`;
+          };
+
+          const formatCurrency = (val: number | null) => {
+            if (val === null) return '-';
+            return `¥${val.toFixed(2)}`;
+          };
+
+          outputPretty(
+            [
+              {
+                Metric: 'Revenue',
+                Current: formatCurrency(current.revenue),
+                Previous: formatCurrency(previous.revenue),
+                Change: formatChange(changes.revenue.percentage),
+              },
+              {
+                Metric: 'Orders',
+                Current: current.orders,
+                Previous: previous.orders,
+                Change: formatChange(changes.orders.percentage),
+              },
+              {
+                Metric: 'Avg Order Value',
+                Current: formatCurrency(current.avg_order_value),
+                Previous: formatCurrency(previous.avg_order_value),
+                Change: formatChange(changes.avg_order_value.percentage),
+              },
+              {
+                Metric: 'Customers',
+                Current: current.customers,
+                Previous: previous.customers,
+                Change: formatChange(changes.customers.percentage),
+              },
+            ],
+            ['Metric', 'Current', 'Previous', 'Change']
+          );
+        }
+      } catch (err: unknown) {
+        handleApiError(err);
+      }
+    });
+
+  // analytics growth
+  analytics
+    .command('growth')
+    .description('Get growth trends over time')
+    .option('--period <type>', 'Period type: daily, weekly, monthly', 'daily')
+    .option('--limit <number>', 'Number of periods', '30')
+    .option('--pretty', 'Output in pretty table format')
+    .action(async (options) => {
+      const cfg = getConfig();
+      if (!cfg.accessToken) {
+        error('Not logged in. Run: bi-cli auth login');
+        process.exit(1);
+      }
+
+      const format = options.pretty ? OutputFormat.PRETTY : OutputFormat.JSON;
+
+      try {
+        const response = await axios.get<GrowthResponse>(
+          `${cfg.backendUrl}/api/v1/analytics/growth`,
+          {
+            params: { period: options.period, limit: options.limit },
+            headers: { Authorization: `Bearer ${cfg.accessToken}` },
+          }
+        );
+
+        if (!response.data.success) {
+          error('Failed to fetch growth data');
+          process.exit(1);
+        }
+
+        const { trends, period_type } = response.data.data;
+
+        if (format === OutputFormat.JSON) {
+          outputJson(response.data.data);
+        } else {
+          console.log(`\n📈 Growth Trends (${period_type})\n`);
+
+          const recentTrends = trends.slice(-15);
+          outputPretty(
+            recentTrends.map((t) => ({
+              Period: t.period.split('T')[0],
+              Revenue: `¥${t.revenue.toFixed(2)}`,
+              Orders: t.orders,
+              Customers: t.customers,
+              Growth: t.revenue_growth !== null ? `${t.revenue_growth.toFixed(1)}%` : '-',
+            })),
+            ['Period', 'Revenue', 'Orders', 'Customers', 'Growth']
+          );
+        }
+      } catch (err: unknown) {
+        handleApiError(err);
+      }
+    });
+
+  // analytics cohort
+  analytics
+    .command('cohort')
+    .description('Customer cohort analysis')
+    .option('--pretty', 'Output in pretty table format')
+    .action(async (options) => {
+      const cfg = getConfig();
+      if (!cfg.accessToken) {
+        error('Not logged in. Run: bi-cli auth login');
+        process.exit(1);
+      }
+
+      const format = options.pretty ? OutputFormat.PRETTY : OutputFormat.JSON;
+
+      try {
+        const response = await axios.get<CohortResponse>(
+          `${cfg.backendUrl}/api/v1/analytics/cohort`,
+          {
+            headers: { Authorization: `Bearer ${cfg.accessToken}` },
+          }
+        );
+
+        if (!response.data.success) {
+          error('Failed to fetch cohort data');
+          process.exit(1);
+        }
+
+        const { cohorts } = response.data.data;
+
+        if (format === OutputFormat.JSON) {
+          outputJson(response.data.data);
+        } else {
+          console.log('\n👥 Customer Cohort Analysis\n');
+          outputPretty(
+            cohorts.map((c) => ({
+              Cohort: c.month.split('T')[0].slice(0, 7),
+              Customers: c.customers,
+              'Avg LTV': `¥${c.avg_lifetime_value.toFixed(2)}`,
+              'Avg Orders': c.avg_orders.toFixed(1),
+              'Total Revenue': `¥${c.total_revenue.toFixed(2)}`,
+            })),
+            ['Cohort', 'Customers', 'Avg LTV', 'Avg Orders', 'Total Revenue']
+          );
+        }
+      } catch (err: unknown) {
+        handleApiError(err);
+      }
+    });
+
+  // analytics funnel
+  analytics
+    .command('funnel')
+    .description('Order status funnel analysis')
+    .option('--days <number>', 'Number of days', '30')
+    .option('--pretty', 'Output in pretty table format')
+    .action(async (options) => {
+      const cfg = getConfig();
+      if (!cfg.accessToken) {
+        error('Not logged in. Run: bi-cli auth login');
+        process.exit(1);
+      }
+
+      const format = options.pretty ? OutputFormat.PRETTY : OutputFormat.JSON;
+
+      try {
+        const response = await axios.get<FunnelResponse>(
+          `${cfg.backendUrl}/api/v1/analytics/order-funnel`,
+          {
+            params: { days: options.days },
+            headers: { Authorization: `Bearer ${cfg.accessToken}` },
+          }
+        );
+
+        if (!response.data.success) {
+          error('Failed to fetch funnel data');
+          process.exit(1);
+        }
+
+        const { funnel, dropoffs, total_orders, conversion_rate } = response.data.data;
+
+        if (format === OutputFormat.JSON) {
+          outputJson(response.data.data);
+        } else {
+          console.log('\n🔄 Order Funnel\n');
+          outputPretty(
+            funnel.map((f) => ({
+              Stage: f.stage,
+              Count: f.count,
+              Amount: `¥${f.amount.toFixed(2)}`,
+              Percentage: `${f.percentage.toFixed(1)}%`,
+            })),
+            ['Stage', 'Count', 'Amount', 'Percentage']
+          );
+
+          if (dropoffs.length > 0) {
+            console.log('\n❌ Dropoffs\n');
+            outputPretty(
+              dropoffs.map((d) => ({
+                Status: d.status,
+                Count: d.count,
+                Amount: `¥${d.amount.toFixed(2)}`,
+                Percentage: `${d.percentage.toFixed(1)}%`,
+              })),
+              ['Status', 'Count', 'Amount', 'Percentage']
+            );
+          }
+
+          info(`Total Orders: ${total_orders} | Conversion Rate: ${conversion_rate.toFixed(1)}%`);
+        }
+      } catch (err: unknown) {
+        handleApiError(err);
+      }
+    });
+
+  return analytics;
+}
+
+function handleApiError(err: unknown): never {
+  const axiosError = err as {
+    response?: { status?: number; data?: { error?: { message?: string } } };
+  };
+  const errorObj = err as Error;
+
+  if (axiosError.response?.status === 401) {
+    error('Authentication failed. Please login again: bi-cli auth login');
+  } else if (axiosError.response?.data?.error) {
+    error(`Error: ${axiosError.response.data.error.message}`);
+  } else {
+    error(`Request failed: ${errorObj.message || 'Unknown error'}`);
+  }
+  process.exit(1);
+}