@flighthq/log 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './log';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './log';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC"}

package/dist/log.d.ts

@@ -0,0 +1,91 @@
+import type { LogContext, LogData, LogDataProvider, LogEntry, LogFormatter, LogSignals, LogSink, LogSpan, LogTimer, LogTransportBackend } from '@flighthq/types';
+import { LogLevel } from '@flighthq/types';
+export declare function addLogSink(sink: LogSink): void;
+export declare function beginLogGroup(label: string, channel?: string | null): void;
+export declare function clearLogChannelLevels(): void;
+export declare function clearLogGroups(): void;
+export declare function clearLogRedactionPaths(): void;
+export declare function clearLogSerializers(): void;
+export declare function clearLogSinks(): void;
+export declare function clearMemoryLogSink(handle: MemoryLogSink): void;
+export declare function createBufferedLogSink(target: LogSink, options?: {
+    size?: number;
+    intervalMs?: number;
+}): BufferedLogSink;
+export declare function createChildLogContext(parent: Readonly<LogContext>, fields: Readonly<Record<string, unknown>>, channel?: string | null): LogContext;
+export declare function createConsoleCaptureSink(options?: {
+    formatter?: LogFormatter;
+}): LogSink;
+export declare function createFanoutLogSink(...sinks: LogSink[]): LogSink;
+export declare function createFileLogSink(options?: {
+    formatter?: LogFormatter;
+}): FileLogSink;
+export declare function createFilterLogSink(target: LogSink, predicate: (entry: Readonly<LogEntry>) => boolean): LogSink;
+export declare function createJsonLogFormatter(): LogFormatter;
+export declare function createLogContext(channel: string | null, fields?: Readonly<Record<string, unknown>>): LogContext;
+export declare function createLogSpan(name: string, fields?: Readonly<Record<string, unknown>>, channel?: string | null): LogSpan;
+export declare function createMemoryLogSink(capacity: number): MemoryLogSink;
+export declare function createRateLimitedLogSink(target: LogSink, options: {
+    perChannel?: boolean;
+    maxPerInterval: number;
+    intervalMs: number;
+}): RateLimitedLogSink;
+export declare function createSampledLogSink(target: LogSink, rate: number): LogSink;
+export declare function createTextLogFormatter(options?: {
+    indentGroups?: boolean;
+    levelPrefix?: boolean;
+    timestamp?: boolean;
+}): LogFormatter;
+export declare function createWebLogTransportBackend(): LogTransportBackend;
+export declare function disposeFileLogSink(_handle: FileLogSink): void;
+export declare function disposeLogSink(handle: BufferedLogSink): void;
+export declare function enableLogSignals(): LogSignals;
+export declare function endLogGroup(channel?: string | null): void;
+export declare function endLogTimer(timer: Readonly<LogTimer>): number;
+export declare function enterLogSpan(span: Readonly<LogSpan>): void;
+export declare function exitLogSpan(span: Readonly<LogSpan>): void;
+export declare function flushLogSink(handle: BufferedLogSink): void;
+export declare function getLogChannelLevel(channel: string): LogLevel | null;
+export declare function getLogConsoleLevel(): LogLevel;
+export declare function getLogLevel(): LogLevel;
+export declare function getLogLevelName(level: LogLevel): string;
+export declare function getLogTransportBackend(): LogTransportBackend | null;
+export declare function getMemoryLogSinkEntries(handle: MemoryLogSink): readonly LogEntry[];
+export declare function log(level: LogLevel, data: LogData | LogDataProvider, channel?: string | null): void;
+export declare function logAssert(condition: boolean, data: LogData | LogDataProvider, channel?: string | null): void;
+export declare function logDebug(data: LogData | LogDataProvider, channel?: string | null): void;
+export declare function logDebugWith(context: Readonly<LogContext>, data: LogData | LogDataProvider): void;
+export declare function logError(data: LogData | LogDataProvider, channel?: string | null): void;
+export declare function logErrorWith(context: Readonly<LogContext>, data: LogData | LogDataProvider): void;
+export declare function logInfo(data: LogData | LogDataProvider, channel?: string | null): void;
+export declare function logInfoWith(context: Readonly<LogContext>, data: LogData | LogDataProvider): void;
+export declare function logOnce(key: string, level: LogLevel, data: LogData | LogDataProvider, channel?: string | null): boolean;
+export declare function logVerbose(data: LogData | LogDataProvider, channel?: string | null): void;
+export declare function logVerboseWith(context: Readonly<LogContext>, data: LogData | LogDataProvider): void;
+export declare function logWarn(data: LogData | LogDataProvider, channel?: string | null): void;
+export declare function logWarnWith(context: Readonly<LogContext>, data: LogData | LogDataProvider): void;
+export declare function logWith(context: Readonly<LogContext>, level: LogLevel, data: LogData | LogDataProvider): void;
+export declare function parseLogLevel(name: string): LogLevel | null;
+export declare function registerLogSerializer(kind: string, fn: (value: unknown) => Record<string, unknown>): void;
+export declare function removeLogSink(sink: LogSink): boolean;
+export declare function serializeLogError(value: unknown): Record<string, unknown>;
+export declare function setLogChannelLevel(channel: string, level: LogLevel): void;
+export declare function setLogConsoleLevel(level: LogLevel): void;
+export declare function setLogLevel(level: LogLevel): void;
+export declare function setLogRedactionPaths(paths: readonly string[]): void;
+export declare function setLogSink(sink: LogSink | null): void;
+export declare function setLogTransportBackend(backend: LogTransportBackend | null): void;
+export declare function startLogTimer(label: string, channel?: string | null): LogTimer;
+export interface BufferedLogSink {
+    readonly sink: LogSink;
+}
+export interface FileLogSink {
+    readonly sink: LogSink;
+}
+export interface MemoryLogSink {
+    readonly sink: LogSink;
+}
+export interface RateLimitedLogSink {
+    readonly sink: LogSink;
+}
+//# sourceMappingURL=log.d.ts.map

package/dist/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"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"}