@adviser/cement 0.2.34 → 0.2.36

package/index.d.cts

@@ -40,6 +40,19 @@ declare function exception2Result<FN extends () => Promise<T> | T, T>(fn: FN): W
 type StripCommand = string | RegExp;
 
 type NullOrUndef = null | undefined;
+type OneKey<K extends string, V = string> = Record<K, V>;
+interface URIInterface<R extends URIInterface<R>> {
+    readonly getParams: Iterable<[string, string]>;
+    hasParam(key: string): boolean;
+    getParam<T extends string | undefined>(key: string | OneKey<string>, def?: T): T extends string ? string : string | undefined;
+    getParamResult(key: string, msgFn?: (key: string) => string): Result<string>;
+    getParamsResult(...keys: keysParam): Result<Record<string, string>>;
+    clone(): R;
+    asURL(): URL;
+    toString(): string;
+    toJSON(): string;
+    asObj(...strips: StripCommand[]): Partial<HostURIObject | PathURIObject>;
+}
 interface URIObject {
     readonly style: "host" | "path";
     readonly protocol: string;
@@ -75,8 +88,9 @@ declare class MutableURL extends URL {
     get searchParams(): URLSearchParams;
     toString(): string;
 }
-type keysParam = (string | ((...keys: string[]) => string))[];
-declare class BuildURI {
+type msgFn = (...keys: string[]) => string;
+type keysParam = (string | msgFn | Record<string, string>)[];
+declare class BuildURI implements URIInterface<BuildURI> {
     _url: MutableURL;
     private constructor();
     static is(value: unknown): value is BuildURI;
@@ -90,18 +104,20 @@ declare class BuildURI {
     defParam(key: string, str: string): BuildURI;
     setParam(key: string, str: string): BuildURI;
     hasParam(key: string): boolean;
-    getParam(key: string): string | undefined;
+    get getParams(): Iterable<[string, string]>;
+    getParam<T extends string | undefined>(key: string | OneKey<string>, def?: T): T extends string ? string : string | undefined;
     getParamResult(key: string, msgFn?: (key: string) => string): Result<string>;
     getParamsResult(...keys: keysParam): Result<Record<string, string>>;
     toString(): string;
     toJSON(): string;
     asURL(): URL;
-    asObj(...strips: StripCommand[]): HostURIObject | PathURIObject;
+    asObj(...strips: StripCommand[]): Partial<HostURIObject | PathURIObject>;
+    clone(): BuildURI;
     URI(): URI;
 }
 type CoerceURI = string | URI | MutableURL | URL | BuildURI | NullOrUndef;
 declare const hasHostPartProtocols: Set<string>;
-declare class URI {
+declare class URI implements URIInterface<URI> {
     static protocolHasHostpart(protocol: string): () => void;
     static merge(into: CoerceURI, from: CoerceURI, defaultProtocol?: string): URI;
     static is(value: unknown): value is URI;
@@ -117,14 +133,14 @@ declare class URI {
     get pathname(): string;
     get getParams(): Iterable<[string, string]>;
     hasParam(key: string): boolean;
-    getParam(key: string): string | undefined;
+    getParam<T extends string | undefined>(key: string | OneKey<string>, def?: T): T extends string ? string : string | undefined;
     getParamResult(key: string, msgFn?: (key: string) => string): Result<string>;
     getParamsResult(...keys: keysParam): Result<Record<string, string>>;
     clone(): URI;
     asURL(): URL;
     toString(): string;
     toJSON(): string;
-    asObj(...strips: StripCommand[]): HostURIObject | PathURIObject;
+    asObj(...strips: StripCommand[]): Partial<HostURIObject | PathURIObject>;
 }
 
 declare enum Level {
@@ -142,7 +158,6 @@ declare class LogValue {
     toJSON(): Serialized | Serialized[];
 }
 type LogSerializable = Record<string, LogValue | Promise<LogValue>>;
-declare function removeSelfRef(lineEnd?: string): (key: unknown, val: unknown) => unknown;
 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;
@@ -180,7 +195,13 @@ interface LoggerInterface<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;
+    Str<T extends string | Record<string, string>>(key: T, value?: T extends string ? string : undefined): R;
+    Uint64<T extends string | Record<string, number>>(key: T, value?: T extends string ? number : undefined): R;
+    Int<T extends string | Record<string, number>>(key: T, value?: T extends string ? number : undefined): R;
+    Bool<T extends string | Record<string, unknown>>(key: T, value?: T extends string ? unknown : undefined): R;
+    Any<T extends string | Record<string, unknown>>(key: T, value?: T extends string ? unknown : undefined): R;
+    Http(res: Response | Result<Response>, req?: Request, key?: string): R;
+    Pair(x: Record<string, unknown>): R;
     Error(): R;
     Warn(): R;
     Debug(): R;
@@ -189,11 +210,7 @@ interface LoggerInterface<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;
 }
 declare function IsLogger(obj: unknown): obj is Logger;
 interface WithLogger extends LoggerInterface<WithLogger> {
@@ -268,16 +285,19 @@ declare class LoggerImpl implements Logger {
     Ref(key: string, action: {
         toString: () => string;
     } | FnSerialized): Logger;
-    Bool(key: string, value: unknown): Logger;
+    Bool(key: string | Record<string, unknown>, value: unknown): Logger;
+    Http(res: Response | Result<Response>, req?: Request, key?: string): Logger;
+    Pair(x: Record<string, unknown>): Logger;
     Result<T>(key: string, res: Result<T, Error>): Logger;
     Len(value: unknown, key?: string): Logger;
     Hash(value: unknown, key?: string): Logger;
     Url(url: CoerceURI, key?: string): Logger;
-    Str(key: string, value?: string): Logger;
-    Any(key: string, value?: string | number | boolean | LogSerializable): Logger;
+    private coerceKey;
+    Str(key: string | Record<string, string>, value?: string): Logger;
+    Any(key: string | Record<string, unknown>, value?: unknown): Logger;
     Dur(key: string, nsec: number): Logger;
-    Uint64(key: string, value: number): Logger;
-    Int(key: string, value: number): Logger;
+    Uint64(key: string | Record<string, number>, value?: number): Logger;
+    Int(key: string | Record<string, number>, value?: number): Logger;
     Flush(): Promise<void>;
     With(): WithLogger;
     _resetAttributes(fn: () => () => Uint8Array): () => Uint8Array;
@@ -555,4 +575,4 @@ 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 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, 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 URIObject, VERSION, type WithLogger, type WithoutOption, type WithoutResult, YAMLFormatter, asyncLogValue, bin2string, bin2text, exception2Result, hasHostPartProtocols, isURL, logValue, removeSelfRef, runtimeFn, toCryptoRuntime };
+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 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, 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 };

package/index.d.ts

@@ -40,6 +40,19 @@ declare function exception2Result<FN extends () => Promise<T> | T, T>(fn: FN): W
 type StripCommand = string | RegExp;
 
 type NullOrUndef = null | undefined;
+type OneKey<K extends string, V = string> = Record<K, V>;
+interface URIInterface<R extends URIInterface<R>> {
+    readonly getParams: Iterable<[string, string]>;
+    hasParam(key: string): boolean;
+    getParam<T extends string | undefined>(key: string | OneKey<string>, def?: T): T extends string ? string : string | undefined;
+    getParamResult(key: string, msgFn?: (key: string) => string): Result<string>;
+    getParamsResult(...keys: keysParam): Result<Record<string, string>>;
+    clone(): R;
+    asURL(): URL;
+    toString(): string;
+    toJSON(): string;
+    asObj(...strips: StripCommand[]): Partial<HostURIObject | PathURIObject>;
+}
 interface URIObject {
     readonly style: "host" | "path";
     readonly protocol: string;
@@ -75,8 +88,9 @@ declare class MutableURL extends URL {
     get searchParams(): URLSearchParams;
     toString(): string;
 }
-type keysParam = (string | ((...keys: string[]) => string))[];
-declare class BuildURI {
+type msgFn = (...keys: string[]) => string;
+type keysParam = (string | msgFn | Record<string, string>)[];
+declare class BuildURI implements URIInterface<BuildURI> {
     _url: MutableURL;
     private constructor();
     static is(value: unknown): value is BuildURI;
@@ -90,18 +104,20 @@ declare class BuildURI {
     defParam(key: string, str: string): BuildURI;
     setParam(key: string, str: string): BuildURI;
     hasParam(key: string): boolean;
-    getParam(key: string): string | undefined;
+    get getParams(): Iterable<[string, string]>;
+    getParam<T extends string | undefined>(key: string | OneKey<string>, def?: T): T extends string ? string : string | undefined;
     getParamResult(key: string, msgFn?: (key: string) => string): Result<string>;
     getParamsResult(...keys: keysParam): Result<Record<string, string>>;
     toString(): string;
     toJSON(): string;
     asURL(): URL;
-    asObj(...strips: StripCommand[]): HostURIObject | PathURIObject;
+    asObj(...strips: StripCommand[]): Partial<HostURIObject | PathURIObject>;
+    clone(): BuildURI;
     URI(): URI;
 }
 type CoerceURI = string | URI | MutableURL | URL | BuildURI | NullOrUndef;
 declare const hasHostPartProtocols: Set<string>;
-declare class URI {
+declare class URI implements URIInterface<URI> {
     static protocolHasHostpart(protocol: string): () => void;
     static merge(into: CoerceURI, from: CoerceURI, defaultProtocol?: string): URI;
     static is(value: unknown): value is URI;
@@ -117,14 +133,14 @@ declare class URI {
     get pathname(): string;
     get getParams(): Iterable<[string, string]>;
     hasParam(key: string): boolean;
-    getParam(key: string): string | undefined;
+    getParam<T extends string | undefined>(key: string | OneKey<string>, def?: T): T extends string ? string : string | undefined;
     getParamResult(key: string, msgFn?: (key: string) => string): Result<string>;
     getParamsResult(...keys: keysParam): Result<Record<string, string>>;
     clone(): URI;
     asURL(): URL;
     toString(): string;
     toJSON(): string;
-    asObj(...strips: StripCommand[]): HostURIObject | PathURIObject;
+    asObj(...strips: StripCommand[]): Partial<HostURIObject | PathURIObject>;
 }
 
 declare enum Level {
@@ -142,7 +158,6 @@ declare class LogValue {
     toJSON(): Serialized | Serialized[];
 }
 type LogSerializable = Record<string, LogValue | Promise<LogValue>>;
-declare function removeSelfRef(lineEnd?: string): (key: unknown, val: unknown) => unknown;
 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;
@@ -180,7 +195,13 @@ interface LoggerInterface<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;
+    Str<T extends string | Record<string, string>>(key: T, value?: T extends string ? string : undefined): R;
+    Uint64<T extends string | Record<string, number>>(key: T, value?: T extends string ? number : undefined): R;
+    Int<T extends string | Record<string, number>>(key: T, value?: T extends string ? number : undefined): R;
+    Bool<T extends string | Record<string, unknown>>(key: T, value?: T extends string ? unknown : undefined): R;
+    Any<T extends string | Record<string, unknown>>(key: T, value?: T extends string ? unknown : undefined): R;
+    Http(res: Response | Result<Response>, req?: Request, key?: string): R;
+    Pair(x: Record<string, unknown>): R;
     Error(): R;
     Warn(): R;
     Debug(): R;
@@ -189,11 +210,7 @@ interface LoggerInterface<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;
 }
 declare function IsLogger(obj: unknown): obj is Logger;
 interface WithLogger extends LoggerInterface<WithLogger> {
@@ -268,16 +285,19 @@ declare class LoggerImpl implements Logger {
     Ref(key: string, action: {
         toString: () => string;
     } | FnSerialized): Logger;
-    Bool(key: string, value: unknown): Logger;
+    Bool(key: string | Record<string, unknown>, value: unknown): Logger;
+    Http(res: Response | Result<Response>, req?: Request, key?: string): Logger;
+    Pair(x: Record<string, unknown>): Logger;
     Result<T>(key: string, res: Result<T, Error>): Logger;
     Len(value: unknown, key?: string): Logger;
     Hash(value: unknown, key?: string): Logger;
     Url(url: CoerceURI, key?: string): Logger;
-    Str(key: string, value?: string): Logger;
-    Any(key: string, value?: string | number | boolean | LogSerializable): Logger;
+    private coerceKey;
+    Str(key: string | Record<string, string>, value?: string): Logger;
+    Any(key: string | Record<string, unknown>, value?: unknown): Logger;
     Dur(key: string, nsec: number): Logger;
-    Uint64(key: string, value: number): Logger;
-    Int(key: string, value: number): Logger;
+    Uint64(key: string | Record<string, number>, value?: number): Logger;
+    Int(key: string | Record<string, number>, value?: number): Logger;
     Flush(): Promise<void>;
     With(): WithLogger;
     _resetAttributes(fn: () => () => Uint8Array): () => Uint8Array;
@@ -555,4 +575,4 @@ 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 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, 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 URIObject, VERSION, type WithLogger, type WithoutOption, type WithoutResult, YAMLFormatter, asyncLogValue, bin2string, bin2text, exception2Result, hasHostPartProtocols, isURL, logValue, removeSelfRef, runtimeFn, toCryptoRuntime };
+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 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, 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 };

package/index.js

@@ -1,3 +1,8 @@
+import {
+  ConsoleWriterStream,
+  FanoutWriteStream,
+  utils_exports
+} from "./chunk-USQXEZHL.js";
 import {
   WebSysAbstraction
 } from "./chunk-WMMUXBDX.js";
@@ -26,11 +31,6 @@ import {
   WrapperSysAbstraction,
   envFactory
 } from "./chunk-Q65HLCNL.js";
-import {
-  ConsoleWriterStream,
-  FanoutWriteStream,
-  utils_exports
-} from "./chunk-7KFVMTOS.js";
 import {
   Utf8EnDecoder,
   Utf8EnDecoderSingleton,
@@ -101,22 +101,16 @@ var LogValue = class {
     this.fn = fn;
   }
   value() {
-    return this.fn();
+    try {
+      return this.fn();
+    } catch (e) {
+      return `LogValue:${e.message}`;
+    }
   }
   toJSON() {
     return this.value();
   }
 };
-function removeSelfRef(lineEnd) {
-  const cache = /* @__PURE__ */ 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;
-  };
-}
 function asyncLogValue(val) {
   throw new Error("Not implemented");
 }
@@ -143,19 +137,31 @@ function logValue(val, state = /* @__PURE__ */ new Set([Math.random()])) {
     case "boolean":
       return new LogValue(() => val);
     case "object": {
+      if (val === null) {
+        return new LogValue(() => "null");
+      }
       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 (val instanceof Headers) {
+        return new LogValue(() => Object.fromEntries(val.entries()));
+      }
+      if (val instanceof ReadableStream) {
+        return new LogValue(() => ">Stream<");
+      }
+      if (val instanceof Promise) {
+        return new LogValue(() => ">Promise<");
       }
       if (state.has(val)) {
         return new LogValue(() => "...");
       }
       state.add(val);
+      if (typeof val.toJSON === "function") {
+        return new LogValue(() => val.toJSON());
+      }
       const res = {};
       const typedVal = val;
       for (const key in typedVal) {
@@ -163,7 +169,9 @@ function logValue(val, state = /* @__PURE__ */ new Set([Math.random()])) {
         if (element instanceof LogValue) {
           res[key] = element;
         } else {
-          res[key] = logValue(element, state);
+          if (typeof element !== "function") {
+            res[key] = logValue(element, state);
+          }
         }
       }
       return new LogValue(() => res);
@@ -297,6 +305,9 @@ function localStripper(path, restrips, obj) {
   if (typeof obj !== "object" || obj === null) {
     return obj;
   }
+  if (Array.isArray(obj)) {
+    return obj.map((i) => localStripper(path, restrips, i));
+  }
   const ret = __spreadValues({}, obj);
   const matcher = (key, nextPath) => {
     for (const re of restrips) {
@@ -337,6 +348,16 @@ function localStripper(path, restrips, obj) {
 }
 
 // src/uri.ts
+function coerceKey(key, def) {
+  if (typeof key === "object") {
+    const keys = Object.keys(key);
+    if (keys.length !== 1) {
+      throw new Error(`Invalid key: ${JSON.stringify(key)}`);
+    }
+    return { key: keys[0], def: key[keys[0]] };
+  }
+  return { key, def };
+}
 function falsy2undef(value) {
   return value === void 0 || value === null ? void 0 : value;
 }
@@ -483,19 +504,33 @@ function getParamResult(key, val, msgFn = (key2) => {
   return Result.Ok(val);
 }
 function getParamsResult(keys, getParam) {
-  const keyStrs = keys.flat().filter((k) => typeof k === "string");
+  const keyDef = keys.flat().reduce(
+    (acc, i) => {
+      if (typeof i === "string") {
+        acc.push({ key: i });
+      } else if (typeof i === "object") {
+        acc.push(...Object.keys(i).map((k) => ({ key: k, def: i[k] })));
+      }
+      return acc;
+    },
+    []
+  );
   const msgFn = keys.find((k) => typeof k === "function") || ((...keys2) => {
     const msg = keys2.join(",");
     return `missing parameters: ${msg}`;
   });
   const errors = [];
   const result = {};
-  for (const key of keyStrs) {
-    const val = getParam.getParam(key);
+  for (const kd of keyDef) {
+    const val = getParam.getParam(kd.key);
     if (val === void 0) {
-      errors.push(key);
+      if (kd.def) {
+        result[kd.key] = kd.def;
+      } else {
+        errors.push(kd.key);
+      }
     } else {
-      result[key] = val;
+      result[kd.key] = val;
     }
   }
   if (errors.length) {
@@ -587,8 +622,16 @@ var BuildURI = class _BuildURI {
   hasParam(key) {
     return this._url.searchParams.has(key);
   }
-  getParam(key) {
-    return falsy2undef(this._url.searchParams.get(key));
+  get getParams() {
+    return this._url.searchParams.entries();
+  }
+  getParam(key, def) {
+    const { key: k, def: d } = coerceKey(key, def);
+    let val = this._url.searchParams.get(k);
+    if (!falsy2undef(val) && d) {
+      val = d;
+    }
+    return falsy2undef(val);
   }
   getParamResult(key, msgFn) {
     return getParamResult(key, this.getParam(key), msgFn);
@@ -609,6 +652,9 @@ var BuildURI = class _BuildURI {
   asObj(...strips) {
     return this.URI().asObj(...strips);
   }
+  clone() {
+    return _BuildURI.from(this.toString());
+  }
   URI() {
     return URI.from(this._url);
   }
@@ -688,8 +734,13 @@ var URI = class _URI {
   hasParam(key) {
     return this._url.searchParams.has(key);
   }
-  getParam(key) {
-    return falsy2undef(this._url.searchParams.get(key));
+  getParam(key, def) {
+    const { key: k, def: d } = coerceKey(key, def);
+    let val = this._url.searchParams.get(k);
+    if (!falsy2undef(val) && d) {
+      val = d;
+    }
+    return falsy2undef(val);
   }
   getParamResult(key, msgFn) {
     return getParamResult(key, this.getParam(key), msgFn);
@@ -910,7 +961,13 @@ var JSONFormatter = class {
     this._space = space;
   }
   format(attr) {
-    return this._txtEnDe.encode(JSON.stringify(attr, removeSelfRef(), this._space) + "\n");
+    let ret;
+    try {
+      ret = JSON.stringify(attr, null, this._space);
+    } catch (e) {
+      ret = JSON.stringify({ internal: { message: e.message, stack: e.stack } });
+    }
+    return this._txtEnDe.encode(ret + "\n");
   }
 };
 var YAMLFormatter = class {
@@ -919,7 +976,7 @@ var YAMLFormatter = class {
     this._space = space;
   }
   format(attr) {
-    return this._txtEnDe.encode("---\n" + YAML.stringify(attr, removeSelfRef(), this._space) + "\n");
+    return this._txtEnDe.encode("---\n" + YAML.stringify(attr, null, this._space) + "\n");
   }
 };
 var LoggerImpl = class _LoggerImpl {
@@ -980,7 +1037,7 @@ var LoggerImpl = class _LoggerImpl {
     return this._txtEnDe;
   }
   Attributes() {
-    return JSON.parse(JSON.stringify(this._attributes, removeSelfRef()));
+    return JSON.parse(JSON.stringify(this._attributes, null));
   }
   SetExposeStack(enable) {
     this._levelHandler.setExposeStack(enable);
@@ -1064,7 +1121,37 @@ var LoggerImpl = class _LoggerImpl {
     return this;
   }
   Bool(key, value) {
-    this._attributes[key] = logValue(!!value);
+    this.coerceKey(key, !!value);
+    return this;
+  }
+  Http(res, req, key) {
+    if (Result.Is(res)) {
+      if (res.isErr()) {
+        this.Err(res.Err());
+        return this;
+      }
+      res = res.Ok();
+    }
+    let reqRes = res;
+    if (req) {
+      reqRes = { res, req };
+    }
+    this.Any(key || "Http", reqRes);
+    return this;
+  }
+  Pair(x) {
+    for (const key of Object.keys(x)) {
+      const value = x[key];
+      if (value instanceof LogValue) {
+        this._attributes[key] = value;
+        continue;
+      }
+      if (Result.Is(value)) {
+        this.Result(key, value);
+        continue;
+      }
+      this.Any(key, value);
+    }
     return this;
   }
   Result(key, res) {
@@ -1087,12 +1174,19 @@ var LoggerImpl = class _LoggerImpl {
     this.Ref(key, () => URI.from(url).toString());
     return this;
   }
+  coerceKey(key, value) {
+    if (typeof key === "string") {
+      this._attributes[key] = logValue(value);
+    } else {
+      this.Pair(key);
+    }
+  }
   Str(key, value) {
-    this._attributes[key] = logValue(value);
+    this.coerceKey(key, value);
     return this;
   }
   Any(key, value) {
-    this._attributes[key] = logValue(value);
+    this.coerceKey(key, value);
     return this;
   }
   Dur(key, nsec) {
@@ -1100,7 +1194,7 @@ var LoggerImpl = class _LoggerImpl {
     return this;
   }
   Uint64(key, value) {
-    this._attributes[key] = logValue(value);
+    this.coerceKey(key, value);
     return this;
   }
   Int(key, value) {
@@ -1197,6 +1291,14 @@ var WithLoggerBuilder = class {
     this._li.SetDebug(...modules);
     return this;
   }
+  Http(res, req, key) {
+    this._li.Http(res, req, key);
+    return this;
+  }
+  Pair(x) {
+    this._li.Pair(x);
+    return this;
+  }
   Str(key, value) {
     this._li.Str(key, value);
     return this;
@@ -1661,7 +1763,6 @@ export {
   hasHostPartProtocols,
   isURL,
   logValue,
-  removeSelfRef,
   runtimeFn,
   toCryptoRuntime,
   utils_exports as utils