@adviser/cement 0.2.40 → 0.2.42

package/index.d.cts

@@ -4,9 +4,35 @@ 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-Q3phXzYr.cjs';
 
+declare abstract class Option<T> {
+    static Some<T>(t: T): Option<T>;
+    static None<T>(): Option<T>;
+    static Is<T>(t: unknown): t is Option<T>;
+    static From<T>(t?: T): Option<T>;
+    IsNone(): boolean;
+    IsSome(): boolean;
+    Unwrap(): T;
+    abstract is_none(): boolean;
+    abstract is_some(): boolean;
+    abstract unwrap(): T;
+}
+declare class Some<T> extends Option<T> {
+    private _t;
+    constructor(_t: T);
+    is_none(): boolean;
+    is_some(): boolean;
+    unwrap(): T;
+}
+declare class None<T> extends Option<T> {
+    is_none(): boolean;
+    is_some(): boolean;
+    unwrap(): T;
+}
+type WithoutOption<T> = T extends Option<infer U> ? U : T;
+
 declare abstract class Result<T, E = Error> {
     static Ok<T = void>(t: T): Result<T, Error>;
-    static Err<T, E extends Error = Error>(t: E | string): Result<T, E>;
+    static Err<T, E extends Error = Error>(t: E | string | Result<unknown, E>): Result<T, E>;
     static Is<T>(t: unknown): t is Result<T>;
     isOk(): boolean;
     isErr(): boolean;
@@ -42,7 +68,8 @@ type StripCommand = string | RegExp;
 type NullOrUndef = null | undefined;
 type OneKey<K extends string, V = string> = Record<K, V>;
 type MsgFn = (...keys: string[]) => string;
-type KeysParam = (string | MsgFn | Record<string, unknown>)[];
+declare const REQUIRED = 4711;
+type KeysParam = (string | MsgFn | Record<string, typeof REQUIRED | unknown>)[];
 interface URIInterface<R extends URIInterface<R>> {
     readonly getParams: Iterable<[string, string]>;
     hasParam(key: string): boolean;
@@ -99,6 +126,7 @@ declare class BuildURI implements URIInterface<BuildURI> {
     hostname(h: string): BuildURI;
     protocol(p: string): BuildURI;
     pathname(p: string): BuildURI;
+    resolve(p: CoerceURI): BuildURI;
     appendRelative(p: CoerceURI): BuildURI;
     cleanParams(): BuildURI;
     delParam(key: string): BuildURI;
@@ -161,7 +189,11 @@ declare class LogValue {
 type LogSerializable = Record<string, LogValue | Promise<LogValue>>;
 declare function asyncLogValue(val: () => Promise<Serialized>): Promise<LogValue>;
 type LogValueArg = LogValue | Serialized | Serialized[] | FnSerialized | undefined | null;
-declare function logValue(val: LogValueArg, state?: Set<unknown>): LogValue;
+interface LogValueState {
+    readonly state?: Set<unknown>;
+    readonly ignoreAttr: Option<RegExp>;
+}
+declare function logValue(val: LogValueArg, ctx: LogValueState): LogValue;
 interface Sized {
     size: number;
 }
@@ -176,18 +208,22 @@ interface LevelHandler {
     enableLevel(level: Level, ...modules: string[]): void;
     disableLevel(level: Level, ...modules: string[]): void;
     setExposeStack(enable?: boolean): void;
+    setIgnoreAttr(re?: RegExp): void;
+    ignoreAttr: Option<RegExp>;
     isStackExposed: boolean;
     setDebug(...modules: (string | string[])[]): void;
     isEnabled(ilevel: unknown, module: unknown): boolean;
 }
 type HttpType = Response | Result<Response> | Request | Result<Request>;
 interface LoggerInterface<R> {
+    readonly levelHandler: LevelHandler;
     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;
+    SetIgnoreAttribute(re?: RegExp): R;
     SetExposeStack(enable?: boolean): R;
     SetFormatter(fmt: LogFormatter): R;
     Ref(key: string, action: {
@@ -264,7 +300,7 @@ declare class LoggerImpl implements Logger {
     readonly _attributes: LogSerializable;
     readonly _withAttributes: LogSerializable;
     readonly _logWriter: LogWriterStream;
-    readonly _levelHandler: LevelHandler;
+    readonly levelHandler: LevelHandler;
     readonly _txtEnDe: TxtEnDecoder;
     _formatter: LogFormatter;
     constructor(params?: LoggerImplParams);
@@ -275,6 +311,7 @@ declare class LoggerImpl implements Logger {
     DisableLevel(level: Level, ...modules: string[]): Logger;
     Module(key: string): Logger;
     SetDebug(...modules: (string | string[])[]): Logger;
+    SetIgnoreAttribute(re?: RegExp): Logger;
     SetFormatter(formatter: LogFormatter): Logger;
     Timestamp(): Logger;
     Warn(): Logger;
@@ -353,41 +390,18 @@ declare function MockLogger(params?: {
 declare class LevelHandlerImpl implements LevelHandler {
     readonly _globalLevels: Set<Level>;
     readonly _modules: Map<string, Set<Level>>;
+    ignoreAttr: Option<RegExp>;
     isStackExposed: boolean;
     enableLevel(level: Level, ...modules: string[]): void;
     disableLevel(level: Level, ...modules: string[]): void;
     setExposeStack(enable?: boolean): void;
+    setIgnoreAttr(re?: RegExp): 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>;
-    static Is<T>(t: unknown): t is Option<T>;
-    IsNone(): boolean;
-    IsSome(): boolean;
-    Unwrap(): T;
-    abstract is_none(): boolean;
-    abstract is_some(): boolean;
-    abstract unwrap(): T;
-}
-declare class Some<T> extends Option<T> {
-    private _t;
-    constructor(_t: T);
-    is_none(): boolean;
-    is_some(): boolean;
-    unwrap(): T;
-}
-declare class None<T> extends Option<T> {
-    is_none(): boolean;
-    is_some(): boolean;
-    unwrap(): T;
-}
-type WithoutOption<T> = T extends Option<infer U> ? U : T;
-
 type TraceCtx = {
     readonly spanId: string;
     readonly time: Time;
@@ -577,4 +591,33 @@ declare function bin2string(hex: ArrayBufferView, size?: number): string;
 
 declare const VERSION: 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 CleanCtx, type CoerceURI, type CryptoRuntime, type FnSerialized, Future, type HostURIObject, type HttpType, type Invokaction, IsLogger, JSONFormatter, Keyed, KeyedResolvOnce, KeyedResolvSeq, type KeysParam, type Lengthed, Level, type LevelHandler, LevelHandlerImpl, LevelHandlerSingleton, LogCollector, type LogFormatter, type LogSerializable, LogValue, type LogValueArg, LogWriteStream, type Logger, LoggerImpl, type LoggerImplParams, type LoggerInterface, Metric, type MetricMap, Metrics, MockLogger, type MockLoggerReturn, type MsgFn, MutableURL, None, Option, type PathURIObject, ResolveOnce, ResolveSeq, Result, ResultError, ResultOK, type Runtime, type Serialized, type SizeOrLength, type Sized, Some, SysAbstraction, Time, type TraceCtx, type TraceCtxParam, TraceNode, type TraceNodeMap, TxtEnDecoder, URI, type URIInterface, type URIObject, VERSION, type WithLogger, type WithoutOption, type WithoutResult, YAMLFormatter, asyncLogValue, bin2string, bin2text, exception2Result, hasHostPartProtocols, isURL, logValue, runtimeFn, toCryptoRuntime };
+declare class HeadersImpl extends Headers {
+    readonly _headers: Map<string, string>;
+    constructor(init: Map<string, string>);
+    [Symbol.iterator](): HeadersIterator<[string, string]>;
+    entries(): HeadersIterator<[string, string]>;
+    keys(): HeadersIterator<string>;
+    values(): HeadersIterator<string>;
+    append(key: string, value: string | string[] | undefined): HeadersImpl;
+}
+declare class HttpHeader {
+    readonly _headers: Map<string, string[]>;
+    static from(headers?: HeadersInit | NodeJS.Dict<string | string[]> | Headers): HttpHeader;
+    _asStringString(): Map<string, string>;
+    _key(key: string): string;
+    Values(key: string): string[];
+    Get(key: string): string | undefined;
+    Set(key: string, valueOr: string | string[]): HttpHeader;
+    Add(key: string, value: string | string[] | undefined): HttpHeader;
+    Del(ey: string): HttpHeader;
+    Items(): [string, string[]][];
+    SortItems(): [string, string[]][];
+    Clone(): HttpHeader;
+    AsRecordStringStringArray(): Record<string, string[]>;
+    AsRecordStringString(): Record<string, string>;
+    AsHeaderInit(): HeadersInit;
+    AsHeaders(): Headers;
+    Merge(other?: HttpHeader): HttpHeader;
+}
+
+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 CleanCtx, type CoerceURI, type CryptoRuntime, type FnSerialized, Future, HeadersImpl, type HostURIObject, HttpHeader, type HttpType, type Invokaction, IsLogger, JSONFormatter, Keyed, KeyedResolvOnce, KeyedResolvSeq, type KeysParam, type Lengthed, Level, type LevelHandler, LevelHandlerImpl, LevelHandlerSingleton, LogCollector, type LogFormatter, type LogSerializable, LogValue, type LogValueArg, type LogValueState, LogWriteStream, type Logger, LoggerImpl, type LoggerImplParams, type LoggerInterface, Metric, type MetricMap, Metrics, MockLogger, type MockLoggerReturn, type MsgFn, MutableURL, None, Option, type PathURIObject, REQUIRED, ResolveOnce, ResolveSeq, Result, ResultError, ResultOK, type Runtime, type Serialized, type SizeOrLength, type Sized, Some, SysAbstraction, Time, type TraceCtx, type TraceCtxParam, TraceNode, type TraceNodeMap, TxtEnDecoder, URI, type URIInterface, type URIObject, VERSION, type WithLogger, type WithoutOption, type WithoutResult, YAMLFormatter, asyncLogValue, bin2string, bin2text, exception2Result, hasHostPartProtocols, isURL, logValue, runtimeFn, toCryptoRuntime };

package/index.d.ts

@@ -4,9 +4,35 @@ 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-tIGZMHTc.js';
 
+declare abstract class Option<T> {
+    static Some<T>(t: T): Option<T>;
+    static None<T>(): Option<T>;
+    static Is<T>(t: unknown): t is Option<T>;
+    static From<T>(t?: T): Option<T>;
+    IsNone(): boolean;
+    IsSome(): boolean;
+    Unwrap(): T;
+    abstract is_none(): boolean;
+    abstract is_some(): boolean;
+    abstract unwrap(): T;
+}
+declare class Some<T> extends Option<T> {
+    private _t;
+    constructor(_t: T);
+    is_none(): boolean;
+    is_some(): boolean;
+    unwrap(): T;
+}
+declare class None<T> extends Option<T> {
+    is_none(): boolean;
+    is_some(): boolean;
+    unwrap(): T;
+}
+type WithoutOption<T> = T extends Option<infer U> ? U : T;
+
 declare abstract class Result<T, E = Error> {
     static Ok<T = void>(t: T): Result<T, Error>;
-    static Err<T, E extends Error = Error>(t: E | string): Result<T, E>;
+    static Err<T, E extends Error = Error>(t: E | string | Result<unknown, E>): Result<T, E>;
     static Is<T>(t: unknown): t is Result<T>;
     isOk(): boolean;
     isErr(): boolean;
@@ -42,7 +68,8 @@ type StripCommand = string | RegExp;
 type NullOrUndef = null | undefined;
 type OneKey<K extends string, V = string> = Record<K, V>;
 type MsgFn = (...keys: string[]) => string;
-type KeysParam = (string | MsgFn | Record<string, unknown>)[];
+declare const REQUIRED = 4711;
+type KeysParam = (string | MsgFn | Record<string, typeof REQUIRED | unknown>)[];
 interface URIInterface<R extends URIInterface<R>> {
     readonly getParams: Iterable<[string, string]>;
     hasParam(key: string): boolean;
@@ -99,6 +126,7 @@ declare class BuildURI implements URIInterface<BuildURI> {
     hostname(h: string): BuildURI;
     protocol(p: string): BuildURI;
     pathname(p: string): BuildURI;
+    resolve(p: CoerceURI): BuildURI;
     appendRelative(p: CoerceURI): BuildURI;
     cleanParams(): BuildURI;
     delParam(key: string): BuildURI;
@@ -161,7 +189,11 @@ declare class LogValue {
 type LogSerializable = Record<string, LogValue | Promise<LogValue>>;
 declare function asyncLogValue(val: () => Promise<Serialized>): Promise<LogValue>;
 type LogValueArg = LogValue | Serialized | Serialized[] | FnSerialized | undefined | null;
-declare function logValue(val: LogValueArg, state?: Set<unknown>): LogValue;
+interface LogValueState {
+    readonly state?: Set<unknown>;
+    readonly ignoreAttr: Option<RegExp>;
+}
+declare function logValue(val: LogValueArg, ctx: LogValueState): LogValue;
 interface Sized {
     size: number;
 }
@@ -176,18 +208,22 @@ interface LevelHandler {
     enableLevel(level: Level, ...modules: string[]): void;
     disableLevel(level: Level, ...modules: string[]): void;
     setExposeStack(enable?: boolean): void;
+    setIgnoreAttr(re?: RegExp): void;
+    ignoreAttr: Option<RegExp>;
     isStackExposed: boolean;
     setDebug(...modules: (string | string[])[]): void;
     isEnabled(ilevel: unknown, module: unknown): boolean;
 }
 type HttpType = Response | Result<Response> | Request | Result<Request>;
 interface LoggerInterface<R> {
+    readonly levelHandler: LevelHandler;
     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;
+    SetIgnoreAttribute(re?: RegExp): R;
     SetExposeStack(enable?: boolean): R;
     SetFormatter(fmt: LogFormatter): R;
     Ref(key: string, action: {
@@ -264,7 +300,7 @@ declare class LoggerImpl implements Logger {
     readonly _attributes: LogSerializable;
     readonly _withAttributes: LogSerializable;
     readonly _logWriter: LogWriterStream;
-    readonly _levelHandler: LevelHandler;
+    readonly levelHandler: LevelHandler;
     readonly _txtEnDe: TxtEnDecoder;
     _formatter: LogFormatter;
     constructor(params?: LoggerImplParams);
@@ -275,6 +311,7 @@ declare class LoggerImpl implements Logger {
     DisableLevel(level: Level, ...modules: string[]): Logger;
     Module(key: string): Logger;
     SetDebug(...modules: (string | string[])[]): Logger;
+    SetIgnoreAttribute(re?: RegExp): Logger;
     SetFormatter(formatter: LogFormatter): Logger;
     Timestamp(): Logger;
     Warn(): Logger;
@@ -353,41 +390,18 @@ declare function MockLogger(params?: {
 declare class LevelHandlerImpl implements LevelHandler {
     readonly _globalLevels: Set<Level>;
     readonly _modules: Map<string, Set<Level>>;
+    ignoreAttr: Option<RegExp>;
     isStackExposed: boolean;
     enableLevel(level: Level, ...modules: string[]): void;
     disableLevel(level: Level, ...modules: string[]): void;
     setExposeStack(enable?: boolean): void;
+    setIgnoreAttr(re?: RegExp): 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>;
-    static Is<T>(t: unknown): t is Option<T>;
-    IsNone(): boolean;
-    IsSome(): boolean;
-    Unwrap(): T;
-    abstract is_none(): boolean;
-    abstract is_some(): boolean;
-    abstract unwrap(): T;
-}
-declare class Some<T> extends Option<T> {
-    private _t;
-    constructor(_t: T);
-    is_none(): boolean;
-    is_some(): boolean;
-    unwrap(): T;
-}
-declare class None<T> extends Option<T> {
-    is_none(): boolean;
-    is_some(): boolean;
-    unwrap(): T;
-}
-type WithoutOption<T> = T extends Option<infer U> ? U : T;
-
 type TraceCtx = {
     readonly spanId: string;
     readonly time: Time;
@@ -577,4 +591,33 @@ declare function bin2string(hex: ArrayBufferView, size?: number): string;
 
 declare const VERSION: 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 CleanCtx, type CoerceURI, type CryptoRuntime, type FnSerialized, Future, type HostURIObject, type HttpType, type Invokaction, IsLogger, JSONFormatter, Keyed, KeyedResolvOnce, KeyedResolvSeq, type KeysParam, type Lengthed, Level, type LevelHandler, LevelHandlerImpl, LevelHandlerSingleton, LogCollector, type LogFormatter, type LogSerializable, LogValue, type LogValueArg, LogWriteStream, type Logger, LoggerImpl, type LoggerImplParams, type LoggerInterface, Metric, type MetricMap, Metrics, MockLogger, type MockLoggerReturn, type MsgFn, MutableURL, None, Option, type PathURIObject, ResolveOnce, ResolveSeq, Result, ResultError, ResultOK, type Runtime, type Serialized, type SizeOrLength, type Sized, Some, SysAbstraction, Time, type TraceCtx, type TraceCtxParam, TraceNode, type TraceNodeMap, TxtEnDecoder, URI, type URIInterface, type URIObject, VERSION, type WithLogger, type WithoutOption, type WithoutResult, YAMLFormatter, asyncLogValue, bin2string, bin2text, exception2Result, hasHostPartProtocols, isURL, logValue, runtimeFn, toCryptoRuntime };
+declare class HeadersImpl extends Headers {
+    readonly _headers: Map<string, string>;
+    constructor(init: Map<string, string>);
+    [Symbol.iterator](): HeadersIterator<[string, string]>;
+    entries(): HeadersIterator<[string, string]>;
+    keys(): HeadersIterator<string>;
+    values(): HeadersIterator<string>;
+    append(key: string, value: string | string[] | undefined): HeadersImpl;
+}
+declare class HttpHeader {
+    readonly _headers: Map<string, string[]>;
+    static from(headers?: HeadersInit | NodeJS.Dict<string | string[]> | Headers): HttpHeader;
+    _asStringString(): Map<string, string>;
+    _key(key: string): string;
+    Values(key: string): string[];
+    Get(key: string): string | undefined;
+    Set(key: string, valueOr: string | string[]): HttpHeader;
+    Add(key: string, value: string | string[] | undefined): HttpHeader;
+    Del(ey: string): HttpHeader;
+    Items(): [string, string[]][];
+    SortItems(): [string, string[]][];
+    Clone(): HttpHeader;
+    AsRecordStringStringArray(): Record<string, string[]>;
+    AsRecordStringString(): Record<string, string>;
+    AsHeaderInit(): HeadersInit;
+    AsHeaders(): Headers;
+    Merge(other?: HttpHeader): HttpHeader;
+}
+
+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 CleanCtx, type CoerceURI, type CryptoRuntime, type FnSerialized, Future, HeadersImpl, type HostURIObject, HttpHeader, type HttpType, type Invokaction, IsLogger, JSONFormatter, Keyed, KeyedResolvOnce, KeyedResolvSeq, type KeysParam, type Lengthed, Level, type LevelHandler, LevelHandlerImpl, LevelHandlerSingleton, LogCollector, type LogFormatter, type LogSerializable, LogValue, type LogValueArg, type LogValueState, LogWriteStream, type Logger, LoggerImpl, type LoggerImplParams, type LoggerInterface, Metric, type MetricMap, Metrics, MockLogger, type MockLoggerReturn, type MsgFn, MutableURL, None, Option, type PathURIObject, REQUIRED, ResolveOnce, ResolveSeq, Result, ResultError, ResultOK, type Runtime, type Serialized, type SizeOrLength, type Sized, Some, SysAbstraction, Time, type TraceCtx, type TraceCtxParam, TraceNode, type TraceNodeMap, TxtEnDecoder, URI, type URIInterface, type URIObject, VERSION, type WithLogger, type WithoutOption, type WithoutResult, YAMLFormatter, asyncLogValue, bin2string, bin2text, exception2Result, hasHostPartProtocols, isURL, logValue, runtimeFn, toCryptoRuntime };