@mxf-dev/core 1.0.0

package/dist/types/toolTypes.js

@@ -0,0 +1,82 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * Tool Types (Stub)
+ *
+ * Provides type definitions for tool-related functionality.
+ * This is a minimal implementation to allow the build process to succeed.
+ * Created following DRY principles and fail-fast validation patterns.
+ */
+// Access level enum for tools
+export var ToolAccessLevel;
+(function (ToolAccessLevel) {
+    ToolAccessLevel["PUBLIC"] = "public";
+    ToolAccessLevel["PRIVATE"] = "private";
+    ToolAccessLevel["PROTECTED"] = "protected";
+    ToolAccessLevel["RESTRICTED"] = "restricted";
+})(ToolAccessLevel || (ToolAccessLevel = {}));
+// Parameter type enum
+export var ToolParameterType;
+(function (ToolParameterType) {
+    ToolParameterType["STRING"] = "string";
+    ToolParameterType["NUMBER"] = "number";
+    ToolParameterType["BOOLEAN"] = "boolean";
+    ToolParameterType["OBJECT"] = "object";
+    ToolParameterType["ARRAY"] = "array";
+    ToolParameterType["ANY"] = "any";
+})(ToolParameterType || (ToolParameterType = {}));
+// Server authentication type enum
+export var ToolServerAuthType;
+(function (ToolServerAuthType) {
+    ToolServerAuthType["NONE"] = "none";
+    ToolServerAuthType["API_KEY"] = "api_key";
+    ToolServerAuthType["OAUTH"] = "oauth";
+    ToolServerAuthType["BASIC"] = "basic";
+})(ToolServerAuthType || (ToolServerAuthType = {}));
+// Server connection type enum
+export var ToolServerConnectionType;
+(function (ToolServerConnectionType) {
+    ToolServerConnectionType["REST"] = "rest";
+    ToolServerConnectionType["GRAPHQL"] = "graphql";
+    ToolServerConnectionType["SOAP"] = "soap";
+    ToolServerConnectionType["GRPC"] = "grpc";
+    ToolServerConnectionType["CUSTOM"] = "custom";
+})(ToolServerConnectionType || (ToolServerConnectionType = {}));
+// Server status enum
+export var ToolServerStatus;
+(function (ToolServerStatus) {
+    ToolServerStatus["ONLINE"] = "online";
+    ToolServerStatus["OFFLINE"] = "offline";
+    ToolServerStatus["DEGRADED"] = "degraded";
+    ToolServerStatus["MAINTENANCE"] = "maintenance";
+    ToolServerStatus["DISCONNECTED"] = "disconnected";
+})(ToolServerStatus || (ToolServerStatus = {}));
+// Tool call status enum
+export var ToolCallStatus;
+(function (ToolCallStatus) {
+    ToolCallStatus["PENDING"] = "pending";
+    ToolCallStatus["IN_PROGRESS"] = "in_progress";
+    ToolCallStatus["COMPLETED"] = "completed";
+    ToolCallStatus["FAILED"] = "failed";
+    ToolCallStatus["TIMEOUT"] = "timeout";
+})(ToolCallStatus || (ToolCallStatus = {}));
+// This maintains a clean separation between tool definition and execution,
+// following the architecture's separation of concerns principle
+//# sourceMappingURL=toolTypes.js.map

package/dist/types/toolTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolTypes.js","sourceRoot":"","sources":["../../src/types/toolTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;GAMG;AAEH,8BAA8B;AAC9B,MAAM,CAAN,IAAY,eAKX;AALD,WAAY,eAAe;IACvB,oCAAiB,CAAA;IACjB,sCAAmB,CAAA;IACnB,0CAAuB,CAAA;IACvB,4CAAyB,CAAA;AAC7B,CAAC,EALW,eAAe,KAAf,eAAe,QAK1B;AAED,sBAAsB;AACtB,MAAM,CAAN,IAAY,iBAOX;AAPD,WAAY,iBAAiB;IACzB,sCAAiB,CAAA;IACjB,sCAAiB,CAAA;IACjB,wCAAmB,CAAA;IACnB,sCAAiB,CAAA;IACjB,oCAAe,CAAA;IACf,gCAAW,CAAA;AACf,CAAC,EAPW,iBAAiB,KAAjB,iBAAiB,QAO5B;AAED,kCAAkC;AAClC,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC1B,mCAAa,CAAA;IACb,yCAAmB,CAAA;IACnB,qCAAe,CAAA;IACf,qCAAe,CAAA;AACnB,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B;AAED,8BAA8B;AAC9B,MAAM,CAAN,IAAY,wBAMX;AAND,WAAY,wBAAwB;IAChC,yCAAa,CAAA;IACb,+CAAmB,CAAA;IACnB,yCAAa,CAAA;IACb,yCAAa,CAAA;IACb,6CAAiB,CAAA;AACrB,CAAC,EANW,wBAAwB,KAAxB,wBAAwB,QAMnC;AAED,qBAAqB;AACrB,MAAM,CAAN,IAAY,gBAMX;AAND,WAAY,gBAAgB;IACxB,qCAAiB,CAAA;IACjB,uCAAmB,CAAA;IACnB,yCAAqB,CAAA;IACrB,+CAA2B,CAAA;IAC3B,iDAA6B,CAAA;AACjC,CAAC,EANW,gBAAgB,KAAhB,gBAAgB,QAM3B;AAED,wBAAwB;AACxB,MAAM,CAAN,IAAY,cAMX;AAND,WAAY,cAAc;IACtB,qCAAmB,CAAA;IACnB,6CAA2B,CAAA;IAC3B,yCAAuB,CAAA;IACvB,mCAAiB,CAAA;IACjB,qCAAmB,CAAA;AACvB,CAAC,EANW,cAAc,KAAd,cAAc,QAMzB;AAqCD,2EAA2E;AAC3E,gEAAgE"}

package/dist/types/types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * Common type definitions for the MXF
+ *
+ * This file contains common type definitions used throughout the framework.
+ */
+/**
+ * Type alias for Channel ID
+ */
+export type ChannelId = string;
+/**
+ * Type alias for Agent ID
+ */
+export type AgentId = string;
+/**
+ * Connection status enum
+ */
+export declare enum ConnectionStatus {
+    DISCONNECTED = "disconnected",
+    CONNECTING = "connecting",
+    CONNECTED = "connected",
+    REGISTERED = "registered",// Added to support registration state
+    ERROR = "error"
+}
+/**
+ * Channel Context interface
+ *
+ * Represents the context of a channel, including metadata,
+ * participants, and conversation state.
+ */
+export interface ChannelContext {
+    channelId: ChannelId;
+    name: string;
+    description: string;
+    createdAt: number;
+    createdBy: AgentId;
+    lastActivity: number;
+    participants: AgentId[];
+    metadata: Record<string, any>;
+    status: 'active' | 'inactive' | 'archived';
+    messageCount: number;
+    conversationSummary?: string;
+    topics?: {
+        id: string;
+        topic: string;
+        keywords: string[];
+        relevance: number;
+    }[];
+}
+/**
+ * Task request interface
+ */
+export interface TaskRequest {
+    taskId: string;
+    fromAgentId: string;
+    toAgentId: string;
+    content: any;
+    metadata?: Record<string, any>;
+}
+/**
+ * Task response interface
+ */
+export interface TaskResponse {
+    taskId: string;
+    fromAgentId: string;
+    toAgentId: string;
+    content: any;
+    status: 'success' | 'error' | 'pending';
+    metadata?: Record<string, any>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B;;GAEG;AACH,oBAAY,gBAAgB;IACxB,YAAY,iBAAiB;IAC7B,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,UAAU,eAAe,CAAE,sCAAsC;IACjE,KAAK,UAAU;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,SAAS,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,OAAO,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACrB,EAAE,CAAC;CACP;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,GAAG,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,GAAG,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC"}

package/dist/types/types.js

@@ -0,0 +1,31 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * Connection status enum
+ */
+export var ConnectionStatus;
+(function (ConnectionStatus) {
+    ConnectionStatus["DISCONNECTED"] = "disconnected";
+    ConnectionStatus["CONNECTING"] = "connecting";
+    ConnectionStatus["CONNECTED"] = "connected";
+    ConnectionStatus["REGISTERED"] = "registered";
+    ConnectionStatus["ERROR"] = "error";
+})(ConnectionStatus || (ConnectionStatus = {}));
+//# sourceMappingURL=types.js.map

package/dist/types/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAkBH;;GAEG;AACH,MAAM,CAAN,IAAY,gBAMX;AAND,WAAY,gBAAgB;IACxB,iDAA6B,CAAA;IAC7B,6CAAyB,CAAA;IACzB,2CAAuB,CAAA;IACvB,6CAAyB,CAAA;IACzB,mCAAe,CAAA;AACnB,CAAC,EANW,gBAAgB,KAAhB,gBAAgB,QAM3B"}

package/dist/utils/Logger.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * Unified Logger for the Model Exchange Framework
+ *
+ * Provides a consistent logging interface for both server and SDK components.
+ * Features:
+ * - Configurable log levels
+ * - Context tagging
+ * - Timestamp formatting
+ * - Separate client/server logging pathways
+ *
+ * This follows DRY principles by providing a single logging implementation
+ * for the entire framework.
+ */
+interface LoggingConfig {
+    server: {
+        enabled: boolean;
+        level: string;
+    };
+    client: {
+        enabled: boolean;
+        level: string;
+    };
+}
+export declare const configureLogging: (config: Partial<LoggingConfig>) => void;
+export declare const enableClientLogging: (level?: string) => void;
+export declare const disableClientLogging: () => void;
+export declare const enableServerLogging: (level?: string) => void;
+export declare const disableServerLogging: () => void;
+/**
+ * Enhanced Logger class that ensures logs are consistently output
+ * with context, timestamps, and proper visibility levels
+ */
+export declare class Logger {
+    private level;
+    private context;
+    private target;
+    private static LOG_LEVELS;
+    /**
+     * Create a new Logger
+     * @param level Log level (error, warn, info, debug, trace)
+     * @param context Context string to prefix log messages
+     * @param target Target pathway ('server' or 'client') - defaults to 'server'
+     */
+    constructor(level: string, context?: string, target?: 'server' | 'client');
+    /**
+     * Internal log method
+     * @param level Log level
+     * @param message Message to log
+     * @param args Additional arguments
+     */
+    private log;
+    /**
+     * Log an error message
+     * @param message Message to log
+     * @param args Additional arguments
+     */
+    error(message: string, ...args: any[]): void;
+    /**
+     * Log a warning message
+     * @param message Message to log
+     * @param args Additional arguments
+     */
+    warn(message: string, ...args: any[]): void;
+    /**
+     * Log an info message
+     * @param message Message to log
+     * @param args Additional arguments
+     */
+    info(message: string, ...args: any[]): void;
+    /**
+     * Log a debug message
+     * @param message Message to log
+     * @param args Additional arguments
+     */
+    debug(message: string, ...args: any[]): void;
+    /**
+     * Log a trace message
+     * @param message Message to log
+     * @param args Additional arguments
+     */
+    trace(message: string, ...args: any[]): void;
+    /**
+     * Set the log level
+     * @param level New log level
+     */
+    setLevel(level: string): void;
+    /**
+     * Get a child logger with a sub-context
+     * @param subContext Sub-context to add
+     * @returns New logger with combined context
+     */
+    child(subContext: string): Logger;
+}
+/**
+ * Create a singleton default logger instance
+ */
+export declare const logger: Logger;
+/**
+ * Create a logger with tags (convenience function for backward compatibility)
+ *
+ * @param tags Tags to include
+ * @returns Logger with tags
+ */
+export declare const loggerWithTags: (...tags: string[]) => Logger;
+export default logger;
+//# sourceMappingURL=Logger.d.ts.map

package/dist/utils/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/utils/Logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;;;GAYG;AAGH,UAAU,aAAa;IACnB,MAAM,EAAE;QACJ,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,MAAM,EAAE;QACJ,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC;CACL;AAeD,eAAO,MAAM,gBAAgB,GAAI,QAAQ,OAAO,CAAC,aAAa,CAAC,KAAG,IAOjE,CAAC;AAGF,eAAO,MAAM,mBAAmB,GAAI,QAAO,MAAgB,KAAG,IAG7D,CAAC;AAEF,eAAO,MAAM,oBAAoB,QAAO,IAEvC,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,QAAO,MAAgB,KAAG,IAG7D,CAAC;AAEF,eAAO,MAAM,oBAAoB,QAAO,IAEvC,CAAC;AAEF;;;GAGG;AACH,qBAAa,MAAM;IACf,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,MAAM,CAAC,UAAU,CAMvB;IAEF;;;;;OAKG;gBACS,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,MAAW,EAAE,MAAM,GAAE,QAAQ,GAAG,QAAmB;IAMvF;;;;;OAKG;IACH,OAAO,CAAC,GAAG;IAsCX;;;;OAIG;IACI,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAInD;;;;OAIG;IACI,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAIlD;;;;OAIG;IACI,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAIlD;;;;OAIG;IACI,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAInD;;;;OAIG;IACI,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAInD;;;OAGG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC;;;;OAIG;IACI,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;CAI3C;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,QAAmC,CAAC;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,GAAG,MAAM,MAAM,EAAE,KAAG,MAElD,CAAC;AAGF,eAAe,MAAM,CAAC"}

package/dist/utils/Logger.js

@@ -0,0 +1,194 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+// Default logging configuration
+const LOGGING_CONFIG = {
+    server: {
+        enabled: false, // Server logging disabled by default
+        level: 'debug'
+    },
+    client: {
+        enabled: false, // Client logging disabled by default (TUI suppresses via disableClientLogging())
+        level: 'debug'
+    }
+};
+// Allow runtime configuration
+export const configureLogging = (config) => {
+    if (config.server) {
+        Object.assign(LOGGING_CONFIG.server, config.server);
+    }
+    if (config.client) {
+        Object.assign(LOGGING_CONFIG.client, config.client);
+    }
+};
+// Convenience functions for common configurations
+export const enableClientLogging = (level = 'debug') => {
+    LOGGING_CONFIG.client.enabled = true;
+    LOGGING_CONFIG.client.level = level;
+};
+export const disableClientLogging = () => {
+    LOGGING_CONFIG.client.enabled = false;
+};
+export const enableServerLogging = (level = 'debug') => {
+    LOGGING_CONFIG.server.enabled = true;
+    LOGGING_CONFIG.server.level = level;
+};
+export const disableServerLogging = () => {
+    LOGGING_CONFIG.server.enabled = false;
+};
+/**
+ * Enhanced Logger class that ensures logs are consistently output
+ * with context, timestamps, and proper visibility levels
+ */
+export class Logger {
+    level;
+    context;
+    target;
+    static LOG_LEVELS = {
+        error: 0,
+        warn: 1,
+        info: 2,
+        debug: 3,
+        trace: 4
+    };
+    /**
+     * Create a new Logger
+     * @param level Log level (error, warn, info, debug, trace)
+     * @param context Context string to prefix log messages
+     * @param target Target pathway ('server' or 'client') - defaults to 'server'
+     */
+    constructor(level, context = '', target = 'server') {
+        this.level = level;
+        this.context = context;
+        this.target = target;
+    }
+    /**
+     * Internal log method
+     * @param level Log level
+     * @param message Message to log
+     * @param args Additional arguments
+     */
+    log(level, message, ...args) {
+        // Get target-specific configuration
+        const targetConfig = LOGGING_CONFIG[this.target];
+        // Check if logging is enabled for this target
+        if (!targetConfig.enabled) {
+            return;
+        }
+        // Use target-specific level if different from instance level
+        const effectiveLevel = targetConfig.level || this.level;
+        // Only log if the level is sufficient
+        if (Logger.LOG_LEVELS[level] <= Logger.LOG_LEVELS[effectiveLevel]) {
+            const timestamp = new Date().toISOString();
+            const targetPrefix = this.target === 'client' ? 'CLIENT' : 'SERVER';
+            const prefix = this.context
+                ? `[${timestamp}][${targetPrefix}][${level.toUpperCase()}][${this.context}]`
+                : `[${timestamp}][${targetPrefix}][${level.toUpperCase()}]`;
+            // Output to console based on level
+            if (level === 'error') {
+                console.error(prefix, message, ...args);
+            }
+            else if (level === 'warn') {
+                console.warn(prefix, message, ...args);
+            }
+            else if (level === 'info') {
+                console.info(prefix, message, ...args);
+            }
+            else {
+                console.log(prefix, message, ...args);
+            }
+            // Force flush stdout if in Node.js environment to ensure logs appear immediately
+            if (typeof process !== 'undefined' && process.stdout && process.stdout.write) {
+                process.stdout.write('');
+            }
+        }
+    }
+    /**
+     * Log an error message
+     * @param message Message to log
+     * @param args Additional arguments
+     */
+    error(message, ...args) {
+        this.log('error', `\x1b[31m${message}\x1b[0m`, ...args);
+    }
+    /**
+     * Log a warning message
+     * @param message Message to log
+     * @param args Additional arguments
+     */
+    warn(message, ...args) {
+        this.log('warn', `\x1b[33m${message}\x1b[0m`, ...args);
+    }
+    /**
+     * Log an info message
+     * @param message Message to log
+     * @param args Additional arguments
+     */
+    info(message, ...args) {
+        this.log('info', message, ...args);
+    }
+    /**
+     * Log a debug message
+     * @param message Message to log
+     * @param args Additional arguments
+     */
+    debug(message, ...args) {
+        this.log('debug', `\x1b[34m${message}\x1b[0m`, ...args);
+    }
+    /**
+     * Log a trace message
+     * @param message Message to log
+     * @param args Additional arguments
+     */
+    trace(message, ...args) {
+        this.log('trace', message, ...args);
+    }
+    /**
+     * Set the log level
+     * @param level New log level
+     */
+    setLevel(level) {
+        this.level = level;
+    }
+    /**
+     * Get a child logger with a sub-context
+     * @param subContext Sub-context to add
+     * @returns New logger with combined context
+     */
+    child(subContext) {
+        const combinedContext = this.context ? `${this.context}:${subContext}` : subContext;
+        return new Logger(this.level, combinedContext, this.target);
+    }
+}
+/**
+ * Create a singleton default logger instance
+ */
+export const logger = new Logger('info', '', 'server');
+/**
+ * Create a logger with tags (convenience function for backward compatibility)
+ *
+ * @param tags Tags to include
+ * @returns Logger with tags
+ */
+export const loggerWithTags = (...tags) => {
+    return logger.child(tags.join(','));
+};
+// Default export for convenient importing
+export default logger;
+//# sourceMappingURL=Logger.js.map

package/dist/utils/Logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.js","sourceRoot":"","sources":["../../src/utils/Logger.ts"],"names":[],"mappings":"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"}

package/dist/utils/MxpEncryption.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+import { EncryptedPayload, MxpPayload } from '../schemas/MxpProtocolSchemas.js';
+/**
+ * MXP Encryption configuration
+ */
+export declare class MxpEncryption {
+    private static instance;
+    private encryptionKey;
+    private isEnabled;
+    private constructor();
+    static getInstance(): MxpEncryption;
+    /**
+     * Initialize encryption from environment variables
+     */
+    private initializeFromEnv;
+    /**
+     * Check if encryption is enabled
+     */
+    isEncryptionEnabled(): boolean;
+    /**
+     * Encrypt an MXP payload
+     */
+    encrypt(payload: MxpPayload): EncryptedPayload | null;
+    /**
+     * Decrypt an encrypted payload
+     */
+    decrypt(encryptedPayload: EncryptedPayload): MxpPayload | null;
+    /**
+     * Encrypt a full message payload (for convenience)
+     */
+    encryptMessage(payload: MxpPayload): MxpPayload | EncryptedPayload;
+    /**
+     * Decrypt a message payload (with type checking)
+     */
+    decryptMessage(payload: MxpPayload | EncryptedPayload): MxpPayload | null;
+    /**
+     * Generate a secure random key (utility for initial setup)
+     */
+    static generateSecureKey(): string;
+}
+/**
+ * Singleton instance export
+ */
+export declare const mxpEncryption: MxpEncryption;
+//# sourceMappingURL=MxpEncryption.d.ts.map

package/dist/utils/MxpEncryption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MxpEncryption.d.ts","sourceRoot":"","sources":["../../src/utils/MxpEncryption.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAWH,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAA0B,MAAM,kCAAkC,CAAC;AAKxG;;GAEG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgB;IACvC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,SAAS,CAAkB;IAEnC,OAAO;WAIO,WAAW,IAAI,aAAa;IAO1C;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;OAEG;IACI,mBAAmB,IAAI,OAAO;IAIrC;;OAEG;IACI,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,gBAAgB,GAAG,IAAI;IAkC5D;;OAEG;IACI,OAAO,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,UAAU,GAAG,IAAI;IAmCrE;;OAEG;IACI,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,GAAG,gBAAgB;IASzE;;OAEG;IACI,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,gBAAgB,GAAG,UAAU,GAAG,IAAI;IAUhF;;OAEG;WACW,iBAAiB,IAAI,MAAM;CAG5C;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,eAA8B,CAAC"}