xjs-common 10.1.3 → 11.0.0-alpha.2

package/dist/index.js

@@ -1,32 +1 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DType = void 0;
-__exportStar(require("./const/types"), exports);
-__exportStar(require("./const/time-unit"), exports);
-__exportStar(require("./const/gender"), exports);
-__exportStar(require("./const/http-method"), exports);
-__exportStar(require("./const/ccy"), exports);
-__exportStar(require("./func/u"), exports);
-__exportStar(require("./func/u-obj"), exports);
-__exportStar(require("./func/u-string"), exports);
-__exportStar(require("./func/u-array"), exports);
-__exportStar(require("./func/u-http"), exports);
-__exportStar(require("./func/u-type"), exports);
-__exportStar(require("./func/decorator/transaction"), exports);
-var d_type_1 = require("./func/decorator/d-type");
-Object.defineProperty(exports, "DType", { enumerable: true, get: function () { return d_type_1.DType; } });
-__exportStar(require("./obj/xjs-err"), exports);
+!function(t,e){"object"==typeof exports&&"object"==typeof module?module.exports=e():"function"==typeof define&&define.amd?define([],e):"object"==typeof exports?exports["xjs-common"]=e():t["xjs-common"]=e()}(this,()=>(()=>{"use strict";var t,e,n,r,o={d:(t,e)=>{for(var n in e)o.o(e,n)&&!o.o(t,n)&&Object.defineProperty(t,n,{enumerable:!0,get:e[n]})},o:(t,e)=>Object.prototype.hasOwnProperty.call(t,e),r:t=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(t,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(t,"__esModule",{value:!0})}},i={};o.r(i),o.d(i,{DType:()=>g,Gender:()=>n,HttpMethod:()=>r,TimeUnit:()=>e,Type:()=>t,UArray:()=>O,UHttp:()=>S,UObj:()=>M,UString:()=>w,UType:()=>j,XjsErr:()=>a,array2map:()=>p,bitor:()=>m,delay:()=>y,getJSTDate:()=>l,int2array:()=>d,resolveCcy:()=>u,retry:()=>h,s_ccy:()=>c,transaction:()=>P}),function(t){t.string="string",t.number="number",t.bigint="bigint",t.boolean="boolean",t.symbol="symbol",t.object="object",t[void 0]="undefined",t.null="null"}(t||(t={})),function(t){t[t.Year=1]="Year",t[t.Month=2]="Month",t[t.Day=3]="Day",t[t.Hour=4]="Hour",t[t.Min=5]="Min",t[t.Sec=6]="Sec",t[t.Msec=7]="Msec"}(e||(e={})),function(t){t[t.Male=0]="Male",t[t.Female=1]="Female"}(n||(n={})),function(t){t.Get="GET",t.Put="PUT",t.Post="POST",t.Delete="DELETE",t.Patch="PATCH",t.Connect="CONNECT"}(r||(r={}));const s={jpy:{crossUsd:"usd/jpy"},usd:{crossUsd:null},gbp:{crossUsd:"gbp/usd"},eur:{crossUsd:"eur/usd"},cad:{crossUsd:"cad/usd"},aud:{crossUsd:"aud/usd"}},c=(Object.entries(s).forEach(t=>{t[1].symbol=t[0],s[t[0]]=Object.freeze(t[1])}),Object.freeze(s));function u(t){const e=Object.keys(c).find(e=>t?.toLowerCase()==e);return e&&c[e]}class a extends Error{code;origin;constructor(t,e,n){super(`[XJS] ${e}`),this.code=t,this.origin=n}}const f=10;function l(t){return new Date((t?t.getTime():Date.now())+324e5)}function y(t){return new Promise(e=>setTimeout(e,1e3*t))}function d(t){const e=Number(t);if(Number.isNaN(e))throw new a(f,"size of the argument is not number.");return Array.from(Array(e).keys())}function p(t,e){const n=new Map;for(const r of t){const t=e(r);n.has(t)?n.get(t).push(r):n.set(t,[r])}return n}function m(...t){return t.reduce((t,e)=>t|e)}function h(t,e){const n=e?.logger??console,r=e?.count??1,o=t=>!(e?.errorCriterion&&!e.errorCriterion(t)||(n.warn(t),0)),i=n=>{if(n<0)throw new a(f,"failure exceeds retryable count.");let s=null;const c=()=>{try{s=t()}catch(t){if(!o(t))throw t;s=i(n-1)}return s instanceof Promise?new Promise((t,e)=>s.then(t).catch(r=>{o(r)?t(i(n-1)):e(r)})):s};return n<r&&e?.intervalPredicate&&(s=e?.intervalPredicate()),s instanceof Promise?s.then(()=>c()):c()};return i(r)}const b=Symbol.for("xjs:typeMap");var g,j,M,w,O,S;!function(e){function n(t,e,n){r(t,e,t=>{if(t.t)throw new a(30,"decorator to express type is duplicate.");t.t=n})}function r(t,e,n){const r=t[b]?Object.assign({},t[b]):{};r[e]??={t:null,req:!1,rec:!1,ary:null};const o=r[e];n(o);let i=null,s=null;if(o.t&&o.rec&&(i="type",s="recursive flag"),o.t&&o.ary&&(i="type",s="array"),o.ary&&o.rec&&(i="array",s="recursive flag"),i&&s)throw new a(30,`decorator to express ${i} and ${s} are exclusive.`);Object.defineProperty(t,b,{value:r,configurable:!0})}e.string=function(e,r){n(e,r,t.string)},e.number=function(e,r){n(e,r,t.number)},e.boolean=function(e,r){n(e,r,t.boolean)},e.required=function(t,e){r(t,e,t=>t.req=!0)},e.array=function(t={}){return(e,n)=>r(e,n,e=>e.ary=t)},e.recursive=function(t,e){r(t,e,t=>t.rec=!0)},e.keep=function(t,e){r(t,e,t=>{})}}(g||(g={})),function(e){function n(e){return null===e||typeof e===t.undefined}function r(t){return t[b]?Object.entries(t[b]).flatMap(e=>o(e[0],t[e[0]],e[1])):[]}function o(t,e,i){return n(e)?i.req?[t]:[]:i.t&&typeof e!==i.t?[t]:i.ary?Array.isArray(e)?e.flatMap(e=>o(t,e,i.ary)):[t]:i.rec?r(e).flatMap(e=>`${t}.${e}`):[]}e.isDefined=function(e){return typeof e!==t.undefined},e.isEmpty=n,e.isString=function(e){return typeof e===t.string},e.isNumber=function(e){return typeof e===t.number},e.isBigint=function(e){return typeof e===t.bigint},e.isBoolean=function(e){return typeof e===t.boolean},e.isSymbol=function(e){return typeof e===t.symbol},e.isObject=function(e){return typeof e===t.object},e.isArray=function(t,e){return Array.isArray(t)&&(!e||t.every(t=>typeof t===e))},e.validate=r,e.takeAsArray=function(t){return Array.isArray(t)?t:[t]}}(j||(j={})),function(t){t.assignProperties=function t(e,n,r,o){for(const i of r??Object.keys(n))j.isDefined(n[i])&&(o&&j.isObject(e[i])&&j.isObject(n[i])&&e[i]?.[b]?t(e[i],n[i],null,!0):e[i]=n[i]);return e},t.crop=function t(e,n,r){if(!n&&!e[b])return{};const o=n??Object.keys(e[b]);return Object.keys(e).filter(i=>(!n&&e[b]?.[i]?.rec&&e[i]&&t(e[i]),!!r===o.includes(i))).forEach(t=>delete e[t]),e}}(M||(M={})),function(t){function n(t,e){const n=t.toString().split("."),r=n[0].split("").reverse().join("");let o="";const i=Math.ceil(r.length/3);for(let t=0;t<i;t++)o+=t===i-1?r.substring(3*t):r.substring(3*t,3*(t+1))+",";const s=e+o.split("").reverse().join("");return 1===n.length?s:s+"."+n[1]}t.eq=function(t,e){return j.isString(t)&&j.isString(e)?t.trim()===e.trim():t===e},t.repeat=function(t,e){return d(e).map(e=>t).join("")},t.simpleTime=function(t){const n=(t?.date??new Date).toISOString().split(".")[0].replace(/[-T:]/g,"");return t?.unit===e.Msec?n:n.substring(0,14-2*(6-(t?.unit??e.Sec)))},t.generateRandomString=function(t){return d(t).map(t=>{let e=Math.floor(62*Math.random());const n=e-52;return n>=0?n.toString():(e>26&&(e+=6),String.fromCharCode(e+65))}).join("")},t.idx2az=function(t){let e="",n=t;for(;n>=0;)e=String.fromCharCode(n%26+97)+e,n=Math.floor(n/26)-1;return e.toUpperCase()},t.az2idx=function(t){if(!t?.match(/^[a-zA-Z]+$/))throw new a(20,"the parameter isn't az(AZ) format.");return t.toLowerCase().split("").map(t=>t.charCodeAt(0)-97).reverse().map((t,e)=>(t+1)*26**e).reduce((t,e)=>t+e)-1},t.asJpy=function(t){return j.isEmpty(t)?"":n(Math.floor(t),"¥")},t.asUsd=function(t){return j.isEmpty(t)?"":n(Number(t.toFixed(2)),"$")},t.asPercentage=function(t){if(j.isEmpty(t))return"";let e=(100*t).toFixed(2);for(;e.endsWith("0");)e=e.substring(0,e.length-1);return e.endsWith(".")&&(e=e.substring(0,e.length-1)),e+"%"},t.is_yyyy=function(t){return!!t?.match(/^[1-9]\d{3}$/)},t.is_yyyyMM=function(t){return!!t?.match(/^[1-9]\d{3}(0[1-9]|1[0-2])$/)},t.is_yyyyMMdd=function(t){return!!t?.match(/^[1-9]\d{3}(0[1-9]|1[0-2])(0[1-9]|[1-2][0-9]|[3][0-1])$/)},t.is_yyyyMMddhh=function(t){return!!t?.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])$/)},t.is_yyyyMMddhhmm=function(t){return!!t?.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$/)},t.is_yyyyMMddhhmmss=function(t){return!!t?.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$/)}}(w||(w={})),function(t){function e(t,e=!0){const n=Math.floor(t.length*Math.random()),r=t[n];return e&&t.splice(n,1),r}t.eq=function(t,e,n={}){const{sort:r,useStrictEqual:o}=Object.assign({sort:!0,useStrictEqual:!0},n);if(t&&!e||!t&&e)return!1;if(!t)return!0;if(t.length!==e.length)return!1;const i=r?[...t].sort():t,s=r?[...e].sort():e;return i.every((t,e)=>o?t===s[e]:t==s[e])},t.distinct=function(t,e){if(!t||0===t.length)return[];if(e?.k)return Array.from(p(t,t=>t[e.k]).values()).map(t=>e?.takeLast?t.pop():t.shift());const n=e?.takeLast?[...t].reverse():[...t],r=e?.predicate??((t,e)=>t==e),o=[n.shift()];return n.forEach(t=>o.some(e=>r(t,e))?{}:o.push(t)),o},t.chop=function(t,e){return[...Array(Math.ceil(t.length/e)).keys()].map(n=>{let r=(n+1)*e;return r>t.length&&(r=t.length),t.slice(n*e,r)})},t.remove=function(t,e){const n=t.indexOf(e);-1!==n&&t.splice(n,1)},t.randomPick=e,t.shuffle=function(t){const n=[...t];return d(t.length).map(t=>e(n))},t.takeOut=function(t,e){const n=[];for(let r=t.length-1;r>=0;r--)e(t[r],r)&&(n.unshift(t[r]),t.splice(r,1));return n}}(O||(O={})),function(t){function e(t){return Math.floor(t/100)}t.isHttpSuccess=function(t){return 2===e(t)},t.statusCategoryOf=e,t.concatParamsWithEncoding=function(t,e){if(!e||0===Object.keys(e).length)return t;const n=Object.entries(e).flatMap(t=>Array.isArray(t[1])?t[1].map(e=>[t[0],e]):[t]);let r=t?t+"?":"";for(var o of n)r+=o[0]+"="+encodeURIComponent(o[1])+"&";return r.substring(0,r.length-1)},t.normalizeHeaders=function(t){return t?Object.entries(t).reduce((t,e)=>(t[e[0].toLowerCase()]=e[1],t),{}):{}}}(S||(S={}));const v=100;function P(t){let e=0;const n=t?.timeoutSec??30;return(t,r,o)=>{const i=o.value;o.value=async function(...t){const r=Date.now()+1e3*n;for(;e>0;){if(r<=Date.now())throw new a(v,"An exclusive process to execute was already running by other request.");await y(1)}try{e++;const n=i.apply(this,t);return n instanceof Promise?await n:n}finally{e--}}}}return i})());

package/dist/types.d.ts

@@ -0,0 +1,285 @@
+declare module "const/types" {
+    export type IndexSignature = string | number | symbol;
+    export type NormalRecord = Record<IndexSignature, any>;
+    export type MaybeArray<T> = T | T[];
+    export type Loggable = {
+        log: (msg: any) => void;
+        warn: (msg: any) => void;
+        error: (msg: any) => void;
+    };
+    export type Unique<T = number> = {
+        id: T;
+    };
+    export type IdName<T = number> = {
+        name: string;
+    } & Unique<T>;
+    export enum Type {
+        string = "string",
+        number = "number",
+        bigint = "bigint",
+        boolean = "boolean",
+        symbol = "symbol",
+        object = "object",
+        undefined = "undefined",
+        null = "null"
+    }
+}
+declare module "const/time-unit" {
+    export enum TimeUnit {
+        Year = 1,
+        Month = 2,
+        Day = 3,
+        Hour = 4,
+        Min = 5,
+        Sec = 6,
+        Msec = 7
+    }
+}
+declare module "const/gender" {
+    export enum Gender {
+        Male = 0,
+        Female = 1
+    }
+}
+declare module "const/http-method" {
+    export enum HttpMethod {
+        Get = "GET",
+        Put = "PUT",
+        Post = "POST",
+        Delete = "DELETE",
+        Patch = "PATCH",
+        Connect = "CONNECT"
+    }
+}
+declare module "const/ccy" {
+    export interface Ccy {
+        symbol: t_ccySymbol;
+        crossUsd: string;
+    }
+    export type t_ccySymbol = keyof (typeof currencies);
+    const currencies: {
+        jpy: Ccy;
+        usd: Ccy;
+        gbp: Ccy;
+        eur: Ccy;
+        cad: Ccy;
+        aud: Ccy;
+    };
+    export const s_ccy: {
+        [k in t_ccySymbol]: Readonly<Ccy>;
+    };
+    export function resolveCcy(str: string): Ccy;
+}
+declare module "obj/xjs-err" {
+    export class XjsErr extends Error {
+        code: number;
+        origin?: any;
+        constructor(code: number, msg: string, origin?: any);
+    }
+}
+declare module "func/u" {
+    import { Loggable } from "const/types";
+    export function getJSTDate(d?: Date): Date;
+    export function delay(sec: number): Promise<void>;
+    export function int2array(size: number): number[];
+    export function array2map<K, T>(array: T[], keyGen: (e: T) => K): Map<K, T[]>;
+    export 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 function retry<T>(cb: () => T, op?: RetryOption<void>): T;
+    export function retry<T>(cb: () => T, op?: RetryOption<Promise<void>>): Promise<T>;
+    export function retry<T>(cb: () => Promise<T>, op?: RetryOption<void>): Promise<T>;
+    export function retry<T>(cb: () => Promise<T>, op?: RetryOption<Promise<void>>): Promise<T>;
+}
+declare module "func/u-type" {
+    import { MaybeArray, Type } from "const/types";
+    export 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[];
+    }
+}
+declare module "func/decorator/d-type" {
+    import { Type } from "const/types";
+    export const smbl_tm: unique symbol;
+    export interface TypeDesc {
+        t?: Type;
+        req?: boolean;
+        ary?: TypeDesc;
+        rec?: boolean;
+    }
+    export interface TypeMap {
+        [k: string]: TypeDesc;
+    }
+    /**
+     * decorators to be validated by {@link UType.validate},
+     * and to be cropped by {@link UObj.crop}.
+     */
+    export namespace DType {
+        function string(target: Object, propKey: string): void;
+        function number(target: Object, propKey: string): void;
+        function boolean(target: Object, propKey: string): void;
+        function required(target: Object, propKey: string): void;
+        function array(elmDesc?: TypeDesc): (target: Object, propKey: string) => void;
+        function recursive(target: Object, propKey: string): void;
+        function keep(target: Object, propKey: string): void;
+    }
+}
+declare module "func/u-obj" {
+    import { NormalRecord } from "const/types";
+    export namespace UObj {
+        /**
+         * assign properties to the object with specified property keys.
+         * @param t target object.
+         * @param s source object.
+         * @param keys property keys which are copied from source object. if omit this, all keys in source object is applied.
+         * @param keepDtypeClass if true, class which has properties decorated with {@link DType} in target object is kept and that is assigned properties recursively.
+         */
+        function assignProperties<T extends NormalRecord, S extends NormalRecord>(t: T, s: S, keys?: (keyof S)[], keepDtypeClass?: boolean): T & Partial<S>;
+        /**
+         * crop properties of the object. the properties is removed with `delete` operator.
+         * @param o object which properties is removed.
+         * @param keys property names to be remained. if omit this, it removes the properties other than properties decorated {@link DType}.
+         * @param exclusive if true, it removes `keys` instead of remaining it.
+         */
+        function crop<T extends NormalRecord>(o: T, keys?: (keyof T)[], exclusive?: boolean): Partial<T>;
+    }
+}
+declare module "func/u-string" {
+    import { TimeUnit } from "const/time-unit";
+    export namespace UString {
+        function eq(s1: string, s2: string): boolean;
+        function repeat(token: string, mlt: number): string;
+        /**
+         * 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?: {
+            date?: Date;
+            unit?: TimeUnit;
+        }): string;
+        function generateRandomString(len: number): string;
+        function idx2az(idx: number): string;
+        function az2idx(az: string): number;
+        function asJpy(amount: number): string;
+        function asUsd(amount: number): string;
+        function asPercentage(amount: number): string;
+        function is_yyyy(v: string): boolean;
+        function is_yyyyMM(v: string): boolean;
+        function is_yyyyMMdd(v: string): boolean;
+        function is_yyyyMMddhh(v: string): boolean;
+        function is_yyyyMMddhhmm(v: string): boolean;
+        function is_yyyyMMddhhmmss(v: string): boolean;
+    }
+}
+declare module "func/u-array" {
+    export namespace UArray {
+        /**
+         * compares two arrays to valuate equality.
+         * if one side is null or undefined, it returns true when other side is the same.
+         * @param v1 it uses equal operator for comparing elements, so applying object element is not recommended.
+         * @param v2 same as v1.
+         * @param sort it uses {@link Array#sort} on v1 and v2 if true. default is true.
+         * @param useStrictEqual it uses `===` operator for compareing elements if true, otherwise using `==` operator. default is true.
+         */
+        function eq(v1: any[], v2: any[], op: {
+            sort?: boolean;
+            useStrictEqual: false;
+        }): boolean;
+        function eq<T>(v1: T[], v2: T[], op: {
+            sort?: boolean;
+            useStrictEqual: true;
+        }): boolean;
+        function eq<T>(v1: T[], v2: T[], op: {
+            sort?: boolean;
+        }): boolean;
+        function eq<T>(v1: T[], v2: T[]): boolean;
+        /**
+         * returns array which is removed duplicate of elements.
+         * this doesn't mutate the param.
+         */
+        function distinct<T>(array: T[]): T[];
+        function distinct<T>(array: T[], op: {
+            k: keyof T;
+            takeLast?: boolean;
+        }): T[];
+        function distinct<T>(array: T[], op: {
+            predicate: (v1: T, v2: T) => boolean;
+            takeLast?: boolean;
+        }): T[];
+        function chop<T>(array: T[], len: number): T[][];
+        function remove<T>(array: T[], v: T): void;
+        function randomPick<T>(array: T[], takeout?: boolean): T;
+        function shuffle<T>(array: T[]): T[];
+        function takeOut<T>(array: T[], filter: (v: T, i?: number) => boolean): T[];
+    }
+}
+declare module "func/u-http" {
+    export namespace UHttp {
+        function isHttpSuccess(statusCode: number): boolean;
+        function statusCategoryOf(statusCode: number): number;
+        function concatParamsWithEncoding(end: string, params: {
+            [k: string]: string | string[];
+        }): string;
+        /** normalize object keys to lower case. */
+        function normalizeHeaders(headers: Record<string, any>): Record<string, any>;
+    }
+}
+declare module "func/decorator/transaction" {
+    /**
+     * applies transation to the method. note that the method must return a Promise.
+     * @param op.timeoutSec default is `30`.
+     */
+    export function transaction(op?: {
+        timeoutSec?: number;
+    }): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
+}
+declare module "xjs-common" {
+    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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xjs-common",
-  "version": "10.1.3",
+  "version": "11.0.0-alpha.2",
   "description": "library modules for typescript that bundled general-purpose implementations.",
   "repository": {
     "type": "git",
@@ -12,8 +12,9 @@
     "utility"
   ],
   "scripts": {
-    "build": "tsc",
-    "test": "node ./dist/test/test.js"
+    "build": "tsc && webpack && npm run build:types",
+    "build:types": "sh ./build-types.sh",
+    "test": "tsc -p ./tsconfig-test.json && node ./compiled/test/test.js"
   },
   "author": "begyyal",
   "license": "Apache-2.0",
@@ -22,9 +23,11 @@
     "!/dist/test*"
   ],
   "main": "./dist/index",
-  "types": "./dist/index.d.ts",
+  "types": "./dist/types.d.ts",
   "devDependencies": {
-    "ts-node": "^10.9.1",
-    "typescript": "^4.9.5"
+    "tsx": "^4.20.3",
+    "typescript": "^5.9.2",
+    "webpack": "^5.101.0",
+    "webpack-cli": "^6.0.1"
   }
-}
+}

package/dist/const/ccy.d.ts

@@ -1,18 +0,0 @@
-export interface Ccy {
-    symbol: t_ccySymbol;
-    crossUsd: string;
-}
-export type t_ccySymbol = keyof (typeof currencies);
-declare const currencies: {
-    jpy: Ccy;
-    usd: Ccy;
-    gbp: Ccy;
-    eur: Ccy;
-    cad: Ccy;
-    aud: Ccy;
-};
-export declare const s_ccy: {
-    [k in t_ccySymbol]: Readonly<Ccy>;
-};
-export declare function resolveCcy(str: string): Ccy;
-export {};

package/dist/const/ccy.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveCcy = exports.s_ccy = void 0;
-const currencies = {
-    jpy: { crossUsd: "usd/jpy" },
-    usd: { crossUsd: null },
-    gbp: { crossUsd: "gbp/usd" },
-    eur: { crossUsd: "eur/usd" },
-    cad: { crossUsd: "cad/usd" },
-    aud: { crossUsd: "aud/usd" }
-};
-exports.s_ccy = (() => {
-    Object.entries(currencies).forEach(kv => { kv[1].symbol = kv[0]; currencies[kv[0]] = Object.freeze(kv[1]); });
-    return Object.freeze(currencies);
-})();
-function resolveCcy(str) {
-    const ccyKey = Object.keys(exports.s_ccy).find(k => str?.toLowerCase() == k);
-    return ccyKey && exports.s_ccy[ccyKey];
-}
-exports.resolveCcy = resolveCcy;

package/dist/const/gender.d.ts

@@ -1,4 +0,0 @@
-export declare enum Gender {
-    Male = 0,
-    Female = 1
-}

package/dist/const/gender.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Gender = void 0;
-var Gender;
-(function (Gender) {
-    Gender[Gender["Male"] = 0] = "Male";
-    Gender[Gender["Female"] = 1] = "Female";
-})(Gender = exports.Gender || (exports.Gender = {}));

package/dist/const/http-method.d.ts

@@ -1,8 +0,0 @@
-export declare enum HttpMethod {
-    Get = "GET",
-    Put = "PUT",
-    Post = "POST",
-    Delete = "DELETE",
-    Patch = "PATCH",
-    Connect = "CONNECT"
-}

package/dist/const/http-method.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HttpMethod = void 0;
-var HttpMethod;
-(function (HttpMethod) {
-    HttpMethod["Get"] = "GET";
-    HttpMethod["Put"] = "PUT";
-    HttpMethod["Post"] = "POST";
-    HttpMethod["Delete"] = "DELETE";
-    HttpMethod["Patch"] = "PATCH";
-    HttpMethod["Connect"] = "CONNECT";
-})(HttpMethod = exports.HttpMethod || (exports.HttpMethod = {}));

package/dist/const/time-unit.d.ts

@@ -1,9 +0,0 @@
-export declare enum TimeUnit {
-    Year = 1,
-    Month = 2,
-    Day = 3,
-    Hour = 4,
-    Min = 5,
-    Sec = 6,
-    Msec = 7
-}

package/dist/const/time-unit.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TimeUnit = void 0;
-var TimeUnit;
-(function (TimeUnit) {
-    TimeUnit[TimeUnit["Year"] = 1] = "Year";
-    TimeUnit[TimeUnit["Month"] = 2] = "Month";
-    TimeUnit[TimeUnit["Day"] = 3] = "Day";
-    TimeUnit[TimeUnit["Hour"] = 4] = "Hour";
-    TimeUnit[TimeUnit["Min"] = 5] = "Min";
-    TimeUnit[TimeUnit["Sec"] = 6] = "Sec";
-    TimeUnit[TimeUnit["Msec"] = 7] = "Msec";
-})(TimeUnit = exports.TimeUnit || (exports.TimeUnit = {}));

package/dist/const/types.d.ts

@@ -1,24 +0,0 @@
-export type IndexSignature = string | number | symbol;
-export type NormalRecord = Record<IndexSignature, any>;
-export type MaybeArray<T> = T | T[];
-export type Loggable = {
-    log: (msg: any) => void;
-    warn: (msg: any) => void;
-    error: (msg: any) => void;
-};
-export type Unique<T = number> = {
-    id: T;
-};
-export type IdName<T = number> = {
-    name: string;
-} & Unique<T>;
-export declare enum Type {
-    string = "string",
-    number = "number",
-    bigint = "bigint",
-    boolean = "boolean",
-    symbol = "symbol",
-    object = "object",
-    undefined = "undefined",
-    null = "null"
-}

package/dist/const/types.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Type = void 0;
-var Type;
-(function (Type) {
-    Type["string"] = "string";
-    Type["number"] = "number";
-    Type["bigint"] = "bigint";
-    Type["boolean"] = "boolean";
-    Type["symbol"] = "symbol";
-    Type["object"] = "object";
-    Type["undefined"] = "undefined";
-    Type["null"] = "null";
-})(Type = exports.Type || (exports.Type = {}));

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

@@ -1,24 +0,0 @@
-import { Type } from "../../const/types";
-export declare const smbl_tm: unique symbol;
-export interface TypeDesc {
-    t?: Type;
-    req?: boolean;
-    ary?: TypeDesc;
-    rec?: boolean;
-}
-export interface TypeMap {
-    [k: string]: TypeDesc;
-}
-/**
- * decorators to be validated by {@link UType.validate},
- * and to be cropped by {@link UObj.crop}.
- */
-export declare namespace DType {
-    function string(target: Object, propKey: string): void;
-    function number(target: Object, propKey: string): void;
-    function boolean(target: Object, propKey: string): void;
-    function required(target: Object, propKey: string): void;
-    function array(elmDesc?: TypeDesc): (target: Object, propKey: string) => void;
-    function recursive(target: Object, propKey: string): void;
-    function keep(target: Object, propKey: string): void;
-}

package/dist/func/decorator/d-type.js

@@ -1,71 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DType = exports.smbl_tm = void 0;
-const types_1 = require("../../const/types");
-const xjs_err_1 = require("../../obj/xjs-err");
-const s_errCode = 30;
-exports.smbl_tm = Symbol.for("xjs:typeMap");
-/**
- * decorators to be validated by {@link UType.validate},
- * and to be cropped by {@link UObj.crop}.
- */
-var DType;
-(function (DType) {
-    function string(target, propKey) {
-        setTypeDesc(target, propKey, types_1.Type.string);
-    }
-    DType.string = string;
-    function number(target, propKey) {
-        setTypeDesc(target, propKey, types_1.Type.number);
-    }
-    DType.number = number;
-    function boolean(target, propKey) {
-        setTypeDesc(target, propKey, types_1.Type.boolean);
-    }
-    DType.boolean = boolean;
-    function setTypeDesc(target, propKey, t) {
-        setDesc(target, propKey, (td) => {
-            if (td.t)
-                throw new xjs_err_1.XjsErr(s_errCode, "decorator to express type is duplicate.");
-            td.t = t;
-        });
-    }
-    function required(target, propKey) {
-        setDesc(target, propKey, (td) => td.req = true);
-    }
-    DType.required = required;
-    function array(elmDesc = {}) {
-        return (target, propKey) => setDesc(target, propKey, (td) => td.ary = elmDesc);
-    }
-    DType.array = array;
-    function recursive(target, propKey) {
-        setDesc(target, propKey, (td) => td.rec = true);
-    }
-    DType.recursive = recursive;
-    function keep(target, propKey) {
-        setDesc(target, propKey, (_) => { });
-    }
-    DType.keep = keep;
-    function setDesc(target, propKey, setter) {
-        const map = target[exports.smbl_tm] ? Object.assign({}, target[exports.smbl_tm]) : {};
-        map[propKey] ??= { t: null, req: false, rec: false, ary: null };
-        const td = map[propKey];
-        setter(td);
-        let ex1 = null, ex2 = null;
-        if (td.t && td.rec) {
-            ex1 = "type";
-            ex2 = "recursive flag";
-        }
-        if (td.t && td.ary) {
-            ex1 = "type";
-            ex2 = "array";
-        }
-        if (td.ary && td.rec) {
-            ex1 = "array";
-            ex2 = "recursive flag";
-        }
-        if (ex1 && ex2)
-            throw new xjs_err_1.XjsErr(s_errCode, `decorator to express ${ex1} and ${ex2} are exclusive.`);
-        Object.defineProperty(target, exports.smbl_tm, { value: map, configurable: true });
-    }
-})(DType = exports.DType || (exports.DType = {}));

package/dist/func/decorator/transaction.d.ts

@@ -1,7 +0,0 @@
-/**
- * applies transation to the method. note that the method must return a Promise.
- * @param op.timeoutSec default is `30`.
- */
-export declare function transaction(op?: {
-    timeoutSec?: number;
-}): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;

package/dist/func/decorator/transaction.js

@@ -1,36 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.transaction = void 0;
-const xjs_err_1 = require("../../obj/xjs-err");
-const u_1 = require("../u");
-const s_errCode = 100;
-/**
- * applies transation to the method. note that the method must return a Promise.
- * @param op.timeoutSec default is `30`.
- */
-function transaction(op) {
-    let lock = 0;
-    const timeoutSec = op?.timeoutSec ?? 30;
-    return (target, propertyKey, descriptor) => {
-        const method = descriptor.value;
-        async function exe(...p) {
-            const timelimit = Date.now() + timeoutSec * 1000;
-            while (lock > 0) {
-                if (timelimit <= Date.now())
-                    throw new xjs_err_1.XjsErr(s_errCode, "An exclusive process to execute was already running by other request.");
-                await (0, u_1.delay)(1);
-            }
-            try {
-                lock++;
-                const ret = method.apply(this, p);
-                return ret instanceof Promise ? await ret : ret;
-            }
-            finally {
-                lock--;
-            }
-        }
-        ;
-        descriptor.value = exe;
-    };
-}
-exports.transaction = transaction;

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

@@ -1,40 +0,0 @@
-export declare namespace UArray {
-    /**
-     * compares two arrays to valuate equality.
-     * if one side is null or undefined, it returns true when other side is the same.
-     * @param v1 it uses equal operator for comparing elements, so applying object element is not recommended.
-     * @param v2 same as v1.
-     * @param sort it uses {@link Array#sort} on v1 and v2 if true. default is true.
-     * @param useStrictEqual it uses `===` operator for compareing elements if true, otherwise using `==` operator. default is true.
-     */
-    function eq(v1: any[], v2: any[], op: {
-        sort?: boolean;
-        useStrictEqual: false;
-    }): boolean;
-    function eq<T>(v1: T[], v2: T[], op: {
-        sort?: boolean;
-        useStrictEqual: true;
-    }): boolean;
-    function eq<T>(v1: T[], v2: T[], op: {
-        sort?: boolean;
-    }): boolean;
-    function eq<T>(v1: T[], v2: T[]): boolean;
-    /**
-     * returns array which is removed duplicate of elements.
-     * this doesn't mutate the param.
-     */
-    function distinct<T>(array: T[]): T[];
-    function distinct<T>(array: T[], op: {
-        k: keyof T;
-        takeLast?: boolean;
-    }): T[];
-    function distinct<T>(array: T[], op: {
-        predicate: (v1: T, v2: T) => boolean;
-        takeLast?: boolean;
-    }): T[];
-    function chop<T>(array: T[], len: number): T[][];
-    function remove<T>(array: T[], v: T): void;
-    function randomPick<T>(array: T[], takeout?: boolean): T;
-    function shuffle<T>(array: T[]): T[];
-    function takeOut<T>(array: T[], filter: (v: T, i?: number) => boolean): T[];
-}

package/dist/func/u-array.js

@@ -1,70 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UArray = void 0;
-const u_1 = require("./u");
-var UArray;
-(function (UArray) {
-    function eq(v1, v2, op = {}) {
-        const { sort, useStrictEqual } = Object.assign({ sort: true, useStrictEqual: true }, op);
-        if (v1 && !v2 || !v1 && v2)
-            return false;
-        if (!v1)
-            return true;
-        if (v1.length !== v2.length)
-            return false;
-        const a = sort ? [...v1].sort() : v1, b = sort ? [...v2].sort() : v2;
-        return a.every((v, i) => useStrictEqual ? v === b[i] : v == b[i]);
-    }
-    UArray.eq = eq;
-    function distinct(array, op) {
-        if (!array || array.length === 0)
-            return [];
-        if (op?.k)
-            return Array.from((0, u_1.array2map)(array, e => e[op.k]).values()).map(a => op?.takeLast ? a.pop() : a.shift());
-        const a = op?.takeLast ? [...array].reverse() : [...array];
-        const p = op?.predicate ?? ((v1, v2) => v1 == v2);
-        const result = [a.shift()];
-        a.forEach(v => result.some(v2 => p(v, v2)) ? {} : result.push(v));
-        return result;
-    }
-    UArray.distinct = distinct;
-    function chop(array, len) {
-        return [...Array(Math.ceil(array.length / len)).keys()]
-            .map(i => {
-            let endIdx = (i + 1) * len;
-            if (endIdx > array.length)
-                endIdx = array.length;
-            return array.slice(i * len, endIdx);
-        });
-    }
-    UArray.chop = chop;
-    function remove(array, v) {
-        const idx = array.indexOf(v);
-        if (idx !== -1)
-            array.splice(idx, 1);
-    }
-    UArray.remove = remove;
-    function randomPick(array, takeout = true) {
-        const i = Math.floor(array.length * Math.random());
-        const r = array[i];
-        if (takeout)
-            array.splice(i, 1);
-        return r;
-    }
-    UArray.randomPick = randomPick;
-    function shuffle(array) {
-        const cp = [...array];
-        return (0, u_1.int2array)(array.length).map(_ => randomPick(cp));
-    }
-    UArray.shuffle = shuffle;
-    function takeOut(array, filter) {
-        const result = [];
-        for (let i = array.length - 1; i >= 0; i--)
-            if (filter(array[i], i)) {
-                result.unshift(array[i]);
-                array.splice(i, 1);
-            }
-        return result;
-    }
-    UArray.takeOut = takeOut;
-})(UArray = exports.UArray || (exports.UArray = {}));

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

@@ -1,9 +0,0 @@
-export declare namespace UHttp {
-    function isHttpSuccess(statusCode: number): boolean;
-    function statusCategoryOf(statusCode: number): number;
-    function concatParamsWithEncoding(end: string, params: {
-        [k: string]: string | string[];
-    }): string;
-    /** normalize object keys to lower case. */
-    function normalizeHeaders(headers: Record<string, any>): Record<string, any>;
-}

package/dist/func/u-http.js

@@ -1,32 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UHttp = void 0;
-var UHttp;
-(function (UHttp) {
-    function isHttpSuccess(statusCode) {
-        return statusCategoryOf(statusCode) === 2;
-    }
-    UHttp.isHttpSuccess = isHttpSuccess;
-    function statusCategoryOf(statusCode) {
-        return Math.floor(statusCode / 100);
-    }
-    UHttp.statusCategoryOf = statusCategoryOf;
-    function concatParamsWithEncoding(end, params) {
-        if (!params || Object.keys(params).length === 0)
-            return end;
-        const paramsFlatten = Object.entries(params)
-            .flatMap(kv => Array.isArray(kv[1]) ? kv[1].map(v => [kv[0], v]) : [kv]);
-        let result = end ? end + "?" : "";
-        for (var kv of paramsFlatten)
-            result += kv[0] + "=" + encodeURIComponent(kv[1]) + "&";
-        return result.substring(0, result.length - 1);
-    }
-    UHttp.concatParamsWithEncoding = concatParamsWithEncoding;
-    /** normalize object keys to lower case. */
-    function normalizeHeaders(headers) {
-        if (!headers)
-            return {};
-        return Object.entries(headers).reduce((a, b) => { a[b[0].toLowerCase()] = b[1]; return a; }, {});
-    }
-    UHttp.normalizeHeaders = normalizeHeaders;
-})(UHttp = exports.UHttp || (exports.UHttp = {}));

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

@@ -1,18 +0,0 @@
-import { NormalRecord } from "../const/types";
-export declare namespace UObj {
-    /**
-     * assign properties to the object with specified property keys.
-     * @param t target object.
-     * @param s source object.
-     * @param keys property keys which are copied from source object. if omit this, all keys in source object is applied.
-     * @param keepDtypeClass if true, class which has properties decorated with {@link DType} in target object is kept and that is assigned properties recursively.
-     */
-    function assignProperties<T extends NormalRecord, S extends NormalRecord>(t: T, s: S, keys?: (keyof S)[], keepDtypeClass?: boolean): T & Partial<S>;
-    /**
-     * crop properties of the object. the properties is removed with `delete` operator.
-     * @param o object which properties is removed.
-     * @param keys property names to be remained. if omit this, it removes the properties other than properties decorated {@link DType}.
-     * @param exclusive if true, it removes `keys` instead of remaining it.
-     */
-    function crop<T extends NormalRecord>(o: T, keys?: (keyof T)[], exclusive?: boolean): Partial<T>;
-}

package/dist/func/u-obj.js

@@ -1,44 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UObj = void 0;
-const d_type_1 = require("./decorator/d-type");
-const u_type_1 = require("./u-type");
-var UObj;
-(function (UObj) {
-    /**
-     * assign properties to the object with specified property keys.
-     * @param t target object.
-     * @param s source object.
-     * @param keys property keys which are copied from source object. if omit this, all keys in source object is applied.
-     * @param keepDtypeClass if true, class which has properties decorated with {@link DType} in target object is kept and that is assigned properties recursively.
-     */
-    function assignProperties(t, s, keys, keepDtypeClass) {
-        for (const k of keys ?? Object.keys(s))
-            if (u_type_1.UType.isDefined(s[k]))
-                if (keepDtypeClass && u_type_1.UType.isObject(t[k]) && u_type_1.UType.isObject(s[k]) && t[k]?.[d_type_1.smbl_tm]) {
-                    assignProperties(t[k], s[k], null, true);
-                }
-                else
-                    t[k] = s[k];
-        return t;
-    }
-    UObj.assignProperties = assignProperties;
-    /**
-     * crop properties of the object. the properties is removed with `delete` operator.
-     * @param o object which properties is removed.
-     * @param keys property names to be remained. if omit this, it removes the properties other than properties decorated {@link DType}.
-     * @param exclusive if true, it removes `keys` instead of remaining it.
-     */
-    function crop(o, keys, exclusive) {
-        if (!keys && !o[d_type_1.smbl_tm])
-            return {};
-        const _keys = keys ?? Object.keys(o[d_type_1.smbl_tm]);
-        Object.keys(o).filter(k => {
-            if (!keys && o[d_type_1.smbl_tm]?.[k]?.rec && o[k])
-                crop(o[k]);
-            return !!exclusive === _keys.includes(k);
-        }).forEach(k => delete o[k]);
-        return o;
-    }
-    UObj.crop = crop;
-})(UObj = exports.UObj || (exports.UObj = {}));

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

@@ -1,27 +0,0 @@
-import { TimeUnit } from "../const/time-unit";
-export declare namespace UString {
-    function eq(s1: string, s2: string): boolean;
-    function repeat(token: string, mlt: number): string;
-    /**
-     * 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?: {
-        date?: Date;
-        unit?: TimeUnit;
-    }): string;
-    function generateRandomString(len: number): string;
-    function idx2az(idx: number): string;
-    function az2idx(az: string): number;
-    function asJpy(amount: number): string;
-    function asUsd(amount: number): string;
-    function asPercentage(amount: number): string;
-    function is_yyyy(v: string): boolean;
-    function is_yyyyMM(v: string): boolean;
-    function is_yyyyMMdd(v: string): boolean;
-    function is_yyyyMMddhh(v: string): boolean;
-    function is_yyyyMMddhhmm(v: string): boolean;
-    function is_yyyyMMddhhmmss(v: string): boolean;
-}

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/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;