@adviser/cement 0.2.30 → 0.2.32

package/index.d.cts

@@ -37,7 +37,23 @@ type WithoutResult<T> = T extends Result<infer U> ? U : T;
 type WithResult<T> = T extends Promise<infer U> ? Promise<Result<U>> : Result<T>;
 declare function exception2Result<FN extends () => Promise<T> | T, T>(fn: FN): WithResult<ReturnType<FN>>;
 
+type StripCommand = string | RegExp;
+
 type NullOrUndef = null | undefined;
+interface URIObject {
+    readonly style: "host" | "path";
+    readonly protocol: string;
+    readonly pathname: string;
+    readonly searchParams: Record<string, string>;
+}
+interface PathURIObject extends URIObject {
+    readonly style: "path";
+}
+interface HostURIObject extends URIObject {
+    readonly style: "host";
+    readonly hostname: string;
+    readonly port: string;
+}
 declare function isURL(value: unknown): value is URL;
 declare class MutableURL extends URL {
     private readonly _sysURL;
@@ -59,6 +75,7 @@ declare class MutableURL extends URL {
     get searchParams(): URLSearchParams;
     toString(): string;
 }
+type keysParam = (string | ((...keys: string[]) => string))[];
 declare class BuildURI {
     _url: MutableURL;
     private constructor();
@@ -68,17 +85,21 @@ declare class BuildURI {
     hostname(h: string): BuildURI;
     protocol(p: string): BuildURI;
     pathname(p: string): BuildURI;
+    appendRelative(p: CoerceURI): 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;
+    getParamResult(key: string, msgFn?: (key: string) => string): Result<string>;
+    getParamsResult(...keys: keysParam): Result<Record<string, string>>;
     toString(): string;
     toJSON(): string;
+    asObj(...strips: StripCommand[]): HostURIObject | PathURIObject;
     URI(): URI;
 }
 type CoerceURI = string | URI | MutableURL | URL | BuildURI | NullOrUndef;
-declare const protocols: Set<string>;
+declare const hasHostPartProtocols: Set<string>;
 declare class URI {
     static protocolHasHostpart(protocol: string): () => void;
     static merge(into: CoerceURI, from: CoerceURI, defaultProtocol?: string): URI;
@@ -96,10 +117,12 @@ declare class URI {
     get getParams(): Iterable<[string, string]>;
     hasParam(key: string): boolean;
     getParam(key: string): string | undefined;
+    getParamResult(key: string, msgFn?: (key: string) => string): Result<string>;
     clone(): URI;
     asURL(): URL;
     toString(): string;
     toJSON(): string;
+    asObj(...strips: StripCommand[]): HostURIObject | PathURIObject;
 }
 
 declare enum Level {
@@ -176,6 +199,7 @@ interface WithLogger extends LoggerInterface<WithLogger> {
 }
 interface AsError {
     AsError(): Error;
+    ResultError<T>(): Result<T>;
 }
 interface Logger extends LoggerInterface<Logger> {
     With(): WithLogger;
@@ -529,6 +553,4 @@ declare function bin2string(hex: ArrayBufferView, size?: number): string;
 
 declare const VERSION: string;
 
-declare function wrapRefcounted<T, M extends string>(t: T, method: M): T;
-
-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, wrapRefcounted };
+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 };

package/index.d.ts

@@ -37,7 +37,23 @@ type WithoutResult<T> = T extends Result<infer U> ? U : T;
 type WithResult<T> = T extends Promise<infer U> ? Promise<Result<U>> : Result<T>;
 declare function exception2Result<FN extends () => Promise<T> | T, T>(fn: FN): WithResult<ReturnType<FN>>;
 
+type StripCommand = string | RegExp;
+
 type NullOrUndef = null | undefined;
+interface URIObject {
+    readonly style: "host" | "path";
+    readonly protocol: string;
+    readonly pathname: string;
+    readonly searchParams: Record<string, string>;
+}
+interface PathURIObject extends URIObject {
+    readonly style: "path";
+}
+interface HostURIObject extends URIObject {
+    readonly style: "host";
+    readonly hostname: string;
+    readonly port: string;
+}
 declare function isURL(value: unknown): value is URL;
 declare class MutableURL extends URL {
     private readonly _sysURL;
@@ -59,6 +75,7 @@ declare class MutableURL extends URL {
     get searchParams(): URLSearchParams;
     toString(): string;
 }
+type keysParam = (string | ((...keys: string[]) => string))[];
 declare class BuildURI {
     _url: MutableURL;
     private constructor();
@@ -68,17 +85,21 @@ declare class BuildURI {
     hostname(h: string): BuildURI;
     protocol(p: string): BuildURI;
     pathname(p: string): BuildURI;
+    appendRelative(p: CoerceURI): 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;
+    getParamResult(key: string, msgFn?: (key: string) => string): Result<string>;
+    getParamsResult(...keys: keysParam): Result<Record<string, string>>;
     toString(): string;
     toJSON(): string;
+    asObj(...strips: StripCommand[]): HostURIObject | PathURIObject;
     URI(): URI;
 }
 type CoerceURI = string | URI | MutableURL | URL | BuildURI | NullOrUndef;
-declare const protocols: Set<string>;
+declare const hasHostPartProtocols: Set<string>;
 declare class URI {
     static protocolHasHostpart(protocol: string): () => void;
     static merge(into: CoerceURI, from: CoerceURI, defaultProtocol?: string): URI;
@@ -96,10 +117,12 @@ declare class URI {
     get getParams(): Iterable<[string, string]>;
     hasParam(key: string): boolean;
     getParam(key: string): string | undefined;
+    getParamResult(key: string, msgFn?: (key: string) => string): Result<string>;
     clone(): URI;
     asURL(): URL;
     toString(): string;
     toJSON(): string;
+    asObj(...strips: StripCommand[]): HostURIObject | PathURIObject;
 }
 
 declare enum Level {
@@ -176,6 +199,7 @@ interface WithLogger extends LoggerInterface<WithLogger> {
 }
 interface AsError {
     AsError(): Error;
+    ResultError<T>(): Result<T>;
 }
 interface Logger extends LoggerInterface<Logger> {
     With(): WithLogger;
@@ -529,6 +553,4 @@ declare function bin2string(hex: ArrayBufferView, size?: number): string;
 
 declare const VERSION: string;
 
-declare function wrapRefcounted<T, M extends string>(t: T, method: M): T;
-
-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, wrapRefcounted };
+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 };

package/index.js

@@ -281,6 +281,61 @@ function exception2Result(fn) {
   }
 }
 
+// src/utils/stripper.ts
+function stripper(strip, obj) {
+  const strips = Array.isArray(strip) ? strip : [strip];
+  const restrips = strips.map((s) => {
+    if (typeof s === "string") {
+      const escaped = s.replace(/[-\\[\]\\/\\{\\}\\(\\)\\*\\+\\?\\.\\\\^\\$\\|]/g, "\\$&");
+      return new RegExp(`^${escaped}$`);
+    }
+    return s;
+  });
+  return localStripper(void 0, restrips, obj);
+}
+function localStripper(path, restrips, obj) {
+  if (typeof obj !== "object" || obj === null) {
+    return obj;
+  }
+  const ret = __spreadValues({}, obj);
+  const matcher = (key, nextPath) => {
+    for (const re of restrips) {
+      if (re.test(key) || re.test(nextPath)) {
+        return true;
+      }
+    }
+    return false;
+  };
+  for (const key in ret) {
+    if (Object.prototype.hasOwnProperty.call(ret, key)) {
+      let nextPath;
+      if (path) {
+        nextPath = [path, key].join(".");
+      } else {
+        nextPath = key;
+      }
+      if (matcher(key, nextPath)) {
+        delete ret[key];
+        continue;
+      }
+      if (typeof ret[key] === "object") {
+        if (Array.isArray(ret[key])) {
+          ret[key] = ret[key].reduce((acc, v, i) => {
+            const toDelete = matcher(key, `${nextPath}[${i}]`);
+            if (!toDelete) {
+              acc.push(localStripper(`${nextPath}[${i}]`, restrips, v));
+            }
+            return acc;
+          }, []);
+        } else {
+          ret[key] = localStripper(nextPath, restrips, ret[key]);
+        }
+      }
+    }
+  }
+  return ret;
+}
+
 // src/uri.ts
 function falsy2undef(value) {
   return value === void 0 || value === null ? void 0 : value;
@@ -306,7 +361,7 @@ var MutableURL = class _MutableURL extends URL {
   constructor(urlStr) {
     super("defect://does.not.exist");
     const partedURL = urlStr.split(":");
-    this._hasHostpart = protocols.has(partedURL[0]);
+    this._hasHostpart = hasHostPartProtocols.has(partedURL[0]);
     let hostPartUrl = ["http", ...partedURL.slice(1)].join(":");
     if (!this._hasHostpart) {
       const pathname = hostPartUrl.replace(/http:\/\/[/]*/, "").replace(/[#?].*$/, "");
@@ -333,32 +388,32 @@ var MutableURL = class _MutableURL extends URL {
   get host() {
     if (!this._hasHostpart) {
       throw new Error(
-        `you can use hostname only if protocol is ${this.toString()} ${JSON.stringify(Array.from(protocols.keys()))}`
+        `you can use hostname only if protocol is ${this.toString()} ${JSON.stringify(Array.from(hasHostPartProtocols.keys()))}`
       );
     }
     return this._sysURL.host;
   }
   get port() {
     if (!this._hasHostpart) {
-      throw new Error(`you can use hostname only if protocol is ${JSON.stringify(Array.from(protocols.keys()))}`);
+      throw new Error(`you can use hostname only if protocol is ${JSON.stringify(Array.from(hasHostPartProtocols.keys()))}`);
     }
     return this._sysURL.port;
   }
   set port(p) {
     if (!this._hasHostpart) {
-      throw new Error(`you can use port only if protocol is ${JSON.stringify(Array.from(protocols.keys()))}`);
+      throw new Error(`you can use port only if protocol is ${JSON.stringify(Array.from(hasHostPartProtocols.keys()))}`);
     }
     this._sysURL.port = p;
   }
   get hostname() {
     if (!this._hasHostpart) {
-      throw new Error(`you can use hostname only if protocol is ${JSON.stringify(Array.from(protocols.keys()))}`);
+      throw new Error(`you can use hostname only if protocol is ${JSON.stringify(Array.from(hasHostPartProtocols.keys()))}`);
     }
     return this._sysURL.hostname;
   }
   set hostname(h) {
     if (!this._hasHostpart) {
-      throw new Error(`you can use hostname only if protocol is ${JSON.stringify(Array.from(protocols.keys()))}`);
+      throw new Error(`you can use hostname only if protocol is ${JSON.stringify(Array.from(hasHostPartProtocols.keys()))}`);
     }
     this._sysURL.hostname = h;
   }
@@ -419,6 +474,35 @@ function from(fac, strURLUri, defaultProtocol) {
       throw new Error(`Invalid argument: ${typeof strURLUri}`);
   }
 }
+function getParamResult(key, val, msgFn = (key2) => {
+  return `missing parameter: ${key2}`;
+}) {
+  if (val === void 0) {
+    return Result.Err(msgFn(key));
+  }
+  return Result.Ok(val);
+}
+function getParamsResult(keys, getParam) {
+  const keyStrs = keys.flat().filter((k) => typeof k === "string");
+  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);
+    if (val === void 0) {
+      errors.push(key);
+    } else {
+      result[key] = val;
+    }
+  }
+  if (errors.length) {
+    return Result.Err(msgFn(...errors));
+  }
+  return Result.Ok(result);
+}
 var BuildURI = class _BuildURI {
   // pathname needs this
   constructor(url) {
@@ -470,6 +554,20 @@ var BuildURI = class _BuildURI {
   //   this._url.host = h;
   //   return this;
   // }
+  appendRelative(p) {
+    const url = URI.from(p);
+    let pathname = url.pathname;
+    if (url.pathname === "/") {
+      pathname = "";
+    } else if (!pathname.startsWith("/")) {
+      pathname = `/${pathname}`;
+    }
+    this.pathname(this._url.pathname + pathname);
+    for (const [key, value] of url.getParams) {
+      this.setParam(key, value);
+    }
+    return this;
+  }
   delParam(key) {
     this._url.searchParams.delete(key);
     return this;
@@ -490,6 +588,12 @@ var BuildURI = class _BuildURI {
   getParam(key) {
     return falsy2undef(this._url.searchParams.get(key));
   }
+  getParamResult(key, msgFn) {
+    return getParamResult(key, this.getParam(key), msgFn);
+  }
+  getParamsResult(...keys) {
+    return getParamsResult(keys, this);
+  }
   toString() {
     this._url.searchParams.sort();
     return this._url.toString();
@@ -497,17 +601,20 @@ var BuildURI = class _BuildURI {
   toJSON() {
     return this.toString();
   }
+  asObj(...strips) {
+    return this.URI().asObj(...strips);
+  }
   URI() {
     return URI.from(this._url);
   }
 };
-var protocols = /* @__PURE__ */ new Set(["http", "https", "ws", "wss"]);
+var hasHostPartProtocols = /* @__PURE__ */ new Set(["http", "https", "ws", "wss"]);
 var URI = class _URI {
   static protocolHasHostpart(protocol) {
     protocol = protocol.replace(/:$/, "");
-    protocols.add(protocol);
+    hasHostPartProtocols.add(protocol);
     return () => {
-      protocols.delete(protocol);
+      hasHostPartProtocols.delete(protocol);
     };
   }
   // if no protocol is provided, default to file:
@@ -579,6 +686,9 @@ var URI = class _URI {
   getParam(key) {
     return falsy2undef(this._url.searchParams.get(key));
   }
+  getParamResult(key, msgFn) {
+    return getParamResult(key, this.getParam(key), msgFn);
+  }
   clone() {
     return new _URI(this._url);
   }
@@ -591,6 +701,22 @@ var URI = class _URI {
   toJSON() {
     return this.toString();
   }
+  asObj(...strips) {
+    const pathURI = {
+      style: "path",
+      protocol: this.protocol,
+      pathname: this.pathname,
+      searchParams: Object.fromEntries(this.getParams)
+    };
+    if (hasHostPartProtocols.has(this.protocol.replace(/:$/, ""))) {
+      return stripper(strips, __spreadProps(__spreadValues({}, pathURI), {
+        style: "host",
+        hostname: this.hostname,
+        port: this.port
+      }));
+    }
+    return stripper(strips, pathURI);
+  }
 };
 
 // src/runtime.ts
@@ -1018,8 +1144,10 @@ var LoggerImpl = class _LoggerImpl {
       }
       return fnRet;
     });
+    const asError = () => new Error(this._txtEnDe.decode(fnError()));
     return {
-      AsError: () => new Error(this._txtEnDe.decode(fnError()))
+      ResultError: () => Result.Err(asError()),
+      AsError: asError
     };
   }
 };
@@ -1468,26 +1596,6 @@ function toCryptoRuntime(cryptoOpts = {}) {
 var VERSION = Object.keys({
   __packageVersion__: "xxxx"
 })[0];
-
-// src/refcounted.ts
-function wrapRefcounted(t, method) {
-  const my = t;
-  my.__refcounted = (my.__refcounted || 0) + 1;
-  if (my.__refcounted === 1) {
-    my.__unrefcounted = my[method];
-    const mRec = my;
-    mRec[method] = function() {
-      this.__refcounted--;
-      if (this.__refcounted === 0) {
-        this.__unrefcounted();
-      }
-      if (this.__refcounted < 0) {
-        throw new Error("already closed");
-      }
-    };
-  }
-  return t;
-}
 export {
   BaseSysAbstraction,
   BrowserEnvActions,
@@ -1542,13 +1650,12 @@ export {
   bin2text,
   envFactory,
   exception2Result,
+  hasHostPartProtocols,
   isURL,
   logValue,
-  protocols,
   removeSelfRef,
   runtimeFn,
   toCryptoRuntime,
-  utils_exports as utils,
-  wrapRefcounted
+  utils_exports as utils
 };
 //# sourceMappingURL=index.js.map