@adviser/cement 0.2.24 → 0.2.26

package/index.d.cts

@@ -1,6 +1,8 @@
 import { S as SysAbstraction } from './base-sys-abstraction-C9WW3w57.cjs';
 export { r as BaseSysAbstraction, o as BaseSysAbstractionParams, B as BrowserEnvActions, C as ConstTime, D as Duration, e as Env, c as EnvActions, d as EnvFactoryOpts, g as EnvImpl, E as EnvMap, p as ExitHandler, q as ExitService, F as FileService, I as IDMode, n as IdService, N as NamedWritableStream, O as OnSetItem, R as RandomMode, m as RandomService, k as StepTime, a as String2TimeMode, j as SysTime, b as SystemService, h as Time, l as TimeFactory, T as TimeMode, i as TimeUnits, V as VoidFunc, s as WrapperSysAbstraction, W as WrapperSysAbstractionParams, f as envFactory } from './base-sys-abstraction-C9WW3w57.cjs';
-export { i as utils } from './index-_GuS2IT4.cjs';
+import { T as TxtEnDecoder } from './txt-en-decoder-CZYJUju2.cjs';
+export { U as Utf8EnDecoder, a as Utf8EnDecoderSingleton } from './txt-en-decoder-CZYJUju2.cjs';
+export { i as utils } from './index-Dhb2fQiw.cjs';
 import 'vitest';
 
 declare abstract class Result<T, E = Error> {
@@ -75,7 +77,7 @@ declare class BuildURI {
     URI(): URI;
 }
 type CoerceURI = string | URI | MutableURL | URL | BuildURI | NullOrUndef;
-declare const protocols: Map<string, boolean>;
+declare const protocols: Set<string>;
 declare class URI {
     static protocolHasHostpart(protocol: string): () => void;
     static merge(into: CoerceURI, from: CoerceURI, defaultProtocol?: string): URI;
@@ -114,9 +116,10 @@ declare class LogValue {
     toJSON(): Serialized | Serialized[];
 }
 type LogSerializable = Record<string, LogValue | Promise<LogValue>>;
-declare function removeSelfRef(): (key: unknown, val: unknown) => unknown;
+declare function removeSelfRef(lineEnd?: string): (key: unknown, val: unknown) => unknown;
 declare function asyncLogValue(val: () => Promise<Serialized>): Promise<LogValue>;
-declare function logValue(val: Serialized | Serialized[] | FnSerialized | LogSerializable | undefined | null): LogValue;
+type LogValueArg = LogValue | Serialized | Serialized[] | FnSerialized | undefined | null;
+declare function logValue(val: LogValueArg, state?: Set<unknown>): LogValue;
 interface Sized {
     size: number;
 }
@@ -124,7 +127,19 @@ interface Lengthed {
     length: number;
 }
 type SizeOrLength = Sized | Lengthed;
+interface LogFormatter {
+    format(attr: LogSerializable): Uint8Array;
+}
+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;
+}
 interface LoggerInterface<R> {
+    TxtEnDe(): TxtEnDecoder;
     Module(key: string): R;
     EnableLevel(level: Level, ...modules: string[]): R;
     DisableLevel(level: Level, ...modules: string[]): R;
@@ -166,25 +181,6 @@ interface Logger extends LoggerInterface<Logger> {
     Flush(): Promise<void>;
 }
 
-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;
-}
-declare class LevelHandlerImpl implements LevelHandler {
-    readonly _globalLevels: Set<Level>;
-    readonly _modules: Map<string, Set<Level>>;
-    isStackExposed: boolean;
-    enableLevel(level: Level, ...modules: string[]): void;
-    disableLevel(level: Level, ...modules: string[]): void;
-    setExposeStack(enable?: boolean): void;
-    forModules(level: Level, fnAction: (p: string) => void, ...modules: (string | string[])[]): void;
-    setDebug(...modules: (string | string[])[]): void;
-    isEnabled(ilevel: unknown, module: unknown): boolean;
-}
 declare class LogWriterStream {
     readonly _out: WritableStream<Uint8Array>;
     readonly _toFlush: (() => Promise<void>)[];
@@ -194,12 +190,27 @@ declare class LogWriterStream {
     _flushDoneFns: (() => void)[];
     _flush(toFlush?: (() => Promise<void>)[] | undefined, done?: () => void): void;
 }
+
+declare class JSONFormatter implements LogFormatter {
+    private readonly _txtEnDe;
+    private readonly _space?;
+    constructor(txtEnde: TxtEnDecoder, space?: number);
+    format(attr: LogSerializable): Uint8Array;
+}
+declare class YAMLFormatter implements LogFormatter {
+    private readonly _txtEnDe;
+    private readonly _space?;
+    constructor(txtEnde: TxtEnDecoder, space?: number);
+    format(attr: LogSerializable): Uint8Array;
+}
 interface LoggerImplParams {
     readonly out?: WritableStream<Uint8Array>;
     readonly logWriter?: LogWriterStream;
     readonly sys?: SysAbstraction;
     readonly withAttributes?: LogSerializable;
     readonly levelHandler?: LevelHandler;
+    readonly txtEnDe?: TxtEnDecoder;
+    readonly formatter?: LogFormatter;
 }
 declare class LoggerImpl implements Logger {
     readonly _sys: SysAbstraction;
@@ -207,7 +218,10 @@ declare class LoggerImpl implements Logger {
     readonly _withAttributes: LogSerializable;
     readonly _logWriter: LogWriterStream;
     readonly _levelHandler: LevelHandler;
+    readonly _txtEnDe: TxtEnDecoder;
+    readonly _formatter: LogFormatter;
     constructor(params?: LoggerImplParams);
+    TxtEnDe(): TxtEnDecoder;
     Attributes(): Record<string, unknown>;
     SetExposeStack(enable?: boolean): Logger;
     EnableLevel(level: Level, ...modules: string[]): Logger;
@@ -237,8 +251,7 @@ declare class LoggerImpl implements Logger {
     Int(key: string, value: number): Logger;
     Flush(): Promise<void>;
     With(): WithLogger;
-    _resetAttributes(fn: () => () => string): () => string;
-    _produceError(attr: LogSerializable, ...args: string[]): string;
+    _resetAttributes(fn: () => () => Uint8Array): () => Uint8Array;
     Msg(...args: string[]): AsError;
 }
 
@@ -267,11 +280,12 @@ declare class LogCollector implements WritableStream<Uint8Array> {
     private _writer?;
     private readonly _pass?;
     private readonly _bufferArr;
-    constructor(pass?: WritableStreamDefaultWriter<Uint8Array>);
+    private readonly _txtEnDe;
+    constructor(pass?: WritableStreamDefaultWriter<Uint8Array>, txtEnDe?: TxtEnDecoder);
     abort(reason?: Uint8Array): Promise<void>;
     close(): Promise<void>;
     getWriter(): WritableStreamDefaultWriter<Uint8Array>;
-    Logs(): any[];
+    Logs(notJsonLine?: boolean): any[];
 }
 
 interface MockLoggerReturn {
@@ -285,6 +299,19 @@ declare function MockLogger(params?: {
     readonly disableDebug?: boolean;
 }): MockLoggerReturn;
 
+declare class LevelHandlerImpl implements LevelHandler {
+    readonly _globalLevels: Set<Level>;
+    readonly _modules: Map<string, Set<Level>>;
+    isStackExposed: boolean;
+    enableLevel(level: Level, ...modules: string[]): void;
+    disableLevel(level: Level, ...modules: string[]): void;
+    setExposeStack(enable?: boolean): void;
+    forModules(level: Level, fnAction: (p: string) => void, ...modules: (string | string[])[]): void;
+    setDebug(...modules: (string | string[])[]): void;
+    isEnabled(ilevel: unknown, module: unknown): boolean;
+}
+declare function LevelHandlerSingleton(): LevelHandler;
+
 declare abstract class Option<T> {
     static Some<T>(t: T): Option<T>;
     static None<T>(): Option<T>;
@@ -344,6 +371,7 @@ declare class Keyed<T extends {
     constructor(factory: (key: K) => T);
     asyncGet(key: () => Promise<K>): Promise<T>;
     get(key: K | (() => K)): T;
+    unget(key: K): void;
     reset(): void;
 }
 declare class KeyedResolvOnce<T, K = string> extends Keyed<ResolveOnce<T, K>, K> {
@@ -435,4 +463,7 @@ interface CryptoRuntime {
 }
 declare function toCryptoRuntime(cryptoOpts?: Partial<CryptoRuntime>): CryptoRuntime;
 
-export { type AsError, BuildURI, type CTAesKeyAlgorithm, type CTAlgorithm, type CTAlgorithmIdentifier, type CTArrayBufferView, type CTBufferSource, type CTCryptoKey, type CTEcKeyImportParams, type CTHmacImportParams, type CTJsonWebKey, type CTKeyFormat, type CTKeyType, type CTKeyUsage, type CTNamedCurve, type CTRsaHashedImportParams, type CoerceURI, type CryptoRuntime, type FnSerialized, Future, IsLogger, Keyed, KeyedResolvOnce, KeyedResolvSeq, type Lengthed, Level, type LevelHandler, LevelHandlerImpl, LogCollector, type LogSerializable, LogValue, LogWriteStream, LogWriterStream, type Logger, LoggerImpl, type LoggerImplParams, type LoggerInterface, MockLogger, type MockLoggerReturn, MutableURL, None, Option, ResolveOnce, ResolveSeq, Result, ResultError, ResultOK, type Runtime, type Serialized, type SizeOrLength, type Sized, Some, SysAbstraction, URI, type WithLogger, type WithoutOption, type WithoutResult, asyncLogValue, exception2Result, isURL, logValue, protocols, removeSelfRef, runtimeFn, toCryptoRuntime };
+declare function bin2text(hex: ArrayBufferView, lineFn: (line: string) => void, size?: number): void;
+declare function bin2string(hex: ArrayBufferView, size?: number): string;
+
+export { type AsError, BuildURI, type CTAesKeyAlgorithm, type CTAlgorithm, type CTAlgorithmIdentifier, type CTArrayBufferView, type CTBufferSource, type CTCryptoKey, type CTEcKeyImportParams, type CTHmacImportParams, type CTJsonWebKey, type CTKeyFormat, type CTKeyType, type CTKeyUsage, type CTNamedCurve, type CTRsaHashedImportParams, type CoerceURI, type CryptoRuntime, type FnSerialized, Future, IsLogger, JSONFormatter, Keyed, KeyedResolvOnce, KeyedResolvSeq, type Lengthed, Level, type LevelHandler, LevelHandlerImpl, LevelHandlerSingleton, LogCollector, type LogFormatter, type LogSerializable, LogValue, type LogValueArg, LogWriteStream, type Logger, LoggerImpl, type LoggerImplParams, type LoggerInterface, MockLogger, type MockLoggerReturn, MutableURL, None, Option, ResolveOnce, ResolveSeq, Result, ResultError, ResultOK, type Runtime, type Serialized, type SizeOrLength, type Sized, Some, SysAbstraction, TxtEnDecoder, URI, type WithLogger, type WithoutOption, type WithoutResult, YAMLFormatter, asyncLogValue, bin2string, bin2text, exception2Result, isURL, logValue, protocols, removeSelfRef, runtimeFn, toCryptoRuntime };

package/index.d.ts

@@ -1,6 +1,8 @@
 import { S as SysAbstraction } from './base-sys-abstraction-C9WW3w57.js';
 export { r as BaseSysAbstraction, o as BaseSysAbstractionParams, B as BrowserEnvActions, C as ConstTime, D as Duration, e as Env, c as EnvActions, d as EnvFactoryOpts, g as EnvImpl, E as EnvMap, p as ExitHandler, q as ExitService, F as FileService, I as IDMode, n as IdService, N as NamedWritableStream, O as OnSetItem, R as RandomMode, m as RandomService, k as StepTime, a as String2TimeMode, j as SysTime, b as SystemService, h as Time, l as TimeFactory, T as TimeMode, i as TimeUnits, V as VoidFunc, s as WrapperSysAbstraction, W as WrapperSysAbstractionParams, f as envFactory } from './base-sys-abstraction-C9WW3w57.js';
-export { i as utils } from './index-_GuS2IT4.js';
+import { T as TxtEnDecoder } from './txt-en-decoder-CZYJUju2.js';
+export { U as Utf8EnDecoder, a as Utf8EnDecoderSingleton } from './txt-en-decoder-CZYJUju2.js';
+export { i as utils } from './index-CcsGcehs.js';
 import 'vitest';
 
 declare abstract class Result<T, E = Error> {
@@ -75,7 +77,7 @@ declare class BuildURI {
     URI(): URI;
 }
 type CoerceURI = string | URI | MutableURL | URL | BuildURI | NullOrUndef;
-declare const protocols: Map<string, boolean>;
+declare const protocols: Set<string>;
 declare class URI {
     static protocolHasHostpart(protocol: string): () => void;
     static merge(into: CoerceURI, from: CoerceURI, defaultProtocol?: string): URI;
@@ -114,9 +116,10 @@ declare class LogValue {
     toJSON(): Serialized | Serialized[];
 }
 type LogSerializable = Record<string, LogValue | Promise<LogValue>>;
-declare function removeSelfRef(): (key: unknown, val: unknown) => unknown;
+declare function removeSelfRef(lineEnd?: string): (key: unknown, val: unknown) => unknown;
 declare function asyncLogValue(val: () => Promise<Serialized>): Promise<LogValue>;
-declare function logValue(val: Serialized | Serialized[] | FnSerialized | LogSerializable | undefined | null): LogValue;
+type LogValueArg = LogValue | Serialized | Serialized[] | FnSerialized | undefined | null;
+declare function logValue(val: LogValueArg, state?: Set<unknown>): LogValue;
 interface Sized {
     size: number;
 }
@@ -124,7 +127,19 @@ interface Lengthed {
     length: number;
 }
 type SizeOrLength = Sized | Lengthed;
+interface LogFormatter {
+    format(attr: LogSerializable): Uint8Array;
+}
+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;
+}
 interface LoggerInterface<R> {
+    TxtEnDe(): TxtEnDecoder;
     Module(key: string): R;
     EnableLevel(level: Level, ...modules: string[]): R;
     DisableLevel(level: Level, ...modules: string[]): R;
@@ -166,25 +181,6 @@ interface Logger extends LoggerInterface<Logger> {
     Flush(): Promise<void>;
 }
 
-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;
-}
-declare class LevelHandlerImpl implements LevelHandler {
-    readonly _globalLevels: Set<Level>;
-    readonly _modules: Map<string, Set<Level>>;
-    isStackExposed: boolean;
-    enableLevel(level: Level, ...modules: string[]): void;
-    disableLevel(level: Level, ...modules: string[]): void;
-    setExposeStack(enable?: boolean): void;
-    forModules(level: Level, fnAction: (p: string) => void, ...modules: (string | string[])[]): void;
-    setDebug(...modules: (string | string[])[]): void;
-    isEnabled(ilevel: unknown, module: unknown): boolean;
-}
 declare class LogWriterStream {
     readonly _out: WritableStream<Uint8Array>;
     readonly _toFlush: (() => Promise<void>)[];
@@ -194,12 +190,27 @@ declare class LogWriterStream {
     _flushDoneFns: (() => void)[];
     _flush(toFlush?: (() => Promise<void>)[] | undefined, done?: () => void): void;
 }
+
+declare class JSONFormatter implements LogFormatter {
+    private readonly _txtEnDe;
+    private readonly _space?;
+    constructor(txtEnde: TxtEnDecoder, space?: number);
+    format(attr: LogSerializable): Uint8Array;
+}
+declare class YAMLFormatter implements LogFormatter {
+    private readonly _txtEnDe;
+    private readonly _space?;
+    constructor(txtEnde: TxtEnDecoder, space?: number);
+    format(attr: LogSerializable): Uint8Array;
+}
 interface LoggerImplParams {
     readonly out?: WritableStream<Uint8Array>;
     readonly logWriter?: LogWriterStream;
     readonly sys?: SysAbstraction;
     readonly withAttributes?: LogSerializable;
     readonly levelHandler?: LevelHandler;
+    readonly txtEnDe?: TxtEnDecoder;
+    readonly formatter?: LogFormatter;
 }
 declare class LoggerImpl implements Logger {
     readonly _sys: SysAbstraction;
@@ -207,7 +218,10 @@ declare class LoggerImpl implements Logger {
     readonly _withAttributes: LogSerializable;
     readonly _logWriter: LogWriterStream;
     readonly _levelHandler: LevelHandler;
+    readonly _txtEnDe: TxtEnDecoder;
+    readonly _formatter: LogFormatter;
     constructor(params?: LoggerImplParams);
+    TxtEnDe(): TxtEnDecoder;
     Attributes(): Record<string, unknown>;
     SetExposeStack(enable?: boolean): Logger;
     EnableLevel(level: Level, ...modules: string[]): Logger;
@@ -237,8 +251,7 @@ declare class LoggerImpl implements Logger {
     Int(key: string, value: number): Logger;
     Flush(): Promise<void>;
     With(): WithLogger;
-    _resetAttributes(fn: () => () => string): () => string;
-    _produceError(attr: LogSerializable, ...args: string[]): string;
+    _resetAttributes(fn: () => () => Uint8Array): () => Uint8Array;
     Msg(...args: string[]): AsError;
 }
 
@@ -267,11 +280,12 @@ declare class LogCollector implements WritableStream<Uint8Array> {
     private _writer?;
     private readonly _pass?;
     private readonly _bufferArr;
-    constructor(pass?: WritableStreamDefaultWriter<Uint8Array>);
+    private readonly _txtEnDe;
+    constructor(pass?: WritableStreamDefaultWriter<Uint8Array>, txtEnDe?: TxtEnDecoder);
     abort(reason?: Uint8Array): Promise<void>;
     close(): Promise<void>;
     getWriter(): WritableStreamDefaultWriter<Uint8Array>;
-    Logs(): any[];
+    Logs(notJsonLine?: boolean): any[];
 }
 
 interface MockLoggerReturn {
@@ -285,6 +299,19 @@ declare function MockLogger(params?: {
     readonly disableDebug?: boolean;
 }): MockLoggerReturn;
 
+declare class LevelHandlerImpl implements LevelHandler {
+    readonly _globalLevels: Set<Level>;
+    readonly _modules: Map<string, Set<Level>>;
+    isStackExposed: boolean;
+    enableLevel(level: Level, ...modules: string[]): void;
+    disableLevel(level: Level, ...modules: string[]): void;
+    setExposeStack(enable?: boolean): void;
+    forModules(level: Level, fnAction: (p: string) => void, ...modules: (string | string[])[]): void;
+    setDebug(...modules: (string | string[])[]): void;
+    isEnabled(ilevel: unknown, module: unknown): boolean;
+}
+declare function LevelHandlerSingleton(): LevelHandler;
+
 declare abstract class Option<T> {
     static Some<T>(t: T): Option<T>;
     static None<T>(): Option<T>;
@@ -344,6 +371,7 @@ declare class Keyed<T extends {
     constructor(factory: (key: K) => T);
     asyncGet(key: () => Promise<K>): Promise<T>;
     get(key: K | (() => K)): T;
+    unget(key: K): void;
     reset(): void;
 }
 declare class KeyedResolvOnce<T, K = string> extends Keyed<ResolveOnce<T, K>, K> {
@@ -435,4 +463,7 @@ interface CryptoRuntime {
 }
 declare function toCryptoRuntime(cryptoOpts?: Partial<CryptoRuntime>): CryptoRuntime;
 
-export { type AsError, BuildURI, type CTAesKeyAlgorithm, type CTAlgorithm, type CTAlgorithmIdentifier, type CTArrayBufferView, type CTBufferSource, type CTCryptoKey, type CTEcKeyImportParams, type CTHmacImportParams, type CTJsonWebKey, type CTKeyFormat, type CTKeyType, type CTKeyUsage, type CTNamedCurve, type CTRsaHashedImportParams, type CoerceURI, type CryptoRuntime, type FnSerialized, Future, IsLogger, Keyed, KeyedResolvOnce, KeyedResolvSeq, type Lengthed, Level, type LevelHandler, LevelHandlerImpl, LogCollector, type LogSerializable, LogValue, LogWriteStream, LogWriterStream, type Logger, LoggerImpl, type LoggerImplParams, type LoggerInterface, MockLogger, type MockLoggerReturn, MutableURL, None, Option, ResolveOnce, ResolveSeq, Result, ResultError, ResultOK, type Runtime, type Serialized, type SizeOrLength, type Sized, Some, SysAbstraction, URI, type WithLogger, type WithoutOption, type WithoutResult, asyncLogValue, exception2Result, isURL, logValue, protocols, removeSelfRef, runtimeFn, toCryptoRuntime };
+declare function bin2text(hex: ArrayBufferView, lineFn: (line: string) => void, size?: number): void;
+declare function bin2string(hex: ArrayBufferView, size?: number): string;
+
+export { type AsError, BuildURI, type CTAesKeyAlgorithm, type CTAlgorithm, type CTAlgorithmIdentifier, type CTArrayBufferView, type CTBufferSource, type CTCryptoKey, type CTEcKeyImportParams, type CTHmacImportParams, type CTJsonWebKey, type CTKeyFormat, type CTKeyType, type CTKeyUsage, type CTNamedCurve, type CTRsaHashedImportParams, type CoerceURI, type CryptoRuntime, type FnSerialized, Future, IsLogger, JSONFormatter, Keyed, KeyedResolvOnce, KeyedResolvSeq, type Lengthed, Level, type LevelHandler, LevelHandlerImpl, LevelHandlerSingleton, LogCollector, type LogFormatter, type LogSerializable, LogValue, type LogValueArg, LogWriteStream, type Logger, LoggerImpl, type LoggerImplParams, type LoggerInterface, MockLogger, type MockLoggerReturn, MutableURL, None, Option, ResolveOnce, ResolveSeq, Result, ResultError, ResultOK, type Runtime, type Serialized, type SizeOrLength, type Sized, Some, SysAbstraction, TxtEnDecoder, URI, type WithLogger, type WithoutOption, type WithoutResult, YAMLFormatter, asyncLogValue, bin2string, bin2text, exception2Result, isURL, logValue, protocols, removeSelfRef, runtimeFn, toCryptoRuntime };