een-api-toolkit 0.3.47 → 0.3.51

package/docs/AI-CONTEXT.md

@@ -1,6 +1,6 @@
 # EEN API Toolkit - AI Reference
 
-> **Version:** 0.3.47
+> **Version:** 0.3.51
 >
 > This documentation is optimized for AI assistants. It provides focused, domain-specific
 > references to help you understand and use the een-api-toolkit efficiently.
@@ -21,6 +21,7 @@
 | Live video, images, HLS playback | [AI-MEDIA.md](./ai-reference/AI-MEDIA.md) | ~4K |
 | Events, alerts, metrics, SSE | [AI-EVENTS.md](./ai-reference/AI-EVENTS.md) | ~3.5K |
 | Automation rules, alert actions | [AI-AUTOMATIONS.md](./ai-reference/AI-AUTOMATIONS.md) | ~4K |
+| Jobs, exports, files, downloads | [AI-JOBS.md](./ai-reference/AI-JOBS.md) | ~3.5K |
 
 ## Specialized Agents
 
@@ -36,6 +37,7 @@ Specialized agents are available in `.claude/agents/` for domain-specific tasks:
 | `een-media-agent` | Live video, camera previews, HLS playback, recorded images |
 | `een-events-agent` | Events, alerts, metrics, real-time SSE subscriptions |
 | `een-automations-agent` | Automation rules, alert condition rules, alert actions |
+| `een-jobs-agent` | Jobs, exports, files, downloads, video export workflows |
 
 **How to Use Agents:**
 
@@ -76,6 +78,7 @@ Then follow the context files and instructions specified within.
 | [vue-alerts-metrics](../examples/vue-alerts-metrics/) | Event metrics and alerts | `src/components/MetricsChart.vue` |
 | [vue-event-subscriptions](../examples/vue-event-subscriptions/) | Real-time SSE streaming | `src/views/LiveEvents.vue` |
 | [vue-automations](../examples/vue-automations/) | Automation rules listing | `src/views/Automations.vue` |
+| [vue-jobs](../examples/vue-jobs/) | Jobs, exports, file downloads | `src/views/Jobs.vue` |
 
 ---
 
@@ -180,6 +183,24 @@ Then follow the context files and instructions specified within.
 | `listAlertActions(params?)` | List alert actions |
 | `getAlertAction(id)` | Get a specific alert action |
 
+### Exports & Jobs
+| Function | Purpose |
+|----------|---------|
+| `createExportJob(params)` | Create video/timelapse export job |
+| `listJobs(params?)` | List jobs with filtering |
+| `getJob(jobId)` | Get a specific job |
+
+### Files & Downloads
+| Function | Purpose |
+|----------|---------|
+| `listFiles(params?)` | List available files |
+| `getFile(fileId)` | Get a specific file |
+| `addFile(params)` | Add a new file |
+| `downloadFile(fileId)` | Download file content |
+| `listDownloads(params?)` | List available downloads |
+| `getDownload(downloadId)` | Get a specific download |
+| `downloadDownload(downloadId)` | Download from downloads endpoint |
+
 ### Utilities
 | Function | Purpose |
 |----------|---------|

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

@@ -1,6 +1,6 @@
 # Authentication - EEN API Toolkit
 
-> **Version:** 0.3.47
+> **Version:** 0.3.51
 >
 > 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.47
+> **Version:** 0.3.51
 >
 > 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.47
+> **Version:** 0.3.51
 >
 > Complete reference for camera and bridge management.
 > Load this document when working with devices.

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

@@ -1,6 +1,6 @@
 # Events, Alerts & Real-Time Streaming - EEN API Toolkit
 
-> **Version:** 0.3.47
+> **Version:** 0.3.51
 >
 > Complete reference for events, alerts, metrics, and SSE subscriptions.
 > Load this document when implementing event-driven features.
@@ -292,6 +292,7 @@ import {
   listEventFieldValues,
   listEventTypes,
   getRecordedImage,
+  getEvent,
   type Camera,
   type Event,
   type EventType,
@@ -374,6 +375,13 @@ const imageLoadingIds = ref<Set<string>>(new Set()) // Track which images are cu
 const boundingBoxCache = ref<Map<string, BoundingBox[]>>(new Map()) // Cache bounding boxes per event
 const enlargedEventId = ref<string | null>(null)
 
+// JSON viewer state
+const jsonViewerEventId = ref<string | null>(null)
+const jsonViewerFullEvent = ref<Event | null>(null)
+const jsonViewerLoading = ref(false)
+const jsonViewerError = ref<string | null>(null)
+const copySuccess = ref(false)
+
 // Lightbox media state
 const showVideo = ref(false)
 const hdImageUrl = ref<string | null>(null)
@@ -396,6 +404,21 @@ const enlargedBoundingBoxes = computed(() => {
   if (!enlargedEvent.value) return []
   return getBoundingBoxes(enlargedEvent.value)
 })
+const jsonViewerEvent = computed(() => {
+  if (!jsonViewerEventId.value) return null
+  return events.value.find(e => e.id === jsonViewerEventId.value) || null
+})
+const jsonViewerContent = computed(() => {
+  // Use full event if loaded, otherwise fall back to list event
+  const eventToShow = jsonViewerFullEvent.value || jsonViewerEvent.value
+  if (!eventToShow) return ''
+  try {
+    return JSON.stringify(eventToShow, null, 2)
+  } catch (err) {
+    // Safely handle any JSON serialization errors
+    return `Error serializing event data: ${String(err)}`
+  }
+})
 
 // Get start timestamp based on time range
 function getStartTimestamp(range: TimeRange): string {
@@ -698,6 +721,77 @@ function closeEnlargedImage() {
   resetVideo()
 }
 
+// Open JSON viewer and fetch full event details
+async function openJsonViewer(eventId: string) {
+  jsonViewerEventId.value = eventId
+  jsonViewerFullEvent.value = null
+  jsonViewerError.value = null
+  copySuccess.value = false
+
+  // Find the event in the list to get its dataSchemas
+  const listEvent = events.value.find(e => e.id === eventId)
+  if (!listEvent) {
+    jsonViewerError.value = 'Event not found in current list'
+    return
+  }
+
+  // Build include array from dataSchemas (prefix with "data.")
+  const includes = listEvent.dataSchemas?.map(schema => `data.${schema}`) || []
+
+  if (includes.length === 0) {
+    // No additional data to fetch, use the list event as-is
+    return
+  }
+
+  // Fetch full event details with all data schemas
+  jsonViewerLoading.value = true
+  const { data, error } = await getEvent(eventId, { include: includes })
+  jsonViewerLoading.value = false
+
+  if (error) {
+    jsonViewerError.value = error.message
+    return
+  }
+
+  if (data) {
+    jsonViewerFullEvent.value = data
+  }
+}
+
+// Close JSON viewer
+function closeJsonViewer() {
+  jsonViewerEventId.value = null
+  jsonViewerFullEvent.value = null
+  jsonViewerError.value = null
+  copySuccess.value = false
+}
+
+// Copy JSON to clipboard
+async function copyJsonToClipboard() {
+  if (!jsonViewerContent.value) return
+  try {
+    await navigator.clipboard.writeText(jsonViewerContent.value)
+    copySuccess.value = true
+    setTimeout(() => {
+      copySuccess.value = false
+    }, 2000)
+  } catch {
+    // Fallback for older browsers
+    const textarea = document.createElement('textarea')
+    textarea.value = jsonViewerContent.value
+    textarea.style.position = 'fixed'
+    textarea.style.opacity = '0'
+    document.body.appendChild(textarea)
+    textarea.select()
+    document.execCommand('copy')
+    document.body.removeChild(textarea)
+    copySuccess.value = true
+    setTimeout(() => {
+      copySuccess.value = false
+    }, 2000)
+  }
+}
+
 // Switch to preview mode
 function showPreview() {
   currentMediaType.value = 'preview'
@@ -747,8 +841,12 @@ async function showVideoPlayer() {
 
 // Handle keyboard events for accessibility
 function handleKeydown(event: KeyboardEvent) {
-  if (event.key === 'Escape' && enlargedEventId.value) {
-    closeEnlargedImage()
+  if (event.key === 'Escape') {
+    if (jsonViewerEventId.value) {
+      closeJsonViewer()
+    } else if (enlargedEventId.value) {
+      closeEnlargedImage()
+    }
   }
 }
 
@@ -759,6 +857,9 @@ onMounted(() => {
 
 onUnmounted(() => {
   window.removeEventListener('keydown', handleKeydown)
+  // Clean up JSON viewer state to prevent memory leaks
+  jsonViewerFullEvent.value = null
+  jsonViewerEventId.value = null
 })
 
 // Watch for modal open/close
@@ -784,6 +885,7 @@ watch(() => props.isOpen, async (isOpen) => {
     boundingBoxCache.value.clear()
     events.value = []
     enlargedEventId.value = null
+    jsonViewerEventId.value = null
   }
 }, { immediate: true })
 
@@ -883,7 +985,15 @@ watch([timeRange, selectedEventTypes], () => {
               </div>
             </div>
             <div class="event-info">
-              <div class="event-type">{{ getEventTypeName(event.type) }}</div>
+              <div class="event-type-row">
+                <span class="event-type">{{ getEventTypeName(event.type) }}</span>
+                <button
+                  class="json-button"
+                  @click="openJsonViewer(event.id)"
+                  title="View JSON data"
+                  data-testid="json-button"
+                >{ }</button>
+              </div>
               <div class="event-time">{{ formatTimestamp(event.startTimestamp) }}</div>
               <div v-if="getBoundingBoxCount(event) > 0" class="event-detections" data-testid="event-detections">
                 {{ getBoundingBoxCount(event) }} detection{{ getBoundingBoxCount(event) !== 1 ? 's' : '' }}

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

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