poi-plugin-mcp 0.2.16 → 0.2.21

package/lib/poi-telemetry.js

@@ -1,439 +1,515 @@
-const { createPoiActionEvents } = require('./poi-action-events')
-
-const QUEST_LIST_PATH = '/kcsapi/api_get_member/questlist'
-const UNSET_SLOT_PATH = '/kcsapi/api_get_member/unsetslot'
-const QUEST_ACTION_PATHS = new Set([
-  '/kcsapi/api_req_quest/start',
-  '/kcsapi/api_req_quest/stop',
-])
-const EQUIPMENT_ACTION_PATHS = new Set([
-  '/kcsapi/api_req_kaisou/slotset',
-  '/kcsapi/api_req_kaisou/slotset_ex',
-  '/kcsapi/api_req_kaisou/slot_deprive',
-  '/kcsapi/api_req_kaisou/unsetslot_all',
-])
-const FLEET_ACTION_PATH = '/kcsapi/api_req_hensei/change'
-const BATTLE_RESULT_PATHS = new Set([
-  '/kcsapi/api_req_practice/battle_result',
-  '/kcsapi/api_req_sortie/battleresult',
-  '/kcsapi/api_req_combined_battle/battleresult',
-])
-const BATTLE_PATHS = new Set([
-  '/kcsapi/api_req_practice/battle',
-  '/kcsapi/api_req_practice/midnight_battle',
-  '/kcsapi/api_req_sortie/battle',
-  '/kcsapi/api_req_sortie/airbattle',
-  '/kcsapi/api_req_sortie/ld_airbattle',
-  '/kcsapi/api_req_sortie/ld_shooting',
-  '/kcsapi/api_req_battle_midnight/battle',
-  '/kcsapi/api_req_battle_midnight/sp_midnight',
-  '/kcsapi/api_req_combined_battle/battle',
-  '/kcsapi/api_req_combined_battle/battle_water',
-  '/kcsapi/api_req_combined_battle/airbattle',
-  '/kcsapi/api_req_combined_battle/ld_airbattle',
-  '/kcsapi/api_req_combined_battle/ld_shooting',
-  '/kcsapi/api_req_combined_battle/ec_battle',
-  '/kcsapi/api_req_combined_battle/each_battle',
-  '/kcsapi/api_req_combined_battle/each_battle_water',
-  '/kcsapi/api_req_combined_battle/midnight_battle',
-  '/kcsapi/api_req_combined_battle/sp_midnight',
-  '/kcsapi/api_req_combined_battle/ec_midnight_battle',
-  '/kcsapi/api_req_combined_battle/ec_night_to_day',
-])
-
-function createPoiTelemetry(options = {}) {
-  const now = options.now || (() => new Date())
-  const actionEvents = createPoiActionEvents({ now })
-  let questGeneration = 0
-  let questList = null
-  let questActionGeneration = 0
-  let questAction = null
-  let equipmentActionGeneration = 0
-  let equipmentAction = null
-  let unsetSlotGeneration = 0
-  let unsetSlot = null
-  let fleetActionGeneration = 0
-  let fleetAction = null
-  let battleGeneration = 0
-  let battleTelemetry = null
-
-  function handleGameResponse(event) {
-    const detail = event && event.detail
-    if (!detail || typeof detail.path !== 'string') return
-    const actionEvent = actionEvents.capture(detail)
-
-    if (detail.path === QUEST_LIST_PATH) {
-      captureQuestList(detail, actionEvent)
-      return
-    }
-    if (detail.path === UNSET_SLOT_PATH) {
-      captureUnsetSlot(detail, actionEvent)
-      return
-    }
-    if (QUEST_ACTION_PATHS.has(detail.path)) {
-      captureQuestAction(detail, actionEvent)
-      return
-    }
-    if (EQUIPMENT_ACTION_PATHS.has(detail.path)) {
-      captureEquipmentAction(detail, actionEvent)
-      return
-    }
-    if (detail.path === FLEET_ACTION_PATH) {
-      captureFleetAction(detail, actionEvent)
-      return
-    }
-    if (BATTLE_RESULT_PATHS.has(detail.path)) {
-      captureBattleResult(detail)
-      return
-    }
-    if (BATTLE_PATHS.has(detail.path)) {
-      captureBattlePacket(detail)
-    }
-  }
-
-  function captureQuestList(detail, actionEvent) {
-    const body = detail.body
-    const postBody = detail.postBody
-    const tabId = toInteger(postBody && postBody.api_tab_id)
-    if (
-      !body ||
-      !Array.isArray(body.api_list) ||
-      tabId == null ||
-      tabId < 0 ||
-      tabId > 9
-    ) {
-      return
-    }
-
-    const quests = body.api_list.flatMap((quest, index) => {
-      if (!quest || typeof quest !== 'object' || !Number.isInteger(quest.api_no)) {
-        return []
-      }
-      return [{ ...quest, listIndex: index + 1 }]
-    })
-
-    questGeneration += 1
-    questList = {
-      available: true,
-      generation: questGeneration,
-      capturedAt: actionEvent
-        ? actionEvent.capturedAt
-        : now().toISOString(),
-      tabId,
-      pageNo: nonNegativeInteger(body.api_disp_page),
-      pageCount: nonNegativeInteger(body.api_page_count),
-      count: nonNegativeInteger(body.api_count),
-      execCount: nonNegativeInteger(body.api_exec_count),
-      execType: nonNegativeInteger(body.api_exec_type),
-      quests,
-    }
-  }
-
-  function captureQuestAction(detail, actionEvent) {
-    const apiResult = actionEvent
-      ? actionEvent.apiResult
-      : equipmentApiResult(detail)
-    if (apiResult !== 1) return
-    const postBody = detail.postBody
-    const questId = toInteger(postBody && postBody.api_quest_id)
-    if (questId == null || questId <= 0) return
-
-    questActionGeneration += 1
-    questAction = {
-      available: true,
-      generation: questActionGeneration,
-      capturedAt: actionEvent
-        ? actionEvent.capturedAt
-        : now().toISOString(),
-      path: actionEvent ? actionEvent.path : detail.path,
-      questId,
-      flag: toInteger(postBody && postBody.api_quest_flag),
-      apiResult,
-    }
-  }
-
-  function captureEquipmentAction(detail, actionEvent) {
-    const apiResult = actionEvent
-      ? actionEvent.apiResult
-      : equipmentApiResult(detail)
-    if (apiResult === 0) return
-    const postBody = normalizeEquipmentPostBody(detail.path, detail.postBody)
-    if (!postBody) return
-
-    equipmentActionGeneration += 1
-    equipmentAction = {
-      available: true,
-      generation: equipmentActionGeneration,
-      capturedAt: actionEvent
-        ? actionEvent.capturedAt
-        : now().toISOString(),
-      path: actionEvent ? actionEvent.path : detail.path,
-      apiResult,
-      postBody,
-    }
-  }
-
-  function captureUnsetSlot(detail, actionEvent) {
-    const bySlotType = normalizeUnsetSlotBody(detail.body)
-    if (bySlotType == null) return
-
-    unsetSlotGeneration += 1
-    unsetSlot = {
-      available: true,
-      generation: unsetSlotGeneration,
-      capturedAt: actionEvent
-        ? actionEvent.capturedAt
-        : now().toISOString(),
-      bySlotType,
-      equipmentIds: Object.values(bySlotType)
-        .flatMap((groups) => Object.values(groups))
-        .flat(),
-    }
-  }
-
-  function captureFleetAction(detail, actionEvent) {
-    const apiResult = actionEvent
-      ? actionEvent.apiResult
-      : equipmentApiResult(detail)
-    if (apiResult === 0) return
-    const postBody = normalizeFleetPostBody(detail.postBody)
-    if (!postBody) return
-
-    fleetActionGeneration += 1
-    fleetAction = {
-      available: true,
-      generation: fleetActionGeneration,
-      capturedAt: actionEvent
-        ? actionEvent.capturedAt
-        : now().toISOString(),
-      path: actionEvent ? actionEvent.path : detail.path,
-      apiResult,
-      postBody,
-    }
-  }
-
-  function captureBattlePacket(detail) {
-    if (!battleTelemetry || battleTelemetry.status === 'settled') {
-      battleGeneration += 1
-    }
-    battleTelemetry = {
-      available: true,
-      generation: battleGeneration,
-      status: 'in_progress',
-      observed: {
-        capturedAt: now().toISOString(),
-        path: detail.path,
-        time: finiteOrNull(detail.time),
-        phaseStartHp: {
-          friendlyMain: numberArray(detail.body && detail.body.api_f_nowhps),
-          friendlyEscort: numberArray(
-            detail.body && detail.body.api_f_nowhps_combined,
-          ),
-          enemyMain: numberArray(detail.body && detail.body.api_e_nowhps),
-          enemyEscort: numberArray(
-            detail.body && detail.body.api_e_nowhps_combined,
-          ),
-        },
-      },
-      official: null,
-    }
-  }
-
-  function captureBattleResult(detail) {
-    if (!battleTelemetry) battleGeneration += 1
-    const body = detail.body && typeof detail.body === 'object'
-      ? detail.body
-      : {}
-    battleTelemetry = {
-      available: true,
-      generation: battleGeneration,
-      status: 'settled',
-      observed: battleTelemetry ? battleTelemetry.observed : null,
-      official: {
-        capturedAt: now().toISOString(),
-        path: detail.path,
-        time: finiteOrNull(detail.time),
-        rank: typeof body.api_win_rank === 'string' ? body.api_win_rank : null,
-        mvpPosition: {
-          main: positiveIntegerOrNull(body.api_mvp),
-          escort: positiveIntegerOrNull(body.api_mvp_combined),
-        },
-        drop: {
-          ship: objectOrNull(body.api_get_ship),
-          useItem: objectOrNull(body.api_get_useitem),
-        },
-      },
-    }
-  }
-
-  return {
-    handleGameResponse,
-    getQuestList() {
-      return questList || { available: false, generation: 0 }
-    },
-    getQuestAction() {
-      return questAction || { available: false, generation: 0 }
-    },
-    getEquipmentAction() {
-      return equipmentAction || { available: false, generation: 0 }
-    },
-    getUnsetSlot() {
-      return unsetSlot || { available: false, generation: 0 }
-    },
-    getFleetAction() {
-      return fleetAction || { available: false, generation: 0 }
-    },
-    getActionEvents(options) {
-      return actionEvents.read(options)
-    },
-    getBattleTelemetry() {
-      return battleTelemetry || { available: false, generation: 0 }
-    },
-  }
-}
-
-function normalizeUnsetSlotBody(body) {
-  if (!body || typeof body !== 'object' || Array.isArray(body)) return null
-  const source = body.api_data &&
-    typeof body.api_data === 'object' &&
-    !Array.isArray(body.api_data)
-    ? body.api_data
-    : body
-  const output = {}
-  let totalIds = 0
-
-  for (const [slotType, groups] of Object.entries(source)) {
-    if (!/^api_slottype\d+$/.test(slotType)) continue
-    if (!groups || typeof groups !== 'object' || Array.isArray(groups)) continue
-    const normalizedGroups = {}
-    for (const [groupId, ids] of Object.entries(groups)) {
-      if (!/^\d+$/.test(groupId) || !Array.isArray(ids)) continue
-      const normalizedIds = ids
-        .map(positiveIntegerOrNull)
-        .filter((id) => id != null)
-      totalIds += normalizedIds.length
-      if (totalIds > 10000) return null
-      normalizedGroups[groupId] = normalizedIds
-    }
-    if (Object.keys(normalizedGroups).length > 0) {
-      output[slotType] = normalizedGroups
-    }
-  }
-  return Object.keys(output).length > 0 ? output : null
-}
-
-function normalizeFleetPostBody(postBody) {
-  if (!postBody || typeof postBody !== 'object') return null
-  const fleetId = boundedInteger(postBody.api_id, 1, 4)
-  const shipIndex = boundedInteger(postBody.api_ship_idx, 0, 5)
-  const shipId = boundedInteger(postBody.api_ship_id, -1)
-  if (fleetId == null || shipIndex == null || shipId == null) return null
-  return {
-    api_id: fleetId,
-    api_ship_idx: shipIndex,
-    api_ship_id: shipId,
-  }
-}
-
-function normalizeEquipmentPostBody(path, postBody) {
-  if (!postBody || typeof postBody !== 'object') return null
-  if (path === '/kcsapi/api_req_kaisou/slotset') {
-    const shipId = positiveIntegerOrNull(postBody.api_id)
-    const slotIndex = boundedInteger(postBody.api_slot_idx, 0, 4)
-    const itemId = boundedInteger(postBody.api_item_id, -1)
-    if (shipId == null || slotIndex == null || itemId == null) return null
-    return {
-      api_id: shipId,
-      api_slot_idx: slotIndex,
-      api_item_id: itemId,
-    }
-  }
-  if (path === '/kcsapi/api_req_kaisou/slotset_ex') {
-    const shipId = positiveIntegerOrNull(postBody.api_id)
-    const itemId = boundedInteger(postBody.api_item_id, -1)
-    if (shipId == null || itemId == null) return null
-    return {
-      api_id: shipId,
-      api_item_id: itemId,
-    }
-  }
-  if (path === '/kcsapi/api_req_kaisou/slot_deprive') {
-    const setShip = positiveIntegerOrNull(postBody.api_set_ship)
-    const unsetShip = positiveIntegerOrNull(postBody.api_unset_ship)
-    const setIndex = boundedInteger(postBody.api_set_idx, -1, 4)
-    const unsetIndex = boundedInteger(postBody.api_unset_idx, -1, 4)
-    if (
-      setShip == null ||
-      unsetShip == null ||
-      setIndex == null ||
-      unsetIndex == null
-    ) {
-      return null
-    }
-    return {
-      api_set_ship: setShip,
-      api_unset_ship: unsetShip,
-      api_set_idx: setIndex,
-      api_unset_idx: unsetIndex,
-    }
-  }
-  if (path === '/kcsapi/api_req_kaisou/unsetslot_all') {
-    const shipId = positiveIntegerOrNull(postBody.api_id)
-    return shipId == null ? null : { api_id: shipId }
-  }
-  return null
-}
-
-function equipmentApiResult(detail) {
-  const candidates = [
-    detail.apiResult,
-    detail.api_result,
-    detail.result,
-    detail.body && detail.body.api_result,
-  ]
-  for (const candidate of candidates) {
-    const value = toInteger(candidate)
-    if (value != null) return value === 1 ? 1 : 0
-  }
-  return null
-}
-
-function boundedInteger(value, minimum, maximum = Number.MAX_SAFE_INTEGER) {
-  const parsed = toInteger(value)
-  return parsed != null && parsed >= minimum && parsed <= maximum
-    ? parsed
-    : null
-}
-
-function toInteger(value, fallback = null) {
-  if (value == null || value === '') return fallback
-  const parsed = Number(value)
-  return Number.isInteger(parsed) ? parsed : null
-}
-
-function nonNegativeInteger(value) {
-  const parsed = toInteger(value, 0)
-  return parsed != null && parsed >= 0 ? parsed : 0
-}
-
-function positiveIntegerOrNull(value) {
-  const parsed = toInteger(value)
-  return parsed != null && parsed > 0 ? parsed : null
-}
-
-function finiteOrNull(value) {
-  return Number.isFinite(value) ? value : null
-}
-
-function numberArray(value) {
-  if (!Array.isArray(value)) return []
-  return value.map((item) => finiteOrNull(item))
-}
-
-function objectOrNull(value) {
-  return value && typeof value === 'object' ? { ...value } : null
-}
-
-module.exports = {
-  createPoiTelemetry,
-}
+const { createPoiActionEvents } = require('./poi-action-events')
+const { createPoiApiResponses } = require('./poi-api-responses')
+
+const QUEST_LIST_PATH = '/kcsapi/api_get_member/questlist'
+const UNSET_SLOT_PATH = '/kcsapi/api_get_member/unsetslot'
+const EQUIPMENT_SELECTION_PATH = '/kcsapi/api_req_kaisou/slot_select'
+const QUEST_ACTION_PATHS = new Set([
+  '/kcsapi/api_req_quest/start',
+  '/kcsapi/api_req_quest/stop',
+  '/kcsapi/api_req_quest/clearitemget',
+])
+const EQUIPMENT_ACTION_PATHS = new Set([
+  '/kcsapi/api_req_kaisou/slotset',
+  '/kcsapi/api_req_kaisou/slotset_ex',
+  '/kcsapi/api_req_kaisou/slot_deprive',
+  '/kcsapi/api_req_kaisou/unsetslot_all',
+])
+const FLEET_ACTION_PATH = '/kcsapi/api_req_hensei/change'
+const BATTLE_RESULT_PATHS = new Set([
+  '/kcsapi/api_req_practice/battle_result',
+  '/kcsapi/api_req_sortie/battleresult',
+  '/kcsapi/api_req_combined_battle/battleresult',
+])
+const BATTLE_PATHS = new Set([
+  '/kcsapi/api_req_practice/battle',
+  '/kcsapi/api_req_practice/midnight_battle',
+  '/kcsapi/api_req_sortie/battle',
+  '/kcsapi/api_req_sortie/airbattle',
+  '/kcsapi/api_req_sortie/ld_airbattle',
+  '/kcsapi/api_req_sortie/ld_shooting',
+  '/kcsapi/api_req_battle_midnight/battle',
+  '/kcsapi/api_req_battle_midnight/sp_midnight',
+  '/kcsapi/api_req_combined_battle/battle',
+  '/kcsapi/api_req_combined_battle/battle_water',
+  '/kcsapi/api_req_combined_battle/airbattle',
+  '/kcsapi/api_req_combined_battle/ld_airbattle',
+  '/kcsapi/api_req_combined_battle/ld_shooting',
+  '/kcsapi/api_req_combined_battle/ec_battle',
+  '/kcsapi/api_req_combined_battle/each_battle',
+  '/kcsapi/api_req_combined_battle/each_battle_water',
+  '/kcsapi/api_req_combined_battle/midnight_battle',
+  '/kcsapi/api_req_combined_battle/sp_midnight',
+  '/kcsapi/api_req_combined_battle/ec_midnight_battle',
+  '/kcsapi/api_req_combined_battle/ec_night_to_day',
+])
+
+function createPoiTelemetry(options = {}) {
+  const now = options.now || (() => new Date())
+  const actionEvents = createPoiActionEvents({ now })
+  const apiResponses = createPoiApiResponses({ now })
+  let questGeneration = 0
+  let questList = null
+  let questActionGeneration = 0
+  let questAction = null
+  let equipmentActionGeneration = 0
+  let equipmentAction = null
+  let equipmentSelectionGeneration = 0
+  let equipmentSelection = null
+  let unsetSlotGeneration = 0
+  let unsetSlot = null
+  let fleetActionGeneration = 0
+  let fleetAction = null
+  let battleGeneration = 0
+  let battleTelemetry = null
+
+  function handleGameResponse(event) {
+    const detail = event && event.detail
+    if (!detail || typeof detail.path !== 'string') return
+    const actionEvent = actionEvents.capture(detail)
+    apiResponses.capture(detail, actionEvent && actionEvent.capturedAt)
+
+    if (detail.path === QUEST_LIST_PATH) {
+      captureQuestList(detail, actionEvent)
+      return
+    }
+    if (detail.path === UNSET_SLOT_PATH) {
+      captureUnsetSlot(detail, actionEvent)
+      return
+    }
+    if (detail.path === EQUIPMENT_SELECTION_PATH) {
+      captureEquipmentSelection(detail, actionEvent)
+      return
+    }
+    if (QUEST_ACTION_PATHS.has(detail.path)) {
+      captureQuestAction(detail, actionEvent)
+      return
+    }
+    if (EQUIPMENT_ACTION_PATHS.has(detail.path)) {
+      captureEquipmentAction(detail, actionEvent)
+      return
+    }
+    if (detail.path === FLEET_ACTION_PATH) {
+      captureFleetAction(detail, actionEvent)
+      return
+    }
+    if (BATTLE_RESULT_PATHS.has(detail.path)) {
+      captureBattleResult(detail)
+      return
+    }
+    if (BATTLE_PATHS.has(detail.path)) {
+      captureBattlePacket(detail)
+    }
+  }
+
+  function captureQuestList(detail, actionEvent) {
+    const body = detail.body
+    const postBody = detail.postBody
+    const tabId = toInteger(postBody && postBody.api_tab_id)
+    if (
+      !body ||
+      !Array.isArray(body.api_list) ||
+      tabId == null ||
+      tabId < 0 ||
+      tabId > 9
+    ) {
+      return
+    }
+
+    const quests = body.api_list.flatMap((quest, index) => {
+      if (!quest || typeof quest !== 'object' || !Number.isInteger(quest.api_no)) {
+        return []
+      }
+      return [{ ...quest, listIndex: index + 1 }]
+    })
+
+    questGeneration += 1
+    questList = {
+      available: true,
+      generation: questGeneration,
+      capturedAt: actionEvent
+        ? actionEvent.capturedAt
+        : now().toISOString(),
+      tabId,
+      pageNo: nonNegativeInteger(body.api_disp_page),
+      pageCount: nonNegativeInteger(body.api_page_count),
+      count: nonNegativeInteger(body.api_count),
+      execCount: nonNegativeInteger(body.api_exec_count),
+      execType: nonNegativeInteger(body.api_exec_type),
+      quests,
+    }
+  }
+
+  function captureQuestAction(detail, actionEvent) {
+    const apiResult = actionEvent
+      ? actionEvent.apiResult
+      : equipmentApiResult(detail)
+    if (apiResult !== 1) return
+    const postBody = detail.postBody
+    const questId = toInteger(postBody && postBody.api_quest_id)
+    if (questId == null || questId <= 0) return
+
+    questActionGeneration += 1
+    questAction = {
+      available: true,
+      generation: questActionGeneration,
+      capturedAt: actionEvent
+        ? actionEvent.capturedAt
+        : now().toISOString(),
+      path: actionEvent ? actionEvent.path : detail.path,
+      questId,
+      flag: toInteger(postBody && postBody.api_quest_flag),
+      selectedKind: selectedKindOf(postBody),
+      apiResult,
+    }
+  }
+
+  function captureEquipmentAction(detail, actionEvent) {
+    const apiResult = actionEvent
+      ? actionEvent.apiResult
+      : equipmentApiResult(detail)
+    if (apiResult === 0) return
+    const postBody = normalizeEquipmentPostBody(detail.path, detail.postBody)
+    if (!postBody) return
+
+    equipmentActionGeneration += 1
+    equipmentAction = {
+      available: true,
+      generation: equipmentActionGeneration,
+      capturedAt: actionEvent
+        ? actionEvent.capturedAt
+        : now().toISOString(),
+      path: actionEvent ? actionEvent.path : detail.path,
+      apiResult,
+      postBody,
+    }
+  }
+
+  function captureUnsetSlot(detail, actionEvent) {
+    const bySlotType = normalizeUnsetSlotBody(detail.body)
+    if (bySlotType == null) return
+
+    unsetSlotGeneration += 1
+    unsetSlot = {
+      available: true,
+      generation: unsetSlotGeneration,
+      capturedAt: actionEvent
+        ? actionEvent.capturedAt
+        : now().toISOString(),
+      bySlotType,
+      equipmentIds: Object.values(bySlotType)
+        .flatMap((groups) => Object.values(groups))
+        .flat(),
+    }
+  }
+
+  function captureEquipmentSelection(detail, actionEvent) {
+    const equipmentIds = normalizeEquipmentSelectionBody(detail.body)
+    if (equipmentIds == null) return
+    const postBody = normalizeEquipmentSelectionPostBody(detail.postBody)
+    if (!postBody) return
+
+    equipmentSelectionGeneration += 1
+    equipmentSelection = {
+      available: true,
+      generation: equipmentSelectionGeneration,
+      capturedAt: actionEvent
+        ? actionEvent.capturedAt
+        : now().toISOString(),
+      path: actionEvent ? actionEvent.path : detail.path,
+      postBody,
+      equipmentIds,
+      count: equipmentIds.length,
+    }
+  }
+
+  function captureFleetAction(detail, actionEvent) {
+    const apiResult = actionEvent
+      ? actionEvent.apiResult
+      : equipmentApiResult(detail)
+    if (apiResult === 0) return
+    const postBody = normalizeFleetPostBody(detail.postBody)
+    if (!postBody) return
+
+    fleetActionGeneration += 1
+    fleetAction = {
+      available: true,
+      generation: fleetActionGeneration,
+      capturedAt: actionEvent
+        ? actionEvent.capturedAt
+        : now().toISOString(),
+      path: actionEvent ? actionEvent.path : detail.path,
+      apiResult,
+      postBody,
+    }
+  }
+
+  function captureBattlePacket(detail) {
+    if (!battleTelemetry || battleTelemetry.status === 'settled') {
+      battleGeneration += 1
+    }
+    battleTelemetry = {
+      available: true,
+      generation: battleGeneration,
+      status: 'in_progress',
+      observed: {
+        capturedAt: now().toISOString(),
+        path: detail.path,
+        time: finiteOrNull(detail.time),
+        phaseStartHp: {
+          friendlyMain: numberArray(detail.body && detail.body.api_f_nowhps),
+          friendlyEscort: numberArray(
+            detail.body && detail.body.api_f_nowhps_combined,
+          ),
+          enemyMain: numberArray(detail.body && detail.body.api_e_nowhps),
+          enemyEscort: numberArray(
+            detail.body && detail.body.api_e_nowhps_combined,
+          ),
+        },
+      },
+      official: null,
+    }
+  }
+
+  function captureBattleResult(detail) {
+    if (!battleTelemetry) battleGeneration += 1
+    const body = detail.body && typeof detail.body === 'object'
+      ? detail.body
+      : {}
+    battleTelemetry = {
+      available: true,
+      generation: battleGeneration,
+      status: 'settled',
+      observed: battleTelemetry ? battleTelemetry.observed : null,
+      official: {
+        capturedAt: now().toISOString(),
+        path: detail.path,
+        time: finiteOrNull(detail.time),
+        rank: typeof body.api_win_rank === 'string' ? body.api_win_rank : null,
+        mvpPosition: {
+          main: positiveIntegerOrNull(body.api_mvp),
+          escort: positiveIntegerOrNull(body.api_mvp_combined),
+        },
+        drop: {
+          ship: objectOrNull(body.api_get_ship),
+          useItem: objectOrNull(body.api_get_useitem),
+        },
+      },
+    }
+  }
+
+  return {
+    handleGameResponse,
+    getQuestList() {
+      return questList || { available: false, generation: 0 }
+    },
+    getQuestAction() {
+      return questAction || { available: false, generation: 0 }
+    },
+    getEquipmentAction() {
+      return equipmentAction || { available: false, generation: 0 }
+    },
+    getEquipmentSelection() {
+      return equipmentSelection || { available: false, generation: 0 }
+    },
+    getUnsetSlot() {
+      return unsetSlot || { available: false, generation: 0 }
+    },
+    getFleetAction() {
+      return fleetAction || { available: false, generation: 0 }
+    },
+    getActionEvents(options) {
+      return actionEvents.read(options)
+    },
+    getActionEventsWait(options) {
+      return actionEvents.wait(options)
+    },
+    getApiResponses(options) {
+      return apiResponses.read(options)
+    },
+    getBattleTelemetry() {
+      return battleTelemetry || { available: false, generation: 0 }
+    },
+  }
+}
+
+function normalizeEquipmentSelectionBody(body) {
+  if (!body || typeof body !== 'object' || Array.isArray(body)) return null
+  const source = body.api_data &&
+    typeof body.api_data === 'object' &&
+    !Array.isArray(body.api_data)
+    ? body.api_data
+    : body
+  if (!Array.isArray(source.api_slotitem)) return null
+  const ids = source.api_slotitem
+    .map((item) => item && typeof item === 'object' && !Array.isArray(item)
+      ? positiveIntegerOrNull(item.api_id)
+      : null)
+  if (ids.some((id) => id == null) || ids.length > 10000) return null
+  return ids
+}
+
+function normalizeEquipmentSelectionPostBody(postBody) {
+  if (!postBody || typeof postBody !== 'object') return null
+  const shipId = positiveIntegerOrNull(postBody.api_id)
+  const slotIndex = boundedInteger(postBody.api_slot_idx, 0, 5)
+  if (shipId == null || slotIndex == null) return null
+  return {
+    api_id: shipId,
+    api_slot_idx: slotIndex,
+  }
+}
+
+function normalizeUnsetSlotBody(body) {
+  if (!body || typeof body !== 'object' || Array.isArray(body)) return null
+  const source = body.api_data &&
+    typeof body.api_data === 'object' &&
+    !Array.isArray(body.api_data)
+    ? body.api_data
+    : body
+  const output = {}
+  let totalIds = 0
+
+  for (const [slotType, groups] of Object.entries(source)) {
+    if (!/^api_slottype\d+$/.test(slotType)) continue
+    if (!groups || typeof groups !== 'object' || Array.isArray(groups)) continue
+    const normalizedGroups = {}
+    for (const [groupId, ids] of Object.entries(groups)) {
+      if (!/^\d+$/.test(groupId) || !Array.isArray(ids)) continue
+      const normalizedIds = ids
+        .map(positiveIntegerOrNull)
+        .filter((id) => id != null)
+      totalIds += normalizedIds.length
+      if (totalIds > 10000) return null
+      normalizedGroups[groupId] = normalizedIds
+    }
+    if (Object.keys(normalizedGroups).length > 0) {
+      output[slotType] = normalizedGroups
+    }
+  }
+  return Object.keys(output).length > 0 ? output : null
+}
+
+function normalizeFleetPostBody(postBody) {
+  if (!postBody || typeof postBody !== 'object') return null
+  const fleetId = boundedInteger(postBody.api_id, 1, 4)
+  const shipIndex = boundedInteger(postBody.api_ship_idx, 0, 5)
+  const shipId = boundedInteger(postBody.api_ship_id, -1)
+  if (fleetId == null || shipIndex == null || shipId == null) return null
+  return {
+    api_id: fleetId,
+    api_ship_idx: shipIndex,
+    api_ship_id: shipId,
+  }
+}
+
+function normalizeEquipmentPostBody(path, postBody) {
+  if (!postBody || typeof postBody !== 'object') return null
+  if (path === '/kcsapi/api_req_kaisou/slotset') {
+    const shipId = positiveIntegerOrNull(postBody.api_id)
+    const slotIndex = boundedInteger(postBody.api_slot_idx, 0, 4)
+    const itemId = boundedInteger(postBody.api_item_id, -1)
+    if (shipId == null || slotIndex == null || itemId == null) return null
+    return {
+      api_id: shipId,
+      api_slot_idx: slotIndex,
+      api_item_id: itemId,
+    }
+  }
+  if (path === '/kcsapi/api_req_kaisou/slotset_ex') {
+    const shipId = positiveIntegerOrNull(postBody.api_id)
+    const itemId = boundedInteger(postBody.api_item_id, -1)
+    if (shipId == null || itemId == null) return null
+    return {
+      api_id: shipId,
+      api_item_id: itemId,
+    }
+  }
+  if (path === '/kcsapi/api_req_kaisou/slot_deprive') {
+    const setShip = positiveIntegerOrNull(postBody.api_set_ship)
+    const unsetShip = positiveIntegerOrNull(postBody.api_unset_ship)
+    const setIndex = boundedInteger(postBody.api_set_idx, -1, 4)
+    const unsetIndex = boundedInteger(postBody.api_unset_idx, -1, 4)
+    if (
+      setShip == null ||
+      unsetShip == null ||
+      setIndex == null ||
+      unsetIndex == null
+    ) {
+      return null
+    }
+    return {
+      api_set_ship: setShip,
+      api_unset_ship: unsetShip,
+      api_set_idx: setIndex,
+      api_unset_idx: unsetIndex,
+    }
+  }
+  if (path === '/kcsapi/api_req_kaisou/unsetslot_all') {
+    const shipId = positiveIntegerOrNull(postBody.api_id)
+    return shipId == null ? null : { api_id: shipId }
+  }
+  return null
+}
+
+function equipmentApiResult(detail) {
+  const candidates = [
+    detail.apiResult,
+    detail.api_result,
+    detail.result,
+    detail.body && detail.body.api_result,
+  ]
+  for (const candidate of candidates) {
+    const value = toInteger(candidate)
+    if (value != null) return value === 1 ? 1 : 0
+  }
+  return null
+}
+
+function boundedInteger(value, minimum, maximum = Number.MAX_SAFE_INTEGER) {
+  const parsed = toInteger(value)
+  return parsed != null && parsed >= minimum && parsed <= maximum
+    ? parsed
+    : null
+}
+
+function selectedKindOf(postBody) {
+  if (!postBody || typeof postBody !== 'object') return null
+  const value = postBody.api_selected_kind
+  if (value == null || value === '') return null
+  if (typeof value === 'string' || typeof value === 'number') return String(value)
+  return null
+}
+
+function toInteger(value, fallback = null) {
+  if (value == null || value === '') return fallback
+  const parsed = Number(value)
+  return Number.isInteger(parsed) ? parsed : null
+}
+
+function nonNegativeInteger(value) {
+  const parsed = toInteger(value, 0)
+  return parsed != null && parsed >= 0 ? parsed : 0
+}
+
+function positiveIntegerOrNull(value) {
+  const parsed = toInteger(value)
+  return parsed != null && parsed > 0 ? parsed : null
+}
+
+function finiteOrNull(value) {
+  return Number.isFinite(value) ? value : null
+}
+
+function numberArray(value) {
+  if (!Array.isArray(value)) return []
+  return value.map((item) => finiteOrNull(item))
+}
+
+function objectOrNull(value) {
+  return value && typeof value === 'object' ? { ...value } : null
+}
+
+module.exports = {
+  createPoiTelemetry,
+}