@context-action/core 0.0.2 → 0.0.3

package/dist/index.cjs

@@ -71,7 +71,7 @@ var require_toPropertyKey = __commonJS({ "../../node_modules/.pnpm/@oxc-project+
 //#region ../../node_modules/.pnpm/@oxc-project+runtime@0.77.3/node_modules/@oxc-project/runtime/src/helpers/defineProperty.js
 var require_defineProperty = __commonJS({ "../../node_modules/.pnpm/@oxc-project+runtime@0.77.3/node_modules/@oxc-project/runtime/src/helpers/defineProperty.js"(exports, module) {
 	var toPropertyKey = require_toPropertyKey();
-	function _defineProperty$1(e, r, t) {
+	function _defineProperty$2(e, r, t) {
 		return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
 			value: t,
 			enumerable: !0,
@@ -79,68 +79,311 @@ var require_defineProperty = __commonJS({ "../../node_modules/.pnpm/@oxc-project
 			writable: !0
 		}) : e[r] = t, e;
 	}
-	module.exports = _defineProperty$1, module.exports.__esModule = true, module.exports["default"] = module.exports;
+	module.exports = _defineProperty$2, module.exports.__esModule = true, module.exports["default"] = module.exports;
 } });
 
+//#endregion
+//#region src/logger.ts
+var import_defineProperty$1 = __toESM(require_defineProperty(), 1);
+/**
+* Log levels in order of severity (lowest to highest)
+*/
+let LogLevel = /* @__PURE__ */ function(LogLevel$1) {
+	LogLevel$1[LogLevel$1["TRACE"] = 0] = "TRACE";
+	LogLevel$1[LogLevel$1["DEBUG"] = 1] = "DEBUG";
+	LogLevel$1[LogLevel$1["INFO"] = 2] = "INFO";
+	LogLevel$1[LogLevel$1["WARN"] = 3] = "WARN";
+	LogLevel$1[LogLevel$1["ERROR"] = 4] = "ERROR";
+	LogLevel$1[LogLevel$1["FATAL"] = 5] = "FATAL";
+	return LogLevel$1;
+}({});
+/**
+* Default console logger implementation
+*/
+var ConsoleLogger = class {
+	constructor(level = LogLevel.ERROR) {
+		this.level = level;
+	}
+	shouldLog(level) {
+		return level >= this.level;
+	}
+	formatMessage(level, message) {
+		return `[${level.toUpperCase()}] ${message}`;
+	}
+	trace(message, ...args) {
+		if (this.shouldLog(LogLevel.TRACE)) console.trace(this.formatMessage("trace", message), ...args);
+	}
+	debug(message, ...args) {
+		if (this.shouldLog(LogLevel.DEBUG)) console.debug(this.formatMessage("debug", message), ...args);
+	}
+	info(message, ...args) {
+		if (this.shouldLog(LogLevel.INFO)) console.info(this.formatMessage("info", message), ...args);
+	}
+	warn(message, ...args) {
+		if (this.shouldLog(LogLevel.WARN)) console.warn(this.formatMessage("warn", message), ...args);
+	}
+	error(message, ...args) {
+		if (this.shouldLog(LogLevel.ERROR)) console.error(this.formatMessage("error", message), ...args);
+	}
+	fatal(message, ...args) {
+		if (this.shouldLog(LogLevel.FATAL)) console.error(this.formatMessage("fatal", message), ...args);
+	}
+	setLevel(level) {
+		this.level = level;
+	}
+};
+/**
+* Parse log level from string
+*/
+function parseLogLevel(level) {
+	const upperLevel = level.toUpperCase();
+	switch (upperLevel) {
+		case "TRACE": return LogLevel.TRACE;
+		case "DEBUG": return LogLevel.DEBUG;
+		case "INFO": return LogLevel.INFO;
+		case "WARN": return LogLevel.WARN;
+		case "ERROR": return LogLevel.ERROR;
+		case "FATAL": return LogLevel.FATAL;
+		default: return LogLevel.ERROR;
+	}
+}
+/**
+* Get log level from environment variable or default to ERROR
+*/
+function getLogLevelFromEnv() {
+	if (typeof process !== "undefined" && process.env) {
+		const envLevel = process.env.LOG_LEVEL || process.env.ACTION_LOG_LEVEL;
+		if (envLevel) return parseLogLevel(envLevel);
+	}
+	return LogLevel.TRACE;
+}
+/**
+* Extract trace ID from payload if it exists
+*/
+function extractTraceIdFromPayload(payload) {
+	if (payload && typeof payload === "object") return payload._traceId || payload.traceId || payload.trace_id;
+	return void 0;
+}
+/**
+* Extract session ID from payload if it exists
+*/
+function extractSessionIdFromPayload(payload) {
+	if (payload && typeof payload === "object") return payload._sessionId || payload.sessionId || payload.session_id;
+	return void 0;
+}
+/**
+* Create OTEL context from payload
+*/
+function createOtelContextFromPayload(payload) {
+	return {
+		traceId: extractTraceIdFromPayload(payload),
+		sessionId: extractSessionIdFromPayload(payload),
+		metadata: payload
+	};
+}
+/**
+* OpenTelemetry-aware console logger implementation
+*/
+var OtelConsoleLogger = class extends ConsoleLogger {
+	constructor(level = LogLevel.ERROR) {
+		super(level);
+		(0, import_defineProperty$1.default)(this, "context", {});
+	}
+	setContext(context) {
+		this.context = {
+			...this.context,
+			...context
+		};
+	}
+	getContext() {
+		return { ...this.context };
+	}
+	clearContext() {
+		this.context = {};
+	}
+	formatWithContext(level, message) {
+		const contextParts = [];
+		if (this.context.sessionId) contextParts.push(`session=${this.context.sessionId}`);
+		if (this.context.traceId) contextParts.push(`trace=${this.context.traceId}`);
+		if (this.context.spanId) contextParts.push(`span=${this.context.spanId}`);
+		const contextStr = contextParts.length > 0 ? ` [${contextParts.join(", ")}]` : "";
+		return `[${level.toUpperCase()}]${contextStr} ${message}`;
+	}
+	logWithContext(level, message, ...args) {
+		const levelName = LogLevel[level].toLowerCase();
+		const formattedMessage = this.formatWithContext(levelName, message);
+		switch (level) {
+			case LogLevel.TRACE:
+				if (this.shouldLog(LogLevel.TRACE)) console.trace(formattedMessage, ...args);
+				break;
+			case LogLevel.DEBUG:
+				if (this.shouldLog(LogLevel.DEBUG)) console.debug(formattedMessage, ...args);
+				break;
+			case LogLevel.INFO:
+				if (this.shouldLog(LogLevel.INFO)) console.info(formattedMessage, ...args);
+				break;
+			case LogLevel.WARN:
+				if (this.shouldLog(LogLevel.WARN)) console.warn(formattedMessage, ...args);
+				break;
+			case LogLevel.ERROR:
+				if (this.shouldLog(LogLevel.ERROR)) console.error(formattedMessage, ...args);
+				break;
+			case LogLevel.FATAL:
+				if (this.shouldLog(LogLevel.FATAL)) console.error(formattedMessage, ...args);
+				break;
+		}
+	}
+	trace(message, ...args) {
+		this.logWithContext(LogLevel.TRACE, message, ...args);
+	}
+	debug(message, ...args) {
+		this.logWithContext(LogLevel.DEBUG, message, ...args);
+	}
+	info(message, ...args) {
+		this.logWithContext(LogLevel.INFO, message, ...args);
+	}
+	warn(message, ...args) {
+		this.logWithContext(LogLevel.WARN, message, ...args);
+	}
+	error(message, ...args) {
+		this.logWithContext(LogLevel.ERROR, message, ...args);
+	}
+	fatal(message, ...args) {
+		this.logWithContext(LogLevel.FATAL, message, ...args);
+	}
+};
+
 //#endregion
 //#region src/ActionRegister.ts
 var import_defineProperty = __toESM(require_defineProperty(), 1);
+/**
+* Core action pipeline management system
+* @template T - Action payload map defining available actions and their payload types
+* @example
+* ```typescript
+* interface AppActions extends ActionPayloadMap {
+*   increment: void;
+*   setCount: number;
+* }
+* 
+* const actionRegister = new ActionRegister<AppActions>();
+* 
+* // Register handlers
+* actionRegister.register('increment', () => console.log('Incremented'));
+* actionRegister.register('setCount', (count) => console.log(`Count: ${count}`));
+* 
+* // Dispatch actions
+* await actionRegister.dispatch('increment');
+* await actionRegister.dispatch('setCount', 42);
+* ```
+*/
 var ActionRegister = class {
-	constructor() {
+	constructor(config) {
 		(0, import_defineProperty.default)(this, "pipelines", /* @__PURE__ */ new Map());
 		(0, import_defineProperty.default)(this, "atomSetters", /* @__PURE__ */ new Map());
+		(0, import_defineProperty.default)(this, "handlerCounter", 0);
+		(0, import_defineProperty.default)(this, "logger", void 0);
+		const envLogLevel = getLogLevelFromEnv();
+		const configLogLevel = config?.logLevel ?? envLogLevel;
+		if (config?.logger) this.logger = config.logger;
+		else if (config?.useOtel) this.logger = new OtelConsoleLogger(configLogLevel);
+		else this.logger = new ConsoleLogger(configLogLevel);
+		if (config?.otelContext && this.logger instanceof OtelConsoleLogger) this.logger.setContext(config.otelContext);
+		this.logger.debug("ActionRegister initialized", {
+			logLevel: configLogLevel,
+			useOtel: config?.useOtel ?? false,
+			hasOtelContext: !!config?.otelContext
+		});
 	}
+	/**
+	* Register a handler for an action in the pipeline
+	* @param action - The action name to handle
+	* @param handler - The handler function to execute
+	* @param config - Optional configuration for the handler
+	* @returns Unregister function to remove the handler
+	* @example
+	* ```typescript
+	* const unregister = actionRegister.register('increment', () => {
+	*   console.log('Incremented!');
+	* }, { priority: 10 });
+	* 
+	* // Later, remove the handler
+	* unregister();
+	* ```
+	*/
 	register(action, handler, config = {}) {
-		if (!this.pipelines.has(action)) this.pipelines.set(action, /* @__PURE__ */ new Map());
+		if (!this.pipelines.has(action)) {
+			this.pipelines.set(action, /* @__PURE__ */ new Map());
+			this.logger.debug(`Created new pipeline for action: ${String(action)}`);
+		}
 		const pipeline = this.pipelines.get(action);
-		const handlerId = config.id || `handler_${Date.now()}_${Math.random()}`;
+		const handlerId = config.id || `handler_${++this.handlerCounter}`;
 		if (pipeline.has(handlerId)) {
-			console.warn(`Handler with id ${handlerId} already exists`);
+			this.logger.warn(`Handler with id ${handlerId} already exists for action: ${String(action)}`);
 			return () => {};
 		}
 		pipeline.set(handlerId, {
 			handler,
 			config
 		});
+		this.logger.debug(`Registered handler for action: ${String(action)}`, {
+			handlerId,
+			priority: config.priority ?? 0,
+			blocking: config.blocking ?? false
+		});
 		this.sortPipeline(action);
 		return () => {
 			pipeline.delete(handlerId);
+			this.logger.debug(`Unregistered handler: ${handlerId} for action: ${String(action)}`);
 		};
 	}
 	registerAtomSetter(name, setter) {
 		this.atomSetters.set(name, setter);
+		this.logger.debug(`Registered atom setter: ${name}`);
 	}
+	/**
+	* Internal dispatch implementation
+	* @internal
+	*/
 	async dispatch(action, payload) {
 		const pipeline = this.pipelines.get(action);
+		if (this.logger instanceof OtelConsoleLogger && payload) {
+			const otelContext = createOtelContextFromPayload(payload);
+			if (otelContext.traceId || otelContext.sessionId) this.logger.setContext(otelContext);
+		}
+		this.logger.debug(`Dispatching action: ${String(action)}`, { payload });
 		if (!pipeline || pipeline.size === 0) {
-			console.warn(`No handlers registered for action: ${String(action)}`);
+			this.logger.warn(`No handlers registered for action: ${String(action)}`);
 			return;
 		}
 		let modifiedPayload = payload;
 		const handlers = Array.from(pipeline.values());
+		let shouldContinue = true;
+		this.logger.trace(`Executing pipeline for action: ${String(action)}`, { handlerCount: handlers.length });
 		for (const { handler, config } of handlers) {
-			let shouldContinue = true;
+			if (!shouldContinue) break;
 			const controller = {
 				next: () => {
 					shouldContinue = true;
 				},
 				abort: (reason) => {
 					shouldContinue = false;
-					console.log(`Pipeline aborted: ${reason}`);
+					this.logger.warn(`Pipeline aborted: ${reason}`);
 				},
 				modifyPayload: (modifier) => {
 					modifiedPayload = modifier(modifiedPayload);
+					this.logger.trace(`Payload modified for action: ${String(action)}`);
 				}
 			};
 			try {
 				if (config.blocking) await handler(modifiedPayload, controller);
 				else handler(modifiedPayload, controller);
-				if (!shouldContinue) break;
 			} catch (error) {
-				console.error(`Error in pipeline handler:`, error);
+				this.logger.error(`Error in pipeline handler for action: ${String(action)}`, error);
 				if (config.blocking) throw error;
 			}
 		}
+		this.logger.debug(`Completed dispatching action: ${String(action)}`);
 	}
 	sortPipeline(action) {
 		const pipeline = this.pipelines.get(action);
@@ -152,6 +395,10 @@ var ActionRegister = class {
 		});
 		pipeline.clear();
 		sorted.forEach(([id, data]) => pipeline.set(id, data));
+		this.logger.trace(`Sorted pipeline for action: ${String(action)}`, {
+			handlerCount: sorted.length,
+			priorities: sorted.map(([, data]) => data.config.priority ?? 0)
+		});
 	}
 };
 
@@ -169,5 +416,13 @@ function isAction(action, type) {
 
 //#endregion
 exports.ActionRegister = ActionRegister;
+exports.ConsoleLogger = ConsoleLogger;
+exports.LogLevel = LogLevel;
+exports.OtelConsoleLogger = OtelConsoleLogger;
 exports.createAction = createAction;
-exports.isAction = isAction;
+exports.createOtelContextFromPayload = createOtelContextFromPayload;
+exports.extractSessionIdFromPayload = extractSessionIdFromPayload;
+exports.extractTraceIdFromPayload = extractTraceIdFromPayload;
+exports.getLogLevelFromEnv = getLogLevelFromEnv;
+exports.isAction = isAction;
+exports.parseLogLevel = parseLogLevel;

package/dist/index.d.cts

@@ -1,22 +1,224 @@
+//#region src/logger.d.ts
+/**
+ * Log levels in order of severity (lowest to highest)
+ */
+declare enum LogLevel {
+  TRACE = 0,
+  DEBUG = 1,
+  INFO = 2,
+  WARN = 3,
+  ERROR = 4,
+  FATAL = 5,
+}
+/**
+ * Logger interface for custom logger implementations
+ */
+interface Logger {
+  trace(message: string, ...args: any[]): void;
+  debug(message: string, ...args: any[]): void;
+  info(message: string, ...args: any[]): void;
+  warn(message: string, ...args: any[]): void;
+  error(message: string, ...args: any[]): void;
+  fatal(message: string, ...args: any[]): void;
+}
+/**
+ * Default console logger implementation
+ */
+declare class ConsoleLogger implements Logger {
+  private level;
+  constructor(level?: LogLevel);
+  protected shouldLog(level: LogLevel): boolean;
+  private formatMessage;
+  trace(message: string, ...args: any[]): void;
+  debug(message: string, ...args: any[]): void;
+  info(message: string, ...args: any[]): void;
+  warn(message: string, ...args: any[]): void;
+  error(message: string, ...args: any[]): void;
+  fatal(message: string, ...args: any[]): void;
+  setLevel(level: LogLevel): void;
+}
+/**
+ * Parse log level from string
+ */
+declare function parseLogLevel(level: string): LogLevel;
+/**
+ * Get log level from environment variable or default to ERROR
+ */
+declare function getLogLevelFromEnv(): LogLevel;
+/**
+ * Extract trace ID from payload if it exists
+ */
+declare function extractTraceIdFromPayload(payload: any): string | undefined;
+/**
+ * Extract session ID from payload if it exists
+ */
+declare function extractSessionIdFromPayload(payload: any): string | undefined;
+/**
+ * Create OTEL context from payload
+ */
+declare function createOtelContextFromPayload(payload: any): OtelContext;
+/**
+ * OpenTelemetry context interface for tracing
+ */
+interface OtelContext {
+  /** Session ID for tracking user sessions */
+  sessionId?: string;
+  /** Trace ID for distributed tracing */
+  traceId?: string;
+  /** Span ID for current operation */
+  spanId?: string;
+  /** Parent span ID for operation hierarchy */
+  parentSpanId?: string;
+  /** Additional context metadata */
+  metadata?: Record<string, any>;
+}
+/**
+ * Extended logger interface with OpenTelemetry support
+ */
+interface OtelLogger extends Logger {
+  /** Set OpenTelemetry context */
+  setContext(context: OtelContext): void;
+  /** Get current OpenTelemetry context */
+  getContext(): OtelContext;
+  /** Clear OpenTelemetry context */
+  clearContext(): void;
+  /** Log with OpenTelemetry context */
+  logWithContext(level: LogLevel, message: string, ...args: any[]): void;
+}
+/**
+ * OpenTelemetry-aware console logger implementation
+ */
+declare class OtelConsoleLogger extends ConsoleLogger implements OtelLogger {
+  private context;
+  constructor(level?: LogLevel);
+  setContext(context: OtelContext): void;
+  getContext(): OtelContext;
+  clearContext(): void;
+  private formatWithContext;
+  logWithContext(level: LogLevel, message: string, ...args: any[]): void;
+  trace(message: string, ...args: any[]): void;
+  debug(message: string, ...args: any[]): void;
+  info(message: string, ...args: any[]): void;
+  warn(message: string, ...args: any[]): void;
+  error(message: string, ...args: any[]): void;
+  fatal(message: string, ...args: any[]): void;
+}
+//# sourceMappingURL=logger.d.ts.map
+//#endregion
 //#region src/ActionRegister.d.ts
+/**
+ * Controller object provided to action handlers for pipeline management
+ * @template T - The type of the payload being processed
+ */
 type PipelineController<T = any> = {
+  /** Continue to the next handler in the pipeline */
   next: () => void;
+  /** Abort the pipeline execution with an optional reason */
   abort: (reason?: string) => void;
+  /** Modify the payload that will be passed to subsequent handlers */
   modifyPayload: (modifier: (payload: T) => T) => void;
 };
+/**
+ * Action handler function that processes actions in the pipeline
+ * @template T - The type of the payload
+ * @param payload - The data passed to the handler
+ * @param controller - Pipeline controller for flow management
+ * @returns void or Promise<void> for async handlers
+ */
 type ActionHandler<T = any> = (payload: T, controller: PipelineController<T>) => void | Promise<void>;
+/**
+ * Configuration options for action handlers
+ */
 type HandlerConfig = {
+  /** Priority level (higher numbers execute first). Default: 0 */
   priority?: number;
+  /** Unique identifier for the handler. Auto-generated if not provided */
   id?: string;
+  /** Whether to wait for async handlers to complete. Default: false */
   blocking?: boolean;
 };
+/**
+ * Base interface for defining action payload mappings
+ * @example
+ * ```typescript
+ * interface MyActions extends ActionPayloadMap {
+ *   increment: void;
+ *   setCount: number;
+ *   updateUser: { id: string; name: string };
+ * }
+ * ```
+ */
 interface ActionPayloadMap {}
+/**
+ * Configuration options for ActionRegister
+ */
+interface ActionRegisterConfig {
+  /** Custom logger implementation. Defaults to ConsoleLogger */
+  logger?: Logger;
+  /** Log level for the logger. Defaults to ERROR if not provided */
+  logLevel?: LogLevel;
+  /** OpenTelemetry context for tracing */
+  otelContext?: OtelContext;
+  /** Whether to use OTEL-aware logger. Defaults to false */
+  useOtel?: boolean;
+}
+/**
+ * Core action pipeline management system
+ * @template T - Action payload map defining available actions and their payload types
+ * @example
+ * ```typescript
+ * interface AppActions extends ActionPayloadMap {
+ *   increment: void;
+ *   setCount: number;
+ * }
+ *
+ * const actionRegister = new ActionRegister<AppActions>();
+ *
+ * // Register handlers
+ * actionRegister.register('increment', () => console.log('Incremented'));
+ * actionRegister.register('setCount', (count) => console.log(`Count: ${count}`));
+ *
+ * // Dispatch actions
+ * await actionRegister.dispatch('increment');
+ * await actionRegister.dispatch('setCount', 42);
+ * ```
+ */
 declare class ActionRegister<T extends ActionPayloadMap = ActionPayloadMap> {
   private pipelines;
   private atomSetters;
+  private handlerCounter;
+  readonly logger: Logger;
+  constructor(config?: ActionRegisterConfig);
+  /**
+   * Register a handler for an action in the pipeline
+   * @param action - The action name to handle
+   * @param handler - The handler function to execute
+   * @param config - Optional configuration for the handler
+   * @returns Unregister function to remove the handler
+   * @example
+   * ```typescript
+   * const unregister = actionRegister.register('increment', () => {
+   *   console.log('Incremented!');
+   * }, { priority: 10 });
+   *
+   * // Later, remove the handler
+   * unregister();
+   * ```
+   */
   register<K extends keyof T>(action: K, handler: ActionHandler<T[K]>, config?: HandlerConfig): () => void;
   registerAtomSetter(name: string, setter: Function): void;
+  /**
+   * Dispatch an action through the pipeline (for actions without payload)
+   * @param action - The action to dispatch
+   * @returns Promise that resolves when all handlers complete
+   */
   dispatch<K extends keyof T>(action: T[K] extends void ? K : never): Promise<void>;
+  /**
+   * Dispatch an action through the pipeline (for actions with payload)
+   * @param action - The action to dispatch
+   * @param payload - The payload data to pass to handlers
+   * @returns Promise that resolves when all handlers complete
+   */
   dispatch<K extends keyof T>(action: K, payload: T[K]): Promise<void>;
   private sortPipeline;
 }
@@ -38,5 +240,5 @@ declare function isAction<T extends Record<string, any>, K extends keyof T>(acti
 //# sourceMappingURL=types.d.ts.map
 
 //#endregion
-export { ActionHandler, ActionHandlerMap, ActionPayload, ActionPayloadMap, ActionRegister, ActionType, BaseActionPayloadMap, HandlerConfig, PipelineController, createAction, isAction };
+export { ActionHandler, ActionHandlerMap, ActionPayload, ActionPayloadMap, ActionRegister, ActionRegisterConfig, ActionType, BaseActionPayloadMap, ConsoleLogger, HandlerConfig, LogLevel, Logger, OtelConsoleLogger, OtelContext, OtelLogger, PipelineController, createAction, createOtelContextFromPayload, extractSessionIdFromPayload, extractTraceIdFromPayload, getLogLevelFromEnv, isAction, parseLogLevel };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/ActionRegister.ts","../src/types.ts"],"sourcesContent":[],"mappings":";KACY;EAAA,IAAA,EAAA,GAAA,GAAA,IAAA;EAAkB,KAAA,EAAA,CAAA,MAAA,CAAA,EAAA,MAAA,EAAA,GAAA,IAAA;EAAA,aAGQ,EAAA,CAAA,QAAA,EAAA,CAAA,OAAA,EAAA,CAAA,EAAA,GAAM,CAAN,EAAA,GAAA,IAAA;CAAC;AAAM,KAGjC,aAHiC,CAAA,IAAA,GAAA,CAAA,GAAA,CAAA,OAAA,EAIlC,CAJkC,EAAA,UAAA,EAK/B,kBAL+B,CAKZ,CALY,CAAA,EAAA,GAAA,IAAA,GAMjC,OANiC,CAAA,IAAA,CAAA;AAGjC,KAKA,aAAA,GALa;EAAA,QAAA,CAAA,EAAA,MAAA;EAAA,EAAA,CACd,EAAA,MAAA;EAAC,QACqB,CAAA,EAAA,OAAA;CAAC;AACtB,UASK,gBAAA,CATL,CAAO;AAEP,cAaC,cAbY,CAAA,UAaa,gBAbb,GAagC,gBAbhC,CAAA,CAAA;EAOR,QAAA,SAAA;EAMJ,QAAA,WAAc;EAAA,QAAA,CAAA,UAAA,MASA,CATA,CAAA,CAAA,MAAA,EAUf,CAVe,EAAA,OAAA,EAWd,aAXc,CAWA,CAXA,CAWE,CAXF,CAAA,CAAA,EAAA,MAAA,CAAA,EAYf,aAZe,CAAA,EAAA,GAAA,GAAA,IAAA;EAAA,kBAAW,CAAA,IAAA,EAAA,MAAA,EAAA,MAAA,EAuCK,QAvCL,CAAA,EAAA,IAAA;EAAgB,QAAG,CAAA,UAAA,MA4CxB,CA5CwB,CAAA,CAAA,MAAA,EA6C7C,CA7C6C,CA6C3C,CA7C2C,CAAA,SAAA,IAAA,GA6CzB,CA7CyB,GAAA,KAAA,CAAA,EA8CpD,OA9CoD,CAAA,IAAA,CAAA;EAAgB,QAS9C,CAAA,UAAA,MAsCM,CAtCN,CAAA,CAAA,MAAA,EAuCf,CAvCe,EAAA,OAAA,EAwCd,CAxCc,CAwCZ,CAxCY,CAAA,CAAA,EAyCtB,OAzCsB,CAAA,IAAA,CAAA;EAAC,QAChB,YAAA;;;;;UClCK,oBAAA,EDAjB;AAA8B,KCKlB,UDLkB,CAAA,UCKG,MDLH,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,GAAA,MCKgC,CDLhC;AAGQ,KCG1B,aDH0B,CAAA,UCI1B,MDJ0B,CAAA,MAAA,EAAA,GAAA,CAAA,EAAA,UAAA,MCKpB,CDLoB,CAAA,GCMlC,CDNkC,CCMhC,CDNgC,CAAA;AAAM,KCShC,gBDTgC,CAAA,UCSL,MDTK,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,GAAA,QAAC,MCU/B,CDV+B,IAAA,CAAA,OAAA,ECUhB,CDVgB,CCUd,CDVc,CAAA,EAAA,GAAA,IAAA,GCUA,ODVA,CAAA,IAAA,CAAA,EAG7C;AAAyB,iBCWT,YDXS,CAAA,UCWc,MDXd,CAAA,MAAA,EAAA,GAAA,CAAA,EAAA,UAAA,MCWmD,CDXnD,CAAA,CAAA,IAAA,ECYjB,CDZiB,EAAA,OAAA,ECad,CDbc,CCaZ,CDbY,CAAA,CAAA,EAAA;EAAA,IACd,ECaA,CDbA;EAAC,OACqB,ECYV,CDZU,CCYR,CDZQ,CAAA;CAAC;AACtB,iBCgBI,QDhBJ,CAAA,UCgBuB,MDhBvB,CAAA,MAAA,EAAA,GAAA,CAAA,EAAA,UAAA,MCgB4D,CDhB5D,CAAA,CAAA,MAAA,EAAA,GAAA,EAAA,IAAA,ECkBJ,CDlBI,CAAA,EAAA,MAAA,IAAA;EAAO,IAAA,ECmBE,CDnBF;EAEP,OAAA,ECiBqB,CDjBrB,CCiBuB,CDjBvB,CAAA;AAOZ,CAAA;AAMA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/logger.ts","../src/ActionRegister.ts","../src/types.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,22 +1,224 @@
+//#region src/logger.d.ts
+/**
+ * Log levels in order of severity (lowest to highest)
+ */
+declare enum LogLevel {
+  TRACE = 0,
+  DEBUG = 1,
+  INFO = 2,
+  WARN = 3,
+  ERROR = 4,
+  FATAL = 5,
+}
+/**
+ * Logger interface for custom logger implementations
+ */
+interface Logger {
+  trace(message: string, ...args: any[]): void;
+  debug(message: string, ...args: any[]): void;
+  info(message: string, ...args: any[]): void;
+  warn(message: string, ...args: any[]): void;
+  error(message: string, ...args: any[]): void;
+  fatal(message: string, ...args: any[]): void;
+}
+/**
+ * Default console logger implementation
+ */
+declare class ConsoleLogger implements Logger {
+  private level;
+  constructor(level?: LogLevel);
+  protected shouldLog(level: LogLevel): boolean;
+  private formatMessage;
+  trace(message: string, ...args: any[]): void;
+  debug(message: string, ...args: any[]): void;
+  info(message: string, ...args: any[]): void;
+  warn(message: string, ...args: any[]): void;
+  error(message: string, ...args: any[]): void;
+  fatal(message: string, ...args: any[]): void;
+  setLevel(level: LogLevel): void;
+}
+/**
+ * Parse log level from string
+ */
+declare function parseLogLevel(level: string): LogLevel;
+/**
+ * Get log level from environment variable or default to ERROR
+ */
+declare function getLogLevelFromEnv(): LogLevel;
+/**
+ * Extract trace ID from payload if it exists
+ */
+declare function extractTraceIdFromPayload(payload: any): string | undefined;
+/**
+ * Extract session ID from payload if it exists
+ */
+declare function extractSessionIdFromPayload(payload: any): string | undefined;
+/**
+ * Create OTEL context from payload
+ */
+declare function createOtelContextFromPayload(payload: any): OtelContext;
+/**
+ * OpenTelemetry context interface for tracing
+ */
+interface OtelContext {
+  /** Session ID for tracking user sessions */
+  sessionId?: string;
+  /** Trace ID for distributed tracing */
+  traceId?: string;
+  /** Span ID for current operation */
+  spanId?: string;
+  /** Parent span ID for operation hierarchy */
+  parentSpanId?: string;
+  /** Additional context metadata */
+  metadata?: Record<string, any>;
+}
+/**
+ * Extended logger interface with OpenTelemetry support
+ */
+interface OtelLogger extends Logger {
+  /** Set OpenTelemetry context */
+  setContext(context: OtelContext): void;
+  /** Get current OpenTelemetry context */
+  getContext(): OtelContext;
+  /** Clear OpenTelemetry context */
+  clearContext(): void;
+  /** Log with OpenTelemetry context */
+  logWithContext(level: LogLevel, message: string, ...args: any[]): void;
+}
+/**
+ * OpenTelemetry-aware console logger implementation
+ */
+declare class OtelConsoleLogger extends ConsoleLogger implements OtelLogger {
+  private context;
+  constructor(level?: LogLevel);
+  setContext(context: OtelContext): void;
+  getContext(): OtelContext;
+  clearContext(): void;
+  private formatWithContext;
+  logWithContext(level: LogLevel, message: string, ...args: any[]): void;
+  trace(message: string, ...args: any[]): void;
+  debug(message: string, ...args: any[]): void;
+  info(message: string, ...args: any[]): void;
+  warn(message: string, ...args: any[]): void;
+  error(message: string, ...args: any[]): void;
+  fatal(message: string, ...args: any[]): void;
+}
+//# sourceMappingURL=logger.d.ts.map
+//#endregion
 //#region src/ActionRegister.d.ts
+/**
+ * Controller object provided to action handlers for pipeline management
+ * @template T - The type of the payload being processed
+ */
 type PipelineController<T = any> = {
+  /** Continue to the next handler in the pipeline */
   next: () => void;
+  /** Abort the pipeline execution with an optional reason */
   abort: (reason?: string) => void;
+  /** Modify the payload that will be passed to subsequent handlers */
   modifyPayload: (modifier: (payload: T) => T) => void;
 };
+/**
+ * Action handler function that processes actions in the pipeline
+ * @template T - The type of the payload
+ * @param payload - The data passed to the handler
+ * @param controller - Pipeline controller for flow management
+ * @returns void or Promise<void> for async handlers
+ */
 type ActionHandler<T = any> = (payload: T, controller: PipelineController<T>) => void | Promise<void>;
+/**
+ * Configuration options for action handlers
+ */
 type HandlerConfig = {
+  /** Priority level (higher numbers execute first). Default: 0 */
   priority?: number;
+  /** Unique identifier for the handler. Auto-generated if not provided */
   id?: string;
+  /** Whether to wait for async handlers to complete. Default: false */
   blocking?: boolean;
 };
+/**
+ * Base interface for defining action payload mappings
+ * @example
+ * ```typescript
+ * interface MyActions extends ActionPayloadMap {
+ *   increment: void;
+ *   setCount: number;
+ *   updateUser: { id: string; name: string };
+ * }
+ * ```
+ */
 interface ActionPayloadMap {}
+/**
+ * Configuration options for ActionRegister
+ */
+interface ActionRegisterConfig {
+  /** Custom logger implementation. Defaults to ConsoleLogger */
+  logger?: Logger;
+  /** Log level for the logger. Defaults to ERROR if not provided */
+  logLevel?: LogLevel;
+  /** OpenTelemetry context for tracing */
+  otelContext?: OtelContext;
+  /** Whether to use OTEL-aware logger. Defaults to false */
+  useOtel?: boolean;
+}
+/**
+ * Core action pipeline management system
+ * @template T - Action payload map defining available actions and their payload types
+ * @example
+ * ```typescript
+ * interface AppActions extends ActionPayloadMap {
+ *   increment: void;
+ *   setCount: number;
+ * }
+ *
+ * const actionRegister = new ActionRegister<AppActions>();
+ *
+ * // Register handlers
+ * actionRegister.register('increment', () => console.log('Incremented'));
+ * actionRegister.register('setCount', (count) => console.log(`Count: ${count}`));
+ *
+ * // Dispatch actions
+ * await actionRegister.dispatch('increment');
+ * await actionRegister.dispatch('setCount', 42);
+ * ```
+ */
 declare class ActionRegister<T extends ActionPayloadMap = ActionPayloadMap> {
   private pipelines;
   private atomSetters;
+  private handlerCounter;
+  readonly logger: Logger;
+  constructor(config?: ActionRegisterConfig);
+  /**
+   * Register a handler for an action in the pipeline
+   * @param action - The action name to handle
+   * @param handler - The handler function to execute
+   * @param config - Optional configuration for the handler
+   * @returns Unregister function to remove the handler
+   * @example
+   * ```typescript
+   * const unregister = actionRegister.register('increment', () => {
+   *   console.log('Incremented!');
+   * }, { priority: 10 });
+   *
+   * // Later, remove the handler
+   * unregister();
+   * ```
+   */
   register<K extends keyof T>(action: K, handler: ActionHandler<T[K]>, config?: HandlerConfig): () => void;
   registerAtomSetter(name: string, setter: Function): void;
+  /**
+   * Dispatch an action through the pipeline (for actions without payload)
+   * @param action - The action to dispatch
+   * @returns Promise that resolves when all handlers complete
+   */
   dispatch<K extends keyof T>(action: T[K] extends void ? K : never): Promise<void>;
+  /**
+   * Dispatch an action through the pipeline (for actions with payload)
+   * @param action - The action to dispatch
+   * @param payload - The payload data to pass to handlers
+   * @returns Promise that resolves when all handlers complete
+   */
   dispatch<K extends keyof T>(action: K, payload: T[K]): Promise<void>;
   private sortPipeline;
 }
@@ -38,5 +240,5 @@ declare function isAction<T extends Record<string, any>, K extends keyof T>(acti
 //# sourceMappingURL=types.d.ts.map
 
 //#endregion
-export { ActionHandler, ActionHandlerMap, ActionPayload, ActionPayloadMap, ActionRegister, ActionType, BaseActionPayloadMap, HandlerConfig, PipelineController, createAction, isAction };
+export { ActionHandler, ActionHandlerMap, ActionPayload, ActionPayloadMap, ActionRegister, ActionRegisterConfig, ActionType, BaseActionPayloadMap, ConsoleLogger, HandlerConfig, LogLevel, Logger, OtelConsoleLogger, OtelContext, OtelLogger, PipelineController, createAction, createOtelContextFromPayload, extractSessionIdFromPayload, extractTraceIdFromPayload, getLogLevelFromEnv, isAction, parseLogLevel };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/ActionRegister.ts","../src/types.ts"],"sourcesContent":[],"mappings":";KACY;EAAA,IAAA,EAAA,GAAA,GAAA,IAAA;EAAkB,KAAA,EAAA,CAAA,MAAA,CAAA,EAAA,MAAA,EAAA,GAAA,IAAA;EAAA,aAGQ,EAAA,CAAA,QAAA,EAAA,CAAA,OAAA,EAAA,CAAA,EAAA,GAAM,CAAN,EAAA,GAAA,IAAA;CAAC;AAAM,KAGjC,aAHiC,CAAA,IAAA,GAAA,CAAA,GAAA,CAAA,OAAA,EAIlC,CAJkC,EAAA,UAAA,EAK/B,kBAL+B,CAKZ,CALY,CAAA,EAAA,GAAA,IAAA,GAMjC,OANiC,CAAA,IAAA,CAAA;AAGjC,KAKA,aAAA,GALa;EAAA,QAAA,CAAA,EAAA,MAAA;EAAA,EAAA,CACd,EAAA,MAAA;EAAC,QACqB,CAAA,EAAA,OAAA;CAAC;AACtB,UASK,gBAAA,CATL,CAAO;AAEP,cAaC,cAbY,CAAA,UAaa,gBAbb,GAagC,gBAbhC,CAAA,CAAA;EAOR,QAAA,SAAA;EAMJ,QAAA,WAAc;EAAA,QAAA,CAAA,UAAA,MASA,CATA,CAAA,CAAA,MAAA,EAUf,CAVe,EAAA,OAAA,EAWd,aAXc,CAWA,CAXA,CAWE,CAXF,CAAA,CAAA,EAAA,MAAA,CAAA,EAYf,aAZe,CAAA,EAAA,GAAA,GAAA,IAAA;EAAA,kBAAW,CAAA,IAAA,EAAA,MAAA,EAAA,MAAA,EAuCK,QAvCL,CAAA,EAAA,IAAA;EAAgB,QAAG,CAAA,UAAA,MA4CxB,CA5CwB,CAAA,CAAA,MAAA,EA6C7C,CA7C6C,CA6C3C,CA7C2C,CAAA,SAAA,IAAA,GA6CzB,CA7CyB,GAAA,KAAA,CAAA,EA8CpD,OA9CoD,CAAA,IAAA,CAAA;EAAgB,QAS9C,CAAA,UAAA,MAsCM,CAtCN,CAAA,CAAA,MAAA,EAuCf,CAvCe,EAAA,OAAA,EAwCd,CAxCc,CAwCZ,CAxCY,CAAA,CAAA,EAyCtB,OAzCsB,CAAA,IAAA,CAAA;EAAC,QAChB,YAAA;;;;;UClCK,oBAAA,EDAjB;AAA8B,KCKlB,UDLkB,CAAA,UCKG,MDLH,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,GAAA,MCKgC,CDLhC;AAGQ,KCG1B,aDH0B,CAAA,UCI1B,MDJ0B,CAAA,MAAA,EAAA,GAAA,CAAA,EAAA,UAAA,MCKpB,CDLoB,CAAA,GCMlC,CDNkC,CCMhC,CDNgC,CAAA;AAAM,KCShC,gBDTgC,CAAA,UCSL,MDTK,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,GAAA,QAAC,MCU/B,CDV+B,IAAA,CAAA,OAAA,ECUhB,CDVgB,CCUd,CDVc,CAAA,EAAA,GAAA,IAAA,GCUA,ODVA,CAAA,IAAA,CAAA,EAG7C;AAAyB,iBCWT,YDXS,CAAA,UCWc,MDXd,CAAA,MAAA,EAAA,GAAA,CAAA,EAAA,UAAA,MCWmD,CDXnD,CAAA,CAAA,IAAA,ECYjB,CDZiB,EAAA,OAAA,ECad,CDbc,CCaZ,CDbY,CAAA,CAAA,EAAA;EAAA,IACd,ECaA,CDbA;EAAC,OACqB,ECYV,CDZU,CCYR,CDZQ,CAAA;CAAC;AACtB,iBCgBI,QDhBJ,CAAA,UCgBuB,MDhBvB,CAAA,MAAA,EAAA,GAAA,CAAA,EAAA,UAAA,MCgB4D,CDhB5D,CAAA,CAAA,MAAA,EAAA,GAAA,EAAA,IAAA,ECkBJ,CDlBI,CAAA,EAAA,MAAA,IAAA;EAAO,IAAA,ECmBE,CDnBF;EAEP,OAAA,ECiBqB,CDjBrB,CCiBuB,CDjBvB,CAAA;AAOZ,CAAA;AAMA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/logger.ts","../src/ActionRegister.ts","../src/types.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.js

@@ -70,7 +70,7 @@ var require_toPropertyKey = __commonJS({ "../../node_modules/.pnpm/@oxc-project+
 //#region ../../node_modules/.pnpm/@oxc-project+runtime@0.77.3/node_modules/@oxc-project/runtime/src/helpers/defineProperty.js
 var require_defineProperty = __commonJS({ "../../node_modules/.pnpm/@oxc-project+runtime@0.77.3/node_modules/@oxc-project/runtime/src/helpers/defineProperty.js"(exports, module) {
 	var toPropertyKey = require_toPropertyKey();
-	function _defineProperty$1(e, r, t) {
+	function _defineProperty$2(e, r, t) {
 		return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
 			value: t,
 			enumerable: !0,
@@ -78,68 +78,311 @@ var require_defineProperty = __commonJS({ "../../node_modules/.pnpm/@oxc-project
 			writable: !0
 		}) : e[r] = t, e;
 	}
-	module.exports = _defineProperty$1, module.exports.__esModule = true, module.exports["default"] = module.exports;
+	module.exports = _defineProperty$2, module.exports.__esModule = true, module.exports["default"] = module.exports;
 } });
 
+//#endregion
+//#region src/logger.ts
+var import_defineProperty$1 = __toESM(require_defineProperty(), 1);
+/**
+* Log levels in order of severity (lowest to highest)
+*/
+let LogLevel = /* @__PURE__ */ function(LogLevel$1) {
+	LogLevel$1[LogLevel$1["TRACE"] = 0] = "TRACE";
+	LogLevel$1[LogLevel$1["DEBUG"] = 1] = "DEBUG";
+	LogLevel$1[LogLevel$1["INFO"] = 2] = "INFO";
+	LogLevel$1[LogLevel$1["WARN"] = 3] = "WARN";
+	LogLevel$1[LogLevel$1["ERROR"] = 4] = "ERROR";
+	LogLevel$1[LogLevel$1["FATAL"] = 5] = "FATAL";
+	return LogLevel$1;
+}({});
+/**
+* Default console logger implementation
+*/
+var ConsoleLogger = class {
+	constructor(level = LogLevel.ERROR) {
+		this.level = level;
+	}
+	shouldLog(level) {
+		return level >= this.level;
+	}
+	formatMessage(level, message) {
+		return `[${level.toUpperCase()}] ${message}`;
+	}
+	trace(message, ...args) {
+		if (this.shouldLog(LogLevel.TRACE)) console.trace(this.formatMessage("trace", message), ...args);
+	}
+	debug(message, ...args) {
+		if (this.shouldLog(LogLevel.DEBUG)) console.debug(this.formatMessage("debug", message), ...args);
+	}
+	info(message, ...args) {
+		if (this.shouldLog(LogLevel.INFO)) console.info(this.formatMessage("info", message), ...args);
+	}
+	warn(message, ...args) {
+		if (this.shouldLog(LogLevel.WARN)) console.warn(this.formatMessage("warn", message), ...args);
+	}
+	error(message, ...args) {
+		if (this.shouldLog(LogLevel.ERROR)) console.error(this.formatMessage("error", message), ...args);
+	}
+	fatal(message, ...args) {
+		if (this.shouldLog(LogLevel.FATAL)) console.error(this.formatMessage("fatal", message), ...args);
+	}
+	setLevel(level) {
+		this.level = level;
+	}
+};
+/**
+* Parse log level from string
+*/
+function parseLogLevel(level) {
+	const upperLevel = level.toUpperCase();
+	switch (upperLevel) {
+		case "TRACE": return LogLevel.TRACE;
+		case "DEBUG": return LogLevel.DEBUG;
+		case "INFO": return LogLevel.INFO;
+		case "WARN": return LogLevel.WARN;
+		case "ERROR": return LogLevel.ERROR;
+		case "FATAL": return LogLevel.FATAL;
+		default: return LogLevel.ERROR;
+	}
+}
+/**
+* Get log level from environment variable or default to ERROR
+*/
+function getLogLevelFromEnv() {
+	if (typeof process !== "undefined" && process.env) {
+		const envLevel = process.env.LOG_LEVEL || process.env.ACTION_LOG_LEVEL;
+		if (envLevel) return parseLogLevel(envLevel);
+	}
+	return LogLevel.TRACE;
+}
+/**
+* Extract trace ID from payload if it exists
+*/
+function extractTraceIdFromPayload(payload) {
+	if (payload && typeof payload === "object") return payload._traceId || payload.traceId || payload.trace_id;
+	return void 0;
+}
+/**
+* Extract session ID from payload if it exists
+*/
+function extractSessionIdFromPayload(payload) {
+	if (payload && typeof payload === "object") return payload._sessionId || payload.sessionId || payload.session_id;
+	return void 0;
+}
+/**
+* Create OTEL context from payload
+*/
+function createOtelContextFromPayload(payload) {
+	return {
+		traceId: extractTraceIdFromPayload(payload),
+		sessionId: extractSessionIdFromPayload(payload),
+		metadata: payload
+	};
+}
+/**
+* OpenTelemetry-aware console logger implementation
+*/
+var OtelConsoleLogger = class extends ConsoleLogger {
+	constructor(level = LogLevel.ERROR) {
+		super(level);
+		(0, import_defineProperty$1.default)(this, "context", {});
+	}
+	setContext(context) {
+		this.context = {
+			...this.context,
+			...context
+		};
+	}
+	getContext() {
+		return { ...this.context };
+	}
+	clearContext() {
+		this.context = {};
+	}
+	formatWithContext(level, message) {
+		const contextParts = [];
+		if (this.context.sessionId) contextParts.push(`session=${this.context.sessionId}`);
+		if (this.context.traceId) contextParts.push(`trace=${this.context.traceId}`);
+		if (this.context.spanId) contextParts.push(`span=${this.context.spanId}`);
+		const contextStr = contextParts.length > 0 ? ` [${contextParts.join(", ")}]` : "";
+		return `[${level.toUpperCase()}]${contextStr} ${message}`;
+	}
+	logWithContext(level, message, ...args) {
+		const levelName = LogLevel[level].toLowerCase();
+		const formattedMessage = this.formatWithContext(levelName, message);
+		switch (level) {
+			case LogLevel.TRACE:
+				if (this.shouldLog(LogLevel.TRACE)) console.trace(formattedMessage, ...args);
+				break;
+			case LogLevel.DEBUG:
+				if (this.shouldLog(LogLevel.DEBUG)) console.debug(formattedMessage, ...args);
+				break;
+			case LogLevel.INFO:
+				if (this.shouldLog(LogLevel.INFO)) console.info(formattedMessage, ...args);
+				break;
+			case LogLevel.WARN:
+				if (this.shouldLog(LogLevel.WARN)) console.warn(formattedMessage, ...args);
+				break;
+			case LogLevel.ERROR:
+				if (this.shouldLog(LogLevel.ERROR)) console.error(formattedMessage, ...args);
+				break;
+			case LogLevel.FATAL:
+				if (this.shouldLog(LogLevel.FATAL)) console.error(formattedMessage, ...args);
+				break;
+		}
+	}
+	trace(message, ...args) {
+		this.logWithContext(LogLevel.TRACE, message, ...args);
+	}
+	debug(message, ...args) {
+		this.logWithContext(LogLevel.DEBUG, message, ...args);
+	}
+	info(message, ...args) {
+		this.logWithContext(LogLevel.INFO, message, ...args);
+	}
+	warn(message, ...args) {
+		this.logWithContext(LogLevel.WARN, message, ...args);
+	}
+	error(message, ...args) {
+		this.logWithContext(LogLevel.ERROR, message, ...args);
+	}
+	fatal(message, ...args) {
+		this.logWithContext(LogLevel.FATAL, message, ...args);
+	}
+};
+
 //#endregion
 //#region src/ActionRegister.ts
 var import_defineProperty = __toESM(require_defineProperty(), 1);
+/**
+* Core action pipeline management system
+* @template T - Action payload map defining available actions and their payload types
+* @example
+* ```typescript
+* interface AppActions extends ActionPayloadMap {
+*   increment: void;
+*   setCount: number;
+* }
+* 
+* const actionRegister = new ActionRegister<AppActions>();
+* 
+* // Register handlers
+* actionRegister.register('increment', () => console.log('Incremented'));
+* actionRegister.register('setCount', (count) => console.log(`Count: ${count}`));
+* 
+* // Dispatch actions
+* await actionRegister.dispatch('increment');
+* await actionRegister.dispatch('setCount', 42);
+* ```
+*/
 var ActionRegister = class {
-	constructor() {
+	constructor(config) {
 		(0, import_defineProperty.default)(this, "pipelines", /* @__PURE__ */ new Map());
 		(0, import_defineProperty.default)(this, "atomSetters", /* @__PURE__ */ new Map());
+		(0, import_defineProperty.default)(this, "handlerCounter", 0);
+		(0, import_defineProperty.default)(this, "logger", void 0);
+		const envLogLevel = getLogLevelFromEnv();
+		const configLogLevel = config?.logLevel ?? envLogLevel;
+		if (config?.logger) this.logger = config.logger;
+		else if (config?.useOtel) this.logger = new OtelConsoleLogger(configLogLevel);
+		else this.logger = new ConsoleLogger(configLogLevel);
+		if (config?.otelContext && this.logger instanceof OtelConsoleLogger) this.logger.setContext(config.otelContext);
+		this.logger.debug("ActionRegister initialized", {
+			logLevel: configLogLevel,
+			useOtel: config?.useOtel ?? false,
+			hasOtelContext: !!config?.otelContext
+		});
 	}
+	/**
+	* Register a handler for an action in the pipeline
+	* @param action - The action name to handle
+	* @param handler - The handler function to execute
+	* @param config - Optional configuration for the handler
+	* @returns Unregister function to remove the handler
+	* @example
+	* ```typescript
+	* const unregister = actionRegister.register('increment', () => {
+	*   console.log('Incremented!');
+	* }, { priority: 10 });
+	* 
+	* // Later, remove the handler
+	* unregister();
+	* ```
+	*/
 	register(action, handler, config = {}) {
-		if (!this.pipelines.has(action)) this.pipelines.set(action, /* @__PURE__ */ new Map());
+		if (!this.pipelines.has(action)) {
+			this.pipelines.set(action, /* @__PURE__ */ new Map());
+			this.logger.debug(`Created new pipeline for action: ${String(action)}`);
+		}
 		const pipeline = this.pipelines.get(action);
-		const handlerId = config.id || `handler_${Date.now()}_${Math.random()}`;
+		const handlerId = config.id || `handler_${++this.handlerCounter}`;
 		if (pipeline.has(handlerId)) {
-			console.warn(`Handler with id ${handlerId} already exists`);
+			this.logger.warn(`Handler with id ${handlerId} already exists for action: ${String(action)}`);
 			return () => {};
 		}
 		pipeline.set(handlerId, {
 			handler,
 			config
 		});
+		this.logger.debug(`Registered handler for action: ${String(action)}`, {
+			handlerId,
+			priority: config.priority ?? 0,
+			blocking: config.blocking ?? false
+		});
 		this.sortPipeline(action);
 		return () => {
 			pipeline.delete(handlerId);
+			this.logger.debug(`Unregistered handler: ${handlerId} for action: ${String(action)}`);
 		};
 	}
 	registerAtomSetter(name, setter) {
 		this.atomSetters.set(name, setter);
+		this.logger.debug(`Registered atom setter: ${name}`);
 	}
+	/**
+	* Internal dispatch implementation
+	* @internal
+	*/
 	async dispatch(action, payload) {
 		const pipeline = this.pipelines.get(action);
+		if (this.logger instanceof OtelConsoleLogger && payload) {
+			const otelContext = createOtelContextFromPayload(payload);
+			if (otelContext.traceId || otelContext.sessionId) this.logger.setContext(otelContext);
+		}
+		this.logger.debug(`Dispatching action: ${String(action)}`, { payload });
 		if (!pipeline || pipeline.size === 0) {
-			console.warn(`No handlers registered for action: ${String(action)}`);
+			this.logger.warn(`No handlers registered for action: ${String(action)}`);
 			return;
 		}
 		let modifiedPayload = payload;
 		const handlers = Array.from(pipeline.values());
+		let shouldContinue = true;
+		this.logger.trace(`Executing pipeline for action: ${String(action)}`, { handlerCount: handlers.length });
 		for (const { handler, config } of handlers) {
-			let shouldContinue = true;
+			if (!shouldContinue) break;
 			const controller = {
 				next: () => {
 					shouldContinue = true;
 				},
 				abort: (reason) => {
 					shouldContinue = false;
-					console.log(`Pipeline aborted: ${reason}`);
+					this.logger.warn(`Pipeline aborted: ${reason}`);
 				},
 				modifyPayload: (modifier) => {
 					modifiedPayload = modifier(modifiedPayload);
+					this.logger.trace(`Payload modified for action: ${String(action)}`);
 				}
 			};
 			try {
 				if (config.blocking) await handler(modifiedPayload, controller);
 				else handler(modifiedPayload, controller);
-				if (!shouldContinue) break;
 			} catch (error) {
-				console.error(`Error in pipeline handler:`, error);
+				this.logger.error(`Error in pipeline handler for action: ${String(action)}`, error);
 				if (config.blocking) throw error;
 			}
 		}
+		this.logger.debug(`Completed dispatching action: ${String(action)}`);
 	}
 	sortPipeline(action) {
 		const pipeline = this.pipelines.get(action);
@@ -151,6 +394,10 @@ var ActionRegister = class {
 		});
 		pipeline.clear();
 		sorted.forEach(([id, data]) => pipeline.set(id, data));
+		this.logger.trace(`Sorted pipeline for action: ${String(action)}`, {
+			handlerCount: sorted.length,
+			priorities: sorted.map(([, data]) => data.config.priority ?? 0)
+		});
 	}
 };
 
@@ -167,5 +414,5 @@ function isAction(action, type) {
 }
 
 //#endregion
-export { ActionRegister, createAction, isAction };
+export { ActionRegister, ConsoleLogger, LogLevel, OtelConsoleLogger, createAction, createOtelContextFromPayload, extractSessionIdFromPayload, extractTraceIdFromPayload, getLogLevelFromEnv, isAction, parseLogLevel };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["_typeof","o","_typeof","toPrimitive","toPropertyKey","_defineProperty","action: K","handler: ActionHandler<T[K]>","config: HandlerConfig","name: string","setter: Function","payload?: T[K]","controller: PipelineController<T[K]>","type: K","payload: T[K]","action: any"],"sources":["../../../node_modules/.pnpm/@oxc-project+runtime@0.77.3/node_modules/@oxc-project/runtime/src/helpers/typeof.js","../../../node_modules/.pnpm/@oxc-project+runtime@0.77.3/node_modules/@oxc-project/runtime/src/helpers/toPrimitive.js","../../../node_modules/.pnpm/@oxc-project+runtime@0.77.3/node_modules/@oxc-project/runtime/src/helpers/toPropertyKey.js","../../../node_modules/.pnpm/@oxc-project+runtime@0.77.3/node_modules/@oxc-project/runtime/src/helpers/defineProperty.js","../src/ActionRegister.ts","../src/types.ts"],"sourcesContent":["function _typeof(o) {\n  \"@babel/helpers - typeof\";\n\n  return module.exports = _typeof = \"function\" == typeof Symbol && \"symbol\" == typeof Symbol.iterator ? function (o) {\n    return typeof o;\n  } : function (o) {\n    return o && \"function\" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? \"symbol\" : typeof o;\n  }, module.exports.__esModule = true, module.exports[\"default\"] = module.exports, _typeof(o);\n}\nmodule.exports = _typeof, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","var _typeof = require(\"./typeof.js\")[\"default\"];\nfunction toPrimitive(t, r) {\n  if (\"object\" != _typeof(t) || !t) return t;\n  var e = t[Symbol.toPrimitive];\n  if (void 0 !== e) {\n    var i = e.call(t, r || \"default\");\n    if (\"object\" != _typeof(i)) return i;\n    throw new TypeError(\"@@toPrimitive must return a primitive value.\");\n  }\n  return (\"string\" === r ? String : Number)(t);\n}\nmodule.exports = toPrimitive, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","var _typeof = require(\"./typeof.js\")[\"default\"];\nvar toPrimitive = require(\"./toPrimitive.js\");\nfunction toPropertyKey(t) {\n  var i = toPrimitive(t, \"string\");\n  return \"symbol\" == _typeof(i) ? i : i + \"\";\n}\nmodule.exports = toPropertyKey, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","var toPropertyKey = require(\"./toPropertyKey.js\");\nfunction _defineProperty(e, r, t) {\n  return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {\n    value: t,\n    enumerable: !0,\n    configurable: !0,\n    writable: !0\n  }) : e[r] = t, e;\n}\nmodule.exports = _defineProperty, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","// 타입 정의\nexport type PipelineController<T = any> = {\n  next: () => void;\n  abort: (reason?: string) => void;\n  modifyPayload: (modifier: (payload: T) => T) => void;\n};\n\nexport type ActionHandler<T = any> = (\n  payload: T,\n  controller: PipelineController<T>\n) => void | Promise<void>;\n\nexport type HandlerConfig = {\n  priority?: number;\n  id?: string;\n  blocking?: boolean;\n};\n\n// 선언적 타입 정의를 위한 인터페이스\nexport interface ActionPayloadMap {\n  // 확장 가능한 구조\n  // 'actionName': PayloadType;\n}\n\n// Action Register 클래스\nexport class ActionRegister<T extends ActionPayloadMap = ActionPayloadMap> {\n  private pipelines = new Map<keyof T, Map<string, {\n    handler: ActionHandler<any>;\n    config: HandlerConfig;\n  }>>();\n  \n  private atomSetters = new Map<string, Function>();\n\n  // 파이프라인에 핸들러 등록\n  register<K extends keyof T>(\n    action: K,\n    handler: ActionHandler<T[K]>,\n    config: HandlerConfig = {}\n  ): () => void {\n    if (!this.pipelines.has(action)) {\n      this.pipelines.set(action, new Map());\n    }\n    \n    const pipeline = this.pipelines.get(action)!;\n    const handlerId = config.id || `handler_${Date.now()}_${Math.random()}`;\n    \n    // 중복 등록 방지\n    if (pipeline.has(handlerId)) {\n      console.warn(`Handler with id ${handlerId} already exists`);\n      return () => {};\n    }\n    \n    pipeline.set(handlerId, { handler, config });\n    \n    // 우선순위로 정렬\n    this.sortPipeline(action);\n    \n    // unregister 함수 반환\n    return () => {\n      pipeline.delete(handlerId);\n    };\n  }\n\n  // Atom setter 등록\n  registerAtomSetter(name: string, setter: Function) {\n    this.atomSetters.set(name, setter);\n  }\n\n  // 파이프라인 실행 - void 타입을 위한 오버로드\n  async dispatch<K extends keyof T>(\n    action: T[K] extends void ? K : never\n  ): Promise<void>;\n  async dispatch<K extends keyof T>(\n    action: K,\n    payload: T[K]\n  ): Promise<void>;\n  async dispatch<K extends keyof T>(\n    action: K,\n    payload?: T[K]\n  ): Promise<void> {\n    const pipeline = this.pipelines.get(action);\n    \n    if (!pipeline || pipeline.size === 0) {\n      console.warn(`No handlers registered for action: ${String(action)}`);\n      return;\n    }\n    \n    let modifiedPayload = payload as T[K];\n    const handlers = Array.from(pipeline.values());\n    \n    for (const { handler, config } of handlers) {\n      let shouldContinue = true;\n      \n      const controller: PipelineController<T[K]> = {\n        next: () => { shouldContinue = true; },\n        abort: (reason) => {\n          shouldContinue = false;\n          console.log(`Pipeline aborted: ${reason}`);\n        },\n        modifyPayload: (modifier) => {\n          modifiedPayload = modifier(modifiedPayload);\n        }\n      };\n      \n      try {\n        if (config.blocking) {\n          await handler(modifiedPayload, controller);\n        } else {\n          handler(modifiedPayload, controller);\n        }\n        \n        if (!shouldContinue) break;\n      } catch (error) {\n        console.error(`Error in pipeline handler:`, error);\n        if (config.blocking) throw error;\n      }\n    }\n  }\n\n  private sortPipeline<K extends keyof T>(action: K) {\n    const pipeline = this.pipelines.get(action);\n    if (!pipeline) return;\n    \n    const sorted = Array.from(pipeline.entries())\n      .sort(([, a], [, b]) => {\n        const priorityA = a.config.priority ?? 0;\n        const priorityB = b.config.priority ?? 0;\n        return priorityB - priorityA; // 높은 우선순위가 먼저\n      });\n    \n    pipeline.clear();\n    sorted.forEach(([id, data]) => pipeline.set(id, data));\n  }\n}","// 기본 액션 타입 정의\nexport interface BaseActionPayloadMap {\n  // 기본 액션들은 여기에 정의\n}\n\n// 액션 타입 추출 헬퍼\nexport type ActionType<T extends Record<string, any>> = keyof T;\nexport type ActionPayload<\n  T extends Record<string, any>,\n  K extends keyof T\n> = T[K];\n\n// 액션 핸들러 타입\nexport type ActionHandlerMap<T extends Record<string, any>> = {\n  [K in keyof T]?: (payload: T[K]) => void | Promise<void>;\n};\n\n// 액션 생성 헬퍼\nexport function createAction<T extends Record<string, any>, K extends keyof T>(\n  type: K,\n  payload: T[K]\n): { type: K; payload: T[K] } {\n  return { type, payload };\n}\n\n// 타입 가드\nexport function isAction<T extends Record<string, any>, K extends keyof T>(\n  action: any,\n  type: K\n): action is { type: K; payload: T[K] } {\n  return action?.type === type;\n}"],"x_google_ignoreList":[0,1,2,3],"mappings":"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"}
+{"version":3,"file":"index.js","names":["_typeof","o","_typeof","toPrimitive","toPropertyKey","_defineProperty","level: LogLevel","level: string","message: string","payload: any","context: OtelContext","contextParts: string[]","config?: ActionRegisterConfig","action: K","handler: ActionHandler<T[K]>","config: HandlerConfig","name: string","setter: Function","payload?: T[K]","controller: PipelineController<T[K]>","type: K","payload: T[K]","action: any"],"sources":["../../../node_modules/.pnpm/@oxc-project+runtime@0.77.3/node_modules/@oxc-project/runtime/src/helpers/typeof.js","../../../node_modules/.pnpm/@oxc-project+runtime@0.77.3/node_modules/@oxc-project/runtime/src/helpers/toPrimitive.js","../../../node_modules/.pnpm/@oxc-project+runtime@0.77.3/node_modules/@oxc-project/runtime/src/helpers/toPropertyKey.js","../../../node_modules/.pnpm/@oxc-project+runtime@0.77.3/node_modules/@oxc-project/runtime/src/helpers/defineProperty.js","../src/logger.ts","../src/ActionRegister.ts","../src/types.ts"],"sourcesContent":["function _typeof(o) {\n  \"@babel/helpers - typeof\";\n\n  return module.exports = _typeof = \"function\" == typeof Symbol && \"symbol\" == typeof Symbol.iterator ? function (o) {\n    return typeof o;\n  } : function (o) {\n    return o && \"function\" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? \"symbol\" : typeof o;\n  }, module.exports.__esModule = true, module.exports[\"default\"] = module.exports, _typeof(o);\n}\nmodule.exports = _typeof, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","var _typeof = require(\"./typeof.js\")[\"default\"];\nfunction toPrimitive(t, r) {\n  if (\"object\" != _typeof(t) || !t) return t;\n  var e = t[Symbol.toPrimitive];\n  if (void 0 !== e) {\n    var i = e.call(t, r || \"default\");\n    if (\"object\" != _typeof(i)) return i;\n    throw new TypeError(\"@@toPrimitive must return a primitive value.\");\n  }\n  return (\"string\" === r ? String : Number)(t);\n}\nmodule.exports = toPrimitive, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","var _typeof = require(\"./typeof.js\")[\"default\"];\nvar toPrimitive = require(\"./toPrimitive.js\");\nfunction toPropertyKey(t) {\n  var i = toPrimitive(t, \"string\");\n  return \"symbol\" == _typeof(i) ? i : i + \"\";\n}\nmodule.exports = toPropertyKey, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","var toPropertyKey = require(\"./toPropertyKey.js\");\nfunction _defineProperty(e, r, t) {\n  return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {\n    value: t,\n    enumerable: !0,\n    configurable: !0,\n    writable: !0\n  }) : e[r] = t, e;\n}\nmodule.exports = _defineProperty, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","/**\n * Log levels in order of severity (lowest to highest)\n */\nexport enum LogLevel {\n  TRACE = 0,\n  DEBUG = 1,\n  INFO = 2,\n  WARN = 3,\n  ERROR = 4,\n  FATAL = 5\n}\n\n/**\n * Logger interface for custom logger implementations\n */\nexport interface Logger {\n  trace(message: string, ...args: any[]): void;\n  debug(message: string, ...args: any[]): void;\n  info(message: string, ...args: any[]): void;\n  warn(message: string, ...args: any[]): void;\n  error(message: string, ...args: any[]): void;\n  fatal(message: string, ...args: any[]): void;\n}\n\n/**\n * Default console logger implementation\n */\nexport class ConsoleLogger implements Logger {\n  constructor(private level: LogLevel = LogLevel.ERROR) {}\n\n  protected shouldLog(level: LogLevel): boolean {\n    return level >= this.level;\n  }\n\n  private formatMessage(level: string, message: string): string {\n    return `[${level.toUpperCase()}] ${message}`;\n  }\n\n  trace(message: string, ...args: any[]): void {\n    if (this.shouldLog(LogLevel.TRACE)) {\n      console.trace(this.formatMessage('trace', message), ...args);\n    }\n  }\n\n  debug(message: string, ...args: any[]): void {\n    if (this.shouldLog(LogLevel.DEBUG)) {\n      console.debug(this.formatMessage('debug', message), ...args);\n    }\n  }\n\n  info(message: string, ...args: any[]): void {\n    if (this.shouldLog(LogLevel.INFO)) {\n      console.info(this.formatMessage('info', message), ...args);\n    }\n  }\n\n  warn(message: string, ...args: any[]): void {\n    if (this.shouldLog(LogLevel.WARN)) {\n      console.warn(this.formatMessage('warn', message), ...args);\n    }\n  }\n\n  error(message: string, ...args: any[]): void {\n    if (this.shouldLog(LogLevel.ERROR)) {\n      console.error(this.formatMessage('error', message), ...args);\n    }\n  }\n\n  fatal(message: string, ...args: any[]): void {\n    if (this.shouldLog(LogLevel.FATAL)) {\n      console.error(this.formatMessage('fatal', message), ...args);\n    }\n  }\n\n  setLevel(level: LogLevel): void {\n    this.level = level;\n  }\n}\n\n/**\n * Parse log level from string\n */\nexport function parseLogLevel(level: string): LogLevel {\n  const upperLevel = level.toUpperCase();\n  switch (upperLevel) {\n    case 'TRACE':\n      return LogLevel.TRACE;\n    case 'DEBUG':\n      return LogLevel.DEBUG;\n    case 'INFO':\n      return LogLevel.INFO;\n    case 'WARN':\n      return LogLevel.WARN;\n    case 'ERROR':\n      return LogLevel.ERROR;\n    case 'FATAL':\n      return LogLevel.FATAL;\n    default:\n      return LogLevel.ERROR;\n  }\n}\n\n/**\n * Get log level from environment variable or default to ERROR\n */\nexport function getLogLevelFromEnv(): LogLevel {\n  if (typeof process !== 'undefined' && process.env) {\n    const envLevel = process.env.LOG_LEVEL || process.env.ACTION_LOG_LEVEL;\n    if (envLevel) {\n      return parseLogLevel(envLevel);\n    }\n  }\n  return LogLevel.TRACE;\n}\n\n/**\n * Extract trace ID from payload if it exists\n */\nexport function extractTraceIdFromPayload(payload: any): string | undefined {\n  if (payload && typeof payload === 'object') {\n    return payload._traceId || payload.traceId || payload.trace_id;\n  }\n  return undefined;\n}\n\n/**\n * Extract session ID from payload if it exists\n */\nexport function extractSessionIdFromPayload(payload: any): string | undefined {\n  if (payload && typeof payload === 'object') {\n    return payload._sessionId || payload.sessionId || payload.session_id;\n  }\n  return undefined;\n}\n\n/**\n * Create OTEL context from payload\n */\nexport function createOtelContextFromPayload(payload: any): OtelContext {\n  return {\n    traceId: extractTraceIdFromPayload(payload),\n    sessionId: extractSessionIdFromPayload(payload),\n    metadata: payload\n  };\n}\n\n/**\n * OpenTelemetry context interface for tracing\n */\nexport interface OtelContext {\n  /** Session ID for tracking user sessions */\n  sessionId?: string;\n  /** Trace ID for distributed tracing */\n  traceId?: string;\n  /** Span ID for current operation */\n  spanId?: string;\n  /** Parent span ID for operation hierarchy */\n  parentSpanId?: string;\n  /** Additional context metadata */\n  metadata?: Record<string, any>;\n}\n\n/**\n * Extended logger interface with OpenTelemetry support\n */\nexport interface OtelLogger extends Logger {\n  /** Set OpenTelemetry context */\n  setContext(context: OtelContext): void;\n  /** Get current OpenTelemetry context */\n  getContext(): OtelContext;\n  /** Clear OpenTelemetry context */\n  clearContext(): void;\n  /** Log with OpenTelemetry context */\n  logWithContext(level: LogLevel, message: string, ...args: any[]): void;\n}\n\n/**\n * OpenTelemetry-aware console logger implementation\n */\nexport class OtelConsoleLogger extends ConsoleLogger implements OtelLogger {\n  private context: OtelContext = {};\n\n  constructor(level: LogLevel = LogLevel.ERROR) {\n    super(level);\n  }\n\n  setContext(context: OtelContext): void {\n    this.context = { ...this.context, ...context };\n  }\n\n  getContext(): OtelContext {\n    return { ...this.context };\n  }\n\n  clearContext(): void {\n    this.context = {};\n  }\n\n  private formatWithContext(level: string, message: string): string {\n    const contextParts: string[] = [];\n    \n    if (this.context.sessionId) {\n      contextParts.push(`session=${this.context.sessionId}`);\n    }\n    if (this.context.traceId) {\n      contextParts.push(`trace=${this.context.traceId}`);\n    }\n    if (this.context.spanId) {\n      contextParts.push(`span=${this.context.spanId}`);\n    }\n    \n    const contextStr = contextParts.length > 0 ? ` [${contextParts.join(', ')}]` : '';\n    return `[${level.toUpperCase()}]${contextStr} ${message}`;\n  }\n\n  logWithContext(level: LogLevel, message: string, ...args: any[]): void {\n    const levelName = LogLevel[level].toLowerCase();\n    const formattedMessage = this.formatWithContext(levelName, message);\n    \n    switch (level) {\n      case LogLevel.TRACE:\n        if (this.shouldLog(LogLevel.TRACE)) {\n          console.trace(formattedMessage, ...args);\n        }\n        break;\n      case LogLevel.DEBUG:\n        if (this.shouldLog(LogLevel.DEBUG)) {\n          console.debug(formattedMessage, ...args);\n        }\n        break;\n      case LogLevel.INFO:\n        if (this.shouldLog(LogLevel.INFO)) {\n          console.info(formattedMessage, ...args);\n        }\n        break;\n      case LogLevel.WARN:\n        if (this.shouldLog(LogLevel.WARN)) {\n          console.warn(formattedMessage, ...args);\n        }\n        break;\n      case LogLevel.ERROR:\n        if (this.shouldLog(LogLevel.ERROR)) {\n          console.error(formattedMessage, ...args);\n        }\n        break;\n      case LogLevel.FATAL:\n        if (this.shouldLog(LogLevel.FATAL)) {\n          console.error(formattedMessage, ...args);\n        }\n        break;\n    }\n  }\n\n  // Override base methods to include context\n  trace(message: string, ...args: any[]): void {\n    this.logWithContext(LogLevel.TRACE, message, ...args);\n  }\n\n  debug(message: string, ...args: any[]): void {\n    this.logWithContext(LogLevel.DEBUG, message, ...args);\n  }\n\n  info(message: string, ...args: any[]): void {\n    this.logWithContext(LogLevel.INFO, message, ...args);\n  }\n\n  warn(message: string, ...args: any[]): void {\n    this.logWithContext(LogLevel.WARN, message, ...args);\n  }\n\n  error(message: string, ...args: any[]): void {\n    this.logWithContext(LogLevel.ERROR, message, ...args);\n  }\n\n  fatal(message: string, ...args: any[]): void {\n    this.logWithContext(LogLevel.FATAL, message, ...args);\n  }\n}\n","import { Logger, LogLevel, ConsoleLogger, OtelConsoleLogger, OtelContext, getLogLevelFromEnv, createOtelContextFromPayload } from './logger';\n\n/**\n * Controller object provided to action handlers for pipeline management\n * @template T - The type of the payload being processed\n */\nexport type PipelineController<T = any> = {\n  /** Continue to the next handler in the pipeline */\n  next: () => void;\n  /** Abort the pipeline execution with an optional reason */\n  abort: (reason?: string) => void;\n  /** Modify the payload that will be passed to subsequent handlers */\n  modifyPayload: (modifier: (payload: T) => T) => void;\n};\n\n/**\n * Action handler function that processes actions in the pipeline\n * @template T - The type of the payload\n * @param payload - The data passed to the handler\n * @param controller - Pipeline controller for flow management\n * @returns void or Promise<void> for async handlers\n */\nexport type ActionHandler<T = any> = (\n  payload: T,\n  controller: PipelineController<T>\n) => void | Promise<void>;\n\n/**\n * Configuration options for action handlers\n */\nexport type HandlerConfig = {\n  /** Priority level (higher numbers execute first). Default: 0 */\n  priority?: number;\n  /** Unique identifier for the handler. Auto-generated if not provided */\n  id?: string;\n  /** Whether to wait for async handlers to complete. Default: false */\n  blocking?: boolean;\n};\n\n/**\n * Base interface for defining action payload mappings\n * @example\n * ```typescript\n * interface MyActions extends ActionPayloadMap {\n *   increment: void;\n *   setCount: number;\n *   updateUser: { id: string; name: string };\n * }\n * ```\n */\nexport interface ActionPayloadMap {\n  // Extensible structure for action definitions\n  // 'actionName': PayloadType;\n}\n\n/**\n * Configuration options for ActionRegister\n */\nexport interface ActionRegisterConfig {\n  /** Custom logger implementation. Defaults to ConsoleLogger */\n  logger?: Logger;\n  /** Log level for the logger. Defaults to ERROR if not provided */\n  logLevel?: LogLevel;\n  /** OpenTelemetry context for tracing */\n  otelContext?: OtelContext;\n  /** Whether to use OTEL-aware logger. Defaults to false */\n  useOtel?: boolean;\n}\n\n/**\n * Core action pipeline management system\n * @template T - Action payload map defining available actions and their payload types\n * @example\n * ```typescript\n * interface AppActions extends ActionPayloadMap {\n *   increment: void;\n *   setCount: number;\n * }\n * \n * const actionRegister = new ActionRegister<AppActions>();\n * \n * // Register handlers\n * actionRegister.register('increment', () => console.log('Incremented'));\n * actionRegister.register('setCount', (count) => console.log(`Count: ${count}`));\n * \n * // Dispatch actions\n * await actionRegister.dispatch('increment');\n * await actionRegister.dispatch('setCount', 42);\n * ```\n */\nexport class ActionRegister<T extends ActionPayloadMap = ActionPayloadMap> {\n  private pipelines = new Map<keyof T, Map<string, {\n    handler: ActionHandler<any>;\n    config: HandlerConfig;\n  }>>();\n  \n  private atomSetters = new Map<string, Function>();\n  private handlerCounter = 0;\n  public readonly logger: Logger;\n\n  constructor(config?: ActionRegisterConfig) {\n    // 환경변수에서 로그 레벨 가져오기\n    const envLogLevel = getLogLevelFromEnv();\n    \n    // 설정에서 로그 레벨 가져오기 (환경변수보다 우선)\n    const configLogLevel = config?.logLevel ?? envLogLevel;\n    \n    // 커스텀 로거가 있으면 사용, OTEL 사용 설정이 있으면 OTEL 로거 사용, 없으면 기본 콘솔 로거 사용\n    if (config?.logger) {\n      this.logger = config.logger;\n    } else if (config?.useOtel) {\n      this.logger = new OtelConsoleLogger(configLogLevel);\n    } else {\n      this.logger = new ConsoleLogger(configLogLevel);\n    }\n    \n    // OTEL 컨텍스트 설정\n    if (config?.otelContext && this.logger instanceof OtelConsoleLogger) {\n      this.logger.setContext(config.otelContext);\n    }\n    \n    this.logger.debug('ActionRegister initialized', { \n      logLevel: configLogLevel,\n      useOtel: config?.useOtel ?? false,\n      hasOtelContext: !!config?.otelContext\n    });\n  }\n\n  /**\n   * Register a handler for an action in the pipeline\n   * @param action - The action name to handle\n   * @param handler - The handler function to execute\n   * @param config - Optional configuration for the handler\n   * @returns Unregister function to remove the handler\n   * @example\n   * ```typescript\n   * const unregister = actionRegister.register('increment', () => {\n   *   console.log('Incremented!');\n   * }, { priority: 10 });\n   * \n   * // Later, remove the handler\n   * unregister();\n   * ```\n   */\n  register<K extends keyof T>(\n    action: K,\n    handler: ActionHandler<T[K]>,\n    config: HandlerConfig = {}\n  ): () => void {\n    if (!this.pipelines.has(action)) {\n      this.pipelines.set(action, new Map());\n      this.logger.debug(`Created new pipeline for action: ${String(action)}`);\n    }\n    \n    const pipeline = this.pipelines.get(action)!;\n    const handlerId = config.id || `handler_${++this.handlerCounter}`;\n    \n    // 중복 등록 방지\n    if (pipeline.has(handlerId)) {\n      this.logger.warn(`Handler with id ${handlerId} already exists for action: ${String(action)}`);\n      return () => {};\n    }\n    \n    pipeline.set(handlerId, { handler, config });\n    this.logger.debug(`Registered handler for action: ${String(action)}`, { \n      handlerId, \n      priority: config.priority ?? 0,\n      blocking: config.blocking ?? false \n    });\n    \n    // 우선순위로 정렬\n    this.sortPipeline(action);\n    \n    // unregister 함수 반환\n    return () => {\n      pipeline.delete(handlerId);\n      this.logger.debug(`Unregistered handler: ${handlerId} for action: ${String(action)}`);\n    };\n  }\n\n  // Atom setter 등록\n  registerAtomSetter(name: string, setter: Function) {\n    this.atomSetters.set(name, setter);\n    this.logger.debug(`Registered atom setter: ${name}`);\n  }\n\n  /**\n   * Dispatch an action through the pipeline (for actions without payload)\n   * @param action - The action to dispatch\n   * @returns Promise that resolves when all handlers complete\n   */\n  async dispatch<K extends keyof T>(\n    action: T[K] extends void ? K : never\n  ): Promise<void>;\n  /**\n   * Dispatch an action through the pipeline (for actions with payload)\n   * @param action - The action to dispatch\n   * @param payload - The payload data to pass to handlers\n   * @returns Promise that resolves when all handlers complete\n   */\n  async dispatch<K extends keyof T>(\n    action: K,\n    payload: T[K]\n  ): Promise<void>;\n  /**\n   * Internal dispatch implementation\n   * @internal\n   */\n  async dispatch<K extends keyof T>(\n    action: K,\n    payload?: T[K]\n  ): Promise<void> {\n    const pipeline = this.pipelines.get(action);\n    \n    // OTEL 컨텍스트 자동 감지 및 설정\n    if (this.logger instanceof OtelConsoleLogger && payload) {\n      const otelContext = createOtelContextFromPayload(payload);\n      if (otelContext.traceId || otelContext.sessionId) {\n        this.logger.setContext(otelContext);\n      }\n    }\n    \n    this.logger.debug(`Dispatching action: ${String(action)}`, { payload });\n    \n    if (!pipeline || pipeline.size === 0) {\n      this.logger.warn(`No handlers registered for action: ${String(action)}`);\n      return;\n    }\n    \n    let modifiedPayload = payload as T[K];\n    const handlers = Array.from(pipeline.values());\n    let shouldContinue = true;\n    \n    this.logger.trace(`Executing pipeline for action: ${String(action)}`, { \n      handlerCount: handlers.length \n    });\n    \n    for (const { handler, config } of handlers) {\n      if (!shouldContinue) break;\n      \n      const controller: PipelineController<T[K]> = {\n        next: () => { shouldContinue = true; },\n        abort: (reason) => {\n          shouldContinue = false;\n          this.logger.warn(`Pipeline aborted: ${reason}`);\n        },\n        modifyPayload: (modifier) => {\n          modifiedPayload = modifier(modifiedPayload);\n          this.logger.trace(`Payload modified for action: ${String(action)}`);\n        }\n      };\n      \n      try {\n        if (config.blocking) {\n          await handler(modifiedPayload, controller);\n        } else {\n          handler(modifiedPayload, controller);\n        }\n      } catch (error) {\n        this.logger.error(`Error in pipeline handler for action: ${String(action)}`, error);\n        if (config.blocking) throw error;\n      }\n    }\n    \n    this.logger.debug(`Completed dispatching action: ${String(action)}`);\n  }\n\n  private sortPipeline<K extends keyof T>(action: K) {\n    const pipeline = this.pipelines.get(action);\n    if (!pipeline) return;\n    \n    const sorted = Array.from(pipeline.entries())\n      .sort(([, a], [, b]) => {\n        const priorityA = a.config.priority ?? 0;\n        const priorityB = b.config.priority ?? 0;\n        return priorityB - priorityA; // 높은 우선순위가 먼저\n      });\n    \n    pipeline.clear();\n    sorted.forEach(([id, data]) => pipeline.set(id, data));\n    \n    this.logger.trace(`Sorted pipeline for action: ${String(action)}`, {\n      handlerCount: sorted.length,\n      priorities: sorted.map(([, data]) => data.config.priority ?? 0)\n    });\n  }\n}","// 기본 액션 타입 정의\nexport interface BaseActionPayloadMap {\n  // 기본 액션들은 여기에 정의\n}\n\n// 액션 타입 추출 헬퍼\nexport type ActionType<T extends Record<string, any>> = keyof T;\nexport type ActionPayload<\n  T extends Record<string, any>,\n  K extends keyof T\n> = T[K];\n\n// 액션 핸들러 타입\nexport type ActionHandlerMap<T extends Record<string, any>> = {\n  [K in keyof T]?: (payload: T[K]) => void | Promise<void>;\n};\n\n// 액션 생성 헬퍼\nexport function createAction<T extends Record<string, any>, K extends keyof T>(\n  type: K,\n  payload: T[K]\n): { type: K; payload: T[K] } {\n  return { type, payload };\n}\n\n// 타입 가드\nexport function isAction<T extends Record<string, any>, K extends keyof T>(\n  action: any,\n  type: K\n): action is { type: K; payload: T[K] } {\n  return action?.type === type;\n}"],"x_google_ignoreList":[0,1,2,3],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@context-action/core",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "type": "module",
   "description": "Type-safe action pipeline management library for JavaScript/TypeScript",
   "main": "dist/index.cjs",
@@ -61,7 +61,7 @@
   "scripts": {
     "build": "tsdown",
     "build:watch": "tsdown --watch",
-    "test": "jest",
+    "test": "jest --passWithNoTests",
     "test:watch": "jest --watch",
     "lint": "eslint src --ext .ts",
     "lint:fix": "eslint src --ext .ts --fix",