@felixgeelhaar/jira-sdk 0.3.0 → 1.0.0

package/dist/errors/index.cjs

@@ -0,0 +1,272 @@
+'use strict';
+
+// src/utils/runtime.ts
+function captureStackTrace(target, constructor) {
+  const capture = Error.captureStackTrace;
+  capture?.(target, constructor);
+}
+
+// src/errors/base.error.ts
+var JiraSdkError = class extends Error {
+  /** HTTP status code if applicable */
+  statusCode;
+  /** Original cause of the error */
+  cause;
+  /** Additional context/metadata */
+  context;
+  constructor(message, options) {
+    super(message, options?.cause !== void 0 ? { cause: options.cause } : void 0);
+    this.name = this.constructor.name;
+    if (options?.cause !== void 0) {
+      this.cause = options.cause;
+    }
+    if (options?.statusCode !== void 0) {
+      this.statusCode = options.statusCode;
+    }
+    if (options?.context !== void 0) {
+      this.context = options.context;
+    }
+    captureStackTrace(this, this.constructor);
+  }
+  /**
+   * Returns a JSON representation of the error
+   */
+  toJSON() {
+    return {
+      name: this.name,
+      code: this.code,
+      message: this.message,
+      statusCode: this.statusCode,
+      context: this.context,
+      cause: this.cause?.message,
+      stack: this.stack
+    };
+  }
+};
+
+// src/errors/api.error.ts
+var ApiError = class extends JiraSdkError {
+  code = "JIRA_API_ERROR";
+  /** Parsed error details from Jira response */
+  details;
+  /** Raw response body */
+  responseBody;
+  constructor(message, statusCode, responseBody) {
+    const details = parseErrorBody(responseBody);
+    const finalMessage = details ? buildErrorMessage(message, details) : message;
+    super(finalMessage, { statusCode, context: { responseBody } });
+    this.details = details;
+    this.responseBody = responseBody;
+  }
+  /**
+   * Returns all error messages as a single array
+   */
+  getAllMessages() {
+    const messages = [];
+    if (this.details?.errorMessages) {
+      messages.push(...this.details.errorMessages);
+    }
+    if (this.details?.errors) {
+      for (const [field, msg] of Object.entries(this.details.errors)) {
+        messages.push(`${field}: ${msg}`);
+      }
+    }
+    if (messages.length === 0) {
+      messages.push(this.message);
+    }
+    return messages;
+  }
+};
+var UnauthorizedError = class extends ApiError {
+  code = "JIRA_UNAUTHORIZED";
+  constructor(message = "Authentication required", responseBody) {
+    super(message, 401, responseBody);
+  }
+};
+var ForbiddenError = class extends ApiError {
+  code = "JIRA_FORBIDDEN";
+  constructor(message = "Permission denied", responseBody) {
+    super(message, 403, responseBody);
+  }
+};
+var NotFoundError = class extends ApiError {
+  code = "JIRA_NOT_FOUND";
+  constructor(message = "Resource not found", responseBody) {
+    super(message, 404, responseBody);
+  }
+};
+var RateLimitError = class extends ApiError {
+  code = "JIRA_RATE_LIMITED";
+  /** When to retry (in milliseconds) */
+  retryAfter;
+  constructor(message = "Rate limit exceeded", responseBody, options) {
+    super(message, 429, responseBody);
+    this.retryAfter = options?.retryAfter;
+  }
+};
+var ServerError = class extends ApiError {
+  code = "JIRA_SERVER_ERROR";
+  constructor(message = "Internal server error", responseBody, statusCode = 500) {
+    super(message, statusCode, responseBody);
+  }
+};
+function parseErrorBody(body) {
+  if (!body || typeof body !== "object") {
+    return void 0;
+  }
+  const obj = body;
+  return {
+    errorMessages: Array.isArray(obj["errorMessages"]) ? obj["errorMessages"] : void 0,
+    errors: typeof obj["errors"] === "object" && obj["errors"] !== null ? obj["errors"] : void 0,
+    warningMessages: Array.isArray(obj["warningMessages"]) ? obj["warningMessages"] : void 0
+  };
+}
+function buildErrorMessage(baseMessage, details) {
+  if (details.errorMessages?.length) {
+    return details.errorMessages.join("; ");
+  }
+  if (details.errors && Object.keys(details.errors).length > 0) {
+    const fieldErrors = Object.entries(details.errors).map(([field, msg]) => `${field}: ${msg}`).join("; ");
+    return `${baseMessage}: ${fieldErrors}`;
+  }
+  return baseMessage;
+}
+
+// src/errors/validation.error.ts
+var ValidationError = class _ValidationError extends JiraSdkError {
+  code = "VALIDATION_ERROR";
+  /** Validation issues from Zod */
+  issues;
+  /**
+   * @param message Human-readable description of what failed.
+   * @param zodError The underlying Zod error, when the failure came from schema
+   * validation. Omit it for validation that is not schema-driven — for example
+   * a missing environment variable — in which case {@link issues} is empty.
+   */
+  constructor(message, zodError) {
+    super(message, {
+      context: {
+        issues: zodError?.issues ?? []
+      }
+    });
+    this.issues = zodError?.issues ?? [];
+  }
+  /**
+   * Creates a ValidationError from a ZodError
+   */
+  static fromZodError(zodError, prefix = "Validation failed") {
+    const message = `${prefix}: ${formatZodIssues(zodError.issues)}`;
+    return new _ValidationError(message, zodError);
+  }
+  /**
+   * Returns a flat list of all error paths and messages
+   */
+  getFieldErrors() {
+    return this.issues.map((issue) => ({
+      path: issue.path.join("."),
+      message: issue.message
+    }));
+  }
+};
+var ConfigValidationError = class _ConfigValidationError extends ValidationError {
+  code = "CONFIG_VALIDATION_ERROR";
+  static fromZodError(zodError) {
+    const message = `Configuration validation failed: ${formatZodIssues(zodError.issues)}`;
+    return new _ConfigValidationError(message, zodError);
+  }
+};
+var ResponseValidationError = class _ResponseValidationError extends ValidationError {
+  code = "RESPONSE_VALIDATION_ERROR";
+  static fromZodError(zodError) {
+    const message = `Response validation failed: ${formatZodIssues(zodError.issues)}`;
+    return new _ResponseValidationError(message, zodError);
+  }
+};
+function formatZodIssues(issues) {
+  return issues.map((issue) => {
+    const path = issue.path.length > 0 ? `${issue.path.join(".")}: ` : "";
+    return `${path}${issue.message}`;
+  }).join("; ");
+}
+
+// src/errors/network.error.ts
+var NetworkError = class extends JiraSdkError {
+  code = "NETWORK_ERROR";
+  constructor(message, options) {
+    super(message, { cause: options?.cause });
+  }
+  /**
+   * Check if this error indicates a connection failure
+   */
+  isConnectionError() {
+    const msg = this.message.toLowerCase();
+    return msg.includes("econnrefused") || msg.includes("econnreset") || msg.includes("enotfound") || msg.includes("fetch failed");
+  }
+  /**
+   * Check if this error might be retryable
+   */
+  isRetryable() {
+    const msg = this.message.toLowerCase();
+    return msg.includes("econnreset") || msg.includes("etimedout") || msg.includes("temporary");
+  }
+};
+var TimeoutError = class extends JiraSdkError {
+  code = "TIMEOUT_ERROR";
+  /** The timeout duration in milliseconds */
+  timeoutMs;
+  constructor(message, options) {
+    super(message, { cause: options?.cause });
+    this.timeoutMs = options?.timeoutMs;
+  }
+};
+var AbortError = class extends JiraSdkError {
+  code = "ABORT_ERROR";
+  constructor(message = "Request was aborted", options) {
+    super(message, { cause: options?.cause });
+  }
+};
+
+// src/errors/auth.error.ts
+var AuthError = class extends JiraSdkError {
+  code = "AUTH_ERROR";
+  constructor(message, context) {
+    super(message, { statusCode: 401, ...context !== void 0 && { context } });
+  }
+};
+var TokenRefreshError = class extends AuthError {
+  code = "TOKEN_REFRESH_ERROR";
+};
+var TokenExpiredError = class extends AuthError {
+  code = "TOKEN_EXPIRED_ERROR";
+  constructor(message = "Access token has expired", context) {
+    super(message, context);
+  }
+};
+var AuthConfigError = class extends AuthError {
+  code = "AUTH_CONFIG_ERROR";
+  validationErrors;
+  constructor(message, validationErrors) {
+    super(message, validationErrors !== void 0 ? { validationErrors } : void 0);
+    this.validationErrors = validationErrors;
+  }
+};
+
+exports.AbortError = AbortError;
+exports.ApiError = ApiError;
+exports.AuthConfigError = AuthConfigError;
+exports.AuthError = AuthError;
+exports.ConfigValidationError = ConfigValidationError;
+exports.ForbiddenError = ForbiddenError;
+exports.JiraSdkError = JiraSdkError;
+exports.NetworkError = NetworkError;
+exports.NotFoundError = NotFoundError;
+exports.RateLimitError = RateLimitError;
+exports.ResponseValidationError = ResponseValidationError;
+exports.ServerError = ServerError;
+exports.TimeoutError = TimeoutError;
+exports.TokenExpiredError = TokenExpiredError;
+exports.TokenRefreshError = TokenRefreshError;
+exports.UnauthorizedError = UnauthorizedError;
+exports.ValidationError = ValidationError;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/errors/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/runtime.ts","../../src/errors/base.error.ts","../../src/errors/api.error.ts","../../src/errors/validation.error.ts","../../src/errors/network.error.ts","../../src/errors/auth.error.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Feature detection for host globals that TypeScript's DOM/Node lib types\n * declare as always present, but which are genuinely absent in some runtimes\n * this SDK supports (browsers, Workers, Deno, edge functions).\n *\n * Reading them through a widened view of `globalThis` keeps the runtime guard —\n * removing it would crash outside Node — while letting the type system see that\n * the check is meaningful, so it no longer reports the guard as an unnecessary\n * condition.\n */\ninterface RuntimeGlobals {\n  process?: { env?: Record<string, string | undefined> };\n  console?: { warn?: (...args: unknown[]) => void };\n  crypto?: { randomUUID?: () => string };\n}\n\nfunction runtime(): RuntimeGlobals {\n  return globalThis;\n}\n\n/**\n * Read `process.env`, or an empty object where `process` is unavailable.\n */\nexport function processEnv(): Record<string, string | undefined> {\n  return runtime().process?.env ?? {};\n}\n\n/**\n * Read a single environment variable, or `undefined` where unavailable.\n */\nexport function readEnvVar(name: string): string | undefined {\n  return processEnv()[name];\n}\n\n/**\n * Emit a warning through `console.warn` where one exists, otherwise do nothing.\n */\nexport function warn(message: string): void {\n  runtime().console?.warn?.(message);\n}\n\n/**\n * Generate a UUID using `crypto.randomUUID` where available, falling back to a\n * timestamp-and-random identifier. The fallback is not cryptographically\n * random and is only used for request correlation IDs.\n */\nexport function randomId(): string {\n  const uuid = runtime().crypto?.randomUUID?.();\n  if (uuid !== undefined) {\n    return uuid;\n  }\n  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 11)}`;\n}\n\n/**\n * V8-only API used to trim the constructor frame from error stacks. Absent on\n * SpiderMonkey and JavaScriptCore.\n */\ntype CaptureStackTrace = (target: object, constructor?: unknown) => void;\n\n/**\n * Trim the constructor frame from an error's stack where the engine supports\n * it; a no-op elsewhere.\n *\n * `constructor` is typed `unknown` rather than `Function` so the signature does\n * not widen to \"any callable\" for callers. V8 expects a constructor function\n * there, and every call site passes `this.constructor`.\n */\nexport function captureStackTrace(target: object, constructor?: unknown): void {\n  const capture = (Error as unknown as { captureStackTrace?: CaptureStackTrace }).captureStackTrace;\n  capture?.(target, constructor);\n}\n","import { captureStackTrace } from '../utils/runtime.js';\n/**\n * Base error class for all SDK errors.\n * Provides consistent error structure with error codes and cause chaining.\n */\nexport abstract class JiraSdkError extends Error {\n  /** Unique error code for programmatic handling */\n  abstract readonly code: string;\n\n  /** HTTP status code if applicable */\n  readonly statusCode?: number;\n\n  /** Original cause of the error */\n  readonly cause?: Error;\n\n  /** Additional context/metadata */\n  readonly context?: Record<string, unknown>;\n\n  constructor(\n    message: string,\n    options?: {\n      cause?: Error | undefined;\n      statusCode?: number | undefined;\n      context?: Record<string, unknown> | undefined;\n    }\n  ) {\n    super(message, options?.cause !== undefined ? { cause: options.cause } : undefined);\n    this.name = this.constructor.name;\n\n    // Only assign properties when values are defined (for exactOptionalPropertyTypes)\n    if (options?.cause !== undefined) {\n      this.cause = options.cause;\n    }\n    if (options?.statusCode !== undefined) {\n      this.statusCode = options.statusCode;\n    }\n    if (options?.context !== undefined) {\n      this.context = options.context;\n    }\n\n    // Maintains proper stack trace for where our error was thrown (V8 only)\n    captureStackTrace(this, this.constructor);\n  }\n\n  /**\n   * Returns a JSON representation of the error\n   */\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      code: this.code,\n      message: this.message,\n      statusCode: this.statusCode,\n      context: this.context,\n      cause: this.cause?.message,\n      stack: this.stack,\n    };\n  }\n}\n","import { JiraSdkError } from './base.error.js';\n\n/**\n * Error details returned by Jira API\n */\nexport interface JiraErrorDetail {\n  errorMessages?: string[] | undefined;\n  errors?: Record<string, string> | undefined;\n  warningMessages?: string[] | undefined;\n}\n\n/**\n * Error thrown when Jira API returns an error response.\n */\nexport class ApiError extends JiraSdkError {\n  readonly code: string = 'JIRA_API_ERROR';\n\n  /** Parsed error details from Jira response */\n  readonly details: JiraErrorDetail | undefined;\n\n  /** Raw response body */\n  readonly responseBody: unknown;\n\n  constructor(message: string, statusCode: number, responseBody?: unknown) {\n    const details = parseErrorBody(responseBody);\n    const finalMessage = details ? buildErrorMessage(message, details) : message;\n    super(finalMessage, { statusCode, context: { responseBody } });\n    this.details = details;\n    this.responseBody = responseBody;\n  }\n\n  /**\n   * Returns all error messages as a single array\n   */\n  getAllMessages(): string[] {\n    const messages: string[] = [];\n\n    if (this.details?.errorMessages) {\n      messages.push(...this.details.errorMessages);\n    }\n\n    if (this.details?.errors) {\n      for (const [field, msg] of Object.entries(this.details.errors)) {\n        messages.push(`${field}: ${msg}`);\n      }\n    }\n\n    if (messages.length === 0) {\n      messages.push(this.message);\n    }\n\n    return messages;\n  }\n}\n\n/**\n * Error thrown when user is not authenticated\n */\nexport class UnauthorizedError extends ApiError {\n  override readonly code: string = 'JIRA_UNAUTHORIZED';\n\n  constructor(message = 'Authentication required', responseBody?: unknown) {\n    super(message, 401, responseBody);\n  }\n}\n\n/**\n * Error thrown when user lacks required permissions\n */\nexport class ForbiddenError extends ApiError {\n  override readonly code: string = 'JIRA_FORBIDDEN';\n\n  constructor(message = 'Permission denied', responseBody?: unknown) {\n    super(message, 403, responseBody);\n  }\n}\n\n/**\n * Error thrown when requested resource is not found\n */\nexport class NotFoundError extends ApiError {\n  override readonly code: string = 'JIRA_NOT_FOUND';\n\n  constructor(message = 'Resource not found', responseBody?: unknown) {\n    super(message, 404, responseBody);\n  }\n}\n\n/**\n * Rate limit error options\n */\nexport interface RateLimitErrorOptions {\n  retryAfter?: number | undefined;\n}\n\n/**\n * Error thrown when rate limit is exceeded\n */\nexport class RateLimitError extends ApiError {\n  override readonly code: string = 'JIRA_RATE_LIMITED';\n\n  /** When to retry (in milliseconds) */\n  readonly retryAfter: number | undefined;\n\n  constructor(\n    message = 'Rate limit exceeded',\n    responseBody?: unknown,\n    options?: RateLimitErrorOptions\n  ) {\n    super(message, 429, responseBody);\n    this.retryAfter = options?.retryAfter;\n  }\n}\n\n/**\n * Error thrown when server encounters an internal error\n */\nexport class ServerError extends ApiError {\n  override readonly code: string = 'JIRA_SERVER_ERROR';\n\n  constructor(message = 'Internal server error', responseBody?: unknown, statusCode = 500) {\n    super(message, statusCode, responseBody);\n  }\n}\n\n// Helper functions\nfunction parseErrorBody(body: unknown): JiraErrorDetail | undefined {\n  if (!body || typeof body !== 'object') {\n    return undefined;\n  }\n\n  const obj = body as Record<string, unknown>;\n\n  return {\n    errorMessages: Array.isArray(obj['errorMessages'])\n      ? (obj['errorMessages'] as string[])\n      : undefined,\n    errors:\n      typeof obj['errors'] === 'object' && obj['errors'] !== null\n        ? (obj['errors'] as Record<string, string>)\n        : undefined,\n    warningMessages: Array.isArray(obj['warningMessages'])\n      ? (obj['warningMessages'] as string[])\n      : undefined,\n  };\n}\n\nfunction buildErrorMessage(baseMessage: string, details: JiraErrorDetail): string {\n  // First, try to use error messages from the response\n  if (details.errorMessages?.length) {\n    return details.errorMessages.join('; ');\n  }\n\n  // Then, try field-specific errors\n  if (details.errors && Object.keys(details.errors).length > 0) {\n    const fieldErrors = Object.entries(details.errors)\n      .map(([field, msg]) => `${field}: ${msg}`)\n      .join('; ');\n    return `${baseMessage}: ${fieldErrors}`;\n  }\n\n  return baseMessage;\n}\n","import type { ZodError, z } from 'zod';\nimport { JiraSdkError } from './base.error.js';\n\n/**\n * Error thrown when validation fails (either request or response).\n */\nexport class ValidationError extends JiraSdkError {\n  readonly code: string = 'VALIDATION_ERROR';\n\n  /** Validation issues from Zod */\n  readonly issues: z.core.$ZodIssue[];\n\n  /**\n   * @param message Human-readable description of what failed.\n   * @param zodError The underlying Zod error, when the failure came from schema\n   * validation. Omit it for validation that is not schema-driven — for example\n   * a missing environment variable — in which case {@link issues} is empty.\n   */\n  constructor(message: string, zodError?: ZodError) {\n    super(message, {\n      context: {\n        issues: zodError?.issues ?? [],\n      },\n    });\n    this.issues = zodError?.issues ?? [];\n  }\n\n  /**\n   * Creates a ValidationError from a ZodError\n   */\n  static fromZodError(zodError: ZodError, prefix = 'Validation failed'): ValidationError {\n    const message = `${prefix}: ${formatZodIssues(zodError.issues)}`;\n    return new ValidationError(message, zodError);\n  }\n\n  /**\n   * Returns a flat list of all error paths and messages\n   */\n  getFieldErrors(): Array<{ path: string; message: string }> {\n    return this.issues.map((issue) => ({\n      path: issue.path.join('.'),\n      message: issue.message,\n    }));\n  }\n}\n\n/**\n * Error thrown when configuration validation fails\n */\nexport class ConfigValidationError extends ValidationError {\n  override readonly code = 'CONFIG_VALIDATION_ERROR';\n\n  static override fromZodError(zodError: ZodError): ConfigValidationError {\n    const message = `Configuration validation failed: ${formatZodIssues(zodError.issues)}`;\n    return new ConfigValidationError(message, zodError);\n  }\n}\n\n/**\n * Error thrown when response validation fails\n */\nexport class ResponseValidationError extends ValidationError {\n  override readonly code = 'RESPONSE_VALIDATION_ERROR';\n\n  static override fromZodError(zodError: ZodError): ResponseValidationError {\n    const message = `Response validation failed: ${formatZodIssues(zodError.issues)}`;\n    return new ResponseValidationError(message, zodError);\n  }\n}\n\n// Helper function\nfunction formatZodIssues(issues: z.core.$ZodIssue[]): string {\n  return issues\n    .map((issue) => {\n      const path = issue.path.length > 0 ? `${issue.path.join('.')}: ` : '';\n      return `${path}${issue.message}`;\n    })\n    .join('; ');\n}\n","import { JiraSdkError } from './base.error.js';\n\n/**\n * Error thrown when a network-level error occurs.\n */\nexport class NetworkError extends JiraSdkError {\n  readonly code = 'NETWORK_ERROR';\n\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(message, { cause: options?.cause as Error | undefined });\n  }\n\n  /**\n   * Check if this error indicates a connection failure\n   */\n  isConnectionError(): boolean {\n    const msg = this.message.toLowerCase();\n    return (\n      msg.includes('econnrefused') ||\n      msg.includes('econnreset') ||\n      msg.includes('enotfound') ||\n      msg.includes('fetch failed')\n    );\n  }\n\n  /**\n   * Check if this error might be retryable\n   */\n  isRetryable(): boolean {\n    const msg = this.message.toLowerCase();\n    return msg.includes('econnreset') || msg.includes('etimedout') || msg.includes('temporary');\n  }\n}\n\n/**\n * Error thrown when a request times out.\n */\nexport class TimeoutError extends JiraSdkError {\n  readonly code = 'TIMEOUT_ERROR';\n\n  /** The timeout duration in milliseconds */\n  readonly timeoutMs: number | undefined;\n\n  constructor(message: string, options?: { cause?: unknown; timeoutMs?: number }) {\n    super(message, { cause: options?.cause as Error | undefined });\n    this.timeoutMs = options?.timeoutMs;\n  }\n}\n\n/**\n * Error thrown when a request is aborted.\n */\nexport class AbortError extends JiraSdkError {\n  readonly code = 'ABORT_ERROR';\n\n  constructor(message = 'Request was aborted', options?: { cause?: unknown }) {\n    super(message, { cause: options?.cause as Error | undefined });\n  }\n}\n","import type { z } from 'zod';\nimport { JiraSdkError } from './base.error.js';\n\n/**\n * Error thrown when authentication fails or is misconfigured.\n */\nexport class AuthError extends JiraSdkError {\n  readonly code: string = 'AUTH_ERROR';\n\n  constructor(message: string, context?: Record<string, unknown>) {\n    super(message, { statusCode: 401, ...(context !== undefined && { context }) });\n  }\n}\n\n/**\n * Error thrown when OAuth2 token refresh fails.\n */\nexport class TokenRefreshError extends AuthError {\n  override readonly code: string = 'TOKEN_REFRESH_ERROR';\n}\n\n/**\n * Error thrown when OAuth2 token is expired.\n */\nexport class TokenExpiredError extends AuthError {\n  override readonly code: string = 'TOKEN_EXPIRED_ERROR';\n\n  constructor(message = 'Access token has expired', context?: Record<string, unknown>) {\n    super(message, context);\n  }\n}\n\n/**\n * Error thrown when auth configuration is invalid.\n */\nexport class AuthConfigError extends AuthError {\n  override readonly code: string = 'AUTH_CONFIG_ERROR';\n  readonly validationErrors: z.core.$ZodIssue[] | undefined;\n\n  constructor(message: string, validationErrors?: z.core.$ZodIssue[]) {\n    super(message, validationErrors !== undefined ? { validationErrors } : undefined);\n    this.validationErrors = validationErrors;\n  }\n}\n"]}

package/dist/errors/index.d.cts

@@ -0,0 +1,203 @@
+import { z, ZodError } from 'zod';
+
+/**
+ * Base error class for all SDK errors.
+ * Provides consistent error structure with error codes and cause chaining.
+ */
+declare abstract class JiraSdkError extends Error {
+    /** Unique error code for programmatic handling */
+    abstract readonly code: string;
+    /** HTTP status code if applicable */
+    readonly statusCode?: number;
+    /** Original cause of the error */
+    readonly cause?: Error;
+    /** Additional context/metadata */
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, options?: {
+        cause?: Error | undefined;
+        statusCode?: number | undefined;
+        context?: Record<string, unknown> | undefined;
+    });
+    /**
+     * Returns a JSON representation of the error
+     */
+    toJSON(): Record<string, unknown>;
+}
+
+/**
+ * Error details returned by Jira API
+ */
+interface JiraErrorDetail {
+    errorMessages?: string[] | undefined;
+    errors?: Record<string, string> | undefined;
+    warningMessages?: string[] | undefined;
+}
+/**
+ * Error thrown when Jira API returns an error response.
+ */
+declare class ApiError extends JiraSdkError {
+    readonly code: string;
+    /** Parsed error details from Jira response */
+    readonly details: JiraErrorDetail | undefined;
+    /** Raw response body */
+    readonly responseBody: unknown;
+    constructor(message: string, statusCode: number, responseBody?: unknown);
+    /**
+     * Returns all error messages as a single array
+     */
+    getAllMessages(): string[];
+}
+/**
+ * Error thrown when user is not authenticated
+ */
+declare class UnauthorizedError extends ApiError {
+    readonly code: string;
+    constructor(message?: string, responseBody?: unknown);
+}
+/**
+ * Error thrown when user lacks required permissions
+ */
+declare class ForbiddenError extends ApiError {
+    readonly code: string;
+    constructor(message?: string, responseBody?: unknown);
+}
+/**
+ * Error thrown when requested resource is not found
+ */
+declare class NotFoundError extends ApiError {
+    readonly code: string;
+    constructor(message?: string, responseBody?: unknown);
+}
+/**
+ * Rate limit error options
+ */
+interface RateLimitErrorOptions {
+    retryAfter?: number | undefined;
+}
+/**
+ * Error thrown when rate limit is exceeded
+ */
+declare class RateLimitError extends ApiError {
+    readonly code: string;
+    /** When to retry (in milliseconds) */
+    readonly retryAfter: number | undefined;
+    constructor(message?: string, responseBody?: unknown, options?: RateLimitErrorOptions);
+}
+/**
+ * Error thrown when server encounters an internal error
+ */
+declare class ServerError extends ApiError {
+    readonly code: string;
+    constructor(message?: string, responseBody?: unknown, statusCode?: number);
+}
+
+/**
+ * Error thrown when validation fails (either request or response).
+ */
+declare class ValidationError extends JiraSdkError {
+    readonly code: string;
+    /** Validation issues from Zod */
+    readonly issues: z.core.$ZodIssue[];
+    /**
+     * @param message Human-readable description of what failed.
+     * @param zodError The underlying Zod error, when the failure came from schema
+     * validation. Omit it for validation that is not schema-driven — for example
+     * a missing environment variable — in which case {@link issues} is empty.
+     */
+    constructor(message: string, zodError?: ZodError);
+    /**
+     * Creates a ValidationError from a ZodError
+     */
+    static fromZodError(zodError: ZodError, prefix?: string): ValidationError;
+    /**
+     * Returns a flat list of all error paths and messages
+     */
+    getFieldErrors(): Array<{
+        path: string;
+        message: string;
+    }>;
+}
+/**
+ * Error thrown when configuration validation fails
+ */
+declare class ConfigValidationError extends ValidationError {
+    readonly code = "CONFIG_VALIDATION_ERROR";
+    static fromZodError(zodError: ZodError): ConfigValidationError;
+}
+/**
+ * Error thrown when response validation fails
+ */
+declare class ResponseValidationError extends ValidationError {
+    readonly code = "RESPONSE_VALIDATION_ERROR";
+    static fromZodError(zodError: ZodError): ResponseValidationError;
+}
+
+/**
+ * Error thrown when a network-level error occurs.
+ */
+declare class NetworkError extends JiraSdkError {
+    readonly code = "NETWORK_ERROR";
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+    /**
+     * Check if this error indicates a connection failure
+     */
+    isConnectionError(): boolean;
+    /**
+     * Check if this error might be retryable
+     */
+    isRetryable(): boolean;
+}
+/**
+ * Error thrown when a request times out.
+ */
+declare class TimeoutError extends JiraSdkError {
+    readonly code = "TIMEOUT_ERROR";
+    /** The timeout duration in milliseconds */
+    readonly timeoutMs: number | undefined;
+    constructor(message: string, options?: {
+        cause?: unknown;
+        timeoutMs?: number;
+    });
+}
+/**
+ * Error thrown when a request is aborted.
+ */
+declare class AbortError extends JiraSdkError {
+    readonly code = "ABORT_ERROR";
+    constructor(message?: string, options?: {
+        cause?: unknown;
+    });
+}
+
+/**
+ * Error thrown when authentication fails or is misconfigured.
+ */
+declare class AuthError extends JiraSdkError {
+    readonly code: string;
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Error thrown when OAuth2 token refresh fails.
+ */
+declare class TokenRefreshError extends AuthError {
+    readonly code: string;
+}
+/**
+ * Error thrown when OAuth2 token is expired.
+ */
+declare class TokenExpiredError extends AuthError {
+    readonly code: string;
+    constructor(message?: string, context?: Record<string, unknown>);
+}
+/**
+ * Error thrown when auth configuration is invalid.
+ */
+declare class AuthConfigError extends AuthError {
+    readonly code: string;
+    readonly validationErrors: z.core.$ZodIssue[] | undefined;
+    constructor(message: string, validationErrors?: z.core.$ZodIssue[]);
+}
+
+export { AbortError, ApiError, AuthConfigError, AuthError, ConfigValidationError, ForbiddenError, type JiraErrorDetail, JiraSdkError, NetworkError, NotFoundError, RateLimitError, ResponseValidationError, ServerError, TimeoutError, TokenExpiredError, TokenRefreshError, UnauthorizedError, ValidationError };