@farthershore/cli 0.3.6 → 0.3.8

package/dist/commands/product.js

@@ -0,0 +1,101 @@
+import { saveConfig } from "../config.js";
+import * as output from "../output.js";
+import { commandFormat, printResult, resolveProductId } from "./helpers.js";
+export function registerProductCommands(program, getClient) {
+    const product = program.command("product").description("Manage products");
+    product
+        .command("create <name>")
+        .description("Create a product and select it for subsequent CLI commands")
+        .requiredOption("--base-url <url>", "Backend API base URL")
+        .option("--strategy <strategy>", "Product billing strategy", "flat_subscription")
+        .option("--description <desc>", "Product description")
+        .option("--display-name <name>", "Display name")
+        .option("--dry-run", "Print the create request without mutating")
+        .action(async (name, opts) => {
+        if (opts.dryRun) {
+            printResult(program, "Product create dry run", {
+                ok: true,
+                dryRun: true,
+                proposal: {
+                    name,
+                    baseUrl: opts.baseUrl,
+                    description: opts.description,
+                    displayName: opts.displayName,
+                    billingStrategy: opts.strategy,
+                    subscriberChangePolicy: {
+                        default: "preserve_current_period",
+                        proration: "none",
+                    },
+                },
+                nextActions: ["Run without --dry-run to create the product"],
+            });
+            return;
+        }
+        const client = getClient();
+        const result = await client.initProduct({
+            name,
+            baseUrl: opts.baseUrl,
+            description: opts.description,
+            displayName: opts.displayName,
+            billingStrategy: opts.strategy,
+            subscriberChangePolicy: {
+                default: "preserve_current_period",
+                proration: "none",
+            },
+        });
+        saveConfig({
+            activeProductId: result.product.id,
+            activeProductName: result.product.name,
+        });
+        printResult(program, `Created product "${result.product.name}"`, {
+            ok: true,
+            productId: result.product.id,
+            product: result.product,
+            repo: result.repo,
+            githubSyncStatus: result.product
+                .acceptedProductSpecGithubSyncStatus ?? null,
+            nextActions: [
+                "Add meters, features, and plans",
+                "Run farthershore apply --dry-run --format json",
+            ],
+        });
+    });
+    product
+        .command("status")
+        .description("Show selected product status")
+        .option("--product <product>", "Product id or name")
+        .action(async (opts) => {
+        const client = getClient();
+        const productId = await resolveProductId(client, opts.product);
+        const config = await client.getProductConfig(productId);
+        printResult(program, "Product status loaded", {
+            ok: true,
+            productId,
+            ...(typeof config === "object" && config ? config : {}),
+        });
+    });
+    product
+        .command("config")
+        .description("Show latest accepted internal product config")
+        .option("--product <product>", "Product id or name")
+        .option("--format <format>", "Output format: json or yaml")
+        .action(async (opts) => {
+        const client = getClient();
+        const productId = await resolveProductId(client, opts.product);
+        const format = opts.format ?? commandFormat(program);
+        if (format === "yaml") {
+            console.log(await client.getProductConfigYaml(productId));
+            return;
+        }
+        console.log(output.json(await client.getProductConfig(productId)));
+    });
+    product
+        .command("attempts")
+        .description("Show rejected product config attempts")
+        .option("--product <product>", "Product id or name")
+        .action(async (opts) => {
+        const client = getClient();
+        const productId = await resolveProductId(client, opts.product);
+        console.log(output.json(await client.getProductAttempts(productId)));
+    });
+}

package/dist/commands/transition.d.ts

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

package/dist/commands/transition.js

@@ -0,0 +1,63 @@
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import YAML from "yaml";
+import * as output from "../output.js";
+import { loadAcceptedSpec, resolveProductId } from "./helpers.js";
+import { analyzePlanTransition } from "./plan-transition.js";
+export function registerTransitionCommands(program, getClient) {
+    const transition = program
+        .command("transition")
+        .description("Preview subscriber impact for product config changes");
+    transition
+        .command("preview")
+        .description("Compare the latest accepted config to a proposed config and show subscriber transition impact")
+        .option("--product <product>", "Product id or name")
+        .option("--to <file>", "Proposed product YAML file")
+        .option("--format <format>", "Output format: table or json")
+        .action(async (opts) => {
+        const client = getClient();
+        const productId = await resolveProductId(client, opts.product);
+        const accepted = await loadAcceptedSpec(client, productId);
+        const proposed = loadProposedSpec(opts.to) ?? accepted;
+        const analysis = analyzePlanTransition({
+            fromSpec: accepted,
+            toSpec: proposed,
+            fromLabel: "acceptedProductSpec",
+            toLabel: opts.to ?? "acceptedProductSpec",
+        });
+        const globalOpts = program.opts();
+        const format = opts.format ?? output.outputFormat(globalOpts.format);
+        if (format === "json") {
+            console.log(output.json({
+                ok: analysis.valid,
+                productId,
+                transitionPreview: analysis,
+                errors: analysis.errors,
+                warnings: analysis.warnings,
+                nextActions: analysis.agentHints,
+            }));
+            if (!analysis.valid)
+                process.exitCode = 1;
+            return;
+        }
+        if (analysis.valid)
+            output.success("Transition preview passed");
+        else
+            output.error("Transition preview failed");
+        for (const change of analysis.changes) {
+            console.log(`  • ${change.message} -> ${change.subscriberAction}`);
+        }
+        for (const warning of analysis.warnings)
+            output.warn(warning);
+        for (const error of analysis.errors)
+            output.error(error);
+        if (!analysis.valid)
+            process.exitCode = 1;
+    });
+}
+function loadProposedSpec(file) {
+    const path = resolve(file ?? "product.yaml");
+    if (!existsSync(path))
+        return null;
+    return YAML.parse(readFileSync(path, "utf-8"));
+}

package/dist/index.js

@@ -10,6 +10,13 @@ import { registerAuthCommands } from "./commands/login.js";
 import { registerInitCommand } from "./commands/init.js";
 import { registerValidateCommand } from "./commands/validate.js";
 import { registerApplyCommand } from "./commands/apply.js";
+import { registerBillingCommands } from "./commands/billing.js";
+import { registerFeatureCommands } from "./commands/feature.js";
+import { registerMeterCommands } from "./commands/meter.js";
+import { registerPlanTransitionCommand } from "./commands/plan-transition.js";
+import { registerPlanCommands } from "./commands/plan.js";
+import { registerProductCommands } from "./commands/product.js";
+import { registerTransitionCommands } from "./commands/transition.js";
 import { CliError } from "./types.js";
 import { getRemediation } from "./remediation.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -33,7 +40,14 @@ function getClient() {
 // Register commands
 registerAuthCommands(program);
 registerInitCommand(program, getClient);
+registerProductCommands(program, getClient);
+registerBillingCommands(program, getClient);
+registerMeterCommands(program, getClient);
+registerFeatureCommands(program, getClient);
+registerPlanCommands(program, getClient);
+registerTransitionCommands(program, getClient);
 registerValidateCommand(program);
+registerPlanTransitionCommand(program);
 registerApplyCommand(program, getClient);
 // Global error handler
 program.exitOverride();

package/dist/types.d.ts

@@ -33,6 +33,8 @@ export type Plan = BuilderPlan;
 export type CliConfig = {
     apiUrl: string;
     activeOrg?: string;
+    activeProductId?: string;
+    activeProductName?: string;
     defaultFormat?: "table" | "json" | "yaml";
 };
 export type Credentials = {

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@farthershore/cli",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "description": "FartherShore CLI — create and configure API products",
   "type": "module",
   "bin": {
-    "farthershore": "./dist/index.js"
+    "farthershore": "dist/index.js"
   },
   "files": [
     "dist"
@@ -17,7 +17,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/farther-shore/farthershore.git"
+    "url": "git+https://github.com/farther-shore/farthershore.git"
   },
   "scripts": {
     "dev": "tsx src/index.ts",