@plyaz/types 1.15.9 → 1.15.11

package/dist/errors/index.cjs

@@ -485,95 +485,95 @@ var ERROR_CODES = {
   DATABASE_ERROR: "error.database",
   // ===== Database Errors =====
   // Connection & Configuration
-  DB_ACCESS_DENIED: "DB_ACCESS_DENIED",
-  DB_CONFIG_REQUIRED: "DB_CONFIG_REQUIRED",
-  DB_CONNECT_FAILED: "DB_CONNECT_FAILED",
-  DB_DISCONNECT_FAILED: "DB_DISCONNECT_FAILED",
-  DB_INIT_FAILED: "DB_INIT_FAILED",
+  DB_ACCESS_DENIED: "db.access_denied",
+  DB_CONFIG_REQUIRED: "db.config_required",
+  DB_CONNECT_FAILED: "db.connect_failed",
+  DB_DISCONNECT_FAILED: "db.disconnect_failed",
+  DB_INIT_FAILED: "db.init_failed",
   // Query & Execution
-  DB_QUERY_FAILED: "DB_QUERY_FAILED",
-  DB_BUILD_WHERE_FAILED: "DB_BUILD_WHERE_FAILED",
-  DB_INVALID_SQL: "DB_INVALID_SQL",
-  DB_TRANSACTION_FAILED: "DB_TRANSACTION_FAILED",
-  DB_UNSUPPORTED_OPERATOR: "DB_UNSUPPORTED_OPERATOR",
+  DB_QUERY_FAILED: "db.query_failed",
+  DB_BUILD_WHERE_FAILED: "db.build_where_failed",
+  DB_INVALID_SQL: "db.invalid_sql",
+  DB_TRANSACTION_FAILED: "db.transaction_failed",
+  DB_UNSUPPORTED_OPERATOR: "db.unsupported_operator",
   // CRUD Operations
-  DB_CREATE_FAILED: "DB_CREATE_FAILED",
-  DB_CREATION_FAILED: "DB_CREATION_FAILED",
-  DB_FETCH_FAILED: "DB_FETCH_FAILED",
-  DB_FIND_FAILED: "DB_FIND_FAILED",
-  DB_FIND_MANY_FAILED: "DB_FIND_MANY_FAILED",
-  DB_FIND_BY_ID_FAILED: "DB_FIND_BY_ID_FAILED",
-  DB_UPDATE_FAILED: "DB_UPDATE_FAILED",
-  DB_UPDATE_NO_CHANGES: "DB_UPDATE_NO_CHANGES",
-  DB_DELETE_FAILED: "DB_DELETE_FAILED",
-  DB_INSERT_FAILED: "DB_INSERT_FAILED",
-  DB_RECORD_NOT_FOUND: "DB_RECORD_NOT_FOUND",
-  DB_EXISTS_FAILED: "DB_EXISTS_FAILED",
+  DB_CREATE_FAILED: "db.create_failed",
+  DB_CREATION_FAILED: "db.creation_failed",
+  DB_FETCH_FAILED: "db.fetch_failed",
+  DB_FIND_FAILED: "db.find_failed",
+  DB_FIND_MANY_FAILED: "db.find_many_failed",
+  DB_FIND_BY_ID_FAILED: "db.find_by_id_failed",
+  DB_UPDATE_FAILED: "db.update_failed",
+  DB_UPDATE_NO_CHANGES: "db.update_no_changes",
+  DB_DELETE_FAILED: "db.delete_failed",
+  DB_INSERT_FAILED: "db.insert_failed",
+  DB_RECORD_NOT_FOUND: "db.record_not_found",
+  DB_EXISTS_FAILED: "db.exists_failed",
   // Schema & Columns
-  DB_COLUMN_NOT_EXISTS: "DB_COLUMN_NOT_EXISTS",
-  DB_TABLE_NOT_REGISTERED: "DB_TABLE_NOT_REGISTERED",
-  DB_TABLE_REGISTRATION_FAILED: "DB_TABLE_REGISTRATION_FAILED",
-  DB_ID_COLUMN_NOT_REGISTERED: "DB_ID_COLUMN_NOT_REGISTERED",
-  DB_INVALID_COLUMN: "DB_INVALID_COLUMN",
-  DB_INVALID_TABLE_NAME: "DB_INVALID_TABLE_NAME",
-  DB_GET_ID_COLUMN_FAILED: "DB_GET_ID_COLUMN_FAILED",
-  DB_GET_TABLE_FAILED: "DB_GET_TABLE_FAILED",
+  DB_COLUMN_NOT_EXISTS: "db.column_not_exists",
+  DB_TABLE_NOT_REGISTERED: "db.table_not_registered",
+  DB_TABLE_REGISTRATION_FAILED: "db.table_registration_failed",
+  DB_ID_COLUMN_NOT_REGISTERED: "db.id_column_not_registered",
+  DB_INVALID_COLUMN: "db.invalid_column",
+  DB_INVALID_TABLE_NAME: "db.invalid_table_name",
+  DB_GET_ID_COLUMN_FAILED: "db.get_id_column_failed",
+  DB_GET_TABLE_FAILED: "db.get_table_failed",
   // Validation & Parameters
-  DB_INVALID_PARAMETERS: "DB_INVALID_PARAMETERS",
-  DB_INVALID_PARAMS: "DB_INVALID_PARAMS",
-  DB_INVALID_FILTER: "DB_INVALID_FILTER",
-  DB_INVALID_ID: "DB_INVALID_ID",
-  DB_INVALID_ENTITY: "DB_INVALID_ENTITY",
-  DB_INVALID_UPDATE_PARAMS: "DB_INVALID_UPDATE_PARAMS",
-  DB_INVALID_FIELD_NAME: "DB_INVALID_FIELD_NAME",
-  DB_INVALID_RESULT: "DB_INVALID_RESULT",
-  DB_NO_UPDATE_FIELDS: "DB_NO_UPDATE_FIELDS",
+  DB_INVALID_PARAMETERS: "db.invalid_parameters",
+  DB_INVALID_PARAMS: "db.invalid_params",
+  DB_INVALID_FILTER: "db.invalid_filter",
+  DB_INVALID_ID: "db.invalid_id",
+  DB_INVALID_ENTITY: "db.invalid_entity",
+  DB_INVALID_UPDATE_PARAMS: "db.invalid_update_params",
+  DB_INVALID_FIELD_NAME: "db.invalid_field_name",
+  DB_INVALID_RESULT: "db.invalid_result",
+  DB_NO_UPDATE_FIELDS: "db.no_update_fields",
   // Count & Data
-  DB_COUNT_FAILED: "DB_COUNT_FAILED",
-  DB_COUNT_NO_RESULTS: "DB_COUNT_NO_RESULTS",
-  DB_NO_DATA: "DB_NO_DATA",
+  DB_COUNT_FAILED: "db.count_failed",
+  DB_COUNT_NO_RESULTS: "db.count_no_results",
+  DB_NO_DATA: "db.no_data",
   // Multi-tenant Context
-  DB_NO_TENANT_CONTEXT: "DB_NO_TENANT_CONTEXT",
-  DB_NO_TENANT_ID: "DB_NO_TENANT_ID",
-  DB_TENANT_VALIDATION_FAILED: "DB_TENANT_VALIDATION_FAILED",
+  DB_NO_TENANT_CONTEXT: "db.no_tenant_context",
+  DB_NO_TENANT_ID: "db.no_tenant_id",
+  DB_TENANT_VALIDATION_FAILED: "db.tenant_validation_failed",
   // Backup & Restore
-  DB_BACKUP_CLEANUP_FAILED: "DB_BACKUP_CLEANUP_FAILED",
-  DB_BACKUP_FILE_NOT_FOUND: "DB_BACKUP_FILE_NOT_FOUND",
-  DB_LIST_BACKUPS_FAILED: "DB_LIST_BACKUPS_FAILED",
-  DB_INVALID_BACKUP_INFO: "DB_INVALID_BACKUP_INFO",
-  DB_RESTORE_FAILED: "DB_RESTORE_FAILED",
+  DB_BACKUP_CLEANUP_FAILED: "db.backup_cleanup_failed",
+  DB_BACKUP_FILE_NOT_FOUND: "db.backup_file_not_found",
+  DB_LIST_BACKUPS_FAILED: "db.list_backups_failed",
+  DB_INVALID_BACKUP_INFO: "db.invalid_backup_info",
+  DB_RESTORE_FAILED: "db.restore_failed",
   // Cache Operations
-  DB_CACHE_DELETE_FAILED: "DB_CACHE_DELETE_FAILED",
-  DB_CACHE_HEALTH_CHECK_FAILED: "DB_CACHE_HEALTH_CHECK_FAILED",
-  DB_CACHE_INVALIDATE_FAILED: "DB_CACHE_INVALIDATE_FAILED",
-  DB_CACHE_SET_FAILED: "DB_CACHE_SET_FAILED",
-  DB_CACHE_GET_FAILED: "DB_CACHE_GET_FAILED",
+  DB_CACHE_DELETE_FAILED: "db.cache_delete_failed",
+  DB_CACHE_HEALTH_CHECK_FAILED: "db.cache_health_check_failed",
+  DB_CACHE_INVALIDATE_FAILED: "db.cache_invalidate_failed",
+  DB_CACHE_SET_FAILED: "db.cache_set_failed",
+  DB_CACHE_GET_FAILED: "db.cache_get_failed",
   // File & Storage
-  DB_INVALID_FILEPATH: "DB_INVALID_FILEPATH",
-  DB_S3_DELETE_FAILED: "DB_S3_DELETE_FAILED",
-  DB_S3_DOWNLOAD_FAILED: "DB_S3_DOWNLOAD_FAILED",
-  DB_S3_NOT_CONFIGURED: "DB_S3_NOT_CONFIGURED",
-  DB_S3_UPLOAD_FAILED: "DB_S3_UPLOAD_FAILED",
+  DB_INVALID_FILEPATH: "db.invalid_filepath",
+  DB_S3_DELETE_FAILED: "db.s3_delete_failed",
+  DB_S3_DOWNLOAD_FAILED: "db.s3_download_failed",
+  DB_S3_NOT_CONFIGURED: "db.s3_not_configured",
+  DB_S3_UPLOAD_FAILED: "db.s3_upload_failed",
   // Misc
-  DB_SCHEDULE_SETUP_FAILED: "DB_SCHEDULE_SETUP_FAILED",
-  DB_DECRYPTION_FAILED: "DB_DECRYPTION_FAILED",
-  DB_INVALID_SHELL_ARG: "DB_INVALID_SHELL_ARG",
-  DB_INVALID_BETWEEN_OPERATOR: "DB_INVALID_BETWEEN_OPERATOR",
-  DB_INVALID_IN_OPERATOR: "DB_INVALID_IN_OPERATOR",
-  DB_INVALID_COUNT: "DB_INVALID_COUNT",
+  DB_SCHEDULE_SETUP_FAILED: "db.schedule_setup_failed",
+  DB_DECRYPTION_FAILED: "db.decryption_failed",
+  DB_INVALID_SHELL_ARG: "db.invalid_shell_arg",
+  DB_INVALID_BETWEEN_OPERATOR: "db.invalid_between_operator",
+  DB_INVALID_IN_OPERATOR: "db.invalid_in_operator",
+  DB_INVALID_COUNT: "db.invalid_count",
   // Connection & Network
-  DB_CONNECTION_FAILED: "DB_CONNECTION_FAILED",
-  DB_TIMEOUT: "DB_TIMEOUT",
+  DB_CONNECTION_FAILED: "db.connection_failed",
+  DB_TIMEOUT: "db.timeout",
   // Constraints & Integrity
-  DB_CONSTRAINT_VIOLATION: "DB_CONSTRAINT_VIOLATION",
-  DB_DEADLOCK: "DB_DEADLOCK",
-  DB_DUPLICATE_ENTRY: "DB_DUPLICATE_ENTRY",
+  DB_CONSTRAINT_VIOLATION: "db.constraint_violation",
+  DB_DEADLOCK: "db.deadlock",
+  DB_DUPLICATE_ENTRY: "db.duplicate_entry",
   // Entity Operations
-  DB_ENTITY_NOT_FOUND: "DB_ENTITY_NOT_FOUND",
+  DB_ENTITY_NOT_FOUND: "db.entity_not_found",
   // Migration & Schema
-  DB_MIGRATION_FAILED: "DB_MIGRATION_FAILED",
+  DB_MIGRATION_FAILED: "db.migration_failed",
   // General
-  DB_UNKNOWN_ERROR: "DB_UNKNOWN_ERROR",
+  DB_UNKNOWN_ERROR: "db.unknown_error",
   // ===== Payments Package Errors =====
   PAYMENT_TIMEOUT: "payment.timeout",
   PAYMENT_NETWORK_ERROR: "payment.network.error",
@@ -594,6 +594,20 @@ var ERROR_CODES = {
   PAYMENT_PROVIDER_RESPONSE_INVALID: "payment.provider.response.invalid",
   PAYMENT_PROVIDER_TIMEOUT: "payment.provider.timeout",
   PAYMENT_PROVIDER_AUTH_FAILED: "payment.provider.auth.failed",
+  PAYMENT_PROVIDER_RATE_LIMIT: "payment.provider.rate.limit",
+  // for HTTP 429
+  PAYMENT_PROVIDER_UNKNOWN: "payment.provider.unknown",
+  PAYMENT_CUSTOMER_CREATION_FAILED: "payment.customer.creation.failed",
+  // Payment method errors
+  PAYMENT_METHOD_SAVE_FAILED: "payment.method.save.failed",
+  PAYMENT_METHOD_DELETE_FAILED: "payment.method.delete.failed",
+  // Subscription errors
+  PAYMENT_SUBSCRIPTION_CREATE_FAILED: "payment.subscription.create.failed",
+  PAYMENT_SUBSCRIPTION_CANCEL_FAILED: "payment.subscription.cancel.failed",
+  // Payout errors
+  PAYMENT_PAYOUT_FAILED: "payment.payout.failed",
+  // Transaction history errors
+  PAYMENT_TRANSACTION_HISTORY_FETCH_FAILED: "payment.transaction.history.fetch.failed",
   // Compliance
   PAYMENT_COMPLIANCE_VIOLATION: "payment.compliance.violation",
   PAYMENT_COMPLIANCE_CHECK_FAILED: "payment.compliance.check.failed",
@@ -775,92 +789,103 @@ var NOTIFICATION_ERROR_CODES = {
   INITIALIZATION_FAILED: ERROR_CODES.NOTIFICATION_INITIALIZATION_FAILED
 };
 var PAYMENT_ERROR_CODES = {
-  PAYMENT_TIMEOUT: "payment.timeout",
-  PAYMENT_NETWORK_ERROR: "payment.network.error",
+  // Timeout & Network
+  PAYMENT_TIMEOUT: ERROR_CODES.PAYMENT_TIMEOUT,
+  PAYMENT_NETWORK_ERROR: ERROR_CODES.PAYMENT_NETWORK_ERROR,
   // Refund
-  PAYMENT_REFUND_FAILED: "payment.refund.failed",
-  PAYMENT_REFUND_NOT_FOUND: "payment.refund.not.found",
-  PAYMENT_REFUND_ALREADY_PROCESSED: "payment.refund.already.processed",
-  PAYMENT_REFUND_AMOUNT_INVALID: "payment.refund.amount.invalid",
-  PAYMENT_REFUND_VALIDATION_FAILED: "payment.refund.validation.failed",
-  PAYMENT_REFUND_TIMEOUT: "payment.refund.timeout",
-  PAYMENT_REFUND_NOT_ALLOWED: "payment.refund.not.allowed",
-  PAYMENT_REFUND_AUTHORIZATION_FAILED: "payment.refund.authorization.failed",
-  PAYMENT_REFUND_PROCESSING_FAILED: "payment.refund.processing.failed",
+  PAYMENT_REFUND_FAILED: ERROR_CODES.PAYMENT_REFUND_FAILED,
+  PAYMENT_REFUND_NOT_FOUND: ERROR_CODES.PAYMENT_REFUND_NOT_FOUND,
+  PAYMENT_REFUND_ALREADY_PROCESSED: ERROR_CODES.PAYMENT_REFUND_ALREADY_PROCESSED,
+  PAYMENT_REFUND_AMOUNT_INVALID: ERROR_CODES.PAYMENT_REFUND_AMOUNT_INVALID,
+  PAYMENT_REFUND_VALIDATION_FAILED: ERROR_CODES.PAYMENT_REFUND_VALIDATION_FAILED,
+  PAYMENT_REFUND_TIMEOUT: ERROR_CODES.PAYMENT_REFUND_TIMEOUT,
+  PAYMENT_REFUND_NOT_ALLOWED: ERROR_CODES.PAYMENT_REFUND_NOT_ALLOWED,
+  PAYMENT_REFUND_AUTHORIZATION_FAILED: ERROR_CODES.PAYMENT_REFUND_AUTHORIZATION_FAILED,
+  PAYMENT_REFUND_PROCESSING_FAILED: ERROR_CODES.PAYMENT_REFUND_PROCESSING_FAILED,
   // Provider
-  PAYMENT_PROVIDER_ERROR: "payment.provider.error",
-  PAYMENT_PROVIDER_UNAVAILABLE: "payment.provider.unavailable",
-  PAYMENT_PROVIDER_CONFIGURATION_INVALID: "payment.provider.configuration.invalid",
-  PAYMENT_PROVIDER_RESPONSE_INVALID: "payment.provider.response.invalid",
-  PAYMENT_PROVIDER_TIMEOUT: "payment.provider.timeout",
-  PAYMENT_PROVIDER_AUTH_FAILED: "payment.provider.auth.failed",
+  PAYMENT_PROVIDER_ERROR: ERROR_CODES.PAYMENT_PROVIDER_ERROR,
+  PAYMENT_PROVIDER_UNAVAILABLE: ERROR_CODES.PAYMENT_PROVIDER_UNAVAILABLE,
+  PAYMENT_PROVIDER_CONFIGURATION_INVALID: ERROR_CODES.PAYMENT_PROVIDER_CONFIGURATION_INVALID,
+  PAYMENT_PROVIDER_RESPONSE_INVALID: ERROR_CODES.PAYMENT_PROVIDER_RESPONSE_INVALID,
+  PAYMENT_PROVIDER_TIMEOUT: ERROR_CODES.PAYMENT_PROVIDER_TIMEOUT,
+  PAYMENT_PROVIDER_AUTH_FAILED: ERROR_CODES.PAYMENT_PROVIDER_AUTH_FAILED,
+  PAYMENT_PROVIDER_RATE_LIMIT: ERROR_CODES.PAYMENT_PROVIDER_RATE_LIMIT,
+  PAYMENT_PROVIDER_UNKNOWN: ERROR_CODES.PAYMENT_PROVIDER_UNKNOWN,
+  PAYMENT_CUSTOMER_CREATION_FAILED: ERROR_CODES.PAYMENT_CUSTOMER_CREATION_FAILED,
+  // Payment method
+  PAYMENT_METHOD_SAVE_FAILED: ERROR_CODES.PAYMENT_METHOD_SAVE_FAILED,
+  PAYMENT_METHOD_DELETE_FAILED: ERROR_CODES.PAYMENT_METHOD_DELETE_FAILED,
+  // Subscription
+  PAYMENT_SUBSCRIPTION_CREATE_FAILED: ERROR_CODES.PAYMENT_SUBSCRIPTION_CREATE_FAILED,
+  PAYMENT_SUBSCRIPTION_CANCEL_FAILED: ERROR_CODES.PAYMENT_SUBSCRIPTION_CANCEL_FAILED,
+  // Payout
+  PAYMENT_PAYOUT_FAILED: ERROR_CODES.PAYMENT_PAYOUT_FAILED,
+  // Transaction history
+  PAYMENT_TRANSACTION_HISTORY_FETCH_FAILED: ERROR_CODES.PAYMENT_TRANSACTION_HISTORY_FETCH_FAILED,
   // Compliance
-  PAYMENT_COMPLIANCE_VIOLATION: "payment.compliance.violation",
-  PAYMENT_COMPLIANCE_CHECK_FAILED: "payment.compliance.check.failed",
-  PAYMENT_COMPLIANCE_LIMIT_EXCEEDED: "payment.compliance.limit.exceeded",
-  PAYMENT_COMPLIANCE_POLICY_MISSING: "payment.compliance.policy.missing",
-  PAYMENT_COMPLIANCE_KYC_REQUIRED: "payment.compliance.kyc.required",
-  PAYMENT_COMPLIANCE_GEOGRAPHIC_RESTRICTION: "payment.compliance.geographic.restriction",
+  PAYMENT_COMPLIANCE_VIOLATION: ERROR_CODES.PAYMENT_COMPLIANCE_VIOLATION,
+  PAYMENT_COMPLIANCE_CHECK_FAILED: ERROR_CODES.PAYMENT_COMPLIANCE_CHECK_FAILED,
+  PAYMENT_COMPLIANCE_LIMIT_EXCEEDED: ERROR_CODES.PAYMENT_COMPLIANCE_LIMIT_EXCEEDED,
+  PAYMENT_COMPLIANCE_POLICY_MISSING: ERROR_CODES.PAYMENT_COMPLIANCE_POLICY_MISSING,
+  PAYMENT_COMPLIANCE_KYC_REQUIRED: ERROR_CODES.PAYMENT_COMPLIANCE_KYC_REQUIRED,
+  PAYMENT_COMPLIANCE_GEOGRAPHIC_RESTRICTION: ERROR_CODES.PAYMENT_COMPLIANCE_GEOGRAPHIC_RESTRICTION,
   // Processing
-  PAYMENT_PROCESSING_FAILED: "payment.processing.failed",
-  PAYMENT_PROCESSING_TIMEOUT: "payment.processing.timeout",
-  PAYMENT_PROCESSING_GATEWAY_ERROR: "payment.processing.gateway.error",
-  PAYMENT_PROCESSING_DUPLICATE: "payment.processing.duplicate",
-  PAYMENT_PROCESSING_UNEXPECTED_STATE: "payment.processing.unexpected.state",
+  PAYMENT_PROCESSING_FAILED: ERROR_CODES.PAYMENT_PROCESSING_FAILED,
+  PAYMENT_PROCESSING_TIMEOUT: ERROR_CODES.PAYMENT_PROCESSING_TIMEOUT,
+  PAYMENT_PROCESSING_GATEWAY_ERROR: ERROR_CODES.PAYMENT_PROCESSING_GATEWAY_ERROR,
+  PAYMENT_PROCESSING_DUPLICATE: ERROR_CODES.PAYMENT_PROCESSING_DUPLICATE,
+  PAYMENT_PROCESSING_UNEXPECTED_STATE: ERROR_CODES.PAYMENT_PROCESSING_UNEXPECTED_STATE,
   // Security
-  PAYMENT_SECURITY_VIOLATION: "payment.security.violation",
-  PAYMENT_SECURITY_SIGNATURE_INVALID: "payment.security.signature.invalid",
-  PAYMENT_SECURITY_ENCRYPTION_FAILED: "payment.security.encryption.failed",
-  PAYMENT_SECURITY_FRAUD_DETECTED: "payment.security.fraud.detected",
-  PAYMENT_SECURITY_TOKEN_INVALID: "payment.security.token.invalid",
-  PAYMENT_SECURITY_VELOCITY_LIMIT_EXCEEDED: "payment.security.velocity.limit.exceeded",
+  PAYMENT_SECURITY_VIOLATION: ERROR_CODES.PAYMENT_SECURITY_VIOLATION,
+  PAYMENT_SECURITY_SIGNATURE_INVALID: ERROR_CODES.PAYMENT_SECURITY_SIGNATURE_INVALID,
+  PAYMENT_SECURITY_ENCRYPTION_FAILED: ERROR_CODES.PAYMENT_SECURITY_ENCRYPTION_FAILED,
+  PAYMENT_SECURITY_FRAUD_DETECTED: ERROR_CODES.PAYMENT_SECURITY_FRAUD_DETECTED,
+  PAYMENT_SECURITY_TOKEN_INVALID: ERROR_CODES.PAYMENT_SECURITY_TOKEN_INVALID,
+  PAYMENT_SECURITY_VELOCITY_LIMIT_EXCEEDED: ERROR_CODES.PAYMENT_SECURITY_VELOCITY_LIMIT_EXCEEDED,
   // Validation
-  PAYMENT_VALIDATION_FAILED: "payment.validation.failed",
-  PAYMENT_VALIDATION_AMOUNT_INVALID: "payment.validation.amount.invalid",
-  PAYMENT_VALIDATION_CURRENCY_UNSUPPORTED: "payment.validation.currency.unsupported",
-  PAYMENT_VALIDATION_METADATA_INVALID: "payment.validation.metadata.invalid",
-  PAYMENT_VALIDATION_MISSING_REQUIRED_FIELD: "payment.validation.field.required",
+  PAYMENT_VALIDATION_FAILED: ERROR_CODES.PAYMENT_VALIDATION_FAILED,
+  PAYMENT_VALIDATION_AMOUNT_INVALID: ERROR_CODES.PAYMENT_VALIDATION_AMOUNT_INVALID,
+  PAYMENT_VALIDATION_CURRENCY_UNSUPPORTED: ERROR_CODES.PAYMENT_VALIDATION_CURRENCY_UNSUPPORTED,
+  PAYMENT_VALIDATION_METADATA_INVALID: ERROR_CODES.PAYMENT_VALIDATION_METADATA_INVALID,
+  PAYMENT_VALIDATION_MISSING_REQUIRED_FIELD: ERROR_CODES.PAYMENT_VALIDATION_MISSING_REQUIRED_FIELD,
   // Webhook
-  PAYMENT_WEBHOOK_SIGNATURE_INVALID: "payment.webhook.signature.invalid",
-  PAYMENT_WEBHOOK_PROCESSING_FAILED: "payment.webhook.processing.failed",
-  PAYMENT_WEBHOOK_VALIDATION_FAILED: "payment.webhook.validation.failed",
-  PAYMENT_WEBHOOK_EVENT_TYPE_UNSUPPORTED: "payment.webhook.event.type.unsupported",
-  PAYMENT_WEBHOOK_HANDLER_NOT_FOUND: "payment.webhook.handler.not.found",
-  // ===== Payment Adapter & Core Errors =====
-  PAYMENT_ADAPTER_INIT_FAILED: "payment.adapter.init.failed",
-  PAYMENT_ADAPTER_SHUTDOWN_ERROR: "payment.adapter.shutdown.error",
-  PAYMENT_ADAPTER_HMAC_COMPUTATION_FAILED: "payment.adapter.hmac.computation.failed",
-  PAYMENT_ADAPTER_MISSING_PROVIDER: "payment.adapter.missing.provider",
-  PAYMENT_ADAPTER_MISSING_ENVIRONMENT: "payment.adapter.missing.environment",
-  PAYMENT_ADAPTER_MISSING_CREDENTIALS: "payment.adapter.missing.credentials",
-  PAYMENT_ADAPTER_MISSING_WEBHOOK_URL: "payment.adapter.missing.webhook.url",
-  PAYMENT_ADAPTER_MISSING_UNREGISTER_ENDPOINT: "payment.adapter.missing.unregister.endpoint",
-  PAYMENT_ADAPTER_UNSUPPORTED_OPERATION: "payment.adapter.unsupported.operation",
-  PAYMENT_ADAPTER_RESPONSE_MAPPING_FAILED: "payment.adapter.response.mapping.failed",
-  // Idempotency & State Management
-  PAYMENT_IDEMPOTENCY_VIOLATION: "payment.idempotency.violation",
-  PAYMENT_IDEMPOTENCY_KEY_MISSING: "payment.idempotency.key.missing",
-  PAYMENT_IDEMPOTENCY_STORE_ERROR: "payment.idempotency.store.error",
-  // Routing & Strategy
-  PAYMENT_ROUTING_FAILED: "payment.routing.failed",
-  PAYMENT_ROUTING_CONFIGURATION_INVALID: "payment.routing.configuration.invalid",
-  PAYMENT_ROUTING_PROVIDER_UNAVAILABLE: "payment.routing.provider.unavailable",
-  PAYMENT_ROUTING_RETRY_EXCEEDED: "payment.routing.retry.exceeded",
-  // General Payment Framework Errors
-  PAYMENT_SYSTEM_NOT_INITIALIZED: "payment.system.not.initialized",
-  PAYMENT_CONTEXT_OPERATION_FAILED: "payment.context.operation.failed",
-  PAYMENT_INTERNAL_ERROR: "payment.internal.error",
-  PAYMENT_UNKNOWN_ERROR: "payment.unknown.error",
-  /**
-   * Thrown when an event could not be emitted due to internal state or creation errors.
-   * Typically non-retryable, indicates a logic or validation fault.
-   */
-  PAYMENT_EVENT_EMIT_FAILED: "PAYMENT_EVENT_EMIT_FAILED",
-  PAYMENT_EVENT_INVALID_TYPE: "PAYMENT_EVENT_INVALID_TYPE",
-  PAYMENT_EVENT_CREATION_FAILED: "PAYMENT_EVENT_CREATION_FAILED",
-  PAYMENT_EVENT_HANDLER_TIMEOUT: "PAYMENT_EVENT_HANDLER_TIMEOUT",
-  PAYMENT_EVENT_HANDLER_INVALID_RESULT: "PAYMENT_EVENT_HANDLER_INVALID_RESULT",
-  PAYMENT_EVENT_LIFECYCLE_FAILURE: "PAYMENT_EVENT_LIFECYCLE_FAILURE"
+  PAYMENT_WEBHOOK_SIGNATURE_INVALID: ERROR_CODES.PAYMENT_WEBHOOK_SIGNATURE_INVALID,
+  PAYMENT_WEBHOOK_PROCESSING_FAILED: ERROR_CODES.PAYMENT_WEBHOOK_PROCESSING_FAILED,
+  PAYMENT_WEBHOOK_VALIDATION_FAILED: ERROR_CODES.PAYMENT_WEBHOOK_VALIDATION_FAILED,
+  PAYMENT_WEBHOOK_EVENT_TYPE_UNSUPPORTED: ERROR_CODES.PAYMENT_WEBHOOK_EVENT_TYPE_UNSUPPORTED,
+  PAYMENT_WEBHOOK_HANDLER_NOT_FOUND: ERROR_CODES.PAYMENT_WEBHOOK_HANDLER_NOT_FOUND,
+  // Adapter & Core
+  PAYMENT_ADAPTER_INIT_FAILED: ERROR_CODES.PAYMENT_ADAPTER_INIT_FAILED,
+  PAYMENT_ADAPTER_SHUTDOWN_ERROR: ERROR_CODES.PAYMENT_ADAPTER_SHUTDOWN_ERROR,
+  PAYMENT_ADAPTER_HMAC_COMPUTATION_FAILED: ERROR_CODES.PAYMENT_ADAPTER_HMAC_COMPUTATION_FAILED,
+  PAYMENT_ADAPTER_MISSING_PROVIDER: ERROR_CODES.PAYMENT_ADAPTER_MISSING_PROVIDER,
+  PAYMENT_ADAPTER_MISSING_ENVIRONMENT: ERROR_CODES.PAYMENT_ADAPTER_MISSING_ENVIRONMENT,
+  PAYMENT_ADAPTER_MISSING_CREDENTIALS: ERROR_CODES.PAYMENT_ADAPTER_MISSING_CREDENTIALS,
+  PAYMENT_ADAPTER_MISSING_WEBHOOK_URL: ERROR_CODES.PAYMENT_ADAPTER_MISSING_WEBHOOK_URL,
+  PAYMENT_ADAPTER_MISSING_UNREGISTER_ENDPOINT: ERROR_CODES.PAYMENT_ADAPTER_MISSING_UNREGISTER_ENDPOINT,
+  PAYMENT_ADAPTER_UNSUPPORTED_OPERATION: ERROR_CODES.PAYMENT_ADAPTER_UNSUPPORTED_OPERATION,
+  PAYMENT_ADAPTER_RESPONSE_MAPPING_FAILED: ERROR_CODES.PAYMENT_ADAPTER_RESPONSE_MAPPING_FAILED,
+  // Idempotency
+  PAYMENT_IDEMPOTENCY_VIOLATION: ERROR_CODES.PAYMENT_IDEMPOTENCY_VIOLATION,
+  PAYMENT_IDEMPOTENCY_KEY_MISSING: ERROR_CODES.PAYMENT_IDEMPOTENCY_KEY_MISSING,
+  PAYMENT_IDEMPOTENCY_STORE_ERROR: ERROR_CODES.PAYMENT_IDEMPOTENCY_STORE_ERROR,
+  // Routing
+  PAYMENT_ROUTING_FAILED: ERROR_CODES.PAYMENT_ROUTING_FAILED,
+  PAYMENT_ROUTING_CONFIGURATION_INVALID: ERROR_CODES.PAYMENT_ROUTING_CONFIGURATION_INVALID,
+  PAYMENT_ROUTING_PROVIDER_UNAVAILABLE: ERROR_CODES.PAYMENT_ROUTING_PROVIDER_UNAVAILABLE,
+  PAYMENT_ROUTING_RETRY_EXCEEDED: ERROR_CODES.PAYMENT_ROUTING_RETRY_EXCEEDED,
+  // General
+  PAYMENT_SYSTEM_NOT_INITIALIZED: ERROR_CODES.PAYMENT_SYSTEM_NOT_INITIALIZED,
+  PAYMENT_CONTEXT_OPERATION_FAILED: ERROR_CODES.PAYMENT_CONTEXT_OPERATION_FAILED,
+  PAYMENT_INTERNAL_ERROR: ERROR_CODES.PAYMENT_INTERNAL_ERROR,
+  PAYMENT_UNKNOWN_ERROR: ERROR_CODES.PAYMENT_UNKNOWN_ERROR,
+  // Event
+  PAYMENT_EVENT_EMIT_FAILED: ERROR_CODES.PAYMENT_EVENT_EMIT_FAILED,
+  PAYMENT_EVENT_INVALID_TYPE: ERROR_CODES.PAYMENT_EVENT_INVALID_TYPE,
+  PAYMENT_EVENT_CREATION_FAILED: ERROR_CODES.PAYMENT_EVENT_CREATION_FAILED,
+  PAYMENT_EVENT_HANDLER_TIMEOUT: ERROR_CODES.PAYMENT_EVENT_HANDLER_TIMEOUT,
+  PAYMENT_EVENT_HANDLER_INVALID_RESULT: ERROR_CODES.PAYMENT_EVENT_HANDLER_INVALID_RESULT,
+  PAYMENT_EVENT_LIFECYCLE_FAILURE: ERROR_CODES.PAYMENT_EVENT_LIFECYCLE_FAILURE
 };
 var DATABASE_ERROR_CODES = {
   ACCESS_DENIED: ERROR_CODES.DB_ACCESS_DENIED,
@@ -3050,6 +3075,78 @@ var ERROR_DEFINITIONS = {
     userMessage: "errors.payment.processing.unexpected_state",
     severity: ERROR_SEVERITY.Critical,
     retryable: false
+  },
+  [ERROR_CODES.PAYMENT_PROVIDER_RATE_LIMIT]: {
+    code: ERROR_CODES.PAYMENT_PROVIDER_RATE_LIMIT,
+    status: HTTP_STATUS.TOO_MANY_REQUESTS,
+    category: ERROR_CATEGORY.RateLimit,
+    userMessage: "errors.payment.provider.rate_limit",
+    severity: ERROR_SEVERITY.High,
+    retryable: true
+  },
+  [ERROR_CODES.PAYMENT_PROVIDER_UNKNOWN]: {
+    code: ERROR_CODES.PAYMENT_PROVIDER_UNKNOWN,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Provider,
+    userMessage: "errors.payment.provider.unknown",
+    severity: ERROR_SEVERITY.Critical,
+    retryable: true
+  },
+  [ERROR_CODES.PAYMENT_CUSTOMER_CREATION_FAILED]: {
+    code: ERROR_CODES.PAYMENT_CUSTOMER_CREATION_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Processing,
+    userMessage: "errors.payment.customer.creation_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: true
+  },
+  [ERROR_CODES.PAYMENT_METHOD_SAVE_FAILED]: {
+    code: ERROR_CODES.PAYMENT_METHOD_SAVE_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Processing,
+    userMessage: "errors.payment.method.save_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: true
+  },
+  [ERROR_CODES.PAYMENT_METHOD_DELETE_FAILED]: {
+    code: ERROR_CODES.PAYMENT_METHOD_DELETE_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Processing,
+    userMessage: "errors.payment.method.delete_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: true
+  },
+  [ERROR_CODES.PAYMENT_SUBSCRIPTION_CREATE_FAILED]: {
+    code: ERROR_CODES.PAYMENT_SUBSCRIPTION_CREATE_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Processing,
+    userMessage: "errors.payment.subscription.create_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: true
+  },
+  [ERROR_CODES.PAYMENT_SUBSCRIPTION_CANCEL_FAILED]: {
+    code: ERROR_CODES.PAYMENT_SUBSCRIPTION_CANCEL_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Processing,
+    userMessage: "errors.payment.subscription.cancel_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: true
+  },
+  [ERROR_CODES.PAYMENT_PAYOUT_FAILED]: {
+    code: ERROR_CODES.PAYMENT_PAYOUT_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Processing,
+    userMessage: "errors.payment.payout.failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: true
+  },
+  [ERROR_CODES.PAYMENT_TRANSACTION_HISTORY_FETCH_FAILED]: {
+    code: ERROR_CODES.PAYMENT_TRANSACTION_HISTORY_FETCH_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Processing,
+    userMessage: "errors.payment.transaction.history.fetch_failed",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: true
   }
 };