opensoma 0.3.0 → 0.5.0

package/src/toz-formatters.ts

@@ -0,0 +1,211 @@
+import { parse } from 'node-html-parser'
+
+import { decodeHtmlEntities } from './shared/utils/html'
+import { parseDurationKey } from './shared/utils/toz'
+import {
+  type TozBooth,
+  TozBoothSchema,
+  type TozBranch,
+  TozBranchSchema,
+  type TozDuration,
+  TozDurationSchema,
+  type TozMeeting,
+  TozMeetingSchema,
+  type TozReservation,
+  TozReservationSchema,
+  type TozReserved,
+  TozReservedSchema,
+} from './types'
+
+interface RawBooth {
+  resultMsg?: string
+  id?: number
+  name?: string
+  branchName?: string
+  branchTel?: string
+  minUseUserCount?: number
+  enableMaxUserCount?: number
+  boothGroupName?: string
+  boothGroupUrl?: string | null
+  boothMemoForUser?: string
+  isLargeBooth?: boolean
+}
+
+interface RawReserved {
+  result?: string
+  resultMsg?: string
+  branchName?: string
+  branchTel?: string
+  boothGroupName?: string
+  boothIsLarge?: boolean
+}
+
+interface RawDuration {
+  key: string
+  value: string
+}
+
+export function parseBookingPageBranches(html: string): TozBranch[] {
+  const root = parse(html)
+  const inputs = root.querySelectorAll('input[name="branch_id"]')
+  const branches: TozBranch[] = []
+
+  for (const input of inputs) {
+    const value = input.getAttribute('value')
+    if (!value) continue
+    const id = Number.parseInt(value, 10)
+    if (!Number.isFinite(id)) continue
+
+    const label = input.parentNode
+    const name = label ? cleanText(label.text) : ''
+    if (!name) continue
+
+    branches.push(TozBranchSchema.parse({ id, name }))
+  }
+
+  return branches
+}
+
+export function parseBookingPageMeetings(html: string): TozMeeting[] {
+  const root = parse(html)
+  const select = root.querySelector('select[name="meeting_id"]')
+  if (!select) return []
+
+  const meetings: TozMeeting[] = []
+  for (const option of select.querySelectorAll('option')) {
+    const value = option.getAttribute('value')
+    if (!value || value === '새모임') continue
+    const id = Number.parseInt(value, 10)
+    if (!Number.isFinite(id)) continue
+
+    const name = cleanText(option.text)
+    if (!name) continue
+
+    meetings.push(TozMeetingSchema.parse({ id, name }))
+  }
+
+  return meetings
+}
+
+export function parseTozDurations(json: unknown): TozDuration[] {
+  if (!Array.isArray(json)) return []
+  const seen = new Set<string>()
+  const durations: TozDuration[] = []
+
+  for (const raw of json as RawDuration[]) {
+    if (!raw?.key || !raw?.value || seen.has(raw.key)) continue
+    seen.add(raw.key)
+    durations.push(
+      TozDurationSchema.parse({
+        key: raw.key,
+        value: raw.value,
+        minutes: parseDurationKey(raw.key),
+      }),
+    )
+  }
+
+  return durations
+}
+
+export function parseTozBoothes(json: unknown): TozBooth[] {
+  if (!Array.isArray(json)) return []
+  const items = json as RawBooth[]
+  if (items.length === 0) return []
+
+  const first = items[0]
+  if (first?.resultMsg && first.resultMsg !== 'SUCCESS') {
+    throw new Error(first.resultMsg)
+  }
+
+  return items
+    .filter((raw) => raw.id !== undefined && raw.id !== null)
+    .map((raw) =>
+      TozBoothSchema.parse({
+        id: raw.id,
+        name: raw.name ?? '',
+        branchName: raw.branchName ?? '',
+        branchTel: raw.branchTel ?? '',
+        minUseUserCount: raw.minUseUserCount ?? 0,
+        enableMaxUserCount: raw.enableMaxUserCount ?? 0,
+        boothGroupName: raw.boothGroupName ?? '',
+        boothGroupUrl: raw.boothGroupUrl ?? null,
+        boothMemoForUser: raw.boothMemoForUser ?? '',
+        isLargeBooth: Boolean(raw.isLargeBooth),
+      }),
+    )
+}
+
+export function parseTozReserved(json: unknown): TozReserved {
+  const raw = json as RawReserved | null
+  if (!raw || raw.result !== 'SUCCESS' || !raw.resultMsg) {
+    throw new Error(raw?.resultMsg || '부스 예약에 실패했습니다.')
+  }
+
+  return TozReservedSchema.parse({
+    reservationId: raw.resultMsg,
+    branchName: raw.branchName ?? '',
+    branchTel: raw.branchTel ?? '',
+    boothGroupName: raw.boothGroupName ?? '',
+    isLargeBooth: Boolean(raw.boothIsLarge),
+  })
+}
+
+const SUCCESS_PATTERNS = ['예약 되었습니다', '대형부스 예약 신청되었습니다']
+
+export function isReservationConfirmSuccess(resultMsg: string): boolean {
+  return SUCCESS_PATTERNS.some((p) => resultMsg.includes(p))
+}
+
+export function parseMypageReservations(html: string): TozReservation[] {
+  const root = parse(html)
+  // The 실시간예약 table is the second table.reservation in the page.
+  // The 상담요청 table (first) lives inside a parent <table style="display:none">.
+  const tables = root.querySelectorAll('table.reservation')
+  if (tables.length === 0) return []
+
+  const target = tables[tables.length - 1]
+  const rows = target.querySelectorAll('tbody tr')
+  const reservations: TozReservation[] = []
+
+  for (const row of rows) {
+    const cells = row.querySelectorAll('td')
+    if (cells.length !== 8) continue
+
+    const [no, meetingName, date, time, branch, booth, reservedAt, statusCell] = cells
+    const cancelLink = statusCell.querySelector('a')
+    const reservationId = extractReservationIdFromOnclick(cancelLink?.getAttribute('href'))
+
+    reservations.push(
+      TozReservationSchema.parse({
+        no: Number.parseInt(cleanText(no.text), 10) || 0,
+        reservationId,
+        meetingName: cleanText(meetingName.text),
+        date: cleanText(date.text),
+        ...splitTimeRange(cleanText(time.text)),
+        branchName: cleanText(branch.text),
+        boothName: cleanText(booth.text),
+        reservedAt: cleanText(reservedAt.text),
+        status: cleanText(statusCell.text),
+      }),
+    )
+  }
+
+  return reservations
+}
+
+function splitTimeRange(text: string): { startTime: string; endTime: string } {
+  const match = /(\d{1,2}:\d{2})\s*[~-]\s*(\d{1,2}:\d{2})/.exec(text)
+  if (!match) return { startTime: text, endTime: '' }
+  return { startTime: match[1], endTime: match[2] }
+}
+
+function extractReservationIdFromOnclick(href: string | undefined): number | null {
+  if (!href) return null
+  const match = /destroyReservation\(\s*(\d+)\s*\)/.exec(href)
+  if (!match) return null
+  return Number.parseInt(match[1], 10)
+}
+
+function cleanText(text: string): string {
+  return decodeHtmlEntities(text).replace(/\s+/g, ' ').trim()
+}

package/src/toz-http.test.ts

@@ -0,0 +1,157 @@
+import { afterEach, describe, expect, mock, test } from 'bun:test'
+
+import { TOZ_BASE_URL } from './constants'
+import { TozHttp } from './toz-http'
+
+const originalFetch = globalThis.fetch
+
+afterEach(() => {
+  globalThis.fetch = originalFetch
+  mock.restore()
+})
+
+describe('TozHttp', () => {
+  test('bootstrap GETs index.htm to seed JSESSIONID', async () => {
+    const fetchMock = mock(async (input: RequestInfo | URL, init?: RequestInit) => {
+      expect(String(input)).toBe(`${TOZ_BASE_URL}/index.htm`)
+      expect(init?.method).toBe('GET')
+      return createResponse('ok', ['JSESSIONID=ABC123; Path=/; HttpOnly'])
+    })
+    globalThis.fetch = fetchMock as typeof fetch
+
+    const http = new TozHttp()
+    await http.bootstrap()
+
+    expect(http.getSessionCookie()).toBe('ABC123')
+    expect(fetchMock).toHaveBeenCalledTimes(1)
+  })
+
+  test('bootstrap is no-op when JSESSIONID already set', async () => {
+    const fetchMock = mock(async () => createResponse('ok'))
+    globalThis.fetch = fetchMock as typeof fetch
+
+    const http = new TozHttp({ sessionCookie: 'JSESSIONID=EXISTING' })
+    await http.bootstrap()
+
+    expect(fetchMock).not.toHaveBeenCalled()
+    expect(http.getSessionCookie()).toBe('EXISTING')
+  })
+
+  test('post sends URL-encoded body with required headers and cookie', async () => {
+    const fetchMock = mock(async (input: RequestInfo | URL, init?: RequestInit) => {
+      expect(String(input)).toBe(`${TOZ_BASE_URL}/ajaxGetEnableBoothes.htm`)
+      expect(init?.method).toBe('POST')
+
+      const headers = init?.headers as Record<string, string>
+      expect(headers['Content-Type']).toBe('application/x-www-form-urlencoded; charset=UTF-8')
+      expect(headers['X-Requested-With']).toBe('XMLHttpRequest')
+      expect(headers.Referer).toBe(`${TOZ_BASE_URL}/booking.htm`)
+      expect(headers.cookie).toBe('JSESSIONID=ABC123')
+
+      expect(init?.body).toBe('basedate=2026-04-21&starttime=1400&durationTime=0200&userCount=2&branchIds=27%2C')
+      return createResponse('[]', [], 'application/json')
+    })
+    globalThis.fetch = fetchMock as typeof fetch
+
+    const http = new TozHttp({ sessionCookie: 'ABC123' })
+    const text = await http.post('/ajaxGetEnableBoothes.htm', {
+      basedate: '2026-04-21',
+      starttime: '1400',
+      durationTime: '0200',
+      userCount: '2',
+      branchIds: '27,',
+    })
+
+    expect(text).toBe('[]')
+  })
+
+  test('postJson parses JSON response', async () => {
+    globalThis.fetch = mock(async () => createResponse('{"result":"SUCCESS","resultMsg":"abc"}')) as typeof fetch
+
+    const http = new TozHttp({ sessionCookie: 'ABC' })
+    const json = await http.postJson<{ result: string; resultMsg: string }>('/ajaxReservationBooth.htm', {})
+
+    expect(json).toEqual({ result: 'SUCCESS', resultMsg: 'abc' })
+  })
+
+  test('postText trims plain-text response', async () => {
+    globalThis.fetch = mock(async () => createResponse('SUCCESS\n')) as typeof fetch
+
+    const http = new TozHttp({ sessionCookie: 'ABC' })
+    expect(await http.postText('/ajaxHpVerify.htm', {})).toBe('SUCCESS')
+  })
+
+  test('strips JSESSIONID= prefix when constructed with full cookie string', async () => {
+    const http = new TozHttp({ sessionCookie: 'JSESSIONID=XYZ789' })
+    expect(http.getSessionCookie()).toBe('XYZ789')
+    expect(http.getCookies()).toEqual({ JSESSIONID: 'XYZ789' })
+  })
+
+  test('constructor with cookies map preserves all cookies', async () => {
+    const http = new TozHttp({ cookies: { JSESSIONID: 'A', other: 'B' } })
+    expect(http.getCookies()).toEqual({ JSESSIONID: 'A', other: 'B' })
+  })
+
+  test('throws on non-2xx response', async () => {
+    globalThis.fetch = mock(async () =>
+      createResponse('Server Error', [], 'text/html', { status: 500 }),
+    ) as typeof fetch
+
+    const http = new TozHttp({ sessionCookie: 'ABC' })
+    await expect(http.get('/index.htm')).rejects.toThrow(/HTTP 500/)
+  })
+
+  test('refuses to follow cross-origin redirects (no cookie leak)', async () => {
+    globalThis.fetch = mock(async (input: RequestInfo | URL) => {
+      const url = String(input)
+      if (url.endsWith('/index.htm')) {
+        return redirectResponse('https://evil.example.com/steal')
+      }
+      throw new Error(`Should not fetch ${url} — cross-origin redirect must be blocked`)
+    }) as typeof fetch
+
+    const http = new TozHttp({ sessionCookie: 'ABC' })
+    await expect(http.get('/index.htm')).rejects.toThrow(/cross-origin redirect/)
+  })
+
+  test('follows same-origin redirects normally', async () => {
+    let hit = 0
+    globalThis.fetch = mock(async (input: RequestInfo | URL) => {
+      const url = String(input)
+      hit += 1
+      if (hit === 1) return redirectResponse(`${TOZ_BASE_URL}/mypage.htm`)
+      expect(url).toBe(`${TOZ_BASE_URL}/mypage.htm`)
+      return createResponse('mypage content')
+    }) as typeof fetch
+
+    const http = new TozHttp({ sessionCookie: 'ABC' })
+    const body = await http.get('/mypage_login_.htm')
+    expect(body).toBe('mypage content')
+    expect(hit).toBe(2)
+  })
+})
+
+function redirectResponse(location: string): Response {
+  const headers = new Headers({ location })
+  const response = new Response(null, { status: 302, headers })
+  Object.defineProperty(response.headers, 'getSetCookie', {
+    value: () => [],
+    configurable: true,
+  })
+  return response
+}
+
+function createResponse(
+  body: string,
+  cookies: string[] = [],
+  contentType = 'text/html',
+  options: { status?: number } = {},
+): Response {
+  const headers = new Headers({ 'Content-Type': contentType })
+  const response = new Response(body, { headers, status: options.status ?? 200 })
+  Object.defineProperty(response.headers, 'getSetCookie', {
+    value: () => cookies,
+    configurable: true,
+  })
+  return response
+}

package/src/toz-http.ts

@@ -0,0 +1,188 @@
+import { TOZ_BASE_URL } from './constants'
+
+const DEFAULT_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'
+const DEFAULT_ACCEPT_LANGUAGE = 'ko,en-US;q=0.9,en;q=0.8'
+
+interface HeadersWithCookieHelpers extends Omit<Headers, 'getSetCookie'> {
+  getSetCookie?: () => string[]
+}
+
+export interface TozHttpOptions {
+  sessionCookie?: string
+  cookies?: Record<string, string>
+}
+
+export interface TozHttpState {
+  cookies: Record<string, string>
+}
+
+export class TozHttp {
+  private cookies = new Map<string, string>()
+
+  constructor(options: TozHttpOptions = {}) {
+    if (options.cookies) {
+      for (const [name, value] of Object.entries(options.cookies)) {
+        this.cookies.set(name, value)
+      }
+    } else if (options.sessionCookie) {
+      this.cookies.set('JSESSIONID', stripJsessionPrefix(options.sessionCookie))
+    }
+  }
+
+  async bootstrap(): Promise<void> {
+    if (this.cookies.has('JSESSIONID')) return
+    await this.get('/index.htm')
+  }
+
+  async get(path: string, params?: Record<string, string>): Promise<string> {
+    const response = await fetch(this.buildUrl(path, params), {
+      method: 'GET',
+      headers: this.buildHeaders(),
+      redirect: 'manual',
+    })
+
+    this.updateFromResponse(response)
+    return this.readFollowingRedirects(response, 'GET')
+  }
+
+  async post(path: string, body: Record<string, string>): Promise<string> {
+    const response = await this.rawPost(path, body)
+    return this.readFollowingRedirects(response, 'POST')
+  }
+
+  async postJson<T>(path: string, body: Record<string, string>): Promise<T> {
+    const text = await this.post(path, body)
+    try {
+      return JSON.parse(text) as T
+    } catch (error) {
+      throw new Error(
+        `Failed to parse JSON response from ${path}: ${error instanceof Error ? error.message : 'unknown'}`,
+      )
+    }
+  }
+
+  async postText(path: string, body: Record<string, string>): Promise<string> {
+    return (await this.post(path, body)).trim()
+  }
+
+  getCookies(): Record<string, string> {
+    return Object.fromEntries(this.cookies)
+  }
+
+  getSessionCookie(): string | undefined {
+    return this.cookies.get('JSESSIONID')
+  }
+
+  getState(): TozHttpState {
+    return { cookies: this.getCookies() }
+  }
+
+  private async rawPost(path: string, body: Record<string, string>): Promise<Response> {
+    const url = this.buildUrl(path)
+    const formBody = new URLSearchParams(body).toString()
+
+    const response = await fetch(url, {
+      method: 'POST',
+      headers: {
+        ...this.buildHeaders(),
+        'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8',
+        'X-Requested-With': 'XMLHttpRequest',
+        Referer: this.buildUrl('/booking.htm'),
+      },
+      body: formBody,
+      redirect: 'manual',
+    })
+
+    this.updateFromResponse(response)
+    return response
+  }
+
+  private async readFollowingRedirects(initial: Response, method: string): Promise<string> {
+    let response = initial
+    let hops = 0
+
+    while (response.status >= 300 && response.status < 400 && hops < 5) {
+      const location = response.headers.get('location')
+      if (!location) break
+      const redirectUrl = location.startsWith('http') ? location : new URL(location, `${TOZ_BASE_URL}/`).toString()
+      if (!isSameOrigin(redirectUrl, TOZ_BASE_URL)) {
+        throw new Error(`Refusing to follow cross-origin redirect to ${new URL(redirectUrl).origin}`)
+      }
+      response = await fetch(redirectUrl, {
+        method: 'GET',
+        headers: this.buildHeaders(),
+        redirect: 'manual',
+      })
+      this.updateFromResponse(response)
+      hops += 1
+    }
+
+    if (!response.ok) {
+      throw new Error(`Toz ${method} ${initial.url} failed: HTTP ${response.status} ${response.statusText}`)
+    }
+
+    return response.text()
+  }
+
+  private buildUrl(path: string, params?: Record<string, string>): string {
+    const normalized = path.startsWith('/') ? path.slice(1) : path
+    const url = new URL(normalized, `${TOZ_BASE_URL}/`)
+    if (params) {
+      for (const [key, value] of Object.entries(params)) {
+        url.searchParams.set(key, value)
+      }
+    }
+    return url.toString()
+  }
+
+  private buildHeaders(): Record<string, string> {
+    const cookieHeader = this.serializeCookies()
+    return {
+      'Accept-Language': DEFAULT_ACCEPT_LANGUAGE,
+      'User-Agent': DEFAULT_USER_AGENT,
+      ...(cookieHeader ? { cookie: cookieHeader } : {}),
+    }
+  }
+
+  private updateFromResponse(response: Response): void {
+    for (const cookie of readSetCookies(response.headers)) {
+      this.setCookie(cookie)
+    }
+  }
+
+  private setCookie(cookieHeader: string): void {
+    const pair = cookieHeader.split(';')[0]?.trim()
+    if (!pair) return
+    const idx = pair.indexOf('=')
+    if (idx === -1) return
+    const name = pair.slice(0, idx).trim()
+    const value = pair.slice(idx + 1).trim()
+    if (name) this.cookies.set(name, value)
+  }
+
+  private serializeCookies(): string {
+    return [...this.cookies.entries()].map(([name, value]) => `${name}=${value}`).join('; ')
+  }
+}
+
+function stripJsessionPrefix(cookie: string): string {
+  return cookie.includes('=') ? (cookie.split('=', 2)[1] ?? cookie) : cookie
+}
+
+function isSameOrigin(url: string, baseUrl: string): boolean {
+  try {
+    return new URL(url).origin === new URL(baseUrl).origin
+  } catch {
+    return false
+  }
+}
+
+function readSetCookies(headers: Headers): string[] {
+  const enhanced = headers as HeadersWithCookieHelpers
+  if (typeof enhanced.getSetCookie === 'function') {
+    return enhanced.getSetCookie()
+  }
+  const single = headers.get('set-cookie')
+  return single ? [single] : []
+}

package/src/types.test.ts

@@ -63,7 +63,10 @@ describe('schemas', () => {
         capacity: 4,
         availablePeriod: { start: '2026-04-01', end: '2026-12-31' },
         description: '소회의실 : 4인',
-        timeSlots: [{ time: '09:00', available: true }],
+        timeSlots: [
+          { time: '09:00', available: true },
+          { time: '09:30', available: false, reservation: { title: '팀 회의', bookedBy: '전수열' } },
+        ],
       }),
     ).toBeDefined()
 

package/src/types.ts

@@ -2,7 +2,12 @@ import { z } from 'zod/v4'
 
 const DateRangeSchema = z.object({ start: z.string(), end: z.string() })
 const TimeRangeSchema = z.object({ start: z.string(), end: z.string() })
-const RoomTimeSlotSchema = z.object({ time: z.string(), available: z.boolean() })
+const RoomTimeSlotReservationSchema = z.object({ title: z.string(), bookedBy: z.string() })
+const RoomTimeSlotSchema = z.object({
+  time: z.string(),
+  available: z.boolean(),
+  reservation: RoomTimeSlotReservationSchema.optional(),
+})
 const DashboardStatusItemSchema = z.object({
   title: z.string(),
   url: z.string(),
@@ -146,9 +151,67 @@ export const CredentialsSchema = z.object({
   username: z.string().optional(),
   password: z.string().optional(),
   loggedInAt: z.string().optional(),
+  tozName: z.string().optional(),
+  tozPhone: z.string().optional(),
 })
 export type Credentials = z.infer<typeof CredentialsSchema>
 
+export const TozBranchSchema = z.object({
+  id: z.number(),
+  name: z.string(),
+})
+export type TozBranch = z.infer<typeof TozBranchSchema>
+
+export const TozMeetingSchema = z.object({
+  id: z.number(),
+  name: z.string(),
+})
+export type TozMeeting = z.infer<typeof TozMeetingSchema>
+
+export const TozDurationSchema = z.object({
+  key: z.string(),
+  value: z.string(),
+  minutes: z.number(),
+})
+export type TozDuration = z.infer<typeof TozDurationSchema>
+
+export const TozBoothSchema = z.object({
+  id: z.number(),
+  name: z.string(),
+  branchName: z.string(),
+  branchTel: z.string(),
+  minUseUserCount: z.number(),
+  enableMaxUserCount: z.number(),
+  boothGroupName: z.string(),
+  boothGroupUrl: z.string().nullable(),
+  boothMemoForUser: z.string(),
+  isLargeBooth: z.boolean(),
+})
+export type TozBooth = z.infer<typeof TozBoothSchema>
+
+export const TozReservedSchema = z.object({
+  reservationId: z.string(),
+  branchName: z.string(),
+  branchTel: z.string(),
+  boothGroupName: z.string(),
+  isLargeBooth: z.boolean(),
+})
+export type TozReserved = z.infer<typeof TozReservedSchema>
+
+export const TozReservationSchema = z.object({
+  no: z.number(),
+  reservationId: z.number().nullable(),
+  meetingName: z.string(),
+  date: z.string(),
+  startTime: z.string(),
+  endTime: z.string(),
+  branchName: z.string(),
+  boothName: z.string(),
+  reservedAt: z.string(),
+  status: z.string(),
+})
+export type TozReservation = z.infer<typeof TozReservationSchema>
+
 export const ReportListItemSchema = z.object({
   id: z.number(),
   category: z.string(),
@@ -222,3 +285,20 @@ export const ReportUpdateOptionsSchema = ReportCreateOptionsSchema.partial().ext
   id: z.number(),
 })
 export type ReportUpdateOptions = z.infer<typeof ReportUpdateOptionsSchema>
+
+export const MentoringCreateOptionsSchema = z.object({
+  title: z.string(),
+  type: z.enum(['public', 'lecture']),
+  date: z.string(),
+  startTime: z.string(),
+  endTime: z.string(),
+  venue: z.string(),
+  maxAttendees: z.number().optional(),
+  regStart: z.string().optional(),
+  regEnd: z.string().optional(),
+  content: z.string().optional(),
+})
+export type MentoringCreateOptions = z.infer<typeof MentoringCreateOptionsSchema>
+
+export const MentoringUpdateOptionsSchema = MentoringCreateOptionsSchema.partial()
+export type MentoringUpdateOptions = z.infer<typeof MentoringUpdateOptionsSchema>