@visulima/pail 4.0.0-alpha.11 → 4.0.0-alpha.13

package/dist/wide-event.js

@@ -1,284 +1 @@
-const LEVEL_PRIORITY = {
-  debug: 0,
-  error: 3,
-  info: 1,
-  warn: 2
-};
-const LEVEL_TO_LOG_TYPE = {
-  debug: "debug",
-  error: "error",
-  info: "info",
-  warn: "warn"
-};
-const deepMerge = (target, source) => {
-  const result = { ...target };
-  const keys = Object.keys(source);
-  for (let i = 0; i < keys.length; i += 1) {
-    const key = keys[i];
-    const sourceValue = source[key];
-    const targetValue = result[key];
-    if (sourceValue !== null && typeof sourceValue === "object" && !Array.isArray(sourceValue) && targetValue !== null && typeof targetValue === "object" && !Array.isArray(targetValue)) {
-      result[key] = deepMerge(targetValue, sourceValue);
-    } else {
-      result[key] = sourceValue;
-    }
-  }
-  return result;
-};
-const formatDuration = (ms) => {
-  if (ms < 1e3) {
-    return `${String(ms)}ms`;
-  }
-  return `${(ms / 1e3).toFixed(2)}s`;
-};
-const serializeError = (error) => {
-  const serialized = {
-    message: error.message,
-    name: error.name
-  };
-  if (error.stack) {
-    serialized.stack = error.stack;
-  }
-  const errorWithStatus = error;
-  if (errorWithStatus.status !== void 0) {
-    serialized.status = errorWithStatus.status;
-  } else if (errorWithStatus.statusCode !== void 0) {
-    serialized.status = errorWithStatus.statusCode;
-  }
-  if (errorWithStatus.data !== void 0) {
-    serialized.data = errorWithStatus.data;
-  }
-  if (error.cause instanceof Error) {
-    serialized.cause = serializeError(error.cause);
-  }
-  return serialized;
-};
-class WideEvent {
-  name;
-  autoEmit;
-  data;
-  emitted;
-  attachedError;
-  level;
-  pail;
-  requestLogs;
-  service;
-  startTime;
-  status;
-  timestamp;
-  // @ts-expect-error TS6133 -- preserved for future use (richer event categorization)
-  _type;
-  constructor(options) {
-    this.name = options.name;
-    this.pail = options.pail;
-    this.data = {};
-    this.startTime = performance.now();
-    this.timestamp = (/* @__PURE__ */ new Date()).toISOString();
-    this.emitted = false;
-    this.autoEmit = options.autoEmit ?? true;
-    this._type = options.type ?? "info";
-    this.level = "info";
-    this.requestLogs = [];
-    this.service = options.service;
-  }
-  /**
-   * Record a debug-level lifecycle log entry.
-   * Does not escalate the event level.
-   * @param message Description of what happened
-   * @param context Optional structured context
-   * @returns `this` for chaining
-   */
-  debug(message, context) {
-    return this.addLogEntry("debug", message, context);
-  }
-  /**
-   * Emit the wide event through the pail logger. Can only be called once;
-   * subsequent calls are no-ops.
-   *
-   * Automatically calculates duration, determines the log type based on
-   * the highest severity level reached, and serializes any attached error.
-   *
-   * Prefer `finish()` for HTTP request contexts where you have a status code.
-   * @param typeOverride Override the log type for this emission
-   */
-  emit(typeOverride) {
-    if (this.emitted) {
-      return;
-    }
-    this.emitted = true;
-    const durationMs = Math.round(performance.now() - this.startTime);
-    const resolvedLevel = this.attachedError ? "error" : this.level;
-    const type = typeOverride ?? LEVEL_TO_LOG_TYPE[resolvedLevel];
-    const payload = {
-      duration: formatDuration(durationMs),
-      duration_ms: durationMs,
-      event: this.name,
-      timestamp: this.timestamp,
-      ...this.data
-    };
-    if (this.service) {
-      payload.service = this.service;
-    }
-    if (this.status !== void 0) {
-      payload.status = this.status;
-    }
-    if (this.attachedError) {
-      payload.error = serializeError(this.attachedError);
-    }
-    if (this.requestLogs.length > 0) {
-      payload.requestLogs = this.requestLogs;
-    }
-    const logFunction = this.pail[type];
-    logFunction({ message: payload });
-  }
-  /**
-   * Record an error-level lifecycle log entry and attach the error.
-   * Escalates the event level to "error".
-   * @param message Description of what went wrong
-   * @param error The error that occurred
-   * @param context Optional structured context
-   * @returns `this` for chaining
-   */
-  error(message, error, context) {
-    if (error) {
-      this.attachedError = error;
-    }
-    return this.addLogEntry("error", message, context);
-  }
-  /**
-   * Finish and emit the wide event with HTTP context.
-   * Sets the response status and optional error before emitting.
-   * @example
-   * ```typescript
-   * ev.finish({ status: 200 });
-   * ev.finish({ status: 500, error: new Error("DB timeout") });
-   * ```
-   * @param options Status code and/or error
-   */
-  finish(options) {
-    if (options?.status !== void 0) {
-      this.status = options.status;
-    }
-    if (options?.error) {
-      this.attachedError = options.error;
-    }
-    this.emit();
-  }
-  /**
-   * Get a read-only snapshot of the accumulated data.
-   */
-  getData() {
-    return this.data;
-  }
-  /**
-   * Get the current severity level of the event.
-   * The level auto-escalates as `warn()` or `error()` entries are added.
-   */
-  getLevel() {
-    return this.attachedError ? "error" : this.level;
-  }
-  /**
-   * Get a read-only copy of the request lifecycle log entries.
-   */
-  getRequestLogs() {
-    return this.requestLogs;
-  }
-  /**
-   * Record an info-level lifecycle log entry.
-   * Does not escalate the event level.
-   * @param message Description of what happened
-   * @param context Optional structured context
-   * @returns `this` for chaining
-   */
-  info(message, context) {
-    return this.addLogEntry("info", message, context);
-  }
-  /**
-   * Accumulate context into the wide event via deep merge.
-   * Call as many times as needed throughout the operation.
-   * @example
-   * ```typescript
-   * ev.set({ user: { id: 1 } });
-   * ev.set({ user: { plan: "pro" } });
-   * // data = { user: { id: 1, plan: "pro" } }
-   * ```
-   * @param data Partial data to merge into the event
-   * @returns `this` for chaining
-   */
-  set(data) {
-    this.data = deepMerge(this.data, data);
-    return this;
-  }
-  /**
-   * Attach an error to the event. Automatically escalates the event
-   * level to "error".
-   * @param error The error to attach
-   * @returns `this` for chaining
-   */
-  setError(error) {
-    this.attachedError = error;
-    return this;
-  }
-  /**
-   * Set the HTTP response status code.
-   * @param status HTTP status code
-   * @returns `this` for chaining
-   */
-  setStatus(status) {
-    this.status = status;
-    return this;
-  }
-  /**
-   * Record a warn-level lifecycle log entry.
-   * Escalates the event level to "warn" (unless already "error").
-   * @param message Description of the warning
-   * @param context Optional structured context
-   * @returns `this` for chaining
-   */
-  warn(message, context) {
-    return this.addLogEntry("warn", message, context);
-  }
-  /**
-   * Disposable implementation. Auto-emits the event if `autoEmit` is true
-   * and the event hasn't been manually emitted yet.
-   *
-   * Enables usage with TC39 Explicit Resource Management:
-   * ```typescript
-   * using ev = createWideEvent({ pail: logger, name: "api.checkout" });
-   * ev.set({ user: { id: 1 } });
-   * // auto-emits here when scope exits
-   * ```
-   */
-  [Symbol.dispose]() {
-    if (this.autoEmit && !this.emitted) {
-      this.emit();
-    }
-  }
-  /**
-   * Add an entry to the request lifecycle log and escalate level if needed.
-   */
-  addLogEntry(level, message, context) {
-    const entry = {
-      level,
-      message,
-      timestamp: (/* @__PURE__ */ new Date()).toISOString()
-    };
-    if (context) {
-      entry.context = context;
-    }
-    this.requestLogs.push(entry);
-    this.escalateLevel(level);
-    return this;
-  }
-  /**
-   * Escalate the event level if the new level has higher severity.
-   */
-  escalateLevel(level) {
-    if ((LEVEL_PRIORITY[level] ?? 0) > (LEVEL_PRIORITY[this.level] ?? 0)) {
-      this.level = level;
-    }
-  }
-}
-const createWideEvent = (options) => new WideEvent(options);
-
-export { WideEvent, createWideEvent };
+var l=Object.defineProperty;var u=(s,t)=>l(s,"name",{value:t,configurable:!0});var g=Object.defineProperty,n=u((s,t)=>g(s,"name",{value:t,configurable:!0}),"o");const d={debug:0,error:3,info:1,warn:2},v={debug:"debug",error:"error",info:"info",warn:"warn"},c=n((s,t)=>{const e={...s},a=Object.keys(t);for(let i=0;i<a.length;i+=1){const r=a[i],o=t[r],h=e[r];o!==null&&typeof o=="object"&&!Array.isArray(o)&&h!==null&&typeof h=="object"&&!Array.isArray(h)?e[r]=c(h,o):e[r]=o}return e},"deepMerge"),E=n(s=>s<1e3?`${String(s)}ms`:`${(s/1e3).toFixed(2)}s`,"formatDuration"),m=n(s=>{const t={message:s.message,name:s.name};s.stack&&(t.stack=s.stack);const e=s;return e.status!==void 0?t.status=e.status:e.statusCode!==void 0&&(t.status=e.statusCode),e.data!==void 0&&(t.data=e.data),s.cause instanceof Error&&(t.cause=m(s.cause)),t},"serializeError");class p{static{u(this,"WideEvent")}static{n(this,"WideEvent")}name;autoEmit;data;emitted;attachedError;level;pail;requestLogs;service;startTime;status;timestamp;_type;constructor(t){this.name=t.name,this.pail=t.pail,this.data={},this.startTime=performance.now(),this.timestamp=new Date().toISOString(),this.emitted=!1,this.autoEmit=t.autoEmit??!0,this._type=t.type??"info",this.level="info",this.requestLogs=[],this.service=t.service}debug(t,e){return this.addLogEntry("debug",t,e)}emit(t){if(this.emitted)return;this.emitted=!0;const e=Math.round(performance.now()-this.startTime),a=this.attachedError?"error":this.level,i=t??v[a],r={duration:E(e),duration_ms:e,event:this.name,timestamp:this.timestamp,...this.data};this.service&&(r.service=this.service),this.status!==void 0&&(r.status=this.status),this.attachedError&&(r.error=m(this.attachedError)),this.requestLogs.length>0&&(r.requestLogs=this.requestLogs);const o=this.pail[i];o({message:r})}error(t,e,a){return e&&(this.attachedError=e),this.addLogEntry("error",t,a)}finish(t){t?.status!==void 0&&(this.status=t.status),t?.error&&(this.attachedError=t.error),this.emit()}getData(){return this.data}getLevel(){return this.attachedError?"error":this.level}getRequestLogs(){return this.requestLogs}info(t,e){return this.addLogEntry("info",t,e)}set(t){return this.data=c(this.data,t),this}setError(t){return this.attachedError=t,this}setStatus(t){return this.status=t,this}warn(t,e){return this.addLogEntry("warn",t,e)}[Symbol.dispose](){this.autoEmit&&!this.emitted&&this.emit()}addLogEntry(t,e,a){const i={level:t,message:e,timestamp:new Date().toISOString()};return a&&(i.context=a),this.requestLogs.push(i),this.escalateLevel(t),this}escalateLevel(t){(d[t]??0)>(d[this.level]??0)&&(this.level=t)}}const y=n(s=>new p(s),"createWideEvent");export{p as WideEvent,y as createWideEvent};

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@visulima/pail",
-  "version": "4.0.0-alpha.11",
+  "version": "4.0.0-alpha.13",
   "description": "Highly configurable Logger for Node.js, Edge and Browser.",
   "keywords": [
-    "ansi",
     "anolilab",
+    "ansi",
     "browser",
     "browser-logger",
     "callsite",
@@ -27,8 +27,8 @@
     "json",
     "json-logger",
     "json-logging",
-    "log level",
     "log",
+    "log level",
     "log-cleaner",
     "log-rotation",
     "log4j",
@@ -37,11 +37,10 @@
     "logger",
     "logging",
     "node",
-    "stream",
-    "pretty",
     "node-logger",
     "pail",
     "pino",
+    "pretty",
     "pretty-error",
     "pretty-log",
     "print",
@@ -49,6 +48,7 @@
     "redact",
     "rotating-log",
     "show error",
+    "stream",
     "timer",
     "universal",
     "visulima",
@@ -59,6 +59,12 @@
   "bugs": {
     "url": "https://github.com/visulima/visulima/issues"
   },
+  "license": "MIT",
+  "author": {
+    "name": "Daniel Bannert",
+    "email": "d.bannert@anolilab.de",
+    "url": "https://danielbannert.com"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/visulima/visulima.git",
@@ -74,14 +80,19 @@
       "url": "https://anolilab.com/support"
     }
   ],
-  "license": "MIT",
-  "author": {
-    "name": "Daniel Bannert",
-    "email": "d.bannert@anolilab.de",
-    "url": "https://danielbannert.com"
-  },
-  "sideEffects": false,
+  "files": [
+    "dist/**",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE.md"
+  ],
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
   "type": "module",
+  "sideEffects": false,
   "exports": {
     ".": {
       "browser": "./dist/index.browser.js",
@@ -224,19 +235,16 @@
     },
     "./package.json": "./package.json"
   },
-  "files": [
-    "dist/**",
-    "README.md",
-    "CHANGELOG.md",
-    "LICENSE.md"
-  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
   "dependencies": {
     "@visulima/colorize": "2.0.0-alpha.10",
-    "@visulima/interactive-manager": "1.0.0-alpha.2",
-    "type-fest": "5.6.0"
+    "@visulima/interactive-manager": "1.0.0-alpha.2"
   },
   "peerDependencies": {
-    "@opentelemetry/api": "1.9.1",
+    "@opentelemetry/api": "^1.9.0",
     "@sveltejs/kit": ">=2.0",
     "@visulima/redact": "3.0.0-alpha.10",
     "elysia": ">=1.0",
@@ -277,14 +285,5 @@
   },
   "engines": {
     "node": "^22.14.0 || >=24.10.0"
-  },
-  "os": [
-    "darwin",
-    "linux",
-    "win32"
-  ],
-  "publishConfig": {
-    "access": "public",
-    "provenance": true
   }
 }

package/dist/constants.d.ts

@@ -1,37 +0,0 @@
-import type { DefaultLoggerTypes } from "./types.d.ts";
-/**
- * Extended RFC 5424 Log Levels
- *
- * The log levels pail uses are those defined in the syslog protocol.
- * Each level is assigned a numeric priority where lower numbers indicate higher priority.
- * @see https://datatracker.ietf.org/doc/html/rfc5424#page-36
- * @example
- * ```typescript
- * import { EXTENDED_RFC_5424_LOG_LEVELS } from "@visulima/pail";
- *
- * console.log(EXTENDED_RFC_5424_LOG_LEVELS.error); // 5
- * ```
- */
-export declare const EXTENDED_RFC_5424_LOG_LEVELS: Record<string, number>;
-/**
- * Default Logger Types Configuration
- *
- * Predefined logger types with their associated colors, labels, and log levels.
- * These types provide semantic meaning to different kinds of log messages.
- * @example
- * ```typescript
- * import { LOG_TYPES } from "@visulima/pail";
- *
- * console.log(LOG_TYPES.error.color); // "red"
- * console.log(LOG_TYPES.success.label); // "success"
- * ```
- */
-export declare const LOG_TYPES: DefaultLoggerTypes;
-/**
- * Empty Symbol
- *
- * A unique symbol used internally to represent empty or undefined message values.
- * This helps distinguish between intentional empty messages and undefined values.
- * @internal
- */
-export declare const EMPTY_SYMBOL: symbol;

package/dist/middleware/next/middleware.d.ts

@@ -1,59 +0,0 @@
-/**
- * Minimal type definitions to avoid requiring next as a dependency.
- */
-interface NextRequest {
-    headers: Headers;
-    nextUrl: {
-        pathname: string;
-    };
-}
-interface NextResponse {
-    headers: Headers;
-}
-interface NextResponseConstructor {
-    next: (options?: {
-        request?: {
-            headers?: Headers;
-        };
-    }) => NextResponse;
-}
-/**
- * Options for the Next.js pail middleware.
- */
-interface PailNextMiddlewareOptions {
-    /**
-     * Glob patterns for paths to exclude from logging.
-     * Excluded paths won't get request IDs or timing headers.
-     * @example ["/_next/**", "/favicon.ico"]
-     */
-    exclude?: string[];
-    /**
-     * Glob patterns for paths to include in logging.
-     * If not set, all non-excluded paths are included.
-     */
-    include?: string[];
-}
-/**
- * Create a Next.js edge middleware that sets `x-request-id` and `x-pail-start`
- * headers on the request for downstream use by `withPail()`.
- *
- * This middleware runs at the edge and prepares request metadata.
- * The actual wide event logging happens in `withPail()`.
- * @param NextResponseClass The NextResponse class from "next/server.d.ts";
- * @param options Middleware configuration
- * @returns A middleware function
- * @example
- * ```typescript
- * // middleware.ts
- * import { NextResponse } from "next/server.d.ts";
- * import { pailMiddleware } from "@visulima/pail/middleware/next";
- *
- * const middleware = pailMiddleware(NextResponse, {
- *   exclude: ["/_next/**", "/favicon.ico"],
- * });
- *
- * export default middleware;
- * ```
- */
-export declare const pailMiddleware: (NextResponseClass: NextResponseConstructor, options?: PailNextMiddlewareOptions) => ((request: NextRequest) => NextResponse);
-export type { PailNextMiddlewareOptions };

package/dist/middleware/next/storage.d.ts

@@ -1,14 +0,0 @@
-import { AsyncLocalStorage } from "node:async_hooks";
-import type { WideEvent } from "../../wide-event.d.ts";
-/**
- * AsyncLocalStorage instance used to propagate the WideEvent logger
- * through Next.js server actions, route handlers, and server components.
- */
-export declare const pailStorage: AsyncLocalStorage<WideEvent>;
-/**
- * Retrieve the request-scoped WideEvent logger from AsyncLocalStorage.
- * Must be called within a `withPail()` wrapped handler or server action.
- * @returns The request-scoped WideEvent logger
- * @throws Error if called outside of a withPail context
- */
-export declare const useLogger: () => WideEvent;

package/dist/middleware/shared/create-middleware-logger.d.ts

@@ -1,82 +0,0 @@
-import type { PailBrowserImpl } from "../../pail.d.ts";
-import type { DefaultLogTypes, LoggerFunction } from "../../types.d.ts";
-import type { WideEventFinishOptions } from "../../wide-event.d.ts";
-import { WideEvent } from "../../wide-event.d.ts";
-import type { RouteConfig } from "./routes.d.ts";
-/**
- * A pail instance with dynamically generated log methods.
- */
-type PailLike<T extends string = string> = PailBrowserImpl<T> & Record<DefaultLogTypes | T, LoggerFunction>;
-/**
- * Base options shared by all framework middleware adapters.
- * @template T - Custom logger type names from the pail instance
- */
-export interface PailMiddlewareOptions<T extends string = string> {
-    /**
-     * Glob patterns for paths to exclude from logging.
-     * Exclusions take precedence over inclusions.
-     * @example ["/health", "/api/_internal/**"]
-     */
-    exclude?: string[];
-    /**
-     * Glob patterns for paths to include in logging.
-     * If not set, all non-excluded paths are logged.
-     * @example ["/api/**"]
-     */
-    include?: string[];
-    /**
-     * The pail logger instance to use for wide event emission.
-     */
-    pail: PailLike<T>;
-    /**
-     * Route-specific configuration. Maps glob patterns to config.
-     * First matching route wins.
-     * @example { "/api/auth/**": { service: "auth-service" } }
-     */
-    routes?: Record<string, RouteConfig>;
-    /**
-     * Default service name for all wide events.
-     * Can be overridden per-route via `routes`.
-     */
-    service?: string;
-}
-/**
- * Result of creating a middleware logger for a request.
- */
-export interface MiddlewareLoggerResult {
-    /**
-     * Finalize and emit the wide event. Sets status/error before emitting.
-     * Safe to call multiple times — only the first call emits.
-     */
-    finish: (options?: WideEventFinishOptions) => void;
-    /**
-     * The request-scoped WideEvent logger.
-     * Use `set()`, `info()`, `warn()`, `error()`, `debug()` to accumulate context.
-     */
-    logger: WideEvent;
-    /**
-     * Whether this request was skipped (excluded from logging).
-     * When true, `logger` and `finish` should not be used.
-     */
-    skipped: boolean;
-}
-/**
- * Core factory function used by all framework middleware adapters.
- *
- * Creates a WideEvent for the given request, checks route inclusion/exclusion,
- * resolves the service name, and returns a logger + finish callback.
- * @param options Middleware options including pail instance and route config
- * @param request Request metadata for the current HTTP request
- * @param request.headers Safe headers extracted from the request
- * @param request.method The HTTP method (GET, POST, etc.)
- * @param request.path The URL path of the request
- * @param request.requestId A unique identifier for this request
- * @returns A result object with logger, finish callback, and skipped flag
- */
-export declare const createMiddlewareLogger: <T extends string = string>(options: PailMiddlewareOptions<T>, request: {
-    headers?: Record<string, string>;
-    method: string;
-    path: string;
-    requestId: string;
-}) => MiddlewareLoggerResult;
-export {};

package/dist/middleware/shared/headers.d.ts

@@ -1,14 +0,0 @@
-/**
- * Extract safe headers from a Web API Headers object, filtering out
- * sensitive headers like Authorization, Cookie, and API keys.
- * @param headers Web API Headers object
- * @returns Plain object of safe header key-value pairs
- */
-export declare const extractSafeHeaders: (headers: Headers) => Record<string, string>;
-/**
- * Extract safe headers from a Node.js IncomingHttpHeaders object,
- * filtering out sensitive headers.
- * @param headers Node.js IncomingHttpHeaders-like object
- * @returns Plain object of safe header key-value pairs
- */
-export declare const extractSafeNodeHeaders: (headers: Record<string, string | string[] | undefined>) => Record<string, string>;

package/dist/middleware/shared/routes.d.ts

@@ -1,30 +0,0 @@
-/**
- * Check if a path matches a glob pattern.
- */
-export declare const matchesPattern: (path: string, pattern: string) => boolean;
-/**
- * Route configuration for a specific path pattern.
- */
-export interface RouteConfig {
-    /** Override the service name for requests matching this route. */
-    service?: string;
-}
-/**
- * Determine whether a request path should be logged based on include/exclude patterns.
- *
- * - Exclusions take precedence over inclusions.
- * - If no include patterns are provided, all non-excluded paths are logged.
- * @param path The request path
- * @param include Glob patterns of paths to include
- * @param exclude Glob patterns of paths to exclude
- * @returns Whether the path should be logged
- */
-export declare const shouldLog: (path: string, include?: string[], exclude?: string[]) => boolean;
-/**
- * Get the service name override for a given path based on route configuration.
- * Returns the first matching route's service name, or undefined if no match.
- * @param path The request path
- * @param routes Route configuration map (pattern → config)
- * @returns The service name override, or undefined
- */
-export declare const getServiceForPath: (path: string, routes?: Record<string, RouteConfig>) => string | undefined;

package/dist/middleware/shared/storage.d.ts

@@ -1,29 +0,0 @@
-import { AsyncLocalStorage } from "node:async_hooks";
-import type { WideEvent } from "../../wide-event.d.ts";
-/**
- * Create an isolated AsyncLocalStorage instance and a `useLogger` accessor
- * for retrieving the request-scoped WideEvent from anywhere in the call stack.
- *
- * Each framework adapter should call this once at module level to get its own
- * isolated storage instance.
- * @param contextHint A description of the expected context, used in the
- * error message when `useLogger` is called outside of a request scope.
- * @returns An object with `storage` and `useLogger`
- * @example
- * ```typescript
- * const { storage, useLogger } = createLoggerStorage(
- *   "Express middleware context. Make sure evlog middleware is registered."
- * );
- *
- * // In middleware:
- * storage.run(wideEvent, () => next());
- *
- * // In handler:
- * const log = useLogger();
- * log.set({ user: { id: 1 } });
- * ```
- */
-export declare const createLoggerStorage: (contextHint: string) => {
-    storage: AsyncLocalStorage<WideEvent>;
-    useLogger: () => WideEvent;
-};