apienvelope 1.0.0 → 1.1.0

package/dist/index.mjs

@@ -1,1254 +1,2 @@
-import {
-  ApiError,
-  BadRequestError,
-  ConflictError,
-  ForbiddenError,
-  InternalServerError,
-  NotFoundError,
-  RateLimitError,
-  ServiceUnavailableError,
-  UnauthorizedError,
-  UnprocessableEntityError,
-  ValidationError,
-  createError
-} from "./chunk-2TAKYP6Q.mjs";
-
-// src/types/config.ts
-var defaultConfig = {
-  includeStackTraces: false,
-  environment: "production",
-  includeTimestamp: true,
-  maskSensitiveData: true,
-  requestIdHeader: "x-request-id",
-  correlationIdHeader: "x-correlation-id",
-  pagination: {
-    defaultLimit: 10,
-    maxLimit: 100,
-    includeLinks: false
-  },
-  preResponseHooks: [],
-  postResponseHooks: [],
-  passthroughMode: false,
-  sensitiveFields: ["password", "token", "secret", "apiKey", "authorization"],
-  generateRequestId: true
-};
-
-// src/utils/errorSerializer.ts
-var defaultOptions = {
-  includeStack: false,
-  maskSensitiveData: true,
-  sensitiveFields: ["password", "token", "secret", "apiKey", "authorization"]
-};
-function maskSensitiveFields(obj, sensitiveFields) {
-  const masked = {};
-  const lowerSensitiveFields = sensitiveFields.map((f) => f.toLowerCase());
-  for (const [key, value] of Object.entries(obj)) {
-    if (lowerSensitiveFields.includes(key.toLowerCase())) {
-      masked[key] = "[REDACTED]";
-    } else if (value && typeof value === "object" && !Array.isArray(value)) {
-      masked[key] = maskSensitiveFields(value, sensitiveFields);
-    } else {
-      masked[key] = value;
-    }
-  }
-  return masked;
-}
-function safeSerializeDetails(details, seen = /* @__PURE__ */ new WeakSet()) {
-  if (seen.has(details)) {
-    return { _circular: true };
-  }
-  seen.add(details);
-  const result = {};
-  for (const [key, value] of Object.entries(details)) {
-    if (value === null || value === void 0) {
-      result[key] = value;
-    } else if (typeof value === "object") {
-      if (value instanceof Error) {
-        result[key] = {
-          name: value.name,
-          message: value.message
-        };
-      } else if (Array.isArray(value)) {
-        result[key] = value.map(
-          (item) => typeof item === "object" && item !== null ? safeSerializeDetails(item, seen) : item
-        );
-      } else {
-        result[key] = safeSerializeDetails(value, seen);
-      }
-    } else {
-      result[key] = value;
-    }
-  }
-  return result;
-}
-function serializeError(error, options = {}) {
-  const opts = { ...defaultOptions, ...options };
-  if (opts.customSerializers) {
-    for (const [ErrorClass, serializer] of opts.customSerializers) {
-      if (error instanceof ErrorClass) {
-        const customResult = serializer(error);
-        return {
-          code: customResult.code || "CUSTOM_ERROR",
-          message: customResult.message || error.message,
-          details: opts.maskSensitiveData ? maskSensitiveFields(customResult, opts.sensitiveFields) : customResult
-        };
-      }
-    }
-  }
-  if (error instanceof ApiError) {
-    const serialized = error.serialize(opts.includeStack);
-    let details = serialized.details;
-    if (details && opts.maskSensitiveData) {
-      details = maskSensitiveFields(
-        safeSerializeDetails(details),
-        opts.sensitiveFields
-      );
-    }
-    const result2 = {
-      code: serialized.code,
-      message: serialized.message
-    };
-    if (details && Object.keys(details).length > 0) {
-      result2.details = details;
-    }
-    if (serialized.fields) {
-      result2.fields = serialized.fields;
-    }
-    if (opts.includeStack && serialized.stack) {
-      result2.stack = serialized.stack;
-    }
-    return result2;
-  }
-  const result = {
-    code: "INTERNAL_ERROR",
-    message: error.message || "An unexpected error occurred"
-  };
-  if (opts.includeStack && error.stack) {
-    result.stack = error.stack;
-  }
-  return result;
-}
-function extractFieldErrors(error) {
-  if (error instanceof ApiError && error.fields) {
-    return error.fields;
-  }
-  return void 0;
-}
-function extractErrorContext(error) {
-  if (error instanceof ApiError && error.context) {
-    return error.context;
-  }
-  return void 0;
-}
-function createErrorSerializer(options = {}) {
-  const opts = { ...defaultOptions, ...options };
-  return (error) => serializeError(error, opts);
-}
-
-// src/utils/statusCodeMapper.ts
-var defaultErrorMappings = /* @__PURE__ */ new Map([
-  [ValidationError, 400],
-  [BadRequestError, 400],
-  [UnauthorizedError, 401],
-  [ForbiddenError, 403],
-  [NotFoundError, 404],
-  [ConflictError, 409],
-  [UnprocessableEntityError, 422],
-  [RateLimitError, 429],
-  [InternalServerError, 500],
-  [ServiceUnavailableError, 503]
-]);
-var methodStatusCodes = {
-  GET: 200,
-  POST: 201,
-  PUT: 200,
-  PATCH: 200,
-  DELETE: 204,
-  HEAD: 200,
-  OPTIONS: 200
-};
-var StatusCodeMapper = class {
-  customMappings;
-  constructor(customMappings) {
-    this.customMappings = customMappings || /* @__PURE__ */ new Map();
-  }
-  /**
-   * Get status code for an error
-   */
-  getStatusCode(error) {
-    if (error instanceof ApiError) {
-      return error.statusCode;
-    }
-    for (const [ErrorClass, statusCode] of this.customMappings) {
-      if (error instanceof ErrorClass) {
-        return statusCode;
-      }
-    }
-    for (const [ErrorClass, statusCode] of defaultErrorMappings) {
-      if (error instanceof ErrorClass) {
-        return statusCode;
-      }
-    }
-    return 500;
-  }
-  /**
-   * Get success status code based on HTTP method
-   */
-  getSuccessStatusCode(method, hasData) {
-    const upperMethod = method.toUpperCase();
-    if (upperMethod === "DELETE" && !hasData) {
-      return 204;
-    }
-    return methodStatusCodes[upperMethod] || 200;
-  }
-  /**
-   * Add custom error mapping
-   */
-  addMapping(ErrorClass, statusCode) {
-    this.customMappings.set(ErrorClass, statusCode);
-  }
-  /**
-   * Remove custom error mapping
-   */
-  removeMapping(ErrorClass) {
-    return this.customMappings.delete(ErrorClass);
-  }
-  /**
-   * Check if status code indicates success
-   */
-  static isSuccessCode(statusCode) {
-    return statusCode >= 200 && statusCode < 300;
-  }
-  /**
-   * Check if status code indicates client error
-   */
-  static isClientError(statusCode) {
-    return statusCode >= 400 && statusCode < 500;
-  }
-  /**
-   * Check if status code indicates server error
-   */
-  static isServerError(statusCode) {
-    return statusCode >= 500 && statusCode < 600;
-  }
-};
-function createStatusCodeMapper(customMappings) {
-  return new StatusCodeMapper(customMappings);
-}
-
-// src/utils/validators.ts
-function validatePaginationInput(input, config) {
-  const page = Math.max(1, Math.floor(Number(input.page) || 1));
-  const limit = Math.min(
-    config.maxLimit,
-    Math.max(1, Math.floor(Number(input.limit) || config.defaultLimit))
-  );
-  const total = Math.max(0, Math.floor(Number(input.total) || 0));
-  return { page, limit, total };
-}
-function calculatePaginationMeta(input, baseUrl) {
-  const { page, limit, total } = input;
-  const totalPages = Math.ceil(total / limit) || 1;
-  const hasNextPage = page < totalPages;
-  const hasPreviousPage = page > 1;
-  const meta = {
-    page,
-    limit,
-    total,
-    totalPages,
-    hasNextPage,
-    hasPreviousPage
-  };
-  if (baseUrl) {
-    meta.links = generatePaginationLinks(page, totalPages, limit, baseUrl);
-  }
-  return meta;
-}
-function generatePaginationLinks(page, totalPages, limit, baseUrl) {
-  const url = new URL(baseUrl);
-  const createLink = (p) => {
-    url.searchParams.set("page", String(p));
-    url.searchParams.set("limit", String(limit));
-    return url.toString();
-  };
-  const links = {
-    self: createLink(page),
-    first: createLink(1),
-    last: createLink(totalPages)
-  };
-  if (page < totalPages) {
-    links.next = createLink(page + 1);
-  }
-  if (page > 1) {
-    links.previous = createLink(page - 1);
-  }
-  return links;
-}
-function calculateCursorPaginationMeta(input, baseUrl) {
-  const meta = {
-    limit: input.limit,
-    hasMore: input.hasMore
-  };
-  if (input.cursor) {
-    meta.cursor = input.cursor;
-  }
-  if (input.nextCursor) {
-    meta.nextCursor = input.nextCursor;
-  }
-  if (input.previousCursor) {
-    meta.previousCursor = input.previousCursor;
-  }
-  if (baseUrl) {
-    meta.links = generateCursorPaginationLinks(input, baseUrl);
-  }
-  return meta;
-}
-function generateCursorPaginationLinks(input, baseUrl) {
-  const url = new URL(baseUrl);
-  const createLink = (cursor) => {
-    if (cursor) {
-      url.searchParams.set("cursor", cursor);
-    } else {
-      url.searchParams.delete("cursor");
-    }
-    url.searchParams.set("limit", String(input.limit));
-    return url.toString();
-  };
-  const links = {
-    self: createLink(input.cursor)
-  };
-  if (input.nextCursor && input.hasMore) {
-    links.next = createLink(input.nextCursor);
-  }
-  if (input.previousCursor) {
-    links.previous = createLink(input.previousCursor);
-  }
-  return links;
-}
-function validateConfig(input) {
-  const errors = [];
-  if (input.environment && !["development", "staging", "production", "test"].includes(input.environment)) {
-    errors.push(`Invalid environment: ${input.environment}`);
-  }
-  if (input.pagination) {
-    if (input.pagination.defaultLimit !== void 0 && input.pagination.defaultLimit < 1) {
-      errors.push("pagination.defaultLimit must be at least 1");
-    }
-    if (input.pagination.maxLimit !== void 0 && input.pagination.maxLimit < 1) {
-      errors.push("pagination.maxLimit must be at least 1");
-    }
-    if (input.pagination.defaultLimit !== void 0 && input.pagination.maxLimit !== void 0 && input.pagination.defaultLimit > input.pagination.maxLimit) {
-      errors.push("pagination.defaultLimit cannot exceed pagination.maxLimit");
-    }
-  }
-  return errors;
-}
-function isPlainObject(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function generateRequestId() {
-  const timestamp = Date.now().toString(36);
-  const random = Math.random().toString(36).substring(2, 10);
-  return `${timestamp}-${random}`;
-}
-
-// src/core/ResponseFormatter.ts
-var ResponseFormatter = class {
-  config;
-  statusCodeMapper;
-  constructor(config = {}) {
-    this.config = this.mergeConfig(config);
-    this.statusCodeMapper = new StatusCodeMapper(this.config.customErrorMappers);
-  }
-  /**
-   * Merge user config with defaults
-   */
-  mergeConfig(input) {
-    return {
-      ...defaultConfig,
-      ...input,
-      pagination: {
-        ...defaultConfig.pagination,
-        ...input.pagination
-      },
-      preResponseHooks: input.preResponseHooks || defaultConfig.preResponseHooks,
-      postResponseHooks: input.postResponseHooks || defaultConfig.postResponseHooks,
-      sensitiveFields: input.sensitiveFields || defaultConfig.sensitiveFields
-    };
-  }
-  /**
-   * Get current configuration
-   */
-  getConfig() {
-    return { ...this.config };
-  }
-  /**
-   * Update configuration
-   */
-  updateConfig(config) {
-    this.config = this.mergeConfig({ ...this.config, ...config });
-    if (config.customErrorMappers) {
-      this.statusCodeMapper = new StatusCodeMapper(config.customErrorMappers);
-    }
-  }
-  /**
-   * Generate timestamp
-   */
-  getTimestamp() {
-    return this.config.includeTimestamp ? (/* @__PURE__ */ new Date()).toISOString() : "";
-  }
-  /**
-   * Apply pre-response hooks
-   */
-  applyPreHooks(data, meta) {
-    let result = { data, meta };
-    for (const hook of this.config.preResponseHooks) {
-      const hookResult = hook(result.data, result.meta);
-      result = { data: hookResult.data, meta: hookResult.meta };
-    }
-    return result;
-  }
-  /**
-   * Apply post-response hooks
-   */
-  applyPostHooks(response) {
-    let result = response;
-    for (const hook of this.config.postResponseHooks) {
-      result = hook(result);
-    }
-    return result;
-  }
-  /**
-   * Format a success response
-   */
-  formatSuccess(data, meta) {
-    const processed = this.applyPreHooks(data, meta);
-    const response = {
-      success: true,
-      data: processed.data,
-      timestamp: this.getTimestamp()
-    };
-    if (processed.meta && Object.keys(processed.meta).length > 0) {
-      response.meta = processed.meta;
-    }
-    if (this.config.passthroughMode && this.config.customFormatter) {
-      return this.config.customFormatter(response);
-    }
-    return this.applyPostHooks(response);
-  }
-  /**
-   * Format an error response
-   */
-  formatError(error, meta) {
-    const includeStack = this.config.includeStackTraces || this.config.environment === "development";
-    const errorDetails = serializeError(error, {
-      includeStack,
-      maskSensitiveData: this.config.maskSensitiveData,
-      sensitiveFields: this.config.sensitiveFields,
-      customSerializers: this.config.customSerializers
-    });
-    const response = {
-      success: false,
-      error: errorDetails,
-      timestamp: this.getTimestamp()
-    };
-    if (meta && Object.keys(meta).length > 0) {
-      response.meta = meta;
-    }
-    if (this.config.passthroughMode && this.config.customFormatter) {
-      return this.config.customFormatter(response);
-    }
-    return this.applyPostHooks(response);
-  }
-  /**
-   * Format a paginated response (offset-based)
-   */
-  formatPaginated(data, paginationInput, meta, baseUrl) {
-    const processed = this.applyPreHooks(data, meta);
-    const validatedInput = validatePaginationInput(paginationInput, this.config.pagination);
-    const paginationMeta = calculatePaginationMeta(
-      validatedInput,
-      this.config.pagination.includeLinks ? baseUrl : void 0
-    );
-    const response = {
-      success: true,
-      data: processed.data,
-      pagination: paginationMeta,
-      timestamp: this.getTimestamp()
-    };
-    if (processed.meta && Object.keys(processed.meta).length > 0) {
-      response.meta = processed.meta;
-    }
-    return this.applyPostHooks(response);
-  }
-  /**
-   * Format a cursor-paginated response
-   */
-  formatCursorPaginated(data, cursorInput, meta, baseUrl) {
-    const processed = this.applyPreHooks(data, meta);
-    const paginationMeta = calculateCursorPaginationMeta(
-      cursorInput,
-      this.config.pagination.includeLinks ? baseUrl : void 0
-    );
-    const response = {
-      success: true,
-      data: processed.data,
-      pagination: paginationMeta,
-      timestamp: this.getTimestamp()
-    };
-    if (processed.meta && Object.keys(processed.meta).length > 0) {
-      response.meta = processed.meta;
-    }
-    return this.applyPostHooks(response);
-  }
-  /**
-   * Get status code for an error
-   */
-  getErrorStatusCode(error) {
-    return this.statusCodeMapper.getStatusCode(error);
-  }
-  /**
-   * Get success status code based on HTTP method
-   */
-  getSuccessStatusCode(method, hasData) {
-    return this.statusCodeMapper.getSuccessStatusCode(method, hasData);
-  }
-  /**
-   * Generate or extract request ID
-   */
-  getRequestId(existingId) {
-    if (existingId) {
-      return existingId;
-    }
-    return this.config.generateRequestId ? generateRequestId() : "";
-  }
-};
-function createResponseFormatter(config) {
-  return new ResponseFormatter(config);
-}
-
-// src/core/ErrorHandler.ts
-var defaultErrorHandlerOptions = {
-  logErrors: true
-};
-var ErrorHandler = class {
-  formatter;
-  options;
-  config;
-  constructor(formatter, options = {}) {
-    this.formatter = formatter;
-    this.options = { ...defaultErrorHandlerOptions, ...options };
-    this.config = formatter.getConfig();
-  }
-  /**
-   * Extract request metadata for error context
-   */
-  extractMeta(req) {
-    const meta = {};
-    const requestId = req.get(this.config.requestIdHeader);
-    if (requestId) {
-      meta.requestId = requestId;
-    }
-    const correlationId = req.get(this.config.correlationIdHeader);
-    if (correlationId) {
-      meta.correlationId = correlationId;
-    }
-    return meta;
-  }
-  /**
-   * Log error if enabled
-   */
-  logError(error, req) {
-    if (!this.options.logErrors) return;
-    if (this.options.errorLogger) {
-      this.options.errorLogger(error, req);
-      return;
-    }
-    const isOperational = error instanceof ApiError ? error.isOperational : false;
-    const logLevel = isOperational ? "warn" : "error";
-    console[logLevel]({
-      message: error.message,
-      name: error.name,
-      stack: error.stack,
-      path: req.path,
-      method: req.method,
-      timestamp: (/* @__PURE__ */ new Date()).toISOString()
-    });
-  }
-  /**
-   * Check if error is operational (expected)
-   */
-  isOperationalError(error) {
-    if (error instanceof ApiError) {
-      return error.isOperational;
-    }
-    return false;
-  }
-  /**
-   * Handle the error and send response
-   */
-  handle(error, req, res, _next) {
-    this.logError(error, req);
-    const transformedError = this.options.transformError ? this.options.transformError(error) : error;
-    if (!this.isOperationalError(transformedError) && this.options.handleNonOperational) {
-      this.options.handleNonOperational(transformedError, req, res);
-      return;
-    }
-    const statusCode = this.formatter.getErrorStatusCode(transformedError);
-    const meta = this.extractMeta(req);
-    const response = this.formatter.formatError(transformedError, meta);
-    res.status(statusCode).json(response);
-  }
-  /**
-   * Create Express error handling middleware
-   */
-  middleware() {
-    return (error, req, res, next) => {
-      this.handle(error, req, res, next);
-    };
-  }
-};
-function createErrorHandler(formatter, options) {
-  return new ErrorHandler(formatter, options);
-}
-function errorHandlerMiddleware(formatter, options) {
-  const handler = new ErrorHandler(formatter, options);
-  return handler.middleware();
-}
-
-// src/core/PaginationHelper.ts
-var PaginationHelper = class {
-  config;
-  constructor(config = {}) {
-    this.config = {
-      defaultLimit: config.defaultLimit ?? 10,
-      maxLimit: config.maxLimit ?? 100,
-      includeLinks: config.includeLinks ?? false,
-      baseUrl: config.baseUrl
-    };
-  }
-  /**
-   * Extract pagination parameters from request
-   */
-  extractFromRequest(req) {
-    const page = Math.max(1, parseInt(req.query.page, 10) || 1);
-    const limit = Math.min(
-      this.config.maxLimit,
-      Math.max(1, parseInt(req.query.limit, 10) || this.config.defaultLimit)
-    );
-    return { page, limit };
-  }
-  /**
-   * Extract cursor pagination parameters from request
-   */
-  extractCursorFromRequest(req) {
-    const cursor = req.query.cursor;
-    const limit = Math.min(
-      this.config.maxLimit,
-      Math.max(1, parseInt(req.query.limit, 10) || this.config.defaultLimit)
-    );
-    return { cursor, limit };
-  }
-  /**
-   * Calculate offset for database queries
-   */
-  calculateOffset(page, limit) {
-    return (page - 1) * limit;
-  }
-  /**
-   * Build pagination metadata
-   */
-  buildMeta(input, baseUrl) {
-    const validated = validatePaginationInput(input, this.config);
-    return calculatePaginationMeta(
-      validated,
-      this.config.includeLinks ? baseUrl || this.config.baseUrl : void 0
-    );
-  }
-  /**
-   * Build cursor pagination metadata
-   */
-  buildCursorMeta(input, baseUrl) {
-    return calculateCursorPaginationMeta(
-      input,
-      this.config.includeLinks ? baseUrl || this.config.baseUrl : void 0
-    );
-  }
-  /**
-   * Create pagination info from data array and total count
-   */
-  fromArray(data, page, limit, total) {
-    const pagination = this.buildMeta({ page, limit, total });
-    return { data, pagination };
-  }
-  /**
-   * Paginate an in-memory array
-   */
-  paginateArray(items, page, limit) {
-    const total = items.length;
-    const offset = this.calculateOffset(page, limit);
-    const data = items.slice(offset, offset + limit);
-    return this.fromArray(data, page, limit, total);
-  }
-  /**
-   * Check if there are more pages
-   */
-  hasNextPage(page, limit, total) {
-    const totalPages = Math.ceil(total / limit);
-    return page < totalPages;
-  }
-  /**
-   * Check if there are previous pages
-   */
-  hasPreviousPage(page) {
-    return page > 1;
-  }
-  /**
-   * Get total pages count
-   */
-  getTotalPages(total, limit) {
-    return Math.ceil(total / limit) || 1;
-  }
-  /**
-   * Validate page number is within bounds
-   */
-  isValidPage(page, total, limit) {
-    if (page < 1) return false;
-    if (total === 0) return page === 1;
-    const totalPages = this.getTotalPages(total, limit);
-    return page <= totalPages;
-  }
-  /**
-   * Get configuration
-   */
-  getConfig() {
-    return { ...this.config };
-  }
-  /**
-   * Update configuration
-   */
-  updateConfig(config) {
-    this.config = { ...this.config, ...config };
-  }
-};
-function createPaginationHelper(config) {
-  return new PaginationHelper(config);
-}
-
-// src/middleware/responseWrapper.ts
-function responseWrapper(options = {}) {
-  const { skipPaths = [], skipCondition, ...formatterConfig } = options;
-  const formatter = new ResponseFormatter(formatterConfig);
-  const config = formatter.getConfig();
-  return (req, res, next) => {
-    const formattedReq = req;
-    const formattedRes = res;
-    if (skipPaths.includes(req.path) || skipCondition && skipCondition(req)) {
-      next();
-      return;
-    }
-    let requestId = req.get(config.requestIdHeader);
-    if (!requestId && config.generateRequestId) {
-      requestId = generateRequestId();
-    }
-    if (requestId) {
-      formattedReq.requestId = requestId;
-      res.setHeader(config.requestIdHeader, requestId);
-    }
-    const correlationId = req.get(config.correlationIdHeader);
-    if (correlationId) {
-      formattedReq.correlationId = correlationId;
-      res.setHeader(config.correlationIdHeader, correlationId);
-    }
-    formattedRes.formatter = formatter;
-    const buildMeta = (additionalMeta) => {
-      const meta = {};
-      if (requestId) meta.requestId = requestId;
-      if (correlationId) meta.correlationId = correlationId;
-      return { ...meta, ...additionalMeta };
-    };
-    const getBaseUrl = () => {
-      const protocol = req.protocol;
-      const host = req.get("host") || "localhost";
-      return `${protocol}://${host}${req.originalUrl.split("?")[0]}`;
-    };
-    formattedRes.respond = (data, meta, statusCode) => {
-      const response = formatter.formatSuccess(data, buildMeta(meta));
-      const status = statusCode ?? formatter.getSuccessStatusCode(req.method, data !== void 0);
-      res.status(status).json(response);
-    };
-    formattedRes.respondPaginated = (data, pagination, meta) => {
-      const response = formatter.formatPaginated(
-        data,
-        pagination,
-        buildMeta(meta),
-        getBaseUrl()
-      );
-      res.status(200).json(response);
-    };
-    formattedRes.respondCursorPaginated = (data, pagination, meta) => {
-      const response = formatter.formatCursorPaginated(
-        data,
-        pagination,
-        buildMeta(meta),
-        getBaseUrl()
-      );
-      res.status(200).json(response);
-    };
-    formattedRes.respondError = (error, meta) => {
-      const response = formatter.formatError(error, buildMeta(meta));
-      const statusCode = formatter.getErrorStatusCode(error);
-      res.status(statusCode).json(response);
-    };
-    next();
-  };
-}
-function createResponseWrapper(formatter, options = {}) {
-  const { skipPaths = [], skipCondition } = options;
-  const config = formatter.getConfig();
-  return (req, res, next) => {
-    const formattedReq = req;
-    const formattedRes = res;
-    if (skipPaths.includes(req.path) || skipCondition && skipCondition(req)) {
-      next();
-      return;
-    }
-    let requestId = req.get(config.requestIdHeader);
-    if (!requestId && config.generateRequestId) {
-      requestId = generateRequestId();
-    }
-    if (requestId) {
-      formattedReq.requestId = requestId;
-      res.setHeader(config.requestIdHeader, requestId);
-    }
-    const correlationId = req.get(config.correlationIdHeader);
-    if (correlationId) {
-      formattedReq.correlationId = correlationId;
-      res.setHeader(config.correlationIdHeader, correlationId);
-    }
-    formattedRes.formatter = formatter;
-    const buildMeta = (additionalMeta) => {
-      const meta = {};
-      if (requestId) meta.requestId = requestId;
-      if (correlationId) meta.correlationId = correlationId;
-      return { ...meta, ...additionalMeta };
-    };
-    const getBaseUrl = () => {
-      const protocol = req.protocol;
-      const host = req.get("host") || "localhost";
-      return `${protocol}://${host}${req.originalUrl.split("?")[0]}`;
-    };
-    formattedRes.respond = (data, meta, statusCode) => {
-      const response = formatter.formatSuccess(data, buildMeta(meta));
-      const status = statusCode ?? formatter.getSuccessStatusCode(req.method, data !== void 0);
-      res.status(status).json(response);
-    };
-    formattedRes.respondPaginated = (data, pagination, meta) => {
-      const response = formatter.formatPaginated(data, pagination, buildMeta(meta), getBaseUrl());
-      res.status(200).json(response);
-    };
-    formattedRes.respondCursorPaginated = (data, pagination, meta) => {
-      const response = formatter.formatCursorPaginated(data, pagination, buildMeta(meta), getBaseUrl());
-      res.status(200).json(response);
-    };
-    formattedRes.respondError = (error, meta) => {
-      const response = formatter.formatError(error, buildMeta(meta));
-      const statusCode = formatter.getErrorStatusCode(error);
-      res.status(statusCode).json(response);
-    };
-    next();
-  };
-}
-
-// src/middleware/errorCatcher.ts
-function errorCatcher(options = {}) {
-  const {
-    logErrors = true,
-    errorLogger,
-    transformError,
-    customHandler,
-    ...formatterConfig
-  } = options;
-  const formatter = new ResponseFormatter(formatterConfig);
-  const config = formatter.getConfig();
-  return (error, req, res, _next) => {
-    if (customHandler && customHandler(error, req, res)) {
-      return;
-    }
-    if (logErrors) {
-      if (errorLogger) {
-        errorLogger(error, req);
-      } else {
-        console.error({
-          message: error.message,
-          name: error.name,
-          stack: error.stack,
-          path: req.path,
-          method: req.method,
-          timestamp: (/* @__PURE__ */ new Date()).toISOString()
-        });
-      }
-    }
-    const finalError = transformError ? transformError(error) : error;
-    const formattedReq = req;
-    const meta = {};
-    if (formattedReq.requestId) {
-      meta.requestId = formattedReq.requestId;
-    } else {
-      const requestId = req.get(config.requestIdHeader);
-      if (requestId) {
-        meta.requestId = requestId;
-      }
-    }
-    if (formattedReq.correlationId) {
-      meta.correlationId = formattedReq.correlationId;
-    } else {
-      const correlationId = req.get(config.correlationIdHeader);
-      if (correlationId) {
-        meta.correlationId = correlationId;
-      }
-    }
-    const response = formatter.formatError(finalError, meta);
-    const statusCode = formatter.getErrorStatusCode(finalError);
-    res.status(statusCode).json(response);
-  };
-}
-function createErrorCatcher(formatter, options = {}) {
-  const { logErrors = true, errorLogger, transformError, customHandler } = options;
-  const config = formatter.getConfig();
-  return (error, req, res, _next) => {
-    if (customHandler && customHandler(error, req, res)) {
-      return;
-    }
-    if (logErrors) {
-      if (errorLogger) {
-        errorLogger(error, req);
-      } else {
-        console.error({
-          message: error.message,
-          name: error.name,
-          stack: error.stack,
-          path: req.path,
-          method: req.method,
-          timestamp: (/* @__PURE__ */ new Date()).toISOString()
-        });
-      }
-    }
-    const finalError = transformError ? transformError(error) : error;
-    const formattedReq = req;
-    const meta = {};
-    if (formattedReq.requestId) {
-      meta.requestId = formattedReq.requestId;
-    } else {
-      const requestId = req.get(config.requestIdHeader);
-      if (requestId) {
-        meta.requestId = requestId;
-      }
-    }
-    if (formattedReq.correlationId) {
-      meta.correlationId = formattedReq.correlationId;
-    } else {
-      const correlationId = req.get(config.correlationIdHeader);
-      if (correlationId) {
-        meta.correlationId = correlationId;
-      }
-    }
-    const response = formatter.formatError(finalError, meta);
-    const statusCode = formatter.getErrorStatusCode(finalError);
-    res.status(statusCode).json(response);
-  };
-}
-function asyncHandler(fn) {
-  return (req, res, next) => {
-    Promise.resolve(fn(req, res, next)).catch(next);
-  };
-}
-function catchErrors(fn) {
-  return async (req, res, next) => {
-    try {
-      await fn(req, res);
-    } catch (error) {
-      next(error);
-    }
-  };
-}
-
-// src/decorators/response.ts
-function createResponseDecorator(formatter) {
-  return (options = {}) => {
-    return (_target, _propertyKey, descriptor) => {
-      const originalMethod = descriptor.value;
-      descriptor.value = async function(req, res, next) {
-        try {
-          const result = await originalMethod.call(this, req, res, next);
-          if (res.headersSent) {
-            return;
-          }
-          if (options.raw) {
-            res.json(result);
-            return;
-          }
-          const formattedReq = req;
-          const meta = { ...options.meta };
-          if (formattedReq.requestId) {
-            meta.requestId = formattedReq.requestId;
-          }
-          if (formattedReq.correlationId) {
-            meta.correlationId = formattedReq.correlationId;
-          }
-          const response = formatter.formatSuccess(result, meta);
-          const statusCode = options.statusCode ?? formatter.getSuccessStatusCode(req.method, result !== void 0);
-          res.status(statusCode).json(response);
-        } catch (error) {
-          if (next) {
-            next(error);
-          } else {
-            throw error;
-          }
-        }
-      };
-      return descriptor;
-    };
-  };
-}
-function HandleErrors() {
-  return (_target, _propertyKey, descriptor) => {
-    const originalMethod = descriptor.value;
-    descriptor.value = async function(req, res, next) {
-      try {
-        await originalMethod.call(this, req, res, next);
-      } catch (error) {
-        next(error);
-      }
-    };
-    return descriptor;
-  };
-}
-function ApiRoute(formatter, options = {}) {
-  return (_target, _propertyKey, descriptor) => {
-    const originalMethod = descriptor.value;
-    descriptor.value = async function(req, res, next) {
-      try {
-        const result = await originalMethod.call(this, req, res, next);
-        if (res.headersSent) {
-          return;
-        }
-        if (options.raw) {
-          res.json(result);
-          return;
-        }
-        const formattedReq = req;
-        const meta = { ...options.meta };
-        if (formattedReq.requestId) {
-          meta.requestId = formattedReq.requestId;
-        }
-        if (formattedReq.correlationId) {
-          meta.correlationId = formattedReq.correlationId;
-        }
-        const response = formatter.formatSuccess(result, meta);
-        const statusCode = options.statusCode ?? formatter.getSuccessStatusCode(req.method, result !== void 0);
-        res.status(statusCode).json(response);
-      } catch (error) {
-        next(error);
-      }
-    };
-    return descriptor;
-  };
-}
-function Validate(validator, source = "body") {
-  return (_target, _propertyKey, descriptor) => {
-    const originalMethod = descriptor.value;
-    descriptor.value = async function(req, res, next) {
-      const data = req[source];
-      const result = validator(data);
-      if (!result.valid) {
-        const { ValidationError: ValidationError2 } = await import("./predefined-FHOIIQHS.mjs");
-        next(new ValidationError2("Validation failed", result.errors));
-        return;
-      }
-      await originalMethod.call(this, req, res, next);
-    };
-    return descriptor;
-  };
-}
-
-// src/decorators/paginate.ts
-function Paginate(formatter, options = {}) {
-  const paginationHelper = new PaginationHelper({
-    defaultLimit: options.defaultLimit ?? 10,
-    maxLimit: options.maxLimit ?? 100,
-    includeLinks: options.includeLinks ?? false
-  });
-  return (_target, _propertyKey, descriptor) => {
-    const originalMethod = descriptor.value;
-    descriptor.value = async function(req, res, next) {
-      try {
-        const { page, limit } = paginationHelper.extractFromRequest(req);
-        req.pagination = {
-          page,
-          limit,
-          offset: paginationHelper.calculateOffset(page, limit)
-        };
-        const result = await originalMethod.call(this, req, res, next);
-        if (res.headersSent) {
-          return;
-        }
-        const formattedReq = req;
-        const meta = { ...options.meta };
-        if (formattedReq.requestId) {
-          meta.requestId = formattedReq.requestId;
-        }
-        if (formattedReq.correlationId) {
-          meta.correlationId = formattedReq.correlationId;
-        }
-        const baseUrl = options.includeLinks ? `${req.protocol}://${req.get("host")}${req.originalUrl.split("?")[0]}` : void 0;
-        const response = formatter.formatPaginated(
-          result.data,
-          { page, limit, total: result.total },
-          Object.keys(meta).length > 0 ? meta : void 0,
-          baseUrl
-        );
-        res.status(200).json(response);
-      } catch (error) {
-        next(error);
-      }
-    };
-    return descriptor;
-  };
-}
-function CursorPaginate(formatter, options = {}) {
-  const paginationHelper = new PaginationHelper({
-    defaultLimit: options.defaultLimit ?? 10,
-    maxLimit: options.maxLimit ?? 100,
-    includeLinks: options.includeLinks ?? false
-  });
-  return (_target, _propertyKey, descriptor) => {
-    const originalMethod = descriptor.value;
-    descriptor.value = async function(req, res, next) {
-      try {
-        const { cursor, limit } = paginationHelper.extractCursorFromRequest(req);
-        req.pagination = {
-          cursor,
-          limit
-        };
-        const result = await originalMethod.call(this, req, res, next);
-        if (res.headersSent) {
-          return;
-        }
-        const formattedReq = req;
-        const meta = { ...options.meta };
-        if (formattedReq.requestId) {
-          meta.requestId = formattedReq.requestId;
-        }
-        if (formattedReq.correlationId) {
-          meta.correlationId = formattedReq.correlationId;
-        }
-        const baseUrl = options.includeLinks ? `${req.protocol}://${req.get("host")}${req.originalUrl.split("?")[0]}` : void 0;
-        const response = formatter.formatCursorPaginated(
-          result.data,
-          {
-            limit,
-            cursor,
-            nextCursor: result.nextCursor,
-            previousCursor: result.previousCursor,
-            hasMore: result.hasMore
-          },
-          Object.keys(meta).length > 0 ? meta : void 0,
-          baseUrl
-        );
-        res.status(200).json(response);
-      } catch (error) {
-        next(error);
-      }
-    };
-    return descriptor;
-  };
-}
-
-// src/types/responses.ts
-function isSuccessResponse(response) {
-  return response.success === true;
-}
-function isErrorResponse(response) {
-  return response.success === false;
-}
-function isPaginatedResponse(response) {
-  return response.success === true && "pagination" in response;
-}
-
-// src/types/errors.ts
-var ErrorCodes = {
-  VALIDATION_ERROR: "VALIDATION_ERROR",
-  NOT_FOUND: "NOT_FOUND",
-  UNAUTHORIZED: "UNAUTHORIZED",
-  FORBIDDEN: "FORBIDDEN",
-  CONFLICT: "CONFLICT",
-  INTERNAL_ERROR: "INTERNAL_ERROR",
-  BAD_REQUEST: "BAD_REQUEST",
-  RATE_LIMIT_EXCEEDED: "RATE_LIMIT_EXCEEDED",
-  SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE",
-  UNPROCESSABLE_ENTITY: "UNPROCESSABLE_ENTITY"
-};
-
-// src/index.ts
-function responseFormatter(options = {}) {
-  return {
-    wrapper: responseWrapper(options),
-    errorHandler: errorCatcher(options)
-  };
-}
-var index_default = responseFormatter;
-export {
-  ApiError,
-  ApiRoute,
-  BadRequestError,
-  ConflictError,
-  CursorPaginate,
-  ErrorCodes,
-  ErrorHandler,
-  ForbiddenError,
-  HandleErrors,
-  InternalServerError,
-  NotFoundError,
-  Paginate,
-  PaginationHelper,
-  RateLimitError,
-  ResponseFormatter,
-  ServiceUnavailableError,
-  StatusCodeMapper,
-  UnauthorizedError,
-  UnprocessableEntityError,
-  Validate,
-  ValidationError,
-  asyncHandler,
-  calculateCursorPaginationMeta,
-  calculatePaginationMeta,
-  catchErrors,
-  createError,
-  createErrorCatcher,
-  createErrorHandler,
-  createErrorSerializer,
-  createPaginationHelper,
-  createResponseDecorator,
-  createResponseFormatter,
-  createResponseWrapper,
-  createStatusCodeMapper,
-  index_default as default,
-  defaultConfig,
-  errorCatcher,
-  errorHandlerMiddleware,
-  extractErrorContext,
-  extractFieldErrors,
-  generateCursorPaginationLinks,
-  generatePaginationLinks,
-  generateRequestId,
-  isErrorResponse,
-  isPaginatedResponse,
-  isPlainObject,
-  isSuccessResponse,
-  responseFormatter,
-  responseWrapper,
-  serializeError,
-  validateConfig,
-  validatePaginationInput
-};
+var xe=Object.defineProperty;var G=(r,e)=>()=>(r&&(e=r(r=0)),e);var Pe=(r,e)=>{for(var t in e)xe(r,t,{get:e[t],enumerable:true});};var E,q=G(()=>{E=class r extends Error{code;statusCode;details;fields;context;isOperational;timestamp;constructor(e,t={}){super(e),this.name=this.constructor.name,this.code=t.code||"INTERNAL_ERROR",this.statusCode=t.statusCode||500,this.details=t.details,this.fields=t.fields,this.context=t.context,this.isOperational=t.isOperational??true,this.timestamp=new Date().toISOString(),Error.captureStackTrace(this,this.constructor),t.cause&&(this.cause=t.cause);}serialize(e=false){let t={code:this.code,message:this.message,statusCode:this.statusCode};return this.details&&(t.details=this.details),this.fields&&(t.fields=this.fields),this.context&&(t.context=this.context),e&&this.stack&&(t.stack=this.stack),t}getErrorChain(){let e=[],t=this,o=new WeakSet;for(;t&&!o.has(t);)o.add(t),e.push({name:t.name,message:t.message,code:t instanceof r?t.code:void 0}),t=t.cause;return e}withContext(e){return new r(this.message,{code:this.code,statusCode:this.statusCode,details:this.details,fields:this.fields,context:{...this.context,...e},cause:this.cause,isOperational:this.isOperational})}toJSON(){return {name:this.name,message:this.message,code:this.code,statusCode:this.statusCode,details:this.details,fields:this.fields,context:this.context,isOperational:this.isOperational,timestamp:this.timestamp,stack:this.stack}}};});var te={};Pe(te,{BadRequestError:()=>O,ConflictError:()=>S,ForbiddenError:()=>F,InternalServerError:()=>v,NotFoundError:()=>k,RateLimitError:()=>T,ServiceUnavailableError:()=>w,UnauthorizedError:()=>M,UnprocessableEntityError:()=>L,ValidationError:()=>b,createError:()=>$});function $(r,e,t){let o=new r(e);return t?o.withContext(t):o}var b,k,M,F,S,v,O,T,w,L,U=G(()=>{q();b=class extends E{constructor(e="Validation failed",t,o={}){super(e,{...o,code:"VALIDATION_ERROR",statusCode:400,fields:t});}},k=class extends E{constructor(e="Resource not found",t={}){super(e,{...t,code:"NOT_FOUND",statusCode:404});}},M=class extends E{constructor(e="Authentication required",t={}){super(e,{...t,code:"UNAUTHORIZED",statusCode:401});}},F=class extends E{constructor(e="Access forbidden",t={}){super(e,{...t,code:"FORBIDDEN",statusCode:403});}},S=class extends E{constructor(e="Resource conflict",t={}){super(e,{...t,code:"CONFLICT",statusCode:409});}},v=class extends E{constructor(e="Internal server error",t={}){super(e,{...t,code:"INTERNAL_ERROR",statusCode:500,isOperational:false});}},O=class extends E{constructor(e="Bad request",t={}){super(e,{...t,code:"BAD_REQUEST",statusCode:400});}},T=class extends E{retryAfter;constructor(e="Rate limit exceeded",t,o={}){super(e,{...o,code:"RATE_LIMIT_EXCEEDED",statusCode:429,details:t?{retryAfter:t}:void 0}),this.retryAfter=t;}},w=class extends E{constructor(e="Service temporarily unavailable",t={}){super(e,{...t,code:"SERVICE_UNAVAILABLE",statusCode:503});}},L=class extends E{constructor(e="Unprocessable entity",t={}){super(e,{...t,code:"UNPROCESSABLE_ENTITY",statusCode:422});}};});var I={includeStackTraces:false,environment:"production",includeTimestamp:true,maskSensitiveData:true,requestIdHeader:"x-request-id",correlationIdHeader:"x-correlation-id",pagination:{defaultLimit:10,maxLimit:100,includeLinks:false},preResponseHooks:[],postResponseHooks:[],passthroughMode:false,sensitiveFields:["password","token","secret","apiKey","authorization"],generateRequestId:true};q();var Q={includeStack:false,maskSensitiveData:true,sensitiveFields:["password","token","secret","apiKey","authorization"]};function V(r,e,t=0){if(t>10)return {_truncated:true};let o=Object.create(null),n=e.map(s=>s.toLowerCase());for(let[s,a]of Object.entries(r))s==="__proto__"||s==="constructor"||s==="prototype"||(n.includes(s.toLowerCase())?o[s]="[REDACTED]":a&&typeof a=="object"&&!Array.isArray(a)?o[s]=V(a,e,t+1):o[s]=a);return o}function W(r,e=new WeakSet,t=0){if(t>10)return {_truncated:true};if(e.has(r))return {_circular:true};e.add(r);let o=Object.create(null);for(let[n,s]of Object.entries(r))n==="__proto__"||n==="constructor"||n==="prototype"||(s==null?o[n]=s:typeof s=="object"?s instanceof Error?o[n]={name:s.name,message:s.message}:Array.isArray(s)?o[n]=s.slice(0,100).map(a=>typeof a=="object"&&a!==null?W(a,e,t+1):a):o[n]=W(s,e,t+1):o[n]=s);return o}function j(r,e={}){let t={...Q,...e};if(t.customSerializers){for(let[n,s]of t.customSerializers)if(r instanceof n){let a=s(r);return {code:a.code||"CUSTOM_ERROR",message:a.message||r.message,details:t.maskSensitiveData?V(a,t.sensitiveFields):a}}}if(r instanceof E){let n=r.serialize(t.includeStack),s=n.details;s&&t.maskSensitiveData&&(s=V(W(s),t.sensitiveFields,0));let a={code:n.code,message:n.message};return s&&Object.keys(s).length>0&&(a.details=s),n.fields&&(a.fields=n.fields),t.includeStack&&n.stack&&(a.stack=n.stack),a}let o={code:"INTERNAL_ERROR",message:r.message||"An unexpected error occurred"};return t.includeStack&&r.stack&&(o.stack=r.stack),o}function Y(r){if(r instanceof E&&r.fields)return r.fields}function J(r){if(r instanceof E&&r.context)return r.context}function ee(r={}){let e={...Q,...r};return t=>j(t,e)}q();U();var ye=new Map([[b,400],[O,400],[M,401],[F,403],[k,404],[S,409],[L,422],[T,429],[v,500],[w,503]]),Ie={GET:200,POST:201,PUT:200,PATCH:200,DELETE:204,HEAD:200,OPTIONS:200},P=class{customMappings;constructor(e){this.customMappings=e||new Map;}getStatusCode(e){if(e instanceof E)return e.statusCode;for(let[t,o]of this.customMappings)if(e instanceof t)return o;for(let[t,o]of ye)if(e instanceof t)return o;return 500}getSuccessStatusCode(e,t){let o=e.toUpperCase();return o==="DELETE"&&!t?204:Ie[o]||200}addMapping(e,t){this.customMappings.set(e,t);}removeMapping(e){return this.customMappings.delete(e)}static isSuccessCode(e){return e>=200&&e<300}static isClientError(e){return e>=400&&e<500}static isServerError(e){return e>=500&&e<600}};function re(r){return new P(r)}function K(r,e,t=Number.MAX_SAFE_INTEGER){let o=Number(r);return !Number.isFinite(o)||Number.isNaN(o)?e:Math.min(t,Math.max(0,Math.floor(o)))}function A(r,e){let t=Math.max(1,K(r.page,1,1e6)),o=Math.min(e.maxLimit,Math.max(1,K(r.limit,e.defaultLimit,e.maxLimit))),n=K(r.total,0,Number.MAX_SAFE_INTEGER);return {page:t,limit:o,total:n}}function D(r,e){let{page:t,limit:o,total:n}=r,s=Math.ceil(n/o)||1,a=t<s,i=t>1,p={page:t,limit:o,total:n,totalPages:s,hasNextPage:a,hasPreviousPage:i};return e&&(p.links=X(t,s,o,e)),p}function X(r,e,t,o){let n=new URL(o),s=i=>(n.searchParams.set("page",String(i)),n.searchParams.set("limit",String(t)),n.toString()),a={self:s(r),first:s(1),last:s(e)};return r<e&&(a.next=s(r+1)),r>1&&(a.previous=s(r-1)),a}function N(r,e){let t={limit:r.limit,hasMore:r.hasMore};return r.cursor&&(t.cursor=r.cursor),r.nextCursor&&(t.nextCursor=r.nextCursor),r.previousCursor&&(t.previousCursor=r.previousCursor),e&&(t.links=Z(r,e)),t}function Z(r,e){let t=new URL(e),o=s=>(s?t.searchParams.set("cursor",s):t.searchParams.delete("cursor"),t.searchParams.set("limit",String(r.limit)),t.toString()),n={self:o(r.cursor)};return r.nextCursor&&r.hasMore&&(n.next=o(r.nextCursor)),r.previousCursor&&(n.previous=o(r.previousCursor)),n}function oe(r){let e=[];return r.environment&&!["development","staging","production","test"].includes(r.environment)&&e.push(`Invalid environment: ${r.environment}`),r.pagination&&(r.pagination.defaultLimit!==void 0&&r.pagination.defaultLimit<1&&e.push("pagination.defaultLimit must be at least 1"),r.pagination.maxLimit!==void 0&&r.pagination.maxLimit<1&&e.push("pagination.maxLimit must be at least 1"),r.pagination.defaultLimit!==void 0&&r.pagination.maxLimit!==void 0&&r.pagination.defaultLimit>r.pagination.maxLimit&&e.push("pagination.defaultLimit cannot exceed pagination.maxLimit")),e}function se(r){return typeof r=="object"&&r!==null&&!Array.isArray(r)}function H(){let r=Date.now().toString(36),e;if(typeof globalThis.crypto<"u"&&globalThis.crypto.getRandomValues){let t=new Uint8Array(6);globalThis.crypto.getRandomValues(t),e=Array.from(t,o=>o.toString(16).padStart(2,"0")).join("");}else e=Math.random().toString(36).substring(2,10);return `${r}-${e}`}var x=class{config;statusCodeMapper;constructor(e={}){this.config=this.mergeConfig(e),this.statusCodeMapper=new P(this.config.customErrorMappers);}mergeConfig(e){return {...I,...e,pagination:{...I.pagination,...e.pagination},preResponseHooks:e.preResponseHooks||I.preResponseHooks,postResponseHooks:e.postResponseHooks||I.postResponseHooks,sensitiveFields:e.sensitiveFields||I.sensitiveFields}}getConfig(){return {...this.config}}updateConfig(e){this.config=this.mergeConfig({...this.config,...e}),e.customErrorMappers&&(this.statusCodeMapper=new P(e.customErrorMappers));}getTimestamp(){return this.config.includeTimestamp?new Date().toISOString():""}applyPreHooks(e,t){let o={data:e,meta:t};for(let n of this.config.preResponseHooks){let s=n(o.data,o.meta);o={data:s.data,meta:s.meta};}return o}applyPostHooks(e){let t=e;for(let o of this.config.postResponseHooks)t=o(t);return t}formatSuccess(e,t){let o=this.applyPreHooks(e,t),n={success:true,data:o.data,timestamp:this.getTimestamp()};return o.meta&&Object.keys(o.meta).length>0&&(n.meta=o.meta),this.config.passthroughMode&&this.config.customFormatter?this.config.customFormatter(n):this.applyPostHooks(n)}formatError(e,t){let o=this.config.includeStackTraces||this.config.environment==="development",s={success:false,error:j(e,{includeStack:o,maskSensitiveData:this.config.maskSensitiveData,sensitiveFields:this.config.sensitiveFields,customSerializers:this.config.customSerializers}),timestamp:this.getTimestamp()};return t&&Object.keys(t).length>0&&(s.meta=t),this.config.passthroughMode&&this.config.customFormatter?this.config.customFormatter(s):this.applyPostHooks(s)}formatPaginated(e,t,o,n){let s=this.applyPreHooks(e,o),a=A(t,this.config.pagination),i=D(a,this.config.pagination.includeLinks?n:void 0),p={success:true,data:s.data,pagination:i,timestamp:this.getTimestamp()};return s.meta&&Object.keys(s.meta).length>0&&(p.meta=s.meta),this.applyPostHooks(p)}formatCursorPaginated(e,t,o,n){let s=this.applyPreHooks(e,o),a=N(t,this.config.pagination.includeLinks?n:void 0),i={success:true,data:s.data,pagination:a,timestamp:this.getTimestamp()};return s.meta&&Object.keys(s.meta).length>0&&(i.meta=s.meta),this.applyPostHooks(i)}getErrorStatusCode(e){return this.statusCodeMapper.getStatusCode(e)}getSuccessStatusCode(e,t){return this.statusCodeMapper.getSuccessStatusCode(e,t)}getRequestId(e){return e||(this.config.generateRequestId?H():"")}};function ne(r){return new x(r)}q();var be={logErrors:true},_=class{formatter;options;config;constructor(e,t={}){this.formatter=e,this.options={...be,...t},this.config=e.getConfig();}extractMeta(e){let t={},o=e.get(this.config.requestIdHeader);o&&(t.requestId=o);let n=e.get(this.config.correlationIdHeader);return n&&(t.correlationId=n),t}logError(e,t){if(!this.options.logErrors)return;if(this.options.errorLogger){this.options.errorLogger(e,t);return}let n=(e instanceof E?e.isOperational:false)?"warn":"error";console[n]({message:e.message,name:e.name,stack:e.stack,path:t.path,method:t.method,timestamp:new Date().toISOString()});}isOperationalError(e){return e instanceof E?e.isOperational:false}handle(e,t,o,n){this.logError(e,t);let s=this.options.transformError?this.options.transformError(e):e;if(!this.isOperationalError(s)&&this.options.handleNonOperational){this.options.handleNonOperational(s,t,o);return}let a=this.formatter.getErrorStatusCode(s),i=this.extractMeta(t),p=this.formatter.formatError(s,i);o.status(a).json(p);}middleware(){return (e,t,o,n)=>{this.handle(e,t,o,n);}}};function ae(r,e){return new _(r,e)}function ie(r,e){return new _(r,e).middleware()}var y=class{config;constructor(e={}){this.config={defaultLimit:e.defaultLimit??10,maxLimit:e.maxLimit??100,includeLinks:e.includeLinks??false,baseUrl:e.baseUrl};}safeParseInt(e,t,o){if(typeof e!="string")return t;let n=parseInt(e,10);return !Number.isFinite(n)||Number.isNaN(n)?t:Math.min(o,Math.max(1,n))}extractFromRequest(e){let t=this.safeParseInt(e.query.page,1,1e6),o=Math.min(this.config.maxLimit,this.safeParseInt(e.query.limit,this.config.defaultLimit,this.config.maxLimit));return {page:t,limit:o}}validateCursor(e){if(!(typeof e!="string"||e.length===0)&&!(e.length>512)&&/^[a-zA-Z0-9+/=_-]+$/.test(e))return e}extractCursorFromRequest(e){let t=this.validateCursor(e.query.cursor),o=Math.min(this.config.maxLimit,this.safeParseInt(e.query.limit,this.config.defaultLimit,this.config.maxLimit));return {cursor:t,limit:o}}calculateOffset(e,t){return (e-1)*t}buildMeta(e,t){let o=A(e,this.config);return D(o,this.config.includeLinks?t||this.config.baseUrl:void 0)}buildCursorMeta(e,t){return N(e,this.config.includeLinks?t||this.config.baseUrl:void 0)}fromArray(e,t,o,n){let s=this.buildMeta({page:t,limit:o,total:n});return {data:e,pagination:s}}paginateArray(e,t,o){let n=e.length,s=this.calculateOffset(t,o),a=e.slice(s,s+o);return this.fromArray(a,t,o,n)}hasNextPage(e,t,o){let n=Math.ceil(o/t);return e<n}hasPreviousPage(e){return e>1}getTotalPages(e,t){return Math.ceil(e/t)||1}isValidPage(e,t,o){if(e<1)return  false;if(t===0)return e===1;let n=this.getTotalPages(t,o);return e<=n}getConfig(){return {...this.config}}updateConfig(e){this.config={...this.config,...e};}};function pe(r){return new y(r)}q();U();function z(r={}){let{skipPaths:e=[],skipCondition:t,...o}=r,n=new x(o),s=n.getConfig();return (a,i,p)=>{let c=a,u=i;if(e.includes(a.path)||t&&t(a)){p();return}let l=a.get(s.requestIdHeader);!l&&s.generateRequestId&&(l=H()),l&&(c.requestId=l,i.setHeader(s.requestIdHeader,l));let R=a.get(s.correlationIdHeader);R&&(c.correlationId=R,i.setHeader(s.correlationIdHeader,R)),u.formatter=n;let f=d=>{let g={};return l&&(g.requestId=l),R&&(g.correlationId=R),{...g,...d}},m=()=>{let d=a.protocol,g=a.get("host")||"localhost";return `${d}://${g}${a.originalUrl.split("?")[0]}`};u.respond=(d,g,C)=>{let h=n.formatSuccess(d,f(g)),he=C??n.getSuccessStatusCode(a.method,d!==void 0);i.status(he).json(h);},u.respondPaginated=(d,g,C)=>{let h=n.formatPaginated(d,g,f(C),m());i.status(200).json(h);},u.respondCursorPaginated=(d,g,C)=>{let h=n.formatCursorPaginated(d,g,f(C),m());i.status(200).json(h);},u.respondError=(d,g)=>{let C=n.formatError(d,f(g)),h=n.getErrorStatusCode(d);i.status(h).json(C);},p();}}function ue(r,e={}){let{skipPaths:t=[],skipCondition:o}=e,n=r.getConfig();return (s,a,i)=>{let p=s,c=a;if(t.includes(s.path)||o&&o(s)){i();return}let u=s.get(n.requestIdHeader);!u&&n.generateRequestId&&(u=H()),u&&(p.requestId=u,a.setHeader(n.requestIdHeader,u));let l=s.get(n.correlationIdHeader);l&&(p.correlationId=l,a.setHeader(n.correlationIdHeader,l)),c.formatter=r;let R=m=>{let d={};return u&&(d.requestId=u),l&&(d.correlationId=l),{...d,...m}},f=()=>{let m=s.protocol,d=s.get("host")||"localhost";return `${m}://${d}${s.originalUrl.split("?")[0]}`};c.respond=(m,d,g)=>{let C=r.formatSuccess(m,R(d)),h=g??r.getSuccessStatusCode(s.method,m!==void 0);a.status(h).json(C);},c.respondPaginated=(m,d,g)=>{let C=r.formatPaginated(m,d,R(g),f());a.status(200).json(C);},c.respondCursorPaginated=(m,d,g)=>{let C=r.formatCursorPaginated(m,d,R(g),f());a.status(200).json(C);},c.respondError=(m,d)=>{let g=r.formatError(m,R(d)),C=r.getErrorStatusCode(m);a.status(C).json(g);},i();}}function B(r={}){let{logErrors:e=true,errorLogger:t,transformError:o,customHandler:n,...s}=r,a=new x(s),i=a.getConfig();return (p,c,u,l)=>{if(n&&n(p,c,u))return;e&&(t?t(p,c):console.error({message:p.message,name:p.name,stack:p.stack,path:c.path,method:c.method,timestamp:new Date().toISOString()}));let R=o?o(p):p,f=c,m={};if(f.requestId)m.requestId=f.requestId;else {let C=c.get(i.requestIdHeader);C&&(m.requestId=C);}if(f.correlationId)m.correlationId=f.correlationId;else {let C=c.get(i.correlationIdHeader);C&&(m.correlationId=C);}let d=a.formatError(R,m),g=a.getErrorStatusCode(R);u.status(g).json(d);}}function ce(r,e={}){let{logErrors:t=true,errorLogger:o,transformError:n,customHandler:s}=e,a=r.getConfig();return (i,p,c,u)=>{if(s&&s(i,p,c))return;t&&(o?o(i,p):console.error({message:i.message,name:i.name,stack:i.stack,path:p.path,method:p.method,timestamp:new Date().toISOString()}));let l=n?n(i):i,R=p,f={};if(R.requestId)f.requestId=R.requestId;else {let g=p.get(a.requestIdHeader);g&&(f.requestId=g);}if(R.correlationId)f.correlationId=R.correlationId;else {let g=p.get(a.correlationIdHeader);g&&(f.correlationId=g);}let m=r.formatError(l,f),d=r.getErrorStatusCode(l);c.status(d).json(m);}}function de(r){return (e,t,o)=>{Promise.resolve(r(e,t,o)).catch(o);}}function le(r){return async(e,t,o)=>{try{await r(e,t);}catch(n){o(n);}}}function me(r){return (e={})=>(t,o,n)=>{let s=n.value;return n.value=async function(a,i,p){try{let c=await s.call(this,a,i,p);if(i.headersSent)return;if(e.raw){i.json(c);return}let u=a,l={...e.meta};u.requestId&&(l.requestId=u.requestId),u.correlationId&&(l.correlationId=u.correlationId);let R=r.formatSuccess(c,l),f=e.statusCode??r.getSuccessStatusCode(a.method,c!==void 0);i.status(f).json(R);}catch(c){if(p)p(c);else throw c}},n}}function ge(){return (r,e,t)=>{let o=t.value;return t.value=async function(n,s,a){try{await o.call(this,n,s,a);}catch(i){a(i);}},t}}function fe(r,e={}){return (t,o,n)=>{let s=n.value;return n.value=async function(a,i,p){try{let c=await s.call(this,a,i,p);if(i.headersSent)return;if(e.raw){i.json(c);return}let u=a,l={...e.meta};u.requestId&&(l.requestId=u.requestId),u.correlationId&&(l.correlationId=u.correlationId);let R=r.formatSuccess(c,l),f=e.statusCode??r.getSuccessStatusCode(a.method,c!==void 0);i.status(f).json(R);}catch(c){p(c);}},n}}function Re(r,e="body"){return (t,o,n)=>{let s=n.value;return n.value=async function(a,i,p){let c=a[e],u=r(c);if(!u.valid){let{ValidationError:l}=await Promise.resolve().then(()=>(U(),te));p(new l("Validation failed",u.errors));return}await s.call(this,a,i,p);},n}}function Ee(r,e={}){let t=new y({defaultLimit:e.defaultLimit??10,maxLimit:e.maxLimit??100,includeLinks:e.includeLinks??false});return (o,n,s)=>{let a=s.value;return s.value=async function(i,p,c){try{let{page:u,limit:l}=t.extractFromRequest(i);i.pagination={page:u,limit:l,offset:t.calculateOffset(u,l)};let R=await a.call(this,i,p,c);if(p.headersSent)return;let f=i,m={...e.meta};f.requestId&&(m.requestId=f.requestId),f.correlationId&&(m.correlationId=f.correlationId);let d=e.includeLinks?`${i.protocol}://${i.get("host")}${i.originalUrl.split("?")[0]}`:void 0,g=r.formatPaginated(R.data,{page:u,limit:l,total:R.total},Object.keys(m).length>0?m:void 0,d);p.status(200).json(g);}catch(u){c(u);}},s}}function Ce(r,e={}){let t=new y({defaultLimit:e.defaultLimit??10,maxLimit:e.maxLimit??100,includeLinks:e.includeLinks??false});return (o,n,s)=>{let a=s.value;return s.value=async function(i,p,c){try{let{cursor:u,limit:l}=t.extractCursorFromRequest(i);i.pagination={cursor:u,limit:l};let R=await a.call(this,i,p,c);if(p.headersSent)return;let f=i,m={...e.meta};f.requestId&&(m.requestId=f.requestId),f.correlationId&&(m.correlationId=f.correlationId);let d=e.includeLinks?`${i.protocol}://${i.get("host")}${i.originalUrl.split("?")[0]}`:void 0,g=r.formatCursorPaginated(R.data,{limit:l,cursor:u,nextCursor:R.nextCursor,previousCursor:R.previousCursor,hasMore:R.hasMore},Object.keys(m).length>0?m:void 0,d);p.status(200).json(g);}catch(u){c(u);}},s}}function ke(r){return r.success===true}function Me(r){return r.success===false}function Fe(r){return r.success===true&&"pagination"in r}var Se={VALIDATION_ERROR:"VALIDATION_ERROR",NOT_FOUND:"NOT_FOUND",UNAUTHORIZED:"UNAUTHORIZED",FORBIDDEN:"FORBIDDEN",CONFLICT:"CONFLICT",INTERNAL_ERROR:"INTERNAL_ERROR",BAD_REQUEST:"BAD_REQUEST",RATE_LIMIT_EXCEEDED:"RATE_LIMIT_EXCEEDED",SERVICE_UNAVAILABLE:"SERVICE_UNAVAILABLE",UNPROCESSABLE_ENTITY:"UNPROCESSABLE_ENTITY"};function ve(r={}){return {wrapper:z(r),errorHandler:B(r)}}var bt=ve;
+export{E as ApiError,fe as ApiRoute,O as BadRequestError,S as ConflictError,Ce as CursorPaginate,Se as ErrorCodes,_ as ErrorHandler,F as ForbiddenError,ge as HandleErrors,v as InternalServerError,k as NotFoundError,Ee as Paginate,y as PaginationHelper,T as RateLimitError,x as ResponseFormatter,w as ServiceUnavailableError,P as StatusCodeMapper,M as UnauthorizedError,L as UnprocessableEntityError,Re as Validate,b as ValidationError,de as asyncHandler,N as calculateCursorPaginationMeta,D as calculatePaginationMeta,le as catchErrors,$ as createError,ce as createErrorCatcher,ae as createErrorHandler,ee as createErrorSerializer,pe as createPaginationHelper,me as createResponseDecorator,ne as createResponseFormatter,ue as createResponseWrapper,re as createStatusCodeMapper,bt as default,I as defaultConfig,B as errorCatcher,ie as errorHandlerMiddleware,J as extractErrorContext,Y as extractFieldErrors,Z as generateCursorPaginationLinks,X as generatePaginationLinks,H as generateRequestId,Me as isErrorResponse,Fe as isPaginatedResponse,se as isPlainObject,ke as isSuccessResponse,ve as responseFormatter,z as responseWrapper,j as serializeError,oe as validateConfig,A as validatePaginationInput};