een-api-toolkit 0.3.51 → 0.3.55

package/docs/AI-CONTEXT.md

@@ -1,6 +1,6 @@
 # EEN API Toolkit - AI Reference
 
-> **Version:** 0.3.51
+> **Version:** 0.3.55
 >
 > This documentation is optimized for AI assistants. It provides focused, domain-specific
 > references to help you understand and use the een-api-toolkit efficiently.

package/docs/ai-reference/AI-AUTH.md

@@ -1,6 +1,6 @@
 # Authentication - EEN API Toolkit
 
-> **Version:** 0.3.51
+> **Version:** 0.3.55
 >
 > OAuth flow implementation, token management, and session handling.
 > Load this document when implementing login, logout, or auth guards.

package/docs/ai-reference/AI-AUTOMATIONS.md

@@ -1,6 +1,6 @@
 # Automations API - EEN API Toolkit
 
-> **Version:** 0.3.51
+> **Version:** 0.3.55
 >
 > Complete reference for automation rules and alert actions.
 > Load this document when working with automated alert workflows.

package/docs/ai-reference/AI-DEVICES.md

@@ -1,6 +1,6 @@
 # Cameras & Bridges API - EEN API Toolkit
 
-> **Version:** 0.3.51
+> **Version:** 0.3.55
 >
 > Complete reference for camera and bridge management.
 > Load this document when working with devices.

package/docs/ai-reference/AI-EVENT-DATA-SCHEMAS.md

@@ -0,0 +1,328 @@
+# Event Type to Data Schemas Mapping - EEN API Toolkit
+
+> **Version:** 0.3.55
+>
+> Complete reference for event type to data schema mappings.
+> Load this document when building dynamic event queries with the `include` parameter.
+
+---
+
+## Overview
+
+When fetching events using the `listEvents` API, you can request additional event-specific data by using the `include` parameter. Each event type supports a specific set of data schemas. The toolkit provides a static mapping and utility functions to help you build the correct `include` parameter dynamically.
+
+### Key Concept
+
+- **Schema names** appear in the event's `dataSchemas` array (e.g., `een.objectDetection.v1`)
+- **Include values** require the `data.` prefix (e.g., `data.een.objectDetection.v1`)
+
+---
+
+## Exported Functions
+
+### getIncludeParameterForEventTypes(eventTypes)
+
+Get the include parameter values for multiple event types. Combines all schemas, removes duplicates, and adds the `data.` prefix.
+
+```typescript
+import { getIncludeParameterForEventTypes, listEvents } from 'een-api-toolkit'
+
+const selectedTypes = ['een.personDetectionEvent.v1', 'een.vehicleDetectionEvent.v1']
+const includeValues = getIncludeParameterForEventTypes(selectedTypes)
+// ['data.een.objectDetection.v1', 'data.een.personAttributes.v1', ...]
+
+const result = await listEvents({
+  actor: `camera:${cameraId}`,
+  type__in: selectedTypes,
+  startTimestamp__gte: startTime,
+  include: includeValues
+})
+```
+
+### getDataSchemasForEventType(eventType)
+
+Get the data schemas for a specific event type (without `data.` prefix).
+
+```typescript
+import { getDataSchemasForEventType } from 'een-api-toolkit'
+
+const schemas = getDataSchemasForEventType('een.personDetectionEvent.v1')
+// ['een.objectDetection.v1', 'een.personAttributes.v1', ...]
+```
+
+### eventTypeHasDataSchemas(eventType)
+
+Check if an event type has any associated data schemas.
+
+```typescript
+import { eventTypeHasDataSchemas } from 'een-api-toolkit'
+
+if (eventTypeHasDataSchemas('een.personDetectionEvent.v1')) {
+  // Include data schemas in the API call
+}
+```
+
+### getEventTypesForDataSchema(schema)
+
+Find which event types support a specific data schema.
+
+```typescript
+import { getEventTypesForDataSchema } from 'een-api-toolkit'
+
+const eventTypes = getEventTypesForDataSchema('een.objectDetection.v1')
+// ['een.motionDetectionEvent.v1', 'een.personDetectionEvent.v1', ...]
+```
+
+### getAllDataSchemas()
+
+Get all unique data schemas across all event types.
+
+```typescript
+import { getAllDataSchemas } from 'een-api-toolkit'
+
+const allSchemas = getAllDataSchemas()
+// ['een.objectDetection.v1', 'een.fullFrameImageUrl.v1', ...]
+```
+
+### getAllKnownEventTypes()
+
+Get all known event types defined in the mapping.
+
+```typescript
+import { getAllKnownEventTypes } from 'een-api-toolkit'
+
+const allTypes = getAllKnownEventTypes()
+// ['een.motionDetectionEvent.v1', 'een.personDetectionEvent.v1', ...]
+```
+
+---
+
+## Static Mapping
+
+The `EVENT_TYPE_DATA_SCHEMAS` constant provides the complete mapping:
+
+```typescript
+import { EVENT_TYPE_DATA_SCHEMAS } from 'een-api-toolkit'
+
+const schemas = EVENT_TYPE_DATA_SCHEMAS['een.personDetectionEvent.v1']
+// ['een.objectDetection.v1', 'een.personAttributes.v1', ...]
+```
+
+---
+
+## Event Type to Data Schemas Reference
+
+### Detection Events
+
+| Event Type | Data Schemas |
+|------------|--------------|
+| `een.motionDetectionEvent.v1` | `objectDetection`, `fullFrameImageUrl`, `croppedFrameImageUrl`, `displayOverlay.boundingBox`, `fullFrameImageUrlWithOverlay` |
+| `een.motionInRegionDetectionEvent.v1` | `motionRegion`, `objectDetection`, `fullFrameImageUrl`, `croppedFrameImageUrl`, `displayOverlay.boundingBox`, `fullFrameImageUrlWithOverlay` |
+| `een.personDetectionEvent.v1` | `objectDetection`, `personAttributes`, `fullFrameImageUrl`, `croppedFrameImageUrl`, `objectClassification`, `objectRegionMapping`, `displayOverlay.boundingBox`, `fullFrameImageUrlWithOverlay`, `geoLocation` |
+| `een.personMotionDetectionEvent.v1` | `objectDetection`, `fullFrameImageUrl`, `croppedFrameImageUrl`, `objectClassification` |
+| `een.animalDetectionEvent.v1` | `objectDetection`, `animalAttributes`, `fullFrameImageUrl`, `croppedFrameImageUrl`, `objectClassification`, `objectRegionMapping`, `displayOverlay.boundingBox`, `fullFrameImageUrlWithOverlay` |
+| `een.faceDetectionEvent.v1` | `objectDetection`, `personAttributes`, `fullFrameImageUrl`, `croppedFrameImageUrl`, `objectClassification`, `objectRegionMapping`, `displayOverlay.boundingBox`, `fullFrameImageUrlWithOverlay` |
+| `een.vehicleDetectionEvent.v1` | `objectDetection`, `fullFrameImageUrl`, `croppedFrameImageUrl`, `objectClassification`, `vehicleAttributes`, `objectRegionMapping`, `displayOverlay.boundingBox`, `fullFrameImageUrlWithOverlay` |
+| `een.vehicleMotionDetectionEvent.v1` | `objectDetection`, `fullFrameImageUrl`, `croppedFrameImageUrl`, `objectClassification`, `vehicleAttributes` |
+| `een.gunDetectionEvent.v1` | `fullFrameImageUrl`, `croppedFrameImageUrl`, `objectDetection`, `motionRegion`, `objectClassification`, `displayOverlay.boundingBox`, `fullFrameImageUrlWithOverlay`, `weaponAttributes`, `personAttributes`, `humanValidationDetails` |
+| `een.weaponDetectionEvent.v1` | `fullFrameImageUrl`, `croppedFrameImageUrl`, `objectDetection`, `motionRegion`, `displayOverlay.boundingBox`, `fullFrameImageUrlWithOverlay` |
+| `een.fallDetectionEvent.v1` | `objectDetection`, `fullFrameImageUrl`, `croppedFrameImageUrl`, `displayOverlay.boundingBox`, `fullFrameImageUrlWithOverlay` |
+| `een.fireDetectionEvent.v1` | `objectDetection`, `objectClassification`, `croppedFrameImageUrl`, `fullFrameImageUrl`, `displayOverlay.boundingBox`, `fullFrameImageUrlWithOverlay` |
+| `een.spillDetectionEvent.v1` | `objectDetection`, `objectClassification`, `croppedFrameImageUrl`, `fullFrameImageUrl`, `displayOverlay.boundingBox`, `fullFrameImageUrlWithOverlay` |
+| `een.crowdFormationDetectionEvent.v1` | `objectDetection`, `objectClassification`, `croppedFrameImageUrl`, `fullFrameImageUrl`, `displayOverlay.boundingBox`, `fullFrameImageUrlWithOverlay` |
+
+### Camera Analytics Events
+
+| Event Type | Data Schemas |
+|------------|--------------|
+| `een.tamperDetectionEvent.v1` | `fullFrameImageUrl` |
+| `een.loiterDetectionEvent.v1` | `loiterArea`, `objectDetection`, `fullFrameImageUrl`, `croppedFrameImageUrl`, `displayOverlay.boundingBox`, `fullFrameImageUrlWithOverlay` |
+| `een.objectLineCrossEvent.v1` | `lineCrossLine`, `objectDetection`, `fullFrameImageUrl`, `croppedFrameImageUrl`, `entryDirection`, `displayOverlay.boundingBox`, `fullFrameImageUrlWithOverlay` |
+| `een.objectLineCrossCountEvent.v1` | `lineCrossLine`, `objectDetection`, `fullFrameImageUrl`, `croppedFrameImageUrl`, `entryDirection`, `displayOverlay.boundingBox`, `fullFrameImageUrlWithOverlay` |
+| `een.countedObjectLineCrossEvent.v1` | `countedLineCross` |
+| `een.objectIntrusionEvent.v1` | `intrusionArea`, `objectDetection`, `fullFrameImageUrl`, `croppedFrameImageUrl`, `entryDirection`, `displayOverlay.boundingBox`, `fullFrameImageUrlWithOverlay` |
+| `een.objectRemovalEvent.v1` | `monitoredArea`, `objectDetection`, `fullFrameImageUrl`, `croppedFrameImageUrl`, `displayOverlay.boundingBox`, `fullFrameImageUrlWithOverlay` |
+| `een.personTailgateEvent.v1` | `objectDetection`, `fullFrameImageUrl`, `croppedFrameImageUrl`, `displayOverlay.boundingBox`, `fullFrameImageUrlWithOverlay` |
+| `een.ppeViolationEvent.v1` | `objectDetection`, `personAttributes`, `fullFrameImageUrl`, `croppedFrameImageUrl`, `objectClassification`, `objectRegionMapping`, `displayOverlay.boundingBox`, `fullFrameImageUrlWithOverlay` |
+
+### AI/Scene Events
+
+| Event Type | Data Schemas |
+|------------|--------------|
+| `een.sceneLabelEvent.v1` | `objectDetection`, `objectClassification`, `vehicleAttributes`, `personAttributes`, `animalAttributes`, `croppedFrameImageUrl`, `fullFrameImageUrl`, `objectRegionMapping`, `displayOverlay.boundingBox`, `customLabels`, `eevaAttributes`, `fullFrameImageUrlWithOverlay` |
+| `een.eevaQueryEvent.v1` | `customLabels`, `eevaAttributes`, `objectDetection`, `fullFrameImageUrl`, `fullFrameImageUrlWithOverlay`, `displayOverlay.boundingBox` |
+
+### License Plate & Fleet Recognition Events
+
+| Event Type | Data Schemas |
+|------------|--------------|
+| `een.lprPlateReadEvent.v1` | `objectDetection`, `lprDetection`, `vehicleAttributes`, `lprAccessType`, `userData`, `userTags`, `croppedFrameImageUrl`, `fullFrameImageUrl`, `displayOverlay.boundingBox`, `fullFrameImageUrlWithOverlay`, `vehicleListInfo`, `resourceDetails`, `vspInsightsSummary` |
+| `een.fleetCodeRecognitionEvent.v1` | `objectDetection`, `dotNumberRecognition`, `truckNumberRecognition`, `trailerNumberRecognition`, `croppedFrameImageUrl`, `fullFrameImageUrl`, `recognizedText`, `resourceDetails` |
+
+### Audio Detection Events
+
+| Event Type | Data Schemas |
+|------------|--------------|
+| `een.gunShotAudioDetectionEvent.v1` | `audioDetection`, `geoLocation` |
+| `een.t3AlarmAudioDetectionEvent.v1` | `audioDetection` |
+| `een.t4AlarmAudioDetectionEvent.v1` | `audioDetection` |
+
+### POS (Point of Sale) Events
+
+| Event Type | Data Schemas |
+|------------|--------------|
+| `een.posTransactionEvent.v1` | `posTransactionStart`, `posTransactionEnd`, `posTransactionItem`, `posTransactionPayment`, `posTransactionCartChangeTrail`, `posTransactionCardLoadSummary`, `posTransactionFlag`, `posTransactionLabel`, `rawData`, `displayLocationSummary`, `fullFrameImageUrl` |
+
+### Device & System Events
+
+| Event Type | Data Schemas |
+|------------|--------------|
+| `een.deviceCloudStatusUpdateEvent.v1` | `deviceCloudStatusUpdate`, `deviceCloudPreviousStatus` |
+| `een.deviceCloudConnectionStatusUpdateEvent.v1` | `deviceCloudConnectionStatusUpdate`, `deviceCloudConnectionPreviousStatus` |
+| `een.edgeReportedDeviceStatusEvent.v1` | `deviceCommonStatusUpdate`, `deviceErrorStatusUpdate` |
+| `een.deviceIOEvent.v1` | `deviceIO` |
+| `een.deviceOperationEvent.v1` | `resourceDetails`, `deviceOperationDetails`, `deviceOperationSubStep`, `deviceOperationUpdate` |
+| `een.ptzPositionUpdateEvent.v1` | `ptzPositionUpdate` |
+
+### Sensor Events
+
+| Event Type | Data Schemas |
+|------------|--------------|
+| `een.doorStatusEvent.v1` | `measurementStringValueUpdate` |
+| `een.batteryLevelUpdateEvent.v1` | `batteryLevelUpdate` |
+| `een.measurementThresholdStatusEvent.v1` | `measurementThresholdStatus`, `measurementValueUpdate`, `measurementStringValueUpdate` |
+| `een.thermalCameraThresholdStatusEvent.v1` | `thermalCameraValueUpdate`, `thermalMonitoredArea` |
+
+### Resource Management Events
+
+All resource management events use `resourceDetails.v1`:
+
+- `een.layoutCreationEvent.v1`, `een.layoutUpdateEvent.v1`, `een.layoutDeletionEvent.v1`
+- `een.deviceCreationEvent.v1`, `een.deviceUpdateEvent.v1`, `een.deviceDeletionEvent.v1`
+- `een.userCreationEvent.v1`, `een.userUpdateEvent.v1`, `een.userDeletionEvent.v1`
+- `een.accountCreationEvent.v1`, `een.accountUpdateEvent.v1`, `een.accountDeletionEvent.v1`
+
+### Job Events
+
+| Event Type | Data Schemas |
+|------------|--------------|
+| `een.jobCreationEvent.v1` | `jobDetails`, `ownerDetails` |
+| `een.jobUpdateEvent.v1` | `jobDetails`, `ownerDetails` |
+| `een.jobDeletionEvent.v1` | `ownerDetails` |
+
+### Safety & Protocol Events
+
+| Event Type | Data Schemas |
+|------------|--------------|
+| `een.panicButtonEvent.v1` | `geoLocation` |
+| `een.evacuateProtocolEvent.v1` | *(none)* |
+| `een.holdProtocolEvent.v1` | *(none)* |
+| `een.lockdownProtocolEvent.v1` | *(none)* |
+| `een.secureProtocolEvent.v1` | *(none)* |
+| `een.shelterProtocolEvent.v1` | *(none)* |
+
+### Behavioral Events
+
+These events have no associated data schemas:
+
+- `een.violenceDetectionEvent.v1`
+- `een.fightDetectionEvent.v1`
+- `een.handsUpDetectionEvent.v1`
+- `een.vapeDetectionEvent.v1`
+
+---
+
+## Common Data Schemas
+
+These are the most commonly used data schemas across multiple event types:
+
+| Schema | Description | Common Uses |
+|--------|-------------|-------------|
+| `een.objectDetection.v1` | Bounding box coordinates `[x1, y1, x2, y2]` (normalized 0-1) | Most detection events |
+| `een.objectClassification.v1` | Object class label and confidence | Detection with classification |
+| `een.fullFrameImageUrl.v1` | URL to full-frame event image | Most camera events |
+| `een.croppedFrameImageUrl.v1` | URL to cropped image of detected object | Detection events |
+| `een.fullFrameImageUrlWithOverlay.v1` | URL to full-frame image with visual overlays | Detection events with overlays |
+| `een.displayOverlay.boundingBox.v1` | Bounding box overlay data for visual display | Detection events |
+| `een.personAttributes.v1` | Person-specific attributes (clothing, gender) | Person detection |
+| `een.vehicleAttributes.v1` | Vehicle-specific attributes (make, model, color) | Vehicle detection |
+| `een.animalAttributes.v1` | Animal-specific attributes | Animal detection |
+| `een.eevaAttributes.v1` | EEVA AI query and response attributes | Scene label, EEVA query |
+| `een.customLabels.v1` | Custom labels from AI analysis | Scene label, EEVA query |
+| `een.countedLineCross.v1` | Aggregated count of objects crossing a line | Counting analytics |
+
+---
+
+## Vue Component Example
+
+```vue
+<script setup lang="ts">
+import { ref, watch, computed } from 'vue'
+import {
+  listEvents,
+  listEventFieldValues,
+  getIncludeParameterForEventTypes,
+  getDataSchemasForEventType,
+  type Camera,
+  type Event
+} from 'een-api-toolkit'
+
+const props = defineProps<{ camera: Camera }>()
+
+const availableEventTypes = ref<string[]>([])
+const selectedEventTypes = ref<string[]>([])
+const events = ref<Event[]>([])
+
+// Dynamically compute include parameter based on selected event types
+const includeParameter = computed(() => {
+  return getIncludeParameterForEventTypes(selectedEventTypes.value)
+})
+
+async function fetchAvailableEventTypes() {
+  const result = await listEventFieldValues({
+    actor: `camera:${props.camera.id}`
+  })
+  if (!result.error) {
+    availableEventTypes.value = result.data.type || []
+    selectedEventTypes.value = [...availableEventTypes.value]
+  }
+}
+
+async function fetchEvents() {
+  if (selectedEventTypes.value.length === 0) return
+
+  const result = await listEvents({
+    actor: `camera:${props.camera.id}`,
+    type__in: selectedEventTypes.value,
+    startTimestamp__gte: new Date(Date.now() - 3600000).toISOString(),
+    include: includeParameter.value
+  })
+
+  if (!result.error) {
+    events.value = result.data.results
+  }
+}
+
+// Get schemas for a specific event (useful for JSON viewer)
+function getEventSchemas(event: Event): string[] {
+  return getDataSchemasForEventType(event.type)
+}
+
+// Refetch when selection changes
+watch(selectedEventTypes, fetchEvents, { deep: true })
+</script>
+```
+
+---
+
+## Source
+
+This mapping is derived from the Eagle Eye Networks API v3.0 specification (`events.yaml`).
+
+## Maintenance
+
+When new event types are added to the EEN API:
+1. Check the API specification for the new event type
+2. Find the `dataSchemas` array in the event schema
+3. Add the mapping to `src/events/dataSchemas.ts`
+4. Update the `KnownEventType` and `DataSchema` types as needed

package/docs/ai-reference/AI-EVENTS.md

@@ -1,6 +1,6 @@
 # Events, Alerts & Real-Time Streaming - EEN API Toolkit
 
-> **Version:** 0.3.51
+> **Version:** 0.3.55
 >
 > Complete reference for events, alerts, metrics, and SSE subscriptions.
 > Load this document when implementing event-driven features.
@@ -293,6 +293,8 @@ import {
   listEventTypes,
   getRecordedImage,
   getEvent,
+  getIncludeParameterForEventTypes,
+  getDataSchemasForEventType,
   type Camera,
   type Event,
   type EventType,
@@ -420,6 +422,12 @@ const jsonViewerContent = computed(() => {
   }
 })
 
+// Data schemas for the current event type
+const jsonViewerDataSchemas = computed(() => {
+  if (!jsonViewerEvent.value) return []
+  return getDataSchemasForEventType(jsonViewerEvent.value.type)
+})
+
 // Get start timestamp based on time range
 function getStartTimestamp(range: TimeRange): string {
   const now = Date.now()
@@ -571,6 +579,9 @@ async function fetchEvents(append = false) {
     error.value = null
   }
 
+  // Build include parameter dynamically based on selected event types
+  const includeValues = getIncludeParameterForEventTypes(selectedEventTypes.value)
+
   const result = await listEvents({
     actor: `camera:${props.camera.id}`,
     type__in: selectedEventTypes.value,
@@ -579,7 +590,7 @@ async function fetchEvents(append = false) {
     pageSize: 20,
     pageToken: append ? nextPageToken.value : undefined,
     sort: '-startTimestamp',
-    include: ['data.een.fullFrameImageUrl.v1', 'data.een.croppedFrameImageUrl.v1', 'data.een.objectDetection.v1', 'data.een.objectClassification.v1']
+    include: includeValues
   })
 
   if (result.error) {

package/docs/ai-reference/AI-GROUPING.md

@@ -1,6 +1,6 @@
 # Layouts API - EEN API Toolkit
 
-> **Version:** 0.3.51
+> **Version:** 0.3.55
 >
 > Complete reference for layout management (camera grouping).
 > Load this document when working with layouts.

package/docs/ai-reference/AI-JOBS.md

@@ -1,6 +1,6 @@
 # Jobs, Exports, Files & Downloads - EEN API Toolkit
 
-> **Version:** 0.3.51
+> **Version:** 0.3.55
 >
 > Complete reference for async jobs, video exports, and file management.
 > Load this document when implementing export workflows or file downloads.

package/docs/ai-reference/AI-MEDIA.md

@@ -1,6 +1,6 @@
 # Media & Live Video - EEN API Toolkit
 
-> **Version:** 0.3.51
+> **Version:** 0.3.55
 >
 > Complete reference for media retrieval, live streaming, and video playback.
 > Load this document when implementing video features.

package/docs/ai-reference/AI-SETUP.md

@@ -1,6 +1,6 @@
 # Vue 3 Application Setup - EEN API Toolkit
 
-> **Version:** 0.3.51
+> **Version:** 0.3.55
 >
 > Complete guide for setting up a Vue 3 application with the een-api-toolkit.
 > Load this document when creating a new project or troubleshooting setup issues.

package/docs/ai-reference/AI-USERS.md

@@ -1,6 +1,6 @@
 # Users API - EEN API Toolkit
 
-> **Version:** 0.3.51
+> **Version:** 0.3.55
 >
 > Complete reference for user management.
 > Load this document when working with user data.

package/examples/vue-events/src/components/EventsModal.vue

@@ -6,6 +6,8 @@ import {
   listEventTypes,
   getRecordedImage,
   getEvent,
+  getIncludeParameterForEventTypes,
+  getDataSchemasForEventType,
   type Camera,
   type Event,
   type EventType,
@@ -133,6 +135,12 @@ const jsonViewerContent = computed(() => {
   }
 })
 
+// Data schemas for the current event type
+const jsonViewerDataSchemas = computed(() => {
+  if (!jsonViewerEvent.value) return []
+  return getDataSchemasForEventType(jsonViewerEvent.value.type)
+})
+
 // Get start timestamp based on time range
 function getStartTimestamp(range: TimeRange): string {
   const now = Date.now()
@@ -284,6 +292,9 @@ async function fetchEvents(append = false) {
     error.value = null
   }
 
+  // Build include parameter dynamically based on selected event types
+  const includeValues = getIncludeParameterForEventTypes(selectedEventTypes.value)
+
   const result = await listEvents({
     actor: `camera:${props.camera.id}`,
     type__in: selectedEventTypes.value,
@@ -292,7 +303,7 @@ async function fetchEvents(append = false) {
     pageSize: 20,
     pageToken: append ? nextPageToken.value : undefined,
     sort: '-startTimestamp',
-    include: ['data.een.fullFrameImageUrl.v1', 'data.een.croppedFrameImageUrl.v1', 'data.een.objectDetection.v1', 'data.een.objectClassification.v1']
+    include: includeValues
   })
 
   if (result.error) {
@@ -907,6 +918,16 @@ watch([timeRange, selectedEventTypes], () => {
               >&times;</button>
             </div>
           </div>
+          <div v-if="jsonViewerDataSchemas.length > 0" class="json-viewer-schemas" data-testid="json-viewer-schemas">
+            <span class="schemas-label">Data Schemas:</span>
+            <div class="schemas-list">
+              <span
+                v-for="schema in jsonViewerDataSchemas"
+                :key="schema"
+                class="schema-tag"
+              >{{ schema }}</span>
+            </div>
+          </div>
           <div class="json-viewer-body">
             <div v-if="jsonViewerLoading" class="json-viewer-loading">
               Loading full event details...
@@ -1496,6 +1517,38 @@ watch([timeRange, selectedEventTypes], () => {
   color: #fff;
 }
 
+.json-viewer-schemas {
+  padding: 12px 20px;
+  border-bottom: 1px solid #333;
+  background: #252525;
+}
+
+.schemas-label {
+  color: #888;
+  font-size: 0.75rem;
+  font-weight: 500;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+  display: block;
+  margin-bottom: 8px;
+}
+
+.schemas-list {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+}
+
+.schema-tag {
+  background: #333;
+  color: #42b883;
+  font-size: 0.7rem;
+  font-family: 'SF Mono', Monaco, 'Cascadia Code', 'Roboto Mono', Consolas, monospace;
+  padding: 3px 8px;
+  border-radius: 3px;
+  border: 1px solid #444;
+}
+
 .json-viewer-body {
   flex: 1;
   overflow: auto;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "een-api-toolkit",
-  "version": "0.3.51",
+  "version": "0.3.55",
   "description": "EEN Video platform API v3.0 library for Vue 3",
   "type": "module",
   "main": "./dist/index.cjs",