@plyaz/types 1.14.9 → 1.14.11

package/dist/errors/codes.d.ts

@@ -185,6 +185,73 @@ export declare const ERROR_CODES: {
     readonly DB_INVALID_BETWEEN_OPERATOR: "DB_INVALID_BETWEEN_OPERATOR";
     readonly DB_INVALID_IN_OPERATOR: "DB_INVALID_IN_OPERATOR";
     readonly DB_INVALID_COUNT: "DB_INVALID_COUNT";
+    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";
+    readonly PAYMENT_REFUND_AMOUNT_INVALID: "payment.refund.amount.invalid";
+    readonly PAYMENT_REFUND_VALIDATION_FAILED: "payment.refund.validation.failed";
+    readonly PAYMENT_REFUND_TIMEOUT: "payment.refund.timeout";
+    readonly PAYMENT_PROVIDER_ERROR: "payment.provider.error";
+    readonly PAYMENT_PROVIDER_UNAVAILABLE: "payment.provider.unavailable";
+    readonly PAYMENT_PROVIDER_CONFIGURATION_INVALID: "payment.provider.configuration.invalid";
+    readonly PAYMENT_PROVIDER_RESPONSE_INVALID: "payment.provider.response.invalid";
+    readonly PAYMENT_PROVIDER_TIMEOUT: "payment.provider.timeout";
+    readonly PAYMENT_PROVIDER_AUTH_FAILED: "payment.provider.auth.failed";
+    readonly PAYMENT_COMPLIANCE_VIOLATION: "payment.compliance.violation";
+    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_PROCESSING_FAILED: "payment.processing.failed";
+    readonly PAYMENT_PROCESSING_TIMEOUT: "payment.processing.timeout";
+    readonly PAYMENT_PROCESSING_GATEWAY_ERROR: "payment.processing.gateway.error";
+    readonly PAYMENT_PROCESSING_DUPLICATE: "payment.processing.duplicate";
+    readonly PAYMENT_PROCESSING_UNEXPECTED_STATE: "payment.processing.unexpected.state";
+    readonly PAYMENT_SECURITY_VIOLATION: "payment.security.violation";
+    readonly PAYMENT_SECURITY_SIGNATURE_INVALID: "payment.security.signature.invalid";
+    readonly PAYMENT_SECURITY_ENCRYPTION_FAILED: "payment.security.encryption.failed";
+    readonly PAYMENT_SECURITY_FRAUD_DETECTED: "payment.security.fraud.detected";
+    readonly PAYMENT_SECURITY_TOKEN_INVALID: "payment.security.token.invalid";
+    readonly PAYMENT_VALIDATION_FAILED: "payment.validation.failed";
+    readonly PAYMENT_VALIDATION_AMOUNT_INVALID: "payment.validation.amount.invalid";
+    readonly PAYMENT_VALIDATION_CURRENCY_UNSUPPORTED: "payment.validation.currency.unsupported";
+    readonly PAYMENT_VALIDATION_METADATA_INVALID: "payment.validation.metadata.invalid";
+    readonly PAYMENT_VALIDATION_MISSING_REQUIRED_FIELD: "payment.validation.field.required";
+    readonly PAYMENT_WEBHOOK_SIGNATURE_INVALID: "payment.webhook.signature.invalid";
+    readonly PAYMENT_WEBHOOK_PROCESSING_FAILED: "payment.webhook.processing.failed";
+    readonly PAYMENT_WEBHOOK_VALIDATION_FAILED: "payment.webhook.validation.failed";
+    readonly PAYMENT_WEBHOOK_EVENT_TYPE_UNSUPPORTED: "payment.webhook.event.type.unsupported";
+    readonly PAYMENT_WEBHOOK_HANDLER_NOT_FOUND: "payment.webhook.handler.not.found";
+    readonly PAYMENT_ADAPTER_INIT_FAILED: "payment.adapter.init.failed";
+    readonly PAYMENT_ADAPTER_SHUTDOWN_ERROR: "payment.adapter.shutdown.error";
+    readonly PAYMENT_ADAPTER_HMAC_COMPUTATION_FAILED: "payment.adapter.hmac.computation.failed";
+    readonly PAYMENT_ADAPTER_MISSING_PROVIDER: "payment.adapter.missing.provider";
+    readonly PAYMENT_ADAPTER_MISSING_ENVIRONMENT: "payment.adapter.missing.environment";
+    readonly PAYMENT_ADAPTER_MISSING_CREDENTIALS: "payment.adapter.missing.credentials";
+    readonly PAYMENT_ADAPTER_MISSING_WEBHOOK_URL: "payment.adapter.missing.webhook.url";
+    readonly PAYMENT_ADAPTER_MISSING_UNREGISTER_ENDPOINT: "payment.adapter.missing.unregister.endpoint";
+    readonly PAYMENT_ADAPTER_UNSUPPORTED_OPERATION: "payment.adapter.unsupported.operation";
+    readonly PAYMENT_ADAPTER_RESPONSE_MAPPING_FAILED: "payment.adapter.response.mapping.failed";
+    readonly PAYMENT_IDEMPOTENCY_VIOLATION: "payment.idempotency.violation";
+    readonly PAYMENT_IDEMPOTENCY_KEY_MISSING: "payment.idempotency.key.missing";
+    readonly PAYMENT_IDEMPOTENCY_STORE_ERROR: "payment.idempotency.store.error";
+    readonly PAYMENT_ROUTING_FAILED: "payment.routing.failed";
+    readonly PAYMENT_ROUTING_CONFIGURATION_INVALID: "payment.routing.configuration.invalid";
+    readonly PAYMENT_ROUTING_PROVIDER_UNAVAILABLE: "payment.routing.provider.unavailable";
+    readonly PAYMENT_ROUTING_RETRY_EXCEEDED: "payment.routing.retry.exceeded";
+    readonly PAYMENT_SYSTEM_NOT_INITIALIZED: "payment.system.not.initialized";
+    readonly PAYMENT_CONTEXT_OPERATION_FAILED: "payment.context.operation.failed";
+    readonly PAYMENT_INTERNAL_ERROR: "payment.internal.error";
+    readonly 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.
+     */
+    readonly PAYMENT_EVENT_EMIT_FAILED: "PAYMENT_EVENT_EMIT_FAILED";
+    readonly PAYMENT_EVENT_INVALID_TYPE: "PAYMENT_EVENT_INVALID_TYPE";
+    readonly PAYMENT_EVENT_CREATION_FAILED: "PAYMENT_EVENT_CREATION_FAILED";
+    readonly PAYMENT_EVENT_HANDLER_TIMEOUT: "PAYMENT_EVENT_HANDLER_TIMEOUT";
+    readonly PAYMENT_EVENT_HANDLER_INVALID_RESULT: "PAYMENT_EVENT_HANDLER_INVALID_RESULT";
+    readonly PAYMENT_EVENT_LIFECYCLE_FAILURE: "PAYMENT_EVENT_LIFECYCLE_FAILURE";
 };
 /**
  * Type for all error code values
@@ -305,8 +372,154 @@ export declare const NOTIFICATION_ERROR_CODES: {
     readonly UNKNOWN_ERROR: "notification.unknown.error";
     readonly INITIALIZATION_FAILED: "notification.initialization.failed";
 };
+/**
+ * PAYMENT-specific error codes
+ * Subset of ERROR_CODES for @plyaz/payments package
+ */
+export declare const PAYMENT_ERROR_CODES: {
+    PAYMENT_REFUND_FAILED: string;
+    PAYMENT_REFUND_NOT_FOUND: string;
+    PAYMENT_REFUND_ALREADY_PROCESSED: string;
+    PAYMENT_REFUND_AMOUNT_INVALID: string;
+    PAYMENT_REFUND_VALIDATION_FAILED: string;
+    PAYMENT_REFUND_TIMEOUT: string;
+    PAYMENT_PROVIDER_ERROR: string;
+    PAYMENT_PROVIDER_UNAVAILABLE: string;
+    PAYMENT_PROVIDER_CONFIGURATION_INVALID: string;
+    PAYMENT_PROVIDER_RESPONSE_INVALID: string;
+    PAYMENT_PROVIDER_TIMEOUT: string;
+    PAYMENT_PROVIDER_AUTH_FAILED: string;
+    PAYMENT_COMPLIANCE_VIOLATION: string;
+    PAYMENT_COMPLIANCE_CHECK_FAILED: string;
+    PAYMENT_COMPLIANCE_LIMIT_EXCEEDED: string;
+    PAYMENT_COMPLIANCE_POLICY_MISSING: string;
+    PAYMENT_PROCESSING_FAILED: string;
+    PAYMENT_PROCESSING_TIMEOUT: string;
+    PAYMENT_PROCESSING_GATEWAY_ERROR: string;
+    PAYMENT_PROCESSING_DUPLICATE: string;
+    PAYMENT_PROCESSING_UNEXPECTED_STATE: string;
+    PAYMENT_SECURITY_VIOLATION: string;
+    PAYMENT_SECURITY_SIGNATURE_INVALID: string;
+    PAYMENT_SECURITY_ENCRYPTION_FAILED: string;
+    PAYMENT_SECURITY_FRAUD_DETECTED: string;
+    PAYMENT_SECURITY_TOKEN_INVALID: string;
+    PAYMENT_VALIDATION_FAILED: string;
+    PAYMENT_VALIDATION_AMOUNT_INVALID: string;
+    PAYMENT_VALIDATION_CURRENCY_UNSUPPORTED: string;
+    PAYMENT_VALIDATION_METADATA_INVALID: string;
+    PAYMENT_VALIDATION_MISSING_REQUIRED_FIELD: string;
+    PAYMENT_WEBHOOK_SIGNATURE_INVALID: string;
+    PAYMENT_WEBHOOK_PROCESSING_FAILED: string;
+    PAYMENT_WEBHOOK_VALIDATION_FAILED: string;
+    PAYMENT_WEBHOOK_EVENT_TYPE_UNSUPPORTED: string;
+    PAYMENT_WEBHOOK_HANDLER_NOT_FOUND: string;
+    PAYMENT_ADAPTER_INIT_FAILED: string;
+    PAYMENT_ADAPTER_SHUTDOWN_ERROR: string;
+    PAYMENT_ADAPTER_HMAC_COMPUTATION_FAILED: string;
+    PAYMENT_ADAPTER_MISSING_PROVIDER: string;
+    PAYMENT_ADAPTER_MISSING_ENVIRONMENT: string;
+    PAYMENT_ADAPTER_MISSING_CREDENTIALS: string;
+    PAYMENT_ADAPTER_MISSING_WEBHOOK_URL: string;
+    PAYMENT_ADAPTER_MISSING_UNREGISTER_ENDPOINT: string;
+    PAYMENT_ADAPTER_UNSUPPORTED_OPERATION: string;
+    PAYMENT_ADAPTER_RESPONSE_MAPPING_FAILED: string;
+    PAYMENT_IDEMPOTENCY_VIOLATION: string;
+    PAYMENT_IDEMPOTENCY_KEY_MISSING: string;
+    PAYMENT_IDEMPOTENCY_STORE_ERROR: string;
+    PAYMENT_ROUTING_FAILED: string;
+    PAYMENT_ROUTING_CONFIGURATION_INVALID: string;
+    PAYMENT_ROUTING_PROVIDER_UNAVAILABLE: string;
+    PAYMENT_ROUTING_RETRY_EXCEEDED: string;
+    PAYMENT_SYSTEM_NOT_INITIALIZED: string;
+    PAYMENT_CONTEXT_OPERATION_FAILED: string;
+    PAYMENT_INTERNAL_ERROR: string;
+    PAYMENT_UNKNOWN_ERROR: string;
+    /**
+     * 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: string;
+    PAYMENT_EVENT_INVALID_TYPE: string;
+    PAYMENT_EVENT_CREATION_FAILED: string;
+    PAYMENT_EVENT_HANDLER_TIMEOUT: string;
+    PAYMENT_EVENT_HANDLER_INVALID_RESULT: string;
+    PAYMENT_EVENT_LIFECYCLE_FAILURE: string;
+};
+/** Database-specific error codes
+* Subset of ERROR_CODES for database operations
+*/
+export declare const DATABASE_ERROR_CODES: {
+    readonly ACCESS_DENIED: "DB_ACCESS_DENIED";
+    readonly CONFIG_REQUIRED: "DB_CONFIG_REQUIRED";
+    readonly CONNECT_FAILED: "DB_CONNECT_FAILED";
+    readonly DISCONNECT_FAILED: "DB_DISCONNECT_FAILED";
+    readonly INIT_FAILED: "DB_INIT_FAILED";
+    readonly QUERY_FAILED: "DB_QUERY_FAILED";
+    readonly BUILD_WHERE_FAILED: "DB_BUILD_WHERE_FAILED";
+    readonly INVALID_SQL: "DB_INVALID_SQL";
+    readonly TRANSACTION_FAILED: "DB_TRANSACTION_FAILED";
+    readonly UNSUPPORTED_OPERATOR: "DB_UNSUPPORTED_OPERATOR";
+    readonly CREATE_FAILED: "DB_CREATE_FAILED";
+    readonly CREATION_FAILED: "DB_CREATION_FAILED";
+    readonly FETCH_FAILED: "DB_FETCH_FAILED";
+    readonly FIND_FAILED: "DB_FIND_FAILED";
+    readonly FIND_MANY_FAILED: "DB_FIND_MANY_FAILED";
+    readonly FIND_BY_ID_FAILED: "DB_FIND_BY_ID_FAILED";
+    readonly UPDATE_FAILED: "DB_UPDATE_FAILED";
+    readonly UPDATE_NO_CHANGES: "DB_UPDATE_NO_CHANGES";
+    readonly DELETE_FAILED: "DB_DELETE_FAILED";
+    readonly INSERT_FAILED: "DB_INSERT_FAILED";
+    readonly RECORD_NOT_FOUND: "DB_RECORD_NOT_FOUND";
+    readonly EXISTS_FAILED: "DB_EXISTS_FAILED";
+    readonly COLUMN_NOT_EXISTS: "DB_COLUMN_NOT_EXISTS";
+    readonly TABLE_NOT_REGISTERED: "DB_TABLE_NOT_REGISTERED";
+    readonly TABLE_REGISTRATION_FAILED: "DB_TABLE_REGISTRATION_FAILED";
+    readonly ID_COLUMN_NOT_REGISTERED: "DB_ID_COLUMN_NOT_REGISTERED";
+    readonly INVALID_COLUMN: "DB_INVALID_COLUMN";
+    readonly INVALID_TABLE_NAME: "DB_INVALID_TABLE_NAME";
+    readonly GET_ID_COLUMN_FAILED: "DB_GET_ID_COLUMN_FAILED";
+    readonly GET_TABLE_FAILED: "DB_GET_TABLE_FAILED";
+    readonly INVALID_PARAMETERS: "DB_INVALID_PARAMETERS";
+    readonly INVALID_PARAMS: "DB_INVALID_PARAMS";
+    readonly INVALID_FILTER: "DB_INVALID_FILTER";
+    readonly INVALID_ID: "DB_INVALID_ID";
+    readonly INVALID_ENTITY: "DB_INVALID_ENTITY";
+    readonly INVALID_UPDATE_PARAMS: "DB_INVALID_UPDATE_PARAMS";
+    readonly INVALID_FIELD_NAME: "DB_INVALID_FIELD_NAME";
+    readonly INVALID_RESULT: "DB_INVALID_RESULT";
+    readonly NO_UPDATE_FIELDS: "DB_NO_UPDATE_FIELDS";
+    readonly COUNT_FAILED: "DB_COUNT_FAILED";
+    readonly COUNT_NO_RESULTS: "DB_COUNT_NO_RESULTS";
+    readonly NO_DATA: "DB_NO_DATA";
+    readonly NO_TENANT_CONTEXT: "DB_NO_TENANT_CONTEXT";
+    readonly NO_TENANT_ID: "DB_NO_TENANT_ID";
+    readonly TENANT_VALIDATION_FAILED: "DB_TENANT_VALIDATION_FAILED";
+    readonly BACKUP_CLEANUP_FAILED: "DB_BACKUP_CLEANUP_FAILED";
+    readonly BACKUP_FILE_NOT_FOUND: "DB_BACKUP_FILE_NOT_FOUND";
+    readonly LIST_BACKUPS_FAILED: "DB_LIST_BACKUPS_FAILED";
+    readonly INVALID_BACKUP_INFO: "DB_INVALID_BACKUP_INFO";
+    readonly RESTORE_FAILED: "DB_RESTORE_FAILED";
+    readonly CACHE_DELETE_FAILED: "DB_CACHE_DELETE_FAILED";
+    readonly CACHE_HEALTH_CHECK_FAILED: "DB_CACHE_HEALTH_CHECK_FAILED";
+    readonly CACHE_INVALIDATE_FAILED: "DB_CACHE_INVALIDATE_FAILED";
+    readonly CACHE_SET_FAILED: "DB_CACHE_SET_FAILED";
+    readonly CACHE_GET_FAILED: "DB_CACHE_GET_FAILED";
+    readonly INVALID_FILEPATH: "DB_INVALID_FILEPATH";
+    readonly S3_DELETE_FAILED: "DB_S3_DELETE_FAILED";
+    readonly S3_DOWNLOAD_FAILED: "DB_S3_DOWNLOAD_FAILED";
+    readonly S3_NOT_CONFIGURED: "DB_S3_NOT_CONFIGURED";
+    readonly S3_UPLOAD_FAILED: "DB_S3_UPLOAD_FAILED";
+    readonly SCHEDULE_SETUP_FAILED: "DB_SCHEDULE_SETUP_FAILED";
+    readonly DECRYPTION_FAILED: "DB_DECRYPTION_FAILED";
+    readonly INVALID_SHELL_ARG: "DB_INVALID_SHELL_ARG";
+    readonly INVALID_BETWEEN_OPERATOR: "DB_INVALID_BETWEEN_OPERATOR";
+    readonly INVALID_IN_OPERATOR: "DB_INVALID_IN_OPERATOR";
+    readonly INVALID_COUNT: "DB_INVALID_COUNT";
+};
 export type ApiErrorCodeValue = (typeof API_ERROR_CODES)[keyof typeof API_ERROR_CODES] | `HTTP_${number}`;
 export type NotificationErrorCodeValue = (typeof NOTIFICATION_ERROR_CODES)[keyof typeof NOTIFICATION_ERROR_CODES];
+export type DatabaseErrorCodeValue = (typeof DATABASE_ERROR_CODES)[keyof typeof DATABASE_ERROR_CODES];
+export type PaymentErrorCodeValue = (typeof PAYMENT_ERROR_CODES)[keyof typeof PAYMENT_ERROR_CODES];
 /**
  * Unified ERROR_DEFINITIONS
  * Single source of truth for ALL error definitions across all @plyaz packages

package/dist/errors/enums.d.ts

@@ -107,6 +107,20 @@ export declare const ERROR_CATEGORY: {
     readonly Template: "template";
     /** Configuration-related error (e.g., invalid or missing configuration). */
     readonly Configuration: "configuration";
+    /** Payment processing-related error (e.g., capture or settlement failure). */
+    readonly Processing: "processing";
+    /** Fraud detection or prevention failure. */
+    readonly Fraud: "fraud";
+    /** Compliance-related error (e.g., AML/KYC validation failure). */
+    readonly Compliance: "compliance";
+    /** Limits or quota-related error (e.g., exceeded transaction limit). */
+    readonly Limits: "limits";
+    /** System-level error (unexpected internal issue). */
+    readonly System: "system";
+    /** Refund-related error (e.g., duplicate or failed refund). */
+    readonly Refund: "refund";
+    /** Security-related error (e.g., encryption or signature failure). */
+    readonly Security: "security";
     /** Unknown or unclassified error. */
     readonly Unknown: "unknown";
 };
@@ -189,6 +203,13 @@ export declare const ERROR_CATEGORY_TO_EMITTER_KEY: {
     readonly webhook: "webhook";
     readonly template: "template";
     readonly configuration: "configuration";
+    readonly processing: "processing";
+    readonly fraud: "fraud";
+    readonly compliance: "compliance";
+    readonly limits: "limits";
+    readonly system: "system";
+    readonly refund: "refund";
+    readonly security: "security";
     readonly unknown: "unknown";
 };
 /**