@digitalwalletcorp/utils 0.2.0 → 0.4.0

package/lib/object-util.d.ts

@@ -0,0 +1,157 @@
+/** コンストラクタの型 */
+export type Constructor<T> = new (...args: any[]) => T;
+/**
+ * マージのオプション
+ */
+export interface MergeOptions {
+    /**
+     * 配列のマージ方法。既定は 'replace'
+     *   ├ replace source側の配列の複製で置き換える
+     *   ├ concat original側の配列にsource側の要素の複製を連結する
+     *   └ indexMerge 添字ごとにマージする。source側より長い部分はoriginal側の要素が残る
+     */
+    arrays?: 'replace' | 'concat' | 'indexMerge';
+}
+/**
+ * 指定したクラスのインスタンスを生成する
+ *
+ * @param {Constructor<T>} creator クラス
+ * @param {any[]} args コンストラクタの引数
+ * @returns {T}
+ */
+export declare function create<T>(creator: Constructor<T>, ...args: any[]): T;
+/**
+ * オブジェクトに階層構造で値を設定する
+ * 引数の最後の要素が値、それ以外がキーの階層である。キーが1つもない場合は何もしない
+ * 途中の階層が存在しない、またはオブジェクトでない場合は、新しいオブジェクトで置き換えて先へ進む
+ * 設定先がすでに配列の場合は、値を置き換えずに配列へ追加する。値が配列の場合はその要素を追加する
+ *
+ * @example
+ *   const obj = {};
+ *   appendObjectHierarchy(obj, 'a', 'b', 'c', 100);   // { a: { b: { c: 100 } } }
+ *   appendObjectHierarchy(obj, 'a', 'b', 'd', [1]);   // { a: { b: { c: 100, d: [1] } } }
+ *   appendObjectHierarchy(obj, 'a', 'b', 'd', [2]);   // { a: { b: { c: 100, d: [1, 2] } } }
+ *
+ * @param {object} obj
+ * @param {any[]} args キーの階層と、最後に設定する値
+ */
+export declare function appendObjectHierarchy(obj: Record<PropertyKey, any>, ...args: any[]): void;
+/**
+ * オブジェクトの階層キーをドット(.)で繋いで指定して値を取得する
+ * 配列の要素は [n] で指定する
+ * 該当するキーがない場合、または途中の値が null / undefined の場合は undefined を返す
+ *
+ * @example
+ *   getValue({ a: { b: [1, 2, 3] } }, 'a.b[1]');   // 2
+ *
+ * @param {any} obj
+ * @param {string} key
+ * @returns {T | undefined}
+ */
+export declare function getValue<T = any>(obj: any, key: string): T | undefined;
+/**
+ * 値を深く複製する
+ * ・プリミティブと関数はそのまま返す
+ * ・Date / RegExp / Map / Set / 配列 / ArrayBuffer / 型付き配列は複製する
+ * ・プレーンオブジェクトとクラスのインスタンスは、プロトタイプを引き継いで列挙可能な自身のプロパティを複製する
+ * ・DOMのNodeは cloneNode(true) で複製する
+ * ・WeakMap / WeakSet / Promise / Error は参照のまま返す
+ * ・循環参照と、同じオブジェクトを複数箇所から参照している構造は、複製後も保たれる
+ *
+ * @param {T} value
+ * @returns {T}
+ */
+export declare function cloneObject<T>(value: T): T;
+/**
+ * originalにsourceのプロパティを深くマージする(破壊)
+ * ・original側とsource側が両方プレーンオブジェクトの場合は再帰的にマージする
+ * ・source側が undefined のプロパティは「指定なし」とみなし、original側の値を残す
+ * ・それ以外はsource側の値の深い複製で置き換える。null は null を設定する
+ * ・配列は既定でsource側の複製で置き換える。options.arrays で連結・添字ごとのマージに変更できる
+ * ・source側の循環参照と、同じオブジェクトを複数箇所から参照している構造は、結果にも保たれる
+ * ・sourceが null / undefined / プレーンオブジェクト以外の場合は何もしない
+ *
+ * @param {T} original マージ先。この引数が書き換えられる
+ * @param {object | null | undefined} source マージするプロパティを持つオブジェクト
+ * @param {MergeOptions} [options]
+ * @returns {T} original
+ */
+export declare function merge<T extends object>(original: T, source: object | null | undefined, options?: MergeOptions): T;
+/**
+ * originalの複製にsourceのプロパティを深くマージした新しいオブジェクトを返す(非破壊)
+ * マージの規則は merge と同じ
+ *
+ * @param {T} original マージ元。この引数は書き換えない
+ * @param {object | null | undefined} source マージするプロパティを持つオブジェクト
+ * @param {MergeOptions} [options]
+ * @returns {T} マージした新しいオブジェクト
+ */
+export declare function cloneMerge<T extends object>(original: T, source: object | null | undefined, options?: MergeOptions): T;
+/**
+ * originalが自身のプロパティとして持つキーに限定して、sourceのプロパティを深くマージする(破壊)
+ * 値が undefined でもキーがあれば対象になる。入れ子のプレーンオブジェクトにも同じ限定を適用する
+ * original側が null やプリミティブで形を持たない場合は、source側の複製を設定する
+ * そのほかの規則は merge と同じ
+ *
+ * @param {T} original マージ先。この引数が書き換えられる
+ * @param {object | null | undefined} source マージするプロパティを持つオブジェクト
+ * @param {MergeOptions} [options]
+ * @returns {T} original
+ */
+export declare function transfer<T extends object>(original: T, source: object | null | undefined, options?: MergeOptions): T;
+/**
+ * originalの複製に対して、originalが持つキーに限定してsourceのプロパティを深くマージした新しいオブジェクトを返す(非破壊)
+ * マージの規則は transfer と同じ
+ *
+ * @param {T} original マージ元。この引数は書き換えない
+ * @param {object | null | undefined} source マージするプロパティを持つオブジェクト
+ * @param {MergeOptions} [options]
+ * @returns {T} マージした新しいオブジェクト
+ */
+export declare function cloneTransfer<T extends object>(original: T, source: object | null | undefined, options?: MergeOptions): T;
+/**
+ * 値を人が読める文字列にする。値の中身は変えない
+ * ・null / undefined は 'null' / 'undefined'
+ * ・文字列はそのまま
+ * ・number / boolean / bigint / symbol は String(value)
+ * ・関数は '[Function: name]'
+ * ・Error は 'name: message'。スタックは含めない
+ * ・ArrayBuffer / 型付き配列はUTF-8の文字列として復号する
+ * ・toJSON を持つオブジェクト(Dateなど)は toJSON() の結果を変換する
+ * ・Map は { key: value } のオブジェクト、Set は要素の配列としてJSON化する。Mapのキーもこの規則で文字列にする
+ * ・それ以外のオブジェクトと配列はインデント2のJSON。循環参照は '[Circular]' になる
+ * Error / 関数 / Map / Set / bigint の変換は、オブジェクトの中に入っている値にも適用する
+ *
+ * @param {any} value
+ * @returns {string}
+ */
+export declare function toString(value: any): string;
+/**
+ * 値のハッシュ値を返す
+ * 値を toStableString で文字列にし、そのUTF-8のバイト列をFNV-1a(32bit)でハッシュ化する
+ * distinct で同じとみなされる値は同じハッシュ値になる
+ *
+ * @param {any} value
+ * @returns {number} 0 〜 4294967295 の整数
+ */
+export declare function hashCode(value: any): number;
+/**
+ * 配列から重複する要素を除いた新しい配列を返す
+ * ・null / undefined の要素は除く
+ * ・オブジェクトはJSON化した文字列で比較する。プロパティの順序は区別せず、配列の順序は区別する(hashCode と同じ文字列表現)
+ * ・プリミティブは型も区別する。'1' と 1 は別の要素として残る
+ *
+ * @example
+ *   distinct([1, 3, 3, 2, 1]);                                             // [1, 3, 2]
+ *   distinct([{ id: 1, name: 'a' }, { id: 1, name: 'b' }], { distinct: a => a.id });   // [{ id: 1, name: 'a' }]
+ *
+ * @param {T[]} array
+ * @param {*} [options]
+ *   ├ distinct 重複判定に使う値を返す関数。戻り値が null / undefined の要素は除く
+ *   └ exclude trueを返した要素は除く
+ * @returns {T[]}
+ */
+export declare function distinct<T>(array: T[], options?: {
+    distinct?: (a: T) => any;
+    exclude?: (a: T) => boolean;
+}): T[];

package/lib/object-util.js

@@ -0,0 +1,16 @@
+import "./json-util-YX7xSF6R.js";
+import { a as r, c as t, b as c, d as n, e as o, f as i, g, h as d, m as f, t as h, i as l } from "./object-util-DhGi-PmA.js";
+export {
+  r as appendObjectHierarchy,
+  t as cloneMerge,
+  c as cloneObject,
+  n as cloneTransfer,
+  o as create,
+  i as distinct,
+  g as getValue,
+  d as hashCode,
+  f as merge,
+  h as toString,
+  l as transfer
+};
+//# sourceMappingURL=object-util.js.map

package/lib/object-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-util.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/lib/string-util-Cw0VgbIH.js

@@ -0,0 +1,52 @@
+function f(e) {
+  return e && e.trim();
+}
+function g(e) {
+  return e && e.replace(/^[a-z]/, (r) => r.toUpperCase());
+}
+function o(e, r) {
+  if (!e || !r || !r.length)
+    return e;
+  let l = e;
+  for (let i = 0; i < r.length; i++) {
+    const n = r[i], a = String(typeof n == "symbol" ? n.description : n);
+    l = l.replace(new RegExp(`\\{${i}\\}`, "g"), a);
+  }
+  return l;
+}
+function y(e) {
+  const r = e.base?.replace(/\/+$/, "") ?? "", l = e.segments?.map((a, u) => {
+    let t = String(a);
+    return !e.base && u === 0 ? t = t.replace(/^\/+/g, "/") : t = t.replace(/^\/+/g, ""), t.replace(/\/+$/g, "");
+  }) ?? [], i = [r, ...l].filter(Boolean).join("/");
+  let n = "";
+  if (e.query)
+    if (typeof e.query == "string")
+      n = e.query.startsWith("?") ? e.query : `?${e.query}`;
+    else {
+      const a = new URLSearchParams();
+      for (const [t, c] of Object.entries(e.query))
+        if (Array.isArray(c))
+          for (const s of c)
+            a.append(t, String(s));
+        else c != null && a.append(t, String(c));
+      const u = a.toString();
+      u && (n = `?${u}`);
+    }
+  return `${i}${n}`;
+}
+const m = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  buildUrl: y,
+  capitalize: g,
+  messageFormat: o,
+  trim: f
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  y as b,
+  g as c,
+  o as m,
+  m as s,
+  f as t
+};
+//# sourceMappingURL=string-util-Cw0VgbIH.js.map

package/lib/string-util-Cw0VgbIH.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-util-Cw0VgbIH.js","sources":["../src/string-util.ts"],"sourcesContent":["/**\n * URLのクエリに指定できる値\n */\nexport type QueryValue = string | number | boolean | undefined;\n\n/**\n * URLのクエリをキーと値の組で表したもの\n */\nexport type QueryObject = Record<string, QueryValue | QueryValue[]>;\n\n/**\n * 文字列の前後の空白を取り除く\n * null, undefined, 空文字の場合はそのまま元の値を返す\n *\n * @param {string} str\n * @returns {string}\n */\nexport function trim(str: string): string {\n  if (!str) {\n    return str;\n  }\n  return str.trim();\n}\n\n/**\n * 文字列の先頭が英小文字の場合、先頭文字を大文字にする\n * null, undefined, 空文字の場合はそのまま元の値を返す\n *\n * @param {string} str\n * @returns {string}\n */\nexport function capitalize(str: string): string {\n  if (!str) {\n    return str;\n  }\n  return str.replace(/^[a-z]/, c => c.toUpperCase());\n}\n\n/**\n * 文字列内の {0} {1} の部分を、配列の添字に該当するパラメータで置換する\n *\n * @param {string} str 元の文字列\n * @param {(string | number | boolean | symbol)[]} [replacements] 置換パラメータ\n * @returns {string}\n */\nexport function messageFormat(str: string, replacements?: (string | number | boolean | symbol)[]): string {\n  if (!str || !replacements || !replacements.length) {\n    return str;\n  }\n  let buf = str;\n  for (let i = 0; i < replacements.length; i++) {\n    const replacement = replacements[i];\n    const value = typeof replacement === 'symbol'\n      ? String(replacement.description)\n      : String(replacement);\n    buf = buf.replace(new RegExp(`\\\\{${i}\\\\}`, 'g'), value);\n  }\n  return buf;\n}\n\n/**\n * base, segments, queryを連結してURLを生成する\n *\n * @param {*} options\n *   ├ base {string} https://example.com のようなプロトコル付きURL\n *   ├ segments {(string | number)[]} セグメント\n *       baseが未指定で配列の先頭要素がスラッシュで始まる場合、生成されるパスはスラッシュで始まる絶対パスを示す\n *       baseが未指定で配列の先頭要素がスラッシュで始まらない場合、生成されるパスはスラッシュで始まらない相対パスを示す\n *       baseが指定されている場合は、先頭要素のスラッシュの有無に関わらずbaseに続くURLとして生成する。URLクラスの挙動とは異なる\n *   ├ query {string | QueryObject}\n *       文字列: ?date=2022-11-02&param=abc のようなクエリ。先頭に?がない場合は補完する。エンコードはしない\n *       キーと値の組: { date: '2022-11-02', param: 'abc' }。値が配列の場合は同じキーで複数指定する\n * @returns {string}\n */\nexport function buildUrl(options: {\n  base?: string;\n  segments?: (string | number)[];\n  query?: string | QueryObject;\n}): string {\n  const base = options.base?.replace(/\\/+$/, '') ?? '';\n  const segments = options.segments?.map((seg, idx) => {\n    let normalizedSegment = String(seg);\n    if (!options.base && idx === 0) {\n      // 絶対パスか相対パスかを表すため、baseがない場合の先頭要素だけはスラッシュを1つ残す\n      normalizedSegment = normalizedSegment.replace(/^\\/+/g, '/');\n    } else {\n      normalizedSegment = normalizedSegment.replace(/^\\/+/g, '');\n    }\n    return normalizedSegment.replace(/\\/+$/g, '');\n  }) ?? [];\n  const path = [base, ...segments].filter(Boolean).join('/');\n\n  let qs = '';\n  if (options.query) {\n    if (typeof options.query === 'string') {\n      qs = options.query.startsWith('?') ? options.query : `?${options.query}`;\n    } else {\n      const params = new URLSearchParams();\n      for (const [key, value] of Object.entries(options.query)) {\n        if (Array.isArray(value)) {\n          for (const v of value) {\n            params.append(key, String(v));\n          }\n        } else if (value != null) {\n          params.append(key, String(value));\n        }\n      }\n      const strParams = params.toString();\n      if (strParams) {\n        qs = `?${strParams}`;\n      }\n    }\n  }\n  return `${path}${qs}`;\n}\n"],"names":["trim","str","capitalize","c","messageFormat","replacements","buf","replacement","value","buildUrl","options","base","segments","seg","idx","normalizedSegment","path","qs","params","key","v","strParams"],"mappings":"AAiBO,SAASA,EAAKC,GAAqB;AACxC,SAAKA,KAGEA,EAAI,KAAA;AACb;AASO,SAASC,EAAWD,GAAqB;AAC9C,SAAKA,KAGEA,EAAI,QAAQ,UAAU,CAAAE,MAAKA,EAAE,aAAa;AACnD;AASO,SAASC,EAAcH,GAAaI,GAA+D;AACxG,MAAI,CAACJ,KAAO,CAACI,KAAgB,CAACA,EAAa;AACzC,WAAOJ;AAET,MAAIK,IAAML;AACV,WAAS,IAAI,GAAG,IAAII,EAAa,QAAQ,KAAK;AAC5C,UAAME,IAAcF,EAAa,CAAC,GAC5BG,IACF,OADU,OAAOD,KAAgB,WAC1BA,EAAY,cACZA,CADuB;AAElC,IAAAD,IAAMA,EAAI,QAAQ,IAAI,OAAO,MAAM,CAAC,OAAO,GAAG,GAAGE,CAAK;AAAA,EACxD;AACA,SAAOF;AACT;AAgBO,SAASG,EAASC,GAId;AACT,QAAMC,IAAOD,EAAQ,MAAM,QAAQ,QAAQ,EAAE,KAAK,IAC5CE,IAAWF,EAAQ,UAAU,IAAI,CAACG,GAAKC,MAAQ;AACnD,QAAIC,IAAoB,OAAOF,CAAG;AAClC,WAAI,CAACH,EAAQ,QAAQI,MAAQ,IAE3BC,IAAoBA,EAAkB,QAAQ,SAAS,GAAG,IAE1DA,IAAoBA,EAAkB,QAAQ,SAAS,EAAE,GAEpDA,EAAkB,QAAQ,SAAS,EAAE;AAAA,EAC9C,CAAC,KAAK,CAAA,GACAC,IAAO,CAACL,GAAM,GAAGC,CAAQ,EAAE,OAAO,OAAO,EAAE,KAAK,GAAG;AAEzD,MAAIK,IAAK;AACT,MAAIP,EAAQ;AACV,QAAI,OAAOA,EAAQ,SAAU;AAC3B,MAAAO,IAAKP,EAAQ,MAAM,WAAW,GAAG,IAAIA,EAAQ,QAAQ,IAAIA,EAAQ,KAAK;AAAA,SACjE;AACL,YAAMQ,IAAS,IAAI,gBAAA;AACnB,iBAAW,CAACC,GAAKX,CAAK,KAAK,OAAO,QAAQE,EAAQ,KAAK;AACrD,YAAI,MAAM,QAAQF,CAAK;AACrB,qBAAWY,KAAKZ;AACd,YAAAU,EAAO,OAAOC,GAAK,OAAOC,CAAC,CAAC;AAAA,YAEhC,CAAWZ,KAAS,QAClBU,EAAO,OAAOC,GAAK,OAAOX,CAAK,CAAC;AAGpC,YAAMa,IAAYH,EAAO,SAAA;AACzB,MAAIG,MACFJ,IAAK,IAAII,CAAS;AAAA,IAEtB;AAEF,SAAO,GAAGL,CAAI,GAAGC,CAAE;AACrB;;;;;;;;"}

package/lib/string-util-w2I5EYuY.cjs

@@ -0,0 +1,2 @@
+"use strict";function f(e){return e&&e.trim()}function s(e){return e&&e.replace(/^[a-z]/,r=>r.toUpperCase())}function g(e,r){if(!e||!r||!r.length)return e;let l=e;for(let i=0;i<r.length;i++){const n=r[i],a=String(typeof n=="symbol"?n.description:n);l=l.replace(new RegExp(`\\{${i}\\}`,"g"),a)}return l}function o(e){const r=e.base?.replace(/\/+$/,"")??"",l=e.segments?.map((a,u)=>{let t=String(a);return!e.base&&u===0?t=t.replace(/^\/+/g,"/"):t=t.replace(/^\/+/g,""),t.replace(/\/+$/g,"")})??[],i=[r,...l].filter(Boolean).join("/");let n="";if(e.query)if(typeof e.query=="string")n=e.query.startsWith("?")?e.query:`?${e.query}`;else{const a=new URLSearchParams;for(const[t,c]of Object.entries(e.query))if(Array.isArray(c))for(const m of c)a.append(t,String(m));else c!=null&&a.append(t,String(c));const u=a.toString();u&&(n=`?${u}`)}return`${i}${n}`}const y=Object.freeze(Object.defineProperty({__proto__:null,buildUrl:o,capitalize:s,messageFormat:g,trim:f},Symbol.toStringTag,{value:"Module"}));exports.buildUrl=o;exports.capitalize=s;exports.messageFormat=g;exports.stringUtil=y;exports.trim=f;
+//# sourceMappingURL=string-util-w2I5EYuY.cjs.map

package/lib/string-util-w2I5EYuY.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-util-w2I5EYuY.cjs","sources":["../src/string-util.ts"],"sourcesContent":["/**\n * URLのクエリに指定できる値\n */\nexport type QueryValue = string | number | boolean | undefined;\n\n/**\n * URLのクエリをキーと値の組で表したもの\n */\nexport type QueryObject = Record<string, QueryValue | QueryValue[]>;\n\n/**\n * 文字列の前後の空白を取り除く\n * null, undefined, 空文字の場合はそのまま元の値を返す\n *\n * @param {string} str\n * @returns {string}\n */\nexport function trim(str: string): string {\n  if (!str) {\n    return str;\n  }\n  return str.trim();\n}\n\n/**\n * 文字列の先頭が英小文字の場合、先頭文字を大文字にする\n * null, undefined, 空文字の場合はそのまま元の値を返す\n *\n * @param {string} str\n * @returns {string}\n */\nexport function capitalize(str: string): string {\n  if (!str) {\n    return str;\n  }\n  return str.replace(/^[a-z]/, c => c.toUpperCase());\n}\n\n/**\n * 文字列内の {0} {1} の部分を、配列の添字に該当するパラメータで置換する\n *\n * @param {string} str 元の文字列\n * @param {(string | number | boolean | symbol)[]} [replacements] 置換パラメータ\n * @returns {string}\n */\nexport function messageFormat(str: string, replacements?: (string | number | boolean | symbol)[]): string {\n  if (!str || !replacements || !replacements.length) {\n    return str;\n  }\n  let buf = str;\n  for (let i = 0; i < replacements.length; i++) {\n    const replacement = replacements[i];\n    const value = typeof replacement === 'symbol'\n      ? String(replacement.description)\n      : String(replacement);\n    buf = buf.replace(new RegExp(`\\\\{${i}\\\\}`, 'g'), value);\n  }\n  return buf;\n}\n\n/**\n * base, segments, queryを連結してURLを生成する\n *\n * @param {*} options\n *   ├ base {string} https://example.com のようなプロトコル付きURL\n *   ├ segments {(string | number)[]} セグメント\n *       baseが未指定で配列の先頭要素がスラッシュで始まる場合、生成されるパスはスラッシュで始まる絶対パスを示す\n *       baseが未指定で配列の先頭要素がスラッシュで始まらない場合、生成されるパスはスラッシュで始まらない相対パスを示す\n *       baseが指定されている場合は、先頭要素のスラッシュの有無に関わらずbaseに続くURLとして生成する。URLクラスの挙動とは異なる\n *   ├ query {string | QueryObject}\n *       文字列: ?date=2022-11-02&param=abc のようなクエリ。先頭に?がない場合は補完する。エンコードはしない\n *       キーと値の組: { date: '2022-11-02', param: 'abc' }。値が配列の場合は同じキーで複数指定する\n * @returns {string}\n */\nexport function buildUrl(options: {\n  base?: string;\n  segments?: (string | number)[];\n  query?: string | QueryObject;\n}): string {\n  const base = options.base?.replace(/\\/+$/, '') ?? '';\n  const segments = options.segments?.map((seg, idx) => {\n    let normalizedSegment = String(seg);\n    if (!options.base && idx === 0) {\n      // 絶対パスか相対パスかを表すため、baseがない場合の先頭要素だけはスラッシュを1つ残す\n      normalizedSegment = normalizedSegment.replace(/^\\/+/g, '/');\n    } else {\n      normalizedSegment = normalizedSegment.replace(/^\\/+/g, '');\n    }\n    return normalizedSegment.replace(/\\/+$/g, '');\n  }) ?? [];\n  const path = [base, ...segments].filter(Boolean).join('/');\n\n  let qs = '';\n  if (options.query) {\n    if (typeof options.query === 'string') {\n      qs = options.query.startsWith('?') ? options.query : `?${options.query}`;\n    } else {\n      const params = new URLSearchParams();\n      for (const [key, value] of Object.entries(options.query)) {\n        if (Array.isArray(value)) {\n          for (const v of value) {\n            params.append(key, String(v));\n          }\n        } else if (value != null) {\n          params.append(key, String(value));\n        }\n      }\n      const strParams = params.toString();\n      if (strParams) {\n        qs = `?${strParams}`;\n      }\n    }\n  }\n  return `${path}${qs}`;\n}\n"],"names":["trim","str","capitalize","c","messageFormat","replacements","buf","replacement","value","buildUrl","options","base","segments","seg","idx","normalizedSegment","path","qs","params","key","v","strParams"],"mappings":"aAiBO,SAASA,EAAKC,EAAqB,CACxC,OAAKA,GAGEA,EAAI,KAAA,CACb,CASO,SAASC,EAAWD,EAAqB,CAC9C,OAAKA,GAGEA,EAAI,QAAQ,SAAUE,GAAKA,EAAE,aAAa,CACnD,CASO,SAASC,EAAcH,EAAaI,EAA+D,CACxG,GAAI,CAACJ,GAAO,CAACI,GAAgB,CAACA,EAAa,OACzC,OAAOJ,EAET,IAAIK,EAAML,EACV,QAAS,EAAI,EAAG,EAAII,EAAa,OAAQ,IAAK,CAC5C,MAAME,EAAcF,EAAa,CAAC,EAC5BG,EACF,OADU,OAAOD,GAAgB,SAC1BA,EAAY,YACZA,CADuB,EAElCD,EAAMA,EAAI,QAAQ,IAAI,OAAO,MAAM,CAAC,MAAO,GAAG,EAAGE,CAAK,CACxD,CACA,OAAOF,CACT,CAgBO,SAASG,EAASC,EAId,CACT,MAAMC,EAAOD,EAAQ,MAAM,QAAQ,OAAQ,EAAE,GAAK,GAC5CE,EAAWF,EAAQ,UAAU,IAAI,CAACG,EAAKC,IAAQ,CACnD,IAAIC,EAAoB,OAAOF,CAAG,EAClC,MAAI,CAACH,EAAQ,MAAQI,IAAQ,EAE3BC,EAAoBA,EAAkB,QAAQ,QAAS,GAAG,EAE1DA,EAAoBA,EAAkB,QAAQ,QAAS,EAAE,EAEpDA,EAAkB,QAAQ,QAAS,EAAE,CAC9C,CAAC,GAAK,CAAA,EACAC,EAAO,CAACL,EAAM,GAAGC,CAAQ,EAAE,OAAO,OAAO,EAAE,KAAK,GAAG,EAEzD,IAAIK,EAAK,GACT,GAAIP,EAAQ,MACV,GAAI,OAAOA,EAAQ,OAAU,SAC3BO,EAAKP,EAAQ,MAAM,WAAW,GAAG,EAAIA,EAAQ,MAAQ,IAAIA,EAAQ,KAAK,OACjE,CACL,MAAMQ,EAAS,IAAI,gBACnB,SAAW,CAACC,EAAKX,CAAK,IAAK,OAAO,QAAQE,EAAQ,KAAK,EACrD,GAAI,MAAM,QAAQF,CAAK,EACrB,UAAWY,KAAKZ,EACdU,EAAO,OAAOC,EAAK,OAAOC,CAAC,CAAC,OAErBZ,GAAS,MAClBU,EAAO,OAAOC,EAAK,OAAOX,CAAK,CAAC,EAGpC,MAAMa,EAAYH,EAAO,SAAA,EACrBG,IACFJ,EAAK,IAAII,CAAS,GAEtB,CAEF,MAAO,GAAGL,CAAI,GAAGC,CAAE,EACrB"}

package/lib/string-util.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./string-util-w2I5EYuY.cjs");exports.buildUrl=e.buildUrl;exports.capitalize=e.capitalize;exports.messageFormat=e.messageFormat;exports.trim=e.trim;
+//# sourceMappingURL=string-util.cjs.map

package/lib/string-util.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-util.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/string-util.d.cts

@@ -0,0 +1,51 @@
+/**
+ * URLのクエリに指定できる値
+ */
+export type QueryValue = string | number | boolean | undefined;
+/**
+ * URLのクエリをキーと値の組で表したもの
+ */
+export type QueryObject = Record<string, QueryValue | QueryValue[]>;
+/**
+ * 文字列の前後の空白を取り除く
+ * null, undefined, 空文字の場合はそのまま元の値を返す
+ *
+ * @param {string} str
+ * @returns {string}
+ */
+export declare function trim(str: string): string;
+/**
+ * 文字列の先頭が英小文字の場合、先頭文字を大文字にする
+ * null, undefined, 空文字の場合はそのまま元の値を返す
+ *
+ * @param {string} str
+ * @returns {string}
+ */
+export declare function capitalize(str: string): string;
+/**
+ * 文字列内の {0} {1} の部分を、配列の添字に該当するパラメータで置換する
+ *
+ * @param {string} str 元の文字列
+ * @param {(string | number | boolean | symbol)[]} [replacements] 置換パラメータ
+ * @returns {string}
+ */
+export declare function messageFormat(str: string, replacements?: (string | number | boolean | symbol)[]): string;
+/**
+ * base, segments, queryを連結してURLを生成する
+ *
+ * @param {*} options
+ *   ├ base {string} https://example.com のようなプロトコル付きURL
+ *   ├ segments {(string | number)[]} セグメント
+ *       baseが未指定で配列の先頭要素がスラッシュで始まる場合、生成されるパスはスラッシュで始まる絶対パスを示す
+ *       baseが未指定で配列の先頭要素がスラッシュで始まらない場合、生成されるパスはスラッシュで始まらない相対パスを示す
+ *       baseが指定されている場合は、先頭要素のスラッシュの有無に関わらずbaseに続くURLとして生成する。URLクラスの挙動とは異なる
+ *   ├ query {string | QueryObject}
+ *       文字列: ?date=2022-11-02&param=abc のようなクエリ。先頭に?がない場合は補完する。エンコードはしない
+ *       キーと値の組: { date: '2022-11-02', param: 'abc' }。値が配列の場合は同じキーで複数指定する
+ * @returns {string}
+ */
+export declare function buildUrl(options: {
+    base?: string;
+    segments?: (string | number)[];
+    query?: string | QueryObject;
+}): string;

package/lib/string-util.d.ts

@@ -0,0 +1,51 @@
+/**
+ * URLのクエリに指定できる値
+ */
+export type QueryValue = string | number | boolean | undefined;
+/**
+ * URLのクエリをキーと値の組で表したもの
+ */
+export type QueryObject = Record<string, QueryValue | QueryValue[]>;
+/**
+ * 文字列の前後の空白を取り除く
+ * null, undefined, 空文字の場合はそのまま元の値を返す
+ *
+ * @param {string} str
+ * @returns {string}
+ */
+export declare function trim(str: string): string;
+/**
+ * 文字列の先頭が英小文字の場合、先頭文字を大文字にする
+ * null, undefined, 空文字の場合はそのまま元の値を返す
+ *
+ * @param {string} str
+ * @returns {string}
+ */
+export declare function capitalize(str: string): string;
+/**
+ * 文字列内の {0} {1} の部分を、配列の添字に該当するパラメータで置換する
+ *
+ * @param {string} str 元の文字列
+ * @param {(string | number | boolean | symbol)[]} [replacements] 置換パラメータ
+ * @returns {string}
+ */
+export declare function messageFormat(str: string, replacements?: (string | number | boolean | symbol)[]): string;
+/**
+ * base, segments, queryを連結してURLを生成する
+ *
+ * @param {*} options
+ *   ├ base {string} https://example.com のようなプロトコル付きURL
+ *   ├ segments {(string | number)[]} セグメント
+ *       baseが未指定で配列の先頭要素がスラッシュで始まる場合、生成されるパスはスラッシュで始まる絶対パスを示す
+ *       baseが未指定で配列の先頭要素がスラッシュで始まらない場合、生成されるパスはスラッシュで始まらない相対パスを示す
+ *       baseが指定されている場合は、先頭要素のスラッシュの有無に関わらずbaseに続くURLとして生成する。URLクラスの挙動とは異なる
+ *   ├ query {string | QueryObject}
+ *       文字列: ?date=2022-11-02&param=abc のようなクエリ。先頭に?がない場合は補完する。エンコードはしない
+ *       キーと値の組: { date: '2022-11-02', param: 'abc' }。値が配列の場合は同じキーで複数指定する
+ * @returns {string}
+ */
+export declare function buildUrl(options: {
+    base?: string;
+    segments?: (string | number)[];
+    query?: string | QueryObject;
+}): string;

package/lib/string-util.js

@@ -0,0 +1,8 @@
+import { b as m, c as r, m as t, t as e } from "./string-util-Cw0VgbIH.js";
+export {
+  m as buildUrl,
+  r as capitalize,
+  t as messageFormat,
+  e as trim
+};
+//# sourceMappingURL=string-util.js.map

package/lib/string-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-util.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitalwalletcorp/utils",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "A javascript utility.",
   "type": "module",
   "main": "lib/index.cjs",
@@ -30,8 +30,11 @@
   },
   "scripts": {
     "build": "vite build",
+    "yarn:dedupe": "npx yarn-deduplicate --strategy highest yarn.lock",
     "install:dev": "rm -rf lib dest && find node_modules -mindepth 1 -delete && yarn install",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "tsc": "tsc --noEmit -p tsconfig.json",
+    "lint": "eslint .",
+    "lint:fix": "eslint --fix .",
     "version:patch": "npm version patch",
     "version:minor": "npm version minor",
     "version:major": "npm version major",
@@ -41,12 +44,9 @@
     "test:unit": "vitest run --coverage"
   },
   "keywords": [
-    "utility",
-    "utils",
-    "number",
-    "decimal"
+    "utils"
   ],
-  "author": "satoshi kotaki",
+  "author": "Digital Wallet Corporation",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -56,20 +56,38 @@
   "bugs": {
     "url": "https://github.com/digitalwalletcorp/utils/issues"
   },
+  "engines": {
+    "node": ">=21"
+  },
   "files": [
     "lib/**/*",
     "src/**/*"
   ],
   "dependencies": {
-    "big.js": "7.0.1"
+    "big.js": "7.0.1",
+    "crypto-js": "4.2.0",
+    "diff": "8.0.2",
+    "luxon": "3.7.2"
   },
   "devDependencies": {
+    "@stylistic/eslint-plugin": "5.10.0",
     "@types/big.js": "6.2.2",
+    "@types/crypto-js": "4.2.2",
+    "@types/luxon": "3.7.1",
     "@types/node": "24.13.6",
     "@vitest/coverage-v8": "3.2.4",
+    "eslint": "10.11.0",
+    "globals": "17.13.0",
     "typescript": "6.0.3",
+    "typescript-eslint": "8.71.0",
     "vite": "7.3.6",
     "vite-plugin-dts": "5.1.0",
     "vitest": "3.2.4"
+  },
+  "resolutions": {
+    "eslint": "10.11.0",
+    "typescript-eslint": "8.71.0",
+    "@stylistic/eslint-plugin": "5.10.0",
+    "globals": "17.13.0"
   }
 }

package/src/crypto-util.ts

@@ -0,0 +1,84 @@
+import CryptoJS from 'crypto-js';
+
+const CHARSETS = {
+  ascii: `!"#$%&'()*+,-./0123456789:;<=>?@[]^_\`abcdefghijklmnopqrstuvwxyz{|}~`,
+  number: '0123456789',
+  alphabet: 'abcdefghijklmnopqrstuvwxyz',
+  alphanum: '0123456789abcdefghijklmnopqrstuvwxyz',
+  hex: '0123456789abcdef'
+} as const;
+
+const randomBytes = (size: number): Uint8Array => globalThis.crypto.getRandomValues(new Uint8Array(size));
+
+/**
+ * 文字列をSHA-256でハッシュ化し、大文字の16進数文字列で返す
+ *
+ * @param {string} str
+ * @returns {string}
+ */
+export function toSha256(str: string): string {
+  return CryptoJS.SHA256(str).toString().toUpperCase();
+}
+
+/**
+ * ランダムな文字列を生成する
+ * 大文字と小文字は別の文字として扱う
+ * caseを指定しない場合は生成対象の文字セットに大文字と小文字の両方を含めるため、'a'と'A'の出現率は同じ確率になる
+ *
+ * @param {number} length 生成する文字列の桁数
+ * @param {*} [options]
+ *   ├ charset 'ascii' | 'number' | 'alphabet' | 'alphanum' | 'hex' 未指定の場合はASCIIの記号・数字・英字(スペースとバックスラッシュを除く)
+ *   ├ case 'upperCase' | 'lowerCase' 英字を大文字のみ・小文字のみにする。未指定の場合は大文字小文字混在
+ *   ├ rejectStartsWithZero trueを指定した場合、0始まりの文字列を生成しない
+ *   ├ includeChars 文字セットに追加する文字。大文字小文字を区別する
+ *   ├ excludeChars 文字セットから除外する文字。大文字小文字は区別する
+ * @returns {string}
+ */
+export function generateRandomString(length: number, options?: {
+  charset?: 'ascii' | 'number' | 'alphabet' | 'alphanum' | 'hex';
+  case?: 'upperCase' | 'lowerCase';
+  rejectStartsWithZero?: boolean;
+  includeChars?: string | string[];
+  excludeChars?: string | string[];
+}): string {
+  if (!Number.isInteger(length) || length < 0) {
+    throw new Error('crypto-util.generateRandomString: length must be a non-negative integer');
+  }
+
+  const lower = CHARSETS[options?.charset ?? 'ascii'];
+  const upper = lower.toUpperCase();
+  let pool = options?.case === 'upperCase'
+    ? upper
+    : options?.case === 'lowerCase'
+      ? lower
+      : lower + upper;
+  const includeChars = options?.includeChars;
+  if (includeChars) {
+    // 追加文字の指定がある場合
+    pool += Array.isArray(includeChars) ? includeChars.join('') : includeChars;
+  }
+  const excludeChars = options?.excludeChars;
+  if (excludeChars) {
+    // 除外文字の指定がある場合
+    const excluded = new Set(Array.isArray(excludeChars) ? excludeChars : Array.from(excludeChars));
+    pool = Array.from(pool).filter(a => !excluded.has(a)).join('');
+  }
+  const characters = Array.from(new Set(pool));
+  if (!characters.length) {
+    throw new Error('crypto-util.generateRandomString: no characters left after applying excludeChars');
+  }
+  // 256を文字種の数で割り切れる範囲のバイトだけを使い、文字ごとの出現率を揃える
+  const maxAcceptableValue = Math.floor(256 / characters.length) * characters.length - 1;
+  let result = '';
+  do {
+    result = '';
+    while (result.length < length) {
+      for (const byte of randomBytes(length - result.length)) {
+        if (byte <= maxAcceptableValue) {
+          result += characters[byte % characters.length];
+        }
+      }
+    }
+  } while (options?.rejectStartsWithZero && result.startsWith('0'));
+  return result;
+}