@farthershore/cli 0.1.0

package/dist/output.js

@@ -0,0 +1,48 @@
+// Output formatting: tables, JSON, colors
+import chalk from "chalk";
+export function table(headers, rows) {
+    const widths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => (r[i] ?? "").length)));
+    const header = headers.map((h, i) => h.padEnd(widths[i])).join("  ");
+    const separator = widths.map((w) => "─".repeat(w)).join("──");
+    const body = rows
+        .map((row) => row.map((cell, i) => (cell ?? "").padEnd(widths[i])).join("  "))
+        .join("\n");
+    return `${chalk.bold(header)}\n${chalk.dim(separator)}\n${body}`;
+}
+export function json(data) {
+    return JSON.stringify(data, null, 2);
+}
+export function success(msg) {
+    console.log(chalk.green(`✓ ${msg}`));
+}
+export function error(msg) {
+    console.error(chalk.red(`✗ ${msg}`));
+}
+export function warn(msg) {
+    console.warn(chalk.yellow(`⚠ ${msg}`));
+}
+export function info(msg) {
+    console.log(chalk.dim(msg));
+}
+export function heading(msg) {
+    console.log(chalk.bold(msg));
+}
+export function formatPrice(cents) {
+    return `$${(cents / 100).toFixed(2)}`;
+}
+export function formatDate(iso) {
+    return new Date(iso).toLocaleDateString("en-US", {
+        year: "numeric",
+        month: "short",
+        day: "numeric",
+    });
+}
+export function isTTY() {
+    return process.stdout.isTTY === true;
+}
+export function outputFormat(flagFormat) {
+    if (flagFormat === "json" || flagFormat === "yaml" || flagFormat === "table")
+        return flagFormat;
+    return isTTY() ? "table" : "json";
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,86 @@
+export type Product = {
+    id: string;
+    name: string;
+    displayName?: string | null;
+    description: string | null;
+    baseUrl: string;
+    status: "DRAFT" | "ACTIVE";
+    runtimeHostname?: string | null;
+    portalHostname?: string | null;
+    createdAt: string;
+    plans: Plan[];
+};
+export type Plan = {
+    id: string;
+    key: string;
+    name: string;
+    description: string | null;
+    type: string;
+    monthlyPriceCents: number;
+    isActive: boolean;
+    selfServeEnabled: boolean;
+};
+export type ApplyResponse = {
+    valid: boolean;
+    errors: Array<{
+        line?: number;
+        message: string;
+    }>;
+    warnings: Array<{
+        message: string;
+    }>;
+    changes: Array<{
+        action: "create" | "update" | "deactivate";
+        key: string;
+        name: string;
+        details: string;
+    }>;
+    applied: boolean;
+    results?: Array<{
+        action: string;
+        key: string;
+        id: string;
+    }>;
+};
+export type MakerToken = {
+    id: string;
+    label: string;
+    lastFour: string;
+    productId: string | null;
+    permissions: string[];
+    createdAt: string;
+};
+export type OrgMember = {
+    userId: string;
+    role: string;
+    user?: {
+        email?: string;
+        name?: string;
+    };
+};
+export type CliConfig = {
+    apiUrl: string;
+    activeOrg?: string;
+    defaultFormat?: "table" | "json" | "yaml";
+};
+export type Credentials = {
+    token: string;
+    orgId?: string;
+    userId?: string;
+};
+export type InitProductResponse = {
+    product: Product;
+    repo: {
+        fullName: string;
+        htmlUrl: string;
+        cloneUrl: string;
+    } | null;
+    agent: {
+        instructions: string;
+        agentsMdUrl: string | null;
+    };
+};
+export declare class CliError extends Error {
+    status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}

package/dist/types.js

@@ -0,0 +1,10 @@
+// Shared types for the FartherShore CLI
+export class CliError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = "CliError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAgFxC,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGxB;IAFT,YACE,OAAe,EACR,MAAe;QAEtB,KAAK,CAAC,OAAO,CAAC,CAAC;QAFR,WAAM,GAAN,MAAM,CAAS;QAGtB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@farthershore/cli",
+  "version": "0.1.0",
+  "description": "FartherShore CLI — manage API products, plans, and billing from the terminal",
+  "type": "module",
+  "bin": {
+    "farthershore": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/farther-shore/farthershore.git"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "lint": "prettier --check \"src/**/*.ts\"",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "farthershore",
+    "api",
+    "cli",
+    "billing",
+    "api-gateway",
+    "api-monetization"
+  ],
+  "author": "Farther Shore",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "js-yaml": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.19.17",
+    "prettier": "^3.8.1",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2",
+    "vitest": "^3.2.4"
+  }
+}