opensoma 0.4.0 → 0.5.1

package/src/formatters.test.ts

@@ -1,4 +1,4 @@
-import { describe, expect, test } from 'bun:test'
+import { describe, expect, it } from 'bun:test'
 
 import {
   parseApprovalList,
@@ -21,7 +21,7 @@ import {
 import { ApprovalListItemSchema, ReportDetailSchema, ReportListItemSchema } from './types'
 
 describe('formatters', () => {
-  test('parseMentoringList parses real list rows', () => {
+  it('parses real mentoring list rows from the list page', () => {
     const html = `
       <table>
         <thead><tr><th>NO.</th><th>제목</th><th>접수기간</th><th>진행날짜</th><th>모집인원</th><th>개설승인</th><th>상태</th><th>작성자</th><th>등록일</th></tr></thead>
@@ -59,7 +59,7 @@ describe('formatters', () => {
     ])
   })
 
-  test('parseMentoringDetail parses real key-value detail view', () => {
+  it('parses the key-value sections of a real mentoring detail view', () => {
     const html = `
       <input type="hidden" name="reportCd" value="MRC020">
       <div class="top">
@@ -94,7 +94,7 @@ describe('formatters', () => {
     })
   })
 
-  test('parseMentoringDetail parses applicant list table', () => {
+  it('parses the applicant list table on the mentoring detail view', () => {
     const html = `
       <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>
@@ -133,7 +133,7 @@ describe('formatters', () => {
     ])
   })
 
-  test('parseMentoringDetail returns empty applicants when no applicant table exists', () => {
+  it('returns an empty applicant list when no applicant table is present', () => {
     const html = `
       <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>
@@ -146,7 +146,7 @@ describe('formatters', () => {
     expect(parseMentoringDetail(html, 5678).applicants).toEqual([])
   })
 
-  test('parseMentoringDetail ignores unrelated 5-column tables in content', () => {
+  it('ignores unrelated 5-column tables embedded in the detail content', () => {
     const html = `
       <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>
@@ -166,7 +166,7 @@ describe('formatters', () => {
     expect(parseMentoringDetail(html, 9999).applicants).toEqual([])
   })
 
-  test('parseRoomList parses real room cards with embedded time slots', () => {
+  it('parses real room cards along with their embedded time slots', () => {
     const html = `
       <ul class="bbs-reserve">
         <li class="item">
@@ -205,7 +205,7 @@ describe('formatters', () => {
     ])
   })
 
-  test('parseRoomSlots parses rentTime fragment', () => {
+  it('parses the rentTime fragment for room slot availability and reservation info', () => {
     const html = `
       <span class="ck-st2" data-hour="09" data-minute="00">
         <input type="checkbox" name="time" id="time1_1" value="1">
@@ -229,7 +229,7 @@ describe('formatters', () => {
     ])
   })
 
-  test('parseDashboard parses real dashboard sections', () => {
+  it('parses every section of a real dashboard page', () => {
     const html = `
       <ul class="dash-top">
         <li class="dash-card">
@@ -287,7 +287,7 @@ describe('formatters', () => {
     })
   })
 
-  test('parseNoticeList and parseNoticeDetail parse real notice structures', () => {
+  it('parses real notice list and detail page structures', () => {
     const listHtml = `
       <table>
         <thead><tr><th>NO.</th><th>제목</th><th>작성자</th><th>등록일</th></tr></thead>
@@ -331,7 +331,7 @@ describe('formatters', () => {
     })
   })
 
-  test('parseTeamInfo parses team cards and summary', () => {
+  it('parses team cards together with the team count summary', () => {
     const html = `
       <ul class="bbs-team">
         <li>
@@ -362,7 +362,7 @@ describe('formatters', () => {
     })
   })
 
-  test('parseMemberInfo parses dl pairs', () => {
+  it('parses member info from <dl> definition pairs', () => {
     const html = `
       <dl><dt><span class="point">아이디</span></dt><dd>devxoul@gmail.com</dd></dl>
       <dl><dt><span class="point">이름</span></dt><dd>전수열</dd></dl>
@@ -384,7 +384,7 @@ describe('formatters', () => {
     })
   })
 
-  test('parseEventList parses 7-column event table', () => {
+  it('parses the 7-column event list table', () => {
     const html = `
       <table>
         <thead><tr><th>NO.</th><th>구분</th><th>제목</th><th>접수기간</th><th>행사기간</th><th>상태</th><th>등록일</th></tr></thead>
@@ -407,7 +407,7 @@ describe('formatters', () => {
     ])
   })
 
-  test('parseApplicationHistory parses 10-column mentoring history table', () => {
+  it('parses the 10-column mentoring application history table', () => {
     const html = `
       <table>
         <thead>
@@ -446,7 +446,7 @@ describe('formatters', () => {
     ])
   })
 
-  test('parsePagination parses bbs-total block', () => {
+  it('parses the bbs-total pagination block', () => {
     const html = `
       <ul class="bbs-total">
         <li>Total : 11</li>
@@ -457,12 +457,12 @@ describe('formatters', () => {
     expect(parsePagination(html)).toEqual({ total: 11, currentPage: 1, totalPages: 2 })
   })
 
-  test('parseCsrfToken extracts hidden input', () => {
+  it('extracts the CSRF token from a hidden input field', () => {
     expect(parseCsrfToken('<form><input type="hidden" name="csrfToken" value="csrf-123"></form>')).toBe('csrf-123')
   })
 
   describe('parseReportList', () => {
-    test('parses report list table with all fields', () => {
+    it('parses every field of the report list table', () => {
       const html = `
         <ul class="bbs-total"><li><strong class="color-blue">Total :</strong> 2</li><li><span class="color-blue">1</span>/1 Page</li></ul>
         <table class=" t">
@@ -532,7 +532,7 @@ describe('formatters', () => {
       })
     })
 
-    test('returns empty array for empty table', () => {
+    it('returns an empty array when the report list table has no rows', () => {
       const html = `
         <ul class="bbs-total"><li><strong class="color-blue">Total :</strong> 0</li><li><span class="color-blue">1</span>/1 Page</li></ul>
         <table class=" t">
@@ -552,7 +552,7 @@ describe('formatters', () => {
   })
 
   describe('parseReportDetail', () => {
-    test('parses report detail view with all fields', () => {
+    it('parses every field of the report detail view', () => {
       const html = `
         <div class="board-view">
         <table>
@@ -590,7 +590,7 @@ describe('formatters', () => {
       ReportDetailSchema.parse(result)
     })
 
-    test('uses provided id in result', () => {
+    it('uses the provided id in the parsed report detail', () => {
       const html = `
         <div class="board-view">
         <table>
@@ -612,7 +612,7 @@ describe('formatters', () => {
   })
 
   describe('parseApprovalList', () => {
-    test('parses approval list table with 10 columns', () => {
+    it('parses every column of the 10-column approval list table', () => {
       const html = `
         <ul class="bbs-total"><li><strong class="color-blue">Total :</strong> 1</li><li><span class="color-blue">1</span>/1 Page</li></ul>
         <table class=" t">
@@ -662,7 +662,7 @@ describe('formatters', () => {
       })
     })
 
-    test('returns empty array for nodata table', () => {
+    it('returns an empty array when the approval table shows the nodata row', () => {
       const html = `
         <table class=" t"><tbody><tr><td colspan="10" class="nodata">데이터가 없습니다.</td></tr></tbody></table>
       `

package/src/formatters.ts

@@ -299,12 +299,40 @@ export function parseReportList(html: string): ReportListItem[] {
 
 export function parseReportDetail(html: string, id = 0): ReportDetail {
   const root = parse(html)
-  const labels = extractLabelMap(root)
+  const labels = { ...extractLabelMap(root), ...extractGroupMap(root) }
 
   const progressTimeText = labels['진행시간'] || ''
   const exceptTimeText = labels['제외시간'] || ''
-  const progressTimes = progressTimeText.split(/\s*~\s*/)
-  const exceptTimes = exceptTimeText.split(/\s*~\s*/)
+  const progressTimeMatch = progressTimeText.match(/(\d{2}:\d{2})\s*~\s*(\d{2}:\d{2})/)
+  const exceptTimeMatch = exceptTimeText.match(/(\d{2}:\d{2})\s*~\s*(\d{2}:\d{2})/)
+
+  let subject = labels['주제'] || ''
+  if (!subject) {
+    for (const group of root.querySelectorAll('.group')) {
+      if (cleanText(group.querySelector('strong.t')) === '주제') {
+        subject = group.querySelector('input')?.getAttribute('value')?.trim() || ''
+        break
+      }
+    }
+  }
+
+  const findGroupTextarea = (...names: string[]): string => {
+    for (const group of root.querySelectorAll('.group')) {
+      const label = cleanText(group.querySelector('strong.t')).replace(/:$/, '')
+      if (names.includes(label)) {
+        const textarea = group.querySelector('textarea')
+        if (textarea) return textarea.text.trim()
+        return cleanText(group.querySelector('.c'))
+      }
+    }
+    return ''
+  }
+
+  const files = root
+    .querySelectorAll('.file_list_new a')
+    .map((a) => a.getAttribute('href') || '')
+    .filter(Boolean)
+    .map((href) => (href.startsWith('http') ? href : `https://www.swmaestro.ai${href}`))
 
   return ReportDetailSchema.parse({
     id,
@@ -312,27 +340,27 @@ export function parseReportDetail(html: string, id = 0): ReportDetail {
     title: labels['제목'] || '',
     progressDate: labels['진행 날짜'] || '',
     status: labels['상태'] || '',
-    author: labels['작성자'] || '',
+    author: labels['작성자'] || labels['진행 멘토 명'] || '',
     createdAt: labels['등록일'] || '',
     acceptedTime: labels['인정시간'] || '',
     payAmount: labels['지급액'] || '',
-    content: labels['추진 내용'] || '',
-    subject: labels['주제'] || '',
-    menteeRegion: labels['멘토링 대상'] || '',
+    content: findGroupTextarea('추진내용', '추진 내용') || labels['추진내용'] || labels['추진 내용'] || '',
+    subject,
+    menteeRegion: labels['멘토링대상'] || labels['멘토링 대상'] || '',
     reportType: labels['구분'] || '',
     teamNames: labels['팀명'] || '',
     venue: labels['진행 장소'] || '',
-    attendanceCount: extractNumber(labels['참석 연수생'] || ''),
+    attendanceCount: extractNumber(labels['참석자 인원'] || labels['참석 연수생'] || ''),
     attendanceNames: labels['참석자 이름'] || '',
-    progressStartTime: progressTimes[0] || '',
-    progressEndTime: progressTimes[1] || '',
-    exceptStartTime: exceptTimes[0] || '',
-    exceptEndTime: exceptTimes[1] || '',
-    exceptReason: labels['제외 사유'] || labels['제외이유'] || '',
-    mentorOpinion: labels['멘토 의견'] || '',
+    progressStartTime: progressTimeMatch?.[1] || '',
+    progressEndTime: progressTimeMatch?.[2] || '',
+    exceptStartTime: exceptTimeMatch?.[1] || '',
+    exceptEndTime: exceptTimeMatch?.[2] || '',
+    exceptReason: labels['제외사유'] || labels['제외 사유'] || labels['제외이유'] || '',
+    mentorOpinion: findGroupTextarea('멘토의견', '멘토 의견') || labels['멘토의견'] || labels['멘토 의견'] || '',
     nonAttendanceNames: labels['무단불참자'] || '',
-    etc: labels['특이사항'] || '',
-    files: [],
+    etc: findGroupTextarea('기타', '특이사항') || labels['기타'] || labels['특이사항'] || '',
+    files,
   })
 }
 

package/src/http.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 { MENU_NO } from './constants'
 import { AuthenticationError } from './errors'
@@ -12,7 +12,7 @@ afterEach(() => {
 })
 
 describe('SomaHttp', () => {
-  test('get sends query params and stores cookies', async () => {
+  it('sends query params on GET and stores returned cookies', async () => {
     const fetchMock = mock(async (input: RequestInfo | URL, init?: RequestInit) => {
       expect(String(input)).toBe(`https://www.swmaestro.ai/sw/member/user/forLogin.do?menuNo=${MENU_NO.LOGIN}`)
       expect(init?.headers).toEqual({
@@ -32,7 +32,7 @@ describe('SomaHttp', () => {
     expect(fetchMock).toHaveBeenCalledTimes(1)
   })
 
-  test('post encodes body and injects csrf token', async () => {
+  it('encodes the POST body and injects the CSRF token', async () => {
     const fetchMock = mock(async (_input: RequestInfo | URL, init?: RequestInit) => {
       expect(init?.method).toBe('POST')
       expect(init?.headers).toEqual({
@@ -53,7 +53,7 @@ describe('SomaHttp', () => {
     expect(html).toBe('<html>ok</html>')
   })
 
-  test('post surfaces alert errors from script tags with attributes', async () => {
+  it('surfaces alert() errors from script tags that have attributes', async () => {
     const fetchMock = mock(async () =>
       createResponse(
         `<html><head><title>빈페이지</title></head><body><script type='text/javascript'>alert('아이디 혹은 비밀번호가 일치 하지 않습니다.');location.href='/login';</script></body></html>`,
@@ -68,7 +68,7 @@ describe('SomaHttp', () => {
     )
   })
 
-  test('post surfaces alert errors followed by history.back()', async () => {
+  it('surfaces alert() errors that are followed by history.back()', async () => {
     const fetchMock = mock(async () =>
       createResponse(
         `<html><head></head><body><script language='JavaScript'>\nalert('잘못된 접근입니다.');\nhistory.back();\n</script></body></html>`,
@@ -81,7 +81,7 @@ describe('SomaHttp', () => {
     await expect(http.post('/mypage/test.do', {})).rejects.toThrow('잘못된 접근입니다.')
   })
 
-  test('post ignores alert() inside function bodies (form validation scripts)', async () => {
+  it('ignores alert() calls nested inside function bodies (form validation scripts)', async () => {
     const pageWithValidationScript = `<html><head><title>AI·SW마에스트로 서울</title></head><body>
       <ul class="bbs-reserve"><li class="item">room data</li></ul>
       <script>
@@ -106,7 +106,7 @@ describe('SomaHttp', () => {
   })
 
   describe('postMultipart', () => {
-    test('passes FormData to fetch', async () => {
+    it('passes the FormData instance through to fetch', async () => {
       const fetchMock = mock(async (_input: RequestInfo | URL, init?: RequestInit) => {
         expect(init?.body).toBeInstanceOf(FormData)
         return createResponse('<html>ok</html>')
@@ -118,7 +118,7 @@ describe('SomaHttp', () => {
       await expect(http.postMultipart('/test', new FormData())).resolves.toBe('<html>ok</html>')
     })
 
-    test('does not set Content-Type manually', async () => {
+    it('does not set the Content-Type header manually (lets fetch set the boundary)', async () => {
       const fetchMock = mock(async (_input: RequestInfo | URL, init?: RequestInit) => {
         expect(init?.headers).toEqual({
           'Accept-Language': 'ko,en-US;q=0.9,en;q=0.8',
@@ -139,7 +139,7 @@ describe('SomaHttp', () => {
       await http.postMultipart('/test', new FormData())
     })
 
-    test('appends csrf token to FormData', async () => {
+    it('appends the CSRF token to the FormData body', async () => {
       const fetchMock = mock(async (_input: RequestInfo | URL, init?: RequestInit) => {
         const body = init?.body
         expect(body).toBeInstanceOf(FormData)
@@ -153,7 +153,7 @@ describe('SomaHttp', () => {
       await http.postMultipart('/test', new FormData())
     })
 
-    test('follows redirects manually', async () => {
+    it('follows redirects manually after a multipart POST', async () => {
       const fetchMock = mock(async (input: RequestInfo | URL, init?: RequestInit) => {
         const url = String(input)
 
@@ -189,7 +189,7 @@ describe('SomaHttp', () => {
       expect(fetchMock).toHaveBeenCalledTimes(2)
     })
 
-    test('keeps existing post() behavior unchanged', async () => {
+    it('keeps the existing post() behavior unchanged', async () => {
       const fetchMock = mock(async (_input: RequestInfo | URL, init?: RequestInit) => {
         expect(init?.method).toBe('POST')
         expect(init?.headers).toEqual({
@@ -211,7 +211,7 @@ describe('SomaHttp', () => {
   })
 
   describe('postForm', () => {
-    test('converts Record to FormData and delegates to postMultipart', async () => {
+    it('converts a Record body to FormData and delegates to postMultipart', async () => {
       const fetchMock = mock(async (_input: RequestInfo | URL, init?: RequestInit) => {
         const body = init?.body
         expect(body).toBeInstanceOf(FormData)
@@ -230,7 +230,7 @@ describe('SomaHttp', () => {
       ).resolves.toBe('<html>ok</html>')
     })
 
-    test('does not set Content-Type header (lets FormData set multipart boundary)', async () => {
+    it('does not set the Content-Type header so FormData can set the multipart boundary', async () => {
       const fetchMock = mock(async (_input: RequestInfo | URL, init?: RequestInit) => {
         const headers = init?.headers as Record<string, string> | undefined
         expect(headers?.['Content-Type']).toBeUndefined()
@@ -245,7 +245,7 @@ describe('SomaHttp', () => {
     })
   })
 
-  test('postJson returns parsed json', async () => {
+  it('returns the parsed JSON body from postJson', async () => {
     const fetchMock = mock(async (_input: RequestInfo | URL, init?: RequestInit) => {
       expect(init?.headers).toEqual({
         'Accept-Language': 'ko,en-US;q=0.9,en;q=0.8',
@@ -267,7 +267,7 @@ describe('SomaHttp', () => {
     expect(json).toEqual({ resultCode: 'SUCCESS' })
   })
 
-  test('login fetches csrf token then posts credentials', async () => {
+  it('fetches the CSRF token before posting credentials during login', async () => {
     const fetchMock = mock(async (input: RequestInfo | URL, init?: RequestInit) => {
       const url = String(input)
 
@@ -309,7 +309,7 @@ describe('SomaHttp', () => {
     expect(http.getCsrfToken()).toBe('csrf-login')
   })
 
-  test('checkLogin returns user identity when logged in, null otherwise', async () => {
+  it('returns the user identity when logged in and null when not', async () => {
     const loggedInMock = mock(async (_input: RequestInfo | URL, _init?: RequestInit) =>
       createResponse(
         JSON.stringify({
@@ -345,7 +345,7 @@ describe('SomaHttp', () => {
     await expect(new SomaHttp().checkLogin()).resolves.toBeNull()
   })
 
-  test('checkLogin returns null when the server redirects to login', async () => {
+  it('returns null from checkLogin when the server redirects to the login page', async () => {
     const fetchMock = mock(async () =>
       createResponse('', [], 'text/html', {
         status: 302,
@@ -357,7 +357,7 @@ describe('SomaHttp', () => {
     await expect(new SomaHttp({ sessionCookie: 'session-1' }).checkLogin()).resolves.toBeNull()
   })
 
-  test('checkLogin returns null when the server serves login html instead of json', async () => {
+  it('returns null from checkLogin when the server serves login HTML instead of JSON', async () => {
     const fetchMock = mock(async () =>
       createResponse(
         '<html><head><title>AI·SW마에스트로</title></head><body><form><input name="username"><input name="password"></form></body></html>',
@@ -368,7 +368,7 @@ describe('SomaHttp', () => {
     await expect(new SomaHttp({ sessionCookie: 'session-1' }).checkLogin()).resolves.toBeNull()
   })
 
-  test('logout calls logout endpoint', async () => {
+  it('calls the logout endpoint', async () => {
     const fetchMock = mock(async (input: RequestInfo | URL) => {
       expect(String(input)).toBe('https://www.swmaestro.ai/sw/member/user/logout.do')
       return createResponse('<html>bye</html>')
@@ -380,7 +380,7 @@ describe('SomaHttp', () => {
     expect(fetchMock).toHaveBeenCalledTimes(1)
   })
 
-  test('extractCsrfToken reads hidden input', async () => {
+  it('reads the CSRF token from a hidden input field', async () => {
     const fetchMock = mock(async () => createResponse('<input type="hidden" name="csrfToken" value="csrf-token">'))
     globalThis.fetch = fetchMock as typeof fetch
 
@@ -397,7 +397,7 @@ describe('SomaHttp', () => {
 
     const expiredMessage = '잘못된 접근입니다. 해당 세션을 전체 초기화 하였습니다.'
 
-    test('post throws AuthenticationError for session-expired alert', async () => {
+    it('throws AuthenticationError from post when alert indicates session expiry', async () => {
       const fetchMock = mock(async () => createResponse(sessionExpiredAlert(expiredMessage)))
       globalThis.fetch = fetchMock as typeof fetch
 
@@ -406,7 +406,7 @@ describe('SomaHttp', () => {
       await expect(http.post('/mypage/officeMng/list.do', { menuNo: '200058' })).rejects.toThrow(AuthenticationError)
     })
 
-    test('get throws AuthenticationError for session-expired alert', async () => {
+    it('throws AuthenticationError from get when alert indicates session expiry', async () => {
       const fetchMock = mock(async () => createResponse(sessionExpiredAlert(expiredMessage)))
       globalThis.fetch = fetchMock as typeof fetch
 
@@ -415,7 +415,7 @@ describe('SomaHttp', () => {
       await expect(http.get('/mypage/officeMng/list.do')).rejects.toThrow(AuthenticationError)
     })
 
-    test('postMultipart throws AuthenticationError for session-expired alert', async () => {
+    it('throws AuthenticationError from postMultipart when alert indicates session expiry', async () => {
       const fetchMock = mock(async () => createResponse(sessionExpiredAlert(expiredMessage)))
       globalThis.fetch = fetchMock as typeof fetch
 
@@ -424,7 +424,7 @@ describe('SomaHttp', () => {
       await expect(http.postMultipart('/mypage/test.do', new FormData())).rejects.toThrow(AuthenticationError)
     })
 
-    test('alert with 세션 + invalidation keyword variants are treated as auth error', async () => {
+    it('treats alerts containing "세션" plus an invalidation keyword as auth errors', async () => {
       const variants = ['세션이 만료되었습니다.', '해당 세션을 초기화하였습니다.', '세션 정보가 유효하지 않습니다.']
 
       for (const message of variants) {
@@ -436,7 +436,7 @@ describe('SomaHttp', () => {
       }
     })
 
-    test('alert containing 세션 without invalidation keyword is not treated as auth error', async () => {
+    it('does not treat an alert containing "세션" without an invalidation keyword as an auth error', async () => {
       const fetchMock = mock(async () => createResponse(sessionExpiredAlert('멘토링 세션이 이미 마감되었습니다.')))
       globalThis.fetch = fetchMock as typeof fetch
 
@@ -445,7 +445,7 @@ describe('SomaHttp', () => {
       await expect(http.post('/mypage/test.do', {})).rejects.toThrow('멘토링 세션이 이미 마감되었습니다.')
     })
 
-    test('non-session alert still throws regular Error', async () => {
+    it('throws a regular Error from post when the alert is unrelated to the session', async () => {
       const fetchMock = mock(async () => createResponse(sessionExpiredAlert('잘못된 접근입니다.')))
       globalThis.fetch = fetchMock as typeof fetch
 
@@ -454,7 +454,7 @@ describe('SomaHttp', () => {
       await expect(http.post('/mypage/test.do', {})).rejects.toThrow('잘못된 접근입니다.')
     })
 
-    test('get throws regular Error for non-session alert', async () => {
+    it('throws a regular Error from get when the alert is unrelated to the session', async () => {
       const fetchMock = mock(async () => createResponse(sessionExpiredAlert('잘못된 접근입니다.')))
       globalThis.fetch = fetchMock as typeof fetch
 
@@ -463,7 +463,7 @@ describe('SomaHttp', () => {
       await expect(http.get('/mypage/test.do')).rejects.toThrow('잘못된 접근입니다.')
     })
 
-    test('session-expired alert with double quotes is detected', async () => {
+    it('detects session-expired alerts that use double quotes', async () => {
       const doubleQuoteAlert = `<html><body><script language='JavaScript'>\nalert("${expiredMessage}");\nhistory.back();\n</script></body></html>`
       const fetchMock = mock(async () => createResponse(doubleQuoteAlert))
       globalThis.fetch = fetchMock as typeof fetch
@@ -480,7 +480,7 @@ describe('SomaHttp', () => {
     })
     const genericErrorJson = JSON.stringify({ error: '처리 중 오류가 발생했습니다.' })
 
-    test('post throws AuthenticationError for session-expired JSON', async () => {
+    it('throws AuthenticationError from post when the JSON response indicates session expiry', async () => {
       const fetchMock = mock(async () => createResponse(sessionExpiredJson, [], 'application/json'))
       globalThis.fetch = fetchMock as typeof fetch
 
@@ -489,7 +489,7 @@ describe('SomaHttp', () => {
       await expect(http.post('/mypage/officeMng/list.do', { menuNo: '200058' })).rejects.toThrow(AuthenticationError)
     })
 
-    test('post throws Error for non-session JSON error', async () => {
+    it('throws a regular Error from post for non-session JSON errors', async () => {
       const fetchMock = mock(async () => createResponse(genericErrorJson, [], 'application/json'))
       globalThis.fetch = fetchMock as typeof fetch
 
@@ -498,7 +498,7 @@ describe('SomaHttp', () => {
       await expect(http.post('/mypage/test.do', {})).rejects.toThrow('처리 중 오류가 발생했습니다.')
     })
 
-    test('postJson throws AuthenticationError for session-expired JSON', async () => {
+    it('throws AuthenticationError from postJson when the JSON response indicates session expiry', async () => {
       const fetchMock = mock(async () => createResponse(sessionExpiredJson, [], 'application/json'))
       globalThis.fetch = fetchMock as typeof fetch
 
@@ -509,7 +509,7 @@ describe('SomaHttp', () => {
       )
     })
 
-    test('postJson throws Error for non-session JSON error', async () => {
+    it('throws a regular Error from postJson for non-session JSON errors', async () => {
       const fetchMock = mock(async () => createResponse(genericErrorJson, [], 'application/json'))
       globalThis.fetch = fetchMock as typeof fetch
 
@@ -518,7 +518,7 @@ describe('SomaHttp', () => {
       await expect(http.postJson('/mypage/test.do', {})).rejects.toThrow('처리 중 오류가 발생했습니다.')
     })
 
-    test('postJson still parses valid JSON when no error field', async () => {
+    it('still parses valid JSON from postJson when no error field is present', async () => {
       const fetchMock = mock(async () =>
         createResponse(JSON.stringify({ resultCode: 'SUCCESS' }), [], 'application/json'),
       )
@@ -529,7 +529,7 @@ describe('SomaHttp', () => {
       await expect(http.postJson('/mypage/test.do', {})).resolves.toEqual({ resultCode: 'SUCCESS' })
     })
 
-    test('non-JSON body starting with { does not false-positive', async () => {
+    it('does not false-positive on non-JSON bodies that happen to start with "{"', async () => {
       const fetchMock = mock(async () => createResponse('{malformed json', [], 'text/html'))
       globalThis.fetch = fetchMock as typeof fetch
 
@@ -538,7 +538,7 @@ describe('SomaHttp', () => {
       await expect(http.get('/test')).resolves.toBe('{malformed json')
     })
 
-    test('JSON error with leading whitespace is still detected', async () => {
+    it('still detects JSON error responses that have leading whitespace', async () => {
       const paddedJson = `  \n  ${sessionExpiredJson}`
       const fetchMock = mock(async () => createResponse(paddedJson, [], 'application/json'))
       globalThis.fetch = fetchMock as typeof fetch
@@ -548,7 +548,7 @@ describe('SomaHttp', () => {
       await expect(http.post('/mypage/test.do', {})).rejects.toThrow(AuthenticationError)
     })
 
-    test('get throws Error for non-session JSON error', async () => {
+    it('throws a regular Error from get for non-session JSON errors', async () => {
       const fetchMock = mock(async () => createResponse(genericErrorJson, [], 'application/json'))
       globalThis.fetch = fetchMock as typeof fetch
 
@@ -557,7 +557,7 @@ describe('SomaHttp', () => {
       await expect(http.get('/mypage/test.do')).rejects.toThrow('처리 중 오류가 발생했습니다.')
     })
 
-    test('postJson throws AuthenticationError for HTML login page response', async () => {
+    it('throws AuthenticationError from postJson when the response is an HTML login page', async () => {
       const loginPageHtml =
         '<html><head><title>AI·SW마에스트로</title></head><body><form><input name="username"><input name="password"></form></body></html>'
       const fetchMock = mock(async () => createResponse(loginPageHtml))

package/src/index.ts

@@ -3,5 +3,8 @@ export type { SomaClientOptions } from './client'
 export { AuthenticationError } from './errors'
 export { SomaHttp } from './http'
 export { CredentialManager } from './credential-manager'
+export { TozHttp } from './toz-http'
+export type { TozHttpOptions, TozHttpState } from './toz-http'
+export * from './toz-formatters'
 export * from './types'
 export * from './constants'