@plyaz/api 1.0.2 → 1.1.1

package/dist/api/events/factories/base.d.ts

@@ -0,0 +1,269 @@
+/**
+ * Base Event Factory
+ * Abstract base class for all event factories providing common functionality
+ */
+import type { EventScope, HandlerStrategy, EventScopeWithTemporary, BaseEvent, EventOptions, HandlerOptions } from '@plyaz/types/api';
+import type { EventEmitter } from '../../pubsub';
+/**
+ * Abstract base class for event factories
+ * Provides common functionality for creating and emitting events
+ */
+export declare abstract class BaseEventFactory<TNamespace extends string> {
+    protected readonly emitter: EventEmitter;
+    protected readonly namespace: TNamespace;
+    readonly scope: string;
+    private scopedHandlers;
+    private originalHandlers;
+    constructor(namespace: TNamespace, emitter: EventEmitter);
+    /**
+     * Track factory operations using the queue pattern
+     * This avoids circular dependency and ensures all operations are captured
+     */
+    private trackFactoryOperation;
+    /**
+     * Generic emit method that works with any event string
+     * Intelligently routes through scope system if applicable
+     */
+    emit<T = unknown>(event: string, data?: T): void;
+    /**
+     * Direct off method that works with any event string
+     * This is what EventManager inherits and uses
+     */
+    off(event: string, handler?: Function): void;
+    /**
+     * Direct removeAllListeners that works with any event string
+     * This is what EventManager inherits and uses
+     */
+    removeAllListeners(event?: string): void;
+    /**
+     * Direct listeners method that works with any event string
+     * This is what EventManager inherits and uses
+     */
+    listeners(event: string): Function[];
+    /**
+     * Direct listenerCount that works with any event string
+     * This is what EventManager inherits and uses
+     */
+    listenerCount(event: string): number;
+    /**
+     * Create base event structure
+     */
+    protected createBaseEvent(type: string, source?: string): BaseEvent;
+    /**
+     * Emit an event to the shared emitter
+     * When used through EventManager, respects its configured scopes
+     */
+    protected emitEvent<T extends BaseEvent>(event: T): void;
+    /**
+     * Create namespaced event key
+     */
+    protected createEventKey(eventName: string): string;
+    /**
+     * Validate event data before creation
+     * Can be overridden by subclasses for specific validation
+     */
+    protected validateEventData(data: unknown): void;
+    /**
+     * Create and optionally emit an event
+     */
+    protected createAndEmit<T extends BaseEvent>(event: T, options?: EventOptions): T;
+    /**
+     * Public emit method for testing purposes
+     * In production, use the specific emit methods on each factory
+     */
+    emitGeneric(eventNameOrType: string, data?: unknown): void;
+    /**
+     * Emit events across all configured scopes with proper priority order
+     * Ensures handlers at all scopes are called in the correct order
+     *
+     * @param eventType - The type of event (e.g., 'error', 'debug', 'headers', 'network')
+     * @param eventName - The specific event name (e.g., 'onNetworkError', 'conflict', 'changed')
+     * @param data - The event data
+     * @param scopes - Optional scopes to emit to (defaults to all scopes)
+     *
+     * Priority order (lowest to highest):
+     * 1. GLOBAL - App-wide handlers
+     * 2. CONFIG - Configuration-level handlers
+     * 3. CLIENT - Instance-specific handlers
+     * 4. REQUEST/TEMPORARY - Request-level handlers (highest priority)
+     *
+     * This method emits:
+     * - Scoped specific events (e.g., global:headers:changed)
+     * - Scoped wildcard events (e.g., global:headers:*)
+     * - Non-scoped events for backwards compatibility (e.g., headers:changed)
+     * - Non-scoped wildcards for backwards compatibility (e.g., headers:*)
+     */
+    emitAcrossScopes(eventType: string, eventName: string, data: unknown, scopes?: EventScopeWithTemporary[]): void;
+    /**
+     * Subscribe to events in this namespace
+     */
+    on<T = unknown>(eventName: string, handler: (data: T) => void): () => void;
+    /**
+     * Subscribe to all events in this namespace
+     */
+    onAny<T = unknown>(handler: (data: T) => void): () => void;
+    /**
+     * Subscribe once to events in this namespace
+     * Handler will be automatically removed after first execution
+     */
+    once<T = unknown>(eventName: string, handler: (data: T) => void): () => void;
+    /**
+     * Subscribe to scoped events in this namespace
+     * This listens to events emitted via emitAcrossScopes for a specific scope
+     *
+     * @param scope - The scope to listen to ('global', 'config', 'client', 'request')
+     * @param eventName - The event name (e.g., 'validation', 'network', '*')
+     * @param handler - The event handler
+     */
+    onScoped<T = unknown>(scope: EventScope, eventName: string, handler: (data: T) => void): () => void;
+    /**
+     * Subscribe once to scoped events in this namespace
+     * Handler will be automatically removed after first execution
+     *
+     * @param scope - The scope to listen to ('global', 'config', 'client', 'request')
+     * @param eventName - The event name (e.g., 'validation', 'network', '*')
+     * @param handler - The event handler
+     */
+    onceScoped<T = unknown>(scope: EventScope, eventName: string, handler: (data: T) => void): () => void;
+    /**
+     * Apply handler strategy to determine final handler list
+     */
+    private applyHandlerStrategy;
+    /**
+     * Register handlers with the emitter based on strategy
+     */
+    private registerHandlersWithEmitter;
+    /**
+     * Create unsubscribe function for handler
+     */
+    private createHandlerUnsubscribe;
+    /**
+     * Add multiple handlers to a scoped event (for chaining)
+     * This is used when multiple handlers need to be called for the same event
+     *
+     * @param scope - The scope to listen to ('global', 'config', 'client', 'request')
+     * @param eventName - The event name (e.g., 'validation', 'network', '*')
+     * @param handler - The event handler to add
+     * @param options - Options for handler registration including strategy and originalHandler
+     */
+    addScopedHandler<T = unknown>(scope: EventScope, eventName: string, handler: (data: T) => void, options?: HandlerOptions & {
+        originalHandler?: (data: T) => void;
+    }): () => void;
+    /**
+     * Remove all listeners for a scoped event
+     *
+     * @param scope - The scope to clear ('global', 'config', 'client', 'request')
+     * @param eventName - The event name (e.g., 'validation', 'network', '*')
+     */
+    removeAllScopedListeners(scope: EventScope, eventName?: string): void;
+    /**
+     * Subscribe once to all events in this namespace
+     * Handler will be automatically removed after first execution of any event
+     */
+    onceAny<T = unknown>(handler: (data: T) => void): () => void;
+    /**
+     * Unsubscribe from events in this namespace (namespace-aware)
+     * Use this for factory-specific events
+     */
+    offNamespaced(eventName: string, handler?: (data: unknown) => void): void;
+    /**
+     * Unsubscribe from all events in this namespace
+     */
+    offAny(handler?: (data: unknown) => void): void;
+    /**
+     * Remove all handlers for an event in this namespace (namespace-aware)
+     * Use this for factory-specific events
+     */
+    removeAllListenersNamespaced(eventName?: string): void;
+    /**
+     * Get all listeners for an event in this namespace (namespace-aware)
+     * Use this for factory-specific events
+     */
+    listenersNamespaced(eventName: string): Function[];
+    /**
+     * Get listener count for an event in this namespace (namespace-aware)
+     * Use this for factory-specific events
+     */
+    listenerCountNamespaced(eventName: string): number;
+    /**
+     * Get the namespace for this factory
+     */
+    getNamespace(): string;
+    /**
+     * Get all handlers for a specific scope
+     * @param scope - The scope to get handlers for
+     * @returns Map of event names to handlers
+     */
+    getScopedHandlers(scope: EventScope): Map<string, Array<(data: unknown) => void>>;
+    /**
+     * Get handlers for a specific scope and event
+     * @param scope - The scope to get handlers for
+     * @param eventName - The event name
+     * @returns Array of handlers for the event
+     */
+    getScopedEventHandlers(scope: EventScope, eventName: string): Array<(data: unknown) => void>;
+    /**
+     * Get original handlers for a specific scope (before wrapping)
+     * @param scope - The scope to get handlers for
+     * @returns Map of event names to original handlers
+     */
+    getOriginalScopedHandlers(scope: EventScope): Map<string, Array<(data: unknown) => void>>;
+    /**
+     * Get original handlers for a specific scope and event (before wrapping)
+     * @param scope - The scope to get handlers for
+     * @param eventName - The event name
+     * @returns Array of original handlers for the event
+     */
+    getOriginalScopedEventHandlers(scope: EventScope, eventName: string): Array<(data: unknown) => void>;
+    /**
+     * Clear all handlers for a specific scope
+     * @param scope - The scope to clear
+     */
+    clearScopedHandlers(scope: EventScope): void;
+    /**
+     * Merge handlers from multiple scopes using the event emitter's merge logic
+     * Follows precedence: global → client → request (request has highest priority)
+     * This is used for event handlers that need to be chained together
+     *
+     * @param global - Global scope handler(s)
+     * @param client - Client scope handler(s)
+     * @param request - Request scope handler(s)
+     * @returns The first merged handler or undefined
+     */
+    mergeHandlerGroup<T>(global?: T, client?: T, request?: T): T | T[] | undefined;
+    /**
+     * Merge handlers with explicit priority handling
+     * Used for config override strategies where the highest priority wins
+     * Priority order: request > client > config > global
+     *
+     * @param global - Global scope handler(s)
+     * @param config - Config scope handler(s)
+     * @param client - Client scope handler(s)
+     * @param request - Request scope handler(s)
+     * @returns Merged handler(s) based on priority
+     */
+    mergeHandlersByPriority<T>(global?: T, config?: T, client?: T, request?: T): T | undefined;
+    /**
+     * Main handler merging method that respects handler strategy and priority
+     * This is the primary entry point for all handler merging operations
+     *
+     * @param options - Options containing strategy, usePriority, and handlers
+     * @returns Merged handler(s) based on the strategy and priority setting
+     */
+    mergeHandlers<T extends object | Function | undefined>(options: {
+        strategy: HandlerStrategy;
+        usePriority: boolean;
+        global?: T;
+        client?: T;
+        request?: T;
+    }): T | undefined;
+    /**
+     * Check if a value is a handler object (has function properties)
+     */
+    private isHandlerObject;
+    /**
+     * Merge handler objects by merging individual properties
+     */
+    private mergeHandlerObjects;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/api/events/factories/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/api/events/factories/base.ts"],"names":[],"mappings":"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"}

package/dist/api/events/factories/cache.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Cache Event Factory
+ * Creates and emits cache-related events with type safety
+ */
+import type { CacheHitEvent, CacheMissEvent, CacheInvalidateEvent, EventOptions, EmitInvalidateOptions, EmitHitOptions } from '@plyaz/types/api';
+import { BaseEventFactory } from './base';
+import type { EventEmitter } from '../../pubsub';
+/**
+ * Cache Event Factory
+ */
+export declare class CacheEventFactory extends BaseEventFactory<'cache'> {
+    constructor(emitter: EventEmitter);
+    /**
+     * Emit cache hit event
+     */
+    emitHit(key: string, options?: EmitHitOptions): CacheHitEvent;
+    /**
+     * Emit cache miss event
+     */
+    emitMiss(key: string, reason?: 'not_found' | 'expired' | 'disabled', options?: EventOptions): CacheMissEvent;
+    /**
+     * Emit cache invalidate event
+     */
+    emitInvalidate(options?: EmitInvalidateOptions): CacheInvalidateEvent;
+}
+/**
+ * Get singleton cache event factory
+ * @param emitter - The event emitter to use (optional, defaults to shared emitter)
+ */
+export declare function getCacheEventFactory(emitter?: EventEmitter): CacheEventFactory;
+//# sourceMappingURL=cache.d.ts.map

package/dist/api/events/factories/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../../src/api/events/factories/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,gBAAgB,CAAC,OAAO,CAAC;gBAClD,OAAO,EAAE,YAAY;IAIjC;;OAEG;IACI,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,aAAa;IAgBxE;;OAEG;IACI,QAAQ,CACb,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,UAAU,EAC7C,OAAO,GAAE,YAAiB,GACzB,cAAc;IAajB;;OAEG;IACI,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,oBAAoB;CAejF;AAID;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,iBAAiB,CAI9E"}

package/dist/api/events/factories/client.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Client Event Factory
+ * Creates and emits client-related events with type safety
+ */
+import type { ClientConflictEvent, ClientDebugEvent, ClientCreatedEvent, RequestStartEvent, ResponseReceivedEvent, RetryAttemptEvent, EmitRetryAttemptOptions, EmitResponseReceivedOptions, EventOptions, ConfigConflict, DebugInfo } from '@plyaz/types/api';
+import { BaseEventFactory } from './base';
+import type { EventEmitter } from '../../pubsub';
+/**
+ * Factory for creating client events
+ */
+export declare class ClientEventFactory extends BaseEventFactory<'client'> {
+    constructor(emitter: EventEmitter);
+    /**
+     * Emit client conflict event
+     */
+    emitConflict(conflict: ConfigConflict, options?: EventOptions): ClientConflictEvent;
+    /**
+     * Emit client debug event
+     */
+    emitDebug(debugInfo: DebugInfo, options?: EventOptions): ClientDebugEvent;
+    /**
+     * Emit client created event
+     */
+    emitCreated(clientId: string, config: Record<string, unknown>, options?: EventOptions): ClientCreatedEvent;
+    /**
+     * Emit request start event
+     */
+    emitRequestStart(url?: string, method?: string, options?: EventOptions): RequestStartEvent;
+    /**
+     * Emit response received event
+     */
+    emitResponseReceived(options?: EmitResponseReceivedOptions): ResponseReceivedEvent;
+    /**
+     * Emit retry attempt event
+     */
+    emitRetryAttempt(options: EmitRetryAttemptOptions): RetryAttemptEvent;
+}
+/**
+ * Get singleton client event factory
+ * @param emitter - The event emitter to use (optional, defaults to shared emitter)
+ */
+export declare function getClientEventFactory(emitter?: EventEmitter): ClientEventFactory;
+//# sourceMappingURL=client.d.ts.map

package/dist/api/events/factories/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/api/events/factories/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,2BAA2B,EAC3B,YAAY,EACZ,cAAc,EACd,SAAS,EACV,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,gBAAgB,CAAC,QAAQ,CAAC;gBACpD,OAAO,EAAE,YAAY;IAIjC;;OAEG;IACI,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,GAAE,YAAiB,GAAG,mBAAmB;IAU9F;;OAEG;IACI,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,GAAE,YAAiB,GAAG,gBAAgB;IAUpF;;OAEG;IACI,WAAW,CAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,GAAE,YAAiB,GACzB,kBAAkB;IAarB;;OAEG;IACI,gBAAgB,CACrB,GAAG,CAAC,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB,GACzB,iBAAiB;IAcpB;;OAEG;IACI,oBAAoB,CAAC,OAAO,GAAE,2BAAgC,GAAG,qBAAqB;IAiB7F;;OAEG;IACI,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,iBAAiB;CAiB7E;AAID;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,kBAAkB,CAIhF"}

package/dist/api/events/factories/config.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Config Event Factory
+ * Creates and emits config-related events with type safety
+ */
+import type { ConfigGlobalUpdatedEvent, ConfigGlobalResetEvent, ConfigEnvironmentEvent, ConfigPresetAppliedEvent, DebuggerConfigSource, ApiConfig, EventOptions, EmitGlobalUpdatedOptions } from '@plyaz/types/api';
+import { BaseEventFactory } from './base';
+import type { EventEmitter } from '../../pubsub';
+/**
+ * Configuration Event Factory
+ */
+export declare class ConfigEventFactory extends BaseEventFactory<'config'> {
+    constructor(emitter: EventEmitter);
+    /**
+     * Emit global config updated event
+     */
+    emitGlobalUpdated(options: EmitGlobalUpdatedOptions): ConfigGlobalUpdatedEvent;
+    /**
+     * Emit global config reset event
+     */
+    emitGlobalReset(previous: ApiConfig, defaults: ApiConfig, source: DebuggerConfigSource, options?: EventOptions): ConfigGlobalResetEvent;
+    /**
+     * Emit environment configured event
+     */
+    emitEnvironmentConfigured(environment: string, config: ApiConfig, source: DebuggerConfigSource, options?: EventOptions): ConfigEnvironmentEvent;
+    /**
+     * Emit preset applied event
+     */
+    emitPresetApplied(presetName: string, config: ApiConfig, source: DebuggerConfigSource, options?: EventOptions): ConfigPresetAppliedEvent;
+}
+/**
+ * Get singleton config event factory
+ */
+export declare function getConfigEventFactory(emitter?: EventEmitter): ConfigEventFactory;
+//# sourceMappingURL=config.d.ts.map

package/dist/api/events/factories/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/api/events/factories/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,SAAS,EACT,YAAY,EACZ,wBAAwB,EACzB,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,gBAAgB,CAAC,QAAQ,CAAC;gBACpD,OAAO,EAAE,YAAY;IAIjC;;OAEG;IACI,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,wBAAwB;IAgBrF;;OAEG;IACI,eAAe,CACpB,QAAQ,EAAE,SAAS,EACnB,QAAQ,EAAE,SAAS,EACnB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE,YAAiB,GACzB,sBAAsB;IAczB;;OAEG;IACI,yBAAyB,CAC9B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE,YAAiB,GACzB,sBAAsB;IAczB;;OAEG;IACI,iBAAiB,CACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE,YAAiB,GACzB,wBAAwB;CAa5B;AAID;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,kBAAkB,CAIhF"}

package/dist/api/events/factories/debug.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Debug Event Factory
+ * Creates and emits debug-related events with type safety
+ */
+import type { ConfigConflictEvent, ConfigChangeEvent, HeadersTrackedEvent, NetworkOverrideEvent, DebugInfoUpdateEvent, PerformanceImpactEvent, MonitoringAlertEvent, ConfigTrackingEvent, EmitConfigChangeOptions, EmitConfigTrackedOptions, ConfigConflict, DebugInfo, ActiveOverride, PerformanceImpact, MonitoringAlert, EventOptions, EmitHeadersTrackedOptions, BaseEvent } from '@plyaz/types/api';
+import type { EventEmitter } from '../../pubsub';
+import { BaseEventFactory } from './base';
+/**
+ * Factory for creating debug events
+ */
+export declare class DebugEventFactory extends BaseEventFactory<'debug'> {
+    constructor(emitter: EventEmitter);
+    /**
+     * Create and emit a config conflict event
+     */
+    emitConfigConflict(conflict: ConfigConflict, options?: EventOptions): ConfigConflictEvent;
+    /**
+     * Create and emit a config change event
+     */
+    emitConfigChange(options: EmitConfigChangeOptions): ConfigChangeEvent;
+    /**
+     * Create and emit a headers tracked event
+     */
+    emitHeadersTracked(options: EmitHeadersTrackedOptions): HeadersTrackedEvent;
+    /**
+     * Create and emit a network override event
+     */
+    emitNetworkOverride(overrides: ActiveOverride[], reason: string, temporary?: boolean, options?: EventOptions): NetworkOverrideEvent;
+    /**
+     * Create and emit a debug info update event
+     */
+    emitDebugInfoUpdate(debugInfo: DebugInfo, options?: EventOptions): DebugInfoUpdateEvent;
+    /**
+     * Create and emit a debug info event (alias for emitDebugInfoUpdate)
+     */
+    emitDebugInfo(debugInfo: DebugInfo, options?: EventOptions): DebugInfoUpdateEvent;
+    /**
+     * Create and emit a performance impact event
+     */
+    emitPerformanceImpact(impact: PerformanceImpact, source: 'network' | 'config' | 'strategy' | 'adaptive', recommendation?: string, options?: EventOptions): PerformanceImpactEvent;
+    /**
+     * Create and emit a monitoring alert event
+     */
+    emitMonitoringAlert(alert: MonitoringAlert, options?: EventOptions): MonitoringAlertEvent;
+    /**
+     * Create and emit a config tracking event
+     */
+    emitConfigTracked(options: EmitConfigTrackedOptions): ConfigTrackingEvent;
+    /**
+     * Create and emit a network state changed event
+     */
+    emitNetworkStateChanged(enabled: boolean, options?: EventOptions): BaseEvent;
+    /**
+     * Create and emit a network data cleared event
+     */
+    emitNetworkDataCleared(options?: EventOptions): BaseEvent;
+    /**
+     * Create and emit a batch of config conflicts
+     */
+    emitConflictsBatch(conflicts: ConfigConflict[], options?: EventOptions): void;
+    /**
+     * Emit event operation for UnifiedDebugger event tracking
+     */
+    emitEventOperation(operation: string, event: string, metadata: {
+        source?: 'pubsub' | 'eventManager' | 'clientEventManager' | 'factory' | 'config';
+        module?: string;
+        [key: string]: unknown;
+    }, options?: EventOptions): BaseEvent;
+    /**
+     * Summarize conflicts for reporting
+     */
+    private summarizeConflicts;
+}
+//# sourceMappingURL=debug.d.ts.map

package/dist/api/events/factories/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../../../src/api/events/factories/debug.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,yBAAyB,EACzB,SAAS,EACV,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAE1C;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,gBAAgB,CAAC,OAAO,CAAC;gBAClD,OAAO,EAAE,YAAY;IAIjC;;OAEG;IACI,kBAAkB,CACvB,QAAQ,EAAE,cAAc,EACxB,OAAO,GAAE,YAAiB,GACzB,mBAAmB;IAUtB;;OAEG;IACI,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,iBAAiB;IAiB5E;;OAEG;IACI,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,mBAAmB;IAkBlF;;OAEG;IACI,mBAAmB,CACxB,SAAS,EAAE,cAAc,EAAE,EAC3B,MAAM,EAAE,MAAM,EACd,SAAS,UAAQ,EACjB,OAAO,GAAE,YAAiB,GACzB,oBAAoB;IAcvB;;OAEG;IACI,mBAAmB,CACxB,SAAS,EAAE,SAAS,EACpB,OAAO,GAAE,YAAiB,GACzB,oBAAoB;IAUvB;;OAEG;IACI,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,GAAE,YAAiB,GAAG,oBAAoB;IAI5F;;OAEG;IACI,qBAAqB,CAC1B,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,EACtD,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,GAAE,YAAiB,GACzB,sBAAsB;IAczB;;OAEG;IACI,mBAAmB,CACxB,KAAK,EAAE,eAAe,EACtB,OAAO,GAAE,YAAiB,GACzB,oBAAoB;IAUvB;;OAEG;IACI,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,mBAAmB;IAgBhF;;OAEG;IACI,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,YAAiB,GAAG,SAAS;IAavF;;OAEG;IACI,sBAAsB,CAAC,OAAO,GAAE,YAAiB,GAAG,SAAS;IAYpE;;OAEG;IACI,kBAAkB,CAAC,SAAS,EAAE,cAAc,EAAE,EAAE,OAAO,GAAE,YAAiB,GAAG,IAAI;IAiBxF;;OAEG;IACI,kBAAkB,CACvB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE;QACR,MAAM,CAAC,EAAE,QAAQ,GAAG,cAAc,GAAG,oBAAoB,GAAG,SAAS,GAAG,QAAQ,CAAC;QACjF,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,EACD,OAAO,GAAE,YAAiB,GACzB,SAAS;IAeZ;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAkB3B"}

package/dist/api/events/factories/errors.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Errors Event Factory
+ * Creates and emits errors-related events with type safety
+ */
+import type { ErrorEvent, GenericErrorEvent, NetworkErrorEvent, ValidationErrorEvent, AuthenticationErrorEvent, AuthorizationErrorEvent, NotFoundErrorEvent, ConflictErrorEvent, ClientErrorEvent, ServerErrorEvent, TimeoutErrorEvent, RateLimitErrorEvent, CacheErrorEvent, HeadersErrorEvent, RetryErrorEvent, ExternalServiceErrorEvent, EventOptions, EmitNetworkErrorOptions, EmitValidationErrorOptions, EmitRateLimitErrorOptions, EmitServerErrorOptions, EmitTimeoutErrorOptions, EmitAuthorizationErrorOptions, EmitConflictErrorOptions, EmitClientErrorOptions, EmitExternalServiceErrorOptions, EmitRetryErrorOptions } from '@plyaz/types/api';
+import { BaseEventFactory } from './base';
+import type { EventEmitter } from '../../pubsub';
+import type { ApiPackageErrorLike } from '@plyaz/types/api';
+/**
+ * Factory for creating error events
+ */
+export declare class ErrorEventFactory extends BaseEventFactory<'errors'> {
+    constructor(emitter: EventEmitter);
+    /**
+     * Create and emit a generic error event
+     */
+    emitGenericError(error: ApiPackageErrorLike, options?: EventOptions): GenericErrorEvent;
+    /**
+     * Create and emit a network error event
+     */
+    emitNetworkError(options: EmitNetworkErrorOptions): NetworkErrorEvent;
+    /**
+     * Create and emit a validation error event
+     */
+    emitValidationError(options: EmitValidationErrorOptions): ValidationErrorEvent;
+    /**
+     * Create and emit an authentication error event
+     */
+    emitAuthenticationError(error: ApiPackageErrorLike, realm?: string, scheme?: string, options?: EventOptions): AuthenticationErrorEvent;
+    /**
+     * Create and emit a rate limit error event
+     */
+    emitRateLimitError(options: EmitRateLimitErrorOptions): RateLimitErrorEvent;
+    /**
+     * Create and emit a server error event
+     */
+    emitServerError(options: EmitServerErrorOptions): ServerErrorEvent;
+    /**
+     * Create and emit a timeout error event
+     */
+    emitTimeoutError(options: EmitTimeoutErrorOptions): TimeoutErrorEvent;
+    /**
+     * Create and emit an authorization error event
+     */
+    emitAuthorizationError(options: EmitAuthorizationErrorOptions): AuthorizationErrorEvent;
+    /**
+     * Create and emit a not found error event
+     */
+    emitNotFoundError(error: ApiPackageErrorLike, url?: string, resource?: string, options?: EventOptions): NotFoundErrorEvent;
+    /**
+     * Create and emit a conflict error event
+     */
+    emitConflictError(options: EmitConflictErrorOptions): ConflictErrorEvent;
+    /**
+     * Create and emit a client error event
+     */
+    emitClientError(options: EmitClientErrorOptions): ClientErrorEvent;
+    /**
+     * Create and emit an external service error event
+     */
+    emitExternalServiceError(options: EmitExternalServiceErrorOptions): ExternalServiceErrorEvent;
+    /**
+     * Create and emit a cache error event
+     */
+    emitCacheError(error: ApiPackageErrorLike, operation?: string, key?: string, options?: EventOptions): CacheErrorEvent;
+    /**
+     * Create and emit a headers error event
+     */
+    emitHeadersError(error: ApiPackageErrorLike, header?: string, operation?: string, options?: EventOptions): HeadersErrorEvent;
+    /**
+     * Create and emit a retry error event
+     */
+    emitRetryError(options: EmitRetryErrorOptions): RetryErrorEvent;
+    /**
+     * Emit error based on category
+     */
+    emitByCategory(error: ApiPackageErrorLike, additionalData?: Record<string, unknown>, options?: EventOptions): ErrorEvent;
+    /**
+     * Create and emit a strategy error event
+     */
+    emitStrategyError(error: ApiPackageErrorLike, strategy: string, reason?: string, options?: EventOptions): ErrorEvent;
+    /**
+     * Create and emit a regional error event
+     */
+    emitRegionalError(error: ApiPackageErrorLike, region: string, fallbackRegion?: string, options?: EventOptions): ErrorEvent;
+    /**
+     * Create and emit an unknown error event
+     */
+    emitUnknownError(error: ApiPackageErrorLike, originalError?: unknown, context?: Record<string, unknown>, options?: EventOptions): ErrorEvent;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/api/events/factories/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/api/events/factories/errors.ts"],"names":[],"mappings":"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"}

package/dist/api/events/factories/headers.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Header Event Factory
+ * Creates and emits header-related events with type safety
+ */
+import type { HeadersChangedEvent, HeadersEnrichedEvent, HeadersConflictEvent, HeadersOverrideEvent, HeadersMergedEvent, HeadersFilteredEvent, HeadersCachedEvent, HeadersCacheHitEvent, HeadersCacheMissEvent, ApiHeaders, EventOptions, EmitConflictOptions, EmitChangedOptions, EmitEnrichedOptions, EmitOverrideOptions, EmitMergedOptions, EmitFilteredOptions, EmitCachedOptions } from '@plyaz/types/api';
+import { BaseEventFactory } from './base';
+/**
+ * Factory for creating header events
+ */
+import type { EventEmitter } from '../../pubsub';
+export declare class HeaderEventFactory extends BaseEventFactory<'headers'> {
+    constructor(emitter: EventEmitter);
+    /**
+     * Create and emit a headers changed event
+     */
+    emitChanged(options: EmitChangedOptions): HeadersChangedEvent;
+    /**
+     * Create and emit a headers enriched event
+     */
+    emitEnriched(options: EmitEnrichedOptions): HeadersEnrichedEvent;
+    /**
+     * Create and emit a headers conflict event
+     */
+    emitConflict(options: EmitConflictOptions): HeadersConflictEvent;
+    /**
+     * Create and emit a headers override event
+     */
+    emitOverride(options: EmitOverrideOptions): HeadersOverrideEvent;
+    /**
+     * Create and emit a headers merged event
+     */
+    emitMerged(options: EmitMergedOptions): HeadersMergedEvent;
+    /**
+     * Create and emit a headers filtered event
+     */
+    emitFiltered(options: EmitFilteredOptions): HeadersFilteredEvent;
+    /**
+     * Create and emit a headers cached event
+     */
+    emitCached(options: EmitCachedOptions): HeadersCachedEvent;
+    /**
+     * Create and emit a headers cache hit event
+     */
+    emitCacheHit(key: string, headers: ApiHeaders, options?: EventOptions): HeadersCacheHitEvent;
+    /**
+     * Create and emit a headers cache miss event
+     */
+    emitCacheMiss(key: string, options?: EventOptions): HeadersCacheMissEvent;
+    /**
+     * Detect changes between two header sets
+     */
+    private detectChanges;
+}
+//# sourceMappingURL=headers.d.ts.map

package/dist/api/events/factories/headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../../../../src/api/events/factories/headers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAE1C;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,qBAAa,kBAAmB,SAAQ,gBAAgB,CAAC,SAAS,CAAC;gBACrD,OAAO,EAAE,YAAY;IAIjC;;OAEG;IACI,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,mBAAmB;IAmBpE;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,oBAAoB;IAmBvE;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,oBAAoB;IAgBvE;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,oBAAoB;IA0BvE;;OAEG;IACI,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,kBAAkB;IAsBjE;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,oBAAoB;IAmBvE;;OAEG;IACI,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,kBAAkB;IAgBjE;;OAEG;IACI,YAAY,CACjB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,UAAU,EACnB,OAAO,GAAE,YAAiB,GACzB,oBAAoB;IAevB;;OAEG;IACI,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,qBAAqB;IAepF;;OAEG;IACH,OAAO,CAAC,aAAa;CAuBtB"}