@formo/cli 1.0.2 → 1.1.1

package/dist/lib/pagination.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'incur';
+export interface PaginationOptions {
+    page?: number;
+    size?: number;
+}
+/**
+ * Shared zod fragments for paginated list commands.
+ * Spread into a command's options: `z.object({ ...paginationOptionsSchema })`.
+ */
+export declare const paginationOptionsSchema: {
+    page: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    size: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+};
+export declare function buildPaginationParams(options?: PaginationOptions): Record<string, number>;

package/dist/lib/pagination.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paginationOptionsSchema = void 0;
+exports.buildPaginationParams = buildPaginationParams;
+const incur_1 = require("incur");
+/**
+ * Shared zod fragments for paginated list commands.
+ * Spread into a command's options: `z.object({ ...paginationOptionsSchema })`.
+ */
+exports.paginationOptionsSchema = {
+    page: incur_1.z.coerce
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe('Page number (1-indexed, default 1)'),
+    size: incur_1.z.coerce
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe('Page size (default 100, max 200)'),
+};
+function buildPaginationParams(options = {}) {
+    const params = {};
+    if (options.page !== undefined)
+        params.page = options.page;
+    if (options.size !== undefined)
+        params.size = options.size;
+    return params;
+}

package/dist/lib/ui.d.ts

@@ -2,8 +2,9 @@
  * Terminal UI utilities for the Formo CLI.
  *
  * Uses raw ANSI escape codes (no dependencies) for coloring and styling.
- * Colors are automatically disabled when stdout is not a TTY (piped output, CI, etc.)
- * or when the NO_COLOR environment variable is set.
+ * All decorated output is written to stderr (stdout is reserved for command
+ * results), so color is keyed to stderr being a TTY. Disabled whenever the
+ * NO_COLOR environment variable is present (any value, per the spec).
  */
 export declare const color: {
     green: (t: string) => string;
@@ -20,12 +21,12 @@ export declare const color: {
 };
 /**
  * Returns the Formo ASCII art banner in green.
- * Only shown when stdout is a TTY.
+ * Only shown when stderr is a TTY.
  */
 export declare function banner(): string;
 export declare function success(message: string): string;
 export declare function error(message: string): string;
 export declare function warn(message: string): string;
 export declare function info(message: string): string;
-export declare function keyValue(key: string, value: string): string;
-export declare function heading(text: string): string;
+/** Mask an API key for display, keeping just enough to identify it. */
+export declare function maskKey(key: string): string;

package/dist/lib/ui.js

@@ -3,8 +3,9 @@
  * Terminal UI utilities for the Formo CLI.
  *
  * Uses raw ANSI escape codes (no dependencies) for coloring and styling.
- * Colors are automatically disabled when stdout is not a TTY (piped output, CI, etc.)
- * or when the NO_COLOR environment variable is set.
+ * All decorated output is written to stderr (stdout is reserved for command
+ * results), so color is keyed to stderr being a TTY. Disabled whenever the
+ * NO_COLOR environment variable is present (any value, per the spec).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.color = void 0;
@@ -13,10 +14,9 @@ exports.success = success;
 exports.error = error;
 exports.warn = warn;
 exports.info = info;
-exports.keyValue = keyValue;
-exports.heading = heading;
-const isTTY = process.stdout.isTTY === true;
-const noColor = !!process.env.NO_COLOR;
+exports.maskKey = maskKey;
+const isTTY = process.stderr.isTTY === true;
+const noColor = process.env.NO_COLOR !== undefined;
 /** Whether color output is enabled */
 const colorEnabled = isTTY && !noColor;
 // ── ANSI helpers ──
@@ -47,7 +47,7 @@ const LOGO_LINES = [
 ];
 /**
  * Returns the Formo ASCII art banner in green.
- * Only shown when stdout is a TTY.
+ * Only shown when stderr is a TTY.
  */
 function banner() {
     if (!isTTY)
@@ -71,9 +71,7 @@ function info(message) {
     return `${exports.color.cyan('ℹ')} ${message}`;
 }
 // ── Formatting helpers ──
-function keyValue(key, value) {
-    return `${exports.color.dim(key + ':')} ${value}`;
-}
-function heading(text) {
-    return exports.color.boldGreen(text);
+/** Mask an API key for display, keeping just enough to identify it. */
+function maskKey(key) {
+    return key.length > 12 ? key.slice(0, 8) + '…' + key.slice(-4) : '***';
 }

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@formo/cli",
-  "version": "1.0.2",
+  "version": "1.1.1",
   "packageManager": "pnpm@11.1.2",
+  "engines": {
+    "node": ">=22.12"
+  },
   "description": "Formo API CLI — query profiles and analytics data",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/getformo/cli.git"
@@ -21,19 +25,18 @@
   ],
   "scripts": {
     "build": "tsc",
-    "dev": "ts-node src/index.ts",
+    "prepublishOnly": "pnpm build",
+    "dev": "tsx src/index.ts",
     "start": "node dist/index.js",
     "lint": "eslint src/",
     "lint:fix": "eslint src/ --fix",
+    "typecheck": "tsc -p tsconfig.test.json --noEmit",
     "test": "mocha",
     "test:watch": "mocha --watch"
   },
   "dependencies": {
-    "axios": "^1.15.2",
-    "incur": "^0.3.4"
-  },
-  "overrides": {
-    "serialize-javascript": ">=7.0.5"
+    "axios": "^1.18.0",
+    "incur": "0.3.25"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
@@ -45,14 +48,8 @@
     "eslint": "^10.2.0",
     "globals": "^17.4.0",
     "mocha": "^11.7.5",
-    "ts-node": "^10.9.2",
     "tsx": "^4.21.0",
     "typescript": "^5.5.4",
     "typescript-eslint": "^8.58.1"
-  },
-  "pnpm": {
-    "overrides": {
-      "serialize-javascript": ">=7.0.5"
-    }
   }
 }