@aiquants/duckdb-helper 1.6.4 → 1.6.6

package/docs/specs/2026.04.11 [AI] 06-build-config.md

@@ -117,7 +117,7 @@ export default defineConfig({
 
 | スクリプト | コマンド | 説明 |
 | --- | --- | --- |
-| `build` | `tsup` | ビルド実行 |
+| `build` | `tsup && node scripts/copy-assets.js` | ビルド実行および DuckDB-Wasm のアセットを dist/assets にコピー |
 | `build:watch` | `tsup --watch` | ファイル変更時に自動リビルド |
 | `dev` | `tsup --watch` | 開発用（build:watch と同一） |
 | `watch` | `tsup --watch` | ウォッチモード |
@@ -168,14 +168,19 @@ npm に公開されるファイル。`src/` はパッケージに含まれない
 
 ## 5. ビルド成果物の構成
 
-```
+```text
 dist/
 ├── index.js        # CommonJS バンドル（require() 用）
 ├── index.mjs       # ESM バンドル（import 用）
 ├── index.d.ts      # TypeScript 型定義
 ├── index.d.mts     # ESM 用 TypeScript 型定義
 ├── index.js.map    # CommonJS ソースマップ
-└── index.mjs.map   # ESM ソースマップ
+├── index.mjs.map   # ESM ソースマップ
+└── assets/         # 同梱される DuckDB-Wasm アセット
+    ├── duckdb-mvp.wasm
+    ├── duckdb-browser-mvp.worker.js
+    ├── duckdb-eh.wasm
+    └── duckdb-browser-eh.worker.js
 ```
 
 ## 6. 新人向けポイント
@@ -186,3 +191,4 @@ dist/
 4. **`external` に指定されたパッケージはバンドルに含まれない**。利用側でインストールが必要。
 5. **ビルドは tsup（esbuild ベース）が行い、tsc は型チェック専用**。この分業により高速ビルドと厳密な型チェックを両立。
 6. **`src/` は npm パッケージに含まれない**。利用者が見るのは `dist/` のビルド済みコードのみ。
+7. **WASM/Worker アセットのローカル自動配信**: パッケージ同梱された DuckDB-Wasm アセットは、フロントエンドアプリ側の起動・ビルドプロセス（Vite プラグイン）により `public/assets/duckdb/` に自動コピーされ、ローカル配信（ `/assets/duckdb/...` ）として利用される。これによりネットワーク競合やデッドロックが防止される。

package/docs/specs/2026.07.05 [AI] 07-testing.md

@@ -1,8 +1,8 @@
 # テスト仕様書
 
-> 対象: `@aiquants/duckdb-helper` v1.6.0
+> 対象: `@aiquants/duckdb-helper`
 > テストソース: `tests/**`
-> 作成: 2026-07-05
+> 更新: 2026-07-22（v1.6.3 の splink_udfs インストールタイムアウトテスト追加に伴う更新）
 
 ## 1. 目的とスコープ
 
@@ -62,6 +62,7 @@ DuckDB-WASM は実際の Worker と WASM ダウンロードを伴うため、単
 | 高速パス | 初期化済みなら Worker を作り直さない | |
 | 同時呼び出しの重複排除 | 2 回同時呼び出しでも Worker は 1 つ | |
 | splink 失敗時の続行 | 拡張ロード失敗でも `ready`、一時コネクションは close | |
+| splink ハング時のタイムアウト | 10秒経過でタイムアウトして `ready`、一時コネクションは close | |
 | **instantiate 失敗 → 再試行可能** | `error` に遷移し `isReady() === false`、Worker terminate + Blob URL revoke、その後 `initialize()` で復旧 | 初期化復旧不能（High） |
 | 非 Error の reject | 文字列 reject でも `error` に遷移 | |
 | Worker 生成前の失敗 | `selectBundle` reject で Worker/URL 未生成のまま `error` | |
@@ -165,7 +166,7 @@ DuckDB-WASM は実際の Worker と WASM ダウンロードを伴うため、単
 
 ## 6. カバレッジ結果
 
-`pnpm run test:coverage` の結果（v1.6.0 時点、88 テスト）:
+`pnpm run test:coverage` の結果（6 ファイル / 89 テスト）:
 
 | File | % Stmts | % Branch | % Funcs | % Lines |
 | --- | --- | --- | --- | --- |
@@ -182,3 +183,4 @@ DuckDB-WASM は実際の Worker と WASM ダウンロードを伴うため、単
 
 - 本テストは**単体テスト**であり、実 DuckDB-WASM / 実 Worker を用いた結合は対象外（実 SQL の意味的正しさ、例えば `BEGIN/COMMIT` のトランザクション意味論は DuckDB 側の責務）。
 - `types/duckdb.ts` は型のみでランタイムコードを持たないためカバレッジ対象から除外。
+- **アセットコピーとローカル解決の検証**: パッケージ同梱用スクリプト（ `copy-assets.js` ）の動作や Vite プラグイン（ `copyDuckDBAssetsPlugin` ）によるコピー処理は、単体テストのモック環境ではなく、パッケージのビルド検証ステップ（ `pnpm run build` ）およびアプリ側のビルド検証において、 `dist/assets` や `public/assets/duckdb` への実アセット配置状況をファイルチェックすることで検証する。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiquants/duckdb-helper",
-  "version": "1.6.4",
+  "version": "1.6.6",
   "description": "DuckDB helper utilities with React hooks, worker initialization, and typed query helpers",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -69,7 +69,7 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && node scripts/copy-assets.js",
     "build:watch": "tsup --watch",
     "dev": "tsup --watch",
     "watch": "tsup --watch",