een-api-toolkit 0.3.97 → 0.3.103

package/docs/AI-CONTEXT.md

@@ -1,6 +1,6 @@
 # EEN API Toolkit - AI Reference
 
-> **Version:** 0.3.97
+> **Version:** 0.3.103
 >
 > 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.97
+> **Version:** 0.3.103
 >
 > 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.97
+> **Version:** 0.3.103
 >
 > 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.97
+> **Version:** 0.3.103
 >
 > Complete reference for camera and bridge management.
 > Load this document when working with devices.

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

@@ -1,6 +1,6 @@
 # Event Type to Data Schemas Mapping - EEN API Toolkit
 
-> **Version:** 0.3.97
+> **Version:** 0.3.103
 >
 > Complete reference for event type to data schema mappings.
 > Load this document when building dynamic event queries with the `include` parameter.
@@ -152,6 +152,7 @@ const schemas = EVENT_TYPE_DATA_SCHEMAS['een.personDetectionEvent.v1']
 | `een.objectRemovalEvent.v1` | monitoredArea, objectDetection, fullFrameImageUrl, croppedFrameImageUrl, displayOverlay.boundingBox, fullFrameImageUrlWithOverlay |
 | `een.personTailgateEvent.v1` | objectDetection, fullFrameImageUrl, croppedFrameImageUrl, displayOverlay.boundingBox, fullFrameImageUrlWithOverlay |
 | `een.edgeReportedDeviceStatusEvent.v1` | deviceCommonStatusUpdate, deviceErrorStatusUpdate |
+| `een.accessActivationEvent.v1` | credentialAccessActivation, creatorDetails, userAccessActivation |
 
 ### Camera Analytics Events
 

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

@@ -1,6 +1,6 @@
 # Events, Alerts & Real-Time Streaming - EEN API Toolkit
 
-> **Version:** 0.3.97
+> **Version:** 0.3.103
 >
 > Complete reference for events, alerts, metrics, and SSE subscriptions.
 > Load this document when implementing event-driven features.

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

@@ -1,6 +1,6 @@
 # Layouts API - EEN API Toolkit
 
-> **Version:** 0.3.97
+> **Version:** 0.3.103
 >
 > 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.97
+> **Version:** 0.3.103
 >
 > 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.97
+> **Version:** 0.3.103
 >
 > Complete reference for media retrieval, live streaming, and video playback.
 > Load this document when implementing video features.

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

@@ -1,6 +1,6 @@
 # PTZ Camera Controls
 
-> **Version:** 0.3.97
+> **Version:** 0.3.103
 >
 > Pan/Tilt/Zoom camera control: position, movement, presets, and automation.
 

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

@@ -1,6 +1,6 @@
 # Vue 3 Application Setup - EEN API Toolkit
 
-> **Version:** 0.3.97
+> **Version:** 0.3.103
 >
 > 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.97
+> **Version:** 0.3.103
 >
 > Complete reference for user management.
 > Load this document when working with user data.

package/examples/vue-ptz/src/components/PositionInput.vue

@@ -1,7 +1,7 @@
 <script setup lang="ts">
 import { ref, watch } from 'vue'
 import { movePtz } from 'een-api-toolkit'
-import type { PtzPositionResponse } from 'een-api-toolkit'
+import type { PtzPositionResponse, PtzDirection, PtzStepSize, PtzMoveType, PtzMove } from 'een-api-toolkit'
 import { useApiLog } from '../composables/useApiLog'
 
 const props = defineProps<{
@@ -14,45 +14,97 @@ const emit = defineEmits<{
 }>()
 
 const { log: apiLog } = useApiLog()
+
+// Move type selection
+const moveType = ref<PtzMoveType>('position')
+
+// Position fields
 const x = ref<string>('0')
 const y = ref<string>('0')
 const z = ref<string>('0')
+
+// Direction fields
+const directions = ref<PtzDirection[]>([])
+const stepSize = ref<PtzStepSize>('medium')
+const allDirections: PtzDirection[] = ['up', 'down', 'left', 'right', 'in', 'out']
+
+// CenterOn fields
+const relativeX = ref<string>('0.5')
+const relativeY = ref<string>('0.5')
+
 const applying = ref(false)
 const error = ref<string | null>(null)
 
-watch(() => props.currentPosition, (pos) => {
-  if (pos) {
-    x.value = pos.x?.toFixed(3) ?? '0'
-    y.value = pos.y?.toFixed(3) ?? '0'
-    z.value = pos.z?.toFixed(3) ?? '0'
+watch(moveType, () => {
+  error.value = null
+})
+
+function importPosition() {
+  if (props.currentPosition) {
+    x.value = props.currentPosition.x?.toFixed(3) ?? '0'
+    y.value = props.currentPosition.y?.toFixed(3) ?? '0'
+    z.value = props.currentPosition.z?.toFixed(3) ?? '0'
   }
-}, { immediate: true })
+}
 
-async function apply() {
-  if (!props.cameraId || applying.value) return
+function buildMove(): PtzMove | null {
+  if (moveType.value === 'position') {
+    const xVal = parseFloat(x.value)
+    const yVal = parseFloat(y.value)
+    const zVal = parseFloat(z.value)
+
+    if (isNaN(xVal) || isNaN(yVal) || isNaN(zVal)) {
+      error.value = 'Invalid numeric values'
+      return null
+    }
+
+    // Position coordinates are camera-specific absolute values (not normalised to 0-1)
+    return { moveType: 'position', x: xVal, y: yVal, z: zVal }
+  } else if (moveType.value === 'direction') {
+    if (directions.value.length === 0) {
+      error.value = 'Select at least one direction'
+      return null
+    }
 
-  const xVal = parseFloat(x.value)
-  const yVal = parseFloat(y.value)
-  const zVal = parseFloat(z.value)
+    return { moveType: 'direction', direction: [...directions.value], stepSize: stepSize.value }
+  } else {
+    const rxVal = parseFloat(relativeX.value)
+    const ryVal = parseFloat(relativeY.value)
+
+    if (isNaN(rxVal) || isNaN(ryVal)) {
+      error.value = 'Invalid numeric values'
+      return null
+    }
 
-  if (isNaN(xVal) || isNaN(yVal) || isNaN(zVal)) {
-    error.value = 'Invalid numeric values'
-    return
+    if (rxVal < 0 || rxVal > 1 || ryVal < 0 || ryVal > 1) {
+      error.value = 'Values must be between 0 and 1'
+      return null
+    }
+
+    return { moveType: 'centerOn', relativeX: rxVal, relativeY: ryVal }
   }
+}
+
+async function apply() {
+  if (!props.cameraId || applying.value) return
 
-  applying.value = true
   error.value = null
 
-  const move = { moveType: 'position' as const, x: xVal, y: yVal, z: zVal }
-  const result = await movePtz(props.cameraId, move)
-  apiLog('movePtz', { cameraId: props.cameraId, move }, result.error ?? result.data, !!result.error)
+  const move = buildMove()
+  if (!move) return
 
-  applying.value = false
+  applying.value = true
+  try {
+    const result = await movePtz(props.cameraId, move)
+    apiLog('movePtz', { cameraId: props.cameraId, move }, result.error ?? result.data, !!result.error)
 
-  if (result.error) {
-    error.value = result.error.message
-  } else {
-    emit('move-complete')
+    if (result.error) {
+      error.value = result.error.message
+    } else {
+      emit('move-complete')
+    }
+  } finally {
+    applying.value = false
   }
 }
 </script>
@@ -60,39 +112,114 @@ async function apply() {
 <template>
   <div class="position-input" data-testid="position-input">
     <div class="input-row">
-      <label>X</label>
-      <input
-        v-model="x"
-        type="number"
-        step="0.01"
-        :disabled="!cameraId || applying"
-        data-testid="input-x"
-        @keyup.enter="apply"
-      />
-    </div>
-    <div class="input-row">
-      <label>Y</label>
-      <input
-        v-model="y"
-        type="number"
-        step="0.01"
-        :disabled="!cameraId || applying"
-        data-testid="input-y"
-        @keyup.enter="apply"
-      />
-    </div>
-    <div class="input-row">
-      <label>Z</label>
-      <input
-        v-model="z"
-        type="number"
-        step="0.1"
-        min="0"
-        :disabled="!cameraId || applying"
-        data-testid="input-z"
-        @keyup.enter="apply"
-      />
+      <label>Move</label>
+      <select v-model="moveType" :disabled="!cameraId || applying" data-testid="move-type-select">
+        <option value="position">Position</option>
+        <option value="direction">Direction</option>
+        <option value="centerOn">Center On</option>
+      </select>
     </div>
+
+    <!-- Position fields -->
+    <template v-if="moveType === 'position'">
+      <div class="input-row">
+        <label>X</label>
+        <input
+          v-model="x"
+          type="number"
+          step="0.01"
+          :disabled="!cameraId || applying"
+          data-testid="input-x"
+          @keyup.enter="apply"
+        />
+      </div>
+      <div class="input-row">
+        <label>Y</label>
+        <input
+          v-model="y"
+          type="number"
+          step="0.01"
+          :disabled="!cameraId || applying"
+          data-testid="input-y"
+          @keyup.enter="apply"
+        />
+      </div>
+      <div class="input-row">
+        <label>Z</label>
+        <input
+          v-model="z"
+          type="number"
+          step="0.1"
+          min="0"
+          :disabled="!cameraId || applying"
+          data-testid="input-z"
+          @keyup.enter="apply"
+        />
+      </div>
+      <button
+        class="import-btn"
+        :disabled="!cameraId || !currentPosition || applying"
+        @click="importPosition"
+        data-testid="import-position"
+      >
+        Import Current Position
+      </button>
+    </template>
+
+    <!-- Direction fields -->
+    <template v-else-if="moveType === 'direction'">
+      <div class="direction-checkboxes">
+        <label v-for="dir in allDirections" :key="dir" class="checkbox-label">
+          <input
+            type="checkbox"
+            :value="dir"
+            v-model="directions"
+            :disabled="!cameraId || applying"
+            :data-testid="'dir-' + dir"
+          />
+          {{ dir }}
+        </label>
+      </div>
+      <div class="input-row">
+        <label>Step</label>
+        <select v-model="stepSize" :disabled="!cameraId || applying" data-testid="step-size-select">
+          <option value="small">Small</option>
+          <option value="medium">Medium</option>
+          <option value="large">Large</option>
+        </select>
+      </div>
+    </template>
+
+    <!-- CenterOn fields -->
+    <template v-else>
+      <div class="input-row">
+        <label>rX</label>
+        <input
+          v-model="relativeX"
+          type="number"
+          step="0.01"
+          min="0"
+          max="1"
+          :disabled="!cameraId || applying"
+          data-testid="input-relative-x"
+          @keyup.enter="apply"
+        />
+      </div>
+      <div class="input-row">
+        <label>rY</label>
+        <input
+          v-model="relativeY"
+          type="number"
+          step="0.01"
+          min="0"
+          max="1"
+          :disabled="!cameraId || applying"
+          data-testid="input-relative-y"
+          @keyup.enter="apply"
+        />
+      </div>
+    </template>
+
     <button
       class="apply-btn"
       :disabled="!cameraId || applying"
@@ -127,7 +254,7 @@ async function apply() {
   font-size: 13px;
   font-weight: 600;
   color: #555;
-  min-width: 20px;
+  min-width: 32px;
   text-align: right;
 }
 
@@ -140,10 +267,61 @@ async function apply() {
   font-family: monospace;
 }
 
-.input-row input:disabled {
+.input-row select {
+  flex: 1;
+  padding: 5px 8px;
+  border: 1px solid #ddd;
+  border-radius: 4px;
+  font-size: 13px;
+}
+
+.input-row input:disabled,
+.input-row select:disabled {
   opacity: 0.5;
 }
 
+.direction-checkboxes {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 4px 12px;
+  margin-bottom: 8px;
+}
+
+.checkbox-label {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  font-size: 13px;
+  color: #555;
+  cursor: pointer;
+  text-transform: capitalize;
+}
+
+.checkbox-label input[type="checkbox"] {
+  margin: 0;
+}
+
+.import-btn {
+  width: 100%;
+  padding: 6px;
+  font-size: 11px;
+  background: #6c757d;
+  color: white;
+  border: none;
+  border-radius: 4px;
+  cursor: pointer;
+  margin-bottom: 4px;
+}
+
+.import-btn:hover:not(:disabled) {
+  background: #5a6268;
+}
+
+.import-btn:disabled {
+  opacity: 0.4;
+  cursor: not-allowed;
+}
+
 .apply-btn {
   width: 100%;
   padding: 8px;

package/package.json

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