faces-cli 1.6.5 → 1.6.7

package/dist/commands/billing/quota.js

@@ -1,24 +1,12 @@
 import { BaseCommand } from '../../base.js';
-import { FacesAPIError } from '../../client.js';
 export default class BillingQuota extends BaseCommand {
-    static description = 'Show compile token quota and per-face stats';
+    static description = 'Show compilation stats per face (deprecated — use compile:stats)';
     static flags = {
         ...BaseCommand.baseFlags,
     };
     async run() {
-        const { flags } = await this.parse(BillingQuota);
-        const client = this.makeClient(flags);
-        let data;
-        try {
-            data = await client.get('/v1/billing/compile-quota');
-        }
-        catch (err) {
-            if (err instanceof FacesAPIError)
-                this.error(`Error (${err.statusCode}): ${err.message}`);
-            throw err;
-        }
-        if (!this.jsonEnabled())
-            this.printHuman(data);
-        return data;
+        process.stderr.write('Note: billing:quota is deprecated. Use compile:stats instead.\n');
+        await this.config.runCommand('compile:stats', this.argv);
+        return {};
     }
 }

package/dist/commands/billing/{checkout.d.ts → subscription/activate.d.ts}

@@ -1,5 +1,5 @@
-import { BaseCommand } from '../../base.js';
-export default class BillingCheckout extends BaseCommand {
+import { BaseCommand } from '../../../base.js';
+export default class BillingSubscriptionActivate extends BaseCommand {
     static description: string;
     static flags: {
         plan: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/billing/subscription/activate.js

@@ -0,0 +1,75 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../../base.js';
+import { FacesAPIError } from '../../../client.js';
+export default class BillingSubscriptionActivate extends BaseCommand {
+    static description = 'Activate or reactivate a subscription plan';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        plan: Flags.string({
+            description: 'Plan to activate',
+            options: ['connect'],
+            default: 'connect',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(BillingSubscriptionActivate);
+        const client = this.makeClient(flags);
+        const json = this.jsonEnabled();
+        // Fetch current state
+        let sub;
+        try {
+            sub = await client.get('/v1/billing/subscription');
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        const plan = sub.plan;
+        const cancelAtPeriodEnd = sub.cancel_at_period_end;
+        // Already active Connect, not pending cancel
+        if (plan === 'connect' && !cancelAtPeriodEnd) {
+            if (!json)
+                this.log('Already on the Connect plan.');
+            return { status: 'already_active', plan: 'connect' };
+        }
+        // Pending cancel — reactivate instead of creating a new checkout
+        if (plan === 'connect' && cancelAtPeriodEnd) {
+            let data;
+            try {
+                data = await client.post('/v1/billing/subscription/reactivate');
+            }
+            catch (err) {
+                if (err instanceof FacesAPIError)
+                    this.error(`Error (${err.statusCode}): ${err.message}`);
+                throw err;
+            }
+            const result = data;
+            if (!json) {
+                this.log(`Reactivated. Connect plan continues — next renewal: ${result.current_period_end ?? 'unknown'}.`);
+            }
+            return { status: 'reactivated', ...result };
+        }
+        // Free plan — create checkout
+        let data;
+        try {
+            data = await client.post(`/v1/billing/checkout?plan=${flags.plan}&source=cli`);
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        const result = data;
+        const url = result.checkout_url;
+        if (!json) {
+            this.log('Subscription Connect — $17/month');
+            this.log('');
+            this.log('Complete payment at this link:');
+            this.log(`  ${url}`);
+            this.log('');
+            this.log('After payment, verify with: faces billing:subscription');
+        }
+        return { status: 'checkout_created', checkout_url: url };
+    }
+}

package/dist/commands/billing/subscription/cancel.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../../base.js';
+export default class BillingSubscriptionCancel extends BaseCommand {
+    static description: string;
+    static flags: {
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+    private confirm;
+}

package/dist/commands/billing/subscription/cancel.js

@@ -0,0 +1,68 @@
+import { Flags } from '@oclif/core';
+import { createInterface } from 'node:readline';
+import { BaseCommand } from '../../../base.js';
+import { FacesAPIError } from '../../../client.js';
+export default class BillingSubscriptionCancel extends BaseCommand {
+    static description = 'Cancel your subscription (keeps access until period end)';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        yes: Flags.boolean({ description: 'Skip confirmation', default: false }),
+    };
+    async run() {
+        const { flags } = await this.parse(BillingSubscriptionCancel);
+        const client = this.makeClient(flags);
+        const json = this.jsonEnabled();
+        // Fetch current state
+        let sub;
+        try {
+            sub = await client.get('/v1/billing/subscription');
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        const plan = sub.plan;
+        if (plan === 'free') {
+            if (!json)
+                this.log('No active subscription to cancel (currently on pay-per-token plan).');
+            return { status: 'no_subscription' };
+        }
+        if (sub.cancel_at_period_end) {
+            if (!json)
+                this.log(`Already canceled. Connect access ends ${sub.current_period_end ?? 'at period end'}.`);
+            return { status: 'already_canceled', current_period_end: sub.current_period_end };
+        }
+        // Confirm
+        if (!flags.yes) {
+            const periodEnd = sub.current_period_end ?? 'period end';
+            const confirmed = await this.confirm(`Cancel Connect plan? You'll keep access until ${periodEnd}.`);
+            if (!confirmed)
+                this.error('Aborted.');
+        }
+        let data;
+        try {
+            data = await client.post('/v1/billing/subscription/cancel');
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        const result = data;
+        if (!json) {
+            this.log(`Canceled. Connect access continues until ${result.current_period_end ?? 'period end'}.`);
+            this.log('To reactivate before then: faces billing:subscription:activate');
+        }
+        return { status: 'canceled', ...result };
+    }
+    confirm(message) {
+        return new Promise((resolve) => {
+            const rl = createInterface({ input: process.stdin, output: process.stdout });
+            rl.question(`${message} [y/N] `, (answer) => {
+                rl.close();
+                resolve(answer.toLowerCase() === 'y');
+            });
+        });
+    }
+}

package/dist/commands/billing/subscription/index.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from '../../../base.js';
+export default class BillingSubscription extends BaseCommand {
+    static description: string;
+    static flags: {
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/billing/subscription/index.js

@@ -0,0 +1,24 @@
+import { BaseCommand } from '../../../base.js';
+import { FacesAPIError } from '../../../client.js';
+export default class BillingSubscription extends BaseCommand {
+    static description = 'Show current plan, face count, and renewal date';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { flags } = await this.parse(BillingSubscription);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.get('/v1/billing/subscription');
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+}

package/dist/commands/compile/stats.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from '../../base.js';
+export default class CompileStats extends BaseCommand {
+    static description: string;
+    static flags: {
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/compile/stats.js

@@ -0,0 +1,34 @@
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class CompileStats extends BaseCommand {
+    static description = 'Show compilation stats per face';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { flags } = await this.parse(CompileStats);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.get('/v1/billing/compile-quota');
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        // Rename face_id → alias in the faces array
+        const resp = data;
+        if (Array.isArray(resp.faces)) {
+            for (const f of resp.faces) {
+                if (f.face_id !== undefined) {
+                    f.alias = f.face_id;
+                    delete f.face_id;
+                }
+            }
+        }
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+}

package/oclif.manifest.json

@@ -120,23 +120,10 @@
         "state.js"
       ]
     },
-    "auth:connect": {
+    "billing:balance": {
       "aliases": [],
-      "args": {
-        "provider": {
-          "description": "OAuth provider to connect",
-          "name": "provider",
-          "options": [
-            "openai"
-          ],
-          "required": true
-        }
-      },
-      "description": "Connect an OAuth provider account to Faces (e.g. ChatGPT Plus/Pro)",
-      "examples": [
-        "<%= config.bin %> auth connect openai",
-        "<%= config.bin %> auth connect openai --manual"
-      ],
+      "args": {},
+      "description": "Show credit balance and payment method status",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -168,17 +155,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "manual": {
-          "description": "Manual mode for headless environments: prints the authorize URL and prompts you to paste the callback URL after approving in any browser.",
-          "name": "manual",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:connect",
+      "id": "billing:balance",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -188,18 +169,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "connect.js"
+        "billing",
+        "balance.js"
       ]
     },
-    "auth:connections": {
+    "billing:card-setup": {
       "aliases": [],
       "args": {},
-      "description": "List connected OAuth provider accounts",
-      "examples": [
-        "<%= config.bin %> auth connections",
-        "<%= config.bin %> auth connections --json"
-      ],
+      "description": "Get a Stripe card setup URL to save a payment method",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -235,7 +212,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:connections",
+      "id": "billing:card-setup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -245,26 +222,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "connections.js"
+        "billing",
+        "card-setup.js"
       ]
     },
-    "auth:disconnect": {
+    "billing:llm-costs": {
       "aliases": [],
-      "args": {
-        "provider": {
-          "description": "OAuth provider to disconnect",
-          "name": "provider",
-          "options": [
-            "openai"
-          ],
-          "required": true
-        }
-      },
-      "description": "Disconnect a linked OAuth provider account",
-      "examples": [
-        "<%= config.bin %> auth disconnect openai"
-      ],
+      "args": {},
+      "description": "List available LLMs and their per-token costs",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -296,11 +261,18 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "provider": {
+          "description": "Filter by provider (e.g. openai, anthropic)",
+          "name": "provider",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:disconnect",
+      "id": "billing:llm-costs",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -310,14 +282,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "disconnect.js"
+        "billing",
+        "llm-costs.js"
       ]
     },
-    "auth:login": {
+    "billing:quota": {
       "aliases": [],
       "args": {},
-      "description": "Login and save JWT credentials",
+      "description": "Show compilation stats per face (deprecated — use compile:stats)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -349,27 +321,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "email": {
-          "description": "Account email",
-          "name": "email",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "password": {
-          "description": "Account password",
-          "name": "password",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:login",
+      "id": "billing:quota",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -379,14 +335,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "login.js"
+        "billing",
+        "quota.js"
       ]
     },
-    "auth:logout": {
+    "billing:subscription": {
       "aliases": [],
       "args": {},
-      "description": "Clear saved credentials",
+      "description": "Show current plan, face count, and renewal date",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -422,7 +378,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:logout",
+      "id": "billing:subscription",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -432,14 +388,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "logout.js"
+        "billing",
+        "subscription.js"
       ]
     },
-    "auth:refresh": {
+    "billing:topup": {
       "aliases": [],
       "args": {},
-      "description": "Exchange current JWT for a fresh one",
+      "description": "Top up credit balance using saved payment method",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -471,11 +427,26 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "amount": {
+          "description": "Top-up amount in USD (min $1)",
+          "name": "amount",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "payment-ref": {
+          "description": "Payment reference (admin/test path)",
+          "name": "payment-ref",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:refresh",
+      "id": "billing:topup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -485,14 +456,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "refresh.js"
+        "billing",
+        "topup.js"
       ]
     },
-    "auth:register": {
+    "billing:usage": {
       "aliases": [],
       "args": {},
-      "description": "Create a new Faces account",
+      "description": "Aggregated usage analytics",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -525,53 +496,37 @@
           "multiple": false,
           "type": "option"
         },
-        "email": {
-          "description": "Email address",
-          "name": "email",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "password": {
-          "description": "Password",
-          "name": "password",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "username": {
-          "description": "Username (lowercase, dashes, numbers)",
-          "name": "username",
-          "required": true,
+        "group-by": {
+          "description": "Group results",
+          "name": "group-by",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "api_key",
+            "model",
+            "llm",
+            "date"
+          ],
           "type": "option"
         },
-        "invite-key": {
-          "description": "Invite key (if required)",
-          "name": "invite-key",
+        "from": {
+          "description": "Start date (YYYY-MM-DD)",
+          "name": "from",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "plan": {
-          "description": "Plan to subscribe to: \"free\" ($5 activation) or \"connect\" ($17/mo, no activation fee)",
-          "name": "plan",
-          "default": "free",
+        "to": {
+          "description": "End date (YYYY-MM-DD)",
+          "name": "to",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "free",
-            "connect"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:register",
+      "id": "billing:usage",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -581,14 +536,27 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "register.js"
+        "billing",
+        "usage.js"
       ]
     },
-    "auth:whoami": {
+    "auth:connect": {
       "aliases": [],
-      "args": {},
-      "description": "Print current user profile and auth diagnostic",
+      "args": {
+        "provider": {
+          "description": "OAuth provider to connect",
+          "name": "provider",
+          "options": [
+            "openai"
+          ],
+          "required": true
+        }
+      },
+      "description": "Connect an OAuth provider account to Faces (e.g. ChatGPT Plus/Pro)",
+      "examples": [
+        "<%= config.bin %> auth connect openai",
+        "<%= config.bin %> auth connect openai --manual"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -620,11 +588,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "manual": {
+          "description": "Manual mode for headless environments: prints the authorize URL and prompts you to paste the callback URL after approving in any browser.",
+          "name": "manual",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:whoami",
+      "id": "auth:connect",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -635,13 +609,17 @@
         "dist",
         "commands",
         "auth",
-        "whoami.js"
+        "connect.js"
       ]
     },
-    "billing:balance": {
+    "auth:connections": {
       "aliases": [],
       "args": {},
-      "description": "Show credit balance and payment method status",
+      "description": "List connected OAuth provider accounts",
+      "examples": [
+        "<%= config.bin %> auth connections",
+        "<%= config.bin %> auth connections --json"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -677,7 +655,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:balance",
+      "id": "auth:connections",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -687,14 +665,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "balance.js"
+        "auth",
+        "connections.js"
       ]
     },
-    "billing:card-setup": {
+    "auth:disconnect": {
       "aliases": [],
-      "args": {},
-      "description": "Get a Stripe card setup URL to save a payment method",
+      "args": {
+        "provider": {
+          "description": "OAuth provider to disconnect",
+          "name": "provider",
+          "options": [
+            "openai"
+          ],
+          "required": true
+        }
+      },
+      "description": "Disconnect a linked OAuth provider account",
+      "examples": [
+        "<%= config.bin %> auth disconnect openai"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -730,7 +720,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:card-setup",
+      "id": "auth:disconnect",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -740,14 +730,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "card-setup.js"
+        "auth",
+        "disconnect.js"
       ]
     },
-    "billing:checkout": {
+    "auth:login": {
       "aliases": [],
       "args": {},
-      "description": "Get a Stripe checkout URL to upgrade your subscription plan",
+      "description": "Login and save JWT credentials",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -780,73 +770,18 @@
           "multiple": false,
           "type": "option"
         },
-        "plan": {
-          "description": "Plan to subscribe to",
-          "name": "plan",
-          "default": "connect",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "connect"
-          ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "billing:checkout",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "billing",
-        "checkout.js"
-      ]
-    },
-    "billing:llm-costs": {
-      "aliases": [],
-      "args": {},
-      "description": "List available LLMs and their per-token costs",
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "base-url": {
-          "description": "API base URL",
-          "env": "FACES_BASE_URL",
-          "name": "base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
+        "email": {
+          "description": "Account email",
+          "name": "email",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "provider": {
-          "description": "Filter by provider (e.g. openai, anthropic)",
-          "name": "provider",
+        "password": {
+          "description": "Account password",
+          "name": "password",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -854,7 +789,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:llm-costs",
+      "id": "auth:login",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -864,14 +799,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "llm-costs.js"
+        "auth",
+        "login.js"
       ]
     },
-    "billing:quota": {
+    "auth:logout": {
       "aliases": [],
       "args": {},
-      "description": "Show compile token quota and per-face stats",
+      "description": "Clear saved credentials",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -907,7 +842,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:quota",
+      "id": "auth:logout",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -917,14 +852,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "quota.js"
+        "auth",
+        "logout.js"
       ]
     },
-    "billing:subscription": {
+    "auth:refresh": {
       "aliases": [],
       "args": {},
-      "description": "Show current plan, face count, and renewal date",
+      "description": "Exchange current JWT for a fresh one",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -960,7 +895,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:subscription",
+      "id": "auth:refresh",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -970,14 +905,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "subscription.js"
+        "auth",
+        "refresh.js"
       ]
     },
-    "billing:topup": {
+    "auth:register": {
       "aliases": [],
       "args": {},
-      "description": "Top up credit balance using saved payment method",
+      "description": "Create a new Faces account",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1010,25 +945,53 @@
           "multiple": false,
           "type": "option"
         },
-        "amount": {
-          "description": "Top-up amount in USD (min $1)",
-          "name": "amount",
+        "email": {
+          "description": "Email address",
+          "name": "email",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "payment-ref": {
-          "description": "Payment reference (admin/test path)",
-          "name": "payment-ref",
+        "password": {
+          "description": "Password",
+          "name": "password",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "username": {
+          "description": "Username (lowercase, dashes, numbers)",
+          "name": "username",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "invite-key": {
+          "description": "Invite key (if required)",
+          "name": "invite-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "plan": {
+          "description": "Plan to subscribe to: \"free\" ($5 activation) or \"connect\" ($17/mo, no activation fee)",
+          "name": "plan",
+          "default": "free",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "free",
+            "connect"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:topup",
+      "id": "auth:register",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1038,14 +1001,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "topup.js"
+        "auth",
+        "register.js"
       ]
     },
-    "billing:usage": {
+    "auth:whoami": {
       "aliases": [],
       "args": {},
-      "description": "Aggregated usage analytics",
+      "description": "Print current user profile and auth diagnostic",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1077,38 +1040,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "group-by": {
-          "description": "Group results",
-          "name": "group-by",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "api_key",
-            "model",
-            "llm",
-            "date"
-          ],
-          "type": "option"
-        },
-        "from": {
-          "description": "Start date (YYYY-MM-DD)",
-          "name": "from",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "to": {
-          "description": "End date (YYYY-MM-DD)",
-          "name": "to",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:usage",
+      "id": "auth:whoami",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1118,8 +1054,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "usage.js"
+        "auth",
+        "whoami.js"
       ]
     },
     "catalog:backup": {
@@ -1905,6 +1841,59 @@
         "import.js"
       ]
     },
+    "compile:stats": {
+      "aliases": [],
+      "args": {},
+      "description": "Show compilation stats per face",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "compile:stats",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "compile",
+        "stats.js"
+      ]
+    },
     "compile:upload": {
       "aliases": [],
       "args": {
@@ -3863,6 +3852,131 @@
         "update.js"
       ]
     },
+    "billing:subscription:activate": {
+      "aliases": [],
+      "args": {},
+      "description": "Activate or reactivate a subscription plan",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "plan": {
+          "description": "Plan to activate",
+          "name": "plan",
+          "default": "connect",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "connect"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "billing:subscription:activate",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "billing",
+        "subscription",
+        "activate.js"
+      ]
+    },
+    "billing:subscription:cancel": {
+      "aliases": [],
+      "args": {},
+      "description": "Cancel your subscription (keeps access until period end)",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "billing:subscription:cancel",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "billing",
+        "subscription",
+        "cancel.js"
+      ]
+    },
     "compile:doc:create": {
       "aliases": [],
       "args": {
@@ -5780,5 +5894,5 @@
       ]
     }
   },
-  "version": "1.6.5"
+  "version": "1.6.7"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "faces-cli",
-  "version": "1.6.5",
+  "version": "1.6.7",
   "description": "CLI for the Faces AI platform",
   "type": "module",
   "author": "sybileak <sybileak@proton.me>",

package/dist/commands/billing/checkout.js

@@ -1,30 +0,0 @@
-import { Flags } from '@oclif/core';
-import { BaseCommand } from '../../base.js';
-import { FacesAPIError } from '../../client.js';
-export default class BillingCheckout extends BaseCommand {
-    static description = 'Get a Stripe checkout URL to upgrade your subscription plan';
-    static flags = {
-        ...BaseCommand.baseFlags,
-        plan: Flags.string({
-            description: 'Plan to subscribe to',
-            options: ['connect'],
-            default: 'connect',
-        }),
-    };
-    async run() {
-        const { flags } = await this.parse(BillingCheckout);
-        const client = this.makeClient(flags);
-        let data;
-        try {
-            data = await client.post(`/v1/billing/checkout?plan=${flags.plan}&source=cli`);
-        }
-        catch (err) {
-            if (err instanceof FacesAPIError)
-                this.error(`Error (${err.statusCode}): ${err.message}`);
-            throw err;
-        }
-        if (!this.jsonEnabled())
-            this.printHuman(data);
-        return data;
-    }
-}