vaultwarden.js 1.0.0 → 1.0.1

package/README.md

@@ -2,9 +2,9 @@
 
 A modern, type-safe, object-oriented TypeScript SDK for Vaultwarden/Bitwarden servers. Inspired by [discord.js](https://discord.js.org/) with a focus on developer experience and comprehensive type safety.
 
-[![npm version](https://img.shields.io/npm/v/vaultwarden-client.svg)](https://www.npmjs.com/package/vaultwarden-client)
+[![npm version](https://img.shields.io/npm/v/vaultwarden.js.svg)](https://www.npmjs.com/package/vaultwarden.js)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.3%2B-blue.svg)](https://www.typescriptlang.org/)
-[![License](https://img.shields.io/npm/l/vaultwarden-client.svg)](LICENSE)
+[![License](https://img.shields.io/npm/l/vaultwarden.js.svg)](LICENSE)
 
 ## Features
 
@@ -19,13 +19,13 @@ A modern, type-safe, object-oriented TypeScript SDK for Vaultwarden/Bitwarden se
 ## Installation
 
 ```bash
-npm install vaultwarden-client
+npm install vaultwarden.
 ```
 
 ## Quick Start
 
 ```typescript
-import { VaultwardenClient } from 'vaultwarden-client';
+import { VaultwardenClient } from 'vaultwarden.js';
 
 const client = new VaultwardenClient({
   baseUrl: 'https://vault.example.com',
@@ -259,7 +259,7 @@ const trash = client.ciphers.trash;
 ## Password Generation
 git remote add origin https://github.com/MarkIt-host/VaultWarden.js.git
 ```typescript
-import { generatePassword, generatePassphrase } from 'vaultwarden-client';
+import { generatePassword, generatePassphrase } from 'vaultwarden.js';
 
 // Generate strong password
 const { password, entropy } = generatePassword({
@@ -337,7 +337,7 @@ import {
   AuthenticationError,
   NotFoundError,
   RateLimitError,
-} from 'vaultwarden-client';
+} from 'vaultwarden.js';
 
 try {
   await client.login({ username, password });
@@ -375,7 +375,7 @@ const client = new VaultwardenClient({
   baseUrl: 'https://vault.example.com',
 
   // Optional
-  deviceName: 'MyApp',      // Default: 'vaultwarden-client'
+  deviceName: 'MyApp',      // Default: 'vaultwarden.js'
   deviceType: 8,              // Default: 8 (Windows Desktop)
   timeout: 30000,             // Request timeout in ms
   maxRetries: 3,              // Max retry attempts

package/dist/chunk-34VL7JLT.js

@@ -0,0 +1,406 @@
+// src/errors/index.ts
+var VaultwardenError = class _VaultwardenError extends Error {
+  /** Error code for programmatic handling */
+  code;
+  /** HTTP status code if applicable */
+  statusCode;
+  /** Additional error context */
+  context;
+  constructor(message, code, statusCode, context) {
+    super(message);
+    this.name = "VaultwardenError";
+    this.code = code;
+    this.statusCode = statusCode;
+    this.context = context;
+    Object.setPrototypeOf(this, _VaultwardenError.prototype);
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, this.constructor);
+    }
+  }
+  /**
+   * Convert error to JSON representation
+   */
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      code: this.code,
+      statusCode: this.statusCode,
+      context: this.context,
+      stack: this.stack
+    };
+  }
+};
+var AuthenticationError = class _AuthenticationError extends VaultwardenError {
+  constructor(message = "Authentication failed", code = "AUTH_FAILED", context) {
+    super(message, code, 401, context);
+    this.name = "AuthenticationError";
+    Object.setPrototypeOf(this, _AuthenticationError.prototype);
+  }
+  /**
+   * Create error for invalid credentials
+   */
+  static invalidCredentials() {
+    return new _AuthenticationError(
+      "Invalid username or password",
+      "INVALID_CREDENTIALS"
+    );
+  }
+  /**
+   * Create error for missing 2FA
+   */
+  static twoFactorRequired(method) {
+    return new _AuthenticationError(
+      "Two-factor authentication required",
+      "2FA_REQUIRED",
+      { method }
+    );
+  }
+  /**
+   * Create error for invalid 2FA code
+   */
+  static invalidTwoFactorCode() {
+    return new _AuthenticationError(
+      "Invalid two-factor authentication code",
+      "INVALID_2FA_CODE"
+    );
+  }
+  /**
+   * Create error for expired session
+   */
+  static sessionExpired() {
+    return new _AuthenticationError(
+      "Session has expired, please log in again",
+      "SESSION_EXPIRED"
+    );
+  }
+};
+var APIError = class _APIError extends VaultwardenError {
+  /** Response body if available */
+  responseBody;
+  /** Request endpoint */
+  endpoint;
+  /** Request method */
+  method;
+  constructor(message, statusCode, code = "API_ERROR", context) {
+    super(message, code, statusCode, context);
+    this.name = "APIError";
+    this.responseBody = context?.responseBody;
+    this.endpoint = context?.endpoint;
+    this.method = context?.method;
+    Object.setPrototypeOf(this, _APIError.prototype);
+  }
+  /**
+   * Create error from HTTP response
+   */
+  static fromResponse(response, endpoint, method, body) {
+    const messages = {
+      400: "Bad request",
+      401: "Unauthorized",
+      403: "Forbidden",
+      404: "Not found",
+      405: "Method not allowed",
+      409: "Conflict",
+      429: "Rate limited",
+      500: "Internal server error",
+      502: "Bad gateway",
+      503: "Service unavailable"
+    };
+    const message = messages[response.status] ?? `HTTP ${response.status} error`;
+    const code = `HTTP_${response.status}`;
+    return new _APIError(message, response.status, code, {
+      endpoint,
+      method,
+      responseBody: body,
+      statusText: response.statusText
+    });
+  }
+  /**
+   * Check if error is a rate limit error
+   */
+  get isRateLimit() {
+    return this.statusCode === 429;
+  }
+  /**
+   * Check if error is a server error (5xx)
+   */
+  get isServerError() {
+    return this.statusCode !== void 0 && this.statusCode >= 500;
+  }
+  /**
+   * Check if error is a client error (4xx)
+   */
+  get isClientError() {
+    return this.statusCode !== void 0 && this.statusCode >= 400 && this.statusCode < 500;
+  }
+  /**
+   * Check if request should be retried
+   */
+  get shouldRetry() {
+    if (this.statusCode === void 0) return true;
+    return this.isRateLimit || this.isServerError || [408, 409, 422].includes(this.statusCode);
+  }
+};
+var ValidationError = class _ValidationError extends VaultwardenError {
+  /** Field that failed validation */
+  field;
+  /** Validation constraints that failed */
+  constraints;
+  constructor(message, field, constraints) {
+    super(message, "VALIDATION_ERROR", void 0, { field, constraints });
+    this.name = "ValidationError";
+    this.field = field;
+    this.constraints = constraints;
+    Object.setPrototypeOf(this, _ValidationError.prototype);
+  }
+  /**
+   * Create error for missing required field
+   */
+  static requiredField(field) {
+    return new _ValidationError(
+      `Field '${field}' is required`,
+      field,
+      ["required"]
+    );
+  }
+  /**
+   * Create error for invalid field value
+   */
+  static invalidValue(field, expectedType) {
+    return new _ValidationError(
+      `Field '${field}' must be ${expectedType}`,
+      field,
+      [`type:${expectedType}`]
+    );
+  }
+  /**
+   * Create error for empty value
+   */
+  static notEmpty(field) {
+    return new _ValidationError(
+      `Field '${field}' cannot be empty`,
+      field,
+      ["notEmpty"]
+    );
+  }
+  /**
+   * Create error for invalid URL
+   */
+  static invalidUrl(field) {
+    return new _ValidationError(
+      `Field '${field}' must be a valid URL`,
+      field,
+      ["url"]
+    );
+  }
+  /**
+   * Create error for invalid email
+   */
+  static invalidEmail(field) {
+    return new _ValidationError(
+      `Field '${field}' must be a valid email address`,
+      field,
+      ["email"]
+    );
+  }
+};
+var PermissionError = class _PermissionError extends VaultwardenError {
+  /** Required permission */
+  requiredPermission;
+  /** Resource being accessed */
+  resource;
+  constructor(message = "Permission denied", code = "PERMISSION_DENIED", context) {
+    super(message, code, 403, context);
+    this.name = "PermissionError";
+    this.requiredPermission = context?.requiredPermission;
+    this.resource = context?.resource;
+    Object.setPrototypeOf(this, _PermissionError.prototype);
+  }
+  /**
+   * Create error for insufficient permissions
+   */
+  static insufficientPermission(requiredPermission, resource) {
+    return new _PermissionError(
+      `Insufficient permissions: ${requiredPermission} required`,
+      "INSUFFICIENT_PERMISSION",
+      { requiredPermission, resource }
+    );
+  }
+  /**
+   * Create error for organization access denied
+   */
+  static organizationAccessDenied(orgId) {
+    return new _PermissionError(
+      "Access denied to organization",
+      "ORG_ACCESS_DENIED",
+      { organizationId: orgId }
+    );
+  }
+  /**
+   * Create error for collection access denied
+   */
+  static collectionAccessDenied(collectionId) {
+    return new _PermissionError(
+      "Access denied to collection",
+      "COLLECTION_ACCESS_DENIED",
+      { collectionId }
+    );
+  }
+};
+var NotFoundError = class _NotFoundError extends VaultwardenError {
+  /** Resource type */
+  resourceType;
+  /** Resource identifier */
+  resourceId;
+  constructor(resourceType, resourceId, message) {
+    const msg = message ?? `${resourceType ?? "Resource"}${resourceId ? ` '${resourceId}'` : ""} not found`;
+    super(msg, "NOT_FOUND", 404, { resourceType, resourceId });
+    this.name = "NotFoundError";
+    this.resourceType = resourceType;
+    this.resourceId = resourceId;
+    Object.setPrototypeOf(this, _NotFoundError.prototype);
+  }
+  /**
+   * Create error for cipher not found
+   */
+  static cipher(id) {
+    return new _NotFoundError("Cipher", id);
+  }
+  /**
+   * Create error for folder not found
+   */
+  static folder(id) {
+    return new _NotFoundError("Folder", id);
+  }
+  /**
+   * Create error for organization not found
+   */
+  static organization(id) {
+    return new _NotFoundError("Organization", id);
+  }
+  /**
+   * Create error for collection not found
+   */
+  static collection(id) {
+    return new _NotFoundError("Collection", id);
+  }
+};
+var RateLimitError = class _RateLimitError extends VaultwardenError {
+  /** Time to wait before retry (seconds) */
+  retryAfter;
+  /** Limit that was hit */
+  limit;
+  constructor(retryAfter, limit, message) {
+    const msg = message ?? `Rate limit exceeded. Retry after ${retryAfter ?? "some"} seconds.`;
+    super(msg, "RATE_LIMITED", 429, { retryAfter, limit });
+    this.name = "RateLimitError";
+    this.retryAfter = retryAfter;
+    this.limit = limit;
+    Object.setPrototypeOf(this, _RateLimitError.prototype);
+  }
+  /**
+   * Check if retry should be attempted
+   */
+  get shouldRetry() {
+    return true;
+  }
+};
+var TimeoutError = class _TimeoutError extends VaultwardenError {
+  /** Request endpoint that timed out */
+  endpoint;
+  /** Timeout duration in milliseconds */
+  timeoutMs;
+  constructor(endpoint, timeoutMs, message) {
+    const msg = message ?? `Request${endpoint ? ` to ${endpoint}` : ""} timed out after ${timeoutMs ?? ""}ms`;
+    super(msg, "TIMEOUT", void 0, { endpoint, timeoutMs });
+    this.name = "TimeoutError";
+    this.endpoint = endpoint;
+    this.timeoutMs = timeoutMs;
+    Object.setPrototypeOf(this, _TimeoutError.prototype);
+  }
+};
+var CryptoError = class _CryptoError extends VaultwardenError {
+  /** Operation that failed */
+  operation;
+  constructor(message, operation, context) {
+    super(message, "CRYPTO_ERROR", void 0, { ...context, operation });
+    this.name = "CryptoError";
+    this.operation = operation;
+    Object.setPrototypeOf(this, _CryptoError.prototype);
+  }
+  /**
+   * Create error for key derivation failure
+   */
+  static keyDerivation() {
+    return new _CryptoError(
+      "Failed to derive encryption key",
+      "keyDerivation"
+    );
+  }
+  /**
+   * Create error for decryption failure
+   */
+  static decryption() {
+    return new _CryptoError(
+      "Failed to decrypt data",
+      "decryption"
+    );
+  }
+  /**
+   * Create error for encryption failure
+   */
+  static encryption() {
+    return new _CryptoError(
+      "Failed to encrypt data",
+      "encryption"
+    );
+  }
+};
+var StateError = class _StateError extends VaultwardenError {
+  constructor(message, code = "INVALID_STATE") {
+    super(message, code);
+    this.name = "StateError";
+    Object.setPrototypeOf(this, _StateError.prototype);
+  }
+  /**
+   * Create error for not authenticated
+   */
+  static notAuthenticated() {
+    return new _StateError(
+      "Not authenticated. Call login() first.",
+      "NOT_AUTHENTICATED"
+    );
+  }
+  /**
+   * Create error for already authenticated
+   */
+  static alreadyAuthenticated() {
+    return new _StateError(
+      "Already authenticated. Logout first.",
+      "ALREADY_AUTHENTICATED"
+    );
+  }
+  /**
+   * Create error for client not ready
+   */
+  static notReady() {
+    return new _StateError(
+      "Client not ready. Ensure login() completed successfully.",
+      "NOT_READY"
+    );
+  }
+};
+
+export {
+  VaultwardenError,
+  AuthenticationError,
+  APIError,
+  ValidationError,
+  PermissionError,
+  NotFoundError,
+  RateLimitError,
+  TimeoutError,
+  CryptoError,
+  StateError
+};
+//# sourceMappingURL=chunk-34VL7JLT.js.map

package/dist/chunk-34VL7JLT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/index.ts"],"sourcesContent":["/**\n * Custom error classes for Vaultwarden Client\n * @module errors\n */\n\n/**\n * Base error class for all Vaultwarden client errors\n * @extends Error\n */\nexport class VaultwardenError extends Error {\n  /** Error code for programmatic handling */\n  public readonly code: string;\n  /** HTTP status code if applicable */\n  public readonly statusCode?: number;\n  /** Additional error context */\n  public readonly context?: Record<string, unknown>;\n\n  constructor(\n    message: string,\n    code: string,\n    statusCode?: number,\n    context?: Record<string, unknown>\n  ) {\n    super(message);\n    this.name = 'VaultwardenError';\n    this.code = code;\n    this.statusCode = statusCode!;\n    this.context = context!;\n\n    // Fix prototype chain for instanceof checks\n    Object.setPrototypeOf(this, VaultwardenError.prototype);\n\n    // Capture stack trace\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n\n  /**\n   * Convert error to JSON representation\n   */\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n      code: this.code,\n      statusCode: this.statusCode,\n      context: this.context,\n      stack: this.stack,\n    };\n  }\n}\n\n/**\n * Error thrown when authentication fails\n * @extends VaultwardenError\n */\nexport class AuthenticationError extends VaultwardenError {\n  constructor(\n    message = 'Authentication failed',\n    code = 'AUTH_FAILED',\n    context?: Record<string, unknown>\n  ) {\n    super(message, code, 401, context);\n    this.name = 'AuthenticationError';\n    Object.setPrototypeOf(this, AuthenticationError.prototype);\n  }\n\n  /**\n   * Create error for invalid credentials\n   */\n  static invalidCredentials(): AuthenticationError {\n    return new AuthenticationError(\n      'Invalid username or password',\n      'INVALID_CREDENTIALS'\n    );\n  }\n\n  /**\n   * Create error for missing 2FA\n   */\n  static twoFactorRequired(method?: string): AuthenticationError {\n    return new AuthenticationError(\n      'Two-factor authentication required',\n      '2FA_REQUIRED',\n      { method }\n    );\n  }\n\n  /**\n   * Create error for invalid 2FA code\n   */\n  static invalidTwoFactorCode(): AuthenticationError {\n    return new AuthenticationError(\n      'Invalid two-factor authentication code',\n      'INVALID_2FA_CODE'\n    );\n  }\n\n  /**\n   * Create error for expired session\n   */\n  static sessionExpired(): AuthenticationError {\n    return new AuthenticationError(\n      'Session has expired, please log in again',\n      'SESSION_EXPIRED'\n    );\n  }\n}\n\n/**\n * Error thrown when an API request fails\n * @extends VaultwardenError\n */\nexport class APIError extends VaultwardenError {\n  /** Response body if available */\n  public readonly responseBody?: string;\n  /** Request endpoint */\n  public readonly endpoint?: string;\n  /** Request method */\n  public readonly method?: string;\n\n  constructor(\n    message: string,\n    statusCode: number,\n    code = 'API_ERROR',\n    context?: Record<string, unknown>\n  ) {\n    super(message, code, statusCode, context);\n    this.name = 'APIError';\n    this.responseBody = (context?.responseBody as string | undefined)!;\n    this.endpoint = (context?.endpoint as string | undefined)!;\n    this.method = (context?.method as string | undefined)!;\n    Object.setPrototypeOf(this, APIError.prototype);\n  }\n\n  /**\n   * Create error from HTTP response\n   */\n  static fromResponse(\n    response: Response,\n    endpoint: string,\n    method: string,\n    body?: string\n  ): APIError {\n    const messages: Record<number, string> = {\n      400: 'Bad request',\n      401: 'Unauthorized',\n      403: 'Forbidden',\n      404: 'Not found',\n      405: 'Method not allowed',\n      409: 'Conflict',\n      429: 'Rate limited',\n      500: 'Internal server error',\n      502: 'Bad gateway',\n      503: 'Service unavailable',\n    };\n\n    const message = messages[response.status] ?? `HTTP ${response.status} error`;\n    const code = `HTTP_${response.status}`;\n\n    return new APIError(message, response.status, code, {\n      endpoint,\n      method,\n      responseBody: body,\n      statusText: response.statusText,\n    });\n  }\n\n  /**\n   * Check if error is a rate limit error\n   */\n  get isRateLimit(): boolean {\n    return this.statusCode === 429;\n  }\n\n  /**\n   * Check if error is a server error (5xx)\n   */\n  get isServerError(): boolean {\n    return this.statusCode !== undefined && this.statusCode >= 500;\n  }\n\n  /**\n   * Check if error is a client error (4xx)\n   */\n  get isClientError(): boolean {\n    return this.statusCode !== undefined && this.statusCode >= 400 && this.statusCode < 500;\n  }\n\n  /**\n   * Check if request should be retried\n   */\n  get shouldRetry(): boolean {\n    if (this.statusCode === undefined) return true;\n    // Retry on rate limit, server errors, and specific client errors\n    return this.isRateLimit || this.isServerError || [408, 409, 422].includes(this.statusCode);\n  }\n}\n\n/**\n * Error thrown for validation failures\n * @extends VaultwardenError\n */\nexport class ValidationError extends VaultwardenError {\n  /** Field that failed validation */\n  public readonly field?: string;\n  /** Validation constraints that failed */\n  public readonly constraints?: string[];\n\n  constructor(\n    message: string,\n    field?: string,\n    constraints?: string[]\n  ) {\n    super(message, 'VALIDATION_ERROR', undefined, { field, constraints });\n    this.name = 'ValidationError';\n    this.field = field!;\n    this.constraints = constraints!;\n    Object.setPrototypeOf(this, ValidationError.prototype);\n  }\n\n  /**\n   * Create error for missing required field\n   */\n  static requiredField(field: string): ValidationError {\n    return new ValidationError(\n      `Field '${field}' is required`,\n      field,\n      ['required']\n    );\n  }\n\n  /**\n   * Create error for invalid field value\n   */\n  static invalidValue(field: string, expectedType: string): ValidationError {\n    return new ValidationError(\n      `Field '${field}' must be ${expectedType}`,\n      field,\n      [`type:${expectedType}`]\n    );\n  }\n\n  /**\n   * Create error for empty value\n   */\n  static notEmpty(field: string): ValidationError {\n    return new ValidationError(\n      `Field '${field}' cannot be empty`,\n      field,\n      ['notEmpty']\n    );\n  }\n\n  /**\n   * Create error for invalid URL\n   */\n  static invalidUrl(field: string): ValidationError {\n    return new ValidationError(\n      `Field '${field}' must be a valid URL`,\n      field,\n      ['url']\n    );\n  }\n\n  /**\n   * Create error for invalid email\n   */\n  static invalidEmail(field: string): ValidationError {\n    return new ValidationError(\n      `Field '${field}' must be a valid email address`,\n      field,\n      ['email']\n    );\n  }\n}\n\n/**\n * Error thrown for permission-related failures\n * @extends VaultwardenError\n */\nexport class PermissionError extends VaultwardenError {\n  /** Required permission */\n  public readonly requiredPermission?: string;\n  /** Resource being accessed */\n  public readonly resource?: string;\n\n  constructor(\n    message = 'Permission denied',\n    code = 'PERMISSION_DENIED',\n    context?: Record<string, unknown>\n  ) {\n    super(message, code, 403, context);\n    this.name = 'PermissionError';\n    this.requiredPermission = (context?.requiredPermission as string | undefined)!;\n    this.resource = (context?.resource as string | undefined)!;\n    Object.setPrototypeOf(this, PermissionError.prototype);\n  }\n\n  /**\n   * Create error for insufficient permissions\n   */\n  static insufficientPermission(\n    requiredPermission: string,\n    resource?: string\n  ): PermissionError {\n    return new PermissionError(\n      `Insufficient permissions: ${requiredPermission} required`,\n      'INSUFFICIENT_PERMISSION',\n      { requiredPermission, resource }\n    );\n  }\n\n  /**\n   * Create error for organization access denied\n   */\n  static organizationAccessDenied(orgId: string): PermissionError {\n    return new PermissionError(\n      'Access denied to organization',\n      'ORG_ACCESS_DENIED',\n      { organizationId: orgId }\n    );\n  }\n\n  /**\n   * Create error for collection access denied\n   */\n  static collectionAccessDenied(collectionId: string): PermissionError {\n    return new PermissionError(\n      'Access denied to collection',\n      'COLLECTION_ACCESS_DENIED',\n      { collectionId }\n    );\n  }\n}\n\n/**\n * Error thrown when a resource is not found\n * @extends VaultwardenError\n */\nexport class NotFoundError extends VaultwardenError {\n  /** Resource type */\n  public readonly resourceType?: string;\n  /** Resource identifier */\n  public readonly resourceId?: string;\n\n  constructor(\n    resourceType?: string,\n    resourceId?: string,\n    message?: string\n  ) {\n    const msg = message ?? `${resourceType ?? 'Resource'}${resourceId ? ` '${resourceId}'` : ''} not found`;\n    super(msg, 'NOT_FOUND', 404, { resourceType, resourceId });\n    this.name = 'NotFoundError';\n    this.resourceType = resourceType!;\n    this.resourceId = resourceId!;\n    Object.setPrototypeOf(this, NotFoundError.prototype);\n  }\n\n  /**\n   * Create error for cipher not found\n   */\n  static cipher(id: string): NotFoundError {\n    return new NotFoundError('Cipher', id);\n  }\n\n  /**\n   * Create error for folder not found\n   */\n  static folder(id: string): NotFoundError {\n    return new NotFoundError('Folder', id);\n  }\n\n  /**\n   * Create error for organization not found\n   */\n  static organization(id: string): NotFoundError {\n    return new NotFoundError('Organization', id);\n  }\n\n  /**\n   * Create error for collection not found\n   */\n  static collection(id: string): NotFoundError {\n    return new NotFoundError('Collection', id);\n  }\n}\n\n/**\n * Error thrown for rate limiting\n * @extends VaultwardenError\n */\nexport class RateLimitError extends VaultwardenError {\n  /** Time to wait before retry (seconds) */\n  public readonly retryAfter?: number;\n  /** Limit that was hit */\n  public readonly limit?: number;\n\n  constructor(\n    retryAfter?: number,\n    limit?: number,\n    message?: string\n  ) {\n    const msg = message ?? `Rate limit exceeded. Retry after ${retryAfter ?? 'some'} seconds.`;\n    super(msg, 'RATE_LIMITED', 429, { retryAfter, limit });\n    this.name = 'RateLimitError';\n    this.retryAfter = retryAfter!;\n    this.limit = limit!;\n    Object.setPrototypeOf(this, RateLimitError.prototype);\n  }\n\n  /**\n   * Check if retry should be attempted\n   */\n  get shouldRetry(): boolean {\n    return true;\n  }\n}\n\n/**\n * Error thrown for timeout failures\n * @extends VaultwardenError\n */\nexport class TimeoutError extends VaultwardenError {\n  /** Request endpoint that timed out */\n  public readonly endpoint?: string;\n  /** Timeout duration in milliseconds */\n  public readonly timeoutMs?: number;\n\n  constructor(\n    endpoint?: string,\n    timeoutMs?: number,\n    message?: string\n  ) {\n    const msg = message ?? `Request${endpoint ? ` to ${endpoint}` : ''} timed out after ${timeoutMs ?? ''}ms`;\n    super(msg, 'TIMEOUT', undefined, { endpoint, timeoutMs });\n    this.name = 'TimeoutError';\n    this.endpoint = endpoint!;\n    this.timeoutMs = timeoutMs!;\n    Object.setPrototypeOf(this, TimeoutError.prototype);\n  }\n}\n\n/**\n * Error thrown for crypto operation failures\n * @extends VaultwardenError\n */\nexport class CryptoError extends VaultwardenError {\n  /** Operation that failed */\n  public readonly operation?: string;\n\n  constructor(\n    message: string,\n    operation?: string,\n    context?: Record<string, unknown>\n  ) {\n    super(message, 'CRYPTO_ERROR', undefined, { ...context, operation });\n    this.name = 'CryptoError';\n    this.operation = operation!;\n    Object.setPrototypeOf(this, CryptoError.prototype);\n  }\n\n  /**\n   * Create error for key derivation failure\n   */\n  static keyDerivation(): CryptoError {\n    return new CryptoError(\n      'Failed to derive encryption key',\n      'keyDerivation'\n    );\n  }\n\n  /**\n   * Create error for decryption failure\n   */\n  static decryption(): CryptoError {\n    return new CryptoError(\n      'Failed to decrypt data',\n      'decryption'\n    );\n  }\n\n  /**\n   * Create error for encryption failure\n   */\n  static encryption(): CryptoError {\n    return new CryptoError(\n      'Failed to encrypt data',\n      'encryption'\n    );\n  }\n}\n\n/**\n * Error thrown when state is invalid\n * @extends VaultwardenError\n */\nexport class StateError extends VaultwardenError {\n  constructor(\n    message: string,\n    code = 'INVALID_STATE'\n  ) {\n    super(message, code);\n    this.name = 'StateError';\n    Object.setPrototypeOf(this, StateError.prototype);\n  }\n\n  /**\n   * Create error for not authenticated\n   */\n  static notAuthenticated(): StateError {\n    return new StateError(\n      'Not authenticated. Call login() first.',\n      'NOT_AUTHENTICATED'\n    );\n  }\n\n  /**\n   * Create error for already authenticated\n   */\n  static alreadyAuthenticated(): StateError {\n    return new StateError(\n      'Already authenticated. Logout first.',\n      'ALREADY_AUTHENTICATED'\n    );\n  }\n\n  /**\n   * Create error for client not ready\n   */\n  static notReady(): StateError {\n    return new StateError(\n      'Client not ready. Ensure login() completed successfully.',\n      'NOT_READY'\n    );\n  }\n}\n"],"mappings":"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","names":[]}