xjs-common 10.1.2 → 11.0.0-alpha.1

package/dist/func/u-string.js

@@ -1,120 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UString = void 0;
-const time_unit_1 = require("../const/time-unit");
-const xjs_err_1 = require("../obj/xjs-err");
-const u_1 = require("./u");
-const u_type_1 = require("./u-type");
-const s_errCode = 20;
-var UString;
-(function (UString) {
-    function eq(s1, s2) {
-        return !u_type_1.UType.isString(s1) || !u_type_1.UType.isString(s2) ? s1 === s2 : s1.trim() === s2.trim();
-    }
-    UString.eq = eq;
-    function repeat(token, mlt) {
-        return (0, u_1.int2array)(mlt).map(_ => token).join("");
-    }
-    UString.repeat = repeat;
-    /**
-     * generate date time number as fixed length (depends on `unit`) string without separator charactor.
-     * For example, `2025-06-08T10:15:06.366Z` is to be `20250608101506366`.
-     * @param op.date Date object refered by this. default is `new Date()`.
-     * @param op.unit time unit. default is secound.
-     */
-    function simpleTime(op) {
-        const t = (op?.date ?? new Date()).toISOString().split(".")[0].replace(/[-T:]/g, "");
-        if (op?.unit === time_unit_1.TimeUnit.Msec)
-            return t;
-        return t.substring(0, 14 - (6 - (op?.unit ?? time_unit_1.TimeUnit.Sec)) * 2);
-    }
-    UString.simpleTime = simpleTime;
-    function generateRandomString(len) {
-        return (0, u_1.int2array)(len).map(_ => {
-            let rnd = Math.floor(62 * Math.random());
-            const remain = rnd - 52;
-            if (remain >= 0)
-                return remain.toString();
-            if (rnd > 26)
-                rnd += 6;
-            return String.fromCharCode(rnd + 65);
-        }).join("");
-    }
-    UString.generateRandomString = generateRandomString;
-    function idx2az(idx) {
-        let az = "", num = idx;
-        while (num >= 0) {
-            az = String.fromCharCode(num % 26 + 97) + az;
-            num = Math.floor(num / 26) - 1;
-        }
-        return az.toUpperCase();
-    }
-    UString.idx2az = idx2az;
-    function az2idx(az) {
-        if (!az?.match(/^[a-zA-Z]+$/))
-            throw new xjs_err_1.XjsErr(s_errCode, "the parameter isn't az(AZ) format.");
-        return az.toLowerCase().split("").map(c => c.charCodeAt(0) - 97).reverse()
-            .map((idx, i) => (idx + 1) * (26 ** i)).reduce((v1, v2) => v1 + v2) - 1;
-    }
-    UString.az2idx = az2idx;
-    function asAmount(amount, unit) {
-        const int2dec = amount.toString().split(".");
-        const etni = int2dec[0].split("").reverse().join("");
-        let fetni = "";
-        const max = Math.ceil(etni.length / 3);
-        for (let i = 0; i < max; i++) {
-            if (i === max - 1)
-                fetni += etni.substring(i * 3);
-            else
-                fetni += (etni.substring(i * 3, (i + 1) * 3) + ",");
-        }
-        const finte = unit + fetni.split("").reverse().join("");
-        if (int2dec.length === 1)
-            return finte;
-        else
-            return finte + "." + int2dec[1];
-    }
-    function asJpy(amount) {
-        return u_type_1.UType.isEmpty(amount) ? "" : asAmount(Math.floor(amount), "¥");
-    }
-    UString.asJpy = asJpy;
-    function asUsd(amount) {
-        return u_type_1.UType.isEmpty(amount) ? "" : asAmount(Number(amount.toFixed(2)), "$");
-    }
-    UString.asUsd = asUsd;
-    function asPercentage(amount) {
-        if (u_type_1.UType.isEmpty(amount))
-            return "";
-        let percent = (amount * 100).toFixed(2);
-        while (percent.endsWith("0"))
-            percent = percent.substring(0, percent.length - 1);
-        if (percent.endsWith("."))
-            percent = percent.substring(0, percent.length - 1);
-        return percent + "%";
-    }
-    UString.asPercentage = asPercentage;
-    function is_yyyy(v) {
-        return !!v?.match(/^[1-9]\d{3}$/);
-    }
-    UString.is_yyyy = is_yyyy;
-    function is_yyyyMM(v) {
-        return !!v?.match(/^[1-9]\d{3}(0[1-9]|1[0-2])$/);
-    }
-    UString.is_yyyyMM = is_yyyyMM;
-    function is_yyyyMMdd(v) {
-        return !!v?.match(/^[1-9]\d{3}(0[1-9]|1[0-2])(0[1-9]|[1-2][0-9]|[3][0-1])$/);
-    }
-    UString.is_yyyyMMdd = is_yyyyMMdd;
-    function is_yyyyMMddhh(v) {
-        return !!v?.match(/^[1-9]\d{3}(0[1-9]|1[0-2])(0[1-9]|[1-2][0-9]|[3][0-1])([01]\d|2[0-3])$/);
-    }
-    UString.is_yyyyMMddhh = is_yyyyMMddhh;
-    function is_yyyyMMddhhmm(v) {
-        return !!v?.match(/^[1-9]\d{3}(0[1-9]|1[0-2])(0[1-9]|[1-2][0-9]|[3][0-1])([01]\d|2[0-3])[0-5]\d$/);
-    }
-    UString.is_yyyyMMddhhmm = is_yyyyMMddhhmm;
-    function is_yyyyMMddhhmmss(v) {
-        return !!v?.match(/^[1-9]\d{3}(0[1-9]|1[0-2])(0[1-9]|[1-2][0-9]|[3][0-1])([01]\d|2[0-3])[0-5]\d[0-5]\d$/);
-    }
-    UString.is_yyyyMMddhhmmss = is_yyyyMMddhhmmss;
-})(UString = exports.UString || (exports.UString = {}));

package/dist/func/u-type.d.ts

@@ -1,25 +0,0 @@
-import { MaybeArray, Type } from "../const/types";
-export declare namespace UType {
-    function isDefined(v: any): boolean;
-    function isEmpty(v: any): boolean;
-    function isString(v: any): v is string;
-    function isNumber(v: any): v is number;
-    function isBigint(v: any): v is bigint;
-    function isBoolean(v: any): v is boolean;
-    function isSymbol(v: any): v is symbol;
-    function isObject(v: any): v is object;
-    function isArray(v: any, t: Type.string): v is string[];
-    function isArray(v: any, t: Type.number): v is number[];
-    function isArray(v: any, t: Type.bigint): v is bigint[];
-    function isArray(v: any, t: Type.boolean): v is boolean[];
-    function isArray(v: any, t: Type.symbol): v is symbol[];
-    function isArray(v: any, t: Type.object): v is object[];
-    function isArray(v: any): v is any[];
-    /**
-     * validate properties which attached decorators in {@link DType}.
-     * @param o object to be validated.
-     * @returns invalid property keys. returns an empty array if `o` is valid.
-     */
-    function validate(o: any): string[];
-    function takeAsArray<T>(v: MaybeArray<T>): T[];
-}

package/dist/func/u-type.js

@@ -1,58 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UType = void 0;
-const types_1 = require("../const/types");
-const d_type_1 = require("./decorator/d-type");
-var UType;
-(function (UType) {
-    function isDefined(v) {
-        return typeof v !== types_1.Type.undefined;
-    }
-    UType.isDefined = isDefined;
-    function isEmpty(v) {
-        return v === null || typeof v === types_1.Type.undefined;
-    }
-    UType.isEmpty = isEmpty;
-    function isString(v) { return typeof v === types_1.Type.string; }
-    UType.isString = isString;
-    function isNumber(v) { return typeof v === types_1.Type.number; }
-    UType.isNumber = isNumber;
-    function isBigint(v) { return typeof v === types_1.Type.bigint; }
-    UType.isBigint = isBigint;
-    function isBoolean(v) { return typeof v === types_1.Type.boolean; }
-    UType.isBoolean = isBoolean;
-    function isSymbol(v) { return typeof v === types_1.Type.symbol; }
-    UType.isSymbol = isSymbol;
-    function isObject(v) { return typeof v === types_1.Type.object; }
-    UType.isObject = isObject;
-    function isArray(v, t) {
-        return Array.isArray(v) && (!t || v.every(e => typeof e === t));
-    }
-    UType.isArray = isArray;
-    /**
-     * validate properties which attached decorators in {@link DType}.
-     * @param o object to be validated.
-     * @returns invalid property keys. returns an empty array if `o` is valid.
-     */
-    function validate(o) {
-        if (!o[d_type_1.smbl_tm])
-            return [];
-        return Object.entries(o[d_type_1.smbl_tm]).flatMap(e => validateProp(e[0], o[e[0]], e[1]));
-    }
-    UType.validate = validate;
-    function validateProp(k, prop, td) {
-        if (isEmpty(prop))
-            return td.req ? [k] : [];
-        if (td.t && typeof prop !== td.t)
-            return [k];
-        if (td.ary)
-            return Array.isArray(prop) ? prop.flatMap(e => validateProp(k, e, td.ary)) : [k];
-        if (td.rec)
-            return validate(prop).flatMap(k2 => `${k}.${k2}`);
-        return [];
-    }
-    function takeAsArray(v) {
-        return Array.isArray(v) ? v : [v];
-    }
-    UType.takeAsArray = takeAsArray;
-})(UType = exports.UType || (exports.UType = {}));

package/dist/func/u.d.ts

@@ -1,24 +0,0 @@
-import { Loggable } from "../const/types";
-export declare function getJSTDate(d?: Date): Date;
-export declare function delay(sec: number): Promise<void>;
-export declare function int2array(size: number): number[];
-export declare function array2map<K, T>(array: T[], keyGen: (e: T) => K): Map<K, T[]>;
-export declare function bitor(...bit: number[]): number;
-export interface RetryOption<T = void | Promise<void>> {
-    count?: number;
-    logger?: Loggable;
-    errorCriterion?: (e: any) => boolean;
-    intervalPredicate?: () => T;
-}
-/**
- * runs callback with customizable retry.
- * @param cb callback to be retried.
- * @param op.count number of retries. default is 1.
- * @param op.logger logger used for exceptions while retrying the process. default is `console` object.
- * @param op.errorCriterion distinguish whether retry is required form exceptions. default is none. (i.e. allways required.)
- * @param op.intervalPredicate predicate that runs between callbacks when retrying.
- */
-export declare function retry<T>(cb: () => T, op?: RetryOption<void>): T;
-export declare function retry<T>(cb: () => T, op?: RetryOption<Promise<void>>): Promise<T>;
-export declare function retry<T>(cb: () => Promise<T>, op?: RetryOption<void>): Promise<T>;
-export declare function retry<T>(cb: () => Promise<T>, op?: RetryOption<Promise<void>>): Promise<T>;

package/dist/func/u.js

@@ -1,76 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.retry = exports.bitor = exports.array2map = exports.int2array = exports.delay = exports.getJSTDate = void 0;
-const xjs_err_1 = require("../obj/xjs-err");
-const s_errCode = 10;
-function getJSTDate(d) {
-    return new Date((d ? d.getTime() : Date.now()) + 9 * 60 * 60 * 1000);
-}
-exports.getJSTDate = getJSTDate;
-function delay(sec) {
-    return new Promise(resolve => setTimeout(resolve, 1000 * sec));
-}
-exports.delay = delay;
-function int2array(size) {
-    const s = Number(size);
-    if (Number.isNaN(s))
-        throw new xjs_err_1.XjsErr(s_errCode, "size of the argument is not number.");
-    return Array.from(Array(s).keys());
-}
-exports.int2array = int2array;
-function array2map(array, keyGen) {
-    const map = new Map();
-    for (const e of array) {
-        const k = keyGen(e);
-        if (map.has(k))
-            map.get(k).push(e);
-        else
-            map.set(k, [e]);
-    }
-    return map;
-}
-exports.array2map = array2map;
-function bitor(...bit) {
-    return bit.reduce((a, b) => a | b);
-}
-exports.bitor = bitor;
-;
-function retry(cb, op) {
-    const l = op?.logger ?? console;
-    const initialCount = op?.count ?? 1;
-    const handleError = (e) => {
-        if (op?.errorCriterion && !op.errorCriterion(e))
-            return false;
-        l.warn(e);
-        return true;
-    };
-    const prcs = (c) => {
-        if (c < 0)
-            throw new xjs_err_1.XjsErr(s_errCode, "failure exceeds retryable count.");
-        let ret = null;
-        const innerPrcs = () => {
-            try {
-                ret = cb();
-            }
-            catch (e) {
-                if (handleError(e))
-                    ret = prcs(c - 1);
-                else
-                    throw e;
-            }
-            if (ret instanceof Promise) {
-                return new Promise((resolve, reject) => ret.then(resolve).catch((e) => { if (handleError(e))
-                    resolve(prcs(c - 1));
-                else
-                    reject(e); }));
-            }
-            else
-                return ret;
-        };
-        if (c < initialCount && op?.intervalPredicate)
-            ret = op?.intervalPredicate();
-        return ret instanceof Promise ? ret.then(() => innerPrcs()) : innerPrcs();
-    };
-    return prcs(initialCount);
-}
-exports.retry = retry;

package/dist/index.d.ts

@@ -1,14 +0,0 @@
-export * from "./const/types";
-export * from "./const/time-unit";
-export * from "./const/gender";
-export * from "./const/http-method";
-export * from "./const/ccy";
-export * from "./func/u";
-export * from "./func/u-obj";
-export * from "./func/u-string";
-export * from "./func/u-array";
-export * from "./func/u-http";
-export * from "./func/u-type";
-export * from "./func/decorator/transaction";
-export { DType } from "./func/decorator/d-type";
-export * from "./obj/xjs-err";

package/dist/obj/type-exp.d.ts

@@ -1,8 +0,0 @@
-import { Type } from "../const/types";
-export declare class TypeExp<T> {
-    private t;
-    private readonly _m;
-    constructor(t: Type.string | Type.number | Type.bigint | Type.null | Type.symbol | Type.undefined);
-    constructor(t: Type.object, model: any);
-    match(o: any): o is T;
-}

package/dist/obj/type-exp.js

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TypeExp = void 0;
-const types_1 = require("../const/types");
-class TypeExp {
-    t;
-    _m;
-    constructor(t, model) {
-        this.t = t;
-        this._m = model;
-    }
-    match(o) {
-        if (typeof o !== this.t)
-            return false;
-        if (this.t !== types_1.Type.object)
-            return true;
-        const isArray = Array.isArray(o);
-        if (isArray !== Array.isArray(this._m))
-            return false;
-        return true;
-    }
-}
-exports.TypeExp = TypeExp;

package/dist/obj/xjs-err.d.ts

@@ -1,5 +0,0 @@
-export declare class XjsErr extends Error {
-    code: number;
-    origin?: any;
-    constructor(code: number, msg: string, origin?: any);
-}

package/dist/obj/xjs-err.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.XjsErr = void 0;
-class XjsErr extends Error {
-    code;
-    origin;
-    constructor(code, msg, origin) {
-        super(`[XJS] ${msg}`);
-        this.code = code;
-        this.origin = origin;
-    }
-}
-exports.XjsErr = XjsErr;

package/dist/prcs/http/http-resolver-context.d.ts

@@ -1,64 +0,0 @@
-import { ClientOption, HttpResponse, IHttpClient, RequestOption } from "./i-http-client";
-import { Loggable } from "../../const/types";
-export declare const s_clientMode: {
-    nodejs: {
-        id: number;
-        cipherOrder: any;
-    };
-    chrome: {
-        id: number;
-        cipherOrder: number[];
-    };
-    firefox: {
-        id: number;
-        cipherOrder: number[];
-    };
-};
-export declare class HttpResolverContext implements IHttpClient {
-    readonly cmv: number;
-    private _l;
-    private readonly _als;
-    private readonly _mode;
-    private readonly _ciphers;
-    private readonly _proxyConfig?;
-    private readonly _chHeaders;
-    private _cookies?;
-    get clientMode(): string;
-    constructor(cmv: number, op?: ClientOption, _l?: Loggable);
-    /**
-     * request GET to the url.
-     * @param url target url.
-     * @param op.headers http headers.
-     * @param op.ignoreQuery {@link RequestOption.ignoreQuery}
-     * @param op.downloadPath {@link RequestOption.downloadPath}
-     * @param op.timeout {@link RequestOption.timeout}
-     * @returns string encoded by utf-8 as response payload.
-     */
-    get(url: string, op?: RequestOption & {
-        outerRedirectCount?: number;
-    }): Promise<HttpResponse>;
-    /**
-     * request POST to the url.
-     * @param url target url.
-     * @param payload request payload. if this is an object, it is treated as json.
-     * @param op.headers http headers.
-     * @param op.ignoreQuery {@link RequestOption.ignoreQuery}
-     * @param op.downloadPath {@link RequestOption.downloadPath}
-     * @param op.timeout {@link RequestOption.timeout}
-     * @returns string encoded by utf-8 as response payload.
-     */
-    post(url: string, payload: any, op?: RequestOption): Promise<HttpResponse>;
-    private createProxyAgent;
-    private getIn;
-    private postIn;
-    private reqHttps;
-    private processResponse;
-    private resolveDownloadPath;
-    private handleRedirect;
-    private createCiphers;
-    private setCookies;
-    private storeCookies;
-    private log;
-    private warn;
-    private error;
-}