@nice-code/action 0.10.0 → 0.11.0

package/build/devtools/server/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/devtools/server/NiceActionServerDevtools.ts"],"sourcesContent":["import {\r\n  ERunningActionFinishedType,\r\n  ERunningActionUpdateType,\r\n} from \"../../ActionDefinition/Action/RunningAction.types\";\r\nimport type { IDevtoolsObservableDomain } from \"../core/ActionDevtools.types\";\r\n\r\nexport type TServerDevtoolsLogFn = (message: string, data?: Record<string, unknown>) => void;\r\n\r\nexport interface IActionServerDevtoolsOptions {\r\n  /**\r\n   * Custom logger function. Defaults to console.log / console.error.\r\n   */\r\n  logger?: TServerDevtoolsLogFn;\r\n  /**\r\n   * Output format.\r\n   * - \"pretty\": human-readable lines (default)\r\n   * - \"json\": newline-delimited JSON for log aggregators\r\n   */\r\n  format?: \"pretty\" | \"json\";\r\n  /**\r\n   * Whether to log action input/output payloads.\r\n   * Disable if payloads may contain sensitive data. Defaults to true.\r\n   */\r\n  logPayloads?: boolean;\r\n  /**\r\n   * Whether devtools are active. Defaults to process.env.NODE_ENV !== \"production\".\r\n   */\r\n  enabled?: boolean;\r\n}\r\n\r\ninterface IStartedTiming {\r\n  startTime: number;\r\n}\r\n\r\nexport class ActionServerDevtools {\r\n  private readonly _options: Required<IActionServerDevtoolsOptions>;\r\n  private readonly _inFlight: Map<string, IStartedTiming> = new Map();\r\n\r\n  constructor(options: IActionServerDevtoolsOptions = {}) {\r\n    const defaultEnabled =\r\n      typeof process !== \"undefined\" ? process[\"env\"][\"NODE_ENV\"] !== \"production\" : true;\r\n\r\n    this._options = {\r\n      logger: options.logger ?? defaultConsoleLogger,\r\n      format: options.format ?? \"pretty\",\r\n      logPayloads: options.logPayloads ?? true,\r\n      enabled: options.enabled ?? defaultEnabled,\r\n    };\r\n  }\r\n\r\n  attachToDomain(domain: IDevtoolsObservableDomain): () => void {\r\n    if (!this._options.enabled) {\r\n      return () => {};\r\n    }\r\n\r\n    return domain.addActionListener((update) => {\r\n      const { runningAction, type, time } = update;\r\n      const actionPath = [...runningAction.allDomains, runningAction.id].join(\".\");\r\n\r\n      if (type === ERunningActionUpdateType.started) {\r\n        this._inFlight.set(runningAction.cuid, { startTime: time });\r\n        this._log(\"started\", actionPath, runningAction.cuid, {\r\n          ...(this._options.logPayloads ? { input: runningAction.state?.request?.input } : {}),\r\n        });\r\n      } else if (type === ERunningActionUpdateType.progress) {\r\n        this._log(\"progress\", actionPath, runningAction.cuid, { progress: update.progress });\r\n      } else if (type === ERunningActionUpdateType.finished) {\r\n        const timing = this._inFlight.get(runningAction.cuid);\r\n        const duration = timing != null ? time - timing.startTime : undefined;\r\n        this._inFlight.delete(runningAction.cuid);\r\n\r\n        const finishType: string = update.finishType;\r\n\r\n        if (finishType === ERunningActionFinishedType.success) {\r\n          const result = update.response?.result;\r\n          if (result != null && !result.ok) {\r\n            this._log(\"action-error\", actionPath, runningAction.cuid, {\r\n              ...(duration != null ? { duration: `${duration}ms` } : {}),\r\n              error: serializeError(result.error),\r\n            });\r\n          } else {\r\n            this._log(\"success\", actionPath, runningAction.cuid, {\r\n              ...(duration != null ? { duration: `${duration}ms` } : {}),\r\n              ...(this._options.logPayloads ? { output: result?.output } : {}),\r\n            });\r\n          }\r\n        } else if (finishType === ERunningActionFinishedType.failed) {\r\n          this._log(\"failed\", actionPath, runningAction.cuid, {\r\n            ...(duration != null ? { duration: `${duration}ms` } : {}),\r\n            error: serializeError(update.error),\r\n          });\r\n        } else {\r\n          this._log(\"aborted\", actionPath, runningAction.cuid, {\r\n            ...(duration != null ? { duration: `${duration}ms` } : {}),\r\n            ...(update.reason != null ? { reason: String(update.reason) } : {}),\r\n          });\r\n        }\r\n      }\r\n    });\r\n  }\r\n\r\n  private _log(\r\n    event: string,\r\n    actionPath: string,\r\n    cuid: string,\r\n    data: Record<string, unknown>,\r\n  ): void {\r\n    const { logger, format } = this._options;\r\n\r\n    if (format === \"json\") {\r\n      logger(\r\n        JSON.stringify({\r\n          time: new Date().toISOString(),\r\n          event,\r\n          action: actionPath,\r\n          cuid,\r\n          ...data,\r\n        }),\r\n      );\r\n      return;\r\n    }\r\n\r\n    const prefix = PRETTY_PREFIX[event] ?? `[${event}]`;\r\n    const suffix = Object.keys(data).length > 0 ? `  ${formatPrettyData(data)}` : \"\";\r\n    logger(`${prefix} ${actionPath}  cuid=${cuid}${suffix}`);\r\n  }\r\n}\r\n\r\nconst PRETTY_PREFIX: Record<string, string> = {\r\n  started: \"[nice-action] ►\",\r\n  progress: \"[nice-action]  \",\r\n  success: \"[nice-action] ✓\",\r\n  failed: \"[nice-action] ✗\",\r\n  aborted: \"[nice-action] ○\",\r\n};\r\n\r\nfunction formatPrettyData(data: Record<string, unknown>): string {\r\n  return Object.entries(data)\r\n    .map(([k, v]) => `${k}=${safeStringify(v)}`)\r\n    .join(\" \");\r\n}\r\n\r\nfunction safeStringify(value: unknown): string {\r\n  if (value === undefined) return \"undefined\";\r\n  if (value === null) return \"null\";\r\n  if (typeof value === \"string\") return `\"${value}\"`;\r\n  try {\r\n    return JSON.stringify(value);\r\n  } catch {\r\n    return String(value);\r\n  }\r\n}\r\n\r\nfunction serializeError(err: unknown): unknown {\r\n  if (err == null) return err;\r\n  if (err instanceof Error) return { message: err.message, name: err.name, stack: err.stack };\r\n  if (typeof err === \"object\") {\r\n    try {\r\n      return JSON.parse(JSON.stringify(err));\r\n    } catch {\r\n      return String(err);\r\n    }\r\n  }\r\n  return err;\r\n}\r\n\r\nfunction defaultConsoleLogger(message: string): void {\r\n  console.log(message);\r\n}\r\n"],"mappings":"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"}