@adviser/cement 0.2.27 → 0.2.29

package/index.d.cts

@@ -1,9 +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';
+import { S as SysAbstraction, T as Time } from './base-sys-abstraction-Qj7pkY1N.cjs';
+export { r as BaseSysAbstraction, o as BaseSysAbstractionParams, B as BrowserEnvActions, C as ConstTime, D as Duration, f as Env, d as EnvActions, e as EnvFactoryOpts, h 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, b as String2TimeMode, j as SysTime, c as SystemService, l as TimeFactory, a as TimeMode, i as TimeUnits, V as VoidFunc, s as WrapperSysAbstraction, W as WrapperSysAbstractionParams, g as envFactory } from './base-sys-abstraction-Qj7pkY1N.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';
+export { i as utils } from './index-Q3phXzYr.cjs';
 
 declare abstract class Result<T, E = Error> {
     static Ok<T = void>(t: T): Result<T, Error>;
@@ -65,13 +64,15 @@ declare class BuildURI {
     private constructor();
     static is(value: unknown): value is BuildURI;
     static from(strURLUri?: CoerceURI, defaultProtocol?: string): BuildURI;
-    port(p: string): this;
-    hostname(h: string): this;
-    protocol(p: string): this;
-    pathname(p: string): this;
-    delParam(key: string): this;
-    defParam(key: string, str: string): this;
-    setParam(key: string, str: string): this;
+    port(p: string): BuildURI;
+    hostname(h: string): BuildURI;
+    protocol(p: string): BuildURI;
+    pathname(p: string): BuildURI;
+    delParam(key: string): BuildURI;
+    defParam(key: string, str: string): BuildURI;
+    setParam(key: string, str: string): BuildURI;
+    hasParam(key: string): boolean;
+    getParam(key: string): string | undefined;
     toString(): string;
     toJSON(): string;
     URI(): URI;
@@ -339,6 +340,63 @@ declare class None<T> extends Option<T> {
 }
 type WithoutOption<T> = T extends Option<infer U> ? U : T;
 
+type TraceCtx = {
+    readonly spanId: string;
+    readonly time: Time;
+    readonly parent: TraceNode;
+    readonly metrics: Map<string, Metric<unknown>>;
+    readonly logger?: Logger;
+} & Record<string, unknown>;
+type CleanCtx = {
+    readonly spanId: string;
+} & Record<string, unknown>;
+type TraceCtxParam = {
+    readonly spanId: string;
+} & Partial<{
+    readonly time: Time;
+    readonly parent: TraceNode;
+    readonly logger: Logger;
+}> & Record<string, unknown>;
+declare class Metric<T> {
+    value?: T;
+    readonly path: string;
+    constructor(path: string);
+    set(value: T): void;
+    add<R extends number | ArrayLike<T>>(value: R): void;
+}
+type MetricMap = Map<string, Metric<unknown>>;
+declare class Metrics {
+    readonly tracenode: TraceNode;
+    private readonly map;
+    readonly spanRefs: MetricMap;
+    constructor(tracenode: TraceNode);
+    toJSON(): Record<string, unknown>;
+    get<T>(ipath: string): Metric<T>;
+}
+interface Invokaction {
+    readonly result: "success" | "error";
+    readonly start: number;
+    readonly end: number;
+    readonly metrics?: Metrics;
+}
+type TraceNodeMap = Map<string, TraceNode>;
+declare class TraceNode {
+    readonly childs: TraceNodeMap;
+    readonly invokations: Invokaction[];
+    readonly spanId: string;
+    readonly ctx: TraceCtx;
+    readonly metrics: Metrics;
+    static root(time: Time, logger?: Logger): TraceNode;
+    constructor(ctx: TraceCtx);
+    getRootPath(rpath?: string[]): string;
+    invokes(): {
+        ctx: CleanCtx;
+        invokations: Invokaction[];
+    };
+    ctxWith(spanId: string, logger?: Logger): TraceCtxParam;
+    span<V extends (trace: TraceNode) => Promise<T> | T, T>(inSpanId: string | TraceCtxParam, fn: V): ReturnType<V>;
+}
+
 interface ResolveSeqItem<T, C> {
     readonly future: Future<T>;
     readonly fn: (c: C) => Promise<T>;
@@ -450,6 +508,7 @@ interface CTArrayBufferView {
 type CTBufferSource = CTArrayBufferView | ArrayBuffer;
 interface CryptoRuntime {
     importKey(format: CTKeyFormat, keyData: CTJsonWebKey | CTBufferSource, algorithm: CTAlgorithmIdentifier | CTRsaHashedImportParams | CTEcKeyImportParams | CTHmacImportParams | CTAesKeyAlgorithm, extractable: boolean, keyUsages: CTKeyUsage[]): Promise<CTCryptoKey>;
+    exportKey(format: CTKeyFormat, key: CTCryptoKey): Promise<CTJsonWebKey | ArrayBuffer>;
     decrypt(algo: {
         name: string;
         iv: Uint8Array;
@@ -468,4 +527,6 @@ declare function toCryptoRuntime(cryptoOpts?: Partial<CryptoRuntime>): CryptoRun
 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 };
+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 Invokaction, 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, Metric, type MetricMap, Metrics, MockLogger, type MockLoggerReturn, MutableURL, None, Option, 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, VERSION, type WithLogger, type WithoutOption, type WithoutResult, YAMLFormatter, asyncLogValue, bin2string, bin2text, exception2Result, isURL, logValue, protocols, removeSelfRef, runtimeFn, toCryptoRuntime };

package/index.d.ts

@@ -1,9 +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';
+import { S as SysAbstraction, T as Time } from './base-sys-abstraction-BkEiLHl0.js';
+export { r as BaseSysAbstraction, o as BaseSysAbstractionParams, B as BrowserEnvActions, C as ConstTime, D as Duration, f as Env, d as EnvActions, e as EnvFactoryOpts, h 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, b as String2TimeMode, j as SysTime, c as SystemService, l as TimeFactory, a as TimeMode, i as TimeUnits, V as VoidFunc, s as WrapperSysAbstraction, W as WrapperSysAbstractionParams, g as envFactory } from './base-sys-abstraction-BkEiLHl0.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';
+export { i as utils } from './index-tIGZMHTc.js';
 
 declare abstract class Result<T, E = Error> {
     static Ok<T = void>(t: T): Result<T, Error>;
@@ -65,13 +64,15 @@ declare class BuildURI {
     private constructor();
     static is(value: unknown): value is BuildURI;
     static from(strURLUri?: CoerceURI, defaultProtocol?: string): BuildURI;
-    port(p: string): this;
-    hostname(h: string): this;
-    protocol(p: string): this;
-    pathname(p: string): this;
-    delParam(key: string): this;
-    defParam(key: string, str: string): this;
-    setParam(key: string, str: string): this;
+    port(p: string): BuildURI;
+    hostname(h: string): BuildURI;
+    protocol(p: string): BuildURI;
+    pathname(p: string): BuildURI;
+    delParam(key: string): BuildURI;
+    defParam(key: string, str: string): BuildURI;
+    setParam(key: string, str: string): BuildURI;
+    hasParam(key: string): boolean;
+    getParam(key: string): string | undefined;
     toString(): string;
     toJSON(): string;
     URI(): URI;
@@ -339,6 +340,63 @@ declare class None<T> extends Option<T> {
 }
 type WithoutOption<T> = T extends Option<infer U> ? U : T;
 
+type TraceCtx = {
+    readonly spanId: string;
+    readonly time: Time;
+    readonly parent: TraceNode;
+    readonly metrics: Map<string, Metric<unknown>>;
+    readonly logger?: Logger;
+} & Record<string, unknown>;
+type CleanCtx = {
+    readonly spanId: string;
+} & Record<string, unknown>;
+type TraceCtxParam = {
+    readonly spanId: string;
+} & Partial<{
+    readonly time: Time;
+    readonly parent: TraceNode;
+    readonly logger: Logger;
+}> & Record<string, unknown>;
+declare class Metric<T> {
+    value?: T;
+    readonly path: string;
+    constructor(path: string);
+    set(value: T): void;
+    add<R extends number | ArrayLike<T>>(value: R): void;
+}
+type MetricMap = Map<string, Metric<unknown>>;
+declare class Metrics {
+    readonly tracenode: TraceNode;
+    private readonly map;
+    readonly spanRefs: MetricMap;
+    constructor(tracenode: TraceNode);
+    toJSON(): Record<string, unknown>;
+    get<T>(ipath: string): Metric<T>;
+}
+interface Invokaction {
+    readonly result: "success" | "error";
+    readonly start: number;
+    readonly end: number;
+    readonly metrics?: Metrics;
+}
+type TraceNodeMap = Map<string, TraceNode>;
+declare class TraceNode {
+    readonly childs: TraceNodeMap;
+    readonly invokations: Invokaction[];
+    readonly spanId: string;
+    readonly ctx: TraceCtx;
+    readonly metrics: Metrics;
+    static root(time: Time, logger?: Logger): TraceNode;
+    constructor(ctx: TraceCtx);
+    getRootPath(rpath?: string[]): string;
+    invokes(): {
+        ctx: CleanCtx;
+        invokations: Invokaction[];
+    };
+    ctxWith(spanId: string, logger?: Logger): TraceCtxParam;
+    span<V extends (trace: TraceNode) => Promise<T> | T, T>(inSpanId: string | TraceCtxParam, fn: V): ReturnType<V>;
+}
+
 interface ResolveSeqItem<T, C> {
     readonly future: Future<T>;
     readonly fn: (c: C) => Promise<T>;
@@ -450,6 +508,7 @@ interface CTArrayBufferView {
 type CTBufferSource = CTArrayBufferView | ArrayBuffer;
 interface CryptoRuntime {
     importKey(format: CTKeyFormat, keyData: CTJsonWebKey | CTBufferSource, algorithm: CTAlgorithmIdentifier | CTRsaHashedImportParams | CTEcKeyImportParams | CTHmacImportParams | CTAesKeyAlgorithm, extractable: boolean, keyUsages: CTKeyUsage[]): Promise<CTCryptoKey>;
+    exportKey(format: CTKeyFormat, key: CTCryptoKey): Promise<CTJsonWebKey | ArrayBuffer>;
     decrypt(algo: {
         name: string;
         iv: Uint8Array;
@@ -468,4 +527,6 @@ declare function toCryptoRuntime(cryptoOpts?: Partial<CryptoRuntime>): CryptoRun
 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 };
+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 Invokaction, 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, Metric, type MetricMap, Metrics, MockLogger, type MockLoggerReturn, MutableURL, None, Option, 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, VERSION, type WithLogger, type WithoutOption, type WithoutResult, YAMLFormatter, asyncLogValue, bin2string, bin2text, exception2Result, isURL, logValue, protocols, removeSelfRef, runtimeFn, toCryptoRuntime };