@plyaz/types 1.15.4 → 1.15.6

package/dist/errors/codes.d.ts

@@ -193,6 +193,8 @@ export declare const ERROR_CODES: {
     readonly DB_ENTITY_NOT_FOUND: "DB_ENTITY_NOT_FOUND";
     readonly DB_MIGRATION_FAILED: "DB_MIGRATION_FAILED";
     readonly DB_UNKNOWN_ERROR: "DB_UNKNOWN_ERROR";
+    readonly PAYMENT_TIMEOUT: "payment.timeout";
+    readonly PAYMENT_NETWORK_ERROR: "payment.network.error";
     readonly PAYMENT_REFUND_FAILED: "payment.refund.failed";
     readonly PAYMENT_REFUND_NOT_FOUND: "payment.refund.not.found";
     readonly PAYMENT_REFUND_ALREADY_PROCESSED: "payment.refund.already.processed";
@@ -209,6 +211,13 @@ export declare const ERROR_CODES: {
     readonly PAYMENT_COMPLIANCE_CHECK_FAILED: "payment.compliance.check.failed";
     readonly PAYMENT_COMPLIANCE_LIMIT_EXCEEDED: "payment.compliance.limit.exceeded";
     readonly PAYMENT_COMPLIANCE_POLICY_MISSING: "payment.compliance.policy.missing";
+    readonly PAYMENT_COMPLIANCE_KYC_REQUIRED: "payment.compliance.kyc.required";
+    readonly PAYMENT_COMPLIANCE_GEOGRAPHIC_RESTRICTION: "payment.compliance.geographic.restriction";
+    readonly PAYMENT_COMPLIANCE_AML_CHECK_FAILED: "payment.compliance.aml.check.failed";
+    readonly PAYMENT_COMPLIANCE_PSD2_STRONG_AUTH_REQUIRED: "payment.compliance.psd2.strong.auth.required";
+    readonly PAYMENT_COMPLIANCE_GDPR_DATA_ACCESS: "payment.compliance.gdpr.data.access";
+    readonly PAYMENT_COMPLIANCE_PCI_COMPLIANCE: "payment.compliance.pci.compliance";
+    readonly PAYMENT_COMPLIANCE_LOCAL_BANKING_RESTRICTION: "payment.compliance.local.banking.restriction";
     readonly PAYMENT_PROCESSING_FAILED: "payment.processing.failed";
     readonly PAYMENT_PROCESSING_TIMEOUT: "payment.processing.timeout";
     readonly PAYMENT_PROCESSING_GATEWAY_ERROR: "payment.processing.gateway.error";
@@ -385,6 +394,8 @@ export declare const NOTIFICATION_ERROR_CODES: {
  * Subset of ERROR_CODES for @plyaz/payments package
  */
 export declare const PAYMENT_ERROR_CODES: {
+    PAYMENT_TIMEOUT: string;
+    PAYMENT_NETWORK_ERROR: string;
     PAYMENT_REFUND_FAILED: string;
     PAYMENT_REFUND_NOT_FOUND: string;
     PAYMENT_REFUND_ALREADY_PROCESSED: string;
@@ -401,6 +412,8 @@ export declare const PAYMENT_ERROR_CODES: {
     PAYMENT_COMPLIANCE_CHECK_FAILED: string;
     PAYMENT_COMPLIANCE_LIMIT_EXCEEDED: string;
     PAYMENT_COMPLIANCE_POLICY_MISSING: string;
+    PAYMENT_COMPLIANCE_KYC_REQUIRED: string;
+    PAYMENT_COMPLIANCE_GEOGRAPHIC_RESTRICTION: string;
     PAYMENT_PROCESSING_FAILED: string;
     PAYMENT_PROCESSING_TIMEOUT: string;
     PAYMENT_PROCESSING_GATEWAY_ERROR: string;

package/dist/errors/enums.d.ts

@@ -347,4 +347,6 @@ export declare const ERROR_EXCEPTIONS_NAMESPACES: {
     MONITORING: string;
     HOOKS: string;
     COMMON: string;
+    COMPLIANCE: string;
+    PAYMENT_WEBHOOKS: string;
 };

package/dist/errors/index.cjs

@@ -264,7 +264,9 @@ var ERROR_EXCEPTIONS_NAMESPACES = {
   WEB3: "web3",
   MONITORING: "monitoring",
   HOOKS: "hooks",
-  COMMON: "common"
+  COMMON: "common",
+  COMPLIANCE: "compliance",
+  PAYMENT_WEBHOOKS: "payment-webhook"
 };
 
 // src/http/constants.ts
@@ -307,6 +309,10 @@ var HTTP_STATUS = {
    * 429 Too Many Requests - The user has sent too many requests in a given amount of time
    */
   TOO_MANY_REQUESTS: 429,
+  /**
+   * 451 Unavailable For Legal Reasons - The user requested a resource that cannot legally be provided
+   */
+  UNAVAILABLE_FOR_LEGAL_REASONS: 451,
   // 5xx Server Errors
   /**
    * 500 Internal Server Error - The server encountered an unexpected condition
@@ -327,7 +333,12 @@ var HTTP_STATUS = {
   /**
    * 504 Gateway Timeout - The server did not get a response in time from the upstream server
    */
-  GATEWAY_TIMEOUT: 504};
+  GATEWAY_TIMEOUT: 504,
+  /**
+   * 511 Network Authentication Required - The client needs to authenticate to gain network access
+   */
+  NETWORK_AUTHENTICATION_REQUIRED: 511
+};
 
 // src/errors/codes.ts
 var ERROR_CODES = {
@@ -564,6 +575,8 @@ var ERROR_CODES = {
   // General
   DB_UNKNOWN_ERROR: "DB_UNKNOWN_ERROR",
   // ===== Payments Package Errors =====
+  PAYMENT_TIMEOUT: "payment.timeout",
+  PAYMENT_NETWORK_ERROR: "payment.network.error",
   // Refund
   PAYMENT_REFUND_FAILED: "payment.refund.failed",
   PAYMENT_REFUND_NOT_FOUND: "payment.refund.not.found",
@@ -583,6 +596,13 @@ var ERROR_CODES = {
   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_AML_CHECK_FAILED: "payment.compliance.aml.check.failed",
+  PAYMENT_COMPLIANCE_PSD2_STRONG_AUTH_REQUIRED: "payment.compliance.psd2.strong.auth.required",
+  PAYMENT_COMPLIANCE_GDPR_DATA_ACCESS: "payment.compliance.gdpr.data.access",
+  PAYMENT_COMPLIANCE_PCI_COMPLIANCE: "payment.compliance.pci.compliance",
+  PAYMENT_COMPLIANCE_LOCAL_BANKING_RESTRICTION: "payment.compliance.local.banking.restriction",
   // Processing
   PAYMENT_PROCESSING_FAILED: "payment.processing.failed",
   PAYMENT_PROCESSING_TIMEOUT: "payment.processing.timeout",
@@ -751,6 +771,8 @@ 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",
   // Refund
   PAYMENT_REFUND_FAILED: "payment.refund.failed",
   PAYMENT_REFUND_NOT_FOUND: "payment.refund.not.found",
@@ -770,6 +792,8 @@ var PAYMENT_ERROR_CODES = {
   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",
   // Processing
   PAYMENT_PROCESSING_FAILED: "payment.processing.failed",
   PAYMENT_PROCESSING_TIMEOUT: "payment.processing.timeout",
@@ -2281,6 +2305,71 @@ var ERROR_DEFINITIONS = {
     severity: ERROR_SEVERITY.High,
     retryable: false
   },
+  [ERROR_CODES.PAYMENT_TIMEOUT]: {
+    code: ERROR_CODES.PAYMENT_TIMEOUT,
+    status: HTTP_STATUS.REQUEST_TIMEOUT,
+    category: ERROR_CATEGORY.Timeout,
+    userMessage: "errors.payment.timeout",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: true
+  },
+  [ERROR_CODES.PAYMENT_NETWORK_ERROR]: {
+    code: ERROR_CODES.PAYMENT_NETWORK_ERROR,
+    status: HTTP_STATUS.NETWORK_AUTHENTICATION_REQUIRED,
+    category: ERROR_CATEGORY.Network,
+    userMessage: "errors.payment.network_error",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: true
+  },
+  // Misc
+  [ERROR_CODES.DB_SCHEDULE_SETUP_FAILED]: {
+    code: ERROR_CODES.DB_SCHEDULE_SETUP_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.misc.schedule_setup_failed",
+    severity: ERROR_SEVERITY.Critical,
+    retryable: false
+  },
+  [ERROR_CODES.DB_DECRYPTION_FAILED]: {
+    code: ERROR_CODES.DB_DECRYPTION_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Server,
+    userMessage: "db.misc.decryption_failed",
+    severity: ERROR_SEVERITY.Critical,
+    retryable: false
+  },
+  [ERROR_CODES.DB_INVALID_SHELL_ARG]: {
+    code: ERROR_CODES.DB_INVALID_SHELL_ARG,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.misc.invalid_shell_arg",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_INVALID_BETWEEN_OPERATOR]: {
+    code: ERROR_CODES.DB_INVALID_BETWEEN_OPERATOR,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.misc.invalid_between_operator",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_INVALID_IN_OPERATOR]: {
+    code: ERROR_CODES.DB_INVALID_IN_OPERATOR,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.misc.invalid_in_operator",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.DB_INVALID_COUNT]: {
+    code: ERROR_CODES.DB_INVALID_COUNT,
+    status: HTTP_STATUS.BAD_REQUEST,
+    category: ERROR_CATEGORY.Validation,
+    userMessage: "db.misc.invalid_count",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
   // ===== Payments Package Error Definitions =====
   // ===== Refund Errors =====
   [ERROR_CODES.PAYMENT_REFUND_FAILED]: {
@@ -2413,45 +2502,20 @@ var ERROR_DEFINITIONS = {
     severity: ERROR_SEVERITY.Critical,
     retryable: false
   },
-  // ===== Processing Errors =====
-  [ERROR_CODES.PAYMENT_PROCESSING_FAILED]: {
-    code: ERROR_CODES.PAYMENT_PROCESSING_FAILED,
-    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
-    category: ERROR_CATEGORY.Processing,
-    userMessage: "errors.payment.processing.failed",
-    severity: ERROR_SEVERITY.Critical,
-    retryable: true
-  },
-  [ERROR_CODES.PAYMENT_PROCESSING_TIMEOUT]: {
-    code: ERROR_CODES.PAYMENT_PROCESSING_TIMEOUT,
-    status: HTTP_STATUS.GATEWAY_TIMEOUT,
-    category: ERROR_CATEGORY.Timeout,
-    userMessage: "errors.payment.processing.timeout",
-    severity: ERROR_SEVERITY.High,
-    retryable: true
-  },
-  [ERROR_CODES.PAYMENT_PROCESSING_GATEWAY_ERROR]: {
-    code: ERROR_CODES.PAYMENT_PROCESSING_GATEWAY_ERROR,
-    status: HTTP_STATUS.BAD_GATEWAY,
-    category: ERROR_CATEGORY.Provider,
-    userMessage: "errors.payment.processing.gateway_error",
-    severity: ERROR_SEVERITY.High,
-    retryable: true
-  },
-  [ERROR_CODES.PAYMENT_PROCESSING_DUPLICATE]: {
-    code: ERROR_CODES.PAYMENT_PROCESSING_DUPLICATE,
-    status: HTTP_STATUS.CONFLICT,
-    category: ERROR_CATEGORY.Processing,
-    userMessage: "errors.payment.processing.duplicate",
-    severity: ERROR_SEVERITY.Low,
+  [ERROR_CODES.PAYMENT_COMPLIANCE_KYC_REQUIRED]: {
+    code: ERROR_CODES.PAYMENT_COMPLIANCE_KYC_REQUIRED,
+    status: HTTP_STATUS.FORBIDDEN,
+    category: ERROR_CATEGORY.Compliance,
+    userMessage: "errors.payment.compliance.kyc_required",
+    severity: ERROR_SEVERITY.Medium,
     retryable: false
   },
-  [ERROR_CODES.PAYMENT_PROCESSING_UNEXPECTED_STATE]: {
-    code: ERROR_CODES.PAYMENT_PROCESSING_UNEXPECTED_STATE,
-    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
-    category: ERROR_CATEGORY.System,
-    userMessage: "errors.payment.processing.unexpected_state",
-    severity: ERROR_SEVERITY.Critical,
+  [ERROR_CODES.PAYMENT_COMPLIANCE_GEOGRAPHIC_RESTRICTION]: {
+    code: ERROR_CODES.PAYMENT_COMPLIANCE_GEOGRAPHIC_RESTRICTION,
+    status: HTTP_STATUS.FORBIDDEN,
+    category: ERROR_CATEGORY.Compliance,
+    userMessage: "errors.payment.compliance.geographic_restriction",
+    severity: ERROR_SEVERITY.Medium,
     retryable: false
   },
   // ===== Security Errors =====
@@ -2708,55 +2772,6 @@ var ERROR_DEFINITIONS = {
     severity: ERROR_SEVERITY.High,
     retryable: true
   },
-  // Misc
-  [ERROR_CODES.DB_SCHEDULE_SETUP_FAILED]: {
-    code: ERROR_CODES.DB_SCHEDULE_SETUP_FAILED,
-    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
-    category: ERROR_CATEGORY.Server,
-    userMessage: "db.misc.schedule_setup_failed",
-    severity: ERROR_SEVERITY.Critical,
-    retryable: false
-  },
-  [ERROR_CODES.DB_DECRYPTION_FAILED]: {
-    code: ERROR_CODES.DB_DECRYPTION_FAILED,
-    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
-    category: ERROR_CATEGORY.Server,
-    userMessage: "db.misc.decryption_failed",
-    severity: ERROR_SEVERITY.Critical,
-    retryable: false
-  },
-  [ERROR_CODES.DB_INVALID_SHELL_ARG]: {
-    code: ERROR_CODES.DB_INVALID_SHELL_ARG,
-    status: HTTP_STATUS.BAD_REQUEST,
-    category: ERROR_CATEGORY.Validation,
-    userMessage: "db.misc.invalid_shell_arg",
-    severity: ERROR_SEVERITY.Medium,
-    retryable: false
-  },
-  [ERROR_CODES.DB_INVALID_BETWEEN_OPERATOR]: {
-    code: ERROR_CODES.DB_INVALID_BETWEEN_OPERATOR,
-    status: HTTP_STATUS.BAD_REQUEST,
-    category: ERROR_CATEGORY.Validation,
-    userMessage: "db.misc.invalid_between_operator",
-    severity: ERROR_SEVERITY.Medium,
-    retryable: false
-  },
-  [ERROR_CODES.DB_INVALID_IN_OPERATOR]: {
-    code: ERROR_CODES.DB_INVALID_IN_OPERATOR,
-    status: HTTP_STATUS.BAD_REQUEST,
-    category: ERROR_CATEGORY.Validation,
-    userMessage: "db.misc.invalid_in_operator",
-    severity: ERROR_SEVERITY.Medium,
-    retryable: false
-  },
-  [ERROR_CODES.DB_INVALID_COUNT]: {
-    code: ERROR_CODES.DB_INVALID_COUNT,
-    status: HTTP_STATUS.BAD_REQUEST,
-    category: ERROR_CATEGORY.Validation,
-    userMessage: "db.misc.invalid_count",
-    severity: ERROR_SEVERITY.Medium,
-    retryable: false
-  },
   // Connection & Network
   [ERROR_CODES.DB_CONNECTION_FAILED]: {
     code: ERROR_CODES.DB_CONNECTION_FAILED,
@@ -2834,7 +2849,6 @@ var ERROR_DEFINITIONS = {
     severity: ERROR_SEVERITY.Medium,
     retryable: false
   },
-  // ===== General Payment Framework Errors =====
   [ERROR_CODES.PAYMENT_SYSTEM_NOT_INITIALIZED]: {
     code: ERROR_CODES.PAYMENT_SYSTEM_NOT_INITIALIZED,
     status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
@@ -2915,6 +2929,87 @@ var ERROR_DEFINITIONS = {
     userMessage: "errors.payment.event.lifecycle_failure",
     severity: ERROR_SEVERITY.High,
     retryable: false
+  },
+  [ERROR_CODES.PAYMENT_COMPLIANCE_AML_CHECK_FAILED]: {
+    code: ERROR_CODES.PAYMENT_COMPLIANCE_AML_CHECK_FAILED,
+    status: HTTP_STATUS.FORBIDDEN,
+    category: ERROR_CATEGORY.Compliance,
+    userMessage: "errors.payment.compliance.aml_check_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: false
+  },
+  [ERROR_CODES.PAYMENT_COMPLIANCE_PSD2_STRONG_AUTH_REQUIRED]: {
+    code: ERROR_CODES.PAYMENT_COMPLIANCE_PSD2_STRONG_AUTH_REQUIRED,
+    status: HTTP_STATUS.UNAUTHORIZED,
+    category: ERROR_CATEGORY.Authentication,
+    userMessage: "errors.payment.compliance.psd2_strong_auth_required",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: true
+  },
+  [ERROR_CODES.PAYMENT_COMPLIANCE_GDPR_DATA_ACCESS]: {
+    code: ERROR_CODES.PAYMENT_COMPLIANCE_GDPR_DATA_ACCESS,
+    status: HTTP_STATUS.UNAVAILABLE_FOR_LEGAL_REASONS,
+    category: ERROR_CATEGORY.Compliance,
+    userMessage: "errors.payment.compliance.gdpr_data_access",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.PAYMENT_COMPLIANCE_PCI_COMPLIANCE]: {
+    code: ERROR_CODES.PAYMENT_COMPLIANCE_PCI_COMPLIANCE,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Security,
+    userMessage: "errors.payment.compliance.pci_compliance",
+    severity: ERROR_SEVERITY.Critical,
+    retryable: false
+  },
+  [ERROR_CODES.PAYMENT_COMPLIANCE_LOCAL_BANKING_RESTRICTION]: {
+    code: ERROR_CODES.PAYMENT_COMPLIANCE_LOCAL_BANKING_RESTRICTION,
+    status: HTTP_STATUS.FORBIDDEN,
+    category: ERROR_CATEGORY.Regional,
+    userMessage: "errors.payment.compliance.local_banking_restriction",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  // === Processing Errors ===
+  [ERROR_CODES.PAYMENT_PROCESSING_FAILED]: {
+    code: ERROR_CODES.PAYMENT_PROCESSING_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Processing,
+    userMessage: "errors.payment.processing.failed",
+    severity: ERROR_SEVERITY.Critical,
+    retryable: false
+  },
+  [ERROR_CODES.PAYMENT_PROCESSING_TIMEOUT]: {
+    code: ERROR_CODES.PAYMENT_PROCESSING_TIMEOUT,
+    status: HTTP_STATUS.GATEWAY_TIMEOUT,
+    category: ERROR_CATEGORY.Timeout,
+    userMessage: "errors.payment.processing.timeout",
+    severity: ERROR_SEVERITY.High,
+    retryable: true
+  },
+  [ERROR_CODES.PAYMENT_PROCESSING_GATEWAY_ERROR]: {
+    code: ERROR_CODES.PAYMENT_PROCESSING_GATEWAY_ERROR,
+    status: HTTP_STATUS.BAD_GATEWAY,
+    category: ERROR_CATEGORY.Provider,
+    userMessage: "errors.payment.processing.gateway_error",
+    severity: ERROR_SEVERITY.High,
+    retryable: true
+  },
+  [ERROR_CODES.PAYMENT_PROCESSING_DUPLICATE]: {
+    code: ERROR_CODES.PAYMENT_PROCESSING_DUPLICATE,
+    status: HTTP_STATUS.CONFLICT,
+    category: ERROR_CATEGORY.Processing,
+    userMessage: "errors.payment.processing.duplicate",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: false
+  },
+  [ERROR_CODES.PAYMENT_PROCESSING_UNEXPECTED_STATE]: {
+    code: ERROR_CODES.PAYMENT_PROCESSING_UNEXPECTED_STATE,
+    status: HTTP_STATUS.UNPROCESSABLE_ENTITY,
+    category: ERROR_CATEGORY.System,
+    userMessage: "errors.payment.processing.unexpected_state",
+    severity: ERROR_SEVERITY.Critical,
+    retryable: false
   }
 };