84 lines
3.2 KiB
TypeScript
84 lines
3.2 KiB
TypeScript
/*
|
|
Copyright 2020 Bruno Windels <bruno@windels.cloud>
|
|
Copyright 2021 The Matrix.org Foundation C.I.C.
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
*/
|
|
|
|
import {LogLevel, LogFilter} from "./LogFilter";
|
|
import type {BaseLogger} from "./BaseLogger";
|
|
import type {BlobHandle} from "../platform/web/dom/BlobHandle.js";
|
|
|
|
export interface ISerializedItem {
|
|
s: number;
|
|
d?: number;
|
|
v: LogItemValues;
|
|
l: LogLevel;
|
|
e?: {
|
|
stack?: string;
|
|
name: string;
|
|
message: string;
|
|
};
|
|
f?: boolean;
|
|
c?: Array<ISerializedItem>;
|
|
};
|
|
|
|
export interface ILogItem {
|
|
logLevel: LogLevel;
|
|
error?: Error;
|
|
readonly logger: ILogger;
|
|
readonly level: typeof LogLevel;
|
|
readonly end?: number;
|
|
readonly start?: number;
|
|
readonly values: LogItemValues;
|
|
wrap<T>(labelOrValues: LabelOrValues, callback: LogCallback<T>, logLevel?: LogLevel, filterCreator?: FilterCreator): T;
|
|
log(labelOrValues: LabelOrValues, logLevel?: LogLevel): ILogItem;
|
|
set(key: string | object, value: unknown): ILogItem;
|
|
runDetached(labelOrValues: LabelOrValues, callback: LogCallback<unknown>, logLevel?: LogLevel, filterCreator?: FilterCreator): ILogItem;
|
|
wrapDetached(labelOrValues: LabelOrValues, callback: LogCallback<unknown>, logLevel?: LogLevel, filterCreator?: FilterCreator): void;
|
|
refDetached(logItem: ILogItem, logLevel?: LogLevel): void;
|
|
ensureRefId(): void;
|
|
catch(err: Error): Error;
|
|
serialize(filter: LogFilter, parentStartTime: number | undefined, forced: boolean): ISerializedItem | undefined;
|
|
finish(): void;
|
|
child(labelOrValues: LabelOrValues, logLevel?: LogLevel, filterCreator?: FilterCreator): ILogItem;
|
|
}
|
|
|
|
export interface ILogger {
|
|
log(labelOrValues: LabelOrValues, logLevel?: LogLevel): void;
|
|
wrapOrRun<T>(item: ILogItem | undefined, labelOrValues: LabelOrValues, callback: LogCallback<T>, logLevel?: LogLevel, filterCreator?: FilterCreator): T;
|
|
runDetached<T>(labelOrValues: LabelOrValues, callback: LogCallback<T>, logLevel?: LogLevel, filterCreator?: FilterCreator): ILogItem;
|
|
run<T>(labelOrValues: LabelOrValues, callback: LogCallback<T>, logLevel?: LogLevel, filterCreator?: FilterCreator): T;
|
|
export(): Promise<ILogExport | undefined>;
|
|
get level(): typeof LogLevel;
|
|
}
|
|
|
|
export interface ILogExport {
|
|
get count(): number;
|
|
removeFromStore(): Promise<void>;
|
|
asBlob(): BlobHandle;
|
|
}
|
|
|
|
export type LogItemValues = {
|
|
l?: string;
|
|
t?: string;
|
|
id?: unknown;
|
|
status?: string | number;
|
|
refId?: number;
|
|
ref?: number;
|
|
[key: string]: any
|
|
}
|
|
|
|
export type LabelOrValues = string | LogItemValues;
|
|
export type FilterCreator = ((filter: LogFilter, item: ILogItem) => LogFilter);
|
|
export type LogCallback<T> = (item: ILogItem) => T;
|