소스맵 업로드

npm install @sophonz/cli --save-dev

export SOPHONZ_TOKEN=sophonz_pat_...
 
npx @sophonz/cli upload-sourcemaps \
  --path dist \
  --web-version 2026.09.15-1

npx @sophonz/cli upload-sourcemaps \
  --path .next/static \
  --url-prefix _next/static \
  --web-version "$WEB_VERSION"

[sophonz] 8 source map(s) for web version 1.4.0 → https://app.sophonz.ai
  (dry run) _next/static/chunks/36o8zuzlzx381.js.map ← chunks/1-1m44t1taogc.js.map

npm install @sophonz/vite-sourcemap --save-dev

// vite.config.ts
import { defineConfig } from 'vite'
import sourcemapUpload from '@sophonz/vite-sourcemap'
 
export default defineConfig({
  build: {
    sourcemap: true, // 중요: 소스맵 생성을 활성화해야 합니다
  },
  plugins: [
    sourcemapUpload({
      endpoint: 'https://app.sophonz.ai/api/v1/web-sourcemaps',
      apiKey: process.env.SOPHONZ_TOKEN,
      // 웹 버전. SDK init의 appVersion과 같은 값
      appVersion: process.env.WEB_VERSION,
    }),
  ],
})

// vite.config.ts
import { defineConfig } from 'vite'
import sourcemapUpload from '@sophonz/vite-sourcemap'
 
export default defineConfig({
  build: {
    sourcemap: true,
  },
  plugins: [
    sourcemapUpload({
      endpoint: 'https://app.sophonz.ai/api/v1/web-sourcemaps',
      apiKey: process.env.SOPHONZ_TOKEN,
 
      // 웹 버전. 소스맵은 이 값으로 보관됩니다
      appVersion: process.env.WEB_VERSION,
      build: process.env.GIT_SHA,
 
      // 파일 필터링 (출력 디렉터리 기준 상대 경로에 적용)
      include: [/assets\/.+\.js\.map$/],
      exclude: [/node_modules/],
 
      // 스크립트가 제공되는 경로가 출력 디렉터리 구조와 다를 때
      urlPrefix: 'static/js',
 
      // 업로드 설정
      concurrency: 3,
      retries: 5,
      gzip: true,
      deleteAfterUpload: true,
 
      // CI에서만 실행
      ciOnly: true,
    }),
  ],
})

sourcemapUpload({
  endpoint: 'https://app.sophonz.ai/api/v1/web-sourcemaps',
  apiKey: process.env.SOPHONZ_TOKEN,
  appVersion: process.env.WEB_VERSION,
  bundle: true,
  bundleFilename: 'sourcemaps.tar.gz',
})

POST https://app.sophonz.ai/api/v1/web-sourcemaps
Authorization: Bearer sophonz_pat_...
Content-Type: multipart/form-data

{
  "ok": true,
  "key": "sourcemaps/<orgId>/<projectId>/<appId>/web/1.4.0/assets/app.js.map",
  "app": "next-sample",
  "serviceNamespace": "sophonz",
  "release": "unreleased",
  "version": "1.4.0",
  "bundle": false,
  "fileCount": null
}

# .github/workflows/deploy.yml
name: Deploy
 
on:
  push:
    branches: [main]
 
jobs:
  build:
    runs-on: ubuntu-latest
    env:
      WEB_VERSION: ${{ github.run_number }}-${{ github.sha }}
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
      - run: npm ci
      - name: Build
        # 앱 코드에서 이 값을 Sophonz.init({ appVersion })으로 넘깁니다
        env:
          NEXT_PUBLIC_WEB_VERSION: ${{ env.WEB_VERSION }}
        run: npm run build
      - name: Upload source maps
        env:
          SOPHONZ_TOKEN: ${{ secrets.SOPHONZ_TOKEN }}
        run: npx @sophonz/cli upload-sourcemaps --path .next/static --url-prefix _next/static --web-version "$WEB_VERSION"