@plyaz/types 1.14.2 → 1.14.4

package/dist/logger/enums.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Standard service names for logger instances across packages
+ *
+ * These constants ensure consistency in service naming and prevent typos
+ * when creating logger instances.
+ */
+export declare const LOGGER_SERVICES: {
+    readonly API_CLIENT: "ApiClient";
+    readonly CLIENT_EVENT_MANAGER: "ClientEventManager";
+    readonly INTERCEPTORS: "Interceptors";
+    readonly PUB_SUB: "PubSub";
+    readonly EVENT_MANAGER: "EventManager";
+    readonly EVENT_QUEUE: "EventQueue";
+    readonly CONFIG_QUEUE: "ConfigQueue";
+    readonly OPERATION_TRACKER: "OperationTracker";
+    readonly EXPRESS_FRAMEWORK: "ExpressFramework";
+    readonly NESTJS_GUARD: "NestJSGuard";
+    readonly NESTJS_INTERCEPTOR: "NestJSInterceptor";
+    readonly NETWORK_CONFIGURATION: "NetworkConfiguration";
+    readonly BASE_OPERATION_TRACKER: "BaseOperationTracker";
+    readonly EVENT_QUEUE_MANAGER: "EventQueueManager";
+    readonly QUEUE_ORCHESTRATOR: "QueueOrchestrator";
+    readonly PERFORMANCE_MONITOR: "PerformanceMonitor";
+    readonly DEBUG_REPORT: "DebugReport";
+    readonly UNIFIED_DEBUGGER: "UnifiedDebugger";
+    readonly DEBUGGER_QUEUE_MANAGER: "DebuggerQueueManager";
+    readonly EMAIL_SERVICE: "EmailService";
+    readonly SMS_SERVICE: "SMSService";
+    readonly PUSH_SERVICE: "PushService";
+    readonly WEBHOOK_SERVICE: "WebhookService";
+    readonly TEMPLATE_ENGINE: "TemplateEngine";
+    readonly ATTACHMENT_RESOLVER: "AttachmentResolver";
+    readonly CONFIG_MANAGER: "ConfigManager";
+    readonly CONFIG_VALIDATOR: "ConfigValidator";
+};
+export type LoggerService = (typeof LOGGER_SERVICES)[keyof typeof LOGGER_SERVICES];

package/dist/logger/types.d.ts

@@ -1,13 +1,50 @@
 import type pino from 'pino';
+/**
+ * Base logger interface with support for both patterns:
+ * - Single meta object: logger.info('msg', { key: val })
+ * - Variadic args: logger.info('msg', obj1, obj2, ...)
+ */
 export interface LoggerInterface {
-    debug(message: string, ...supportingDetials: unknown[]): void;
-    info(message: string, ...supportingDetials: unknown[]): void;
-    warn(message: string, ...supportingDetials: unknown[]): void;
-    error(message: string, ...supportingDetials: unknown[]): void;
-    fatal(message: string, ...supportingDetials: unknown[]): void;
+    debug(message: string, meta?: Record<string, unknown>): void;
+    debug(message: string, ...supportingDetails: unknown[]): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, ...supportingDetails: unknown[]): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, ...supportingDetails: unknown[]): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, ...supportingDetails: unknown[]): void;
+    fatal(message: string, meta?: Record<string, unknown>): void;
+    fatal(message: string, ...supportingDetails: unknown[]): void;
+    group?(label?: string): void;
+    groupCollapsed?(label?: string): void;
+    groupEnd?(): void;
 }
 export type LoggerMethodTypes = 'debug' | 'info' | 'warn' | 'error' | 'fatal';
-export type LoggerEnvironment = 'development' | 'production';
+export type LoggerEnvironment = 'development' | 'production' | 'staging';
+/**
+ * Configuration for PackageLogger instances
+ */
+export interface PackageLoggerConfig {
+    /** Package name (e.g., 'notifications', 'api', 'config') */
+    packageName: string;
+    /** Service/module name within package (optional) */
+    service?: string;
+    /** Environment (development or production) */
+    environment?: LoggerEnvironment;
+    /** Correlation ID for request tracing */
+    correlationId?: string;
+    /** Minimum log level to output */
+    minLevel?: LoggerMethodTypes;
+}
+/**
+ * Extended logger interface with package context support
+ */
+export interface PackageLoggerInterface extends LoggerInterface {
+    /** Create child logger with additional context */
+    child(context: Record<string, unknown>): PackageLoggerInterface;
+    /** Get current package context */
+    getContext(): Record<string, unknown>;
+}
 /**
  * Infers the parameter types for a specific logger method from the `pino.Logger` interface.
  *

package/dist/notifications/types.d.ts

@@ -160,7 +160,7 @@ export interface BaseAdapterConfig {
     /** Optional fallback adapter */
     fallbackAdapter?: unknown;
     /** Optional logger */
-    logger?: unknown;
+    logger?: Logger;
     /** Attachment resolver options */
     attachmentResolverOptions?: AttachmentResolverOptions;
     /** API client configuration (for providers using @plyaz/api) */
@@ -1206,7 +1206,7 @@ export interface AttachmentResolverOptions {
     /** Allow local file paths (default: true) */
     allowLocalPaths?: boolean;
     /** Logger */
-    logger?: unknown;
+    logger?: Logger;
 }
 /**
  * Base event payload with generic metadata support
@@ -1351,11 +1351,12 @@ export interface Logger {
     info(message: string, meta?: UnknownRecord): void;
     warn(message: string, meta?: UnknownRecord): void;
     error(message: string, meta?: UnknownRecord): void;
+    fatal?(message: string, meta?: UnknownRecord): void;
 }
 /**
  * Log level type
  */
-export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'fatal';
 /**
  * NotificationAdapter - Base interface all providers must implement
  *
@@ -1861,7 +1862,7 @@ export interface BaseWebhookAdapterConfig extends WebhookAdapterConfig {
     /** Header name containing the signature */
     signatureHeader?: string;
     /** Logger instance */
-    logger?: unknown;
+    logger?: Logger;
 }
 /**
  * Idempotency record (internal use)
@@ -1911,7 +1912,7 @@ export interface InfobipDeliveryWebhookConfig {
      */
     priority?: number;
     /** Logger instance */
-    logger?: unknown;
+    logger?: Logger;
 }
 /**
  * Infobip Email Tracking Webhook configuration
@@ -1937,7 +1938,7 @@ export interface InfobipTrackingWebhookConfig {
      */
     priority?: number;
     /** Logger instance */
-    logger?: unknown;
+    logger?: Logger;
 }
 /**
  * SendGrid Webhook configuration
@@ -1975,5 +1976,5 @@ export interface SendGridWebhookConfig {
      */
     priority?: number;
     /** Logger instance */
-    logger?: unknown;
+    logger?: Logger;
 }

package/dist/utils/enums.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Media file extensions
+ */
+export declare const MEDIA_EXTENSIONS: {
+    readonly IMAGE: readonly ["jpg", "jpeg", "png", "gif", "webp", "svg", "ico", "bmp", "tiff"];
+    readonly VIDEO: readonly ["mp4", "webm", "avi", "mov", "wmv", "flv", "mkv", "3gp"];
+    readonly AUDIO: readonly ["mp3", "wav", "ogg", "aac", "flac", "m4a", "wma"];
+};
+/**
+ * Media MIME type prefixes
+ */
+export declare const MEDIA_MIME_PREFIXES: readonly ["image/", "video/", "audio/"];
+/**
+ * ANSI color codes
+ */
+export declare const COLORS: {
+    readonly reset: "\u001B[0m";
+    readonly black: "\u001B[30m";
+    readonly red: "\u001B[31m";
+    readonly green: "\u001B[32m";
+    readonly yellow: "\u001B[33m";
+    readonly blue: "\u001B[34m";
+    readonly magenta: "\u001B[35m";
+    readonly cyan: "\u001B[36m";
+    readonly white: "\u001B[37m";
+    readonly gray: "\u001B[90m";
+    readonly brightRed: "\u001B[91m";
+    readonly brightGreen: "\u001B[92m";
+    readonly brightYellow: "\u001B[93m";
+    readonly brightBlue: "\u001B[94m";
+    readonly brightMagenta: "\u001B[95m";
+    readonly brightCyan: "\u001B[96m";
+    readonly brightWhite: "\u001B[97m";
+    readonly bgRed: "\u001B[41m";
+    readonly bgGreen: "\u001B[42m";
+    readonly bgYellow: "\u001B[43m";
+    readonly bgBlue: "\u001B[44m";
+    readonly bgMagenta: "\u001B[45m";
+    readonly bgCyan: "\u001B[46m";
+    readonly bgWhite: "\u001B[47m";
+    readonly bold: "\u001B[1m";
+    readonly dim: "\u001B[2m";
+    readonly italic: "\u001B[3m";
+    readonly underline: "\u001B[4m";
+    readonly blink: "\u001B[5m";
+    readonly reverse: "\u001B[7m";
+    readonly hidden: "\u001B[8m";
+    readonly strikethrough: "\u001B[9m";
+};
+/**
+ * Correlation ID types for different contexts
+ * Used across packages for distributed tracing and event correlation
+ */
+export declare enum CORRELATION_TYPE {
+    /** Network event correlation */
+    NETWORK = "net",
+    /** API request correlation */
+    API = "api",
+    /** User session correlation */
+    SESSION = "session",
+    /** Transaction correlation */
+    TRANSACTION = "txn",
+    /** Event correlation */
+    EVENT = "evt",
+    /** Trace correlation */
+    TRACE = "trace",
+    /** Generic correlation */
+    GENERIC = "corr"
+}

package/dist/utils/types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Utility Types
+ * Common types used across packages
+ */
+/**
+ * ID generation options
+ * Used for generating unique identifiers across packages
+ */
+export interface IdGenerationOptions {
+    /** Prefix for the ID */
+    prefix?: string;
+    /** Suffix for the ID */
+    suffix?: string;
+    /** Use timestamp-based ID instead of UUID */
+    useTimestamp?: boolean;
+    /** Separator for components */
+    separator?: string;
+    /** Include random component for timestamp IDs */
+    includeRandom?: boolean;
+    /** Radix for number conversion (2-36) */
+    radix?: number;
+    /** Length of random component */
+    randomLength?: number;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plyaz/types",
-  "version": "1.14.2",
+  "version": "1.14.4",
   "author": "Redeemer Pace",
   "license": "ISC",
   "description": "Provides shared TypeScript types and schema utilities for validation and parsing in the @playz ecosystem.",
@@ -170,6 +170,16 @@
       "import": "./dist/notifications/index.js",
       "require": "./dist/notifications/index.cjs"
     },
+    "./logger": {
+      "types": "./dist/logger/index.d.ts",
+      "import": "./dist/logger/index.js",
+      "require": "./dist/logger/index.cjs"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.js",
+      "require": "./dist/utils/index.cjs"
+    },
     "./payments": {
       "types": "./dist/payments/index.d.ts",
       "import": "./dist/payments/index.js",

package/dist/api/utils/enums.d.ts

@@ -1,23 +0,0 @@
-/**
- * Utility Enums for API Package
- * Enums used across API utilities
- */
-/**
- * Correlation ID types for different contexts
- */
-export declare enum CORRELATION_TYPE {
-    /** Network event correlation */
-    NETWORK = "net",
-    /** API request correlation */
-    API = "api",
-    /** User session correlation */
-    SESSION = "session",
-    /** Transaction correlation */
-    TRANSACTION = "txn",
-    /** Event correlation */
-    EVENT = "evt",
-    /** Trace correlation */
-    TRACE = "trace",
-    /** Generic correlation */
-    GENERIC = "corr"
-}

package/dist/logger/index.d.ts

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