@context-action/core 0.0.1 → 0.0.3

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/core/ActionRegister.ts","../src/core/types.ts","../src/react/ActionContext.tsx"],"sourcesContent":[],"mappings":"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"}
+{"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,30 +1,230 @@
-import React, { ReactNode } from "react";
-
-//#region src/core/ActionRegister.d.ts
+//#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;
 }
 //# sourceMappingURL=ActionRegister.d.ts.map
 //#endregion
-//#region src/core/types.d.ts
+//#region src/types.d.ts
 interface BaseActionPayloadMap {}
 type ActionType<T extends Record<string, any>> = keyof T;
 type ActionPayload<T extends Record<string, any>, K extends keyof T> = T[K];
@@ -38,32 +238,7 @@ declare function isAction<T extends Record<string, any>, K extends keyof T>(acti
   payload: T[K];
 };
 //# sourceMappingURL=types.d.ts.map
-//#endregion
-//#region src/react/ActionContext.d.ts
-/**
- * Context type for ActionRegister
- */
-interface ActionContextType<T extends ActionPayloadMap = ActionPayloadMap> {
-  actionRegisterRef: React.RefObject<ActionRegister<T>>;
-}
-/**
- * Return type for createActionContext
- */
-interface ActionContextReturn<T extends ActionPayloadMap = ActionPayloadMap> {
-  Provider: React.FC<{
-    children: ReactNode;
-  }>;
-  useActionContext: () => ActionContextType<T>;
-  useAction: () => ActionRegister<T>;
-  useActionHandler: <K extends keyof T>(action: K, handler: ActionHandler<T[K]>, config?: HandlerConfig) => void;
-}
-/**
- * ActionRegister를 Context로 공유할 수 있는 헬퍼 함수
- * @returns Provider, hooks를 포함한 객체
- */
-declare function createActionContext<T extends ActionPayloadMap = ActionPayloadMap>(): ActionContextReturn<T>;
-//# sourceMappingURL=ActionContext.d.ts.map
 
 //#endregion
-export { ActionHandler, ActionHandlerMap, ActionPayload, ActionPayloadMap, ActionRegister, ActionType, BaseActionPayloadMap, HandlerConfig, PipelineController, createAction, createActionContext, 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/core/ActionRegister.ts","../src/core/types.ts","../src/react/ActionContext.tsx"],"sourcesContent":[],"mappings":";;;KACY;;;EAAA,aAAA,EAAA,CAAA,QAAkB,EAAA,CAAA,OAAA,EAGQ,CAHR,EAAA,GAGc,CAHd,EAAA,GAAA,IAAA;CAAA;AAGQ,KAG1B,aAH0B,CAAA,IAAA,GAAA,CAAA,GAAA,CAAA,OAAA,EAI3B,CAJ2B,EAAA,UAAA,EAKxB,kBALwB,CAKL,CALK,CAAA,EAAA,GAAA,IAAA,GAM1B,OAN0B,CAAA,IAAA,CAAA;AAAM,KAQhC,aAAA,GARgC;EAAC,QAAA,CAAA,EAAA,MAAA;EAGjC,EAAA,CAAA,EAAA,MAAA;EAAa,QAAA,CAAA,EAAA,OAAA;CAAA;AAEQ,UAUhB,gBAAA,CAVgB;AACrB,cAeC,cAfD,CAAA,UAe0B,gBAf1B,GAe6C,gBAf7C,CAAA,CAAA;EAAO,QAAA,SAAA;EAEP,QAAA,WAAa;EAOR,QAAA,CAAA,UAAgB,MAeN,CAfM,CAAA,CAAA,MAAA,EAgBrB,CAhBqB,EAAA,OAAA,EAiBpB,aAjBoB,CAiBN,CAjBM,CAiBJ,CAjBI,CAAA,CAAA,EAAA,MAAA,CAAA,EAkBrB,aAlBqB,CAAA,EAAA,GAAA,GAAA,IAAA;EAMpB,kBAAc,CAAA,IAAA,EAAA,MAAA,EAAA,MAAA,EAuCgB,QAvChB,CAAA,EAAA,IAAA;EAAA,QAAA,CAAA,UAAA,MA4CM,CA5CN,CAAA,CAAA,MAAA,EA6Cf,CA7Ce,CA6Cb,CA7Ca,CAAA,SAAA,IAAA,GA6CK,CA7CL,GAAA,KAAA,CAAA,EA8CtB,OA9CsB,CAAA,IAAA,CAAA;EAAA,QAAW,CAAA,UAAA,MA+CL,CA/CK,CAAA,CAAA,MAAA,EAgD1B,CAhD0B,EAAA,OAAA,EAiDzB,CAjDyB,CAiDvB,CAjDuB,CAAA,CAAA,EAkDjC,OAlDiC,CAAA,IAAA,CAAA;EAAgB,QAAG,YAAA;;;;;UCxBxC,oBAAA;KAKL,qBAAqB,6BAA6B;ADLlD,KCMA,aDNkB,CAAA,UCOlB,MDPkB,CAAA,MAAA,EAAA,GAAA,CAAA,EAAA,UAAA,MCQZ,CDRY,CAAA,GCS1B,CDT0B,CCSxB,CDTwB,CAAA;AAAA,KCYlB,gBDZkB,CAAA,UCYS,MDZT,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,GAAA,QAGQ,MCUxB,CDVwB,IAAA,CAAA,OAAA,ECUT,CDVS,CCUP,CDVO,CAAA,EAAA,GAAA,IAAA,GCUO,ODVP,CAAA,IAAA,CAAA,EAAC;AAAM,iBCc7B,YDd6B,CAAA,UCcN,MDdM,CAAA,MAAA,EAAA,GAAA,CAAA,EAAA,UAAA,MCc+B,CDd/B,CAAA,CAAA,IAAA,ECerC,CDfqC,EAAA,OAAA,ECgBlC,CDhBkC,CCgBhC,CDhBgC,CAAA,CAAA,EAAA;EAGjC,IAAA,ECcD,CDdC;EAAa,OAAA,ECcF,CDdE,CCcA,CDdA,CAAA;CAAA;AAEQ,iBCiBjB,QDjBiB,CAAA,UCiBE,MDjBF,CAAA,MAAA,EAAA,GAAA,CAAA,EAAA,UAAA,MCiBuC,CDjBvC,CAAA,CAAA,MAAA,EAAA,GAAA,EAAA,IAAA,ECmBzB,CDnByB,CAAA,EAAA,MAAA,IAAA;EAAC,IAApB,ECoBO,CDpBP;EAAkB,OACpB,ECmBqB,CDnBrB,CCmBuB,CDnBvB,CAAA;AAAO,CAAA;AAEnB;;;;AAXA;;AAGsC,UEErB,iBFFqB,CAAA,UEEO,gBFFP,GEE0B,gBFF1B,CAAA,CAAA;EAAC,iBAAK,EEGvB,KAAA,CAAM,SFHiB,CEGP,cFHO,CEGQ,CFHR,CAAA,CAAA;AAAC;AAG7C;;;AAEiC,UEIhB,mBFJgB,CAAA,UEIc,gBFJd,GEIiC,gBFJjC,CAAA,CAAA;EAAC,QAApB,EEKF,KAAA,CAAM,EFLJ,CAAA;IACF,QAAA,EEIqB,SFJrB;EAAO,CAAA,CAAA;EAEP,gBAAa,EAAA,GAAA,GEGC,iBFHD,CEGmB,CFHnB,CAAA;EAOR,SAAA,EAAA,GAAA,GEHE,cFGc,CEHC,CFGD,CAAA;EAMpB,gBAAA,EAAc,CAAA,UAAA,MERU,CFQV,CAAA,CAAA,MAAA,EEPf,CFOe,EAAA,OAAA,EENd,aFMc,CENA,CFMA,CENE,CFMF,CAAA,CAAA,EAAA,MAAA,CAAA,EELd,aFKc,EAAA,GAAA,IAAA;;;;;;AAWA,iBERX,mBFQW,CAAA,UERmB,gBFQnB,GERsC,gBFQtC,CAAA,CAAA,CAAA,EER2D,mBFQ3D,CER+E,CFQ/E,CAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/logger.ts","../src/ActionRegister.ts","../src/types.ts"],"sourcesContent":[],"mappings":"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"}