@ramathibodi/nuxt-commons 0.1.74 → 0.1.75

package/dist/runtime/components/device/IdCardWebSocket.vue

@@ -1,207 +1,207 @@
-<script setup lang="ts">
-/**
- * DeviceIdCardWebSocket bridges UI actions with host-agent hardware/device operations and emits runtime scan/read results.
- * This doc block is consumed by vue-docgen for generated API documentation.
- */
-import { onBeforeUnmount, onMounted, ref, watch } from 'vue'
-import { type IdCardWsServerMessage, type PatientRegisterPayload } from '../../composables/hostAgent'
-import { useHostAgentWs } from "../../composables/hostAgentWs";
-
-interface Props {
-  /** Subscribe withPhoto=true => server will push payload that includes photo when available */
-  withPhoto?: boolean // Includes portrait/photo data in ID card read results.
-  /** Optional reader name; null/undefined means "any/default" */
-  reader?: string | null // Preferred hardware reader identifier to connect or switch to.
-  /** Auto-connect on mount (default true) */
-  autoConnect?: boolean // Connects to the device WebSocket automatically on mount.
-  /** Auto-subscribe after connect (default true) */
-  autoSubscribe?: boolean // Subscribes to live reader events automatically after connect.
-  /** If true, try to reconnect when socket closes unexpectedly */
-  autoReconnect?: boolean // Retries connection automatically when the socket closes unexpectedly.
-  /** Reconnect delay in ms */
-  reconnectDelayMs?: number // Delay in milliseconds before each reconnect attempt.
-}
-
-/**
- * Public props accepted by DeviceIdCardWebSocket.
- * Document each prop field with intent, defaults, and side effects for clear generated docs.
- */
-const props = withDefaults(defineProps<Props>(), {
-  withPhoto: false,
-  reader: null,
-  autoConnect: true,
-  autoSubscribe: true,
-  autoReconnect: false,
-  reconnectDelayMs: 1000,
-})
-
-/**
- * Custom events emitted by DeviceIdCardWebSocket.
- * Parents can listen to these events to react to user actions and internal state changes.
- */
-const emit = defineEmits<{
-  (e: 'connected'): void
-  (e: 'disconnected', info?: { code?: number; reason?: string }): void
-  (e: 'subscribed', info?: { reader?: string | null; withPhoto?: boolean }): void
-  (e: 'unsubscribed'): void
-  (e: 'inserted', payload: PatientRegisterPayload): void
-  (e: 'removed'): void
-  (e: 'error', err: unknown): void
-  (e: 'message', msg: IdCardWsServerMessage): void
-}>()
-
-const host = useHostAgentWs()
-
-const reconnectTimer = ref<ReturnType<typeof setTimeout> | null>(null)
-const mounted = ref(false)
-const manuallyDisconnected = ref(false)
-
-function clearReconnect() {
-  if (reconnectTimer.value) {
-    clearTimeout(reconnectTimer.value)
-    reconnectTimer.value = null
-  }
-}
-
-function connectAndSubscribe() {
-  manuallyDisconnected.value = false
-  host.connectIdCardWs()
-
-  // subscribe immediately; safe because connectIdCardWs sets handlers then WS opens soon
-  // but we must wait until OPEN to send; so we subscribe on "open" event in handler below.
-}
-
-function safeDisconnect() {
-  manuallyDisconnected.value = true
-  clearReconnect()
-  try {
-    // best-effort unsubscribe (only if connected)
-    if (host.wsConnected.value) {
-      try { host.unsubscribeIdCardWs() } catch { /* ignore */ }
-    }
-  } catch { /* ignore */ }
-  host.disconnectIdCardWs()
-}
-
-const off = host.onIdCardWsEvent((ev) => {
-  if (ev.type === 'open') {
-    emit('connected')
-
-    if (props.autoSubscribe) {
-      try {
-        host.subscribeIdCardWs({ reader: props.reader ?? null, withPhoto: props.withPhoto })
-      } catch (e) {
-        emit('error', e)
-      }
-    }
-    return
-  }
-
-  if (ev.type === 'close') {
-    emit('disconnected', { code: ev.code, reason: ev.reason })
-
-    if (props.autoReconnect && mounted.value && !manuallyDisconnected.value) {
-      clearReconnect()
-      reconnectTimer.value = setTimeout(() => {
-        try {
-          connectAndSubscribe()
-        } catch (e) {
-          emit('error', e)
-        }
-      }, props.reconnectDelayMs)
-    }
-    return
-  }
-
-  if (ev.type === 'error') {
-    emit('error', ev.error)
-    return
-  }
-
-  if (ev.type === 'message') {
-    const msg = ev.data
-    emit('message', msg)
-
-    switch (msg.type) {
-      case 'monitor.subscribed':
-        if (msg.ok) emit('subscribed', { reader: msg.reader ?? null, withPhoto: !!msg.withPhoto })
-        break
-      case 'monitor.unsubscribed':
-        emit('unsubscribed')
-        break
-      case 'card.inserted':
-        emit('inserted', msg.payload)
-        break
-      case 'card.removed':
-        emit('removed')
-        break
-      case 'card.error':
-      case 'error':
-        emit('error', msg)
-        break
-    }
-  }
-})
-
-onMounted(() => {
-  mounted.value = true
-  if (props.autoConnect) connectAndSubscribe()
-})
-
-onBeforeUnmount(() => {
-  mounted.value = false
-  try { off?.() } catch { /* ignore */ }
-  safeDisconnect()
-})
-
-/**
- * If props change while connected, switch subscription behavior.
- * - withPhoto changes => re-subscribe (server treats subscribe twice as error), so do unsubscribe -> subscribe
- * - reader changes => use switchReader action when possible; if not connected, just store for next subscribe
- */
-watch(
-    () => props.reader,
-    (r) => {
-      if (!mounted.value) return
-      if (!host.wsConnected.value) return
-      if (!host.wsSubscribed.value) return
-
-      try {
-        host.switchReaderIdCardWs(r ?? null)
-      } catch (e) {
-        emit('error', e)
-      }
-    }
-)
-
-watch(
-    () => props.withPhoto,
-    (withPhoto) => {
-      if (!mounted.value) return
-      if (!host.wsConnected.value) return
-
-      // Server disallows re-subscribe without unsubscribe first.
-      // We do a clean unsubscribe -> resubscribe sequence.
-      try {
-        if (host.wsSubscribed.value) {
-          host.unsubscribeIdCardWs()
-        }
-      } catch { /* ignore */ }
-
-      // resubscribe after a tick; give server a moment to process unsubscribe
-      setTimeout(() => {
-        try {
-          if (host.wsConnected.value) {
-            host.subscribeIdCardWs({ reader: props.reader ?? null, withPhoto })
-          }
-        } catch (e) {
-          emit('error', e)
-        }
-      }, 0)
-    }
-)
-</script>
-
-<template>
-  <!-- Intentionally blank (headless component) -->
-</template>
+<script setup lang="ts">
+/**
+ * DeviceIdCardWebSocket bridges UI actions with host-agent hardware/device operations and emits runtime scan/read results.
+ * This doc block is consumed by vue-docgen for generated API documentation.
+ */
+import { onBeforeUnmount, onMounted, ref, watch } from 'vue'
+import { type IdCardWsServerMessage, type PatientRegisterPayload } from '../../composables/hostAgent'
+import { useHostAgentWs } from "../../composables/hostAgentWs";
+
+interface Props {
+  /** Subscribe withPhoto=true => server will push payload that includes photo when available */
+  withPhoto?: boolean // Includes portrait/photo data in ID card read results.
+  /** Optional reader name; null/undefined means "any/default" */
+  reader?: string | null // Preferred hardware reader identifier to connect or switch to.
+  /** Auto-connect on mount (default true) */
+  autoConnect?: boolean // Connects to the device WebSocket automatically on mount.
+  /** Auto-subscribe after connect (default true) */
+  autoSubscribe?: boolean // Subscribes to live reader events automatically after connect.
+  /** If true, try to reconnect when socket closes unexpectedly */
+  autoReconnect?: boolean // Retries connection automatically when the socket closes unexpectedly.
+  /** Reconnect delay in ms */
+  reconnectDelayMs?: number // Delay in milliseconds before each reconnect attempt.
+}
+
+/**
+ * Public props accepted by DeviceIdCardWebSocket.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
+const props = withDefaults(defineProps<Props>(), {
+  withPhoto: false,
+  reader: null,
+  autoConnect: true,
+  autoSubscribe: true,
+  autoReconnect: false,
+  reconnectDelayMs: 1000,
+})
+
+/**
+ * Custom events emitted by DeviceIdCardWebSocket.
+ * Parents can listen to these events to react to user actions and internal state changes.
+ */
+const emit = defineEmits<{
+  (e: 'connected'): void
+  (e: 'disconnected', info?: { code?: number; reason?: string }): void
+  (e: 'subscribed', info?: { reader?: string | null; withPhoto?: boolean }): void
+  (e: 'unsubscribed'): void
+  (e: 'inserted', payload: PatientRegisterPayload): void
+  (e: 'removed'): void
+  (e: 'error', err: unknown): void
+  (e: 'message', msg: IdCardWsServerMessage): void
+}>()
+
+const host = useHostAgentWs()
+
+const reconnectTimer = ref<ReturnType<typeof setTimeout> | null>(null)
+const mounted = ref(false)
+const manuallyDisconnected = ref(false)
+
+function clearReconnect() {
+  if (reconnectTimer.value) {
+    clearTimeout(reconnectTimer.value)
+    reconnectTimer.value = null
+  }
+}
+
+function connectAndSubscribe() {
+  manuallyDisconnected.value = false
+  host.connectIdCardWs()
+
+  // subscribe immediately; safe because connectIdCardWs sets handlers then WS opens soon
+  // but we must wait until OPEN to send; so we subscribe on "open" event in handler below.
+}
+
+function safeDisconnect() {
+  manuallyDisconnected.value = true
+  clearReconnect()
+  try {
+    // best-effort unsubscribe (only if connected)
+    if (host.wsConnected.value) {
+      try { host.unsubscribeIdCardWs() } catch { /* ignore */ }
+    }
+  } catch { /* ignore */ }
+  host.disconnectIdCardWs()
+}
+
+const off = host.onIdCardWsEvent((ev) => {
+  if (ev.type === 'open') {
+    emit('connected')
+
+    if (props.autoSubscribe) {
+      try {
+        host.subscribeIdCardWs({ reader: props.reader ?? null, withPhoto: props.withPhoto })
+      } catch (e) {
+        emit('error', e)
+      }
+    }
+    return
+  }
+
+  if (ev.type === 'close') {
+    emit('disconnected', { code: ev.code, reason: ev.reason })
+
+    if (props.autoReconnect && mounted.value && !manuallyDisconnected.value) {
+      clearReconnect()
+      reconnectTimer.value = setTimeout(() => {
+        try {
+          connectAndSubscribe()
+        } catch (e) {
+          emit('error', e)
+        }
+      }, props.reconnectDelayMs)
+    }
+    return
+  }
+
+  if (ev.type === 'error') {
+    emit('error', ev.error)
+    return
+  }
+
+  if (ev.type === 'message') {
+    const msg = ev.data
+    emit('message', msg)
+
+    switch (msg.type) {
+      case 'monitor.subscribed':
+        if (msg.ok) emit('subscribed', { reader: msg.reader ?? null, withPhoto: !!msg.withPhoto })
+        break
+      case 'monitor.unsubscribed':
+        emit('unsubscribed')
+        break
+      case 'card.inserted':
+        emit('inserted', msg.payload)
+        break
+      case 'card.removed':
+        emit('removed')
+        break
+      case 'card.error':
+      case 'error':
+        emit('error', msg)
+        break
+    }
+  }
+})
+
+onMounted(() => {
+  mounted.value = true
+  if (props.autoConnect) connectAndSubscribe()
+})
+
+onBeforeUnmount(() => {
+  mounted.value = false
+  try { off?.() } catch { /* ignore */ }
+  safeDisconnect()
+})
+
+/**
+ * If props change while connected, switch subscription behavior.
+ * - withPhoto changes => re-subscribe (server treats subscribe twice as error), so do unsubscribe -> subscribe
+ * - reader changes => use switchReader action when possible; if not connected, just store for next subscribe
+ */
+watch(
+    () => props.reader,
+    (r) => {
+      if (!mounted.value) return
+      if (!host.wsConnected.value) return
+      if (!host.wsSubscribed.value) return
+
+      try {
+        host.switchReaderIdCardWs(r ?? null)
+      } catch (e) {
+        emit('error', e)
+      }
+    }
+)
+
+watch(
+    () => props.withPhoto,
+    (withPhoto) => {
+      if (!mounted.value) return
+      if (!host.wsConnected.value) return
+
+      // Server disallows re-subscribe without unsubscribe first.
+      // We do a clean unsubscribe -> resubscribe sequence.
+      try {
+        if (host.wsSubscribed.value) {
+          host.unsubscribeIdCardWs()
+        }
+      } catch { /* ignore */ }
+
+      // resubscribe after a tick; give server a moment to process unsubscribe
+      setTimeout(() => {
+        try {
+          if (host.wsConnected.value) {
+            host.subscribeIdCardWs({ reader: props.reader ?? null, withPhoto })
+          }
+        } catch (e) {
+          emit('error', e)
+        }
+      }, 0)
+    }
+)
+</script>
+
+<template>
+  <!-- Intentionally blank (headless component) -->
+</template>