@genfeedai/errors 0.1.1

package/README.md

@@ -0,0 +1,35 @@
+# @genfeedai/errors
+
+Shared terminal-friendly error primitives for Genfeed CLIs.
+
+## Install
+
+```bash
+npm i @genfeedai/errors
+```
+
+## Usage
+
+```ts
+import { ApiError, formatError, handleError } from '@genfeedai/errors';
+
+try {
+  throw new ApiError('Request failed', 500, 'Retry in a few seconds');
+} catch (err) {
+  console.error(formatError(err));
+  handleError(err);
+}
+```
+
+## Related Packages
+
+- `@genfeedai/cli`
+- `@genfeedai/skills-pro`
+
+## Build Faster with Genfeed
+
+Ship consistent CLI error handling or run everything in Genfeed at [https://genfeed.ai](https://genfeed.ai).
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,51 @@
+'use strict';
+
+var chalk = require('chalk');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var chalk__default = /*#__PURE__*/_interopDefault(chalk);
+
+// src/index.ts
+var BaseCliError = class extends Error {
+  suggestion;
+  constructor(message, suggestion) {
+    super(message);
+    this.name = "BaseCliError";
+    this.suggestion = suggestion;
+  }
+};
+var ApiError = class extends BaseCliError {
+  statusCode;
+  constructor(message, statusCode, suggestion) {
+    super(message, suggestion);
+    this.name = "ApiError";
+    this.statusCode = statusCode;
+  }
+};
+function formatError(error) {
+  if (error instanceof BaseCliError) {
+    let output = chalk__default.default.red(`\u2716 ${error.message}`);
+    if (error.suggestion) {
+      output += `
+  ${chalk__default.default.dim(error.suggestion)}`;
+    }
+    return output;
+  }
+  if (error instanceof Error) {
+    return chalk__default.default.red(`\u2716 ${error.message}`);
+  }
+  return chalk__default.default.red("\u2716 An unknown error occurred");
+}
+function handleError(error, options) {
+  console.error(formatError(error));
+  if (options?.replMode) {
+    throw error;
+  }
+  process.exit(1);
+}
+
+exports.ApiError = ApiError;
+exports.BaseCliError = BaseCliError;
+exports.formatError = formatError;
+exports.handleError = handleError;

package/dist/index.d.cts

@@ -0,0 +1,36 @@
+/**
+ * Base error class for all Genfeed CLI tools.
+ * Provides an optional `suggestion` field for actionable user guidance.
+ *
+ * Domain-specific repos extend this:
+ * - CLI: `GenfeedError extends BaseCliError`
+ * - Skills-Pro: `SkillsProError extends BaseCliError`
+ */
+declare class BaseCliError extends Error {
+    suggestion?: string;
+    constructor(message: string, suggestion?: string);
+}
+/**
+ * Shared API error with HTTP status code.
+ * Used identically by CLI and skills-pro for HTTP client errors.
+ */
+declare class ApiError extends BaseCliError {
+    statusCode?: number;
+    constructor(message: string, statusCode?: number, suggestion?: string);
+}
+/**
+ * Format an error for terminal display.
+ * Handles BaseCliError (with suggestion), generic Error, and unknown errors.
+ */
+declare function formatError(error: unknown): string;
+interface HandleErrorOptions {
+    /** When true, re-throws the error instead of exiting (for REPL mode). */
+    replMode?: boolean;
+}
+/**
+ * Print a formatted error and exit the process.
+ * Supports REPL mode where errors are re-thrown instead of calling process.exit.
+ */
+declare function handleError(error: unknown, options?: HandleErrorOptions): never;
+
+export { ApiError, BaseCliError, type HandleErrorOptions, formatError, handleError };

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Base error class for all Genfeed CLI tools.
+ * Provides an optional `suggestion` field for actionable user guidance.
+ *
+ * Domain-specific repos extend this:
+ * - CLI: `GenfeedError extends BaseCliError`
+ * - Skills-Pro: `SkillsProError extends BaseCliError`
+ */
+declare class BaseCliError extends Error {
+    suggestion?: string;
+    constructor(message: string, suggestion?: string);
+}
+/**
+ * Shared API error with HTTP status code.
+ * Used identically by CLI and skills-pro for HTTP client errors.
+ */
+declare class ApiError extends BaseCliError {
+    statusCode?: number;
+    constructor(message: string, statusCode?: number, suggestion?: string);
+}
+/**
+ * Format an error for terminal display.
+ * Handles BaseCliError (with suggestion), generic Error, and unknown errors.
+ */
+declare function formatError(error: unknown): string;
+interface HandleErrorOptions {
+    /** When true, re-throws the error instead of exiting (for REPL mode). */
+    replMode?: boolean;
+}
+/**
+ * Print a formatted error and exit the process.
+ * Supports REPL mode where errors are re-thrown instead of calling process.exit.
+ */
+declare function handleError(error: unknown, options?: HandleErrorOptions): never;
+
+export { ApiError, BaseCliError, type HandleErrorOptions, formatError, handleError };

package/dist/index.js

@@ -0,0 +1,42 @@
+import chalk from 'chalk';
+
+// src/index.ts
+var BaseCliError = class extends Error {
+  suggestion;
+  constructor(message, suggestion) {
+    super(message);
+    this.name = "BaseCliError";
+    this.suggestion = suggestion;
+  }
+};
+var ApiError = class extends BaseCliError {
+  statusCode;
+  constructor(message, statusCode, suggestion) {
+    super(message, suggestion);
+    this.name = "ApiError";
+    this.statusCode = statusCode;
+  }
+};
+function formatError(error) {
+  if (error instanceof BaseCliError) {
+    let output = chalk.red(`\u2716 ${error.message}`);
+    if (error.suggestion) {
+      output += `
+  ${chalk.dim(error.suggestion)}`;
+    }
+    return output;
+  }
+  if (error instanceof Error) {
+    return chalk.red(`\u2716 ${error.message}`);
+  }
+  return chalk.red("\u2716 An unknown error occurred");
+}
+function handleError(error, options) {
+  console.error(formatError(error));
+  if (options?.replMode) {
+    throw error;
+  }
+  process.exit(1);
+}
+
+export { ApiError, BaseCliError, formatError, handleError };

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@genfeedai/errors",
+  "version": "0.1.1",
+  "sideEffects": false,
+  "license": "MIT",
+  "description": "Shared error classes and formatting for Genfeed CLI tools",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/genfeedai/packages.git",
+    "directory": "errors"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "bun run build"
+  },
+  "dependencies": {
+    "chalk": "5.6.2"
+  },
+  "devDependencies": {
+    "@types/node": "25.2.3",
+    "tsup": "8.4.0",
+    "typescript": "5.9.3"
+  },
+  "type": "module"
+}