opensoma 0.1.2 → 0.2.0

package/src/commands/dashboard.ts

@@ -1,12 +1,11 @@
 import { Command } from 'commander'
 
-import { MENU_NO } from '@/constants'
-import * as formatters from '@/formatters'
-import { handleError } from '@/shared/utils/error-handler'
-import { formatOutput } from '@/shared/utils/output'
-
+import { MENU_NO } from '../constants'
+import * as formatters from '../formatters'
+import { handleError } from '../shared/utils/error-handler'
+import { buildMentoringListParams } from '../shared/utils/mentoring-params'
+import { formatOutput } from '../shared/utils/output'
 import { getHttpOrExit } from './helpers'
-import { buildMentoringListParams } from '@/shared/utils/mentoring-params'
 
 type ShowOptions = { pretty?: boolean }
 

package/src/commands/event.ts

@@ -1,11 +1,10 @@
 import { Command } from 'commander'
 
-import { MENU_NO } from '@/constants'
-import * as formatters from '@/formatters'
-import { handleError } from '@/shared/utils/error-handler'
-import { formatOutput } from '@/shared/utils/output'
-import { buildApplicationPayload, parseEventDetail } from '@/shared/utils/swmaestro'
-
+import { MENU_NO } from '../constants'
+import * as formatters from '../formatters'
+import { handleError } from '../shared/utils/error-handler'
+import { formatOutput } from '../shared/utils/output'
+import { buildApplicationPayload, parseEventDetail } from '../shared/utils/swmaestro'
 import { getHttpOrExit } from './helpers'
 
 type ListOptions = { page?: string; pretty?: boolean }

package/src/commands/helpers.ts

@@ -1,12 +1,29 @@
-import { CredentialManager } from '@/credential-manager'
-import { SomaHttp } from '@/http'
+import { CredentialManager } from '../credential-manager'
+import { SomaHttp } from '../http'
 
 export async function getHttpOrExit(): Promise<SomaHttp> {
   const manager = new CredentialManager()
   const creds = await manager.getCredentials()
   if (!creds) {
-    console.error(JSON.stringify({ error: 'Not logged in. Run: opensoma auth login' }))
+    console.error(
+      JSON.stringify({
+        error: 'Not logged in. Run: opensoma auth login or opensoma auth extract',
+      }),
+    )
     process.exit(1)
   }
-  return new SomaHttp({ sessionCookie: creds.sessionCookie, csrfToken: creds.csrfToken })
+
+  const http = new SomaHttp({ sessionCookie: creds.sessionCookie, csrfToken: creds.csrfToken })
+
+  const identity = await http.checkLogin()
+  if (!identity) {
+    console.error(
+      JSON.stringify({
+        error: 'Session expired. Run: opensoma auth login or opensoma auth extract',
+      }),
+    )
+    process.exit(1)
+  }
+
+  return http
 }

package/src/commands/member.ts

@@ -1,10 +1,9 @@
 import { Command } from 'commander'
 
-import { MENU_NO } from '@/constants'
-import * as formatters from '@/formatters'
-import { handleError } from '@/shared/utils/error-handler'
-import { formatOutput } from '@/shared/utils/output'
-
+import { MENU_NO } from '../constants'
+import * as formatters from '../formatters'
+import { handleError } from '../shared/utils/error-handler'
+import { formatOutput } from '../shared/utils/output'
 import { getHttpOrExit } from './helpers'
 
 type ShowOptions = { pretty?: boolean }

package/src/commands/mentoring.ts

@@ -1,20 +1,25 @@
 import { Command } from 'commander'
 
-import { MENU_NO } from '@/constants'
-import * as formatters from '@/formatters'
-import { handleError } from '@/shared/utils/error-handler'
-import { formatOutput } from '@/shared/utils/output'
+import { MENU_NO } from '../constants'
+import * as formatters from '../formatters'
+import { handleError } from '../shared/utils/error-handler'
+import { buildMentoringListParams, parseSearchQuery } from '../shared/utils/mentoring-params'
+import { formatOutput } from '../shared/utils/output'
 import {
   buildApplicationPayload,
   buildCancelApplicationPayload,
   buildDeleteMentoringPayload,
   buildMentoringPayload,
-} from '@/shared/utils/swmaestro'
-
+} from '../shared/utils/swmaestro'
 import { getHttpOrExit } from './helpers'
-import { buildMentoringListParams, parseSearchQuery } from '@/shared/utils/mentoring-params'
 
-type ListOptions = { status?: string; type?: string; search?: string; page?: string; pretty?: boolean }
+type ListOptions = {
+  status?: string
+  type?: string
+  search?: string
+  page?: string
+  pretty?: boolean
+}
 type GetOptions = { pretty?: boolean }
 type CreateOptions = {
   title: string
@@ -36,17 +41,23 @@ async function listAction(options: ListOptions): Promise<void> {
   try {
     const http = await getHttpOrExit()
     const search = options.search ? parseSearchQuery(options.search) : undefined
-    const user = search?.me ? (await http.checkLogin()) ?? undefined : undefined
-    const html = await http.get('/mypage/mentoLec/list.do', buildMentoringListParams({
-      status: options.status,
-      type: options.type,
-      page: options.page,
-      search,
-      user,
-    }))
+    const user = search?.me ? ((await http.checkLogin()) ?? undefined) : undefined
+    const html = await http.get(
+      '/mypage/mentoLec/list.do',
+      buildMentoringListParams({
+        status: options.status,
+        type: options.type,
+        page: options.page,
+        search,
+        user,
+      }),
+    )
     console.log(
       formatOutput(
-        { items: formatters.parseMentoringList(html), pagination: formatters.parsePagination(html) },
+        {
+          items: formatters.parseMentoringList(html),
+          pagination: formatters.parsePagination(html),
+        },
         options.pretty,
       ),
     )
@@ -58,7 +69,10 @@ async function listAction(options: ListOptions): Promise<void> {
 async function getAction(id: string, options: GetOptions): Promise<void> {
   try {
     const http = await getHttpOrExit()
-    const html = await http.get('/mypage/mentoLec/view.do', { menuNo: MENU_NO.MENTORING, qustnrSn: id })
+    const html = await http.get('/mypage/mentoLec/view.do', {
+      menuNo: MENU_NO.MENTORING,
+      qustnrSn: id,
+    })
     console.log(formatOutput(formatters.parseMentoringDetail(html, Number.parseInt(id, 10)), options.pretty))
   } catch (error) {
     handleError(error)
@@ -134,7 +148,10 @@ async function historyAction(options: HistoryOptions): Promise<void> {
     })
     console.log(
       formatOutput(
-        { items: formatters.parseApplicationHistory(html), pagination: formatters.parsePagination(html) },
+        {
+          items: formatters.parseApplicationHistory(html),
+          pagination: formatters.parsePagination(html),
+        },
         options.pretty,
       ),
     )

package/src/commands/notice.ts

@@ -1,10 +1,9 @@
 import { Command } from 'commander'
 
-import { MENU_NO } from '@/constants'
-import * as formatters from '@/formatters'
-import { handleError } from '@/shared/utils/error-handler'
-import { formatOutput } from '@/shared/utils/output'
-
+import { MENU_NO } from '../constants'
+import * as formatters from '../formatters'
+import { handleError } from '../shared/utils/error-handler'
+import { formatOutput } from '../shared/utils/output'
 import { getHttpOrExit } from './helpers'
 
 type ListOptions = { page?: string; pretty?: boolean }

package/src/commands/room.ts

@@ -1,10 +1,9 @@
 import { Command } from 'commander'
 
-import * as formatters from '@/formatters'
-import { handleError } from '@/shared/utils/error-handler'
-import { formatOutput } from '@/shared/utils/output'
-import { buildRoomReservationPayload, resolveRoomId } from '@/shared/utils/swmaestro'
-
+import * as formatters from '../formatters'
+import { handleError } from '../shared/utils/error-handler'
+import { formatOutput } from '../shared/utils/output'
+import { buildRoomReservationPayload, resolveRoomId } from '../shared/utils/swmaestro'
 import { getHttpOrExit } from './helpers'
 
 type ListOptions = { date?: string; room?: string; pretty?: boolean }

package/src/commands/team.ts

@@ -1,10 +1,9 @@
 import { Command } from 'commander'
 
-import { MENU_NO } from '@/constants'
-import * as formatters from '@/formatters'
-import { handleError } from '@/shared/utils/error-handler'
-import { formatOutput } from '@/shared/utils/output'
-
+import { MENU_NO } from '../constants'
+import * as formatters from '../formatters'
+import { handleError } from '../shared/utils/error-handler'
+import { formatOutput } from '../shared/utils/output'
 import { getHttpOrExit } from './helpers'
 
 type ShowOptions = { pretty?: boolean }

package/src/credential-manager.test.ts

@@ -3,7 +3,7 @@ import { mkdtemp, stat } from 'node:fs/promises'
 import { tmpdir } from 'node:os'
 import { join } from 'node:path'
 
-import { CredentialManager } from '@/credential-manager'
+import { CredentialManager } from './credential-manager'
 
 let createdDirs: string[] = []
 

package/src/credential-manager.ts

@@ -3,7 +3,7 @@ import { chmod, mkdir, readFile, rm, writeFile } from 'node:fs/promises'
 import { homedir } from 'node:os'
 import { join } from 'node:path'
 
-import type { Credentials } from '@/types'
+import type { Credentials } from './types'
 
 export interface CredentialConfig {
   credentials: Credentials | null

package/src/errors.ts

@@ -0,0 +1,10 @@
+/**
+ * Error thrown when authentication is required but not valid.
+ * Provides a clear message indicating the need to authenticate.
+ */
+export class AuthenticationError extends Error {
+  constructor(message = 'Authentication required. Please login with: opensoma auth login or opensoma auth extract') {
+    super(message)
+    this.name = 'AuthenticationError'
+  }
+}

package/src/formatters.test.ts

@@ -14,7 +14,7 @@ import {
   parseRoomList,
   parseRoomSlots,
   parseTeamInfo,
-} from '@/formatters'
+} from './formatters'
 
 describe('formatters', () => {
   test('parseMentoringList parses real list rows', () => {

package/src/formatters.ts

@@ -23,7 +23,7 @@ import {
   RoomCardSchema,
   type TeamInfo,
   TeamInfoSchema,
-} from '@/types'
+} from './types'
 
 type LabelMap = Record<string, string>
 
@@ -53,17 +53,26 @@ export function parseMentoringDetail(html: string, id = 0): MentoringDetail {
   const labels = { ...extractLabelMap(root), ...extractGroupMap(root) }
   const rawTitle = labels['모집 명'] || labels['제목'] || cleanText(root.querySelector('h1, h2, .title'))
   const dateText = labels['강의날짜'] || labels['진행날짜'] || ''
-  const contentNode = root.querySelector('.cont') ?? root.querySelector('.board-view-content') ?? root.querySelector('.view-content') ?? root.querySelector('.content-body') ?? root.querySelector('#contents')
+  const contentNode =
+    root.querySelector('.cont') ??
+    root.querySelector('.board-view-content') ??
+    root.querySelector('.view-content') ??
+    root.querySelector('.content-body') ??
+    root.querySelector('#contents')
 
   return MentoringDetailSchema.parse({
     id: id || extractNumber(root.querySelector('[name="qustnrSn"]')?.getAttribute('value') ?? ''),
     title: stripMentoringStatus(stripMentoringPrefix(rawTitle)),
-    type: extractMentoringType(labels['유형'] || root.querySelector('[name="reportCd"]')?.getAttribute('value') || rawTitle),
+    type: extractMentoringType(
+      labels['유형'] || root.querySelector('[name="reportCd"]')?.getAttribute('value') || rawTitle,
+    ),
     registrationPeriod: extractDateRange(labels['접수 기간'] || labels['접수기간'] || ''),
     sessionDate: extractFirstDate(dateText),
     sessionTime: extractTimeRange(dateText),
     attendees: {
-      current: extractNumber(labels['신청인원'] || labels['현재인원'] || cleanText(root.querySelector('.total-normal')) || ''),
+      current: extractNumber(
+        labels['신청인원'] || labels['현재인원'] || cleanText(root.querySelector('.total-normal')) || '',
+      ),
       max: extractNumber(labels['모집인원'] || labels['수강인원'] || ''),
     },
     approved: /OK/i.test(labels['개설 승인'] || labels['개설승인'] || ''),
@@ -161,7 +170,12 @@ export function parseNoticeDetail(html: string, id = 0): NoticeDetail {
   const spans = top?.querySelectorAll('.etc span') ?? []
   const author = extractPrefixedValue(spans, '작성자') || labels['작성자'] || ''
   const createdAt = extractPrefixedValue(spans, '등록일') || labels['등록일'] || ''
-  const contentNode = root.querySelector('.bbs-view .cont') ?? root.querySelector('.board-view-content') ?? root.querySelector('.view-content') ?? root.querySelector('.content-body') ?? root.querySelector('#contents')
+  const contentNode =
+    root.querySelector('.bbs-view .cont') ??
+    root.querySelector('.board-view-content') ??
+    root.querySelector('.view-content') ??
+    root.querySelector('.content-body') ??
+    root.querySelector('#contents')
 
   return NoticeDetailSchema.parse({
     id: id || extractNumber(root.querySelector('[name="nttId"]')?.getAttribute('value') ?? ''),
@@ -314,28 +328,42 @@ function extractGroupMap(root: HTMLElement): LabelMap {
 function parseDashboardLinks(
   root: HTMLElement,
   predicate: (href: string) => boolean,
-): Array<{ title: string; url: string; status: string }> {
+): Array<{
+  title: string
+  url: string
+  status: string
+  date?: string
+  time?: string
+  venue?: string
+}> {
   return root
     .querySelectorAll('ul.bbs-dash_w a')
     .filter((link) => predicate(link.getAttribute('href') ?? ''))
     .map((link) => {
-    const text = cleanText(link)
-    return {
-      title: stripTrailingStatus(text),
-      url: link.getAttribute('href') ?? '',
-      status: extractTrailingStatus(text),
-    }
-  })
+      const text = cleanText(link)
+      const { cleanTitle, date, time, venue } = extractDateTimeFromTitle(text)
+      return {
+        title: stripTrailingStatus(cleanTitle),
+        url: link.getAttribute('href') ?? '',
+        status: extractTrailingStatus(text),
+        date,
+        time,
+        venue,
+      }
+    })
 }
 
 function parseTimeSlotsFromRoot(root: HTMLElement): RoomCard['timeSlots'] {
   const grid = root.querySelector('.time-grid')
-  const spans = grid ? grid.querySelectorAll('span') : root.querySelectorAll('.time-grid span, [class*="time-slot"], .slot')
+  const spans = grid
+    ? grid.querySelectorAll('span')
+    : root.querySelectorAll('.time-grid span, [class*="time-slot"], .slot')
 
   return spans
     .map((slot) => ({
       time: cleanText(slot),
-      available: !(slot.getAttribute('class') ?? '').includes('not-reserve') &&
+      available:
+        !(slot.getAttribute('class') ?? '').includes('not-reserve') &&
         !(slot.getAttribute('class') ?? '').includes('booked') &&
         !(slot.getAttribute('class') ?? '').includes('disabled'),
     }))
@@ -349,12 +377,16 @@ function findDashboardValue(items: HTMLElement[], label: string): string {
 
 function extractDashEtcValue(container: HTMLElement | null | undefined, label: string): string {
   const match = (container?.querySelectorAll('span') ?? []).find((item) => cleanText(item).startsWith(label))
-  return cleanText(match).replace(new RegExp(`^${escapeRegex(label)}\\s*:`), '').trim()
+  return cleanText(match)
+    .replace(new RegExp(`^${escapeRegex(label)}\\s*:`), '')
+    .trim()
 }
 
 function findListText(card: HTMLElement, label: string): string {
   const item = card.querySelectorAll('.txt > li').find((entry) => cleanText(entry).startsWith(label))
-  return cleanText(item).replace(new RegExp(`^${escapeRegex(label)}\\s*:`), '').trim()
+  return cleanText(item)
+    .replace(new RegExp(`^${escapeRegex(label)}\\s*:`), '')
+    .trim()
 }
 
 function extractLocationHref(onclick: string | undefined): string {
@@ -440,6 +472,45 @@ function extractTrailingStatus(text: string): string {
   return match?.[1] ?? ''
 }
 
+function extractDateTimeFromTitle(text: string): {
+  cleanTitle: string
+  date?: string
+  time?: string
+  venue?: string
+} {
+  // Match date patterns: 2025-04-15 or 2025.04.15
+  const dateMatch = text.match(/(\d{4}[.-]\d{2}[.-]\d{2})/)
+  // Match time patterns: 14:00~16:00 or 14:00
+  const timeMatch = text.match(/(\d{2}:\d{2}(?:~\d{2}:\d{2})?)/)
+  // Match venue patterns: 스페이스 A1, A1, 강의실, etc.
+  const venueMatch = text.match(/(스페이스\s*[A-Z]\d+|강의실\s*\d+|회의실\s*[A-Z]?\d+|A\d|B\d|C\d)/i)
+
+  let cleanTitle = text
+  let date: string | undefined
+  let time: string | undefined
+  let venue: string | undefined
+
+  if (dateMatch) {
+    date = dateMatch[1].replace(/\./g, '-')
+    cleanTitle = cleanTitle.replace(dateMatch[0], '')
+  }
+
+  if (timeMatch) {
+    time = timeMatch[1]
+    cleanTitle = cleanTitle.replace(timeMatch[0], '')
+  }
+
+  if (venueMatch) {
+    venue = venueMatch[1]
+    cleanTitle = cleanTitle.replace(venueMatch[0], '')
+  }
+
+  // Clean up remaining whitespace and punctuation
+  cleanTitle = cleanTitle.replace(/^[\s\-~]+|[\s\-~]+$/g, '').trim()
+
+  return { cleanTitle, date, time, venue }
+}
+
 function stripTrailingStatus(text: string): string {
   return text.replace(/\s*(예약완료|예약중|대기|접수중|마감|승인완료|신청완료)$/, '').trim()
 }
@@ -467,7 +538,9 @@ function escapeRegex(text: string): string {
 
 function extractPrefixedValue(nodes: HTMLElement[], label: string): string {
   const match = nodes.find((node) => cleanText(node).includes(label))
-  return cleanText(match).replace(new RegExp(`^${escapeRegex(label)}\\s*:`), '').trim()
+  return cleanText(match)
+    .replace(new RegExp(`^${escapeRegex(label)}\\s*:`), '')
+    .trim()
 }
 
 function normalizeDate(value: string): string {

package/src/http.test.ts

@@ -1,7 +1,7 @@
 import { afterEach, describe, expect, mock, test } from 'bun:test'
 
-import { MENU_NO } from '@/constants'
-import { SomaHttp } from '@/http'
+import { MENU_NO } from './constants'
+import { SomaHttp } from './http'
 
 const originalFetch = globalThis.fetch
 
@@ -12,8 +12,13 @@ afterEach(() => {
 
 describe('SomaHttp', () => {
   test('get sends query params and stores cookies', async () => {
-    const fetchMock = mock(async (input: RequestInfo | URL) => {
+    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({
+        'Accept-Language': 'ko,en-US;q=0.9,en;q=0.8',
+        'User-Agent':
+          'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/147.0.0.0 Safari/537.36',
+      })
       return createResponse('<html></html>', ['JSESSIONID=session-1; Path=/', 'XSRF-TOKEN=csrf-1; Path=/'])
     })
     globalThis.fetch = fetchMock as typeof fetch
@@ -30,6 +35,9 @@ describe('SomaHttp', () => {
     const fetchMock = mock(async (_input: RequestInfo | URL, init?: RequestInit) => {
       expect(init?.method).toBe('POST')
       expect(init?.headers).toEqual({
+        'Accept-Language': 'ko,en-US;q=0.9,en;q=0.8',
+        'User-Agent':
+          'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/147.0.0.0 Safari/537.36',
         cookie: 'JSESSIONID=session-1',
         'Content-Type': 'application/x-www-form-urlencoded',
       })
@@ -47,6 +55,9 @@ describe('SomaHttp', () => {
   test('postJson returns parsed json', 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',
+        'User-Agent':
+          'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/147.0.0.0 Safari/537.36',
         cookie: 'JSESSIONID=session-1',
         Accept: 'application/json',
         'Content-Type': 'application/x-www-form-urlencoded',
@@ -56,7 +67,9 @@ describe('SomaHttp', () => {
     globalThis.fetch = fetchMock as typeof fetch
 
     const http = new SomaHttp({ sessionCookie: 'session-1', csrfToken: 'csrf-1' })
-    const json = await http.postJson<{ resultCode: string }>('/mypage/officeMng/rentTime.do', { itemId: '17' })
+    const json = await http.postJson<{ resultCode: string }>('/mypage/officeMng/rentTime.do', {
+      itemId: '17',
+    })
 
     expect(json).toEqual({ resultCode: 'SUCCESS' })
   })
@@ -67,6 +80,11 @@ describe('SomaHttp', () => {
 
       if (url.includes('/forLogin.do')) {
         expect(init?.method).toBe('GET')
+        expect(init?.headers).toEqual({
+          'Accept-Language': 'ko,en-US;q=0.9,en;q=0.8',
+          'User-Agent':
+            'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/147.0.0.0 Safari/537.36',
+        })
         return createResponse('<form><input type="hidden" name="csrfToken" value="csrf-login"></form>', [
           'JSESSIONID=session-2; Path=/',
         ])
@@ -75,6 +93,9 @@ describe('SomaHttp', () => {
       expect(url).toBe('https://www.swmaestro.ai/sw/member/user/toLogin.do')
       expect(init?.method).toBe('POST')
       expect(init?.headers).toEqual({
+        'Accept-Language': 'ko,en-US;q=0.9,en;q=0.8',
+        'User-Agent':
+          'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/147.0.0.0 Safari/537.36',
         cookie: 'JSESSIONID=session-2',
         'Content-Type': 'application/x-www-form-urlencoded',
       })
@@ -96,16 +117,31 @@ describe('SomaHttp', () => {
   })
 
   test('checkLogin returns user identity when logged in, null otherwise', async () => {
-    const loggedInMock = mock(async () =>
+    const loggedInMock = mock(async (_input: RequestInfo | URL, init?: RequestInit) =>
       createResponse(
-        JSON.stringify({ resultCode: 'fail', userVO: { userId: 'user@example.com', userNm: 'Test' } }),
+        JSON.stringify({
+          resultCode: 'fail',
+          userVO: { userId: 'user@example.com', userNm: 'Test' },
+        }),
         [],
         'application/json',
       ),
     )
     globalThis.fetch = loggedInMock as typeof fetch
 
-    await expect(new SomaHttp().checkLogin()).resolves.toEqual({ userId: 'user@example.com', userNm: 'Test' })
+    await expect(new SomaHttp().checkLogin()).resolves.toEqual({
+      userId: 'user@example.com',
+      userNm: 'Test',
+    })
+    expect(loggedInMock).toHaveBeenCalledWith('https://www.swmaestro.ai/sw/member/user/checkLogin.json', {
+      method: 'GET',
+      headers: {
+        'Accept-Language': 'ko,en-US;q=0.9,en;q=0.8',
+        'User-Agent':
+          'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/147.0.0.0 Safari/537.36',
+        Accept: 'application/json',
+      },
+    })
 
     const notLoggedInMock = mock(async () =>
       createResponse(JSON.stringify({ resultCode: 'fail', userVO: { userId: '', userSn: 0 } }), [], 'application/json'),