Puter

이 오류는 Windows에서 puter.com v2.5.1을 사용할 때 발생합니다. 확장 로더가 필수 file:// 접두사 없이 절대 Windows 경로(예: 'c:\\...')를 사용하기 때문이며, 이는 Node.js ESM 로더가 거부합니다. 해결 방법: Node.js를 --experimental-specifier-resolution=node 플래그와 함께 실행합니다. package.json에서 시작 스크립트를 수정하거나 직접 실행합니다: 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']
    }
  }
});