@padosoft/logger 1.3.2

package/dist/adapters/drizzle.d.mts

@@ -0,0 +1,8 @@
+import { Logger } from "../core/logger.mjs";
+
+//#region src/adapters/drizzle.d.ts
+declare const createDrizzleAdapter: (logger: Logger) => {
+  logQuery(query: string, params: unknown[]): void;
+};
+//#endregion
+export { createDrizzleAdapter };

package/dist/adapters/drizzle.mjs

@@ -0,0 +1 @@
+const e=e=>({logQuery(t,n){e.debug(`drizzle-orm DB query`,{query:t,params:n})}});export{e as createDrizzleAdapter};

package/dist/adapters/hono.d.mts

@@ -0,0 +1,6 @@
+import { Logger } from "../core/logger.mjs";
+
+//#region src/adapters/hono.d.ts
+declare const createHonoAdapter: (logger: Logger) => (message: string, ...rest: string[]) => void;
+//#endregion
+export { createHonoAdapter };

package/dist/adapters/hono.mjs

@@ -0,0 +1 @@
+const e=e=>(t,...n)=>{e.info(t,...n)};export{e as createHonoAdapter};

package/dist/core/logger.d.mts

@@ -0,0 +1,44 @@
+import { LogLevel } from "../lib/levels.mjs";
+import { Plugin, Transport } from "../types/mods.mjs";
+import { LogEntry, LoggerOptions } from "../types/logger.mjs";
+import { BatchingOptions, BatchingState } from "../types/batching.mjs";
+
+//#region src/core/logger.d.ts
+declare class Logger {
+  protected level: LogLevel;
+  readonly transports: Transport[];
+  readonly plugins: Plugin[];
+  protected batching?: BatchingOptions | undefined;
+  protected batchingState: BatchingState;
+  constructor(opts?: LoggerOptions);
+  addPlugin(plugin: Plugin): this;
+  addTransport(transport: Transport): this;
+  use(mod: Transport | Plugin): this;
+  setLevel(level: LogLevel): this;
+  setBatching(options: BatchingOptions | null): this;
+  protected shouldLog(level: LogLevel): boolean;
+  protected applyTransforms(entry: LogEntry): Promise<LogEntry>;
+  protected handleEntry(entry: LogEntry): Promise<void>;
+  emit(level: LogLevel, data: unknown[]): this;
+  trace: (...a: unknown[]) => this;
+  debug: (...a: unknown[]) => this;
+  info: (...a: unknown[]) => this;
+  success: (...a: unknown[]) => this;
+  warn: (...a: unknown[]) => this;
+  error: (...a: unknown[]) => this;
+  fatal: (...a: unknown[]) => this;
+  assert(cond: boolean, ...a: unknown[]): this;
+  table(data: unknown, properties?: readonly string[]): this;
+  clear(): this;
+  group(...label: unknown[]): this;
+  groupEnd(): this;
+  clone(extra?: Partial<LoggerOptions>): Logger;
+  close(): Promise<void>;
+  [Symbol.asyncDispose](): Promise<void>;
+  [Symbol.dispose](): void;
+  private clearTimer;
+  private scheduleTimer;
+  flush(): Promise<void>;
+}
+//#endregion
+export { Logger };

package/dist/core/logger.mjs

@@ -0,0 +1 @@
+import{LogLevels as e,LogLevelsValues as t}from"../lib/levels.mjs";var n=class n{level;transports;plugins;batching;batchingState;constructor(t={}){this.level=t.level??e.INFO,this.transports=t.transports??[],this.plugins=t.plugins??[],this.batching=t.batching?t.batching:void 0,this.batchingState={buf:[],timer:null},Promise.allSettled(this.plugins.map(e=>e.enrichLogger?.(this)))}addPlugin(e){return this.plugins.push(e),e.enrichLogger?.(this),this}addTransport(e){return this.transports.push(e),this}use(e){return e._tag===`plugin`?this.addPlugin(e):e._tag===`transport`?this.addTransport(e):this}setLevel(e){return this.level=e,this}setBatching(e){return this.batching=e??void 0,this}shouldLog(e){return t[e]>=t[this.level]}async applyTransforms(e){let t=e;for(let e of this.plugins)e.transformEntry&&(t=await e.transformEntry(this,t));return t}async handleEntry(e){let t=await this.applyTransforms(e);if(!this.batching||this.batching.maxBatchSize<=1){Promise.allSettled(this.transports.map(e=>e.send(this,t)));return}if(!(this.batching.dropIfBufferFull&&this.batchingState.buf.length>=this.batching.maxBatchSize)){if(this.batchingState.buf.push(t),this.batchingState.buf.length>=this.batching.maxBatchSize)return this.flush();this.batching.maxIntervalMs&&this.batching.maxIntervalMs>0&&this.scheduleTimer()}}emit(e,t){if(!this.shouldLog(e))return this;let n={level:e,time:new Date,data:t};return this.handleEntry(n),this}trace=(...t)=>this.emit(e.TRACE,t);debug=(...t)=>this.emit(e.DEBUG,t);info=(...t)=>this.emit(e.INFO,t);success=(...t)=>this.emit(e.SUCCESS,t);warn=(...t)=>this.emit(e.WARN,t);error=(...t)=>this.emit(e.ERROR,t);fatal=(...t)=>this.emit(e.FATAL,t);assert(e,...t){return e||this.error(`Assertion failed:`,...t),this}table(e,t){return console.table?.(e,t),this}clear(){return console.clear?.(),this}group(...e){return console.group?.(e),this}groupEnd(){return console.groupEnd?.(),this}clone(e){return new n({level:this.level,transports:this.transports,plugins:this.plugins,...e})}async close(){(this.batching?.flushOnDispose??!0)&&await this.flush(),await Promise.all(this.transports.map(e=>(this.transports.pop(),e.teardown?.(this)))),await Promise.all(this.plugins.map(e=>(this.plugins.pop(),e.teardown?.(this)))),this.clearTimer()}[Symbol.asyncDispose](){return this.close()}[Symbol.dispose](){this.close()}clearTimer(){this.batchingState.timer&&(clearTimeout(this.batchingState.timer),this.batchingState.timer=null)}scheduleTimer(){!this.batching?.maxIntervalMs||this.batchingState.timer||(this.batchingState.timer=setTimeout(()=>{this.flush()},this.batching.maxIntervalMs))}async flush(){this.batchingState.buf.length!==0&&(await Promise.allSettled(this.transports.map(e=>typeof e.batch==`function`?e.batch(this,this.batchingState.buf):Promise.all(this.batchingState.buf.map(t=>e.send(this,t))))),this.batchingState.buf=[],this.clearTimer())}};export{n as Logger};

package/dist/index.d.mts

@@ -0,0 +1,5 @@
+import { Mod, Plugin, Transport } from "./types/mods.mjs";
+import { LogEntry, LoggerOptions } from "./types/logger.mjs";
+import { BatchingOptions, BatchingState } from "./types/batching.mjs";
+import { Logger } from "./core/logger.mjs";
+export { BatchingOptions, BatchingState, LogEntry, Logger, LoggerOptions, Mod, Plugin, Transport };

package/dist/index.mjs

@@ -0,0 +1 @@
+import{Logger as e}from"./core/logger.mjs";export{e as Logger};

package/dist/lib/format.d.mts

@@ -0,0 +1,6 @@
+import { TimestampType } from "../types/format.mjs";
+
+//#region src/lib/format.d.ts
+declare const makeTimestamp: (type: TimestampType) => ((date: Date) => string);
+//#endregion
+export { makeTimestamp };

package/dist/lib/format.mjs

@@ -0,0 +1 @@
+const e=e=>{if(typeof e==`function`)return e;let t=e===`local`?e=>e.toLocaleString():e=>e.toISOString();return e=>t(e)};export{e as makeTimestamp};

package/dist/lib/index.d.mts

@@ -0,0 +1,4 @@
+import { LogLevel, LogLevels, LogLevelsValues } from "./levels.mjs";
+import { createPlugin, createTransport } from "./mods.mjs";
+import { isAzurePipeline, isCI, isModernTerminal, isWindowsCmd, supportsColors, supportsTTY, supportsUnicode } from "./utils.mjs";
+export { LogLevel, LogLevels, LogLevelsValues, createPlugin, createTransport, isAzurePipeline, isCI, isModernTerminal, isWindowsCmd, supportsColors, supportsTTY, supportsUnicode };

package/dist/lib/index.mjs

@@ -0,0 +1 @@
+import{LogLevels as e,LogLevelsValues as t}from"./levels.mjs";import{createPlugin as n,createTransport as r}from"./mods.mjs";import{isAzurePipeline as i,isCI as a,isModernTerminal as o,isWindowsCmd as s,supportsColors as c,supportsTTY as l,supportsUnicode as u}from"./utils.mjs";export{e as LogLevels,t as LogLevelsValues,n as createPlugin,r as createTransport,i as isAzurePipeline,a as isCI,o as isModernTerminal,s as isWindowsCmd,c as supportsColors,l as supportsTTY,u as supportsUnicode};

package/dist/lib/levels.d.mts

@@ -0,0 +1,14 @@
+//#region src/lib/levels.d.ts
+declare const LogLevels: {
+  readonly TRACE: "trace";
+  readonly DEBUG: "debug";
+  readonly INFO: "info";
+  readonly SUCCESS: "success";
+  readonly WARN: "warn";
+  readonly ERROR: "error";
+  readonly FATAL: "fatal";
+};
+declare const LogLevelsValues: Record<LogLevel, number>;
+type LogLevel = (typeof LogLevels)[keyof typeof LogLevels];
+//#endregion
+export { LogLevel, LogLevels, LogLevelsValues };

package/dist/lib/levels.mjs

@@ -0,0 +1 @@
+const e={TRACE:`trace`,DEBUG:`debug`,INFO:`info`,SUCCESS:`success`,WARN:`warn`,ERROR:`error`,FATAL:`fatal`},t={trace:10,debug:20,info:30,success:35,warn:40,error:50,fatal:60};export{e as LogLevels,t as LogLevelsValues};

package/dist/lib/mods.d.mts

@@ -0,0 +1,7 @@
+import { Mod, Plugin, Transport } from "../types/mods.mjs";
+
+//#region src/lib/mods.d.ts
+declare const createPlugin: <P extends Omit<Plugin, keyof Mod<string>>>(options: P) => Plugin & P;
+declare const createTransport: <T extends Omit<Transport, keyof Mod<string>>>(options: T) => Transport & T;
+//#endregion
+export { createPlugin, createTransport };

package/dist/lib/mods.mjs

@@ -0,0 +1 @@
+const e=e=>({...e,_tag:`plugin`}),t=e=>({...e,_tag:`transport`});export{e as createPlugin,t as createTransport};

package/dist/lib/utils.d.mts

@@ -0,0 +1,10 @@
+//#region src/lib/utils.d.ts
+declare const supportsTTY: boolean;
+declare const isAzurePipeline: boolean;
+declare const isCI: boolean;
+declare const isModernTerminal: () => boolean;
+declare const isWindowsCmd: boolean;
+declare const supportsUnicode: () => boolean;
+declare const supportsColors: () => boolean;
+//#endregion
+export { isAzurePipeline, isCI, isModernTerminal, isWindowsCmd, supportsColors, supportsTTY, supportsUnicode };

package/dist/lib/utils.mjs

@@ -0,0 +1 @@
+const e=typeof process<`u`&&`stdout`in process&&`isTTY`in process.stdout&&process.stdout.isTTY,t=typeof process<`u`&&`env`in process&&`TF_BUILD`in process.env&&`AGENT_NAME`in process.env,n=typeof process<`u`&&`env`in process&&`CI`in process.env,r=()=>{if(typeof process>`u`||!(`env`in process))return!1;let{TERM_PROGRAM:e,COLORTERM:t,TERM:n}=process.env,r=new Set([`iTerm.app`,`Apple_Terminal`,`Hyper`,`vscode`,`Windows Terminal`,`Alacritty`,`Tabby`,`WezTerm`]),i=new Set([`truecolor`,`24bit`]),a=e&&r.has(e),o=t&&i.has(t.toLowerCase()),s=n&&/xterm-256color|screen-256color|tmux-256color/.test(n);return a||o||s||!1},i=typeof process<`u`&&`platform`in process&&process.platform===`win32`,a=()=>i?r():!0,o=()=>e||n||t?!0:r();export{t as isAzurePipeline,n as isCI,r as isModernTerminal,i as isWindowsCmd,o as supportsColors,e as supportsTTY,a as supportsUnicode};

package/dist/package.mjs

@@ -0,0 +1 @@
+var e=`@padosoft/logger`,t=`1.3.2`;export{e as name,t as version};

package/dist/plugins/context.d.mts

@@ -0,0 +1,21 @@
+import { Plugin } from "../types/mods.mjs";
+import { Logger } from "../core/logger.mjs";
+
+//#region src/plugins/context.d.ts
+type Context = Record<string, unknown>;
+declare module ".." {
+  interface LogEntry {
+    ctx?: Context;
+  }
+  interface Logger {
+    setContext?<C extends Context>(ctx: Partial<C>): void;
+    clearContext?(): void;
+    getContext?<C extends Context>(): C;
+  }
+}
+interface ContextPluginOptions {
+  initial: Record<string, unknown>;
+}
+declare const contextPlugin: (options: ContextPluginOptions) => Plugin<Logger>;
+//#endregion
+export { Context, ContextPluginOptions, contextPlugin };

package/dist/plugins/context.mjs

@@ -0,0 +1 @@
+import{createPlugin as e}from"../lib/mods.mjs";import"../lib/index.mjs";const t=t=>{let n={...t.initial};return e({name:`context`,transformEntry(e,t){let r={...n,...t.ctx};return{...t,ctx:r}},enrichLogger(e){return e.setContext=e=>{n=e},e.clearContext=()=>{n={}},e.getContext=()=>n,e}})};export{t as contextPlugin};

package/dist/plugins/metrics.d.mts

@@ -0,0 +1,20 @@
+import { LogLevel } from "../lib/levels.mjs";
+import { Plugin } from "../types/mods.mjs";
+import { Logger } from "../core/logger.mjs";
+
+//#region src/plugins/metrics.d.ts
+interface Metrics extends Partial<Record<LogLevel, number>> {
+  plugins: number;
+  transports: number;
+}
+declare module ".." {
+  interface Logger {
+    getMetrics?(): Metrics;
+  }
+}
+interface MetricsPluginOptions {
+  countLevels?: boolean;
+}
+declare const metricsPlugin: (options: MetricsPluginOptions) => Plugin<Logger>;
+//#endregion
+export { Metrics, MetricsPluginOptions, metricsPlugin };

package/dist/plugins/metrics.mjs

@@ -0,0 +1 @@
+import{createPlugin as e}from"../lib/mods.mjs";import"../lib/index.mjs";const t=t=>{let n,r,i,a={plugins:0,transports:0};return e({name:`metrics`,enrichLogger(e){return a.plugins=e.plugins.length,a.transports=e.transports.length,n=e.emit.bind(e),r=e.addPlugin.bind(e),i=e.addTransport.bind(e),e.emit=t.countLevels?(e,t)=>(a[e]=(a[e]??0)+1,n(e,t)):n,e.addPlugin=e=>(a.plugins++,r(e)),e.addTransport=e=>(a.transports++,i(e)),e.getMetrics=()=>a,e}})};export{t as metricsPlugin};

package/dist/plugins/rate-limiter.d.mts

@@ -0,0 +1,7 @@
+import { Plugin } from "../types/mods.mjs";
+import { Logger } from "../core/logger.mjs";
+
+//#region src/plugins/rate-limiter.d.ts
+declare const rateLimiterPlugin: (ms: number) => Plugin<Logger>;
+//#endregion
+export { rateLimiterPlugin };

package/dist/plugins/rate-limiter.mjs

@@ -0,0 +1 @@
+import{createPlugin as e}from"../lib/mods.mjs";const t=t=>{let n,r=0;return e({name:`rate-limiter`,enrichLogger(e){return n=e.emit.bind(e),e.emit=(i,a)=>{let o=Date.now();return o-r<t?e:(r=o,n(i,a))},e},teardown(e){return e.emit=n,e}})};export{t as rateLimiterPlugin};

package/dist/shared.d.mts

@@ -0,0 +1,6 @@
+import { Logger } from "./core/logger.mjs";
+
+//#region src/shared.d.ts
+declare const logger: Logger;
+//#endregion
+export { logger };

package/dist/shared.mjs

@@ -0,0 +1 @@
+import{Logger as e}from"./core/logger.mjs";const t=new e;export{t as logger};

package/dist/transports/console/index.d.mts

@@ -0,0 +1,13 @@
+import { Transport } from "../../types/mods.mjs";
+import { TimestampType } from "../../types/format.mjs";
+
+//#region src/transports/console/index.d.ts
+interface ConsoleTransportOptions {
+  timestamp?: TimestampType;
+  symbols?: boolean;
+  colors?: boolean;
+  level?: boolean;
+}
+declare const consoleTransport: (options?: ConsoleTransportOptions) => Transport;
+//#endregion
+export { ConsoleTransportOptions, consoleTransport };

package/dist/transports/console/index.mjs

@@ -0,0 +1 @@
+import{makeTimestamp as e}from"../../lib/format.mjs";import{createTransport as t}from"../../lib/mods.mjs";import{colors as n,getLevelColor as r}from"./lib/colors.mjs";import{symbolize as i}from"./lib/symbols.mjs";import{consoleMethods as a}from"./lib/utils.mjs";const o=(o={timestamp:`local`,colors:!0,symbols:!0,level:!0})=>{let s=(e,t)=>o.colors?e(t):t,c=e(o.timestamp??`local`),l=(e,t)=>{let a=o.symbols??!0?i(e):null,l=r(e),u=new Date,d=[s(n.gray,c(u)),a?s(l,a):``];return(o.level??!0)&&d.push(`[${s(l,e.toUpperCase())}]`),[d.filter(e=>e.length).join(` `),...t]};return t({name:`console`,send:(e,t)=>{let n=l(t.level,t.data),r=a[t.level]||`log`,i=console[r];return i(...n)},batch(e,t){Promise.all(t.map(t=>this.send(e,t)))}})};export{o as consoleTransport};

package/dist/transports/console/lib/colors.d.mts

@@ -0,0 +1,20 @@
+import { LogLevel } from "../../../lib/levels.mjs";
+
+//#region src/transports/console/lib/colors.d.ts
+declare const SUPPORTS_COLORS: boolean;
+declare const colorize: (code: number, str: string) => string;
+declare const getLevelColor: (level: LogLevel) => ColorFn;
+declare const colors: {
+  readonly gray: (s: string) => string;
+  readonly red: (s: string) => string;
+  readonly green: (s: string) => string;
+  readonly yellow: (s: string) => string;
+  readonly blue: (s: string) => string;
+  readonly purple: (s: string) => string;
+};
+type Colors = typeof colors;
+type Color = keyof Colors;
+type ColorFn = Colors[Color];
+declare const colorMap: Partial<Record<LogLevel, ColorFn>>;
+//#endregion
+export { Color, ColorFn, Colors, SUPPORTS_COLORS, colorMap, colorize, colors, getLevelColor };

package/dist/transports/console/lib/colors.mjs

@@ -0,0 +1 @@
+import{supportsColors as e}from"../../../lib/utils.mjs";const t=e(),n=(e,n)=>t?`\x1b[${e}m${n}\x1b[0m`:n,r=e=>a[e]??i.gray,i={gray:e=>n(90,e),red:e=>n(31,e),green:e=>n(32,e),yellow:e=>n(33,e),blue:e=>n(34,e),purple:e=>n(34,e)},a={error:i.red,warn:i.yellow,success:i.green,debug:i.purple,fatal:i.red,info:i.blue,trace:i.gray};export{t as SUPPORTS_COLORS,a as colorMap,n as colorize,i as colors,r as getLevelColor};

package/dist/transports/console/lib/symbols.d.mts

@@ -0,0 +1,15 @@
+import { LogLevel } from "../../../lib/levels.mjs";
+
+//#region src/transports/console/lib/symbols.d.ts
+type Symbols = Partial<Record<LogLevel | (string & {}), string>>;
+declare const symbols: {
+  readonly success: "✔";
+  readonly error: "✖";
+  readonly warn: "⚠";
+  readonly info: "i";
+  readonly arrow: "➜";
+};
+declare const SUPPORTS_SYMBOLS: boolean;
+declare const symbolize: (level: LogLevel) => string;
+//#endregion
+export { SUPPORTS_SYMBOLS, Symbols, symbolize, symbols };

package/dist/transports/console/lib/symbols.mjs

@@ -0,0 +1 @@
+import{supportsUnicode as e}from"../../../lib/utils.mjs";const t={success:`✔`,error:`✖`,warn:`⚠`,info:`i`,arrow:`➜`},n=e(),r=e=>n&&e in t?t[e]:``;export{n as SUPPORTS_SYMBOLS,r as symbolize,t as symbols};

package/dist/transports/console/lib/utils.d.mts

@@ -0,0 +1,7 @@
+import { LogLevel } from "../../../lib/levels.mjs";
+import { ConsoleMethods } from "../types.mjs";
+
+//#region src/transports/console/lib/utils.d.ts
+declare const consoleMethods: Partial<Record<LogLevel, ConsoleMethods>>;
+//#endregion
+export { consoleMethods };

package/dist/transports/console/lib/utils.mjs

@@ -0,0 +1 @@
+const e={info:`info`,warn:`warn`,error:`error`,debug:`debug`,success:`log`};export{e as consoleMethods};

package/dist/transports/console/types.d.mts

@@ -0,0 +1,4 @@
+//#region src/transports/console/types.d.ts
+type ConsoleMethods = keyof Pick<Console, "log" | "warn" | "error" | "info" | "debug">;
+//#endregion
+export { ConsoleMethods };

package/dist/transports/console/types.mjs

@@ -0,0 +1 @@
+export{};

package/dist/transports/discord/index.d.mts

@@ -0,0 +1,9 @@
+import { Transport } from "../../types/mods.mjs";
+
+//#region src/transports/discord/index.d.ts
+interface DiscordTransportOptions {
+  webhookUrl: string;
+}
+declare const discordTransport: (options: DiscordTransportOptions) => Transport;
+//#endregion
+export { DiscordTransportOptions, discordTransport };

package/dist/transports/discord/index.mjs

@@ -0,0 +1,2 @@
+import{createTransport as e}from"../../lib/mods.mjs";import{httpTransport as t}from"../http.mjs";const n=n=>{let r=t({endpoint:n.webhookUrl,method:`POST`,headers:{"Content-Type":`application/json`},transformBody:e=>{let t={username:`Logger`,embeds:[{title:`Log Entries`,description:e.map(e=>`**[${e.level.toUpperCase()}]** ${e.data.join(` `)}`).join(`
+`),color:5814783,timestamp:new Date().toISOString(),footer:{text:`Total Entries: ${e.length}`}}]};return JSON.stringify(t)}});return e({name:`discord`,send(...e){return r.send(...e)},batch(...e){return r.batch?.(...e)}})};export{n as discordTransport};

package/dist/transports/expo-fs/index.d.mts

@@ -0,0 +1,15 @@
+import { Transport } from "../../types/mods.mjs";
+import { TimestampType } from "../../types/format.mjs";
+import { FileLogger } from "./lib/file-logger.mjs";
+
+//#region src/transports/expo-fs/index.d.ts
+declare let expoFileLogger: FileLogger | null;
+interface ExpoFileSystemTransportOptions {
+  filename?: string;
+  timestamp?: TimestampType;
+  raw?: boolean;
+  cleanOnStart?: boolean;
+}
+declare const expoFileSystemTransport: (options?: ExpoFileSystemTransportOptions) => Transport;
+//#endregion
+export { ExpoFileSystemTransportOptions, expoFileLogger, expoFileSystemTransport };

package/dist/transports/expo-fs/index.mjs

@@ -0,0 +1,2 @@
+import{makeTimestamp as e}from"../../lib/format.mjs";import{createTransport as t}from"../../lib/mods.mjs";import"./lib/constants.mjs";import{FileLogger as n}from"./lib/file-logger.mjs";let r=null;const i=(i={timestamp:`local`})=>{let a=i.filename??`app.log`,o=e(i.timestamp??`local`);r=new n({filename:a}),r.open();let s=e=>{if(i.raw)try{return JSON.stringify(e)}catch{return String(e)}return[[o(e.time),`[${e.level.toUpperCase()}]`].filter(e=>e.trim().length).join(` `),...e.data?.map?.(e=>{if(!e)return``;if(typeof e==`string`||typeof e==`number`||typeof e==`boolean`)return e.toString().trim();try{return JSON.stringify(e)}catch{return String(e)}})].filter(e=>e.trim().length).join(` `)};return t({name:`expo-fs`,send:(e,t)=>{let n=s(t);r?.append(n)},batch(e,t){let n=t.map(e=>s(e)).join(`
+`);r?.append(n)},[Symbol.dispose](){r?.close()},async[Symbol.asyncDispose](){r?.close()}})};export{r as expoFileLogger,i as expoFileSystemTransport};

package/dist/transports/expo-fs/lib/constants.d.mts

@@ -0,0 +1,4 @@
+//#region src/transports/expo-fs/lib/constants.d.ts
+declare const LOG_FILE_SEPARATOR = "\n";
+//#endregion
+export { LOG_FILE_SEPARATOR };

package/dist/transports/expo-fs/lib/constants.mjs

@@ -0,0 +1,2 @@
+const e=`
+`;export{e as LOG_FILE_SEPARATOR};

package/dist/transports/expo-fs/lib/file-logger.d.mts

@@ -0,0 +1,20 @@
+//#region src/transports/expo-fs/lib/file-logger.d.ts
+interface FileLoggerOptions {
+  filename: string;
+  cleanOnStart?: boolean;
+}
+declare class FileLogger {
+  private file;
+  private handle;
+  private readonly cleanOnStart;
+  readonly path: string;
+  constructor(options: FileLoggerOptions);
+  open(): void;
+  append(line: string): void;
+  close(): void;
+  readBytes(length: number): Uint8Array<ArrayBuffer>;
+  readString(length: number): string;
+  readLogEntries(): Promise<string[]>;
+}
+//#endregion
+export { FileLogger, FileLoggerOptions };

package/dist/transports/expo-fs/lib/file-logger.mjs

@@ -0,0 +1,3 @@
+import"./constants.mjs";import{applicationName as e}from"expo-application";import{File as t,Paths as n}from"expo-file-system";var r=class{file=null;handle=null;cleanOnStart=!1;path;constructor(t){let r=n.join(n.cache,e||`padosoft`,t.filename);this.path=r,this.cleanOnStart=t.cleanOnStart??!1}open(){this.handle||=(this.file=new t(this.path),this.cleanOnStart&&this.file.delete(),this.file.create({intermediates:!0,overwrite:!0}),this.file.open())}append(e){if(!this.handle)throw Error(`Log file not open`);let t=new TextEncoder().encode(`${e}
+`);this.handle.writeBytes(t)}close(){this.handle&&=(this.handle.close(),null)}readBytes(e){if(!this.handle)throw Error(`Log file not open`);return this.handle.readBytes(e)}readString(e){if(!this.handle)throw Error(`Log file not open`);let t=this.handle.readBytes(e);return new TextDecoder().decode(t)}async readLogEntries(){if(!this.handle)throw Error(`Log file not open`);let e=await this.file?.text();return e?e.split(`
+`).filter(e=>e.trim().length>0):[]}};export{r as FileLogger};

package/dist/transports/file.d.mts

@@ -0,0 +1,21 @@
+import { Transport } from "../types/mods.mjs";
+import { OpenMode } from "node:fs";
+
+//#region src/transports/file.d.ts
+interface FileTransportOptions {
+  /**
+  * Full path to the log file.
+  */
+  filePath: string;
+  /**
+  * Optional flag to append to file (default is true).
+  */
+  append?: boolean;
+  /**
+  * Optional flag to write data in mode different than appen/write
+  */
+  writeMode?: OpenMode;
+}
+declare const fileTransport: (options: FileTransportOptions) => Transport;
+//#endregion
+export { FileTransportOptions, fileTransport };

package/dist/transports/file.mjs

@@ -0,0 +1,2 @@
+import{createTransport as e}from"../lib/mods.mjs";import{mkdir as t,open as n}from"node:fs/promises";import*as r from"node:path";const i=i=>{let a=i.writeMode??(i.append?`a`:`w`),o=null,s=e=>JSON.stringify(e)+`
+`;return(async()=>(o||=(await t(r.dirname(i.filePath),{recursive:!0}),await n(i.filePath,a)),o))(),e({name:`file`,send(e,t){o?.write(s(t))},batch(e,t){let n=t.map(s).join(``);o?.write(n)},async teardown(){o?.close()},[Symbol.dispose](){this.teardown()},async[Symbol.asyncDispose](){await this.teardown()}})};export{i as fileTransport};

package/dist/transports/http.d.mts

@@ -0,0 +1,18 @@
+import { Transport } from "../types/mods.mjs";
+import { LogEntry } from "../types/logger.mjs";
+
+//#region src/transports/http.d.ts
+interface HttpTransportOptions {
+  /** Endpoint URL to send logs to */
+  endpoint?: string;
+  /** HTTP method (default: POST) */
+  method?: string;
+  /** Optional headers */
+  headers?: Record<string, string>;
+  transformBody?: (body: LogEntry[]) => string;
+  /** Custom fetch function (default: global fetch) */
+  fetchFn?: (batch: LogEntry[]) => Promise<void>;
+}
+declare const httpTransport: (options: HttpTransportOptions) => Transport;
+//#endregion
+export { HttpTransportOptions, httpTransport };

package/dist/transports/http.mjs

@@ -0,0 +1 @@
+import{createTransport as e}from"../lib/mods.mjs";const t=t=>{let n=t.method??`POST`,r={"Content-Type":`application/json`,...t.headers},i=t.fetchFn??(async e=>{if(!t.endpoint)throw Error(`httpTransport: no endpoint or fetchFn provided`);let i=t.transformBody?t.transformBody(e):JSON.stringify(e);return globalThis.fetch(t.endpoint,{method:n,headers:r,body:i})});return e({name:`http`,send(e,t){i([t])},batch(e,t){i(t)}})};export{t as httpTransport};

package/dist/transports/otel/index.d.mts

@@ -0,0 +1,10 @@
+import { Transport } from "../../types/mods.mjs";
+import { OpenTelemetryTransportOptions } from "./types.mjs";
+
+//#region src/transports/otel/index.d.ts
+/**
+* OpenTelemetry transport (portable: Node + Edge + RN).
+*/
+declare const openTelemetryTransport: (options: OpenTelemetryTransportOptions) => Transport;
+//#endregion
+export { openTelemetryTransport };

package/dist/transports/otel/index.mjs

@@ -0,0 +1 @@
+import{createTransport as e}from"../../lib/mods.mjs";import{name as t,version as n}from"../../package.mjs";import{createLogProcessor as r,mapLevelToSeverity as i}from"./utils.mjs";import{DiagConsoleLogger as a,DiagLogLevel as o,context as s,diag as c,trace as l}from"@opentelemetry/api";import{logs as u}from"@opentelemetry/api-logs";import{OTLPLogExporter as d}from"@opentelemetry/exporter-logs-otlp-http";import{detectResources as f,envDetector as p,hostDetector as m,osDetector as h,processDetector as g,resourceFromAttributes as _,serviceInstanceIdDetector as v}from"@opentelemetry/resources";import{LoggerProvider as y}from"@opentelemetry/sdk-logs";import{ATTR_SERVICE_NAME as b,ATTR_SERVICE_VERSION as x}from"@opentelemetry/semantic-conventions";const S=S=>{let C=S.service?.name||t,w=S.service?.version||n;S.debug&&c.setLogger(new a,o.DEBUG);let T=f({detectors:[p,m,h,g,v]}),E=_({[b]:C,[x]:w,"deployment.environment":S.environment??`unknown`}),D=_(S.resources||{}),O=T.merge(E).merge(D),k=new d({concurrencyLimit:10,...S.httpExporterOptions}),A=S.exporters.map(e=>r(e,S.processor))||[r(k,S.processor)],j=S.loggerProvider??new y({resource:O,processors:A});u.setGlobalLoggerProvider(j);let M=j.getLogger(C,w);return e({name:`opentelemetry`,async send(e,t){let n=i(t.level),r=t.data.join(` `),a={args:t.data,time:t.time.toISOString()},o=s.active(),c=l.getSpan(o)?.spanContext();c&&(a.trace_id=c.traceId,a.span_id=c.spanId,a.trace_flags=c.traceFlags),M.emit({body:r,timestamp:t.time,severityNumber:n,severityText:t.level.toUpperCase(),attributes:a,context:o})},async batch(e,t){await Promise.allSettled(t.map(t=>this.send(e,t)))},async teardown(){await Promise.allSettled(A.map(e=>e.shutdown())),u.disable()}})};export{S as openTelemetryTransport};

package/dist/transports/otel/types.d.mts

@@ -0,0 +1,23 @@
+import { LoggerProvider } from "@opentelemetry/api-logs";
+import { DetectedResourceAttributes } from "@opentelemetry/resources";
+import { LogRecordExporter, LogRecordProcessor } from "@opentelemetry/sdk-logs";
+import { OTLPExporterNodeConfigBase } from "@opentelemetry/otlp-exporter-base";
+
+//#region src/transports/otel/types.d.ts
+interface OTELServiceOptions {
+  name?: string;
+  version?: string;
+}
+type OTELLogProcessor = (_exporter: LogRecordExporter) => LogRecordProcessor;
+interface OpenTelemetryTransportOptions {
+  service?: OTELServiceOptions;
+  environment?: string;
+  loggerProvider: LoggerProvider;
+  processor?: "batch" | "simple" | OTELLogProcessor;
+  debug?: boolean;
+  httpExporterOptions?: OTLPExporterNodeConfigBase;
+  resources?: DetectedResourceAttributes;
+  exporters: LogRecordExporter[];
+}
+//#endregion
+export { OTELLogProcessor, OTELServiceOptions, OpenTelemetryTransportOptions };

package/dist/transports/otel/types.mjs

@@ -0,0 +1 @@
+export{};

package/dist/transports/otel/utils.d.mts

@@ -0,0 +1,11 @@
+import { LogEntry } from "../../types/logger.mjs";
+import { OpenTelemetryTransportOptions } from "./types.mjs";
+import { SeverityNumber } from "@opentelemetry/api-logs";
+import { LogRecordExporter, LogRecordProcessor } from "@opentelemetry/sdk-logs";
+
+//#region src/transports/otel/utils.d.ts
+declare const levelToSeverity: Record<LogEntry["level"], SeverityNumber>;
+declare const mapLevelToSeverity: (level: LogEntry["level"]) => SeverityNumber;
+declare const createLogProcessor: (exporter: LogRecordExporter, type?: OpenTelemetryTransportOptions["processor"]) => LogRecordProcessor;
+//#endregion
+export { createLogProcessor, levelToSeverity, mapLevelToSeverity };

package/dist/transports/otel/utils.mjs

@@ -0,0 +1 @@
+import{SeverityNumber as e}from"@opentelemetry/api-logs";import{BatchLogRecordProcessor as t,SimpleLogRecordProcessor as n}from"@opentelemetry/sdk-logs";const r={fatal:e.FATAL,error:e.ERROR,warn:e.WARN,info:e.INFO,success:e.INFO,debug:e.DEBUG,trace:e.TRACE},i=t=>r[t]??e.UNSPECIFIED,a=(e,r=`batch`)=>typeof r==`function`?r(e):new{batch:t,simple:n}[r](e);export{a as createLogProcessor,r as levelToSeverity,i as mapLevelToSeverity};

package/dist/transports/ws.d.mts

@@ -0,0 +1,9 @@
+import { Transport } from "../types/mods.mjs";
+
+//#region src/transports/ws.d.ts
+interface WebSocketTransportOptions {
+  url: string;
+}
+declare const webSocketTransport: (options: WebSocketTransportOptions) => Transport;
+//#endregion
+export { WebSocketTransportOptions, webSocketTransport };

package/dist/transports/ws.mjs

@@ -0,0 +1 @@
+import{createTransport as e}from"../lib/mods.mjs";import"../lib/index.mjs";const t=t=>{let n=new WebSocket(t.url);return e({name:`ws`,send(e,t){n.send(JSON.stringify([t]))},batch(e,t){n.send(JSON.stringify(t))},teardown(){n.close()}})};export{t as webSocketTransport};

package/dist/types/batching.d.mts

@@ -0,0 +1,44 @@
+import { LogEntry } from "./logger.mjs";
+
+//#region src/types/batching.d.ts
+/**
+* Options that control batching behavior in the Logger.
+*/
+interface BatchingOptions {
+  /**
+  * Flush when buffer reaches this size.
+  * @example 10
+  */
+  maxBatchSize: number;
+  /**
+  * Also flush after this many milliseconds (if > 0).
+  * Disabled if `0` or undefined.
+  * @example 2000
+  */
+  maxIntervalMs?: number | 0;
+  /**
+  * Whether to flush remaining logs automatically on dispose/close.
+  * @default true
+  */
+  flushOnDispose?: boolean;
+  /**
+  * Drop the newest log when buffer is full instead of flushing immediately.
+  * @default false
+  */
+  dropIfBufferFull?: boolean;
+}
+/**
+* Internal batching state, maintained per Logger.
+*/
+interface BatchingState {
+  /**
+  * Current buffer of entries waiting to be flushed.
+  */
+  buf: LogEntry[];
+  /**
+  * Reference to the currently scheduled timer, if any.
+  */
+  timer: ReturnType<typeof setTimeout> | null;
+}
+//#endregion
+export { BatchingOptions, BatchingState };

package/dist/types/batching.mjs

@@ -0,0 +1 @@
+export{};

package/dist/types/format.d.mts

@@ -0,0 +1,4 @@
+//#region src/types/format.d.ts
+type TimestampType = ((date: Date) => string) | "local" | "utc";
+//#endregion
+export { TimestampType };

package/dist/types/format.mjs

@@ -0,0 +1 @@
+export{};

package/dist/types/index.d.mts

@@ -0,0 +1,4 @@
+import { Mod, Plugin, Transport } from "./mods.mjs";
+import { LogEntry, LoggerOptions } from "./logger.mjs";
+import { BatchingOptions, BatchingState } from "./batching.mjs";
+export { BatchingOptions, BatchingState, LogEntry, LoggerOptions, Mod, Plugin, Transport };

package/dist/types/index.mjs

@@ -0,0 +1 @@
+export{};

package/dist/types/logger.d.mts

@@ -0,0 +1,46 @@
+import { LogLevel } from "../lib/levels.mjs";
+import { Plugin, Transport } from "./mods.mjs";
+import { BatchingOptions } from "./batching.mjs";
+
+//#region src/types/logger.d.ts
+/**
+* Represents a single log entry created by the Logger.
+*/
+interface LogEntry {
+  /**
+  * Timestamp when the entry was created.
+  */
+  time: Date;
+  /**
+  * Severity level of the entry.
+  */
+  level: LogLevel;
+  /**
+  * Arbitrary data passed by the user.
+  */
+  data: unknown[];
+}
+/**
+* Options passed to the Logger constructor or clone.
+*/
+interface LoggerOptions {
+  /**
+  * Minimum severity level to emit.
+  * @default LogLevels.INFO
+  */
+  level?: LogLevel;
+  /**
+  * Destination transports where log entries will be delivered.
+  */
+  transports?: Transport[];
+  /**
+  * Plugins that can enrich logger or transform log entries.
+  */
+  plugins?: Plugin[];
+  /**
+  * Optional batching configuration.
+  */
+  batching?: BatchingOptions;
+}
+//#endregion
+export { LogEntry, LoggerOptions };

package/dist/types/logger.mjs

@@ -0,0 +1 @@
+export{};

package/dist/types/mods.d.mts

@@ -0,0 +1,74 @@
+import { LogEntry } from "./logger.mjs";
+import { Logger } from "../core/logger.mjs";
+
+//#region src/types/mods.d.ts
+interface Mod<Tag extends string> {
+  readonly _tag: Tag;
+}
+/**
+* A plugin can extend the Logger with transformations or enrichments.
+*/
+interface Plugin<EnrichedLogger extends Logger = Logger> extends Mod<"plugin"> {
+  /**
+  * Unique plugin name.
+  * @example "rate-limiter"
+  */
+  name: string;
+  /**
+  * Transform a log entry before it is emitted.
+  */
+  transformEntry?(logger: EnrichedLogger, entry: LogEntry): LogEntry | Promise<LogEntry>;
+  /**
+  * Enrich the Logger instance with additional methods or props.
+  * May return sync or async.
+  */
+  enrichLogger?(logger: Logger): EnrichedLogger | Promise<EnrichedLogger>;
+  /**
+  * Cleanup called when logger closes.
+  * @property
+  */
+  teardown?(logger: EnrichedLogger): Logger;
+  /**
+  * Optional dispose hook (sync).
+  */
+  [Symbol.dispose]?(): void;
+  /**
+  * Optional dispose hook (async).
+  */
+  [Symbol.asyncDispose]?(): Promise<void>;
+}
+/**
+* A transport is responsible for delivering log entries to a destination
+* (console, file, remote API, etc.).
+*/
+interface Transport extends Mod<"transport"> {
+  /**
+  * Unique transport name.
+  * @example "websocket"
+  */
+  name: string;
+  /**
+  * Send a single log entry.
+  * Called immediately unless batching is enabled.
+  */
+  send(logger: Logger, entry: LogEntry): void | Promise<void>;
+  /**
+  * Send a batch of log entries at once.
+  * Used if available when batching is enabled.
+  */
+  batch?(logger: Logger, batch: LogEntry[]): void | Promise<void>;
+  /**
+  * Optional cleanup invoked during logger shutdown.
+  */
+  teardown?(logger: Logger): void | Promise<void>;
+  /**
+  * Optional sync dispose hook.
+  */
+  [Symbol.dispose]?(): void;
+  /**
+  * Optional async dispose hook.
+  */
+  [Symbol.asyncDispose]?(): Promise<void>;
+}
+//#endregion
+export { Mod, Plugin, Transport };

package/dist/types/mods.mjs

@@ -0,0 +1 @@
+export{};

package/package.json

@@ -0,0 +1,200 @@
+{
+	"name": "@padosoft/logger",
+	"version": "1.3.2",
+	"type": "module",
+	"types": "./dist/index.d.mts",
+	"files": [
+		"dist"
+	],
+	"publishConfig": {
+		"access": "public",
+		"registry": "https://registry.npmjs.org/"
+	},
+	"repository": {
+		"url": "git+https://github.com/padosoft/ts-support.git"
+	},
+	"scripts": {
+		"build": "tsdown",
+		"ts:check": "tsc --noEmit"
+	},
+	"devDependencies": {
+		"@padosoft/config": "workspace:^",
+		"@opentelemetry/api": "^1.9.1",
+		"@opentelemetry/api-logs": "^0.219.0",
+		"@opentelemetry/exporter-logs-otlp-http": "^0.219.0",
+		"@opentelemetry/resources": "^2.8.0",
+		"@opentelemetry/sdk-logs": "^0.219.0",
+		"@opentelemetry/semantic-conventions": "^1.41.1",
+		"expo-file-system": "^56.0.8",
+		"expo-application": "^56.0.3"
+	},
+	"dependencies": {},
+	"peerDependencies": {
+		"@opentelemetry/api": "*",
+		"@opentelemetry/api-logs": "*",
+		"@opentelemetry/exporter-logs-otlp-http": "*",
+		"@opentelemetry/resources": "*",
+		"@opentelemetry/sdk-logs": "*",
+		"@opentelemetry/semantic-conventions": "*",
+		"expo-file-system": "*",
+		"expo-application": "*"
+	},
+	"peerDependenciesMeta": {
+		"@opentelemetry/api": {
+			"optional": true
+		},
+		"@opentelemetry/api-logs": {
+			"optional": true
+		},
+		"@opentelemetry/resources": {
+			"optional": true
+		},
+		"@opentelemetry/exporter-logs-otlp-http": {
+			"optional": true
+		},
+		"@opentelemetry/sdk-logs": {
+			"optional": true
+		},
+		"@opentelemetry/semantic-conventions": {
+			"optional": true
+		},
+		"expo-file-system": {
+			"optional": true
+		}
+	},
+	"exports": {
+		".": {
+			"default": "./dist/index.mjs",
+			"types": "./dist/index.d.mts"
+		},
+		"./adapters/drizzle": {
+			"default": "./dist/adapters/drizzle.mjs",
+			"types": "./dist/adapters/drizzle.d.mts"
+		},
+		"./adapters/hono": {
+			"default": "./dist/adapters/hono.mjs",
+			"types": "./dist/adapters/hono.d.mts"
+		},
+		"./core/logger": {
+			"default": "./dist/core/logger.mjs",
+			"types": "./dist/core/logger.d.mts"
+		},
+		"./lib": {
+			"default": "./dist/lib/index.mjs",
+			"types": "./dist/lib/index.d.mts"
+		},
+		"./lib/format": {
+			"default": "./dist/lib/format.mjs",
+			"types": "./dist/lib/format.d.mts"
+		},
+		"./lib/levels": {
+			"default": "./dist/lib/levels.mjs",
+			"types": "./dist/lib/levels.d.mts"
+		},
+		"./lib/mods": {
+			"default": "./dist/lib/mods.mjs",
+			"types": "./dist/lib/mods.d.mts"
+		},
+		"./lib/utils": {
+			"default": "./dist/lib/utils.mjs",
+			"types": "./dist/lib/utils.d.mts"
+		},
+		"./plugins/context": {
+			"default": "./dist/plugins/context.mjs",
+			"types": "./dist/plugins/context.d.mts"
+		},
+		"./plugins/metrics": {
+			"default": "./dist/plugins/metrics.mjs",
+			"types": "./dist/plugins/metrics.d.mts"
+		},
+		"./plugins/rate-limiter": {
+			"default": "./dist/plugins/rate-limiter.mjs",
+			"types": "./dist/plugins/rate-limiter.d.mts"
+		},
+		"./shared": {
+			"default": "./dist/shared.mjs",
+			"types": "./dist/shared.d.mts"
+		},
+		"./transports/console": {
+			"default": "./dist/transports/console/index.mjs",
+			"types": "./dist/transports/console/index.d.mts"
+		},
+		"./transports/console/lib/colors": {
+			"default": "./dist/transports/console/lib/colors.mjs",
+			"types": "./dist/transports/console/lib/colors.d.mts"
+		},
+		"./transports/console/lib/symbols": {
+			"default": "./dist/transports/console/lib/symbols.mjs",
+			"types": "./dist/transports/console/lib/symbols.d.mts"
+		},
+		"./transports/console/lib/utils": {
+			"default": "./dist/transports/console/lib/utils.mjs",
+			"types": "./dist/transports/console/lib/utils.d.mts"
+		},
+		"./transports/console/types": {
+			"default": "./dist/transports/console/types.mjs",
+			"types": "./dist/transports/console/types.d.mts"
+		},
+		"./transports/discord": {
+			"default": "./dist/transports/discord/index.mjs",
+			"types": "./dist/transports/discord/index.d.mts"
+		},
+		"./transports/expo-fs": {
+			"default": "./dist/transports/expo-fs/index.mjs",
+			"types": "./dist/transports/expo-fs/index.d.mts"
+		},
+		"./transports/expo-fs/lib/constants": {
+			"default": "./dist/transports/expo-fs/lib/constants.mjs",
+			"types": "./dist/transports/expo-fs/lib/constants.d.mts"
+		},
+		"./transports/expo-fs/lib/file-logger": {
+			"default": "./dist/transports/expo-fs/lib/file-logger.mjs",
+			"types": "./dist/transports/expo-fs/lib/file-logger.d.mts"
+		},
+		"./transports/file": {
+			"default": "./dist/transports/file.mjs",
+			"types": "./dist/transports/file.d.mts"
+		},
+		"./transports/http": {
+			"default": "./dist/transports/http.mjs",
+			"types": "./dist/transports/http.d.mts"
+		},
+		"./transports/otel": {
+			"default": "./dist/transports/otel/index.mjs",
+			"types": "./dist/transports/otel/index.d.mts"
+		},
+		"./transports/otel/types": {
+			"default": "./dist/transports/otel/types.mjs",
+			"types": "./dist/transports/otel/types.d.mts"
+		},
+		"./transports/otel/utils": {
+			"default": "./dist/transports/otel/utils.mjs",
+			"types": "./dist/transports/otel/utils.d.mts"
+		},
+		"./transports/ws": {
+			"default": "./dist/transports/ws.mjs",
+			"types": "./dist/transports/ws.d.mts"
+		},
+		"./types": {
+			"default": "./dist/types/index.mjs",
+			"types": "./dist/types/index.d.mts"
+		},
+		"./types/batching": {
+			"default": "./dist/types/batching.mjs",
+			"types": "./dist/types/batching.d.mts"
+		},
+		"./types/format": {
+			"default": "./dist/types/format.mjs",
+			"types": "./dist/types/format.d.mts"
+		},
+		"./types/logger": {
+			"default": "./dist/types/logger.mjs",
+			"types": "./dist/types/logger.d.mts"
+		},
+		"./types/mods": {
+			"default": "./dist/types/mods.mjs",
+			"types": "./dist/types/mods.d.mts"
+		},
+		"./package.json": "./package.json"
+	}
+}