codecard-cli 0.1.0

package/dist/commands/spend.js

@@ -0,0 +1,116 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.spendCommand = void 0;
+const commander_1 = require("commander");
+const ora_1 = __importDefault(require("ora"));
+const config_1 = require("../lib/config");
+const api_client_1 = require("../lib/api-client");
+const output_1 = require("../lib/output");
+const shared_1 = require("../shared");
+const categoryColors = {
+    "ai-apis": output_1.accent,
+    "cloud-infra": output_1.blue,
+    "dev-tools": output_1.purple,
+    "other": output_1.orange,
+};
+const categoryLabels = {
+    "ai-apis": "AI Model APIs",
+    "cloud-infra": "Cloud & Infra",
+    "dev-tools": "Dev Tools",
+    "other": "Other",
+};
+exports.spendCommand = new commander_1.Command("spend")
+    .description("View spend breakdown")
+    .option("-p, --project <name>", "Filter by project name")
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    if (!(0, config_1.isAuthenticated)()) {
+        (0, output_1.printError)("Not authenticated. Run " + (0, output_1.accent)("code auth login") + " first.");
+        return;
+    }
+    const spinner = (0, ora_1.default)({ text: "Fetching spend data...", color: "green" }).start();
+    // If project filter, need to resolve name -> id
+    let projectId;
+    if (opts.project) {
+        const { mockProjects } = await Promise.resolve().then(() => __importStar(require("../shared")));
+        const proj = mockProjects.find((p) => p.name === opts.project);
+        if (proj)
+            projectId = proj.id;
+    }
+    const breakdown = await (0, api_client_1.getSpendBreakdown)(projectId);
+    spinner.stop();
+    if (opts.json) {
+        (0, output_1.printJson)(breakdown);
+        return;
+    }
+    const title = opts.project ? `Spend — ${opts.project}` : "Spend Overview";
+    (0, output_1.printHeader)(title);
+    console.log();
+    console.log((0, output_1.muted)("  Total spend  ") + (0, output_1.accent)((0, shared_1.currency)(breakdown.totalSpend)));
+    console.log();
+    // By category
+    console.log((0, output_1.dim)("  By Category"));
+    const catTable = (0, output_1.createTable)(["Category", "Amount", "%"]);
+    for (const c of breakdown.byCategory) {
+        const colorFn = categoryColors[c.category] || output_1.muted;
+        catTable.push([
+            colorFn(categoryLabels[c.category] || c.category),
+            (0, shared_1.currency)(c.amount),
+            (0, output_1.dim)(c.percentage.toFixed(1) + "%"),
+        ]);
+    }
+    console.log(catTable.toString());
+    // By provider
+    console.log((0, output_1.dim)("  By Provider"));
+    const provTable = (0, output_1.createTable)(["Provider", "Amount", "%"]);
+    for (const p of breakdown.byProvider.slice(0, 8)) {
+        provTable.push([(0, output_1.muted)(p.provider), (0, shared_1.currency)(p.amount), (0, output_1.dim)(p.percentage.toFixed(1) + "%")]);
+    }
+    console.log(provTable.toString());
+    // By project (only if no project filter)
+    if (!opts.project && breakdown.byProject.length > 1) {
+        console.log((0, output_1.dim)("  By Project"));
+        const projTable = (0, output_1.createTable)(["Project", "Amount"]);
+        for (const p of breakdown.byProject) {
+            projTable.push([(0, output_1.accent)(p.projectName), (0, shared_1.currency)(p.amount)]);
+        }
+        console.log(projTable.toString());
+    }
+    console.log();
+});

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const login_1 = require("./commands/auth/login");
+const logout_1 = require("./commands/auth/logout");
+const whoami_1 = require("./commands/auth/whoami");
+const create_1 = require("./commands/project/create");
+const list_1 = require("./commands/project/list");
+const list_2 = require("./commands/card/list");
+const freeze_1 = require("./commands/card/freeze");
+const spend_1 = require("./commands/spend");
+const balance_1 = require("./commands/balance");
+const rewards_1 = require("./commands/rewards");
+const alerts_1 = require("./commands/alerts");
+const pnl_1 = require("./commands/pnl");
+const update_check_1 = require("./lib/update-check");
+const program = new commander_1.Command();
+program
+    .name("codecard")
+    .description("code_ — The financial stack for AI-native builders")
+    .version("0.1.0");
+// Auth commands
+const auth = program.command("auth").description("Authentication");
+auth.addCommand(login_1.loginCommand);
+auth.addCommand(logout_1.logoutCommand);
+auth.addCommand(whoami_1.whoamiCommand);
+// Project commands
+const project = program.command("project").description("Project management");
+project.addCommand(create_1.projectCreateCommand);
+project.addCommand(list_1.projectListCommand);
+// Card commands
+const card = program.command("card").description("Virtual card management");
+card.addCommand(list_2.cardListCommand);
+card.addCommand(freeze_1.cardFreezeCommand);
+card.addCommand(freeze_1.cardUnfreezeCommand);
+// Top-level commands
+program.addCommand(spend_1.spendCommand);
+program.addCommand(balance_1.balanceCommand);
+program.addCommand(rewards_1.rewardsCommand);
+program.addCommand(alerts_1.alertsCommand);
+program.addCommand(pnl_1.pnlCommand);
+// MCP server command
+program
+    .command("mcp")
+    .description("Start MCP server for AI agent integration (stdio transport)")
+    .action(() => {
+    require("./mcp-server");
+});
+// Check for updates in background (non-blocking)
+(0, update_check_1.checkForUpdate)("0.1.0");
+program.parse();

package/dist/lib/api-client.d.ts

@@ -0,0 +1,23 @@
+import { Project, VirtualCard, ProjectPnl, SpendBreakdown, RewardBalance, RewardTier, RewardHistory, AlertRule, AlertEvent } from "../shared";
+export declare function getProjects(): Promise<Project[]>;
+export declare function getProjectPnl(projectId: string): Promise<ProjectPnl | null>;
+export declare function createProject(name: string, description: string, budget: number): Promise<Project>;
+export declare function getCards(): Promise<VirtualCard[]>;
+export declare function freezeCard(cardId: string): Promise<VirtualCard | null>;
+export declare function unfreezeCard(cardId: string): Promise<VirtualCard | null>;
+export declare function getSpendBreakdown(projectId?: string): Promise<SpendBreakdown>;
+export declare function getBalance(): Promise<{
+    available: number;
+    pending: number;
+    creditLimit: number;
+    creditUsed: number;
+}>;
+export declare function getRewards(): Promise<{
+    balance: RewardBalance;
+    tiers: RewardTier[];
+    history: RewardHistory[];
+}>;
+export declare function getAlerts(): Promise<{
+    rules: AlertRule[];
+    events: AlertEvent[];
+}>;

package/dist/lib/api-client.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProjects = getProjects;
+exports.getProjectPnl = getProjectPnl;
+exports.createProject = createProject;
+exports.getCards = getCards;
+exports.freezeCard = freezeCard;
+exports.unfreezeCard = unfreezeCard;
+exports.getSpendBreakdown = getSpendBreakdown;
+exports.getBalance = getBalance;
+exports.getRewards = getRewards;
+exports.getAlerts = getAlerts;
+const shared_1 = require("../shared");
+const output_1 = require("./output");
+// Mutable copies for mutations within session
+const projects = [...shared_1.mockProjects];
+const cards = [...shared_1.mockCards.map((c) => ({ ...c }))];
+async function fakeLatency() {
+    await (0, output_1.delay)(200 + Math.random() * 400);
+}
+// Projects
+async function getProjects() {
+    await fakeLatency();
+    return projects;
+}
+async function getProjectPnl(projectId) {
+    await fakeLatency();
+    return shared_1.mockProjectPnls.find((p) => p.projectId === projectId) || null;
+}
+async function createProject(name, description, budget) {
+    await fakeLatency();
+    const id = `proj_${String(projects.length + 1).padStart(3, "0")}`;
+    const cardId = `card_${String(cards.length + 1).padStart(3, "0")}`;
+    const last4 = String(Math.floor(1000 + Math.random() * 9000));
+    const colors = ["#b8f036", "#5b8cff", "#a07cff", "#3ee8c8", "#ff5f8f", "#ffa044"];
+    const project = {
+        id,
+        name,
+        description,
+        status: "active",
+        color: colors[projects.length % colors.length],
+        cardId,
+        monthlyBudget: budget,
+        createdAt: new Date().toISOString(),
+    };
+    const card = {
+        id: cardId,
+        projectId: id,
+        last4,
+        cardHolder: "SARAH CHEN",
+        status: "active",
+        dailyLimit: Math.round(budget / 10),
+        monthlyLimit: budget,
+        currentMonthSpend: 0,
+        createdAt: new Date().toISOString(),
+    };
+    projects.push(project);
+    cards.push(card);
+    return project;
+}
+// Cards
+async function getCards() {
+    await fakeLatency();
+    return cards;
+}
+async function freezeCard(cardId) {
+    await fakeLatency();
+    const card = cards.find((c) => c.id === cardId);
+    if (!card)
+        return null;
+    card.status = "frozen";
+    return card;
+}
+async function unfreezeCard(cardId) {
+    await fakeLatency();
+    const card = cards.find((c) => c.id === cardId);
+    if (!card)
+        return null;
+    card.status = "active";
+    return card;
+}
+// Spend
+async function getSpendBreakdown(projectId) {
+    await fakeLatency();
+    const txns = projectId
+        ? shared_1.mockTransactions.filter((t) => t.projectId === projectId)
+        : shared_1.mockTransactions;
+    return (0, shared_1.buildSpendBreakdown)(txns, projects);
+}
+// Balance
+async function getBalance() {
+    await fakeLatency();
+    return {
+        available: 12400,
+        pending: 340,
+        creditLimit: 25000,
+        creditUsed: 7890,
+    };
+}
+// Rewards
+async function getRewards() {
+    await fakeLatency();
+    return {
+        balance: shared_1.mockRewardBalance,
+        tiers: shared_1.mockRewardTiers,
+        history: shared_1.mockRewardHistory,
+    };
+}
+// Alerts
+async function getAlerts() {
+    await fakeLatency();
+    return { rules: shared_1.mockAlertRules, events: shared_1.mockAlertEvents };
+}

package/dist/lib/config.d.ts

@@ -0,0 +1,16 @@
+import Conf from "conf";
+interface ConfigSchema {
+    token: string | null;
+    email: string | null;
+    name: string | null;
+}
+declare const config: Conf<ConfigSchema>;
+export declare function isAuthenticated(): boolean;
+export declare function getAuth(): {
+    email: string;
+    name: string;
+    token: string;
+} | null;
+export declare function setAuth(email: string, name: string, token: string): void;
+export declare function clearAuth(): void;
+export default config;

package/dist/lib/config.js

@@ -0,0 +1,40 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAuthenticated = isAuthenticated;
+exports.getAuth = getAuth;
+exports.setAuth = setAuth;
+exports.clearAuth = clearAuth;
+const conf_1 = __importDefault(require("conf"));
+const config = new conf_1.default({
+    projectName: "codecard-cli",
+    defaults: {
+        token: null,
+        email: null,
+        name: null,
+    },
+});
+function isAuthenticated() {
+    return config.get("token") !== null;
+}
+function getAuth() {
+    const token = config.get("token");
+    const email = config.get("email");
+    const name = config.get("name");
+    if (!token || !email || !name)
+        return null;
+    return { token, email, name };
+}
+function setAuth(email, name, token) {
+    config.set("token", token);
+    config.set("email", email);
+    config.set("name", name);
+}
+function clearAuth() {
+    config.set("token", null);
+    config.set("email", null);
+    config.set("name", null);
+}
+exports.default = config;

package/dist/lib/output.d.ts

@@ -0,0 +1,20 @@
+import chalk from "chalk";
+import Table from "cli-table3";
+export declare const accent: chalk.Chalk;
+export declare const muted: chalk.Chalk;
+export declare const dim: chalk.Chalk;
+export declare const pink: chalk.Chalk;
+export declare const blue: chalk.Chalk;
+export declare const purple: chalk.Chalk;
+export declare const cyan: chalk.Chalk;
+export declare const orange: chalk.Chalk;
+export declare function printHeader(text: string): void;
+export declare function printSuccess(text: string): void;
+export declare function printError(text: string): void;
+export declare function printWarning(text: string): void;
+export declare function printInfo(text: string): void;
+export declare function printRow(label: string, value: string): void;
+export declare function createTable(headers: string[]): Table.Table;
+export declare function printJson(data: unknown): void;
+export declare function printJsonError(error: string): void;
+export declare function delay(ms: number): Promise<void>;

package/dist/lib/output.js

@@ -0,0 +1,69 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.orange = exports.cyan = exports.purple = exports.blue = exports.pink = exports.dim = exports.muted = exports.accent = void 0;
+exports.printHeader = printHeader;
+exports.printSuccess = printSuccess;
+exports.printError = printError;
+exports.printWarning = printWarning;
+exports.printInfo = printInfo;
+exports.printRow = printRow;
+exports.createTable = createTable;
+exports.printJson = printJson;
+exports.printJsonError = printJsonError;
+exports.delay = delay;
+const chalk_1 = __importDefault(require("chalk"));
+const cli_table3_1 = __importDefault(require("cli-table3"));
+exports.accent = chalk_1.default.hex("#b8f036");
+exports.muted = chalk_1.default.hex("#9490a8");
+exports.dim = chalk_1.default.hex("#5e5a72");
+exports.pink = chalk_1.default.hex("#ff5f8f");
+exports.blue = chalk_1.default.hex("#5b8cff");
+exports.purple = chalk_1.default.hex("#a07cff");
+exports.cyan = chalk_1.default.hex("#3ee8c8");
+exports.orange = chalk_1.default.hex("#ffa044");
+function printHeader(text) {
+    console.log();
+    console.log(exports.accent.bold("  code_") + (0, exports.dim)(" │ ") + chalk_1.default.white(text));
+    console.log((0, exports.dim)("  " + "─".repeat(50)));
+}
+function printSuccess(text) {
+    console.log((0, exports.accent)("  ✓ ") + text);
+}
+function printError(text) {
+    console.log((0, exports.pink)("  ✗ ") + text);
+    process.exitCode = 1;
+}
+function printWarning(text) {
+    console.log((0, exports.orange)("  ⚠ ") + text);
+}
+function printInfo(text) {
+    console.log((0, exports.blue)("  ℹ ") + text);
+}
+function printRow(label, value) {
+    console.log((0, exports.muted)("  " + label.padEnd(22)) + chalk_1.default.white(value));
+}
+function createTable(headers) {
+    return new cli_table3_1.default({
+        head: headers.map((h) => (0, exports.dim)(h)),
+        chars: {
+            top: "", "top-mid": "", "top-left": "", "top-right": "",
+            bottom: "", "bottom-mid": "", "bottom-left": "", "bottom-right": "",
+            left: "  ", "left-mid": "", mid: "─", "mid-mid": "─",
+            right: "", "right-mid": "", middle: (0, exports.dim)(" │ "),
+        },
+        style: { "padding-left": 1, "padding-right": 1, head: [], border: [] },
+    });
+}
+function printJson(data) {
+    console.log(JSON.stringify(data, null, 2));
+}
+function printJsonError(error) {
+    console.log(JSON.stringify({ success: false, error }, null, 2));
+    process.exitCode = 1;
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/dist/lib/update-check.d.ts

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

package/dist/lib/update-check.js

@@ -0,0 +1,74 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkForUpdate = checkForUpdate;
+const chalk_1 = __importDefault(require("chalk"));
+const output_1 = require("./output");
+const PACKAGE_NAME = "codecard-cli";
+const CHECK_INTERVAL = 24 * 60 * 60 * 1000; // 24 hours
+async function checkForUpdate(currentVersion) {
+    try {
+        // Check if we should check (throttle to once per day)
+        const Conf = (await Promise.resolve().then(() => __importStar(require("conf")))).default;
+        const config = new Conf({ projectName: "codecard-cli-update" });
+        const lastCheck = config.get("lastUpdateCheck", 0);
+        if (Date.now() - lastCheck < CHECK_INTERVAL)
+            return;
+        config.set("lastUpdateCheck", Date.now());
+        // Fetch latest version from npm
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 3000);
+        const res = await fetch(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`, { signal: controller.signal });
+        clearTimeout(timeout);
+        if (!res.ok)
+            return;
+        const data = (await res.json());
+        const latest = data.version;
+        if (latest && latest !== currentVersion) {
+            console.log();
+            console.log((0, output_1.dim)("  ┌─────────────────────────────────────────┐"));
+            console.log((0, output_1.dim)("  │") + "  Update available: " + (0, output_1.dim)(currentVersion) + " → " + (0, output_1.accent)(latest) + (0, output_1.dim)("  │"));
+            console.log((0, output_1.dim)("  │") + "  Run " + chalk_1.default.white(`npm i -g ${PACKAGE_NAME}`) + " to update" + (0, output_1.dim)("  │"));
+            console.log((0, output_1.dim)("  └���────────────────────────────────────────┘"));
+            console.log();
+        }
+    }
+    catch {
+        // Silently fail — never block the CLI for update checks
+    }
+}

package/dist/mcp-server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};