opensoma 0.5.0 → 0.5.1

package/src/client.test.ts

@@ -1,4 +1,4 @@
-import { afterEach, describe, expect, mock, test } from 'bun:test'
+import { afterEach, describe, expect, it, mock } from 'bun:test'
 import { mkdtemp } from 'node:fs/promises'
 import { tmpdir } from 'node:os'
 import { join } from 'node:path'
@@ -7,31 +7,80 @@ import { SomaClient } from './client'
 import { MENU_NO } from './constants'
 import { CredentialManager } from './credential-manager'
 import { AuthenticationError } from './errors'
-import type { SomaHttp } from './http'
+import { SomaHttp, type UserIdentity } from './http'
 
 afterEach(() => {
   mock.restore()
 })
 
+type HttpCall = { method: string; path: string; data: Record<string, string> | undefined }
+
+interface FakeHttpConfig {
+  identity?: UserIdentity | null
+  getBody?: (path: string, data?: Record<string, string>) => string
+  postBody?: (path: string, data: Record<string, string>) => string
+  postFormBody?: (path: string, data: Record<string, string>) => string
+  sessionCookie?: string
+  csrfToken?: string | null
+  onLogin?: (username: string, password: string) => void
+  onLogout?: () => void
+  checkLoginSequence?: Array<UserIdentity | null>
+}
+
+function createFakeHttp(config: FakeHttpConfig = {}): { http: SomaHttp; calls: HttpCall[] } {
+  const calls: HttpCall[] = []
+  const sequence = config.checkLoginSequence ? [...config.checkLoginSequence] : null
+
+  const fake = {
+    checkLogin: async () => {
+      if (sequence) {
+        return sequence.shift() ?? config.identity ?? null
+      }
+      return config.identity ?? null
+    },
+    get: async (path: string, data?: Record<string, string>) => {
+      calls.push({ method: 'get', path, data })
+      return config.getBody ? config.getBody(path, data) : ''
+    },
+    post: async (path: string, data: Record<string, string>) => {
+      calls.push({ method: 'post', path, data })
+      return config.postBody ? config.postBody(path, data) : ''
+    },
+    postForm: async (path: string, data: Record<string, string>) => {
+      calls.push({ method: 'postForm', path, data })
+      return config.postFormBody ? config.postFormBody(path, data) : ''
+    },
+    postMultipart: async () => '',
+    login: async (username: string, password: string) => {
+      config.onLogin?.(username, password)
+    },
+    logout: async () => {
+      config.onLogout?.()
+    },
+    getSessionCookie: () => config.sessionCookie,
+    getCsrfToken: () => config.csrfToken ?? null,
+  }
+
+  return { http: fake as unknown as SomaHttp, calls }
+}
+
 describe('SomaClient', () => {
-  test('constructor initializes SomaHttp with provided session state', () => {
+  it('exposes session state passed through options', () => {
     const client = new SomaClient({ sessionCookie: 'session-1', csrfToken: 'csrf-1' })
-    const http = Reflect.get(client, 'http') as SomaHttp
 
-    expect(http.getSessionCookie()).toBe('session-1')
-    expect(http.getCsrfToken()).toBe('csrf-1')
+    expect(client.getSessionData()).toEqual({
+      sessionCookie: 'session-1',
+      csrfToken: 'csrf-1',
+    })
   })
 
-  test('mentoring list calls GET and parses list plus pagination', async () => {
-    const client = new SomaClient()
-    const calls: Array<{ method: string; path: string; data: Record<string, string> | undefined }> = []
-    Reflect.set(client, 'http', {
-      checkLogin: async () => ({ userId: 'user@example.com', userNm: 'Test' }),
-      get: async (path: string, data?: Record<string, string>) => {
-        calls.push({ method: 'get', path, data })
-        return '<table><tbody><tr><td>1</td><td><a href="/sw/mypage/mentoLec/view.do?qustnrSn=123">[자유 멘토링] 제목 [접수중]</a></td><td>2026-04-01 ~ 2026-04-02</td><td>2026-04-03(목) 10:00 ~ 11:00</td><td>1 /4</td><td>OK</td><td>[접수중]</td><td>작성자</td><td>2026-04-01</td></tr></tbody></table><ul class="bbs-total"><li>Total : 1</li><li>1/1 Page</li></ul>'
-      },
+  it('lists mentoring sessions with parsed items and pagination', async () => {
+    const { http, calls } = createFakeHttp({
+      identity: { userId: 'user@example.com', userNm: 'Test' },
+      getBody: () =>
+        '<table><tbody><tr><td>1</td><td><a href="/sw/mypage/mentoLec/view.do?qustnrSn=123">[자유 멘토링] 제목 [접수중]</a></td><td>2026-04-01 ~ 2026-04-02</td><td>2026-04-03(목) 10:00 ~ 11:00</td><td>1 /4</td><td>OK</td><td>[접수중]</td><td>작성자</td><td>2026-04-01</td></tr></tbody></table><ul class="bbs-total"><li>Total : 1</li><li>1/1 Page</li></ul>',
     })
+    const client = new SomaClient({ http })
 
     const result = await client.mentoring.list({ status: 'open', type: 'public', page: 2 })
 
@@ -51,41 +100,34 @@ describe('SomaClient', () => {
     expect(result.pagination).toEqual({ total: 1, currentPage: 1, totalPages: 1 })
   })
 
-  test('mentoring get calls detail endpoint and parser', async () => {
-    const client = new SomaClient()
-    let captured: { path: string; data: Record<string, string> | undefined } | undefined
-    Reflect.set(client, 'http', {
-      checkLogin: async () => ({ userId: 'user@example.com', userNm: 'Test' }),
-      get: async (path: string, data?: Record<string, string>) => {
-        captured = { path, data }
-        return '<input type="hidden" name="qustnrSn" value="99"><table><tr><th>모집 명</th><td>상세</td><th>상태</th><td>접수중</td></tr><tr><th>접수 기간</th><td>2026-04-01 ~ 2026-04-02</td><th>강의날짜</th><td>2026-04-03(목) 10:00 ~ 11:00</td></tr><tr><th>장소</th><td>온라인(Webex)</td><th>모집인원</th><td>4명</td></tr><tr><th>작성자</th><td>작성자</td><th>등록일</th><td>2026-04-01</td></tr></table><div data-content><p>본문</p></div>'
-      },
+  it('fetches a single mentoring session from the detail endpoint', async () => {
+    const { http, calls } = createFakeHttp({
+      identity: { userId: 'user@example.com', userNm: 'Test' },
+      getBody: () =>
+        '<input type="hidden" name="qustnrSn" value="99"><table><tr><th>모집 명</th><td>상세</td><th>상태</th><td>접수중</td></tr><tr><th>접수 기간</th><td>2026-04-01 ~ 2026-04-02</td><th>강의날짜</th><td>2026-04-03(목) 10:00 ~ 11:00</td></tr><tr><th>장소</th><td>온라인(Webex)</td><th>모집인원</th><td>4명</td></tr><tr><th>작성자</th><td>작성자</td><th>등록일</th><td>2026-04-01</td></tr></table><div data-content><p>본문</p></div>',
     })
+    const client = new SomaClient({ http })
 
     const result = await client.mentoring.get(99)
 
-    expect(captured).toEqual({
-      path: '/mypage/mentoLec/view.do',
-      data: { menuNo: MENU_NO.MENTORING, qustnrSn: '99' },
-    })
+    expect(calls).toEqual([
+      {
+        method: 'get',
+        path: '/mypage/mentoLec/view.do',
+        data: { menuNo: MENU_NO.MENTORING, qustnrSn: '99' },
+      },
+    ])
     expect(result).toMatchObject({ id: 99, title: '상세', venue: '온라인(Webex)' })
   })
 
-  test('mutating operations post expected payloads', async () => {
+  it('posts the expected payloads for create, update, delete, apply, cancel, reserve, and event apply', async () => {
     const mentoringDetailHtml =
       '<div class="group"><strong class="t">모집 명</strong><div class="c">[자유 멘토링] 기존 멘토링</div></div><div class="group"><strong class="t">접수 기간</strong><div class="c">2026.03.01 ~ 2026.03.15</div></div><div class="group"><strong class="t">강의날짜</strong><div class="c"><span>2026.03.20 10:00시 ~ 12:00시</span></div></div><div class="group"><strong class="t">장소</strong><div class="c">온라인(Webex)</div></div><div class="group"><strong class="t">모집인원</strong><div class="c">5명</div></div><div class="group"><strong class="t">작성자</strong><div class="c">전수열</div></div><div class="group"><strong class="t">등록일</strong><div class="c">2026.03.01</div></div><div class="cont"><p>기존 내용</p></div>'
-    const client = new SomaClient()
-    const calls: Array<{ method: string; path: string; data: Record<string, string> }> = []
-    const captor = (method: string) => async (path: string, data: Record<string, string>) => {
-      calls.push({ method, path, data })
-      return ''
-    }
-    Reflect.set(client, 'http', {
-      checkLogin: async () => ({ userId: 'user@example.com', userNm: 'Test' }),
-      get: async () => mentoringDetailHtml,
-      post: captor('post'),
-      postForm: captor('postForm'),
+    const { http, calls } = createFakeHttp({
+      identity: { userId: 'user@example.com', userNm: 'Test' },
+      getBody: () => mentoringDetailHtml,
     })
+    const client = new SomaClient({ http })
 
     await client.mentoring.create({
       title: '새 멘토링',
@@ -115,7 +157,8 @@ describe('SomaClient', () => {
     })
     await client.event.apply(11)
 
-    expect(calls.map((call) => `${call.method}:${call.path}`)).toEqual([
+    const writes = calls.filter((call) => call.method !== 'get')
+    expect(writes.map((call) => `${call.method}:${call.path}`)).toEqual([
       'postForm:/mypage/mentoLec/insert.do',
       'postForm:/mypage/mentoLec/update.do',
       'post:/mypage/mentoLec/delete.do',
@@ -124,41 +167,41 @@ describe('SomaClient', () => {
       'post:/mypage/itemRent/insert.do',
       'post:/application/application/application.do',
     ])
-    expect(calls[0]?.data).toMatchObject({
+    expect(writes[0]?.data).toMatchObject({
       menuNo: MENU_NO.MENTORING,
       reportCd: 'MRC020',
       qustnrSj: '새 멘토링',
     })
-    expect(calls[1]?.data).toMatchObject({
+    expect(writes[1]?.data).toMatchObject({
       menuNo: MENU_NO.MENTORING,
       reportCd: 'MRC010',
       qustnrSj: '수정된 멘토링',
       qustnrSn: '42',
     })
-    expect(calls[2]?.data).toEqual({
+    expect(writes[2]?.data).toEqual({
       menuNo: MENU_NO.MENTORING,
       qustnrSn: '7',
       pageQueryString: '',
     })
-    expect(calls[3]?.data).toEqual({
+    expect(writes[3]?.data).toEqual({
       menuNo: MENU_NO.EVENT,
       qustnrSn: '8',
       applyGb: 'C',
       stepHeader: '0',
     })
-    expect(calls[4]?.data).toEqual({
+    expect(writes[4]?.data).toEqual({
       menuNo: MENU_NO.APPLICATION_HISTORY,
       applySn: '9',
       qustnrSn: '10',
     })
-    expect(calls[5]?.data).toMatchObject({
+    expect(writes[5]?.data).toMatchObject({
       menuNo: MENU_NO.ROOM,
       itemId: '17',
       title: '회의',
       'time[0]': '10:00',
       'time[1]': '10:30',
     })
-    expect(calls[6]?.data).toEqual({
+    expect(writes[6]?.data).toEqual({
       menuNo: MENU_NO.EVENT,
       qustnrSn: '11',
       applyGb: 'C',
@@ -166,22 +209,18 @@ describe('SomaClient', () => {
     })
   })
 
-  test('mentoring.update merges partial params with existing data', async () => {
+  it('merges partial update params with the existing mentoring data', async () => {
     const mentoringDetailHtml =
       '<div class="group"><strong class="t">모집 명</strong><div class="c">[멘토 특강] 웹 성능 특강</div></div><div class="group"><strong class="t">접수 기간</strong><div class="c">2026.04.01 ~ 2026.04.10</div></div><div class="group"><strong class="t">강의날짜</strong><div class="c"><span>2026.04.11 14:00시 ~ 15:30시</span></div></div><div class="group"><strong class="t">장소</strong><div class="c">온라인(Webex)</div></div><div class="group"><strong class="t">모집인원</strong><div class="c">20명</div></div><div class="group"><strong class="t">작성자</strong><div class="c">전수열</div></div><div class="group"><strong class="t">등록일</strong><div class="c">2026.04.01</div></div><div class="cont"><p>세션 본문</p></div>'
-    const client = new SomaClient()
-    const postFormCalls: Array<{ path: string; data: Record<string, string> }> = []
-    Reflect.set(client, 'http', {
-      checkLogin: async () => ({ userId: 'user@example.com', userNm: 'Test' }),
-      get: async () => mentoringDetailHtml,
-      postForm: async (path: string, data: Record<string, string>) => {
-        postFormCalls.push({ path, data })
-        return ''
-      },
+    const { http, calls } = createFakeHttp({
+      identity: { userId: 'user@example.com', userNm: 'Test' },
+      getBody: () => mentoringDetailHtml,
     })
+    const client = new SomaClient({ http })
 
     await client.mentoring.update(9572, { title: '변경된 제목' })
 
+    const postFormCalls = calls.filter((c) => c.method === 'postForm')
     expect(postFormCalls).toHaveLength(1)
     expect(postFormCalls[0]?.data).toMatchObject({
       qustnrSj: '변경된 제목',
@@ -198,13 +237,10 @@ describe('SomaClient', () => {
     })
   })
 
-  test('room, dashboard, notice, team, member, event, and history routes use expected endpoints', async () => {
-    const client = new SomaClient()
-    const calls: Array<{ method: string; path: string; data: Record<string, string> | undefined }> = []
-    Reflect.set(client, 'http', {
-      checkLogin: async () => ({ userId: 'neo@example.com', userNm: '전수열' }),
-      get: async (path: string, data?: Record<string, string>) => {
-        calls.push({ method: 'get', path, data })
+  it('routes room, dashboard, notice, team, member, event, and history calls to the expected endpoints', async () => {
+    const { http, calls } = createFakeHttp({
+      identity: { userId: 'neo@example.com', userNm: '전수열' },
+      getBody: (path) => {
         if (path === '/mypage/myMain/dashboard.do') {
           return '<ul class="dash-top"><li class="dash-card"><div class="dash-etc"><span>소속 :<br> Indent</span><span>직책 :<br> </span></div><div class="dash-state"><div class="top"><span class="bg-orange label"><span>멘토</span></span><div class="welcome"><strong>전수열</strong>님 안녕하세요.</div></div></div></li></ul><ul class="bbs-dash_w"><li>멘토링 · 멘토특강<li><a href="/sw/mypage/mentoLec/view.do?qustnrSn=9582">게임 개발 AI 활용법 접수중</a></li></li></ul>'
         }
@@ -231,14 +267,14 @@ describe('SomaClient', () => {
         }
         return '<table><tbody><tr><td>1</td><td>멘토 특강</td><td><a href="/sw/mypage/mentoLec/view.do?qustnrSn=1">접수내역</a></td><td>전수열</td><td>2026.04.11</td><td>2026-04-01</td><td>[신청완료]</td><td>[OK]</td><td>승인대기</td><td>-</td></tr></tbody></table><ul class="bbs-total"><li>Total : 1</li><li>1/1 Page</li></ul>'
       },
-      post: async (path: string, data: Record<string, string>) => {
-        calls.push({ method: 'post', path, data })
+      postBody: (path) => {
         if (path === '/mypage/officeMng/rentTime.do') {
           return '<span class="ck-st2 disabled" data-hour="09" data-minute="00"><input type="checkbox" disabled="disabled"><label title="아침 회의&lt;br&gt;예약자 : 김오픈">오전 09:00</label></span>'
         }
         return '<ul class="bbs-reserve"><li class="item"><a href="javascript:void(0);" onclick="location.href=\'/sw/mypage/officeMng/view.do?itemId=17\';"><div class="cont"><h4 class="tit">스페이스 A1</h4><ul class="txt bul-dot grey"><li>이용기간 : 2026-04-01 ~ 2026-12-31</li><li><p>설명 : 4인</p></li><li class="time-list"><div class="time-grid"><span>09:00</span></div></li></ul></div></a></li></ul>'
       },
     })
+    const client = new SomaClient({ http })
 
     const roomList = await client.room.list({ date: '2026-04-01', room: 'A1', includeReservations: true })
     const roomSlots = await client.room.available(17, '2026-04-01')
@@ -289,8 +325,7 @@ describe('SomaClient', () => {
       note: '-',
     })
 
-    const dashboardCallIndex = calls.findIndex((c) => c.path === '/mypage/myMain/dashboard.do')
-    expect(dashboardCallIndex).toBeGreaterThanOrEqual(0)
+    expect(calls.some((c) => c.path === '/mypage/myMain/dashboard.do')).toBe(true)
     expect(calls).toContainEqual({
       method: 'post',
       path: '/mypage/officeMng/rentTime.do',
@@ -305,53 +340,44 @@ describe('SomaClient', () => {
     })
   })
 
-  test('login and isLoggedIn delegate to SomaHttp', async () => {
-    const client = new SomaClient({ username: 'neo@example.com', password: 'secret' })
-    const calls: string[] = []
-    Reflect.set(client, 'http', {
-      login: async (username: string, password: string) => {
-        calls.push(`${username}:${password}`)
-      },
-      checkLogin: async () => ({ userId: 'neo@example.com', userNm: '전수열' }),
+  it('delegates login and isLoggedIn to SomaHttp', async () => {
+    const loginCalls: string[] = []
+    const { http } = createFakeHttp({
+      identity: { userId: 'neo@example.com', userNm: '전수열' },
+      onLogin: (username, password) => loginCalls.push(`${username}:${password}`),
     })
+    const client = new SomaClient({ username: 'neo@example.com', password: 'secret', http })
 
     await client.login()
 
-    expect(calls).toEqual(['neo@example.com:secret'])
+    expect(loginCalls).toEqual(['neo@example.com:secret'])
     await expect(client.isLoggedIn()).resolves.toBe(true)
   })
 
-  test('auth-required operations re-login automatically when username/password are configured', async () => {
-    const client = new SomaClient({ username: 'neo@example.com', password: 'secret' })
-    const calls: string[] = []
-    let authChecks = 0
-    Reflect.set(client, 'http', {
-      checkLogin: async () => {
-        authChecks += 1
-        return authChecks >= 2 ? { userId: 'neo@example.com', userNm: '전수열' } : null
-      },
-      login: async (username: string, password: string) => {
-        calls.push(`${username}:${password}`)
-      },
-      get: async () =>
+  it('re-logs in automatically when username and password are configured', async () => {
+    const loginCalls: string[] = []
+    const { http } = createFakeHttp({
+      checkLoginSequence: [null, { userId: 'neo@example.com', userNm: '전수열' }],
+      onLogin: (username, password) => loginCalls.push(`${username}:${password}`),
+      getBody: () =>
         '<table><tbody><tr><td>1</td><td><a href="/sw/mypage/mentoLec/view.do?qustnrSn=123">[자유 멘토링] 제목 [접수중]</a></td><td>2026-04-01 ~ 2026-04-02</td><td>2026-04-03(목) 10:00 ~ 11:00</td><td>1 /4</td><td>OK</td><td>[접수중]</td><td>작성자</td><td>2026-04-01</td></tr></tbody></table><ul class="bbs-total"><li>Total : 1</li><li>1/1 Page</li></ul>',
     })
+    const client = new SomaClient({ username: 'neo@example.com', password: 'secret', http })
 
     await expect(client.mentoring.list()).resolves.toMatchObject({
       items: [expect.objectContaining({ id: 123, title: '제목' })],
     })
-    expect(calls).toEqual(['neo@example.com:secret'])
+    expect(loginCalls).toEqual(['neo@example.com:secret'])
   })
 
-  test('saveCredentials persists the credentials used by login()', async () => {
-    const client = new SomaClient()
+  it('persists the credentials used by login() when saveCredentials is called', async () => {
     const dir = await mkdtemp(join(tmpdir(), 'opensoma-client-save-'))
     const manager = new CredentialManager(dir)
-    Reflect.set(client, 'http', {
-      login: async () => {},
-      getSessionCookie: () => 'session-1',
-      getCsrfToken: () => 'csrf-1',
+    const { http } = createFakeHttp({
+      sessionCookie: 'session-1',
+      csrfToken: 'csrf-1',
     })
+    const client = new SomaClient({ http })
 
     await client.login('neo@example.com', 'secret')
     await client.saveCredentials(manager)
@@ -367,25 +393,19 @@ describe('SomaClient', () => {
     await manager.remove()
   })
 
-  test('logout delegates to SomaHttp', async () => {
-    const client = new SomaClient()
-    const calls: string[] = []
-    Reflect.set(client, 'http', {
-      logout: async () => {
-        calls.push('logout')
-      },
-    })
+  it('delegates logout to SomaHttp', async () => {
+    const logoutCalls: string[] = []
+    const { http } = createFakeHttp({ onLogout: () => logoutCalls.push('logout') })
+    const client = new SomaClient({ http })
 
     await client.logout()
 
-    expect(calls).toEqual(['logout'])
+    expect(logoutCalls).toEqual(['logout'])
   })
 
-  test('auth-required operations throw AuthenticationError when not logged in', async () => {
-    const client = new SomaClient()
-    Reflect.set(client, 'http', {
-      checkLogin: async () => null,
-    })
+  it('throws AuthenticationError from every auth-required operation when not logged in', async () => {
+    const { http } = createFakeHttp({ identity: null })
+    const client = new SomaClient({ http })
 
     await expect(client.mentoring.list()).rejects.toBeInstanceOf(AuthenticationError)
     await expect(client.mentoring.get(1)).rejects.toBeInstanceOf(AuthenticationError)
@@ -428,11 +448,9 @@ describe('SomaClient', () => {
     await expect(client.event.apply(1)).rejects.toBeInstanceOf(AuthenticationError)
   })
 
-  test('AuthenticationError has helpful message', async () => {
-    const client = new SomaClient()
-    Reflect.set(client, 'http', {
-      checkLogin: async () => null,
-    })
+  it('includes helpful login hints in the AuthenticationError message', async () => {
+    const { http } = createFakeHttp({ identity: null })
+    const client = new SomaClient({ http })
 
     try {
       await client.mentoring.list()

package/src/client.ts

@@ -46,6 +46,8 @@ export interface SomaClientOptions {
   username?: string
   password?: string
   verbose?: boolean
+  /** @internal */
+  http?: SomaHttp
 }
 
 export class SomaClient {
@@ -109,7 +111,7 @@ export class SomaClient {
       searchKeyword?: string
     }): Promise<{ items: ReportListItem[]; pagination: Pagination }>
     get(id: number): Promise<ReportDetail>
-    create(options: ReportCreateOptions, file: Buffer | string, fileName?: string): Promise<void>
+    create(options: ReportCreateOptions, files: Array<{ buffer: Buffer; name: string }>): Promise<void>
     update(
       id: number,
       options: Omit<ReportUpdateOptions, 'id'>,
@@ -141,11 +143,13 @@ export class SomaClient {
     this.options = options
     this.loginCredentials =
       options.username && options.password ? { username: options.username, password: options.password } : null
-    this.http = new SomaHttp({
-      sessionCookie: options.sessionCookie,
-      csrfToken: options.csrfToken,
-      verbose: options.verbose,
-    })
+    this.http =
+      options.http ??
+      new SomaHttp({
+        sessionCookie: options.sessionCookie,
+        csrfToken: options.csrfToken,
+        verbose: options.verbose,
+      })
 
     this.mentoring = {
       list: async (options) => {
@@ -344,7 +348,7 @@ export class SomaClient {
         })
         return formatters.parseReportDetail(html, id)
       },
-      create: async (options, file, fileName) => {
+      create: async (options, files) => {
         await this.requireAuth()
         const payload = buildReportPayload({
           menteeRegion: options.menteeRegion,
@@ -369,11 +373,11 @@ export class SomaClient {
         for (const [key, value] of Object.entries(payload)) {
           formData.append(key, value)
         }
-        const isBuffer = Buffer.isBuffer(file)
-        const fileBuffer = isBuffer ? file : await readFile(file)
-        const resolvedFileName = isBuffer ? (fileName ?? 'file') : (file.split('/').pop() ?? 'file')
-        const uint8Array = new Uint8Array(fileBuffer.buffer, fileBuffer.byteOffset, fileBuffer.byteLength)
-        formData.append('file_1_1', new Blob([uint8Array as unknown as ArrayBuffer]), resolvedFileName)
+        for (let i = 0; i < files.length; i++) {
+          const { buffer, name } = files[i]
+          const uint8Array = new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength)
+          formData.append(`file_1_${i + 1}`, new Blob([uint8Array as unknown as ArrayBuffer]), name)
+        }
         formData.append('fileFieldNm_1', 'file_1')
         formData.append('atchFileId', '')
         await this.http.postMultipart('/mypage/mentoringReport/insert.do', formData)

package/src/commands/auth.test.ts

@@ -1,11 +1,11 @@
-import { describe, expect, test } from 'bun:test'
+import { describe, expect, it } from 'bun:test'
 
 import { inspectStoredAuthStatus, resolveExtractedCredentials } from './auth'
 
 const noBrowserExtraction = async () => null
 
 describe('resolveExtractedCredentials', () => {
-  test('returns the first candidate that validates successfully', async () => {
+  it('returns the first candidate that validates successfully', async () => {
     const calls: string[] = []
 
     const credentials = await resolveExtractedCredentials(
@@ -32,7 +32,7 @@ describe('resolveExtractedCredentials', () => {
     expect(calls).toEqual(['check:stale-session', 'check:valid-session', 'csrf:valid-session'])
   })
 
-  test('returns null when every candidate is invalid or throws', async () => {
+  it('returns null when every candidate is invalid or throws', async () => {
     const credentials = await resolveExtractedCredentials(
       [
         { browser: 'Chrome', lastAccessUtc: 30, profile: 'Default', sessionCookie: 'stale-session' },
@@ -57,7 +57,7 @@ describe('resolveExtractedCredentials', () => {
 })
 
 describe('inspectStoredAuthStatus', () => {
-  test('clears stale credentials when both recovery methods fail', async () => {
+  it('clears stale credentials when both recovery methods fail', async () => {
     let removed = false
 
     const status = await inspectStoredAuthStatus(
@@ -90,7 +90,7 @@ describe('inspectStoredAuthStatus', () => {
     expect(removed).toBe(true)
   })
 
-  test('preserves credentials when session verification fails unexpectedly', async () => {
+  it('preserves credentials when session verification fails unexpectedly', async () => {
     let removed = false
 
     const status = await inspectStoredAuthStatus(
@@ -125,7 +125,7 @@ describe('inspectStoredAuthStatus', () => {
     expect(removed).toBe(false)
   })
 
-  test('recovers via browser extraction when no stored password is available', async () => {
+  it('recovers via browser extraction when no stored password is available', async () => {
     let savedCredentials: Record<string, unknown> | null = null
 
     const status = await inspectStoredAuthStatus(
@@ -160,7 +160,7 @@ describe('inspectStoredAuthStatus', () => {
     expect(savedCredentials).toHaveProperty('loggedInAt')
   })
 
-  test('refreshes the session automatically when encrypted login credentials are available', async () => {
+  it('refreshes the session automatically when stored username and password are available', async () => {
     let savedCredentials: Record<string, string> | null = null
 
     const status = await inspectStoredAuthStatus(

package/src/commands/helpers.test.ts

@@ -1,11 +1,11 @@
-import { describe, expect, test } from 'bun:test'
+import { describe, expect, it } from 'bun:test'
 
 import { createAuthenticatedHttp } from './helpers'
 
 const noBrowserExtraction = async () => null
 
 describe('createAuthenticatedHttp', () => {
-  test('throws a login hint when no credentials are stored', async () => {
+  it('throws a login hint when no credentials are stored', async () => {
     const manager = {
       getCredentials: async () => null,
       remove: async () => {},
@@ -16,7 +16,7 @@ describe('createAuthenticatedHttp', () => {
     )
   })
 
-  test('clears stale credentials when both recovery methods fail', async () => {
+  it('clears stale credentials when both recovery methods fail', async () => {
     let removed = false
     const manager = {
       getCredentials: async () => ({
@@ -39,7 +39,7 @@ describe('createAuthenticatedHttp', () => {
     expect(removed).toBe(true)
   })
 
-  test('returns the authenticated http client when the session is valid', async () => {
+  it('returns the authenticated http client when the session is valid', async () => {
     const http = {
       checkLogin: async () => ({ userId: 'neo@example.com', userNm: '전수열' }),
       get: async () => '',
@@ -60,7 +60,7 @@ describe('createAuthenticatedHttp', () => {
     await expect(createAuthenticatedHttp(manager, () => http)).resolves.toBe(http)
   })
 
-  test('re-authenticates automatically when stored username/password are available', async () => {
+  it('re-authenticates automatically when stored username and password are available', async () => {
     let savedCredentials: Record<string, string> | null = null
     const manager = {
       getCredentials: async () => ({
@@ -110,7 +110,7 @@ describe('createAuthenticatedHttp', () => {
     })
   })
 
-  test('recovers via browser extraction when no stored password is available', async () => {
+  it('recovers via browser extraction when no stored password is available', async () => {
     let savedCredentials: Record<string, unknown> | null = null
     const manager = {
       getCredentials: async () => ({
@@ -146,7 +146,7 @@ describe('createAuthenticatedHttp', () => {
     expect(savedCredentials).toHaveProperty('loggedInAt')
   })
 
-  test('falls back to browser extraction when password re-login throws', async () => {
+  it('falls back to browser extraction when password re-login fails', async () => {
     let savedCredentials: Record<string, unknown> | null = null
     const manager = {
       getCredentials: async () => ({
@@ -190,7 +190,7 @@ describe('createAuthenticatedHttp', () => {
     })
   })
 
-  test('does not attempt browser extraction when no credentials exist', async () => {
+  it('skips browser extraction when no credentials exist', async () => {
     let browserExtractionCalled = false
     const manager = {
       getCredentials: async () => null,