@subsquid/logger 0.0.1

package/lib/sinks/pretty.js

@@ -0,0 +1,244 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prettyStderrSink = exports.Printer = void 0;
+const util_internal_hex_1 = require("@subsquid/util-internal-hex");
+const assert_1 = __importDefault(require("assert"));
+const supports_color_1 = require("supports-color");
+const level_1 = require("../level");
+class Printer {
+    constructor(out, hasColor) {
+        this.out = out;
+        this.hasColor = hasColor;
+        this.visited = new Set();
+        this.seenRecursion = false;
+    }
+    line(s) {
+        if (s && this.hasColor && this.style) {
+            s = this.style.open + s + this.style.close;
+        }
+        if (this.prefix) {
+            this.out(this.prefix.prepend(s));
+        }
+        else {
+            this.out(s);
+        }
+    }
+    text(text) {
+        for (let line of text.split(/\r?\n/)) {
+            this.line(line);
+        }
+    }
+    begin(prefix, width) {
+        width = width == null ? prefix.length : width;
+        if (this.hasColor && this.style) {
+            prefix = this.style.open + prefix + this.style.close;
+        }
+        this.prefix = new Prefix(prefix, width, this.prefix);
+    }
+    end() {
+        (0, assert_1.default)(this.prefix != null);
+        this.prefix = this.prefix.prev;
+    }
+    property(prefix, val) {
+        switch (typeof val) {
+            case "symbol":
+            case "string":
+                this.begin(prefix);
+                this.text(val.toString());
+                this.end();
+                break;
+            case "boolean":
+            case "bigint":
+            case "number":
+                this.line(`${prefix} ${val}`);
+                break;
+            case "object":
+                if (val instanceof Uint8Array) {
+                    this.line(`${prefix} ${(0, util_internal_hex_1.toHex)(val)}`);
+                }
+                else if (val instanceof Date) {
+                    this.line(`${prefix} ${val}`);
+                }
+                else if (typeof val?.toJSON == 'function') {
+                    this.property(prefix, val.toJSON());
+                }
+                else if (Array.isArray(val)) {
+                    if (val.length == 0) {
+                        this.line(`${prefix} []`);
+                    }
+                    else {
+                        if (this.visited.has(val)) {
+                            this.seenRecursion = true;
+                            return;
+                        }
+                        else {
+                            this.visited.add(val);
+                        }
+                        this.line(prefix);
+                        for (let item of val) {
+                            this.property('  -', item);
+                        }
+                        this.visited.delete(val);
+                    }
+                }
+                else if (val == null) {
+                    this.line(`${prefix} null`);
+                }
+                else {
+                    if (this.visited.has(val)) {
+                        this.seenRecursion = true;
+                        return;
+                    }
+                    else {
+                        this.visited.add(val);
+                    }
+                    let has = false;
+                    for (let key in val) {
+                        if (!has) {
+                            if (prefix == '  -') {
+                                this.begin(prefix);
+                            }
+                            else {
+                                this.line(prefix);
+                                this.begin(' ');
+                            }
+                        }
+                        has = true;
+                        this.property(key + ':', val[key]);
+                    }
+                    if (has) {
+                        this.end();
+                    }
+                    this.visited.delete(val);
+                }
+                break;
+        }
+    }
+    print(rec) {
+        this.begin(formatHead(rec, this.hasColor), 14 + (rec.ns ? rec.ns.length + 1 : 0));
+        if (rec.msg) {
+            this.text(rec.msg);
+        }
+        this.style = { open: '\u001b[2m', close: '\u001b[22m' }; // dim
+        if (rec.err instanceof Error) {
+            this.text(rec.err.stack || rec.err.toString());
+        }
+        for (let key in rec) {
+            switch (key) {
+                case 'time':
+                case 'ns':
+                case 'level':
+                case 'msg':
+                    break;
+                default:
+                    this.property(key + ':', rec[key]);
+            }
+        }
+        this.end();
+        if (this.seenRecursion) {
+            this.reset();
+            this.print({
+                ns: 'sys',
+                time: Date.now(),
+                level: level_1.LogLevel.ERROR,
+                msg: 'Previous record contained recursive data.\n' +
+                    'Serialisation of such records is not supported in production.'
+            });
+        }
+    }
+    reset() {
+        this.visited.clear();
+        this.prefix = undefined;
+        this.style = undefined;
+        this.seenRecursion = false;
+    }
+}
+exports.Printer = Printer;
+function formatHead(rec, withColor) {
+    let time = formatTime(rec.time);
+    let level = level_1.LogLevel[rec.level].padEnd(5, ' ');
+    let ns = rec.ns;
+    if (withColor) {
+        level = `\u001b[1m\u001b[${getLevelColor(rec.level)}m${level}\u001b[0m`;
+        ns = `\u001b[1m\u001b[34m${ns}\u001b[0m`;
+    }
+    let head = time + ' ' + level;
+    if (rec.ns) {
+        head += ' ' + ns;
+    }
+    return head;
+}
+function getLevelColor(level) {
+    switch (level) {
+        case level_1.LogLevel.TRACE:
+            return 35;
+        case level_1.LogLevel.DEBUG:
+            return 32;
+        case level_1.LogLevel.INFO:
+            return 36;
+        case level_1.LogLevel.WARN:
+            return 33;
+        case level_1.LogLevel.ERROR:
+        case level_1.LogLevel.FATAL:
+            return 31;
+        default:
+            return 0;
+    }
+}
+function formatTime(time) {
+    let date = new Date(time);
+    let hour = date.getHours().toString().padStart(2, '0');
+    let minutes = date.getMinutes().toString().padStart(2, '0');
+    let seconds = date.getSeconds().toString().padStart(2, '0');
+    return `${hour}:${minutes}:${seconds}`;
+}
+class Prefix {
+    constructor(value, width, prev) {
+        this.value = value;
+        this.prev = prev;
+        this.indent = '';
+        this.offset = (this.prev?.offset || 0) + width + 1;
+    }
+    prepend(s) {
+        if (this.value) {
+            let val = this.value;
+            if (this.prev) {
+                val = this.prev.prepend(val);
+            }
+            this.value = '';
+            return s ? val + ' ' + s : val;
+        }
+        else if (s) {
+            this.indent = this.indent || ''.padEnd(this.offset, ' ');
+            return this.indent + s;
+        }
+        else {
+            return s;
+        }
+    }
+}
+const PRINTER = new Printer(line => {
+    process.stderr.write(line + '\n');
+}, !!supports_color_1.stderr);
+function prettyStderrSink(rec) {
+    try {
+        PRINTER.print(rec);
+    }
+    catch (e) {
+        PRINTER.reset();
+        PRINTER.print({
+            ns: 'sys',
+            level: level_1.LogLevel.ERROR,
+            time: Date.now(),
+            msg: e.stack || e.toString()
+        });
+    }
+    finally {
+        PRINTER.reset();
+    }
+}
+exports.prettyStderrSink = prettyStderrSink;
+//# sourceMappingURL=pretty.js.map

package/lib/sinks/pretty.js.map

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

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@subsquid/logger",
+  "version": "0.0.1",
+  "description": "Lightweight library for structured logging",
+  "license": "GPL-3.0-or-later",
+  "repository": "git@github.com:subsquid/squid.git",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "lib",
+    "src"
+  ],
+  "main": "lib/index.js",
+  "dependencies": {
+    "@subsquid/util-internal-hex": "^0.0.0",
+    "@subsquid/util-internal-json": "^0.1.0",
+    "supports-color": "^8.1.1"
+  },
+  "devDependencies": {
+    "@types/mocha": "^9.1.1",
+    "@types/node": "^16.11.22",
+    "@types/supports-color": "^8.1.1",
+    "expect": "^27.5.1",
+    "mocha": "^9.2.2",
+    "typescript": "~4.5.5"
+  },
+  "scripts": {
+    "build": "rm -rf lib && tsc",
+    "test": "mocha lib/**/*.test.js"
+  },
+  "readme": "# @subsquid/logger\n\nLightweight structured logger for squid framework.\n\n## Usage\n\n```typescript\nimport {createLogger} from \"@subsquid/logger\"\n\nconst log = createLogger('sqd:demo')\n\nlog.info('message with severity info')\nlog.debug('message with severity debug')\n\nlog.info({foo: 1, bar: 2}, 'message and some additional attributes')\n\n// info message consisting only of attributes\nlog.info({a: 1, b: 2, c: 3, array: [4, 5]}) \n\n// pass an Error object inplace of attributes\nlog.warn(new Error('Some error occured'))\n\n// Error together with some other attributes and message\nlog.error({err: new Error('Another error'), a: 1, b: 2}, 'weird')\n\n// create a child logger instance with namespace `sqd:demo:sql` \n// and `req: 1` attribute attached to every log record\nconst sqlLog = log.child('sql', {req: 1})\nsqlLog.debug('connecting to database')\nsqlLog.debug({sql: 'SELECT max(id) FROM status'})\n```\n\n## Configuration\n\nThere are 6 log levels available: `TRACE`, `DEBUG`, `INFO`, `WARN`, `ERROR`, `FATAL`.\n\nThe log level of each logger instance is solely determined by its namespace and specified\nvia set of `SQD_TRACE`, ..., `SQD_FATAL` environment variables.\nThe default log level is `INFO`. \n\nUsers override the default log level by setting in appropriate \nenvironment variable a pattern which matches the logger's namespace.\n\n* `SQD_DEBUG=*` - sets the log level to `DEBUG` for all loggers.\n* `SQD_DEBUG=foo` - loggers `foo`, `foo:bar`, `foo:a:b`, etc will have a `DEBUG` level.\n* `SQD_DEBUG=a:b*:c,d` - loggers `a:b:c`, `a:baz:c`, `a:baz:c:foo`, `d`, etc will have a `DEBUG` level, logger `a:z:c` will not.\n\nWhen logger is matched by multiple `SQD_*` variables, the match with the highest specificity wins.\nWhen specificities are equal, the most verbose matched log level will be effective.\n\nSpecificity is computed as a number of namespace characters \nwhich are not matched by wildcards and which are not part of a child namespace.\nFor example, given a pattern `foo*bar`, the specificity of `foo:bar:baz:qux`, `foobar` and `foobazbar` is `6`.\n\n## Output\n\nThe logger always writes to `stderr`. \n\nWhen `stderr` is connected to a terminal, log records will be pretty printed.\n\n![Pretty printed log records](img.png)\n\nOtherwise, log records will be written as JSON lines.\n\n```\n{\"level\":2,\"time\":1650875498437,\"ns\":\"sqd:demo\",\"msg\":\"message with severity info\"}\n{\"level\":2,\"time\":1650875498437,\"ns\":\"sqd:demo\",\"msg\":\"message and some additional attributes\",\"foo\":1,\"bar\":2}\n{\"level\":2,\"time\":1650875498437,\"ns\":\"sqd:demo\",\"a\":1,\"b\":2,\"c\":3,\"array\":[4,5]}\n{\"level\":3,\"time\":1650875498437,\"ns\":\"sqd:demo\",\"err\":{\"stack\":\"Error: Some error occured\\n    at Object.<anonymous> (/Users/eldar/dev/squid/util/logger/lib/demo.js:11:10)\\n    at Module._compile (node:internal/modules/cjs/loader:1103:14)\\n    at Object.Module._extensions..js (node:internal/modules/cjs/loader:1155:10)\\n    at Module.load (node:internal/modules/cjs/loader:981:32)\\n    at Function.Module._load (node:internal/modules/cjs/loader:822:12)\\n    at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:77:12)\\n    at node:internal/main/run_main_module:17:47\"}}\n{\"level\":4,\"time\":1650875498438,\"ns\":\"sqd:demo\",\"msg\":\"weird\",\"err\":{\"stack\":\"Error: Another error\\n    at Object.<anonymous> (/Users/eldar/dev/squid/util/logger/lib/demo.js:13:18)\\n    at Module._compile (node:internal/modules/cjs/loader:1103:14)\\n    at Object.Module._extensions..js (node:internal/modules/cjs/loader:1155:10)\\n    at Module.load (node:internal/modules/cjs/loader:981:32)\\n    at Function.Module._load (node:internal/modules/cjs/loader:822:12)\\n    at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:77:12)\\n    at node:internal/main/run_main_module:17:47\"},\"a\":1,\"b\":2}\n```\n"
+}

package/src/demo.ts

@@ -0,0 +1,23 @@
+import {createLogger} from "./index"
+
+const log = createLogger('sqd:demo')
+
+log.info('message with severity info')
+log.debug('message with severity debug')
+
+log.info({foo: 1, bar: 2}, 'message and some additional attributes')
+
+// info message consisting only of attributes
+log.info({a: 1, b: 2, c: 3, array: [4, 5, {a: 1, b: 2, c: {foo: 'foo', bar: 'bar'}}, {a: 3, b: 4}]})
+
+// pass an Error object inplace of attributes
+log.warn(new Error('Some error occured'))
+
+// Error together with some other attributes and message
+log.error({err: new Error('Another error'), a: 1, b: 2}, 'weird')
+
+// create a child logger instance with namespace `sqd:demo:sql`
+// and `req: 1` attribute attached to every log record
+const sqlLog = log.child('sql', {req: 1})
+sqlLog.debug('connecting to database')
+sqlLog.debug({sql: 'SELECT max(id) FROM status'})

package/src/index.ts

@@ -0,0 +1,17 @@
+import {Logger} from "./logger"
+import {jsonLinesStderrSink} from "./sinks/json"
+import {prettyStderrSink} from "./sinks/pretty"
+
+export {LogLevel} from "./level"
+export * from "./logger"
+
+
+const ROOT = new Logger(
+    process.stderr.isTTY ? prettyStderrSink : jsonLinesStderrSink,
+    ''
+)
+
+
+export function createLogger(ns: string, attributes?: object): Logger {
+    return ROOT.child(ns, attributes)
+}

package/src/level.test.ts

@@ -0,0 +1,80 @@
+import assert from "assert"
+import {Levels, LogLevel} from "./level"
+
+
+function suite(
+    config: [level: LogLevel, pattern: string][],
+    tests: [ns: string, level: LogLevel][]
+) {
+    let name = config.map(([level, pattern]) => LogLevel[level] + '=' + pattern).join('; ')
+    describe(name ? 'with ' + name : 'by default', function() {
+        let levels = new Levels()
+        config.forEach(([level, pattern]) => {
+            levels.configure(level, pattern)
+        })
+        tests.forEach(([ns, level]) => {
+            it(ns + '=' + LogLevel[level], () => {
+                assert.strictEqual(levels.get(ns), level)
+            })
+        })
+    })
+}
+
+
+describe("levels", function() {
+    suite([], [
+        ['foo', LogLevel.INFO]
+    ])
+
+    suite([
+        [LogLevel.DEBUG, '*']
+    ], [
+        ['foo', LogLevel.DEBUG],
+        ['bar', LogLevel.DEBUG]
+    ])
+
+    suite([
+        [LogLevel.DEBUG, 'foo']
+    ], [
+        ['foo', LogLevel.DEBUG],
+        ['foo:bar', LogLevel.DEBUG],
+        ['foobar', LogLevel.INFO]
+    ])
+
+    suite([
+        [LogLevel.DEBUG, 'foo:*']
+    ], [
+        ['foo', LogLevel.INFO],
+        ['foo:bar', LogLevel.DEBUG],
+        ['foobar', LogLevel.INFO]
+    ])
+
+    suite([
+        [LogLevel.DEBUG, 'foo*bar']
+    ], [
+        ['foobar', LogLevel.DEBUG],
+        ['foo:bar', LogLevel.DEBUG],
+        ['foo:baz:bar:qux', LogLevel.DEBUG],
+        ['foobaz', LogLevel.INFO]
+    ])
+
+    suite([
+        [LogLevel.DEBUG, '*'],
+        [LogLevel.WARN, 'foo'],
+        [LogLevel.ERROR, 'foo:*:bar']
+    ], [
+        ['bar', LogLevel.DEBUG],
+        ['foo', LogLevel.WARN],
+        ['foo:bar', LogLevel.WARN],
+        ['foo:qux:bar', LogLevel.ERROR]
+    ])
+
+    suite([
+        [LogLevel.DEBUG, 'foo, foo:*:baz'],
+        [LogLevel.WARN, 'foo:*']
+    ], [
+        ['foo', LogLevel.DEBUG],
+        ['foo:bar:baz', LogLevel.DEBUG],
+        ['foo:bar', LogLevel.WARN]
+    ])
+})

package/src/level.ts

@@ -0,0 +1,96 @@
+export enum LogLevel {
+    TRACE = 0,
+    DEBUG = 1,
+    INFO = 2,
+    WARN = 3,
+    ERROR = 4,
+    FATAL = 5
+}
+
+
+type Specificity = number
+
+
+interface NamespaceMatcher {
+    (ns: string): Specificity
+}
+
+
+function compileLevelConfig(config: string): NamespaceMatcher {
+    let variants = config.split(',').map(ns => {
+        ns = ns.trim()
+        let regex = new RegExp('^' + ns.split('*').map(escapeRegex).join('(.*)') + '(:.*)?$')
+        return function match(ns: string) {
+            let m = regex.exec(ns)
+            if (!m) return 0
+            let specificity = ns.length + 1
+            for (let i = 1; i < m.length; i++) {
+                specificity -= m[i]?.length || 0
+            }
+            return specificity
+        }
+    })
+
+    return function matchLevel(ns: string): Specificity {
+        let specificity = 0
+        for (let i = 0; i < variants.length; i++) {
+            specificity = Math.max(specificity, variants[i](ns))
+        }
+        return specificity
+    }
+}
+
+
+// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions#escaping
+function escapeRegex(s: string): string {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+}
+
+
+function noMatch(ns: string): Specificity {
+    return 0
+}
+
+
+export class Levels {
+    private cache: Record<string, LogLevel> = {}
+    private levels: NamespaceMatcher[] = [noMatch, noMatch, noMatch, noMatch, noMatch, noMatch]
+
+    get(ns: string): LogLevel {
+        let level = this.cache[ns]
+        if (level == null) {
+            return this.cache[ns] = this.determineLevel(ns)
+        } else {
+            return level
+        }
+    }
+
+    private determineLevel(ns: string): LogLevel {
+        let specificity = 0
+        let level = LogLevel.INFO
+        for (let i = 0; i < this.levels.length; i++) {
+            let s = this.levels[i](ns)
+            if (s > specificity) {
+                level = i
+                specificity = s
+            }
+        }
+        return level
+    }
+
+    configure(level: LogLevel, config: string): void {
+        this.levels[level] = compileLevelConfig(config)
+        this.cache = {}
+    }
+}
+
+
+export const LEVELS = new Levels()
+
+
+;['TRACE', 'DEBUG', 'INFO', 'WARN', 'ERROR', 'FATAL'].forEach((name, level) => {
+    let env = process.env[`SQD_${name}`]
+    if (env) {
+        LEVELS.configure(level, env)
+    }
+})

package/src/logger.ts

@@ -0,0 +1,146 @@
+import {LEVELS, LogLevel} from "./level"
+
+
+export interface LogRecord {
+    time: number
+    level: LogLevel
+    ns: string
+    msg?: string
+    err?: Error
+}
+
+
+export type Sink = (rec: LogRecord) => void
+
+
+export class Logger {
+    constructor(
+        private sink: Sink,
+        private ns: string,
+        private attributes?: object
+    ) {
+    }
+
+    get level(): LogLevel {
+        return LEVELS.get(this.ns)
+    }
+
+    child(attributes: object): Logger
+    child(ns: string, attributes?: object): Logger
+    child(nsOrAttributes: string | object, attributes?: object): Logger {
+        let ns = this.ns
+        if (typeof nsOrAttributes == 'string') {
+            ns = ns ? `${ns}:${nsOrAttributes}` : nsOrAttributes
+        } else {
+            attributes = nsOrAttributes
+        }
+        if (this.attributes) {
+            if (attributes) {
+                attributes = {...this.attributes, ...attributes}
+            } else {
+                attributes = this.attributes
+            }
+        }
+        return new Logger(this.sink, ns, attributes)
+    }
+
+    write(level: LogLevel, msg?: string): void
+    write(level: LogLevel, attributes?: object, msg?: string): void
+    write(level: LogLevel, attributes?: any, msg?: any) {
+        if (attributes == null) return
+        if (level < this.level) return
+        if (typeof attributes == 'string') {
+            msg = attributes
+            attributes = null
+        }
+        if (attributes instanceof Error) {
+            attributes = {err: attributes}
+        }
+        let rec: any = {
+            level,
+            time: Date.now(),
+            ns: this.ns,
+            msg
+        }
+        addAttributes(this.attributes, rec)
+        addAttributes(attributes, rec)
+        this.sink(rec)
+    }
+
+    trace(msg?: string): void
+    trace(attributes?: object, msg?: string): void
+    trace(attributes?: any, msg?: any): void {
+        this.write(LogLevel.TRACE, attributes, msg)
+    }
+
+    debug(msg?: string): void
+    debug(attributes?: object, msg?: string): void
+    debug(attributes?: any, msg?: any): void {
+        this.write(LogLevel.DEBUG, attributes, msg)
+    }
+
+    info(msg?: string): void
+    info(attributes?: object, msg?: string): void
+    info(attributes?: any, msg?: any): void {
+        this.write(LogLevel.INFO, attributes, msg)
+    }
+
+    warn(msg?: string): void
+    warn(attributes?: object, msg?: string): void
+    warn(attributes?: any, msg?: any): void {
+        this.write(LogLevel.WARN, attributes, msg)
+    }
+
+    error(msg?: string): void
+    error(attributes?: object, msg?: string): void
+    error(attributes?: any, msg?: any): void {
+        this.write(LogLevel.ERROR, attributes, msg)
+    }
+
+    fatal(msg?: string | null): void
+    fatal(attributes?: object | null, msg?: string): void
+    fatal(attributes?: any, msg?: any): void {
+        this.write(LogLevel.FATAL, attributes, msg)
+    }
+
+    isTrace(): boolean {
+        return this.level <= LogLevel.TRACE
+    }
+
+    isDebug(): boolean {
+        return this.level <= LogLevel.DEBUG
+    }
+
+    isInfo(): boolean {
+        return this.level <= LogLevel.INFO
+    }
+
+    isWarn(): boolean {
+        return this.level <= LogLevel.WARN
+    }
+
+    isError(): boolean {
+        return this.level <= LogLevel.ERROR
+    }
+
+    isFatal(): boolean {
+        return this.level <= LogLevel.FATAL
+    }
+}
+
+
+function addAttributes(src: any, target: any) {
+    for (let key in src) {
+        let val = src[key]
+        switch (key) {
+            case 'time':
+            case 'level':
+            case 'ns':
+            case 'msg':
+                break
+            default:
+                target[key] = val
+        }
+    }
+}
+

package/src/sinks/json.ts

@@ -0,0 +1,23 @@
+import {toJSON} from "@subsquid/util-internal-json"
+import {LogLevel} from "../level"
+import {LogRecord} from "../logger"
+
+
+export function jsonLinesStderrSink(rec: LogRecord): void {
+    process.stderr.write(stringify(rec) + '\n')
+}
+
+
+function stringify(rec: LogRecord): string {
+    try {
+        return JSON.stringify(toJSON(rec))
+    } catch(e: any) {
+        return stringify({
+            ns: 'sys',
+            time: Date.now(),
+            level: LogLevel.ERROR,
+            msg: `Failed to serialize log record from ${rec.ns}`,
+            err: {stack: e.stack || e.toString()} as Error
+        })
+    }
+}