@farthershore/cli 0.3.6 → 0.3.8

package/dist/commands/helpers.js

@@ -0,0 +1,93 @@
+import { loadConfig } from "../config.js";
+import * as output from "../output.js";
+export function commandFormat(program) {
+    return output.outputFormat(program.opts().format);
+}
+export function printResult(program, humanMessage, payload) {
+    if (commandFormat(program) === "json") {
+        console.log(output.json(payload));
+        return;
+    }
+    output.success(humanMessage);
+}
+export async function resolveProductId(client, productArg) {
+    const config = loadConfig();
+    if (productArg) {
+        if (productArg.length === 36)
+            return productArg;
+        const products = client.isMakerToken()
+            ? await client.managementListProducts()
+            : await client.listProducts();
+        const product = products.find((p) => p.id === productArg ||
+            p.name.toLowerCase() === productArg.toLowerCase());
+        if (product)
+            return product.id;
+    }
+    if (config.activeProductId)
+        return config.activeProductId;
+    throw new Error("No product selected. Pass --product <id-or-name> or run `farthershore product create` first.");
+}
+export async function resolvePlanId(client, productId, planArg) {
+    if (planArg.length === 36)
+        return planArg;
+    const products = client.isMakerToken()
+        ? await client.managementListProducts()
+        : await client.listProducts();
+    const product = products.find((p) => p.id === productId);
+    const plan = product?.plans?.find((p) => p.id === planArg ||
+        p.key === planArg ||
+        p.name.toLowerCase() === planArg.toLowerCase());
+    if (!plan)
+        throw new Error(`Plan "${planArg}" not found`);
+    return plan.id;
+}
+export async function loadAcceptedSpec(client, productId) {
+    const config = (await client.getProductConfig(productId));
+    if (!config.acceptedConfig ||
+        typeof config.acceptedConfig !== "object" ||
+        Array.isArray(config.acceptedConfig)) {
+        throw new Error("Product has no accepted internal config yet.");
+    }
+    return config.acceptedConfig;
+}
+export function plans(spec) {
+    if (!Array.isArray(spec.plans))
+        spec.plans = [];
+    return spec.plans;
+}
+export function objectAt(parent, key) {
+    const current = parent[key];
+    if (current && typeof current === "object" && !Array.isArray(current)) {
+        return current;
+    }
+    const next = {};
+    parent[key] = next;
+    return next;
+}
+export function stringArrayAt(parent, key) {
+    if (!Array.isArray(parent[key]))
+        parent[key] = [];
+    const values = parent[key];
+    const strings = values.filter((value) => typeof value === "string");
+    if (strings.length !== values.length)
+        parent[key] = strings;
+    return parent[key];
+}
+export function findPlan(spec, planKey) {
+    const plan = plans(spec).find((candidate) => candidate.key === planKey);
+    if (!plan)
+        throw new Error(`Plan "${planKey}" not found`);
+    return plan;
+}
+export async function updateSpec(program, client, productId, spec, opts) {
+    const result = await client.updateProductConfig(productId, spec, {
+        dryRun: opts?.dryRun,
+    });
+    printResult(program, opts?.message ?? "Product config updated", {
+        ok: true,
+        productId,
+        dryRun: opts?.dryRun === true,
+        ...(typeof result === "object" && result ? result : {}),
+    });
+    return result;
+}

package/dist/commands/login.js

@@ -4,48 +4,18 @@ import { loadConfig, saveConfig, saveCredentials, clearCredentials, } from "../c
 import { resolveToken } from "../auth.js";
 import * as output from "../output.js";
 export function registerAuthCommands(program) {
+    const auth = program.command("auth").description("Manage authentication");
+    auth
+        .command("set-key [token]")
+        .description("Set your API token")
+        .action(async (tokenArg) => {
+        await setKey(tokenArg);
+    });
     program
         .command("set-key [token]")
         .description("Set your API token (interactive or pass as argument)")
         .action(async (tokenArg) => {
-        let token = tokenArg?.trim();
-        if (!token) {
-            // Interactive mode
-            if (!process.stdin.isTTY) {
-                output.error("No token provided. Pass it as an argument: farthershore set-key <token>");
-                process.exitCode = 1;
-                return;
-            }
-            console.log("Set your FartherShore API token\n");
-            console.log("  Create a token at https://farthershore.com/settings/tokens\n");
-            const rl = readline.createInterface({
-                input: process.stdin,
-                output: process.stdout,
-            });
-            token = (await rl.question("Token: ")).trim();
-            rl.close();
-        }
-        if (!token) {
-            output.error("No token provided.");
-            process.exitCode = 1;
-            return;
-        }
-        const config = loadConfig();
-        try {
-            const client = createClient({ apiUrl: config.apiUrl, token });
-            const ctx = await client.bootstrap();
-            saveCredentials({
-                token,
-                orgId: ctx.activeOrganization.id,
-                userId: ctx.user.id,
-            });
-            output.success("Authenticated");
-            console.log(`  Organization: ${ctx.activeOrganization.name ?? ctx.activeOrganization.id}`);
-        }
-        catch {
-            output.error("Invalid token. Check it and try again.");
-            process.exitCode = 1;
-        }
+        await setKey(tokenArg);
     });
     program
         .command("logout")
@@ -118,3 +88,42 @@ export function registerAuthCommands(program) {
         output.success("API URL reset to https://core.farthershore.com");
     });
 }
+async function setKey(tokenArg) {
+    let token = tokenArg?.trim();
+    if (!token) {
+        if (!process.stdin.isTTY) {
+            output.error("No token provided. Pass it as an argument: farthershore auth set-key <token>");
+            process.exitCode = 1;
+            return;
+        }
+        console.log("Set your FartherShore API token\n");
+        console.log("  Create a token at https://farthershore.com/settings/tokens\n");
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        token = (await rl.question("Token: ")).trim();
+        rl.close();
+    }
+    if (!token) {
+        output.error("No token provided.");
+        process.exitCode = 1;
+        return;
+    }
+    const config = loadConfig();
+    try {
+        const client = createClient({ apiUrl: config.apiUrl, token });
+        const ctx = await client.bootstrap();
+        saveCredentials({
+            token,
+            orgId: ctx.activeOrganization.id,
+            userId: ctx.user.id,
+        });
+        output.success("Authenticated");
+        console.log(`  Organization: ${ctx.activeOrganization.name ?? ctx.activeOrganization.id}`);
+    }
+    catch {
+        output.error("Invalid token. Check it and try again.");
+        process.exitCode = 1;
+    }
+}

package/dist/commands/meter.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+import type { ApiClient } from "../client.js";
+export declare function registerMeterCommands(program: Command, getClient: () => ApiClient): void;

package/dist/commands/meter.js

@@ -0,0 +1,94 @@
+import { loadAcceptedSpec, objectAt, printResult, resolveProductId, updateSpec, } from "./helpers.js";
+export function registerMeterCommands(program, getClient) {
+    const meter = program.command("meter").description("Manage usage meters");
+    meter
+        .command("list")
+        .option("--product <product>", "Product id or name")
+        .action(async (opts) => {
+        const client = getClient();
+        const productId = await resolveProductId(client, opts.product);
+        const spec = await loadAcceptedSpec(client, productId);
+        const usage = objectAt(spec, "usage");
+        printResult(program, "Meters loaded", {
+            ok: true,
+            productId,
+            meters: objectAt(usage, "meters"),
+        });
+    });
+    meter
+        .command("add <key>")
+        .option("--product <product>", "Product id or name")
+        .option("--selector <field>", "Selector field, for example model")
+        .option("--measure <measure>", "Measure name; repeatable", collect, [])
+        .option("--rating <source>", "Rating source", "fixed")
+        .option("--catalog <catalog>", "Catalog key for provider_catalog rating")
+        .option("--resolver <resolver>", "Resolver id for external/custom rating")
+        .option("--amount-field <path>", "Amount field for upstream_reported rating")
+        .option("--currency-field <path>", "Currency field for upstream_reported rating")
+        .option("--dry-run", "Validate without mutating")
+        .action(async (key, opts) => {
+        const client = getClient();
+        const productId = await resolveProductId(client, opts.product);
+        const spec = await loadAcceptedSpec(client, productId);
+        const usage = objectAt(spec, "usage");
+        const meters = objectAt(usage, "meters");
+        meters[key] = {
+            ...(opts.selector ? { selector: opts.selector } : {}),
+            measures: opts.measure.length > 0 ? opts.measure : ["count"],
+            rating: ratingFromOptions(opts),
+        };
+        await updateSpec(program, client, productId, spec, {
+            dryRun: opts.dryRun,
+            message: `Meter "${key}" saved`,
+        });
+    });
+    meter
+        .command("rating set <key>")
+        .option("--product <product>", "Product id or name")
+        .requiredOption("--rating <source>", "Rating source")
+        .option("--catalog <catalog>", "Catalog key for provider_catalog rating")
+        .option("--resolver <resolver>", "Resolver id for external/custom rating")
+        .option("--amount-field <path>", "Amount field for upstream_reported rating")
+        .option("--currency-field <path>", "Currency field for upstream_reported rating")
+        .option("--dry-run", "Validate without mutating")
+        .action(async (key, opts) => {
+        const client = getClient();
+        const productId = await resolveProductId(client, opts.product);
+        const spec = await loadAcceptedSpec(client, productId);
+        const usage = objectAt(spec, "usage");
+        const meters = objectAt(usage, "meters");
+        const current = meters[key];
+        if (!current || typeof current !== "object" || Array.isArray(current)) {
+            throw new Error(`Meter "${key}" not found`);
+        }
+        current.rating = ratingFromOptions(opts);
+        await updateSpec(program, client, productId, spec, {
+            dryRun: opts.dryRun,
+            message: `Meter "${key}" rating saved`,
+        });
+    });
+}
+function collect(value, previous) {
+    previous.push(value);
+    return previous;
+}
+function ratingFromOptions(opts) {
+    if (opts.rating === "provider_catalog") {
+        return {
+            source: opts.rating,
+            catalog: opts.catalog ?? "default",
+            pricePolicy: "pass_through",
+        };
+    }
+    if (opts.rating === "upstream_reported") {
+        return {
+            source: opts.rating,
+            amountField: opts.amountField ?? "usage.cost_micros",
+            ...(opts.currencyField ? { currencyField: opts.currencyField } : {}),
+        };
+    }
+    if (opts.rating === "external_rate_api" || opts.rating === "custom") {
+        return { source: opts.rating, resolver: opts.resolver ?? "default" };
+    }
+    return { source: "fixed", rates: {} };
+}

package/dist/commands/plan-transition.d.ts

@@ -0,0 +1,40 @@
+import { Command } from "commander";
+type ChangeKind = "strategy_changed" | "price_increase" | "price_decrease" | "feature_added" | "feature_removed" | "limit_increased" | "limit_reduced" | "credit_increased" | "credit_reduced" | "rating_changed" | "plan_added" | "plan_removed";
+type SubscriberAction = "preserve_current_period" | "switch_immediately" | "switch_immediately_prorate" | "new_subscribers_only";
+type TransitionChange = {
+    kind: ChangeKind;
+    planKey?: string;
+    meter?: string;
+    feature?: string;
+    from?: unknown;
+    to?: unknown;
+    subscriberAction: SubscriberAction;
+    requiresAcknowledgment: boolean;
+    message: string;
+};
+type TransitionAnalysis = {
+    valid: boolean;
+    from: string;
+    to: string;
+    strategy: {
+        from?: string;
+        to?: string;
+    };
+    policy: {
+        default: SubscriberAction;
+        proration: string;
+        when: Record<string, SubscriberAction>;
+    };
+    changes: TransitionChange[];
+    errors: string[];
+    warnings: string[];
+    agentHints: string[];
+};
+export declare function analyzePlanTransition(options: {
+    fromSpec: unknown;
+    toSpec: unknown;
+    fromLabel?: string;
+    toLabel?: string;
+}): TransitionAnalysis;
+export declare function registerPlanTransitionCommand(program: Command): void;
+export {};