README.md

@d-zero/shared

共有ユーティリティ関数とクラスのコレクション。

モジュール一覧

コアユーティリティ

Import Path	Description
@d-zero/shared/cache	ファイルシステムにデータを保存するシンプルなキャッシュシステムのクラス
@d-zero/shared/config-reader	フロントマターをサポートする設定ファイルリーダー
@d-zero/shared/deferred	遅延解決可能なPromiseクラス
@d-zero/shared/disposable-listener	イベントリスナーを登録し、using 宣言のスコープ脱出時に自動解除する Disposable を返す関数
@d-zero/shared/mkdtemp-disposable	一時ディレクトリを作成し、using 宣言のスコープ脱出時に自動削除する AsyncDisposable ハンドルを返す関数
@d-zero/shared/hash	文字列のSHA-256ハッシュ値を生成
@d-zero/shared/types	TypeScript型定義

ランダム数値生成と遅延機能

Import Path	Description
@d-zero/shared/delay	コードの実行を指定した時間だけ遅延させる関数。固定時間やランダムな遅延時間、確率分布を指定可能。 詳細
@d-zero/shared/random-int	指定された範囲内でランダムな整数を生成する関数。 詳細
@d-zero/shared/sample-distribution	指定された確率分布（一様・正規・三角・偏り・二峰性・カスタム）からランダムな整数値をサンプリングする関数。 詳細
@d-zero/shared/parse-interval	CLI引数の文字列（"500" または "500-1000"）をパースし、数値またはDelayOptionsに変換する関数。エラーメッセージ用のフィールドラベルを指定可能

日付ユーティリティ

Import Path	Description
@d-zero/shared/between-weekend-days	2つの日付間の週末の日付を返す関数
@d-zero/shared/skip-holiday-period	開始日と期限日の間の祝日期間をスキップする関数
@d-zero/shared/skip-holidays	指定された日付から祝日と週末をスキップし、次の有効な日付を返す関数

URL/パスユーティリティ

Import Path	Description
@d-zero/shared/decode-uri-safely	URLエンコードされた文字列を安全にデコードする関数群（decodeURISafely、decodeURIComponentSafely）
@d-zero/shared/encode-resource-path	リソースパスをMIMEタイプと共にエンコード/デコードする関数群。拡張子がないURLパスにMIMEタイプ情報をエンコード。 詳細
@d-zero/shared/normalize-url	URLを正規化する関数。エンコーディング、パス、トレーリングスラッシュ、インデックスページのバリエーションを正規化
@d-zero/shared/parse-url	URL文字列をパースし、正規化されたExURLオブジェクトを返す関数
@d-zero/shared/path-list-to-tree	URLまたはファイルパスのリストをツリー構造に変換する関数。 詳細
@d-zero/shared/url-matches	2つのURLが等価かどうかを比較する関数。エンコーディング、トレーリングスラッシュ、インデックスページのバリエーション、クエリパラメータの順序を考慮
@d-zero/shared/url-to-file-name	URLをファイル名として使用可能な文字列に変換する関数
@d-zero/shared/url-to-local-path	URLをローカルファイルパスに変換する関数。 詳細
@d-zero/shared/validate-same-host	すべてのURLが同じホスト名を持つことを検証する関数

配列/文字列ユーティリティ

Import Path	Description
@d-zero/shared/split-array	配列を指定されたサイズのチャンクに分割する関数
@d-zero/shared/str-to-regex	文字列パターンを正規表現に変換する関数

ソートユーティリティ

Import Path	Description
@d-zero/shared/sort/dir	2つのディレクトリパスを比較し、順序を示す値を返す関数
@d-zero/shared/sort/path	2つのURLまたはURLを表す文字列を比較し、順序を示す値を返す関数

HTTP検出ユーティリティ

Import Path	Description
@d-zero/shared/detect-compress	HTTPレスポンスヘッダから圧縮形式を検出する関数（gzip, br, compress, deflate等に対応）
@d-zero/shared/detect-cdn	HTTPレスポンスヘッダからCDNプロバイダを検出する関数（Akamai, CloudFront, Cloudflare等に対応）

その他のユーティリティ

Import Path	Description
@d-zero/shared/filesize	バイトサイズをキロバイト（KB）またはメガバイト（MB）に変換する関数
@d-zero/shared/mime-to-extension	MIMEタイプをファイル拡張子に変換する関数
@d-zero/shared/race-with-timeout	指定されたPromiseをタイムアウトと競争させ、結果またはタイムアウト指示を返す関数
@d-zero/shared/ratio-value	絶対値と相対値の比率を自動的に維持しながら更新する関数
@d-zero/shared/retry	メソッドにリトライロジックを追加するデコレータファクトリ。 詳細
@d-zero/shared/timestamp	タイムスタンプを生成する関数。フォーマットが指定されない場合は、Linux時刻（エポック秒）を文字列で返す
@d-zero/shared/typed-await-event-emitter	型付きイベントと非同期イベント処理をサポートするイベントエミッター