loggily 0.7.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,199 +0,0 @@
1
- //#region src/pipeline.d.ts
2
- type OutputLogLevel = "trace" | "debug" | "info" | "warn" | "error";
3
- type LogLevel = OutputLogLevel | "silent";
4
- type LogFormat = "console" | "json";
5
- type LogEvent = {
6
- kind: "log";
7
- time: number;
8
- namespace: string;
9
- level: OutputLogLevel;
10
- message: string;
11
- props?: Record<string, unknown>;
12
- };
13
- type SpanEvent = {
14
- kind: "span";
15
- time: number;
16
- namespace: string;
17
- name: string;
18
- duration: number;
19
- props?: Record<string, unknown>;
20
- spanId: string;
21
- traceId: string;
22
- parentId: string | null;
23
- };
24
- type Event = LogEvent | SpanEvent;
25
- type Stage = (event: Event) => Event | null | void;
26
- declare const LOG_LEVEL_PRIORITY: Record<LogLevel, number>;
27
- declare function safeStringify(value: unknown): string;
28
- type NsFilter = (namespace: string) => boolean;
29
- interface Pipeline {
30
- dispatch: (event: Event) => void;
31
- level: LogLevel;
32
- dispose: () => void;
33
- }
34
- interface ScopeConfig {
35
- level: LogLevel;
36
- ns: NsFilter | null;
37
- format: LogFormat;
38
- }
39
- declare function buildPipeline(elements: unknown[], parentConfig?: Partial<ScopeConfig>): Pipeline;
40
- declare function defaultPipeline(): Pipeline;
41
- //#endregion
42
- //#region src/core.d.ts
43
- interface SpanRecord {
44
- readonly name: string;
45
- readonly durationMs: number;
46
- }
47
- interface SpanRecorder {
48
- recordSpan(data: SpanRecord): void;
49
- }
50
- /** @internal */
51
- declare let _ambientRecorder: SpanRecorder | null;
52
- declare function _setAmbientRecorder(recorder: SpanRecorder | null): void;
53
- type LazyMessage = string | (() => string);
54
- type LazyProps = Record<string, unknown> | (() => Record<string, unknown>);
55
- interface SpanData {
56
- readonly id: string;
57
- readonly traceId: string;
58
- readonly parentId: string | null;
59
- readonly startTime: number;
60
- readonly endTime: number | null;
61
- readonly duration: number | null;
62
- [key: string]: unknown;
63
- }
64
- interface Logger {
65
- readonly name: string;
66
- readonly props: Readonly<Record<string, unknown>>;
67
- readonly spanData: SpanData | null;
68
- trace(message: LazyMessage, data?: Record<string, unknown>): void;
69
- debug(message: LazyMessage, data?: Record<string, unknown>): void;
70
- info(message: LazyMessage, data?: Record<string, unknown>): void;
71
- warn(message: LazyMessage, data?: Record<string, unknown>): void;
72
- error(message: LazyMessage, data?: Record<string, unknown>): void;
73
- error(error: Error, data?: Record<string, unknown>): void;
74
- error(error: Error, message: string, data?: Record<string, unknown>): void;
75
- logger(namespace?: string, props?: Record<string, unknown>): ConditionalLogger;
76
- span(namespace?: string, props?: LazyProps): SpanLogger;
77
- child(context: Record<string, unknown>): ConditionalLogger;
78
- /** @deprecated Use .logger() instead for namespace-based children */
79
- child(context: string): ConditionalLogger;
80
- end(): void;
81
- }
82
- interface SpanLogger extends Logger, Disposable {
83
- readonly spanData: SpanData & {
84
- [key: string]: unknown;
85
- };
86
- }
87
- interface ConditionalLogger {
88
- readonly name: string;
89
- readonly props: Readonly<Record<string, unknown>>;
90
- readonly spanData: SpanData | null;
91
- trace?: (message: LazyMessage, data?: Record<string, unknown>) => void;
92
- debug?: (message: LazyMessage, data?: Record<string, unknown>) => void;
93
- info?: (message: LazyMessage, data?: Record<string, unknown>) => void;
94
- warn?: (message: LazyMessage, data?: Record<string, unknown>) => void;
95
- error?: {
96
- (message: LazyMessage, data?: Record<string, unknown>): void;
97
- (error: Error, data?: Record<string, unknown>): void;
98
- (error: Error, message: string, data?: Record<string, unknown>): void;
99
- };
100
- logger(namespace?: string, props?: Record<string, unknown>): ConditionalLogger;
101
- span(namespace?: string, props?: LazyProps): SpanLogger;
102
- child(context: Record<string, unknown>): ConditionalLogger;
103
- child(context: string): ConditionalLogger;
104
- end(): void;
105
- }
106
- declare function resetIds(): void;
107
- /** @internal */
108
- declare function _setContextHooks(hooks: {
109
- getContextTags: () => Record<string, string>;
110
- getContextParent: () => {
111
- spanId: string;
112
- traceId: string;
113
- } | null;
114
- enterContext: (spanId: string, traceId: string, parentId: string | null) => void;
115
- exitContext: (spanId: string) => void;
116
- }): void;
117
- /** @internal */
118
- declare function _clearContextHooks(): void;
119
- interface SpanDataFields {
120
- id: string;
121
- traceId: string;
122
- parentId: string | null;
123
- startTime: number;
124
- endTime: number | null;
125
- duration: number | null;
126
- }
127
- declare function createSpanDataProxy(getFields: () => SpanDataFields, attrs: Record<string, unknown>): SpanData;
128
- declare function startCollecting(): void;
129
- declare function stopCollecting(): SpanData[];
130
- declare function getCollectedSpans(): SpanData[];
131
- declare function clearCollectedSpans(): void;
132
- /**
133
- * Create a logger.
134
- *
135
- * @param name - Logger namespace (e.g., 'myapp', 'myapp:db')
136
- * @param config - Optional config array. Objects configure, arrays branch, values write.
137
- *
138
- * @example
139
- * // Zero config (reads LOG_LEVEL, DEBUG, LOG_FORMAT from env)
140
- * const log = createLogger('myapp')
141
- *
142
- * @example
143
- * // Configured pipeline
144
- * const log = createLogger('myapp', [
145
- * { level: 'debug', ns: '-sql' },
146
- * console,
147
- * { file: '/tmp/app.log', level: 'info', format: 'json' },
148
- * ])
149
- */
150
- declare function createLogger(name: string, config?: unknown[]): ConditionalLogger;
151
- type LoggerFactory = (name: string, config?: unknown[]) => ConditionalLogger;
152
- type LoggerPlugin = (factory: LoggerFactory) => LoggerFactory;
153
- /**
154
- * Compose a custom createLogger with plugins.
155
- *
156
- * @example
157
- * import { createLogger as base, compose } from "loggily"
158
- * import withSentry from "@sentry/loggily"
159
- *
160
- * const createLogger = compose(base, withSentry({ dsn: "..." }))
161
- * const log = createLogger("myapp")
162
- */
163
- declare function compose(base: LoggerFactory, ...plugins: LoggerPlugin[]): LoggerFactory;
164
- /** @deprecated Use createLogger config array: createLogger("x", [{ level }, console]) */
165
- declare function setLogLevel(level: LogLevel): void;
166
- /** @deprecated Level is per-logger in v2 */
167
- declare function getLogLevel(): LogLevel;
168
- /** @deprecated Use TRACE=1 env var */
169
- declare function enableSpans(): void;
170
- /** @deprecated */
171
- declare function disableSpans(): void;
172
- /** @deprecated */
173
- declare function spansAreEnabled(): boolean;
174
- /** @deprecated Use TRACE=namespace env var */
175
- declare function setTraceFilter(namespaces: string[] | null): void;
176
- /** @deprecated */
177
- declare function getTraceFilter(): string[] | null;
178
- /** @deprecated Use DEBUG=namespace env var or { ns } in config array */
179
- declare function setDebugFilter(namespaces: string[] | null): void;
180
- /** @deprecated */
181
- declare function getDebugFilter(): string[] | null;
182
- /** @deprecated Use { format } in config array */
183
- declare function setLogFormat(format: LogFormat): void;
184
- /** @deprecated */
185
- declare function getLogFormat(): LogFormat;
186
- /** @deprecated Omit console from config array instead */
187
- declare function setSuppressConsole(value: boolean): void;
188
- type OutputMode = "console" | "stderr" | "writers-only";
189
- /** @deprecated Use config array */
190
- declare function setOutputMode(_mode: OutputMode): void;
191
- /** @deprecated */
192
- declare function getOutputMode(): OutputMode;
193
- /** @deprecated Pass writers in config array instead */
194
- declare function addWriter(writer: (formatted: string, level: string) => void): () => void;
195
- /** @deprecated Spans dispatch through the pipeline automatically */
196
- declare function writeSpan(namespace: string, duration: number, attrs: Record<string, unknown>): void;
197
- //#endregion
198
- export { setDebugFilter as A, Event as B, getCollectedSpans as C, getOutputMode as D, getLogLevel as E, setTraceFilter as F, OutputLogLevel as G, LogEvent as H, spansAreEnabled as I, Stage as J, Pipeline as K, startCollecting as L, setLogLevel as M, setOutputMode as N, getTraceFilter as O, setSuppressConsole as P, stopCollecting as R, enableSpans as S, getLogFormat as T, LogFormat as U, LOG_LEVEL_PRIORITY as V, LogLevel as W, defaultPipeline as X, buildPipeline as Y, safeStringify as Z, clearCollectedSpans as _, LoggerFactory as a, createSpanDataProxy as b, SpanData as c, SpanRecorder as d, _ambientRecorder as f, addWriter as g, _setContextHooks as h, Logger as i, setLogFormat as j, resetIds as k, SpanLogger as l, _setAmbientRecorder as m, LazyMessage as n, LoggerPlugin as o, _clearContextHooks as p, SpanEvent as q, LazyProps as r, OutputMode as s, ConditionalLogger as t, SpanRecord as u, compose as v, getDebugFilter as w, disableSpans as x, createLogger as y, writeSpan as z };
199
- //# sourceMappingURL=core-DAFH-huv.d.mts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"core-DAFH-huv.d.mts","names":[],"sources":["../src/pipeline.ts","../src/core.ts"],"mappings":"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"}