xjs-common 11.0.0 → 11.0.1-alpha.2

package/dist/index.js

@@ -1 +0,0 @@
-!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

@@ -1,285 +0,0 @@
-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";
-}