@adviser/cement 0.0.0-jsr-t1

package/ts/logger.d.ts

@@ -0,0 +1,84 @@
+import { Result } from "./result.js";
+import { TxtEnDecoder } from "./txt-en-decoder.js";
+import { CoerceURI } from "./uri.js";
+export declare enum Level {
+    WARN = "warn",
+    DEBUG = "debug",
+    INFO = "info",
+    ERROR = "error"
+}
+export type Serialized = string | number | boolean;
+export type FnSerialized = () => Serialized | Serialized[];
+export declare class LogValue {
+    readonly fn: FnSerialized;
+    constructor(fn: FnSerialized);
+    value(): Serialized | Serialized[];
+    toJSON(): Serialized | Serialized[];
+}
+export type LogSerializable = Record<string, LogValue | Promise<LogValue>>;
+export declare function removeSelfRef(lineEnd?: string): (key: unknown, val: unknown) => unknown;
+export declare function asyncLogValue(val: () => Promise<Serialized>): Promise<LogValue>;
+export type LogValueArg = LogValue | Serialized | Serialized[] | FnSerialized | undefined | null;
+export declare function logValue(val: LogValueArg, state?: Set<unknown>): LogValue;
+export interface Sized {
+    size: number;
+}
+export interface Lengthed {
+    length: number;
+}
+export type SizeOrLength = Sized | Lengthed;
+export interface LogFormatter {
+    format(attr: LogSerializable): Uint8Array;
+}
+export interface LevelHandler {
+    enableLevel(level: Level, ...modules: string[]): void;
+    disableLevel(level: Level, ...modules: string[]): void;
+    setExposeStack(enable?: boolean): void;
+    isStackExposed: boolean;
+    setDebug(...modules: (string | string[])[]): void;
+    isEnabled(ilevel: unknown, module: unknown): boolean;
+}
+export interface LoggerInterface<R> {
+    TxtEnDe(): TxtEnDecoder;
+    Module(key: string): R;
+    EnableLevel(level: Level, ...modules: string[]): R;
+    DisableLevel(level: Level, ...modules: string[]): R;
+    Attributes(): Record<string, unknown>;
+    SetDebug(...modules: (string | string[])[]): R;
+    SetExposeStack(enable?: boolean): R;
+    SetFormatter(fmt: LogFormatter): R;
+    Ref(key: string, action: {
+        toString: () => string;
+    } | FnSerialized): R;
+    Result<T>(key: string, res: Result<T>): R;
+    Url(url: CoerceURI, key?: string): R;
+    Len(value: unknown, key?: string): R;
+    Hash(value: unknown, key?: string): R;
+    Str(key: string, value?: string): R;
+    Error(): R;
+    Warn(): R;
+    Debug(): R;
+    Log(): R;
+    WithLevel(level: Level): R;
+    Err(err: unknown | Result<unknown> | Error): R;
+    Info(): R;
+    Timestamp(): R;
+    Any(key: string, value: unknown): R;
+    Dur(key: string, nsec: number): R;
+    Uint64(key: string, value: number): R;
+    Int(key: string, value: number): R;
+    Bool(key: string, value: unknown): R;
+}
+export declare function IsLogger(obj: unknown): obj is Logger;
+export interface WithLogger extends LoggerInterface<WithLogger> {
+    Logger(): Logger;
+}
+export interface AsError {
+    AsError(): Error;
+}
+export interface Logger extends LoggerInterface<Logger> {
+    With(): WithLogger;
+    Msg(...args: string[]): AsError;
+    Flush(): Promise<void>;
+}
+//# sourceMappingURL=logger.d.ts.map

package/ts/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,oBAAY,KAAK;IACf,IAAI,SAAS;IACb,KAAK,UAAU;IACf,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AACnD,MAAM,MAAM,YAAY,GAAG,MAAM,UAAU,GAAG,UAAU,EAAE,CAAC;AAE3D,qBAAa,QAAQ;IACP,QAAQ,CAAC,EAAE,EAAE,YAAY;gBAAhB,EAAE,EAAE,YAAY;IACrC,KAAK,IAAI,UAAU,GAAG,UAAU,EAAE;IAGlC,MAAM,IAAI,UAAU,GAAG,UAAU,EAAE;CAGpC;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AAE3E,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO,CAUvF;AAGD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAG/E;AAED,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,EAAE,GAAG,YAAY,GAAG,SAAS,GAAG,IAAI,CAAC;AAEjG,wBAAgB,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,GAAE,GAAG,CAAC,OAAO,CAAqC,GAAG,QAAQ,CA0D5G;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AACD,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE5C,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,UAAU,CAAC;CAC3C;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACtD,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACvD,cAAc,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACvC,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,GAAG,OAAO,EAAE,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC;IAClD,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;CACtD;AAED,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,OAAO,IAAI,YAAY,CAAC;IACxB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC;IAEvB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IACnD,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IAEpD,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEtC,QAAQ,CAAC,GAAG,OAAO,EAAE,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/C,cAAc,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC;IACpC,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,CAAC,CAAC;IAEnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;KAAE,GAAG,YAAY,GAAG,CAAC,CAAC;IACvE,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAE1C,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;IAErC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;IAErC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;IAEtC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;IACpC,KAAK,IAAI,CAAC,CAAC;IACX,IAAI,IAAI,CAAC,CAAC;IACV,KAAK,IAAI,CAAC,CAAC;IACX,GAAG,IAAI,CAAC,CAAC;IACT,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC;IAE3B,GAAG,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;IAC/C,IAAI,IAAI,CAAC,CAAC;IACV,SAAS,IAAI,CAAC,CAAC;IACf,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC;IACpC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC;IAClC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC;IACtC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC;IACnC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC;CACtC;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAyBpD;AAED,MAAM,WAAW,UAAW,SAAQ,eAAe,CAAC,UAAU,CAAC;IAC7D,MAAM,IAAI,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,IAAI,KAAK,CAAC;CAClB;AAED,MAAM,WAAW,MAAO,SAAQ,eAAe,CAAC,MAAM,CAAC;IACrD,IAAI,IAAI,UAAU,CAAC;IAEnB,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAChC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/ts/logger.js

@@ -0,0 +1,114 @@
+import { bin2string } from "./bin2text.js";
+export var Level;
+(function (Level) {
+    Level["WARN"] = "warn";
+    Level["DEBUG"] = "debug";
+    Level["INFO"] = "info";
+    Level["ERROR"] = "error";
+})(Level || (Level = {}));
+export class LogValue {
+    constructor(fn) {
+        this.fn = fn;
+    }
+    value() {
+        return this.fn();
+    }
+    toJSON() {
+        return this.value();
+    }
+}
+export function removeSelfRef(lineEnd) {
+    const cache = new Set();
+    return function (key, value) {
+        if (typeof value === "object" && value !== null) {
+            if (cache.has(value))
+                return "...";
+            cache.add(value);
+        }
+        return lineEnd ? value + lineEnd : value;
+    };
+}
+export function asyncLogValue(val) {
+    throw new Error("Not implemented");
+}
+export function logValue(val, state = new Set([Math.random()])) {
+    switch (typeof val) {
+        case "function":
+            return new LogValue(val);
+        case "string": {
+            try {
+                const ret = JSON.parse(val);
+                if (typeof ret === "object" && ret !== null) {
+                    return logValue(ret, state);
+                }
+            }
+            catch (e) {
+                if (val.match(/[\n\r]/)) {
+                    const lines = val.trimEnd().split(/[\n\r]/);
+                    return new LogValue(() => lines);
+                }
+            }
+            return new LogValue(() => val.toString());
+        }
+        case "number":
+            return new LogValue(() => val);
+        case "boolean":
+            return new LogValue(() => val);
+        case "object": {
+            if (ArrayBuffer.isView(val)) {
+                return logValue(bin2string(val, 512));
+            }
+            if (Array.isArray(val)) {
+                return new LogValue(() => val.map((v) => logValue(v).value()));
+            }
+            if (val === null) {
+                return new LogValue(() => "null");
+            }
+            if (state.has(val)) {
+                return new LogValue(() => "...");
+            }
+            state.add(val);
+            const res = {};
+            const typedVal = val;
+            for (const key in typedVal) {
+                const element = typedVal[key];
+                if (element instanceof LogValue) {
+                    res[key] = element;
+                }
+                else {
+                    res[key] = logValue(element, state);
+                }
+            }
+            return new LogValue(() => res);
+        }
+        default:
+            if (!val) {
+                return new LogValue(() => "--Falsy--");
+            }
+            throw new Error(`Invalid type:${typeof val}`);
+    }
+}
+export function IsLogger(obj) {
+    return (typeof obj === "object" &&
+        [
+            "Module",
+            "EnableLevel",
+            "DisableLevel",
+            "SetDebug",
+            "Str",
+            "Error",
+            "Warn",
+            "Debug",
+            "Log",
+            "WithLevel",
+            "Err",
+            "Info",
+            "Timestamp",
+            "Any",
+            "Dur",
+            "Uint64",
+        ]
+            .map((fn) => typeof obj[fn] === "function")
+            .reduce((a, b) => a && b, true));
+}
+//# sourceMappingURL=logger.js.map

package/ts/logger.js.map

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

package/ts/logger.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logger.test.d.ts.map

package/ts/logger.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.test.d.ts","sourceRoot":"","sources":["../../src/logger.test.ts"],"names":[],"mappings":""}