@plyaz/types 1.7.18 → 1.7.20

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

@@ -0,0 +1,293 @@
+/**
+ * Error Event Factory
+ * Creates and emits error-related events with type safety
+ */
+import { type BaseEvent, type EventOptions } from '..';
+import type { ApiPackageErrorLike } from '../../../errors';
+import type { ERROR_CATEGORY } from '../../../../errors';
+import type { ERROR_EVENTS } from '../..';
+/**
+ * Base structure for error events
+ */
+export interface ErrorEvent extends BaseEvent {
+    type: string;
+    data: unknown;
+}
+/**
+ * Generic error event
+ */
+export interface GenericErrorEvent extends BaseEvent {
+    type: typeof ERROR_EVENTS.GENERIC_ERROR;
+    data: {
+        error: ApiPackageErrorLike;
+        category: typeof ERROR_CATEGORY | string;
+        code: string;
+        message: string;
+        context?: Record<string, unknown>;
+    };
+}
+/**
+ * Network error event
+ */
+export interface NetworkErrorEvent extends BaseEvent {
+    type: typeof ERROR_EVENTS.NETWORK_ERROR;
+    data: {
+        error: ApiPackageErrorLike;
+        code: string;
+        message: string;
+        url?: string;
+        method?: string;
+        status?: number;
+        retryable?: boolean;
+    };
+}
+/**
+ * Validation error event
+ */
+export interface ValidationErrorEvent extends BaseEvent {
+    type: typeof ERROR_EVENTS.VALIDATION_ERROR;
+    data: {
+        error: ApiPackageErrorLike;
+        code: string;
+        message: string;
+        field?: string;
+        value?: unknown;
+        constraints?: Record<string, string>;
+    };
+}
+/**
+ * Authentication error event
+ */
+export interface AuthenticationErrorEvent extends BaseEvent {
+    type: typeof ERROR_EVENTS.AUTHENTICATION_ERROR;
+    data: {
+        error: ApiPackageErrorLike;
+        code: string;
+        message: string;
+        realm?: string;
+        scheme?: string;
+    };
+}
+/**
+ * Rate limit error event
+ */
+export interface RateLimitErrorEvent extends BaseEvent {
+    type: typeof ERROR_EVENTS.RATE_LIMIT_ERROR;
+    data: {
+        error: ApiPackageErrorLike;
+        code: string;
+        message: string;
+        limit?: number;
+        remaining?: number;
+        resetAt?: string;
+        retryAfter?: number;
+    };
+}
+/**
+ * Server error event
+ */
+export interface ServerErrorEvent extends BaseEvent {
+    type: typeof ERROR_EVENTS.SERVER_ERROR;
+    data: {
+        error: ApiPackageErrorLike;
+        code: string;
+        message: string;
+        status: number;
+        serverMessage?: string;
+        traceId?: string;
+    };
+}
+/**
+ * Timeout error event
+ */
+export interface TimeoutErrorEvent extends BaseEvent {
+    type: typeof ERROR_EVENTS.TIMEOUT_ERROR;
+    data: {
+        error: ApiPackageErrorLike;
+        code: string;
+        message: string;
+        timeoutMs: number;
+        operation?: string;
+        url?: string;
+    };
+}
+/**
+ * Authorization error event
+ */
+export interface AuthorizationErrorEvent extends BaseEvent {
+    type: typeof ERROR_EVENTS.AUTHORIZATION_ERROR;
+    data: {
+        error: ApiPackageErrorLike;
+        code: string;
+        message: string;
+        url?: string;
+        method?: string;
+        resource?: string;
+        permission?: string;
+    };
+}
+/**
+ * Not found error event
+ */
+export interface NotFoundErrorEvent extends BaseEvent {
+    type: typeof ERROR_EVENTS.NOT_FOUND_ERROR;
+    data: {
+        error: ApiPackageErrorLike;
+        code: string;
+        message: string;
+        url?: string;
+        resource?: string;
+    };
+}
+/**
+ * Conflict error event
+ */
+export interface ConflictErrorEvent extends BaseEvent {
+    type: typeof ERROR_EVENTS.CONFLICT_ERROR;
+    data: {
+        error: ApiPackageErrorLike;
+        code: string;
+        message: string;
+        conflictingResource?: string;
+        currentValue?: unknown;
+        attemptedValue?: unknown;
+    };
+}
+/**
+ * Client error event
+ */
+export interface ClientErrorEvent extends BaseEvent {
+    type: typeof ERROR_EVENTS.CLIENT_ERROR;
+    data: {
+        error: ApiPackageErrorLike;
+        code: string;
+        message: string;
+        status: number;
+        url?: string;
+        method?: string;
+    };
+}
+/**
+ * External service error event
+ */
+export interface ExternalServiceErrorEvent extends BaseEvent {
+    type: typeof ERROR_EVENTS.EXTERNAL_SERVICE_ERROR;
+    data: {
+        error: ApiPackageErrorLike;
+        code: string;
+        message: string;
+        service?: string;
+        endpoint?: string;
+        timeout?: number;
+    };
+}
+/**
+ * Cache error event
+ */
+export interface CacheErrorEvent extends BaseEvent {
+    type: typeof ERROR_EVENTS.CACHE_ERROR;
+    data: {
+        error: ApiPackageErrorLike;
+        code: string;
+        message: string;
+        operation?: string;
+        key?: string;
+    };
+}
+/**
+ * Headers error event
+ */
+export interface HeadersErrorEvent extends BaseEvent {
+    type: typeof ERROR_EVENTS.HEADERS_ERROR;
+    data: {
+        error: ApiPackageErrorLike;
+        code: string;
+        message: string;
+        header?: string;
+        operation?: string;
+    };
+}
+/**
+ * Retry error event
+ */
+export interface RetryErrorEvent extends BaseEvent {
+    type: typeof ERROR_EVENTS.RETRY_ERROR;
+    data: {
+        error: ApiPackageErrorLike;
+        code: string;
+        message: string;
+        attempts?: number;
+        maxAttempts?: number;
+        lastError?: unknown;
+    };
+}
+/**
+ * Options for emit methods
+ */
+export interface EmitNetworkErrorOptions extends EventOptions {
+    error: ApiPackageErrorLike;
+    url?: string;
+    method?: string;
+    status?: number;
+    retryable?: boolean;
+}
+export interface EmitValidationErrorOptions extends EventOptions {
+    error: ApiPackageErrorLike;
+    field?: string;
+    value?: unknown;
+    constraints?: Record<string, string>;
+}
+export interface EmitRateLimitErrorOptions extends EventOptions {
+    error: ApiPackageErrorLike;
+    limit?: number;
+    remaining?: number;
+    resetAt?: string;
+    retryAfter?: number;
+}
+export interface EmitServerErrorOptions extends EventOptions {
+    error: ApiPackageErrorLike;
+    statusCode: number;
+    serverMessage?: string;
+    traceId?: string;
+}
+export interface EmitTimeoutErrorOptions extends EventOptions {
+    error: ApiPackageErrorLike;
+    timeout: number;
+    operation?: string;
+    url?: string;
+}
+export interface EmitAuthorizationErrorOptions extends EventOptions {
+    error: ApiPackageErrorLike;
+    url?: string;
+    method?: string;
+    resource?: string;
+    permission?: string;
+}
+export interface EmitConflictErrorOptions extends EventOptions {
+    error: ApiPackageErrorLike;
+    conflictingResource?: string;
+    currentValue?: unknown;
+    attemptedValue?: unknown;
+}
+export interface EmitClientErrorOptions extends EventOptions {
+    error: ApiPackageErrorLike;
+    status: number;
+    url?: string;
+    method?: string;
+}
+export interface EmitExternalServiceErrorOptions extends EventOptions {
+    error: ApiPackageErrorLike;
+    service?: string;
+    endpoint?: string;
+    timeout?: number;
+}
+export interface EmitRetryErrorOptions extends EventOptions {
+    error: ApiPackageErrorLike;
+    attempts?: number;
+    maxAttempts?: number;
+    lastError?: unknown;
+}
+/**
+ * Union type for all error event types
+ */
+export type ErrorEventData = GenericErrorEvent | NetworkErrorEvent | ValidationErrorEvent | AuthenticationErrorEvent | RateLimitErrorEvent | ServerErrorEvent | TimeoutErrorEvent;

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

@@ -0,0 +1 @@
+export type * from './types';

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

@@ -0,0 +1,256 @@
+/**
+ * Header Event Factory
+ * Creates and emits header-related events with type safety
+ */
+import { type BaseEvent, type EventOptions } from '..';
+import type { ApiHeaders } from '../../../headers';
+import type { DebuggerConfigSource, HEADER_EVENTS } from '../../..';
+/**
+ * Base structure for header events
+ */
+export interface HeaderEvent extends BaseEvent {
+    type: string;
+    data: Record<string, unknown>;
+}
+/**
+ * Headers changed event
+ */
+export interface HeadersChangedEvent extends HeaderEvent {
+    type: typeof HEADER_EVENTS.CHANGED;
+    data: {
+        previous: ApiHeaders;
+        current: ApiHeaders;
+        changes: {
+            added: ApiHeaders;
+            modified: ApiHeaders;
+            removed: string[];
+        };
+        source: DebuggerConfigSource;
+        reason?: string;
+    };
+}
+/**
+ * Headers enriched event
+ */
+export interface HeadersEnrichedEvent extends HeaderEvent {
+    type: typeof HEADER_EVENTS.ENRICHED;
+    data: {
+        original: ApiHeaders;
+        enriched: ApiHeaders;
+        addedHeaders: string[];
+        source: 'client-hints' | 'device-detection' | 'user-agent' | 'custom';
+        metadata?: {
+            deviceType?: string;
+            browserName?: string;
+            osName?: string;
+            [key: string]: unknown;
+        };
+    };
+}
+/**
+ * Headers conflict event
+ */
+export interface HeadersConflictEvent extends HeaderEvent {
+    type: typeof HEADER_EVENTS.CONFLICT;
+    data: {
+        header: string;
+        conflicts: Array<{
+            source: DebuggerConfigSource;
+            value: string;
+            priority: number;
+        }>;
+        resolution: {
+            source: DebuggerConfigSource;
+            value: string;
+            reason: string;
+        };
+        strategy: 'override' | 'merge' | 'preserve';
+    };
+}
+/**
+ * Headers override event
+ */
+export interface HeadersOverrideEvent extends HeaderEvent {
+    type: typeof HEADER_EVENTS.OVERRIDE;
+    data: {
+        header: string;
+        previousValue: string | undefined;
+        newValue: string;
+        source: DebuggerConfigSource;
+        reason: string;
+        temporary?: boolean;
+    };
+}
+/**
+ * Headers merged event
+ */
+export interface HeadersMergedEvent extends HeaderEvent {
+    type: typeof HEADER_EVENTS.MERGED;
+    data: {
+        sources: ApiHeaders[];
+        result: ApiHeaders;
+        strategy: 'shallow' | 'deep' | 'concat';
+        conflictsResolved: number;
+    };
+}
+/**
+ * Headers filtered event
+ */
+export interface HeadersFilteredEvent extends HeaderEvent {
+    type: typeof HEADER_EVENTS.FILTERED;
+    data: {
+        original: ApiHeaders;
+        filtered: ApiHeaders;
+        removedHeaders: string[];
+        reason: string;
+        source?: DebuggerConfigSource;
+    };
+}
+/**
+ * Headers validated event
+ */
+export interface HeadersValidatedEvent extends HeaderEvent {
+    type: typeof HEADER_EVENTS.VALIDATED;
+    data: {
+        headers: ApiHeaders;
+        valid: boolean;
+        errors?: Array<{
+            header: string;
+            reason: string;
+        }>;
+        warnings?: Array<{
+            header: string;
+            message: string;
+        }>;
+    };
+}
+/**
+ * Headers cached event
+ */
+export interface HeadersCachedEvent extends HeaderEvent {
+    type: typeof HEADER_EVENTS.CACHED;
+    data: {
+        key: string;
+        headers: ApiHeaders;
+        ttl?: number;
+        strategy?: 'memory' | 'session' | 'persistent';
+    };
+}
+/**
+ * Headers cache hit event
+ */
+export interface HeadersCacheHitEvent extends HeaderEvent {
+    type: typeof HEADER_EVENTS.CACHE_HIT;
+    data: {
+        key: string;
+        headers: ApiHeaders;
+        ttl?: number;
+        strategy?: 'memory' | 'session' | 'persistent';
+    };
+}
+/**
+ * Headers cache miss event
+ */
+export interface HeadersCacheMissEvent extends HeaderEvent {
+    type: typeof HEADER_EVENTS.CACHE_MISS;
+    data: {
+        key: string;
+        headers?: ApiHeaders;
+        ttl?: number;
+        strategy?: 'memory' | 'session' | 'persistent';
+    };
+}
+/**
+ * Options for emitChanged method
+ */
+export interface EmitChangedOptions extends EventOptions {
+    previous: ApiHeaders;
+    current: ApiHeaders;
+    source: DebuggerConfigSource;
+    reason?: string;
+}
+/**
+ * Options for emitEnriched method
+ */
+export interface EmitEnrichedOptions extends EventOptions {
+    original: ApiHeaders;
+    enriched: ApiHeaders;
+    source: 'client-hints' | 'device-detection' | 'user-agent' | 'custom';
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options for emitConflict method
+ */
+export interface EmitConflictOptions extends EventOptions {
+    header: string;
+    conflicts: Array<{
+        source: DebuggerConfigSource;
+        value: string;
+        priority: number;
+    }>;
+    resolution: {
+        source: DebuggerConfigSource;
+        value: string;
+        reason: string;
+    };
+    strategy?: 'override' | 'merge' | 'preserve';
+}
+/**
+ * Options for emitOverride method
+ */
+export interface EmitOverrideOptions extends EventOptions {
+    header: string;
+    previousValue: string | undefined;
+    newValue: string;
+    source: DebuggerConfigSource;
+    reason: string;
+    temporary?: boolean;
+}
+/**
+ * Options for emitMerged method
+ */
+export interface EmitMergedOptions extends EventOptions {
+    sources: ApiHeaders[];
+    result: ApiHeaders;
+    strategy?: 'shallow' | 'deep' | 'concat';
+    conflictsResolved?: number;
+}
+/**
+ * Options for emitFiltered method
+ */
+export interface EmitFilteredOptions extends EventOptions {
+    original: ApiHeaders;
+    filtered: ApiHeaders;
+    reason: string;
+    source?: DebuggerConfigSource;
+}
+/**
+ * Options for emitCached method
+ */
+export interface EmitCachedOptions extends EventOptions {
+    key: string;
+    headers: ApiHeaders;
+    ttl?: number;
+    strategy?: 'memory' | 'session' | 'persistent';
+}
+/**
+ * Union type for all header event types
+ */
+export type HeaderEventType = HeadersChangedEvent | HeadersEnrichedEvent | HeadersConflictEvent | HeadersOverrideEvent | HeadersMergedEvent | HeadersFilteredEvent | HeadersValidatedEvent | HeadersCachedEvent | HeadersCacheHitEvent | HeadersCacheMissEvent;
+/**
+ * Header event handlers interface
+ */
+export interface HeaderEventHandlers {
+    onHeadersChanged?: (event: HeadersChangedEvent) => void;
+    onHeadersEnriched?: (event: HeadersEnrichedEvent) => void;
+    onHeadersConflict?: (event: HeadersConflictEvent) => void;
+    onHeadersOverride?: (event: HeadersOverrideEvent) => void;
+    onHeadersMerged?: (event: HeadersMergedEvent) => void;
+    onHeadersFiltered?: (event: HeadersFilteredEvent) => void;
+    onHeadersValidated?: (event: HeadersValidatedEvent) => void;
+    onHeadersCached?: (event: HeadersCachedEvent) => void;
+    onHeadersCacheHit?: (event: HeadersCacheHitEvent) => void;
+    onHeadersCacheMiss?: (event: HeadersCacheMissEvent) => void;
+    onAnyHeaderEvent?: (event: HeaderEventType) => void;
+}
+export type HeaderEventData = HeadersChangedEvent | HeadersEnrichedEvent | HeadersConflictEvent | HeadersOverrideEvent | HeadersMergedEvent | HeadersValidatedEvent | HeadersCachedEvent;

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

@@ -0,0 +1,9 @@
+export type * from './cache';
+export type * from './client';
+export type * from './debug';
+export type * from './config';
+export type * from './errors';
+export type * from './headers';
+export type * from './network';
+export type * from './performance';
+export type * from './types';

package/dist/api/events/factories/network/index.d.ts

@@ -0,0 +1 @@
+export type * from './types';