een-api-toolkit 0.3.28 → 0.3.30

package/.claude/agents/een-devices-agent.md

@@ -119,15 +119,28 @@ interface ListCamerasParams {
 ## Key Functions
 
 ### getCameras()
-List cameras with optional filters:
+List cameras with optional filters.
+
+**IMPORTANT:** The `status` field is NOT included by default. You must use `include: ['status']` to receive it:
+
 ```typescript
 import { getCameras, type Camera, type ListCamerasParams } from 'een-api-toolkit'
 
 const cameras = ref<Camera[]>([])
 
-// Get all online cameras
+// Get all cameras WITH status - include: ['status'] is required!
+async function fetchCameras() {
+  const result = await getCameras({
+    include: ['status'],  // Required to get camera.status
+    pageSize: 100
+  })
+  // Now camera.status will be populated
+}
+
+// Get all online cameras (still need include for display)
 async function fetchOnlineCameras() {
   const result = await getCameras({
+    include: ['status'],  // Required to display status in UI
     status__in: ['online', 'streaming', 'recording'],
     pageSize: 100
   })
@@ -231,17 +244,33 @@ async function fetchBridge(bridgeId: string) {
 
 ```vue
 <script setup lang="ts">
-import { ref, onMounted } from 'vue'
-import { getCameras, type Camera, type ListCamerasParams } from 'een-api-toolkit'
+import { ref, onMounted, computed } from 'vue'
+import { getCameras, type Camera, type CameraStatus, type ListCamerasParams } from 'een-api-toolkit'
 
 const cameras = ref<Camera[]>([])
 const loading = ref(false)
 const statusFilter = ref<string[]>(['online', 'streaming', 'recording'])
 
+// Helper: status can be a string OR an object with connectionStatus
+function getStatusString(status?: CameraStatus | { connectionStatus?: CameraStatus }): string | undefined {
+  if (!status) return undefined
+  if (typeof status === 'string') return status
+  return status.connectionStatus
+}
+
+// Computed property to pre-process cameras with status string (avoids calling helper multiple times in template)
+const camerasWithStatus = computed(() =>
+  cameras.value.map(camera => ({
+    ...camera,
+    statusString: getStatusString(camera.status),
+  }))
+)
+
 async function fetchCameras() {
   loading.value = true
 
   const params: ListCamerasParams = {
+    include: ['status'],  // Required to receive status field
     pageSize: 100
   }
 
@@ -275,10 +304,13 @@ onMounted(fetchCameras)
 
     <div v-if="loading">Loading cameras...</div>
 
+    <!-- Use computed property for better performance (status string computed once per camera) -->
     <div class="camera-grid" v-else>
-      <div v-for="camera in cameras" :key="camera.id" class="camera-card">
+      <div v-for="camera in camerasWithStatus" :key="camera.id" class="camera-card">
         <h3>{{ camera.name }}</h3>
-        <span :class="camera.status">{{ camera.status }}</span>
+        <span :class="camera.statusString">
+          {{ camera.statusString || 'unknown' }}
+        </span>
       </div>
     </div>
   </div>

package/CHANGELOG.md

@@ -2,7 +2,7 @@
 
 All notable changes to this project will be documented in this file.
 
-## [0.3.28] - 2026-01-23
+## [0.3.30] - 2026-01-23
 
 ### Release Summary
 
@@ -10,19 +10,13 @@ No PR descriptions available for this release.
 
 ### Detailed Changes
 
-#### Bug Fixes
-- fix: Suppress eslint console.log warning in debug utility
-
 #### Other Changes
-- docs: Address Gemini and Claude review comments
-- chore: Add OAuth proxy startup to PR-and-check skill
-- docs: Add Claude Code agent setup instructions to Live Viewer prompt
-- docs: Add Claude Code agents documentation to User Guide and README
-- docs: Improve agent documentation based on usage experience
+- refactor: Use computed property for camera status in devices agent
+- docs: Document status field requirements in devices agent
 
 ### Links
 - [npm package](https://www.npmjs.com/package/een-api-toolkit)
-- [Full Changelog](https://github.com/klaushofrichter/een-api-toolkit/compare/v0.3.22...v0.3.28)
+- [Full Changelog](https://github.com/klaushofrichter/een-api-toolkit/compare/v0.3.28...v0.3.30)
 
 ---
-*Released: 2026-01-23 08:45:39 CST*
+*Released: 2026-01-23 17:42:54 CST*

package/docs/AI-CONTEXT.md

@@ -1,6 +1,6 @@
 # EEN API Toolkit - AI Reference
 
-> **Version:** 0.3.28
+> **Version:** 0.3.30
 >
 > 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.28
+> **Version:** 0.3.30
 >
 > OAuth flow implementation, token management, and session handling.
 > Load this document when implementing login, logout, or auth guards.

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

@@ -1,6 +1,6 @@
 # Cameras & Bridges API - EEN API Toolkit
 
-> **Version:** 0.3.28
+> **Version:** 0.3.30
 >
 > 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.28
+> **Version:** 0.3.30
 >
 > Complete reference for events, alerts, metrics, and SSE subscriptions.
 > Load this document when implementing event-driven features.

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

@@ -1,6 +1,6 @@
 # Media & Live Video - EEN API Toolkit
 
-> **Version:** 0.3.28
+> **Version:** 0.3.30
 >
 > 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.28
+> **Version:** 0.3.30
 >
 > 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.28
+> **Version:** 0.3.30
 >
 > Complete reference for user management.
 > Load this document when working with user data.

package/package.json

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