feat: add usage IP geolocation lookup

2026-10-31 00:24:38 +00:00 · 2026-07-01 21:49:49 +08:00
parent 7dc7cfce1d
commit 0ff93aca7a
11 changed files with 938 additions and 3 deletions
@@ -0,0 +1,101 @@
+<template>
+  <div v-if="entry.status === 'idle'" class="mt-0.5 text-xs">
+    <button
+      type="button"
+      class="text-primary-600 underline decoration-dashed underline-offset-2 hover:text-primary-700 dark:text-primary-400 dark:hover:text-primary-300"
+      @click="handleFetch"
+    >
+      {{ t('usage.ipGeo.fetch') }}
+    </button>
+  </div>
+
+  <div
+    v-else-if="entry.status === 'loading'"
+    class="mt-0.5 flex items-center gap-1 text-xs text-gray-400 dark:text-gray-500"
+  >
+    <svg class="h-3 w-3 animate-spin" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+      <path
+        stroke-linecap="round"
+        stroke-linejoin="round"
+        stroke-width="2"
+        d="M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15"
+      />
+    </svg>
+    {{ t('usage.ipGeo.fetching') }}
+  </div>
+
+  <div v-else-if="entry.status === 'success'" class="mt-0.5 flex items-center gap-1 text-xs">
+    <button
+      type="button"
+      class="truncate text-gray-500 underline decoration-dotted underline-offset-2 hover:text-primary-600 dark:text-gray-400 dark:hover:text-primary-400"
+      :title="tooltipText"
+      @click="handleOpenDetail"
+    >
+      {{ entry.label }}
+    </button>
+    <button
+      type="button"
+      class="text-gray-400 hover:text-primary-600 dark:hover:text-primary-400"
+      :title="t('usage.ipGeo.refreshTitle')"
+      @click="handleRefresh"
+    >
+      <Icon name="refresh" size="xs" />
+    </button>
+  </div>
+
+  <div v-else-if="entry.status === 'error'" class="mt-0.5 text-xs">
+    <button
+      type="button"
+      class="text-red-600 underline decoration-dashed underline-offset-2 hover:text-red-700 dark:text-red-400 dark:hover:text-red-300"
+      @click="handleFetch"
+    >
+      {{ t('usage.ipGeo.failed') }}
+    </button>
+  </div>
+
+  <div v-else class="mt-0.5 text-xs text-gray-400 dark:text-gray-500">
+    {{ t('usage.ipGeo.private') }}
+  </div>
+</template>
+
+<script setup lang="ts">
+import { computed } from 'vue'
+import { useI18n } from 'vue-i18n'
+import Icon from '@/components/icons/Icon.vue'
+import { fetchOne, getEntry } from '@/utils/ipGeoLookup'
+
+const props = defineProps<{ ip: string }>()
+const { t } = useI18n()
+
+const entry = computed(() => getEntry(props.ip))
+
+const tooltipText = computed(() => {
+  const detail = entry.value.detail
+  if (!detail) return ''
+  const lines = [
+    detail.organization ? `${t('usage.ipGeo.detailOrg')}: ${detail.organization}` : '',
+    detail.timezone ? `${t('usage.ipGeo.detailTimezone')}: ${detail.timezone}` : '',
+    detail.accuracy != null ? `${t('usage.ipGeo.detailAccuracy')}: ${detail.accuracy}km` : '',
+    detail.latitude && detail.longitude
+      ? `${t('usage.ipGeo.detailCoordinates')}: ${detail.latitude}, ${detail.longitude}`
+      : '',
+  ].filter(Boolean)
+  return lines.join('\n')
+})
+
+const handleFetch = () => {
+  void fetchOne(props.ip)
+}
+
+const handleRefresh = () => {
+  void fetchOne(props.ip, true)
+}
+
+const handleOpenDetail = () => {
+  window.open(
+    `https://www.iplocation.net/ip-lookup?query=${encodeURIComponent(props.ip)}`,
+    '_blank',
+    'noopener,noreferrer'
+  )
+}
+</script>
@@ -0,0 +1,108 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+import { mount } from '@vue/test-utils'
+
+const mocks = vi.hoisted(() => ({
+  getEntry: vi.fn(),
+  fetchOne: vi.fn(),
+}))
+
+vi.mock('@/utils/ipGeoLookup', () => ({
+  getEntry: mocks.getEntry,
+  fetchOne: mocks.fetchOne,
+}))
+
+vi.mock('vue-i18n', async () => {
+  const actual = await vi.importActual<typeof import('vue-i18n')>('vue-i18n')
+  return {
+    ...actual,
+    useI18n: () => ({
+      t: (key: string) => {
+        const table: Record<string, string> = {
+          'usage.ipGeo.fetch': 'Fetch region',
+          'usage.ipGeo.fetching': 'Fetching...',
+          'usage.ipGeo.failed': 'Failed',
+          'usage.ipGeo.private': 'Private address',
+          'usage.ipGeo.refreshTitle': 'Refresh',
+          'usage.ipGeo.detailOrg': 'ISP',
+          'usage.ipGeo.detailTimezone': 'Timezone',
+          'usage.ipGeo.detailAccuracy': 'Accuracy',
+          'usage.ipGeo.detailCoordinates': 'Coordinates',
+        }
+        return table[key] ?? key
+      },
+    }),
+  }
+})
+
+import IpGeoCell from '../IpGeoCell.vue'
+
+describe('IpGeoCell', () => {
+  beforeEach(() => {
+    mocks.getEntry.mockReset()
+    mocks.fetchOne.mockReset()
+  })
+
+  it('renders a clickable fetch link in idle state and triggers fetchOne on click', async () => {
+    mocks.getEntry.mockReturnValue({ status: 'idle' })
+    const wrapper = mount(IpGeoCell, { props: { ip: '8.8.8.8' } })
+    expect(wrapper.text()).toContain('Fetch region')
+    await wrapper.find('button').trigger('click')
+    expect(mocks.fetchOne).toHaveBeenCalledWith('8.8.8.8')
+  })
+
+  it('renders loading state', () => {
+    mocks.getEntry.mockReturnValue({ status: 'loading' })
+    const wrapper = mount(IpGeoCell, { props: { ip: '8.8.8.8' } })
+    expect(wrapper.text()).toContain('Fetching...')
+  })
+
+  it('renders success state with label, tooltip detail, and a refresh button', async () => {
+    mocks.getEntry.mockReturnValue({
+      status: 'success',
+      label: 'CN · Guangdong · Shenzhen',
+      detail: {
+        organization: 'AS4134 Chinanet',
+        timezone: 'Asia/Shanghai',
+        accuracy: 10,
+        latitude: '22.5',
+        longitude: '114.0',
+      },
+    })
+    const wrapper = mount(IpGeoCell, { props: { ip: '121.35.47.43' } })
+    expect(wrapper.text()).toContain('CN · Guangdong · Shenzhen')
+    const buttons = wrapper.findAll('button')
+    expect(buttons.length).toBe(2)
+    expect(buttons[0].attributes('title')).toContain('AS4134 Chinanet')
+    expect(buttons[0].attributes('title')).toContain('Asia/Shanghai')
+    await buttons[1].trigger('click')
+    expect(mocks.fetchOne).toHaveBeenCalledWith('121.35.47.43', true)
+  })
+
+  it('opens the external lookup page when the label is clicked', async () => {
+    mocks.getEntry.mockReturnValue({ status: 'success', label: 'US · California', detail: {} })
+    const openSpy = vi.spyOn(window, 'open').mockImplementation(() => null)
+    const wrapper = mount(IpGeoCell, { props: { ip: '8.8.4.4' } })
+    await wrapper.findAll('button')[0].trigger('click')
+    expect(openSpy).toHaveBeenCalledWith(
+      'https://www.iplocation.net/ip-lookup?query=8.8.4.4',
+      '_blank',
+      'noopener,noreferrer'
+    )
+    openSpy.mockRestore()
+  })
+
+  it('renders failed state as a clickable retry', async () => {
+    mocks.getEntry.mockReturnValue({ status: 'error' })
+    const wrapper = mount(IpGeoCell, { props: { ip: '8.8.8.8' } })
+    expect(wrapper.text()).toContain('Failed')
+    await wrapper.find('button').trigger('click')
+    expect(mocks.fetchOne).toHaveBeenCalledWith('8.8.8.8')
+  })
+
+  it('renders private state as non-clickable text', () => {
+    mocks.getEntry.mockReturnValue({ status: 'private' })
+    const wrapper = mount(IpGeoCell, { props: { ip: '192.168.1.1' } })
+    expect(wrapper.text()).toContain('Private address')
+    expect(wrapper.find('button').exists()).toBe(false)
+  })
+})