@plyaz/types 1.13.3 → 1.13.5

package/dist/errors/codes.d.ts

@@ -0,0 +1,253 @@
+/**
+ * Unified Error Codes and Definitions
+ * Centralized source of truth for ALL error handling across @plyaz packages
+ *
+ * This file is the single source of truth for:
+ * - All error codes
+ * - All error definitions
+ * - Error code to definition mappings
+ */
+import type { ErrorDefinitions } from './types';
+/**
+ * All Error Codes
+ * Combined error codes from all @plyaz packages
+ */
+export declare const ERROR_CODES: {
+    readonly CLIENT_INITIALIZATION_FAILED: "CLIENT_INITIALIZATION_FAILED";
+    readonly CLIENT_INVALID_CONFIG: "CLIENT_INVALID_CONFIG";
+    readonly CLIENT_MISSING_BASE_URL: "CLIENT_MISSING_BASE_URL";
+    readonly CLIENT_CANCELLED: "CLIENT_CANCELLED";
+    readonly CONFIG_VALIDATION_FAILED: "CONFIG_VALIDATION_FAILED";
+    readonly HEADER_PROCESSING_FAILED: "HEADER_PROCESSING_FAILED";
+    readonly NETWORK_OVERRIDE_FAILED: "NETWORK_OVERRIDE_FAILED";
+    readonly REQUEST_TIMEOUT: "REQUEST_TIMEOUT";
+    readonly REQUEST_ABORTED: "REQUEST_ABORTED";
+    readonly REQUEST_INVALID_PARAMS: "REQUEST_INVALID_PARAMS";
+    readonly REQUEST_PREPARATION_FAILED: "REQUEST_PREPARATION_FAILED";
+    readonly RESPONSE_INVALID_FORMAT: "RESPONSE_INVALID_FORMAT";
+    readonly RESPONSE_PARSING_FAILED: "RESPONSE_PARSING_FAILED";
+    readonly AUTH_UNAUTHORIZED: "AUTH_UNAUTHORIZED";
+    readonly AUTH_FORBIDDEN: "AUTH_FORBIDDEN";
+    readonly AUTH_TOKEN_EXPIRED: "AUTH_TOKEN_EXPIRED";
+    readonly AUTH_INVALID_CREDENTIALS: "AUTH_INVALID_CREDENTIALS";
+    readonly RATE_LIMIT_EXCEEDED: "RATE_LIMIT_EXCEEDED";
+    readonly RESOURCE_NOT_FOUND: "RESOURCE_NOT_FOUND";
+    readonly RESOURCE_CONFLICT: "RESOURCE_CONFLICT";
+    readonly API_VALIDATION_FAILED: "API_VALIDATION_FAILED";
+    readonly API_INVALID_INPUT: "API_INVALID_INPUT";
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    readonly REQUIRED_FIELD_MISSING: "REQUIRED_FIELD_MISSING";
+    readonly INVALID_FORMAT: "INVALID_FORMAT";
+    readonly VALIDATION_INVALID_FORMAT: "VALIDATION_INVALID_FORMAT";
+    readonly STRING_TOO_SHORT: "STRING_TOO_SHORT";
+    readonly STRING_TOO_LONG: "STRING_TOO_LONG";
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+    readonly CONNECTION_FAILED: "CONNECTION_FAILED";
+    readonly NETWORK_CONNECTION_FAILED: "NETWORK_CONNECTION_FAILED";
+    readonly NETWORK_OFFLINE: "NETWORK_OFFLINE";
+    readonly NETWORK_DNS_FAILED: "NETWORK_DNS_FAILED";
+    readonly NETWORK_TIMEOUT: "NETWORK_TIMEOUT";
+    readonly NETWORK_PRESET_NOT_FOUND: "NETWORK_PRESET_NOT_FOUND";
+    readonly NETWORK_CONFIGURATION_INVALID: "NETWORK_CONFIGURATION_INVALID";
+    readonly SERVER_ERROR: "SERVER_ERROR";
+    readonly INTERNAL_SERVER_ERROR: "INTERNAL_SERVER_ERROR";
+    readonly SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE";
+    readonly CACHE_READ_FAILED: "CACHE_READ_FAILED";
+    readonly CACHE_WRITE_FAILED: "CACHE_WRITE_FAILED";
+    readonly CACHE_INVALIDATION_FAILED: "CACHE_INVALIDATION_FAILED";
+    readonly CACHE_STORAGE_FAILED: "CACHE_STORAGE_FAILED";
+    readonly CACHE_RETRIEVAL_FAILED: "CACHE_RETRIEVAL_FAILED";
+    readonly RETRY_LIMIT_EXCEEDED: "RETRY_LIMIT_EXCEEDED";
+    readonly RETRY_FAILED: "RETRY_FAILED";
+    readonly RETRY_EXHAUSTED: "RETRY_EXHAUSTED";
+    readonly RETRY_STRATEGY_INVALID: "RETRY_STRATEGY_INVALID";
+    readonly STRATEGY_INVALID: "STRATEGY_INVALID";
+    readonly STRATEGY_CONFLICT: "STRATEGY_CONFLICT";
+    readonly STRATEGY_EXECUTION_FAILED: "STRATEGY_EXECUTION_FAILED";
+    readonly HEADERS_ENRICHMENT_FAILED: "HEADERS_ENRICHMENT_FAILED";
+    readonly HEADERS_VALIDATION_FAILED: "HEADERS_VALIDATION_FAILED";
+    readonly HEADERS_MERGE_CONFLICT: "HEADERS_MERGE_CONFLICT";
+    readonly REGION_DETECTION_FAILED: "REGION_DETECTION_FAILED";
+    readonly REGIONAL_PRESET_NOT_FOUND: "REGIONAL_PRESET_NOT_FOUND";
+    readonly EXTERNAL_SERVICE_ERROR: "EXTERNAL_SERVICE_ERROR";
+    readonly TIMEOUT: "TIMEOUT";
+    readonly DEBUG_TRACKING_FAILED: "DEBUG_TRACKING_FAILED";
+    readonly POLLING_CANCELLED: "POLLING_CANCELLED";
+    readonly POLLING_TIMEOUT: "POLLING_TIMEOUT";
+    readonly POLLING_INVALID_CONFIG: "POLLING_INVALID_CONFIG";
+    readonly PUBSUB_SUBSCRIPTION_FAILED: "PUBSUB_SUBSCRIPTION_FAILED";
+    readonly PUBSUB_PUBLICATION_FAILED: "PUBSUB_PUBLICATION_FAILED";
+    readonly PUBSUB_INVALID_TOPIC: "PUBSUB_INVALID_TOPIC";
+    readonly PUBSUB_CHANNEL_ERROR: "PUBSUB_CHANNEL_ERROR";
+    readonly REVALIDATION_FAILED: "REVALIDATION_FAILED";
+    readonly REVALIDATION_IN_PROGRESS: "REVALIDATION_IN_PROGRESS";
+    readonly DEBUG_OVERRIDE_FAILED: "DEBUG_OVERRIDE_FAILED";
+    readonly DEBUG_CONFLICT_DETECTED: "DEBUG_CONFLICT_DETECTED";
+    readonly ENDPOINT_BUILD_FAILED: "ENDPOINT_BUILD_FAILED";
+    readonly ENDPOINT_NOT_FOUND: "ENDPOINT_NOT_FOUND";
+    readonly ENDPOINT_INVALID_CONFIG: "ENDPOINT_INVALID_CONFIG";
+    readonly EVENT_HANDLER_FAILED: "EVENT_HANDLER_FAILED";
+    readonly EVENT_EMISSION_FAILED: "EVENT_EMISSION_FAILED";
+    readonly MONITORING_FAILED: "MONITORING_FAILED";
+    readonly CONTEXT_OPERATION_FAILED: "CONTEXT_OPERATION_FAILED";
+    readonly CLIENT_ERROR: "CLIENT_ERROR";
+    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
+    readonly NOTIFICATION_PROVIDER_SEND_FAILED: "notification.provider.send.failed";
+    readonly NOTIFICATION_PROVIDER_CONFIGURATION_INVALID: "notification.provider.configuration.invalid";
+    readonly NOTIFICATION_PROVIDER_RATE_LIMIT: "notification.provider.rate.limit";
+    readonly NOTIFICATION_PROVIDER_AUTH_FAILED: "notification.provider.auth.failed";
+    readonly NOTIFICATION_PROVIDER_TIMEOUT: "notification.provider.timeout";
+    readonly NOTIFICATION_PROVIDER_UNAVAILABLE: "notification.provider.unavailable";
+    readonly NOTIFICATION_PROVIDER_FEATURE_NOT_SUPPORTED: "notification.provider.feature.not.supported";
+    readonly NOTIFICATION_ALL_PROVIDERS_FAILED: "notification.all.providers.failed";
+    readonly NOTIFICATION_INVALID_INPUT: "notification.validation.input.invalid";
+    readonly NOTIFICATION_INVALID_RECIPIENT: "notification.validation.recipient.invalid";
+    readonly NOTIFICATION_INVALID_TEMPLATE: "notification.validation.template.invalid";
+    readonly NOTIFICATION_INVALID_PAYLOAD: "notification.validation.payload.invalid";
+    readonly NOTIFICATION_MISSING_REQUIRED_FIELD: "notification.validation.field.required";
+    readonly NOTIFICATION_VALIDATION_FAILED: "notification.validation.failed";
+    readonly NOTIFICATION_USER_OPTED_OUT: "notification.user.opted.out";
+    readonly NOTIFICATION_QUEUE_FULL: "notification.queue.full";
+    readonly NOTIFICATION_QUEUE_PROCESSING_FAILED: "notification.queue.processing.failed";
+    readonly NOTIFICATION_WEBHOOK_SIGNATURE_INVALID: "notification.webhook.signature.invalid";
+    readonly NOTIFICATION_WEBHOOK_VALIDATION_FAILED: "notification.webhook.validation.failed";
+    readonly NOTIFICATION_WEBHOOK_PROCESSING_FAILED: "notification.webhook.processing.failed";
+    readonly NOTIFICATION_TEMPLATE_NOT_FOUND: "notification.template.not.found";
+    readonly NOTIFICATION_TEMPLATE_RENDER_FAILED: "notification.template.render.failed";
+    readonly NOTIFICATION_UNKNOWN_ERROR: "notification.unknown.error";
+    readonly NOTIFICATION_INITIALIZATION_FAILED: "notification.initialization.failed";
+    readonly ERROR_SYSTEM_NOT_INITIALIZED: "error.system.not.initialized";
+    readonly EVENT_FACTORY_NOT_REGISTERED: "error.event.factory.not.registered";
+};
+/**
+ * Type for all error code values
+ */
+export type ErrorCodeValue = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+/**
+ * API-specific error codes
+ * Subset of ERROR_CODES for @plyaz/api package
+ */
+export declare const API_ERROR_CODES: {
+    readonly CLIENT_INITIALIZATION_FAILED: "CLIENT_INITIALIZATION_FAILED";
+    readonly CLIENT_INVALID_CONFIG: "CLIENT_INVALID_CONFIG";
+    readonly CLIENT_MISSING_BASE_URL: "CLIENT_MISSING_BASE_URL";
+    readonly CLIENT_CANCELLED: "CLIENT_CANCELLED";
+    readonly CONFIG_VALIDATION_FAILED: "CONFIG_VALIDATION_FAILED";
+    readonly HEADER_PROCESSING_FAILED: "HEADER_PROCESSING_FAILED";
+    readonly NETWORK_OVERRIDE_FAILED: "NETWORK_OVERRIDE_FAILED";
+    readonly REQUEST_TIMEOUT: "REQUEST_TIMEOUT";
+    readonly REQUEST_ABORTED: "REQUEST_ABORTED";
+    readonly REQUEST_INVALID_PARAMS: "REQUEST_INVALID_PARAMS";
+    readonly REQUEST_PREPARATION_FAILED: "REQUEST_PREPARATION_FAILED";
+    readonly RESPONSE_INVALID_FORMAT: "RESPONSE_INVALID_FORMAT";
+    readonly RESPONSE_PARSING_FAILED: "RESPONSE_PARSING_FAILED";
+    readonly AUTH_UNAUTHORIZED: "AUTH_UNAUTHORIZED";
+    readonly AUTH_FORBIDDEN: "AUTH_FORBIDDEN";
+    readonly AUTH_TOKEN_EXPIRED: "AUTH_TOKEN_EXPIRED";
+    readonly AUTH_INVALID_CREDENTIALS: "AUTH_INVALID_CREDENTIALS";
+    readonly RATE_LIMIT_EXCEEDED: "RATE_LIMIT_EXCEEDED";
+    readonly RESOURCE_NOT_FOUND: "RESOURCE_NOT_FOUND";
+    readonly RESOURCE_CONFLICT: "RESOURCE_CONFLICT";
+    readonly VALIDATION_FAILED: "API_VALIDATION_FAILED";
+    readonly INVALID_INPUT: "API_INVALID_INPUT";
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    readonly REQUIRED_FIELD_MISSING: "REQUIRED_FIELD_MISSING";
+    readonly INVALID_FORMAT: "INVALID_FORMAT";
+    readonly VALIDATION_INVALID_FORMAT: "VALIDATION_INVALID_FORMAT";
+    readonly STRING_TOO_SHORT: "STRING_TOO_SHORT";
+    readonly STRING_TOO_LONG: "STRING_TOO_LONG";
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+    readonly CONNECTION_FAILED: "CONNECTION_FAILED";
+    readonly NETWORK_CONNECTION_FAILED: "NETWORK_CONNECTION_FAILED";
+    readonly NETWORK_OFFLINE: "NETWORK_OFFLINE";
+    readonly NETWORK_DNS_FAILED: "NETWORK_DNS_FAILED";
+    readonly NETWORK_TIMEOUT: "NETWORK_TIMEOUT";
+    readonly NETWORK_CONFIGURATION_INVALID: "NETWORK_CONFIGURATION_INVALID";
+    readonly SERVER_ERROR: "SERVER_ERROR";
+    readonly INTERNAL_SERVER_ERROR: "INTERNAL_SERVER_ERROR";
+    readonly SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE";
+    readonly CACHE_READ_FAILED: "CACHE_READ_FAILED";
+    readonly CACHE_WRITE_FAILED: "CACHE_WRITE_FAILED";
+    readonly CACHE_INVALIDATION_FAILED: "CACHE_INVALIDATION_FAILED";
+    readonly CACHE_STORAGE_FAILED: "CACHE_STORAGE_FAILED";
+    readonly CACHE_RETRIEVAL_FAILED: "CACHE_RETRIEVAL_FAILED";
+    readonly RETRY_LIMIT_EXCEEDED: "RETRY_LIMIT_EXCEEDED";
+    readonly RETRY_FAILED: "RETRY_FAILED";
+    readonly RETRY_EXHAUSTED: "RETRY_EXHAUSTED";
+    readonly RETRY_STRATEGY_INVALID: "RETRY_STRATEGY_INVALID";
+    readonly STRATEGY_INVALID: "STRATEGY_INVALID";
+    readonly STRATEGY_CONFLICT: "STRATEGY_CONFLICT";
+    readonly STRATEGY_EXECUTION_FAILED: "STRATEGY_EXECUTION_FAILED";
+    readonly HEADERS_ENRICHMENT_FAILED: "HEADERS_ENRICHMENT_FAILED";
+    readonly HEADERS_VALIDATION_FAILED: "HEADERS_VALIDATION_FAILED";
+    readonly HEADERS_MERGE_CONFLICT: "HEADERS_MERGE_CONFLICT";
+    readonly REGION_DETECTION_FAILED: "REGION_DETECTION_FAILED";
+    readonly REGIONAL_PRESET_NOT_FOUND: "REGIONAL_PRESET_NOT_FOUND";
+    readonly EXTERNAL_SERVICE_ERROR: "EXTERNAL_SERVICE_ERROR";
+    readonly NETWORK_PRESET_NOT_FOUND: "NETWORK_PRESET_NOT_FOUND";
+    readonly TIMEOUT: "TIMEOUT";
+    readonly DEBUG_TRACKING_FAILED: "DEBUG_TRACKING_FAILED";
+    readonly DEBUG_OVERRIDE_FAILED: "DEBUG_OVERRIDE_FAILED";
+    readonly DEBUG_CONFLICT_DETECTED: "DEBUG_CONFLICT_DETECTED";
+    readonly POLLING_CANCELLED: "POLLING_CANCELLED";
+    readonly POLLING_TIMEOUT: "POLLING_TIMEOUT";
+    readonly POLLING_INVALID_CONFIG: "POLLING_INVALID_CONFIG";
+    readonly PUBSUB_SUBSCRIPTION_FAILED: "PUBSUB_SUBSCRIPTION_FAILED";
+    readonly PUBSUB_PUBLICATION_FAILED: "PUBSUB_PUBLICATION_FAILED";
+    readonly PUBSUB_INVALID_TOPIC: "PUBSUB_INVALID_TOPIC";
+    readonly PUBSUB_CHANNEL_ERROR: "PUBSUB_CHANNEL_ERROR";
+    readonly REVALIDATION_FAILED: "REVALIDATION_FAILED";
+    readonly REVALIDATION_IN_PROGRESS: "REVALIDATION_IN_PROGRESS";
+    readonly ENDPOINT_BUILD_FAILED: "ENDPOINT_BUILD_FAILED";
+    readonly ENDPOINT_NOT_FOUND: "ENDPOINT_NOT_FOUND";
+    readonly ENDPOINT_INVALID_CONFIG: "ENDPOINT_INVALID_CONFIG";
+    readonly EVENT_HANDLER_FAILED: "EVENT_HANDLER_FAILED";
+    readonly EVENT_EMISSION_FAILED: "EVENT_EMISSION_FAILED";
+    readonly MONITORING_FAILED: "MONITORING_FAILED";
+    readonly CONTEXT_OPERATION_FAILED: "CONTEXT_OPERATION_FAILED";
+    readonly CLIENT_ERROR: "CLIENT_ERROR";
+    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
+};
+/**
+ * Notification-specific error codes
+ * Subset of ERROR_CODES for @plyaz/notifications package
+ */
+export declare const NOTIFICATION_ERROR_CODES: {
+    readonly PROVIDER_SEND_FAILED: "notification.provider.send.failed";
+    readonly PROVIDER_CONFIGURATION_INVALID: "notification.provider.configuration.invalid";
+    readonly PROVIDER_RATE_LIMIT: "notification.provider.rate.limit";
+    readonly PROVIDER_AUTH_FAILED: "notification.provider.auth.failed";
+    readonly PROVIDER_TIMEOUT: "notification.provider.timeout";
+    readonly PROVIDER_UNAVAILABLE: "notification.provider.unavailable";
+    readonly PROVIDER_FEATURE_NOT_SUPPORTED: "notification.provider.feature.not.supported";
+    readonly ALL_PROVIDERS_FAILED: "notification.all.providers.failed";
+    readonly INVALID_INPUT: "notification.validation.input.invalid";
+    readonly INVALID_RECIPIENT: "notification.validation.recipient.invalid";
+    readonly INVALID_TEMPLATE: "notification.validation.template.invalid";
+    readonly INVALID_PAYLOAD: "notification.validation.payload.invalid";
+    readonly MISSING_REQUIRED_FIELD: "notification.validation.field.required";
+    readonly VALIDATION_FAILED: "notification.validation.failed";
+    readonly USER_OPTED_OUT: "notification.user.opted.out";
+    readonly QUEUE_FULL: "notification.queue.full";
+    readonly QUEUE_PROCESSING_FAILED: "notification.queue.processing.failed";
+    readonly WEBHOOK_SIGNATURE_INVALID: "notification.webhook.signature.invalid";
+    readonly WEBHOOK_VALIDATION_FAILED: "notification.webhook.validation.failed";
+    readonly WEBHOOK_PROCESSING_FAILED: "notification.webhook.processing.failed";
+    readonly TEMPLATE_NOT_FOUND: "notification.template.not.found";
+    readonly TEMPLATE_RENDER_FAILED: "notification.template.render.failed";
+    readonly UNKNOWN_ERROR: "notification.unknown.error";
+    readonly INITIALIZATION_FAILED: "notification.initialization.failed";
+};
+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];
+/**
+ * Unified ERROR_DEFINITIONS
+ * Single source of truth for ALL error definitions across all @plyaz packages
+ *
+ * Combines:
+ * - API error definitions (basic: code, status, category, fieldsLeft)
+ * - Notification error definitions (extended: includes severity, retryable, userMessage)
+ *
+ * All packages can access ANY error definition for cross-package error handling
+ */
+export declare const ERROR_DEFINITIONS: ErrorDefinitions;

package/dist/errors/enums.d.ts

@@ -97,6 +97,205 @@ export declare const ERROR_CATEGORY: {
     readonly Strategy: "strategy";
     /** Regional-related error (e.g., region detection failure). */
     readonly Regional: "regional";
+    /** Provider-related error (e.g., notification service provider failure). */
+    readonly Provider: "provider";
+    /** Queue-related error (e.g., queue full or processing failed). */
+    readonly Queue: "queue";
+    /** Webhook-related error (e.g., invalid signature or processing failure). */
+    readonly Webhook: "webhook";
+    /** Template-related error (e.g., template not found or rendering failed). */
+    readonly Template: "template";
+    /** Configuration-related error (e.g., invalid or missing configuration). */
+    readonly Configuration: "configuration";
     /** Unknown or unclassified error. */
     readonly Unknown: "unknown";
 };
+/**
+ * Internal package status codes (non-HTTP)
+ * Used for internal configuration and validation errors that aren't HTTP-related
+ * These are in the 1xxx range to distinguish from HTTP status codes (which are typically 100-599)
+ *
+ * @example
+ * ```typescript
+ * import { INTERNAL_STATUS_CODES } from '@plyaz/types';
+ *
+ * const statusCode = INTERNAL_STATUS_CODES.INVALID_CONFIGURATION; // 1001
+ * if (error.statusCode >= 1000 && error.statusCode < 2000) {
+ *   // Handle internal package error
+ * }
+ * ```
+ */
+export declare const INTERNAL_STATUS_CODES: {
+    readonly INVALID_CONFIGURATION: 1001;
+    readonly MISSING_CONFIGURATION: 1002;
+    readonly CONFIGURATION_CONFLICT: 1003;
+    readonly CONFIGURATION_TRACKING_FAILED: 1004;
+    readonly DEBUG_TRACKING_FAILED: 1005;
+    readonly RESOURCE_NOT_FOUND: 1010;
+    readonly RESOURCE_ALREADY_EXISTS: 1011;
+    readonly RESOURCE_UNAVAILABLE: 1012;
+    readonly INVALID_PARAMETER: 1020;
+    readonly MISSING_PARAMETER: 1021;
+    readonly PARAMETER_OUT_OF_RANGE: 1022;
+    readonly STRATEGY_NOT_FOUND: 1030;
+    readonly PRESET_NOT_FOUND: 1031;
+    readonly INVALID_STRATEGY: 1032;
+    readonly REQUEST_FAILED: 1035;
+    readonly INITIALIZATION_FAILED: 1040;
+    readonly OPERATION_FAILED: 1041;
+    readonly STATE_CORRUPTION: 1042;
+    readonly SERIALIZATION_FAILED: 1043;
+    readonly DESERIALIZATION_FAILED: 1044;
+    readonly CONFIGURATION_INVALID: 1045;
+    readonly HEADER_PROCESSING_ERROR: 1046;
+    readonly REGION_DETECTION_ERROR: 1047;
+    readonly NETWORK_OVERRIDE_ERROR: 1048;
+};
+/**
+ * Mapping of error category values to camelCase emitter keys
+ * Used by event systems to route errors to appropriate handlers
+ *
+ * @example
+ * ```typescript
+ * import { ERROR_CATEGORY, ERROR_CATEGORY_TO_EMITTER_KEY } from '@plyaz/types';
+ *
+ * const category = ERROR_CATEGORY.RateLimit; // 'rate.limit'
+ * const emitterKey = ERROR_CATEGORY_TO_EMITTER_KEY[category]; // 'rateLimit'
+ *
+ * // Use in event emitter
+ * eventEmitter.emit(`error:${emitterKey}`, error);
+ * ```
+ */
+export declare const ERROR_CATEGORY_TO_EMITTER_KEY: {
+    readonly network: "network";
+    readonly validation: "validation";
+    readonly authentication: "authentication";
+    readonly authorization: "authorization";
+    readonly "rate.limit": "rateLimit";
+    readonly server: "server";
+    readonly timeout: "timeout";
+    readonly "not.found": "notFound";
+    readonly conflict: "conflict";
+    readonly client: "client";
+    readonly "external.service": "externalService";
+    readonly cache: "cache";
+    readonly headers: "headers";
+    readonly retry: "retry";
+    readonly blockchain: "blockchain";
+    readonly strategy: "strategy";
+    readonly regional: "regional";
+    readonly provider: "provider";
+    readonly queue: "queue";
+    readonly webhook: "webhook";
+    readonly template: "template";
+    readonly configuration: "configuration";
+    readonly unknown: "unknown";
+};
+/**
+ * Common operation names used in error context
+ * These are optional helpers - you can use any freeform string in context.operation
+ *
+ * @example
+ * ```typescript
+ * import { COMMON_OPERATIONS } from '@plyaz/types';
+ *
+ * const context = { operation: COMMON_OPERATIONS.STORAGE };
+ * // Or just use a string:
+ * const context2 = { operation: 'custom-operation' };
+ * ```
+ */
+export declare const COMMON_OPERATIONS: {
+    readonly STORAGE: "storage";
+    readonly RETRIEVAL: "retrieval";
+    readonly INVALIDATION: "invalidation";
+    readonly DELETION: "deletion";
+    readonly VALIDATION: "validation";
+    readonly ENRICHMENT: "enrichment";
+    readonly SERIALIZATION: "serialization";
+    readonly DESERIALIZATION: "deserialization";
+    readonly REQUEST: "request";
+    readonly RESPONSE: "response";
+    readonly RETRY: "retry";
+    readonly REVALIDATION: "revalidation";
+    readonly POLLING: "polling";
+    readonly INITIALIZATION: "initialization";
+    readonly CONFIGURATION: "configuration";
+    readonly PRESET_LOOKUP: "preset-lookup";
+    readonly REGIONAL_DETECTION: "regional-detection";
+    readonly STRATEGY_EXECUTION: "strategy-execution";
+    readonly FALLBACK: "fallback";
+    readonly SUBSCRIPTION: "subscription";
+    readonly PUBLICATION: "publication";
+    readonly EVENT_HANDLING: "event-handling";
+    readonly DEBUG: "debug";
+    readonly DEBUG_TRACKING: "debug-tracking";
+    readonly TRACKING: "tracking";
+    readonly MONITORING: "monitoring";
+    readonly NETWORK_CHECK: "network-check";
+    readonly ENDPOINT_BUILD: "endpoint-build";
+    readonly CONTEXT_SETUP: "context-setup";
+    readonly SEND: "send";
+    readonly RENDER: "render";
+    readonly QUEUE: "queue";
+    readonly PROCESS: "process";
+};
+/**
+ * Common field names used in error context
+ * These are optional helpers - you can use any freeform string in context.field
+ *
+ * @example
+ * ```typescript
+ * import { COMMON_FIELDS } from '@plyaz/types';
+ *
+ * const context = { field: COMMON_FIELDS.EMAIL };
+ * // Or just use a string:
+ * const context2 = { field: 'customField' };
+ * ```
+ */
+export declare const COMMON_FIELDS: {
+    readonly STORAGE: "storage";
+    readonly CACHE: "cache";
+    readonly CONFIG: "config";
+    readonly PRESET_NAME: "presetName";
+    readonly PRESET_ID: "presetId";
+    readonly HEADERS: "headers";
+    readonly URL: "url";
+    readonly METHOD: "method";
+    readonly STRATEGY: "strategy";
+    readonly RETRY_COUNT: "retryCount";
+    readonly MAX_RETRIES: "maxRetries";
+    readonly POLLING_INTERVAL: "pollingInterval";
+    readonly TOPIC: "topic";
+    readonly CHANNEL: "channel";
+    readonly ENDPOINT: "endpoint";
+    readonly CLIENT: "client";
+    readonly NETWORK_TYPE: "networkType";
+    readonly TIME_INTERVAL: "timeInterval";
+    readonly EMAIL: "email";
+    readonly PHONE: "phoneNumber";
+    readonly RECIPIENT: "recipient";
+    readonly TEMPLATE: "template";
+    readonly PROVIDER: "provider";
+};
+/**
+ * Common storage type names
+ * These are optional helpers - you can use any freeform string in context.storageType
+ *
+ * @example
+ * ```typescript
+ * import { COMMON_STORAGE_TYPES } from '@plyaz/types';
+ *
+ * const context = { storageType: COMMON_STORAGE_TYPES.REDIS };
+ * // Or just use a string:
+ * const context2 = { storageType: 'custom-storage' };
+ * ```
+ */
+export declare const COMMON_STORAGE_TYPES: {
+    readonly PRIMARY: "primary";
+    readonly FALLBACK: "fallback";
+    readonly MEMORY: "memory";
+    readonly SESSION: "session";
+    readonly LOCAL: "local";
+    readonly REDIS: "redis";
+    readonly DATABASE: "database";
+};