Puter

このエラーは、Windows上のputer.com v2.5.1で発生します。これは、拡張ローダーが必須のfile://プレフィックスなしで絶対Windowsパス（例：'c:\\...'）を使用しており、Node.jsのESMローダーが拒否するためです。回避策：Node.jsを--experimental-specifier-resolution=nodeフラグ付きで実行してください。package.jsonのstartスクリプトを修正するか、直接実行します：node --enable-source-maps --experimental-specifier-resolution=node -r ./dist/src/backend/telemetry.js ./dist/src/backend/index.js。あるいは、拡張ローディングコードにパッチを適用し、絶対パスをfile://URLに変換します。恒久的な修正：Windowsのパスを正しく処理する新しいバージョンのputer.comにアップデートしてください。

エラーは、@heyputer/puter.js の Node 互換バンドル（socket.io‑client の .unref() を使用）がクライアント側で読み込まれるために発生します。クライアント専用プラグインを使用して、Nuxt にブラウザビルドを強制的に使わせます：

1. plugins/puter.client.ts を作成：

export default defineNuxtPlugin(async (nuxtApp) => {
  const mod = await import('@heyputer/puter.js/dist/puter.js'); // browser bundle
  const puter = mod.puter ?? mod.default ?? mod;
  nuxtApp.provide('puter', puter);
});

export default defineNuxtConfig({
  ssr: false, // ensure client‑side only
  vite: {
    optimizeDeps: {
      exclude: ['@heyputer/puter.js']
    }
  }
});