dl-once 0.0.1 → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026-present, tai-kun
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -1,45 +1,145 @@
 # dl-once
 
-## ⚠️ IMPORTANT NOTICE ⚠️
+`dl-once` は、リソースを「一度だけ、確実に」取得するための TypeScript/JavaScript ライブラリです。
 
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
+ネットワークの不安定さへの耐性、多層的なキャッシュ制御、そして詳細なライフサイクルフックを提供し、複雑なダウンロード要件をシンプルに解決します。
 
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
+## 主な特徴
 
-## Purpose
+* **キャッシュファースト**: ネットワーク取得の前にキャッシュ（IndexedDB、ファイルシステム 等）を確認し、無駄な通信を抑制します。
+* **マルチターゲット・フォールバック**: 複数の URL を指定可能。1つ目の取得に失敗しても、自動的に次のミラーサイトやバックアップ URL を試行します。
+* **ストリーム処理**: メモリ効率を重視。レスポンスをチャンクごとに処理し、読み込みながら同時にキャッシュへの書き出しを行います。
+* **強力なフックシステム**: 開始前、データ受信中、完了、エラーの各フェーズに独自のロジックを注入できます。
+* **中断（Abort）の完全サポート**: `AbortSignal` により、処理を安全かつ即座に停止し、リソースを解放します。
 
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `dl-once`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
+## インストール
 
-## What is OIDC Trusted Publishing?
+```bash
+npm install dl-once
+```
 
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
+## 基本的な使い方
 
-## Setup Instructions
+最もシンプルな使い方は、URL を渡して `Uint8Array` を受け取る方法です。
 
-To properly configure OIDC trusted publishing for this package:
+```typescript
+import downloadOnce from "dl-once";
 
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
+const data = await downloadOnce("https://example.com/assets/config.bin");
+console.log(`取得サイズ: ${data.length} bytes`);
+```
 
-## DO NOT USE THIS PACKAGE
+## 高度な設定例（1）
 
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
+キャッシュ、検証を組み合わせる例です。
 
-## More Information
+```typescript
+import {
+  downloadOnce,           // メインの関数です。
+  IndexedDbCacheStorage,  // ブラウザーで IndexedDB にキャッシュするためのストレージクラスです。
+  NodeFsCacheStorage,     // Node.js でファイルにキャッシュするためのストレージクラスです。
+  Sha256VerificationHook, // 期待する SHA-256 ハッシュ値であるか検証するためのフッククラスです。
+} from "dl-once";
 
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
+await using cacheStorage = typeof document !== "undefined"
+  ? new IndexedDbCacheStorage("dl-once-db-name")
+  : new NodeFsCacheStorage("/tmp/dl-once-cache");
+await cacheStorage.open();
 
----
+const data = downloadOnce(["https://example.com/data"], {
+  // キャッシュの制御
+  cacheHandle: cacheStorage.createCacheHandle(),
 
-**Maintained for OIDC setup purposes only**
+  // ライフサイクルフック
+  hooks: [
+    new Sha256VerificationHook("..."),
+  ],
+
+  // 中断制御
+  signal: AbortSignal.timeout(30e3) // 30 秒タイムアウト
+});
+```
+
+## 高度な設定例（2）
+
+キャッシュ、カスタムフェッチャー、および進捗確認用のフックを組み合わせる例です。
+
+```typescript
+import downloadOnce from "dl-once";
+
+const data = await downloadOnce(
+  // 1つ目が失敗したら2つ目を試行
+  ["https://primary.example.com/data", "https://backup.example.com/data"],
+  {
+    // キャッシュの制御
+    cacheHandle: myCustomCacheHandle, 
+    forceDownload: false,
+
+    // ライフサイクルフック
+    hooks: [{
+      onBeforeDownload({ request }) {
+        console.log(`開始: ${request.url}`);
+      },
+      onChunkRead({ chunkData }) {
+        console.log(`${chunkData.length} bytes を受信`);
+      },
+      onClose() {
+        console.log("ダウンロード完了！");
+      },
+      onError({ reason }) {
+        console.error("エラーが発生しました:", reason);
+      }
+    }],
+
+    // 中断制御
+    signal: AbortSignal.timeout(30e3) // 30 秒タイムアウト
+  }
+);
+```
+
+## API リファレンス
+
+### `downloadOnce(target, options?)`
+
+#### `target`
+
+取得対象を指定します。以下のいずれか、またはその配列を受け取ります。
+
+* `string` | `URL` | `Request`: リソースの場所。
+* `() => MaybePromise<PrimitiveTarget>`: 実行時に URL を生成する関数。
+* `Config`: 個別の設定（`target`, `hooks`, `fetcher` 等）を含むオブジェクト。
+
+#### `options`
+
+全体的な動作を制御するオプションです。
+
+* `cacheHandle`: キャッシュの読み書きを管理するインターフェース。
+* `forceDownload`: `true` の場合、キャッシュを無視してネットワークから取得します。
+* `hooks`: グローバルに適用されるフック関数の配列。
+* `fetcher`: カスタムの HTTP リクエスト実行関数（デフォルトは `fetch`）。
+* `signal`: 処理全体を中断するための `AbortSignal`。
+
+## インターフェースの拡張
+
+### キャッシュの実装 (`ICacheHandle`)
+
+独自のキャッシュ機構（例：ブラウザの Cache Storage や Node.js のファイルシステム）を利用するには、`ICacheHandle` を実装します。
+
+```typescript
+const myCache: ICacheHandle = {
+  async getReader({ signal }) {
+    // キャッシュがあれば AsyncIterableIterator を返す、なければ null
+  },
+  async getWriter({ response, request }) {
+    // IWriter (write, close, abort) を実装したオブジェクトを返す
+  }
+};
+```
+
+### フックの実装 (`IHook`)
+
+ダウンロードの進捗表示やログ記録などに利用できます。特定のフックがエラーを投げても、ライブラリ本体の処理は継続されるよう設計されています（`onClose` を除く）。
+
+## ライセンス
+
+MIT

package/dist/_bytes-builder.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `Uint8Array` のチャンクを効率的に積み上げ、最終的に一つのバイナリーデータとして結合するためのビルダー形式のクラスです。
+ */
+export default class BytesBuilder {
+    /**
+     * 書き込まれたバイナリーデータのチャンクを保持する配列です。
+     * @private
+     */
+    private chunks;
+    /**
+     * 現在までに書き込まれた全データの合計バイト長です。
+     * @private
+     */
+    private length;
+    /**
+     * `BytesBuilder` クラスの新しいインスタンスを初期化します。
+     */
+    constructor();
+    /**
+     * 新しいバイナリーデータをチャンクとして追加します。
+     *
+     * @param data 追加する `Uint8Array` 形式のデータです。
+     */
+    write(data: Uint8Array<ArrayBuffer>): void;
+    /**
+     * 現在保持しているすべてのチャンクを結合して、一つの `Uint8Array` として返します。
+     *
+     * このメソッドを呼び出すと、内部のチャンクと長さの情報はリセットされます。
+     *
+     * @returns 結合されたすべてのデータを含む `Uint8Array` です。
+     */
+    bytes(): Uint8Array<ArrayBuffer>;
+}
+//# sourceMappingURL=_bytes-builder.d.ts.map

package/dist/_bytes-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_bytes-builder.d.ts","sourceRoot":"","sources":["../src/_bytes-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAA4B;IAE1C;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAS;IAEvB;;OAEG;;IAOH;;;;OAIG;IACI,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,IAAI;IAMjD;;;;;;OAMG;IACI,KAAK,IAAI,UAAU,CAAC,WAAW,CAAC;CAsBxC"}

package/dist/_bytes-builder.js

@@ -0,0 +1,48 @@
+/**
+ * `Uint8Array` のチャンクを効率的に積み上げ、最終的に一つのバイナリーデータとして結合するためのビルダー形式のクラスです。
+ */
+export default class BytesBuilder {
+    /**
+     * `BytesBuilder` クラスの新しいインスタンスを初期化します。
+     */
+    constructor() {
+        // 内部状態を初期化します。
+        this.chunks = [];
+        this.length = 0;
+    }
+    /**
+     * 新しいバイナリーデータをチャンクとして追加します。
+     *
+     * @param data 追加する `Uint8Array` 形式のデータです。
+     */
+    write(data) {
+        // チャンク配列にデータを追加し、全体の長さを更新します。
+        this.chunks.push(data);
+        this.length += data.length;
+    }
+    /**
+     * 現在保持しているすべてのチャンクを結合して、一つの `Uint8Array` として返します。
+     *
+     * このメソッドを呼び出すと、内部のチャンクと長さの情報はリセットされます。
+     *
+     * @returns 結合されたすべてのデータを含む `Uint8Array` です。
+     */
+    bytes() {
+        // 全体の長さに合わせた新しいバッファーを確保します。
+        const bytes = new Uint8Array(this.length);
+        // 書き込み位置を管理するためのオフセット変数です。
+        let offset = 0;
+        // 保持している各チャンクを、作成したバッファーの適切な位置にコピーしていきます。
+        for (const data of this.chunks) {
+            // 指定したオフセットからデータをセットします。
+            bytes.set(data, offset);
+            // 次のチャンクのためにオフセットを更新します。
+            offset += data.length;
+        }
+        // 次回の書き込みに備えて、内部の状態（チャンク配列と合計長）をリセットします。
+        this.chunks = [];
+        this.length = 0;
+        // 結合済みのバイナリーデータを返します。
+        return bytes;
+    }
+}

package/dist/cache-storage.d.ts

@@ -0,0 +1,74 @@
+import type { ICacheHandle, MaybePromise } from "./dl-once.js";
+/**
+ * ストレージを開始する際に渡せるオプションの型定義です。
+ */
+export type OpenOptions = {
+    /**
+     * 中断を監視するためのシグナルです。
+     */
+    readonly signal?: AbortSignal | undefined;
+};
+/**
+ * ストレージを終了する際に渡せるオプションの型定義です。
+ */
+export type CloseOptions = {
+    /**
+     * 中断を監視するためのシグナルです。
+     */
+    readonly signal?: AbortSignal | undefined;
+};
+/**
+ * ストレージをクリアする際に渡せるオプションの型定義です。
+ */
+export type ClearOptions = {
+    /**
+     * キャッシュを一意に識別する文字列です。
+     */
+    readonly cacheKey?: string | undefined;
+    /**
+     * 中断を監視するためのシグナルです。
+     */
+    readonly signal?: AbortSignal | undefined;
+};
+/**
+ * データキャッシュを管理するストレージのインターフェースです。
+ */
+export interface ICacheStorage {
+    /**
+     * ストレージが現在開いているかどうかを返します。
+     */
+    readonly isOpen: boolean;
+    /**
+     * ストレージを開き、利用可能な状態にします。
+     *
+     * @param options オプションです。
+     */
+    open(options?: OpenOptions | undefined): MaybePromise<void>;
+    /**
+     * ストレージを閉じ、すべてのキャッシュデータを破棄します。
+     *
+     * @param options オプションです。
+     */
+    close(options?: CloseOptions | undefined): MaybePromise<void>;
+    /**
+     * キャッシュをクリアします。引数が指定された場合はそのキーのみ、指定されない場合は全てのキャッシュを削除します。
+     *
+     * @param cacheKey キャッシュを一意に識別する文字列です。
+     * @param options オプションです。
+     */
+    clear(cacheKey?: string | undefined, options?: Omit<ClearOptions, "cacheKey"> | undefined): MaybePromise<void>;
+    /**
+     * キャッシュをクリアします。引数が指定された場合はそのキーのみ、指定されない場合は全てのキャッシュを削除します。
+     *
+     * @param options オプションです。
+     */
+    clear(options?: ClearOptions | undefined): MaybePromise<void>;
+    /**
+     * 指定したキーに対応するキャッシュハンドルを取得、または新規作成します。
+     *
+     * @param key キャッシュを一意に識別する文字列です。
+     * @returns ICacheHandle を実装したオブジェクトを返します。
+     */
+    createCacheHandle(key: string): ICacheHandle;
+}
+//# sourceMappingURL=cache-storage.d.ts.map

package/dist/cache-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-storage.d.ts","sourceRoot":"","sources":["../src/cache-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC3C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC3C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC3C,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAE5D;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAE9D;;;;;OAKG;IACH,KAAK,CACH,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,GAAG,SAAS,GACnD,YAAY,CAAC,IAAI,CAAC,CAAC;IAEtB;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAE9D;;;;;OAKG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC;CAC9C"}

package/dist/cache-storage.js

@@ -0,0 +1 @@
+export {};

package/dist/dl-once.d.ts

@@ -0,0 +1,242 @@
+/**
+ * 同期的な値、または Promise ライクな値を表す型です。
+ *
+ * @template T 解決される値の型です。
+ */
+export type MaybePromise<T> = T | PromiseLike<T>;
+/**
+ * ダウンロード開始前に実行されるハンドラーに渡される引数の型定義です。
+ */
+export type BeforeDownloadHandlerArgs = {
+    /**
+     * 実行されるリクエストオブジェクトです。
+     */
+    request: Request;
+    /**
+     * 中断を監視するためのシグナルです。
+     */
+    signal: AbortSignal;
+};
+/**
+ * データのチャンクが読み込まれた際に実行されるハンドラーに渡される引数の型定義です。
+ */
+export type ChunkReadHandlerArgs = {
+    /**
+     * 読み込まれたバイナリーデータです。
+     */
+    chunkData: Uint8Array<ArrayBuffer>;
+    /**
+     * サーバーからのレスポンスオブジェクトです。
+     */
+    response: Response;
+    /**
+     * 中断を監視するためのシグナルです。
+     */
+    signal: AbortSignal;
+};
+/**
+ * 処理が正常に終了した際に実行されるハンドラーに渡される引数の型定義です。
+ */
+export type CloseHandlerArgs = {
+    /**
+     * 中断を監視するためのシグナルです。
+     */
+    signal: AbortSignal;
+};
+/**
+ * エラーが発生した際に実行されるハンドラーに渡される引数の型定義です。
+ */
+export type ErrorHandlerArgs = {
+    /**
+     * エラーの原因となったオブジェクトです。
+     */
+    reason: unknown;
+    /**
+     * 中断を監視するためのシグナルです。
+     */
+    signal: AbortSignal;
+};
+/**
+ * ダウンロードの各フェーズで実行されるフック関数のインターフェースです。
+ */
+export interface IHook {
+    /**
+     * ダウンロード開始前に呼び出されます。
+     */
+    onBeforeDownload?(args: BeforeDownloadHandlerArgs): MaybePromise<void>;
+    /**
+     * チャンクデータが読み込まれるたびに呼び出されます。
+     */
+    onChunkRead?(args: ChunkReadHandlerArgs): MaybePromise<void>;
+    /**
+     * 正常終了時に呼び出されます。
+     */
+    onClose?(args: CloseHandlerArgs): MaybePromise<void>;
+    /**
+     * エラー発生時に呼び出されます。
+     */
+    onError?(args: ErrorHandlerArgs): MaybePromise<void>;
+}
+/**
+ * キャッシュリーダーを取得する際に渡される引数の型定義です。
+ */
+export type GetReaderArgs = {
+    /**
+     * 中断を監視するためのシグナルです。
+     */
+    signal: AbortSignal;
+};
+/**
+ * キャッシュからデータを読み出すためのリーダー型です。
+ *
+ * 同期または非同期の反復子として定義されます。
+ */
+export type IReader = IterableIterator<Uint8Array<ArrayBuffer>> | AsyncIterableIterator<Uint8Array<ArrayBuffer>>;
+/**
+ * キャッシュライターを取得する際に渡される引数の型定義です。
+ */
+export type GetWriterArgs = {
+    /**
+     * サーバーからのレスポンスオブジェクトです。
+     */
+    response: Response;
+    /**
+     * 実行されたリクエストオブジェクトです。
+     */
+    request: Request;
+    /**
+     * 中断を監視するためのシグナルです。
+     */
+    signal: AbortSignal;
+};
+/**
+ * キャッシュへデータを書き込むためのインターフェースです。
+ */
+export interface IWriter {
+    /**
+     * チャンクデータを書き込みます。
+     */
+    write(chunkData: Uint8Array<ArrayBuffer>): MaybePromise<void>;
+    /**
+     * 書き込みを完了し、リソースを閉じます。
+     */
+    close(): MaybePromise<void>;
+    /**
+     * 書き込みを中断します。
+     */
+    abort(reason: unknown): MaybePromise<void>;
+}
+/**
+ * キャッシュの読み書きを管理するハンドルのインターフェースです。
+ */
+export interface ICacheHandle {
+    /**
+     * 指定された条件でキャッシュリーダーを取得します。存在しない場合は null を返します。
+     */
+    getReader(args: GetReaderArgs): MaybePromise<IReader | null>;
+    /**
+     * 書き込み用のライターを取得します。
+     */
+    getWriter(args: GetWriterArgs): MaybePromise<IWriter>;
+}
+/**
+ * フェッチャーに渡される初期化オプションの型定義です。
+ */
+export type FetcherRequestInit = {
+    /**
+     * 中断を監視するためのシグナルです。
+     */
+    readonly signal: AbortSignal;
+};
+/**
+ * カスタムの HTTP リクエスト実行関数の型定義です。
+ */
+export interface IFetcher {
+    /**
+     * HTTP リクエストを実行し、レスポンスを返します。
+     *
+     * @param request リクエストオブジェクトです。
+     * @param init 初期化オプションです。
+     * @returns レスポンスまたはそれを解決する Promise です。
+     */
+    (request: Request, init: FetcherRequestInit | undefined): MaybePromise<Response>;
+}
+/**
+ * 単一のリクエストターゲットを表すプリミティブな型です。
+ */
+export type PrimitiveTarget = string | URL | Request;
+/**
+ * 動的にリクエストターゲットを生成するファクトリー関数の型定義です。
+ */
+export interface ITargetFactory {
+    (): MaybePromise<PrimitiveTarget>;
+}
+/**
+ * 解決可能なターゲットの型定義です。
+ */
+export type Target = PrimitiveTarget | ITargetFactory;
+/**
+ * JavaScript における Falsy な値の型定義です。
+ */
+export type Falsy = 0 | "" | false | null | undefined;
+/**
+ * 個別のダウンロード設定を定義する型です。
+ */
+export type Config = {
+    /**
+     * ダウンロード対象のターゲットです。
+     */
+    readonly target: Target;
+    /**
+     * 使用するキャッシュハンドルです。
+     */
+    readonly cacheHandle?: ICacheHandle | undefined;
+    /**
+     * キャッシュを無視して強制的にダウンロードするかどうかのフラグです。
+     */
+    readonly forceDownload?: boolean | undefined;
+    /**
+     * 適用されるフックのリストです。
+     */
+    readonly hooks?: readonly (IHook | Falsy)[] | undefined;
+    /**
+     * 使用するカスタムフェッチャーです。
+     */
+    readonly fetcher?: IFetcher | undefined;
+};
+/**
+ * 全体的なダウンロード動作を制御するオプションの型定義です。
+ */
+export type Options = {
+    /**
+     * デフォルトで使用するキャッシュハンドルです。
+     */
+    readonly cacheHandle?: ICacheHandle | undefined;
+    /**
+     * デフォルトでキャッシュを無視するかどうかのフラグです。
+     */
+    readonly forceDownload?: boolean | undefined;
+    /**
+     * グローバルに適用されるフックのリストです。
+     */
+    readonly hooks?: readonly (IHook | Falsy)[] | undefined;
+    /**
+     * デフォルトで使用するフェッチャーです。
+     */
+    readonly fetcher?: IFetcher | undefined;
+    /**
+     * 処理全体の中断を管理するシグナルです。
+     */
+    readonly signal?: AbortSignal | undefined;
+};
+/**
+ * 指定されたターゲットからデータを一度だけダウンロードし、バイナリーデータとして返します。
+ *
+ * キャッシュが利用可能な場合はキャッシュから取得を試み、失敗した場合はネットワーク経由で取得します。
+ *
+ * @param target ダウンロード対象（単体、設定オブジェクト、またはその配列）です。
+ * @param options ダウンロードの動作を制御するオプションです。
+ * @returns 取得されたバイナリーデータ（Uint8Array）を解決する Promise です。
+ */
+export default function downloadOnce(target: Target | Config | readonly (Target | Config)[], options?: Options | undefined): Promise<Uint8Array<ArrayBuffer>>;
+//# sourceMappingURL=dl-once.d.ts.map

package/dist/dl-once.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dl-once.d.ts","sourceRoot":"","sources":["../src/dl-once.ts"],"names":[],"mappings":"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"}